dsh-github
GitPub:在 DSH 设置页一键将本地插件发布至 GitHub,并自动创建专用 AI 会话进行后续维护
AI 分析
核心用途是简化 DSH 插件的开源发布流程。适合插件开发者,可通过 AI 辅助自动生成双语 README、打标签并推送到仓库。
安装
此插件尚未提供可验证的 bundle,或兼容性检查未通过。请先阅读仓库说明。 阅读完整 README ↗
说明文档
阅读完整 README ↗使用方法
- 启动 DeepSeek Harness(
dsh web),进入 设置页,找到 Git 发布(GitPub)入口; - 填写发布信息:插件源码目录、仓库名、仓库简介、设计要求、语言模式、仓库可见性,并粘贴你的 Personal Access Token(获取方法见下方教程);
- 点击「发布」,系统自动创建一个专用 AI 会话;
- 该会话自动完成:创建 GitHub 仓库 → 上传插件本体 → 添加
dsh-plugin话题 → 生成中英双语 README 与封面 → 推送到 GitHub; - 发布完成后,继续在该会话中提出修改、修复、界面美化需求即可,全程无需离开 Harness。
获取 Personal Access Token(保姆级教程)
发布插件需要 GitHub 的 Personal Access Token(个人访问令牌),它相当于一把"发布专用钥匙"。按以下步骤操作,全程约 2 分钟:
- 打开 GitHub 并登录:浏览器访问 ,输入账号密码登录(没有账号先点 Sign up 注册一个);
- 进入设置:点击页面右上角你的头像 → 在下拉菜单中点击 Settings(设置);
- 找到开发者设置:在左侧设置菜单中一直向下滚动,点击最底部的 Developer settings(开发者设置);
- 进入令牌页面:在左侧菜单点击 Personal access tokens(个人访问令牌) 将其展开,然后点击 Tokens (classic)(经典令牌);
直达链接:(登录后直接打开此链接也可以)
- 新建令牌:点击右上角绿色按钮 Generate new token,在下拉菜单中选择 Generate new token (classic);
- 填写备注:在 Note(备注) 输入框中填写说明,例如
dsh-github-publish,方便日后辨认; - 设置有效期:在 Expiration(有效期) 中选择过期时间,推荐
30 days(发布一次足够用,越短越安全); - 勾选权限:在 Select scopes(权限) 区域勾选
repo(勾选后整个 repo 分组会自动选中,包含repo:status、repo_deployment、public_repo等子权限)——这是发布仓库必需的权限; - 生成令牌:点击页面底部绿色按钮 Generate token;
- 复制令牌:生成后页面顶部会出现一行以
ghp_开头的字符串,点击右侧的复制按钮复制;
重要:这串字符只显示这一次,关闭或刷新页面后就再也看不到了,务必立刻复制并妥善保存; 11. 粘贴到插件:回到 DeepSeek Harness → 设置页 → Git 发布,把令牌粘贴到 Personal Access Token 输入框中(仅本次使用,不会保存); 12. 点击发布:完成其余信息填写后点击「发布」,AI 会话会自动完成建仓、上传、美化、推送; 13. 用完即删(推荐):发布完成后,回到 ,点击该令牌右侧的 Delete 将其删除,彻底杜绝泄露风险。
路径速查:github.com → 头像 → Settings → Developer settings → Personal access tokens → Tokens (classic) → Generate new token (classic)
常见问题:
- 提示 401/403 或权限不足:检查是否勾选了
repo权限、令牌是否已过期;直接重新生成一个新令牌即可;- 令牌被拒:确认复制时没有多出空格或漏掉字符,重新复制粘贴一次;
- 安全问题:令牌等同于密码,不要发给任何人、不要写进代码或聊天记录;本插件只会用它访问你自己的仓库,且仅通过环境变量注入,绝不落盘。
配置说明
| 配置项 | 位置 | 说明 |
|---|---|---|
DSH_HOME | 环境变量 | DSH 数据根目录,默认 %USERPROFILE%\.dsh |
| web profile | $DSH_HOME\profiles\web\ | Web 插件依赖与补丁所在的 profile 目录 |
package.json | web profile 内 | dependencies 声明插件包 |
cordis.patch.yml | web profile 内 | 用户补丁层,在 insert 列表加入插件的 id/name |
cordis.patch.yml 示例(把 dsh-github 插入到某个现有行之后):
- id:
insert:
- dsh-github
锚点行 id 以当前组合树为准,可运行 dsh --profile web --dump-config 查看。
Token 安全:GitHub Token 只通过环境变量注入(如 $env:GHPUB_TOKEN = (Get-Content -Raw 路径).Trim()),
绝不写入任何会被提交的文件,也不会在对话中明文出现。