@yolk_vat-y/dsh-project-memory 0.5.13 → 0.5.14

package/CHANGELOG.md

@@ -1,3 +1,129 @@
+## 0.5.14 (2026-10-02)
+
+`npm test` **540 → 561 项 / 28 → 30 个文件**；`npm run eval:injection` 逐项不变
+（命中 14 / 假阳性 0 / 漏召 0，P/R 1.00/1.00，7 次注入 857 字符）。
+
+### 修复：`/` 菜单里「工作流」三行点了没反应
+
+同一个病根：**UI 动作被写成了宿主命令**。那三行的实现是
+`remote.commands.execute(sessionId, '/tasks insight list project')` —— 命令在宿主侧确实执行了，
+但客户端渲染命令节点的是按**命令名**分发的 `TaskCommandNode`（`key: 'tasks'`）：它拿到
+`name === 'tasks'` 就用**任务**解析器去解**记忆**载荷，`parseTaskPayloadText` 必然返回 null，
+于是对面板零影响，只在对话里留下一个 `/tasks 已执行` 节点。用户看到的就是「点了没反应」。
+
+根因是面板的视图页是 `TaskPanel` 组件**内部**的 `useState('task')` —— 组件外面没有任何可寻址
+的落点，所以菜单行只能绕宿主命令，而那条路又够不到面板。
+
+- `view` 移进 UI store（`task-ui-store.ts`）：新增 `PANEL_VIEWS` / `normalizeView()` 与
+  `setView()` / `openView()`，持久化且可从组件外寻址；面板的切页按钮改为读它（不再各抄一份）。
+- `/` 菜单三行改为**纯客户端**：`consumeSpan()` 之后直接 `openView(view)`，不再发宿主命令
+  （`SlashSourceDeps.run` 随之删除，`client.ts` 里的 `runCommand` 变成死代码也删掉）。
+- 候选不再携带 `line` 字段。
+- 测试：`test/client-slash.test.mjs` 的点击语义改为断言 **localStorage 里的 `view` / `closed`**
+  （旧断言是"命令行映射正确"，正是它把 bug 放了过去），并加一条"视图入口不得携带命令行"。
+
+### 修复：`show_task_panel` 从来没有打开过面板
+
+这个工具读 `exec.ctx` 再 `emit('dsh:task-panel:show')`，而宿主契约里**没有 `ctx`**：
+`ToolRunContext` 只扩了 `deferContext()` / `concludeTurn()` 两个自有成员
+（`packages/core/tools/src/index.ts:418`）。于是它每次都只返回「无法获取上下文」，
+那个事件名也是编出来的 —— 面板从未被它打开过。
+
+面板的 `closed` / `minimized` 是**浏览器侧** UI store 的状态，宿主进程碰不到，所以正确的
+位置是宿主给出的扩展点：`ui-tool` 在 `conversation.chat.node`（key `tool-call`）下声明了按
+**工具名**分发的子槽 `tool.call.toolview`（契约原文：*"Any name is allowed, including tools
+registered by your package. Register with `key: '<tool name>'`"*）。
+
+- 新增 `src/client/ShowTaskPanelNode.tsx`：认领 `show_task_panel` 这个 key，工具结果一渲染
+  就调 `taskUIStore.open()`。**只在现场执行时打开** —— 历史节点（刷新 / 切会话后）会直接以
+  `result` 阶段挂载，那时只展示不开面板，否则每次打开会话都弹一次（与 `/tasks` 命令节点的
+  `live` 判据同款）。
+- 宿主侧删掉那段触碰不到 `ctx` 的代码，改为只让调用真实发生并返回可读结果。
+- 测试：新增 `test/client-toolview.test.mjs`（5 项：注册 key、历史回放不弹、现场执行弹、
+  槽缺失时降级、畸形 ctx 不抛）+ `test/task-view.test.mjs` 补一项（不依赖 `exec`）。
+
+### 性能：影子日志瘦身 2×，单项目日志上限 4.5 MB → 1.5 MB
+
+`admission-shadow.jsonl` 的体积 **90.6% 是 `candidates`**（实测 210 行 / 965 KB，候选占
+875 KB），而真实 store 单步就能产生 40~60 条（中位 42）。三处都是纯冗余：
+
+- `support` / `terms` 是**查询级**量，同一个 pre-step 内逐条恒定（实测 139/139 步）→ 提到行级；
+- 候选只可能来自提示通道（trigger 在 `injected` / `dropped` 里）→ 不再逐条记 `channel`；
+- 候选按分数降序、`decision === 'cand'` 必然在最前 → **全部 cand + 按排名补足到 16 条**，
+  截断前的总数记在 `candidatesTotal`，不静默。
+
+实测单行 **6071 B → 2935 B（48%）**。同时把 `shadowMaxBytes` 默认 2 MB 降到 512 KB：
+轮转只保留一代 `.1`，所以单项目日志硬上限从 `2×2MB + 2×256KB ≈ 4.5MB` 降到 **≈1.5MB**
+（按每行 ~1.5KB 算仍有 ~680 步历史窗口，远超"离线重放最近历史"所需）。
+日志**本来就是有上限的**（`rotateIfOversized` 覆盖旧的 `.1`，不是无限追加）；
+要彻底不要日志，`autoContext.shadowLog: false` 即可。
+
+### 修复：会话配额把长会话的后段永久致盲
+
+`maxItemsPerSession` / `maxItemCharsPerSession` 从 12 / 4000 抬到 **60 / 24000**。它们是**保险丝**，
+不是节流阀——节流一直由单轮 `maxTokens` 与 `gateCooldownSteps` 负责，但默认值太小、真实用量
+确实到得了：实测 5 个 root 的 2781 个 pre-step（含轮转历史）里 **11/81 个会话打满**，打满之后
+再无条目注入（`session-chars` 1115 步 + `session-items` 119 步），且**全部尾部失明步的 72% 来自
+这 11 个会话**（最坏的一个 223 步里 168 步静默，末次注入停在 step 54）。机制一行未改，显式配小值
+即可复现旧行为。
+
+### 修复：配额邻近上限时的「细缝」静默不可诊断
+
+配额逼近上限却未触顶时（实测 `4000 − 3962 = 38` 字符），每条候选都过得了全部门槛，却永远塞不下
+最小正文（提示 120 / 触发 48），于是**永久**静默——而日志里只有一条无量纲的 `budget`。
+现在丢弃会带出 `remaining` / `need` 两个数字。
+
+### 修复：注入判据的观测缺口（三处）
+
+- 会话限流命中时 `hintCands` 被整个置空，静默步**一个候选都不落盘**（实测 1420 步全空）→
+  改为照旧评分、只不注入，影子记录才答得出「不限流这一步会注入什么」。
+- `buildInjection` 的空块早退分支漏掉了 `candidates`，把候选一并丢了。
+- 候选只有门槛结论、没有预算结论 → 每个候选新增 `outcome`
+  （`injected` / `budget` / `quota` / `idle` / `gate` / `unscheduled`），与 `decision` 正交；
+  影子行另记 `scoreQuery`（**实际**用于评分的 intent + 写目标拼合，与人类消息 `query` 不是一回事）
+  与 `dropped`。
+
+### 性能：每步评分从 O(C²) 降到 O(C)
+
+`idfCoverage` 对**每个候选**都重建一遍整个语料的词集合。真实 store（72 条）实测单步
+`buildInjection` **113 ms → 9 ms**；只看覆盖率那段是 147.5 → 1.3 ms（109×），且逐字段一致
+（已固化为回归用例）。评分在每个 pre-step 都跑，所以这是「每条模型消息」级别的开销。
+
+### 修复：IDF 语料与检索语料不同源
+
+`store.js` 的 `_rebuildIdf` 手抄了一份 `title×5 + keywords + summary`，而检索侧的
+`weightedFieldText` 是 `title×5 + keywords + summary + **terms** + sourcePath`。于是只出现在
+`terms` 里的词 `df=0` → 被当成极稀有词拿虚高 IDF（`terms` 正是为修「只有前 300 字符可检索」
+加的主检索面）。改为直接调 `makeSearchText`，权重自动对齐。
+
+### 观察：注入块抬头标注生产者
+
+`[Memory Inject] auto-context` → `[Memory Inject] dsh-project-memory · auto-context`。
+`source.kind` 只有宿主看得到（请求序列化只取 `role` / `content`，provider 对 `.source` 零引用），
+抬头是模型与 GUI 用户唯一能看到生产者的地方。
+
+### 工具描述修订
+
+- `remember` 指向了一个**不存在**的工具（`search_experience`）→ 改为 `query_memory`。
+- `remember` 与 `save_lesson` 职责相邻却都没说清怎么选 → 两处互相点名（`remember` 写独立的
+  经验文件；新建内容优先 `save_lesson`，它带 scope / 合并 / 晋升）；`forget` 的参数说明同步。
+- `watch_repo` 不再建议「重载插件」（模型做不到这件事）。
+
+### 修复：`writeJsonAtomic` 的两份副本已漂移
+
+同一个函数在 `store.js` 与 `insight-store.js` 各有一份。`f9a1389` 给前一份补了「失败即删自己的
+`.tmp`」，v0.5.0 后加的那份没有，写成了「失败后重试同一个 rename」—— 瞬时失败下可能重试成功，
+然后照样抛错。两份的父目录契约也不同（一份要求已存在，一份自建）。
+
+后果落在 global insight 文件上：它写失败会永久留下 `<file>.<pid>.tmp`，因为
+`cleanStaleTmp()` 只扫项目 store 目录，够不着 `~/.config/dsh-project-memory/`。
+
+- 抽成 `src/util/fs.js` 的单一实现：先建父目录，失败时删掉自己的 `.tmp` 并原样抛出。
+- 两份副本删除；`insight-store.js` 清掉随之无用的 import。
+- `store.js` 两处 `mkdirSync(shards)` 已冗余，一并删除。分片写的 mkdir 次数不变（1 次，
+  只是挪进函数内）。
+- 测试：新增 `test/atomic-write.test.mjs`（6 项），含「`shards/` 被删后 store 仍写得进去」。
+
 ## 0.5.13 (2026-09-28)
 
 适配 DSH 0.2.x。`npm test` **539 → 540 项 / 28 个文件**。

