v1.4.1 — 视觉决策与实战经验库

v1.4.1 — 视觉决策与实战经验库

本版把最新 main 的两条增量一起正式发布：可解释的视觉决策合同，以及从真实 ChatCut 项目持续学习的实战经验库。

Visual Decision Contract

• Rule Registry 从 14 条扩展为 18 条 runtime rule。
• 每个语义段只声明一个主视觉任务。
• B-roll 候选按语义、真实性、时机、清晰度、版权与重复度六维透明计分。
• 低于阈值的候选只能转人工复核；生成视觉不得冒充 evidence/data。
• 新 Schema、匿名 fixture、CLI 和 8 项回归测试进入正式 release gate。

Field Reports

• 新增追加式 field-reports/，保存真实任务时间线、失败链、修复、验证、未决问题和 E0–E3 证据等级。
• Skill 迭代前必须读取命中案例，之后在 iteration-log.md 记录采用、拒绝、canary 与晋升决定。
• 首个公开脱敏 AI Hero 案例记录编辑器预览、项目状态和云端合成帧不一致，以及真实 Hyperframes 视频资产替换和 1080P60 最终验证。
• 整理 7 条可直接分享给 ChatCut 产品与研发的问题；没有保存的编辑器黑底截图被明确标为证据缺口，不冒充机器像素证据。

验证

• Node 24.18.0 下 npm run verify
• 307 tests passed
• GitHub Actions main verify passed
• skills-ref format validation passed
• OTA strict PII/version audit passed
• Public safety and version-drift gates passed

仍未验证的边界

真实 ChatCut adapter、真实媒体探针/渲染和平台发布仍需要当前 build/schema/probe/canary 证据；仓库不会自动执行这些动作。一次编辑器黑底事故不会直接晋升为全局 hard policy。

v1.4.0 — 可验证生产系统

v1.4.0 — 可验证生产系统

这一版把 ChatCut 口播从剪辑技巧包推进为可验证、可恢复、可治理的离线生产系统。

本次交付

• Rule Registry：14 条 runtime rule、六个治理域与 tighten-only override。
• Creator OS IR + Rational Time：统一 project、transcript、edit、state、caption 与 evidence，并校验 revision、coverage 和 owner。
• SRT bridge + Explainable Planner：SRT 人工视图、sidecar 机器真相、可复算信号与 source refs。
• Preview Approval：将批准绑定到 actor、scope、plan/style/timeline 指纹，漂移时 fail closed。
• Recoverable Executor + Evidence：fake adapter 覆盖幂等、revision lock、写后回读、补偿、checkpoint/resume 与证据失效传播。
• Media QA + Export Authorization：审计 artifact、音画、隐私覆盖和导出授权。
• Governed Distribution Pack：平台规则新鲜度与母片/content truth 绑定，publishAction=none。
• Feedback Governance + Live Gate：匿名反馈进入人工建议队列；缺少当前 capability canary 时阻断 live route。

真实环境边界

仓库已经验证离线 Schema、匿名 fixtures、fake adapter、报告审计与 fail-closed 路由。真实 ChatCut adapter、真实媒体探针/渲染和平台发布仍未验证，也不会被自动执行。

安装

gh skill install maojiebc/majia-chatcut-koubo
# 或
npx skills add maojiebc/majia-chatcut-koubo
# 或
npx clawhub install majia-chatcut-koubo

完整变更见 CHANGELOG.md。

v1.3.0 — 制度增量 + ChatCut 实测档案 + 本地个人层

V1.3.0（2026-07-24）— 制度增量 + ChatCut 实测档案 + 本地个人层

私有实战版（v2.x，含一场约 15 分钟母片全片状态机重构会话的教训）向公开包的通用增量融合。全部案例匿名化，品牌词表实词与个人实测坐标不入公开包（走本地个人层机制）。

SKILL.md 制度增量

• 新增「确认闸门」节：状态表先行硬闸（画面结构批量落库前必须产出全片状态表——stateId｜[start,end)｜三层参数｜进出过渡｜隐私｜语义理由——请用户过目，无状态表禁止批量 edit_item；上下文压缩后不凭摘要续做画面结构）+ 高风险删除/字幕/视觉方向确认（视觉方向先出 2–4 个可选方案）+ 导出须用户开口 + 自动修复三轮止损。
• 工序 4 样片闸门升级：长片（>5 分钟）60 秒预览闸（开头 60 秒全层完成态请用户验收再推进）；批量中逐幕渲染抽查；验收单元 = 完整成片体验（画面+动画+字幕+隐私），字幕修正随幕完成，不设整片末尾统一校对。
• 工序 3 精校稿先行：开工扫素材目录找用户精校逐字稿，有则为字幕文本唯一真相源；ASR 三大高发（数字吞位/繁体/专名）禁止自行猜测修正——同句写进成片红线。
• 工序 6 下游增强：静态章节卡可由外部 MG 工具（如 hyperframes）产 MP4 后 import_media 替换；音效/BGM 走 ChatCut 素材库与生成工具，音量不夺 anchor。
• 工序 7 验收加双端预览路由指针（细则权威位在 chatcut-field-notes）。

