dsh-tree-task-flow 0.3.0 → 0.3.1

package/README.md

@@ -4,7 +4,8 @@
 **目标 → 任务 → 子任务**三级树，每个节点完成时由模型提交结果，插件随即把这个节点的
 **执行过程**从上下文里折叠掉，只留下那条结果。
 
-装上不等于启用。插件默认关闭，不会在没人点头的时候改动任何会话。
+**安装即启用**：`dsh plugin add` 之后就生效，不需要再改任何配置。
+不想用的时候，在 profile 里写一句 `enabled: false` 就能关掉，关掉后一个字节都不碰会话。
 
 ## 它解决什么
 
@@ -81,41 +82,47 @@
 
 需要 Node.js 22.19 以上，以及能运行 `dsh`。
 
+**从 npm 安装**：
+
+```powershell
+dsh plugin --profile web add dsh-tree-task-flow
+```
+
 **从源码目录安装**（装成 `link:`，改完源码重启即生效）。把仓库克隆到任意目录，
 然后指向那个目录：
 
 ```powershell
 dsh plugin --profile web add <插件目录>
-dsh --profile web --dump-config          # 输出里应出现 task-tree 这一行
 ```
 
-**从 npm 安装**：
+`dsh plugin add` 会把包加进 profile 的 `dsh.profile.bundles`，而本包自带的
+`cordis.patch.yml`（由 `package.json` 的 `dsh.bundle.patch` 指定）会顺势把
+`task-tree` 这一行插进插件列表——**装上即启用，不需要再改任何配置**。装完可以核对：
 
 ```powershell
-dsh plugin --profile web add dsh-tree-task-flow
+dsh --profile web --dump-config          # 输出里应出现 task-tree 这一行，且不带 config
 ```
 
-**装完必须重启 `dsh web`**——运行中的会话不追溯。
-
-## 启用
+**必须重启 `dsh web` 才生效**——运行中的会话不追溯，新工具要在新会话里才会出现。
 
-**装上 ≠ 启用，插件默认是关的**（`enabled: false`）。
+## 关闭
 
-在 `$DSH_HOME/profiles/web/cordis.patch.yml` 里加：
+不想要了，除了 `dsh plugin remove` 卸掉，也可以只把它关掉。在
+`$DSH_HOME/profiles/<名字>/cordis.patch.yml` 里写：
 
 ```yaml
 - id: task-tree
   config:
-    enabled: true
+    enabled: false
 ```
 
-然后重启 `dsh web`。仓库里的 `enable.example.yml` 可以直接抄。
+然后重启 `dsh web`。仓库里的 `config.example.yml` 有可以直接抄的完整版本。
 
 > ⚠️ profile 这一层按行覆盖时 `config` 是**整体替换**，不是逐字段深合并——
 > 覆盖时要把想保留的字段一起写全，没写的会走插件默认值（见下面的配置表）。
 
-没启用时插件**一个字节都不碰会话**：不注册工具、不加提示词段落、不折叠、不续行、
-不挂暂停闸门。只留一条 `/task-tree` 命令让你确认"装了但没开"以及怎么开。
+关掉之后插件**一个字节都不碰会话**：不注册工具、不加提示词段落、不折叠、不续行、
+不挂暂停闸门。只留一条 `/task-tree` 命令，让你确认它是被关掉的以及怎么打开。
 
 ## 界面
 
@@ -137,7 +144,7 @@ dsh plugin --profile web add dsh-tree-task-flow
 **没有计划的会话一个像素都不占**——读不到计划就返回 `null`，不会平白挤掉内置的
 待办与目标条目。
 
-开关不在界面上，在 profile 的 `cordis.patch.yml` 里（见下面的「启用」一节）。
+开关不在界面上，在 profile 的 `cordis.patch.yml` 里（见上面的「关闭」一节）。
 
 ## 命令
 
@@ -158,7 +165,7 @@ dsh plugin --profile web add dsh-tree-task-flow
 
 | 字段 | 默认 | 说明 |
 |---|---|---|
-| `enabled` | `false` | 总开关 |
+| `enabled` | `true` | 总开关；**装上即启用**，写 `false` 关掉 |
 | `autoContinue` | `false` | 模型停下时是否自动续行 |
 | `maxAutoRounds` | `5` | 连续自动续行的轮次上限 |
 | `promptOrder` | `1800` | 工具说明段落的排序 |
