dsh-github

DSH PLUGIN浏览器与联网

仓库 KNLCXY/dsh-github

浏览器与联网 L5 · 运行验证通过 安全审查:低风险 可信度:金 可安装插件
安装这个插件

dsh-github 是 KNLCXY 维护的 浏览器与联网 类 DSH 可安装插件, 仓库为 KNLCXY/dsh-github,许可证 MIT。 下面按「装什么、怎么装、验没验过、跑起来要注意什么」逐项列出。

一句话选型结论

按资料字段整理

dsh-github 是浏览器与联网类的 DSH 可安装插件,验证等级 L5 · 运行验证通过,安全审查为低风险,有可直接复制的安装命令。验证通过不等于安全:插件会读写文件、执行命令或联网,装前先到仓库确认它做了什么;涉及密钥或系统权限的,建议先在隔离环境试装。

分类浏览器与联网 收录类型可安装插件 验证等级L5 · 运行验证通过 安全审查低风险
验证等级 L5 L5 · 运行验证通过
GitHub 星标 0 复刻 0 · 未关闭 issue 0
最近更新 2026-10-23 创建于 2026-10-22
README 10.8 KB 正文体量,越大说明说明书写得越细

安装

可安装插件
在 DSH 里执行,装完用 dsh plugin list 确认已挂上;标了 L4 / L5 的命令已在沙盒里真实跑通
dsh plugin --profile web add github:KNLCXY/dsh-github#v0.4.1
  1. 1
    确认版本与运行环境

    仓库没有标注兼容版本与 Node.js 要求,先确认你的 DSH 版本能装,再继续。

  2. 2
    执行安装命令

    在 DSH 里执行上面的命令;多包仓库要注意区分具体子包名,别装错包。

  3. 3
    确认已挂载

    用 dsh plugin list 查看列表里是否出现这个插件,出现即挂载成功。

  4. 4
    试跑并检查权限

    加载后跑一个最小用例,确认它能正常工作;同时看它申请了哪些文件、命令或网络权限。

兼容 DSH 版本未标注版本不匹配时安装会报错
Node.js 要求未标注来自仓库 package.json 的 engines 字段
前置依赖无需要同时安装的同级依赖
npm 包名未发布到 npm可用 npm view 查看包信息

能做什么

浏览器与联网
字段来自项目仓库与公开索引,中文说明由本站标注

适用场景

GitHub 集成文件读写

上游标签

agent-toolsautomationdeepseek-harnessdevtoolsdshdsh-plugingitgithubgithub-apipersonal-access-token

验证等级与安全审查

L5 · 运行验证通过
自动化流程结论,不是人工审核
验证等级L5 · 运行验证通过在 dsh 沙盒中完成安装与运行冒烟——装得上、跑得起来
安全审查低风险静态分析结论,未标注不代表已通过审查
仓库健康度活跃按仓库活跃度与最近更新时间给出
可信度金综合仓库活跃度与验证结果

选择建议

装之前先看这几条
按条目字段给出的判断,不替你决定用不用

值得选的地方

  • 验证等级 L5:安装和运行都在沙盒里跑通过,装完能直接用的概率高。
  • 静态安全审查为低风险,没有发现明显可疑行为。
  • 有可直接复制的安装命令,不用自己翻文档找入口。

先想清楚的地方

  • 没有声明 Node.js 版本要求,版本不匹配可能装不上。
  • 验证通过不等于安全:插件会读写文件、执行命令或联网,装前先到仓库确认它做了什么。

更适合

  • 需要在浏览器与联网场景里给 DSH 补能力的人。
  • 想装完就能用、不想自己排依赖的人。
  • 能接受在本地装依赖、愿意自己确认权限的人。

不太适合

  • 只使用 DSH 官方内置能力、不接受第三方插件的人。

同类对比

6 个同类
同分类里挑最接近的几条,字段以各自详情页为准
插件验证等级安全审查星标兼容版本安装命令
dsh-github当前 L5 · 运行验证通过 低风险 0 未标注 有
dsh-our-free-model L3 · 安装规范通过 低风险 8,796 未标注 有
dsh-web L3 · 安装规范通过 低风险 8,549 未标注 无
BrowserSkill L4 · 沙盒安装通过 低风险 8,456 未标注 有
dsh-pocket L5 · 运行验证通过 低风险 1,656 0.2.0-rc.2 等 12 个 有
Browser4 L4 · 沙盒安装通过 中风险 1,152 未标注 有

