DSH Host 能力清单（本插件用到的）

本插件 host 侧消费的 DSH Host 服务与事件（2026-08 实测，基于 deepseek-harness checkout）。

服务（inject）

服务	提供包	本插件用途
tools	@deepseek-ai/dsh-tools	register(defineTool(...)) 动态注册 bash 工具，返回 disposer 切换时注销
subprocess	@deepseek-ai/dsh-subprocess-local	spawn({argv, cwd, stdio, graceMs, signal, env}) 执行 git-bash；collect 模式输出截断 + spill
systemPrompt	@deepseek-ai/dsh-system-prompt	section({name, order, text}) 注册引导文本；system-prompt/assemble 事件裁剪工具面
webServer	@deepseek-ai/dsh-host-webserver	register({kind:'prefix', path, handler}) 提供卡片读写 API
settings	@deepseek-ai/dsh-settings-file	installSettingsSection 注册 shell-policy section；mutate(ns, ops) 持久化 preferred

事件

事件	模式	本插件用途
system-prompt/assemble	waterfall	await next() 后按策略过滤 pwsh/bash 工具

关键机制

• 工具注册：ctx.tools.register 返回 disposer；同 scope 重名报错；host 层与 preset 层不同 scope 可同名
• 工具 schema 按请求刷新：注册/注销后下一次请求的工具面变化（当前请求不变）
• 系统提示按会话快照：sections 在会话开始时注入，新会话才看到新 section
• settings allowlist：apiproxy 的 WEB_SETTINGS_NAMESPACES 决定哪些 namespace 可被 client 端 RPC 读写；插件自行注册的 namespace 不在其中（官方 deferred work）
• scope 事件过滤：scopeTarget 的 filter 对无 scope tag 的 listener 放行（host 层 listener 全局接收 agent scope 事件）