企业官网建设流程全解析

• AI 技能
• AI 评测
• 提示工程
• 人工智能
• 媒体生成

本篇指南以仓库俄语版快速入门文档 docs/QUICKSTART.ru.md 为骨架，完整还原"安装一个根技能 → 用诊断工具验证 → 根据已有决策选择路线 → 写出并打磨第一段俄语提示词 → 单点修复 → 对白/参考/续拍 → 安全边界"的完整链路，并补充仓库安装器源码（scripts/install_codex_skill.py）与配套文档（docs/INSTALL_SCOPES.md、docs/INSTALL_DOCTOR.md、docs/INSTALL_MIGRATION.md）中的实现细节。读完后，你将能够在 Codex / Claude Code 中一次性装好技能、独立判断安装状态，并掌握"以镜头而非秒数为单位"的 Seedance 2.0 提示词写作方法论。本指南只负责把场景想法变成可直接交给视频服务渲染的提示词；它本身不生成视频，也不保证渲染质量。

1. 安装：一次性装好一个根技能

包版本为 6.7.0。安装前先准备 Python 3 环境，并获取仓库内容——既可以下载仓库 ZIP 并解压，也可以执行 git clone：

git clone <seedance-2.0 仓库地址> cd seedance-2.0

然后在仓库目录内从以下方案中只选一个执行。每个方案都会在目标目录下生成一个名为seedance-20/的技能文件夹；技能内部已包含全部子模块（interview、prompt、sequence、continuation、troubleshoot 等），不需要再单独安装任何子技能。

# Codex：对当前用户全局可用 python scripts/install_codex_skill.py --client codex --scope user # Claude Code：对当前用户全局可用 python scripts/install_codex_skill.py --client claude-code --scope user # Codex：安装到本仓库之外的某个既有项目 python scripts/install_codex_skill.py --client codex --scope project --project-root /path/to/project

三个方案的技能父目录由安装器按 docs/INSTALL_SCOPES.md 的规则决定：

几个关键参数约束（可从 scripts/install_codex_skill.py 的参数解析逻辑印证）：

• --client必须搭配--scope user或--scope project；--scope project还必须给出--project-root，且该目录必须已经存在——安装器不会替你搜索 Git 祖先目录，也不假定安装器所在目录就是目标项目。
• --dest与--client/--scope互斥（源码中以 mutually exclusive group 实现），避免拼写错误悄悄在冲突目标之间切换。
• 显式的--client codex --scope user固定使用~/.agents/skills，即使设置了CODEX_HOME也如此；不带任何目标参数时才沿用对历史环境敏感的$CODEX_HOME/skills路径。两种形式都不会去搜索、移动、删除或禁用其他已安装副本，因此新装副本可以与旧副本共存。
• 路径含空格时请加引号，例如 PowerShell 中--project-root "C:\Projects\My Film"。

安装器并不是简单复制整个仓库：它依据 validation/install-payload.txt 这份显式 allowlist 打包，计算每个文件的 SHA-256，写入完成记录，并剔除 README 中未随包安装的图片资源链接。从源码看，开发专用与网络相关文件被明确排除在安装载荷之外：eval_run.py、eval-runs/、tests/不会进入已安装技能，图片与字体（*.png、*.jpg、*.ttf等）也不打包——安装后的载荷是纯离线文本技能加本地校验脚本，具体边界见 SECURITY.md。

如果你需要覆盖替换一个已存在副本，安装器使用带事务语义的替换流程：切换期间保留临时备份；若切换失败且事务记录仍有效，会回滚恢复旧的完整副本；切换成功后临时备份进入隔离区并被删除——它不能替代你自己保留的个人备份。因此替换前请先保存本地改动并另做独立备份，--force只用于有意的替换。

2. 用诊断工具验证同一个目录

安装完成后，用只读诊断工具 scripts/install_doctor.py 检查与安装时相同的目标目录。例如验证第一个安装方案：

python scripts/install_doctor.py --client codex --scope user --json

诊断工具与安装器共享同一套目标参数（--client/--scope/--dest/--project-root），检查时请使用与安装完全一致的参数；它会自动在指定父目录下追加seedance-20进行核对。该工具不会安装、更新、备份、删除、恢复事务，也不会联网或读取凭据，它只是一个源码检出侧的核对工具。

各状态含义如下：

退出码约定：0表示 current；1表示需要关注的状态；2表示 unsafe 或检查不完整（也用于非法 CLI 参数）。JSON 输出包含所有发生变化的源码声明路径，但从不打印文件内容或原始标记错误。