仓库档案

浏览器与联网
字段来自项目仓库与公开索引,中文说明由本站标注
作者 / 维护方KNLCXY仓库 dsh-github · 默认分支 main
分类浏览器与联网network
收录类型可安装插件声明了 dsh.bundle、可用 dsh plugin add 安装的条目
开发语言未标注仓库主语言
许可证MIT商用或二次分发前请确认条款原文
星标 / 复刻 / issue0 / 0 / 0收录时的数值,非实时
创建 / 更新2026-10-22 · 2026-10-23最后推送 2026-10-23
本站收录2026-10-30首次进入本站目录的时间

README 全文

10.8 KB
作者原文,中文版优先;只做安全转义,不改内容

dsh-github

给 DeepSeek Harness(DSH)用的 GitHub 工具插件。装上之后 agent 可以直接:调 GitHub REST API、一次提交多个文件(一个 commit)、建仓库、查这个 token 是谁的。

token 你自己填 —— 在 设置 → GitHub 里粘一次,之后每个会话都能用。设置里那格只有示例占位符,没有默认值;插件源码、cordis.patch.yml、任何工具输出里都不会出现你的 token。

github_status        这个 token 是谁的、有什么权限、还剩多少配额(不回显 token)
github_api           直接调 REST API(相对路径或完整 URL)
github_push_files    一批文件 = 一个 commit(blob → tree → commit → 更新 ref)
github_repo_create   建仓库,顺手设 topics
github_release_create 建 Release 并上传附件(tgz 等),可标 draft / prerelease
github_fix_git_auth  诊断并修 git 凭据弹窗(CredentialHelperSelector)



下载

不想 clone 就直接去 Release 页拿安装包(每个版本都带 .tgz 和 SHA256SUMS.txt):

→ 全部 Release

> 版本口径:0.x 一律是预发布(Pre-release,不算 Latest);1.x 起才算正式版。

dsh plugin --profile <你的 profile> add "file:<下载路径>/dsh-github-<版本>.tgz"

校验:同页附件 SHA256SUMS.txt(sha256sum -c SHA256SUMS.txt)。


安装

# 从 git 装
dsh plugin --profile <你的 profile> add github:KNLCXY/dsh-github

# 或从目录装(要改代码时)
dsh plugin --profile <你的 profile> add "file:/绝对路径/dsh-github"

装完重启 DSH(插件的宿主半和 client 半都在进程启动时组装一次)。

填 token(唯一的配置步骤)

打开 设置 → GitHub,把 token 粘进第一个输入框,点保存。

输入框 说明
GitHub token 只有示例占位符 ghp_xxxxxxxxxxxxxxxxxxxx,没有默认值;不填就是没配
API 地址 留空用 https://api.github.com;只有 GitHub Enterprise 才需要改
代理 留空 = 直连。GitHub 直连超时的网络填 http://127.0.0.1:7897

也可以直接写文件(等价,改完下一轮工具调用即生效,不用重启):

// ~/.dsh/storages/dsh-github/settings.json
{
"token": "ghp_xxxxxxxxxxxxxxxxxxxx",
"apiBase": "https://api.github.com",
"proxyUrl": "http://127.0.0.1:7897"
}

token 怎么建、要什么权限

你想干什么 最小权限
只读仓库、看 issue / PR Contents: Read(+ Issues: Read)
提交文件(github_push_files) Contents: Read and write
建仓库、设 topics 再加 Administration: Read and write
用 classic token 图省事 勾一个 repo 就全有了
  • fine-grained: → 选仓库 → 配上面几项 → Generate
  • classic: → 勾 repo → Generate

建议设过期时间(7–30 天)。不用了随时在同一个页面 Revoke。

工具参考

github_status

不带参数。返回登录名、token 掩码(ghp_…9c31)、scopes、API 配额余量。没配 token 时给一句提示,不报错。

✅ token 可用:KNLCXY
token:ghp_…9c31 · 代理:http://127.0.0.1:7897
scopes:repo
配额:4986/5000

github_api

参数 说明
path 必填。/repos/owner/repo 这样的相对路径,或完整 https://api.github.com/...
method GET(默认)/ POST / PUT / PATCH / DELETE
body JSON 字符串,只对写操作有意义
max_chars 返回体上限,默认 6000,超了截断并告诉你原长
github_api({ path: "/repos/KNLCXY/dsh-github" })
github_api({ path: "/search/repositories?q=dsh-plugin&sort=stars" })
github_api({ path: "/repos/KNLCXY/x/issues", method: "POST", body: '{"title":"hi","body":"…"}' })

