framechord 是做什么的？
从任何能运行进程的代理中使用 framechord 二进制文件。如果它缺失，请阅读 安装 了解公共安装程序、用户本地安装和显式更新，或者解释 cargo install --path /path/to/framechord 用于源代码检出。请勿在技能内部切换媒体工具或进行提供商 API 调用。
支持对现有的 mediaagent/ 项目进行就地处理。在升级旧安装之前，请阅读 重命名和遗留项目；使用返回的 data_directory 路径，而非假设文件夹名称。
阅读 命令 了解此二进制版本中的每个命令和标志；工作流程 了解输出、限制、恢复和审阅；创作 了解角色和信息图模板。机器可读的模式文件位于 references/schemas/。导出的模板位于 templates/。
在跨场景复用相同角色时，阅读 角色连续性。使用选定的身份引用、支持的保真度控制，并与实际原始图像进行比较；API 成功并不保证相似度。
在检查设置或提供商/密钥故障时，阅读 连接检查：doctor 离线检查存在性；doctor --live 通过只读请求显式验证身份。它支持提供商过滤、超时和 JSON。读取每个提供商的状态/操作；成功验证身份并不保证生成/模型/计费就绪。
在发现语音、设计预览、接受授权录音，或显式创建/克隆/绑定选定提供商语音时，阅读 语音。预览生成、提供商端创建、规范绑定和录音接受是独立操作。
阅读 设置和当前模型 了解循环终端向导、Google 优先默认值和显式 OpenAI 替代方案、保留项目 .env 设置、掩码凭据和项目技能安装、非交互式设置就绪、模型过滤器和显式目录刷新。对于单个资产，使用显式的当前提供商/模型/输入/输出标志，无需初始化。对于重复性工作，代理使用 init PATH --preset recommended --json --non-interactive，检查 config status --json，并在需要时使用 config setup --file 提供精确配置。人类终端用户运行 init 以恢复设置。初始化期间不会进行提供商调用。保留现有角色模型锁定；已退役模型的身份需要新的角色版本和人机接受的引用，才能再次生成。
精确保留所要求的对话、歌词、数字和标签。在将文章改编为播客时，使用单独的显式规划操作。在本地文件中提供文章文本。角色是可选的；选择后，复用其已接受的引用和固定的语音/提供商/模型。派生身份资产必须使用原始资产的已记录提供商/模型；冲突的覆盖会失败。保留原始元数据，而不是将项目默认值复制到派生作业 YAML 中。将稳定身份与姿势、场景、传达或临时服装分开描述。候选引用需要用户选择后才能接受。
使用模板创作文件，然后 validate。在输入为新的情况下，在执行前检查 generate --job ... --dry-run --json。仅在用户请求时才调用生成。使用 --json --non-interactive 进行自动化。如实报告二进制文件返回的工件路径和不完整的作业。
对已记录的运行使用 runs status、runs wait、runs reconcile 和 runs resume。在考虑付费重试之前，检索受支持的提供商结果。切勿静默重试未知的付费请求；--retry-unknown 需要显式用户授权。审阅将质量与生成成功分开记录。审阅不会自动修订，修订也不会替换规范角色引用。
阅读 修复工作流程 了解 v2 演员表、选定的规划器输入、有界验证、引用存储、恢复结果附件、使用和迁移。作业/配置/运行接受 v1 和 v2；新演员表和播客汇编需要 v2。其他清单版本保持不变。
使用 plan --character MANIFEST --asset FILE 显式选择依赖项；二进制文件将它们复制到 _inputs/。对于包含多个已保存角色的场景，使用 cast 条目和特定于作业的指令文件。需要已接受的引用和兼容的原始模型谱系；切勿重写配置文件以消除冲突。
对于验收测试，预览 verify --suite SUITE --json 并在 --execute --preview-hash HASH 之前获得对有限付费批次的批准。缺失的凭据将被跳过，而非传递。语音创建/克隆使用其各自的显式角色命令和批准。review report 比较生成的工件和已保存的引用；只有实际的用户选择才能授权规范接受。
models --live 读取提供商目录；可见性并非生成权限。usage 如实报告返回的单元和未知成本。storage plan --output cleanup.yaml 在 framechord/ 外部准备一个保守的清理预览；storage clean --plan cleanup.yaml 仅移除重新验证后未引用的 blob。migrate --kind job|config|run --file FILE 预览；--apply 保留 v1 备份。对于不确定的作业，runs recover 需要记录的指纹和协调证据，然后 runs resume 发布提供的响应，无需重新生成。