dsh-plugin-agent-tree 0.1.0 → 0.1.1

package/CHANGELOG.md

@@ -1,14 +1,12 @@
 # Changelog
 
-## 未发布
+## 0.1.1 — 2026-10-29
 
-- **「等你拍板」的会话不再消失**：读实时状态里的 `pendingInteraction`（`question` / `approval` / `plan-review`），这类会话即使没在跑也会列出，琥珀色圆点 + `待答 / 待批 / 待审` 徽标，排在在跑的前面；标题栏变成「N 个等你处理 · M 个在跑 · K 个定时」。
-- **定时任务显示修复**：`remote.schedule` 是别的客户端插件挂上来的命名空间服务，只读 `ctx.remote.schedule` 在它还没挂上时会拿到 undefined，导致定时任务整段消失；现在用 `ctx.get('remote.schedule')` 兜底并继续轮询。
-- **codex 行名改成会话标题**：从 rollout 里取第一条真实用户消息（跳过 `environment_context` / `AGENTS.md` 注入）当行名，取不到才回落目录名；右侧加灰色目录小标签；同 cwd 的多个 codex 进程按时间各认领一条会话，避免多行同名。
-- **codex 的子对话**：读 `~/.codex/sessions/**/rollout-*.jsonl` 的 `session_meta`，按 `parent_thread_id` 还原 subagent 线程树，挂在 codex 行下面（昵称 + agent 路径 + 最后活动时间 / `running`）；按 cwd、cwd 前缀、桌面端 originator 三级匹配主线程。
-- 顶层改成「本机 agent 列表」：`dsh` 与 `claude` / `codex` 同级，各自展开自己的子树；行规格统一。
+- **定时 / 循环任务加小闹钟**：挂了定时任务的会话，标题前固定有一个 `⏰`，右侧显示距下次触发的倒计时（`8m` / `2h` / `3d`）。
+  刚触发过、倒计时到期的显示 `now`，但 `⏰` 不会消失——之前只有「还没到点」的行才有标记，正在跑或刚跑完的循环任务看起来和普通会话一样。
+- 倒计时不再重复画 `⏱` 图标：图标统一挪到标题前，右侧只留数字。
 
-## 0.1.0 — 2026-10-28
+## 0.1.0 — 2026-10-29
 
 首个公开版本。从「一个会话里翻着看 subagent 太累」长出来的一张小卡片。
 
@@ -22,6 +20,11 @@
 - **外部 agent 进程（带子树）**：宿主半部只读接口 `GET /local/dsh-agent-tree/processes`，用 `ps` + `lsof` 发现本机正在跑的 `claude` / `codex` CLI，并按 `ppid` 把它们的子进程挂成子树（同类子进程归组成 `computer use ×4` / `MCP ×3` 这样的行）。它们和 `dsh` 是**同级的顶层 agent 节点**（本机 agent 列表），用同一套行规格，可折叠。
 - **点击跳转**：点任意一行 → `subagentAddress` + `uiWorkspace.openSession` 跳到对应会话（含 subagent）。
 - **拖动与记忆**：拖标题栏移动，位置存 `localStorage`。
+- **「等你拍板」的会话不再消失**：读实时状态里的 `pendingInteraction`（`question` / `approval` / `plan-review`），这类会话即使没在跑也会列出，琥珀色圆点 + `待答 / 待批 / 待审` 徽标，排在在跑的前面；标题栏变成「N 个等你处理 · M 个在跑 · K 个定时」。
+- **定时任务显示修复**：`remote.schedule` 是别的客户端插件挂上来的命名空间服务，只读 `ctx.remote.schedule` 在它还没挂上时会拿到 undefined，导致定时任务整段消失；现在用 `ctx.get('remote.schedule')` 兜底并继续轮询。
+- **codex 行名改成会话标题**：从 rollout 里取第一条真实用户消息（跳过 `environment_context` / `AGENTS.md` 注入）当行名，取不到才回落目录名；右侧加灰色目录小标签；同 cwd 的多个 codex 进程按时间各认领一条会话，避免多行同名。
+- **codex 的子对话**：读 `~/.codex/sessions/**/rollout-*.jsonl` 的 `session_meta`，按 `parent_thread_id` 还原 subagent 线程树，挂在 codex 行下面（昵称 + agent 路径 + 最后活动时间 / `running`）；按 cwd、cwd 前缀、桌面端 originator 三级匹配主线程。
+- 顶层改成「本机 agent 列表」：`dsh` 与 `claude` / `codex` 同级，各自展开自己的子树；行规格统一。
 
 ### 健壮性
 