package/README.md

@@ -161,15 +161,15 @@ The workflow panel is collapsible, automatically adapts to dsh and theme plugin
 | `reflection.enabled` | false | v0.5 LLM reflection, **draft-only at task level** (fires on task switch-away / archive). `cooldownMs` `1800000`, `maxLessonsPerReflect` `3`, `maxDecisionsPerReflect` `2` |
 | `autoContext.enabled` | true | silent injection wrapper (resident task card + gated items). Inert (full passthrough) until the host exposes a resolvable session cwd; `maxTokens` `400`, `editedMax` `3` (how many recently-written "editing now" files the resident task card shows), `signalMinRatio` `0.5` (a hint must reach half of its layer's top score), `skipEchoSelfTodo` `true` (don't echo the task card back when the model itself maintains the task list with no newer human message; relevant insights still inject), `budgetLog` `off` (budget-drop audit on stderr: `off` silent / `once` at most one line per session / `all` one line per changed dropped set), `reinjectItemsAfter` `0` (cooldown, in pre-steps, before the same insight may be injected again), `rootNotice` `true` (when the memory root is inferred from a marker-less working directory, tell the model once where memory lives and how to change it) |
 | `autoContext.gateCooldownSteps` | 2 | **admission knobs.** Minimum number of pre-steps between two *item* injections (the resident task card is exempt — it is a state snapshot and should update when it changes). This is the main "don't inject often" dial |
