dsh-agent-control
DeepSeek Harness 插件：把「删除一个会话」与「从模型上下文中删除一轮对话」这两件破坏性操作收进一个插件，用同一套确认与失败语义管理。
插件会安装到这里；不确定时保持 web。
npx -y @deepseek-ai/dsh plugin --profile web add github:ventisyn/dsh-agent-control#1efb7e7d324c07c9cbd8a6662371fe6bb7b5c782Agent Control 以 dsh-agent-control 发布，当前版本为 0.2.1-alpha.1-v1.0.1。Plugin Hub 会校验它的 manifest，并保存精确安装来源，便于复现安装结果。
DeepSeek Harness（DSH）插件：把两件破坏性、不可撤销的操作收进一个插件，用同一套确认与失败语义管理。
$DSH_HOME/attachments，可能被别的会话引用）system/message 墓碑）会让会话重启后打不开，已不再使用。本插件只使用 DSH 的公开 API：不依赖内核的私有结构，也不照抄任何第三方插件的实现。这一点是刻意的——依赖私有结构的写法换一个 harness 版本就会静默失效（详见 AGENTS.md 第 4 节）。
| 删除会话 | 删除一轮 | |
|---|---|---|
| 磁盘日志 | 永久删除 | 保留（日志是 append-only，不改写、不截断） |
| 模型上下文 | 会话整个消失 | 那一轮不再进入上下文 |
| 附件 | 随会话目录一起删 | 不会清理（见下方「已知限制」） |
| 可恢复 | ❌ 不可恢复 | ❌ 但内容仍在日志里 |
⚠️ 删除一轮不是安全删除。 它通过在日志末尾追加一笔压缩事务、把那一轮从模型可见面上替换掉来实现。被删内容仍然完整留在会话日志与附件存储里，只是不再进入模型上下文。任何「删了就没人能看到」的理解都是错的。
dsh web 退出。所以要删一个本次启动后打开过的会话，只能重启 dsh web，重启后不要点开它，直接从侧栏「…」菜单删除。$DSH_HOME/attachments。webServer 配置成 0.0.0.0，请自行评估。# 从已发布的版本分支安装
dsh plugin --profile <profile 名> add github:ventisyn/dsh-agent-control#0.2.1-alpha.1-v1.0.1
# 本地开发（改完重启即生效）
dsh plugin --profile <profile 名> add link:<本地 clone 路径>
⚠️ 如果 profile 里已经装了别的删除类插件，请先移除，否则界面上会出现两套删除按钮——同一批槽位只能有一个主人：
dsh plugin --profile <profile 名> remove <占用了同名槽位的插件>
安装或改动 host 端代码后需要重启 dsh web：已加载的 host 模块不会因为文件改动而重新导入（新增的路由会一直返回 401）。
装好之后：
# 会话列表（同时也是「路由是否注册成功」的探针）
curl http://127.0.0.1:<端口>/api/agent-control/sessions
浏览器控制台里：
window.__dshAgentControl.usingNativePrimitives() // 用的是原生原语还是自带兜底
window.__dshAgentControl.id // 注册 id
接口一览：
GET /api/agent-control/sessions 会话列表
GET /api/agent-control/turns?sessionId= 某个会话里已被删除的轮次
POST /api/agent-control/session/delete { sessionId }
POST /api/agent-control/turn/delete { sessionId, assistantMessageId }
失败一律返回 { ok: false, error: { code, message } }。错误码含义：
| 码 | 含义 |
|---|---|
SESSION_LIVE | 会话本次启动后打开过、仍驻留在内存里：重启 dsh web 后不打开它直接删 |
TARGET_NOT_FOUND | 目标已经不存在 |
TURN_NOT_CLOSED | 那一轮还没结束 |
TURN_COMPACTED | 那一轮已被压缩或不再连续，无法单独删除 |
AGENT_BUSY | 会话的任务没有停下来，已放弃删除 |
DELETE_FAILED | 宿主拒绝了这次删除（消息里带原始原因） |
npm test # 语法检查 + 84 项离线测试，不需要 DSH 进程，也不碰真实 profile
设计与取舍、与 DSH 版本的耦合点、改完的自检清单都在 AGENTS.md。
docs/VERIFY-*.md 里，请按那里的结论判断它的成熟度，不要只看本页的概览。MIT