maogeigei
c48902f063
配置收敛：
- 端口/DB名/产出根/榜单目录单源化到 mcn-work-shop/config.json，代码层统一经 load-config.js 读取
- 新增 get-port.js 供 start.bat 读端口（bat 内嵌 node -e 会被 cmd 截断，读到的是兜底值）
- start.bat 修复失效的 managed node 路径（原写死 22.22.2 已不存在），改为遍历 versions 自动探测
复盘诊断页（真 bug 修复）：
- 问题清单严重度全部显示成绿色 + 修改建议不显示：模型输出 {sev:'high',fix} 与前端读取 {severity:'高',suggestion} 字段名与取值均不匹配
- 前端新增 normIssue 归一化，兼容 sev/severity/level 与中英取值，并回补所属维度显示
- 在 submit-review-tasks 与诊断/复盘 prompt 中固化 issues_json 字段契约，从源头防 schema 漂移
分镜提示词：
- 原创选题（video_id 为空）原本无生成入口（分镜按 video_id 查询）
- listStoryboards 支持按 rewrite_id 查询，前端放开入口、切版本重查，并补落库指令（此前入库靠模型自由发挥）
榜单展示：
- 期号改为显示区间「08/31 ~ 09/06」，避免被误读为单日（期号=该周周一）
- 后端新增 collectRanges，从落盘文件读真实 dateStart/dateEnd 随 API 返回（日榜 start=end 不显区间）
其他：
- 清理 dsh 环境废弃后的历史叙述类废话（16 文件约 18 处），文末变更记录区保留
- 新增 docs/工作台UI规范.md（设计 token / 布局 / 8 页面路由 / 12 类组件 / 9 条已知坑）
3.4 KiB
3.4 KiB
铁律避坑规则（功能一：获取账号信息）
本文件记录账号信息获取（功能一）执行过程中踩过的坑和沉淀的解决方案，防止重复犯错。 与「账号设定执行避坑.md」（功能三）、「账号数据分析执行避坑.md」（功能四）互为镜像，结构一致。
一、工具/工艺类
| # | 问题现象 | 根因 | 解决方案 | 沉淀状态 |
|---|---|---|---|---|
| 1 | （预留） |
二、数据质量类
| # | 问题现象 | 根因 | 解决方案 | 沉淀状态 |
|---|---|---|---|---|
| 1 | 账号表登记（TC-01）时直接用工作台库 mcn-plugin.db 的 hot_accounts 表读取 sec_uid/抖音号/地址填表，被用户指出「为什么又走到 MCP/库去了」 |
① 就近取数惯性：模型遇到填表需求优先找现成数据（库读取成本低、看起来权威），而非走浏览器实时抓取（成本高）；② 规则覆盖缝隙：SKILL.md L50 红线约束的是「获取达人账号信息（功能一）」抓取流程，Step 1.0 只说「存文本格式」未规定身份标识（sec_uid/抖音号/地址）的数据来源，登记占位阶段钻了空子；③ 同源性未识别：hot_accounts 表 = MCP 内部账号库（list_hot_accounts/hot_account_detail）的本地副本，绕道读 db 拿到的是同一份内部账号库数据，形式上"没碰 MCP"实际同源违规；④ 前置检查（P4 MCP 可用性）在 TC-01 阶段就调 MCP 工具（auth_status），加剧用户观感 |
① 登记只占位 账号ID+达人昵称，身份标识一律留空待浏览器抓取后回填；② 红线明确「禁止从任何数据库读取账号字段回填账号表（含身份标识）」，hot_accounts 表 = 内部账号库本地副本，读其数据等同违反红线（已固化 SKILL.md「账号信息数据源」红线 + feature/01 Step 1.0）；③ 库仅用于流程状态参考（判断是否已解析/产出），不是账号数据来源；④ MCP 工具调用严格限定在 TC-05 视频解析环节，前置检查只确认可用性，TC-01 登记阶段不调用 MCP 工具 |
已沉淀为本规则（2026-08-31 强化） |
三、流程/规范类
| # | 问题现象 | 根因 | 解决方案 | 沉淀状态 |
|---|---|---|---|---|
| 1 | 账号数据来源规则分散在 SKILL.md/feature/浏览器规范多处，无统一避坑记录 | 功能一/二无独立避坑文件 | 新建本文件（功能一避坑），与功能三/四避坑文件并列；数据来源红线唯一权威定义在 SKILL.md，本文件只记录案例与根因 | 已沉淀为本规则 |
快速参考：数据来源红线速查
权威定义：SKILL.md「账号信息数据源（红线）」；执行流程：
references/feature/01_获取账号信息.mdStep 1.0。
| 数据 | 允许来源 | 禁止来源 |
|---|---|---|
| 账号身份标识（抖音号/sec_uid/抖音地址） | 浏览器抓取（browser-harness 访问抖音主页） | 工作台库 mcn-plugin.db（hot_accounts 表 = MCP 内部账号库本地副本）、MCP list_hot_accounts/hot_account_detail |
| 账号统计数据（粉丝/获赞/关注/作品/IP/简介） | 浏览器抓取（网页实时值） | 同上（MCP 兜底仅限浏览器无法访问时，须注明来源） |
| 流程状态参考（是否已解析/已生成） | 工作台库只读参考 | ——（只用于判断，不回填账号表） |