新册 references/chatcut-field-notes.md（ChatCut 宿主实测行为档案）

• 几何与渲染：crop=框内裁显示区与反推公式、keepAspectRatio 校验/渲染两层不一致与两步提交、编辑器 vs 云端渲染差异（成片以云端帧为准）、borderRadius 作用域。
• 窗口动画：MG 媒体槽（video/image 属性）运行时失效实证 → 四档链 2/3 档跳过；正解 = 满屏 item + 窗口 reframe shader（归一化参数契约/track-bound per-item 挂载/过渡窗口摆位/圆窗换算示例）；框线与过渡单一 owner；shader beta 确认。
• S 态实现：endWin 收拢至圆心=人物退场；split 后 opacity=0（anchor 不断）；split 在气口造缝。
• 字幕分页引擎机器路径：read_captions words:true 拿词级 key → forcePageBreak 气口打断 → forced break 间 ≤22 显示字则引擎不再 length 切；源 item 边界自动强分页；split_item 更换 item id → forcePageBreak 需按新前缀重设（纪律=结构 split 先做完再设断点）；字体须 search_fonts 命中、样式改动必须走 json 参数。
• 音频层基线：trackId 省略自动建 A1/显式 alias 强制新轨、library:sound:<id>、whoosh -12dB/卡点 -10dB/BGM -24dB 实测起点（听感标 unverified）。
• 外部 MG 章节卡链路：对比度门（WCAG 大字 3:1）拦色、data-duration 锁总帧、渲染后 import_media。
• 隐私扫描 SOP：全源抽帧 contact sheet → 源区间求交 → 插叙段必查 → 源头平移优先于遮挡 → 渲染帧兜底。
• 工具面杂项 + 双端预览路由（Mac 客户端优先 → 提示可装一次 → 浏览器兜底；代理像素证据始终=云端渲染帧）。

三本通用新册

• references/operating-manual.md：一片一闭环（冻结盘点→状态表→原子改画面→精修字幕→音频→门禁）、四大门禁 + 八道硬闸、A-roll 删减增量（删前保后/风险分级）、批量流水线与回归矩阵、多代理调度编制、生成资产纪律（成本合并报价/参考图先行/两段式/三轮降级）、验证方法学、导出与帧率、止损与汇报。
• references/retention-structure.md：开头重构决策流（删铺垫/钩子三公式/爆点前置扫描）、钩子-兑现成对、注意力时钟与开环句保护、自然结尾、四平台条件路由表（抖音/小红书/视频号/B站，含可信度标注）、数据复盘口径。
• references/recovery.md：502/403/工具面固化处置、续接手册协议（事实层 vs 动态 ID 层）、打开既有项目标准流（connected≠持久化）、转写故障绕行、素材上传、上下文压缩后恢复。

既有册融合增量

• dual-frame-layouts.md：五状态 → 七执行状态（S/P 升为正式行）；P 态语义修正为「独立不透明全区间 redaction owner，人物窗/裁切只承担构图」；新增状态落地原子契约（半开区间三层同边界提交/区间相交审计/owner 台账/逻辑事务/outroStart）与双素材呼吸感条款（人物升 A、录屏升 S 交替；长片每幕评估一次 S 态机会）；竖版补充加两套文字体系不混用、按镜头任务切换裁切。
• motion-transitions.md：四档链加 ChatCut 宿主快速路由（2/3 档跳过、推荐 reframe shader、降级直切需确认）；新增「已验收动效的指纹守恒」。
• face-reframe.md：效果栈补第三层（描边/阴影沿最终蒙版边界）；uvMapped RGB/Alpha 采样错位特征故障；兼容探针契约（templates/compatibility.template.json）与探针残留=P0。
• captions-terminology.md：精校逐字稿真相源节、剪后重建五步、ASR 准备与缓存、短卡门槛改毫秒制（450/800ms，30/60fps 等价）、validator 用法更新（结构化 JSON/--terms）、分页引擎指针。
• graphics-blocks.md：新增画面任务路由表（真实素材 vs 信息块；一段一个视觉任务）。
• theme-palettes.md：token v1.1 对比度修正说明；新增色板简报（palette brief）、感知均匀色阶与色域、图表与数据色板三节。

