- Home
- Plugins
- Sessions & Messages
- dsh-butler
dsh-butler
yutouaa/dsh-butler
One dedicated butler session per workspace. A workspace-menu item enables it, creating (or reusing) a session titled "管家" in that workspace. From that session, four tools list what the other sessions in the workspace are doing, digest their memory and skills in one call, name sessions by role, and dispatch a task to a session by role name, unique title or id. Dispatch uses the host in-process delivery with the scheduled-task service as the fallback. Other sessions in the workspace are refused. Its HTTP routes have no DSH access check, so a web page open in your browser could call them.
Install
dsh plugin --profile web add github:yutouaa/dsh-butlerREADME
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)。
License
Related plugins
billion-context
ranxianglei/billion-context
dsh-web-ui (dsh-chat-recovery)
zhu1090093659/dsh-web-ui
dsh-synapse
liangmianya/dsh-synapse
dsh-archive-manager
michengai/dsh-archive-manager