dsh-butler — DSH 工作区管家
给 DeepSeek Harness(DSH)的每个工作区配一个专门的「管家」会话:它看得见本工作区所有会话在干什么, 能按岗位名 / 标题把活派给正确的会话,还能一次汇总所有会话的要点、记忆与技能,不用一个个点开翻。 在侧栏工作区的菜单里点一下「启用管家」,该工作区里就多出一个叫「管家」的会话;以后跟它说人话就行:
「现在这个工作区都有哪些会话?都在干什么?」 「把『跑一遍回归测试』派给跑测试那个会话。」 「会话 session-xxxx 负责拉代码,以后叫它『拉代码』。」
提供什么
| 工具 | 作用 |
|---|---|
butler_sessions |
会话总览:标题、状态(running / active / idle)、最近活跃时间、最近几轮在做什么 |
butler_digest |
一次性摘要:各会话要点 + 技能清单 + 记忆规模(默认 ≤ 12 KB) |
butler_roles |
岗位表:给会话起岗位名(拉代码 / 跑测试 / 查日志),之后按名字派活 |
butler_dispatch |
跨会话派活:把一条自包含的任务投递给另一个会话并唤醒它 |
另外随包带一个 butler 技能(skills/butler/SKILL.md),告诉模型什么时候用哪个工具、派活要守哪些规矩。
每个工作区一个专门的管家会话
- 启用:在侧栏工作区的「…」菜单(或右键菜单)里点「启用管家」,插件会在该工作区里新建一个叫「管家」的会话, 并给它发一条开场白,让它先汇报本工作区各会话在做什么。已经有可用的管家会话时直接复用,不会重复建。
- 只有这个会话能用管家工具:同工作区的其它会话、别的工作区的会话调用四个工具都会被拒绝, 错误信息会告诉模型去哪个会话里操作。
- 只管本工作区:看会话、做摘要、设岗位、派活,都只针对管家所在工作区的会话。别的工作区看不到,也派不过去。 岗位表按工作区分开,每个工作区都可以有自己的「跑测试」。
- 停用:同一个菜单里点「停用管家」。四个工具立刻对这个工作区全部拒绝;管家会话本身是普通会话,原样保留, 之后再启用就复用它。不想要了可以自己把它删掉或归档,下次启用会另建一个。
- 没启用过管家的工作区,什么都不会发生:不建会话,工具一律拒绝。
菜单开关只能由人在 DSH 窗口里点:修改请求必须带窗口的会话 cookie,模型用 shell 发请求改不了。
工具的描述会出现在每个会话的上下文里(几百字),但只有管家会话调得动。这是 DSH 目前按会话开关工具的限制。
安装
插件市场(收录后):插件 → 发现,搜索 dsh-butler,安装。
手动(npm):在 profile 目录里装包,并把它加进 bundles,然后重启 DSH。
cd ~/.dsh/profiles/desktop
pnpm add dsh-butler
// ~/.dsh/profiles/desktop/package.json
{ "dsh": { "profile": { "bundles": ["…", "dsh-butler"] } } }
从源码(开发用,Windows / PowerShell 7):
pwsh -File scripts/install.ps1 # 备份 profile 配置 → 复制到 node_modules/dsh-butler → 写入 bundles
pwsh -File scripts/uninstall.ps1
装好后 ~/.dsh/butler/last-load.json 会记下版本号和四个工具名,可以用来确认插件已加载。
工具参数
butler_sessions
| 参数 | 类型 | 说明 |
|---|---|---|
full |
boolean | 每个会话展开更多轮次 |
includeSubagents |
boolean | 把子代理会话也列出来(默认隐藏,它们不能派活) |
limit |
integer | 最多列多少个会话,默认 20 |
butler_digest:full、includeSubagents,含义同上。
butler_roles
| 参数 | 类型 | 说明 |
|---|---|---|
action |
list | set | remove |
必填 |
sessionId |
string | set / remove 必填,必须是本工作区内 session- 开头的顶层会话 |
role |
string | 岗位短名,set 必填,工作区内唯一 |
job |
string | 一句话说明这个会话负责什么 |
butler_dispatch
| 参数 | 类型 | 说明 |
|---|---|---|
target |
string | 必填。sessionId / 岗位名 / 会话标题片段 |
message |
string | 必填。任务内容,要自包含:背景、做什么、什么算完成、产出放哪 |
title |
string | 走调度通道时的任务标题 |
dryRun |
boolean | 只解析目标并演练,不投递 |
派活是怎么实现的
目标解析顺序:session- id → 岗位名 → 会话标题(先精确,再唯一的模糊匹配),都只在本工作区内找。
匹配到多个会直接报错并列出候选,不会替你挑。
投递走宿主自己的两条官方通道,按顺序尝试:
- 进程内投递:
sessionController.resolveAgent→agent.followup→sessions.flush。 零延迟,冷会话会被自动唤醒,等持久化确认后才算成功。 - 调度服务回退:
schedule.create({ timing: { kind: "after" }, target: { kind: "session" } }),几秒后投递。
目标会话收到的是一条用户消息,开头带 【管家派活 · 来自会话 xxxxxxxx】,
这样对方(以及之后翻记录的你)都知道这不是当场手打的。派活是异步的:工具返回只代表送达,不代表对方做完。
安全边界
- 工具只认工作区指定的那个管家会话;工作区没启用管家时一律拒绝。
- 只能派给本工作区的顶层会话。别的工作区的会话、子代理会话、已归档会话、管家自己都会被拒绝。
- 每小时最多
maxDispatchesPerHour次(默认 20),只计真正投递成功的。 - 每次尝试都写审计
~/.dsh/butler/audit.jsonl:成功、失败、限流、演练都有记录。 dryRun可以按次传,也可以在配置里全局打开。- 插件不会自己派活,只在模型调用
butler_dispatch时才动;随包技能要求模型在用户没点名目标时先建议再执行。
配置
在 profile 的 cordis.patch.yml 里覆盖:
- id: butler
config:
maxDispatchesPerHour: 20 # 每小时派活上限(所有工作区合计)
dispatchDelaySeconds: 3 # 调度回退通道的投递延迟(秒)
dryRun: false # 全局演练
# dshHome: D:\dsh-home # 覆盖 DSH 家目录,默认 $DSH_HOME 或 ~/.dsh
读什么、写什么
只读:
- 会话:
~/.dsh/storages/session_projcache/sessions/*.json(宿主可能正在写,半截文件会被跳过并计数) - 工作区与归档表:
~/.dsh/storages/workspace.json - 记忆:
~/.dsh/MEMORY.md、USER.md,找不到再看~/.mnemon/runtime/ - 技能:
~/.dsh/skills/*/SKILL.md与<工作区>/.dsh/skills/*/SKILL.md
只写 ~/.dsh/butler/:roles.json(岗位表)、workspaces.json(各工作区是否启用,以及它的管家会话 id)、audit.jsonl(派活审计)、last-load.json(加载标记)。
此外,点「启用管家」时会通过宿主的会话服务在该工作区里新建一个会话(并改名、发开场白);除此之外不碰其它会话,派活之外也不替你发消息。
插件不访问外网;唯一的 HTTP 是界面端向本机宿主读写开关(/dsh-butler/workspaces)。
注意摘要会把同工作区其它会话的 prompt 片段带进管家会话的上下文。
兼容性
| DSH | 状态 |
|---|---|
| 0.2.2-rc.3 | experimental:自动化测试通过;真实跨会话投递、工作区菜单开关和管家会话的创建请先在自己的环境里验证(派活可先用 dryRun) |
需要 Node ≥ 22。会话数据读的是宿主的投影缓存,属于内部格式,宿主升级后可能需要跟进。
已知限制
- 会话属于哪个工作区是按它的工作目录判断的(落在哪个工作区的文件夹下)。两个工作区指向同一个文件夹时无法区分。
- 工作目录不属于任何已登记工作区的会话没有菜单可点,也就没有管家。
- 菜单开关只在 Web / 桌面界面里有;纯命令行宿主里没法创建管家会话。
- 启用时新建的会话和开场白依赖宿主的
sessionController服务;拿不到时启用会报错,不会留下半成品开关。 - 刚建好的管家会话如果开场白发送失败,它只是一个空会话;你直接对它说话即可,工具照样可用。
- 菜单文案按浏览器语言在中文和英文之间选。
- 会话标题由 DSH 用首条 prompt 自动生成,可能比较长。
- 宿主异常退出可能留下假的 running 状态,判断时结合「上次活跃」时间。
- 限流在并发调用下不是严格原子的:同一瞬间的多次派活可能略微超过上限。
audit.jsonl不会自动轮转。
开发
npm test # 插件测试 + 数据层自检
node --test --test-name-pattern "限流" "test/*.test.mjs" # 只跑一条
node lib/indexer.mjs list --top-level --workspace <路径> # 数据层 CLI:list | digest | stats | json
@deepseek-ai/* 由宿主在运行时注入,磁盘上没有;测试用 test/stub-host.mjs 里的桩顶替(需要 Node ≥ 22.15)。
No comments yet. Be the first to write one.