会话改名工具 ccclucky/dsh-plugin-session-rename

dsh-plugin-session-rename

一个极小的 DeepSeek Harness（DSH）插件，给 Agent 增加一个原生工具：

session_rename(title: string)

工具内部直接调用 Cordis 的 sessionTitle 服务 —— sessionTitle.rename(session, title) —— 所以会话标题是真的被改了，不是模型自说自话。

为什么需要

默认情况下用户能在界面上改会话名，但 Agent 不能。当标题要承载任务状态时，这就是个缺口：

- 用 [wip] / [pending] / [done] 前缀表示会话当前进展；
- 用交付物命名，而不是用第一句提问命名；
- 第一句提问太模糊时，把标题改准确。

装上这个插件后，Agent 可以在状态真正变化的那一刻自己把标题改对。

改名时发生了什么

sessionTitle.rename(session, title) 会向会话日志追加一条 session/title 事件，source 为 user。由此得到三个特性：

| 特性 | 效果 |
| 持久 | 重放、分叉、恢复都从日志重建标题。 |
| 锁定 | 进行中的自动标题生成被取代，后续提问不会再自动改名。 |
| 实时 | 事件落地即刷新会话列表与聊天头部，无需刷新页面。 |

前置条件

- 提供 sessionTitle 服务的 DSH 版本（标准 Web / Desktop bundle 已内置）。
- 无运行时依赖，插件本身不 import 任何包。

安装

从 npm 安装（一条命令）

dsh plugin --profile <profile> add dsh-plugin-session-rename

这是应用内 Plugin Hub 与社区索引所依赖的形式。本包声明了 dsh.bundle.patch，安装器会把它追加进 dsh.profile.bundles，该行自行挂载：

- insert:
- id: session-rename
name: 'dsh-plugin-session-rename'

注意：名为 desktop 的 profile 由 Electron 应用独占，CLI 无法管理；请改用应用内插件管理页，或用下面的源码安装方式。

从源码安装（npm 发布前可用）

dsh plugin 命令本身只是转发给 pnpm add，所以 git 源可用：

dsh plugin --profile <profile> add git+https://github.com/ccclucky/dsh-plugin-session-rename.git

profile 内本地副本

把本仓库 clone 到任意位置，再让 profile 补丁指向文件（Loader 以补丁文件所在目录为基准解析相对路径）：

~/.dsh/profiles/<profile>/cordis.patch.yml
- insert:
- id: session-rename
name: './plugins/session-rename/index.js'

只能选一种：npm、git、本地行三者同时存在会产生重复 entry id session-rename。

模块与补丁层都由 HMR 热加载，无需重启。

使用

自然语言即可——「把会话改名为 [done] 迁移收尾」——Agent 也可以直接调用：

{ "title": "[wip] 迁移进行中" }

返回：

{
"title": "[wip] 迁移进行中", "eventSeq": 514, "source": "user" }

错误都是显式的，不会静默成功：

- 空标题或全空白标题，在调用服务前就被拒绝；
- 没有调用方 agent、或 agent 没有 live session，直接报错；
- 服务端把标题归一化为空时，原样抛出服务自己的错误。

设计要点

- 用原始 JSON Schema，不用作者方言。 ctx.tools.register() 接收的是原始 JSON Schema。defineTool() 那套作者方言（属性内写 required: true）只适用于打包的 TypeScript 工具，混用会让 loader 行激活失败。测试里专门钉住了这一点。
- 模型改不了别人的会话。 会话取自 exec.agent.session，不接受工具参数指定。
- 零 import。 registry 接受普通 ToolDefinition 对象，不需要从 profile 的 node_modules 解析任何东西。
- 缺依赖时休眠而非报错。 inject = ['tools', 'sessionTitle']，缺任一服务的 profile 里插件保持 inactive。
- 注销由 effect 拥有。 注册放在 ctx.effect(...) 内，禁用该行即卸载工具。

测试

node --test

14 条契约测试，零依赖、无需安装 DSH：通过桩 Cordis 上下文驱动插件，覆盖注册形态、原始 schema 契约、会话解析、取消以及全部错误路径。

兼容性

基于 DSH 0.2.x 插件 API 编写（ctx.tools.register、ctx.effect、sessionTitle.rename）。

本包声明 engines.dsh: ">=0.2.1-rc.2 <0.3.0"。DSH 在安装前会校验该范围，不兼容的运行时会被直接拒绝，而不是加载一个可能崩的插件——DSH 处于开发者预览期，0.3.x 的破坏性变更应当显式失败。
由于存在 engines.dsh，它单独决定兼容性：本包刻意不声明任何 @deepseek-ai/ peerDependencies，因为它不 import 任何包，不该被 peer 解析卡住。

若未来运行时能跑但不在范围内，请用官方的精确版本豁免（dsh plugin allow-version），而不是改范围。

发布状态

| 渠道 | 是否可用 |
| npm registry | ✅ dsh-plugin-session-rename@1.0.0 —— 已带 provenance 发布 |
| dsh plugin add dsh-plugin-session-rename | ✅ 已实测：数秒装好，安装器自动把 bundle 追加进 dsh.profile.bundles |
| GitHub 仓库 | ✅ https://github.com/ccclucky/dsh-plugin-session-rename |
| GitHub 话题 dsh-plugin | ✅ 已添加 —— 社区站 dsh-plugin.org 依此话题发现仓库 |
| dsh plugin add git+https://… | ✅ 同样可用，适合装未发布的提交 |

发布由 .github/workflows/publish.yml 在推送 v 标签时执行：跑测试、校验 tarball，再带 provenance 发布。
仓库密钥 NPM_TOKEN 必须存放勾选了「Bypass 2FA」的细粒度令牌——不勾豁免的令牌能通过认证，但上传阶段会以 403 失败。

许可

MIT © CCLUCKY