-| `autoContext.maxItemsPerSession` | 12 | hard per-session cap on injected items; the budget is a ceiling, not a target — once exhausted the item channel stays silent |
-| `autoContext.maxItemCharsPerSession` | 4000 | same, in characters |
+| `autoContext.maxItemsPerSession` | 60 | **runaway fuse, not a throttle** — throttling is done by `maxTokens` (per step) and `gateCooldownSteps`. It is a hard per-session ceiling: once reached, the item channel stays silent for the rest of the session. The default sat at 12 until 0.5.14, which real usage did reach (longest observed session: 35 items), permanently blinding the tail of long sessions. Set it lower to reproduce the old behaviour |
+| `autoContext.maxItemCharsPerSession` | 24000 | same, in characters |
 | `autoContext.hintMinCoverage` | 0.45 | **absolute** floor for the statistical (hint) channel: IDF-weighted share of the query's information mass the entry covers. A ratio-only threshold cannot tell signal from "best of a bad lot" (`relative:1.00` on an unrelated entry). Raised from 0.30 in 0.5.8: on a real 43-entry store the control scenario injected 3 unrelated hints at cov 0.32–0.35, because a same-corpus store flattens IDF |
 | `autoContext.hintMinMatched` | 2 | a hint must share at least this many terms with the query — one generic word ("plugin") is not evidence |
 | `autoContext.hintMinSupport` | 0.15 | channel-level silence: if less than this share of the query's terms exist anywhere in the corpus, the hint channel says nothing this round — a long sentence that happens to share one word otherwise reports `cov:1.00` |
 | `autoContext.legacyScope` | `filter` | how to treat a legacy `trigger.scope`: `filter` keeps the old semantics, `ignore` drops it. `npm run selfcheck:triggers` reports entries whose scope values cannot intersect the project tag space |
 | `autoContext.auditLog` | true | append one JSONL line per **actual** injection to `<root>/.dsh-project-memory/injection-audit.jsonl` (what was injected, why it matched, what was dropped, session budget snapshot); rotates to `.1` past `auditMaxBytes` (`262144`). Silent on any I/O error — never affects the host request |