@@ -263,7 +270,7 @@ dsh plugin --profile web add dsh-tree-task-flow
 真去物化 `client.js`、真调一次 `apply`、真渲染一遍条目。
 
 ```powershell
-node verify-entry.mjs     # 入口装配：启用/未启用两条路径各注册了什么
+node verify-entry.mjs     # 入口装配：默认（安装即启用）/ 显式关闭两条路径各注册了什么
 node verify-tools.mjs     # 工具层：schema、result 必填、三级约束
 node verify-region.mjs    # 折叠行为：游标推进、降级追加、检查点提示
 node verify-plan.mjs      # 计划树纯逻辑：状态流转、自动完成、丢弃级联

package/config.example.yml

@@ -0,0 +1,27 @@
+# 这个文件只是示例，插件不需要它——**安装即启用**，装完就能用。
+#
+# 想改默认值时，把下面这段抄进 profile 自己的 cordis.patch.yml
+# （通常是 $DSH_HOME/profiles/<名字>/cordis.patch.yml）：
+#
+#   - id: task-tree
+#     config:
+#       enabled: false
+#
+# ⚠️ 同 id 的 config 是**整体替换**，不是逐字段深合并：写进去的字段会一次性顶掉
+#    整份默认配置，没写的字段回落到 `lib/index.js` 的 DEFAULT_CONFIG。所以要改
+#    哪一项就把想保留的项一起写全。
+- id: task-tree
+  config:
+    # 总开关。默认 true（装上即启用）；写 false 就一句话关掉，
+    # 关掉后插件不注册工具、不加提示词、不折叠上下文、不续行，一个字节都不碰会话。
+    enabled: true
+    # 模型停下时是否自动续行。默认 false —— 开着意味着 agent 一空下来就被再推一把，
+    # 会出现「按下停止却停不下来」，所以它从不默认打开。
+    autoContinue: false
+    # 连续自动续行的轮次上限，达到就停；只有真人发言才重置配额。
+    maxAutoRounds: 5
+    # 工具说明段落的排序。1800 落在内置的 TOOL_PTY(1700) 与 TOOL_WEB_SEARCH(2000)
+    # 之间的空档，不与任何内置段落撞号。
+    promptOrder: 1800
+    # 插件状态目录；null 表示 $DSH_HOME/dsh-task-tree。
+    rootDir: null

package/cordis.patch.yml

@@ -2,15 +2,16 @@
 #
 # package.json 的 dsh.bundle.patch 指向本文件，因此安装成 bundle 后，
 # 这一层会自动挂进 `dsh.profile.bundles` 配置栈（优先级低于 profile 自身的
-# cordis.patch.yml）。
+# cordis.patch.yml）。安装这个动作本身就把插件行插好了——**装上即启用**，
+# 不需要再改任何配置。
 #
-# 这里刻意不写 config，全部走 lib/index.js 里的 DEFAULT_CONFIG。
+# 这里刻意不写 config，全部走 lib/index.js 里的 DEFAULT_CONFIG（enabled 默认 true）。
 # 要临时关掉或改默认值，请在 profile 自己的 cordis.patch.yml 里覆盖这一行。
 #
 # ⚠️ 同 id 的 config 是**整体替换**，不是逐字段深合并——覆盖时要把需要的
 #    字段一次写全。可覆盖的字段见 DEFAULT_CONFIG：
 #
-#   enabled            总开关                          默认 false（装上 ≠ 启用）
+#   enabled            总开关                          默认 true（写 false 关掉）
 #   autoContinue       是否允许自动续行                默认 false（开着会让人停不下来）
 #   maxAutoRounds      连续自动续行轮次上限            默认 5
 #   promptOrder        工具说明段顺序                  默认 1800

package/lib/commands.js

@@ -20,10 +20,10 @@ const USAGE = [
   "/task-tree reset               清掉本会话的计划树",
 ].join("\n");
 
-/** 未启用时唯一要说的话：装了，但没开，以及怎么开。 */
+/** 插件被配置关掉时唯一要说的话：现在是关的，以及怎么打开。 */
 const DISABLED_NOTE =
-  "dsh-tree-task-flow 已装载但**未启用**（config 里 enabled 不是 true）：它没有注册工具，" +
-  "也不会折叠任何上下文。要启用请在 profile 的 cordis.patch.yml 里把 enabled 设为 true。";
+  "dsh-tree-task-flow 已被配置**关闭**（config 里 enabled 不是 true）：它没有注册工具，" +
+  "也不会折叠任何上下文。要打开请在 profile 的 cordis.patch.yml 里把 enabled 设为 true。";
 
 /**
  * 把检查点那句话拼出来。措辞与 `plan.js` 的检查点提示一致。
@@ -45,7 +45,7 @@ function checkpointLines(checkpoint) {
  *
  * @param ctx - 挂载本行的 Cordis 上下文。
  * @param options - `{ store, cfg, pause, enabled }`；`pause` 是 `registerPause`
- *   返回的控制接口，未启用时是 null。
+ *   返回的控制接口，被关闭时是 null。
  */
 export function registerCommands(ctx, { store, cfg, pause = null, enabled = false }) {
   // 和 tools 一样，命令服务不是每个部署都有；用 get 探测而不是写进 inject。
@@ -72,12 +72,12 @@ export function registerCommands(ctx, { store, cfg, pause = null, enabled = fals
         return { kind: "success", text: enabled === true ? USAGE : `${DISABLED_NOTE}\n\n${USAGE}` };
       }
 
-      // 未启用时插件没有注册工具，也就不会有计划树；除了查看"装了但没开"，
-      // 其余动词一概不执行——启用的插件一个字节都不该碰会话。
+      // 被关闭时插件没有注册工具，也就不会有计划树；除了确认关闭状态，
+      // 其余动词一概不执行——关掉的插件一个字节都不该碰会话。
       if (enabled !== true && verb !== "status") {
         return {
           kind: "error",
-          text: `${DISABLED_NOTE}\n\n未启用时只有 /task-tree status 与 /task-tree help 可用。`,
+          text: `${DISABLED_NOTE}\n\n关闭状态下只有 /task-tree status 与 /task-tree help 可用。`,
         };
       }
 

package/lib/http.js

@@ -101,7 +101,7 @@ function afterWrite(plan) {
  * 注册全部面板接口。
  *
  * @param ctx - 挂载本行的 Cordis 上下文。
- * @param options - `{ store, autoContinue, pause }`；未启用时后两者是 null。
+ * @param options - `{ store, autoContinue, pause }`；插件被关闭时后两者是 null。
  */
 export function registerHttp(ctx, { store, autoContinue, pause = null }) {
   ctx.inject(["webServer"], (host) => {

package/lib/index.js

@@ -43,11 +43,13 @@ export const DEFAULT_CONFIG = {
   /**
    * 总开关。
    *
-   * ★ **默认关闭**。装上插件 ≠ 启用插件：一启用，它就会往**每个会话**的系统提示词里
-   * 加一段说明、并在节点完成时改上下文。这种事不该在用户没点头的时候发生。
-   * 要启用见 README（在 profile 的 cordis.patch.yml 里打开）。
+   * ★ **默认开启**：装上就用。安装这个插件本身就是用户点的头，
+   * 再让每个人去改一遍 profile 配置没有道理。
+   *
+   * 想关掉就在 profile 的 `cordis.patch.yml` 里显式写 `enabled: false`——
+   * 关掉之后它一个字节都不碰会话（见下面 apply 里的分支）。
    */
-  enabled: false,
+  enabled: true,
   /**
    * 是否允许在模型停下时自动续行。
    *
@@ -75,8 +77,8 @@ export function apply(ctx, config) {
   const root = cfg.rootDir ?? defaultRoot();
   const store = createStore(root);
 
-  // 总开关默认**关**。未启用时一个字节都不碰会话：不注册工具、不加提示词段落、
-  // 不折叠上下文、不续行——只留一条命令，让人能确认"装了但没开"以及怎么开。
+  // 被显式关掉时，一个字节都不碰会话：不注册工具、不加提示词段落、不折叠上下文、
+  // 不续行——只留一条命令，让人能确认"装了但被关掉了"以及怎么打开。
   if (cfg.enabled !== true) {
     registerCommands(ctx, { store, cfg, pause: null, enabled: false });
     // 条目接口照挂：客户端条目与 enabled 无关，照样会来读。读不到计划它就返回
@@ -84,7 +86,7 @@ export function apply(ctx, config) {
     // 只读插件自己的状态目录，不碰任何会话。
     registerHttp(ctx, { store, autoContinue: null, pause: null });
     ctx.logger?.warn?.(
-      "dsh-tree-task-flow: 已装载但**未启用**（enabled=false）。要启用请在 profile 的 cordis.patch.yml 里设为 true。",
+      "dsh-tree-task-flow: 已按配置关闭（enabled=false）。要打开请在 profile 的 cordis.patch.yml 里把它设为 true。",
     );
     return;
   }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-tree-task-flow",
-  "version": "0.3.0",
+  "version": "0.3.1",
   "description": "树形任务流：把多步任务组织成目标→任务→子任务三级树，节点完成时由 AI 提交结果，插件随即把该节点的执行过程从上下文里折叠掉，只留下结果。",
   "type": "module",
   "main": "lib/index.js",
@@ -13,7 +13,7 @@
     "lib",
     "client.js",
     "cordis.patch.yml",
-    "enable.example.yml",
+    "config.example.yml",
     "README.md"
   ],
   "dsh": {

package/enable.example.yml

@@ -1,4 +0,0 @@
-# 显式启用插件用。默认 enabled 是 false——装上不等于启用。
-- id: task-tree
-  config:
-    enabled: true