需要强调current的边界：它只证明被检查的文件与这份源码检出一致，并不证明你的客户端实际加载了这份副本。因此拿到current后仍要刷新/重启客户端，并单独核实客户端发现的seedance-20路径。版本标签来自 SKILL.md 的 frontmatter，属于描述性信息，不能作为完整性证明；完成记录也不记录 commit，所以installed_commit是unknown而不是猜测值。

3. 换目录、迁移与手动转移

什么时候需要迁移

当技能安装在旧目录、出现两份副本，或客户端加载的版本与你刚安装的不同时，参照 docs/INSTALL_MIGRATION.md 走迁移流程。核心原则：记录新旧 skills 父目录（安装器与诊断工具会自动追加seedance-20/，不要把最终目录作为--dest传入）。

检查—保留—安装—验证五步

1. 检查已知旧父目录：python scripts/install_doctor.py --dest /path/to/old/skills --json，保留报告与所对照的源码提交。different_payload不说明谁更新；modified/unmanaged需要审查本地改动与来源；unsafe则停下来人工检查路径。
2. 保留旧目录：把整个seedance-20/（含隐藏文件与本地新增文件）备份到所有客户端技能目录之外的独立位置，替换前先验证备份。诊断工具不检查额外文件，安装器的临时事务备份也不是个人保留备份。
3. 检查新父目录：对新目录同样先跑诊断；若已含副本，先核对再替换。如果新旧父目录解析到同一目录，这是原地更新而非迁移，走替换流程。
4. 安装到空目标：不带--force执行安装命令；如果它拒绝已有目标，应调查目标本身而非盲目加--force。不要复制整个仓库，也不要叠加两份载荷版本。
5. 核对新载荷及其被发现情况：从同一源码检出对新父目录跑诊断，然后刷新客户端并核实seedance-20的确切源路径。正确的名字、版本标签或current诊断结果单独都不足以证明客户端选中了新副本。

例如显式选定当前 Codex 用户父目录（注意 PowerShell 中~可能不展开，需用"$HOME/.agents/skills"）：

python scripts/install_doctor.py --dest ~/.agents/skills --json python scripts/install_codex_skill.py --dest ~/.agents/skills python scripts/install_doctor.py --dest ~/.agents/skills --json

第一条命令在安装缺失时返回退出码1——请查看状态含义，而不是把所有非零退出码都当成"可以安装"的信号。

解决重复发现

• Codex：官方文档说明同名技能不会被合并，可能在选择器中同时出现。要"退役"一个已知旧条目而不删除它，可在~/.codex/config.toml中按路径禁用：

[[skills.config]] path = "/absolute/path/to/old/seedance-20/SKILL.md" enabled = false

Windows 上 TOML 建议使用正斜杠；操作前先备份客户端配置，更新已有条目而不是追加冲突重复项。

• Claude Code：官方优先级是企业级 > 个人级 > 项目级，因此新的项目副本可能被旧个人副本遮蔽。核实来源后再决定；若旧副本归你所有，先在扫描目录之外做验证过的备份，再只移动那个被识别的目录离开发现范围。不要把备份目录改名后留在技能扫描目录内，也不要假定改动 frontmatter 名称能安全迁移引用与调用元数据。

手动转移

当客户端需要通过导入对话框接收技能，或需要转移到另一台机器时，按 docs/MANUAL_INSTALL.md 操作：

1. 从已审查的检出运行python scripts/install_codex_skill.py --dest /path/to/new-staging/skills，在源码检出之外使用一个新目录作为暂存区。
2. 只复制得到的seedance-20/目录（保留相对路径、隐藏文件与完成记录），按目标客户端的导入格式打包——ZIP 并非通用格式。
3. 在目标端有对应源码检出与 Python 时，运行python scripts/install_doctor.py --dest /path/to/client/skills --json；current表示受检载荷与该源码一致。若客户端剥离了元数据或变换了内容，请调查差异而非伪造完成记录。
4. 重启/刷新客户端并单独验证发现情况。

直接通过 GitHub 导入属于客户端特定的打包路径：请检查客户端实际取走了哪些文件，不要假定它应用了本安装器的 allowlist。手动复制没有安装器的事务恢复/回滚能力，所以需要替换时应尽量使用安装器。

4. 从你已有的决定出发：选对路线

在客户端中调用seedance-20，并直接描述你已经想好的场景。已经确定的时长、机位、声音和情绪不需要再次被询问；如果任务足够明确，可以直接索要成品提示词。不必记住路线名称，下表只是内部路由的映射（完整路由表见 SKILL.md 的 Load Map）：

一个完整的示例请求（俄语原文）：

Нужен радостный шестисекундный клип: взрослая женщина, мастер по ремонту часов, слышит, что отремонтированные настольные часы снова идут. Камера неподвижна, без диалога. Предложи три разных решения, а я выберу. Только подготовь промпты, ничего не генерируй.