package/README.en.md

@@ -19,6 +19,7 @@ at which depth, on which model, for how long, and when its next scheduled run fi
 - **Always-on entry** — idle collapses to `● Agent tree ▸`; work re-expands it; manual collapse wins.
 - **Color = depth** — green dot for top-level conversations, blue for level-2 subagents, violet for deeper ones, grey for finished rows.
 - **Per-row model chip** (right aligned) — from the session projection `modelSelection` (`next` → `lastUsed`), shortened to `v4.1-flash`; subagents without their own record inherit the parent's (tooltip says so).
+- **Alarm clock on loop sessions** — any session driven by a schedule keeps a `⏰` in front of its title, with the countdown to the next run on the right (`8m` / `2h` / `3d`); a round that just fired shows `now` and still keeps the clock, so a running loop never looks like a plain conversation.
 - **Scheduled-task countdown** — reads `schedule.catalog()` from Automation tasks (the `remote.schedule` service, with a `ctx.get` fallback while its namespace is not mounted yet); sessions driven by a schedule are listed even while idle, with `⏱8m / ⏱2h / ⏱3d` and a `N running · M scheduled` headline.
 - **Sessions that need your call come first** — when an agent asks a question, waits for an approval, or waits for a plan review (`pendingInteraction` = `question` / `approval` / `plan-review`), that row turns **amber**, carries a `待答 / 待批 / 待审` badge and **sorts above running rows**. Previously such a session disappeared because it was no longer running.
 - **Local external agent processes, also as a tree** — the plugin's host half exposes a read-only endpoint that finds running **claude / codex CLIs** via `ps` + `lsof` and nests their children by `ppid` (e.g. codex's `computer use ×4` / `MCP ×3` / `code mode`). They show up as **top-level agents next to `dsh`**, with exactly the same row spec. ChatGPT desktop's `Codex Framework` helpers are not mistaken for CLIs themselves.

package/README.md

@@ -83,6 +83,7 @@ dsh plugin --profile web add "$PWD"
 | `▾ ● codex 推进一下能推进的任务…  devline` | codex 的**会话标题**（首条真实用户消息）+ 目录名；不是目录名兜底 |
 | `▾ ● claude proj-alpha         12m 3%` | 本机另一个 agent（和 `dsh` 同级）：claude CLI，工作目录 `proj-alpha`，跑了 12 分钟、3% CPU |
 | `│  └─ computer use ×2            41m` | 它的子进程，自动按种类归组（`×N` + 最长的那个时长） |
+| `├─ ⏰ 推进 backlog 任务并设循环   now` | 挂了定时 / 循环任务的会话：标题前固定一个小闹钟，右侧是距下次触发的倒计时（到期显示 `now`，闹钟不消失） |
 | `│  ├─ ● Hubble advance_review_logic  running` | codex 的子对话（subagent 线程）：昵称 + agent 路径，右边是「正在工作 / 最后活动多久前」 |
 | `会话 6 · 子代理 3 · 运行中 5（live）` | 自检：快照里的会话数 / 子代理数 / 运行中数量；`live` 表示官方实时状态流 |
 

package/client.js

