本地 DSH 宿主桥接与 Skill:通过官方 session-title 服务预览并批量重命名会话标题。它的 HTTP 路由没有 DSH 的访问检查,浏览器里打开的网页可以调用它们。
安装
# npm 包(预构建)
dsh plugin --profile web add dsh-rename-chats
# GitHub 源码(首次需按提示配置 allowBuilds 构建授权后重试)
dsh plugin --profile web add github:xiaopei-sd/dsh-rename-chats
装任何插件都等于在你的机器上跑第三方代码,权限和你本人一样大——能读你的文件、用你的凭据、访问网络,工具审批管不到它。GitHub 来源的插件还会在安装时执行构建脚本——pnpm 默认拦截,所以安装可能停在 ERR_PNPM_GIT_DEP_PREPARE_NOT_ALLOWED 或 ERR_PNPM_IGNORED_BUILDS;dsh 会打印出需要添加的确切键名,把它加进该 profile 的 pnpm-workspace.yaml 的 allowBuilds 下,重跑一次即可装上。放行构建本身就是一次信任判断:请只安装可信来源,并尽量锁定 commit(github:owner/repo#sha)。
README
该插件的 README 只有英文版本。
A local, loopback-only bridge that lets a DSH Skill read DSH session titles and
rename them through the official session-title service. It does not edit
session.v4.jsonl.zstd, SQLite, or browser cookies.
This package is one half of a two-part tool:
dsh-rename-chats(this package) — a DSH host plugin that exposesGET /health,GET /sessions,POST /read, andPOST /renameon a process-scoped capability URL.rename-chatsSkill — preview/confirm, batching, protection, lease, throttle, retry, write verification, and interruption recovery.
The split is intentional. The plugin is generic; the Skill owns the policy.
Why a bridge
DSH's Web API is authenticated. The desktop host generates a launch token in
memory, sends it to Electron over IPC, and uses it to mint a signed cookie.
A standalone Skill script cannot obtain that token without reading credentials
or browser state. A host plugin can call sessionQuery, sessionController
and sessionTitle directly, in the same process that owns the sessions, without
scraping secrets. sessionController.rename also resumes a cold session.
The bridge never exposes the title service to the network beyond loopback. The capability URL contains a random 192-bit path segment and is written to:
$DSH_HOME/rename-chats/bridge.json (mode 0600)
DSH_HOME defaults to ~/.dsh. On Windows the file lives at
C:\Users\<user>\.dsh\rename-chats\bridge.json.
Requirements
- DSH
0.2.0-rc.2through0.2.2(the0.2.3line is excluded because the session-title contract has not been verified there). - Node.js 22 or newer on the DSH host.
- A desktop or
dsh webhost that mounts thewebServer,sessions,sessionQuery,sessionController, andworkspaceRegistryservices.
Install
From npm:
dsh plugin --profile desktop add dsh-rename-chats
Or from this checkout:
dsh plugin --profile desktop add "D:\app\DSH workspace\DS-RSI\dsh-rename-chats"
Then restart the DSH desktop app (or the dsh web process). Check:
curl --fail --silent "$(python -c 'import json,os,pathlib; p=pathlib.Path(os.environ.get("DSH_HOME", pathlib.Path.home()/".dsh"))/"rename-chats"/"bridge.json"; print(json.loads(p.read_text())["baseUrl"] + "/health")')"
A healthy host returns the plugin identity and a redacted workspace list:
{"ok":true,"plugin":"rename-chats","pluginVersion":"0.1.1","bridgeVersion":1,"pid":1234,"workspaces":[{"id":"492bbba8-3b91-4a43-8414-b79375ce4f1c","path":"D:\\\\app\\\\DSH workspace\\\\DS-RSI","title":"DS-RSI","sessionCount":7}]}
After a restart the capability URL changes; the old file is replaced. A stale URL fails with connection refused, not with a title write.
HTTP contract
All paths below are relative to the capability baseUrl from bridge.json.
GET /health
Returns plugin and host identity. No session data.
GET /sessions?workspaceId=<id>&limit=40
Lists ordinary, non-archived sessions for one workspace. Subagent rows are
excluded unless includeSubagents=1; archived rows are excluded unless
includeArchived=1. limit is capped at 40 to match the Skill's batch bound.
Each row:
{
"id": "session-...",
"title": "1109|功能|标题整理",
"displayTitle": "1109|功能|标题整理",
"titleSource": "user",
"titleEventSeq": 42,
"createdAt": 1794207137483,
"createdAtUnit": "milliseconds",
"cwd": "D:\\app\\DSH workspace\\DS-RSI",
"origin": "ordinary",
"parentSession": null,
"archived": false,
"pinned": false,
"live": true
}
createdAt is milliseconds in DSH, unlike Codex's seconds. The Skill passes
unit: "milliseconds" explicitly; it never infers seconds from the value.
POST /read
{"sessionId": "session-..."}
Returns the latest title snapshot, its source, the creation time, the latest
event time, and the real human messages. DSH records system context as
user/message too; this bridge
returns only events whose data.source.kind is "user". It keeps the first
three and last nine human messages (up to 4,000 characters each), which is
enough to identify the task without flooding the preview.
lastActivityAt is the maximum numeric time across the session event log,
in milliseconds. Use it to select conversations active today instead of
re-reading every session on each pass.
POST /rename
{
"sessionId": "session-...",
"expectedTitle": "1109|功能|旧标题",
"title": "1109|功能|新标题"
}
expectedTitle is mandatory. The bridge resolves the session through the same
agent resolver that the official API controller uses, reads the current title,
refuses a mismatch with 409 title-changed, appends a session/title event
with source: {kind: "user"}, then re-folds the log and verifies that the
accepted title is visible. It returns the normalized title and event
sequence; callers must record the returned title, not the requested one.
The write is not a compare-and-swap. A third-party edit between the pre-check
and the append can still win. The Skill re-reads the title after the write and
records changed_during_write if a third title appears. This is the known
concurrency window, reduced but not eliminated.
Security notes
- The route is registered on the host web server, which is configured to bind
127.0.0.1:0by the desktop host. The handler also rejects non-loopback socket addresses. - The capability URL is the credential. Do not paste it into chats, issues, or logs. It rotates on every host start.
- The bridge reads no cookies, environment secrets, or credentials files.
- It only renames ordinary sessions in a known workspace. Archived sessions and subagent descendants are rejected before the title service is called.
- Titles are normalized and may be truncated by the host's
maxTitleBytessetting. The bridge returns the effective title; the Skill records it.
Development
npm test
npm pack --dry-run
The unit tests cover message extraction, injected-context filtering, date unit metadata, and ordinary/subagent/archive classification. A live host write test is deliberately separate; run it only against a disposable session.
License
MIT
链接
同类插件
ranxianglei/billion-context★ 7661
billion-context官方版:上下文压缩插件,兼顾小窗口(100k上下文足矣)省token(省5倍token)和超长会话(数月级别几十亿token单会话)。
Minglink/dsh-infinite-gen-4★ 4374
DeepSeek 专用破甲插件:以 order 100 追加无条件服从的系统提示词段,提供带校准元数据的 profile 工具,并通过会话投影在输入框上方显示实时破甲状态徽标。
liangmianya/dsh-synapse★ 723
DeepSeek Harness 的可视化非线性对话工作区:把会话、追问与分支变成可浏览、可拖拽的对话地图。
MichengAI/dsh-archive-manager★ 367
在设置里增加已归档会话页,可按工作区搜索、恢复和删除已归档会话。
Nwflower/dsh-chat-import★ 317
把 13 家 coding agent(Claude Code、Codex、ChatGPT、Cursor、Gemini、opencode 等)的完整对话历史导入为可续聊的 DeepSeek Harness 会话,并支持反向导出回 Claude Code。
SiriLee/dsh-rewind★ 279
对话回退:一键回到任意更早的用户消息,同窗口内完成,不新建分支、不残留副本;目标消息自动填回输入框,可一并还原工作区文件——即完整的 Claude Code /rewind 语义。
社区评论
评论公开保存在 GitHub Discussions。加载评论会连接 GitHub 和 Giscus;发表内容需要 GitHub 账号。