dsh-task-ledger 0.0.99 → 0.0.101

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "dsh-task-ledger",
-	"version": "0.0.99",
+	"version": "0.0.101",
 	"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",

package/skill/SKILL.md

@@ -1,7 +1,7 @@
 ---
 name: task-ledger
 description: 本地任务台账，跨会话记录在办任务的归属、进度与起止。当用户要登记一件新的事（新建任务 / 建个坑 / 这活我领了）、记录已有任务的进展（接着做 / 记一条进展 / 这轮先记下）、查看任务状态或历史（现在该做什么 / 这活谁在做 / 上周做过什么）、给任务结案或退回（做完了 / 验收通过 / 不做了 / 退回待认领）、整理标签或检查台账一致性时加载；只是改代码、讨论方案时不要用。
-version: 1.3.25
+version: 1.3.27
 allowed-tools: Read,Edit,Bash,Grep
 ---
 
@@ -41,15 +41,15 @@ allowed-tools: Read,Edit,Bash,Grep
 
 | 参数 | 含义 |
 |---|---|
-| `--title "…"` | 任务标题（必填）—— 写任务核心、一句话说清干啥；它用来生成任务号和过程文件名，建议 4~20 字 |
+| `--title "…"` | 任务标题（必填）—— 写任务核心、一句话说清干啥，不要拿分类名当标题；它用来生成任务号和过程文件名，建议 4~20 字 |
 | `--id` | 自定义任务号（一般不传；只能用小写字母、数字、汉字和连字符） |
 | `--created` | 给过去漏记的任务补建时，补录实际创建日期（`YYYY-MM-DD`） |
 | `--self` | 建并认领：直接归自己名下、状态「进行中」。仅当用户明确说「并开始做 / 并执行」时才用（判定见生命周期第 2 条） |
-| `--category` / `--tags` | 分类 / 标签，口径见本节末尾 |
+| `--category` / `--tags` | 分类 / 标签，**只在建任务时能设分类**，口径见本节末尾 |
 
 干什么：建任务、按模板建好过程文档。不加 `--self` = 只建，落公共池等认领；加 `--self` = 建并认领。
 
-分类 / 标签口径（`new` / `set` / `close` 共用这组参数）：`--category` 答「是什么类型」，单值，中文 ≤4 字 / 纯英文 ≤3 词，吃不准写「其他」；`--tags` 答「涉及什么」，0~5 个、逗号分隔，写不出就不传（传空串等于没传）。tags 不许写 category 的同义词；查询用 tags（包含匹配，见 `list --tag`）。名词性短语、中文优先。**建任务时没写、后来想补就用 `set --category` / `--tags`**（在办任务随时可改）；结案时 `close` 写的值会覆盖成终值并进历史行。正例：`--category 缺陷修复 --tags "镜像拉取,超时重试"`；反例：`--category 已完成登录修复`、`--tags 修 bug`。
+分类 / 标签口径（`--category` 只有 `new` 有；`--tags` 三个命令都有）：`--category` 答「是什么类型」，单值，中文 ≤4 字 / 纯英文 ≤3 词，吃不准写「其他」，**建任务时给一次，之后谁都改不了**（`set` / `close` 没有这个参数，历史行里就是建任务时那个值；标题与创建时间同理，建完即不可变）。`--tags` 答「涉及什么」，0~5 个、逗号分隔，写不出就不传（传空串等于没传），随时可改。**分类只进台账与历史**（`list` / `history` 看得到），**不写进过程文档**；过程文档头部只有标签行，标签可以涵盖分类（「建设」「修改」这类词直接当标签写）。查询用 tags（包含匹配，见 `list --tag`）。名词性短语、中文优先。正例：`--category 缺陷修复 --tags "镜像拉取,超时重试"`；反例：`--category 已完成登录修复`、`--tags 修 bug`。
 
 举例：用户说「新建个任务：把发布流程走通」→ `new --title "把发布流程走通"`（只建，不认领）；用户明确说「新建个任务并开始做」→ `new --title "把发布流程走通" --self`。
 
@@ -63,24 +63,25 @@ allowed-tools: Read,Edit,Bash,Grep
 
 举例：用户说「这活我领了」→ `claim --id 20261023-1117-把发布流程走通-7f3a`。
 
