dsh-cursor-dev 0.11.0 → 0.12.0

package/README.md

@@ -55,9 +55,9 @@ flowchart LR
 3. 按 DSH 提示完成加载；涉及后台代码更新时重启 DSH，然后刷新页面。在 Cursor 面板中选择模型并保存。
 4. 明确告诉父模型使用 `cursor_code`，或者用下面的斜杠命令派发第一个任务。
 
-**版本说明（2026-10-17 核对）：** `0.11.0` 已推送到公开仓库的 `main`，适配 DSH `0.2.1-rc.2`：插件改用新的外部子智能体契约（`startActivation`、必须返回未被占用的子会话 id、External 行由宿主写入），在包顶层声明 `engines.dsh: ^0.2.0-rc.1`，并清理了 DSH 0.2.1 已删除的工具配置项。插件市场（dshmarket）已收录本插件（目录条目合并于 2026-10-17），可以直接在市场里找到并安装；`0.11.0` 也已发布到 npm 公共源（包名 `dsh-cursor-dev`），按包名安装不再返回 404，目录下一次探测后市场卡片会显示版本和 `DSH ^0.2.0-rc.1` 宿主要求。要跟进后续改动请用 Git 来源；`.tgz` 是某一刻的固定快照。详见[安装来源与版本](docs/INSTALL.md#2-选择安装来源)。
+**版本说明（2026-10-18 核对）：** `0.12.0` 已推送到公开仓库的 `main`，沿用 `0.11.1` 的 DSH `0.2.1-rc.2` 契约（外部子智能体契约、顶层 `engines.dsh: >=0.2.1-rc.2 <0.3.0-0`），并重做了面板的历史会话卡：列表收进限高滚动框、点标题即可整段折叠（选择记在浏览器本地），每行新增两段式**删除**，经新增的 `api/forget` 路由一并清掉索引记录、轨迹和镜像子会话。插件市场（dshmarket）已收录本插件（目录条目合并于 2026-10-17），可以直接在市场里找到并安装；npm 公共源上当前可安装的版本仍是 `0.11.1`（`0.12.0` 尚未发布，要这版删除/折叠功能请用 Git 来源）。要跟进后续改动请用 Git 来源；`.tgz` 是某一刻的固定快照。详见[安装来源与版本](docs/INSTALL.md#2-选择安装来源)。
 
-运行要求：DSH 包声明 `^0.2.0-rc.1`（已在 `0.2.1-rc.2` 上验证）；Node.js `^22.19.0 || >=24.0.0`；已登录且可访问服务的 Cursor CLI。原生子智能体功能需要 DSH 的 `subagents`、`agents` 服务，后台任务还需要对应任务服务，建议使用当前 DSH 桌面版。CLI 安装方法见 [Cursor 官方文档](https://cursor.com/docs/cli)。
+运行要求：DSH `>=0.2.1-rc.2 <0.3.0-0`（已在 `0.2.1-rc.2` 上验证）；Node.js `^22.19.0 || >=24.0.0`；已登录且可访问服务的 Cursor CLI。原生子智能体功能需要 DSH 的 `subagents`、`agents` 服务，后台任务还需要对应任务服务，建议使用当前 DSH 桌面版。CLI 安装方法见 [Cursor 官方文档](https://cursor.com/docs/cli)。
 
 ### 三个入口
 
@@ -152,7 +152,7 @@ flowchart LR
 
 从 DSH 的 Cursor 插件入口打开面板，也可以访问当前 DSH 地址下的 `/plugins/dsh-cursor-dev/`。例如，DSH 运行在 `http://127.0.0.1:19387` 时，面板地址为 `http://127.0.0.1:19387/plugins/dsh-cursor-dev/`；其他用户应使用自己的地址和端口。
 
-面板包含安装/登录状态、账号额度、模型和模式设置、活动与历史会话。点击会话可查看镜像记录。新版本页面可能与上面的截图不同。
+面板包含安装/登录状态、账号额度、模型和模式设置、活动与历史会话。点击会话可查看镜像记录。历史会话会一直累积，所以列表默认收在一个限高的滚动框里，点标题即可整段折叠（选择会被记住）；每行右侧的 **删除** 会清掉这次运行的全部痕迹——索引记录、轨迹和镜像子会话，和 `resetSession` 走同一条链路。删除要连点两次（第一次只是变成「确认删除」），因为删掉之后无法恢复。新版本页面可能与上面的截图不同。
 
 | 插件配置 | 默认值 | 用途 |
 | --- | --- | --- |
@@ -194,7 +194,7 @@ npm install
 node --test --test-force-exit --test-skip-pattern="the child agent really edits a file|a bad model is rejected|the real Cursor account returns live quota data" "test/**/*.test.mjs"
 ```
 
-完整测试命令为 `npm test`，共 213 项；上面那条命令跳过其中三个真实 CLI/账号测试，剩下 210 项离线测试必须全绿。真实测试需要 Cursor 登录和网络，执行任务会使用该账号额度。当前实现已通过 210 项离线测试，并完成两轮真实 Auto 调用、文件修改和上下文续接验证。打包使用 `npm pack` 或 `pnpm pack`，发布前按[分发检查](docs/INSTALL.md#7-维护者分发前检查)核对安装包和版本。
+完整测试命令为 `npm test`，共 216 项；上面那条命令跳过其中三个真实 CLI/账号测试，剩下 213 项离线测试必须全绿。真实测试需要 Cursor 登录和网络，执行任务会使用该账号额度。当前实现已通过 213 项离线测试，并完成两轮真实 Auto 调用、文件修改和上下文续接验证。打包使用 `npm pack` 或 `pnpm pack`，发布前按[分发检查](docs/INSTALL.md#7-维护者分发前检查)核对安装包和版本。
 
 ## English
 
@@ -217,12 +217,12 @@ See the [installation guide](docs/INSTALL.md) for detailed setup and troubleshoo
    dsh plugin add dsh-cursor-dev
    ```
 
-3. Restart DSH when backend changes require it, then refresh the page. Open the Cursor panel under `/plugins/dsh-cursor-dev/`, select a model and save it.
+3. Restart DSH when backend changes require it, then refresh the page. Open the Cursor panel under `/plugins/dsh-cursor-dev/`, select a model and save it. The history list keeps one row per run forever, so it sits in a height-capped scroll box and folds away when you click its heading (the choice is remembered); a row's **Delete** link clears that run's index record, journal and mirrored child — the same chain `resetSession` uses — and arms on the first click so the irreversible second click is deliberate.
 4. Ask the parent to use `cursor_code`, or send `/cursor-subagent` followed by a complete task. The command dispatches directly and hands a completion or failure summary back to the original parent.
 
-As checked on **2026-10-17**, version `0.11.0` is pushed to `main` on the public repository and adapts the plugin to DSH `0.2.1-rc.2`: it follows the new external-subagent contract (`startActivation`, a child id the host has not registered yet, and the `External` catalog row written by the host), declares `engines.dsh: ^0.2.0-rc.1` at the package top level, and drops the tool-config keys that DSH 0.2.1 removed. The dsh-market catalog already lists this plugin (entry merged 2026-10-17), so it can be installed from the market; version `0.11.0` is also published to the public npm registry as `dsh-cursor-dev`, so a bare package-name installation works and the market card shows the version and the `DSH ^0.2.0-rc.1` host requirement after the catalog's next probe. Use the Git source to follow later changes; a `.tgz` is a fixed snapshot.
+As checked on **2026-10-18**, version `0.12.0` is pushed to `main` on the public repository and keeps the DSH `0.2.1-rc.2` contract from `0.11.1` (the external-subagent contract and `engines.dsh: >=0.2.1-rc.2 <0.3.0-0` at the package top level), and reworks the panel's history card: the list sits in a height-capped scroll box, folds away from its heading (remembered per browser), and each row gains a two-click **Delete** that clears the index record, journal and mirrored child through a new `api/forget` route. The dsh-market catalog already lists this plugin (entry merged 2026-10-17), so it can be installed from the market; `0.11.1` is the version currently on the public npm registry as `dsh-cursor-dev` (`0.12.0` is not published yet, so use the Git source for the fold/delete work). Use the Git source to follow later changes; a `.tgz` is a fixed snapshot.
 
-Requirements: DSH metadata declares `^0.2.0-rc.1` (verified against `0.2.1-rc.2`); Node.js `^22.19.0 || >=24.0.0`; an authenticated Cursor CLI account with service access. Native dispatch additionally needs DSH's `subagents` and `agents` services, and background runs need the host's job services. A current DSH desktop installation is recommended.
+Requirements: DSH `>=0.2.1-rc.2 <0.3.0-0` (verified against `0.2.1-rc.2`); Node.js `^22.19.0 || >=24.0.0`; an authenticated Cursor CLI account with service access. Native dispatch additionally needs DSH's `subagents` and `agents` services, and background runs need the host's job services. A current DSH desktop installation is recommended.
 
 ### Parent-to-child contract
 

package/docs/INSTALL.md

@@ -11,7 +11,7 @@
 - 可正常对话的 DSH，以及一个支持工具调用的父模型。
 - 插件使用的 Node.js 满足 `^22.19.0 || >=24.0.0`。桌面版应检查其自带运行时，终端里的 `node --version` 不一定是桌面程序使用的版本。
 - 当前版 Cursor CLI，已完成登录，并有执行任务所需的账号权限、额度和网络连接。
-- 原生子智能体入口需要 DSH 的 `subagents`、`agents` 服务；后台运行还需要宿主任务服务。包声明的 DSH 版本为 `^0.2.0-rc.1`（已在 `0.2.1-rc.2` 上验证），建议使用当前桌面版及其标准 profile。
+- 原生子智能体入口需要 DSH 的 `subagents`、`agents` 服务；后台运行还需要宿主任务服务。包声明的 DSH 版本为 `>=0.2.1-rc.2 <0.3.0-0`（已在 `0.2.1-rc.2` 上验证），建议使用当前桌面版及其标准 profile。
 
 父模型的 API 配置与 Cursor 登录分别管理。插件使用本机 CLI 的登录状态，无需再向插件填写一份 Cursor API Key。
 
@@ -38,15 +38,15 @@ agent status --format json
 
 ## 2. 选择安装来源
 
-**发布状态（2026-10-17 核对）：** 公共 GitHub 仓库存在，`0.11.0` 已推送到 `main`（适配 DSH `0.2.1-rc.2` 的外部子智能体契约、顶层 `engines.dsh`、面板模型锁定、父级专属的 `maxChildDepth` 递归限制，以及本指南都在其中）。插件市场（dshmarket）的目录条目已于 2026-10-17 合并，可以直接在市场里找到本插件；`0.11.0` 也已发布到 npm 公共源（包名 `dsh-cursor-dev`），按包名安装不再返回 404，目录下一次探测后市场会显示版本和 `DSH ^0.2.0-rc.1` 宿主要求。
+**发布状态（2026-10-18 核对）：** 公共 GitHub 仓库存在，`0.12.0` 已推送到 `main`（沿用 `0.11.1` 的 DSH `0.2.1-rc.2` 外部子智能体契约与顶层 `engines.dsh: >=0.2.1-rc.2 <0.3.0-0`，并重做历史会话卡：限高滚动、可折叠、每行可删除）。插件市场（dshmarket）的目录条目已于 2026-10-17 合并，可以直接在市场里找到本插件；npm 公共源上当前为 `0.11.1`，`0.12.0` 尚未发布——要用折叠与删除功能请装 Git 来源，市场卡片的版本号要等发布后才会更新。
 
 | 你要安装的内容 | 安装来源 |
 | --- | --- |
 | 插件市场里的本插件 | 市场条目解析为 `github:Dclef/dsh-cursor-dev`，安装后会跟随仓库默认分支 |
-| npm 公共源上的已发布版本 | `dsh-cursor-dev`（`0.11.0` 起可用，按包内 `files` 白名单安装） |
+| npm 公共源上的已发布版本 | `dsh-cursor-dev`（`0.11.0` 起可用，按包内 `files` 白名单安装，当前为 `0.11.1`；`0.12.0` 尚未发布） |
 | 公开仓库的当前版本（推荐） | `git+https://github.com/Dclef/dsh-cursor-dev.git` |
 | 你本地的源码目录 | 该目录的绝对路径，例如 `D:/plugins/dsh-cursor-dev` |
-| 维护者提供的源码快照或发布包 | `.tgz` 文件的绝对路径，例如 `D:/Downloads/dsh-cursor-dev-0.11.0.tgz` |
+| 维护者提供的源码快照或发布包 | `.tgz` 文件的绝对路径，例如 `D:/Downloads/dsh-cursor-dev-0.12.0.tgz` |
 
 表中本地路径是示例，需要换成实际位置。npm 来源取 registry 上发布的最新版本；Git 来源会取得仓库默认分支的最新提交；`.tgz` 是某一刻的固定快照——要跟进后续改动就用 Git 来源。
 
@@ -88,7 +88,7 @@ dsh plugin add "/home/you/plugins/dsh-cursor-dev"
 安装收到的包：
 
 ```powershell
-dsh plugin add "D:/Downloads/dsh-cursor-dev-0.11.0.tgz"
+dsh plugin add "D:/Downloads/dsh-cursor-dev-0.12.0.tgz"
 ```
 
 终端没有 `dsh` 命令时，使用桌面插件管理即可。不要把在任意项目目录执行 `npm install` 当成已经在 DSH 当前 profile 中启用插件。
@@ -113,6 +113,12 @@ http://127.0.0.1:19387/plugins/dsh-cursor-dev/
 
 `auto` 与 `default[]` 都表示 Auto。面板保存的选择与当前已启动任务的模型不是同一项状态；新选择在后续运行时应用。锁定只决定选用哪个模型，不增加账号额度或模型访问权限。
 
+### 历史会话列表太长或想删掉某一次运行
+
+历史会话按「父会话 + 标签」累积，每一次运行留一行，时间久了列表会很长。所以面板把它收在一个限高的滚动框里，点标题即可整段折叠，折叠状态记在浏览器本地，刷新后仍然保持。
+
+每行最右侧是 **删除**：第一次点击只会变成 **确认删除**，再点一次才真正执行。它会清掉这次运行的索引记录、轨迹和镜像子会话，与工具参数 `resetSession` 走同一条链路，所以删掉之后无法恢复，也无法再从这个面板续聊那次运行。Cursor 自己保存的原始会话不受影响；需要它时可从 Cursor 侧查看。
+
 ### 模型列表不全时先看代理
 
 同一张卡片上有 **代理** 输入框，留空即为自动探测，正常情况不需要填。它决定的是**插件启动的 CLI 子进程**走哪条网络出口。
@@ -189,7 +195,7 @@ continueSession 设为 true。让 Cursor 说明上一轮做了什么，再核对
 
 | 现象 | 检查与处理 |
 | --- | --- |
-| 按包名安装返回 404 | `0.11.0` 起已发布到 npm 公共源；仍 404 时确认 registry 指向公共源且包名拼写为 `dsh-cursor-dev`，或改用插件市场、上面的 Git 来源、已取得的源码目录或安装包 |
+| 按包名安装返回 404 | `0.11.0` 起已发布到 npm 公共源（当前 `0.11.1`）；仍 404 时确认 registry 指向公共源且包名拼写为 `dsh-cursor-dev`，或改用插件市场、上面的 Git 来源、已取得的源码目录或安装包 |
 | DSH 报告找不到 Cursor CLI | 检查 `agent status --format json`；确认 CLI 位于 DSH 可见的 PATH 或常见安装目录，然后重启 DSH。仍找不到时，在插件配置里设置 `command` 为可启动二进制、安装根目录、`agent.cmd`，或 `"node.exe" "index.js"`（非空时只走该路径） |
 | 未登录或账号不可用 | 在运行 DSH 的同一操作系统用户下执行 `agent login`，检查账号和网络状态 |
 | 面板选了 Auto，实际仍是其他模型 | 当前任务不会中途切换；新版请保存“锁定面板模型”。查看返回的 `modelSource` 与 `requestedModel`，确认是否有显式调用参数 |

package/lib/journal.js

@@ -88,6 +88,29 @@ export class RunJournal {
         this.#entries.delete(key);
     }
 
+    /**
+     * Drop every generation's journal for one conversation.
+     *
+     * `clear` is exact-keyed, which is right for a live run but useless for a
+     * conversation being forgotten: its buckets are keyed `parent::label#2` and
+     * the caller only knows `parent::label`. Sweeping the prefix is what makes
+     * "delete this history row" actually delete the timeline behind it.
+     *
+     * @param conversationKey - `parent::label`.
+     * @returns how many buckets were dropped.
+     */
+    clearConversation(conversationKey) {
+        const prefix = `${conversationKey}#`;
+        let dropped = 0;
+        for (const key of [...this.#entries.keys()]) {
+            if (key === conversationKey || key.startsWith(prefix)) {
+                this.#entries.delete(key);
+                dropped += 1;
+            }
+        }
+        return dropped;
+    }
+
     /**
      * Read the newest journal belonging to one conversation.
      *

package/lib/usage.js

@@ -533,6 +533,90 @@ export function registerUsageRoutes(ctx, deps) {
         },
     };
 
+    /**
+     * Forget one conversation: every trace of it, not just the row.
+     *
+     * The dashboard's delete button, and it deliberately does exactly what
+     * `cursor_code`'s `resetSession` does — kill the live generations, drop the
+     * journals, remove the durable index row and close the mirrored child —
+     * because a row that vanished from the table while any of those survived
+     * would come back on the next run and confuse the operator twice.
+     *
+     * Forgetting something already gone answers `ok` with zero counts: the
+     * button's promise is "make it invisible", and a second click on a stale row
+     * must not produce a scary 404.
+     */
+    const forgetRoute = {
+        kind: 'exact',
+        path: '/plugins/dsh-cursor-dev/api/forget',
+        handler: async (req, res) => {
+            const method = String(req?.method ?? 'GET').toUpperCase();
+            if (method !== 'POST') {
+                sendJson(res, 405, { ok: false, error: `method ${method} is not supported` });
+                return;
+            }
+            const url = new URL(req?.url ?? '/', 'http://localhost');
+            const key = url.searchParams.get('key');
+            if (key === null || key === '') {
+                sendJson(res, 400, { ok: false, error: 'a conversation key is required' });
+                return;
+            }
+            // Same two key spaces as the restore route: a live row arrives
+            // generation-scoped (`a::default#1`), the rest of the host knows the
+            // bare conversation (`a::default`).
+            const durableKey = conversationKeyOf(key);
+            const entry = index?.get?.(key) ?? index?.get?.(durableKey);
+            const live = pool.snapshot().filter(row => conversationKeyOf(row.key) === durableKey);
+            // The pool goes first: a disposed session cannot append to the
+            // journal or rewrite the index behind the deletions that follow.
+            try {
+                pool.dropConversation?.(durableKey);
+            }
+            catch (error) {
+                ctx.logger?.warn?.(`dsh-cursor-dev: conversation ${durableKey} was not evicted: ${errorText(error)}`);
+            }
+            let journals = 0;
+            try {
+                if (typeof journal?.clearConversation === 'function')
+                    journals = journal.clearConversation(durableKey);
+                else
+                    journal?.clear?.(durableKey);
+            }
+            catch (error) {
+                ctx.logger?.warn?.(`dsh-cursor-dev: journal for ${durableKey} was not cleared: ${errorText(error)}`);
+            }
+            let indexes = 0;
+            for (const each of new Set([durableKey, key])) {
+                if (index?.get?.(each) === undefined)
+                    continue;
+                try {
+                    await index.delete(each);
+                    indexes += 1;
+                }
+                catch (error) {
+                    ctx.logger?.warn?.(`dsh-cursor-dev: index row ${each} was not removed: ${errorText(error)}`);
+                }
+            }
+            let mirrorsDropped = 0;
+            if (typeof mirrors?.dropConversation === 'function') {
+                try {
+                    await mirrors.dropConversation(durableKey);
+                    mirrorsDropped = 1;
+                }
+                catch (error) {
+                    ctx.logger?.warn?.(`dsh-cursor-dev: mirror for ${durableKey} was not closed: ${errorText(error)}`);
+                }
+            }
+            sendJson(res, 200, {
+                ok: true,
+                key,
+                conversationKey: durableKey,
+                existed: entry !== undefined || live.length > 0,
+                dropped: { live: live.length, journals, index: indexes, mirrors: mirrorsDropped },
+            });
+        },
+    };
+
     const dashboardRoute = {
         kind: 'exact',
         path: '/plugins/dsh-cursor-dev/',
@@ -587,7 +671,7 @@ export function registerUsageRoutes(ctx, deps) {
         }
     };
 
-    for (const route of [jsonRoute, journalRoute, restoreRoute, dashboardRoute]) {
+    for (const route of [jsonRoute, journalRoute, restoreRoute, forgetRoute, dashboardRoute]) {
         try {
             registrations.push(server.register({
                 ...route,
@@ -665,6 +749,7 @@ function dashboardHtml(state) {
         endpoint: '/plugins/dsh-cursor-dev/api/usage',
         journalEndpoint: '/plugins/dsh-cursor-dev/api/journal',
         restoreEndpoint: '/plugins/dsh-cursor-dev/api/restore',
+        forgetEndpoint: '/plugins/dsh-cursor-dev/api/forget',
         settingsEndpoint: '/plugins/dsh-cursor-dev/api/settings',
         statusEndpoint: '/plugins/dsh-cursor-dev/status',
         settings: {
@@ -738,6 +823,25 @@ function dashboardHtml(state) {
      grows a page-wide scrollbar and the cards drift off-screen. The scroll
      belongs to this wrapper, never to the page. */
   .tablewrap { overflow-x: auto; padding-bottom: 2px; }
+  /* The history table is unbounded (one row per run ever made), so it scrolls
+     inside a box of its own instead of stretching the card. The inner .tablewrap
+     still owns the horizontal scroll; this box owns the vertical one. */
+  #convos-body { max-height: 300px; overflow-y: auto; }
+  /* A 300px window over a table with one row per run is useless if the column
+     labels scroll away with the first row, so the header stays put. */
+  #convos-body thead th { position: sticky; top: 0; background: var(--card); z-index: 1; }
+  /* A section heading that doubles as the collapse control. */
+  h2 > .disclose { color: inherit; text-decoration: none; }
+  h2 > .disclose::before { content: '▾ '; color: var(--muted); }
+  h2.collapsed > .disclose::before { content: '▸ '; }
+  h2 > .disclose:hover { color: var(--accent); }
+  h2 > .pill { margin-left: 8px; }
+  td.act { white-space: nowrap; }
+  /* One row is one run: model names and timestamps must not wrap into a second
+     line, or a 300px window shows four rows instead of eight. The long key and
+     path columns already clip themselves. */
+  #convos td { white-space: nowrap; }
+  a.link.danger { color: var(--bad); }
   table { width: 100%; border-collapse: collapse; }
   th, td { text-align: left; padding: 6px 8px; border-bottom: 1px solid var(--line); }
   th { color: var(--muted); font-weight: 500; white-space: nowrap; }
@@ -758,6 +862,9 @@ function dashboardHtml(state) {
   .err { border-color: var(--bad); }
   .journal { margin-top: 12px; border-top: 1px solid var(--line); padding-top: 10px; }
   .journal h3 { font-size: 12px; margin: 0 0 8px; font-weight: 600; }
+  .journal.warn { border-top-color: var(--warn); color: var(--warn); }
+  .journal.bad { border-top-color: var(--bad); color: var(--bad); }
+  .journal.ok { border-top-color: var(--good); color: var(--good); }
   .journal pre { white-space: pre-wrap; word-break: break-word; margin: 6px 0 0;
     background: var(--bg); border: 1px solid var(--line); border-radius: 6px; padding: 8px;
     max-height: 260px; overflow: auto; font-size: 12px; }
@@ -936,11 +1043,17 @@ function dashboardHtml(state) {
 </div>
 
 <div class="row card">
-  <h2 data-t="conversations">历史会话（可恢复，重装后仍在）</h2>
+  <h2><a href="#" class="disclose" id="convos-toggle" data-t="conversations">历史会话（可恢复，重装后仍在）</a><span class="pill" id="convos-count">0</span></h2>
   <div class="muted" data-t="conversationsHint"></div>
-  <div class="tablewrap"><table><thead><tr>
-    <th data-t="colKey">会话键</th><th data-t="colSession">会话号</th><th data-t="colWorkspace">工作目录</th><th data-t="colModel">模型</th><th class="num" data-t="colUpdated">更新时间</th>
-  </tr></thead><tbody id="convos"></tbody></table></div>
+  <!-- The history table grows one row per run the operator has ever made, so it
+       gets its own bounded scroll box and can be dropped entirely: on a busy
+       machine this card alone used to push everything else off the page. -->
+  <div id="convos-body">
+    <div class="tablewrap"><table><thead><tr>
+      <th data-t="colKey">会话键</th><th data-t="colSession">会话号</th><th data-t="colWorkspace">工作目录</th><th data-t="colModel">模型</th><th class="num" data-t="colUpdated">更新时间</th><th class="num" data-t="colActions">操作</th>
+    </tr></thead><tbody id="convos"></tbody></table></div>
+  </div>
+  <div class="journal" id="convos-notice" style="display:none"></div>
 </div>
 
 <div class="note" id="source"></div>
@@ -950,6 +1063,8 @@ function dashboardHtml(state) {
 (function () {
   var boot = JSON.parse(document.getElementById('bootstrap').textContent);
   var STORE_KEY = 'dsh-cursor-dev:lang';
+  /** Where the "history table folded" choice is remembered. */
+  var FOLD_KEY = 'dsh-cursor-dev:convos-folded';
 
   var T = {
     zh: {
@@ -999,6 +1114,16 @@ function dashboardHtml(state) {
       live: '运行中的 Cursor 会话',
       conversations: '历史会话（可恢复，重装后仍在）',
       conversationsHint: '点击会话键打开这次运行：有子智能体对话时直接跳过去；旧对话（这个功能上线前跑的）会当场从 Cursor 里读回来建成子会话；读不到才退回去展开轨迹。',
+      colActions: '操作',
+      forget: '删除',
+      forgetArmed: '确认删除',
+      forgetHint: '删除这条历史会话（会话记录、轨迹、镜像一起清掉）',
+      forgetting: '正在删除这条历史会话…',
+      forgetConfirm: '删除这条历史会话？它的会话记录、轨迹和镜像都会一起清掉，无法恢复。再点一次「确认删除」就执行。',
+      forgetFailed: '删除失败：',
+      forgotten: '已删除：',
+      expandHint: '展开或收起历史会话列表',
+      countRows: '条',
       openChildHint: '打开这次运行的子智能体对话',
       openJournalHint: '展开这次运行的轨迹',
       restoreHint: '把这次运行的旧对话读回来，建成一个能点开的子智能体会话',
@@ -1105,6 +1230,16 @@ function dashboardHtml(state) {
       live: 'Live Cursor sessions',
       conversations: 'Known conversations (durable)',
       conversationsHint: 'Click a key to open the run: its child conversation when there is one; an older run (made before this feature) is read back out of Cursor and published as one; only if that fails does the step timeline open instead.',
+      colActions: 'actions',
+      forget: 'Delete',
+      forgetArmed: 'Confirm delete',
+      forgetHint: 'Delete this history row (its index record, journal and mirror go too)',
+      forgetting: 'Deleting this history row…',
+      forgetConfirm: 'Delete this history row? Its index record, journal and mirror go with it, and it cannot be undone. Click Confirm delete to go ahead.',
+      forgetFailed: 'Delete failed: ',
+      forgotten: 'Deleted: ',
+      expandHint: 'Fold or unfold the history list',
+      countRows: 'rows',
       openChildHint: 'Open the child conversation for this run',
       openJournalHint: 'Unfold this run’s step timeline',
       restoreHint: 'Read this run’s old conversation back and publish it as an openable child conversation',
@@ -1639,7 +1774,8 @@ function dashboardHtml(state) {
     if (spec.cls) td.className = spec.cls;
     if (spec.link) {
       var a = document.createElement('a');
-      a.className = 'link' + (spec.on && spec.on(entry) ? ' on' : '');
+      a.className = 'link' + (spec.on && spec.on(entry) ? ' on' : '')
+        + (spec.danger ? ' danger' : '');
       a.href = '#';
       a.textContent = spec.value(entry);
       var hint = spec.title ? spec.title(entry) : '';
@@ -1782,6 +1918,97 @@ function dashboardHtml(state) {
     renderLive(lastPayload || {});
   }
 
+  /**
+   * One history row's delete control.
+   *
+   * Destroying a row is irreversible here (the index, the journal and the
+   * mirrored child all go), so the first click only arms the link and the second
+   * one within the same row does the work. Armed state lives in a module-level
+   * variable rather than in the DOM because the table is re-rendered by the
+   * poll: a pending confirmation must survive a re-render of its own row.
+   */
+  function forgetRow(entry) {
+    var key = entry.key;
+    if (armedFor !== key) {
+      armedFor = key;
+      forgetNotice(t('forgetConfirm'), 'warn');
+      renderLive(lastPayload || {});
+      return;
+    }
+    armedFor = '';
+    forgetNotice(t('forgetting'), '');
+    fetch(boot.forgetEndpoint + '?key=' + encodeURIComponent(key), {
+      method: 'POST',
+      headers: { accept: 'application/json' },
+    })
+      .then(function (response) {
+        return response.json().then(function (body) { return { ok: response.ok, body: body }; });
+      })
+      .then(function (answer) {
+        var body = answer.body || {};
+        if (answer.ok === true && body.ok === true) {
+          if (journalKey === key) {
+            journalKey = '';
+            var panel = $('journal');
+            panel.style.display = 'none';
+            panel.textContent = '';
+          }
+          // The row is gone on disk, so drop it from the payload that is about
+          // to be re-painted instead of waiting for the next poll to notice.
+          var extended = lastPayload && lastPayload.extended;
+          if (extended && Array.isArray(extended.conversations)) {
+            extended.conversations = extended.conversations.filter(function (row) { return row.key !== key; });
+          }
+          forgetNotice(t('forgotten') + shortKey(key), 'ok');
+          renderLive(lastPayload || {});
+          return;
+        }
+        forgetNotice(t('forgetFailed') + (body.error || 'unknown error'), 'bad');
+        renderLive(lastPayload || {});
+      })
+      .catch(function (error) {
+        forgetNotice(t('forgetFailed') + (error && error.message ? error.message : String(error)), 'bad');
+        renderLive(lastPayload || {});
+      });
+  }
+
+  /** One line of feedback under the history table (never the journal panel). */
+  function forgetNotice(message, tone) {
+    var host = $('convos-notice');
+    if (!host) return;
+    host.style.display = message === '' ? 'none' : '';
+    host.className = 'journal' + (tone ? ' ' + tone : '');
+    host.textContent = message;
+  }
+
+  /**
+   * Fold or unfold the history table.
+   *
+   * The card is the longest thing on the page on a busy machine, and the fold
+   * state is remembered per browser so a panel that fits the operator's screen
+   * stays that way across reloads and language switches.
+   */
+  function setFolded(folded) {
+    convosFolded = folded === true;
+    try { window.localStorage.setItem(FOLD_KEY, convosFolded ? '1' : '0'); } catch (e) { /* private mode */ }
+    applyFolded();
+  }
+  function applyFolded() {
+    var body = $('convos-body');
+    if (body) body.style.display = convosFolded ? 'none' : '';
+    var title = $('convos-toggle');
+    if (title && title.parentNode && title.parentNode.classList) {
+      title.parentNode.classList[convosFolded ? 'add' : 'remove']('collapsed');
+    }
+    if (title) title.title = t('expandHint');
+  }
+  /** The row count pill next to the heading. */
+  function renderCount(count) {
+    var pill = $('convos-count');
+    if (!pill) return;
+    pill.textContent = String(count) + ' ' + t('countRows');
+  }
+
   /**
    * The key cell: the conversation when there is one, else the step timeline.
    *
@@ -1899,6 +2126,11 @@ function dashboardHtml(state) {
 
   var lastPayload = {};
   var journalKey = '';
+  /** The row whose delete is armed; empty means nothing is pending. */
+  var armedFor = '';
+  /** Whether the history table is folded; remembered per browser. */
+  var convosFolded = false;
+  try { convosFolded = window.localStorage.getItem(FOLD_KEY) === '1'; } catch (e) { convosFolded = false; }
   /** Live text in the model search box; survives a re-render and a language switch. */
   var modelFilter = '';
   /** Which chip is active in the model browser; also survives a re-render. */
@@ -1944,8 +2176,13 @@ function dashboardHtml(state) {
       { value: function (e) { return e.workspaceRoot; }, cls: 'path',
         title: function (e) { return e.workspaceRoot; } },
       { value: function (e) { return e.model; } },
-      { value: function (e) { return when(e.updatedAt); }, num: true }
+      { value: function (e) { return when(e.updatedAt); }, num: true },
+      { value: function (e) { return armedFor === e.key ? t('forgetArmed') : t('forget'); },
+        cls: 'act', link: true, danger: true, onClick: forgetRow,
+        title: function () { return t('forgetHint'); } }
     ]);
+    renderCount(convos.length);
+    applyFolded();
   }
   function render(payload) {
     lastPayload = payload;
@@ -2133,6 +2370,15 @@ function dashboardHtml(state) {
     loadSettings(false);
     refreshAuth(true);
   });
+  // The heading is the fold control: the table is the one unbounded list on the
+  // page, and this is how a busy machine keeps it out of the way.
+  try {
+    $('convos-toggle').addEventListener('click', function (event) {
+      event.preventDefault();
+      setFolded(!convosFolded);
+    });
+  }
+  catch (error) { /* a stubbed DOM in the tests has no heading */ }
   $('model-save').addEventListener('click', function () {
     var value = $('model').value;
     var proxyBox = $('proxy');

package/package.json

@@ -1,8 +1,8 @@
 {
   "name": "dsh-cursor-dev",
   "displayName": "Cursor 子智能体",
-  "description": "把 Cursor CLI 当作子编码智能体来写业务代码：每次运行都在 DSH 里开一个真实的子会话（点开就是完整对话），可按任务选模型、会话在 DSH 重启后仍能续聊、返回逐步工具时间线与真实文件 diff，并自带额度/模型/会话面板。",
-  "version": "0.11.0",
+  "description": "把 Cursor CLI 当作子编码智能体来写业务代码：cursor_code 每次运行都在 DSH 里开一个真实的、可点开的子会话，cursor_subagent 则显示为宿主写入的 External 记录；可按任务选模型、会话在 DSH 重启后仍能续聊、返回逐步工具时间线与真实文件 diff，并自带额度/模型/会话面板。",
+  "version": "0.12.0",
   "license": "MIT",
   "type": "module",
   "main": "lib/index.js",
@@ -22,7 +22,7 @@
   ],
   "engines": {
     "node": "^22.19.0 || >=24.0.0",
-    "dsh": "^0.2.0-rc.1"
+    "dsh": ">=0.2.1-rc.2 <0.3.0-0"
   },
   "scripts": {
     "test": "node --test --test-force-exit \"test/**/*.test.mjs\""