@@ -182,6 +182,22 @@ window.__ModuleLoader__.load({
       return map;
     }
 
+    /**
+     * 定时任务的行内标记：`mark` 放在标题前面当小闹钟，`label` 放在右侧当倒计时。
+     * 倒计时已经到期（`now`）时 label 仍然给 `now`，mark 不消失——一眼就知道这行是循环任务。
+     */
+    function scheduleMark(scheduled, now) {
+      if (scheduled === undefined || scheduled === null) return null;
+      const label = countdownLabel(scheduled.nextAt, now);
+      return {
+        mark: '\u23f0',
+        label,
+        title: `${scheduled.count} 个定时任务${
+          Number.isFinite(scheduled.nextAt) ? `，下次 ${new Date(scheduled.nextAt).toLocaleString()}` : ''
+        }`,
+      };
+    }
+
     /** 距离下次触发还有多久，比如 `8m` / `2h` / `3d`。 */
     function countdownLabel(nextAt, now) {
       if (!Number.isFinite(nextAt)) return '';
@@ -483,6 +499,24 @@ window.__ModuleLoader__.load({
     }
 
     /** 「等你拍板」的小徽标：琥珀色 `待答` / `待批` / `待审`。 */
+    /** 定时 / 循环任务的小闹钟。 */
+    function AlarmMark({ title }) {
+      return h(
+        'span',
+        {
+          title,
+          style: {
+            flex: 'none',
+            fontSize: 9,
+            lineHeight: 1,
+            opacity: 0.75,
+            color: 'var(--dsw-alias-label-tertiary)',
+          },
+        },
+        '\u23f0',
+      );
+    }
+
     function WaitBadge({ kind }) {
       const info = WAIT[kind];
       if (!info) return null;
@@ -560,19 +594,16 @@ window.__ModuleLoader__.load({
           const expanded = !collapsedNodes[key];
           const own = modelLabel(node.row.projectionValues);
           const model = own || inheritedModel || '';
-          const scheduled = node.schedule;
-          const clock = scheduled
+          const schedule = scheduleMark(node.schedule, now);
+          const alarm = schedule ? h(AlarmMark, { title: schedule.title }) : null;
+          const clock = schedule
             ? h(
                 'span',
                 {
-                  title: `${scheduled.count} 个定时任务${
-                    Number.isFinite(scheduled.nextAt)
-                      ? `，下次 ${new Date(scheduled.nextAt).toLocaleString()}`
-                      : ''
-                  }`,
+                  title: schedule.title,
                   style: { flex: 'none', fontSize: 8.5, color: 'var(--dsw-alias-label-tertiary)' },
                 },
-                `⏱${countdownLabel(scheduled.nextAt, now)}`,
+                schedule.label,
               )
             : null;
 
@@ -619,6 +650,7 @@ window.__ModuleLoader__.load({
                   : node.active
                     ? h(Dot, { color: DOT.conversation, active: true })
                     : null,
+                alarm,
                 clampSpan(shortTitle(node.row), {
                   fontSize: 10.5,
                   fontWeight: node.waiting || node.active ? 600 : 500,
@@ -652,6 +684,7 @@ window.__ModuleLoader__.load({
               },
               glyph(connector),
               h(Dot, { color: node.waiting ? WAIT[node.waiting].color : color, active: node.active || Boolean(node.waiting) }),
+              alarm,
               clampSpan(shortTitle(node.row), {
                 fontSize: 10.5,
                 color: node.waiting
@@ -1253,6 +1286,7 @@ window.__ModuleLoader__.load({
       groupProcessChildren,
         modelLabel,
         toScheduleMap,
+        scheduleMark,
         countdownLabel,
         formatElapsed,
       },

package/docs/manual.en.md

@@ -76,7 +76,7 @@ The `dsh` root row collapses every workspace at once; its right side shows the w
 | `▾ / ▸` | this row has children — expand / collapsed |
 | `●` | status dot, colored by depth (below) |
 | Title | session title (`displayTitle`), elided when long; running rows are bolder |
-| `⏱8m` | countdown to the next scheduled run: `now` / `<1m` / `8m` / `2h` / `3d` |
+| `⏰` + `8m` | countdown to the next scheduled run: `now` / `<1m` / `8m` / `2h` / `3d` |
 | `v4.1-flash` | model chip (right aligned) from `modelSelection`, with `deepseek-` / `anthropic-` prefixes stripped |
 | `1m5s` | elapsed duration (subagent rows only): `45s` / `12m` / `1h5m` |
 

package/docs/manual.md

@@ -8,11 +8,11 @@
 ├──────────────────────────────────────────────────┤
 │ ▾ ● dsh                          2 个 workspace  │ ← 顶层 agent：这个 DSH 实例
 │ ├─ ▾ proj-alpha                              2  │ ← workspace
-│ │  ├─ ▾ ● Refactor billing flow  ⏱8m  v4.1-pro  │ ← 对话（绿点）
+│ │  ├─ ▾ ● ⏰ Refactor billing flow  8m  v4.1-pro  │ ← 对话（绿点，挂了定时）
 │ │  │  ├─ ● Explore repo structure      1m5s     │ ← subagent（蓝点）
 │ │  │  │  └─ ● Run unit tests              9s     │ ← 孙代理（紫点）
 │ │  │  └─ ● Write migration plan          31s     │
-│ │  └─   Fix flaky login test      ⏱2h  v4.1-flash │ ← 有定时、当前空闲
+│ │  └─   ⏰ Fix flaky login test      2h  v4.1-flash │ ← 有定时、当前空闲
 │ ├─ ▾ my-repo                                 1  │
 │ │  └─ ● Triage CI failures        v4.1-pro       │
 │ ▾ ● claude  proj-alpha                 12m 3%    │ ← 顶层 agent：本机 claude（和 dsh 同级）
@@ -78,7 +78,7 @@ dsh（这个实例）                  claude / codex（本机其它 agent）
 | `▾ / ▸` | 这一行有子代理，可展开 / 已收起 |
 | `●` | 状态点：颜色见下表 |
 | 标题 | 会话标题（`displayTitle`），过长省略；运行的会话字更粗更深 |
-| `⏱8m` | 定时任务的倒计时：`now` / `<1m` / `8m` / `2h` / `3d` |
+| `⏰` + `8m` | 标题前的小闹钟表示这行挂了定时 / 循环任务；右侧是倒计时：`now` / `<1m` / `8m` / `2h` / `3d`（到期显示 `now`，闹钟不消失） |
 | `v4.1-flash` | 模型标签（右侧对齐）：来自 `modelSelection`，`deepseek-` / `anthropic-` 前缀会去掉 |
 | `1m5s` | 运行或已运行时长（subagent 行才有）：`45s` / `12m` / `1h5m` |
 
@@ -100,7 +100,12 @@ subagent 的 `modelSelection` 常常为空，这时用最近一个祖先会话
 ## 5. 定时任务行
 
 DSH 的 Automation tasks（`schedule.catalog()`）驱动的是「间歇式工作」的会话：它们大部分时间空闲，
-到点自己跑一次。卡片会把这些会话**即使不在跑也列出来**，右侧 `⏱` 是下一次触发时间；
+到点自己跑一次。卡片会把这些会话**即使不在跑也列出来**：
+
+- 标题前固定一个 `⏰`（小闹钟），一眼认出「这行是循环任务」；
+- 右侧是距下次触发的倒计时；
+- 刚跑完、倒计时到期时显示 `now`，但 `⏰` 保持——正在跑的循环任务不会看起来像普通会话。
+
 点它同样能跳过去看上一次跑出来的东西。
 
 ## 6. 本机外部 agent（和 dsh 同级）
@@ -113,7 +118,8 @@ DSH 的 Automation tasks（`schedule.catalog()`）驱动的是「间歇式工作
 ▾ ● codex   ChatGPT        69h35m 2%
 ```
 
-- `label` 的取值顺序：进程真实 cwd 的目录名 → 命令行里的 `--cwd/--cd/-C` → `ChatGPT`（桌面端 backend）→ 空。
+- 行名（`label`）的取值顺序：该 codex 会话的第一条真实用户消息（跳过 `environment_context` / `AGENTS.md` 注入）
+  → 进程真实 cwd 的目录名 → 命令行里的 `--cwd/--cd/-C` → `ChatGPT`（桌面端 backend）→ 空。
 - 只显示前 8 条；结果缓存 3 秒；接口需要登录态（未登录 401）。
 - 目的是「我在 DSH 里干活时，本机还有没有别的 agent 在偷偷跑」；点这一行可折叠子树。
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-plugin-agent-tree",
-  "version": "0.1.0",
+  "version": "0.1.1",
   "description": "DSH Web mini agent tree: a tiny always-on floating card showing workspace → conversation → subagent as a live tree, with per-row model, scheduled-task countdowns, and external claude/codex CLI processes.",
   "keywords": [
     "dsh",