47 lines
3.2 KiB
Markdown
47 lines
3.2 KiB
Markdown
# 失误与规避记录
|
||
|
||
> 持续追加。
|
||
|
||
---
|
||
|
||
## #001 跨技能借鉴判断（2026-08-13）
|
||
|
||
遇到"要不要同步某字段"时，先验证数据流（信息从哪来→落到哪→下游谁读，断了就是缺口），再决定字段形态——避免用"结构不合适"直接否定，掩盖信息链路缺口。
|
||
|
||
---
|
||
|
||
## #002 审计修复未逐条执行（2026-08-13）
|
||
|
||
审计修复时一次性批量读取所有涉及文件准备批量改，被用户纠正。规避：逐条读取→逐条修改→逐条验证，禁止批量读取准备批量修改。
|
||
|
||
---
|
||
|
||
## #003 素材库引用机制搞混（2026-08-14）
|
||
|
||
把「适用场景（人设卡片）」当成素材库引用的核心来源。规避：素材库引用核心入口是「极致类型映射」（知识库 05_极致事件 → 极致类型 → 素材类型），「适用场景」只是四维标签里的辅助过滤维度。
|
||
|
||
---
|
||
|
||
## #004 部署注意点只写记忆未落文件（2026-08-14）
|
||
|
||
把「部署到用户电脑需注意的点（MCP 安装前须检查 Node/Python 环境）」只写进个人记忆（`~/.workbuddy/MEMORY.md`），没写进技能文件。规避：记忆是开发机本地文件、不随部署走，凡是需要在用户电脑生效的部署注意点，必须写进 SKILL.md（或技能内 references 文件），不能只写个人记忆。
|
||
|
||
---
|
||
|
||
## #005 标准库引用不存在的文件（2026-08-17 审计发现）
|
||
|
||
`references/旧梦留声机人设卡片.md` 已不存在，但 SKILL.md（2处）与 `feature/02_提炼账号设定.md`（2处）仍引用它（禁用清单 + 技能库路径表 + Step5 生成参考），执行时会找空。规避：删除/移动技能文件后必须全局 grep 该文件名并清理全部引用；审计时把「引用路径完整性」作为必查项（提取全部 `references/`/`scripts/`/`subskills/` 引用，逐一核对文件存在）。
|
||
|
||
---
|
||
|
||
## #006 标准库写死账号实证数据（2026-08-17 审计发现）
|
||
|
||
`references/账号数据分析方法.md` 的趋势判断法/植入范式写入了具体账号（王微斯）的账号名与大量绑定实证数值（如"5月占比80%→均赞8.9万""白惜牙膏86.8万"），部署到其他账号/用户时会造成误导。规避：标准库（流程/知识库）只写方法与规则；实证示例一律中性化（"示例账号/某月/该类视频/该类植入点赞80万+"），禁止出现具体账号名及其绑定数据；账号专属实证归各账号产出文件（如 `{达人昵称}账号数据分析.md`），不进标准库。
|
||
|
||
---
|
||
|
||
## #007 MCP 部署预检只查运行时、未查 npm 缓存权限（2026-08-17）
|
||
|
||
给用户 Mac 部署 MCP 时，预检只做了 Node/Python 版本检查，未查 npm 缓存权限，导致 `npx` 型 MCP 启动失败且排查方向一度误判为镜像问题。真正根因：`~/.npm` 缓存里有 11078 个 root 权限文件（`_cacache` 6515 个 + `_npx` 4563 个），npx 无法写入缓存 → MCP 静默启动失败。规避：MCP 部署预检 = ①运行时版本 ②npm 缓存权限（macOS 高发，`find ~/.npm -user root` 检查，`rm -rf ~/.npm/_npx ~/.npm/_cacache` 清理，无需 sudo）③npm 源（仅可选，非根因）；排查顺序 1→2→3，缓存权限问题先于网络问题排查。已固化到 `MCP_工具调用规范.md` 3 部署预检。
|
||
|