GitHub 只读连接器 hh719509125/deepseek_harness_plugin

DeepSeek Harness 插件

English · 中文说明

DeepSeek Harness（DSH）的插件。每个插件都是一个自包含的 DSH bundle —— 一个普通目录，目录里的 package.json 声明了它通过 dsh.bundle.patch 插入的 composition rows。安装插件不需要发布到 npm，也不需要手动改配置档。

| 插件 | 位置 | 功能 |
| github-connector/ | 本仓库 | 只读 GitHub 工具 —— github_api、github_search、github_file、github_issues —— 用 Personal Access Token 鉴权，另有一个 token 设置页。 |
| Preview Editor | hh719509125/dsh-preview-editor | 在侧边栏文档预览里就地编辑文本文档 —— 保存/还原、Ctrl+S、冲突保护、逐字节保留行尾。它独立成了自己的仓库，这样才能被单独找到、加星和安装。 |

安装

让你的 DSH 智能体直接从 GitHub 安装 —— 不用发布到 npm，也不用手动 clone：

plugin_manager { action: "install_bundle", target: "github:hh719509125/deepseek_harness_plugin#path:/github-connector" }
plugin_manager { action: "install_bundle", target: "github:hh719509125/dsh-preview-editor" }

#path:/<subdirectory> 是 pnpm 的 git 子目录写法，所以合集仓库可以放多个包；预览编辑器有自己的仓库，写法里不需要 path。返回 "application": "applied" 就表示装上了 —— 然后刷新一次页面，因为浏览器那一半是随页面加载的。

固定版本。 把 ref 放在对应写法要求的位置：

| 插件 | 写法 |
| github-connector | …#v1.0.0&path:/github-connector —— ref 放在 &path: 前面 |
| preview editor | github:hh719509125/dsh-preview-editor#v1.0.0 —— ref 放在 # 后面 |

两种写法里，ref 都必须是分支、tag，或者完整的 40 位 commit SHA —— 缩写的不行，因为 git ls-remote 永远不会返回缩写。

权限。 每个 plugin_manager 操作都需要 danger-full-access，或者逐次批准。装上的 Host 代码以你的用户身份在进程内运行，不受工作区沙箱约束 —— 信任级别等同于在 Harness 里跑 bash。安装前请先读源码。

用法、配置和限制写在每个插件自己的 README.md 里。

兼容性

两个插件都针对 DeepSeek Harness 0.2.0-rc.2 构建并验证过，而且都依赖 DSH 的内部约定——预览编辑器依赖 Connection 精确的 /api Fetch 路由和预览的 documentPreviews 渲染器注册表，连接器依赖 ctx.tools 注册表。这些约定不保证在候选版本之间保持稳定。两个插件都故意不声明 peerDependencies：官方包 peer 的是 @deepseek-ai/cordis，范围写错会让插件管理器直接拒绝安装，这比运行时错误更难排查。如果某个工具或渲染器没出现，先检查 DSH 版本。

Layout

.
├── .gitattributes # stored as LF
├── .gitignore
├── LICENSE # MIT, covers the whole repository
└── github-connector/ # one complete plugin package

每个插件目录都是自包含的——package.json、Host 半边、Client 半边、cordis.patch.yml、语言文件、图标，以及自己的 LICENSE——所以单独复制一个目录出来照样能装。

中文说明

给 DeepSeek Harness（DSH）用的插件集合。每个插件都是一个独立、可单独安装的 DSH 组合包（bundle）：一个普通目录，靠 package.json 里的 dsh.bundle.patch 声明要插入的组合行。不需要发布到 npm，也不用手改 profile 的 package.json。

| 插件 | 位置 | 作用 |
| github-connector/ | 本仓库 | 用 Personal Access Token 只读访问 GitHub：github_api、github_search、github_file、github_issues 四个工具，以及一个令牌设置页 |
| 文档编辑 | hh719509125/dsh-preview-editor | 在右侧栏的文档预览里直接编辑文本文件：保存/撤销、Ctrl+S、冲突保护、行尾逐字节保留。它已经独立成一个仓库，方便被单独搜到、收藏和安装 |

快速上手

前提：DSH 已经装好、能打开界面。

1. 装 —— 把下面这条规格发给你的 DSH agent（插件由 agent 安装，用户不直接调用 plugin_manager）：

plugin_manager { action: "install_bundle", target: "github:hh719509125/deepseek_harness_plugin#path:/github-connector" }

想装文档编辑插件，用 github:hh719509125/dsh-preview-editor。返回 "application": "applied" 即成功。

2. 刷新一次页面 —— 安装对 Host 是热生效的，但浏览器侧要重新加载一次才会出现插件贡献的界面。

3. 用：

