# 2026-08-17 工作日志

## 短视频创作流程新增「产物保存模式」（用户模式/开发模式）

**触发**：用户要求创作流程增加两种保存模式，默认用户模式。

**设计关键点**：新增的「产物保存模式」与现有「创作模式」（快速/共创）是**两个正交维度**——创作模式管"确认行为"（Gate 是否暂停），保存模式管"落盘范围"（中间产物是否写盘），可自由组合（如「快速+用户」默认、「共创+开发」调试）。

**两种模式定义**：
- 👤 **用户模式（默认）**：只落盘最终交付物（账号级人设卡片 + 脚本正文 + 分镜脚本 + 诊断报告 + 创作回顾.html），中间产物（01~08）仅在对话上下文完整传递，不写盘
- 🛠️ **开发模式**：与历史一致，每步产物全落盘

**产物链铁律修订**（核心）：原铁律"全链落盘 + 信息只读已落盘文件"改为模式感知——
- 「全链产出（两模式一致）」：中间产物永不省略，只是保存介质随模式变化
- 「信息只读已确认产物」：开发模式读落盘文件，用户模式读对话上下文（不写盘但内容完整传递）

**修改文件（4 处）**：
1. `SKILL.md` L10 description + L36-42 创作模式章节 + L267-274 产物链铁律
2. `创作流程规范.md` 二、新增「产物保存模式」小节（L62-92）
3. `创作流程规范.md` 五、落盘清单表 + 铁律模式化（L432-443）
4. `4_账号设定解析和确认.md` L123 人设卡片两份文件模式区分
5. `11_脚本检查和诊断.md` L172 创作回顾.html 数据源模式区分

**验证**：「全链落盘」「只读已落盘文件」等旧表述仅在开发模式语境正确保留，无矛盾残留。

## 方案 A 落地：用户模式补「执行范围」= 后台静默

**触发**：用户反馈"用户模式下说生成脚本，AI 把所有步骤都跑了一遍、生成了所有内容"。三层根因：①产物链铁律 P0「全链产出」强制全链执行（主因）②意图②前置门强制先确认人设+框架 ③用户模式只定义了「落盘」没定义「执行范围」。

**方案 A（后台静默）核心**：用户模式 + 单一诉求（"生成脚本"）时，中间步骤 S1~S8 **后台静默执行**——完整产出（不跳步）、不逐个展示、不落盘、不停顿确认，只显式产出目标步骤（如 S9 故事脚本）。

**关键原则**：
- 后台静默 ≠ 跳步：05→06→07 等中间产物仍按顺序完整产出，仅作为内部信息源在对话上下文传递
- 只显式产出目标步骤：用户要求什么，可见结果就是什么
- 前置门静默通过：意图②的 settings_confirmed 门不停顿，有人设卡片直接读、无则自动生成
- 共创模式优先：用户显式选共创时，中间步骤仍逐步展示确认（正交性保持）

**修改文件（9 处，2 文件）**：
1. `创作流程规范.md`：L64 职责定义（落盘+执行范围）、L66-82 用户模式表格加「执行范围」行 + 「执行范围·后台静默」说明段、L100 正交说明、L435 注释、L441 铁律1条、L569 意图②前置门例外
2. `SKILL.md`：L10 description、L40 产物保存模式定义、L274 用户模式 bullet

## 三态模式重构：废弃两维正交，简化为 自动/共创/开发

**触发**：用户认为之前「快速/共创 × 用户/开发」两维正交搞复杂了，要求：用户模式融合进自动模式（默认）、共创模式=自动+步骤询问、开发模式=步骤全落盘。

**新三态体系（互斥，一次只处于一种）**：
- ⚡ **自动模式（默认）** = 后台静默执行 + 只落盘最终交付物（融合原「快速+用户」）
- 🤝 **共创模式** = 自动 + 每个确认门（Gate-0~6）展示产物并询问用户；落盘同自动
- 🛠️ **开发模式** = 自动 + 每步产物全落盘（01~11+创作回顾.html）；Gate 自动通过

**设计公式**：三态 = 自动执行（基底） + 可选增强（共创=+询问，开发=+落盘）。已删除「产物保存模式」「两维正交」概念。

**修改范围（9 文件 20+ 处）**：
1. `创作流程规范.md`：模式章节整体重构（三态定义/切换规则/互斥说明）、确认门机制、落盘清单表（3模式行）、产物链铁律、意图②前置门例外（自动/开发静默通过）
2. `SKILL.md`：description、模式章节、模式说明、关键规则、产物链铁律
3. 下游 7 文件：帮助文档.md、2_需求完善.md、4_账号设定解析和确认.md、5_生成短视频选题.md、6_生成短视频框架.md、7_生成短视频大纲.md、11_脚本检查和诊断.md（Gate 说明行「快速模式」→「自动模式」+ 模式落盘表述）

**验证**：全文 grep「快速模式/用户模式/产物保存模式/两维正交/保存模式」零残留；新表述正向验证全覆盖。

**教训沉淀**：模式设计优先考虑用户心智负担——两维正交概念正确但难用，用户最终选择三态互斥（每态=一个完整心智模型，无组合推导成本）。

## MCP 部署预检扩展：运行时 → 三件套（npm 缓存权限坑）

**触发**：用户 Mac 部署 MCP 失败，根因是 `.npm` 缓存 11078 个 root 权限文件（_cacache 6515 + _npx 4563），npx 无法写入缓存 → MCP 静默启动失败；排查一度误判为镜像问题（实际源已是 npmmirror 且包能下载）。

**固化 3 处**：
1. `MCP_工具调用规范.md` §3 部署预检：①运行时版本 ②npm 缓存权限（`npm config get cache` + `find ~/.npm -user root`，清理 `rm -rf ~/.npm/_npx ~/.npm/_cacache` 无需 sudo，勿动 ~/.npmrc）③npm 源（可选非根因）；排查顺序 1→2→3
2. `失误与规避记录.md` #007
3. `~/.workbuddy/MEMORY.md` MCP 安装前置检查（跨项目约定）表格化三件套

**教训**：npx 型 MCP「包能下载 ≠ 能启动」，缓存写入权限是独立故障域；macOS sudo 装包/系统迁移后必查 `~/.npm` 权限。

## 清理 § 特殊符号（5 处，3 文件）

`§` 符号影响阅读，全部去掉（`§3`→`3` 保留编号）。修改：
1. `MCP_工具调用规范.md`：L39 `[§4 登录检查]`→`[4 登录检查]`、L118 `[§3 自动检测与安装引导流程]`→`[3 ...]`
2. `Douyin_Video_Analysis.md`：L9/L10/L96 引用 `§3/§4/§5`→`3/4/5`
3. `失误与规避记录.md` #007：`§3 部署预检`→`3 部署预检`

**保留不动**：~~`参考skills/seedance2.0-prompt-skill/` 内 10 处 `§`（storyboard-driven.md、image-to-prompt.md、09-延展创意集.md）——第三方参考技能，按「参考技能原文不做修改」原则保留。~~（用户随后指示"三方技能也全部修改"，已全部清理，2026-08-17 全项目 `§` 零残留）