机器门禁与资产

• 新增 rules/policy.json：不可由 profile 放宽的字幕发布策略（单行/禁自动换行/原文源/词级审计/450–800ms 毫秒短卡/繁体零容忍）。
• 新增 schemas/：policy / profile / captions / terminology / compatibility 五份 JSON Schema。
• scripts/validate-caption-pages.mjs 全量升级：递归 profile 继承（extends）、policy 硬校验（profile 无法放宽）、结构化字幕 JSON（旧文本仅迁移兼容）、毫秒短卡、繁体检测、页/词区间与文本一致性、外部词表文件、新增 --terms 旗标（本地个人层词表覆盖 profile.terminologyFile）。
• 新增 tests/caption-validator.test.mjs（14 项回归，含 --terms 用例）与根 package.json（npm test / npm run verify）。
• assets/compositions.json v2.1：protect 拆分为 mustRemainVisible / mustBeRedacted（隐私项不再与保护可见项同数组）。
• templates/：operating-profile 模板升级为 schema 2.0（policyVersion/timeline/毫秒 releaseGates）；terminology 模板升级为 entries 结构（带证据要求与风险分级字段）；新增 compatibility.template.json；新增 local-config-example/（本地个人层四件套带注释模板：profile / terminology / aesthetics / local-notes）。
• 主题 token v1.1（json/css/ts 三处同步 + 4 份 playbook 升 1.2.0）：海盐青正文 #0B5F58→#07554F（7.67:1 达标）、次级文字与 ctaText 加深；暖灰橙/极简黑白次级文字加深；大地棕 ctaBackground #8B5E34→#6B3F1F（配白字 8.9:1）。check-contrast.mjs 全绿。

本地个人层机制（千人千面）

• SKILL.md「让它变成你自己的」升格为正式契约：~/.config/majia-chatcut-koubo/ 开工探测、存在即叠加（profile 覆盖同名键 / terminology 走 --terms / aesthetics 审美裁决 / local-notes 个人护栏）；品牌实词、真实业务数字、个人路径只进本地层，永不进 git；本地 profile 不能放宽 policy。

脱敏说明：本版所有新增内容不含真实雇主/品牌词表实词/个人路径；案例一律匿名化（「某 15 分钟母片重构会话」）；templates/examples.md 原有一处品牌词判例同步替换为通用词。

• 供应链修复：assets/theme-kit/requirements.txt 将 CairoSVG>=2.7 固定为 CairoSVG==2.9.0，消除 CVE-2026-31899（CairoSVG 2.7 递归 <use> 元素放大导致的指数级 DoS）暴露。该依赖仅被可选脚本 assets/theme-kit/scripts/render-backgrounds.py（SVG→PNG）使用，pin 到 PyPI 最新稳定版不影响功能。
• trigger 收窄：SKILL.md description 追加「前置（需官方 ChatCut skill/MCP）」与「非目标（不做非视频剪辑任务、不替代官方工具用法）」，回应 ClawHub skillspector 的 SQP-1（activation 过宽）。
• 触发本次修复的背景：v1.2.2 发布后 ClawHub skillspector 因上述未固定 CVE 依赖判 suspicious/CAUTION（clawscan AI 审查判 benign），版本被扣在审核未转公开；本版清除该 HIGH 项以求干净过审。
• 规则本体（references/templates/scripts 逻辑）零改动。

V1.2.2（2026-07-23）— 中文品牌名

• 展示名定为「ChatCut口播 · 马甲实战版」，同步五处品牌面：SKILL.md H1、README.md H1、README.en.md 副标题注记、GitHub About 简介、ClawHub --name；架构图标题与 footer 一并更新。
• 安装标识（slug）majia-chatcut-koubo、SKILL frontmatter name:、gh skill install / npx skills add / clawhub install 命令一律不变 —— 仅人读展示名变更，机器标识与安装路径零改动。
• 规则本体（SKILL/references/templates/scripts）零改动。

V1.2.1（2026-07-23）— 框架图 + README 装修

