DSH Remote Control
让 DSH Agent 使用另一个 DSH 实例：创建会话、发送需求，随后自行选择查状态或读取结果。发送返回接收回执，远端独立继续工作。目标无需安装配套插件。
快速开始
插件版本 1.0.0，已验证的 DSH 基线为 0.2.0-rc.2，Node.js 要求 22.19+。具体边界见 COMPATIBILITY.md。
使用 DSH 官方命令安装到调用方的 profile。自定义 DSH_HOME 时，先设置为你实际使用的数据目录；使用默认目录时无需设置。Git 安装要求仓库已上传，并包含 v1.0.0 标签。
$env:DSH_HOME = 'C:\path\your-dsh-home' # 仅自定义数据目录时设置
dsh plugin --profile web add 'github:mazov2love/dsh-remote-control#v1.0.0'
也可以下载或 clone 源码后安装：
dsh plugin --profile web add 'C:\path\dsh-remote-control'
源码 DSH 在其源码目录使用 pnpm dsh plugin --profile web ...。将 web 替换为实际调用方 profile。安装后重启调用方，开启新会话。
然后直接告诉 Agent：
我要使用另一个 DSH，它在本机的 3080 端口，令牌是 <目标当前令牌>。请帮我配置连接并验证。
也可以提供完整启动链接，或要求 Agent 启动另一个 DSH 实例并配置连接。该路径由用户在自定义 DSH_HOME 和复杂插件环境中实测可用，依赖 Agent 已有的文件、终端及管理能力。目标实例无需安装配套插件。
插件同时安装 dsh-remote-control Skill，供 Agent 按需读取配置和使用说明，不需要另外安装 Skill。默认只增加简短 Skill 摘要，不把完整操作手册放进每次请求。自定义 preset 需保留 DSH 的 Skill 加载能力；缺少通用操作权限时，Agent 会说明需要补充的步骤。
连接配置改变后需要重载插件或重启调用方。重启不删除原有连接、引用和读取状态。令牌可通过对话提供，工具不会主动返回凭据；原始对话仍包含用户提供的令牌。
手动连接配置（可选）
默认读取 $DSH_HOME/remote-control/connections.json：
{"targets":[{"id":"technical","url":"http://127.0.0.1:3080","authFile":"C:/path/your-dsh-home/remote-control/technical.auth.json"}]}
私有 authFile 内容：
{"origin":"http://127.0.0.1:3080","token":"目标启动链接中 token 参数的值"}
合法启动 token 换取 Cookie 并写回私有认证文件；失效时用最新 token 重新认证。也可用 tokenEnv 指定环境变量名。URL 不含 token，工具不会返回认证文件内容。多个目标通过 id 选择；仅一个目标时可省略 instance。
六个常驻工具
| 工具 | 用法 |
|---|
dsh_create | 创建会话或注册已有目录作为工作区，自动保存引用与用途/注释 |
dsh_refs | 分页查看、保存、更新或删除本地引用；get 查看完整注释 |
dsh_send | 使用 ref 或 instance/sessionId 发送，立即返回回执；可显式设置模型与权限 |
dsh_status | 默认只查状态；view=new 读取新增回复；view=final 预览最新回复 |
dsh_search | 默认搜已保存引用；scope=sessions/workspaces 搜远端简短元数据 |
dsh_other | 查询详细操作用法，或按明确操作名称执行 |
插件不注册额外 system prompt 正文。高级操作说明不提前加入基础工具 schema；通过 dsh_other 查询时才返回。无自动等待、自动读取全部回复、完成通知或唤醒主体。
发送的 message 由调用 Agent 自己提供。accepted=true 只表示接收成功，不表示任务完成；网络中断时可能返回 accepted=unknown，检查目标后再决定是否用相同 requestId 重发。
引用与增量读取
state.json 默认位于 $DSH_HOME/remote-control/，存储实例/会话引用、name、purpose、notes、最后发送回执和读取位置。它保存操作状态，不自动注入人格记忆。创建时自动保存；已有会话用 dsh_refs action=save 保存。删除引用只删除本地记录，远端会话不受影响。
默认列表最多 10 条，最大 50 条，使用 offset/nextOffset 分页。列表省略完整 notes，查详情才加载。引用绑定 origin，目标 id 指向新地址时拒绝误用旧引用；重新保存新的引用即可。
dsh_status view=new 默认只返回尚未读取的 assistant 文本；includeTools/includeUser 可显式包含工具结果或用户消息。读取成功才推进本地 cursor。不同引用指向同一远端会话时共用读取位置。
view=final 是最新文本预览，不保证远端已完成，也不推进 cursor。传 afterSeq 的显式读取与 read_history 也不推进 cursor。需要补看旧工具过程，使用历史读取或明确 reset_read；默认省略的工具结果不会自动重返后续增量读取。
状态中的 idle 表示当前没有运行，不等同于某条请求成功。unreadEvents 是新增事件数，包含内部事件，不是新增消息数。wait 是按 requestId 判断轮次结束的可选操作，返回状态，不携带回复正文；结束原因可通过历史查看。
返回预算
默认工具返回预算为 6000 字符，按包含 data 的 JSON 文本测量，不声称是精确 token 数。超过预算时返回 oversized 和 resultId，原结果暂存本机；原文不进入模型上下文，读取 cursor 不推进。
dsh_other action=help operation=result
dsh_other action=execute operation=result args={"resultId":"...","offset":0,"maxChars":3000}
实际工具参数 args 是上述对象的 JSON 字符串。按 nextOffset 顺序继续读取所有 JSON 文本分段，全部连续送达才推进 cursor；跳读分段不会确认未读取前缀。也可设置外层工具 maxChars 并在 args 内传 full=true，明确要求完整原对象。外层最大预算默认 100000 字符。明确 reset_read 后，旧暂存结果不能再推进新 cursor。
暂存默认有效 24 小时，最多 50 份；到期/被淘汰后可以重新读取，cursor 不因淘汰而推进。暂存不包含连接凭据，但可能含会话内容，应与 DSH 本地数据一样保护。拦截减少模型输入，不减少远端已产生的输出或既有后端传输量。
现有 DSH 只有倒序历史分页；插件在本地组合增量内容，默认最多检查 20 页。超过扫描上限会明确返回 history-scan-limit，不跳过未读取内容。
按需操作
dsh_other 默认 action=help；省略 operation 列出操作摘要。action=execute 时，args 为 JSON 对象字符串。
支持 instances、catalog、workspaces、sessions、read_history、wait、cancel、interactions、respond、settings、permission_catalog、search_content、reset_read、result。先查某项 help 获取参数和示例。没有任意 RPC 透传入口。
模型/权限设置通过 DSH 官方 Remote 方法和 /permission 命令修改，再读取状态核对；设置失败不发送消息。设置会持续影响整个会话，DSH selectModel 还可能保存部署默认模型。只对 idle 会话修改；多项设置不是远端原子事务，部分修改可能在后续失败后保留。另一个客户端同时改设置也可能产生竞争，需要远端增强才能进一步解决。
配置与维护
插件 row 支持 config.connectionsFile、config.targets、config.stateFile、config.returnBudgetChars（默认 6000）、config.maxReturnChars（默认 100000）、config.maxHistoryPages（默认 20）。配置变更后重载或重启。
npm ci --ignore-scripts
npm run verify
node scripts/verify-host-contract.mjs C:/path/to/deepseek-harness
npm pack
测试与维护脚本在 Git 源码项目中；安装内容包括运行源码、自带 Skill 和通用文档，无需构建，也没有必须批准的安装脚本。本项目以源码/Git 安装为主要方式，不要求 npm 发布或 GitHub Release。维护前读 AGENTS.md、ARCHITECTURE.md、CONTRIBUTING.md、TESTING.md 和 CHANGELOG.md。
