dsh-super-code 0.3.7 → 0.3.9

package/cordis.patch.yml

@@ -17,7 +17,7 @@
           - id: super-code
             name: dsh-super-code/super-code
             config:
-              presetVersion: 0.3.7
+              presetVersion: 0.3.9
               presetInstallation: bundle:dsh-super-code
           - id: compaction
             name: cordis:group

package/docs/Acknowledgements.md

@@ -1,105 +1,76 @@
-# 致谢与借鉴 · Acknowledgements and Design References
+# 致谢
 
-感谢为 Super Code 提供运行基础、设计启发、开放规范和评测资源的项目与维护者。本文展开 [README 致谢表格](../README.md#4-致谢--acknowledgements)中的具体贡献，范围为当前 `0.3.4` 主干及其已有研究记录。
+中文 · [English](en/Acknowledgements.md)
 
-We thank the projects and maintainers who provide Super Code's runtime foundation, design references, open specifications, and evaluation resources. This document expands the [README acknowledgements](../README.md#4-致谢--acknowledgements), covering the current `0.3.4` main branch and its recorded design studies.
+感谢以下项目及其维护者。下文列出各项目在本插件中的具体用途。
 
 ## DeepSeek Harness
 
-**[项目与源码](https://github.com/deepseek-ai/deepseek-harness) · [MIT 许可证](https://github.com/deepseek-ai/deepseek-harness/blob/master/LICENSE)**
+[源码](https://github.com/deepseek-ai/deepseek-harness) · [MIT](https://github.com/deepseek-ai/deepseek-harness/blob/master/LICENSE)
 
-DeepSeek Harness 是本插件的运行基础。Super Code 复用宿主的 Agent、模型路由、会话、工具、权限、取消、持久化、子 Agent 和用量记录；批量调用与独立读取通过宿主原生 PTC 调度。预设组合沿用官方的 compaction、文件、搜索、终端、网页、子 Agent 与 Skill 插件。
+插件的运行宿主。
 
-DeepSeek Harness is the runtime foundation. Super Code uses its Agents, model routing, sessions, tools, permissions, cancellation, persistence, subagents, and usage records. Native PTC schedules batched calls and independent reads. Preset compositions use the official compaction, file, search, shell, Web, subagent, and Skill plugins.
+- Agent、模型路由、会话、工具、权限、取消、持久化、子 Agent 和用量记录均由宿主提供。批量调用使用宿主原生 PTC。
+- 预设组合沿用官方的压缩、文件、搜索、终端、网页、子 Agent 和 Skill 插件。
+- 界面基于宿主的 React、主题变量、Remote、设置页、侧边栏和会话投影接口实现；Agent 详情参考了宿主的消息与工具调用展示。
+- Cordis（插件生命周期与组合）和 Schemastery（配置）同样由宿主提供。
 
-Web 与桌面界面依托 Harness 的 React、主题变量、Remote、设置页、侧栏和会话投影接口。对话式 Agent 详情也参考宿主的消息与工具调用呈现。Cordis 的插件生命周期和组合机制、Schemastery 的配置机制同样来自宿主提供的基础设施。
-
-The Web and desktop interfaces use Harness-provided React, theme variables, Remotes, settings pages, sidebars, and session projections. Chat-style Agent details also draw on its message and tool-call presentation. Cordis supplies plugin lifecycles and composition, while Schemastery supplies configuration facilities through the host.
-
-实现对应：[预设组合](../presets/super-code/agent.cordis.yml)、[声明式预设](../cordis.patch.yml)、[宿主接入](https://github.com/ArtlexYoung/dsh-super-code/blob/main/src/dsh/index.ts)、[客户端](../client/index.js)。
-
-Implementation: [preset composition](../presets/super-code/agent.cordis.yml), [declarative preset](../cordis.patch.yml), [host integration](https://github.com/ArtlexYoung/dsh-super-code/blob/main/src/dsh/index.ts), and [client](../client/index.js).
+对应实现：[预设组合](../presets/super-code/agent.cordis.yml)、[声明式预设](../cordis.patch.yml)、[宿主接入](https://github.com/ArtlexYoung/dsh-super-code/blob/main/src/dsh/index.ts)、[客户端](../client/index.js)
 
 ## ZCode
 
-**[项目与源码](https://github.com/zai-org/ZCode) · [Apache-2.0 许可证](https://github.com/zai-org/ZCode/blob/main/LICENSE)**
-
-0.3.2 界面设计阶段研究了 ZCode 的 [DESIGN.md](https://github.com/zai-org/ZCode/blob/main/DESIGN.md)、语义主题与字号、Button / Input、设置资源分组、分段切换、搜索框、确认对话框和 WorkflowAgentPill。感谢这些可供阅读的设计与组件实现，它们帮助梳理紧凑布局、清晰层级、分组操作和交互状态。
-
-During the 0.3.2 UI design work, we studied ZCode's [DESIGN.md](https://github.com/zai-org/ZCode/blob/main/DESIGN.md), semantic themes and typography, Button / Input components, settings resource groups, segmented tabs, search fields, confirmation dialogs, and WorkflowAgentPill. These design documents and component implementations informed compact layouts, clear hierarchy, grouped actions, and interaction states.
+[源码](https://github.com/zai-org/ZCode) · [Apache-2.0](https://github.com/zai-org/ZCode/blob/main/LICENSE)
 
-Super Code 的界面接入仍采用 Harness 的公开接口与主题变量。ZCode 在这里是设计参考，没有作为插件依赖引入；执行树保留 Super Code 的圆形节点与运行反馈。
+0.3.2 界面改版时参考了其 [DESIGN.md](https://github.com/zai-org/ZCode/blob/main/DESIGN.md)、主题与字号、Button / Input、设置分组、分段切换、搜索框、确认框和 WorkflowAgentPill，用于梳理紧凑布局、层级、分组和交互状态。
 
-Super Code implements its interface through Harness's public APIs and theme variables. ZCode is a design reference rather than a package dependency; the execution tree keeps Super Code's circular nodes and running feedback.
+仅作为设计参考，并非依赖。界面仍基于 Harness 公开接口实现，执行树保留自有的圆形节点样式。
 
 ## Agent Skills
 
-**[格式规范](https://agentskills.io/specification) · [规范仓库与许可证](https://github.com/agentskills/agentskills)**
-
-内嵌前端 Skill 采用 Agent Skills 的目录格式：SKILL.md、YAML 元数据和 references/ 资源目录。宿主先提供名称与短描述，匹配任务后再加载正文和相关参考文件。感谢这套开放约定，使指导内容可以保持简短入口、按需展开，并与项目和用户自己的 Skill 共存。
-
-The bundled frontend Skill follows Agent Skills conventions: SKILL.md, YAML metadata, and a references/ resource directory. The host exposes a name and short description first, then loads the body and relevant resources when needed. This open format supports a short entry point, progressive disclosure, and coexistence with project and user Skills.
-
-实现对应：[super-code-frontend](../presets/super-code/skills/super-code-frontend/SKILL.md)。格式与内容加载复用 Harness 的原生 Skill 能力。
-
-Implementation: [super-code-frontend](../presets/super-code/skills/super-code-frontend/SKILL.md). Parsing and content loading use Harness's native Skill facilities.
-
-## 前端设计与无障碍资料 · Frontend Design and Accessibility
-
-### Apple Human Interface Guidelines
-
-**[布局](https://developer.apple.com/design/human-interface-guidelines/layout) · [无障碍](https://developer.apple.com/design/human-interface-guidelines/accessibility) · [按钮](https://developer.apple.com/design/human-interface-guidelines/buttons) · [反馈](https://developer.apple.com/design/human-interface-guidelines/feedback)**
-
-前端 Skill 的补充研究阅读了上述官方指南，采纳对齐表达关系、布局适应容器与字体、控制尺寸与间隔降低操作负担、交互可预测、反馈就近且适度等原则。这些原则被整理进视觉设计、交互状态和浏览器验证三份按需参考，感谢指南对具体交互问题的细致说明。
-
-The frontend Skill study used these official guides for alignment, layouts that adapt to containers and typography, control size and spacing, predictable interaction, and timely, proportionate feedback. These principles inform the Skill's visual-design, interaction-state, and browser-validation references.
-
-采纳范围是可迁移的交互原则；产品仍沿用自己的视觉语言。原生平台尺寸单位不直接换成 Web 的 CSS pixel，材质、字体和图标也不作为统一模板。资料适用条款见 [Apple Developer 条款](https://developer.apple.com/support/terms/)。
-
-The reference concerns transferable interaction principles, applied within each product's visual language. Native platform units are not treated as CSS pixels, and platform materials, typography, and icons are not prescribed as a template. See [Apple Developer terms](https://developer.apple.com/support/terms/) for applicable documentation terms.
-
-### W3C WCAG 2.2
+[规范](https://agentskills.io/specification) · [仓库与许可证](https://github.com/agentskills/agentskills)
 
-**[WCAG 2.2](https://www.w3.org/TR/WCAG22/) · [2.5.8 Target Size (Minimum) 说明](https://www.w3.org/WAI/WCAG22/Understanding/target-size-minimum.html)**
+内置前端 Skill 按该规范组织：`SKILL.md`、YAML 元数据和 `references/` 目录。平时仅向模型提供名称和简介，需要时才加载正文和参考资料，可与项目及用户自有的 Skill 共存。解析和加载使用 Harness 原生能力。
 
-感谢 W3C Web Accessibility Initiative 对操作目标尺寸、间距和例外条件的公开说明。前端 Skill 使用 WCAG 2.2 AA 2.5.8 的 24 × 24 CSS pixel 尺寸及间距等例外作为 Web 检查依据，并要求通过实际命中、键盘操作和内容验证检查可用性。数字检查通过不等于整个界面已满足无障碍要求。
+对应实现：[super-code-frontend](../presets/super-code/skills/super-code-frontend/SKILL.md)
 
-We thank the W3C Web Accessibility Initiative for its target-size, spacing, and exception guidance. The frontend Skill uses WCAG 2.2 AA 2.5.8's 24 × 24 CSS pixel criterion and its exceptions when checking Web controls, alongside real hit-area, keyboard, and content checks. Passing numeric checks does not establish accessibility compliance for the whole interface.
+## Apple Human Interface Guidelines
 
-实现对应：[交互状态参考](../presets/super-code/skills/super-code-frontend/references/interaction-states.md)、[浏览器验证参考](../presets/super-code/skills/super-code-frontend/references/browser-validation.md)。版权与使用条件见各 W3C 文档随附声明。
+[布局](https://developer.apple.com/design/human-interface-guidelines/layout) · [无障碍](https://developer.apple.com/design/human-interface-guidelines/accessibility) · [按钮](https://developer.apple.com/design/human-interface-guidelines/buttons) · [反馈](https://developer.apple.com/design/human-interface-guidelines/feedback) · [条款](https://developer.apple.com/support/terms/)
 
-Implementation: [interaction-state guidance](../presets/super-code/skills/super-code-frontend/references/interaction-states.md) and [browser-validation guidance](../presets/super-code/skills/super-code-frontend/references/browser-validation.md). Copyright and usage conditions are recorded in the respective W3C documents.
+前端 Skill 采纳了其中的原则：以对齐表达关系、布局适应容器和字号、通过控件尺寸和间距降低操作负担、交互可预测、反馈就近且适度。上述原则整理为视觉设计、交互状态和浏览器验证三份参考文档。
 
-## 评测项目 · Evaluation Projects
+仅借鉴原则，产品仍保持自身视觉风格。原生平台的尺寸单位不直接作为 CSS 像素使用，材质、字体和图标也不作为模板。
 
-### SWE-bench
+## W3C WCAG 2.2
 
-**[项目与评分工具](https://github.com/SWE-bench/SWE-bench) · [数据集](https://huggingface.co/datasets/princeton-nlp/SWE-bench) · [代码许可证](https://github.com/SWE-bench/SWE-bench/blob/main/LICENSE)**
+[WCAG 2.2](https://www.w3.org/TR/WCAG22/) · [2.5.8 目标尺寸（最小）](https://www.w3.org/WAI/WCAG22/Understanding/target-size-minimum.html)
 
-感谢 SWE-bench 提供真实软件工程任务、任务环境和可复现的评分基础。当前版本迭代使用从官方 dev 集中筛选并验证有效的 33 道困难题进行效果优化与开发验证。这 33 题是本项目的筛选集合。
+前端 Skill 检查 Web 控件时，采用 2.5.8 的 24 × 24 CSS 像素标准及其间距例外，并结合实际点击、键盘和内容检查。尺寸达标不代表整个界面满足无障碍要求。
 
-We thank SWE-bench for real software-engineering tasks, task environments, and reproducible grading infrastructure. Current iterations use 33 valid difficult tasks selected from the official dev split for performance improvement and development checks. This is a project-selected subset.
+对应实现：[交互状态](../presets/super-code/skills/super-code-frontend/references/interaction-states.md)、[浏览器验证](../presets/super-code/skills/super-code-frontend/references/browser-validation.md)
 
-### SWE-bench Pro
+## SWE-bench
 
-**[项目与评分工具](https://github.com/scaleapi/SWE-bench_Pro-os) · [数据集](https://huggingface.co/datasets/ScaleAI/SWE-bench_Pro) · [代码许可证](https://github.com/scaleapi/SWE-bench_Pro-os/blob/main/LICENSE)**
+[源码与评分工具](https://github.com/SWE-bench/SWE-bench) · [数据集](https://huggingface.co/datasets/princeton-nlp/SWE-bench) · [MIT](https://github.com/SWE-bench/SWE-bench/blob/main/LICENSE)
 
-感谢 Scale AI 与 SWE-bench Pro 的维护者提供长流程软件工程任务及评分工具。本项目固定的 hard-100 用于候选冻结后的效果评测和 bug 排查，不参与效果调优；“hard-100”是本项目的集合名称，不代表官方认定的最难 100 题。
+提供真实的软件工程任务、环境和可复现的评分。调优所用的 33 道困难题由本项目从官方 dev 集中筛选。
 
-We thank Scale AI and the SWE-bench Pro maintainers for long-horizon software-engineering tasks and grading tools. The project's frozen hard-100 set is used to evaluate frozen candidates and investigate bugs, not for performance tuning. “hard-100” is this project's selection name, rather than an official hardest-100 designation.
+## SWE-bench Pro
 
-评测口径、限制和逐题证据见[评测文档](EvaluationResults.md)。两项评测项目的代码许可证均为 MIT；数据集、被测仓库、镜像与其他资产保留各自条款，代码许可证不统一覆盖这些内容。
+[源码与评分工具](https://github.com/scaleapi/SWE-bench_Pro-os) · [数据集](https://huggingface.co/datasets/ScaleAI/SWE-bench_Pro) · [MIT](https://github.com/scaleapi/SWE-bench_Pro-os/blob/main/LICENSE)
 
-See the [evaluation report](EvaluationResults.md) for methodology, limitations, and per-task evidence. Both evaluation code repositories use MIT licenses. Datasets, tested repositories, images, and other assets retain their own terms, which are not replaced by the evaluation code licenses.
+感谢 Scale AI 及维护者提供长流程任务和评分工具。hard-100 是本项目选定的题集名称，并非官方的「最难 100 题」，仅用于评测和排查问题，不参与调优。[评测结果](EvaluationResults.md)
 
-## 运行依赖 · Runtime Dependencies
+两个评测项目的代码采用 MIT 许可证，但数据集、被测仓库和镜像等各有其条款，不在代码许可证覆盖范围内。
 
-感谢 [js-yaml](https://github.com/nodeca/js-yaml) 与 [Zod](https://github.com/colinhacks/zod) 的维护者。前者提供 YAML 解析，后者提供数据结构与输入校验；两者均以 MIT 许可证发布，是本插件的直接运行依赖。完整直接依赖及宿主 peer dependencies 见 [package.json](../package.json)，版本锁定见 [package-lock.json](https://github.com/ArtlexYoung/dsh-super-code/blob/main/package-lock.json)。
+## 运行依赖
 
-We thank the maintainers of [js-yaml](https://github.com/nodeca/js-yaml) and [Zod](https://github.com/colinhacks/zod). They provide YAML parsing and schema/input validation, respectively. Both are direct runtime dependencies under MIT licenses. See [package.json](../package.json) for direct and host peer dependencies, and [package-lock.json](https://github.com/ArtlexYoung/dsh-super-code/blob/main/package-lock.json) for locked versions.
+- [js-yaml](https://github.com/nodeca/js-yaml)（MIT）：YAML 解析
+- [Zod](https://github.com/colinhacks/zod)（MIT）：数据与输入校验
+- [@modelcontextprotocol/sdk](https://github.com/modelcontextprotocol/typescript-sdk)：MCP 连接
 
-## 版权与许可证 · Copyright and Licenses
+完整依赖见 [package.json](../package.json)，锁定版本见 [package-lock.json](https://github.com/ArtlexYoung/dsh-super-code/blob/main/package-lock.json)。
 
-Super Code 使用 [Apache License 2.0](../LICENSE)。上述项目、规范、设计资料和数据保留各自版权、许可证或文档条款；具体内容以对应上游的 LICENSE、NOTICE、数据说明和版权声明为准。本页记录贡献与借鉴范围，设计参考本身不表示运行依赖、上游背书或功能等价。
+## 许可证
 
-Super Code uses the [Apache License 2.0](../LICENSE). Referenced projects, specifications, design resources, and datasets retain their own copyrights, licenses, or documentation terms, as stated by their upstream LICENSE, NOTICE, dataset documentation, and copyright notices. This page records contributions and design influence; a design reference does not imply a runtime dependency, upstream endorsement, or feature equivalence.
+本项目采用 [Apache-2.0](../LICENSE) 许可证。上述项目、规范、设计资料和数据各自保留版权与许可证，以上游的 LICENSE、NOTICE 和说明为准。设计参考不代表依赖关系、上游背书或功能等价。

package/docs/Changelog.md

@@ -1,79 +1,160 @@
-# 版本记录 · Changelog
-
-- **0.3.7 · 2026-10-24**：新增关闭、宽松、严格三档删除保护，默认宽松：提示优先使用可恢复的 `trash`，脚本中同样建议使用，用户明确要求时可用 `rm`；严格模式识别永久删除命令并逐次请求确认，官方预设另设开关且默认关闭。兼容旧布尔设置与 v4 日志。[删除保护](UsageGuide.md#删除保护--deletion-protection)
-  **0.3.7 · 2026-10-24**: Adds Off, Relaxed, and Strict deletion protection, defaulting to Relaxed: prefer recoverable `trash`, including in scripts, while honoring explicit `rm` requests. Strict mode recognizes permanent-deletion commands and requests per-call approval; official presets opt in separately. Supports legacy boolean settings and v4 journals. [Deletion protection](UsageGuide.md#删除保护--deletion-protection)
-
-  Super Code 侧栏新增只读任务状态并默认展开，从现有记录展示目标、步骤进度、动作和成功文件操作；Agent 名字只在任务根显示。任务、步骤、已加载动作全部展开，使用变高虚拟滚动，保留阅读位置、键盘导航和运行指示。保留原圆圈执行树与记忆库，三项互斥切换。任务状态不改提示词、模型请求、工具定义或执行行为；文件记录不等同完整 Git diff，缺失与截断明确提示。[任务状态](UsageGuide.md#任务状态--task-status)
-  Adds a read-only Task status section, open by default, showing recorded objectives, step counts, activity, and successful file operations. Agent names appear only at task roots. All loaded tasks, steps, and activity stay expanded in a variable-height virtual list with reading-position retention, keyboard navigation, and running indicators. Preserves the circular Agent graph and memory library with exclusive section switching. Task status changes no prompts, model requests, tool definitions, or execution behavior. File records are not a complete Git diff; missing or bounded data is labeled. [Task status](UsageGuide.md#任务状态--task-status)
-
-README 仅保留最近三个版本，完整记录见本页；[评测说明](EvaluationResults.md) 列出各组 DSH、插件与模型版本，以及 GLM 迁移和新版预算对照。
-
-README shows the three most recent releases; this page retains the full history. The [evaluation report](EvaluationResults.md) identifies DSH, plugin, and model versions, with GLM transfer and newer-host budget comparisons.
-
-- **0.3.6 · 2026-10-20**：排查发现新版 Harness 预算收紧后出现效果退化，因此增加插件内预算配置，并默认使用此前 Pro 测试中效果更好的旧预算，无需用户手动填写：按完整上下文窗口计算、80% 触发压缩、保留最近 16% 原文、摘要上限 8,192 Token，压缩追加尝试与溢出重试各 1 次，支持新版 PTC 的宿主默认执行时限和上限均为 600 秒。保留原有宿主默认值提示、用户自定义覆盖及运行中 Agent 的配置快照；旧宿主按能力禁用时限覆盖，始终遵守宿主时限上限。官方预设仍需手动开启应用。该修复不代表新增或改写历史评测成绩。[预算设置](UsageGuide.md#运行预算--runtime-budgets)
-  **0.3.6 · 2026-10-20**: Investigation found regressions after newer Harness versions reduced their budgets. Adds in-plugin budget settings and defaults to the older budgets that performed better in the Pro tests, without manual setup: full-context-window accounting, compression at 80%, 16% recent verbatim retention, an 8,192-token summary cap, one additional compression attempt and one overflow retry, and 600-second default/maximum deadlines on hosts with the newer PTC provider. Preserves host-default hints, user overrides, and running Agents' configuration snapshots. Older hosts disable unsupported deadline overrides, and host ceilings always apply. Official presets remain opt-in. This fix does not add or revise historical evaluation scores. [Budget settings](UsageGuide.md#运行预算--runtime-budgets)
-
-  设置页按“预设状态 / 上下文配置”分组，预算支持保存、恢复默认和并发编辑冲突检查；修复语言偏好尚未保存时提前重载导致语言回退的问题。完成 20 个 Web 版本、5 个官方 macOS arm64 Desktop 版本与 DSH NEXT 的兼容复验；[验证范围与限制](Compatibility.md)。
-  Groups settings into Preset status / Context settings, with budget saving, reset, and concurrent-edit conflict checks. Fixes language changes being lost when the page reloads before the host saves the preference. Revalidated 20 Web versions, five official macOS arm64 Desktop versions, and DSH NEXT; [coverage and limits](Compatibility.md).
-
-- **0.3.5 · 2026-10-18**：适配 Harness `0.2.1-rc.2`，修复 v4 日志迁移后旧任务记录不可见的问题，保留 `0.1.5-alpha.1` 起的兼容性，并补齐官方桌面安装说明。[验证范围](Compatibility.md)
-  **0.3.5 · 2026-10-18**: Supports Harness `0.2.1-rc.2`, restores legacy task records after v4 log migration, retains support from `0.1.5-alpha.1`, and clarifies official Desktop installation. [Validation coverage](Compatibility.md)
-
-- **0.3.4 · 2026-10-15**：补充官方预设在同一批 100 题上的成绩、用量与耗时核算说明；新增 README 致谢表格和[详细致谢文档](Acknowledgements.md)，说明宿主、界面设计、Skill、无障碍资料、评测项目与运行依赖的贡献和借鉴范围，并将文档纳入 npm 包。
-  **0.3.4 · 2026-10-15**: Adds official preset results on the same 100 tasks, with usage and timing methodology. Adds a README acknowledgements table and [detailed acknowledgements](Acknowledgements.md) covering the host, UI design, Skills, accessibility resources, evaluation projects, and runtime dependencies; includes the document in the npm package.
-
-- **0.3.3 · 2026-10-14**：执行树与记忆库合并为单个 Super Code 侧栏，默认展开执行区，两区互斥且始终保留一个展开；切换后保留树状态、筛选、搜索、阅读位置与草稿，记忆记录同页定位。记忆支持新增、编辑、取消、保存和确认删除，手动条目标明来源，只保留当前内容，失败保留输入并防止并发覆盖。保留圆形节点，增强运行环动画，修复节点光环、文字与连线重叠。内嵌按需加载的前端 Skill，覆盖布局对齐、操作舒适度、响应式、交互状态和浏览器验证；旧预设需要确认重装。整理双语安装、评测用途、版本规则及简短更新说明；[验证范围](Compatibility.md)。
-  **0.3.3 · 2026-10-14**: Combines the Agent tree and memory library in one Super Code sidebar, with the tree open by default and exactly one section expanded. Switching preserves tree state, filters, search, reading position, and drafts; memory activity links open in the same page. Adds memory creation, editing, cancellation, saving, and confirmed deletion. Manual entries are labeled; only current content is stored, failed writes preserve input, and concurrent changes are protected. Retains circular nodes, makes running animation clearer, and fixes halo, label, and connector overlap. Bundles an on-demand frontend Skill for alignment, comfortable controls, responsive layout, interaction states, and browser validation; existing presets require confirmed reinstallation. Clarifies bilingual installation, evaluation methodology, version rules, and concise update notes; [validation scope](Compatibility.md).
-
-- **0.3.2 · 2026-10-11**：统一预设设置、执行树和记忆库的视觉样式，保留圆形节点，紧凑工具栏显示“已收起”/“自动整理”名称；所有插件按钮使用上方名称气泡，历史时间/排序改为支持键盘操作的自定义下拉。Agent 详情按对话呈现用户消息、回复和可展开的真实工具调用/结果，兼容旧版与新版 journal，顶部额外信息按需展开。记忆库新增主题导航、筛选和同主题条目，精简中英文冗余文案。保留预设安装、版本提示、归属保护及重装备份；[验证范围](Compatibility.md)。
-  **0.3.2 · 2026-10-11**: Refreshes preset settings, the Agent tree, and memory library while retaining circular nodes. Compact actions have visible Collapsed/Organize labels; plugin buttons show name bubbles above, and history filters use keyboard-accessible custom dropdowns. Agent details show user/reply roles and expandable real tool calls/results from old and new journals, with additional header information folded. Adds memory topic navigation, filtering, and related entries, and trims redundant bilingual copy. Preserves installation, version notices, ownership protection, and reinstall backups; [validation scope](Compatibility.md).
-  修复新版侧栏聚焦导致下拉选项无法点击的问题；启动时等待宿主语言偏好加载，避免暂定浏览器语言触发预设重复同步与刷新。
-  Fixes dropdown options closing before selection when newer sidebars take focus. Startup waits for the host language preference, preventing provisional browser locales from repeatedly synchronizing presets and reloading the page.
-
-- **0.3.1 · 2026-10-10**：设置页始终展开，展示插件与当前预设的独立版本，提示不一致或未记录版本；声明式宿主新增安装、确认重装、改名、恢复备份及默认名称/描述语言同步。保留目录式安装、归属校验和自定义内容保护，允许新版宿主使用的 Cordis/Schemastery alpha 依赖。
-  **0.3.1 · 2026-10-10**: Keeps settings expanded and shows independent plugin/preset versions with mismatch or unrecorded-version notices. Adds installation, confirmed reinstallation, renaming, recovery backups and default display-language synchronization on declarative hosts. Retains directory installation, ownership checks and custom display-field protection, and accepts the Cordis/Schemastery alpha dependencies used by newer hosts.
-  修复原生桌面宿主管理 API 的解析位置，以及移除确认列表条目后 Escape 误关设置页的问题。逐版验证 15 个官方 Harness 版本（`0.1.5-alpha.1`～`0.2.1-alpha.2`）及可获取的四个 macOS arm64 Desktop 发行包；[验证范围与限制](Compatibility.md)。
-  Fixes native Desktop management API resolution and Escape closing Settings after removing a confirmation row. Verifies 15 official Harness versions (`0.1.5-alpha.1`–`0.2.1-alpha.2`) and four available macOS arm64 Desktop releases; [verification scope and limits](Compatibility.md).
-
-- **0.3.0 · 2026-10-09**：合入 Batch.3，用 Harness 原生 PTC 合并工具调用、并行独立读取，补齐批量调用中的 Agent 记忆使用记录，保留分层记忆及 0.2.1 的兼容适配，更新完整 100 题成绩和使用说明。
-  **0.3.0 · 2026-10-09**: Integrates Batch.3 with Harness-native PTC for composed tool calls and parallel independent reads, adds per-Agent memory activity for nested calls, retains layered memory and 0.2.1 compatibility updates, and refreshes the complete 100-task results and usage guide.
-
-- **0.2.1 · 2026-10-08**：逐版验证 Harness `0.2.0-rc.2` 与 `0.2.1-alpha.1`，扩展 peer 依赖范围，补齐根路径及 `/dsh`、`/super-code` 子路径的中英文展示资源，以适配新版插件元数据读取机制。安装、主/子 Agent、记忆、重启及 Safari 界面验收通过；alpha.1 原生 Desktop 尚未验收。[兼容范围与限制](Compatibility.md)
-  **0.2.1 · 2026-10-08**: Verifies Harness `0.2.0-rc.2` and `0.2.1-alpha.1` individually, extends peer ranges, and exports Chinese/English display resources for the root, `/dsh`, and `/super-code` entries to support the new plugin metadata reader. Installation, main/child Agents, memory, restart, and Safari checks passed; native Desktop alpha.1 remains unverified. [Compatibility scope and limitations](Compatibility.md)
-
-- **0.2.0 · 2026-09-30**：合入分层任务记忆，新增记忆库和每个 Agent 的记忆使用记录，tab 标题和界面文案跟随中英文切换，补齐 Harness 0.1.5-alpha.1 至 0.2.0-rc.2 的宿主兼容适配并完成官方 Desktop 原生窗口验收。
-  **0.2.0 · 2026-09-30**: Integrates hierarchical task memory, adds the memory library and per-Agent memory activity, keeps tab titles and interface labels in sync with the Chinese/English language setting, and adapts the host boundary from Harness 0.1.5-alpha.1 through 0.2.0-rc.2, including checks in the official Desktop native window.
-
-- **0.1.4**：适配 Harness 的目录与声明式预设机制：旧宿主保留目录安装，新宿主通过 bundle 声明 Super Code，设置页按宿主能力显示状态；声明式路径不提供目录副本安装、重命名、重装或名称语言同步。扩展 Harness peer 依赖范围，补齐中英文发布说明、使用指南及 npm 包内公开文档。`zod` 保留为运行时依赖，不内嵌其文件。
-  Adapts directory and declarative Harness presets: older hosts retain directory installation, while newer hosts use a Super Code bundle declaration and capability-specific status. The declarative path does not install, rename, reinstall, or synchronize localized names for directory copies. Expands Harness peer dependency ranges and includes bilingual release notes, usage guidance, and public documentation in the npm package. `zod` remains a runtime dependency without bundling its files.
-  已验证 `0.1.5-rc.3`、`0.1.6-alpha.1`、`0.1.6-alpha.2`、`0.1.7-alpha.1`、`0.1.7-alpha.2`、`0.1.7-rc.1`、`0.1.7-rc.2`；仅代表固定依赖的隔离 Web/CLI 与确定性模型冒烟，不代表原生 Desktop、外部模型、完整升级回归或新的 SWE-bench 成绩。[兼容范围与安装限制](Compatibility.md)
-  Verified `0.1.5-rc.3`, `0.1.6-alpha.1`, `0.1.6-alpha.2`, `0.1.7-alpha.1`, `0.1.7-alpha.2`, `0.1.7-rc.1`, and `0.1.7-rc.2` in pinned, isolated Web/CLI smoke checks using a deterministic model—not native Desktop, external models, complete upgrade regression, or new SWE-bench results. [Compatibility scope and installation limitations](Compatibility.md)
-- **0.1.3**：插件配置和预设的默认名称、描述跟随中英文语言设置；升级仅更新未被用户修改的字段。安装名称支持中文和空格。已安装副本可在确认清单后按新名称与标识符重装，旧目录保留恢复备份，并严格校验副本归属。[使用说明](UsageGuide.md)
-  Plugin settings and default preset names and descriptions follow the Chinese/English interface language; upgrades update only untouched fields. Installation names support Chinese characters and spaces. Owned copies can be reinstalled with a new name and identifier after confirmation, while the old directory is retained as a recovery backup. [Usage guide](UsageGuide.md)
-- **0.1.2**：优化按需专业指导、故障诊断与状态恢复验证，保留预设安装修复，最低支持 Harness 0.1.5-alpha.1。
-  Improves on-demand guidance, failure diagnosis, and state recovery checks; retains the preset installation fix and supports Harness 0.1.5-alpha.1 or later.
-- **0.1.1**：修复部分宿主安装后预设不可见的问题，新增可折叠的安装状态与自定义名称安装入口，兼容 Harness 0.1.5-rc.1。
-  Fixes presets missing on some hosts after installation and adds a collapsible status panel with custom-name installation; supports Harness 0.1.5-rc.1.
-- **0.1.0**：发布统一 Super Code 编码预设，提供多 Agent 执行树、任务记忆与用量展示。
-  Introduces the unified Super Code coding preset, with an Agent tree, task memory, and usage display.
-- **0.0.9**：包名改为 `dsh-super-code`，使用 Harness 原生任务记忆和按需专业指导，简化旧工作流并完善执行树状态。
-  Renames the package to `dsh-super-code`, adopts Harness-native task memory and on-demand specialist guidance, simplifies earlier workflows, and improves Agent tree state.
-
-更早版本以 `dsh-super-agent` 包名开发和发布；以下条目记录该项目的前身，不代表 `dsh-super-code` 曾以这些版本号发布。历史中没有 0.0.8 发布提交。
-
-Earlier versions were developed and released as `dsh-super-agent`. The entries below describe that predecessor, not releases of the `dsh-super-code` package. The repository history has no 0.0.8 release commit.
-
-- **0.0.7**：引入统一 Super Code 预设、Agent 执行图和精简任务上下文。
-  Introduces the unified Super Code preset, Agent graph, and compact task context.
-- **0.0.6**：完成统一预设的初版集成，改进编程任务规划与模型选择；Harness 包改为 peer dependencies。
-  Integrates the first unified preset, improves programming planning and model selection, and declares Harness packages as peer dependencies.
-- **0.0.5**：完成 Harness Web 适配、宿主界面集成和模型池路由，并让简单任务按需规划。
-  Completes Harness Web adaptation, host UI integration, and model-pool routing, with adaptive planning for straightforward tasks.
-- **0.0.4**：加入有界多轮任务上下文、验证失败修复提示与评测聚合，限制停滞修复和历史内存增长。
-  Adds bounded multi-turn task context, verifier repair hints, and evaluation aggregation, while limiting stalled repairs and history growth.
-- **0.0.3**：整理插件文档并采用 Apache-2.0 许可。
-  Refines plugin documentation and adopts the Apache-2.0 license.
-- **0.0.2**：补齐类型化任务和指标协议，建立初版评测工具。
-  Adds typed task and metric protocols and an initial evaluation tool.
-- **0.0.1**：提供场景预设及可安装的 DSH 插件包。
-  Provides scenario presets and an installable DSH plugin package.
+# 版本记录
+
+中文 · [English](en/Changelog.md)
+
+版本号格式为「主版本.效果版本.维护版本」。第二位变化表示编码效果或效率有提升；第三位表示修复、界面和兼容性更新。各版本的验证范围见[兼容性](Compatibility.md)。
+
+## 0.3.9 · 2026-10-28
+
+**界面**
+
+- 美化首页、预设、预算、删除保护和连接设置；预算自动保存，输入无效或保存失败时保留草稿并提示，可重试或恢复默认。
+- 侧栏任务更紧凑，工具调用按成功、失败和运行状态汇总，文件按项目相对路径显示；长列表继续使用虚拟滚动。
+- 任务、协作执行、记忆最多展开一项，默认任务，点击当前标题可全部收起。保留圆圈执行树、运行动画、顶部提示和旧版记忆的新增、编辑、取消、保存及删除。
+- 整理双语安装、使用及评测说明，更新 README 的设置、任务和执行树截图，并同步主干已有的历史评分复核记录，保留原始判分和校正依据。
+
+**MCP**（服务仍默认关闭）
+
+- 新增「允许 MCP 新增对话」（默认开启）；关闭时只能明确复用已有对话。新建对话归入已有工作区，未登记目录会创建同名工作区，标题以 `[MCP]` 开头。
+- 可查询并选择模型和思考强度，省略时沿用会话当前或默认选择；选择保留在会话中。
+- 新增 `dsh_status`、`dsh_models`、`dsh_read`、`dsh_approve`，支持容量诊断、公开对话分页读取及更明确的失败/恢复提示。修复历史子任务失败影响后续对话状态的问题。
+- 新增「允许调用方审批」（默认关闭）；开启后仅批准或拒绝精确的单次操作，无法处理时回到 DSH。新增目录仍须用户在 DSH 同意。
+- 修复 `run_code` 内子工具审批未转交 MCP 的问题：开启调用方审批后，按执行中的 Agent、调用 ID 和工具名匹配真实参数；批准仅对该次操作有效，拒绝或取消后清理请求，关闭开关时仍由 DSH 确认。
+- 改善忙碌、重试和断线处理；明确保留 requestId、等待空位与 DELETE 释放客户端会话。新增 `super-code-mcp` 命令行入口。
+
+只保留旧版记忆，不包含开发中的新版记忆、类型切换或迁移功能；普通对话的提示词和模型行为不变。本版未重新运行 100 题评测；历史评分复核不代表 0.3.9 的效果提升。验证范围见[兼容性记录](Compatibility.md)。
+
+## 0.3.8 · 2026-10-26
+
+**MCP 连接**（默认关闭）。[说明](UsageGuide.md#mcp-连接)
+
+- 在本机 `127.0.0.1` 上提供 Streamable HTTP MCP 服务，使用凭证认证。
+- 提供六个工具：`dsh_sessions`、`dsh_run`、`dsh_wait`、`dsh_send`、`dsh_cancel`、`dsh_request_directory`。外部客户端可委派 DSH 对话、查看进度、补充要求和取消任务。
+- 沿用宿主的模型、预设和权限；不修改普通会话的提示词，不自动批准权限。
+- 先通过 `dsh_sessions` 按目录查询最近对话和连接额度，由调用方明确选择复用或新建，不默认复用最新对话。
+- 最大连接数与任务并发上限保持一致，默认均为 3，并保留用户已保存的值。
+- 工作目录改为勾选列表，每次打开时刷新。外部申请新目录需在 DSH 弹窗中批准；撤销授权后无法通过复用绕过。
+- 请求具备幂等性；重启后任务标记为中断，不自动重发；输出有长度上限；附带 Git 工作区观察结果。
+
+**设置页**
+
+- 新增首页：显示预设状态和版本、删除保护等级、MCP 开关以及在线/历史对话数。
+- 客户端和关联会话详情移至「连接」页；删除保护单独成页；预设配置默认展开。
+- 连接设置自动保存，凭证默认展开显示。
+
+**修复**：读取工作区路径出错，导致有效目录显示「目录不可用」、无法启用连接。
+
+## 0.3.7 · 2026-10-24
+
+**删除保护**：提供关闭、宽松、严格三档，默认宽松。[说明](UsageGuide.md#删除保护)
+
+- 宽松：引导 Agent 默认使用可恢复的 `trash`，脚本中同样适用；用户明确要求时可使用 `rm`。
+- 严格：识别永久删除命令，每次执行前均需确认。
+- 官方预设另设开关，默认关闭。兼容旧的布尔配置和 v4 日志。
+
+**任务状态**：侧边栏新增只读的任务状态，默认展开。[说明](UsageGuide.md#任务)
+
+- 根据已有记录展示目标、步骤进度、操作和成功的文件改动。Agent 名称仅在任务根节点显示。
+- 内容全部展开，采用变高虚拟滚动；保留阅读位置、键盘导航和运行指示。
+- 保留原有的执行树和记忆库，三个部分互斥切换。
+- 不修改提示词、模型请求、工具定义或执行行为。文件记录不等同于完整的 Git diff，缺失和截断时会提示。
+
+## 0.3.6 · 2026-10-20
+
+新版 Harness 收紧预算后效果下降。插件新增预算配置，默认恢复此前 Pro 评测中效果更好的旧预算，无需手动填写。[说明](UsageGuide.md#运行预算)
+
+- 默认值：按完整上下文窗口计算，用量达到 80% 时触发压缩，保留最近 16% 的原文，摘要上限 8,192 token，压缩追加和溢出重试各 1 次；支持 PTC 时限配置的新版宿主，默认时限和上限均为 600 秒。
+- 用户自定义值优先；运行中的 Agent 保留原配置；旧宿主不支持的时限项会禁用；所有值均不超过宿主上限。
+- 官方预设仍需手动开启后才应用。
+- 设置页分为「预设状态」和「上下文配置」，支持保存、恢复默认和并发修改冲突检查。
+- 修复：语言偏好尚未保存时页面提前重载，导致语言回退。
+- 未新增或改写历史评测成绩。
+
+## 0.3.5 · 2026-10-18
+
+- 适配 Harness `0.2.1-rc.2`，最低仍支持 `0.1.5-alpha.1`。
+- 修复：v4 日志迁移后旧任务记录无法显示。
+- 补充官方桌面版安装说明。
+
+## 0.3.4 · 2026-10-15
+
+- 补充官方预设在同一批 100 题上的成绩，以及用量和耗时的统计方法。
+- 新增致谢表和[详细致谢](Acknowledgements.md)，并纳入 npm 包。
+
+## 0.3.3 · 2026-10-14
+
+- 执行树和记忆库合并为一个 Super Code 侧边栏，两部分互斥切换，切换后保留状态、筛选、搜索、阅读位置和草稿。
+- 记忆库支持新增、编辑、取消、保存和确认删除。手动条目标明来源，仅保留当前内容；保存失败时保留输入，并防止并发覆盖。
+- 运行动画更清晰；修复节点光环、文字和连线重叠的问题。
+- 内置按需加载的前端 Skill（对齐、操作舒适度、响应式、交互状态、浏览器验证）。旧预设需确认重装后才包含该 Skill。
+- 整理双语安装说明、评测用途和版本规则。
+
+## 0.3.2 · 2026-10-11
+
+- 统一预设设置、执行树和记忆库的视觉风格，保留圆形节点。工具栏显示「已收起」「自动整理」文字；按钮提示统一显示在上方；时间和排序改为支持键盘操作的下拉菜单。
+- Agent 详情按对话形式展示用户消息、回复和可展开的工具调用，兼容新旧日志。
+- 记忆库新增主题导航、筛选和同主题条目。
+- 修复：新版侧边栏抢占焦点导致下拉选项无法点击；启动时先等待宿主语言加载，避免预设反复同步、页面反复刷新。
+
+## 0.3.1 · 2026-10-10
+
+- 设置页始终展开，分别显示插件版本和预设版本，二者不一致或未记录时给出提示。
+- 声明式宿主支持安装、确认重装、改名、恢复备份和默认名称的语言同步。
+- 修复：桌面版管理接口解析位置错误；在确认框中移除条目后按 Esc 误关设置页。
+- 逐版验证 15 个 Harness 版本（`0.1.5-alpha.1` ~ `0.2.1-alpha.2`）和 4 个 macOS arm64 桌面版。
+
+## 0.3.0 · 2026-10-09
+
+- 使用 Harness 原生 PTC 合并工具调用、并行执行独立读取（Batch.3）。
+- 补充批量调用中的 Agent 记忆使用记录。
+- 更新完整的 100 题成绩和使用说明。
+
+## 0.2.1 · 2026-10-08
+
+- 适配 Harness `0.2.0-rc.2`、`0.2.1-alpha.1` 新的插件信息读取方式，补充中英文展示资源。
+- `0.2.1-alpha.1` 的原生桌面版未经验收。
+
+## 0.2.0 · 2026-09-30
+
+- 引入分层任务记忆；新增记忆库和每个 Agent 的记忆使用记录。
+- 界面跟随中英文设置切换。
+- 适配 Harness `0.1.5-alpha.1` ~ `0.2.0-rc.2`，官方桌面版通过验收。
+
+## 0.1.4
+
+- 适配两种预设机制：旧宿主采用目录安装，新宿主采用 bundle 声明；设置页按宿主能力显示。声明式路径暂不支持重命名、重装和名称语言同步。
+- 扩大 Harness 依赖范围，补充双语文档。
+- 已在 7 个版本（`0.1.5-rc.3` ~ `0.1.7-rc.2`）上完成隔离冒烟测试，不含原生桌面、外部模型和新评测成绩。
+
+## 0.1.3
+
+- 默认名称和描述跟随中英文设置，升级时仅修改用户未改动的字段。
+- 安装名称支持中文和空格；确认后可按新名称和标识符重装，旧目录保留为备份。
+
+## 0.1.2
+
+优化按需专业指导、故障诊断和状态恢复；最低支持 Harness `0.1.5-alpha.1`。
+
+## 0.1.1
+
+修复部分宿主安装后无法显示预设的问题；新增可折叠的安装状态和自定义名称安装；兼容 Harness `0.1.5-rc.1`。
+
+## 0.1.0
+
+发布统一的 Super Code 编码预设，包含多 Agent 执行树、任务记忆和用量展示。
+
+## 0.0.9
+
+包名改为 `dsh-super-code`；改用 Harness 原生任务记忆和按需专业指导。
+
+## 更早版本（`dsh-super-agent`）
+
+以下为前身 `dsh-super-agent` 的版本，`dsh-super-code` 未发布过这些版本号。历史中没有 0.0.8。
+
+- **0.0.7**：统一 Super Code 预设、Agent 执行图、精简任务上下文。
+- **0.0.6**：统一预设初版；改进规划和模型选择；Harness 包改为 peer 依赖。
+- **0.0.5**：适配 Harness Web、宿主界面集成、模型池路由；简单任务按需规划。
+- **0.0.4**：有上限的多轮任务上下文、验证失败修复提示、评测汇总。
+- **0.0.3**：整理文档，采用 Apache-2.0。
+- **0.0.2**：类型化任务和指标协议，初版评测工具。
+- **0.0.1**：场景预设和可安装的插件包。