• 新增 docs/architecture.svg：增量层全景框架图 —— 官方 ChatCut 底座 → 双画面版式 / 主题配色 / 过渡动效工程 / 人脸取景 四大件（各标所治痛点）→ 词表模板 + 字幕门禁 → 可见画面 / 可听声音 / 可读字幕 验收三象；配套 docs/architecture.png（raw.githubusercontent 渲染用，.svg 在包页不内联）。
• README.md / README.en.md 首图改为该框架图（绝对 raw URL），原 8 主题配色总览下移为第二张图；「结构」段补 docs/。
• 版本记录段收敛为最近 3 条（V1.2.1 / V1.2.0 / V1.1.0），更早版本移交 CHANGELOG。
• 纯文档增强，SKILL/references/templates/scripts 规则本体零改动。

V1.2.0（2026-07-22）— 块级动效词汇表

• references/graphics-blocks.md 新增「块级动效词汇表」：进场/出场/循环强调三轴受限枚举（弹入默认禁——「不弹跳」是全包基线；闪烁禁；漂浮几乎不用；打字机仅文字块且需逐字有语义）、时长基线（进场 10–16 帧 @30fps、出场 8–12 帧，一律按秒或归一化帧率写）、块×动效推荐表、「一致性>花样」与同屏错帧规则。
• 8 份主题 playbook 各增「动效档」：逐主题准许/慎用/禁用集（极简黑白收到最窄仅淡入+上移；活力青柠为弹入唯一豁免主题且仍需用户点头）；playbookVersion 1.0.0 → 1.1.0。
• 方法来源新增 yoqu/lingji-cut（Apache-2.0）：仅吸收三轴动效枚举的组织方法，枚举取舍与全部文本为本包自定。

V1.1.0（2026-07-22）— 主题 playbook 化

• 8 套主题各配一份代理 playbook（assets/theme-kit/playbooks/<id>.md）：frontmatter 注入 themes.json 语义 token + token 档位实测结论 + 绑定版式 + 信息块偏好 + 字幕底板硬规则 + 一段可直接嵌进 MG 生成指令的「调用 crib」。主题包从「色板+底图」升级为「代理可执行的设计系统」。
• 新增 references/graphics-blocks.md：十类信息块 × 何时用（证据信号驱动、与钩子三公式对应）；行动引导块默认不加为红线。
• theme-palettes.md 增加标准用法流：选主题 → 读 playbook → 生成时嵌 crib。
• 方法来源新增 pireel/pireel（AGPL-3.0）：仅吸收「主题=数据+代理 playbook」与逐主题 crib 的组织方法，未复制其主题内容、文本或代码。

V1.0.0（2026-07-22）— 首发

从作者私有实战体系（11 天 99 场 ChatCut 代理剪辑会话、11 支直播切片多轮返工）蒸馏出的通用技巧层：

• 五条第一性原则 + 通用工序 + 成片红线（SKILL.md）
• 双画面版式系统：横竖版 8 套具名版式坐标快照 + 五状态语义决策器 + 小窗腾挪规则
• 主题配色系统：8 套实测主题（token/SVG 底图/可运行组件）+ 对比度档位限制 + 按角色用色
• 过渡动效工程：端点契约、N-1 归一化、分层缓动、四档可靠性链、fps 归一化
• 人脸取景与三层合成：reframe→mask 顺序、GL UV 坐标陷阱、焦点保持换算、overscan 黑边数学、二次裁切判定公式
• 字幕与词表：气口分卡判例、单行机器门禁、译文轨 P0 陷阱、词表机制
• 三个自维护模板：词表 / 实测参数 profile / 例句判例库
• 字幕页机械校验脚本 validate-caption-pages.mjs（配 profile releaseGates 使用）

v1.2.3 — 依赖 CVE 修复（CairoSVG CVE-2026-31899）

v1.2.3 — 依赖 CVE 修复（解 ClawHub 审核扣留）

v1.2.2 发到 ClawHub 后被 skillspector 判 suspicious/CAUTION 扣在审核（clawscan AI 审查为 benign）。根因是一个真实供应链项，本版清除：

• 供应链修复：assets/theme-kit/requirements.txt 的 CairoSVG>=2.7 → CairoSVG==2.9.0，消除 CVE-2026-31899（CairoSVG 2.7 递归 <use> 指数级 DoS）暴露。该依赖仅被可选脚本 render-backgrounds.py（SVG→PNG）用，pin 到 PyPI 最新稳定版不影响功能。
• trigger 收窄：SKILL description 补「前置（需官方 ChatCut skill/MCP）+ 非目标（不做非视频剪辑、不替代官方工具用法）」，回应 skillspector SQP-1。
• 规则本体（references/templates/scripts 逻辑）零改动。

安装（不变）：gh skill install maojiebc/majia-chatcut-koubo

v1.2.2 — 中文品牌名「ChatCut口播 · 马甲实战版」

