@godv61/dsh-task-engine 0.23.7 → 0.23.9

package/.preset-test.mjs

@@ -26,7 +26,7 @@ import { derivedEngComposition, wasSeeded, applyPersona, personaFieldOf } from '
  * The live derivation resolves `@deepseek-ai/dsh-agent-presets`, a PEER the
  * running harness provides. In a consumer's install it may be absent or a
  * different version, so the assertions that read a real `standard` skip when it
- * is unavailable rather than failing �?the fixture-driven cases below cover the
+ * is unavailable rather than failing —the fixture-driven cases below cover the
  * logic itself and always run.
  */
 const derived = derivedEngComposition()
@@ -48,7 +48,7 @@ test('the engineering persona replaces the shipped one', live, () => {
 
 test('the derived persona row is well formed and never sets complete', live, () => {
   // Which field is correct depends on the running harness, so assert the SHAPE
-  // (a block scalar under `config:`) rather than one field name �?the field
+  // (a block scalar under `config:`) rather than one field name —the field
   // itself is pinned by the two fixtures below.
   assert.match(derived.text, /- id: persona\n {2}name: '@deepseek-ai\/dsh-persona'\n {2}config:\n(?: {4}suffix: .*\n)? {4}(?:text|prefix): [|>]-/u,
     'the persona row must carry a block scalar under config')

package/README.md

@@ -10,6 +10,7 @@
 <p align="center">
   <a href="https://www.npmjs.com/package/@godv61/dsh-task-engine"><img src="https://img.shields.io/npm/v/%40godv61%2Fdsh-task-engine?style=flat-square&amp;color=238636" alt="npm version" /></a>
   <a href="https://github.com/godv61/dsh-task-engine/actions/workflows/verify.yml"><img src="https://github.com/godv61/dsh-task-engine/actions/workflows/verify.yml/badge.svg" alt="Package verification CI" /></a>
+  <a href="https://awesome-dsh-plugin.com"><img src="https://awesome-dsh-plugin.com/badge.svg" alt="Awesome DSH Plugin" /></a>
   <a href="LICENSE"><img src="https://img.shields.io/badge/license-MIT-64748b?style=flat-square" alt="MIT license" /></a>
 </p>
 
@@ -65,7 +66,7 @@ dsh plugin --profile web add @godv61/dsh-task-engine
 | **敏捷轻量** `agile` | 需求 → 开发 → 交付 → 审查 | 希望保留任务记录、减少阶段和产物的迭代。 |
 | **纯代码** `minimal` | 开发 → 交付 | 已明确做法的小改动。 |
 
-当前版本的阶段顺序和检查条件由预设固定，默认技能/规则绑定只能追加。**可视化自定义流程正在规划，尚未发布**，具体范围见[功能规划](docs/roadmap.md)。
+当前版本的阶段顺序和检查条件由预设固定，默认技能/规则绑定只能追加。**可视化自定义流程不在计划内**——它把流程设计的负担转嫁给使用者，而三个内置流程已覆盖个人项目的常见需要，详见[功能规划](docs/roadmap.md)。
 
 ## 把自己的技能和规则带进来
 
@@ -90,7 +91,7 @@ dsh plugin --profile web add @godv61/dsh-task-engine
 | 完整操作说明 | [HTML 手册](docs/manual.html)（下载后在浏览器打开） |
 | 当前能力与常见问题 | [常见问题](docs/faq.md) |
 | 本地开发与验证 | [开发指南](docs/development.md) |
-| 真实项目回归修复 | [0.23.1 发布说明](docs/release-0.23.1.md) · [回归迭代说明](docs/workflow-regression.md) |
+| 真实项目回归修复 | [0.23.1 发布说明](docs/releases/0.23.1.md) · [回归迭代说明](docs/workflow-regression.md) |
 | 版本变化与验证记录 | [更新日志](docs/CHANGELOG.md) · [0.23.1 测试说明](docs/testing/0.23.1/测试报告.md) |
 
 ## 能力说明
@@ -101,9 +102,9 @@ dsh plugin --profile web add @godv61/dsh-task-engine
 
 小修正允许主代理处理，仍须审核和验证。遇到沙箱权限拒绝应使用宿主审批或报告阻塞，不能靠反复切换命令规避。
 
-状态查询会列出过期验证和附加技能回执；`commit.allowed` 同时检查这些阻塞，文件变化后先补验证再申请提交。
-
-验证命令的单次权限重试先审批后执行，不改变会话权限；操作方式见[验证权限说明](docs/faq.md#验证命令被沙箱阻止怎么办)。
+状态查询会列出过期验证和附加技能回执；`commit.allowed` 同时检查这些阻塞，文件变化后先补验证再申请提交。
+
+验证命令的单次权限重试先审批后执行，不改变会话权限；操作方式见[验证权限说明](docs/faq.md#验证命令被沙箱阻止怎么办)。
 
 记录需求、方案或评审前，模型可从 `artifact_requirements` 获取当前阶段允许的字段和缺项，避免猜测字段名。
 

package/docs/CHANGELOG.md

@@ -4,6 +4,32 @@
 
 按版本查阅功能变化。当前使用方式以[项目首页](../README.md)和使用指南为准；历史条目中的实现方式、限制与测试数量可能已被后续版本替代。
 
+## 0.23.9
+
+- **工作台的阶段绑定改为可搜索的选择器**。此前技能和规则各是一串可点击的胶囊标签：没有搜索、没有筛选、没有计数，列表也没有滚动容器，资源一多就把页面撑得很长。现在每类资源各有一个选择器：
+  - 技能与规则**各自独立搜索**，另有「仅看已选」筛选。
+  - 显示**已选/总数**、每项的资源来源，空态区分「尚未安装」和「没有匹配项」。
+  - 列表在 280px 内**就地滚动**，不再随目录增长而拉伸页面。
+  - **预设默认绑定保持勾选且不可取消**，与引擎的追加式覆盖语义一致——界面不会表达一个引擎会忽略的移除。
+  - 目录中找不到的绑定**仍然可见**并标注为未找到；目录加载失败不能静默隐藏已有选择。
+  - 切换阶段时**重置筛选但不改动绑定**。
+- 顺带删除重复的只读流程节点列表和每个预设的说明文字——选择器已经展示了这些信息。
+- **修复客户端 source map 内联源码**。`lib/client.js.map` 此前带有 `sourcesContent`，把整棵 `src/client` 源码原样以 `lib/` 名义打进包里（447 KB）；基于路径的「tarball excludes src sources」检查因此形同虚设。改为只保留行映射后为 148 KB，并补上**按内容而非按文件名**断言的检查，防止退回。
+- **修复 10 处 UTF-8 字节损坏**。四处文件里出现了「被截断的 UTF-8 首字节 + `?`」的序列——工具链某处把无法编码的字符替换掉了而没有报错，因此评审从未看到。最严重的一处在**预设名内部**：`工程化开发引擎` 的「擎」是 `E6 93 3F` 而非 `E6 93 8D`，而这正是预设选择器渲染的文字。其余为破折号和一个箭头。全部修复后，仓库现以严格的 UTF-8 解码器验证通过——此前用容错解码读取，正是它掩盖了这个问题。
+
+## 0.23.8
+
+- **更正文档中与代码不符的陈述**，不改动任何运行时行为：
+  - 可视化自定义流程在五个位置（`roadmap.md`、`faq.md`、`configuration.md`、项目首页、HTML 手册）被描述为“规划中/尚未发布”，但它**不在计划内**——它把流程设计的负担转嫁给使用者，而三个内置流程已覆盖个人项目的常见需要；`main` 上不存在该能力的实现。现改为明确说明不实现的理由。
+  - `development.md` 曾称“已存在的 eng 预设不会被自动覆盖”。该行为自 0.23.6 起已改变：预设**每次启动都从运行中 harness 的 `standard` 重新派生**，判断依据是文件里有没有本插件的 agent 行——插件生成的会被更新，手工编辑过的原样保留。`enable` 脚本仍直接拒绝覆盖，这是旧表述显得合理的原因。
+  - `getting-started.md` 的安装命令写死 `@0.23.0`（落后七个版本），改为安装 `latest` 并说明如何主动固定版本。
+  - 描述**当前**行为的 FAQ 条目以引入版本号开头（如“0.23.1 …”），读起来像历史而非当前行为，已去掉版本前缀。
+  - `roadmap.md` 的“当前 npm 版本为 0.23.0”与 `manual.html` 页脚的“0.23.2-rc.1”改为指向更新日志。
+- 文档目录重组：发布说明移入 `docs/releases/`，文档索引拆为“开始使用 / 参与开发 / 历史记录”三段。**没有删除任何文件**——旧的发布说明与测试报告是被更新日志引用的逐版本快照，且带有各自的范围声明（例如 0.23.1 报告写明“不等同业务项目端到端验收”），保留它们才能追溯当时的验证边界。
+- 更正 0.23.7 条目的一处描述错误：文中说旧格式产出 `text: |-`，实际**沿用源预设的 `>-`（折叠标量）**。所有随包发布的 `standard` 都使用 `>-`，而 0.23.7 的实现是照写源的标量风格——`>-` 会把正文内的单个换行折叠为空格，与 `|-` 语义不同，因此这条描述当时会误导读者。
+
+> 本版仅文档变更，`src/`、`package.json` 与测试均未改动；功能行为与 0.23.7 完全一致。
+
 ## 0.23.7
 
 - **修复 persona 字段在旧版 DSH 上不兼容**。`@deepseek-ai/dsh-persona` 在提交 `40792330c0`（2026-09-06，首次随 `dsh-v0.1.3-alpha.2` 发布）把配置字段从 `text` 改名为 `prefix`/`suffix`，两个 schema 互斥：写 `prefix` 的预设会被旧版 persona 插件以 `$.text missing required value` 整份拒绝，反之亦然。0.23.6 的派生逻辑**硬编码了 `prefix`**，因此在 `dsh-v0.1.3-alpha.1` 及更早的 harness 上，`eng` 预设挂载失败、新会话无法创建。现在改为**读取源预设自己使用的字段**再照写——`standard` 就是运行中 harness 的格式权威。已用两个版本的真实 `standard` 验证：`v0.1.3-alpha.1` 产出 `text: |-`，`v0.1.6-alpha.2` 产出 `suffix` + `prefix: |-`，两者 YAML 均解析通过。
@@ -41,14 +67,14 @@
 - 修复 verify / skill_result 先执行命令后审批、批准权限未传入 shell 的问题；拒绝、取消或审批不可用时不执行命令。
 - 审批显示实际验证命令；批准模式只用于本次命令和回执写入，不改变会话策略，也不重复申请保存回执的审批。
 - 修正提交规则与手册中的模块名示例，第一段使用当前任务 id，第二段使用 status 的 commit.label；自定义格式以任务冻结流程为准。
-- dshtest 首轮在 0.23.1 复现权限问题；修复后连续两轮完整开发、验证、审核、本地提交及归档回退通过。专项覆盖审批拒绝、原命令批准执行、证据过期和单次权限恢复，详见[发布说明](release-0.23.2.md)与[测试报告](testing/0.23.2/测试报告.md)。
+- dshtest 首轮在 0.23.1 复现权限问题；修复后连续两轮完整开发、验证、审核、本地提交及归档回退通过。专项覆盖审批拒绝、原命令批准执行、证据过期和单次权限恢复，详见[发布说明](releases/0.23.2.md)与[测试报告](testing/0.23.2/测试报告.md)。
 
 ## 0.23.1
 
 - 汇总本轮候选版的资源来源、Windows 技能加载、实施审核保留、派工状态、真实技能/验证/提交回执及状态一致性修复。
 - 新增 status.artifact_requirements，提前披露当前阶段的记录字段和缺项；未知字段拒绝时给出恢复指引，整次写入保持不变。
 - 需求技能按预设实际字段记录，修正敏捷流程误用标准字段的问题；小修正、权限恢复、契约核对和测试证据说明同步更新。
-- 旧任务保留冻结流程，新任务使用标准 v2 和执行证据门禁。实际能力及未覆盖边界见[发布说明](release-0.23.1.md)与[测试说明](testing/0.23.1/测试报告.md)。
+- 旧任务保留冻结流程，新任务使用标准 v2 和执行证据门禁。实际能力及未覆盖边界见[发布说明](releases/0.23.1.md)与[测试说明](testing/0.23.1/测试报告.md)。
 
 以下 rc 条目为本轮迭代历史，已汇总至 0.23.1；“尚未发布”描述的是当时状态。
 
@@ -93,7 +119,7 @@
 - 加强导入校验与失败清理，修复任务并发写入的版本读取次序。
 - 优先使用 Harness 已注册的工作区，补充发布包行为测试和 Node 22/24 CI。
 
-[完整发布说明](release-0.23.0.md) · [测试报告](testing/0.23.0/测试报告.md)
+[完整发布说明](releases/0.23.0.md) · [测试报告](testing/0.23.0/测试报告.md)
 
 ## 早期版本
 

package/docs/README.md

@@ -1,29 +1,41 @@
-# 使用文档
-
-[← 返回项目首页](../README.md)
-
-DSH Task Engine 是 DeepSeek Harness 的个人工程流程工作台。先完成安装，再按需要配置流程、技能和规则。
-
-## 开始使用
-
-| 文档 | 内容 |
-| :--- | :--- |
-| [安装与启用](getting-started.md) | 安装到 Web profile、启用工程会话、确认安装结果。 |
-| [流程配置](configuration.md) | 三个内置流程、阶段绑定、配置文件与任务快照。 |
-| [技能与规则安装](resource-install.md) | 系统文件选择、安装预览、项目/个人范围和格式要求。 |
-| [常见问题](faq.md) | 预设区别、资源使用、项目目录与能力限制。 |
-| [完整 HTML 手册](manual.html) | 详细操作、工具说明与任务走查；下载后在浏览器中打开。 |
-
-## 参与开发
-
-| 文档 | 内容 |
-| :--- | :--- |
-| [开发指南](development.md) | 构建、测试、包结构与可选 host 接入。 |
-| [功能规划](roadmap.md) | 自定义流程的提案范围，区分已发布功能与规划。 |
-| [更新日志](CHANGELOG.md) | 按版本查阅变化。 |
-| [0.23.2 发布说明](release-0.23.2.md) | 验证命令单次审批修复、提交指引与管控边界。 |
-| [0.23.2 测试报告](testing/0.23.2/测试报告.md) | 两轮完整开发、归档回退与门禁专项的实际结果。 |
-| [0.23.1 发布说明](release-0.23.1.md) | 真实项目发现的问题、修复及能力边界。 |
-| [0.23.1 测试说明](testing/0.23.1/测试报告.md) | 自动化、安装包与实机证据的适用范围。 |
-| [0.23.0 发布说明](release-0.23.0.md) | 前一版安装交互及界面调整。 |
-| [插件收录材料](listing/submission.md) | Awesome DSH Plugin 的提交条件与条目草稿。 |
+# 使用文档
+
+[← 返回项目首页](../README.md)
+
+DSH Task Engine 是 DeepSeek Harness 的个人工程流程工作台。先完成安装，再按需要配置流程、技能和规则。
+
+## 开始使用
+
+| 文档 | 内容 |
+| :--- | :--- |
+| [安装与启用](getting-started.md) | 安装到 Web profile、启用工程会话、确认安装结果。 |
+| [流程配置](configuration.md) | 三个内置流程、阶段绑定、配置文件与任务快照。 |
+| [技能与规则安装](resource-install.md) | 系统文件选择、安装预览、项目/个人范围和格式要求。 |
+| [常见问题](faq.md) | 预设区别、资源使用、项目目录与能力限制。 |
+| [完整 HTML 手册](manual.html) | 详细操作、工具说明与任务走查；下载后在浏览器中打开。 |
+
+## 参与开发
+
+| 文档 | 内容 |
+| :--- | :--- |
+| [开发指南](development.md) | 构建、测试、包结构与可选 host 接入。 |
+| [功能规划](roadmap.md) | 已发布能力与规划中的范围。 |
+| [更新日志](CHANGELOG.md) | 按版本查阅变化；**这是版本信息的唯一权威来源**。 |
+| [插件收录材料](listing/submission.md) | Awesome DSH Plugin 的提交条件、条目内容与收录结果。 |
+
+## 历史记录
+
+以下文档是**各自版本当时的快照**，用于追溯当时的验证范围与已知边界。其中的测试数量、
+实现细节和界面描述可能已被后续版本替代——当前行为以「开始使用」和[更新日志](CHANGELOG.md)为准。
+
+| 文档 | 内容 |
+| :--- | :--- |
+| [0.23.2 验证记录](testing/0.23.2/测试报告.md) | 两轮完整开发、归档回退与门禁专项的实际结果。 |
+| [0.23.2 发布说明](releases/0.23.2.md) | 验证命令单次审批修复、提交指引与管控边界。 |
+| [0.23.1 验证记录](testing/0.23.1/测试报告.md) | 自动化、安装包与实机证据的适用范围。 |
+| [0.23.1 发布说明](releases/0.23.1.md) | 真实项目发现的问题、修复及能力边界。 |
+| [0.23.1 回归迭代说明](workflow-regression.md) | 真实项目逐轮问题的处理记录。 |
+| [0.23.0 验证记录](testing/0.23.0/测试报告.md) | 资源导入、工作台交互与包入口的验证。 |
+| [0.23.0 发布说明](releases/0.23.0.md) | 早期安装交互及界面调整。 |
+
+> 0.23.3 起的版本变化全部记录在[更新日志](CHANGELOG.md)中，不再单独出具发布说明。

package/docs/configuration.md

@@ -38,7 +38,7 @@
 
 阶段顺序、转移条件、产物必填字段和提交策略由所选预设固定。新建规则可以提供工作指引，但不会改变引擎中的提交消息校验或阶段条件。
 
-可视化自定义流程的范围见[功能规划](roadmap.md)，目前尚未发布。
+可视化自定义流程**不在计划内**：它把流程设计的负担转嫁给使用者，而三个内置流程已覆盖个人项目的常见需要。详见[功能规划](roadmap.md)。
 
 ## 配置与正在进行的任务
 

package/docs/development.md

@@ -18,7 +18,7 @@ npm run verify:package
 
 `build` 生成 host、浏览器客户端与提交钩子；`typecheck` 检查 host 和 client 两个编译面。`verify:package` 将 tarball 安装到干净临时项目，检查包入口、客户端注册、包内测试和 CLI 语法。
 
-CI 在 Windows 的 Node 22/24 上运行。具体用例与限制见[测试报告](testing/0.23.0/测试报告.md)；每次功能修改选择相关验证，文档排版调整只需要文档、链接和渲染检查。
+CI 在 Windows 的 Node 22/24 上运行。每次功能修改选择相关验证；文档排版调整只需要文档、链接和渲染检查。测试数量随版本变化，当前值以本地 `npm test` 与 `npm run verify:package` 的输出为准，不在此处固定。
 
 ## 代码导航
 
@@ -44,10 +44,10 @@ Host 入口挂载工作台控制器，并在 eng 预设不存在时生成“工
   name: '@godv61/dsh-task-engine/agent'
 ```
 
-已存在的 eng 预设不会被自动覆盖。手工调整前先备份；配套的 enable 脚本也会拒绝覆盖已存在的预设。
+eng 预设由插件在每次启动时**从当前 Harness 的 `standard` 预设重新派生**，因此 Harness 升级后预设会跟着更新。判断依据是文件里是否带有本插件写入的 agent 行：**插件自己生成的会被更新，手工编辑过的原样保留**。配套的 `enable` 脚本行为更保守——目标已存在时直接拒绝，不覆盖。
 
 ## 可选 host 接入
 
-0.23.0 优先使用 Harness 的 `workspaceRegistry.resolveByPath` 获取已登记工作区。旧 host 可以通过插件导出的 `registerWorkspace` 和 `enableStrictWorkspaces` 配置注册目录及严格模式，接口定义见 [src/controller.ts](../src/controller.ts)。注册范围不等于会话身份鉴权；个人本机使用不要求为此改造 Harness。
+Host 入口优先使用 Harness 的 `workspaceRegistry.resolveByPath` 获取已登记工作区。旧 host 可以通过插件导出的 `registerWorkspace` 和 `enableStrictWorkspaces` 配置注册目录及严格模式，接口定义见 [src/controller.ts](../src/controller.ts)。注册范围不等于会话身份鉴权；个人本机使用不要求为此改造 Harness。
 
 发布前保持 README、使用手册和实际代码一致；不要将规划中的功能描述为已经可用。

package/docs/faq.md

@@ -12,7 +12,7 @@
 
 ## 能自己增删流程阶段吗？
 
-0.23.0 支持选择三个内置流程和追加阶段资源，不支持自由修改阶段。复制预设、编辑阶段与条件、导入导出已列入[自定义流程方案](roadmap.md)，尚未实现。
+不支持，且**不打算支持**。可以选择三个内置流程（`standard`、`agile`、`minimal`）并为阶段追加资源，但阶段与条件本身固定。让使用者自行设计流程会把流程设计的负担转嫁给使用者，而内置流程已覆盖个人项目的常见需要。详见[功能规划](roadmap.md)。
 
 ## 安装资源后就会自动使用吗？
 
@@ -24,17 +24,17 @@
 
 ## 能移除默认技能、覆盖内置规则吗？
 
-当前预设绑定只能追加，内置资源只读且同名优先。需要自建资源时使用新名称。自定义流程方案会提供自由配置绑定的能力。
+预设绑定只能追加，内置资源只读且同名优先。需要自建资源时使用新名称；同名资源会同时保留在各自来源，绑定选择按名称去重。
 
 ## 工具显示验证或审核通过，能完全相信吗？
 
-0.23.1 新建任务的验证需要真实命令回执，要求退出码为 0 且未超时、中止或被沙箱拒绝；代码修改后需重验。旧任务保持原验证约定。附加技能记录加载、命令和场景证据；审核和实施项结论仍由模型记录。命令覆盖是否充分、审核是否准确仍需判断，不能把一个成功退出码当作全部需求已验证。
+新建任务的验证需要真实命令回执，要求退出码为 0 且未超时、中止或被沙箱拒绝；代码修改后需重验。附加技能记录加载、命令和场景证据；审核和实施项结论仍由模型记录。命令覆盖是否充分、审核是否准确仍需判断，不能把一个成功退出码当作全部需求已验证。
 
-## 验证命令被沙箱阻止怎么办？
-
-`verify` 和 `skill_result` 默认使用会话沙箱策略。原命令因权限受阻时，可携带 `sandbox_permissions: "danger-full-access"` 与 `justification` 申请单次重试；审批显示实际命令，批准后才执行，不改变后续调用的会话权限。拒绝、取消或缺少审批服务均不运行命令、不写入回执。不要用另一条简单命令替代原验收。详见验证技能说明。
-
-## 本地提交钩子有什么作用？
+## 验证命令被沙箱阻止怎么办？
+
+`verify` 和 `skill_result` 默认使用会话沙箱策略。原命令因权限受阻时，可携带 `sandbox_permissions: "danger-full-access"` 与 `justification` 申请单次重试；审批显示实际命令，批准后才执行，不改变后续调用的会话权限。拒绝、取消或缺少审批服务均不运行命令、不写入回执。不要用另一条简单命令替代原验收。详见验证技能说明。
+
+## 本地提交钩子有什么作用？
 
 它在普通 git commit 时检查任务、阶段、消息和文件范围。`--no-verify`、替换 hooksPath 或直接修改本地数据仍可能绕过检查；项目需要更强的提交约束时，应结合自己的 CI 和人工审核。
 

package/docs/getting-started.md

@@ -15,10 +15,12 @@ dsh plugin --profile web add @godv61/dsh-task-engine
 如果你正在 Harness 源码目录开发，使用：
 
 ```sh
-pnpm dsh plugin --profile web add @godv61/dsh-task-engine@0.23.0
+pnpm dsh plugin --profile web add @godv61/dsh-task-engine
 pnpm dsh web --no-open
 ```
 
+不写版本号会安装 npm 上的 `latest`；需要固定版本时再追加 `@<版本>`。
+
 已有 Web 进程时，先关闭该进程再启动，避免端口冲突。通过 `dsh plugin` 安装会将插件加入对应 profile；仅在任意目录执行 `npm install` 不会完成工作台挂载。
 
 ## 2. 检查安装结果

package/docs/listing/godv61__dsh-task-engine.yml

@@ -1,6 +1,6 @@
-url: https://github.com/godv61/dsh-task-engine
-name: godv61/dsh-task-engine
-category: workflow
-description:
-  en: Preset engineering workflows with stage checks, task records, commit validation, and a skill and rule workbench for DeepSeek Harness.
-  zh: 为 DeepSeek Harness 提供预设工程流程、阶段检查、任务记录、提交校验和技能规则工作台。
+url: https://github.com/godv61/dsh-task-engine
+name: godv61/dsh-task-engine
+category: workflow
+description:
+  en: 'Preset engineering workflows for DeepSeek Harness: a dev_task tool that gates stage transitions, artifacts, verification, review and commit scope, plus a web workbench for installing project or user skills and rules.'
+  zh: '为 DeepSeek Harness 提供预设工程流程：dev_task 工具把阶段流转、产物、验证、审核与提交范围做成硬门禁，并带一个安装项目级与个人级技能和规则的工作台。'

package/docs/listing/submission.md

@@ -1,9 +1,84 @@
-# 插件收录申请
-
-目标：[awesome-dsh-plugin](https://github.com/awesome-dsh-plugin/awesome-dsh-plugin)。按[贡献指南](https://github.com/awesome-dsh-plugin/awesome-dsh-plugin/blob/main/contributing.md)，PR 只新增 `data/plugins/godv61__dsh-task-engine.yml`，内容复制本目录同名 YAML。标题：`Add godv61/dsh-task-engine`。
-
-PR 正文：
-
-> Adds godv61/dsh-task-engine under workflow. The plugin provides preset engineering workflows, stage checks, task records, commit validation, and a web workbench for skills and rules. The repository includes source code, a dsh.bundle manifest, installation documentation, and package verification tests. npm metadata points back to the same repository.
-
-提交前确认公开源码已推送、topic 为 `dsh-plugin`、仓库创建满 24 小时。GitHub API 的 created_at 为 2026-09-15 08:10:50 UTC，即北京时间 2026-09-15 16:10:50；最早在北京时间 2026-09-16 16:10:50 满 24 小时。npm 关联自动读取 package.json repository，YAML 不添加 npm 字段。截图为推荐项，不是必填。
+# 插件收录申请
+
+**已收录：** [PR #5681](https://github.com/awesome-dsh-plugin/awesome-dsh-plugin/pull/5681)
+于 2026-09-22 15:45:57 UTC 被维护者 `fkysly` 合并，**无修改要求**（0 条评审评论）。
+条目已在列表的 `main` 上，中英两个 README 均已生成对应行。
+
+提交时 `check`（7m40s）与 `Submission gate` 两项 CI 全部通过。PR 只新增
+`data/plugins/godv61__dsh-task-engine.yml`（+6 行），未触碰生成出来的 README。
+
+条目页：[awesome-dsh-plugin.com](https://awesome-dsh-plugin.com)
+
+目标：[awesome-dsh-plugin](https://github.com/awesome-dsh-plugin/awesome-dsh-plugin)。
+
+## 提交内容
+
+按[贡献指南](https://github.com/awesome-dsh-plugin/awesome-dsh-plugin/blob/main/contributing.md)，
+PR **只新增一个文件**：`data/plugins/godv61__dsh-task-engine.yml`，内容复制本目录同名 YAML。
+
+**标题：** `Add godv61/dsh-task-engine`
+
+**分类：** `workflow` —— 插件本身提供工程流程预设与阶段门禁，分类与实际行为一致。
+
+> 注意：`data/plugins/` 下的条目文件是数据源，仓库根的两个 README 由脚本生成。
+> **不要手工编辑 README**，也不要往 `data/screenshots.json` 加键（新约定是插件仓库自己放 `screenshots.json`）。
+
+## PR 正文
+
+> Adds `godv61/dsh-task-engine` under `workflow`.
+>
+> The plugin adds a `dev_task` tool that holds an engineering state machine: three preset flows
+> (`standard`, `agile`, `minimal`) with transitions gated on human confirmation, artifact
+> completeness, implementation items, real verification receipts, and review outcome — plus a
+> commit gate that checks stage, message format and file scope. A web workbench installs project- or
+> user-level skills and rules, binds them to individual stages, and shows the task ledger.
+>
+> Repository includes source, a `dsh.bundle` manifest with `cordis.patch.yml`, user documentation,
+> and a test suite (146 P0 assertions, 52 `node:test` cases including an end-to-end commit-hook
+> suite). Published on npm; `repository` points back at this repo.
+
+## 提交前的自查（对照指南逐条）
+
+| 指南要求 | 本仓库状态 |
+| :--- | :--- |
+| `package.json` 声明 `dsh.bundle` | ✅ `"bundle": { "patch": "./cordis.patch.yml" }` |
+| 仓库根有 `cordis.patch.yml` | ✅ |
+| 真实可用代码（非占位/纯 README） | ✅ host 与 client 两个面均已实现并有测试 |
+| 仓库创建满 1 天 | ✅ 创建于 2026-09-15 08:10:50 UTC |
+| 已有 `dsh-plugin` topic | ✅ |
+| 活跃维护 | ✅ |
+| `repository` 指回本仓库 | ✅ `git+https://github.com/godv61/dsh-task-engine.git` |
+| npm 包 `repository` 回指同一仓库 | ✅ |
+| 非纯聚合包（自带行为） | ✅ 自带 `dev_task` 工具与工作台 UI |
+| 描述不含 `: `（冒号+空格） | ✅ 已加引号 |
+| 官方包用 `peerDependencies` | ✅ `@deepseek-ai/dsh-*` 均在 peer 中 |
+| peer 范围带显式预发布分支 | ✅ `^0.1.2-rc.1 \|\| ^0.1.3-alpha.1 \|\| ^0.1.6-alpha.2 \|\| ^0.1.7-alpha.1` |
+
+**关于 peer 范围**：指南特别警告过「不带显式预发布分支的范围会静默排除 harness 的预发布构建」。
+本插件用的是显式 `||` 分支形式，正是指南推荐写法。
+
+## 描述准确性
+
+指南说明描述会被**当作对代码的声明并逐句核对**，因此上面那行只写了可验证的事实：
+
+| 描述中的说法 | 代码依据 |
+| :--- | :--- |
+| `dev_task` 工具 | `src/dev-task.ts` 的 `defineTool` |
+| 阶段流转门禁 | `src/engine.ts` 的 `assertAdvance` / `legalTargets` |
+| 产物门禁 | guard `artifacts_present` + `ArtifactDef` |
+| 验证门禁 | guard `verified` + 真实命令回执 |
+| 审核门禁 | guard `review_passed` |
+| 提交范围校验 | `checkFileScope` + `hooks/commit-msg` |
+| 三个预设流程 | `FLOW_OPTIONS`：`standard` / `agile` / `minimal` |
+| 工作台安装技能与规则 | `src/client/` 的 `ResourceManager` 等 |
+
+**描述里刻意不写具体数字**（如「7 个技能、3 条规则」）：这类数字会随版本变化，
+写死反而容易变成不准确声明。
+
+## 备注
+
+本目录此前一份材料提到「仓库创建满 24 小时」与手工核对 `created_at`。指南现已说明
+**该门槛由 CI 自动检查**，无需在 PR 里论证，故此处不再展开。
+
+截图可选：可在本仓库根放 `screenshots.json` 声明，市场会自动读取，无需在本列表仓库提交图片。
+当前未声明，市场会从 README 自动抽取。

package/docs/manual.html

@@ -193,7 +193,7 @@ pnpm install &amp;&amp; pnpm run build &amp;&amp; pnpm dsh web</code></pre>
       </section>
 
       <section id="configure">
-        <p>当前版本支持三个内置流程及追加阶段资源。可视化自定义流程处于规划阶段，尚未发布。</p>
+        <p>当前版本支持三个内置流程及追加阶段资源。可视化自定义流程曾列入评估，结论是不实现：它把流程设计的负担转嫁给使用者，而三个内置流程已覆盖个人项目的常见需要。</p>
         <h2>7. 配置流程与挂载</h2>
         <p>侧边栏点「工程流程」打开工作台，五个标签页：<strong>项目初始化 / 流程配置 / 任务 / 技能 skill / 规则 rule</strong>，默认落在「项目初始化」（详见第 8 节）。日常配流程只需在「流程配置」页做两件事：</p>
         <ol>
@@ -385,7 +385,7 @@ risk_level: high_risk   // 涉及鉴权，验证要加证据
         <p>状态查询中的 <code>evidence_blockers</code> 列出过期验证和附加技能回执；<code>commit.allowed</code> 同时检查这些阻塞及技能执行义务。<code>legal_next</code> 是流程定义的候选去向，不表示所有门禁已通过。</p>
         <details><summary>记录需求时提示字段不存在怎么办？</summary><div>先读取 <code>status.artifact_requirements</code>，按当前阶段列出的字段填写。标准需求为 <code>scope</code> 和 <code>acceptance_criteria</code>，敏捷流程只有 <code>scope</code>。疑问、假设或待确认取舍写入字段正文，不新增字段名。错误输入整次不保存，修正后再提交；不需要修改流程配置或历史任务记录。</div></details>
         <details><summary>验证命令被沙箱阻止怎么办？</summary><div><code>verify</code> 与 <code>skill_result</code> 默认使用会话权限。原命令被沙箱阻止后，用相同命令和 <code>sandbox_permissions: "danger-full-access"</code>、<code>justification</code> 申请单次重试。审批显示命令，批准后才执行；拒绝、取消或审批不可用时不执行、不写回执。授权只对本次调用生效，不改变会话权限。以本次回执的实际模式和退出码判断结果。</div></details>
-        <p class="stamp">版本 0.23.2-rc.1 · 验证命令审批修复候选 · 最后更新：2026-09-17</p>
+        <p class="stamp">适用于插件 0.23.7 及之后 · 最后更新：2026-09-23</p>
       </section>
     </main>
   </div>

package/docs/{release-0.23.0.md → releases/0.23.0.md}

@@ -1,6 +1,6 @@
 # 0.23.0 修改清单与发布说明
 
-[← 文档导航](README.md)
+[← 文档导航](../README.md)
 
 ## 本次实现
 
@@ -25,8 +25,8 @@
 
 ## 后续建议
 
-后续优先讨论可视化自定义流程、资源导入反馈和资源维护。详细范围见[功能规划](roadmap.md)。产品定位为个人本机工作台，会话级服务器隔离不列为当前版本必修项。
+后续优先讨论可视化自定义流程、资源导入反馈和资源维护。详细范围见[功能规划](../roadmap.md)。产品定位为个人本机工作台，会话级服务器隔离不列为当前版本必修项。
 
 ## 验证与发布
 
-以[测试报告](testing/0.23.0/测试报告.md)记录实际结果。源代码与 npm 发布各自验证；GitHub CI 未完成时不能称已通过。市场 PR 只添加 `data/plugins/godv61__dsh-task-engine.yml`，按[贡献指南](https://github.com/awesome-dsh-plugin/awesome-dsh-plugin/blob/main/contributing.md)检查，npm 关联来自 package.json repository。
+以[测试报告](../testing/0.23.0/测试报告.md)记录实际结果。源代码与 npm 发布各自验证；GitHub CI 未完成时不能称已通过。市场 PR 只添加 `data/plugins/godv61__dsh-task-engine.yml`，按[贡献指南](https://github.com/awesome-dsh-plugin/awesome-dsh-plugin/blob/main/contributing.md)检查，npm 关联来自 package.json repository。

package/docs/{release-0.23.1.md → releases/0.23.1.md}

@@ -1,6 +1,6 @@
 # 0.23.1：真实项目回归后的流程修复
 
-[← 文档导航](README.md)
+[← 文档导航](../README.md)
 
 本版集中修复真实开发中暴露的资源来源、技能执行、审核记录、验证与提交问题，并改善错误提示。仍使用三个预设流程，不包含自定义流程编排。
 
@@ -45,7 +45,7 @@
 
 ## 验证结果与边界
 
-自动化及安装包结果见 [0.23.1 测试说明](testing/0.23.1/测试报告.md)。候选版 rc.3 在一项真实需求中完成了需求/方案审批、8个实施项双阶段审核、测试技能执行、真实验证和本地提交回写。rc.5 与本次字段提示修复有定向回归及包验证，未再次执行整轮真实需求。
+自动化及安装包结果见 [0.23.1 测试说明](../testing/0.23.1/测试报告.md)。候选版 rc.3 在一项真实需求中完成了需求/方案审批、8个实施项双阶段审核、测试技能执行、真实验证和本地提交回写。rc.5 与本次字段提示修复有定向回归及包验证，未再次执行整轮真实需求。
 
 该实机过程包含观察方纠正契约、复现异步缺陷和修订报告的干预，不能称为完全自主交付。业务结构树真实联调仍有环境与请求差异待核实，不能用插件本地闭环证明业务端到端可用。
 

package/docs/{release-0.23.2.md → releases/0.23.2.md}

@@ -1,6 +1,6 @@
 # 0.23.2 发布说明
 
-[← 文档导航](README.md)
+[← 文档导航](../README.md)
 
 本版修复验证命令的单次权限审批，并统一提交消息指引。
 
@@ -16,6 +16,6 @@
 
 ## 验证范围与管控边界
 
-实机测试使用独立 `dshtest` 仓库与标准流程，由 DSH 编写业务代码，观察者审阅审批、执行独立验收并修复插件。每轮业务代码、任务台账与会话日志保留在本地归档，完成轮次回退到同一空业务基线。结果与干预见[测试报告](testing/0.23.2/测试报告.md)。本次不代表 QMS 页面、数据库或生产环境验收。
+实机测试使用独立 `dshtest` 仓库与标准流程，由 DSH 编写业务代码，观察者审阅审批、执行独立验收并修复插件。每轮业务代码、任务台账与会话日志保留在本地归档，完成轮次回退到同一空业务基线。结果与干预见[测试报告](../testing/0.23.2/测试报告.md)。本次不代表 QMS 页面、数据库或生产环境验收。
 
-插件控制 `dev_task` 的阶段、证据与提交登记；通用文件编辑工具不会逐次经过该状态机，模型也可能错误解读证据。直接 Git 提交的机械约束需要安装[提交钩子](manual.html)，本次独立业务轮次验证的是通过 `dev_task` 完成的受控路径。不要把技能指引等同于对所有工具调用的强制拦截。
+插件控制 `dev_task` 的阶段、证据与提交登记；通用文件编辑工具不会逐次经过该状态机，模型也可能错误解读证据。直接 Git 提交的机械约束需要安装[提交钩子](../manual.html)，本次独立业务轮次验证的是通过 `dev_task` 完成的受控路径。不要把技能指引等同于对所有工具调用的强制拦截。

package/docs/roadmap.md

@@ -1,33 +1,34 @@
-# 功能规划
-
-[← 文档导航](README.md)
-
-本页记录讨论中的方向，不代表已发布功能。当前 npm 版本为 0.23.0；实现范围在开始编码前确认。
-
-## 优先讨论：自定义流程
-
-三个内置流程继续开箱即用，用户可以复制成自己的模板，通过可视化表单配置：
-
-| 能力 | 建议第一版范围 |
-| :--- | :--- |
-| 阶段 | 添加、重命名、删除和调整顺序。 |
-| 条件 | 为阶段设置人工确认、实施完成、验证、审核或必填产物。 |
-| 资源 | 自由添加、替换和移除阶段技能/规则。 |
-| 产物 | 配置名称与必填字段。 |
-| 提交 | 配置提交阶段、方式、格式与文件范围要求。 |
-| 复用 | 保存到项目，支持配置导入/导出。 |
-
-建议采用左侧阶段列表、右侧配置、底部流程预览。第一版以顺序流程为主；分支、循环和并行需要单独设计证据失效和任务恢复逻辑。
-
-运行中的任务保持原流程快照。多次验证、审核和人工确认应绑定到各自阶段，不能自动复用前一个阶段的通过状态。配置保存还应保留 verify_command 等已有项目字段。
-
-## 后续体验方向
-
-- 资源导入：文件选择取消、大包进度、分块上传与取消。
-- 资源维护：来源与版本记录、升级差异预览、备份和恢复。
-- 工作台：未保存内容保护、台账扩展、语言与可访问性完善。
-- 项目展示：真实工作台截图、案例和插件市场收录。
-
-## 产品范围
-
-本项目服务本机个人开发工作台。多用户服务器的会话权限架构不列为当前版本的必修项。日常改进优先解决工作区目标清晰、文件误操作、任务连续性和操作反馈。
+# 功能规划
+
+[← 文档导航](README.md)
+
+本页记录**讨论中的方向，不代表已发布功能**；是否实现、何时实现都在开始编码前单独确认。
+已发布的能力与版本变化见[更新日志](CHANGELOG.md)。
+
+## 当前能力边界
+
+| 能力 | 状态 |
+| :--- | :--- |
+| 三个内置流程（`standard`、`agile`、`minimal`） | ✅ 已发布，开箱即用 |
+| 阶段资源绑定（技能、规则挂到具体阶段） | ✅ 已发布 |
+| 任务台账、验证与审核回执、提交门禁 | ✅ 已发布 |
+| 项目级与个人级资源安装、来源保留 | ✅ 已发布 |
+| **自由编辑流程阶段与条件** | ❌ **不在计划内** |
+
+**关于自定义流程**：让使用者自行设计阶段、条件与提交流程曾被评估，结论是**不列入计划**——
+它把流程设计的负担转嫁给使用者，而三个内置流程已覆盖个人项目的常见需要。代码中不存在该能力的
+实现；相关尝试保留在非发布分支，不在 `main` 上。
+
+需要调整时，可修改项目根目录的 `.dsh/eng.json` 改变阶段资源绑定，或直接在三个内置流程中选择。
+
+## 后续体验方向
+
+- 资源导入：文件选择取消、大包进度、分块上传与取消。
+- 资源维护：来源与版本记录、升级差异预览、备份和恢复。
+- 工作台：未保存内容保护、台账扩展、语言与可访问性完善。
+- 项目展示：真实工作台截图、案例和收录信息。
+
+## 产品范围
+
+本项目服务本机个人开发工作台。多用户服务器的会话权限架构不列为当前版本的必修项。日常改进优先
+解决工作区目标清晰、文件误操作、任务连续性和操作反馈。

package/docs/testing/0.23.0//346/265/213/350/257/225/346/212/245/345/221/212.md

@@ -39,4 +39,4 @@
 
 实机技能附件与规则文件均核对 SHA-256 一致，两个一次性资源已清理并确认目标不存在；源码 fixture 留在评测工作目录，不进入发布仓库。源历史 163 个 blob 和当前待发布文件的常见凭据模式扫描无命中；模式扫描不保证发现所有形式的秘密。
 
-完整修改与后续建议见[发布说明](../../release-0.23.0.md)。收录指南要求仓库创建满一天，申请材料已准备，提交与合并应分别确认。
+完整修改与后续建议见[发布说明](../../releases/0.23.0.md)。收录指南要求仓库创建满一天，申请材料已准备，提交与合并应分别确认。

package/docs/testing/0.23.1//346/265/213/350/257/225/346/212/245/345/221/212.md

@@ -1,6 +1,6 @@
 # 0.23.1 发布验证
 
-[← 发布说明](../../release-0.23.1.md)
+[← 发布说明](../../releases/0.23.1.md)
 
 日期：2026-09-16。对象：插件 0.23.1。此文记录插件验证，不等同业务项目端到端验收。
 

package/docs/testing/0.23.2//346/265/213/350/257/225/346/212/245/345/221/212.md

@@ -1,6 +1,6 @@
 # 0.23.2 实机循环回归报告
 
-[← 发布说明](../../release-0.23.2.md)
+[← 发布说明](../../releases/0.23.2.md)
 
 日期：2026-09-17。结论：权限缺陷修复后，两个新会话从同一空业务基线完成标准研发流程、独立验收、本地提交和归档回退；门禁专项通过。验证对象是本机 Harness 上的独立 CLI 项目，不是 QMS 页面、数据库或生产业务。