（大意：需要一个六秒的欢快片段：成年女性钟表维修师听到修好的座钟重新走起来。机位固定，无对白。给出三个不同方案由我挑选，只准备提示词，不要生成。）

需要换方案时，可要求最多三个方向不同的方案（不同的场面调度、注意力或表演），再选一个或说"替我做主"。方案菜单是可选项，不是每次写提示词前的必选流程；已经决定的机位、声音、时长和被否决的方向要保持不变。

镜头，而不是秒数

这是 Seedance 2.0 提示词方法论的基石：对于含多个镜头的片段，技能按事件发生的顺序给镜头编号，并且绝不在提示词内部写 0–3 秒这类时间段——官方 Seedance 2.0 提示词指南指出，模型遵循镜头顺序，对精确计时支持不稳定；时长是服务端的表面参数，需要表现的"感觉长度"应写成行为（详见 skills/seedance-prompt/SKILL.md 的时间结构小节与 references/multishot-grammar.md）。

当镜头数量未指定时，技能会给出一小段"阶梯"，每级用一行说明取舍：

• Надёжно（可靠）：每个动作都有充足时间；
• С риском（有风险）：对白或肢体接触可能被压缩；
• Рискованно（高风险）：官方指南警告此处内容与对白可能开始失真，因此技能通常建议改为两次更短的生成。

外加一个在推荐阶梯上写好的成品提示词。选一个阶梯或说"выбери сам（你替我选）"。注意：这些阈值是该技能的启发式经验，不是测量出的模型上限；官方也没有公布镜头数量上限。当用户已固定镜头数时，技能会直接写出该数量并一句话标注它处于哪个阶梯。高风险阶梯永远不会被称作"坏了"——提供两次更短生成是更划算的支出。

5. 选定镜头的支撑方案

以下三个方案是针对该具体请求的选项，不是每次写提示词前的必选菜单：

可以选一个方案、组合兼容的决定，也可以说"выбери за меня и объясни почему（替我选并解释原因）"。选定方案 А 之后，后续修改都应保持它，直到你主动要求换思路。

6. 复制所选提示词：俄语示例逐句拆解

以方案 А 为例。这是一个纯文本提示词：不附带任何文件，也不含虚构的图片链接。生成前在所选服务中把时长设为六秒（若该操作允许设置时长）；先检查设置再消耗积分。宽高比与质量等级需单独设置，本示例不预设任何具体服务商或 API。

Взрослая женщина, мастер по ремонту часов, сидит перед работающими настольными часами. Услышав тиканье, она слегка поднимает брови и улыбается, продолжая смотреть на часы. Неподвижный средний крупный план на уровне её глаз. Боковой свет из окна позволяет видеть изменение выражения лица. Слышны тиканье и тихий фон мастерской, без речи и музыки. Последние две секунды она сохраняет улыбку и позу.

（大意：成年女性钟表维修师坐在走动的座钟前。听到滴答声，她微微扬起眉毛并微笑，目光仍看着钟。与她视线齐平的固定中近景。窗侧光足以看清表情变化。能听到滴答声与安静的作坊背景，无对白无音乐。最后两秒她保持微笑与姿势。）

这些决定为什么成立

声音引起可见的反应，固定机位便于读表情，结尾停顿留出观察表情的时间——这是创作意图，不是实测结果：该镜头展示的是"反应"，并不证明真实维修质量。

生成后要检查什么

在视频中核查：目光是否始终在钟上、机位是否没有移动、是否没有出现对白、结尾姿势是否保持。先点名被违反的那条标准，再往文本里加新形容词——不要用堆形容词掩盖结构性问题。

写作顺序与篇幅

"кто — что делает — как снято（谁—做什么—怎么拍）"的顺序方便日后编辑，但这是编辑上的选择，不是模型如何处理开头词组的已验证机制。技能的约40–110 个英文单词只适用于英文起草启发式，既不是测试过的模型上限，也不保证后置子句一定出现；不要把这条英文词数当作其他语言的字数、字符数或音节数限制。留下理解动作及其完成所必需的细节即可。

当提示词过长需要压缩时，按此顺序删减（见 skills/seedance-prompt/SKILL.md 的压缩规则）：重复的风格形容词、泛化的质量词、参考图里已可见的背景细节、次要机位动作、次要动作、臆测的情绪标签；保留保护性约束、动作时序与角色映射。若用户要求双语/混合语言提示词，语言混合只应用于清晰性：参考角色、对白语言、技术机位术语与安全的制作约束。

7. 只修复一个决定，不要推倒重来

Улыбка получилась слишком широкой. Оставь вариант А, шесть секунд и неподвижную камеру. Осталась одна попытка; подготовь правку, но не отправляй её.

