中文首页 · English · 日本語 · 한국어 · 更新日志
学习操作请先用程序内帮助页的 教程（F1）：零基础路线 19 课，Cubism 经验者路线 14 课。下列文档用于回看操作和查阅技术细节。中文为主要语言，标题链接到中文原文，「译文」列只列出已有的翻译。
For hands-on learning, open the Tutorials on the Help page (F1). Chinese is the primary documentation language: each title links to the Chinese page, and the Translations column lists the translations that exist. Every user guide, format reference and the MCP reference has an English version.
操作の習得にはヘルプページの チュートリアル（F1）を使ってください。主要言語は中国語です。タイトルは中国語版へのリンクで、「译文 · Translations」列に既存の翻訳を示します。
| 文档 | 内容 | 译文 · Translations |
|---|---|---|
| 更新日志 | 各版本中使用者能感知到的变化 | — |
| 操作速查 | 与程序内教程对应的文字版、常用快捷键、工作区与纹理工作区 | English · 日本語 |
| 画布编辑 | 模式菜单（物体 / 变形 / 编辑 / 模拟 / 骨骼 / 绘画 / 预览）、形变、网格拓扑、Glue、权重、绘画会话 | English |
| 素材与 Layout | 素材库、先摆放再生成、重新生成、语义标签 | English |
| 前后分层图文教程 | 衣领与脖子、头发与肩部装饰的前后遮挡，复制、黏合与橡皮擦修边 | English |
| 骨骼与姿态 | 骨架推断、绑定、IK、预设动作与烘焙结构 | English |
| 摇摆生成 | 左右 / 上下摇摆、画布手柄、摆锤与烘焙 | English |
| 物理 | 物理组来源、摆锤画布、输入输出、预置与导出 | English |
| 模拟与烘焙 | 布料 / 头发的 2D 模拟、顶点权重组、胶水角色，烘焙为参数、关键形与摆锤 | English |
| 模拟图文教程 | 从头发与服装预设开始，调整固定点权重、重新烘焙并检查导出效果 | English |
| 变形路径（实验性） | 路径的创建、绑定与导出方式 | English |
| 纹理高清化 | 本地 nunif 配置、参数与效果检查 | English |
开发中功能：内部造型生成器与编辑器入口 · English；按纹理结构重布点。
| 文档 | 内容 | 译文 · Translations |
|---|---|---|
| 开发与命令行 | 源码运行、CLI 参数、测试与打包、代码结构 | English · 日本語 |
| Cubism Native 预览 | 可选的官方 SDK 预览桥接构建与部署 | English · 日本語 |
| CI 与发行 | GitHub Actions 测试与含 SDK 的发行流程 | English |
| 文档 | 内容 | 译文 · Translations |
|---|---|---|
| PSD 素材与命名 | 分层要求、图层名称表、左右与差分 | English · 日本語 |
| 变形器与参数 | 自动生成的结构、坐标约定、默认参数 | English · 日本語 |
| 实现概览 | 流水线各阶段的实现与核心不变量 | English · 日本語 |
| 工程格式 v2 | .psd2live 归档布局、v1 迁移、保存与校验 |
English |
| Layout 清单 | 分层素材的 JSON / zip 交换格式：图片、矩形、上下顺序、组、标签、差分 | English |
| 导出目标 | 中立绑定 IR、各导出格式与损失报告、模块许可证 | English |
| 运行时 | Rust 运行时、.p2lrt 格式、网页播放器与 Godot 节点 |
English |
.p2lrt 2.0 格式 |
分块容器、核心层与扩展层、演进规则 | English |
| 文档 | 内容 | 译文 · Translations |
|---|---|---|
| MCP 使用与接口 | 接入方式、190 项公开操作、原子批量与试运行、调用示例、状态与历史 | English |
| Agent 设计与验收 | 分工边界、工具设计原则、任务验收步骤 | — |
| 能力实测 | 真实任务的实测记录与记录格式 | — |
面向本项目开发者的实现说明，仅有中文。Implementation notes for contributors, in Chinese only.
| 文档 | 内容 |
|---|---|
| 文档层 | 生成器依赖图、生成结果覆盖、缓存、逐层尺寸与拆分物化 |
| Rig 预设架构 | 部位、基础算法、模块与配方，部件角色：注册、成本、保存、升级、重放与扩展 |
| 模块与算法目录：面部 · 头发与身体 · 物理与动作 · 结构与表现 | 各插槽可注册的生成算法的设计：适用条件、产出结构、分步算法、可调数值与优先级 |
| 固化 Rig | 按修订保存的固化 Rig、检查点、再生成合并与实现进度 |
| 素材与 Layout 实现 | 生成视图与待生成图层、素材库存储、语义标签映射、操作表 |
| Layout 的 AI 辅助（设计中） | 对齐、抠图、补全 |
| 无窗口宿主 | 不依赖界面的应用层工作区宿主、桌面与无窗口适配、外部工具接入 |
| 运行时与导出边界 | 数据流、格式支持范围、交付检查 |
| 网格拓扑与图层拆分 | 自适应网格生成、填充算法、图层拆分 |
| 绘画系统 | 绘画会话、组件分工、坐标与提交 |
| 画布渲染器 | 编辑画布、纹理集页面与预览的渲染架构，播放与跟踪会话 |
- README 只写定位、上手、能力边界与入口；逐步操作以程序内交互教程为准。
- 描述须与源码一致：教程顺序对照
InteractiveTutorial.kt，快捷键对照ShortcutRegistry.kt，CLI 对照Main.kt，MCP 工具对照应用层操作注册（application/Workspace*Operations.kt、WorkspaceCommandDefinitions.kt）与AgentOperationTools.kt。界面文案对照src/main/resources/i18n/。 - 区分"已实现""实测通过""设计中"。能解析不等于能编辑，导出成功不等于视觉一致。
- 用户指南、格式参考与 MCP 参考至少有中英两版；内部实现说明只写中文。已有译文的页面同步结构与事实，不保留过时副本；索引只列出存在的译文，不为缺失的译文放占位链接。
- 保持文件路径稳定；修改时一并检查链接、图片与示例命令。截图位于
docs/imgs/，使用 WebP。