dsh-task-ledger 0.0.125 → 0.0.127

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

@@ -0,0 +1,15 @@
+/**
+ * 任务动作（界面行内按钮 → skill 写命令）：认领、释放。
+ *
+ * 写完必须清读缓存 —— 下一屏快照要看到刚改过的归属，不能吃 1.5s 的旧值。
+ */
+import { invalidate } from "../repositories/cache.js";
+import { runTaskAction, } from "../repositories/task.repository.js";
+/**
+ * @param onStep - 过程步骤回调：路由把它写成 NDJSON 一行一行推给界面（进度翻牌）。
+ *   命令跑完 / 失败前都会先收到前面那几个阶段，界面据此换文案。
+ */
+export async function actOnTask(input, onStep) {
+    await runTaskAction(input.repo, input.id, input.action, input.summary ?? "", onStep);
+    invalidate();
+}

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

@@ -1,5 +1,5 @@
 import { type TrendBucket } from "../repositories/trend.repository.js";
-import type { LedgerWorkspace, TrendPayload, TrendView } from "../types.js";
+import type { BoardTrendGran, LedgerWorkspace, TrendPayload, TrendView } from "../types.js";
 /**
  * 跨工作区求和：同一天起止的周桶相加。
  * 工作区之间周界一致（同机同时区、都由 skill 的周一起算），所以直接按 `from` 归并。
@@ -10,4 +10,4 @@ export declare function mergeTrend(rows: readonly {
     coverageTo: string;
 }[]): TrendView;
 /** 趋势图数据：逐工作区读、坏的进 degraded，全挂给空桶（不抛）。 */
-export declare function getBoardTrend(workspaces: readonly LedgerWorkspace[]): Promise<TrendPayload>;
+export declare function getBoardTrendGran(workspaces: readonly LedgerWorkspace[], gran: BoardTrendGran): Promise<TrendPayload>;

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

@@ -1,14 +1,14 @@
 /**
- * 首页趋势图的用例：跨工作区把「近 8 周」的桶**按周求和**。
+ * 首页趋势图的用例：跨工作区把「近 26 周」的桶**按周求和**。
  *
- * 数字真源全在 skill（每工作区 `stats --trend week --last 8w`），本文件只做两件事：
+ * 数字真源全在 skill（每工作区 `stats --trend week --last 26w`），本文件只做两件事：
  * 按 `from` 把各工作区同周的数加在一起、把读挂的工作区归进 `degraded`。
  *
  * ⚠️ 这里**不抛**「全部失败」：趋势只是首页的一块图，不能因为它把 8 张卡和列表一起打成 500。
  * 全挂时返回空桶 + inherited degraded，界面显示空态（真源口径见 errors.ts 的 settleWorkspaces 注释）。
  */
 import { codeOf, messageOf } from "../errors.js";
-import { readTrend } from "../repositories/trend.repository.js";
+import { readBoardTrend } from "../repositories/trend.repository.js";
 const byFrom = (a, b) => a.from < b.from ? -1 : a.from > b.from ? 1 : 0;
 /**
  * 跨工作区求和：同一天起止的周桶相加。
@@ -63,8 +63,8 @@ export function mergeTrend(rows) {
     };
 }
 /** 趋势图数据：逐工作区读、坏的进 degraded，全挂给空桶（不抛）。 */
