Skip to content
Back to search

dsh-ntr

SkillWorks with Claude CodeGitHub

让你的Deepseek harness成为一个统一的agent入口,轻松接入codebuddy、claude code、opencode、qoder | Make your Deepseek harness a unified agent gateway for easy integration with CodeBuddy, Claude Code, OpenCode, Qoder, and more.

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked yesterday

Check it deeper on your machine

It has changed since its scan on 18 Nov 2026.

As a Claude Code plugin, install it and then ask Claude Code:

/plugin marketplace add keithmackay/mackayi/plugin install scanskillsafety@mackayiDo a deep scan of https://github.com/GDWhisper/dsh-ntr with scanskillsafety

Or from a terminal, clone it and run it:

git clone https://github.com/keithmackay/scanskillsafety-skill ~/.claude/skills/scanskillsafetynode ~/.claude/skills/scanskillsafety/cli.cjs --deep 'https://github.com/GDWhisper/dsh-ntr'

It checks the exact commit: every file, its packages against OSV (api.osv.dev), how it compares with this page's scan (findsafeskills.com receives the repository's address), and, if you agree, Claude reading every file with your own Claude subscription. It never runs the code.

Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/gdwhisper--dsh-ntr/badge.svg)](/listings/gdwhisper--dsh-ntr)

HTML

<a href="/listings/gdwhisper--dsh-ntr"><img src="/api/listings/gdwhisper--dsh-ntr/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

本插件是一个 DSH **bundle**:`package.json` 的 `dsh.bundle.patch` 声明了随包分发的两层补丁——插件本体的 `cordis.patch.yml`,与 NTR 模式 preset 的 `presets/acp/acp.patch.yml`。用 `dsh plugin` 安装后,包会加入 profile 的 `dsh.profile.bundles`,补丁层**自动生效**,无需手动编辑任何配置文件。

方式一:从官方界面安装

打开 DSH 侧边栏的**插件**页,点**添加插件**,输入 `dsh-ntr`,点安装。装完刷新页面即可使用。

> DSH 的 npm 渠道有 24 小时防范期:刚发布的版本 24 小时内不算「最新版」,只输 `dsh-ntr` 装到的可能还是旧版。想马上用新版,把版本号一起写上,例如 `dsh-ntr@0.1.5`;不急的话,等防范期过去再照常安装或升级。

方式二:从 npm registry 安装

dsh plugin --profile web add dsh-ntr@latest

升级重跑同一条命令即可。

> `add` 时**务必带 `@latest`**:不带的话包管理器会一直复用首次写入的版本号,之后连 `update` 也升不上去。

