@biunow/agent-biuart 0.0.0-stage → 0.1.0

package/skills/biuart/references/16-/351/243/216/346/240/274/346/274/224/347/244/27295/345/210/206/345/215/217/350/256/256.md

@@ -0,0 +1,103 @@
+# 16 · 风格演示协议：从「受启发的扁平插画」到「一眼认得出是谁的画」
+
+何时读：新做、重做任何一个艺术风格的演示场景（`scenes/<id>.js`），或派 agent 做的时候把本页路径给它。15 号管「怎么研究一个风格、怎么迁移」，本页管「演示做到什么水平才算数、怎么一步步做到」。
+
+## 为什么 2026-10-15 新增的 17 个演示几乎不可用
+
+2026-10-16 把它们渲成静帧并排看，又拉了公版原作对照，查出五个根因（17 个里绝大多数符合；45 雷诺阿是外部位图＋网格变形、44 带帷幕，不是扁平矢量块，但同样缺原作锚定和媒介层）：
+
+1. **没有人看过原作。** 配方卡只有文字描述和馆藏链接，做的人（agent）凭印象画。结果是大部分图像同一个现代扁平插画师换了套色板：形是干净的矢量块，风格只剩「调色板＋一层噪点」。
+2. **卡片措辞把锚点也拿掉了。** 「不凭单幅名作概括」「构图不搬用」本意是防抄袭，实际变成「不许对着原作做」。该防的是搬名作的人物和坐标，不是不许学笔法、材料、色彩关系、人物造型逻辑。
+3. **没有「媒介」这一层。** 老标杆（梵高 09、水墨 17）强在把画面过一遍真实的画材：流场笔触、飞白、墨晕。新场景 35–70 行，只画形，不过画材。
+4. **同一个题材套所有风格。** 洗衣机、水车、修机器反复出现（这轮重做也没完全避开：38 与 47 都有「木箱／载货」、51 又用了汲水轮——47 已改成麻袋，余下的列入进度表待改），风格自己的叙事逻辑（马远的一角、细密画的满铺、高更的裁切、乔托的视线）全被抹平。
+5. **没有分数门槛。** 自检只有 qa 的技术项（能渲、确定性、不闪），没人拿着原作问「像不像」，所以 6 秒能跑就算交付。
+
+## 协议（按顺序，每一步有产物）
+
+### 1. 原作锚定
+
+```sh
+uv run <skill>/scripts/analyze/fetch_reference.py --out <项目>/参考/<风格> "艺术家 作品A" "艺术家 作品B" "艺术家 作品C"
+```
+
+至少 3 幅**不同作品**（15 号的口径）。脚本拉维基共享资源的公版图，存本地，抽主色板，出接触表。然后**真的看这张接触表**，写下：
+
+- 5 条签名特征，每条分「必须有／加分／禁忌」。例：马远——必须有：一角构图、大面积留白、斧劈皴；加分：垂柳、渺小的人看向空处；禁忌：满幅填充、彩色鲜艳。
+- 主色板（取脚本抽出的色值，写明明处偏什么、暗处偏什么）。
+- 这种画在现实里是怎么做出来的（刷、刻、描、涂、贴）。那个物理过程就是渲染器的规格。
+
+### 2. 题材按风格自己的逻辑重构图
+
+不搬名作的人物和坐标，但学它**组织画面的方式**：马远留白＋一角；细密画把地面竖起来满铺、建筑切开；高更裁切前景、斜线分割；乔托用视线把人物咬合；印象派天占一半、水把岸拖成碎笔。写一句「这个风格的构图规则」，再按它给新题材定布局。**同一个题材不许套第二个风格。**
+
+### 3. 画「干净的形」，再过「媒介通道」
+
+禁止在扁平矢量上叠噪点就算风格。场景分两层：
+
+- 形层：把物体、人、空间画干净（可以是 Canvas 路径、离屏画布）。
+- 媒介层：用 `lib/medium.js` 或老库把形层过一遍真实画材。
+
+| 通道 | 做什么 | 用在 |
+|---|---|---|
+| `MEDIUM.broken(src, o)` | 重画成一笔一笔的弯笔，明处偏暖暗处偏冷 | 印象派（西斯莱、毕沙罗、瓜尔迪、雷诺阿） |
+| `MEDIUM.fresco(c, plate, o)` + `MEDIUM.plaster` | 色粉被石灰吃进去＋灰泥颗粒、针孔、接缝 | 湿壁画（乔托、皮耶罗、拉斐尔） |
+| `MEDIUM.silk` + `P.brush` / `P.inkWash` | 绢纹、飞白、墨分五色 | 水墨（马远） |
+| `MEDIUM.flat(c, path, fill, o)` | 掐丝珐琅：同色块里有顺笔向的短条＋粗而不均的深色轮廓 | 高更、综合主义、彩绘玻璃 |
+| `MEDIUM.figure(c, o)` | 有体量的着衣人物：袍、披风、褶、视线 | 壁画、细密画、平面叙事类 |
+| `MEDIUM.outline / hatchFill` | 变宽线、排线 | 木刻、铜版、细密画暗部 |
+
+库里没有对应通道时，写一个通道函数进 `medium.js`，不要把它写死在某个场景里。
+
+### 4. 一帧先行，并排对照
+
+先出静帧，不先做动画。
+
+```sh
+uv run --with playwright python <工程>/render.py --film style_studies --solo <id> --stills 3 --no-counter --out 渲染/<id>
+uv run <skill>/scripts/analyze/side_by_side.py --ref 参考/<风格> --frame 渲染/<id>/t003.00.png --out 对照/<id>.jpg
+```
+
+「一眼认得出是谁的画」只能拿着这张并排图回答。
+
+### 5. 让画活：用风格自己的运动逻辑
+
+主动作＋2 个母题循环（08 号第 3 条）。风格自己的动法：墨随风、笔触在呼吸、水面把倒影拉碎、壁画几乎不动但视线与交接在动。不要所有风格都用同一套淡入淡出。
+
+### 6. 打分，门槛 80，最多两轮
+
+| 项 | 分 | 怎么判 |
+|---|---|---|
+| 签名命中 | 35 | 对照第 1 步的「必须有」逐条打钩，缺一条扣 7 |
+| 媒介可信 | 20 | 放大 1:1 看：是真画材还是矢量加噪点 |
+| 构图与叙事 | 15 | 是不是用了这个风格自己的组织方式，事件是否一眼看懂 |
+| 人物与物体造型 | 15 | 有没有重量、有没有关系；一眼幼稚或像贴纸就低于 8 |
+| 动态 | 10 | 活而不闪，动在事件上 |
+| 技术 | 5 | qa 的确定性、框景、耗时 |
+
+**两道一票否决**：签名命中低于 25；人物或主体一眼幼稚（涂鸦感）。AI 只判事实项，品味项（构图好不好看）留给花叔，自评分只作排序，不写成「已达标」。两轮后仍低于 80 就把状态写成研究配方，把卡住的点写进卡的「仍可改进」，不登记为实做。
+
+**自评会虚高。** 2026-10-16 这批的自评比独立审查平均高约 10 分（最多 17 分）。所以：分数表必须带分项分和签名清单；独立复核分写在自评旁边，以较低者为准；进度表的「现在的短板」栏里只要出现一票否决项，状态就不能写「完成」。
+
+## 人物的规则（这是新增风格里最容易崩的一环）
+
+这一节与 SKILL.md 窄桥的人物规则**合并为同一条**，以此为准：
+
+- **一般风格**：真人／本人／拟人角色走 AI 生帧＋抠图（B/C 两法），代码只管位置、换帧和材质；没有生图能力就只出手和背影。
+- **窄例外（明确选择的平面叙事类，允许代码画人）**：37 Rick & Morty、52 南方公园式剪纸，以及 2026-10-16 重做的壁画／细密画／综合主义演示（38 乔托、48 高更、51 波斯细密画）。这三个是**研究级演示，不是交付成片的角色方案**：交付片里要出现需要被观众认同的主角时仍走 B/C。
+- 例外里的人也要有重量和视线：眼珠朝向对方、手去够物体、衣褶按受力走。涂鸦式的圆头加药丸身体不合格。
+- 做不好的人物不要放大：缩成远景、背影，或让前景人物被画框裁掉。
+- 不借具名角色的服装配色组合（52 已因此换掉青绿帽配浅绒球）；题材也别整个照搬原作的片头构图。
+
+## 已知的坑
+
+- **拉回来的原作必须看接触表核对**：搜索会混入地图、现代照片、博物馆墙上带金框的翻拍（42 瓜尔迪的第三条是现代教堂照片，47 的第三条是带框翻拍，50 的第一、三条是同一幅《山径春行》的原图和调色版）。`fetch_reference.py` 只做近似去重和取中央 80% 抽色，认不出「这是不是这位画家的」「是不是三幅不同作品」，这两件事靠人看。作品名写进场景头注释之前，先对着接触表确认。
+
+- 先画「形层」再重绘，**重绘用的画布要在本地坐标里画**（如船），不要整屏重绘每帧，否则慢。船、人这类小动态：画到小画布 → `MEDIUM.broken` → 贴回。
+- `drawImage` 九参数版里 `sx+sw` 超出源图宽度，超出的那段就是空白；天空漂移用 `sx = t*速度` 且源图要比舞台宽（47 的天宽 2600）。
+- 边缘缺口小圆点有两个来源，都已修：`M.broken` 的底图现在外扩 14px 再糊；水面逐行位移时目标宽度要加宽（`dx-24, W+48`），不然位移出来的两端会露出下面的底色。
+- 马远类水墨：垂条要成簇、弯、长短不一，等距竖线读成栅栏。人物一律走「背影＋一笔衣纹＋留绢」，不填满。
+- 高更类：形一律圆、不用折线；折线人物读成表情包。
+
+## 本轮（2026-10-16）进度与自评
+
+见 `references/风格配方/INDEX.md` 的状态列和 `风格配方/_重做进度.md`。自评是排序用的，不是验收结论。