v1.2.2 — 中文品牌名「ChatCut口播 · 马甲实战版」

• 中文展示名定为 ChatCut口播 · 马甲实战版，同步 SKILL.md / README / README.en / 架构图标题+footer / GitHub About / ClawHub。
• 安装标识（slug）majia-chatcut-koubo、frontmatter name:、安装命令一律不变 —— 仅人读展示名变更，机器标识零改动。
• 规则本体（SKILL/references/templates/scripts）零改动；架构图 alt 与 footer 版本号同步 v1.2.2。

安装（不变）：gh skill install maojiebc/majia-chatcut-koubo

v1.2.1 — 增量层框架图 + README 装修

v1.2.1 — 框架图 + README 装修

纯文档增强，规则本体零改动。

• 新增 docs/architecture.svg 增量层全景框架图：官方 ChatCut 底座 → 双画面版式 / 主题配色 / 过渡动效工程 / 人脸取景 四大件（各标所治痛点）→ 词表模板 + 字幕门禁 → 可见画面 / 可听声音 / 可读字幕 验收三象。配套 architecture.png（raw.githubusercontent 渲染用）。
• README.md / README.en.md 首图改为框架图（绝对 raw URL），原 8 主题配色总览下移为第二张图；「结构」段补 docs/。
• 版本记录收敛为最近 3 条，更早移交 CHANGELOG。

安装：gh skill install maojiebc/majia-chatcut-koubo

v1.2.0 — 块级动效词汇表:三轴枚举 + 8 主题动效档

v1.2.0 — 块级动效词汇表

信息块的动效从「各自发挥」收敛为三轴受限枚举:

• 进场:淡入/上移入(默认)、左右入(方向须有语义)、缩放入(强调一次性)、弹入默认禁(「不弹跳」是全包基线,唯一豁免见活力青柠且需用户点头)
• 出场:默认淡出随气口静默退场,不做戏剧化出场
• 循环强调:pulse 全片≤1、flicker 禁(光敏风险)、typewriter 仅文字块且逐字须有语义
• 8 份主题 playbook 各配「动效档」准许/禁用集(极简黑白最窄:仅淡入+上移)
• 块×动效推荐表:「一致性>花样」,同屏双块入场错开 3–5 帧

方法来源新增 yoqu/lingji-cut(Apache-2.0,仅吸收三轴枚举组织方法)。

安装:npx skills add maojiebc/majia-chatcut-koubo

v1.1.0 — 主题 playbook 化:8 主题代理手册 + 十类信息块

v1.1.0 — 主题 playbook 化

主题包从「色板+底图」升级为「代理可执行的设计系统」:

• 8 套主题各配一份代理 playbook(assets/theme-kit/playbooks/):token 语义与实测档位、绑定版式、信息块偏好、字幕底板硬规则(如海盐青正文禁裸压 canvas 必须落 surface)、以及一段可直接嵌进 MG 生成指令的「调用 crib」
• 新增十类信息块选用表(references/graphics-blocks.md):标题卡/大数字/数字变化/趋势对比/步骤清单/关键词强调/章节导航/代码卡/问答卡/行动引导——每类给出进入信号与禁忌,由证据信号驱动;行动引导默认不加是红线
• 标准用法:选主题 → 读 playbook → 生成图形时嵌 crib,不再逐元素查表挑色

方法来源新增 pireel/pireel(AGPL-3.0,仅吸收「主题=数据+代理 playbook」组织方法,未复制任何内容)。

安装:npx skills add maojiebc/majia-chatcut-koubo

v1.0.0 — ChatCut 口播剪辑通用技巧包首发

v1.0.0 — 首发:ChatCut 口播剪辑通用技巧包

官方 ChatCut skill 之上的增量层,从 11 天 99 场真实代理剪辑会话蒸馏:

四大件

• 双画面版式系统:横竖版 8 套具名版式坐标 + 五状态语义决策器(证据驱动,不按时间轮播)
• 主题配色系统:8 套实测主题(token/SVG 底图/可运行组件)+ 对比度档位限制
• 过渡动效工程:端点契约 / N-1 归一化 / 分层缓动 / 四档可靠性链 / fps 归一化
• 人脸取景与三层合成:reframe→mask 硬顺序 / GL UV 坐标陷阱 / overscan 黑边数学 / 二次裁切判定公式

自维护模块

• 词表模板(你的品牌与 ASR 误听)+ 实测参数 profile 模板 + 气口/钩子/删减判例库
• 字幕页机械校验脚本:validator 退出码非 0 = 未完成

安装:npx skills add maojiebc/majia-chatcut-koubo