@nakie-zjm/dsh-session-delete
中文 | English
中文
给 DeepSeek Harness Desktop加一个会话永久删除动作。
DSH 只提供「归档」：会话日志是 append-only 的，dsh-session-persistence
没有任何删除方法，dsh-workspace 注册表也没有 removeSession。这个插件把
已有的公开服务组合成一个真正的删除操作，并把入口挂到侧栏会话行的 … 菜单里。
安装
包名：@nakie-zjm/dsh-session-delete
方式一：DSH 插件页（推荐，桌面版和 Web 版都适用）
- 打开 DSH 的 插件 页面；
- 在「添加插件」里填入包名和版本：
@nakie-zjm/dsh-session-delete@0.1.1
- 按页面结果操作。桌面版需要完全退出并重启应用——bundle 选择是启动时读取的，
配置 HMR 不会重新读 profile 的package.json。
安装器会自动把包加入 profile 依赖、把 bundle 选进 dsh.profile.bundles，包内的
cordis.patch.yml 随层生效，不需要手改任何配置文件。
方式二：dsh plugin 命令行
dsh plugin --profile desktop add @nakie-zjm/dsh-session-delete@0.1.1
dsh plugin --profile web add @nakie-zjm/dsh-session-delete@0.1.1
官方桌面版的 dsh 命令默认不在 PATH 里，需要先在应用里注册自带的命令
（应用菜单中的 Manage dsh Command…），并在完全退出应用后使用 desktop profile。
从 npm 安装时 --profile 换成你自己的 profile 名。
方式三：不用 dsh plugin 的手动兜底
cd ~/.dsh/profiles/desktop # 或你的 profile 目录
pnpm add @nakie-zjm/dsh-session-delete@0.1.1
然后在 ~/.dsh/profiles/desktop/package.json 里确认两处（安装器正常情况下会自己写）：
{
"dependencies": { "@nakie-zjm/dsh-session-delete": "0.1.1" },
"dsh": { "profile": { "bundles": [ /* …, */ "@nakie-zjm/dsh-session-delete" ] } }
}
重启应用生效。
卸载
dsh plugin --profile desktop remove @nakie-zjm/dsh-session-delete
或在插件页点卸载。卸载只移除插件本身，不会删除任何已有会话。
兼容性
针对 DSH 0.2.0-rc.2 开发与验证。插件依赖下面这些宿主接口，DSH 升级后可能需要跟着更新：
Workspace.detachSession、workspaceRegistry.archiveSession / unarchiveSession / unpinSession、
sessionPersistence.list / resolveCurrentLog、Connection 的 /api exact Fetch 路由注册、
api-session/removed 转发事件、以及客户端插件的 dsh.client 约定与平台种子模块表。
其中只有 resolveCurrentLog 缺失会自动退回布局复刻，其余缺失会降级成警告或明确拒绝，
不会静默删错东西。
行为
只加一个入口：会话行悬停出现的 … 菜单里多一项 永久删除（红色，order 500，
排在归档 400 之后）。不加行内悬停按钮。
- 预检：解析会话（先查活动会话，再查持久化列表），并从宿主拿到它真实的日志位置，
同时把「能不能安全删」全部判完——这一段有任何拒绝都发生在改动任何状态之前； - 确认对话框：显示会话标题和不可恢复的提示，取消不做任何写入；
- 确认后：
- 会话若还在跑回合：先经注册表自己的归档准入接缝（archiveSession({stopActivity:true})）
停掉这些工作，并把借用的归档标记恢复原状（本来没归档就收回，本来就在归档集合里
就保留），然后才继续；
- 从工作区记账中摘除（Workspace.detachSession，会持久化并推送变更）；
- 从归档集合、置顶集合中摘除；
- 永久删除会话日志目录与投影缓存文档；
- 发出api-session/removed，浏览器会话列表立即去掉这一行。
不可恢复。 没有回收站、没有备份、没有撤销。
永久删除怎么做到失败也安全
直接 rm -rf 会在中途失败时留下半棵目录树，而 DSH 下一次启动仍会把它当成会话读。
所以删除走两步隔离：
rename(会话目录 → ~/.dsh/sessions/.dsh-session-delete-<随机>/<会话id>/) ← 同卷，原子
→ 重新 lstat 校验身份（dev/ino/birthtimeNs 与改记账前一致；目录 size 会随内容
变化，不算身份）
→ rm(隔离目录, recursive, force:false)
→ 再 stat 一次确认真的没了
- 身份对不上（删除期间被换掉）：放回原位，什么都不删，报
unsafe-location； rm中途失败：报错并告知隔离目录的完整路径，~/.dsh/sessions/下不会留下会被误读的目录，只会留下一个.dsh-session-delete-*待你处理；- 全部成功才清理隔离目录本身。测试断言：删除完成后
.dsh-session-delete-*一个不剩。
位置与安全
- 位置来自宿主：会话目录优先取
sessionPersistence.resolveCurrentLog(id)的答案，
只有后端答不出来时才退回本插件对布局的复刻（复刻有测试对着真实目录逐条核对）。
后端答案必须满足/<项目目录>/<会话id>/transcript的形状，否则拒绝。 - 符号链接防护：删除前用
lstat+realpath证明目标是真目录、父目录就是
~/.dsh/sessions/下的项目目录、且解析后仍在 sessions 根内（harness home 本身
经符号链接 / junction 到达时两边都按解析后的路径比较，不会被误判成越界）。指向别处
就拒绝——测试会造一个 junction 指向根外目录，断言拒绝并且目标文件完好无损。 - 拒绝不留副作用：身份检查、位置检查、运行中检查都排在第一次持久化写入之前。
任何拒绝之后，会话仍然在工作区原位、仍然在原有归档/置顶状态，日志一个字节没动。 - 请求加固：只接受 POST +
application/json；浏览器请求必须同源且带
x-dsh-session-delete-confirmation: delete-session（链接和 HTML 表单设不了自定义头，
所以跨站导航打不到这个分支；同源判定是 Origin 与请求自身 Host 的主机名比对，
http 或 https 都算）；会话 id 必须匹配[A-Za-z0-9_-]{1,128}；请求体先查
content-length、再核对读到的长度，超过 8 KiB 直接 413。无Origin的原生调用方
（CLI / Agent 直接 POST loopback）由宿主信任栅栏认证，不需要那个头。
已知边界
- 正在运行的会话：插件会先停掉它的回合再删。停不下来（宿主没提供归档准入接缝，
或者停完仍是 live）才拒绝，返回session-delete/running（HTTP 409），并且此时
一个文件都没动，归档状态也和删除前完全一样：本来没归档的仍然没归档，把它的工作
停掉再重试即可；本来就在归档集合里的会保持归档，需要先去侧栏的「显示已归档」筛选里
取消归档再重试。当前正在对话的这个会话通常属于这一类（它始终 live）。 - 会话的图片/文件附件是内容寻址的全局存储，其它会话可能共享，所以删除不动
~/.dsh/attachments。这会留下孤儿字节，但不会误删别人的数据。 - 清理中途失败：工作区记账摘除之后，文件步骤（改名 / rm）仍可能失败。此时会话
已经不属于任何工作区（侧栏刷新后行会消失），磁盘上可能留下.dsh-session-delete-*
隔离目录或投影缓存文档；错误信息会说明失败原因（已隔离的会给出隔离目录完整路径），
重试一次通常能删干净，也可以按路径手工清理。 session_projcache的内存表保留该会话那一行直到重启；磁盘文档已删除，且没有
日志的会话不会再被水合，所以不影响使用。- 删掉就没了。要保留内容，请先用官方的
/export命令导出一份 ZIP。 - 与
dsh-session-delete（vtxf 的
同名插件）不能同时装：两者都注册sidebar.workspaces.session.menu.item，菜单里会
出现两个删除项。它侧重目录级批量归档/删除，本插件侧重单会话删除的失败安全与
运行中会话的处理。
开发
仓库根就是包根。产物只有 lib/client.js 一个文件：
dsh-session-delete/
package.json main → src/index.js、./client → lib/client.js、dsh.bundle.patch
cordis.patch.yml bundle 补丁层：插入一行 Loader entry
src/index.js 宿主半（源码 = 产物：删除编排 + /api/session.delete 路由）
src/client.js 浏览器半源码：工厂体，用 require/exports/module
lib/client.js 浏览器半产物：build-client.mjs 套上 lazy-CJS 外壳
scripts/build-client.mjs 唯一的构建步骤；--check 校验产物是否过期
test/host-half.mjs 宿主半端到端（临时 DSH_HOME，真删文件）
test/browser-half.mjs 浏览器半（在 Node 里物化 lib/client.js，桩掉 React 与 fetch）
test/verify-endpoint.mjs 对运行中的实例核对路径推导与可达性
test/deployment-check.mjs 对 verify-endpoint 的回归（桩宿主：404 已挂载 / 报错要说清 URL）
宿主半不需要构建：DSH 的 Loader 用 import 加载它，main 直接指向 src/index.js。
浏览器半需要构建：DSH 只服务一个文件（exports["./client"]），它必须自己调用
window.__ModuleLoader__.load({ id, factory })，而模块表没有相对加载器，所以外壳
不能写进源码再 import。外壳由 scripts/build-client.mjs 套上——源码保持可读，产物
可复现（npm run build:check 校验产物是否过期）。
npm run build # 生成 lib/client.js
npm test # 宿主半 75 项 + 浏览器半 47 项 + 部署检查 2 项
npm run verify # 对运行中的 DSH 实例核对（需应用在跑）
npm run check # build:check + test，prepublishOnly 会自动跑
npm run verify 不依赖任何机器相关的写死路径：harness home 走 DSH_HOME（默认
~/.dsh）经插件自己的解析器，base URL 依次取命令行参数、DSH_WEB_URL、
再依次探测 19387 / 3000 / 8080 / 8000 / 5173。它只能确认「根目录存在 + 有 DSH 宿主
在跑」；无法判断路由是否挂载——未认证请求会被信任栅栏统一挡成 401，无论路由
在不在。要判定挂载，请用它在 Web UI 控制台里打印的那条已认证 fetch。
本包没有任何运行时依赖：客户端只用平台种子模块表里的
react、react/jsx-runtime、@deepseek-ai/dsh-client-store、
@deepseek-ai/dsh-client-ui-primitives。
许可
MIT
English
Adds one permanent session delete action to DeepSeek Harness (Desktop and Web).
DSH ships archive only: the session log is append-only, dsh-session-persistence
exposes no delete, and the Workspace registry has no removeSession. This plugin
composes the existing public services into a real delete and mounts the entry in
the sidebar session row's … menu.
Install
Package name: @nakie-zjm/dsh-session-delete
Plugins page (recommended): open DSH → Plugins, then add
@nakie-zjm/dsh-session-delete@0.1.1. The installer adds the profile dependency,
selects the bundle in dsh.profile.bundles, and the package's own
cordis.patch.yml applies as a layer — no configuration file is edited by hand.
Desktop requires a full app restart, because bundle selection is read at startup.
CLI:
dsh plugin --profile desktop add @nakie-zjm/dsh-session-delete@0.1.1
dsh plugin --profile web add @nakie-zjm/dsh-session-delete@0.1.1
The official Desktop build does not put dsh on PATH; register the bundled
command first (Manage dsh Command… in the app menu) and use the desktop
profile after fully quitting the app.
Manual fallback: in ~/.dsh/profiles/, run
pnpm add @nakie-zjm/dsh-session-delete@0.1.1, then confirm the name appears in
both dependencies and dsh.profile.bundles of that profile's package.json.
Uninstall: dsh plugin --profile desktop remove @nakie-zjm/dsh-session-delete,
or use the Plugins page. Uninstalling never deletes existing sessions.
Compatibility: built and verified against DSH 0.2.0-rc.2.
Behaviour
One entry only: a red Delete permanently row (order 500, after archive at 400)
in the session row's … menu. No hover button.
Every check that can refuse — identity, location, and whether the session is
running — runs before the first durable write, so a refusal leaves the session
exactly as it was. Confirming then stops a running turn through the registry's own
archive admission seam (putting the borrowed archive marker back exactly as it
was — cleared if it was not set, kept if it was), detaches the session from its
Workspace, drops it from the archive and pin sets, removes its log directory and
projection cache, and emits api-session/removed so the browser list drops the row.
There is no undo. No trash, no backup. Export with /export first if you want
to keep the transcript.
The recursive removal is staged: the session directory is renamed into a
quarantine directory beside its project directory, its identity (dev/ino/
birthtimeNs — directory size changes with content, so it is not identity) is
re-checked there, and only then removed — so a failed removal can never leave a
half-deleted tree where DSH would read it as a session.
Safety
- The directory comes from
sessionPersistence.resolveCurrentLog(id); the plugin's
own replica of the layout is only a fallback. lstat+realpathprove the target is a real directory inside the sessions
root before anything is removed; both sides of that comparison are resolved, so a
harness home reached through a symlink or junction is not mistaken for an escape,
while a junction pointing outside is still refused.- The route accepts POST +
application/jsononly, requires a same-origin browser
request (Origin matching the request's own Host, over http or https) carrying
x-dsh-session-delete-confirmation, pins the session id to
[A-Za-z0-9_-]{1,128}, and checks the body length before parsing it. - Attachments under
~/.dsh/attachmentsare content-addressed and shared, so they
are never touched.
Known limits
- A session whose turn will not stop is refused with
session-delete/running
(HTTP 409) and no file is touched. Its archive state is exactly what it was before
the attempt: one that was already archived stays archived (unarchive it from the
sidebar filter before retrying), and an unarchived one just needs its work stopped
before the retry. - A failure mid-cleanup: after the workspace accounting is removed, the file step
(rename / rm) can still fail. The session is no longer in any workspace (the row
disappears after a refresh) while a.dsh-session-delete-*quarantine directory or
the projection cache document may remain on disk; the error explains what failed
(naming the quarantine path when one was left), a retry usually finishes the
cleanup, and the leftover can also be removed by hand. - Cannot be installed alongside
dsh-session-delete(vtxf's
plugin): both register the same menu slot, so the menu would show two delete rows.
Development
npm run build # regenerate lib/client.js
npm test # host half (75 checks) + browser half (47 checks) + deployment check (2)
npm run check # build:check + test — also runs on prepublishOnly
No runtime dependencies: the browser half uses only platform seed modules.
License
MIT
