 admin
|
2f656098de
|
技能仓：技能根绝对路径清零（用户令：严格禁止技能中写这里绝对路径）
用户原话：「SKILL.md:189 判据源写 E:/ProgramData/.workbuddy/skills/
严格禁止技能中写这里绝对路径（除非跨根目录因引用），跨环境全部报错」
起因：product-planning/SKILL.md:189「判据来源」那句写了技能根绝对路径。
按同一判据全仓反查后清掉 10 个文件：
· product-planning：SKILL.md（判据来源 / video-capture 位置 / 本技能位置 ＋ 新增「路径写相对或占位」规则）、
references/_留痕/SKILL-总入口-20261007改说人话前.md、stage-delivery/assets/video-capture/SKILL.md、
scripts/check_naming.py（注释）
· session-mechanism：SKILL.md（反例改占位 ＋ 例外条款改写：由「文档／注释不在此列」改为「例外只有跨根引用」）、
references/deploy.md（安装目录）、scripts/session-rules-check.py（docstring）、
boards/会话看板/board-launch.py.tpl（模板占位符）
· video-capture：ATTRIBUTION.md（沿革）
· 改包纪律.md：3 条 cd 命令
判据（用户给的两分法）：
· 技能根（本包自己 ＋ 同根技能）⇒ 一律不写绝对路径，写 <技能根>/<技能名>/
· 跨根引用（工作区根 / 文档库根 / 本机软件安装位 / 宿主数据目录）⇒ 才落到具体位置，优先读环境变量
验收：
· product-planning 命名闸门：通过 2060 / 失败 0
· session-mechanism 全量自测：PASS 110 / FAIL 0
· 全仓 grep -r 反查该形态：清零（install.log 为运行时产物已 ignore；browser-harness/.venv 为 pip 元数据）
· 3 个被编辑器写成 CRLF 的文件已转回 LF，与 .gitattributes 的 eol=lf 对齐
|
2026-10-14 21:10:29 +08:00 |
|
|
admin
|
fe22f4cebe
|
session-mechanism：两个看板定名（会话看板 / 项目看板）＋ 包内代码一律相对路径
用户令（两句，同一轮）：
①「会话技能中 能用相对路径的都要用相对路径」
②「把会话的 项目目标看板 改成 项目看板，
项目看板 和 会话技能的任务看板 都重新命名 会话看板、项目看板」
## 一、改名：项目管理界面 → 项目看板
* 目录：boards/项目管理界面/ → boards/项目看板/（会话看板不变）
* 包内引用：路径性（3 行）＋ 展示名（6 处，含 argparse description、启动横幅、
错误日志前缀、模块 docstring、页面 <title> 与 .brand）
* HTML 标题：<title>项目管理 · 执行任务</title> → <title>项目看板 · 执行任务</title>
## 二、相对路径（新立第 11 条禁令）
判据＝「这个根能不能从『我自己的位置』推出来」：
* 能（本包自己的目录）⇒ 从 __file__ 上跳推导
* 不能（工作区根 / 配置目录 / 文档库根）⇒ 读本包 env/roots.env
* 推不出来 ⇒ 如实报错 ＋ 留痕（⛔ 不许静默扫空）
落点（共 4 处代码级硬编码，全部清掉）：
* boards/项目看板/project-board.py：新增 _sm_load_roots()；
技能根改 HERE.parent.parent；WS_ROOTS 从 DSH_AIROOT 推导；
推不出根时打警告 ＋ 写 logs/project-board.err.log（原为静默扫出 0 个项目）
* scripts/selftest.py：生产区定位改为扫 DSH_AIROOT 下兄弟区（⛔ 不写死区名）；
两处测试假路径去掉盘符
⛔ 文档/注释里的绝对路径保持原样（举例、历史取证照写 —— 那是证据）。
## 验收
* 换机场景实测（技能包拷到 /tmp、不带 env/roots.env）：
无任何配置 ⇒ 如实报错；只给 DSH_AIROOT ⇒ 正常扫到 4 个项目
* selftest --filter 看板：PASS 110 / FAIL 0（报告型 1 条不计入）
* 项目看板服务：pid 40776 · HTTP 200 · <title>项目看板 · 执行任务</title>
· /api/projects 出数据 · /healthz ok
* py_compile 三份改动文件全过
|
2026-10-14 16:33:28 +08:00 |
|
|
admin
|
52566c79f9
|
session-mechanism：两个看板整包搬进 boards/（页面与脚本同处一包）
用户令：「把这两个看板都纳入会话技能中，分两个看板文件夹，开个 boards 文件夹放两个看板」
「1 boards 2 A」（文件夹名 boards；本区部署与计划任务本轮一起改）
## 分层（新增第三层）
scripts/ ＝ 可执行程序（被计划任务／hook 调）
assets/ ＝ 静态素材（样式、模板）
boards/ ＝ 自带页面的看板程序（一个看板一个文件夹，页面＋脚本同处一包）
## 动了什么
* boards/会话看板/（6 文件）：board.py / board_ext.py / board-launch.py /
board-launch.py.tpl / board.html / board-render-probe.js（从 scripts/ 与 assets/ 搬入）
* boards/项目管理界面/（3 文件）：project-board.py / project-board.html /
project-board-launch.py（从工作区 交付物/项目管理界面/ 复制入）
## 搬迁带出的真缺陷（已修，非补丁）
* board.py：「与 collabd.py 同目录」这个前提搬走后不成立 ⇒ 原来会**静默**落到
本地抄的那份判据（自测「两侧共用同一实现」判 FAIL，但看板照跑、肉眼看不出来）。
改成候选表（同目录 → 包内 scripts/ → DSH_SKILL_ROOT/scripts/），并在兜底分支**写 stderr 留痕**。
* board.py：CFG_P 同样按 HERE 找配置 ⇒ 与 collabd.py::load_cfg() 对齐查找顺序。
* selftest.py：一个 H 指两处的假设（board.py 与 collabd.py 同目录）拆成 H/B 两参数；
board.html / board.py 全部改走 BOARD_DIR / board_py()。
## 顺带修一条既有 FAIL（与搬迁无关）
* 判据锚点没跟文档改：supervise-persistence.md 措辞在 053a6a6 已改成
「排期按点拉起主会话这条路不存在」，判据仍锚旧句 ⇒ 恒红。判据改成锚档内现存那句。
## 验收
* selftest：--filter 看板 PASS 110 / FAIL 0（报告型 1 条不计入）；
全量 PASS 91 / FAIL 1（同一条报告型，实质 FAIL 0）。
* 会话看板 board.py --out ⇒ 50515 字节快照，无「回落本地判据」告警（证明真从 collabd.py 取）。
* 项目管理界面 --once ⇒ 4 个项目全列出；HTTP / 200 · 54102 字节（＝技能包真身那份）·
/api/projects 出数据 · /healthz ok。
|
2026-10-14 15:39:41 +08:00 |
|