dsh-remote-control
mazov2love/dsh-remote-control
Let Agents directly control independent local DSH instances with zero intrusion—no plugins or components required on the target. Isolated environments enable autonomous configuration and testing, while Agents with different models and personalities can chat, role-play, or form nested control chains. Supports conversational setup, user-like operations, incremental reading, saved references, and remote session/workspace search.
Установка
dsh plugin --profile web add github:mazov2love/dsh-remote-controlREADME
DSH Remote Control
让 DSH Agent 使用另一个 DSH 实例：创建会话、发送需求，随后自行选择查状态或读取结果。发送返回接收回执，远端独立继续工作。目标无需安装配套插件。
图片为宣传插画，展示概念性的界面与玩法。
插件用途
- 不只是 Agent 团队，而是真正独立的 Agent
不同于传统的子代理或多 Agent 团队，本插件让 Agent 能够直接操控另一个完整、独立运行的 DSH 实例。每个实例都可以拥有自己的上下文、记忆、人格、模型、工具和配置，不必共享一个脑子，更不用挤在同一个环境里。
你可以自由组合不同的 DSH 环境，让它们相互交流、协作，又不必担心一个 Agent 的会话或配置修改直接影响另一个。
- 让 Agent 帮 Agent 折腾自己
想给 DSH 安装新插件、修改配置，或者测试某个大胆的想法？不妨让另一个 Agent 帮你完成。
借助接近用户的操作语义，Agent 可以直接操作目标 DSH 的会话与工作区，为它编写插件、调整配置、安装组件、运行测试，甚至根据测试结果继续修改。
不再需要把所有实验都塞进主 Agent 的工作环境。给它准备一个独立的 DSH 实例，让它尽情折腾，成功了就留下成果，失败了就继续尝试。
- 好玩，才是第一生产力
谁说 Agent 一定要用来提高生产力？
让不同模型、不同人格的 Agent 互相聊天、吵架、出题、玩角色扮演；或者让一个 Agent 假装成用户，去指挥另一个 Agent，再让后者也假装成用户，继续指挥下一个……
Agent A 控制 Agent B，B 控制 C，C 控制 D……甚至一路套娃到 Z，再让 Z 回过头来控制 A。
快速开始
插件版本 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（Windows 示例）
想保留日常 DSH，同时给 Agent 准备一个可以独立调整和测试的实例，可以另建源码目录、数据目录和端口。下面使用 %USERPROFILE%\dsh-lab\deepseek-harness 存源码、%USERPROFILE%\.dsh-lab 存 DSH 数据、8081 端口提供 Web；日常实例仍可使用原来的目录与 3080 端口。如果 8081 已被占用，换一个空闲端口。
1. 下载并构建
准备 Git、Node.js 和 pnpm；本插件验证基线要求 Node.js 22.19+，DSH 源码的实际 Node.js 与 pnpm 要求以所下载版本的 package.json 中 engines、packageManager 为准。在 PowerShell 执行以下命令，每一步成功后再继续；目录已存在时请换一个新目录，不要覆盖已有源码：
New-Item -ItemType Directory -Force "$env:USERPROFILE\dsh-lab" | Out-Null
Set-Location "$env:USERPROFILE\dsh-lab"
git clone https://github.com/deepseek-ai/deepseek-harness.git
Set-Location .\deepseek-harness
pnpm install
pnpm run build
构建步骤来自 DSH 官方源码运行说明。源码更新后通常需要重新安装依赖并构建；平时启动只运行 pnpm dsh web，无需每次构建。本插件已验证 DSH 0.2.0-rc.2，仓库最新源码可能变化，升级前请核对 兼容性说明。
2. 在启动时单独指定环境变量
新开一个 PowerShell 窗口，在该窗口执行：
Set-Location "$env:USERPROFILE\dsh-lab\deepseek-harness"
$env:DSH_HOME = "$env:USERPROFILE\.dsh-lab"
$env:DSH_AGENTS_HOME = "$env:USERPROFILE\.agents-dsh-lab"
pnpm dsh web --host 127.0.0.1 --port 8081
DSH_HOME 分开保存此实例的配置、凭据、会话和插件安装数据；DSH_AGENTS_HOME 分开默认的用户级 Skill 根目录，否则它可能仍使用共享的 ~/.agents。这些赋值只影响当前终端及其子进程，关闭窗口后不会改变系统环境变量。在这个窗口里运行插件安装等管理命令，也会使用同一份独立数据目录。
首次启动后，在新实例的页面配置模型与 API 凭据。终端会打印带 ?token=… 的启动链接，可交给调用方 Agent 配置连接；重启后以本次打印的链接为准。需要后台式使用、不自动打开浏览器时，在命令末尾加 --no-open；结束进程可在启动窗口按 Ctrl+C。
3. 做成双击启动的脚本
把下面内容保存为 start-dsh-lab.cmd（注意扩展名是 .cmd，不是 .txt），构建完成后双击即可启动；也可以直接复制本仓库的 启动模板。前三个变量分别控制源码目录、数据目录和端口：
@echo off
setlocal
set "DSH_SOURCE=%USERPROFILE%\dsh-lab\deepseek-harness"
set "DSH_HOME=%USERPROFILE%\.dsh-lab"
set "DSH_LAB_PORT=8081"
set "DSH_AGENTS_HOME=%USERPROFILE%\.agents-dsh-lab"
if not exist "%DSH_SOURCE%\package.json" (
echo Source directory not found. Edit DSH_SOURCE in this script.
pause
exit /b 1
)
cd /d "%DSH_SOURCE%"
call pnpm dsh web --host 127.0.0.1 --port %DSH_LAB_PORT%
set "DSH_LAB_EXIT=%ERRORLEVEL%"
if not "%DSH_LAB_EXIT%"=="0" pause
endlocal & exit /b %DSH_LAB_EXIT%
setlocal 让环境变量仅作用于脚本及其启动的进程，不需要 setx，也不用更改 Windows 的 HOME 或 USERPROFILE。源码实例用其目录中的 pnpm dsh 启动；全局 dsh web 仍由原安装提供。要再开第三个实例，使用另一份源码目录，并修改数据目录、Skill 目录和端口。
这是程序与 DSH 数据层面的分离，不是操作系统沙盒：两个实例仍以当前 Windows 用户的权限访问文件；手动选择相同项目目录、配置额外 Skill 路径或共享外部服务时，相应资源仍会共享。想让实验更独立，可以给它单独的项目目录。
4. 也可以把整套工作交给现有 Agent
如果现有 Agent 有终端与文件操作能力，可以把这一节直接交给它，或者这样说：
请按本教程建立一个新的独立源码 DSH：新建源码目录，使用单独的 DSH_HOME、DSH_AGENTS_HOME 和空闲端口，安装依赖并构建，生成一键启动脚本，启动后验证 Web 可访问，再帮我配置 DSH Remote Control 连接；保留我原有实例的配置和数据。
本插件安装在发起调用的实例；新建的目标实例无需安装配套插件。若新实例反过来也要控制其他 DSH，再在它自己的 DSH_HOME 下安装本插件。
手动连接配置（可选）
默认读取 $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。