admin/mcn-short-video
1
0 Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

工作台：目录改名 mcn-workshop + 任务进度可见 + 会话归属配置化

Browse Source 
1. 目录 mcn-work-shop -> mcn-workshop（空间分组名取会话 cwd 的目录名，只改字符串无效，必须真改名）
2. 全仓替换 mcn-work-shop -> mcn-workshop：37 文件 121 处；历史日志按沿革句规矩保留当时目录名
3. 任务进度可见：/api/run/status 产出 已运行时长/工具调用/最近动作/停滞判定（读会话日志尾部），前端新增右下角常驻面板，四处任务入口接入
4. 会话归属目录配置化：新增 config.sessionCwd（留空=工作台自身目录），现指向 D://AI技能//mcn-workshop，使任务显示为命名分组而非「未分组任务」
5. 修前端轮询静默缺陷：连续 3 次查询失败即提示服务断开（原逻辑静默空转到 15 分钟超时，用户零感知）
This commit is contained in:
maogeigei committed 2026-10-08 13:09:06 +08:00
1 parent d07049ecf1
commit f77735b206
115 files changed
+1103 -1514
Download Patch File Download Diff File Expand all files Collapse all files

No files matched your search

.workbuddy/memory/2026-09-29.md
+147
View File
@@ -368,3 +368,150 @@ codebuddy -p → EADDRINUSE 后卡死，超时零输出
### 清理
本轮 91 个临时文件（`_*.py`／`_*.log`／`_*.txt`／`_debug/` 等，均在根目录与 mcn-work-shop 下）已全部分批删除。
---
## 18:45-19:30 A 方案落地完成 + 联网搜索接入（实测全通过）
### ✅ 结果：工作台 AI 链路已切到本地 CLI，可用
用户提供 API Key 后，端到端全部跑通：
`/api/ai/status` → ready:true ／ `?probe=1` → ok:true ／ `/api/ai/clarify`(SSE) → 正常出内容且格式合规（`==OPTS==/==REQ==` 完整）。
### 🔐 凭据存放（重要，防泄密）
- **`mcn-work-shop/config.json` 是 git 跟踪文件** → ⛔ 绝不能把 key 写进去。
- 凭据落在**仓库之外**：`%USERPROFILE%\.workbuddy\mcn-work-shop\ai-cli.json`（`{"apiKey":"..."}`）。
- 解析优先级：`config.apiKey/authToken` > **凭据文件** > 环境变量 `CODEBUDDY_API_KEY/AUTH_TOKEN`。
- `server.js` 新增 `cliBaseOpts()` 统一构造调用参数；新增环境变量覆盖开关 **`MCN_AI_MODEL`**（不改配置做模型 A/B）。
### ⭐⭐ doubao 不可用（钉死结论）
- `custom:doubao-seed-2-1-pro-260628` → **500**；`custom:doubao-seed-2-0-lite-260428` → **400 `Custom model [...] service info not found`**。
- CLI `--help` 的模型列表是**二进制静态清单，≠ 已开通**。桌面产品配置 48 个模型里没 doubao；`workbuddy.db` 历史只用过 `deepseek-v4.1-flash`/`hy4-preview`。
- **但 `custom:` 系并非全不可用** —— 同租户下有一大批已开通的自定义槽位。
### ⭐⭐ `custom:custom-model-*` 槽位 → 真实模型名映射（实测逐个跑出）
| 槽位 | 真名 |
|:--|:--|
| `a1` / `a2` / `a3` / `a4` | Claude-Opus-4.7 / Sonnet-4.6 / Opus-4.6 / **Opus-4.8** |
| `b1-standard` / `b1-priority` | GPT-5.4-Standard / GPT-5.4-Priority |
| `b3-priority` | GPT-5.2-Priority |
| `b4-standard` / `b4-priority` | GPT-5.1-Standard / GPT-5.1-Priority |
| `b5-standard` / `b5-priority` | **GPT-5.5-Standard / GPT-5.5-Priority** |
| `c2-flash` | Gemini-3.5-Flash-1 |
> **取证方法**（可复用）：CLI 日志 `%TEMP%\mcn-cli-home\logs\<日期>\*.log` 里会有
> `"requestModelId":"custom:...","requestModelName":"Claude-Opus-4.8"` 配对 → 正则一次提取全部映射。
> 直接问模型「你是谁」不可靠（a1~a4 会统一答「我是AI智能编程助手」）。
### ⭐⭐ 三个性能杠杆（实测数据，都已在代码里落地）
| 杠杆 | 做法 | 效果 |
|:--|:--|:--|
| **工具面收敛** | `--tools "WebSearch,WebFetch"` | prompt **21,776 → 4,859 tokens（-78%）**，**47.6s → 15.0s** |
| **推理档位** | `--effort low`（新增，`minimal\|low\|medium\|high\|xhigh\|max`） | 首字 **61.7s → 19.7s** |
| **换模型** | `deepseek-v4-pro` 46.2s → `custom:custom-model-a4` 18.5s | 快 2.5 倍 |
- ⚠️ **`[INIT tools]` 事件列的是工具注册表全量，不是启用集** —— 判断 `--tools` 是否生效要看 `usage.input_tokens`，别被事件列表误导（本轮差点误判成"白名单没生效"）。
- 附带安全收益：工具面收敛后模型**物理上碰不到文件系统**（Bash/Read/Write/Edit 全不在白名单）。
### ⭐ 联网搜索：CLI 原生自带，开箱可用
- `--tools` 里保留 `WebSearch,WebFetch` 即可；实测真的发起 `WebSearch {"query":...,"freshness":"d1"}`。
- **但不能常开也不能常关** → 用 `CLI_SEARCH_HINT` 作 `--append-system-prompt` 注入判据：
该搜（今天/近期的外部事实、热点、平台规则、事实核查）／不该搜（创作讨论、需求澄清、脚本撰写）／
**搜索预算硬上限 2 次**（1 WebSearch + 必要 1 WebFetch），搜到即答禁止反复搜。
- 教训：第一版提示词只写"最多搜 2 轮"，模型实际连搜 4 次把耗时推到 3 分钟 → 改成显式预算 + `maxTurns: 6` 硬顶。
### ⭐ 两个文本污染（必须处理）
1. **报错当回答**：未认证时 CLI 把报错走文本通道发出 → `isCliBoilerplate()` 拦截。
2. **工具调用前的过程话术**（本轮新发现）：模型搜前先吐一句
`I'll search for ... before responding.` → 被当正文显示。
**修法**：`runCli` 记录每次 `tool_use` 的位置（`toolMarks`），**只保留最后一次工具调用之后的文本**；
因为这段已流式推给前端，`server.js` 成功分支比对 `r.text !== acc` 时补发 `{replace}` 整体覆盖。
（前端 `data-pages.js` L653-672 对未知事件类型是 `continue` 安全跳过 → 加事件类型不破坏兼容。）
### ⭐ 本轮新识别并清掉的宿主干扰
- **宿主 MCP 注入**：`CODEBUDDY_MCP_CONFIG` 会在子 CLI 里自动挂上 `weixinpay` + `sheetagent` 两个 MCP，
纯浪费启动时间还可能被误调 → `buildChildEnv` 删该变量 + 传 `--strict-mcp-config --mcp-config '{"mcpServers":{}}'`。
实测 `[INIT mcp]` 从 2 个变成 `[]`。
- 另删 `CODEBUDDY_GATEWAY_PASSWORD`/`CODEBUDDY_GATEWAY_AUTH`/`WORKBUDDY_PAC_RPC_*`。
### 当前配置
`config.json → ai`：`backend:"cli"`，`model:"custom:custom-model-a4"`（Claude-Opus-4.8），
`effort:"low"`，`search:true`，`tools:""`，`strictMcp:true`，`maxTurns:6`。
### 遗留 / 待办
- **需求打磨单轮耗时仍 60-120s**（首字已降到 ~20s）。总耗时主要在模型推理+输出，属模型特性；若要更快可再换 `b5-standard`(GPT-5.5) 或加 `effort:minimal`。
- **前端 `sendTurn` 未实测**（本轮只测了后端 SSE；协议未变理论零改动）。
- 真实账号 + 参考选题走**完整 AI 创作链路**（S1-S11）仍未验证。
- `flash`/`minimal` 档位对产出质量的影响未评估。
---
## 19:32-19:40 模型切换：GPT-5.5（用户拍板）
用户选定 **GPT-5.5**，配置已改为 `custom:custom-model-b5-standard`。
### 实测对比（端到端 `/api/ai/clarify`，同一测试用例）
| 模型 | 普通创作问答 | 问热点（带搜索） | 格式合规 |
|:--|:--|:--|:--|
| **GPT-5.5-Standard**（当前） | **42.2s** | 137.2s | ✅ |
| Claude-Opus-4.8 | 105.5s | 139.6s | ✅ |
| DeepSeek-V4-Pro | 119.5s | 151.2s | ✅ |
- **普通问答快 2.5 倍**（42.2s vs 105.5s）—— 这是最常用的路径，收益最大。
- **触发搜索后各模型都是 130-150s** → 瓶颈转移到搜索本身，不是模型。
∴ `CLI_SEARCH_HINT` 把搜索预算压到 ≤2 次是对的，这是搜索场景唯一有效的提速手段。
- 首字延迟：普通问答 ~20s；搜索场景 ~67s（因为叙述被切掉了，搜索期间用户只看到"正在思考"占位）。
### b5 两个变体的区别
`custom:custom-model-b5-standard`（标准档，已选）／`custom:custom-model-b5-priority`（优先档，
资源紧张时优先路由，通常积分倍率更高）。b1/b3/b4 同族也是这套 -standard/-priority 后缀。
### 本轮验证方法（可复用）
测试脚本自检三件事，比只看耗时更有价值：
1. `==OPTS==` / `==REQ==` 双标记是否齐全（格式合规，前端要靠它解析候选与需求清单）
2. 英文过程话术残留（正则扫整行纯英文 ≥25 字符的段落）
3. 首字延迟 + 总耗时分开记（首字反映推理档位，总耗时反映输出+搜索）
### 当前最终配置
`config.json → ai`：`backend:"cli"`，`model:"custom:custom-model-b5-standard"`，
`effort:"low"`，`search:true`，`tools:""`，`strictMcp:true`，`maxTurns:6`；
凭据在 `%USERPROFILE%\.workbuddy\mcn-work-shop\ai-cli.json`。
---
## 19:40-19:50 切换 deepseek-v4.1-flash + 全流程跑通验证
用户要求「改为用 deepseek v4.1 flash 把流程跑通」。配置已改 `custom:custom-model-b5-standard` → **`deepseek-v4.1-flash`**。
### ✅ 全流程四环节实测全绿
| 环节 | 结果 |
|:--|:--|
| `GET /api/ai/status` | backend=cli · model=deepseek-v4.1-flash · ready=**true** |
| `?probe=1` | ok=**true** · 17.0s · 返回「成功」 |
| `POST /api/ai/clarify`(stream) | 371 字 · `==OPTS==/==REQ==` 合规 ✅ · 无英文残留 ✅ · 51.7s（首字 49.7s） |
| `POST /api/run` → 轮询 | queued(5s) → running(30s) → **done**(50s) · `model_id` 落库 = deepseek-v4.1-flash ✅ |
### ⭐⭐ 关键架构发现：完整流程 = 两段，模型来源互不相干
| 环节 | 接口 | 谁在跑 | 模型来源 |
|:--|:--|:--|:--|
| 需求打磨（弹窗对话） | `POST /api/ai/clarify` | **本地 CLI**（本方案） | `config.json → ai.cli.model` |
| 提交创作任务（S1-S11 生成脚本） | `POST /api/run` | **WorkBuddy 宿主**（写 automation，桌面端调度器执行） | **`sessions` 表最近活跃「手动会话」的 `model`**，兜底 `auto` |
- 🔴 **改 `ai.cli.model` 不影响创作任务的模型。**
- 创作任务模型是「跟随用户在 WorkBuddy UI 最近选过的模型」→ 从工作台侧看是**浮动的、不确定的**。
- 取证 SQL：`SELECT model_id, COUNT(*) FROM automations GROUP BY model_id ORDER BY 2 DESC;`
本机实测分布：`hy4-preview` **30** 条 / `deepseek-v4.1-flash` **6** 条（我们这次会话是 flash，所以新任务落到 flash）。
- **想让创作固定用某模型**：在 UI 把当前会话模型切到它；或改造 `/api/run` 支持显式 `model_id`（属行为变更，未做）。
### `deepseek-v4.1-flash` 的实测速度（澄清一个反直觉点）
- 首字 **49.7s**，总 51.7s；对比 GPT-5.5 首字 20.0s/总 42.2s。
- **"flash" 不等于首字更快** —— 它仍是推理型模型；但总耗时接近。选它主要看积分成本。
- 三个模型（deepseek-v4.1-flash / GPT-5.5 / Opus-4.8）**格式合规都 ✅、都无英文残留**，质量层面可用性一致。
### 顺带确认的死代码
- **`POST /api/ai/topics` 是遗留死代码** —— 前端从不调用（选题列表走 `GET /api/dsh/topics`）。
它仍写死 Dify，未配 `DIFY_MCN_CYLG_KEY` 会 500，但**不影响真实流程**。已记入文档 §11。
### 清理
- 自检 automation `automation-1790682160345`（名为「链路自检·deepseek-v4.1-flash（可删除）」）
已用 `automation_update mode=delete` 走正规通道删除（未用 sqlite 直改）。
- 临时脚本 `_t_flash.py` 已删。
.workbuddy/memory/2026-10-08.md
+165
View File
@@ -0,0 +1,165 @@
# 2026-10-08
## 会话技能加载 + 项目记忆去重
- 按用户指令加载 `session-mechanism`：四类必读已读（`00-动手前必过.md` / `rules.md` / `manifest.md` / `01-文档索引.md`）＋ SKILL.md 第一屏（触发句、第 0 步加载门槛、十条禁令、自决策白名单、现状地图）。
- 内化判据：**边界内自决策**（技术选型／实现路径／命名／调参／部署／排查／版本／兼容降级／文档技术内容）；**只提报三类**（功能语义分叉／红线门禁／超边界：花钱·对外承诺·要凭据）。
- 项目 `MEMORY.md` 去重重组为 v4（17,841 → 17,315 B）：新增 §0 两条指针（工作台 AI 通路 `docs/AI链路-本地CLI接入.md`、技能侧 WeKnora 调用）；§2.1 补 09-29 AI 通路四条硬红线＋两段流程模型来源；§4.2／§4.3 降级为「存根＋硬红线」；清历史流水。
### 未决
- ⚠️ `MEMORY.md` 体积仍会被注入截断（阈值约 10–12 KB）。解法二选一：① 维持单文件（细节自动可见，但注入截断）② 拆专题文件（不截断，但细节失去自动注入）。**无客观优劣 ⇒ 待用户定**。
## 工作台「更新榜单数据」按钮排查（功能正常，是可见性问题）
- 现象：用户点击后「没有会话执行」。
- 取证（四处读数）：宿主库 `automations` 有该 once 任务（ACTIVE、`next_run_at` 已过期、`model=hy4-preview`、`skills=["mcn-data-insight"]`）；`automation_runs.status=IN_PROGRESS` ＋ `automation_runtime_state.running=1`（⚠️ `running_conversation_id=null` 是常态，不代表没起会话）；`sessions` 已建后台会话 `8a085794…`（bg=1，10:07:23）；会话 jsonl 283 KB 且 mtime 持续更新（10:14），工具调用 30 Bash／14 Read／4 Write ⇒ **任务真的在跑**。`/api/dsh/ranking-update` 返回 `files=104`、`lastUpdateAt` 10:13:51 ⇒ 数据已在落盘。
- 真因两条（都与抓取逻辑无关）：① 会话 `cwd = …\mcn-work-shop` ⇒ 落在侧边栏 **mcn-work-shop 空间分组**，不在用户当前空间，需切组才可见（这是设计，非 bug）；② 工作台服务作为会话后台任务**被回收** ⇒ 前端轮询 `/api/run/status` 持续抛错。
- 修复：`public/data-pages.js` `updateRankingData()` 轮询加失败计数 —— 连续 3 次查询失败即提示「工作台服务已断开，任务仍在后台执行」并结束轮询（原逻辑静默 `continue` 到 15 分钟超时，用户零感知）。
- ⚠️ **排查方法论沉淀**：判「后台任务有没有在执行」的正确取證链 = `automations` → `automation_runs` → `automation_runtime_state` → `sessions` → 会话 jsonl 的 mtime/大小。⛔ 别只看 `running_conversation_id`（常为 null，会误判成没执行）。
## 工作台目录统一改名 `mcn-work-shop` → `mcn-workshop`
- 动因（用户）：「分组已改为 mcn-workshop，需要全部替换；执行会话任务时需要按分组名称显示在会话列表」。
🔑 **机制**：WorkBuddy 侧边栏空间分组名 = 会话 `cwd` 的 **basename** ⇒ **只改字符串无效，必须真改名目录**。
- 执行五步：① 停服务释放句柄（否则 rename 必 `WinError 5`）→ ② `mv mcn-work-shop mcn-workshop`（成功）→ ③ 临时脚本全仓替换 **`mcn-work-shop`→`mcn-workshop`：37 文件 / 121 处**；⛔ 按**沿革句规矩跳过** `.workbuddy/memory/YYYY-MM-DD.md`（16 个历史日志保留当时目录名史实）→ ④ 修 2 处被替换改坏语义的注释（`server.js` L1265 / L1269，原「旧 mcn-workshop／新建 mcn-workshop」被换成同词，已补回三代路径）→ ⑤ 重启验证：`app.js`/`data-pages.js` 200，`data-pages.js` 含 `pollFail` 修复。
- ⚠️ **事实澄清（易踩）**：`D:\AI技能\mcn-workshop` **不是工作台**，是 09-01 路径拼接 bug 留下的**垃圾目录**（3 个 0 字节文件 ＋ `outputs`）。工作台本体一直在仓库内 `…\V1.0\mcn-workshop`。sessions 表取证：该垃圾目录下**零会话**；未删除会话中仅 1 条 mcn-work 相关，cwd 仍是旧 `…\mcn-work-shop`。
- 净效果：新建后台会话 cwd = `…\V1.0\mcn-workshop` ⇒ 侧边栏分组显示 **`mcn-workshop`** ✅
- 残留：`project/…/subskills/mcn-data-insight/scripts/__pycache__/*.pyc`（二进制缓存含旧串，会自行重生成，无需处理）。
### 追加澄清（用户真实意图，⛔ 别再理解成"目录改名"）
- 用户要的不是改目录名，而是：**工作台提交 WorkBuddy 定时任务后，产生的 AI 会话应归属哪个「空间分组」**。
- 机制：分组名 = 会话 `cwd` 的**目录名**；工作台侧由 `server.js` 的 `SESSION_CWD`（当前 = 工作台自身目录）决定 ⇒ **改目录名只是让分组名变成 `mcn-workshop` 的手段**，不是目的本身。
- ⚠️ **存量不掉头**：10:07 那条榜单更新任务 cwd 仍是旧 `…\mcn-work-shop` ⇒ 显示在**旧**分组；改名后**新建**的任务才落到 `mcn-workshop`。清理用的 `SESSION_CWD_PATTERN='%mcn-work%'` 覆盖新旧三代，不受影响。
- 待用户定（功能语义分叉）：① 维持工作台专属分组 ② 归入用户当前主项目分组 ③ 自定义独立分组（需目录真实存在且在 workspaces 登记，08-27 即此法）。可选项：把 `SESSION_CWD` 提升为 `config.json` 可配字段，换分组只改配置不动代码。
## 后台任务进度可见（用户：「我需要看到 才知道执行是否正常」）
- 真需求：不是分组放哪，而是**在工作台内直接看到执行状态**，判断在跑还是卡住、做了什么。
- 后端 `server.js` `/api/run/status` 增强：automation → 关联它拉起的后台会话（`sessions.is_background_automation=1` 且创建时间落在任务创建 −15s~+300s）→ 读该会话 jsonl **尾部 256 KB** → 新增字段
`elapsedMs` / `sessionId` / `sessionTitle` / `lastAction`（最近一段文本，截断 160 字）/ `toolCalls`（按工具名计数）/ `updatedAgoMs` / `stalled`（>90 s 无新输出）/ `logBytes`。
- ⭐ 会话日志路径换算（可复用）：cwd → projects 目录名 = **盘符小写 ＋ 分隔符全转 `-`**（`escapeCwdForProjects()`）；基目录 `<workbuddy>/projects/<转义名>/<sessionId>.jsonl`。
- ⚠️ `stalled` 只在 `state=running` 时有意义（已完成任务日志当然不再写入，会恒 true）。
- 前端新增 `window.TaskProgress`（实现在 `public/app.js`，样式 `style.css` 的 `.tp-*`）：右下角常驻面板 = 状态／已运行时长／工具调用／最近动作／停滞警告。**四处轮询点全接入**：`app.js executeTask`、`data-pages.js` 的榜单更新／批量更新账号／视频解析。终态保留 8 秒自动收起，运行超时则保留供继续观察。
- 验证：三文件 `node --check` 全过；服务起来后 `app.js` 含 6 处、`data-pages.js` 含 9 处 `TaskProgress`，`style.css` 含 `.tp-panel`；状态接口返回完整进度字段。
### ✅ 分组归属定案：就用 `mcn-workshop` 文件夹对应的分组（已实测）
- 用户拍板：任务会话归到 **`mcn-workshop` 文件夹对应的那个分组**。
- 实测（提交轻量自检任务取证）：新会话 `cwd = …\V1.0\mcn-workshop` ✅；对照 10:07 那条旧榜单任务仍是 `…\mcn-work-shop`（**两者在侧边栏分属不同分组**，属正常存量，不用管）。
- 结论：**不需要再改代码** —— `SESSION_CWD = ROOT`，目录改名后自动生效。自检任务已删排期。
- ⚠️ 认知要点：侧边栏分组按 **完整 cwd** 聚合，不是按文件夹名合并 ⇒ 同名不同路径会是两个分组。
### ⚠️ 更正（12:2x）：分组靠 cwd **命中已打开的工作区**，光改目录名不够
- 上一条只对了一半：目录改名后会话 cwd 是**仓库内** `…\V1.0\mcn-workshop`，**不是用户的工作区** ⇒ 仍显示在「**未分组任务**」区域（用户实测反馈）。
- 用户纠正：`D:\AI技能\mcn-workshop` **才是那个工作区**。我此前仅凭目录里只有 3 个 0 字节垃圾文件就判它"是垃圾目录"——**没查登记表就下结论**，违反「判状态先问程序自己」。
- 🔑 **真机制**：侧边栏分组 = 会话 cwd **命中已打开过的工作区**才显示为命名分组；没命中 ⇒ 落「未分组任务」。
- 取证：`workspaces` 表仅 7 行且全是 `C:\Users\maidou\WorkBuddy\<时间戳>`，**不含**任何 `D:\AI技能\*` ⇒ 分组依据不是这张表，而是按会话 cwd 对已打开工作区的聚合。
- 修法（配置化，⛔ 不写死）：`load-config.js` 增 `sessionCwd`（默认 `''` = 用 ROOT）→ `server.js` `SESSION_CWD = String(CFG.sessionCwd||'').trim() || ROOT` → `config.json` 设 `"sessionCwd": "D:\\AI技能\\mcn-workshop"`。**换分组只改配置，不动代码。**
- 实测：新会话 cwd = `D:/AI技能/mcn-workshop` ✅；任务在该工作区执行正常（done，结果"成功"，73 秒）。对照 12:23 那条仍在仓库内路径 ⇒ 两组并存，旧的会随过期清理消失。
- ✅ 13:06 **二次模拟请求复验一致**（用户指示：不测真实功能，只发模拟请求看分组）：写入 `cwds=["D:\\AI技能\\mcn-workshop"]`，会话 cwd 同样命中 ⇒ 配置化改法稳定。两次自检排期均已删，会话留在目标工作区供用户肉眼确认。
## 素材库补采：批 65 收尾 + 批 66／67 完成（30 卡）
- 承 09-29 进度：批 65（细节专业 15 卡）已 apply 完成，细节专业 40→55。
- **批 66（细节专业 15 卡）**：取材 31748 姜乘澜底妆 / 17511 笑笑易 / 19014 俊希做菜 / 24821 烟道逃生 / 25090 姜乘澜画眼线。✅ **本批 5 条原生即教程／实操题材**，与细节专业天然契合（不像批 65 从非专业题材硬提）。apply：接受 15／退回 0，问法改写 15 张平均 +32 字。细节专业 55→70。
- **批 67（自嘲反差 15 卡）**：取材 26484 路之坑爹感恩宴 / 31816 直男五合一洗护 / 31970 李普不离谱 / 21500 桃气小周买饭 / 26411 老弟受难日记。含 1 张**元层面自黑**卡（31970 全家崩溃时推销泡面）。apply：接受 15／退回 0，问法改写 15 张平均 +12 字。自嘲反差 56→71。
- 两批均走完整链路：`写 md → _tmp_bNN_spec.py 生成 spec → meta.json → build-pending → cat PROMPT_polish_v3.md + build-pending 组装 prompt → 派 doubao-seed-2-1-pro → _wNN.py 校验落盘 → apply-pending`。
### 本轮新踩坑
- ⚠️ **MCP `myai-mcp-production` 登录态会过期**：批 66 拉第 4 条时报「认证失败」。解法：先 `auth_status` 确认 → `feishu_login` 重授权（拉起浏览器）→ 重试即通。**连续拉多条详情时中途要留意**。
- ⚠️ **spec 脚本里别夹英文单词**：批 66 的 neg 句误写「等摊主 processing」，批量产出会污染语料。写完 spec 脚本前先自查。
### 当前缺口（修正后口径，2026-10-08 10:50）
| 标签 | 现有 | 缺口 | 候选 |
|:--|--:|--:|--:|
| 食材极致 | 8 | 92 | ⛔ 0 |
| 预见式服务 | 21 | 79 | ⛔ 2 |
| 感官沉浸 | 59 | 41 | 14 |
| 细节专业 | 70 | 30 | 22 |
| 自嘲反差 | 71 | 29 | 34 |
| 视觉冲击 | 76 | 24 | 10 |
达标：品质对比 110 / 氛围沉浸 106 / 反差 217 / 反常识 128 / 价值观冲击 108。
- ⛔ **卡点未解**：`食材极致`（缺口 92）与 `预见式服务`（缺口 79）候选池近乎空，占剩余缺口一半以上。需换关键词或换捞法才能推进。
- 暂存批累计 24 批（43–52、54–67，缺 53）。
## 补采续跑：批 68（感官沉浸 15 卡）／批 69（细节专业 9 卡）
**批 68 · 感官沉浸（33289 子杭自驾318 ×6 ／ 31773 萝卜乔乔英国留学回国 ×6 ／ 30090 姐弟双向送礼 ×3）**
- apply 结果：**接受 15／退回 0，问法改写 15 张，平均 +19 字**。感官沉浸 59 → 74。
- ⭐ **两条来源 0 卡，已在 md 写明判据**：`28012`（电焊工试戏）男主嘴配的「滋滋」是**谐音梗的音效**而非真实声音质感，事件主角是"身在曹营心在焊" → 归 `反常识`/`自嘲反差`；`28415`（男朋友的算计）踩碎眼镜/摔筷子/拍桌的动静是**发疯甩锅的附产品** → 归 `反差`/`价值观冲击`。
- 感官通道分布齐全（冷/缺氧失眠/冰雹砸车/撕羊腿/热水澡/久坐腰酸 · 热瓶/苦到脸垮/中药味/红米肠/赶机喘/长途疲惫 · 中暑虚脱/猛灌水/红糖蛋滋啦）。
**批 69 · 细节专业（28328 海鲜蒸汽 ×4 ／ 37316 巧克力棒手作 ×5）= 9 卡**
- apply 结果：**接受 9／退回 0，问法改写 9 张，平均 +20 字**。细节专业 70 → 79。
- ⭐ **本批 3 条来源 0 卡，坚持不凑数**（沿用批 56 口径）：
- `20461`（机票骗局）—— 骗子的"专业"是**话术与骗术设计**（伪装客服、真退票取信、连环索要卡号），不落在"这一下换普通人来做就做不到位"的操作细节上 → `反差`/`反常识`。**这是细节专业最容易误判的一类：话术专业 ≠ 操作专业。**
- `24820`（烟道脱困）—— 主角是**作死翻车与体力消耗**，片尾"专业人士、专业场地、专业操作"是**反讽** → `自嘲反差`/`难度极限`；且同账号同题材 `24821` 已在批 66 取过两卡，本条脱困手法同构，不重复入库。
- `22163`（轮椅游渔岛）—— 倒拖轮椅过软沙滩属**体力付出** → `难度极限`；其余为情侣互坑 → `反差`/`自嘲反差`。
- ⭐ **取批命中率下降的信号**：细节专业候选池看着有 22 条，但主队列取 5 条只有 2 条可用（命中率 40%）。后续该标签每批卡数会低于 15，属正常，不要为了凑 15 张硬塞。
**新增踩坑与复用做法**
- ✅ **`_wNN.py` 用 sed 复用**（`sed -e 's/_raw68/_raw69/g' -e 's/pending_0068/pending_0069/g' -e 's/^N = 15/N = 9/' _w68.py > _w69.py`）—— 卡数变化时记得同步改 `N`。本轮连续 3 批（67/68/69）一次通过，`bad: []`。
- ✅ **超长详情自动落盘**：`33289` 返回 88,150 字符超限 → 工具落盘到 `D:\.workbuddy\projects\d-AI技能-mcn-short-video\<sessionId>\tool-results\*.txt`，用 Read 直接读（该文件只有 117 行，一次读完）。
- ⚠️ 派模型改用「让 Agent 自己 Read prompt 文件 → 自己 Write 落盘 `_rawNN.txt`」——比让模型把 JSON 回吐到对话再手工落盘更省上下文，连续 3 批稳定。
**当前缺口（批 69 后）**：自嘲反差 29（候选 34）｜感官沉浸 26（候选 14）｜视觉冲击 24（候选 10）｜细节专业 21（候选 22）。食材极致 92／预见式服务 79 仍挂起（用户 2026-10-08 决策：先不处理）。
## 批 70（自嘲反差 15 卡）· 本轮第 5 批 → 复核点
**结果**：接受 15／退回 0，问法改写 15 张，平均 **+27 字**（前几批 +19/+20，本批问法增厚更充分）。自嘲反差 71→**86**（缺口 14）。
**来源**：35376 唐轩乌龙×6 ｜ 35301 丁浩普信男×6 ｜ 28146 妈妈硬核推理×3。**5 条视频里 2 条 0 卡**（33593、21923）。
**⭐ 自嘲反差口径新增形态「姿态过载」**（本批确立）：
- 定义：主角自己把一件小事升格到远超其体量的规格，且全程一本正经（妈妈把女儿回家晚做成刑侦审讯：北风4级／100米／11分37秒 vs 6点12分39秒）。
- 判据仍落回一句话：**笑点落在主角自己身上**。妈妈是主角、推理的荒谬感由她自己一本正经地制造 → 收。
- ⛔ 反向凡尔赛揭晓（语数英 100/98/100 + 兑现平板）→ 笑点在预期被颠覆 → `反常识`；儿子 O 型嘴石化 → 笑点落在旁观者受击 → `反差`（世界参差）。均不收。
**两条 0 卡判据（写入 meta）**：
- **33593（张开父子的下场）**：家族护短复仇爽剧，爽点落在反派父子被制裁上，主角阵营全程降维打击，无一处笑点落在自己身上 → `反差`／`价值观冲击`。其「悲痛段落硬塞洗面奶口播」虽属元层面自黑，但批 67 已收同构卡（C1 全家崩溃时推销泡面）→ 不重复入库。
- **21923（消防设施瘫痪的代价）**：真实事件改编的沉重社会悲剧（烟花引火→消防栓被锁→接头拧不上→母亲丧生→儿子一夜白头），全片无笑点 → `价值观冲击`。
- ⭐ **通用判据沉淀**：**沉重社会悲剧类一律不进自嘲反差**；**元层面自黑要查是否已收同构卡**（批 67 已占一类）。
**其他弃卡判据**：35376「你那算盘珠子都崩我脸上了」是吐槽他人 → `反差`；「我没吃过我妈包的包子」与「我妈不会做饭」是同一场乌龙的两端 → 分作「立 flag」与「揭盅」两卡，不合并（同批 67 B2/B3/B4 细分做法）。35301 防晒植入段属商业植入；丽丽怒骂并入 B4 不单列。
**本轮 5 批（66–70）合计 69 卡**：66=15 ｜ 67=15（自嘲反差）｜ 68=15（感官沉浸）｜ 69=9（细节专业，不凑数）｜ 70=15（自嘲反差）。
**当前缺口（批 70 后）**：感官沉浸 **26**（候选 14）→ 视觉冲击 24（10）→ 细节专业 21（22）→ 自嘲反差 14（34）。食材极致 92／预见式服务 79 挂起。
**体检**：`5_tag_coverage.py` 卡片总数 1017（源文件 69 个），12 维无自造标签；⛔ 零覆盖仅 `难度极限`（用户决策不处理），⚠️ 偏少仅 `食材极致`（8，挂起）。
**复核抽查**：批 70 卡 6（哭着嚼坚果上供）润色生效——台词前置 + 破折号拍点（「我以后再也不养小仓鼠了，我对不起你」——唐轩把相框平放在桌上…），锁定 4 字段零改动，无编造。spec 回写 sim=3／neg=2、tag 单一、src 3 个，全部符合。
**⭐ 入库状态核查（用户问「素材都同步到 wekonra 了吗」→ 答案：没有，两层原因）**
- **流程层**：按暂存模式，补采只落 `batches/pending_import/`，统一入库必须跑 `13_import_pending.py --run`。截至批 70，**27 批 397 卡全部堆在暂存区，一条都没进库**（`13_import_pending.py --help` 盘点：27 批／397 卡／异常 0）。`batches/*.md` 41 批（早期跑过 `2_import_batch.py` 的）是唯一进过库的部分。
- **环境层**：`WeKnora-app` 容器 **Exited (127)**，最后一条日志停在 **2026-09-29 23:53**（health 200）→ 31607 端口不通，连"库里现有多少条"都查不了。同项目其余容器（frontend 24719 / docreader / postgres / redis）都在跑。**整个 10-08 的补采从未连过库。**
- **部署信息**：镜像 `wechatopenai/weknora-app:latest`，restart `unless-stopped`，compose 工作目录标签 `/home/maidou/weknora`（WSL 路径，本机 `docker ps -a` 可见）。拉起命令 `docker start WeKnora-app`；若仍 127 需查 compose 的 command/entrypoint。
- **回炉链路同样未完成**：「删旧条目 + 重导 + 检索终验」都还没做；回炉批 31–33 也未跑完。
- ⚠️ 排查口诀补充：**问「同步了吗」时先查两处**——① `13_import_pending.py --help` 看暂存盘点 ② `docker ps -a` 看 WeKnora-app 是否 Up。两者都要看，只查一处会误判。
**⭐ 规则核对：入库前必须补全 question（用户 2026-10-08 追问「是否遵循」→ 核查 27 批结论）**
- **规则依据（能查到的最强出处）**：RUNBOOK §步骤 6「写 spec.json（检索问法）」＝流水线必经步骤；**真正的动机在 RUNBOOK 红线**：「追加相似问不重建索引（`POST /faq/entries/{id}/similar-questions` 返回 200 但向量分数按位不变）→ **要改问法只能删 + 重导**」。所以「入库前补全」不是形式要求，而是**事后补的代价＝整批删+重导**。
- ⚠️ **未找到该规则的原始对话出处**：`conversation_search` 两次 0 命中，本地 memory / RUNBOOK 也没有「入库前要补全 question」这句原话。**已按「规范 + 红线」等价认定，未擅自当作既有明文规则引用。**
- **核查结论（27 批全量）**：全部有 spec.json、`std` 全部非空 → **形式上 100% 遵循**。但有 **2 批偏离现行规范**：
| 批 | 偏离 | 范围 |
|:--|:--|:--|
| **43** | `neg=3` 条（现行应为 2），且内容是**关键词短语**（「白酒带货 / 餐厅推荐 / 商务礼仪培训」）不是问句 | 15/15 卡 |
| **48** | `sim=2` 条（现行应为 3） | 15/15 卡 |
其余 25 批：sim=3（批 47 起）或 sim=6（批 44/45/46，合旧规范）／neg=2，全部合规。
- ⚠️ **文档与执行脱节（待用户裁定）**：RUNBOOK §步骤 6 明文写 **sim「口语问法 4–6 条」**，但**批 47 起实际统一为 3 条**（`_wNN.py` 校验也写死 `!= 3`）。要么改文档、要么把 sim 补回 ≥4 条。
- ⭐ **核查脚本口诀**：`glob('batches/pending_import/batch_*.spec.json')` 逐批 `Counter(len(x['sim']))` + `Counter(len(x['neg']))` 打分布表，一眼看出条数偏离；**别用 md 的 ```text 计数 //2 算卡数**（会算成一半，以 spec 长度为准）。
**⭐ Docker WeKnora 启动失败排查（2026-10-08 · 已修复）**
- **根因（不是应用崩溃，是容器 init 前的 bind mount 失败）**：`docker inspect WeKnora-app` 的 `.State.Error` 给出原文——
`OCI runtime create failed: runc create failed: ... error mounting "/run/desktop/mnt/host/wsl/docker-desktop-bind-mounts/Ubuntu-24.04/4f4eee8c…" to rootfs at "/app/config/config.yaml": not a directory: Are you trying to mount a directory onto a file (or vice-versa)?`
- **链路**：compose 写 `./config/config.yaml:/app/config/config.yaml`（文件→文件，写法正确，源文件 `/home/maidou/weknora/config/config.yaml` 确实存在且是 6545 B 的文件）→ 但 **Docker Desktop 的 bind-mount 代理层**（WSL 9P 中转，路径被哈希成 `4f4eee8c…`）把源**识别成了目录** → 挂载失败 → 容器连 init 都没进 → **Exit 127**（entrypoint `./scripts/docker-entrypoint.sh` 根本没执行）。
- **时间线**：StartedAt 09-28 01:45，FinishedAt **10-08 02:51** —— 正常跑了 10 天，今天凌晨有一次重启尝试（Docker Desktop/WSL 层变动）时代理层状态不对而失败。restart `unless-stopped` 不会救「启动失败」，所以一直停在 Exited。
- ✅ **修复：`docker start WeKnora-app` 一次即恢复**（`Up (healthy)`，31607 通）→ 属**代理层临时状态问题**，重试可解。复发时的升级路径：重启 Docker Desktop → `docker compose up -d` 重建容器（会换新的代理哈希）。治本方向：单文件 bind mount 跨 WSL 本就脆弱，可改 `docker cp` 或 volume。
- ⭐ **排查口诀：容器 Exited(127) 先看 `docker inspect --format '{{.State.Error}}'`**，不要只看 `docker logs`（日志只到上次正常运行，看不出启动失败原因）。本次日志最后一条停在 09-29 23:53 health 200，完全看不出问题，是 inspect 的 State.Error 直接给出根因。
**库内实测（服务恢复后）**
- FAQ 总数 **631**（分页抖动，去重拉取 624）。**问法 100% 齐全**：无 std 0 ／ 无 sim 0 ／ 无 neg 0。
- sim 条数分布 `{5:312, 6:222, 3:46, 2:30, 4:14}`、neg `{2:542, 3:82}` —— 历史口径混着（旧 5/6 条、现 3 条、少量 2 条）。
- 库内 tag_name 分布：反差 172／反常识 117／价值观冲击 93／视觉冲击 67／自嘲反差 44／细节专业 32／感官沉浸 26／氛围沉浸 24／品质对比 19／预见式服务 19／食材极致 9／难度极限 2 → **与本地统计一致，即已入库 = 早期 41 批；暂存 27 批 397 卡确实未进。**
- ⚠️ **接口结构坑**：FAQ 列表返回是 **`data.data`**（`{data:{total,page,page_size,data:[...]}}`）两层嵌套，只取一层会得到空列表；条目标签字段是 **`tag_name`**（不是 `tag`／`tags`）；`page_size=total` 一次拉全会返回空 → 必须分页 100 逐页 + 按 id 去重。
**新增踩坑**
- ⚠️ `_tmp_bNN_spec.py` 里卡片名提取必须 **`.replace("###","")`**：`head.split("｜")[0].strip()` 会带 `### ` 前缀 → `assert name in Q` 报 `AssertionError: ### 吃包子吃出丧母感`。批 70 踩到一次，加 replace 后通过。
- ✅ prompt 组装字节数核对：模板 7,683 + 载荷 34,647 = 42,330（`wc -c` 可验），比批 68 记录的 15,772 大是因当时统计口径不同，**以 `wc -c` 为准**。
.workbuddy/memory/MEMORY.md
+40 -41
View File
@@ -1,28 +1,40 @@
# MCN 短视频项目长期记忆（2026-09-28 精简重写 v3）
# MCN 短视频项目长期记忆（v4 · 2026-10-08 去重精简）
> 原则：**只放「索引 + 红线 + 踩坑」**。凡已在文件里可查的（SKILL.md / references / RUNBOOK / 工作台规范）只留指针。
> 原则：**只放「索引 + 红线 + 踩坑」**。凡文件里可查的（SKILL.md / references / RUNBOOK / 工作台 docs）只留指针，不抄内容。历史流水已清。
## 0. 权威源指针
| 主题 | 权威文件 |
|:--|:--|
| 技能全部口径 | `<仓库>/project/短视频脚本创作/V1.0/`（SKILL.md + references/references-add） |
| 路径/环境 | `references-add/路径配置.md` |
| 技能全部口径 | `<仓库>/project/短视频脚本创作/V1.0/`（SKILL.md + references + references-add） |
| 路径 / 环境 | `references-add/路径配置.md` |
| 留人密度 | `知识库/03_框架节奏/04_节奏控时叙事套路.md` §1.3 三级留人点体系 |
| 12 维标签 / 镜头 / 画面风格 | `素材库/分块定义/00_通用维度_分块定义.md` |
| 事件卡 10 字段模板 | `素材库/分块定义/00_模板-各库分块模板.md` §极致事件 |
| 赛道词表 | `知识库/标签库/赛道标签.md`（S01–S27 × 8 叙事形态 × 三级垂类） |
| 卡片批量生产 / 回炉 | `tools/weknora-ingest/RUNBOOK.md`（自包含手册，**§2.4 召回实测 / §2.5 回炉 SOP / §2.6 触发率**） |
| 工作台 UI | `mcn-work-shop/docs/工作台视觉交互规范.md` |
| 卡片批量生产 / 回炉 | `tools/weknora-ingest/RUNBOOK.md`（§2.4 召回 / §2.5 回炉 SOP / §2.6 触发率） |
| 工作台 UI | `mcn-workshop/docs/工作台视觉交互规范.md` |
| 工作台 AI 通路 | `mcn-workshop/docs/AI链路-本地CLI接入.md` |
| 技能侧 WeKnora 调用 | 技能 `references/接口调用/WeKnora_极致事件检索.md` |
## 1. 仓库与环境
- 本地 `D:\AI技能\mcn-short-video`；远程 `[email protected]:maogeigei/mcn-short-video.git`。
- 技能软链 `~/.workbuddy/skills/短视频工作台` = junction → `project\短视频脚本创作\V1.0\`；失效判据 children=0 → node `unlinkSync` + PowerShell `New-Item -ItemType Junction`。
- 环境判定（禁写死盘符）：路径含 `.dsh` → dsh（**只读**）；否则 `git rev-parse --show-toplevel` 成功=开发机 / 失败=用户环境。
- 产物落盘：桌面 `MCNSkill项目/{账号}/`。
- 技能版本：**只改 V1.0**；Lite1.0（无 subskills）默认不动；变更流程 = 方案→确认→执行→同步副本。
- 版本：**只改 V1.0**；Lite1.0（无 subskills）默认不动；变更流程 = 方案→确认→执行→同步副本。
## 2. 子技能要点
- **MCN工作台（Web）** `V1.0/mcn-work-shop/`：零依赖 Node，端口 8900。AI 任务 `POST /api/run`（写宿主 automation，once + `next_run_at`=now+5s）→ 轮询 `/api/run/status`；**创作/改写 prompt 必带 `SKILL_HINT_CREATE` 前缀**。配置单源 `config.json`；`.cjs` 无扩展 require 会 MODULE_NOT_FOUND → 配置模块用 `.js`；静态资源根映射，`/public/xxx` 必 404。
### 2.1 MCN工作台（Web）`V1.0/mcn-workshop/`
- 零依赖 Node，端口 8900。任务 `POST /api/run`（写宿主 automation，once + `now+5s`）→ 轮询 `/api/run/status`；**创作/改写 prompt 必带 `SKILL_HINT_CREATE` 前缀**。配置单源 `config.json`；`.cjs` 无扩展 require → MODULE_NOT_FOUND（配置模块用 `.js`）；静态资源根映射，`/public/xxx` 必 404。
- **AI 通路（09-29 起）**：`ai.backend` = `cli`（本地 CodeBuddy CLI，stdio 无端口）｜`dify`（旧链路兜底）。**细节全在 §0 权威文档，改动前必读**。四条硬红线：
- 🔴 **凭据**：`config.json` 是 git 跟踪文件 → key 只放 `%USERPROFILE%\.workbuddy\mcn-workshop\ai-cli.json`（仓库外，不被技能同步复制）。
- 🔴 **`SERVER__PORT` 必须删** —— CLI（含 `-p` 模式）内部起 HTTP server，继承宿主端口即 `EADDRINUSE` **静默卡死**，且 HTTP 层（health/info/sessions）看起来完全正常。**最容易误判的坑**。
- 🔴 **两段流程模型来源不同**：`/api/ai/clarify`（需求打磨）走**本地 CLI**（`ai.cli.model`）；`/api/run`（提交创作）走**宿主调度器**，模型取 `sessions` 表最近活跃**手动会话**的 `model`（兜底 `auto`）⇒ **改 `ai.cli.model` 不影响创作任务模型**。
- 🔴 **`custom:` 模型按租户开通**：本机 Key 租户**无 doubao**（500 / `service info not found`）；`custom-model-*` 真名从 `%TEMP%\mcn-cli-home\logs\**\*.log` 的 `requestModelId`/`requestModelName` 配对提取（问模型「你是谁」不可靠）。
- 其余备忘：性能三杠杆 `--tools "WebSearch,WebFetch"`（prompt -78%）/ `--effort low`（首字 61.7s→19.7s）/ 换模型；⚠️ `[INIT tools]` 是**注册表全量**，判生效看 `usage.input_tokens`；`/api/ai/topics` 是**死代码**；SSE 协议 `{delta}/{replace}/{error}/[DONE]`，cli 与 dify 一致（前端零改动）。
### 2.2 其他子技能
- **mcn-dou-analysis**：达人表 15 列、TOP6、≥60 条停、29 赛道枚举、浏览器 9223 + 标签页复用、**身份标识禁从 DB 回填**；产物 `POST /api/import/account` 幂等写 `mcn-plugin.db`。
- **mcn-data-insight**：11 个红狐子技能，榜单即查即缓存。红狐周期 code=3203 → 账号周榜最新可用期恒为**上一周**（非 bug）。
- **mcn-video-prompt**：F1 反推图/F2 反推视频/F3 生图/F4 分镜；格式优先级 = 用户格式 > 默认 6 层；llm-wiki 必须下沉读原始条目。
@@ -31,12 +43,11 @@
## 3. 创作红线
- 三态：⚡自动（静默只落最终物）/🤝共创（+确认门）/🛠开发（+全落盘）；产物链 05→06→07 禁跳步；硬编码禁止（P0）。
- 脚本必须走 S1-S11，禁会话内直写；开场钩子 3-7s，硬上限 10s。
- **留人点**：L1 极致触点 15-20s ／ L2 留人点 **每 10 秒 ≥1** ／ L3 增量点 3-5s。判据 = 观众产生明确「为什么」（抛问题/打破预期/说到自己/给承诺，≥1 种）；纯陈述/纯动作/重复前文不算。自检 = ⌈时长÷10⌉。**禁止混层**。类型名沿用五类机制，**禁自造枚举**。
- **留人点**：L1 极致触点 15-20s ／ L2 留人点 **每 10 秒 ≥1** ／ L3 增量点 3-5s。判据 = 观众产生明确「为什么」（抛问题/打破预期/说到自己/给承诺，≥1 种）；纯陈述/纯动作/重复前文不算。自检 = ⌈时长÷10⌉。**禁止混层**，类型名沿用五类机制，**禁自造枚举**。
- **三层定位**：素材库=存素材／极致事件=素材的内容层属性／知识库=讲方法。**事件卡模板与条目落在素材库侧**，`知识库/05_极致事件/` 只放类型层与判据。
- **事件卡 10 字段（顺序固定）**：`极致内容 → 内容含义 → 极致触点 → 事件标签 → 极致类型 → 创作手法 → 镜头语言 → 画面风格 → 复用场景 → 适用场景`。卡片头 `> 所属库：{NN 库名 ｜ 横切未定}` 不占字段位。
- 三易混字段：**极致内容**＝画面内容+氛围+质感（客观可拍）；**内容含义**＝`[期待A]—被X打破→[结果B]`；**极致触点**＝**效果侧两项：用户心理 / 共鸣**（机制词归标签/类型，效果词不复用标签词）。
- **事件标签 ≥2 值，主标签后缀「（主）」**；「事件标签」≠ 8 库「极致标签」。
- 创作手法含**铺垫量级 短≤3s / 中 3-10s / 长>10s**；翻车样本同等入库。**极致触点 ≠ 留人点**。
- **事件标签 ≥2 值，主标签后缀「（主）」**；「事件标签」≠ 8 库「极致标签」。创作手法含**铺垫量级 短≤3s / 中 3-10s / 长>10s**；翻车样本同等入库。**极致触点 ≠ 留人点**。
- **复用场景 ≠ 适用场景**：适用场景＝原生在哪被调用（从哪来）；复用场景＝事件结构能搬到哪（到哪去），取值 `{赛道·叙事形态·段落}`，**禁自造赛道名**。
- **素材条目形态铁律**：`### {名称}` + `- **字段**：值` 平铺列表；**禁写成多节表格报告**。
- 解析逆向：以 `analysis` 场次表为准（±1-2s 偏移）；`极限维度` 是**上游自造词，禁直录**，三步归一：剥落差→类型层→落 12 维。
@@ -44,7 +55,7 @@
## 4. 检索层：WeKnora + 卡片流水线
- 容器：`MCN极致事件素材库`（FAQ 型，`e6772e41-7b72-499d-b46c-e5ca7c9d1740`，`127.0.0.1:31607`，key 见 `D:\.workbuddy\mcp.json`）。**执行前必读 RUNBOOK**。
- ⛔ **接口四铁律**：① 只走 `POST /faq/entries` 批量通道（单条 `/faq/entry` 建的检索不到）；② 改相似问必须 DELETE + 重导；③ 检索必显式 `vector_threshold: 0.5`（默认 0.7）；④ dry_run 异步且占通道，须轮询 completed。
- ⛔⛔ **检索参数名铁律**：数量参数名 = **`match_count`**；写 `top_k`/`limit`/`size`/`count`/`k` 会**静默忽略并恒返回 10 条**（不报错）。`vector_threshold` **必须显式传**（省略 → 返回 0 条）。阈值只做事后过滤，**不能提升质量**。分数间隔**不可判优**（top1~top10 首尾仅差 0.047）→ 靠**人工复筛落差结构同构性**。
- ⛔⛔ **检索参数名铁律**：数量参数 = **`match_count`**；写 `top_k`/`limit`/`size`/`count`/`k` 会**静默忽略并恒返回 10 条**（不报错）。`vector_threshold` **必须显式传**（省略 → 返回 0 条）。阈值只事后过滤，**不能提升质量**；分数间隔**不可判优**（top1~top10 首尾仅差 0.047）→ 靠**人工复筛落差结构同构性**。
- ⛔ **删 FAQ 条目**：`DELETE /knowledge-bases/{KB}/faq/entries` + body `{"ids":[int64,...]}`；`DELETE /faq/entries/{id}` 是 404。
- ⛔ **FAQ 列表分页抖动**：`page_size=100` 页边界会重复。解法 = 先 `page_size=1` 拿 `total` → 再 `page_size={total}` 一次拉全。
- 其他：FAQ 检索恒为纯向量；条目**单标签**；`CustomMetadata` 不参与过滤；`auto_tag` 必须关。素材卡走 FAQ 型（文档型封顶 9/11）。**规则类文本不进检索层**。
@@ -55,36 +66,27 @@
### 4.1 补采自动化与标签治理
- 自动化 `MCN极致事件素材库·定向补采（每小时3批·暂存模式）`，id `c4d5eae8-e2ff-427a-99aa-d027d354bc19`，`FREQ=HOURLY;INTERVAL=1`，ACTIVE。**rrule 不支持分钟级** → 单次触发连跑 3 批。
- 脚本：`4_sensory_candidates.py`（感官候选）／`5_tag_coverage.py`（12 标签体检）／`6_target_candidates.py`（定向筛，含 `NEGMAP`）／`7_dispatch_next.py`（**调度器**：算缺口+取批命令+SKIP/PRIORITY）。取批三入口：主队列／`--sensory`／`--target <标签> N`。
- 脚本：`4_sensory_candidates`（感官候选）／`5_tag_coverage`（12 标签体检）／`6_target_candidates`（定向筛，含 `NEGMAP`）／`7_dispatch_next`（**调度器**：算缺口+取批命令+SKIP/PRIORITY）。取批三入口：主队列／`--sensory`／`--target <标签> N`。
- **目标「每标签 ≥100 条」**：**严格主角判据** + **食材优先** + **难度极限暂不处理**。缺口跑 `7_dispatch_next.py`，**勿写死**。
- ⭐ **「食材极致」严格主角判据 3 条**：① 部位知识型 ② 验鲜解剖全流程型 ③ 形态重组型。
- ⭐⭐ **暂存模式（防返工关键机制）**：补采只产 `batches/pending_import/{batch_00NN.md,.spec.json,.meta.json}`，**禁跑 `2_import_batch.py`/`3_done_batch.py`、禁改 `state.json`**。统一入库 = **`13_import_pending.py --dry|--run|--sync`**。**安全结论**：回炉删除按 `polish_plan.json` 冻结的 526 id → 新采卡不会被误删；唯一真风险 = 重跑 `9_polish_plan.py`（已禁）。
### 4.2 卡片回炉 + v3 双任务 SOP — 详见 RUNBOOK §2.5
- 链路：`8_backup_all.py` → `9_polish_plan.py` → `10_polish_batch.py payload|apply <n>` → 删旧 + 重导 → `11_diff_report.py`。
### 4.2 卡片回炉 + v3 SOP（细节 → RUNBOOK §2.5）
- 链路 `8_backup_all` → `9_polish_plan` → `10_polish_batch payload|apply <n>` → 删旧 + 重导 → `11_diff_report`。
- **字段契约**：可润色 6（极致内容/内容含义/极致触点/创作手法/镜头语言/画面风格）／**锁定 4**（事件标签/极致类型/复用场景/适用场景）／可改写问法 3 组。
- **三重校验**：① 字段集合一致 ② 骨架完整 ③ 行数不变。任一失败 → 该卡退回。
- ⭐ **v2「吸引力优先」**：判据 = **内容是否更短视频化**。三特征：破折号 +24%／口语化连接词 +28／强动作动词 +32%。三改动 = **台词前置／破折号拍点／动词升级**。
- ⭐ **约束强度对照**：堆「禁止…」严约束 → 改动率仅 1%；宽约束 → 46%。走宽约束。
- ⭐ **v3 第二任务：问法增厚**：`std` 保留骨架补画面、`sim` 条数严格相等、`neg` 保持负例属性。**v3.1 绝对边界**：增厚 = **搬运原文已有信息**。自检口诀：「问法里每一个具体信息点，都必须能在该卡 6 个可润色字段 + 事件标签里找到出处；找不到的删掉。」
- ⭐ **`validate()` 返回 5 元组** `(ok, reasons, cleaned, q, autofix)`；**std 前缀校验 = autofix 语义**（原文无前缀时模型误加 → 自动剥离，不退回）。
- ⭐ **`fiction_check` 防误报**：引号字符类匹配弯/直引号；比对须归一化。实测残留告警全为误报 → 只告警不拦截。
- ⭐⭐ **暂存批 v3 链路（已跑通）**：`10_polish_batch.py build-pending <n>` → `Agent(model="doubao-seed-2-1-pro")` 喂 `PROMPT_polish_v3.md`+载荷 → 存 `out/polish_result/pending_00NN.json` → `apply-pending <n>`。
- ⚠️ **`apply-pending` 必须在同一次执行内跑完**：曾出现「已生成 pending_00NN.json 但未 apply」→ 续跑须先补 apply（批次 48 实测）。
- 工具：`12_attractiveness.py`、`11_diff_report.py`、`14_form_audit.py`、`15_sensory_recall.py`（含 `extract_name()`）、`16/17_question_ab.py`、`18/18b_question_validate(.r).py`。
- ⭐ **v2「吸引力优先」**：判据 = **内容是否更短视频化**；三改动 = 台词前置／破折号拍点／动词升级。⭐ **宽约束**（严约束改动率仅 1% / 宽 46%）。
- ⭐ **v3 问法增厚**：`std` 保留骨架补画面、`sim` 条数严格相等、`neg` 保持负例属性。**绝对边界 = 搬运原文已有信息**（每个信息点须能在该卡 6 个可润色字段 + 事件标签找到出处）。
- 🔴 **暂存批 v3 链路**：`build-pending <n>` → 喂 `PROMPT_polish_v3.md` + 载荷 → 存 `out/polish_result/pending_00NN.json` → `apply-pending <n>`；**`apply-pending` 必须同一次执行内跑完**（曾漏跑，续跑须先补，批次 48 实测）。
- 其他：`validate()` 返 5 元组 `(ok,reasons,cleaned,q,autofix)`，std 前缀不符走 autofix（剥离、不退回）；`fiction_check` 弯/直引号须归一化，只告警不拦截；工具 `11_diff_report`/`12_attractiveness`/`14_form_audit`/`15_sensory_recall`/`16-18*_question_*`。
### 4.3 ⭐⭐ 技能侧 WeKnora 调用（权威源 = 技能 `references/接口调用/WeKnora_极致事件检索.md`）
- 🔴 **素材召回触发率 ≈ 0（端到端实测 ×2 路径）**；**口径（用户确立，优先）**：架构 = 「**流程不主动召回素材，知识库按需被取**」= 设计意图，**不改**。`hybrid_search` 0 次 ≠ bug。判据只有两条：① 模型**真能写出桥段** → 跳过 = ✅；② **写不出却仍不检索** = ❌。
- 实测：4 会话 191 次工具调用、召回 0 次；模型自述「中间步骤已在上下文按序完成，自动模式后台静默」→ 整段脑内跳过。
- **⭐ 素材库两个作用位**：**① 给事件「填空」**（S7 写不出桥段时取机制样本）＋ **② 给台词「润色」**（S9 取原话/微反应/意外）。**两者是同一条链上下游**：S7 触发 ≈ 0 → S9 的 `{material_cards}` 恒空 → ② 退化。**∴ ② 失效是 ① 的直接后果**（②修好①自动恢复，改动最小）。
- 文件位置：① `7_生成短视频大纲.md` §极致触点素材检索；② `9_生成短视频脚本.md` L12 + L101-113 §3.1。
- **结论**：不动架构；解「"按需"判据太软」→ 推荐 **C1 换外部可验证判据**（"通用 vs 专属"可验证，不像"我能不能写"）。⛔ 作废「删除跳过条款 → 默认必检」。
- 会话记录 `D:/.workbuddy/projects/<cwd转义名>/<sessionId>.jsonl`；工具 `20_trace_recall.py`。工作台「提交创作」是**两段式**（`#reqCreate` 只弹确认，真提交在 `button[data-ok]`）。
- ✅ **确定有效 = 参数纠正**：`match_count` 实测省 69% 上下文；`vector_threshold` 必显式传。
- ⚠️ **收益有限 = 问法改写**：反查法旧 R@1 34/35 vs 新 35/35 → **差异在噪声内**。价值 = **信息量保障**，不是提升召回率。⛔ 禁宣称"召回率 97%→100%"。
- 🔴 **真实瓶颈 = 素材覆盖**：需求法暴露 3/5 真实节点零命中 → 问法再优化也召不回不存在的素材。
- 🔬 **验证方法论铁律**：测「检索优化」→ ⛔ 禁用「凭空需求」法；✅ 必用**「反查法」**。
- ⚠️ **信息保真审计口径**：真判据 = **角色台词零丢失 + 数字零丢失 + 可拍动作/物品全在**。
### 4.3 技能侧 WeKnora 调用（权威源 = 技能 `references/接口调用/WeKnora_极致事件检索.md`）
- 🔴 **素材召回触发率 ≈ 0（端到端实测 ×2 路径）**；**用户口径（优先）**：架构 = 「**流程不主动召回素材，知识库按需被取**」= 设计意图，**不改**。`hybrid_search` 0 次 ≠ bug。判据仅两条：① 模型**真能写出桥段** → 跳过 = ✅；② **写不出却仍不检索** = ❌。
- ⭐ **素材库两个作用位**：① 给事件「填空」（S7 写不出桥段时取机制样本）② 给台词「润色」（S9 取原话/微反应/意外）。**同一链上下游**：S7 触发≈0 → S9 `{material_cards}` 恒空 → ② 退化；**∴ ② 失效是 ① 的直接后果**（修①即自动恢复）。文件位：`7_生成短视频大纲.md` §极致触点素材检索；`9_生成短视频脚本.md` L12 + L101-113。
- **结论**：不动架构；解「按需判据太软」→ 推荐 **C1 换外部可验证判据**（"通用 vs 专属"可验证）。⛔ 作废「删跳过条款 → 默认必检」。
- ✅ **确定有效**：参数纠正（`match_count` 省 69% 上下文；`vector_threshold` 必显式传）。⚠️ **收益有限**：问法改写（反查法 R@1 34/35→35/35，**差异在噪声内**；⛔ 禁宣称"召回率 97%→100%"）。🔴 **真实瓶颈 = 素材覆盖**（3/5 真实节点零命中）。
- 🔬 **验证方法论铁律**：测检索优化 → ⛔ 禁用「凭空需求」法；✅ 必用**「反查法」**。⚠️ 信息保真审计口径 = **角色台词零丢失 + 数字零丢失 + 可拍动作/物品全在**。
- 杂项：会话记录 `D:/.workbuddy/projects/<cwd转义名>/<sessionId>.jsonl`；工具 `20_trace_recall.py`；工作台「提交创作」两段式（`#reqCreate` 弹确认，真提交在 `button[data-ok]`）。
## 5. 麦芽平台采集（脚本在 `tools/`）
- ⭐ **接口直取，禁 DOM 翻页**：`GET /api/scriptwriting/shortVideo/hot?pageNum&pageSize&sortType&startLikeNum`（pageSize=50 最快）。
@@ -110,14 +112,11 @@
- ChatGPT 投材料（`tools/chatgpt_ask.py`）：**长材料走附件上传**；完成判定 = 无 stop 按钮且文本连续 4 次不变。
## 8. 工作台 UI 定稿要点
> 完整铁律查 **`mcn-work-shop/docs/工作台视觉交互规范.md`**（权威源）。
> 完整铁律查 **`mcn-workshop/docs/工作台视觉交互规范.md`**（权威源）。
- 榜单四榜末列恒「功能」= `inDb ? 查看 : 关注`；热门榜与点赞榜字段体系不同 → 跨榜逻辑双向回退。
- 选题列表由 `rewrite_id` 驱动：点标题=详情；「查看脚本」=`openScriptModal({rewriteId})`；「编辑继续」=带 id UPDATE；「复制」=不带 id 新增。
## 9. 历史时间线（压缩）
- 08 月：素材库扁平化 8 类型；赛道 8→27；三态创作；Lite1.0；`.dsh` 只读；工作台立项。
- 09-10 仓库迁移 + 环境判定｜09-14 全量技能审计（P0=0/P1=8/P2=7）｜09-16 工作台 AI 创作改版 + UI 规范定稿。
- 09-21~22 极致事件定义与三层定位裁决、事件卡 10 字段定稿。
- 09-23 WeKnora 检索层建成（FAQ 容器 + 阈值 0.5）；留人点三级体系定稿。
- 09-23~24 卡片流水线化（RUNBOOK + 脚本 1/2/3）。
- 09-28 定向补采自动化 + 卡片回炉（v2 吸引力优先 + v3 问法增厚）+ 补采切暂存模式；检索参数名纠正。
- 09-10 仓库迁移 + 环境判定｜09-14 全量技能审计（P0=0/P1=8/P2=7）｜09-16 工作台 AI 创作改版 + UI 规范定稿｜09-21~22 极致事件定义与三层定位裁决、事件卡 10 字段定稿｜09-23 WeKnora 检索层建成 + 留人点三级体系定稿｜09-23~24 卡片流水线化｜09-28 定向补采自动化 + 卡片回炉（v2/v3）+ 补采切暂存模式 + 检索参数名纠正。
- 09-29 AI 通路改 `cli`（本地 CodeBuddy CLI）→ 端到端跑通（status/probe/clarify/run），模型 `deepseek-v4.1-flash`；权威文档 `docs/AI链路-本地CLI接入.md`。