🐙 dsh-github-workbench · GitHub 工作台

把 GitHub 装进 DeepSeek Harness 的侧边栏:仓库目录树 + Issues / Pull requests / Actions 页签,读之外直接建 Issue、发 PR、评论、合并、重跑 CI。

人在面板里亲自点按钮 = 天然的人类审批,无需任何额外审批链。

0.3.x 页签优先注册 DSH 官方原生右侧栏。

⭐ 欢迎点星收藏

如果 GitHub 工作台帮到了你，欢迎到 GitHub 仓库 点个 Star ⭐，让更多 DSH 用户看到它。问题与建议请提 Issue。

📋 兼容性

| 插件版本 | 状态 | 对应 DSH | |---|---|---| | 0.3.x（当前主线） | ✅ | 0.1.5-rc.1 / 0.1.5-rc.2（及之后的 0.1.5 线；页签走官方原生右侧栏） | | 0.2.x | 🔧 维护态（仅修 bug） | DSH ≤ 0.1.2-rc.1（仍兼容 0.1.1-rc.2 / 0.1.2-alpha.4；better-sidebar 页签或独立面板） |

本次升级功能变化

• 页签宿主迁移：DSH 0.1.5+ 优先注册官方原生右侧栏（ctx.sidebarRightTabs），better-sidebar 降为旧宿主回退，独立面板兜底不变。
• 官方已有的交给官方：不画赞踩、不画交付文件卡；聊天里的 GitHub 链接接管仍依赖旧宿主，原生形态暂不覆盖。
• 0.3.x 在 DSH 0.1.2 + better-sidebar 上 页签会退化成独立面板；要旧页签请留在 0.2.x。

✨ 截图速览

| Code:远端目录树 + 文件预览 | Issues 列表 | |---|---| | | |

| Issue 详情 + 评论/编辑/关闭 | Pull requests(checks 摘要 / 合并三法) | |---|---| | | |

| Actions(runs 列表,悬停 重跑/取消) | 仓库切换弹层(自动拉取 + 公开仓搜索) | |---|---| | | |

| ⚙ 设置(Token / 自动刷新 / 字号) | 收件箱(Issues / PR / Actions 三分栏) | |---|---| | | |

🚀 核心能力

• 双形态挂载:已装 dsh-better-sidebar → 注册为侧边栏页签;独立安装 → 自动降级为对话区右侧可展开/收起的自绘面板(同一套组件,运行时自动协商)
• Code:目录树一次拉取(git/trees?recursive=1)+ 文本文件行号预览(<900KB);二进制/超大文件降级为 GitHub 外链;<600px 时树自动收进「目录」抽屉
• Issues / PR 全量列表:Search API(is:issue / is:pr)不被 PR 占坑;默认按最新创建排序,可切最近更新;页签角标与工具条显示真实总数;底部「加载更多」翻页;PR 拆成开放 / 已关闭(未合并) / 已合并
• 写操作全家桶:新建 Issue / 新建 PR(head·base 可选)/ 评论 / 编辑标题正文 / 编辑删除评论 / 关闭重开 —— 关闭与删评有确认门
• 合并三法强确认:merge / squash / rebase 下拉选择,执行前弹窗展示方法与目标分支
• CI 控制:runs 列表实时状态图标,行悬停 ⟳ 重跑、✕ 取消(取消需确认),点击直达原 run 页
• 仓库切换器:打开即列出 Token 可见全部仓库(owner/协作/组织,滤 archived,按推送排序)+ 输入实时过滤 + 公开仓库搜索(≥3 字符去抖触发,⭐ 排序)+ 最近使用置顶 + 首次打开自动识别当前工作区 .git/config;他人的仓可一键从列表移除(本地隐藏,管理页可恢复)
• 🔗 聊天链接接管:在 ⚙ 开启「接管聊天中的 GitHub 链接」后,对话里出现的任何 github.com 链接点击即在工作台打开——自动切仓、自动落到对应 Issues/PR 详情;每个链接独立实例互不干扰(需 better-sidebar v0.13+,开关位于本插件侧边卡片齿轮内)
• 收件箱:Issues / PR / Actions 三分栏。Issues·PR 监视 Token 可见公开仓的新建单;Actions 只盯当前仓+最近最多 5 个公开仓。点行跳到对应页签,「返回原仓页」回到进箱前。未读露在头部数字、侧栏 tab 角标、独立竖条
• ↗ 浏览器直达:顶部工具栏一键在系统浏览器打开当前仓库
• 原生观感:全站唯一 16px octicon 风格 SVG 图标集;颜色全部消费宿主 --dsw-* 设计令牌,深浅主题与皮肤自动跟随;字号默认跟随 DSH 侧边栏(12px),⚙ 内可调 13/14

🔑 Token 与隐私

⚙ 设置里填 Personal Access Token(仅存浏览器 localStorage / 宿主 pluginSettings,不经过任何服务端、不进会话上下文):

| Token 类型 | 权限 | |---|---| | 细粒度(推荐) | Contents R · Issues RW · Pull requests RW · Actions RW | | 经典 | repo(需要改 workflow 文件时另加 workflow) |

无 Token 可浏览公开仓(匿名 60 次/h,不可写);页脚实时显示 core 限额剩余。

📦 安装

# 方式〇:npm 安装(推荐)
npm i -g dsh-github-workbench   # 或 pnpm add -g
dsh plugin --profile web add dsh-github-workbench

# 方式一:从 GitHub 直接装(dsh CLI,免 npm)
dsh plugin --profile web add github:meyaomiao/dsh-github-workbench

# 方式二:克隆后本地挂载
git clone https://github.com/meyaomiao/dsh-github-workbench.git
cd dsh-github-workbench && pnpm install && pnpm build
dsh plugin --profile web add .

# 然后在 ~/.dsh/profiles/web/cordis.patch.yml 启用:
#   - insert:
#       - id: github-workbench
#         name: 'dsh-github-workbench'
# 重启 dsh web + 浏览器硬刷新

也可在 dshmarket 或 better-sidebar「添加插件」中搜索 dsh-github-workbench。

🧩 平台集成细节(给插件开发者)

• 消费 ctx.betterSidebar:inject=['betterSidebar'](cordis 访问授权)+ package.json dsh.client.inject 声明 bundle 依赖 dsh-better-sidebar(loader 加载顺序)——两层缺一不可,否则服务访问被代理拒绝或模块被跳过(踩坑实录见源码注释)
• 根节点流式撑满 TabContent(不用 absolute inset:0,避免逃逸覆盖侧边栏框架)
• 容器查询三档自适应(<600 抽屉态 / ≥720 / ≥1000);visible=false 时暂停轮询省配额

🛠 开发

pnpm install
pnpm build        # esbuild 双入口:host(esm) + client(ModuleLoader 包装 cjs)
pnpm typecheck    # tsc --noEmit(strict)
pnpm test         # node:test 纯函数单测

设计文档与交互视觉稿:docs/design.md · design/mockup.html

改仓库前先读 CONTRIBUTING.md（Issue → 分支 → Draft PR）。思考原则见 AI-ISSUE-WORKFLOW.md。

License

MIT © meyaomiao