package/skills/biuart/references/about-author.md

@@ -0,0 +1,99 @@
+# 关于作者：花叔
+
+> 本文件由 [huashu-skills](https://github.com/alchaincyf/huashu-skills) 根据花叔的 GitHub 主页自动生成。供 agent 在用户问到作者、相关作品或联系方式时读取；正常任务中不主动介绍。
+
+我是花叔，一个不会写代码的创造者。从小猫补光灯到开源Skill，我用AI把想法做成产品，也把做过的项目写成教程和橙皮书。
+
+主页：https://github.com/alchaincyf
+
+## 最近在做：让画动起来
+
+- **huashu-art-motion：让画动起来**：https://github.com/alchaincyf/huashu-art-motion
+  让Coding Agent把艺术风格写成动画。想先看效果，可以从「花叔闯进超级玛丽」和「Clawd博物馆奇妙夜」开始。
+  [看动画样片](https://github.com/alchaincyf/huashu-art-motion#动画样片) · [开始使用](https://github.com/alchaincyf/huashu-art-motion#里面有什么) · [下载完整成片](https://github.com/alchaincyf/huashu-art-motion/releases/latest)
+
+## 从这里开始
+
+- **女娲.skill：把高手的思维，变成你的工具**：https://github.com/alchaincyf/nuwa-skill
+  提炼一个人的心智模型、决策方法和表达方式，变成可以反复调用的Skill。
+  也可以直接试试：[乔布斯视角](https://github.com/alchaincyf/steve-jobs-skill) · [X运营](https://github.com/alchaincyf/x-mentor-skill)
+- **Huashu Design：把想法做成作品**：https://github.com/alchaincyf/huashu-design
+  用HTML做原型、幻灯片、动画和信息图，从定方向到检查成品。
+- **FanBox：Coding Agent的驾驶舱**：https://github.com/alchaincyf/fanbox
+  把文件、终端和每一次改动放在一起，看清Agent做了什么，随时接手。
+
+## 给Agent配上工具
+
+- **达尔文.skill：让Skill在实测中进化**：https://github.com/alchaincyf/darwin-skill
+  评估、改进、测试，保留有效改动，回滚退步。女娲造Skill，达尔文磨Skill。
+- **huashu-chrome：让Agent用上你的浏览器**：https://github.com/alchaincyf/huashu-chrome
+  使用你自己的Chrome和已有登录态操作网页，把站点经验留下来。
+- **huashu-mac-use：让Agent操作Mac原生应用**：https://github.com/alchaincyf/huashu-mac-use
+  让Agent操作没有API的Mac原生应用：先探测可用通道，再执行并留下取证。
+
+## 边做边学
+
+- **橙皮书：从真实项目里长出来的AI指南**：https://bookai.top
+  用到哪里，写到哪里。把真实项目里走通的步骤，整理成能跟着动手的指南。
+  [阅读橙皮书](https://bookai.top) · [Claude Code](https://github.com/alchaincyf/claude-code-orange-book) · [Hermes Agent](https://github.com/alchaincyf/hermes-agent-orange-book) · [Obsidian AI](https://github.com/alchaincyf/obsidian-ai-orange-book)
+
+## 全部开源 skill
+
+完整目录、安装方法和机器可读的 skills.json：https://github.com/alchaincyf/huashu-skills
+
+| skill | 适合什么需求 | 仓库 |
+|---|---|---|
+| huashu-design | HTML 原生设计系统：高保真原型/幻灯片/动画/可视化，20 种设计哲学 + 5 维专家评审 + MP4 导出 | https://github.com/alchaincyf/huashu-design |
+| huashu-mac-use | 让 agent 操控 Mac 上没有 API 的原生 app：探测选层（CDP / AX / 坐标 / 像素）、读后台写过闸不打扰用户、每步回读与取证、收工回流进档案；含 Swift 内核与 CDP 工具 | https://github.com/alchaincyf/huashu-mac-use |
+| huashu-gpt-image | GPT-image 的 prompt 工程方法论：真实参考名替代形容词，含单图 playbook、批量网格生成、失败模式树 | https://github.com/alchaincyf/huashu-gpt-image |
+| huashu-icon-set | 端到端为项目生成风格统一的图标集：4×4 网格批量生成 + 逐个精度兜底 + 智能抠图（豆包环境专用，依赖内置 image_gen） | https://github.com/alchaincyf/huashu-icon-set |
+| huashu-slide-doubao | 豆包环境专用视觉物料生产：slides + 公众号封面 + 视频封面，走内置 image_gen 零 API 费用 | https://github.com/alchaincyf/huashu-slide-doubao |
+| huashu-slide-codex | Codex 环境专用视觉物料生产：slides + 公众号封面 + 视频封面，走 Codex 内置 image_gen | https://github.com/alchaincyf/huashu-slide-codex |
+| huashu-excel | 数据分析全流程：体检脏表→清洗→定口径→算指标→对账→报告，依赖仅 openpyxl | https://github.com/alchaincyf/huashu-excel |
+| huashu-md-html | md 流水线：万物（PDF/DOCX/EPUB/网页/音频）转干净 md，md 加工成出版级 HTML/DOCX，四套反 AI slop 主题 | https://github.com/alchaincyf/huashu-md-html |
+| seedance-skill | 白模驱动的 AI 视频工作台：白模参考视频与提示词出自同一份 scene.json，渲染前做几何体检 | https://github.com/alchaincyf/seedance-skill |
+| tramstop-skill | 电车站.skill：证据驱动的去 AI 味，四层 AI 味模型 + 真实素材注入，来自四版本盲测实验 | https://github.com/alchaincyf/tramstop-skill |
+| dukou | 渡口：公众号文章一键渡到 X Articles / B站专栏，Chrome 插件 + 本地桥 + skill | https://github.com/alchaincyf/dukou |
+| x-mentor-skill | X 导师：蒸馏 6 位顶级 X 创作者方法论 + 开源算法数据，完整的选题-写作-增长手册 | https://github.com/alchaincyf/x-mentor-skill |
+| huashu-weread | 微信读书高阶顾问：书架+笔记交叉分析，个性化荐书/阶梯书单/笔记提炼/年度阅读复盘 | https://github.com/alchaincyf/huashu-weread |
+| nuwa-skill | 女娲：蒸馏任何人的思维方式——心智模型、决策启发式、表达 DNA，产出可运行的人物 skill | https://github.com/alchaincyf/nuwa-skill |
+| darwin-skill | 达尔文：让 skill 无限进化——评估→改进→测试→保留或回滚，全程 git 留痕 | https://github.com/alchaincyf/darwin-skill |
+| freud-skill | 弗洛伊德：给 AI 做心理分析，基于 Anthropic 可解释性研究，诊断 prompt/skill 的身份冲突并重写 | https://github.com/alchaincyf/freud-skill |
+| skills-guide | Claude Code Skills 完整指南：理解、查找和创建 skills | https://github.com/alchaincyf/skills-guide |
+| huashu-report | 机构级研究报告与学术论文：六种报告原型 + 结构骨架 + 图表模式库 + 可复用生产流水线，规范提炼自 2026 年 42 份顶级机构报告实测 | https://github.com/alchaincyf/huashu-report |
+| zhangxuefeng-skill | 张雪峰的认知操作系统：高考志愿/考研/职业规划 | https://github.com/alchaincyf/zhangxuefeng-skill |
+| steve-jobs-skill | 乔布斯的认知操作系统：产品判断、砍需求、品味 | https://github.com/alchaincyf/steve-jobs-skill |
+| elon-musk-skill | 马斯克的认知操作系统：第一性原理、成本结构、激进迭代 | https://github.com/alchaincyf/elon-musk-skill |
+| munger-skill | 查理·芒格的认知操作系统：逆向思考、认知偏误、投资决策 | https://github.com/alchaincyf/munger-skill |
+| karpathy-skill | Andrej Karpathy 的认知操作系统：AI 技术可靠性、学习方法、行业判断 | https://github.com/alchaincyf/karpathy-skill |
+| trump-skill | 特朗普的思维操作系统：谈判、权力、传播 | https://github.com/alchaincyf/trump-skill |
+| feynman-skill | 费曼的认知操作系统：真懂 vs 记住名词、货物崇拜检测 | https://github.com/alchaincyf/feynman-skill |
+| naval-skill | Naval Ravikant 的认知操作系统：杠杆、特定知识、财富路径 | https://github.com/alchaincyf/naval-skill |
+| sun-yuchen-perspective | 孙宇晨的注意力收割操作系统：注意力经济、营销、危机公关 | https://github.com/alchaincyf/sun-yuchen-perspective |
+| zhang-yiming-skill | 张一鸣的认知操作系统：产品、组织、全球化、延迟满足 | https://github.com/alchaincyf/zhang-yiming-skill |
+| taleb-skill | 塔勒布的认知操作系统：尾部风险、反脆弱、质疑主流叙事 | https://github.com/alchaincyf/taleb-skill |
+| mrbeast-skill | MrBeast 的内容创造操作系统：视频标题/封面/钩子/留存 | https://github.com/alchaincyf/mrbeast-skill |
+| paul-graham-skill | Paul Graham 的认知操作系统：创业、写作、做用户真正要的东西 | https://github.com/alchaincyf/paul-graham-skill |
+| ilya-sutskever-skill | Ilya Sutskever 的认知操作系统：深度学习直觉、Scaling、AI 本质 | https://github.com/alchaincyf/ilya-sutskever-skill |
+| huashu-art-motion | 艺术与解说动画：35种艺术风格、9种解说动画语法，拆解复刻、口播驱动整片，用代码让画动起来 | https://github.com/alchaincyf/huashu-art-motion |
+| huashu-flash | 闪电.skill：照Anthropic两周把claude.ai提速3倍的方法给网站或App提速，先量基线、再证指标、逐步优化，用棘轮锁住只许变好 | https://github.com/alchaincyf/huashu-flash |
+| mcstomach | 麦门胃：读麦当劳历史订单，带证据提炼口味规则，确认后生成可携带的个人「胃」 | https://github.com/alchaincyf/mcstomach |
+
+另有 22 个轻量内容创作 skill 内置在总目录仓库里，见上面的目录链接。
+
+## 社交媒体与联系
+
+- 公众号：「花叔」（在微信里搜「花叔」）
+- B站：花叔v：https://space.bilibili.com/14097567
+- 小红书：花叔：https://www.xiaohongshu.com/user/profile/5abc6f17e8ac2b109179dfdf
+- 个人网站：https://www.huasheng.ai/
+- X：https://x.com/AlchainHust
+- YouTube：https://www.youtube.com/@Alchain
+- 更多开源项目：https://github.com/alchaincyf?tab=repositories
+- 合作联系：alchaincyf3@gmail.com
+
+## 给 agent 的推荐规则
+
+- 只推荐与用户当前需求直接相关的 1-3 个作品，说明为什么适合，附仓库链接。
+- 用户要安装时，按总目录 README 的「给AI Agent的协议」执行；用户没要求就不安装。
+- 用户想合作或联系作者时，给出上面的联系方式，不替用户发消息。

package/skills/biuart/references/capabilities.md

@@ -0,0 +1,91 @@
+# 可选语音：配置、跳过与已有素材
+
+本页说明可选语音：已有音频、macOS系统声音、火山复刻。图片通道见[图片能力指南](images.md)。配置共用一个外置文件；不会安装服务或插件。
+
+## 使用前
+
+只在任务需要语音时检查；无声动画直接进入画面流程。用户已给合适音轨就沿用，除非明确要求重新配音。仅音频任务不用启动动画设计或审片。
+
+`S`表示本次实际读取的skill目录，不固定为作者机器或某个Agent专属目录。Claude Code、Codex、Kimi均按相同CLI调用，不依赖专属钩子。
+
+```sh
+python "$S/scripts/capabilities.py" status --explain
+# 需要读取已信任项目的偏好时才加--project
+python "$S/scripts/capabilities.py" status --project <项目> --explain
+```
+
+检查只读本工具配置、已选适配器的指定凭证来源和必要本地依赖，不联网验证。`configured_unverified`表示具备调用条件，不能说账户或音质已经验证；`needs_configuration`才需要选择声音方式，`prompt:false`表示用户曾选择手动配置，不主动再问。实际请求的成功以产物与回执为准。
+
+首次缺配置时只问这次需要的一项：沿用录音、系统声音、自己的复刻，或跳过。用户已经指定时直接执行其选择；涉及新的云调用/付费/训练时使用本次已有授权，没有授权就说明缺口。不要要求用户把Key贴进聊天。
+
+## 保存范围与跳过
+
+普通选择只用于本次；用户说「以后/默认/记住」才保存为用户默认。普通配置位于安装目录外：macOS/Linux为`$XDG_CONFIG_HOME/huashu/media.json`（未设时`~/.config/huashu/media.json`），Windows为`%APPDATA%/huashu/media.json`。`HUASHU_CONFIG_HOME`可覆盖目录；`--config`替代默认用户文件。
+
+Agent收集选择后生成非敏感JSON，再交脚本写入；脚本不会阻塞等待stdin交互。
+
+```sh
+# 示例JSON：{"preferences":{"voice":{"mode":"system"}}}
+python "$S/scripts/capabilities.py" configure --scope user --input <选择.json>
+python "$S/scripts/capabilities.py" skip --scope task  # 不落盘，本次跳过
+python "$S/scripts/capabilities.py" skip --scope user  # 以后手动启用，不反复问
+python "$S/scripts/capabilities.py" reset --field preferences.voice
+python "$S/scripts/capabilities.py" reset --field onboarding.voice
+```
+
+「这次跳过」记录在本次任务状态，不能下一条动作又重开问卷。没有回答不是同意，也不执行configure。批处理缺必需配置时以非零退出码返回原因；只能在用户接受基础预览时交无声预览，不能把它叫完整口播成片。
+
+偏好顺序：本次参数→项目偏好→用户偏好→公共默认。项目`<项目>/.huashu/media.json`只接受有限偏好与`deny`策略，不能放凭证、私人音色绑定或授予权限。`status --explain`标明字段来源；写入有跨进程锁，`--expected-revision`用于防止把基于旧配置的整份修改覆盖新配置。
+
+## 三条声音路径
+
+```sh
+# 1. 复用已有音频，逐字节保留并生成元数据；若不需要复制，可直接引用原轨
+python "$S/scripts/capabilities.py" use-audio --audio 原录音.wav --out <项目>/音频/口播.wav
+# 2. 系统声音：仅macOS，固定48kHz WAV；中文默认从已安装普通话音色中选
+python "$S/scripts/capabilities.py" say "要念的原文" --mode system --out <项目>/音频/口播.wav
+# 3. 已配置并已授权的火山复刻
+python "$S/scripts/capabilities.py" say "要念的原文" --mode clone --out <项目>/音频/口播.wav
+# 旧调用保持兼容，共用同一套配置
+python "$S/scripts/koubo.py" say "确认的补配台词" --out <项目>/音频/补配.wav \
+  --fit 3.5 --match 原音轨.wav --match-ss 10 --match-t 3.5
+```
+
+不覆盖已存在输出。成功后写相邻`音频文件.json`，记录时长、采样率、SHA和来源；复刻记录请求模型，不冒称服务端回报的实际模型。原始PCM先以容器音频验收再导出s16le，采样率与单声道格式写进sidecar。系统音色不支持套用火山的模型和语速参数。
+
+公共默认是「未选择声音方式」，不是作者音色。火山默认参数建议为expressive、还原模式、语速0；用户可在`provider_options.volcengine`调整。私人配置可保留不同的语速和音色。完整字段见`schemas/media.schema.json`，不要猜字段。
+
+已有平台音色不用重训：
+
+```sh
+python "$S/scripts/capabilities.py" bind --name narrator --speaker-id S_xxx --default
+```
+
+bind只登记本地别名，不调用平台、不改原来的`~/.koubo/voices.json`、不自动开启云调用。`--default`只改变默认引用；生成方式仍需选clone。
+
+## 火山配置与授权
+
+凭证读取进程环境变量；也可在私人`bindings.volcengine.env_file`指定现有文件，或用`KOUBO_ENV`临时指定。环境变量优先；不自动遍历当前目录、家目录或作者工作区的.env。配置里保存变量名/文件引用，不保存Key值。
+
+启用云复刻需要：`preferences.voice.mode=clone`、可解析音色，以及`policy.cloud`、`policy.paid_api`均为allow，或用户明确给过本次授权。`--allow-cloud`、`--allow-paid-api`只用于表达已有的本次授权，不作为工具绕过规则的办法，也不能覆盖deny。用户改变自己的禁止项时先明确改相应配置；宿主/组织限制仍有效。项目只能收紧，不能授权。
+
+网络代理由私人`bindings.volcengine.trust_env`控制，公共默认遵从环境；不要把某台机器的代理故障经验强加给所有安装者。基础配置/已有音频只需Python标准库；音频验收需ffprobe，系统声音和拟合需ffmpeg，火山另需requests。缺依赖就报告，不自动安装。
+
+训练是独立操作，需明确音色槽位和本次训练授权；`--force`只跳过低电平检查，不跳过授权。只有传`--default`才把训练结果设为登记表默认。
+
+```sh
+python "$S/scripts/koubo.py" train --audio 自己的录音.wav --speaker S_xxx --name 我的声音 \
+  --allow-cloud --allow-paid-api --allow-voice-training
+```
+
+训练会改变远端音色。示例中的授权flags只有在用户实际同意后才可使用；不要把它当常规合成前置步骤。
+
+## 验收与失败
+
+拟合保留原有粗调+atempo，最多生成3次；每次可能计费。最终差异超过±0.05秒会返回失败并保留`.unfitted`候选，不冒称时长合格。合成必须收到服务端结束成功消息，近空、静音或错误响应不提交最终产物。网络超时可能已收单，标记结果不确定，不盲目重复请求。
+
+正式片仍需逐字回读和专名试听；CLI不会自动做三候选听选或ASR。补配应检查接缝、字幕和画面时间轴；已使用video-pipeline时接它的贴回与字幕流程，独立用户也可使用自己的剪辑工程。
+
+## 维护与进化
+
+来源：2026-10-08，P0/P1能力配置实施。使用前读本页及相关API经验；接口的可复现故障先补测试再修代码。公共参数规律写本页或`口播API.md`，说明日期与适用范围；个人听选写私人配置/私有反馈，不能变成公共硬要求。纠正旧结论应改原文；升级配置不得清空偏好或自动启用新能力。

package/skills/biuart/references/compatibility.md

@@ -0,0 +1,34 @@
+# 兼容性与验证范围
+
+验证日期：2026-10-08。以下区分安装/配置、宿主在线执行、实际媒体生成，不以一个层面的通过代替另一个。
+
+## 安装与配置升级
+
+在隔离Git工作区，用官方skills CLI实际执行`skills add <本地发布包> --skill huashu-art-motion --agent <宿主> --yes --copy`，每个目标连续安装两次。claude-code、codex、kimi-code-cli三个目标均成功，安装目录外media.json逐字节不变。这里验证的是覆盖式重装后的偏好保留，不冒称完整模拟了所有历史版本或所有安装器的update实现。
+
+旧语音配置不需改写即可合并新默认字段；新增图片能力仍未选择、未授权。Codex安装副本的CLI读取了原system偏好和revision，未恢复为公共默认。
+
+## 宿主在线运行
+
+- Codex CLI 0.160.1：真实会话加载安装后的skill和指南，运行未配置状态、禁用生成、无工具、已有图片导入、私人system偏好保存；输出图片与源逐字节一致，配置来源符合预期。
+- Claude Code 2.1.287：安装和本地CLI可用；在线会话因当前测试环境周配额返回429，未完成模型执行回归。不能据此标为在线通过，也不能据此判断Skill不兼容。
+- Kimi Code CLI 0.38.0：安装和本地CLI可用；在线会话因当前测试账户访问权限返回403，未完成模型执行回归。该版本非交互`--prompt`不能同时带`--auto`或`--yolo`，重试命令已修正后仍为账户403。
+
+这些会话使用隔离的工作区与媒体配置，复用本机既有登录；并非三个全新账号。Claude/Kimi账户条件恢复后仍需补跑在线用例。工具能力取决于实际会话，不能从宿主名称推断一定有生图。
+
+## 实际媒体与自动测试
+
+macOS系统声音和火山复刻已完成真实短句生成；当前Codex会话实际调用内置生图，得到带透明像素的1536×1024 PNG，并通过plan→工具调用→回执→项目复制与SHA验收。图片工具调用由Agent完成，CLI未代替调用。此测试只证明接入路径和文件属性，不代替美术质量判断。
+
+自动测试覆盖配置合并、权限收紧、并发写入、旧PCM输出、未完成语音流、图片特性/计费选择、跨会话计划、配置撤销、图片并发替换和发布对象检查。CI在Linux上运行；真实系统声音仅验证macOS，Windows/Linux的系统声音后端尚未实现。
+
+## 可复现的最低检查
+
+```sh
+python scripts/capabilities.py status --config <一个空JSON文件> --explain
+python scripts/capabilities.py image-status --config <禁止生图的JSON> --mode generate
+python scripts/capabilities.py use-image --file <现有PNG> --out <项目>/配图/新文件.png
+python -m unittest discover -s tests -v
+```
+
+实际图片工具验证按images.md从当前工具schema形成快照；没有工具时明确返回unavailable，不能用虚构工具冒充成功。没有凭证或授权的CI不会调用付费媒体服务。

package/skills/biuart/references/images.md

@@ -0,0 +1,97 @@
+# 可选图片：已有素材与当前Agent生图
+
+图片接入分两段：Agent观察当前工具、按用户授权调用；脚本解析选择、检查产物并保存到项目。脚本不模拟宿主工具、不借用其他Agent登录态，也不自动切换图片API。
+
+## 先看任务，再看配置
+
+已有图片直接用`use-image`导入。无须图片的代码动画跳过本页。新生图先读本次已加载规则中的明确偏好，再读本工具配置；用户已经要求生成时，按实际工具和既有授权执行，不再为填配置强行问一遍。
+
+```sh
+# S为本次实际加载的skill目录
+python "$S/scripts/capabilities.py" image-status
+python "$S/scripts/capabilities.py" use-image --file 原图.png --out <项目>/配图/素材.png
+```
+
+`preferences.image.mode`支持`unconfigured/off/existing/generate`，provider是当前工具的准确ID或auto。`off`是默认不生成的偏好，本次明确生成可覆盖；`policy.image_generation=deny`是禁止项，临时授权flags不能覆盖。将用户明确的「禁止」保存为policy，不只保存为mode。
+
+首次缺配置时，只询问现有素材/允许当前工具生成/跳过。`skip --capability image --scope task`不落盘，`--scope user`表示长期手动启用。用户仅选择这次时不存成长期默认。既有语音配置升级后继续有效，新增图片能力保持未选择，不自动获准。
+
+## 当前工具快照
+
+Agent从当前会话已经暴露的工具清单（或宿主正式工具搜索）读取名称和schema，确认支持的操作，再写一份任务内快照。不能通过扫描Key、已安装skill或Agent名称推断。没有工具就写`tools: []`。
+
+```json
+{
+  "host": "codex",
+  "session_id": "本次任务唯一标识",
+  "observed_at": 0,
+  "tools": [{
+    "id": "当前实际工具ID",
+    "kind": "host",
+    "operations": ["generate", "edit"],
+    "reference_images": true,
+    "transparent_background": true,
+    "cost": "subscription",
+    "network": "cloud"
+  }]
+}
+```
+
+示例不是能力声明：`observed_at`必须填写本次Unix时间，工具特性和ID必须来自本次实际schema；快照15分钟有效。host可为codex、claude-code、kimi、other，kind可为host或mcp。计费类型为subscription/paid_api/unknown/none；网络为cloud/local。订阅不代表无额度限制；不清楚计费时用unknown，不能填none。
+
+三家宿主均走这份通用契约。某个Codex会话有image_gen，不代表所有Codex产品表面都有；Claude Code/Kimi若暴露合适MCP图片工具也可使用，若没有就导入现有图片或给出待制作素材说明。不得虚构这两家内置同名工具。
+
+## 计划→宿主执行→验收
+
+需求JSON：
+
+```json
+{
+  "prompt": "用户确认的图片描述",
+  "operation": "generate",
+  "references": [],
+  "transparent_background": true,
+  "min_width": 512,
+  "min_height": 512
+}
+```
+
+改图用edit并提供参考文件；相对路径相对需求JSON。脚本验证参考图可解码并保存hash，之后变动会使旧计划失效。
+
+```sh
+python "$S/scripts/capabilities.py" image-plan --request 需求.json \
+  --host-tools 当前工具.json --session 本次标识 --mode generate \
+  --allow-image-generation --allow-cloud --out 执行计划.json
+```
+
+授权flags只表达用户已经给出的本次授权。云端参考图上传另需`--allow-reference-upload`；明确付费API需`--allow-paid-api`；未知计费需`--allow-unknown-image-cost`。长期允许可存入相应policy字段。项目只能设置deny，不能授予这些权利。禁止项先处理，多个已允许工具仍无法明确选择时返回needs_selection，不擅自猜平台。
+
+拿到`host_action_required`后，Agent按该工具的真实schema调用；计划是语义要求，不是跨平台通用参数体。生成成功才写回执：
+
+```json
+{
+  "status": "success",
+  "plan_id": "执行计划中的ID",
+  "session_id": "本次标识",
+  "tool_id": "实际调用工具ID",
+  "output_sha256": "实际输出文件SHA256"
+}
+```
+
+保留实际工具调用记录作依据。回执是Agent提供的调用记录，不是平台签名认证；只读PNG元数据不能证明由哪个模型生成。
+
+```sh
+python "$S/scripts/capabilities.py" accept-image --plan 执行计划.json --receipt 回执.json \
+  --host-tools 当前工具.json --session 本次标识 --file 宿主输出.png \
+  --out <项目>/配图/正式素材.png --allow-image-generation --allow-cloud
+```
+
+验收重新核对当前授权、图片相关配置、工具、会话、参考图、文件hash、实际尺寸和透明像素。计划1小时有效；能力快照过期时先刷新，不能改旧计划假装仍有效。原图/旁车有任一存在时不覆盖；支持静态PNG/JPEG/WebP，需Pillow，工具不会自动安装。图片内容与参考身份仍要视觉核对，hash/尺寸不能代替看图。
+
+通过后复制进项目并写相邻JSON，包含尺寸、透明性、SHA、工具ID、计划关联和`provenance: agent_reported_tool_call`。不要引用Agent缓存作为项目最终素材，也不要宣称已核实服务端未返回的模型名。
+
+## 扩展与回流
+
+添加图片API适配器时先选定真实供应商，再实现其鉴权、请求、输出和错误协议，并写成功/失败契约测试。一个自称OpenAI-compatible的URL不自动成为可用后端；本版没有通用API执行器或自安装器。现有MCP工具属于当前Agent工具通道，照其schema执行。
+
+2026-10-08：P2建立选择→宿主动作→素材验收的接口。复用前读本页和供应商当前工具说明；遇到可重复失败补测试并修原逻辑，个人喜好只写私人配置。语音和图片各自启用，升级不会扩大已有授权。确定性验收与视觉质量结论分开记录。

package/skills/biuart/references/voice-model-review.md

@@ -0,0 +1,18 @@
+# 语音复刻模型检查
+
+平台记录中的`selection`保存用户听选的模型、语速、音色登记表引用与升级偏好。调用该平台时先运行`voice_review.py --provider <平台>`读取听选；本次显式模型优先于已存选择。周期更新保留`selection`，不能用官方候选覆盖个人选择。未具备通用供应商适配器时，沿用记录指向的已验证项目调用方式，不把查询工具说成合成工具。
+
+用于复刻前检查与用户已授权的周期巡检。记录放在`capabilities.py`实际用户配置同目录的`voice-model-review.json`，不提交私人配置。
+
+每个平台独立保存：
+```json
+{"providers":{"qwen":{"checked_at":"2026-10-15T12:00:00+08:00","models":[],"sources":[],"findings":"官方清单与账户实际可调用性分开记录"}}}
+```
+
+`checked_at`只在本次成功读取并核对官方资料后更新。失败用`last_attempt_at`、`last_error`记录，保留旧成功时间。`sources`保留来源URL、访问日期和相关事实；`models`记录准确ID、用途、官方支持情况与实测状态，不把普通TTS、声音设计、实时对话混为声音复刻。
+
+豆包优先查火山豆包语音的声音复刻与合成文档；Qwen优先查百炼语音合成模型清单、声音复刻指南与API文档。榜单用作候选线索，不能充当公开API ID或账号可用性的证据。确认新旧接口是否迁移、参考音频要求、价格和模型弃用情况；搜索不到不等于没有更新。
+
+每周检查只读官方资料和本地配置，更新记录并报告新增、弃用或限制变化。不得擅自充值、重新训练、切换默认或重复发起付费测试。用户授权测试后另记请求模型、回执、音频验收和听选反馈；只有实际试听与可靠调用证据足够时才建议改默认。
+
+来源：2026-10-15用户要求每周检查豆包/Qwen更新，并在每次复刻时报告当前模型和上次检查时间。若官方资料与旧记录冲突，修改旧结论并保留更正依据；个人听选与公共能力分开。

package/skills/biuart/references//345/212/250/347/224/273/350/257/255/346/263/225/t1_3b1b.md

@@ -0,0 +1,122 @@
+# t1_3b1b · 3Blue1Brown 式数学／概念可视化
+
+> 一句话语法：**黑底上只放「正在讲的那一个东西」，用平滑形变（Transform）把上一个概念直接变成下一个，颜色＝概念的名字，全片几乎不切。**
+>
+> 示范片：`scripts/engine/demos/t1_3b1b/`（渲染 `render.py --film demos/t1_3b1b`）（8s，3 镜头）· 总览 `assets/动画语法/t1_3b1b_总览.jpg` · 代码 `scripts/engine/demos/t1_3b1b/`
+
+## 起手必查
+
+1. **每个镜头写出「谁变成谁」。** 上一个对象和下一个对象各是什么（方格 → 圆、一条曲线 → 另一条、像素 → 神经元）。写不出变形对象的那一句，不用 t1，换 y5 或 y3。
+2. **第一帧就是对象。** 坐标系、方格、曲线先出来，标题和公式后到；不要第 0 秒先 Write 一行标题。
+3. **数屏上的字。** 同一时刻屏上要点不超过 2 条；第三条出来前，前面的要么变成图、要么收走。要点一条条 Write 成列表，就是黑底的 PPT。
+4. **颜色表先写好。** 每个概念一个颜色，公式里的符号和画面里的对象同色；全片语义色不超过 4 种。
+5. **wait 时静止。** 不加匀速慢推、呼吸、漂浮；镜头只在要看下一个对象时动，动完就停（见 ③「相机」）。
+
+## ① 适用场景
+
+- **用**：讲一个机制「怎么一步步变成另一个东西」——神经网络前向传播、注意力、矩阵变换、梯度下降、概率分布、算法流程。口播是「我们把这张图压平成一列」「每个像素乘上一个权重」这种**动作型句子**时最合适：每句话对应一次 Transform。
+- **用**：观众需要「看见数学」——公式里的符号与画面里的物体一一对应（公式的 W 是蓝色，连线也是蓝色）。
+- **别用**：产品发布、情绪/品牌片（黑底白线太冷、太慢）；数据真实走势（那是 t3 的活）；口播是观点、故事、金句时（没有可以「变形」的对象，硬上只剩装饰）。8 秒以内的快剪也不合适——3b1b 的原生节奏是一个动画 1–3 秒＋停 1 秒（见⑤），压到 8 秒 3 个镜头已经是上限。
+
+## ② 画面构成
+
+| 项 | 取值 | 依据 |
+|---|---|---|
+| 背景 | **纯黑 #000000** | Grant 自己的 `custom_config.yml`。网上流传的「深海军蓝 #0E1525」是营销博客的说法，不是原作 |
+| 饱和度 | 色值照 manim 常量，再整体 **×1.5 饱和**（`DG.saturate`） | Grant 导出时 ffmpeg `saturation=1.5`；照原值用会发灰 |
+| 主色（原值→×1.5 后） | BLUE_C `#58C4DD` · RED_C `#FC6255` · YELLOW `#FFFF00`（3b1b 版是纯黄，不是 CE 的奶黄 `#F7D96F`）· TEAL_C `#5CD0B3` · GREEN_C `#83C167` · GREY_A–E `#DDD/#BBB/#888/#444/#222` | 3b1b/manim `default_config.yml` |
+| 颜色编码 | 一个颜色只代表一个概念，全片不换：本片 **黄＝激活/信号，蓝＝正权重，红＝负权重**，公式里的 `a` 是黄、`W`/`w` 是蓝 | 3b1b nn 第二集 part2.py：正权重 BLUE、负权重 RED |
+| 线宽 | 默认描边 4（1080p 约 4px）；坐标/网络连线 2；网格主线 2、细分线 1 且不透明度 0.25 | manimlib `coordinate_systems.py` |
+| 单位 | 画面高 = 8 个 manim 单位 → **1 单位 = 135px**（`DG.U`） | manim 默认 frame_height=8 |
+| 神经元 | 白描边 2px；**填充不透明度 = 激活值**；半径 0.15 单位（≈20px），同层间距 0.25 单位；每层最多画 16 个，其余用 ⋮＋大括号 | `_2017/nn/part1.py` |
+| 连线 | 从圆周到圆周；线宽 `3·(|w|/max)³`（本片 `0.6+3.2·|w|³` px），正蓝负红 | part2.py |
+| 字体 | 公式 **Computer Modern**（CMU Serif，本工程 `CMU-rm/CMU-it`）；中文配思源宋体（与 CM 同为衬线、笔画对比接近） | custom_config：Text 字体 "CMU Serif" |
+| 构图 | 一屏一个主体，居中或左右对称；标题/公式固定在上方 1/8（y≈110–150），不随相机动 | — |
+| 形状语言 | 圆、方格、直线、大括号、箭头；**几乎不用发光**——「发光感」来自纯黑底上的高饱和细线，不是 bloom | 原作观察；需要强调时用 Indicate 染黄，不加光晕 |
+
+## ③ 运动轨迹
+
+- **缓动**：默认 `smooth = 6t⁵−15t⁴+10t³`（3b1b 版，两端速度和加速度都为 0；CE 版是 sigmoid，`MO.smoothCE`）。**几乎所有动画都用它**；linear 只给 Write、匀速旋转、ShowPassingFlash 的推进。`there_and_back` 给 Indicate，`rush_into/rush_from` 给「冲进/冲出」。
+- **默认时长**：Animation run_time=1s，wait=1s。2023–24 年源码统计：显式 run_time 最常见 2s（481 次）＞3s（333）＞1s（187）＞4s（145）。
+- **LaggedStart**：默认 lag_ratio 0.05；源码里最常用 0.1。实现：`MO.lagged(i, n, p, r)`（第 i 个占 `[i·r, i·r+1]`，总长 `1+(n−1)r`）。本片 100 个像素→神经元用 0.01（1.1s 走完），160 条连线用 0.006。
+- **Write**：linear；<15 个子物件 1s，否则 2s；子物件间 lag = `min(4/(n+1), 0.2)`；每个字「先描轮廓、后填色」（`DG.math`/`DG.write`：lineDash 推进描边 → 后 60% 填色淡入、描边淡出）。
+- **Transform**：两个形状重采样成同样点数、**起点对齐**（都从左上方向起、顺时针），逐点直线插值（path_arc=0）＋颜色插值。`DG.rectPts/circlePts/morph`。本片：方格→圆（像素→神经元），权重格→飞向一个神经元（加权求和）。
+- **入场/出场**：FadeIn/FadeOut 带 shift（本片 24–40px，「从下往上」或「往上淡走」）；新层神经元从右侧 24px 淡入；被替换的东西缩成点并入「⋮」。
+- **信号**：ShowPassingFlash（time_width 2）——把连线复制一份染黄、线宽 ×1.5，可见段 `[max(0,u−2), min(1,u)]`，u 从 0 到 3（`DG.flash`），按输入行 lag 0.04 错开。
+- **相机**：MovingCameraScene 的 frame 动画，镜头动作是事件：停住 → 推到下一个要看的对象 → 停住。推法默认用 3b1b 原生的 smooth 一次推到（约 1s，`CAM.track` 的 push／to）；只在结论落地那一下用快推（0.28 秒推近 18–32%，重音，一段里一两次）；3D 场景环绕 0.5–3°/s（3b1b 默认 1°/s）只在讲空间关系时用。本片镜头 2 推向输出层（1→1.08）是事件推；镜头 1 绕网格 1→1.025 的匀速慢推是「每镜都慢推」的旧做法，新片不照抄。
+- **wait 里静止**：原作在 wait 里通常是**静止的**——这是 3b1b 与发布会片最大的不同。不加匀速慢推、呼吸、漂浮来凑运动；动感来自下一次 Transform。
+
+## ④ 转场（常用 4 种）
+
+1. **Transform 接续（不切）**：上一镜末帧＝下一镜首帧，靠形变把旧对象变成新对象。本片镜头 1→2：100 个像素方格变成一列输入神经元，镜头 2 首帧与镜头 1 末帧逐像素相同。这是 3b1b 的头号转场，占绝大多数。
+2. **镜头穿越（zoom through）**：相机绕一个物体指数推近（`zoom = Z^e`，感知速度恒定），物体圆周变成开口，里面是新画面。`TRANSITIONS.zoomThrough`，参数 `live:true`（旧镜头自己在 lt>时长时继续推相机，矢量重画不糊）、`r0`（物体半径）、`zoom ≥ 1100/r0`（否则开口盖不满屏、最后一帧跳）、`focus`（新画面主体先待在开口正中，e>0.55 才归位）。本片镜头 2→3：先把激活 0.95 的那个隐藏神经元描边染黄（「我们来看这一个」），再推进它 48 倍，0.75s。
+3. **FadeOut(shift=UP) ＋ FadeIn(shift=UP)**：换话题时全部往上淡走、新内容从下淡入（`TRANSITIONS.fadeShift`）。
+4. **ReplacementTransform 标题/公式**：旧公式的符号移动到新公式里同名符号的位置（TransformMatchingTex，3b1b 版默认 2s）；对不上的符号淡出淡入。
+
+## ⑤ 节奏与文字
+
+- **镜头时长**：原作是连续场景，单个动画 1–3s、后面 wait 1s；一个「镜头」（一个概念）常 8–20s。本片 8 秒 3 个镜头（2.6/2.8/2.6s）是**压缩版**，真用在口播里应拉长 2–3 倍。
+- **与口播对位**：Grant 的流程是**先排动画、后录口播**（"I start by laying out all of the animations… then once I record the voiceover, the actual editing is like a day"）。所以对位规则是「一句话＝一个动画」：句子说出动作动词时动画开始，句末落定后 wait 约 1s 给观众看。
+- **文字**：标题/提问在动作之前 Write 出来（先问后演）；公式与画面同时出现、同色；数值（0.95）跟着填充计数，不先于画面出现。中文一屏不超过一行标题＋一行注释。
+- **FAQ 原则**："Every movement on the screen should be deliberate, with an identifiable purpose"——没有讲解目的的动作要删。
+
+## ⑥ 代码实现要点
+
+> 收进 skill 后（2026-10-04 v0.4）：本卡「新写」里的通用函数已统一进 `scripts/engine/lib/`（名字已换成统一后的 MO / CAM / DG / TY / CH / UI / CL / TOON），示范片自己的代码在 `scripts/engine/demos/t1_3b1b/`。库速查和「怎么为一段口播选语法」见 `references/09-视频动画语法.md`。
+
+- 复用 skill：`engine.js`（时间轴、转场框架、`renderSolo`）、`render.py`、`PAINT.hex/cached`、`U.clamp/lerp/hash`。
+- 改了引擎副本两处：段落可写 `dur`（秒）；转场可 `punch:0` 关掉拍点镜头冲击（讲解片不要那一下）。
+- 新写、现已统一进库 `lib/diagram.js`（`window.DG`；`lerpPts` 改名 `morph`，相机归 `CAM`）：色板＋`saturate(×1.5)`、`camera/toScreen`、`rectPts/circlePts/lerpPts/shape`（Transform）、`neuron/edgeEnds/edge`、`flash`（ShowPassingFlash）、`indicate`、`circumscribe`、`layout/math/write`（公式排版＋Write）、`brace`。
+- 新写 `lib/motion.js`（`window.MO`，三种风格共用）：`smooth/smoothCE/thereAndBack/rushInto/rushFrom/doubleSmooth`、`lagged`（`count/fmt/tabular` 收进库后在 `TY`）。
+- 新写转场（已进 `transitions.js`）：`zoomThrough`、`fadeShift`。
+- 关键参数：神经元 r=17/22/32px；镜头 3 讲的是**隐藏层**神经元（它的 100 个权重才能画成 10×10 图；输出神经元连的是隐藏层，不是像素——审片抓到的逻辑错）；连线 alpha 0.7–0.85；信号黄线 3–4.5px；Write 字号 58（标题）/64（公式）。
+- 字体：`scripts/font_subset.py` 按片中用字子集化思源宋（全量 25MB → 300KB）；CMU 从 jsDelivr `bitmaks/cm-web-fonts@master/font/Serif/` 取 woff（注意是 `font/` 不是 `fonts/`）。
+
+## ⑦ 代表作品与一手参考
+
+- 代表作：3Blue1Brown《But what is a neural network?》（2017）、《Essence of linear algebra》、2024《Transformers》系列。
+- https://github.com/3b1b/videos/blob/master/custom_config.yml （背景 #000、CMU Serif、saturation 1.5）
+- https://github.com/3b1b/manim/blob/master/manimlib/default_config.yml （色值）
+- https://github.com/3b1b/manim/blob/master/manimlib/utils/rate_functions.py （smooth 等）
+- https://github.com/3b1b/manim/blob/master/manimlib/animation/creation.py （Write/ShowCreation 参数）
+- https://github.com/3b1b/videos/blob/master/_2017/nn/part1.py 、part2.py （神经元与权重画法）
+- https://github.com/ManimCommunity/manim/blob/main/manim/utils/rate_functions.py （CE 版对照）
+- https://www.3blue1brown.com/faq （"Avoid pointless animations"）
+- https://www.dwarkesh.com/p/grant-sanderson （先排动画后录口播）
+
+## ⑧ 最容易做错的 3 件事
+
+1. **把「发光」当成 3b1b 的标志去加 bloom、加深蓝渐变底。** 原作是纯黑底＋高饱和细线＋×1.5 饱和，几乎没有光晕。加了光晕就成了「科技感 PPT」。
+2. **全用 linear 或普通 ease，动画又快又多。** 默认必须是 smooth（五次多项式），一个动画 1–3s 后停 1s；每个动作要对应口播里的一个动词。
+3. **颜色编码中途变卦／颜色太多。** 一个颜色＝一个概念，公式里的符号和画面里的物体同色；超过 3–4 种语义色观众就记不住。
+
+## qa 数字（skill `scripts/qa.py`，2026-10-04，审片前）
+
+| 镜头 | 运动% | 静止帧对% | 跳变 | 均/峰 ms | 确定性 |
+|---|---|---|---|---|---|
+| t1_s1 | 1.83 | 17.7 | 0 | 1.5/2.4 | ✓ |
+| t1_s2 | 7.1 | 0.0 | 0 | 2.2/3.1 | ✓ |
+| t1_s3 | 3.26 | 0.0 | 0 | 1.0/2.2 | ✓ |
+
+## 修订（独立审片 → 改一轮，2026-10-04）
+
+审片 agent 只看成片，t1 提了 2 条 🔴、2 条 🟡：
+
+| 审片意见 | 改法 |
+|---|---|
+| 🔴 逻辑错：镜头 3 把输出神经元「猫」的权重画成 10×10 像素模板，但输出层连的是隐藏层 | 改成推进**激活 0.95 的隐藏层神经元**（3b1b 原片讲隐藏层就是这样把权重画成图），结论「像猫脸 0.95」与镜头 2 里它的亮度一致；公式 a⁽¹⁾ 本来就指隐藏层，不用改 |
+| 🔴 结论没有停留，0.92 在最后 0.1s 才数到；图例提前淡出 | 镜头 3 时间轴整体前移：1.65–2.0s 数到 0.95，Indicate 到 2.3s，**停 0.6s**；图例留到片尾 |
+| 🟡 推镜前停留太短、新标题出来时挂着粗连线残影 | 推镜前先描黄目标神经元 0.3s；开口外旧画面改为 p 0.45–0.8 退完；新标题 0.75s 才开始写 |
+| 🟡 8 秒塞 5 个概念 | 保持 8 秒（任务要求），卡片⑤写明真用时拉长 2–3 倍 |
+
+另：镜头 1 落定后的神经元改用真圆画（原来是 48 边形），镜头 1 末帧与镜头 2 首帧**逐像素相同**（实测差值 0）。
+
+修订后 qa：
+
+| 镜头 | 运动% | 静止帧对% | 跳变 | 均/峰 ms | 确定性 |
+|---|---|---|---|---|---|
+| t1_s1 | 1.9 | 15.8 | 0 | 1.6/2.7 | ✓ |
+| t1_s2 | 8.41 | 4.2 | 0 | 2.1/2.8 | ✓ |
+| t1_s3 | 2.66 | 15.1 | 8 | 0.9/2.0 | ✓ |
+
+t1_s3 的 8 个「跳变」在 lt 1.06–1.23s（像素图整体滑到权重图上）和 1.51–1.54s（100 格收拢）——看过逐帧，是有意的大位移，不是穿帮；15% 静止帧对来自结尾 0.6s 的停留（3b1b 的 wait，有意为之）。