dsh-ntr
Interactive Agent Client Protocol (ACP) client for the DSH web UI: attach any ACP-capable agent and stream its session.
インストール
npx -p @deepseek-ai/dsh dsh plugin --profile web add dsh-ntr@latestドキュメント
README 全文を読む ↗配置参考(开发者)
以上是用户部分。以下写给要改这个插件、或要手工写配置文件的人。
最小配置
在 Profile 层的 cordis.patch.yml 里挂载。省略 cwd / allowedCwdRoots 时用插件自有工作区 ~/.dsh/dsh-ntr/workspaces(保存时自动创建);command 是一整条命令行,含空格的路径用引号包住。
- id: dsh-ntr
name: dsh-ntr
config:
agents:
- id: pi
title: pi coding agent (ACP)
command: /path/to/bin/pi-acp # 例如 "codebuddy --acp"
cwd: ~/.dsh/dsh-ntr/workspaces
allowedCwdRoots: [~/.dsh/dsh-ntr/workspaces]
可选的 agent 字段:npmPackage(PATH 里找不到时自动 npm install -g)、exposedModels(NTR 座位菜单列哪些变体)、idleTimeoutMs(聊天进程的空闲释放窗口,0 = 永不释放,默认 30 分钟)。插件级还有 transcriptMaxEntries(会话事件缓冲上限,默认 600)与 probeModelsOnBoot(保留字段,启动时已不再为每个 agent 探测,见 bootstrapCatalogs 的注释)。可靠性超时与重试的默认值(startupTimeoutMs、cancelFallbackMs、staleCancelRetryDelayMs、staleCancelMaxRetries、permissionTimeoutMs 与 permissionFallbackTimeoutMs)见 AGENTS.md 约束 12 与 13;设置页能改的都在设置页改。
构建与安装
npm install # 依赖
npm run build # 宿主 TS 声明 + 浏览器 Bundle
npm test # 测试套件
dsh plugin --profile web add ./ # 挂载到 Web Profile
实现要点
以下每条都对应一处真实故障,改代码前先读对应文档。浏览器半区经 /acp RPC 与 /api/acp/stream SSE 和宿主半区通信;宿主半区每会话一个 AgentBridge,经 stdio JSON-RPC 驱动 agent 子进程。
代码位置:src/index.ts(插件入口)· src/protocol.ts(共享类型)· src/impl.ts(纯宿主逻辑)· src/bridge.ts(子进程通信桥)· src/client/(React 扩展)· presets/acp/(NTR 模式声明)· ~/.dsh/dsh-ntr/(运行时落盘)。
- DSH 只出显示层:插件不写 DSH 的模型路由,不接管宿主的模型目录,也不让 ACP 模型出现在 DSH 原生选择器里。
- 工作区即侧栏路径:侧栏点开的目录必须成为
session/new的 cwd 和 agent 子进程自己的 cwd。有一条 agent(codebuddy)在进程启动那一刻就定死工作区。 - NTR 模式 = agent preset:由
presets/acp/acp.patch.yml随包声明,不挂工具、不注入项目指令、不做 compaction,让模型可见的表面完全属于对端 agent。 - 转发严格等于用户文本:按
source.kind === 'user'挑消息,不转发标题生成、compaction 这类辅助调用,也不拼任何边界叙述。 - 逐步切分 = 原生交错的工具卡:一个 ACP turn 按工具活动切成多个宿主 step——段以
tool-call卡收尾即结束本次 stream,宿主落定消息、执行卡(真实输出经 guard 虚拟工具应答)、续跑下一步;续跑段续读同一个仍在飞的session/prompt,绝不新发 prompt。卡片因此夹在两个 assistant 节点之间,与原生多步对话一致。 - 绑定必须接到请求路径上:guard 的
agent/requestwaterfall(prepend: true)把请求改写成绑定指向的acp/,adapter 再做一次复查。 - 权限模式与审批是两层,都以 agent 为准:
composer-mode.tsx的控件只渲染 agent 经session/set_mode下发的availableModes,不写可见标签、不翻译选项名;session/request_permission原样映射给用户。插件没有自己的权限开关:agent 问了就一定到人面前。早先那套由宿主替 agent 裁定的端口语义(decidePermission、fs 写栅栏)已删除,见docs/acp-convergence.md§2.3。 - 跨平台路径:
impl.ts不能 importnode:path,绝对路径判定与 containment 全部手写,Windows 与 UNC 有专门用例。
文档索引
- AGENTS.md —— 先读「本插件是什么」一节:哪些约束已废弃、哪些目标形态已落地
- NTR 模式:把会话交给另一个 agent —— 设计、实测证据与硬边界
- ACP 收敛方向:只借显示层 —— 代码收敛的唯一权威依据
- DSH 插件开发通用指南
- DSH 官方源码参考与架构索引
最小配置
在 Profile 层的 cordis.patch.yml 里挂载。省略 cwd / allowedCwdRoots 时用插件自有工作区 ~/.dsh/dsh-ntr/workspaces(保存时自动创建);command 是一整条命令行,含空格的路径用引号包住。
- id: dsh-ntr
name: dsh-ntr
config:
agents:
- id: pi
title: pi coding agent (ACP)
command: /path/to/bin/pi-acp # 例如 "codebuddy --acp"
cwd: ~/.dsh/dsh-ntr/workspaces
allowedCwdRoots: [~/.dsh/dsh-ntr/workspaces]
可选的 agent 字段:npmPackage(PATH 里找不到时自动 npm install -g)、exposedModels(NTR 座位菜单列哪些变体)、idleTimeoutMs(聊天进程的空闲释放窗口,0 = 永不释放,默认 30 分钟)。插件级还有 transcriptMaxEntries(会话事件缓冲上限,默认 600)与 probeModelsOnBoot(保留字段,启动时已不再为每个 agent 探测,见 bootstrapCatalogs 的注释)。可靠性超时与重试的默认值(startupTimeoutMs、cancelFallbackMs、staleCancelRetryDelayMs、staleCancelMaxRetries、permissionTimeoutMs 与 permissionFallbackTimeoutMs)见 AGENTS.md 约束 12 与 13;设置页能改的都在设置页改。