dsh-task-ledger 0.0.98 → 0.0.100

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "dsh-task-ledger",
-	"version": "0.0.98",
+	"version": "0.0.100",
 	"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.24
+version: 1.3.26
 allowed-tools: Read,Edit,Bash,Grep
 ---
 
@@ -41,7 +41,7 @@ allowed-tools: Read,Edit,Bash,Grep
 
 | 参数 | 含义 |
 |---|---|
-| `--title "…"` | 任务标题（必填）—— 写任务核心、一句话说清干啥；它用来生成任务号和过程文件名，建议 4~20 字 |
+| `--title "…"` | 任务标题（必填）—— 写任务核心、一句话说清干啥，不要拿分类名当标题；它用来生成任务号和过程文件名，建议 4~20 字 |
 | `--id` | 自定义任务号（一般不传；只能用小写字母、数字、汉字和连字符） |
 | `--created` | 给过去漏记的任务补建时，补录实际创建日期（`YYYY-MM-DD`） |
 | `--self` | 建并认领：直接归自己名下、状态「进行中」。仅当用户明确说「并开始做 / 并执行」时才用（判定见生命周期第 2 条） |
@@ -49,7 +49,7 @@ allowed-tools: Read,Edit,Bash,Grep
 
 干什么：建任务、按模板建好过程文档。不加 `--self` = 只建，落公共池等认领；加 `--self` = 建并认领。
 
-分类 / 标签口径（`new` 与 `close` 共用这组参数）：`--category` 答「是什么类型」，单值，中文 ≤4 字 / 纯英文 ≤3 词，吃不准写「其他」；`--tags` 答「涉及什么」，0~5 个、逗号分隔，写不出就不传（传空串等于没传）。tags 不许写 category 的同义词；查询用 tags（包含匹配，见 `list --tag`）。名词性短语、中文优先。**在办任务的分类 / 标签一旦写下就改不了**，只有结案时用 `close --category` / `--tags` 写终值。正例：`--category 缺陷修复 --tags "镜像拉取,超时重试"`；反例：`--category 已完成登录修复`、`--tags 修 bug`。
+分类 / 标签口径（`new` / `set` / `close` 共用这组参数）：`--category` 答「是什么类型」，单值，中文 ≤4 字 / 纯英文 ≤3 词，吃不准写「其他」；`--tags` 答「涉及什么」，0~5 个、逗号分隔，写不出就不传（传空串等于没传）。tags 不许写 category 的同义词；查询用 tags（包含匹配，见 `list --tag`）。名词性短语、中文优先。**建任务时没写、后来想补就用 `set --category` / `--tags`**（在办任务随时可改）；结案时 `close` 写的值会覆盖成终值并进历史行。正例：`--category 缺陷修复 --tags "镜像拉取,超时重试"`；反例：`--category 已完成登录修复`、`--tags 修 bug`。
 
 举例：用户说「新建个任务：把发布流程走通」→ `new --title "把发布流程走通"`（只建，不认领）；用户明确说「新建个任务并开始做」→ `new --title "把发布流程走通" --self`。
 
@@ -63,17 +63,24 @@ allowed-tools: Read,Edit,Bash,Grep
 
 举例：用户说「这活我领了」→ `claim --id 20261023-1117-把发布流程走通-7f3a`。
 
-### set — 释放任务（退回公共池）
+### set — 释放任务 / 改分类标签
 
 | 参数 | 含义 |
 |---|---|
-| `--id <任务号>` | 释放哪个（必填） |
+| `--id <任务号>` | 哪条任务（必填） |
 | `--release` | 释放回公共池（不带人） |
 | `--owner <别人的uuid>` | 把任务转交给对方（预留通道，**agent 不用**，见纪律；只收 uuid，传名字当场报错） |
+| `--category <分类>` | 改分类（改过程文档头部「分类/标签」行 + 分片字段） |
+| `--tags <a、b>` | 改标签（顿号 / 逗号分隔，最多 5 个） |
 
-干什么：把任务放回公共池、状态回「待认领」，别人即可认领；没有单独的「改状态」入口。**`--release` 与 `--owner` 必须二选一、不能同给**（只给 `--id` 会报错）。
+干什么：两组用法，**不能混在一次调用里** ——
 
-举例：用户明确说「把这个任务退回去」→ `set --id <任务号> --release`。
+- `--release` / `--owner`：改归属。释放回公共池、状态回「待认领」，别人即可认领；没有单独的「改状态」入口。**这两个必须二选一、不能同给**。
+- `--category` / `--tags`：改分类标签。只改自己名下**在办**任务；给了哪个就替换哪个，没给的沿用原值；头部那行没有就插到最上面，有就原地改。已结案（在历史里）的任务改不了。
+
+只给 `--id` 会报错，要求你指明要做哪件事。
+
+举例：用户明确说「把这个任务退回去」→ `set --id <任务号> --release`；「这任务归到建设类、打上台账标签」→ `set --id <任务号> --category 建设 --tags 台账、看板`。
 
 ### log — 记一条进展
 