-export async function getBoardTrend(workspaces) {
-    const settled = await Promise.allSettled(workspaces.map((workspace) => readTrend(workspace)));
+export async function getBoardTrendGran(workspaces, gran) {
+    const settled = await Promise.allSettled(workspaces.map((workspace) => readBoardTrend(workspace, gran)));
     const rows = [];
     const degraded = [];
     settled.forEach((result, i) => {

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

@@ -0,0 +1,10 @@
+import type { LedgerWorkspace, RegistryWorkspace } from "../types.js";
+/**
+ * 台账目录发现（用户 2026-11-01 改口径）：**按机器级清单读**，不再按宿主工作区读。
+ *
+ * 宿主 registry 只剩一件事：替清单**补登记**（扫到的工作区里清单还没有的，加进去）。
+ * 补登记只在 `sync = true` 时做（用户 2026-11-03：进看板 + 手动刷新，一共两处；其余请求
+ * 一律只读清单 —— 每请求起一个进程只为对比工作区，纯浪费）。
+ * 隐藏 = 全局不看，过滤只在这里做一次 —— 下游（统计卡 / 趋势 / 列表 / 名册）全吃这个输出。
+ */
+export declare function resolveWorkspaces(registryList: readonly RegistryWorkspace[], sync?: boolean): Promise<LedgerWorkspace[]>;

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

@@ -0,0 +1,28 @@
+import { addDir, readDirs } from "../repositories/dirs.repository.js";
+/**
+ * 台账目录发现（用户 2026-11-01 改口径）：**按机器级清单读**，不再按宿主工作区读。
+ *
+ * 宿主 registry 只剩一件事：替清单**补登记**（扫到的工作区里清单还没有的，加进去）。
+ * 补登记只在 `sync = true` 时做（用户 2026-11-03：进看板 + 手动刷新，一共两处；其余请求
+ * 一律只读清单 —— 每请求起一个进程只为对比工作区，纯浪费）。
+ * 隐藏 = 全局不看，过滤只在这里做一次 —— 下游（统计卡 / 趋势 / 列表 / 名册）全吃这个输出。
+ */
+export async function resolveWorkspaces(registryList, sync = false) {
+    let dirs = await readDirs();
+    if (sync) {
+        const known = new Set(dirs.map((dir) => dir.path));
+        for (const workspace of registryList) {
+            if (known.has(workspace.path))
+                continue;
+            // 串行：读改写同一个文件，并发会互相覆盖（skill 侧虽有锁，最后写入者仍可能少几条）
+            const added = await addDir(workspace.path, workspace.title);
+            known.add(workspace.path);
+            if (added.added)
+                dirs = added.dirs;
+        }
+    }
+    return dirs.filter((dir) => !dir.hidden).map(toWorkspace);
+}
+function toWorkspace(dir) {
+    return { id: dir.path, title: dir.name, path: dir.path };
+}

package/dist/host/types.d.ts

@@ -5,15 +5,30 @@
  * 比绑死官方类型更稳）。
  */
 import type { DegradedInfo } from "./errors.js";
-/** 一个活跃台账工作区：宿主 registry 条目 + 本地探测（含 `ledger/`）。 */
+/** 一个可看的台账：机器级清单里的一条（已去掉隐藏）。 */
 export interface LedgerWorkspace {
-    /** 宿主工作区 id。 */
+    /** 台账目录绝对路径（清单条目没有别的唯一标识，路径本身就唯一；历史筛选 / 缓存键都用它）。 */
     readonly id: string;
-    /** 宿主 title（允许重名）。 */
+    /** 显示名：清单里的 name，没写就是目录名（默认名由 skill 算好，插件不重算）。 */
     readonly title: string;
-    /** canonical 绝对路径（宿主已 realpath 归一；skill 脚本 --repo 直传它）。 */
+    /** 台账目录绝对路径（skill 脚本 --repo 直传它）。 */
     readonly path: string;
 }
+/**
+ * 宿主 `workspaceRegistry.list()` 条目的最小面（结构声明；事实与坐标见
+ * external/dsh-workspace-registry.md）。它现在只承担「替台账清单补登记」一件事。
+ */
+export interface RegistryWorkspace {
+    readonly id: string;
+    readonly title: string;
+    readonly path: string;
+    /**
+     * 把会话登记进本工作区的 `sessionIds`（会话归组的唯一途径）。
+     * ⚠️ 只设 `meta.cwd` **不会**自动归组（reference: dsh-task-dispatch-table 决策 22 真机结论）；
+     * 宿主旧版本可能没有该面 ⇒ optional，调用方按缺失降级并如实回报。
+     */
+    readonly attachSession?: (sessionId: string) => Promise<void>;
+}
 /** 任务对象的原始字段（skill 脚本 list --json 的值形状；缺字段按可选处理）。 */
 export interface TaskRecord {
     title?: string;
@@ -117,7 +132,9 @@ export interface StatsPayload {
     readonly stats: BoardStatsView;
     readonly degraded: readonly DegradedInfo[];
 }
-/** 一个人在一个周桶里的三个数（新增按 creator、完成 / 未结按 owner，都是 skill 的口径）。 */
+/** 首页趋势图的周期粒度（日 / 周；历史页那档 month 这里不要，见 HistoryGran）。 */
+export type BoardTrendGran = "day" | "week";
+/** 一个人在一个周期桶里的三个数（新增按 creator、完成 / 未结按 owner，都是 skill 的口径）。 */
 export interface TrendOwnerCounts {
     readonly added: number;
     readonly done: number;
@@ -145,6 +162,89 @@ export interface TrendView {
 export interface TrendPayload extends TrendView {
     readonly degraded: readonly DegradedInfo[];
 }
+/** 历史趋势的周期粒度（一根柱 = 一个周期；桶的切分与口径全在 skill）。 */
+export type HistoryGran = "day" | "week" | "month";
+/** 历史趋势里某工作区一个周期内的结案数。 */
+export interface HistoryWorkspaceCell {
+    readonly done: number;
+    readonly cancelled: number;
+}
+/**
+ * 历史页顶部的一个周期桶：**数字真源是 skill `stats --trend <gran>`**，
+ * host 只做跨工作区求和（用户 2026-10-30 定：不自己写聚合算法）。
+ */
+export interface HistoryBucket {
+    /** 周期起始日（日 = 当天、周 = 周一、月 = 1 号；skill 口径）。 */
+    readonly key: string;
+    /** 周期结束日（含边界；skill 口径，浮卡的区间标题用）。 */
+    readonly to: string;
+    readonly done: number;
+    readonly cancelled: number;
+    /** 该周期新建（含在办 / 待认领）。 */
+    readonly added: number;
+    /** 工作区 id → 该区该周期的 done / cancelled（分色用）。 */
+    readonly byWorkspace: Readonly<Record<string, HistoryWorkspaceCell>>;
+}
+/** 一个周期的结案拆分（合计 = done + cancelled）—— 小字要分别显示「完成 / 取消」。 */
+export interface PeriodCount {
+    readonly done: number;
+    readonly cancelled: number;
+}
+/** 历史页顶部数显（host 从 day 桶求和：今日 / 昨日 / 本周 / 上周 / 本月 / 上月 / 本季度 / 上季度）。 */
+export interface HistoryTotals {
+    readonly today: PeriodCount;
+    readonly yesterday: PeriodCount;
+    readonly week: PeriodCount;
+    readonly lastWeek: PeriodCount;
+    readonly month: PeriodCount;
+    readonly lastMonth: PeriodCount;
+    readonly quarter: PeriodCount;
+    readonly lastQuarter: PeriodCount;
+}
+/** 历史页顶部数据：当前粒度的桶序列 + 4 数显。
+ *  桶只覆盖最近 365 天（skill 的 day 粒度上限）；更早的窗口由前端按 key 补空槽。 */
+export interface HistoryTrendView {
+    readonly workspaces: readonly {
+        readonly id: string;
+        readonly title: string;
+    }[];
+    /** 桶序列（升序；空桶 = 该周期无结案）。 */
+    readonly buckets: readonly HistoryBucket[];
+    readonly totals: HistoryTotals;
+}
+/** 历史日趋势 + 降级。 */
+export interface HistoryTrendPayload extends HistoryTrendView {
+    readonly degraded: readonly DegradedInfo[];
+}
+/** 一条已结案记录（skill `history --json` 的 records 项 + 工作区身份）。 */
+export interface HistoryRecord {
+    /** 唯一键 `${src}:${line}`：翻页时跨页重复的那几条靠它去重。 */
+    readonly key: string;
+    readonly workspaceId: string;
+    readonly workspaceTitle: string;
+    readonly title: string;
+    readonly summary: string;
+    readonly category: string;
+    readonly tags: readonly string[];
+    /** done / cancelled（skill 口径）。 */
+    readonly result: string;
+    readonly owner: string;
+    readonly ownerName: string;
+    readonly creator: string;
+    readonly creatorName: string;
+    readonly created: string;
+    readonly finished: string;
+    /** 过程文档绝对路径；空串 = 这行没有 worklog，不可点开。 */
+    readonly filePath: string;
+}
+/** `/history/list` 响应：选中那个月的结案记录（按结案时间正序）。
+ *  分页不在这里做 —— 整月一次下发，前端按行号做虚拟滚动。 */
+export interface HistoryListPayload {
+    readonly records: readonly HistoryRecord[];
+    /** 窗口内记录超过读取上限（一年 5000 条）：此时列表底部不再追加。 */
+    readonly capped: boolean;
+    readonly degraded: readonly DegradedInfo[];
+}
 /** 一个工作区的花名册（skill `owners --json`：含当前没任务的人）。 */
 export interface WorkspaceOwners {
     readonly workspaceId: string;
@@ -161,8 +261,10 @@ export interface WorkspaceOwners {
  * 前端只筛不判。
  */
 export interface BoardHomePayload extends StatsPayload {
-    /** 首页右侧趋势图（近 8 周）。 */
+    /** 首页右侧趋势图（近 26 周）。 */
     readonly trend: TrendView;
+    /** 同一段时间的**日档**桶（近 26 周的天数）：两份一起下发 ⇒ 切「日 / 周」零请求。 */
+    readonly trendDay: TrendView;
     readonly workspaces: readonly LedgerWorkspace[];
     readonly tasks: readonly TaskRow[];
     readonly identities: Readonly<Record<string, string | null>>;

package/dist/index.d.ts

@@ -4,6 +4,8 @@ interface PluginContext {
     inject(deps: readonly string[], callback: (ctx: Record<string, unknown>) => void): void;
     /** 组合内副作用：进入时 setup、离开时执行返回的清理函数（cordis 核心面）。 */
     effect(setup: () => (() => void) | undefined): void;
+    /** 按名取服务（取不到给 undefined）。**读属性**在未 inject 的模块上会直接 throw ⇒ 见 serviceOf。 */
+    get(name: string): unknown;
 }
 export declare function apply(ctx: PluginContext): void;
 export {};

package/dist/index.js

@@ -9,9 +9,27 @@
  * 满足不了的依赖会令 entry 一直 pending、卡死整个 dsh 启动）；两条注入线
  * 互相独立——skills 缺席不挡数据面，反之亦然。
  */
-import { registerRoutes, } from "./host/routes.js";
+import { serveFsRoute } from "dsh-plugin-core/host";
+import { FS_ROUTE, registerRoutes } from "./host/routes.js";
 import { buildSkillRegistration, } from "./host/skill/registration.js";
 export const name = "dsh-task-ledger";
+/**
+ * 「继续」用的宿主服务读取器：**现取、不预先注入**。
+ *
+ * 为什么不写进 `ctx.inject([...])` 的依赖表：cordis 里任一依赖缺席，整个回调永远 pending，
+ * 数据面会跟着一起消失（参考插件真机教训）。这些服务缺席只该让「继续」这一个动作报人话。
+ * 另外 ctx 的命名空间属性是 getter，未 inject 时读取直接 throw ⇒ 这里归一成 undefined。
+ */
+function serviceOf(ctx, name) {
+    return () => {
+        try {
+            return ctx.get(name);
+        }
+        catch {
+            return undefined;
+        }
+    };
+}
 export function apply(ctx) {
     // ── 数据面（任务 3） ──
     ctx.inject(["workspaceRegistry", "webServer"], (services) => {
@@ -21,9 +39,19 @@ export function apply(ctx) {
             console.warn("[task-ledger] workspaceRegistry / webServer 未就位，数据面路由不注册");
             return;
         }
-        registerRoutes(webServer, { registry });
-        console.info("[task-ledger] 数据面路由已注册（读 /api/task-ledger/workspaces、/board/snapshot）");
+        registerRoutes(webServer, {
+            registry,
+            // 「继续」要起会话：agents / agentPresets / agentDefaultModel 三者按需现取
+            agents: serviceOf(ctx, "agents"),
+            presets: serviceOf(ctx, "agentPresets"),
+            defaultModel: serviceOf(ctx, "agentDefaultModel"),
+            sessionTitle: serviceOf(ctx, "sessionTitle"),
+        });
+        console.info("[task-ledger] 数据面路由已注册（读 /api/task-ledger/workspaces、/board/snapshot；写 /task/action、/task/continue）");
     });
+    // ── 只读文件路由（核心 explorer 的数据面：选目录弹窗 + 文件预览都吃它） ──
+    // 官方 workspaceFiles 只能在各自工作区内列目录，选台账目录要能走全盘 ⇒ 用核心这条。
+    serveFsRoute(ctx, { path: FS_ROUTE });
     // ── skill 全局注册（任务 2） ──
     // unscoped 注册落全局层，模型可 load；disposer 随插件 dispose 自动注销。
     ctx.inject(["skills"], (services) => {

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "dsh-task-ledger",
-	"version": "0.0.125",
+	"version": "0.0.127",
 	"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",
@@ -57,6 +57,6 @@
 		}
 	},
 	"dependencies": {
-		"dsh-plugin-core": "^0.10.0"
+		"dsh-plugin-core": "^0.26.0"
 	}
 }

package/skill/SKILL.md

@@ -278,7 +278,7 @@ allowed-tools: Read,Edit,Bash,Grep
 
 干什么：本机身份的只读查询，**不依赖 `--repo`、不写任何文件**，回答「这台机器上我是谁」。需要自己的 uuid 时用它（转述给别人、核对 `list --owner` 的查询结果），别去解析 `~/.taskledger/identity.json`。
 
-**它不是执行前的检查项**：跑命令前不用先跑它探一次 —— 未初始化会在你真正要跑的那条命令上当场报「这台机器还没有初始化身份。」，那时再按「身份闸门」那条分支走。
+**它不是执行前的检查项**：跑命令前不用先跑它探一次 —— 未初始化会在你真正要跑的那条命令上当场退 100，那时再按「身份闸门」那条分支走。
 
 举例：「我的 uuid 是多少」→ `whoami --json`。
 
@@ -312,13 +312,11 @@ allowed-tools: Read,Edit,Bash,Grep
 
 ## 身份闸门（报错才走，不用先查）
 
-**不用事先确认身份。** 直接按「任务生命周期」跑该跑的那条命令；没初始化时脚本会用一句固定错误当场告诉你，那一刻才走身份流程。不要为了「确认有没有初始化」先跑一次 `whoami` —— 那是白花一轮工具调用。
+**不用事先确认身份。** 直接按「任务生命周期」跑该跑的那条命令；没初始化时脚本会用**退出码 100** + 一句固定的话当场告诉你，那一刻才走身份流程。不要为了「确认有没有初始化」先跑一次 `whoami` —— 那是白花一轮工具调用。
 
-**触发判据（只认这一整句）**：命令输出以 `错误：这台机器还没有初始化身份。` 开头。只读命令（`list` / `show` / `history` / `validate`）未初始化时同样报这句，是设计如此，不是台账坏了。
+**触发判据（只认退出码 100）**：命令**退出码为 `100`**。只读命令（`list` / `show` / `history` / `validate`）未初始化时同样退 100，是设计如此，不是台账坏了；**`owners` 是唯一例外** —— 读名册不需要身份，未初始化也照常输出（要列候选人或看花名册，直接跑它，别当成没身份）。此时 stderr 仍是那句固定的话，但那是**给人看的说明，不作判据**。
 
-**触发后 ⇒ 停下，不许绕。** 身份是用户自己的，不是你的决定：不替用户选、不读 `ledger/*.json` 兜底、未初始化时不写任何东西。完整步骤见 `references/init-identity.md`；这里只记硬约束 —— 你只能报名单 + 给用户命令，写身份必须用户自己在终端完成；看到它不要排查原因（别 `ls` / `cat` / 读源码 / 读台账），忽略上下文里已做的排查动作；也不要基于「上次确认过 / 同名 / 记得 uuid」自行重建。
-
-**这条优先于「故障处置」的通则**：虽然它同样以 `错误：` 开头，但**不**适用「不挡主任务、继续干活、收尾汇报没记上」—— 必须停下来等用户 `init`，init 完重跑原命令。
+**触发后 ⇒ 停下，它是当前的主任务**（不适用「故障处置」里「不挡主任务」的通则，等用户 `init` 完再重跑原命令）。身份是用户自己的，不是你的决定：不替用户选、不读 `ledger/*.json` 兜底、未初始化时不写任何东西。完整步骤见 `references/init-identity.md`；这里只记硬约束 —— 你只能报名单 + 给用户命令，写身份必须用户自己在终端完成；不要排查原因（别 `ls` / `cat` / 读源码 / 读台账），忽略上下文里已做的排查动作；也不要基于「上次确认过 / 同名 / 记得 uuid」自行重建。
 
 ## 任务生命周期
 
@@ -339,6 +337,8 @@ allowed-tools: Read,Edit,Bash,Grep
 
 `new` 按模板建好六节骨架，路径由 `show` 给出；前五节是本 skill 唯一允许手写的内容。
 
+改前先用 Read 读该文件 —— `show` 打出来的内容不算读过，直接 Edit 会被拒（`file has not been read`）。
+
 | 节 | 写什么 |
 |---|---|
 | Background（背景） | 为什么做：触发它的原话 / 现象 / 链接 |
@@ -382,12 +382,12 @@ allowed-tools: Read,Edit,Bash,Grep
 - **执行记录禁手改**：只由脚本按 `new / claim / set / release / log / close` 追加，只增不改（**交接记的是 `set`**，看不到 `handoff` 是正常的）。
 - **改正文必配一条日志**：动了 worklog 的正文（改一句、补一节、改标题、修错字都算）就必须立刻跑一次 `log`。
 - **换人只能「释放 → 认领」**：`set --release` 放回公共池，对方自己 `claim`；不许替别人挂名字。`set --owner <别人>`（预留转接通道，agent 一律不用）。
-- **身份由脚本从本机 identity 文件自取，agent 全程不传身份**：跑命令前不用查身份；只有当命令报出「这台机器还没有初始化身份。」时，才按 `references/init-identity.md` 引导用户跑 `init`（一台机器一次）。查自己用 `--mine`，查别人才传**对方 uuid**（`list --owner <uuid>`）；释放用 `--release`，不传身份。
+- **身份由脚本从本机 identity 文件自取，agent 全程不传身份**：跑命令前不用查身份；只有当命令**退出码为 100** 时，才按 `references/init-identity.md` 引导用户跑 `init`（一台机器一次）。查自己用 `--mine`，查别人才传**对方 uuid**（`list --owner <uuid>`）；释放用 `--release`，不传身份。
 - **身份只用 uuid，名字只用于显示与筛选**：认领 / 释放 / 交接 / 查「我的」一律只比 uuid；`--owner` 传名字会当场报错，要按人模糊找就用 `--owner-name <片段>`（子串、不分大小写）。名字是冗余字段（改名不影响归属），别拿它当身份用。
 
 ### 人类授权（跑之前问不问）
 
-项目没有 `ledger/` ⇒ 先问「要不要建个台账记这活？」，不许自建。用户同意 ⇒ 直接跑第一条写命令，且**必须带 `--repo <工作区根>`**（根是直接含有 `ledger/` 的那个目录，`ledger/` 本身不是根、指到它会被拒绝）：不带时脚本只从当前目录逐级往上找第一个含 `ledger/` 的目录，一个都没有就退 1 报「找不到台账」，绝不就地建；台账由这条写命令顺带建出来，身份**不用事先确认** —— 没 `init` 过，这条命令会当场报「这台机器还没有初始化身份。」，按「身份闸门」走一遍就好（一台机器一次，写本机身份，与台账无关）。之后可以不带 `--repo`，但查找是**逐级往上**的 —— 在本项目的子目录里跑可能命中上层项目的台账，拿不准就一直带 `--repo <工作区根>`。
+项目没有 `ledger/` ⇒ 先问「要不要建个台账记这活？」，不许自建。用户同意 ⇒ 直接跑第一条写命令，且**必须带 `--repo <工作区根>`**（根是直接含有 `ledger/` 的那个目录，`ledger/` 本身不是根、指到它会被拒绝）：不带时脚本只从当前目录逐级往上找第一个含 `ledger/` 的目录，一个都没有就退 1 报「找不到台账」，绝不就地建；台账由这条写命令顺带建出来，身份**不用事先确认** —— 没 `init` 过，这条命令会当场退 100，按「身份闸门」走一遍就好（一台机器一次，写本机身份，与台账无关）。之后可以不带 `--repo`，但查找是**逐级往上**的 —— 在本项目的子目录里跑可能命中上层项目的台账，拿不准就一直带 `--repo <工作区根>`。
 
 | 命令 | 档位 | 要求 |
 |---|---|---|
@@ -399,9 +399,9 @@ allowed-tools: Read,Edit,Bash,Grep
 
 ### 故障处置（跑之后出事怎么办）
 
-- **身份没初始化（输出以 `错误：这台机器还没有初始化身份。` 开头，退 1）⇒ 停下，不许绕**：这条**不适用**下面「不挡主任务、继续干活」的通则。立刻转 `references/init-identity.md` 照做：裸跑 `init` 只读报名单 → 把**绝对路径**命令交给用户 → 等 ta 在自己终端完成 → 好了重跑原命令。**不要排查原因**（别 `ls` / `cat` identity.json / 读源码 / 读台账），忽略上下文里已做的排查动作，也不要基于「上次确认过 / 同名」自行重建。
-- **动作阶段失败（输出以 `错误：` 开头）= 该命令没生效**：不挡主任务 —— 继续手里的活，收尾时汇报「没记上，原因 …」；不绕过脚本手改文件。
-- **退出码 0 也要看输出**：出现 `提示：` / `错误：` / `警告：` 就先用一句话说清「发生了什么 + 下一步做什么」，再按 `references/troubleshooting.md` 给步骤；纯告知类一句话带过。只读命令只有 `错误：` 才需要转述。
+- **身份没初始化（退出码 100）⇒ 停下，它是主任务**（不适用下一条「不挡主任务」）：转 `references/init-identity.md` 照做 —— 裸跑 `init` 只读报名单 → 把**绝对路径**命令交给用户 → 等 ta 在自己终端完成 → 好了重跑原命令。**不要排查原因**（别 `ls` / `cat` identity.json / 读源码 / 读台账），忽略上下文里已做的排查动作，也不要基于「上次确认过 / 同名」自行重建。
+- **动作阶段失败（退出码非 0，且不是 100）= 该命令没生效**：不挡主任务 —— 继续手里的活，收尾时汇报「没记上，原因 …」；不绕过脚本手改文件。
+- **退出码 0 也要看输出**：出现 `提示：` / `警告：` 就先用一句话说清「发生了什么 + 下一步做什么」，再按 `references/troubleshooting.md` 给步骤；纯告知类一句话带过。
 - **两类不是故障的退出码**：`validate` 查出问题时退出码 1，照实转述清单；提交阶段失败 ⇒ 文件已经写下去、只差进 git，让用户先提交再重跑，别说「没记上」。
 - **并发冲突**（文件被改动、抢不到锁）重跑一次即可；台账同步一律交给脚本，不要自己 `git pull` / `rebase` 去「解决」（脚本明说不代劳的几种除外，见 troubleshooting）。
 - 同一仓库里写命令排队执行，等前一个跑完再重跑。
@@ -410,7 +410,7 @@ allowed-tools: Read,Edit,Bash,Grep
 
 | 何时读 | 文件 |
 |---|---|
-| 任何非 0 退出、退出码 0 但有 `提示：` / `错误：` / `警告：`、并发冲突、`validate` 报错 | `references/troubleshooting.md` |
+| 任何非 0 退出、退出码 0 但有 `提示：` / `警告：`、并发冲突、`validate` 报错 | `references/troubleshooting.md` |
 | 传 `--created` / `--finished` 补录时间、看 `--json` 里的时间字段、查别人时 owner 匹配异常、看 history 列义 / 时间窗口口径 | `references/state-model.md` |
 | 拿不准一条记录够不够格、`--note` 不会写 | `references/log-note.md` |
-| 命令返回「这台机器还没有初始化身份。」（退 1，输出以 `错误：` 开头） | `references/init-identity.md` |
+| 命令退出码 100（这台机器还没有身份） | `references/init-identity.md` |

package/skill/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "task-ledger",
-	"version": "1.3.46",
+	"version": "1.3.48",
 	"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/init-identity.md

@@ -1,6 +1,6 @@
 # 未初始化身份时怎么走
 
-触发：任何命令返回「这台机器还没有初始化身份」。身份是用户自己的，**不是你的决定**。
+触发：任何命令**退出码为 100**。身份是用户自己的，**不是你的决定**。
 
 **触发后立刻照做，不要探索。** 除「裸跑 init 只读报名单」外，不要 `ls` / 扫描仓库、不要 `cat identity.json`、不要读任何目录或文件，不要猜身份。
 

package/skill/references/troubleshooting.md

@@ -88,7 +88,7 @@
 
 ### 只提示、不拦（退出码 0）
 
-- **（「这台机器还没有初始化身份。」不在此列** —— 它是退 1 的硬拦，见「身份闸门」。）
+- **（「这台机器还没有初始化身份。」不在此列** —— 它是**退出码 100** 的硬拦，见「身份闸门」。）
 - **「提示：格式版本是 … 当前是 …；不拦，但字段可能有出入」**：数据是旧版本写的，功能照常；想统一就按提示升版本。
 - **「提示：写前把本地快进到 …（N 个提交，仅 fast-forward）」**：纯告知。
 - **「提示：写前快进到 … 没成功（工作树有未提交改动），改为只刷新本次要写的台账文件」**：没碍事，照写。

package/dist/host/workspace.d.ts

@@ -1,20 +0,0 @@
-import type { LedgerWorkspace } from "./types.js";
-/** 宿主 workspaceRegistry.list() 条目的最小面（结构声明；事实与坐标见 external/dsh-workspace-registry.md）。 */
-export interface RegistryWorkspace {
-    readonly id: string;
-    readonly title: string;
-    readonly path: string;
-    /**
-     * 把会话登记进本工作区的 `sessionIds`（会话归组的唯一途径）。
-     * ⚠️ 只设 `meta.cwd` **不会**自动归组（reference: dsh-task-dispatch-table 决策 22 真机结论）；
-     * 宿主旧版本可能没有该面 ⇒ optional，调用方按缺失降级并如实回报。
-     */
-    readonly attachSession?: (sessionId: string) => Promise<void>;
-}
-/**
- * 工作区发现：宿主 registry 全量 → 逐个问 skill `root`（这个目录是不是台账根），
- * 只留是的。没有 `ledger/` 的目录后端不可见（2026-10-17 拍板）。
- *
- * 探测走 repository 的 hasLedger()——本文件不碰 node:fs（IO 唯一出口纪律）。
- */
-export declare function resolveWorkspaces(registryList: readonly RegistryWorkspace[]): Promise<LedgerWorkspace[]>;

package/dist/host/workspace.js

@@ -1,17 +0,0 @@
-import { hasLedger } from "./repositories/ledger.repository.js";
-/**
- * 工作区发现：宿主 registry 全量 → 逐个问 skill `root`（这个目录是不是台账根），
- * 只留是的。没有 `ledger/` 的目录后端不可见（2026-10-17 拍板）。
- *
- * 探测走 repository 的 hasLedger()——本文件不碰 node:fs（IO 唯一出口纪律）。
- */
-export async function resolveWorkspaces(registryList) {
-    const flags = await Promise.all(registryList.map((workspace) => hasLedger(workspace.path)));
-    return registryList
-        .filter((_, index) => flags[index])
-        .map((workspace) => ({
-        id: workspace.id,
-        title: workspace.title,
-        path: workspace.path,
-    }));
-}