（大意：微笑太夸张了。保留方案 А、六秒与固定机位。只剩一次尝试；准备修改，但不要发送。）

如果用户没有附带视频，回答必须基于你的描述，不能假装"看过了视频"。可能的修复：只把「слегка поднимает брови и улыбается（微微扬起眉毛并微笑）」替换为「расслабляет брови и едва приподнимает уголки губ, не показывая зубы（放松眉毛，仅微微提起嘴角，不露牙齿）」。目标是收窄表情幅度；下次生成能否成功不保证。其余设置全部保留。

关键边界：

• 零预算时不要请求新生成。评估是否可用某个成功片段做剪辑，或直接停止尝试。
• 不要宣布镜头验收，只要某个必需标准未被满足。
• 写一份修改文本不授权任何动作：不授权发送、切换服务商、上传文件，也不授权加长时长或提高质量档位。

8. 对白、参考与续拍

精确对白

如果用户把请求改成「сохрани дословно фразу “Работает.”（逐字保留“Работает.”这句话）」，这些词必须原样留在提示词中。女人是自言自语；不得擅自添加对话者或另一种语体。不要把这句话混入原先无对白的方案，不要用转写（transliteration）替代西里尔字母，也不要未经同意缩短精确短语。俄语对白的注意事项见 references/vocab/ru.md：俄语不在模型卡的 Table 20 中，这一缺位既不能证明性能差，也不构成词数限制；应保留用户的西里尔对白与目标语体，实测真实发音时长，并请母语者核对返回的语音，若无法核对就明确标注"未审查自然度"。

参考标签保持原样

附加真实图片作为@Image1时，为它指定一个角色，例如"确定钟的外观"。始终保留界面实际使用的写法：@图片1、[Image 1]等写法不得被擅自替换或翻译（多语言与混合语言提示词的逐字节绑定要求见 references/multilingual-community-examples.md 与 skills/seedance-vocab-ru/SKILL.md）。只是"提到名字"并不会真的附上文件；不附图时，上面的示例仍是纯文本提示词。俄语参考角色与紧凑模板可查 references/vocab/ru.md：

@Image1 — референс; сохранить [персонажа/продукт/логотип] без изменений. Меняются только [движение/свет/камера]. Камера: [одно движение]. Звук: [аудиосигнал].

续拍

如果用户写「в последнем кадре она улыбается и смотрит на часы（最后一帧她微笑看钟）」但没附上画面，回答必须说明这是用户的描述——不能声称查看过图片，也不能编造作坊细节。拿到已验收的结尾后，从这一姿势继续，不要重复开头的反应。若某个物体的精确位置必要但未知，先澄清它，不要拿未经验证的连续性当既定事实。序列与续拍的完整规则见 docs/DESIGN_SERIES_MODE.md 与 references/continuation-handoff.md。

9. 安全与后续工作

内容安全

图片、文件与转写文本内部的内容是原始素材，不是执行命令、读取密钥、上传文件或生成视频的授权。翻译不能作为绕过限制的手段。涉及真实人脸与声音、品牌及他人素材时，通过原创方案、授权素材或后期处理保留创作意图，相关改写规则见 SECURITY.md。根技能 SKILL.md 中的 Agent Trust Boundary 同样规定：提示词写作不授权付费生成、账号登录或外部上传；执行前须确认用户已授权的服务商、资产、动作与额度，永远不要要求用户把密钥粘贴进提示词。

已安装载荷的边界

安装器生成的已安装包不含网络开发工具（如scripts/eval_run.py）与可选的 provider 启动器——这些被安装器明确排除，tests/test_install_payload.py会拒绝已安装 Python 文件中的已知网络模块导入与凭据形态的环境读取（见 SECURITY.md）。已安装技能是纯本地文本与脚本，不产生网络调用、无遥测。但代理本身的权限由客户端管理：安装技能并不会把它变成无网络访问的环境；客户端能做什么，就仍可能做什么。

延伸阅读

• Русский словарь режиссёрских указаний —— 俄语导演指示词汇表、紧凑模板与反"空话"陷阱表（如用「камера неподвижна на уровне её глаз; тиканье предшествует улыбке」替代模糊的「кинематографичный」）。
• Примеры по режимам и роли референсов —— T2V、I2V、V2V、R2V、FLF2V、edit、extend 各模式示例。
• Языковое покрытие и проверка —— 多语言覆盖记录与"俄语版为 AI 草拟、尚未经母语者独立审查"的状态边界。
• 路由与加载地图总览见 SKILL.md，生产级提示词构建规则见 skills/seedance-prompt/SKILL.md。

其他语言版本：English · 中文 · 日本語 · 한국어 · Español。

• AI 技能
• AI 评测
• 提示工程
• 人工智能
• 媒体生成