错误会翻译成人话:401(token 无效/过期)、403(权限不足或限流)、404(仓库不存在或无权访问)。

github_push_files

参数 说明
repo 必填,"owner/name"
message 必填,commit message(多行只取第一行做摘要)
files 必填。数组 [{path, content, encoding?}],或对象 {path: content}
branch 默认仓库的 default_branch
github_push_files({
repo: "KNLCXY/scratch",
message: "docs: 补 README",
files: [
{ path: "README.md", content: "# hi\n" },
{ path: "docs/a.md", content: "…" },
{ path: "logo.png", content: "", encoding: "base64" },
],
})

返回 ✅ 已提交 N 个文件 … commit abc1234 … https://github.com/owner/repo/commit/…。

行为说明:

  • 空仓库也能用:没有 main 时会自动建第一条 commit 和分支
  • 只在 base_tree 上叠加,不会顺手删掉仓库里别的文件
  • 一个调用 = 一个 commit,不是 N 个
  • 401/403 会明确告诉你是 token 权限问题

github_repo_create

参数 说明
name 必填,只写名字(不带 owner/)
description 一句话描述(≤350 字符,会进搜索结果)
private 默认 false
topics 逗号分隔,例如 "dsh,dsh-plugin,deepseek-harness" —— 决定能不能被搜到
owner 组织名;不填就是自己的账号

安全边界

事项 做法
token 存在哪 ~/.dsh/storages/dsh-github/settings.json(本机,不进 git)
会不会进 repo 不会。仓库里的 cordis.patch.yml 写的是 token: ''
会不会进工具输出 不会。只有 github_status 显示掩码(首 4 + 末 4)
设置接口返回什么 hasToken / tokenHint / 占位符,没有 token 字段
明文出现在哪 只有设置文件本身和 github_api 发出去的 Authorization 头

想再稳一点:给 token 设 7 天过期,用完 Revoke;或者用只含目标仓库的 fine-grained token(不要 "All repositories")。

scripts/:三个可复用的旁路工具

> 这三个脚本也单独发了一个仓库(不装插件也能用,仓库里同样不含任何 key):
> KNLCXY/dsh-github-scripts

主流程用 token 走 API,这三个脚本是没有 token 时的旁路(也是本插件诞生的原因):

脚本 干什么
gh-web-commit.mjs 不依赖 token,用浏览器里已登录的 GitHub 会话提交单个文件(驱动 GitHub 网页编辑器)
gh-device-login.mjs 走 OAuth 设备流,用已登录的浏览器会话换一个 gho_ token(scope 自己定)
chrome-probe.mjs 用指定启动参数起内核、导航、跑 JS —— 排查「页面在自动化下不渲染」这类问题
ELECTRON_RUN_AS_NODE=1 "/DeepSeek Harness.exe" scripts/chrome-probe.mjs \
"https://github.com///new/main?filename=README.md" \
--flag "--disable-blink-features=AutomationControlled" \
--js "document.querySelectorAll('.cm-content').length"

两个入口都认环境变量:DSH_CHROME(内核路径)、DSH_GH_PROFILE(浏览器 profile 目录)。

> 踩过的坑(值得写下来):GitHub 的文件编辑器在 navigator.webdriver === true 时整块不渲染,页面只剩 "Files main" 骨架。加 --disable-blink-features=AutomationControlled 才正常。这也是 gh-web-commit.mjs 默认带这个参数的原因。

排错

