dsh-task-ledger 0.0.96 → 0.0.98

package/dist/host/repositories/ledger.repository.d.ts

@@ -19,8 +19,14 @@ export declare function hasLedger(workspacePath: string): boolean;
  * 不静默返空（空 = 撒谎）。**过 1.5s 读缓存**（同屏多端点会反复读同一份在办）。
  */
 export declare function readTasks(workspace: LedgerWorkspace, filter?: LedgerFilter): Promise<TaskRow[]>;
-/** 已结案记录（包 `history --json`；`records` 必须存在且为数组，缺了即坏数据）。同样过读缓存。 */
-export declare function readHistory(workspace: LedgerWorkspace, filter?: LedgerFilter): Promise<HistoryRecord[]>;
+/**
+ * 已结案记录（包 `history --json`；`records` 必须存在且为数组，缺了即坏数据）。同样过读缓存。
+ * 一并带回 `warnings`（被脚本整行跳过的坏行原因）——调用方必须展示，不许吞。
+ */
+export declare function readHistory(workspace: LedgerWorkspace, filter?: LedgerFilter): Promise<{
+    records: HistoryRecord[];
+    warnings: string[];
+}>;
 /** 单条在办（展开行 / 详情用）。取不到回 null，不抛。 */
 export declare function getTask(workspace: LedgerWorkspace, taskId: string): Promise<TaskRow | null>;
 /**

package/dist/host/repositories/ledger.repository.js

@@ -65,7 +65,10 @@ export async function readTasks(workspace, filter = {}) {
         return parseTaskList(result.data, workspace);
     });
 }
-/** 已结案记录（包 `history --json`；`records` 必须存在且为数组，缺了即坏数据）。同样过读缓存。 */
+/**
+ * 已结案记录（包 `history --json`；`records` 必须存在且为数组，缺了即坏数据）。同样过读缓存。
+ * 一并带回 `warnings`（被脚本整行跳过的坏行原因）——调用方必须展示，不许吞。
+ */
 export async function readHistory(workspace, filter = {}) {
     return await cached(cacheKey(workspace.id, "history", argsKey(filter, "history")), async () => {
         const result = await runLedgerScript("history", [

package/dist/host/repositories/records.d.ts

@@ -1,5 +1,13 @@
 import type { HistoryRecord, LedgerWorkspace, TaskRow } from "../types.js";
 /** `list --json`（任务号为键的对象）→ TaskRow[]（打上 id 与 workspace）。 */
 export declare function parseTaskList(raw: unknown, workspace: LedgerWorkspace): TaskRow[];
-/** `history --json`（`{count, filters, records}`）→ HistoryRecord[]（打上 workspace）。 */
-export declare function parseHistoryRecords(raw: unknown, workspace: LedgerWorkspace): HistoryRecord[];
+/**
+ * `history --json`（`{count, filters, records, warnings}`）→ 记录 + 脚本警告（都打上 workspace）。
+ *
+ * ⚠️ `warnings` **必须带出去**：脚本只认十一列历史，列数不对 / 时间不合法的行会被
+ * **整行跳过**（不是少几个字段）。丢掉 warnings 就是「趋势图少算一截还装作没发生」。
+ */
+export declare function parseHistoryRecords(raw: unknown, workspace: LedgerWorkspace): {
+    records: HistoryRecord[];
+    warnings: string[];
+};

package/dist/host/repositories/records.js

@@ -29,7 +29,12 @@ export function parseTaskList(raw, workspace) {
     }
     return rows;
 }
-/** `history --json`（`{count, filters, records}`）→ HistoryRecord[]（打上 workspace）。 */
+/**
+ * `history --json`（`{count, filters, records, warnings}`）→ 记录 + 脚本警告（都打上 workspace）。
+ *
+ * ⚠️ `warnings` **必须带出去**：脚本只认十一列历史，列数不对 / 时间不合法的行会被
+ * **整行跳过**（不是少几个字段）。丢掉 warnings 就是「趋势图少算一截还装作没发生」。
+ */
 export function parseHistoryRecords(raw, workspace) {
     if (!isPlainObject(raw)) {
         throw new LedgerDataError(workspace.id, `${workspace.title}: 台账 history 输出不是对象，拒绝当成空历史`);
@@ -44,7 +49,11 @@ export function parseHistoryRecords(raw, workspace) {
             continue; // 元素级宽松：坏行跳过，不整板炸
         rows.push(toHistoryRecord(record, workspace));
     }
-    return rows;
+    const rawWarnings = raw.warnings;
+    const warnings = Array.isArray(rawWarnings)
+        ? rawWarnings.filter((item) => typeof item === "string")
+        : [];
+    return { records: rows, warnings };
 }
 /**
  * 脚本 9 列的键 → 领域字段名。

package/dist/host/routes.js

@@ -135,6 +135,7 @@ export function registerRoutes(webServer, deps) {
                 closed: result.closed,
                 trend: result.trend,
                 degraded: result.degraded,
+                warnings: result.warnings,
             });
         }
         catch (error) {

package/dist/host/services/dates.d.ts

@@ -1,10 +1,15 @@
 /**
  * 日期口径（纯函数层，零 IO）：本机时区、周一为一周之始（与 skill 脚本同口径）。
  * 所有函数显式收 `now`——不自己读时钟，便于单测与跨时区复现。
+ *
+ * ⚠️ **台账存盘时间是 UTC**（skill `core/time.py::now`），`--json` 原样吐 UTC，
+ * 只有人话输出才转查看者本地（`fmt_local`）。看板是给人看的 ⇒ 一律先按 UTC 解析出
+ * 真实时刻，再按本机时区取日期（等价于脚本的 `fmt_local`）。否则会出现
+ * 「脚本表格里是 10-17、看板却算进 10-16 那周」—— 两个界面同一条记录差一天。
  */
-/** Date → `YYYY-MM-DD`。 */
+/** Date → `YYYY-MM-DD`（本机时区）。 */
 export declare function ymd(date: Date): string;
-/** 时刻串（`YYYY-MM-DD HH:mm:ss` / `YYYY-MM-DD`）→ 日期部分；解析不了回 null。 */
+/** 时刻串（`YYYY-MM-DD HH:mm:ss` / `YYYY-MM-DD`）→ 本机时区的日期；解析不了回 null。 */
 export declare function dayOf(stamp: string | null | undefined): string | null;
 /** 某日期所在周的周一（00:00）。 */
 export declare function mondayOf(day: string): Date;

package/dist/host/services/dates.js

@@ -1,20 +1,43 @@
 /**
  * 日期口径（纯函数层，零 IO）：本机时区、周一为一周之始（与 skill 脚本同口径）。
  * 所有函数显式收 `now`——不自己读时钟，便于单测与跨时区复现。
+ *
+ * ⚠️ **台账存盘时间是 UTC**（skill `core/time.py::now`），`--json` 原样吐 UTC，
+ * 只有人话输出才转查看者本地（`fmt_local`）。看板是给人看的 ⇒ 一律先按 UTC 解析出
+ * 真实时刻，再按本机时区取日期（等价于脚本的 `fmt_local`）。否则会出现
+ * 「脚本表格里是 10-17、看板却算进 10-16 那周」—— 两个界面同一条记录差一天。
  */
 function pad(value) {
     return String(value).padStart(2, "0");
 }
-/** Date → `YYYY-MM-DD`。 */
+/** Date → `YYYY-MM-DD`（本机时区）。 */
 export function ymd(date) {
     return `${date.getFullYear()}-${pad(date.getMonth() + 1)}-${pad(date.getDate())}`;
 }
-/** 时刻串（`YYYY-MM-DD HH:mm:ss` / `YYYY-MM-DD`）→ 日期部分；解析不了回 null。 */
+/**
+ * 台账时刻串 → Date（带时刻的按 **UTC** 解析；纯日期串按本地日历，不涉及时区）。
+ * 解析不了回 null，不猜。
+ */
+function parseStamp(stamp) {
+    const text = stamp.trim().replace(" ", "T");
+    // 已带时区后缀（`Z` / `+08:00`）的不重复加，加了会二次偏移
+    const iso = /\d{1,2}:\d{2}/.test(text)
+        ? /(?:[zZ]|[+-]\d{2}:?\d{2})$/.test(text)
+            ? text
+            : `${text}Z`
+        : text;
+    const parsed = new Date(iso);
+    return Number.isNaN(parsed.getTime()) ? null : parsed;
+}
+/** 时刻串（`YYYY-MM-DD HH:mm:ss` / `YYYY-MM-DD`）→ 本机时区的日期；解析不了回 null。 */
 export function dayOf(stamp) {
     if (stamp === null || stamp === undefined || stamp === "")
         return null;
-    const day = String(stamp).slice(0, 10);
-    return /^\d{4}-\d{2}-\d{2}$/.test(day) ? day : null;
+    const text = String(stamp);
+    if (/^\d{4}-\d{2}-\d{2}$/.test(text.trim()))
+        return text.trim();
+    const parsed = parseStamp(text);
+    return parsed === null ? null : ymd(parsed);
 }
 /** 某日期所在周的周一（00:00）。 */
 export function mondayOf(day) {
@@ -51,8 +74,8 @@ export function inWindow(day, window) {
 export function daysSince(stamp, now) {
     if (stamp === null || stamp === undefined || stamp === "")
         return null;
-    const parsed = new Date(String(stamp).replace(" ", "T"));
-    if (Number.isNaN(parsed.getTime()))
+    const parsed = parseStamp(String(stamp));
+    if (parsed === null)
         return null;
     const days = Math.floor((now.getTime() - parsed.getTime()) / 86_400_000);
     return days > 0 ? days : 0;

package/dist/host/services/history.service.js

@@ -15,7 +15,7 @@ export const DEFAULT_HISTORY_LIMIT = 500;
 export async function queryClosed(workspaces, filter = {}) {
     const windowed = { months: RECENT_MONTHS, ...filter };
     const { data, degraded } = await settleWorkspaces(workspaces, "history", (workspace) => readHistory(workspace, windowed), (rows) => rows
-        .flat()
+        .flatMap((row) => row.records)
         .sort((a, b) => String(b.created ?? b.time ?? "").localeCompare(String(a.created ?? a.time ?? "")))
         .slice(0, filter.limit ?? DEFAULT_HISTORY_LIMIT));
     return { records: data, degraded };

package/dist/host/services/trend.service.d.ts

@@ -12,7 +12,9 @@ export declare const RECENT_MONTHS = 13;
 /** 趋势图桶数：近 8 周（2026-10-17 定稿）。 */
 export declare const WEEKLY_WEEKS = 8;
 /** 慢路径读法：单工作区 readTasks + readHistory(months) + 本机身份（并行；供 settle 逐工作区调）。 */
-export declare function readTrendScope(workspace: LedgerWorkspace): Promise<TrendScope>;
+export declare function readTrendScope(workspace: LedgerWorkspace): Promise<TrendScope & {
+    warnings: readonly string[];
+}>;
 /**
  * 近 N 周分组桶（完成按结案时间、新增按创建时间）× 所有 / 我的（纯函数）。
  *
@@ -28,6 +30,7 @@ export declare function getTrend(workspaces: readonly LedgerWorkspace[]): Promis
     closed: ClosedSummary;
     trend: TrendPeriods;
     degraded: readonly DegradedInfo[];
+    warnings: readonly string[];
 }>;
 /** 趋势端点用的历史 filter（窗口由本模块策略决定，repository 零默认值注入）。 */
 export declare function trendHistoryFilter(extra?: LedgerFilter): LedgerFilter;

package/dist/host/services/trend.service.js

@@ -21,7 +21,13 @@ export async function readTrendScope(workspace) {
         readHistory(workspace, { months: RECENT_MONTHS }),
         getCurrentIdentity(workspace),
     ]);
-    return { workspace, tasks, history, identity };
+    return {
+        workspace,
+        tasks,
+        history: history.records,
+        identity,
+        warnings: history.warnings,
+    };
 }
 /**
  * 近 N 周分组桶（完成按结案时间、新增按创建时间）× 所有 / 我的（纯函数）。
@@ -146,6 +152,8 @@ export async function getTrend(workspaces) {
         closed: computeClosedSummary(scopes, now),
         trend: computeTrendPeriods(scopes, now),
         degraded,
+        // 被脚本跳过的历史行（列数不对 / 时间不合法）：数字已经少算了，必须让界面说出口
+        warnings: scopes.flatMap((scope) => scope.warnings),
     };
 }
 /** 趋势端点用的历史 filter（窗口由本模块策略决定，repository 零默认值注入）。 */

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "dsh-task-ledger",
-	"version": "0.0.96",
+	"version": "0.0.98",
 	"description": "Task ledger board for dsh (DeepSeek Harness): read-only board over task-ledger skill workspaces. The task-ledger skill is bundled — install the plugin, get the skill globally.",
 	"keywords": [
 		"deepseek",
@@ -55,5 +55,8 @@
 				"@deepseek-ai/dsh-client-ui-layout"
 			]
 		}
+	},
+	"dependencies": {
+		"dsh-plugin-core": "^0.5.0"
 	}
 }

package/skill/README.md

@@ -24,7 +24,7 @@
 
 ## 为什么这么设计
 
-跨项目固定用 `ledger/`（不占项目的 `docs/`）；状态用 JSON 而非 Markdown（改动面最小）；状态与过程正文分离（互不踩）；一人一份分片把并发冲突面从整份文件缩到公共池里几行；台账数据时间存 UTC、过程文档里的日志行显示本地时间。
+跨项目固定用 `ledger/`（不占项目的 `docs/`）；状态用 JSON 而非 Markdown（改动面最小）；状态与过程正文分离（互不踩）；一人一份分片把并发冲突面从整份文件缩到公共池里几行；**所有存盘时间（含过程文档里的日志行）一律 UTC**，脚本输出时统一转本机时区（人话与 `--json` 一致）。
 
 ## 怎么用（执行规则在 SKILL.md）
 
@@ -34,7 +34,7 @@
 python3 <SKILL.md 所在目录>/scripts/progress.py <子命令> --repo <工作区根>
 ```
 
-子命令：`new` `claim` `set` `log` `close` `list` `history` `show` `validate`。命令参考（参数 / 一句话 / 举例）、任务生命周期、纪律（数据完整性 / 人类授权 / 故障处置）全在 `SKILL.md`；参数细节看 `<子命令> --help`（不要凭记忆编）。
+子命令：`new` `claim` `set` `log` `close` `list` `history` `show` `whoami` `validate`。命令参考（参数 / 一句话 / 举例）、任务生命周期、纪律（数据完整性 / 人类授权 / 故障处置）全在 `SKILL.md`；参数细节看 `<子命令> --help`（不要凭记忆编）。
 
 ## 深入参考（references/，按需读）
 

package/skill/SKILL.md

@@ -1,7 +1,7 @@
 ---
 name: task-ledger
 description: 本地任务台账，跨会话记录在办任务的归属、进度与起止。当用户要登记一件新的事（新建任务 / 建个坑 / 这活我领了）、记录已有任务的进展（接着做 / 记一条进展 / 这轮先记下）、查看任务状态或历史（现在该做什么 / 这活谁在做 / 上周做过什么）、给任务结案或退回（做完了 / 验收通过 / 不做了 / 退回待认领）、整理标签或检查台账一致性时加载；只是改代码、讨论方案时不要用。
-version: 1.3.22
+version: 1.3.24
 allowed-tools: Read,Edit,Bash,Grep
 ---
 
@@ -21,11 +21,11 @@ allowed-tools: Read,Edit,Bash,Grep
 
 - **唯一能手写的是任务的过程文档（worklog）前五节**（怎么写见「过程文档」节）；末节「执行记录」由脚本维护，**禁止手写、禁止手工添加**。
 - **其他所有文件一律不许手改**：修改 / 删除 / 任何操作都走命令；手改台账文件即数据损坏。
-- 台账看着不对劲（任务凭空少了、状态怪、分片对不上）⇒ **不要动手修**：让用户跑 `validate`（要连老月份和正文一起看就跑 `validate --deep`），把清单交给用户。
+- 台账看着不对劲（任务凭空少了、状态怪、分片对不上）⇒ **不要动手修**：让用户跑 `validate`（老月份的历史也要查就跑 `validate --deep`），把清单交给用户。
 
 ## 命令参考
 
-十个子命令：`init`（初始化本机身份，一台机器一次）+ 前五个写命令（`new`/`claim`/`set`/`log`/`close`）+ 后四个查询类（`list` / `show` / `history` / `validate`）；何时用哪个见「任务生命周期」。参数语法看 `<子命令> --help`；下表说每个参数干什么、何时用。
+十一个子命令：`init`（初始化本机身份，一台机器一次）+ 前五个写命令（`new`/`claim`/`set`/`log`/`close`）+ 后五个只读命令（`list` / `show` / `history` / `whoami` / `validate`）；何时用哪个见「任务生命周期」。参数语法看 `<子命令> --help`；下表说每个参数干什么、何时用。
 
 ### init — 初始化本机身份
 
@@ -110,7 +110,7 @@ allowed-tools: Read,Edit,Bash,Grep
 | `--status open\|doing` | 按状态筛（逗号分隔可多选；合法值只有 `open` / `doing`） |
 | `--category` / `--tag` | 按分类（精确）/ 标签（包含）筛 |
 | `--since` / `--until` | 按创建时间筛（只给日期含当天） |
-| `--json` | 输出 JSON（`{任务号: 任务对象}`） |
+| `--json` | 输出 JSON（`{任务号: 任务对象}`）；**每行带 `mine`**（是不是自己名下的，只比 uuid） |
 
 干什么：合并公共池 + 各人名下的任务，列出在办。**默认就是全量**，没有 `--all` 参数；收窄用 `--mine` / `--pool`。
 
@@ -120,10 +120,10 @@ allowed-tools: Read,Edit,Bash,Grep
 
 | 参数 | 含义 |
 |---|---|
-| `--id <任务号>` | 看哪条（必填；谁名下的都能看） |
-| `--json` | 连过程文档全文一起给（人话模式只给路径） |
+| `--id <任务号>` | 看哪条（必填；谁名下的、在办还是已结案都能看） |
+| `--json` | 任务字段 + 过程文档全文一起给（人话模式只给路径） |
 
-干什么：拿任务 JSON + 过程文档路径 / 全文。改既有任务正文前，先用它拿路径。
+干什么：**看一条 = 任务字段 + 过程文档全文**，一次拿全；已结案的任务同样能看，不必先查 `history`。`--json` 里 `legacy: true` 表示这些字段是回退查在办得到的（老文档没有状态行）。
 
 举例：「这个任务到哪一步了」→ `show --id <任务号> --json`。
 
@@ -138,12 +138,32 @@ allowed-tools: Read,Edit,Bash,Grep
 | `--months N` | 最近 N 个自然月（与 `--since` / `--until` **互斥**，同传直接报错） |
 | `--limit N` | 最近 N 条 |
 | `--count-only` | 只输出 `{"count","capped"}`（与 `--json`、`--limit` 都互斥） |
-| `--json` | JSON 输出 |
+| `--json` | JSON 输出；**每条记录带 `mine`**（是不是自己结的，只比 uuid） |
 
 干什么：按结案时间倒序排列，每条一行，只列结案时间、负责人、标题，其他都不在表格里；要摘要 / 分类 / 标签 / 完整时间加 `--json`。不给时间参数 = 最近 3 个自然月；最多 13 个月，超了直接报错。
 
 举例：「上周做过什么」→ `history --since <上周一日期>`；「今年都结掉哪些」→ `history --months 12`（超过 13 个月要分段查）。
 
+### whoami — 我是谁
+
+| 参数 | 含义 |
+|---|---|
+| （无） | 打印本机身份：`@名字　uuid` |
+| `--json` | `{"uuid","name"}`；**未初始化给双 null**（照常退 0，不是错误） |
+
+干什么：本机身份的只读查询，**不依赖 `--repo`、不写任何文件**，回答「这台机器上我是谁」。判断要不要引导用户 `init` 就看这条命令，别去解析 `~/.taskledger/identity.json`。
+
+举例：`whoami --json` 拿到 `uuid` 是 `null` ⇒ 这台机器还没初始化身份，先引导用户跑 `init`。
+
+### validate — 台账体检
+
+| 参数 | 含义 |
+|---|---|
+| `--deep` | 历史读全部月份（默认只读当月那个月文件） |
+| `--json` | `{"problems","notices","checked_files","total_tasks","deep"}` |
+
+干什么：只读体检，查公共池 + 各分片的字段格式、索引与文件对不对得上、历史格式。**不读过程文档正文**（浅度 / 深度都不读）。查出问题时退 1 —— 把清单原样交给用户，agent 不自行修。
+
 ## 怎么调用
 
 ```bash
@@ -152,7 +172,8 @@ python3 <本 SKILL.md 所在目录>/scripts/progress.py <子命令> --repo <工
 
 - 定位项目：`--repo <工作区根>`（**直接含有 `ledger/` 的那个目录**）给了就校验后用；不给就从当前目录逐级向上找。`ledger/` 本身、以及它下面的任何子目录都不是根，指过去会被直接拒绝（判据只看位置，不看目录里有哪些文件 —— 项目根自带 `pool.json`、`history/`、`worklog/` 都不影响）。
 - `--no-sync`（放在子命令**前**）：用户明确要求「先别同步」时才用；之后自己 `git add ledger && commit && push`。
-- `--json` 只对只读命令（`list` / `show` / `history` / `validate`）有意义；写命令不接收 `--json`，传了是用法错。`--json` 里的时间字段是 UTC，人话输出是本地时间。
+- `--json` 只对只读命令（`list` / `show` / `history` / `whoami` / `validate`）有意义；写命令不接收 `--json`，传了是用法错。
+- **时间**：存盘一律 UTC，脚本对外**一律给本机时区**（人话表格与 `--json` 都是），拿到直接显示，不要再转一次；`--since` / `--until` / `--created` / `--finished` 也按本机时区给，脚本内部转 UTC 比较。过程文档正文里的时间是原文，脚本不碰。
 - 命令回执只用来确认生效；任务状态以 `show` / `list` 为准。
 
 ## 任务生命周期
@@ -186,15 +207,24 @@ python3 <本 SKILL.md 所在目录>/scripts/progress.py <子命令> --repo <工
 
 - 「执行记录」节名一个字都别动；老文档缺这一节也不用补。
 - 过程文档找不到时 `log` 只提示不失败；用 `show` 查路径，不要手写。
-- 头部只有创建时间 / 创建人、封卷标记、分类 / 标签行 —— **状态与归属以台账数据为准，别从头部读**。
-- 执行记录行格式 `- 本地时间 · 类型 · @谁 · 说明`，`@谁` 是这次动手的人、不是任务现归属；只追加、不改旧行。行首「类型」是脚本内部动作名（会见到 `release`，它就是 `set --release`）；认不出就别当成新命令，按 `--help` 查。
+- 头部是四行，由脚本维护、**都不要手改**，顺序固定 `分类/标签 → 状态 → 创建 → 封卷`，值一律 `· ` 分隔：
+
+  ```markdown
+  - **分类**：建设 · **标签**：DSH、台账
+  - **状态**：doing · 2026-10-27 09:12:33 · @某人 · 8d557c6d-…
+  - **创建**：2026-10-26 23:38:02 · @某人 · 8d557c6d-…
+  - **封卷**：2026-10-27 09:20:10 · @某人 · 8d557c6d-…
+  ```
+
+  分类 / 标签行与封卷行不一定有（没给分类、没结案就没有）。老文档没有状态行是合法的（`show` 回退查在办，`--json` 标 `legacy: true`），不用补。
+- 执行记录行格式 `- 时间（UTC） · 类型 · @谁 · 说明`，`@谁` 是这次动手的人、不是任务现归属；只追加、不改旧行。行首「类型」是脚本内部动作名（会见到 `release`，它就是 `set --release`）；认不出就别当成新命令，按 `--help` 查。
 - 只改某条任务的正文：`show --id <任务号>` 拿路径直接改，不另建 md；已结案的用 `history --months 12 --json` 找回链接（**人话输出里没有链接，必须加 `--json`**）——默认只查近 3 个月，结案久了的要显式放大窗口；只读不改。
 
 ### 收工三步（「收工」= 这一轮对用户有可见产出）
 
 1. 改正文：这轮变化的事实都落笔，「下一步」写具体动作。
 2. 跑 `log`：这一轮只要改过正文就必须记（一轮至少一条；纪律见下文）。正文没变也能记一条推进，但要同时重写「下一步」。
-3. 回读末行（`tail -n 3 <路径>`）：说明 = 这轮的事。执行记录行的时间是本机本地时间，别以为没记上。
+3. 回读末行（`tail -n 3 <路径>`）：说明 = 这轮的事。执行记录行的时间是 **UTC**（比本机本地时间早若干小时，看时差别以为没记上）。
 
 **什么算一个节点**：明天自己想不起来、或换个人接手会看不出的事，就记一条；一次状态 / 结论变化对应一条，不对应一次工具调用。拿不准够不够格、`--note` 不会写 → 见 `references/log-note.md`。
 
@@ -217,7 +247,7 @@ python3 <本 SKILL.md 所在目录>/scripts/progress.py <子命令> --repo <工
 | `new` / `claim` / `set` | 动手类 | 执行前复述完整参数并取得确认；**`new` 仅当用户原话点名要建且标题可直取原话时免复述**，标题需另拟或拿不准仍复述一次（`claim`/`set` 一律复述） |
 | `log` | 免确认 | 本任务的推进 / 卡点 / 交付记录直接跑，跑完一句话交代「已记执行记录：…」；要替用户下结论，先问（任务不在自己名下会直接被拒） |
 | `close` | 独立授权 | 仅认明确说「结束掉 / close 掉」（完整判定见生命周期第 8 条）；说得含糊必须反问「是要结束这个任务吗？」；**agent 自判「干完了」不算** |
-| `list` / `show` / `history` / `validate` | 只读 | 直接跑 |
+| `list` / `show` / `history` / `whoami` / `validate` | 只读 | 直接跑 |
 
 ### 故障处置（跑之后出事怎么办）
 

package/skill/assets/worklog.md

@@ -1,8 +1,11 @@
 # <id>：<title>
 
-> **创建**：<created>（@<creator>）
+- **状态**：<status>
+- **创建**：<created> · @<creator>
 
-<!-- 「> **分类**：… ｜ **标签**：…」行由脚本按 new --category / --tags 插入；两者皆空则不写。 -->
+<!-- 头部四行由脚本维护，顺序固定：分类/标签 → 状态 → 创建 → 封卷。
+     「- **分类**：… · **标签**：…」按 new --category / --tags 插在最上面，两者皆空则不写；
+     「- **封卷**：…」在结案时加在最后。 -->
 
 ## 背景
 

package/skill/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "task-ledger",
-	"version": "1.3.22",
+	"version": "1.3.24",
 	"description": "Task-ledger skill for coding agents: per-workspace progress tracking (ledger/pool.json + owners/<hash>.json shards + owners.json index, history, worklog) driven by a CLI script. Standalone install for CodeBuddy and other agents; also bundled inside the dsh-task-ledger DSH plugin.",
 	"keywords": [
 		"skill",

package/skill/references/state-model.md

@@ -24,7 +24,12 @@ close             → 历史层 + 封卷 + 移出自己名下
 - **只在补录过去时间时传**：`new --created`、`close --finished`。格式 `YYYY-MM-DD[ HH:MM[:SS]]`，按本地墙钟给、脚本内部转 UTC。`new --created` 补录时 `updated` 一并等于该时间 —— 之后补一条 `log` 把 `updated` 刷回当前。
   - 注意：任务号前缀与 worklog 月份目录按 **UTC** 推 —— UTC+8 下裸日期 `--created 2026-01-05` 存成 `2026-01-04 16:00:00`，任务号前缀变成 `20260104-1600`；临午夜补录要连时间一起传。
 - **筛选语义**：`list` 的 `--since` / `--until` 按**创建时间**；`history` 的按**结案时间**（历史文件按结案月归档，按创建时间比较会漏「上月建、本月结」的记录）。只给日期时起 = 当天 `00:00:00`、止 = 当天 `23:59:59`（含当天）。
-- **时区**：存盘为 UTC 的只有 —— 任务号、worklog 目录 / 文件名、台账 JSON 的 `created`/`started`/`updated`/`finished`、history 行、worklog 头部「创建」行。**执行记录行、封卷行、`list` / `history` 的人话输出都是本机本地时间**（给人看的日志行）；`--json` 原样给 UTC，由消费方自己转。存量老数据（2026-10-22 前）写的是写入者本地时间、无标记，无法与 UTC 区分。
+- **时区**：**存盘一律 UTC，出门一律本机时区**。
+  - 存盘：任务号、worklog 目录 / 文件名、台账 JSON 的 `created`/`started`/`updated`/`finished`、history 行、worklog 头部「创建」行与「状态」行、封卷行、每条执行记录行。
+  - 出门：`list` / `show` / `history` 的输出（人话表格与 `--json` 同一个值）都是本机时区，**拿到的就是能直接显示的**，不要再转。
+  - 进门：`--since` / `--until` / `--created` / `--finished` 按本机墙钟给，脚本内部转 UTC 再比较 / 落盘；除这四个参数没有任何地方要调用方传时间。
+  - **过程文档正文不动**：`show --json` 的 `worklog.text` 是原文，里面的时间是当时写进去的 UTC。
+  - 存量老数据写的是写入者本地时间、无标记，无法与 UTC 区分（JSON 是 2026-10-22 前，执行记录行是 2026-10-27 前）。
 - **history 文件 11 列**：结案时间 / 创建时间 / 工作包（= `new --title` 的任务标题）/ 分类 / 标签 / owner / owner_name / creator / creator_name / 摘要 / 过程文档；排序与 `--since` / `--until` 按**结案时间**。（`history` 命令的人话输出只展示其中几列：结案时间、负责人、标题。）
 - **owner / creator 两列存的是 uuid**（与任务里一致，身份只认 uuid）；紧随其后的 `owner_name` / `creator_name` 两列**落盘**结案那一刻的显示名 —— 改名不回写旧行，看历史看到的就是当时那个名字。老行（升级前落的）没有名字时按名册兜底补一次展示值，**不回写文件**。
 

package/skill/references/troubleshooting.md

@@ -96,19 +96,19 @@
 - **「提示：当前目录不是 git 仓库，台账只写了本地文件」**：没有 git 也能用；想纳入版本管理就 `git init`，否则继续本地写（多人各写各的，后写覆盖先写）。
 - **「提示：任务 X 没有过程文档，已跳过封卷，历史末列留空」**：老数据没有 worklog 字段，结案照常，只是没有文档可封。
 - **`无需重复：这次没有新的改动。`**（`claim` / `set` / `close` 的 already_done 通道）：上次已经做成过，重跑是幂等空转；`close` 重跑还会顺手补齐上次崩在半途的封卷与移出。
-- **`validate` 的 notices**（同号任务出现在多个文件、历史解析警告、worklog 仍是骨架等）：只提示不判错，照实转述。
+- **`validate` 的 notices**（同号任务出现在多个文件、历史解析警告等）：只提示不判错，照实转述。
 
 ## validate 查什么（有问题 ⇒ 退出码 1）
 
-两档：默认**浅度**只查格式与结构（账本 JSON + 当月历史 + 每篇过程文档的模板格式）；加 **`--deep`** 才多读全部历史月份、并读正文判「还是不是空骨架」。
+两档：默认**浅度**只查格式与结构（账本 JSON + 当月历史）；加 **`--deep`** 才多读全部历史月份。**两档都不读过程文档正文**（存量可达上万篇；过程文档是附件，格式与内容不在体检范围）。
 
-problems（任一即退 1）：① 池里任务带着 owner；② 池里任务 status 不是 open/doing；③ 索引登记了身份但分片文件不在；④ 分片任务没有 owner；⑤ 分片任务 owner 与分片所属键不一致；⑥ 分片任务 status 非法；⑦ `owners/` 里有索引没登记的 `*.json`；⑧ 过程文档格式坏（第一行不是标题 / 头部缺「创建」行 / 前五节缺或顺序不对）。
-notices（只提示）：过程文档缺「执行记录」节或有重复的节、历史解析警告、历史有结案行但任务还在办、还没有 `owners.json`；`--deep` 另加「过程文档还是空骨架」。
+problems（任一即退 1）：① 池里任务带着 owner；② 池里任务 status 不是 open/doing；③ 索引登记了身份但分片文件不在；④ 分片任务没有 owner；⑤ 分片任务 owner 与分片所属键不一致；⑥ 分片任务 status 非法；⑦ `owners/` 里有索引没登记的 `*.json`。
+notices（只提示）：历史解析警告、历史有结案行但任务还在办、还没有 `owners.json`。
 ①~⑦ 里结构类的属人工裁决：读原文确认哪份是真的，删多余那份或把索引改对，**不要用脚本猜**。索引或任一 JSON 损坏 ⇒ 退 3。
 
 ## 读命令只读本地（跨机器要先取最新）
 
-- **读命令（`list` / `show` / `history` / `validate`）不会自动 `git pull`**：看到的是**这台机器上一次同步后的**台账。
+- **读命令（`list` / `show` / `history` / `whoami` / `validate`）不会自动 `git pull`**：看到的是**这台机器上一次同步后的**台账（`whoami` 连台账都不读，只看本机身份）。
 - 想看别的机器刚写的东西：先 `git pull`，或者跑任意一条写命令（写命令进入时会先取最新）。
 
 ## 写前取最新与写后同步（机制）

package/skill/scripts/ledgerkit/actions/claim.py

@@ -7,7 +7,7 @@ from pathlib import Path
 from ..core.identity import Identity, normalize
 from ..core.paths import POOL_REL, shard_rel
 from ..core.time import now
-from ..core.worklog_md import exec_line
+from ..core.worklog_md import StatusLine, exec_line
 from ..errors import Fail
 from ..store.owners_index import OwnersIndex
 from ..store.task_store import TaskStore
@@ -41,6 +41,7 @@ def claim(repo: Path, me: Identity, tid: str) -> Result:
                 logs.append_exec(
                     path,
                     exec_line(now(), me.uuid, "claim", "认领（补齐上次未完成的清理）"),
+                    status=StatusLine("doing", me.name, me.uuid, now()),
                 )
             return Result(
                 already_done=True,
@@ -72,7 +73,11 @@ def claim(repo: Path, me: Identity, tid: str) -> Result:
     logs = WorklogStore(repo)
     path = logs.find(tid, moved.get("worklog"))
     if path is not None:
-        logs.append_exec(path, exec_line(now(), me.stamp(), "claim", "认领 → doing"))
+        logs.append_exec(
+            path,
+            exec_line(now(), me.stamp(), "claim", "认领 → doing"),
+            status=StatusLine("doing", me.name, me.uuid, now()),
+        )
         note = None
     return Result(
         changed=("owner", "started", "updated"),

package/skill/scripts/ledgerkit/actions/close_task.py

@@ -12,10 +12,12 @@ from ..core.identity import Identity
 from ..core.labels import normalize_label, parse_tags
 from ..core.paths import history_path_for, shard_rel, to_repo_rel, worklog_name
 from ..core.worklog_md import (
+    StatusLine,
     append_exec_log,
     exec_line,
     has_frozen_line,
     rewrite_label_line,
+    rewrite_status_line,
     stamp_frozen,
 )
 from ..errors import Fail
@@ -99,6 +101,9 @@ def close_task(
                     frozen = append_exec_log(
                         frozen, exec_line(finished, me.stamp(), "close", "结案封卷")
                     )
+                    frozen = rewrite_status_line(
+                        frozen, StatusLine("closed", me.name, me.uuid, finished)
+                    )
                     logs.write(doc_path, frozen)
                     notes.append("补齐上次未完成的封卷。")
             if mine.get(tid) is not None:
@@ -160,6 +165,9 @@ def close_task(
                 frozen = append_exec_log(
                     frozen, exec_line(finished, me.stamp(), "close", "结案封卷")
                 )
+                frozen = rewrite_status_line(
+                    frozen, StatusLine("closed", me.name, me.uuid, finished)
+                )
                 logs.write(doc_path, frozen)
 
         # ④ 删我分片那行（永远最后）

package/skill/scripts/ledgerkit/actions/handoff.py

@@ -7,7 +7,7 @@ from pathlib import Path
 from ..core.identity import Identity, normalize
 from ..core.paths import shard_rel
 from ..core.time import now
-from ..core.worklog_md import exec_line
+from ..core.worklog_md import StatusLine, exec_line
 from ..errors import Fail
 from ..store.owners_index import OwnersIndex
 from ..store.task_store import TaskStore
@@ -62,6 +62,7 @@ def handoff(repo: Path, me: Identity, tid: str, *, to: str) -> Result:
             logs.append_exec(
                 path,
                 exec_line(now(), me.stamp(), "set", f"交接给 @{who_stamp}（补齐）"),
+                status=StatusLine("doing", to_name, to_key, now()),
             )
         return Result(
             already_done=True,
@@ -80,7 +81,9 @@ def handoff(repo: Path, me: Identity, tid: str, *, to: str) -> Result:
         note = f"任务 {tid} 已交给 {who}，但过程文档没找到，跳过执行记录。"
     else:
         logs.append_exec(
-            path, exec_line(now(), me.stamp(), "set", f"交接给 @{who_stamp}")
+            path,
+            exec_line(now(), me.stamp(), "set", f"交接给 @{who_stamp}"),
+            status=StatusLine("doing", to_name, to_key, now()),
         )
     return Result(
         changed=("owner", "owner_name", "updated"),

package/skill/scripts/ledgerkit/actions/list_tasks.py

@@ -12,7 +12,7 @@ from ..core.paths import POOL_REL
 from ..errors import Fail
 from ..store.owners_index import OwnersIndex
 from ..store.task_store import TaskStore
-from .guard import in_scope, owner_of, require_uuid, status_of
+from .guard import in_scope, is_mine, owner_of, require_uuid, status_of
 from .query import ListQuery
 from .result import ListResult, TaskRow, rel
 
@@ -52,6 +52,9 @@ def list_tasks(repo: Path, me: Identity, q: ListQuery) -> ListResult:
     kept = {
         tid: t for tid, t in rows.items() if in_scope(t, q, me=me, name_keys=name_keys)
     }
+    # 每行自带 `mine`（只比 uuid，零额外 IO）：调用方不必自己拿 uuid 再比一次
+    for task in kept.values():
+        task["mine"] = is_mine(task, me)
     table = tuple(
         TaskRow(
             tid=tid,

package/skill/scripts/ledgerkit/actions/log_progress.py

@@ -7,7 +7,7 @@ from pathlib import Path
 from ..core.identity import Identity
 from ..core.paths import shard_rel
 from ..core.time import now
-from ..core.worklog_md import exec_line
+from ..core.worklog_md import StatusLine, exec_line
 from ..errors import Fail
 from ..store.task_store import TaskStore
 from ..store.worklog_store import WorklogStore
@@ -46,7 +46,11 @@ def log_progress(repo: Path, me: Identity, tid: str, note: str) -> Result:
                 "提示：这条任务没有过程文档，已跳过执行记录（分片的最后更新已刷）。",
             ),
         )
-    ok = logs.append_exec(path, exec_line(now(), me.stamp(), "log", text))
+    ok = logs.append_exec(
+        path,
+        exec_line(now(), me.stamp(), "log", text),
+        status=StatusLine("doing", me.name, me.uuid, now()),
+    )
     if not ok:
         return Result(
             changed=("updated",),

package/skill/scripts/ledgerkit/actions/new_task.py

@@ -17,7 +17,7 @@ from ..core.paths import (
     to_repo_rel,
     worklog_rel,
 )
-from ..core.worklog_md import exec_line
+from ..core.worklog_md import StatusLine, exec_line
 from ..errors import Fail
 from ..store.atomic import ensure_dir, restore, snapshot
 from ..store.task_store import TaskStore
@@ -102,6 +102,12 @@ def new_task(
             creator=me.stamp(),
             category=category,
             tags=tag_list,
+            status=StatusLine(
+                "doing" if mine else "open",
+                me.name if mine else None,
+                me.uuid if mine else None,
+                created,
+            ),
             first_exec=exec_line(
                 created, me.stamp(), "new", "创建任务并认领" if mine else "创建任务"
             ),

package/skill/scripts/ledgerkit/actions/query_history.py

@@ -18,7 +18,7 @@ from ..core.time import now, time_key
 from ..errors import Fail
 from ..store.history_store import HistoryStore
 from ..store.owners_index import OwnersIndex
-from .guard import require_uuid
+from .guard import is_mine, require_uuid
 from .query import COUNT_CAP, HistoryQuery
 from .result import HistoryResult, rel
 
@@ -132,6 +132,8 @@ def query_history(repo: Path, me: Identity, q: HistoryQuery) -> HistoryResult:
             row["src"] = rel(repo, path)
             row["created"] = time_key(row.get("created") or "") or row.get("created")
             row["finished"] = time_key(row.get("finished") or "") or row.get("finished")
+            # 每行自带 `mine`（只比 uuid）：调用方不必自己拿 uuid 再比一次
+            row["mine"] = is_mine(row, me)
             records.append(row)
 
     index = OwnersIndex(repo)