-| `autoContext.shadowLog` | true | append one JSONL line **per step** (including steps that injected nothing) to `admission-shadow.jsonl`: every scored candidate with its judgement features (`rel` / `coverage` / `matched` / `support` / `terms` / `decision`) plus the step's `query` / `ops` / `writes`. This is what makes a threshold change answerable offline on real history (`decision` shows which gate rejected each candidate). Rotates past `shadowMaxBytes` (`2097152`). Disk only — never enters the prompt, costs no tokens |
-| `autoContext.shadowMaxBytes` | 2097152 | rotation cap for `admission-shadow.jsonl` |
+| `autoContext.shadowLog` | true | append one JSONL line **per step** (including steps that injected nothing) to `admission-shadow.jsonl`: the scored candidates near the head of the ranking (`rel` / `coverage` / `matched` / `decision` / `outcome`) plus the step's `query` / `scoreQuery` / `ops` / `writes`. This is what makes a threshold change answerable offline on real history (`decision` shows which gate rejected each candidate, `outcome` what the budget did with it). Rotates past `shadowMaxBytes` (`524288`), keeping one `.1` generation, so the per-project log ceiling is `2 × shadowMaxBytes + 2 × auditMaxBytes` ≈ 1.5 MB. Disk only — never enters the prompt, costs no tokens |
+| `autoContext.shadowMaxBytes` | 524288 | rotation cap for `admission-shadow.jsonl` (one `.1` generation is kept) |
 
 ### Injection admission (why it stays quiet)
 
@@ -298,7 +298,7 @@ These commands are for **maintaining the plugin code** — regular users do not
 
 ```bash
 npm install
-npm test                    # 539 tests (214 core + 16 TaskBridge + 12 insight-store + 9 insight-actions + 8 doc-index + 7 auto-inject + 10 host-contract + 5 reflection + 4 llm-route + 2 client-hints + 10 recall + 14 readiness + 7 insight-derive + 7 readiness-eval + 6 ops + 11 injection-audit + 5 injection-budget + 6 injection-scenarios + 18 bugfix-0.5.7 + 3 client-icons + 10 client-slash + 5 workflow-command + 7 client-session-id + 6 task-view + 79 root-guards + 9 store-gitignore + 22 store-cache + 27 enhancer)
+npm test                    # 561 tests (216 core + 16 TaskBridge + 12 insight-store + 9 insight-actions + 8 doc-index + 7 auto-inject + 10 host-contract + 5 reflection + 5 llm-route + 2 client-hints + 10 recall + 15 readiness + 7 insight-derive + 7 readiness-eval + 6 ops + 12 injection-audit + 10 injection-budget + 6 injection-scenarios + 18 bugfix-0.5.7 + 3 client-icons + 10 client-slash + 5 client-toolview + 5 workflow-command + 7 client-session-id + 7 task-view + 79 root-guards + 9 store-gitignore + 6 atomic-write + 22 store-cache + 27 enhancer)
 npm run eval:injection      # scenario P/R on the synthetic pool: 14/14 hits, 0 false positives, control group clean
 npm run eval:injection -- --store .dsh-project-memory/insights.json   # replay on YOUR store; control group is a hard gate
 npm run selfcheck:triggers  # which entries can still push, which declarations are dead (reads your local store)

package/README.zh-CN.md

@@ -158,15 +158,15 @@ TaskPanel (Container)
 | `reflection.enabled` | false | v0.5 LLM 反思，**只写任务级草稿**（触发于任务切走/归档）。`cooldownMs` `1800000`、`maxLessonsPerReflect` `3`、`maxDecisionsPerReflect` `2` |
 | `autoContext.enabled` | true | v0.5 静默注入包装（entry 常驻块 + relevance）。宿主无法解析会话 cwd 时完全透传（零副作用）；`maxTokens` `400`、`editedMax` `3`（resident 任务卡显示最近"编辑中"文件数）、`signalMinRatio` `0.5`（提示至少要达到该层最高分的一半）、`skipEchoSelfTodo` `true`（模型自己写/维护任务清单后、无新人类消息时不回声任务卡，省 token；相关 insights 仍注入）、`budgetLog` `off`（预算丢弃审计写到 stderr：`off` 静默 / `once` 每会话最多一行 / `all` 丢弃组合每变化一次一行。注入按优先级排程，预算不够时丢掉低优先级条目属于**正常降级而非故障**，所以默认不占用用户终端）、`reinjectItemsAfter` `0`（同一条 insight 重复注入的冷却步数；`0` = 正文没变就不在本会话内再注入——注入消息留在会话历史里，重发只是重复占位）、`rootNotice` `true`（记忆根是从无标记的工作目录**推定**出来时，向模型通告一次根在哪、怎么改） |
 | `autoContext.gateCooldownSteps` | 2 | **准入旋钮**：两次*条目*注入之间至少隔几步（常驻任务卡不受限——它是状态快照，内容变了就该更新）。这是"别频繁注入"的主旋钮 |
-| `autoContext.maxItemsPerSession` | 12 | 每会话条目注入条数硬上限；预算是上限不是目标，用尽后条目通道持续沉默 |
-| `autoContext.maxItemCharsPerSession` | 4000 | 同上，按字符计 |
+| `autoContext.maxItemsPerSession` | 60 | **runaway 保险丝，不是节流阀** —— 节流由 `maxTokens`（单轮）与 `gateCooldownSteps` 负责。它是每会话硬上限：一旦触顶，本会话余下部分条目通道持续沉默。0.5.14 之前默认 12，而真实用量确实到得了（实测最长会话 35 条），于是长会话的后段被永久致盲。配小值可复现旧行为 |
+| `autoContext.maxItemCharsPerSession` | 24000 | 同上，按字符计 |
 | `autoContext.hintMinCoverage` | 0.45 | 提示通道的**绝对**下限：条目覆盖了查询多少 IDF 加权信息量。只用相对阈值分不出"有信号"和"矮子里拔将军"（实测无关条目也拿 `relative:1.00`）。0.5.8 从 0.30 上调：真实 43 条 store 上对照组以 cov 0.32~0.35 注入了 3 条无关提示——同源语料会把 IDF 分辨力拉平 |
 | `autoContext.hintMinMatched` | 2 | 提示还必须至少共享这么多个词：单个通用词（"插件"）不构成证据 |
 | `autoContext.hintMinSupport` | 0.15 | 通道级沉默：查询里能在语料中找到对应的词占比低于此值时，提示通道本轮整体不出声——否则一句只碰巧共享一个词的长句子会报出 `cov:1.00` |
 | `autoContext.legacyScope` | `filter` | 旧 `trigger.scope` 的处理：`filter` 保留旧语义，`ignore` 丢弃。`npm run selfcheck:triggers` 会列出 scope 值与项目画像 tag 空间不可能相交的条目 |
 | `autoContext.auditLog` | true | 每次**真实**注入往 `<root>/.dsh-project-memory/injection-audit.jsonl` 追加一行（注入了什么、为什么命中、丢了什么、会话额度快照）；超过 `auditMaxBytes`（`262144`）轮转 `.1`。任何 IO 失败都静默，绝不影响宿主请求 |
-| `autoContext.shadowLog` | true | **每步**（含什么都没注入的步）往 `admission-shadow.jsonl` 追加一行：本步全部被评分的候选 + 判据特征（`rel` / `coverage` / `matched` / `support` / `terms` / `decision`）+ 场景（`query` / `ops` / `writes`）。它让"换个阈值会怎样"可以在真实历史上离线回答（`decision` 直接指出每条候选卡在哪一关）。超过 `shadowMaxBytes`（`2097152`）轮转。只写盘，不进 prompt、不花 token |
-| `autoContext.shadowMaxBytes` | 2097152 | `admission-shadow.jsonl` 的轮转上限 |
+| `autoContext.shadowLog` | true | **每步**（含什么都没注入的步）往 `admission-shadow.jsonl` 追加一行：排名靠前的被评分候选（`rel` / `coverage` / `matched` / `decision` / `outcome`）+ 场景（`query` / `scoreQuery` / `ops` / `writes`）。它让"换个阈值会怎样"可以在真实历史上离线回答（`decision` 指出每条候选卡在哪一关，`outcome` 指出预算拿它怎么办）。超过 `shadowMaxBytes`（`524288`）轮转，只保留一代 `.1`，所以单项目日志硬上限 ≈ `2 × shadowMaxBytes + 2 × auditMaxBytes` ≈ 1.5 MB。只写盘，不进 prompt、不花 token |
+| `autoContext.shadowMaxBytes` | 524288 | `admission-shadow.jsonl` 的轮转上限（保留一代 `.1`） |
 
 ### 注入的准入化（为什么它保持安静）
 
@@ -295,7 +295,7 @@ node scripts/bench.mjs /你的/项目路径 [--json] [--samples 100] [--no-pdf]
 
 ```bash
 npm install
