chore(工作区): 全量入库 + 补齐 .gitignore（以工作区为准）

- 变更规模：新增 514 / 修改 62 / 重命名 155 / 删除 4（归档重组与文档轮次） - .gitignore 修：`归档/**/db-cwd归一-备份-*/` —— 原规则写绝对层级（归档/db-cwd归一-…），目录搬进归档/配置与备份/ 后**静默失效**，43 MB 的 DB 备份又变成未跟踪 - .gitignore 补：嵌套 git 内部数据（归档/内嵌git-20261008/、归档/skills-git-旧线-20261007/dotgit-原样移出/） - .gitignore 补：运行态与部署副本（.workbuddy/collab/、.workbuddy/tools/、.workbuddy/.load-pending、.workbuddy/tmp-*） - .gitignore 补：备份件（*.bak-*） - 未跟踪文件从 2190 降到 890（其余为归档/ 归档件与 .workbuddy/memory/ 知识文件，按口径入库）
2026-10-10 23:13:22 +08:00
1 parent 30b46dbd0c
commit c1b5e4d966
@@ -0,0 +1,151 @@
+#!/usr/bin/env python
+"""🔴 **新建协作工作区**（技能内脚本，用户 2026-10-03 要求"每次使用协作会话机制都可以有对应的目标文件夹"）。
+
+用法：
+    python init_workspace.py <工作区绝对路径> [--title 目标标题] [--short 目标简称]
+                             [--port 单例端口] [--no-main-session]
+
+做四件事（⛔ 顺序固定，缺一件机制就跑不起来）：
+  ① 建工作区骨架（`.workbuddy/collab/`、`tmp/supervise-inbox/`、`交付物/`）
+  ② 写**部署配置** `collabd.config.json`（`COLLABD_CONFIG` 指向它 ⇒ `collabd.py` 才认这个工作区）
+  ③ 写**目标** `goal.json`（title／short／topics／lifecycle＝进行中／taskgraph）
+  ③b 写**最小任务图**（⛔ 漏了它 ⇒ 常驻每轮报「读任务图失败」，且目标判据缺一条腿）
+  ④ 跑 `collabd.py --ensure-goal-dir` ⇒ **建目标文件夹 ＋ 落《目标执行状态.md》骨架**（幂等）
+  ⑤ 建一条**主会话排期**（`automation_update` 由调用方做 ⇒ 本脚本只**打印**它该用的参数，
+     ⛔ 不自己写宿主库 —— 创建新会话**只能走自动化入口**，这是宿主规矩）
+
+🔴 关键约束（都是踩过的）：
+  · `workspace` 必须**正斜杠**（⛔ 反斜杠会让 `cwds` 裂组）
+  · `singleton_port` **每个工作区一个**（⛔ 复用 ⇒ 常驻单例互抢、静默只有一个活着）
+  · `board_ext` 指 `.RETIRED-*` ⇒ 新工作区**不带**使用方扩展（技能侧零项目串）
+  · 排期名必须是两级前缀 `[主]-<类别>-<具体>`（⛔ 光杆名 ⇒ 角色判不出，看板认不出）
+"""
+import argparse
+import json
+import os
+import subprocess
+import sys
+from pathlib import Path
+
+sys.stdout.reconfigure(encoding="utf-8", errors="replace")
+SK = Path(__file__).resolve().parent
+DEFAULT_TITLE = "检查会话协作是否运行正常 ＋ 协作机制问题排查与修复"
+
+
+def main() -> int:
+    ap = argparse.ArgumentParser()
+    ap.add_argument("workspace")
+    ap.add_argument("--title", default=DEFAULT_TITLE)
+    ap.add_argument("--short", default="")
+    ap.add_argument("--topics", default="会话协作自检,机制排查与修复")
+    ap.add_argument("--port", type=int, default=0)
+    ap.add_argument("--python", default=sys.executable)
+    a = ap.parse_args()
+
+    ws = Path(a.workspace).resolve()
+    ws_s = str(ws).replace("\\", "/")            # 🔴 正斜杠（红线）
+    short = a.short or ws.name
+    topics = [t.strip() for t in a.topics.split(",") if t.strip()]
+    port = a.port or (20000 + (abs(hash(ws_s)) % 5000))   # ⛔ 每区唯一
+
+    print("=== 新建协作工作区：%s ===" % ws_s)
+    # ① 骨架
+    for d in (".workbuddy/collab", "tmp/supervise-inbox", "交付物", ".workbuddy/collab/logs"):
+        (ws / d).mkdir(parents=True, exist_ok=True)
+    print("① 骨架已建（.workbuddy/collab ／ tmp/supervise-inbox ／ 交付物 ／ logs）")
+
+    # ② 部署配置
+    cfg = {
+        "_说明": "本文件＝**本工作区**的协作机制部署配置（⛔ 不属于技能）。由 `init_workspace.py` 生成；"
+                 "`COLLABD_CONFIG` 必须指向它，否则 `collabd.py` 不认这个工作区。",
+        "workspace": ws_s,
+        "inbox": "tmp/supervise-inbox",
+        "live": "交付物/本机协作-实时状态.md",
+        "taskgraph": "交付物/任务图-会话协作自检.json",
+        "targets": {},
+        "singleton_port": port,
+        "interval": 10, "idle_min": 12, "stuck_min": 30, "vacuum_min": 5, "health_every": 300,
+        "supervise_interval": 10,
+        "wake_enable": False,        # 🔴 唤醒/投递整套已退役
+        "board_ext": ".workbuddy/collab/board_ext.RETIRED.py",   # ⛔ 不带使用方扩展
+        "log": ".workbuddy/collab/logs/_collabd.log",
+    }
+    cfgp = ws / ".workbuddy/collab/collabd.config.json"
+    cfgp.write_text(json.dumps(cfg, ensure_ascii=False, indent=1), encoding="utf-8", newline="")
+    print("② 部署配置已写：%s（单例端口 %d）" % (cfgp.relative_to(ws), port))
+
+    # ③ 目标
+    goal = {
+        "title": a.title, "short": short, "topics": topics,
+        "lifecycle": "进行中",
+        "lifecycle_at": "", "lifecycle_by": "", "lifecycle_why": "init_workspace.py 新建",
+        "taskgraph": "交付物/任务图-会话协作自检.json",
+        "taskgraph_set_at": "", "taskgraph_set_by": "",
+        "declared_at": "", "declared_by": "",
+        "acceptance_state": {},
+        "_唯一来源": "本文件 title/short/topics 是真源；`execution_doc` 指向目标文件夹里的《目标执行状态.md》。",
+    }
+    gp = ws / "tmp/supervise-inbox/goal.json"
+    gp.write_text(json.dumps(goal, ensure_ascii=False, indent=1), encoding="utf-8", newline="")
+    print("③ 目标已写：title=%r short=%r lifecycle=进行中" % (a.title, short))
+
+    # ③b 任务图（🔴 2026-10-03 14:35x 补）：配置里 `taskgraph` 指向它，
+    #    但初始化时**没建这个文件** ⇒ 常驻每 10 秒报「goal_state 读任务图失败」
+    #    ⇒ 更要命的是**判据第二路（任务图 nodes）永远取不到** ⇒ 目标状态判据缺一条腿。
+    #    ⇒ 写一份最小任务图：节点全 `pending`，由协作会话逐个转 `done`。
+    tg_rel = "交付物/任务图-会话协作自检.json"
+    tg = {"title": a.title, "short": short, "topics": topics,
+          "nodes": [{"id": "N1", "title": "核对目标并完成首轮协作", "status": "pending",
+                     "line": topics[0] if topics else "", "note": "init_workspace.py 生成的最小任务图"}]}
+    (ws / tg_rel).write_text(json.dumps(tg, ensure_ascii=False, indent=1),
+                             encoding="utf-8", newline="")
+    print("③b 任务图已写：%s（%d 个节点，全 pending）" % (tg_rel, len(tg["nodes"])))
+
+    # ④ 目标文件夹（走产品入口，⛔ 不自己 mkdir 文档）
+    # 🔴🔴 2026-10-03 **改用「本工作区的副本」，⛔ 不再用技能目录那份**：
+    #    定案口径＝**各工作区的程序各自独立**（技能目录＝源，`.workbuddy/collab/`＝各区副本，
+    #    `deploy_code.py` 分发）⇒ 提示用户去跑技能目录那份，等于**又拉起第二个常驻**，
+    #    它会写**技能目录的 tmp/**（⛔ 那不是任何工作区的 inbox）⇒ 状态写到别处，
+    #    看板读不到、故障排查也被带偏（本轮 `SESSION_END`-style 误判的同族）。
+    #    ⚠️ 本副本若还不存在（首次初始化、还没分发）⇒ 回落用技能目录那份，
+    #    但**打印时必须说清"这次是回落"**（⛔ 静默回落＝用户以为跑的是副本）。
+    _own = ws / ".workbuddy" / "collab" / "collabd.py"
+    _own_ba = ws / ".workbuddy" / "collab" / "board.py"
+    _fallback = not _own.is_file()
+    _cd = SK / "collabd.py" if _fallback else _own
+    if _fallback:
+        print("   ⚠️ 本工作区还没有 collabd.py 副本 ⇒ 本次**回落用技能目录那份**；"
+              "请随后跑 deploy_code.py 分发，否则各区程序不独立。")
+    env = dict(os.environ)
+    env["COLLABD_CONFIG"] = str(cfgp).replace("\\", "/")
+    env["COLLABD_NO_ENSURE"] = "1"
+    r = subprocess.run([a.python, str(_cd), "--ensure-goal-dir"],
+                       env=env, cwd=str(ws), capture_output=True, timeout=120)
+    out = r.stdout.decode("utf-8", "replace").strip()
+    print("④ --ensure-goal-dir rc=%s" % r.returncode)
+    for ln in out.splitlines():
+        print("     " + ln)
+    gd = [ln for ln in out.splitlines() if ln.startswith("目标目录：")]
+    gdir = gd[0].split("：", 1)[1].strip() if gd else ""
+
+    # ⑤ 主会话排期参数（⛔ 本脚本不建 —— 创建新会话只能走自动化入口）
+    print()
+    print("⑤ 主会话排期（请由调用方用 automation_update 建）：")
+    print("     name = [主]-%s-主会话" % short)
+    print("     cwds = %s" % ws_s)
+    print("   提示：主会话标题必须是**两级前缀**（`[主]-<类别>-<具体>`），⛔ 光杆名看板认不出。")
+    print()
+    print("✅ 完成。后续协作（⛔ **都跑本工作区的副本**，别跑技能目录那份 —— "
+          "各区程序各自独立，跑了目录那份会写错地方）：")
+    print("     export COLLABD_CONFIG=%s" % str(cfgp).replace("\\", "/"))
+    _cd_show = _cd
+    _bd_show = (SK / "board.py") if not (ws / ".workbuddy" / "collab" / "board.py").is_file() else _own_ba
+    print("     python %s --supervise" % _cd_show)
+    print("     python %s --serve 8789 --takeover" % _bd_show)
+    if _fallback:
+        print("   ⚠️ 上面是**技能目录那份**（副本还没分发）⇒ 先跑 deploy_code.py --ws %s" % ws_s)
+    return 0
+
+
+if __name__ == "__main__":
+    sys.exit(main())