@l1vide/dsh-session-delete 0.0.0-stage → 1.3.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 L1vide (Dubai1210)
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,3 +1,160 @@
-# Temporary Holding Version
+# DSH Session Delete
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+[![Listed on dsh-plugin.org](https://dsh-plugin.org/badges/listed.svg)](https://dsh-plugin.org/plugins/Dubai1210/dsh-session-delete)
+
+在会话「⋯」菜单的「归档会话」下面多一项 **删除会话**：点一下、确认一次，这个会话的对话记录消失、它在工作区留下的过程残留被清掉，**它做出来的成果保留**。
+
+DSH 自带的「归档」只是把会话从列表里挪走，文件还在、可以取消归档恢复。这个插件补上真正不可逆的那一步。
+
+## 功能
+
+- 菜单项插在 `sidebar.workspaces.session.menu.item` 插槽 **order 410**，即「归档会话」之后、「会话 ID」之前
+- 垃圾桶图标，点击先关闭菜单，再弹出二次确认框
+- 确认框打开时先做一次只读扫描，列出「会删掉哪些过程文件」「会保留多少成果文件」，可取消勾选只删对话
+- 确认后 Host 侧一次性完成清理，所有已打开的窗口立刻把该行移除
+
+## 删除范围
+
+| 对象 | 处理 |
+| --- | --- |
+| 对话记录 | `~/.dsh/sessions/<project>/<session-id>/` 整目录删除（`session.v4.jsonl.zstd` 等世代日志） |
+| 投影缓存 | `storages/session_projcache` 里该会话的行（含投影后的消息正文） |
+| 工作区里的过程残留 | 该会话新建的脚本、下载的工具、临时文件和脚手架目录，逐个 `rm`，随后清掉因此变空的目录（不越过会话 `cwd`） |
+| 正在运行的 agent | `cancel({kind:"user"})` + `agent.scope.dispose()`，释放日志文件句柄 |
+| 工作区归属 | 从每个工作区记录的 `sessionIds` 中 `detachSession` |
+| 归档 / 置顶集合 | 全局 `archivedSessionIds`、`pinnedSessionIds` 中移除 |
+| 客户端列表 | `ctx.emit("api-session/removed", id)` → 所有窗口实时移除该行 |
+
+成果文件、你原来就有并被它改过的文件，都不在删除范围内。详见下一节。
+
+删除**不进回收站**，对话记录不可恢复。
+
+## 哪些文件算残留，哪些算成果
+
+判定在 `lib/classify.js`，先保后删：
+
+**一律保留**
+
+| 情况 | 理由 |
+| --- | --- |
+| 会话**修改过**的文件（`kind === "modified"`） | 改的是你的东西，删了无法还原 |
+| 通过 `present` 工具交付的文件 | 会话明确交给你的成果 |
+| 最后一次回复正文里点名的文件 | 同上 |
+| 位于 git 仓库内的文件 | 是项目代码，能靠 git 回滚 |
+| 文档/数据/媒体扩展名：`.docx .xlsx .pptx .pdf .md .txt .csv .png .jpg .mp4 .json .yaml .html` 等 | 成果形态 |
+| 判不出来的扩展名 | 宁可留着 |
+
+**会被清理（仅当文件是该会话新建的）**
+
+| 类型 | 例子 |
+| --- | --- |
+| 脚手架目录内的文件 | `node_modules/` `dist/` `build/` `tmp/` `temp/` `.cache/` `__pycache__/` `.venv/` `target/` `coverage/` |
+| 脚本/源码 | `.js .mjs .cjs .ts .py .ps1 .sh .bat .rb .pl .php .lua .go .rs .java` … |
+| 下载或构建产物 | `.exe .msi .zip .7z .tar .gz .apk .jar .whl .dll .so` … |
+| 临时文件 | `.log .bak .tmp .out .err .orig .rej .swp` |
+| 隐藏文件 | 以 `.` 开头的 |
+| 因此变空的目录 | 顺手删掉，不越过会话 `cwd` |
+
+「新建」的判定：该会话对它的第一次操作是写、且此前没读过它 —— DSH 要求覆盖已有文件前先读，所以「写而无读」即表示文件原本不存在。
+
+做不到的部分（明确写在这里，避免误解）：
+
+- **通过 shell 命令写出的文件不在归属范围内**。`bash` / `ops_bash` 的命令行只有字符串，没有可解析的目标路径，插件不会去猜。所以 `pip install`、`curl -o`、`python make.py` 产生的东西会留在磁盘上
+- 子会话（subagent）写出的文件不计入父会话；要清就删对应子会话
+- 「修改」类文件只保留、不还原 —— 原内容已被覆盖，本插件不做备份；需要旧版本请靠自己的 git
+
+## 安装
+
+源码安装（GitHub）：
+
+```bash
+dsh plugin --profile web add github:Dubai1210/dsh-session-delete
+```
+
+本地目录安装（开发调试）：
+
+```bash
+dsh plugin --profile desktop add link:/path/to/dsh-session-delete
+```
+
+安装后**刷新一次 DSH 窗口**（Ctrl+R）让 client bundle 加载；如果菜单里没有出现新项，重启一次 DSH。
+
+## 使用
+
+1. 在左侧工作区列表里找到目标会话行，点行尾的「⋯」
+2. 选择「归档会话」下面的「**删除会话**」
+3. 弹窗会先扫一次工作区，列出要清的过程文件；不想清就取消勾选
+4. 点「删除」
+5. 该会话行消失，对话记录和过程残留同时被清掉，成果文件还在
+
+## 权限与风险
+
+- Host 半只注册同源 HTTP 路由：`POST /dsh-session-delete/inspect`（只读预检）、`POST /dsh-session-delete/delete`。同源校验照抄 DSH 官方插件的做法：拒绝 `sec-fetch-site: cross-site`、`origin: null`、以及 `origin.host` 与 `host` 头不一致的请求
+- 只操作本机 `~/.dsh` 下的会话数据、工作区注册表，以及该会话自己留下的过程文件，**不发起任何外部网络请求**，不依赖任何第三方服务
+- 没有任何遥测、没有后台常驻任务
+- 风险点：删除是永久性的。被判定为「残留」的文件如果没有版本控制，删掉就没了；判定规则和预览清单就是为此存在的
+
+## 兼容与运行要求
+
+- DSH：0.2.x（desktop profile 与 web profile 均可）
+- 平台：Windows / macOS / Linux
+- 运行时：Node.js >= 18（Host 半只用 `node:fs/promises`、`node:path`、`node:zlib`）
+- 依赖的服务：`webServer`、`sessions`、`agents`、`sessionPersistence`、`workspaceRegistry`、`storageDomain`，全部来自 DSH 基础 bundle，无额外依赖
+
+## 能力分类
+
+界面与体验（同时涉及会话与消息的数据清理）
+
+## 实现说明
+
+bundle 插件，两半：
+
+**Host** — `lib/index.js`，导出 `apply(ctx)`，注册两条 `webServer` exact 路由。删除流水线：
+
+1. `lib/transcript.js` 读转录日志（多帧 zstd）拿出该会话碰过的工作区文件
+2. `lib/classify.js` 把它分成「保留 / 残留」两堆（有 `present`、末尾回复、git 仓库、扩展名等信号）
+3. 只对「残留」逐个 `rm`，再清空目录
+4. 停活 agent 并释放文件句柄
+5. `sessionPersistence.locate({cwd, id})` 定位日志文件，`rm -r` 其所在会话目录
+6. `storageDomain.get("session_projcache").table("sessions").delete(id)` 清投影缓存行
+7. 遍历 `workspaceRegistry.list()`，逐个 `entity.detachSession(id)`
+8. `unarchiveSession(id)` + `unpinSession(id)` 清全局集合
+9. `ctx.emit("api-session/removed", id)` 通知所有客户端
+
+每一步独立 try/catch，单步失败不影响其余步骤；返回值 `{ok, live, removedFiles, cacheRows, headerFound, workspace:{removed,kept,failed,cwd}}` 便于排查。
+
+文件归属解析在 `lib/transcript.js`：会话日志是**多帧 zstd**（每个追加批次一帧），一次性 `zstdDecompressSync` 只能解出第一帧，所以这里先按 frame header / block header 走一遍结构定位所有完整帧再逐帧解压；然后扫描 `tool/call` 事件，按工具名取路径参数（`path` / `file_path` / `target_file`，`apply_patch` 走 `*** Update File:` 行），用会话 `cwd` 规整并拒绝越界路径。
+
+**Client** — `client.js`，`window.__ModuleLoader__.load` 注册懒工厂，往两个插槽注册：
+
+- `sidebar.workspaces.session.menu.item` → 删除菜单项（order 410）
+- `shell.overlay` → 确认弹窗（`Modal` + 清单 + 清理开关 + 取消/删除按钮）
+
+打开弹窗先 `fetch("/dsh-session-delete/inspect")` 取清单，确认时 `fetch("/dsh-session-delete/delete", {body:{sessionId, clean}})`，同源、`credentials: same-origin`。
+
+## 目录结构
+
+```
+dsh-session-delete/
+├── package.json          # dsh.bundle.patch + dsh.client
+├── cordis.patch.yml      # - insert: 宿主插件条目
+├── lib/index.js          # Host 半：两条路由 + 删除流水线
+├── lib/transcript.js     # Host 半：多帧 zstd 解码 + 会话写文件归属解析
+├── lib/classify.js       # Host 半：残留 / 成果判定
+├── client.js             # Client 半：菜单项 + 确认框
+├── locale/en.json        # meta.title / meta.description
+├── locale/zh.json
+└── icon.svg
+```
+
+## 开发
+
+改完文件后重新装一次即可热生效（Host 半需要重新加载）：
+
+```bash
+dsh plugin --profile desktop add link:/path/to/dsh-session-delete
+```
+
+## 许可证
+
+MIT，见 [LICENSE](LICENSE)。

package/client.js

@@ -0,0 +1,277 @@
+window.__ModuleLoader__.load({
+  id: "dsh-session-delete",
+  factory: (require) => {
+    const module = { exports: {} };
+    const exports = module.exports;
+    Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+
+    const react = require("react");
+    const jsxRuntime = require("react/jsx-runtime");
+    const primitives = require("@deepseek-ai/dsh-client-ui-primitives");
+    const store = require("@deepseek-ai/dsh-client-store");
+
+    const jsx = jsxRuntime.jsx;
+    const jsxs = jsxRuntime.jsxs;
+    const Fragment = jsxRuntime.Fragment;
+    const createSnapshotStore = store.createSnapshotStore ?? store.default?.createSnapshotStore;
+
+    const name = "dsh-session-delete";
+    const NS = "dsh-session-delete";
+    const inject = ["slots", "locale", "sessions"];
+
+    const DELETE_URL = "/dsh-session-delete/delete";
+    const INSPECT_URL = "/dsh-session-delete/inspect";
+
+    const zh = {
+      "menu.deleteSession": "删除会话",
+      "delete.confirm.title": "删除此会话？",
+      "delete.confirm.desc":
+        "对话记录会永久删除，它在工作区里留下的过程文件（脚本、下载的工具、临时文件）一并清理；它做出来的成果文件会保留。",
+      "delete.confirm.action": "删除",
+      "delete.confirm.pending": "正在删除…",
+      "delete.scanning": "正在检查工作区…",
+      "delete.scanFailed": "工作区检查失败，仍可删除会话。",
+      "delete.cleanup.label": "清理 {count} 个过程文件",
+      "delete.cleanup.none": "没有需要清理的过程文件",
+      "delete.keep.label": "保留 {count} 个成果文件（含被修改的文件）",
+      "cancel": "取消",
+      "close": "关闭"
+    };
+
+    const en = {
+      "menu.deleteSession": "Delete session",
+      "delete.confirm.title": "Delete this session?",
+      "delete.confirm.desc":
+        "The conversation is deleted for good, together with the scaffolding it left in the workspace (scripts, downloaded tools, temp files). Files it produced are kept.",
+      "delete.confirm.action": "Delete",
+      "delete.confirm.pending": "Deleting…",
+      "delete.scanning": "Checking the workspace…",
+      "delete.scanFailed": "Workspace check failed; the session can still be deleted.",
+      "delete.cleanup.label": "Clean up {count} scaffolding files",
+      "delete.cleanup.none": "Nothing to clean up",
+      "delete.keep.label": "Keep {count} result files (modified files included)",
+      "cancel": "Cancel",
+      "close": "Close"
+    };
+
+    const listStyle = {
+      margin: "8px 0 0",
+      padding: "6px 8px",
+      maxHeight: 144,
+      overflow: "auto",
+      listStyle: "none",
+      fontFamily: "var(--font-mono, ui-monospace, monospace)",
+      fontSize: 12,
+      lineHeight: 1.6,
+      background: "var(--surface-2, rgba(127,127,127,0.08))",
+      borderRadius: 6
+    };
+
+    function DeleteSessionMenuItem(props) {
+      const { sessionId, displayTitle, useMenuOpenState, requestDelete, t } = props;
+      const [, setMenuOpen] = useMenuOpenState();
+      return jsx(primitives.MenuItemButton, {
+        icon: jsx(primitives.IconTrashOutlineRegular, { size: 14 }),
+        onSelect: () => {
+          setMenuOpen(false);
+          requestDelete(sessionId, displayTitle);
+        },
+        children: t("menu.deleteSession")
+      });
+    }
+
+    function DeleteSessionConfirmDialog(props) {
+      const { useDeleteRequest, settleSessionDelete, confirmSessionDelete, t } = props;
+      const request = useDeleteRequest((pending) => pending);
+      if (request === null) return null;
+      return jsx(DeleteConfirmForm, {
+        request,
+        confirmSessionDelete,
+        onSettle: settleSessionDelete,
+        t
+      });
+    }
+
+    function DeleteConfirmForm({ request, confirmSessionDelete, onSettle, t }) {
+      const [plan, setPlan] = react.useState(null);
+      const [scanFailed, setScanFailed] = react.useState(false);
+      const [clean, setClean] = react.useState(true);
+      const [deleting, setDeleting] = react.useState(false);
+      const [error, setError] = react.useState(null);
+
+      react.useEffect(() => {
+        let alive = true;
+        postJson(INSPECT_URL, { sessionId: request.sessionId })
+          .then((payload) => {
+            if (alive) setPlan(payload);
+          })
+          .catch(() => {
+            if (alive) setScanFailed(true);
+          });
+        return () => {
+          alive = false;
+        };
+      }, [request.sessionId]);
+
+      const close = () => {
+        if (deleting) return;
+        onSettle();
+      };
+
+      const confirm = () => {
+        setDeleting(true);
+        setError(null);
+        confirmSessionDelete(request.sessionId, clean)
+          .then(() => {
+            setDeleting(false);
+            onSettle();
+          })
+          .catch((reason) => {
+            setDeleting(false);
+            setError(reason instanceof Error ? reason.message : String(reason));
+          });
+      };
+
+      const residue = plan?.residue ?? [];
+      const kept = plan?.keep?.length ?? 0;
+      const scanning = plan === null && !scanFailed;
+
+      return jsxs(primitives.Modal, {
+        open: true,
+        onClose: close,
+        closeLabel: t("close"),
+        title: t("delete.confirm.title"),
+        description: t("delete.confirm.desc"),
+        footer: jsxs(Fragment, {
+          children: [
+            jsx(primitives.Button, {
+              variant: "outline",
+              disabled: deleting,
+              onClick: close,
+              children: t("cancel")
+            }),
+            jsx(primitives.Button, {
+              variant: "primary",
+              disabled: deleting,
+              onClick: confirm,
+              children: deleting ? t("delete.confirm.pending") : t("delete.confirm.action")
+            })
+          ]
+        }),
+        children: [
+          scanning ? jsx("div", { role: "status", children: t("delete.scanning") }) : null,
+          scanFailed ? jsx("div", { children: t("delete.scanFailed") }) : null,
+          plan !== null && residue.length > 0
+            ? jsxs(Fragment, {
+                children: [
+                  jsx("label", {
+                    style: { display: "flex", gap: 8, alignItems: "center", marginTop: 4 },
+                    children: [
+                      jsx("input", {
+                        type: "checkbox",
+                        checked: clean,
+                        disabled: deleting,
+                        onChange: (event) => setClean(event.target.checked)
+                      }),
+                      jsx("span", { children: t("delete.cleanup.label", { count: residue.length }) })
+                    ]
+                  }),
+                  jsx("ul", {
+                    style: listStyle,
+                    children: residue.map((entry) =>
+                      jsx("li", { children: entry.path }, entry.path)
+                    )
+                  })
+                ]
+              })
+            : null,
+          plan !== null && residue.length === 0
+            ? jsx("div", { style: { marginTop: 4 }, children: t("delete.cleanup.none") })
+            : null,
+          plan !== null && kept > 0
+            ? jsx("div", {
+                style: { marginTop: 6, opacity: 0.75 },
+                children: t("delete.keep.label", { count: kept })
+              })
+            : null,
+          error !== null ? jsx("div", { role: "alert", children: error }) : null
+        ]
+      });
+    }
+
+    async function postJson(path, body) {
+      const response = await fetch(path, {
+        method: "POST",
+        headers: { "content-type": "application/json" },
+        credentials: "same-origin",
+        cache: "no-store",
+        body: JSON.stringify(body)
+      });
+      let payload = null;
+      try {
+        payload = await response.json();
+      } catch {}
+      if (!response.ok || payload?.ok === false) {
+        throw new Error(payload?.error || `HTTP ${response.status}`);
+      }
+      return payload;
+    }
+
+    function apply(ctx) {
+      const sessions = ctx.get("sessions", false);
+      const deleteRequest = createSnapshotStore(null);
+
+      const deleteMenuItemInjected = () => ({
+        requestDelete: (sessionId, displayTitle) => {
+          deleteRequest.set({ sessionId, displayTitle });
+        }
+      });
+
+      const deleteDialogInjected = () => ({
+        hooks: { deleteRequest },
+        settleSessionDelete: () => {
+          deleteRequest.set(null);
+        },
+        confirmSessionDelete: async (sessionId, clean) => {
+          const payload = await postJson(DELETE_URL, { sessionId, clean });
+          try {
+            sessions?.handleSessionRemoved?.(sessionId);
+          } catch {}
+          return payload;
+        }
+      });
+
+      ctx.effect(() => ctx.locale.register(NS, { zh, en }), "dsh-session-delete: dictionaries");
+
+      ctx.slots.inject("sidebar.workspaces.session.menu.item", function* () {
+        yield ctx.slots.register(
+          {
+            name: "sidebar.workspaces.session.menu.item",
+            id: "session-delete",
+            order: 410,
+            locale: NS,
+            inject: deleteMenuItemInjected
+          },
+          DeleteSessionMenuItem
+        );
+      });
+
+      ctx.slots.inject("shell.overlay", function* () {
+        yield ctx.slots.register(
+          {
+            name: "shell.overlay",
+            id: "session-delete",
+            locale: NS,
+            inject: deleteDialogInjected
+          },
+          DeleteSessionConfirmDialog
+        );
+      });
+    }
+
+    exports.name = name;
+    exports.inject = inject;
+    exports.apply = apply;
+    return module.exports;
+  }
+});

package/cordis.patch.yml

@@ -0,0 +1,3 @@
+- insert:
+    - id: dsh-session-delete
+      name: '@l1vide/dsh-session-delete'

package/icon.svg

@@ -0,0 +1,6 @@
+<svg xmlns="http://www.w3.org/2000/svg" width="24" height="24" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1.8" stroke-linecap="round" stroke-linejoin="round">
+  <path d="M4 7h16" />
+  <path d="M10 4h4a1 1 0 0 1 1 1v2H9V5a1 1 0 0 1 1-1z" />
+  <path d="M6 7l1 12a2 2 0 0 0 2 2h6a2 2 0 0 0 2-2l1-12" />
+  <path d="M10 11v6M14 11v6" />
+</svg>