-### set — 释放任务 / 改分类标签
+### set — 释放任务 / 改标签
 
 | 参数 | 含义 |
 |---|---|
 | `--id <任务号>` | 哪条任务（必填） |
 | `--release` | 释放回公共池（不带人） |
 | `--owner <别人的uuid>` | 把任务转交给对方（预留通道，**agent 不用**，见纪律；只收 uuid，传名字当场报错） |
-| `--category <分类>` | 改分类（改过程文档头部「分类/标签」行 + 分片字段） |
-| `--tags <a、b>` | 改标签（顿号 / 逗号分隔，最多 5 个） |
+| `--tags <a、b>` | 改标签（顿号 / 逗号分隔，最多 5 个；写台账字段 + 过程文档头部标签行） |
 
 干什么：两组用法，**不能混在一次调用里** ——
 
 - `--release` / `--owner`：改归属。释放回公共池、状态回「待认领」，别人即可认领；没有单独的「改状态」入口。**这两个必须二选一、不能同给**。
-- `--category` / `--tags`：改分类标签。只改自己名下**在办**任务；给了哪个就替换哪个，没给的沿用原值；头部那行没有就插到最上面，有就原地改。已结案（在历史里）的任务改不了。
+- `--tags`：改标签。只改自己名下**在办**任务；给了就整组替换（没给的标签等于删掉）。同时改台账与过程文档头部那行（没有就插到最上面，有就原地改）。已结案（在历史里）的任务改不了。
+
+**没有改分类的入口**：分类建任务时定死，`set` / `close` 都没有 `--category`。
 
 只给 `--id` 会报错，要求你指明要做哪件事。
 
-举例：用户明确说「把这个任务退回去」→ `set --id <任务号> --release`；「这任务归到建设类、打上台账标签」→ `set --id <任务号> --category 建设 --tags 台账、看板`。
+举例：用户明确说「把这个任务退回去」→ `set --id <任务号> --release`；「给这任务打上台账标签」→ `set --id <任务号> --tags 台账、看板`。
 
 ### log — 记一条进展
 
@@ -100,7 +101,7 @@ allowed-tools: Read,Edit,Bash,Grep
 | `--id <任务号>` | 结哪条（必填） |
 | `--summary "…"` | 结案摘要（必填；放弃写「放弃：原因」） |
 | `--finished` | 给漏记的旧任务补用时，补录实际结案时间（`YYYY-MM-DD[ HH:MM[:SS]]`） |
-| `--category` / `--tags` | 覆盖分类 / 标签终值（写进历史行） |
+| `--tags` | 覆盖标签终值（写进历史行；文档头部只写标签）。分类不可改，历史行用它建任务时的值 |
 
 干什么：结案并封卷过程文档、移出自己名下。**封卷后只读**（见生命周期第 8 条）。
 
@@ -214,16 +215,16 @@ python3 <本 SKILL.md 所在目录>/scripts/progress.py <子命令> --repo <工
 
 - 「执行记录」节名一个字都别动；老文档缺这一节也不用补。
 - 过程文档找不到时 `log` 只提示不失败；用 `show` 查路径，不要手写。
-- 头部是四行，由脚本维护、**都不要手改**，顺序固定 `分类/标签 → 状态 → 创建 → 封卷`，值一律 `· ` 分隔：
+- 头部是四行，由脚本维护、**都不要手改**，顺序固定 `标签 → 状态 → 创建 → 封卷`，值一律 `· ` 分隔：
 
   ```markdown
-  - **分类**：建设 · **标签**：DSH、台账
+  - **标签**：建设、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`），不用补。
+  标签行与封卷行不一定有（没给标签、没结案就没有）。老文档头部可能还带着「**分类**」段，那是旧格式，不用补也不用改（脚本下次改写标签行时会一并清掉）。老文档没有状态行是合法的（`show` 回退查在办，`--json` 标 `legacy: true`），不用补。
 - 执行记录行格式 `- 时间（UTC） · 类型 · @谁 · 说明`，`@谁` 是这次动手的人、不是任务现归属；只追加、不改旧行。行首「类型」是脚本内部动作名（会见到 `release`，它就是 `set --release`）；认不出就别当成新命令，按 `--help` 查。
 - 只改某条任务的正文：`show --id <任务号>` 拿路径直接改，不另建 md；已结案的用 `history --months 12 --json` 找回链接（**人话输出里没有链接，必须加 `--json`**）——默认只查近 3 个月，结案久了的要显式放大窗口；只读不改。
 

package/skill/assets/worklog.md