方式三:经 [dsh-market](https://github.com/dsh-market/dsh-market) 插件市场安装

先装市场本体:

dsh plugin --profile web add dshmarket

重启 `dsh web`,打开**插件**页:dsh 0.2.1 起市场是「已安装」旁边的**插件市场**标签页;更早的版本在**设置 → 插件市场**。搜索 `dsh-ntr`,确认来源后一键安装,装完刷新页面即可使用;之后的更新检查与升级也在市场里完成。官方 DSH 桌面 App 自带这个市场,直接在 App 的**插件**页里搜索安装即可。

> 市场的插件清单来自 [awesome-dsh-plugin](https://awesome-dsh-plugin.com) 精选目录,每天自动刷新。若搜索结果里暂时没有 `dsh-ntr`,用方式二从 npm 安装,不影响使用。

方式四:从源码安装

需要 Node.js ≥ 22.12.0。

git clone https://github.com/GDWhisper/dsh-ntr.git
cd dsh-ntr
npm install        # 安装构建依赖(typescript 等)
npm run build      # 编译宿主 TS 与浏览器 Bundle 到 lib/(构建产物不入库,此步必须执行)
dsh plugin --profile web add ./

之后升级:`git pull` → `npm run build` → 重启 `dsh web`。`add .` 以 `link:` 方式安装,重建后重启即生效,不需要重新 add。

> 从源码安装切到 npm / 市场版前,先在插件管理器里卸载旧版,并删掉 profile 里的 `node_modules/dsh-ntr`。pnpm 的 hoisted 布局会把 `link:` 目标里的 `node_modules` 留在包目录内,旧依赖会遮蔽新装的 SDK,典型报错见「常见问题」里的 `EPERM ... zod`。

> `dsh plugin` 是 pnpm 转发器,`--profile <name>` 必填;`add .` 会把当前目录以 `link:` 方式装进 profile。官方桌面 App 的 profile 由它自己的插件管理器掌管,不要对着它的 profile 跑命令行。

---

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 329 lines
  1. # dsh-ntr
  2. [English](./README.en.md) | 简体中文
  3. 在 [DSH(DeepSeek Harness)](https://github.com/deepseek-ai/deepseek-harness) 的网页/桌面端里,用你习惯的界面,直接和任意一个 **ACP agent**(CodeBuddy、Pi、Oh My Pi、Claude Code、OpenCode、Qoder 等)对话。
  4. **DSH 提供界面,agent 提供能力。** 会话列表、输入框、侧栏、消息展示全部来自 DSH;推理、工具执行、文件读写、权限判断全部由你自己配置的那个 agent 完成,它跑在独立进程里,完全自治。这个插件只做一件事:把两边接通,并把 agent 的输出原样画到 DSH 的界面上。
  5. > 模型选择、思考等级、工作模式都是 **agent 自己的概念**,不是 DSH 的模型目录。插件不替你换模型,也不会把 agent 的选择写进 DSH 的全局设置。
  6. ![dsh-ntr:在 DSH 里用 NTR 模式与 ACP agent 对话,模型、思考等级与工具活动都留在原生界面里](./docs/images/ntr-session.png)
  7. ---
  8. ## NTR 是什么
  9. **NTR = Negotiated Target Routing(协商式目标路由)**。
  10. 一句话:你的宿主 Agent 作为 ACP 客户端,和目标 Agent 协商能力与权限,把这一轮任务交给它执行。
  11. ---
  12. ## 安装
  13. 本插件是一个 DSH **bundle**:`package.json` 的 `dsh.bundle.patch` 声明了随包分发的两层补丁——插件本体的 `cordis.patch.yml`,与 NTR 模式 preset 的 `presets/acp/acp.patch.yml`。用 `dsh plugin` 安装后,包会加入 profile 的 `dsh.profile.bundles`,补丁层**自动生效**,无需手动编辑任何配置文件。
  14. ### 方式一:从官方界面安装
  15. 打开 DSH 侧边栏的**插件**页,点**添加插件**,输入 `dsh-ntr`,点安装。装完刷新页面即可使用。
  16. > DSH 的 npm 渠道有 24 小时防范期:刚发布的版本 24 小时内不算「最新版」,只输 `dsh-ntr` 装到的可能还是旧版。想马上用新版,把版本号一起写上,例如 `dsh-ntr@0.1.5`;不急的话,等防范期过去再照常安装或升级。
  17. ### 方式二:从 npm registry 安装
  18. ```bash
  19. dsh plugin --profile web add dsh-ntr@latest
  20. ```
  21. 升级重跑同一条命令即可。
  22. > `add` 时**务必带 `@latest`**:不带的话包管理器会一直复用首次写入的版本号,之后连 `update` 也升不上去。
  23. ### 方式三:经 [dsh-market](https://github.com/dsh-market/dsh-market) 插件市场安装
  24. 先装市场本体:
  25. ```bash
  26. dsh plugin --profile web add dshmarket
  27. ```
  28. 重启 `dsh web`,打开**插件**页:dsh 0.2.1 起市场是「已安装」旁边的**插件市场**标签页;更早的版本在**设置 → 插件市场**。搜索 `dsh-ntr`,确认来源后一键安装,装完刷新页面即可使用;之后的更新检查与升级也在市场里完成。官方 DSH 桌面 App 自带这个市场,直接在 App 的**插件**页里搜索安装即可。
  29. > 市场的插件清单来自 [awesome-dsh-plugin](https://awesome-dsh-plugin.com) 精选目录,每天自动刷新。若搜索结果里暂时没有 `dsh-ntr`,用方式二从 npm 安装,不影响使用。
  30. ### 方式四:从源码安装
  31. 需要 Node.js ≥ 22.12.0。
  32. ```bash
  33. git clone https://github.com/GDWhisper/dsh-ntr.git
  34. cd dsh-ntr
  35. npm install # 安装构建依赖(typescript 等)
  36. npm run build # 编译宿主 TS 与浏览器 Bundle 到 lib/(构建产物不入库,此步必须执行)
  37. dsh plugin --profile web add ./
  38. ```
  39. 之后升级:`git pull` → `npm run build` → 重启 `dsh web`。`add .` 以 `link:` 方式安装,重建后重启即生效,不需要重新 add。
  40. > 从源码安装切到 npm / 市场版前,先在插件管理器里卸载旧版,并删掉 profile 里的 `node_modules/dsh-ntr`。pnpm 的 hoisted 布局会把 `link:` 目标里的 `node_modules` 留在包目录内,旧依赖会遮蔽新装的 SDK,典型报错见「常见问题」里的 `EPERM ... zod`。
  41. > `dsh plugin` 是 pnpm 转发器,`--profile <name>` 必填;`add .` 会把当前目录以 `link:` 方式装进 profile。官方桌面 App 的 profile 由它自己的插件管理器掌管,不要对着它的 profile 跑命令行。
  42. ---
  43. ## 快速开始
  44. ### 你需要什么
  45. 1. 一个已经装好的 DSH(Web 或桌面版)。
  46. 2. 至少一个支持 ACP 协议的 agent,用它的终端版本(CLI / TUI)即可。例如 Qoder CLI(`qodercli`)、CodeBuddy Code(`codebuddy`)、Claude Code、OpenCode——插件内置了这些常见预设;其他 agent 只要能以类似 `xxx --acp` 的方式从命令行启动,也可以直接填。
  47. ### 三步接入
  48. 1. 打开 **设置 → NTR**。
  49. 2. 在「Agent 列表」里选一个预设一键填入,或点「从零新建自定义 Agent」手填启动命令。
  50. 3. 点「测试」。成功会显示 agent 的名字和握手耗时;失败会显示可操作的错误和 stderr 尾部。
  51. 保存后,这个 agent 就出现在输入框行尾的 NTR 底座里。
  52. ### 开始对话
  53. 1. 新建一个会话,在模式选择里选「**NTR 模式**」。
  54. 2. 在输入框行尾的 NTR 底座里选一个 agent。
  55. 3. 直接说话。
  56. agent 的回复和思考显示在主聊天区。工具活动按发生顺序插在它们中间:一行 `🛠️ **工具名** · 参数`,输出跟一个代码块。agent 一披露参数,命令就出现在行里——工具还在运行也照样显示,不必等它结束。agent 派发后台子代理时会先回复「已派…」,你可以继续对话;子代理跑完后的报告在 **NTR** 视图里。想看完整的工具输出、计划和 diff,切到对话头部的 **NTR** 标签页。
  57. ---
  58. ## 你会用到的界面
  59. ### NTR 底座(输入框行尾)
  60. 点一下,选哪个 agent 服务这条会话。这个菜单里只有 agent 列表——一个控件一件事。agent 自己的模型和思考等级是同一行里各自独立的芯片,各开各的菜单;如果 agent 还发布了额外配置项(温度、供应商开关等),模型芯片左边会多一个「高级」底座,点开逐项设置。首轮之前 agent 底座固定在行尾最右侧;锁定后它退场,模型和思考等级接管右端。那些清单由 agent 自己上报,不是你熟悉的 DSH 模型列表。
  61. 底座只出现在 **NTR 模式**的会话里。普通会话里看到的是 DSH 原生的模型选择器。
  62. **一个会话一个 agent。** 首条消息发出前,底座一直在,你可以先选好、也可以反悔改选。首轮**开始**时会话就**锁定**在这个 agent 上:底座粉碎,名字变成**输入框卡片上边缘的小挂牌**(`NTR · <agent>`,骑在顶边上),挂牌只显示、不能点击——换 agent 请新建会话。模型、思考等级和「高级」芯片留在原位,它们属于同一个 agent,不涉及上下文迁移。如果首轮还没产生任何可见输出就失败/取消,锁定会自动回滚,底座回来,可以直接重选。
  63. ### `/` 命令属于 agent
  64. 在 NTR 会话里输入 `/`,弹出的是 **agent 自己的命令清单**——它通过 ACP 声明的那些(例如 `compact`、`session`、`model`),不是 DSH 的命令。选中一项只是把命令名填进输入框;回车后整行原样发给 agent,由它执行。清单在**第一条消息之前**就能用:宿主记住了这个 agent 上次会话声明的命令(从没跑过的 agent 要等第一轮之后才有)。
  65. DSH 自己的 `/model`、`/permission`、`/export` 等在这一模式下**不会**被宿主截走:同名命令也交给 agent,宿主命令菜单与技能补全不会出现。普通会话的斜杠行为完全不变。
  66. ### 审批与 agent 自己的权限模式
  67. agent 要动敏感的东西时会问你。询问卡出现在对话里、聊天输入框上方(插件自己的卡片),选项就是 agent 给的那些,你点哪个它照着做;设置页的「待处理权限请求」是跨会话镜像,对话没打开时在那里回答。
  68. 每个 agent 问法不一样:有的给一组选项,有的只给允许/拒绝,有的会附上它要执行的具体命令。插件把这些原样呈现给你,不预先替你决定。
  69. **权限模式由 agent 自己定义。** 每个 agent 在输入框工具行给出它自己的模式清单(例如 `Always Ask`、`Accept Edits`、`Plan`、`Bypass Permissions`),选项文字就是 agent 下发的原文。你切换模式,agent 就按新模式决定什么时候来问你。插件不另设一套权限档,也不替你翻译这些模式名。
  70. > **注意**:DSH 自己的「访问模式」(只读 / 工作区写入 / 完全权限)管不到外部 agent。那个 agent 在自己的进程里,DSH 的文件沙箱对它没有作用力。真正生效的是 agent 自己的权限模式,以及它向你发起的那些审批。
  71. ### NTR 标签页
  72. 对话头部的 **NTR** 标签页显示 agent 的原始流:
  73. - 计划和待办清单
  74. - 每次工具调用的名称、状态、输出(默认折叠,点开看全部)
  75. - 代码改动的 unified diff,带 `+N -M` 行数统计
  76. - 用量读数
  77. 这个标签页是只读的:它不发消息、不取消任务、不启动进程。实时跟随,不需要手动刷新。
  78. **主聊天区和 NTR 标签页的分工**:人和 agent 的对话在主聊天区,工具活动也按时间顺序内联在那里;NTR 标签页放主聊天区装不下的东西——计划、完整输出、diff、用量。
  79. ### 设置 → NTR
  80. - **已接入的 NTR 智能体**:每个 agent 一行,标着进程状态。点开「展开配置与模型」看全部细节。
  81. - **`★ 默认`**:新建 NTR 会话默认用哪个 agent。
  82. - **每张 agent 卡片**:显示名、启动命令、npm 包名、环境变量、工作目录,全部直接摆在你面前,没有藏起来的默认值。
  83. - **启动命令是一整行**:程序加参数,例如 `codebuddy --acp`。含空格的路径用引号包住。输入框下方会实时显示插件解析出的「程序 / 参数」。
  84. - **测试按钮**:用当前表单里的值拉起一个一次性进程做握手,不保存、不注册。适合在改配置前先验证。
  85. - **工作区目录**:agent 在哪个目录里干活。
  86. - **对话中可见的模型**:agent 能报几百个模型时,这里挑你想在模型芯片菜单里看到的。没勾的仍然可用,只是不列出来。
  87. ### 你的工作区
  88. 在对话里起的 NTR 会话,工作目录就是你在这个 DSH 会话里选中的那个目录(侧栏点的那个)。对端 agent 的读文件、搜索、执行命令都在那里,它自己的进程也从那里启动。
  89. 有一类 agent 在进程启动那一刻就把工作区定死了,只改会话参数它不听。插件在它没有活动会话时会把它搬到新目录;有会话在进行时就保持原进程,不打断你的对话。
  90. ---
  91. ## 常见问题
  92. **会被平台风控吗?会封号吗?会把我的请求转发出去吗?**
  93. 不会转发。dsh-ntr 只负责在你本地启动 agent 自己提供的 ACP 入口,再通过 ACP 协议和它通信。插件不接触平台 API,也不转发任何请求;模型调用全部由本机的 agent 进程自己完成,和你在终端里直接用这个 agent 一样。
  94. 在按本插件的设计方式使用时,通常没有问题:接入目标是 agent 官方提供的 ACP 入口,账号、密钥和订阅来自官方渠道,用途不超出平台条款允许的范围。这属于官方支持的正常用法。
  95. 但插件无法替你判断第三方配置是否合规。如果你让 agent 去连第三方渠道或非公开接口,或用于超出条款的场景,风险由那套配置和用法决定。它们不在本插件的支持范围内,插件也不能保证这种情况下不被风控或封号。
  96. **为什么选完 agent 之后,输入框里没看到 DSH 的模型选择器?**
  97. 那是设计如此。NTR 会话里,模型是 agent 自己的概念,所以那个位置换成了 NTR 底座。切回普通模式的会话,原生选择器就回来了。
  98. **为什么首轮开始后,输入框行尾不显示 agent 名字了?**
  99. 一个会话一个 agent。首轮之前底座留着让你改选;首轮一开始,会话就锁在这个 agent 上,名字变成挂在输入框卡片上边缘的 `NTR · <agent>` 只读小挂牌。换 agent 会丢掉它这边的上下文,所以确认锁定后只能新建会话。模型、思考等级和高级配置芯片不受影响。首轮没有任何可见输出就失败/取消时,锁定会回滚,底座回来。
  100. **锁定后想换 agent 怎么办?**
  101. 新建一个会话重新选。已锁定的会话不会接受 `session/chat-bind` 的改绑(宿主返回 `agent_locked`),这是刻意的:新 agent 没有这段对话的上下文,假装切换只会得到一段失忆的对话。首轮没有产生任何可见输出就失败的情况例外:锁定会自动回滚,可以直接重选。
  102. **顶部看不到 NTR 标签页?**
  103. 每条会话都有这个标签页。这条会话还没绑过 agent 时,它是空的,会提示你去选一个。先在模式选择里选「NTR 模式」,再在 NTR 底座里选一个 agent。
  104. **agent 卡住不动了?**
  105. 可以放心点停止。插件会取消这一轮,并在 agent 不理会取消时强制收尾,会话不会永久卡住。agent 自己长时间无动静时,卡住的那一轮也会被收口(见 AGENTS.md 约束 23):声明了 `session/load` 的 agent,下一次发送会自动重启并恢复会话;没声明的会被重置,上下文丢失。卡的若是这条会话的首轮、且什么都没输出,锁定会回滚、该轮作废,下一条消息直接新建会话。agent 进程崩溃同理——支持恢复的会自动拉起并回放历史,不支持的要新建会话。
  106. **agent 只回了一个空气泡?**
  107. 一部分 agent 会把上游失败(认证、计费、配额)当成「正常结束」。插件检测到这种情况时会补一条告警,不让失败静默。
  108. **agent 没反应,也没报错?**
  109. 看设置页的测试按钮。它会在宿主侧跑一次完整的握手,把真正的错误(包括 stderr 尾部)显示出来。
  110. **模型列表太长或太短?**
  111. 模型芯片的菜单没有搜索框,所以模型是**按需勾选**的。去设置页那张卡片里勾你想看的。不勾就没有那些条目,避免几百个模型刷屏。
  112. **为什么 NTR 标签页里没有我发的消息?**
  113. 那个标签页只显示 agent 的原始流(它的计划、完整工具输出、diff、用量)。你和它的对话在主聊天区,工具活动按发生顺序内联在对话里。
  114. **为什么输入框里多了一个下拉,里面的选项我没见过?**
  115. 那是 agent 自己的权限模式,选项文字由它下发。每个 agent 的叫法不一样,插件照原样列出。它管的是 agent 什么时候来问你,与 DSH 的「访问模式」无关。
  116. **导入了 agent,但它的权限模式和别的 agent 不一样?**
  117. 正常。模式清单由每个 agent 自己声明(`session/set_mode` 下发),插件照原样列出,不统一翻译、也不补默认值。想改叫法要在 agent 自己的配置里改。
  118. **从源码安装切到 npm / 市场版后,启用时报 `EPERM ... zod`?**
  119. 这是旧依赖残留,不是插件缺文件:错误路径里会出现 `node_modules/dsh-ntr/node_modules/.pnpm/...`。源码安装用 `link:` 指向你的仓库;pnpm 的 hoisted 布局在切到 registry 版时会把包目录换成真实文件,但会留下链接目标里的 `node_modules`。这份旧树(旧版 `@agentclientprotocol/sdk` 及其失效的 `zod` 软链)会遮蔽新装的依赖,DSH 导入时 stat 到坏链就报 `EPERM`。处理:在插件管理器里卸载 `dsh-ntr`,删除 `~/.dsh/profiles/<profile>/node_modules/dsh-ntr`(或只删它下面的 `node_modules`),再重装并重启。桌面 App 的 profile 请直接在 App 的插件页卸载/重装,不要用命令行。
  120. **NTR 会话里出现 `Error: unknown tool "xxx"`,紧跟一行「已添加工具:xxx」,是什么?**
  121. 这是宿主给工具卡补执行记录时的显示层噪音,不是 agent 的工具调用失败。较新的宿主在组装请求前就冻结了这一步可用的工具集;执行阶段才出现的工具名进不了这一步,首次出现记 `unknown tool`,下一次组装请求时工具清单多了一项,补一行「已添加工具」。插件现在在 guard 挂载时就预注册保留的工具名 `dsh_ntr__acp_tool_call`:只要挂载早于本会话首次请求组装,schema 就会随第一份请求头一起下发,这对行不再出现;只有挂载时宿主的 tools 服务还没就绪或挂载注册失败、回落到执行阶段的惰性注册,才可能再看到一次;升级或热重载前就已存在的会话,下一份请求头仍可能补记一次「已添加工具」。0.2.1-rc.5 这类在 waterfall 里实时解析工具的宿主本来就不出现。
  122. 插件把所有工具调用收敛成这一个固定名字,完整命令仍原样留在卡片的参数区,所以不会按命令数量刷屏。
  123. 旧版本里这对行的数量随不同工具名的个数增长:有的 agent(例如 opencode2)把整条命令当作工具名上报,因此会刷出一大片。
  124. agent 的真实输出始终在 NTR 标签页。dsh-ntr 0.3.9 及更早版本聊天卡显示的是占位文字,0.3.10 已修正。升级到当前版本后,正常路径(挂载早于本会话首次请求组装)上不会再出现这一对。
  125. **Auto 权限档下,为什么每张 ACP 工具卡都报错?**
  126. 宿主对 Auto 档的每次工具调用会先跑一次实验性自动审查:先核对请求头里的工具 schema,再调用会话模型判断风险。NTR 会话的模型就是外部 ACP agent,插件不会把宿主这段内部提示转发给它,所以审查永远得不出结论,宿主拒绝每一张 ACP 工具卡并显示红色错误。agent 自己的工具照样在它自己的进程里执行完,只是卡片拿不到正常结果。这不是插件能绕过的宿主闸门,也没有修好;请改用非 Auto 的权限档。
  127. **为什么「已完成,用时 …」下面还留着一串中间过程文字?**
  128. 这不是插件的问题,是 DSH 宿主的对话显示设置。宿主默认「收起后显示的回复」为「全部回复」,会把本轮每条 assistant 正文(包括中间叙述)都保留在已完成的展开行下面,最终回答只是其中最后一条。想让过程收进「已完成」、只留最终回答,打开 **设置 → 通用设置 → 收起后显示的回复 → 仅最终回答**。过程内容仍可在「已完成」展开区和 NTR 标签页查看。
  129. ---
  130. ## 它能做什么(能力清单)
  131. - **任意 ACP agent**:内置常见预设,也可以接入任何支持 stdio 的 ACP agent。自定义 agent 带「自定义」徽标。
  132. - **多会话隔离**:多个会话可以同时跟不同 agent 对话,各自独立。
  133. - **流式展示**:用户消息、agent 回复、思考过程、工具执行、任务计划都是流式的。
  134. - **工具活动内联**:工具调用按发生顺序插进主聊天区,思考和回答分列它两侧,不分层。
  135. - **真实权限**:agent 的权限模式原样列出,它的每次权限询问也原样呈现,你答什么它收到什么。
  136. - **斜杠命令归 agent**:NTR 会话里 `/` 弹出的是 agent 自己声明的命令;DSH 的同名命令不会截走你的输入。
  137. - **断线重连**:浏览器刷新或断网后,历史按序补齐。agent 进程崩了,声明了 `session/load` 的会在下次发消息时自动恢复。
  138. - **空闲释放**:没有活动的 agent 进程会在空闲一段时候后自动退出,不占内存;空闲会话被挂起成可恢复状态,下一条消息经 `session/load` 恢复(只对声明了 `session/load` 的 agent 成立;没声明的仍要求没有活会话才释放进程)。窗口在设置页「进程管理」里调(1-60 分钟,默认 30 分钟),单个智能体可在其「高级」里单独覆盖。
  139. - **Windows 可用**:npm 全局安装的 agent 在 Windows 上也能正常启动和回收,不会残留后台进程。
  140. ---
  141. ## 配置参考(开发者)
  142. 以上是用户部分。以下写给要改这个插件、或要手工写配置文件的人。
  143. ### 最小配置
  144. 在 Profile 层的 `cordis.patch.yml` 里挂载。省略 `cwd` / `allowedCwdRoots` 时用插件自有工作区 `~/.dsh/dsh-ntr/workspaces`(保存时自动创建);`command` 是**一整条命令行**,含空格的路径用引号包住。
  145. ```yaml
  146. - id: dsh-ntr
  147. name: dsh-ntr
  148. config:
  149. agents:
  150. - id: pi
  151. title: pi coding agent (ACP)
  152. command: /path/to/bin/pi-acp # 例如 "codebuddy --acp"
  153. cwd: ~/.dsh/dsh-ntr/workspaces
  154. allowedCwdRoots: [~/.dsh/dsh-ntr/workspaces]
  155. ```
  156. 可选的 agent 字段:`npmPackage`(PATH 里找不到时自动 `npm install -g`)、`exposedModels`(NTR 座位菜单列哪些变体)、`idleTimeoutMs`(聊天进程的空闲释放窗口,`0` = 永不释放,默认 30 分钟)、`mcpServers`(额外交给 agent 连接的 MCP 服务器)。插件级还有 `transcriptMaxEntries`(会话事件缓冲上限,默认 600)与 `probeModelsOnBoot`(保留字段,启动时已不再为每个 agent 探测,见 `bootstrapCatalogs` 的注释)。可靠性超时与重试的默认值(`startupTimeoutMs`、`cancelFallbackMs`、`staleCancelRetryDelayMs`、`staleCancelMaxRetries`、`permissionTimeoutMs`、`permissionTimeoutMode`,以及卡死看门狗的 `turnStallMs` / `turnStallToolMs` / `turnStallTickMs`)见 [AGENTS.md](./AGENTS.md) 约束 12、13 与 23;设置页能改的都在设置页改,看门狗三个键只在配置文件里(`turnStallMs: 0` 关闭整个看门狗)。
  157. `mcpServers` 是**插件自己的形状**(每条必带 `name` 与 `transport`),不是 ACP 线格式——线格式里 stdio 那条不带 `type`,照线格式手写会被 agent 静默丢弃:
  158. ```yaml
  159. - id: pi
  160. command: pi-acp
  161. mcpServers:
  162. - name: codegraph
  163. transport: stdio # stdio 需 command;http / sse 需 url
  164. command: /opt/bin/codegraph
  165. args: ["serve", "--mcp"]
  166. env: { CODEGRAPH_INDEX: /srv/index }
  167. - name: remote
  168. transport: http
  169. url: https://mcp.example.com/mcp
  170. headers: { Authorization: "Bearer …" }
  171. ```
  172. 这些服务器在**建会话时**交给 agent,由 agent 自己拉起并使用;agent 自己配置的 MCP 服务器不受影响,这里只是额外追加。
  173. ### 构建与安装
  174. ```bash
  175. npm install # 依赖
  176. git config core.hooksPath .githooks # 启用提交钩子(拒绝 AI 署名 + 敏感词预检)
  177. npm run build # 宿主 TS 声明 + 浏览器 Bundle
  178. npm test # 测试套件
  179. dsh plugin --profile web add ./ # 挂载到 Web Profile
  180. ```
  181. `.githooks/commit-msg` 只校验提交信息:拒绝把 AI 工具写进 `Co-Authored-By` / `Generated with` 之类署名,普通正文与人类署名不受影响。`.githooks/pre-commit` 另扫暂存区内容,命中约定词汇就拒绝提交;确属必要可用 `git commit --no-verify` 跳过。`core.hooksPath` 是本地配置,clone 后执行一次即可。
  182. ### 实现要点
  183. 以下每条都对应一处真实故障,改代码前先读对应文档。浏览器半区经 `/acp` RPC 与 `/api/acp/stream` SSE 和宿主半区通信;宿主半区每会话一个 `AgentBridge`,经 stdio JSON-RPC 驱动 agent 子进程。
  184. 代码位置:`src/index.ts`(插件入口)· `src/protocol.ts`(共享类型)· `src/impl.ts`(纯宿主逻辑)· `src/bridge/`(子进程通信、回合、绑定、状态等宿主模块;`src/bridge.ts` 仅再导出)· `src/client/`(React 扩展)· `presets/acp/`(NTR 模式声明)· `~/.dsh/dsh-ntr/`(运行时落盘)。
  185. - **DSH 只出显示层**:插件不写全局默认模型,不接管宿主的模型目录,也不让 ACP 模型出现在 DSH 原生选择器里;唯一的模型层写入是 guard 用 `agent.model.select()` 把会话绑定记成该会话的模型选择(宿主 0.2.2+ 在 step preparation 前固定路由)。
  186. - **工作区即侧栏路径**:侧栏点开的目录必须成为 `session/new` 的 cwd **和** agent 子进程自己的 cwd。有一条 agent(codebuddy)在进程启动那一刻就定死工作区。
  187. - **NTR 模式 = agent preset**:由 `presets/acp/acp.patch.yml` 随包声明,不挂工具、不注入项目指令、不做 compaction,让模型可见的表面完全属于对端 agent。
  188. - **转发严格等于用户文本**:按 `source.kind === 'user'` 挑消息,不转发标题生成、compaction 这类辅助调用,也不拼任何边界叙述。
  189. - **逐步切分 = 原生交错的工具卡**:一个 ACP turn 按工具活动切成多个宿主 step——段以 `tool-call` 卡收尾即结束本次 stream,宿主落定消息、执行卡(真实输出经 guard 虚拟工具应答)、续跑下一步;续跑段续读同一个仍在飞的 `session/prompt`,绝不新发 prompt。卡片因此夹在两个 assistant 节点之间,与原生多步对话一致。
  190. - **绑定必须接到请求路径上**:guard 在唤醒驱动前用 `agent.model.select()` 把绑定记成会话的模型选择(`acp/<agent>`),adapter 再做一次复查;老宿主(无 `agent.model`)才用 `agent/request` waterfall(`prepend: true`)改写请求。
  191. - **权限模式与审批是两层,都以 agent 为准**:`composer-mode.tsx` 的控件只渲染 agent 经 `session/set_mode` 下发的 `availableModes`,不写可见标签、不翻译选项名;`session/request_permission` 原样映射给用户。插件没有自己的权限开关:agent 问了就一定到人面前。早先那套由宿主替 agent 裁定的端口语义(`decidePermission`、fs 写栅栏)已删除,见 `docs/acp-convergence.md` §2.3。
  192. - **跨平台路径**:`impl.ts` 不能 import `node:path`,绝对路径判定与 containment 全部手写,Windows 与 UNC 有专门用例。
  193. ### 文档索引
  194. - [AGENTS.md](./AGENTS.md) —— **先读「本插件是什么」一节**:哪些约束已废弃、哪些目标形态已落地
  195. - [NTR 模式:把会话交给另一个 agent](./docs/acp-mode.md) —— 设计、实测证据与硬边界
  196. - [ACP 收敛方向:只借显示层](./docs/acp-convergence.md) —— **代码收敛的唯一权威依据**
  197. - [DSH 插件开发通用指南](./docs/dsh-plugin-development-guide.md)
  198. - [DSH 官方源码参考与架构索引](./docs/README.md)
  199. ---
  200. ## 开源协议
  201. 本项目采用 [Apache 2.0](LICENSE) 许可证开源。

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.