blender-cli

基于所提供证据使用 Blender CLI

所有 Blender 专属的功能选择、API 标识符、枚举值、参数含义和工作流说明，都必须来自此技能的数据。**预训练的 Blender 知识不能作为有效证据。**可以使用常规语言理解、逻辑和 Python 组合来串联有依据的事实；不要用记忆中的行为填补 Blender 知识空白。用户需求提供的是期望输出和艺术选择，并不能证明某个 API 存在或具有某种行为。

首先了解上下文：可用的功能系列

在查询 API 数据库或起草 Blender 代码之前，请完整阅读功能概览。此层是纯 Markdown 和透明压缩的 JSON，无需 SQLite 即可查看。它列出了已编写的路径、所有源 API 页面卡片、状态以及选择方式。

用户的工作领域	目录域
场景、对象、集合和变换	scene
网格、BMesh 和修改器	geometry
几何节点、字段和实例	geometry-nodes
曲线、3D 文本、毛发、点云和体积	curves-volumes
雕刻、笔刷和绘制	sculpt-paint
UV 贴图、图像和纹理烘焙	uv
材质、着色器、纹理和世界	shading
灯光、摄像机和阴影	lights-shadows
渲染、通道、颜色和图像输出	render
合成、蒙版和图像处理	compositor
视频剪辑、标题和音频	video-audio
Grease Pencil、2D 笔画和 Freestyle	grease-pencil-freestyle
运动跟踪和影片剪辑	tracking
关键帧、驱动器、绑定和约束	animation-rigging
模拟、物理和缓存	simulation
文件、导入/导出、库和资源	files-assets
Python 集成、数学、GPU 和界面	integration-gpu
API 指南、枚举和源索引	api-guides

这些是导航类别，并不保证能在后台模式下执行。确切的功能说明位于关联源的卡片中。documented_route_runtime_unverified 表示源文档描述了一条路径；api_discovery_only 表示存在源页面，在声称某种行为之前必须先阅读。identifier_only 表示简介源文本没有描述足够的行为。不要把后两种状态转化为实现承诺。

证据工作流

1. 先发现，再查询。 阅读概览，然后阅读其中链接的相关领域文件。python3 scripts/features.py match "the user request" 会搜索提供的越南语／英语别名，不会打开 SQLite。使用 features.py show ID 阅读每个候选项；比较其 choose_when、证据摘录和缺口。出现相同关键词并不足以据此选定。若仍有多个有文档依据的路径都可能适用，请先澄清输出要求。
2. 明确处理未知事项。 如果没有适用的已编写路径，请使用 features.py pages DOMAIN 和 features.py symbols TEXT，发现数据库以外由源材料提供的名称／描述。仅将 api:... 页面卡片用作发现步骤。如果源材料不支持所请求的行为，请返回 insufficient_skill_evidence，并指出缺少的事实。不要凭记忆编造英文 Blender 术语、API、参数或操作方法。外部搜索不能作为默认的隐式后备方案：新材料必须连同来源信息纳入技能，然后才能作为任务证据。
3. 让选择过程可审查。 使用 features.py plan --request "..." --feature ID --output /absolute/path/plan.json 创建计划。组合任务时重复使用 --feature。计划中的初始 API 查询直接来自所选卡片，而非猜测的标识符。
4. 阅读 API 证据。 使用卡片的 next_queries，通过 docs.py read REF --plan /absolute/path/plan.json 阅读 API 证据。计划会记录实际源哈希和显示的行范围。继续翻页，直到所选相关段落完整。遵循阅读证据实际提供的链接，或在需要更多上下文时选择另一项有文档依据的功能／卡片。docs.py search／symbol 可用于细化此处所提供上下文中已出现的术语；绝不要把搜索结果或匹配的标识符当作行为依据。
5. 仅实现有依据支持的操作。 在计划的 bindings 中记录每项 Blender 操作的来源，以及该来源能够证明的内容；将缺失事实保留在 unresolved 中。只有类型／默认值的属性，仅能证明这一有限约定，不能证明未记录的渲染器效果。如果源材料没有明确说明，必须检查节点插槽标签、动态枚举和操作符上下文。不要在缺乏依据的情况下复用熟悉的操作方法来陈述 Blender 特有内容。准确的计划格式见 证据工作流。
6. 验证所选运行时。 遵循 CLI 工作流。捆绑的探测工具可以收集观测到的 RNA／版本数据，但不能补充缺失的概念性工作流语义。只有记录在案的运行时观测才算任务证据；此外，任何新用到的 Blender 事实仍必须根据这些观测和／或提供的源材料进行解释。如果相关内容仍未记录，就停止依赖该内容的操作。明确记录缺失的可执行文件或尚未解决的运行时事实。
7. 绑定、执行并验证。 evidence.py inspect 会列出待审查的操作；evidence.py seal 会验证已记录的读取／绑定，并绑定脚本哈希。run_blender.py --plan ... 会拒绝缺失或过期的计划、未解决的事实、未记录的引文和未覆盖的操作代码行。只有捆绑的探测工具例外。读取实际结果，重新打开重要的已保存数据，并检查视觉输出后再宣称成功。这些检查会确保可追溯性；但无法证明任意代码的语义，也无法证明模型的内部知识从未被激活。

命令

以下路径均相对于此已安装技能，而非用户的项目。主机辅助工具使用 Python 3.10+ 和标准库；API 查询还需要 SQLite FTS5。在其他位置工作时，请使用脚本的绝对路径。

python3 scripts/features.py overview
python3 scripts/features.py match "text strip shadow"
python3 scripts/features.py show FEATURE_ID
python3 scripts/features.py pages lights-shadows
python3 scripts/features.py plan --request "..." --feature FEATURE_ID --output /tmp/blender-plan.json
python3 scripts/docs.py read SOURCE_REF --plan /tmp/blender-plan.json
python3 scripts/evidence.py inspect --script /absolute/path/task.py
python3 scripts/evidence.py seal --plan /tmp/blender-plan.json --script /absolute/path/task.py
python3 scripts/run_blender.py --script /absolute/path/task.py --plan /tmp/blender-plan.json --timeout 900 -- --output /absolute/path/result.blend

请使用目录返回的真实 ID/引用。运行器不会安装 Blender、不会自动保存，也不会让未记录的操作变得有效。请勿使用原始 CLI、记忆中的代码片段、旧的前向测试示例或伪造的绑定来绕过此证据工作流。引用必须支持其关联的陈述；仅有有效哈希并不足够。

数据范围与维护

所提供的快照标明 API 5.2 和清单项目 Blender 5.2.1 LTS Python API。它不能证明已安装的版本。目录覆盖范围区分了编写的功能路由、所有源页面卡片和未解决的描述缺口。references/api/api.sqlite3 是 API 文本、锚点、链接、符号、搜索和覆盖范围元数据的打包事实来源；请参阅语料库指南。

索引参考资料经过专门打包，可供离线查阅证据。每项任务只读取选定的证据。目录由 SQLite 构建，而非来自嵌入或模型记忆。未打包原始 HTML/资源、Blender Manual、上游代码库和扩展页面。重建/更新说明见语料库指南；更新语义源内容会使先前的证据计划失效，并要求重新审查受影响的功能声明。