@@ -3,8 +3,8 @@
 - **状态**：<status>
 - **创建**：<created> · @<creator>
 
-<!-- 头部四行由脚本维护，顺序固定：分类/标签 → 状态 → 创建 → 封卷。
-     「- **分类**：… · **标签**：…」按 new --category / --tags 插在最上面，两者皆空则不写；
+<!-- 头部四行由脚本维护，顺序固定：标签 → 状态 → 创建 → 封卷。
+     「- **标签**：…」按 new --tags 插在最上面，没有标签就不写（分类只进台账与历史，不进本文档）；
      「- **封卷**：…」在结案时加在最后。 -->
 
 ## 背景

package/skill/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "task-ledger",
-	"version": "1.3.25",
+	"version": "1.3.27",
 	"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

@@ -30,7 +30,7 @@ close             → 历史层 + 封卷 + 移出自己名下
   - 进门：`--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` 命令的人话输出只展示其中几列：结案时间、负责人、标题。）
+- **history 文件 11 列**：结案时间 / 创建时间 / 标题 / 分类 / 标签 / owner / owner_name / creator / creator_name / 摘要 / 过程文档；排序与 `--since` / `--until` 按**结案时间**。（`history` 命令的人话输出只展示其中几列：结案时间、负责人、标题。）
 - **owner / creator 两列存的是 uuid**（与任务里一致，身份只认 uuid）；紧随其后的 `owner_name` / `creator_name` 两列**落盘**结案那一刻的显示名 —— 改名不回写旧行，看历史看到的就是当时那个名字。老行（升级前落的）没有名字时按名册兜底补一次展示值，**不回写文件**。
 
 ## 任务号
@@ -47,7 +47,7 @@ close             → 历史层 + 封卷 + 移出自己名下
 
 ## 历史层
 
-- 按**结案时间**分月存放，11 列（列序：owner 之后是 `owner_name`，再是 creator、`creator_name`）；`close` 从任务直写分类 / 标签终值。
+- 按**结案时间**分月存放，11 列（列序：owner 之后是 `owner_name`，再是 creator、`creator_name`）；`close` 写历史行时：分类用任务原值（**建任务后不可改**），标签用终值。
 - 存量平铺历史文件只读兼容、永不重写；`history` 连同它在内、按下面的月份区间合并。
 - **查询区间**：`history` 先由时间参数算出要读的月份文件，再逐个「存在才读、缺月跳过」，不扫磁盘。无时间参数默认最近 3 个自然月；`--months N`（近 N 月）与 `--since/--until`（结案时间闭区间）二选一；一次最多读 13 个历史文件（按月分文件，不区分连续/分散，只数总数），超出直接报错、不读任何文件。末列文档链接只按**文件名**消费（取 basename），链接里的 `../worklog/<年月>/` 前缀只为阅读器跳转服务，解析时忽略。
 - `history --json` 直接按文件现状解析，旧行没有的列不编造（名字列为空就按名册补展示值，不回写）；存量九列的历史文件按 `docs/history-creator-upgrade.md` 一次性升级，脚本不认旧列数。

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

@@ -9,7 +9,7 @@ from __future__ import annotations
 from pathlib import Path
 
 from ..core.identity import Identity
