GDWhisper/dsh-ntr ↗★ 6

dsh-ntr

Interactive Agent Client Protocol (ACP) client for the DSH web UI: attach any ACP-capable agent and stream its session.

パッケージ
dsh-ntr
互換性
未検証
バージョン
0.1.4
ライセンス
MIT
最終更新
2026/10/26

インストール

$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/request waterfall(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 不能 import node:path,绝对路径判定与 containment 全部手写,Windows 与 UNC 有专门用例。

文档索引

最小配置

在 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;设置页能改的都在设置页改。