| 插件 | 装完怎么用 |
| GitHub 连接器 | 设置 → GitHub 页粘贴 Personal Access Token，点「测试并保存」；之后直接让 agent 用它查 GitHub |
| 文档编辑 | 右侧栏按 Ctrl+P 打开文件树，点一个 .txt / 代码 / .json 文件 → 打开就是编辑器，改完 Ctrl+S |

细节、配置项和边界都在各插件自己的 README.md 里。

安装

插件由 agent 安装（plugin_manager 是 agent 工具，用户不直接调用）。

| 插件 | 安装规格 |
| GitHub 连接器 | github:hh719509125/deepseek_harness_plugin#path:/github-connector |
| 文档编辑 | github:hh719509125/dsh-preview-editor |

#path:/<子目录> 是 pnpm 的 git 子目录规格，所以本仓库可以放多个包；文档编辑插件是独立仓库，规格里不需要 #path:。

锁定版本

ref 的位置两种规格不一样，容易踩：

| 插件 | 规格 |
| GitHub 连接器 | …#v1.0.0&path:/github-connector —— ref 在 &path: 前面 |
| 文档编辑 | github:hh719509125/dsh-preview-editor#v1.0.0 —— ref 在 # 后面 |

两种情况都：ref 可以是分支、标签或完整的 40 位 SHA；短 SHA 解析不了（git ls-remote 不返回缩写 SHA）。
智能体会依次：从 GitHub 取包 → 作为依赖写进 profile 的 package.json → 在 profile 目录里运行 pnpm → 把包名加入 dsh.profile.bundles → 应用组合包自带的 patch 行。返回 "application": "applied" 即为生效。

两点注意：

- 权限：plugin_manager 的每个动作都需要 danger-full-access 或当次批准。装进来的 Host 代码在工作区沙箱之外、以你的用户身份在本进程内执行——和在 Harness 里跑 bash 是同一层信任，装之前请先读一遍源码。
- 刷新页面：安装是热应用的，但浏览器侧需要刷新一次才能加载新的 client bundle。

另一种装法（想固定版本或离线）：克隆仓库，然后把插件目录的绝对路径作为规格（文档编辑插件就是克隆后的仓库根目录）：

git clone https://github.com/hh719509125/deepseek_harness_plugin.git
plugin_manager { action: "install_bundle", target: "<克隆路径>/github-connector" }

⚠️ 路径装法下 profile 只记录路径、不复制文件，装好之后不要移动或删除那个目录。

兼容性

两个插件都是为 DeepSeek Harness 0.2.0-rc.2 开发和验证的，并且各自依赖 DSH 的内部约定：文档编辑依赖 Connection 的 /api 精确 Fetch 路由和预览的 documentPreviews 渲染器注册表；GitHub 连接器依赖 ctx.tools 工具注册表（较稳定）。DSH 仍在 rc 阶段，这些不承诺跨版本稳定。插件刻意没有声明 peerDependencies——官方包声明的是 @deepseek-ai/cordis，而声明错的 peer 会让插件管理器在安装前就拒绝，那比装完再报错更难排查。所以：装完如果某个工具/渲染器不出现，先确认 DSH 版本。

目录结构

.
├── .gitattributes # 统一按 LF 存储 ├── .gitignore # 仓库级忽略（node_modules、日志、本机 CA） ├── LICENSE # MIT，覆盖整个仓库 └── github-connector/ # 一个完整插件包

每个插件目录都是自包含的：package.json、Host 半边、Client 半边、cordis.patch.yml、locale、图标，以及自己那份 LICENSE。所以从仓库里单独拷一个目录出去也能直接装。文档编辑插件是另一个仓库里的完整包。

开发提示

- 机器相关配置放 profile 层，别写进插件包。 插件包自带的 cordis.patch.yml 会应用到每一个安装它的 profile，所以绝对路径、本机证书这类东西要写到 <DSH_HOME>/profiles/<profile>/cordis.patch.yml——它优先级高于所有 bundle 层，而且不会被发布出去。热重载的 hmr.root 就是这么配的，见各插件 README 的「开发」一节。
- 热重载：Host 半边（index.js）改完自动热重载，不用重启；Client 半边（client.js）属于浏览器侧，改完刷新页面即可。
- 不要就地改布局：如果某个插件目录同时是一个 git 仓库（历史遗留），不要在那个目录里重排文件——DSH 的 profile 是按路径 link: 的，挪文件会让在线插件立刻加载失败。要改布局就在单独的检出里做。
- 发布用 _tools/publish-plugins.ps1（本地脚本，不在仓库里）：它按显式白名单把插件源同步进对应检出、显示 diff，加 -Push 才提交推送，所以本机忽略文件、CA 证书、散落产物都进不了仓库。
- 每个插件的 README 里都写了验证方式和已知边界，改之前先看一眼。

License

MIT