28 lines
5.2 KiB
Markdown
28 lines
5.2 KiB
Markdown
# 2026-09-04 工作日志
|
||
|
||
## browser-harness 环境修复（00:00-00:20）
|
||
- **背景**：用户问为什么找不到 browser-harness → 排查发现三处副本 + 一处损坏残留互相误导
|
||
- **排查结论（全部位置）**：①源技能 `V1.0/subskills/browser-harness/`（真源，git 管理）= C 盘 `短视频工作台` 软链同份；②`AppData/Roaming/uv/tools/browser-harness` = **损坏残留**（site-packages 仅 2 文件空壳、uv tool list 报 malformed，误导源头）；③`.dsh/skills/browser-harness` = dsh 部署副本（8-25 完整 repo，保留不动）；④源技能内 `envs/browser-harness` = **残缺环境**（无 pyvenv.cfg、无 python.exe，browser-harness.exe 跑报 ModuleNotFoundError）
|
||
- **用户决策**：删 #2 uv 残留 + 修复 #4（真源保留）；dsh 副本 #3 保留
|
||
- **#4 修复过程（关键坑）**：①venv 残缺真因=editable pth 指向 8 月更名前旧路径 `D:\AgentSkill\MCNDouAnalysis\...\src`（已不存在）→ 先试改 pth 仍失败（venv 无 pyvenv.cfg 时 site-packages 根本不在 sys.path）；②重建 venv 用 `python -m venv <中文长路径>` 传参编码损坏→目录没建出来但 exit 0（**必须 cd 进目标目录用相对路径建**）；③新 venv + 从 .bak 搬依赖（PIL/anyio/cdp_use/fetch_use/httpx/websockets/setuptools83/wheel 等 30 项）+ `pip install -e . --no-deps --no-build-isolation`（PEP660 editable 写 finder 文件为 UTF-8 无中文编码坑）→ **browser-harness.exe --version = 0.1.8 复活** ✓
|
||
- **正确调用方式（沉淀）**：`<技能目录>/subskills/browser-harness/envs/browser-harness/Scripts/browser-harness.exe`（技能自带 venv，不依赖 PATH/uv tool）；envs/ 已被 gitignore（重建不影响 git）
|
||
|
||
## 主 SKILL.md 子技能索引登记（00:20-00:30）
|
||
- **诉求**：subskills 下技能全部写入主技能 SKILL.md，用相对路径
|
||
- **落码（V1.0/SKILL.md）**：①新增「## 子技能索引（subskills/，09-04 登记）」表格（6 子技能：browser-harness/lieflat-charts/mcn-data-insight/mcn-dou-analysis/mcn-script-review/mcn-video-prompt，列=目录名/技能名/功能触发/相对路径 `subskills/<目录>/SKILL.md`）；②文件目录树补 subskills/ + mcn-work-shop + references-add 行（原树缺这些）；③frontmatter updated_at→2026-09-04、last_change 前缀新增 09-04 条目
|
||
- **commit**：570ef84（memory 临时文件归因，承接 09-03 日志）+ 0810446（SKILL.md 子技能索引）——按 2h 节奏未 push
|
||
- **二次修正（809778a，continue 推进）**：①mcn-dou-analysis「外部技能依赖」段废弃旧「D:\AgentSkill 两步判定」——查证独立仓库 `D:\AgentSkill\mcn-dou-analysis`/`MCNDouAnalysis` 均已不存在（死路径），改 subskills/ + dsh 平级 `~/.dsh/skills/mcn-dou-analysis/` 双描述；②browser-harness 段可执行文件改技能自带 venv 相对路径（uv 工具安装描述废弃，与 00:00 环境修复配套）；③lieflat-charts 路径改相对；全文件旧绝对路径引用零残留（grep 验证）
|
||
- **dsh 副本 SKILL.md 不同步结论**：dsh short-video-script（324 行，deployment:dsh）是刻意特化版——无 subskills/无外部技能依赖段/无工作台章节，子技能平级部署 `~/.dsh/skills/`；子技能索引照搬会产生无效路径 → 按刻意 divergence 策略不同步（09-04 判定，待用户确认）
|
||
- **遗留提示**：SKILL.md「外部技能依赖：账号解析」段仍写旧绝对路径 `D:\AgentSkill\mcn-dou-analysis`（实际已在 subskills/ 下），是否改相对路径待用户确认；dsh 副本 SKILL.md 是否同步待确认
|
||
|
||
## 全量路径引用审计收尾（09:20）
|
||
- **最终残留验证（源技能 V1.0）**：①`maidou` 命中仅剩 4 份 `references/规则/路径引用规范.md` 的禁止性**规则示例行**（描述什么是被禁止的，合法豁免）；②`MCNVideo AI` 锚点零残留；③废弃目录名（MCNSkillCase/DSHSkill项目/MCNSkill输出）仅剩 3 份 `references-add/路径配置.md`（含 mcn-dou-analysis/mcn-video-prompt 副本）的 **变更记录历史行**（`2026-08-26：…` 描述废弃演变，合法豁免）——当前规则行零残留
|
||
- **豁免清单固化**：规则示例行（路径引用规范.md 中「禁止…」描述本身）、变更记录/历史行、references-add/路径配置.md 运行时权威文件 = 三类允许保留废弃名/用户名的位置
|
||
- **commit**：`docs: 全量相对路径规范化（移除 maidou/废弃盘符/应用子技能锚点）`
|
||
|
||
## 首页品牌名回退：MCN热点雷达 → 短视频工作台（09:55）
|
||
- 用户诉求：首页名称改回「短视频工作台」（08 月曾品牌化为 MCN热点雷达）
|
||
- **改动 6 文件 8 处全量替换**（grep 零残留验证）：`index.html` `<title>`、`app.js` 面包屑 crumb-home ×2 + 头注释、`data-pages.js`/`style.css`/`dsh-data.js` 头注释、`server.js` 头注释 + 启动日志；首页无独立大字标题，品牌名只在此两处 UI 呈现
|
||
- **缓存版本统一 bump** `?v=20260904a`（style/app/data-pages 三文件引用）；brand 区曾误加 brand-name 文字会与 crumb-home 重复显示→已撤销
|
||
- **服务重启生效**：杀 8900 旧进程（34076）→ 重启（24836），curl 验证 `<title>短视频工作台</title>` + crumb-home 文本正确
|