-from ..core.labels import normalize_label, parse_tags
+from ..core.labels import parse_tags
 from ..core.paths import history_path_for, shard_rel, to_repo_rel, worklog_name
 from ..core.worklog_md import (
     StatusLine,
@@ -36,7 +36,6 @@ def close_task(
     *,
     summary: str,
     finished: str,
-    category: str | None = None,
     tags: tuple[str, ...] | None = None,
 ) -> Result:
     """写序四步：改标签行 → 历史加一行 → 封卷 → 删分片（永远是最后一步）。"""
@@ -45,7 +44,6 @@ def close_task(
     text_summary = " ".join((summary or "").split())
     if not text_summary:
         raise Fail("结案要写一句「完成了什么」（--summary 不能为空）。")
-    new_category = normalize_label(category, field="分类") if category else None
     new_tags = parse_tags(tags) if tags else None
 
     logs = WorklogStore(repo)
@@ -70,8 +68,8 @@ def close_task(
     # 分片里在、但行内 owner 不是我 ⇒ 台账脏了（validate 会报⑤）：先拦下来，别用我的 uuid 记历史
     require_owner(task, tid, me)
 
-    # 历史行那两列取**最终值**：给了参数用新值，没给用任务原值，两处必须一致
-    final_category = new_category if new_category else task.get("category")
+    # 分类取任务原值（**不可改**）；标签给了参数用新值，没给沿用原值
+    final_category = task.get("category")
     final_tags = tuple(new_tags) if new_tags else tuple(task.get("tags") or ())
 
     doc_path = logs.find(tid, task.get("worklog"))
@@ -128,10 +126,10 @@ def close_task(
                     "（可能是编辑器或 git 操作），已中止、未写入任何内容；重跑一次即可。"
                 )
 
-        # ① 改标签行（给了 --category / --tags 才做，且必须在封卷之前）
-        if doc_path is not None and (new_category or new_tags):
+        # ① 改标签行（给了 --tags 才做，且必须在封卷之前）
+        if doc_path is not None and new_tags:
             text = logs.read(doc_path)
-            logs.write(doc_path, rewrite_label_line(text, final_category, final_tags))
+            logs.write(doc_path, rewrite_label_line(text, final_tags))
 
         # ② 历史加一行（先 ensure_dir：首次结案时 history/ 可能还不存在）
         ensure_dir(hist_path.parent)

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

@@ -100,7 +100,6 @@ def new_task(
             title=clean_title,
             created=created,
             creator=me.stamp(),
-            category=category,
             tags=tag_list,
             status=StatusLine(
                 "doing" if mine else "open",

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

@@ -43,14 +43,14 @@ ACTIONS: dict[str, ActionSpec] = {
     "set": ActionSpec(
         set_task.set_task,
         "result",
-        params=("tid", "owner", "release", "category", "tags"),
+        params=("tid", "owner", "release", "tags"),
         lock_action="set",
     ),
     "log": ActionSpec(log_progress.log_progress, "result", params=("tid", "note")),
     "close": ActionSpec(
         close_task.close_task,
         "result",
-        params=("tid", "summary", "finished", "category", "tags"),
+        params=("tid", "summary", "finished", "tags"),
     ),
     "list": ActionSpec(
         list_tasks.list_tasks, "list_view", readonly=True, params=("q",)

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

@@ -1,6 +1,9 @@
-"""改分类 / 标签：分片那两个字段 + 过程文档头部那行，一次改动两处同步。
+"""改标签：分片 `tags` + 过程文档头部标签行，一次写两处。
 
-只动「分类 / 标签」这一件事，不碰归属与状态 —— 归属走 `--owner` / `--release`，
+**分类不可改**（2026-10-27 用户拍板）：它在 `new` 时定死，之后没有任何入口能改 —
+不进过程文档、不进 `set` / `close` 参数；历史行里那个值就是建任务时那个值。
+
+只动「标签」这一件事，不碰归属与状态 —— 归属走 `--owner` / `--release`，
 状态只随命令语义变。已结案的任务不在任何分片里，改不了（历史行是快照）。
 """
 
@@ -9,7 +12,7 @@ from __future__ import annotations
 from pathlib import Path
 
 from ..core.identity import Identity
-from ..core.labels import normalize_label, parse_tags
+from ..core.labels import parse_tags
 from ..core.paths import shard_rel
 from ..core.time import now
 from ..core.worklog_md import (
@@ -26,32 +29,20 @@ from .guard import require_owner
 from .result import Result, rel
 
 
-def _describe(category: str | None, tags: list[str]) -> str:
-    """执行记录里那一句说明：`建设 · DSH、台账`。"""
-    parts = [category] if category else []
-    if tags:
-        parts.append("、".join(tags))
-    return " · ".join(parts)
-
-
 def relabel(
     repo: Path,
     me: Identity,
     tid: str,
     *,
-    category: str | None = None,
     tags: str | tuple[str, ...] | None = None,
 ) -> Result:
     """写序：算最终值 → 过程文档（标签行 + 执行记录 + 状态行，一次写）→ 分片。
 
     `tags` 收字符串（顿号 / 逗号分隔）或已切好的元组 —— 外壳可能已经切过一遍。
     """
-    new_category = normalize_label(category, field="分类") if category else None
     new_tags = parse_tags(tags) if tags else None
-    if new_category is None and new_tags is None:
-        raise Fail(
-            "改分类 / 标签至少要给一个：`--category <分类>` 或 `--tags <a、b>`。"
-        )
+    if new_tags is None:
+        raise Fail("改标签要给 `--tags <a、b>`。")
 
     mine = TaskStore(repo, shard_rel(me.uuid), identity=me)
     task = mine.get(tid)  # 锁内重读
@@ -61,19 +52,12 @@ def relabel(
         )
     require_owner(task, tid, me)
 
-    # 没给的沿用原值：分类与标签是一行里的两段，写一次就得给全
-    final_category = new_category if new_category else task.get("category")
-    final_tags: list[str] = (
-        [str(tag) for tag in new_tags]
-        if new_tags is not None
-        else [str(tag) for tag in (task.get("tags") or ())]
-    )
-    if not final_category and not final_tags:
-        raise Fail("分类与标签都是空的，没有可写的值。")
+    final_tags: list[str] = [str(tag) for tag in new_tags]
+    if not final_tags:
+        raise Fail("标签是空的，没有可写的值。")
 
     when = now()
     updated = dict(task)
-    updated["category"] = final_category
     updated["tags"] = final_tags
     updated["updated"] = when
 
@@ -82,15 +66,15 @@ def relabel(
     if path is None:
         mine.put(tid, updated)
         return Result(
-            changed=("category", "tags", "updated"),
+            changed=("tags", "updated"),
             where=rel(repo, mine.path),
-            message=f"{tid}：改分类 / 标签",
+            message=f"{tid}：改标签",
             notices=("提示：这条任务没有过程文档，只改了分片，文档与历史里看不到。",),
         )
 
     text = logs.read(path)
-    note = "改分类 / 标签：" + _describe(final_category, final_tags)
-    text = rewrite_label_line(text, final_category, final_tags)
+    note = "改标签：" + "、".join(final_tags)
+    text = rewrite_label_line(text, final_tags)
     text = append_exec_log(text, exec_line(when, me.stamp(), "set", note))
     text = rewrite_status_line(
         text, StatusLine(task.get("status") or "doing", me.name, me.uuid, when)
@@ -99,7 +83,7 @@ def relabel(
     mine.put(tid, updated)
 
     return Result(
-        changed=("category", "tags", "updated"),
+        changed=("tags", "updated"),
         where=rel(repo, mine.path),
-        message=f"{tid}：改分类 / 标签",
+        message=f"{tid}：改标签",
     )

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

@@ -1,11 +1,14 @@
-"""改归属的入口：只看 `--owner`，决定走哪个动作，**自己不加锁、不改任何文件**。
+"""改归属 / 改标签的入口：决定走哪个动作，**自己不加锁、不改任何文件**。
 
-它是全树唯一的跨动作引用点（import `release` / `handoff` / `claim`）。
+它是全树唯一的跨动作引用点（import `release` / `handoff` / `claim` / `relabel`）。
 
 任务状态只随命令语义变（认领 → 进行中、释放 → 待认领、结案 → 历史），
 **没有单独的「改状态」入口**：`--status` 于 2026-10-23 删除 —— 全仓没有任何
 产品调用方（看板只有 claim / release / close 三个写路由），且它能制造
-「归我名下、状态却还是待认领」的坏状态（看板上显示成没人认领）。
+:「归我名下、状态却还是待认领」的坏状态（看板上显示成没人认领）。
+
+**也没有改分类的入口**（2026-10-27 删除 `--category`）：分类在 `new` 时定死，
+之后谁都改不了；标题与创建时间同理，建完即不可变。`--tags` 仍可随时改。
 """
 
 from __future__ import annotations
@@ -23,10 +26,7 @@ from . import release as release_mod
 from .guard import require_uuid
 from .result import Result, rel
 
-_MIXED = (
-    "--category / --tags 不能与 --release / --owner 同时给："
-    "一个是改分类标签，一个是改归属，分两次跑。"
-)
+_MIXED = "--tags 与 --release / --owner 不能同给：一个改标签，一个改归属。"
 
 
 def set_task(
@@ -36,28 +36,26 @@ def set_task(
     *,
     owner: str | None = None,
     release: bool = False,
-    category: str | None = None,
     tags: str | tuple[str, ...] | None = None,
 ) -> Result:
     """路由：`--release` = 释放；别人的 uuid = 交接；自己的 uuid = 已认领则空转、没认领先认领；
-    `--category` / `--tags` = 改分类与标签（只动文档头部那行与分片字段）。
+    `--tags` = 改标签（写分片 + 过程文档头部标签行）。
     """
-    relabel_wanted = bool(category or tags)
     if release:
         if owner is not None:
             raise Fail("--release 与 --owner 不能同时给：释放不带人，交接不带释放。")
-        if relabel_wanted:
+        if tags:
             raise Fail(_MIXED)
         return release_mod.release(repo, me, tid)
     if owner is not None:
-        if relabel_wanted:
+        if tags:
             raise Fail(_MIXED)
     else:
-        if relabel_wanted:
-            return relabel_mod.relabel(repo, me, tid, category=category, tags=tags)
+        if tags:
+            return relabel_mod.relabel(repo, me, tid, tags=tags)
         raise Fail(
             "set 必须给一样：`--release`（释放回公共池）/ `--owner <对方 uuid>`（交接）/ "
-            "`--category <分类>` 或 `--tags <a、b>`（改分类标签）。"
+            "`--tags <a、b>`（改标签）。"
         )
     # 交接目标只收 uuid：名字查不到就当场报错，绝不去猜「他大概是这个人」
     target = require_uuid(owner, field="--owner")

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

@@ -7,7 +7,7 @@
 逐篇读全文换不来体检结论，只白花时间；文档自身的格式与内容不在体检范围。
 
 只查格式，不查业务（该谁结案、逾期与否都不管）；也不查「同一任务号落在多个文件」——
-读侧只显示一次（`show` 会点名）、写侧已有防护，撞上了不关体检的事（2026-10-24 用户拍板）。
+读侧只显示一次（`list` / `show` 都不重复）、写侧已有防护，撞上了不关体检的事（2026-10-24 用户拍板）。
 """
 
 from __future__ import annotations

package/skill/scripts/ledgerkit/core/history_md.py

@@ -15,7 +15,7 @@ from .time import TIME_RE, time_key
 
 HISTORY_TITLE = "# 进度历史（已结案）"
 HISTORY_HEADER = (
-    "| 结案时间 | 创建时间 | 工作包 | 分类 | 标签 "
+    "| 结案时间 | 创建时间 | 标题 | 分类 | 标签 "
     "| owner | owner_name | creator | creator_name | 完成了什么 | 过程文档 |"
 )
 HISTORY_SEP = "|---|---|---|---|---|---|---|---|---|---|---|"

package/skill/scripts/ledgerkit/core/labels.py

@@ -48,21 +48,20 @@ def parse_tags(raw: str | Iterable[str] | None) -> tuple[str, ...]:
     return tuple(out)
 
 
-def label_line(category: str | None, tags: Iterable[str] | None) -> str:
-    """过程文档头部的「分类 / 标签」行；两者皆空返回空串（此行不写）。"""
-    segs: list[str] = []
-    if category:
-        segs.append(f"**分类**：{category}")
+def label_line(tags: Iterable[str] | None) -> str:
+    """过程文档头部的「标签」行；标签为空返回空串（此行不写）。
+
+    分类**不进过程文档**（2026-10-27 用户拍板）：它只活在分片字段与历史表里，
+    标签可涵盖分类（「建设」「修改」这类词直接当标签写）。
+    """
     tag_list = [t for t in (tags or ()) if t]
-    if tag_list:
-        segs.append(f"**标签**：{'、'.join(tag_list)}")
-    return "- " + " · ".join(segs) if segs else ""
+    return f"- **标签**：{'、'.join(tag_list)}" if tag_list else ""
 
 
 def parse_label_line(text: str) -> tuple[str | None, tuple[str, ...]]:
     """从过程文档头部（第一个 `## ` 小节之前）解析分类与标签。
 
-    跳过 HTML 注释块：模板注释里举例写着「**分类**：…」，那不是数据。
+    跳过 HTML 注释块：模板注释里的示例不是数据。老文档的分类段照样能解析出来。
     """
     in_comment = False
     for line in text.splitlines():

package/skill/scripts/ledgerkit/core/worklog_md.py

@@ -21,8 +21,8 @@ EXEC_HINT = (
     '     补记用 progress.py log --id <任务号> --note "一句话"。 -->'
 )
 FROZEN_MARK = "封卷"
-#: 头部四行的规范顺序：分类/标签 → 状态 → 创建 → 封卷。
-#: 「分类」只在有分类 / 标签时写，「封卷」只在结案时写，另两行必有。
+#: 头部四行的规范顺序：标签 → 状态 → 创建 → 封卷。
+#: 标签行只在有标签时写（分类不进文档），「封卷」只在结案时写，另两行必有。
 HEAD_KEY_ORDER = ("meta", "status", "created", "frozen")
 #: 头部行前缀：新格式是无序列表 `- `，老文档是引用块 `> ` —— 读的时候两种都认。
 _HEAD_BULLET = r"^(?:\s*>\s?|\s*[-*]\s+)"
@@ -168,7 +168,6 @@ def render_worklog(
     title: str,
     created: str,
     creator: str,
-    category: str | None = None,
     tags: Iterable[str] | None = None,
     status: StatusLine | None = None,
     template: str,
@@ -198,12 +197,13 @@ def render_worklog(
             "<status>",
             render_status_body(status.status, status.name, status.uuid, status.when),
         )
-    meta = label_line(category, tags)
+    meta = label_line(tags)
     if not meta:
         return text
     return "\n".join(_insert_head_line(text.splitlines(), meta, "meta")) + "\n"
 
 
+#: 头部「标签」行；老格式的「分类」段也一并匹配 —— 改写时整行替换，分类自然消失。
 _META_LINE_RE = re.compile(_HEAD_BULLET + r"\*\*(?:分类|标签)\*\*")
 
 
@@ -362,11 +362,9 @@ def stamp_frozen(text: str, finished: str, who: str | None = "") -> str:
     return "\n".join(_insert_head_line(text.splitlines(), mark, "frozen")) + "\n"
 
 
-def rewrite_label_line(
-    text: str, category: str | None, tags: Iterable[str] | None
-) -> str:
-    """改写头部的分类 / 标签行：有就地替换，没有就按头部顺序插进去。"""
-    line = label_line(category, tags)
+def rewrite_label_line(text: str, tags: Iterable[str] | None) -> str:
+    """改写头部的标签行：有就地替换（老文档的分类段一并清掉），没有就按头部顺序插进去。"""
+    line = label_line(tags)
     lines = text.splitlines()
     for i, ln in enumerate(lines):
         if ln.startswith("## "):

package/skill/scripts/ledgerkit/shell/cli.py

@@ -45,13 +45,10 @@ def build_parser() -> argparse.ArgumentParser:
     claim = sub.add_parser("claim", help="认领公共池里的任务")
     claim.add_argument("--id", required=True, dest="tid")
 
-    setp = sub.add_parser("set", help="释放 / 交接 / 改分类标签")
+    setp = sub.add_parser("set", help="释放 / 交接 / 改标签")
     setp.add_argument("--id", required=True, dest="tid")
     setp.add_argument("--owner", help="交给别人的 uuid（交接）")
     setp.add_argument("--release", action="store_true", help="释放回公共池")
-    setp.add_argument(
-        "--category", help="改分类（与 --tags 一起改过程文档头部分类/标签行）"
-    )
     setp.add_argument("--tags", help="改标签，顿号 / 逗号分隔")
 
     logp = sub.add_parser("log", help="记一条进展")
@@ -62,7 +59,6 @@ def build_parser() -> argparse.ArgumentParser:
     close.add_argument("--id", required=True, dest="tid")
     close.add_argument("--summary", required=True)
     close.add_argument("--finished")
-    close.add_argument("--category")
     close.add_argument("--tags")
 
     listp = sub.add_parser("list", help="查在办任务")

package/skill/scripts/ledgerkit/store/history_store.py

@@ -53,7 +53,7 @@ class HistoryStore:
     ) -> str:
         """这个月的历史里已经有这条了吗？三态：`hit` / `miss` / `undecidable`。
 
-        有末列就比**文件名**（不比整条路径）。末列为空的行改按「创建时间 + 工作包」两列比
+        有末列就比**文件名**（不比整条路径）。末列为空的行改按「创建时间 + 标题」两列比
         —— 那种行在调用方给不出 `created` / `title` 时判不了，明说 `undecidable`，不拿 miss 冒充。
         """
         records, _ = history_md.parse_history(self.read(path))

package/skill/scripts/ledgerkit/store/worklog_store.py

@@ -130,7 +130,6 @@ class WorklogStore:
         title: str,
         created: str,
         creator: str,
-        category: str | None = None,
         tags: tuple[str, ...] = (),
         status: worklog_md.StatusLine | None = None,
         first_exec: str | None = None,
@@ -144,7 +143,6 @@ class WorklogStore:
             title=title,
             created=created,
             creator=creator,
-            category=category,
             tags=tags,
             status=status,
             template=self.template(),