DSH Plugins Marketplace

DSH Plugins

Plugins

/

Sessions & Messages

/

dsh-butler

d

dsh-butler

Manifest valid

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

UI (client)hasBundlePatch

dsh-butler — DSH 工作区管家

English

给 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

参数类型说明
fullboolean每个会话展开更多轮次
includeSubagentsboolean把子代理会话也列出来(默认隐藏,它们不能派活)
limitinteger最多列多少个会话,默认 20

butler_digest:full、includeSubagents,含义同上。

butler_roles

参数类型说明
actionlist | set | remove必填
sessionIdstringset / remove 必填,必须是本工作区内 session- 开头的顶层会话
rolestring岗位短名,set 必填,工作区内唯一
jobstring一句话说明这个会话负责什么

butler_dispatch

参数类型说明
targetstring必填。sessionId / 岗位名 / 会话标题片段
messagestring必填。任务内容,要自包含:背景、做什么、什么算完成、产出放哪
titlestring走调度通道时的任务标题
dryRunboolean只解析目标并演练,不投递

派活是怎么实现的

目标解析顺序:session- id → 岗位名 → 会话标题(先精确,再唯一的模糊匹配),都只在本工作区内找。 匹配到多个会直接报错并列出候选,不会替你挑。

投递走宿主自己的两条官方通道,按顺序尝试:

  1. 进程内投递:sessionController.resolveAgent → agent.followup → sessions.flush。 零延迟,冷会话会被自动唤醒,等持久化确认后才算成功。
  2. 调度服务回退: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.3experimental:自动化测试通过;真实跨会话投递、工作区菜单开关和管家会话的创建请先在自己的环境里验证(派活可先用 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

MIT

Comments

Loading…

Similar plugins

dsbot-session-create

by Gaudi-XIX

Adds four tools to a Session. create_session opens a new Session in a named workspace or in any existing folder and delivers one prompt into it; session_message sends one more message into a Session t

Sessions & MessagesManifest valid

★ 0

TypeScript

Nov 3, 2026

dsh plugin --profile web add dsbot-session-create

by Ryuu-64

Gives the agent four session tools: start a new session, send a message into another one, list sessions with their state, and wait for another session's turn to finish so its answer can be read back.

Sessions & MessagesManifest valid

★ 0

MIT

JavaScript

Oct 8, 2026

dsh plugin --profile web add @ryuu-64/dsh-session-tools

by drscrewdriver

DSH Web 插件:会话管理台(原名 dsh-session-steward)—— 活跃/归档会话统一管理(浏览、筛选、收藏、批量归档/取消归档/清理),外加四门会话体检;入口自适应顶栏工具行或底栏。不含搜索/索引、不依赖 DRS(搜索在 dsh-search-index)。

Sessions & MessagesManifest valid

★ 2

MIT

TypeScript

Nov 16, 2026

dsh plugin --profile web add dsh-manage-session

Adds a Session without workspace entry to the DSH Workspace picker, creates isolated date-organized directories, and keeps started sessions resumable under Ungrouped.

Sessions & MessagesManifest valid

★ 2

↓ 150/wk

MIT

TypeScript

dsh plugin --profile web add dsh-projectless-session

A sidebar panel that moves, rebuilds, merges, renames and deletes whole workspaces: a move re-publishes each session log with the new directory in its header, repairs the workspace record, refreshes t

Sessions & MessagesManifest valid

★ 0

dsh plugin --profile web add dsh-workspace-control

by jing-hy

Project/task dual-mode workspaces for DSH: a task skips the workspace picker and gets a fresh scratch directory (D:\dsh_working\<name>-<timestamp>) per conversation, Codex-style; no-workspace sessions

Tools & CapabilitiesTerminal & ClientsManifest valid

★ 0

↓ 126/wk

MIT

JavaScript

Oct 11, 2026

dsh plugin --profile web add dsh-task-runner