-npm test                    # 539 项测试（核心 214 + TaskBridge 16 + insight-store 12 + insight-actions 9 + doc-index 8 + auto-inject 7 + host-contract 10 + reflection 5 + llm-route 4 + client-hints 2 + recall 10 + readiness 14 + insight-derive 7 + readiness-eval 7 + ops 6 + injection-audit 11 + injection-budget 5 + injection-scenarios 6 + bugfix-0.5.7 18 + client-icons 3 + client-slash 10 + workflow-command 5 + client-session-id 7 + task-view 6 + root-guards 79 + store-gitignore 9 + store-cache 22 + enhancer 27）
+npm test                    # 561 项测试（核心 216 + TaskBridge 16 + insight-store 12 + insight-actions 9 + doc-index 8 + auto-inject 7 + host-contract 10 + reflection 5 + llm-route 5 + client-hints 2 + recall 10 + readiness 15 + insight-derive 7 + readiness-eval 7 + ops 6 + injection-audit 12 + injection-budget 10 + injection-scenarios 6 + bugfix-0.5.7 18 + client-icons 3 + client-slash 10 + client-toolview 5 + workflow-command 5 + client-session-id 7 + task-view 7 + root-guards 79 + store-gitignore 9 + atomic-write 6 + store-cache 22 + enhancer 27）
 npm run eval:injection      # 合成池上的场景 P/R：命中 14/14、假阳性 0、对照组零注入
 npm run eval:injection -- --store .dsh-project-memory/insights.json   # 用你自己的 store 重放；对照组是硬闸门
 npm run selfcheck:triggers  # 哪些条目还推得动、哪些声明是死的（读你本地的 store）