package/skill/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "task-ledger",
-	"version": "1.3.24",
+	"version": "1.3.26",
 	"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` 两列**落盘**结案那一刻的显示名 —— 改名不回写旧行，看历史看到的就是当时那个名字。老行（升级前落的）没有名字时按名册兜底补一次展示值，**不回写文件**。
 
 ## 任务号

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

@@ -43,7 +43,7 @@ ACTIONS: dict[str, ActionSpec] = {
     "set": ActionSpec(
         set_task.set_task,
         "result",
-        params=("tid", "owner", "release"),
+        params=("tid", "owner", "release", "category", "tags"),
         lock_action="set",
     ),
     "log": ActionSpec(log_progress.log_progress, "result", params=("tid", "note")),

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

@@ -0,0 +1,105 @@
+"""改分类 / 标签：分片那两个字段 + 过程文档头部那行，一次改动两处同步。
+
+只动「分类 / 标签」这一件事，不碰归属与状态 —— 归属走 `--owner` / `--release`，
+状态只随命令语义变。已结案的任务不在任何分片里，改不了（历史行是快照）。
+"""
+
+from __future__ import annotations
+
+from pathlib import Path
+
+from ..core.identity import Identity
+from ..core.labels import normalize_label, parse_tags
+from ..core.paths import shard_rel
+from ..core.time import now
+from ..core.worklog_md import (
+    StatusLine,
+    append_exec_log,
+    exec_line,
+    rewrite_label_line,
+    rewrite_status_line,
+)
+from ..errors import Fail
+from ..store.task_store import TaskStore
+from ..store.worklog_store import WorklogStore
+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>`。"
+        )
+
+    mine = TaskStore(repo, shard_rel(me.uuid), identity=me)
+    task = mine.get(tid)  # 锁内重读
+    if task is None:
+        raise Fail(
+            f"任务 {tid} 不在我的分片里（只能改自己名下在办的任务；已结案的任务改不了）。"
+        )
+    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("分类与标签都是空的，没有可写的值。")
+
+    when = now()
+    updated = dict(task)
+    updated["category"] = final_category
+    updated["tags"] = final_tags
+    updated["updated"] = when
+
+    logs = WorklogStore(repo)
+    path = logs.find(tid, task.get("worklog"))
+    if path is None:
+        mine.put(tid, updated)
+        return Result(
+            changed=("category", "tags", "updated"),
+            where=rel(repo, mine.path),
+            message=f"{tid}：改分类 / 标签",
+            notices=("提示：这条任务没有过程文档，只改了分片，文档与历史里看不到。",),
+        )
+
+    text = logs.read(path)
+    note = "改分类 / 标签：" + _describe(final_category, final_tags)
+    text = rewrite_label_line(text, final_category, 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)
+    )
+    logs.write(path, text)
+    mine.put(tid, updated)
+
+    return Result(
+        changed=("category", "tags", "updated"),
+        where=rel(repo, mine.path),
+        message=f"{tid}：改分类 / 标签",
+    )

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

@@ -18,10 +18,16 @@ from ..errors import Fail
 from ..store.task_store import TaskStore
 from . import claim as claim_mod
 from . import handoff as handoff_mod
+from . import relabel as relabel_mod
 from . import release as release_mod
 from .guard import require_uuid
 from .result import Result, rel
 
+_MIXED = (
+    "--category / --tags 不能与 --release / --owner 同时给："
+    "一个是改分类标签，一个是改归属，分两次跑。"
+)
+
 
 def set_task(
     repo: Path,
@@ -30,15 +36,28 @@ def set_task(
     *,
     owner: str | None = None,
     release: bool = False,
+    category: str | None = None,
+    tags: str | tuple[str, ...] | None = None,
 ) -> Result:
-    """路由：`--release` = 释放；别人的 uuid = 交接；自己的 uuid = 已认领则空转、没认领先认领。"""
+    """路由：`--release` = 释放；别人的 uuid = 交接；自己的 uuid = 已认领则空转、没认领先认领；
+    `--category` / `--tags` = 改分类与标签（只动文档头部那行与分片字段）。
+    """
+    relabel_wanted = bool(category or tags)
     if release:
         if owner is not None:
             raise Fail("--release 与 --owner 不能同时给：释放不带人，交接不带释放。")
+        if relabel_wanted:
+            raise Fail(_MIXED)
         return release_mod.release(repo, me, tid)
-    if owner is None:
+    if owner is not None:
+        if relabel_wanted:
+            raise Fail(_MIXED)
+    else:
+        if relabel_wanted:
+            return relabel_mod.relabel(repo, me, tid, category=category, tags=tags)
         raise Fail(
-            "set 必须二选一：`--release`（释放回公共池）或 `--owner <对方 uuid>`（交接）。"
+            "set 必须给一样：`--release`（释放回公共池）/ `--owner <对方 uuid>`（交接）/ "
+            "`--category <分类>` 或 `--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/shell/cli.py

@@ -45,10 +45,14 @@ 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="记一条进展")
     logp.add_argument("--id", required=True, dest="tid")

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))