dsh-session-id-for-desktop

给 DeepSeek Harness（DSH） 左侧会话列表的行菜单补两项：复制会话 ID 与 永久删除会话（含存储）。

不改 DSH 源码，不读 React fiber，不往 DOM 上贴东西 —— 全部走 DSH 官方插槽。

实测环境：DSH 0.2.0-rc.2（官方 Desktop，Windows x64；Web profile 同源）

---

功能

功能	入口	说明
复制会话 ID	会话行 ⋯ 菜单 → 复制会话 ID	写入剪贴板后菜单自动关闭
删除会话（含存储）	会话行 ⋯ 菜单 → 删除会话（红色）	二次确认框：显示磁盘占用、明确「不可恢复」、说明附件不删

菜单里的顺序（官方项 + 本插件项）：

重命名 (200)  →  复制会话 ID (150)  →  分叉 (300)  →  归档 (400)  →  删除会话 (500)

双击标题重命名由 DSH 原生提供，本插件不重复实现。

---

安装

Desktop（推荐）：DSH → 插件 → 添加插件 → 用下面任一来源安装本包

• 本地路径（开发用）
• GitHub：github:zf-666888/dsh-session-id-for-desktop
• npm（若已发布）

Web profile（CLI）：

dsh plugin --profile web add github:zf-666888/dsh-session-id-for-desktop

装完 完全重启 DSH。客户端代码字节是启动时快照的，只刷新页面不够。

安装后 dsh-session-id-for-desktop 会出现在 profile 的 dsh.profile.bundles 里，本包自带的 cordis.patch.yml 会自动把插件行插进 Loader，不需要你改 profile 的任何文件。

---

它到底删了什么

删除是不可恢复操作，所以这里写清楚：

$DSH_HOME/sessions/<工程目录键>/<会话 ID>/          会话日志目录（session.v<N>.jsonl.zstd + 同目录其它产物）
$DSH_HOME/storages/session_projcache/sessions/<会话 ID>.json   投影缓存
$DSH_HOME/storages/workspace.json                  从 archivedSessionIds[] 与各 workspaces[*].sessionIds[] 摘除该 ID

附件不会删。 $DSH_HOME/attachments/v1/objects/ 里是按内容寻址（sha256 分片）的对象，多个会话可能共用同一份，按会话删除会误伤其他会话。

「归档」与「删除」的区别：归档只是把会话移出列表，日志与记账位都保留，可移回；删除会把上面那些物理抹掉。

---

安全设计

• 删除前校验：会话 ID 走 ^[A-Za-z0-9][A-Za-z0-9._-]{0,127}$；路径段按存储后端一致的方式转义；每个候选目录再校验一次仍在 sessions 根之下；不跟随符号链接/junction。
• 正在运行的会话拒绝删除：判定用 DSH 自己的 agent/status（ctx.agents.get(id).status === 'running'），不自己发明"忙碌"概念。只打开着但空闲的会话可以删。
• 只碰自己的接口：/api2/dsh-session-id-for-desktop/*，仅 POST、仅 application/json、仅回环 Host（可用 DSH_SESSION_ID_FOR_DESKTOP_TRUSTED_HOSTS 追加受信主机名）。内容是 JSON 是为了强制 CORS 预检，而本路由不响应预检。
• 磁盘上已无该会话时也能收尾：inspect 返回 exists: false，确认框改成"只把这一行从列表收掉"，不再出现"看着能点、点了没反应"。

---

兼容性

DSH	本插件
0.2.0-rc.2（Desktop / Web）	0.1.x

依赖的宿主插槽（dsh-client-ui-workspace 声明，随 DSH 版本演进）：

插槽	kind	用途
sidebar.workspaces.session.menu.item	list / root	两个菜单项
shell.overlay	list / root	删除确认框（官方重命名对话框也在这里）

---

已知限制

• 不提供右键菜单。DSH 没有右键钩子，只能靠 DOM 去猜那个 ⋯ 按钮，脆弱且易误伤；而 ⋯ 菜单里已经有这两项，一次点击可达。
• 被删除的"打开着的空闲会话"：磁盘与列表立刻干净，但进程内还会留着它的副本，直到重启 DSH 才彻底释放。
• workspace.json 的摘除可能被回滚：Workspace registry 在内存里另有一份状态，它下次写入会整份覆盖。残留只是一个指向"已不存在会话"的 ID，任何分组视图都不会渲染它；宿主的会话索引本身有对账逻辑。
• 只对 Web UI 生效；无头 profile 下宿主半边加载为空操作。

---

实现说明

为什么不用 dsh-session-actions

上游 dsh-session-actions@0.3.1 的浏览器半边靠 React fiber props 判定"这是会话行"：

props.node && typeof props.onRename === 'function' && typeof props.onArchive === 'function'

而 0.2.0-rc.2 的行组件签名已经变成：

function SessionNodeItem({ node, currentId, now, onOpen, onRenameRequest, renderSlot, onReveal, drag, t })

两个属性名都已不存在，判定永远为假 —— 于是插件"加载成功但完全无效果"，这是最难排查的一类失效。详见上游 issue：duanyunlun/dsh-session-actions#1。

0.2.0-rc.2 其实已经提供了官方插槽，官方自己就是这么用的：

renderSlot("sidebar.workspaces.session.menu.item", { sessionId, displayTitle },
           { hookContext: menuOpenState })

ctx.slots.inject("sidebar.workspaces.session.menu.item", function* () {
  yield ctx.slots.register({ name: "…", id: "pin",     order: 100, … }, PinSessionMenuItem)
  yield ctx.slots.register({ name: "…", id: "rename",  order: 200, … }, RenameSessionMenuItem)
  yield ctx.slots.register({ name: "…", id: "fork",    order: 300, … }, ForkSessionMenuItem)
  yield ctx.slots.register({ name: "…", id: "archive", order: 400, … }, ArchiveSessionMenuItem)
})

sessionId / displayTitle 由宿主直接给，不需要从 DOM 文本反推（两个同名会话也不会认错）。

文件

文件	作用
client.js	浏览器半边：注册两个菜单项 + 确认框。零依赖，只 require react 与 @deepseek-ai/dsh-client-ui-primitives
index.js	宿主半边：挂 /api2/dsh-session-id-for-desktop/{inspect,delete}
session-files.js	磁盘操作：定位会话目录、算大小、删日志、清投影缓存、摘工作区引用
cordis.patch.yml	bundle 层：插入插件行

index.js 与 session-files.js 复用上游 MIT 代码（仅改路由前缀与插件名）。

---

卸载

在插件页停用/移除本 bundle，或从 profile 的 dsh.profile.bundles 里删掉 dsh-session-id-for-desktop —— 本插件是纯增量（patch 只有一条 insert，不停用任何宿主条目），移除后不留残迹。

---

许可

MIT。index.js / session-files.js 源自 duanyunlun/dsh-session-actions（MIT，Copyright (c) duanyunlun），详见 LICENSE。