package/client/client.js

@@ -365,6 +365,20 @@ window.__ModuleLoader__.load({
 		* - 启动/刷新强制 closed: true，面板默认不显示
 		*/
 		const STORAGE_KEY = "dsh-pm-task-panel-ui";
+		/**
+		* 面板的三个视图页。**单一事实来源**：面板的切页按钮与 `/` 菜单的三行都读它。
+		* 两边各抄一份必然漂移 —— 实测就是这样：菜单行去执行宿主命令"开记忆页"，而面板的 view
+		* 是组件内部 state，谁也够不着它，于是点击没有任何可见效果。
+		*/
+		const PANEL_VIEWS = [
+			"task",
+			"project",
+			"global"
+		];
+		/** 把任意值收敛成一个合法视图页（脏 localStorage / 外部传入都要过这一关）。 */
+		function normalizeView(value) {
+			return PANEL_VIEWS.includes(value) ? value : "task";
+		}
 		function defaultPosition() {
 			if (typeof window !== "undefined") return {
 				x: Math.max(16, window.innerWidth - 408),
@@ -391,7 +405,8 @@ window.__ModuleLoader__.load({
 						minimized: parsed.minimized !== false,
 						closed: true,
 						theme: typeof parsed.theme === "string" ? parsed.theme : "native",
-						showHints: parsed.showHints !== false
+						showHints: parsed.showHints !== false,
+						view: normalizeView(parsed.view)
 					};
 				}
 			} catch {}
@@ -401,7 +416,8 @@ window.__ModuleLoader__.load({
 				minimized: true,
 				closed: true,
 				theme: "native",
-				showHints: true
+				showHints: true,
+				view: "task"
 			};
 		}
 		function persistUI(state) {
@@ -455,6 +471,36 @@ window.__ModuleLoader__.load({
 						closed: false
 					});
 				},
+				/**
+				* 切页但不动开合状态（面板里那个循环按钮用）。
+				* 非法值一律忽略 —— 这个入口会被菜单行与脏 localStorage 碰到，静默归一比抛错合适。
+				*/
+				setView(view) {
+					if (!PANEL_VIEWS.includes(view)) return;
+					if (uiState.view === view) return;
+					setUIState({
+						...uiState,
+						view
+					});
+				},
+				/**
+				* 打开面板并切到指定页 —— `/` 菜单那三行的**全部**动作。
+				*
+				* 纯客户端：不再绕 `remote.commands.execute('/tasks insight list …')` 一圈。那条路
+				* 只在对话里留下一个命令节点，而客户端渲染命令节点的是按**命令名**分发的
+				* `TaskCommandNode`（`name === 'tasks'`），它拿任务解析器去解记忆载荷，解析必然失败
+				* —— 于是点菜单"开记忆页"什么都不会发生。
+				* @param view - 目标视图页；非法值直接忽略（不打开面板，避免"点了没反应还弹窗"）。
+				*/
+				openView(view) {
+					if (!PANEL_VIEWS.includes(view)) return;
+					setUIState({
+						...uiState,
+						view,
+						minimized: false,
+						closed: false
+					});
+				},
 				minimize() {
 					setUIState({
 						...uiState,
@@ -1769,11 +1815,7 @@ window.__ModuleLoader__.load({
 			"in_progress",
 			"completed"
 		];
-		const VIEW_CYCLE = [
-			"task",
-			"project",
-			"global"
-		];
+		const VIEW_CYCLE = PANEL_VIEWS;
 		function getT(ctx) {
 			return createTranslate(ctx?.locale?.getSnapshot?.()?.active === "zh" ? zh : en);
 		}
@@ -1816,14 +1858,14 @@ window.__ModuleLoader__.load({
 			const [syncedAt, setSyncedAt] = (0, react.useState)(0);
 			const [syncError, setSyncError] = (0, react.useState)(null);
 			const showHints = ui.showHints;
-			const [view, setView] = (0, react.useState)("task");
+			const dataActions = useTaskDataActions();
+			const uiActions = useTaskUIActions();
+			const view = ui.view;
 			const cycleView = () => {
 				const i = VIEW_CYCLE.indexOf(view);
-				setView(VIEW_CYCLE[(i + 1) % VIEW_CYCLE.length]);
+				uiActions.setView(VIEW_CYCLE[(i + 1) % VIEW_CYCLE.length]);
 			};
 			const viewTitle = view === "task" ? t("panel.title") : view === "global" ? t("view.global") : t("view.project");
-			const dataActions = useTaskDataActions();
-			const uiActions = useTaskUIActions();
 			const tasks = Array.isArray(data.tasks) ? data.tasks : [];
 			const activeTasks = tasks.filter((task) => !task.archived);
 			const boundTask = data.boundTaskId ? tasks.find((task) => task.id === data.boundTaskId) ?? null : null;
@@ -2302,6 +2344,53 @@ window.__ModuleLoader__.load({
 			});
 		}
 		//#endregion
+		//#region src/client/ShowTaskPanelNode.tsx
+		/**
+		* `show_task_panel` 工具调用的会话内视图 —— 它的作用就是**把面板打开**。
+		*
+		* 为什么这件事必须在这里做：面板的显示状态（closed / minimized）是**浏览器侧**的
+		* （`task-ui-store.ts`），宿主进程碰不到它。宿主侧原本写的是
+		* `exec.ctx.events.emit('dsh:task-panel:show')`，而宿主契约里根本没有 `ctx`：
+		*
+		*   packages/core/tools/src/index.ts:418
+		*   export interface ToolRunContext extends ToolExecution {
+		*     deferContext(context: UserMessage): void
+		*     concludeTurn(): void
+		*   }
+		*
+		* 于是那个工具每次都只返回「无法获取上下文」，面板从来不会打开 —— 插件里唯一的
+		* 宿主命令之外，这是第二个"写了但没生效"的面（详见 CHANGELOG 0.5.14）。
+		*
+		* 正确的位置是宿主给出的扩展点：`ui-tool` 注册了 `conversation.chat.node`（key `tool-call`），
+		* 其下有个按**工具名**分发的子槽 `tool.call.toolview`（契约原文：*Any name is allowed,
+		* including tools registered by your package. Register with `key: '<tool name>'`*）。
+		* 在这里认领 `show_task_panel` 这个 key，工具结果一渲染就把面板打开。
+		*/
+		/**
+		* 只在**现场执行**时打开面板。
+		*
+		* 历史节点在刷新 / 切换会话后挂载时会**直接**处于 `result` 阶段；现场调用则会先经过
+		* `preparing` / `start`。这与 `/tasks` 命令节点用的判据同款（见 `TaskCommandNode.tsx`
+		* 的 `live` ref）：刷新后只展示、不再开面板，否则每次打开会话都会弹一次面板。
+		*/
+		function ShowTaskPanelNode(props) {
+			const phase = props?.phase;
+			const live = (0, react.useRef)(phase !== "result");
+			(0, react.useEffect)(() => {
+				if (phase !== "result" || !live.current) return;
+				live.current = false;
+				taskUIStore.actions.open();
+			}, [phase]);
+			return null;
+		}
+		/** 把 `show_task_panel` 的视图注册进宿主的 `tool.call.toolview` 槽。 */
+		function registerShowTaskPanelView(slots) {
+			slots.inject("tool.call.toolview", () => slots.register({
+				name: "tool.call.toolview",
+				key: "show_task_panel"
+			}, ShowTaskPanelNode));
+		}
+		//#endregion
 		//#region src/client/slash.ts
 		/** 源的稳定标识：同一 trigger 内唯一，重复注册会抛错。 */
 		const SLASH_SOURCE_NAME = "project-memory";
@@ -2312,7 +2401,7 @@ window.__ModuleLoader__.load({
 				descriptionKey: "slash.tasks-desc",
 				icon: IconChecklistOutline16,
 				match: ["tasks", "task"],
-				line: "/tasks"
+				view: "task"
 			},
 			{
 				labelKey: "view.project",
@@ -2323,7 +2412,7 @@ window.__ModuleLoader__.load({
 					"project",
 					"insight"
 				],
-				line: "/tasks insight list project"
+				view: "project"
 			},
 			{
 				labelKey: "view.global",
@@ -2334,7 +2423,7 @@ window.__ModuleLoader__.load({
 					"global",
 					"insight"
 				],
-				line: "/tasks insight list global"
+				view: "global"
 			}
 		];
 		/** 按当前语言取翻译函数。 */
@@ -2361,7 +2450,6 @@ window.__ModuleLoader__.load({
 					description: t(row.descriptionKey),
 					icon: row.icon,
 					section: t("slash.group"),
-					line: row.line,
 					terms: [title, ...row.match].map((term) => term.toLowerCase())
 				};
 			}).filter((row) => query === "" || row.terms.some((term) => term.startsWith(query))).map(({ terms: _terms, ...candidate }) => candidate);
@@ -2385,13 +2473,18 @@ window.__ModuleLoader__.load({
 			}
 		}
 		/**
-		* 一次菜单点击：消费掉触发 token 后立刻执行该行对应的命令行。
+		* 一次菜单点击：消费掉触发 token 后**直接打开面板的对应页**。
 		*
-		* 不返回 claim（回填 `/xxx ` 再等回车）：这三行都是「打开某个视图」，claim 会多要一次回车，
-		* 而且子动词（`insight list project`）也没法由一个 claim token 表达。消费失败时仍然执行，
-		* 只是草稿里残留的触发文本要用户自己清掉 —— 比回填一个会执行错命令的 claim 安全。
+		* 这三行是「打开某个视图」，不是「执行某条命令」，所以走客户端自己的 UI store：
+		* 面板的 `closed` / `view` 都是浏览器侧状态，宿主命令碰不到它们。旧实现执行
+		* `remote.commands.execute('/tasks insight list project')`，只在对话里留下一个命令节点，
+		* 而客户端渲染命令节点的是按**命令名**分发的 `TaskCommandNode`（`name === 'tasks'`），
+		* 它拿任务解析器去解记忆载荷 → 解析失败 → 对面板零影响。**这就是"点了没反应"的原因。**
+		*
+		* 不返回 claim（回填 `/xxx ` 再等回车）：claim 会多要一次回车，而这三行没有参数要填。
+		* 消费失败时仍然切页 —— 草稿里残留的触发文本要用户自己清掉，比"点了完全没反应"好。
 		* @param t - 翻译函数（按当前语言把候选 name 映射回 ROWS）。
-		* @param deps - 会话服务与命令执行通道。
+		* @param deps - 会话服务与 UI store 动作。
 		* @param pick - 宿主给的点击载荷。
 		* @returns PickOutcome；拿不到可用形状时返回 undefined（菜单照常关闭，草稿不动）。
 		*/
@@ -2401,9 +2494,11 @@ window.__ModuleLoader__.load({
 			const row = ROWS.find((candidate) => t(candidate.labelKey) === title);
 			if (row === void 0) return void 0;
 			consumeSpan(deps, pick);
-			deps.run(pick.session, row.line, []).catch((err) => {
-				console.warn(`[dsh-project-memory] ${row.line} failed:`, err);
-			});
+			try {
+				deps.openView(row.view);
+			} catch (err) {
+				console.warn(`[dsh-project-memory] open view ${row.view} failed:`, err);
+			}
 			return "handled";
 		}
 		/**
@@ -2452,34 +2547,6 @@ window.__ModuleLoader__.load({
 			"locale"
 		];
 		/**
-		* 执行一条命令行，映射成 composer 的 SubmitOutcome。
-		* 与 TaskPanel 走同一个 remote.commands.execute 通道（同样的返回信封）。
-		* @param commands - ctx.remote.commands
-		* @param session - 会话投影（只读 sessionId）
-		* @param line - 完整命令行（含前导斜杠）
-		* @param attachments - 提交附件（菜单路径恒为空）
-		* @returns {kind:'success'|'error', text?}
-		*/
-		async function runCommand(commands, session, line, attachments = []) {
-			const sessionId = session?.sessionId;
-			if (typeof sessionId !== "string" || !commands || typeof commands.execute !== "function") return {
-				kind: "error",
-				text: `no session / commands service for ${line}`
-			};
-			const envelope = await commands.execute(sessionId, line, [...attachments]);
-			if (envelope && typeof envelope === "object" && envelope.ok === false) return {
-				kind: "error",
-				text: `command.execute failed: ${envelope.error?.code ?? "unknown"}`
-			};
-			const execution = envelope && typeof envelope === "object" && "value" in envelope ? envelope.value : envelope;
-			const result = execution?.result ?? execution;
-			if (result?.kind === "error") return {
-				kind: "error",
-				text: result.text ?? `${line} failed`
-			};
-			return { kind: "success" };
-		}
-		/**
 		* 注册自建的 `/` 菜单源（见 slash.ts）。
 		*
 		* 整段都是**可选增强**：宿主没有 `inputTriggers` 服务、或该服务换了契约时，绝不能因此
@@ -2506,7 +2573,7 @@ window.__ModuleLoader__.load({
 						}
 						const source = createSlashSource(scope, {
 							sessions: scope.sessions,
-							run: (session, line, attachments) => runCommand(scope?.remote?.commands, session, line, attachments)
+							openView: (view) => taskUIStore.actions.openView(view)
 						});
 						scope.effect(() => inputTriggers.registerSource(source), "dsh-project-memory: slash source");
 					} catch (err) {
@@ -2530,6 +2597,7 @@ window.__ModuleLoader__.load({
 					name: "conversation.chat.commandview",
 					key
 				}, TaskCommandNode));
+				registerShowTaskPanelView(slots);
 			} catch (err) {
 				console.warn(`[${NS}] task panel registration failed:`, err);
 			}