现象 原因 / 修法
还没有配置 GitHub token 去 设置 → GitHub 粘一个;或者写进 settings.json
401 Bad credentials token 打错、已 Revoke、或复制时带了空格
403 Resource not accessible by personal access token 权限不够。fine-grained 要给 Contents: Read and write(推文件)或 Administration(建仓库/设 topics)
403 API rate limit exceeded 未认证限流 60/小时,认证后 5000/小时;等一会儿或用别的 token
404 Not Found 仓库名拼错,或 token 没有这个仓库的访问权(fine-grained 要显式选仓库)
请求超时 / fetch failed 这个网络到 GitHub 不稳,在设置里填代理(http://127.0.0.1:7897),或用 github_status 对比直连与代理
设置页没有「GitHub」 client 半在进程启动时组装:重启 DSH
反复弹 CredentialHelperSelector git 的 system 配置把 credential.helper 设成了 helper-selector。用 github_fix_git_auth({ apply: true }),或在「设置 → GitHub」点「修复」——只改 git 凭据存储,不碰 token

开发

# 纯逻辑冒烟(不联网、不需要 DSH)
node test/smoke.mjs
# 用 DSH 自带 Node 也一样
ELECTRON_RUN_AS_NODE=1 "/DeepSeek Harness.exe" test/smoke.mjs

覆盖:4 个工具是否注册、设置路由的校验(坏 token 400 / 好 token 200 且只回显首末 4 位 / 明文不出现在响应里 / 清除 / 坏代理 400)、没 token 时的提示、repo 格式校验。

改完源码要生效:bump package.json 的 version → 重新 dsh plugin add → 重启 DSH。
(pnpm 是把包复制进 node_modules,版本号不变会说 "Already up to date"。)

实现要点见 lib/index.js 顶部注释:代理是自实现的 CONNECT 隧道(Node 的 fetch 不读代理环境变量),所以 proxyUrl 一填,连 api.github.com 也能走隧道。

git 凭据弹窗(CredentialHelperSelector)

Windows 上如果每次 git 要凭据都弹一个「Select a credential helper」的框,成因是:

git config --system --get-all credential.helper   # → helper-selector
git config --global --get credential.credentialStore  # → 空

helper-selector 这个 helper 的职责就是弹选择框;store 没配,它每次都问。

修法(注意 helper 是多层叠加的,只写 global manager 顶不掉 system 的那条):

git config --global credential.credentialStore wincred
git config --global --unset-all credential.helper
git config --global --add credential.helper ""       # 空值 = 重置此前累积的列表
git config --global --add credential.helper manager

插件里做成了一条命令:

github_fix_git_auth({})              // 只检查
github_fix_git_auth({ apply: true }) // 写入 ~/.gitconfig

或在「设置 → GitHub」点 修复(写 ~/.gitconfig)。只影响 git 的凭据存储位置,
不读取、不修改你的 GitHub token。

许可

MIT © KNLCXY

常见问题

6 问
答案由本站依据条目字段整理,不引用上游原文
dsh-github 怎么安装?

在 DSH 里执行 `dsh plugin --profile web add github:KNLCXY/dsh-github#v0.4.1` 即可。

dsh-github 的验证等级是什么意思?

L5 · 运行验证通过。在 dsh 沙盒中完成安装与运行冒烟——装得上、跑得起来

dsh-github 安全吗?

低风险。

dsh-github 装之前要先确认什么?

先看它会读写哪些文件、执行哪些命令、连接哪些网络地址;验证等级只说明装得上、跑得起来,不等于安全。涉及密钥或系统权限的,建议先在隔离环境试装。

dsh-github 用的是什么许可证?

上游标注为 MIT。商用或二次分发前请到仓库确认许可证原文。

这条记录的数据可靠吗?

本站按仓库名去重后合并整理,字段以作者仓库与 npm 元数据为准;安装命令、仓库地址与 README 保持原文,带 L4 / L5 标记的安装命令已在隔离沙盒里真实跑通。

同名或近似条目

8 条
不同作者的仓库分开列,请确认你要装的是哪一个
浏览器与联网
按星标排序,可作替代方案

dsh-our-free-model

dsh-our-free-model

在 DeepSeek Harness 中装上这个 DSH plugin,无需登录、注册或填 API Key,即可直接调用 DeepSeek

L3 · 安装规范通过 8,796 星

dsh-web

dsh-web

侧边栏多列任务看板:卡片交给真实 DSH 智能体会话执行,支持 cron 定时(Host 侧到点执行,关浏览器也生效)。

L3 · 安装规范通过 8,549 星

BrowserSkill

BrowserSkill

BrowserSkill 的 DeepSeek Harness 浏览器自动化桥接插件,通过原生浏览器工具控制可见的 Chrome 和 Edg

L4 · 沙盒安装通过 8,456 星

dsh-pocket

dsh-pocket

DSH Pocket 让 DeepSeek Harness 装进口袋:电脑跑 dsh web,手机扫码即实时同步访问(局域网+公网),人在外

L5 · 运行验证通过 1,656 星

Browser4

Browser4

L4 · 沙盒安装通过 1,152 星

agentrq

agentrq

L4 · 沙盒安装通过 1,140 星

KNLCXY 的其它插件

3 个

插件的元信息来自作者仓库;分类、验证等级与安全结论的中文说明为中文整理,最近核验 —。