@aswless_854771076/ai_short_studio_cli 0.1.216 → 0.1.217
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +15 -0
- package/dist/commands/canvas/node/run.d.ts +1 -0
- package/dist/commands/canvas/node/run.js +1 -0
- package/dist/commands/canvas/previs/apply.d.ts +17 -0
- package/dist/commands/canvas/previs/apply.js +19 -0
- package/dist/commands/canvas/previs/compare.d.ts +17 -0
- package/dist/commands/canvas/previs/compare.js +19 -0
- package/dist/commands/canvas/previs/physics.d.ts +18 -0
- package/dist/commands/canvas/previs/physics.js +15 -0
- package/dist/commands/canvas/previs/read.d.ts +19 -0
- package/dist/commands/canvas/previs/read.js +16 -0
- package/dist/commands/canvas/previs/references.d.ts +17 -0
- package/dist/commands/canvas/previs/references.js +14 -0
- package/dist/commands/canvas/previs/upload.d.ts +23 -0
- package/dist/commands/canvas/previs/upload.js +46 -0
- package/dist/domain/vvicat-api.d.ts +9 -0
- package/dist/domain/vvicat-api.js +33 -0
- package/package.json +1 -1
- package/skills/using-vvicat-ai-short-studio-cli/SKILL.md +1 -0
- package/skills/using-vvicat-ai-short-studio-cli/references/canvas-previs.md +190 -0
package/README.md
CHANGED
|
@@ -48,6 +48,7 @@ CLI 只把 refresh token 保存到系统钥匙串。短期 access token 会写
|
|
|
48
48
|
- `ai-short-studio canvas continuity analyze`:视频生成前分析镜头依赖,可修复已具备源视频的首尾帧连线。
|
|
49
49
|
- `ai-short-studio canvas asset`:资产列表、上传、版本选择和下载。
|
|
50
50
|
- `ai-short-studio canvas documents`:一次读取当前分集的 自由画布文档、选版和阻塞原因;`canvas document get|save|status` 读取、保存或检查单个文档。
|
|
51
|
+
- `ai-short-studio canvas previs read <nodeId> --project <projectId>`:读取预演场景与 `base`;`canvas previs apply <nodeId> --project <projectId> --file edit.json` 提交 `{ "base": <读取结果的 base>, "actions": [...] }`,或用 `restoreVersionId` 代替 `actions` 恢复历史。所有写入都追加版本;409 后重新读取并审阅,不自动换基线重试。执行帧图和视频仍使用 `canvas node execute`。`canvas previs upload <nodeId> <imageFile> --base base.json` 上传并绑定最多 16 MiB 的 PNG/JPEG/WebP 参考图;当前仅存档,绑定素材的场景暂不能渲染。
|
|
51
52
|
- `ai-short-studio canvas workflow status`:读取当前阶段、基础模块门禁和下一步缺失项。
|
|
52
53
|
- `ai-short-studio canvas asset review-context|review`:读取当前媒体摘要和必需维度,提交实际逐项审核并追加独立审核文档;不自动生成通过结论。
|
|
53
54
|
- `ai-short-studio canvas folder`:画布资产目录管理(5 预设 + 用户子目录 + 软删 + 跨项目复制)。
|
|
@@ -257,3 +258,17 @@ Read `canvas asset reuse-context` before submitting `canvas asset reuse`. The co
|
|
|
257
258
|
人工完整审看后,可加 `--approve-only` 单独保存验收声明,把返回的 `approvalAssetId` / `approvalVersionId` 交给内置助手继续。内置工具仅接受该引用,不能自行填写人审结论;声明不改变视频选版。
|
|
258
259
|
|
|
259
260
|
After a human completes playback and review, use `--approve-only` to save a separate declaration without selecting a video version. Pass the returned approval references to the built-in assistant; its reuse tool accepts references rather than model-authored review or playback claims. A changed source or deleted declaration requires a fresh review.
|
|
261
|
+
|
|
262
|
+
动作编译 / Motion compilation: `previs-motion` 接收正式场景版本,使用现有节点配置、连线与 execute 命令提交;`canvas previs read <nodeId> --project <projectId> --motion --json` 读取完整 QA 和版本有效性。QA 失败会保留,available 不等于审核通过。Motion playback and rendering remain unavailable.
|
|
263
|
+
|
|
264
|
+
预演导出 / Previs export: 创建 `previs-export`,连接 scene 和可选 motion,在 config.previs 配置 sceneId、formats(project/otio/usd-camera/media/frame-pack)及可选 shotIds,然后显式 execute。`canvas previs read <nodeId> --project <projectId> --export --json` 返回正式 ZIP/JSON 文件版本和短期链接。包保留素材版本引用,不内嵌模型,恢复需要原平台素材权限。The export node emits a ZIP archive and JSON manifest with exact version references; assets are not embedded and restoring requires access to the original platform assets.
|
|
265
|
+
|
|
266
|
+
雕刻轮廓比较 / Sculpt silhouette comparison: `canvas previs compare <nodeId> --project <projectId> --file compare.json --json` 显式提交 `{base,sceneId,objectId,references,options?}`,只接受已绑定的精确参考版本,支持自动角度、多视图加权和候选排名;不应用候选。输出只读报告及 PNG 对照图数据。The native approximation scores silhouettes, not boolean holes, material accuracy, identity or approval. See the bundled canvas-previs reference for parameter limits and assistant support.
|
|
267
|
+
|
|
268
|
+
OBJ/GLB/FBX props can be uploaded with `canvas previs upload <nodeId> <file.obj> --project <projectId> --base base.json --scene <sceneId> --object <objectId>` (32 MiB maximum). Use a `.glb` or `.fbx` file with the same command for GLB or untextured binary/ASCII FBX props (ASCII versions 7000–7700). Prop FBX uses `--object`; character FBX keeps its separate model/character flags. The command creates a new mesh or replaces an existing mesh source, preserving scene transforms and source history. Read the latest full base and save drafts first. Character flags cannot be combined with `--object`. OBJ/GLB/FBX preview and frame/video rendering use exact source versions; GLB supports bounded embedded PNG/JPEG/WebP textures and rejects external URIs, unsupported compression and unknown required extensions. Separate glTF resources, AVIF/data URIs, external MTL/textures and textured FBX are not integrated. Native character FBX still requires binary encoding.
|
|
269
|
+
|
|
270
|
+
逐帧物理读取 / Physics frame inspection: `canvas previs physics <motionNodeId> --project <projectId> --motion-version <receipt.versionId> --frame <zeroBasedFrame> --json` reads frozen compiled COM, support, the current ballistic-fit point and up to 24 spring-tip frames. It does not create versions, render or approve media. Read the current motion receipt first; stale versions and concurrent edits return 409. Coordinates stay in compiled world metres, and display placement does not recompute dynamics. Attached-solid collision QA remains in `qa.attachments`; path support is outside this diagnostic scope.
|
|
271
|
+
|
|
272
|
+
预演环境贴图:`ai-short-studio canvas previs upload <nodeId> sky.hdr --project <projectId> --base base.json --hdr --scene <sceneId> --json`;支持 HDR/EXR/PNG/JPEG,最大32 MiB及16,777,216像素。上传保存正式素材与场景版本并选中环境,仍须显式执行节点渲染。内置助手可读取并选择已有绑定,暂不能上传本地文件。
|
|
273
|
+
|
|
274
|
+
显式预演抠图 / Previs matte: `canvas previs apply <nodeId> --project <projectId> --file matte.json --json` accepts `{base,matte:{sceneId,objectId,selection:"auto"|"saved",options:{...}}}`. Keep the read base, save drafts first, and use existing cutout sources. This appends immutable image/mask/scene versions; it does not render or approve media.
|
|
@@ -5,6 +5,7 @@ function submittedTaskId(result) {
|
|
|
5
5
|
return result.task?.taskId || result.task?.id;
|
|
6
6
|
}
|
|
7
7
|
export default class CanvasNodeRun extends BaseCommand {
|
|
8
|
+
static description = '提交画布节点任务,可等待正式结果。预演帧图和视频遵循 executionLocation:CLI 的 auto 使用后台;显式 client 需由本人打开本项目画布领取并在客户端渲染、编码,失败不会转后台。';
|
|
8
9
|
static args = { nodeId: Args.string({ required: false }) };
|
|
9
10
|
static flags = {
|
|
10
11
|
...BaseCommand.baseFlags,
|
|
@@ -0,0 +1,17 @@
|
|
|
1
|
+
import { BaseCommand } from '../../../base-command.js';
|
|
2
|
+
export default class CanvasPrevisApply extends BaseCommand {
|
|
3
|
+
static description: string;
|
|
4
|
+
static args: {
|
|
5
|
+
nodeId: import("@oclif/core/interfaces").Arg<string, Record<string, unknown>>;
|
|
6
|
+
};
|
|
7
|
+
static flags: {
|
|
8
|
+
project: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
|
|
9
|
+
file: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
|
|
10
|
+
'base-url': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
|
|
11
|
+
json: import("@oclif/core/interfaces").BooleanFlag<boolean>;
|
|
12
|
+
locale: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
|
|
13
|
+
profile: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
|
|
14
|
+
episode: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
|
|
15
|
+
};
|
|
16
|
+
run(): Promise<void>;
|
|
17
|
+
}
|
|
@@ -0,0 +1,19 @@
|
|
|
1
|
+
import { Args, Flags } from '@oclif/core';
|
|
2
|
+
import { BaseCommand } from '../../../base-command.js';
|
|
3
|
+
import { commandApi, projectFlag, readJsonInput } from '../../../command-helpers.js';
|
|
4
|
+
export default class CanvasPrevisApply extends BaseCommand {
|
|
5
|
+
static description = '提交预演结构化操作、显式抠图或历史恢复;JSON 必须携带 read 返回的 base,409 后重新读取并审阅';
|
|
6
|
+
static args = { nodeId: Args.string({ required: true }) };
|
|
7
|
+
static flags = {
|
|
8
|
+
...BaseCommand.baseFlags,
|
|
9
|
+
project: projectFlag,
|
|
10
|
+
file: Flags.string({ description: '包含 base 和 actions、matte 或 restoreVersionId 的 JSON;省略时读取 stdin' }),
|
|
11
|
+
};
|
|
12
|
+
async run() {
|
|
13
|
+
const { args, flags } = await this.parse(CanvasPrevisApply);
|
|
14
|
+
const input = await readJsonInput(flags.file);
|
|
15
|
+
const { api } = await commandApi(flags);
|
|
16
|
+
// 不重读或替换用户审阅过的基线,避免把旧操作静默应用到新场景。
|
|
17
|
+
this.print(await api.previsApply(flags.project, args.nodeId, input));
|
|
18
|
+
}
|
|
19
|
+
}
|
|
@@ -0,0 +1,17 @@
|
|
|
1
|
+
import { BaseCommand } from '../../../base-command.js';
|
|
2
|
+
export default class CanvasPrevisCompare extends BaseCommand {
|
|
3
|
+
static description: string;
|
|
4
|
+
static args: {
|
|
5
|
+
nodeId: import("@oclif/core/interfaces").Arg<string, Record<string, unknown>>;
|
|
6
|
+
};
|
|
7
|
+
static flags: {
|
|
8
|
+
project: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
|
|
9
|
+
file: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
|
|
10
|
+
'base-url': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
|
|
11
|
+
json: import("@oclif/core/interfaces").BooleanFlag<boolean>;
|
|
12
|
+
locale: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
|
|
13
|
+
profile: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
|
|
14
|
+
episode: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
|
|
15
|
+
};
|
|
16
|
+
run(): Promise<void>;
|
|
17
|
+
}
|
|
@@ -0,0 +1,19 @@
|
|
|
1
|
+
import { Args, Flags } from '@oclif/core';
|
|
2
|
+
import { BaseCommand } from '../../../base-command.js';
|
|
3
|
+
import { commandApi, projectFlag, readJsonInput } from '../../../command-helpers.js';
|
|
4
|
+
export default class CanvasPrevisCompare extends BaseCommand {
|
|
5
|
+
static description = '只读比较雕刻与绑定参考图;JSON 携带 base、sceneId、objectId、references 和可选 options';
|
|
6
|
+
static args = { nodeId: Args.string({ required: true }) };
|
|
7
|
+
static flags = {
|
|
8
|
+
...BaseCommand.baseFlags,
|
|
9
|
+
project: projectFlag,
|
|
10
|
+
file: Flags.string({ description: '包含比较请求的 JSON;省略时读取 stdin' }),
|
|
11
|
+
};
|
|
12
|
+
async run() {
|
|
13
|
+
const { args, flags } = await this.parse(CanvasPrevisCompare);
|
|
14
|
+
const input = await readJsonInput(flags.file);
|
|
15
|
+
const { api } = await commandApi(flags);
|
|
16
|
+
// 不自动更换用户指定的基线,避免报告来自另一版工程。
|
|
17
|
+
this.print(await api.previsCompare(flags.project, args.nodeId, input));
|
|
18
|
+
}
|
|
19
|
+
}
|
|
@@ -0,0 +1,18 @@
|
|
|
1
|
+
import { BaseCommand } from '../../../base-command.js';
|
|
2
|
+
export default class CanvasPrevisPhysics extends BaseCommand {
|
|
3
|
+
static description: string;
|
|
4
|
+
static args: {
|
|
5
|
+
nodeId: import("@oclif/core/interfaces").Arg<string, Record<string, unknown>>;
|
|
6
|
+
};
|
|
7
|
+
static flags: {
|
|
8
|
+
project: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
|
|
9
|
+
'motion-version': import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
|
|
10
|
+
frame: import("@oclif/core/interfaces").OptionFlag<number, import("@oclif/core/interfaces").CustomOptions>;
|
|
11
|
+
'base-url': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
|
|
12
|
+
json: import("@oclif/core/interfaces").BooleanFlag<boolean>;
|
|
13
|
+
locale: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
|
|
14
|
+
profile: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
|
|
15
|
+
episode: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
|
|
16
|
+
};
|
|
17
|
+
run(): Promise<void>;
|
|
18
|
+
}
|
|
@@ -0,0 +1,15 @@
|
|
|
1
|
+
import { Args, Flags } from '@oclif/core';
|
|
2
|
+
import { BaseCommand } from '../../../base-command.js';
|
|
3
|
+
import { commandApi, projectFlag } from '../../../command-helpers.js';
|
|
4
|
+
export default class CanvasPrevisPhysics extends BaseCommand {
|
|
5
|
+
static description = '只读检查明确动作版本的一帧重心、支撑、腾空拟合点和末端拖尾';
|
|
6
|
+
static args = { nodeId: Args.string({ required: true }) };
|
|
7
|
+
static flags = { ...BaseCommand.baseFlags, project: projectFlag,
|
|
8
|
+
'motion-version': Flags.string({ required: true, description: '正式动作回执的 versionId' }),
|
|
9
|
+
frame: Flags.integer({ required: true, min: 0, max: 19999, description: '从 0 开始的动作帧号' }) };
|
|
10
|
+
async run() {
|
|
11
|
+
const { args, flags } = await this.parse(CanvasPrevisPhysics);
|
|
12
|
+
const { api } = await commandApi(flags);
|
|
13
|
+
this.print(await api.previsPhysics(flags.project, args.nodeId, flags['motion-version'], flags.frame));
|
|
14
|
+
}
|
|
15
|
+
}
|
|
@@ -0,0 +1,19 @@
|
|
|
1
|
+
import { BaseCommand } from '../../../base-command.js';
|
|
2
|
+
export default class CanvasPrevisRead extends BaseCommand {
|
|
3
|
+
static description: string;
|
|
4
|
+
static args: {
|
|
5
|
+
nodeId: import("@oclif/core/interfaces").Arg<string, Record<string, unknown>>;
|
|
6
|
+
};
|
|
7
|
+
static flags: {
|
|
8
|
+
project: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
|
|
9
|
+
motion: import("@oclif/core/interfaces").BooleanFlag<boolean>;
|
|
10
|
+
qa: import("@oclif/core/interfaces").BooleanFlag<boolean>;
|
|
11
|
+
export: import("@oclif/core/interfaces").BooleanFlag<boolean>;
|
|
12
|
+
'base-url': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
|
|
13
|
+
json: import("@oclif/core/interfaces").BooleanFlag<boolean>;
|
|
14
|
+
locale: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
|
|
15
|
+
profile: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
|
|
16
|
+
episode: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
|
|
17
|
+
};
|
|
18
|
+
run(): Promise<void>;
|
|
19
|
+
}
|
|
@@ -0,0 +1,16 @@
|
|
|
1
|
+
import { Args, Flags } from '@oclif/core';
|
|
2
|
+
import { BaseCommand } from '../../../base-command.js';
|
|
3
|
+
import { commandApi, projectFlag } from '../../../command-helpers.js';
|
|
4
|
+
export default class CanvasPrevisRead extends BaseCommand {
|
|
5
|
+
static description = '读取预演场景、动作 QA 报告或正式导出文件链接';
|
|
6
|
+
static args = { nodeId: Args.string({ required: true }) };
|
|
7
|
+
static flags = { ...BaseCommand.baseFlags, project: projectFlag,
|
|
8
|
+
motion: Flags.boolean({ description: '读取动作节点的正式编译报告', default: false, exclusive: ['export', 'qa'] }),
|
|
9
|
+
qa: Flags.boolean({ description: '读取预演帧图、视频或导出的联合人物碰撞报告', default: false, exclusive: ['motion', 'export'] }),
|
|
10
|
+
export: Flags.boolean({ description: '读取导出节点的正式文件与短期下载链接', default: false, exclusive: ['motion', 'qa'] }) };
|
|
11
|
+
async run() {
|
|
12
|
+
const { args, flags } = await this.parse(CanvasPrevisRead);
|
|
13
|
+
const { api } = await commandApi(flags);
|
|
14
|
+
this.print(await (flags.qa ? api.previsQa(flags.project, args.nodeId) : flags.export ? api.previsExport(flags.project, args.nodeId) : flags.motion ? api.previsMotion(flags.project, args.nodeId) : api.previsRead(flags.project, args.nodeId)));
|
|
15
|
+
}
|
|
16
|
+
}
|
|
@@ -0,0 +1,17 @@
|
|
|
1
|
+
import { BaseCommand } from '../../../base-command.js';
|
|
2
|
+
export default class CanvasPrevisReferences extends BaseCommand {
|
|
3
|
+
static description: string;
|
|
4
|
+
static args: {
|
|
5
|
+
nodeId: import("@oclif/core/interfaces").Arg<string, Record<string, unknown>>;
|
|
6
|
+
};
|
|
7
|
+
static flags: {
|
|
8
|
+
project: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
|
|
9
|
+
'scene-version': import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
|
|
10
|
+
'base-url': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
|
|
11
|
+
json: import("@oclif/core/interfaces").BooleanFlag<boolean>;
|
|
12
|
+
locale: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
|
|
13
|
+
profile: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
|
|
14
|
+
episode: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
|
|
15
|
+
};
|
|
16
|
+
run(): Promise<void>;
|
|
17
|
+
}
|
|
@@ -0,0 +1,14 @@
|
|
|
1
|
+
import { Args, Flags } from '@oclif/core';
|
|
2
|
+
import { BaseCommand } from '../../../base-command.js';
|
|
3
|
+
import { commandApi, projectFlag } from '../../../command-helpers.js';
|
|
4
|
+
export default class CanvasPrevisReferences extends BaseCommand {
|
|
5
|
+
static description = '读取当前场景固定来源版本的参考图临时地址;不得将地址写回工程';
|
|
6
|
+
static args = { nodeId: Args.string({ required: true }) };
|
|
7
|
+
static flags = { ...BaseCommand.baseFlags, project: projectFlag,
|
|
8
|
+
'scene-version': Flags.string({ required: true, description: 'read 返回的 base.sceneVersionId' }) };
|
|
9
|
+
async run() {
|
|
10
|
+
const { args, flags } = await this.parse(CanvasPrevisReferences);
|
|
11
|
+
const { api } = await commandApi(flags);
|
|
12
|
+
this.print(await api.previsReferences(flags.project, args.nodeId, flags['scene-version']));
|
|
13
|
+
}
|
|
14
|
+
}
|
|
@@ -0,0 +1,23 @@
|
|
|
1
|
+
import { BaseCommand } from '../../../base-command.js';
|
|
2
|
+
export default class CanvasPrevisUpload extends BaseCommand {
|
|
3
|
+
static description: string;
|
|
4
|
+
static args: {
|
|
5
|
+
nodeId: import("@oclif/core/interfaces").Arg<string, Record<string, unknown>>;
|
|
6
|
+
file: import("@oclif/core/interfaces").Arg<string, Record<string, unknown>>;
|
|
7
|
+
};
|
|
8
|
+
static flags: {
|
|
9
|
+
project: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
|
|
10
|
+
base: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
|
|
11
|
+
hdr: import("@oclif/core/interfaces").BooleanFlag<boolean>;
|
|
12
|
+
model: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
|
|
13
|
+
scene: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
|
|
14
|
+
object: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
|
|
15
|
+
character: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
|
|
16
|
+
'base-url': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
|
|
17
|
+
json: import("@oclif/core/interfaces").BooleanFlag<boolean>;
|
|
18
|
+
locale: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
|
|
19
|
+
profile: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
|
|
20
|
+
episode: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
|
|
21
|
+
};
|
|
22
|
+
run(): Promise<void>;
|
|
23
|
+
}
|
|
@@ -0,0 +1,46 @@
|
|
|
1
|
+
import { basename, extname } from 'node:path';
|
|
2
|
+
import { readFile, stat } from 'node:fs/promises';
|
|
3
|
+
import { Args, Flags } from '@oclif/core';
|
|
4
|
+
import { BaseCommand } from '../../../base-command.js';
|
|
5
|
+
import { commandApi, projectFlag, readJsonInput } from '../../../command-helpers.js';
|
|
6
|
+
import { mimeTypeForUpload } from '../asset/upload.js';
|
|
7
|
+
export default class CanvasPrevisUpload extends BaseCommand {
|
|
8
|
+
static description = '上传参考图(16 MiB)、角色 FBX 或物体 OBJ/GLB/FBX 或环境 HDR/EXR/PNG/JPEG(32 MiB),保存正式来源版本和场景绑定';
|
|
9
|
+
static args = { nodeId: Args.string({ required: true }), file: Args.string({ required: true }) };
|
|
10
|
+
static flags = { ...BaseCommand.baseFlags, project: projectFlag,
|
|
11
|
+
base: Flags.string({ required: true, description: '保存 read 返回的完整 base 对象的 JSON 文件' }),
|
|
12
|
+
hdr: Flags.boolean({ description: '上传环境贴图并选中,须提供 --scene' }),
|
|
13
|
+
model: Flags.string({ options: ['x-bot-tpose', 'y-bot-tpose'], description: 'FBX 对应的原生角色骨架' }),
|
|
14
|
+
scene: Flags.string({ description: '模型或环境贴图的目标场景 ID' }),
|
|
15
|
+
object: Flags.string({ description: 'OBJ/GLB/FBX 物体 ID;不存在时创建,已是 mesh 时替换素材' }),
|
|
16
|
+
character: Flags.string({ description: '模型目标角色 ID' }) };
|
|
17
|
+
async run() {
|
|
18
|
+
const { args, flags } = await this.parse(CanvasPrevisUpload);
|
|
19
|
+
const hdr = flags.hdr;
|
|
20
|
+
if (hdr && (!flags.scene || flags.model || flags.character || flags.object))
|
|
21
|
+
throw new Error('环境贴图上传须提供 --hdr 和 --scene,不能混用模型目标');
|
|
22
|
+
const mesh = Boolean(flags.object);
|
|
23
|
+
if (mesh && (!flags.scene || flags.model || flags.character))
|
|
24
|
+
throw new Error('OBJ/GLB/FBX 上传须同时提供 --object 和 --scene,不能混用角色参数');
|
|
25
|
+
const model = !hdr && !mesh && Boolean(flags.model || flags.scene || flags.character);
|
|
26
|
+
if (model && (!flags.model || !flags.scene || !flags.character))
|
|
27
|
+
throw new Error('上传角色模型必须同时提供 --model、--scene 和 --character');
|
|
28
|
+
const extension = extname(args.file).toLowerCase();
|
|
29
|
+
const info = await stat(args.file), type = hdr ? ({ '.hdr': 'image/vnd.radiance', '.exr': 'image/x-exr', '.png': 'image/png', '.jpg': 'image/jpeg', '.jpeg': 'image/jpeg' }[extension] ?? '') : mesh ? (extension === '.glb' ? 'model/gltf-binary' : extension === '.fbx' ? 'model/fbx' : 'model/obj') : model ? 'application/vnd.vvicat.previs-fbx' : mimeTypeForUpload(args.file);
|
|
30
|
+
if (!info.isFile() || !info.size || info.size > (hdr || model || mesh ? 32 : 16) * 1024 * 1024
|
|
31
|
+
|| (hdr ? !['.hdr', '.exr', '.png', '.jpg', '.jpeg'].includes(extension) : mesh ? !['.obj', '.glb', '.fbx'].includes(extension) : model ? extname(args.file).toLowerCase() !== '.fbx' : !['image/png', 'image/jpeg', 'image/webp'].includes(type))) {
|
|
32
|
+
throw new Error(hdr ? '环境贴图须为不超过 32 MiB 的 HDR/EXR/PNG/JPEG 文件' : mesh ? '物体模型须为不超过 32 MiB 的 OBJ/GLB/FBX 文件' : model ? '角色模型须为不超过 32 MiB 的 FBX 文件' : '参考图须为不超过 16 MiB 的 PNG/JPEG/WebP 文件');
|
|
33
|
+
}
|
|
34
|
+
const base = await readJsonInput(flags.base), form = new FormData();
|
|
35
|
+
form.set('base', JSON.stringify(base));
|
|
36
|
+
if (hdr)
|
|
37
|
+
form.set('hdrTarget', JSON.stringify({ sceneId: flags.scene, purpose: 'hdr' }));
|
|
38
|
+
if (model)
|
|
39
|
+
form.set('target', JSON.stringify({ sceneId: flags.scene, characterId: flags.character, model: flags.model }));
|
|
40
|
+
if (mesh)
|
|
41
|
+
form.set('meshTarget', JSON.stringify({ sceneId: flags.scene, objectId: flags.object }));
|
|
42
|
+
form.set('file', new Blob([await readFile(args.file)], { type }), basename(args.file));
|
|
43
|
+
const { api } = await commandApi(flags);
|
|
44
|
+
this.print(await api.previsUpload(flags.project, args.nodeId, form));
|
|
45
|
+
}
|
|
46
|
+
}
|
|
@@ -146,6 +146,15 @@ export declare class VvicatApi {
|
|
|
146
146
|
}): Promise<JsonObject>;
|
|
147
147
|
patchCanvas(projectId: string, input: JsonObject): Promise<JsonObject>;
|
|
148
148
|
updateStoryboardShot(projectId: string, nodeId: string, input: JsonObject): Promise<JsonObject>;
|
|
149
|
+
previsRead(projectId: string, nodeId: string): Promise<JsonObject>;
|
|
150
|
+
previsMotion(projectId: string, nodeId: string): Promise<JsonObject>;
|
|
151
|
+
previsQa(projectId: string, nodeId: string): Promise<JsonObject>;
|
|
152
|
+
previsPhysics(projectId: string, nodeId: string, motionVersionId: string, frame: number): Promise<JsonObject>;
|
|
153
|
+
previsExport(projectId: string, nodeId: string): Promise<JsonObject>;
|
|
154
|
+
previsApply(projectId: string, nodeId: string, input: JsonObject): Promise<JsonObject>;
|
|
155
|
+
previsCompare(projectId: string, nodeId: string, input: JsonObject): Promise<JsonObject>;
|
|
156
|
+
previsUpload(projectId: string, nodeId: string, form: FormData): Promise<JsonObject>;
|
|
157
|
+
previsReferences(projectId: string, nodeId: string, sceneVersionId: string): Promise<JsonObject>;
|
|
149
158
|
diagnoseNode(projectId: string, nodeId: string): Promise<JsonObject>;
|
|
150
159
|
storyboardDraft(projectId: string, nodeId: string, input?: JsonObject): Promise<JsonObject>;
|
|
151
160
|
storyboardRevision(projectId: string, nodeId: string, input?: JsonObject): Promise<JsonObject>;
|
|
@@ -262,6 +262,39 @@ export class VvicatApi {
|
|
|
262
262
|
method: 'PATCH', body: input,
|
|
263
263
|
});
|
|
264
264
|
}
|
|
265
|
+
previsRead(projectId, nodeId) {
|
|
266
|
+
return this.client.request(`/api/projects/${encodeURIComponent(projectId)}/canvas/nodes/${encodeURIComponent(nodeId)}/previs`);
|
|
267
|
+
}
|
|
268
|
+
previsMotion(projectId, nodeId) {
|
|
269
|
+
return this.client.request(`/api/projects/${encodeURIComponent(projectId)}/canvas/nodes/${encodeURIComponent(nodeId)}/previs/motion`);
|
|
270
|
+
}
|
|
271
|
+
previsQa(projectId, nodeId) {
|
|
272
|
+
return this.client.request(`/api/projects/${encodeURIComponent(projectId)}/canvas/nodes/${encodeURIComponent(nodeId)}/previs/qa`);
|
|
273
|
+
}
|
|
274
|
+
previsPhysics(projectId, nodeId, motionVersionId, frame) {
|
|
275
|
+
return this.client.request(`/api/projects/${encodeURIComponent(projectId)}/canvas/nodes/${encodeURIComponent(nodeId)}/previs/physics?motionVersionId=${encodeURIComponent(motionVersionId)}&frame=${frame}`);
|
|
276
|
+
}
|
|
277
|
+
previsExport(projectId, nodeId) {
|
|
278
|
+
return this.client.request(`/api/projects/${encodeURIComponent(projectId)}/canvas/nodes/${encodeURIComponent(nodeId)}/previs/export`);
|
|
279
|
+
}
|
|
280
|
+
previsApply(projectId, nodeId, input) {
|
|
281
|
+
return this.client.request(`/api/projects/${encodeURIComponent(projectId)}/canvas/nodes/${encodeURIComponent(nodeId)}/previs/actions`, {
|
|
282
|
+
method: 'POST', body: input,
|
|
283
|
+
});
|
|
284
|
+
}
|
|
285
|
+
previsCompare(projectId, nodeId, input) {
|
|
286
|
+
return this.client.request(`/api/projects/${encodeURIComponent(projectId)}/canvas/nodes/${encodeURIComponent(nodeId)}/previs/sculpt-compare`, {
|
|
287
|
+
method: 'POST', body: input,
|
|
288
|
+
});
|
|
289
|
+
}
|
|
290
|
+
previsUpload(projectId, nodeId, form) {
|
|
291
|
+
return this.client.request(`/api/projects/${encodeURIComponent(projectId)}/canvas/nodes/${encodeURIComponent(nodeId)}/previs/assets`, {
|
|
292
|
+
method: 'POST', body: form,
|
|
293
|
+
});
|
|
294
|
+
}
|
|
295
|
+
previsReferences(projectId, nodeId, sceneVersionId) {
|
|
296
|
+
return this.client.request(`/api/projects/${encodeURIComponent(projectId)}/canvas/nodes/${encodeURIComponent(nodeId)}/previs/assets?sceneVersionId=${encodeURIComponent(sceneVersionId)}`);
|
|
297
|
+
}
|
|
265
298
|
diagnoseNode(projectId, nodeId) {
|
|
266
299
|
return this.client.request(`/api/projects/${projectId}/canvas/nodes/${nodeId}/diagnose`);
|
|
267
300
|
}
|
package/package.json
CHANGED
|
@@ -16,6 +16,7 @@ description: Use when an agent needs to inspect or operate VVICAT infinite-canva
|
|
|
16
16
|
`SKILL.md` 只保留路由和主流程。按实际进度逐阶段读取命中的资料;长任务可以先后读取多份,但不要在开始时一次加载全部:
|
|
17
17
|
|
|
18
18
|
- 项目创建、settings、批处理、目录或安全边界:[references/project-and-canvas.md](references/project-and-canvas.md)
|
|
19
|
+
- 轻量 3D 预演场景读取、结构化编辑、显式渲染与工程导出:[references/canvas-previs.md](references/canvas-previs.md)
|
|
19
20
|
- 人物/场景/道具、拆镜、分镜图和生成前审计:[references/assets-and-storyboard.md](references/assets-and-storyboard.md)
|
|
20
21
|
- MiniMax H3 视频、原生音频、遮挡转场、单镜与成片验收:[references/h3-video-delivery.md](references/h3-video-delivery.md)
|
|
21
22
|
- 资产、分镜图、视频提示词和视频的滚动异步调度:[references/async-pipeline.md](references/async-pipeline.md)
|
|
@@ -0,0 +1,190 @@
|
|
|
1
|
+
# 轻量预演
|
|
2
|
+
|
|
3
|
+
深度图与法线图现在统一使用黑色空背景,排除 HDR 天空、渐变和主图底色;辅助通道渲染成功或失败后都会恢复原材质、背景和光晕可见性。正式后台渲染专项覆盖雕刻、内置 HDR、独立灯具和光晕,验证主图变化且辅助通道不受照明污染;验证范围为主机软件 Chromium,未替代 Alpine 或真实任务队列验收。
|
|
4
|
+
|
|
5
|
+
|
|
6
|
+
原生修复候选与提示补丁的评分已包含冻结场景中的附着体碰撞:使用同一世界变换和原生 `compareQa` 规则,附着诊断与原生诊断共同参与候选接受/拒绝判定;仍保留原生总严重度与问题组的取舍规则,不保证每项诊断单独下降。`compilation.repair.qaScope=native-and-frozen-scene-attachments`,`attachmentRepairCandidates=false` 表示目前复用原生候选,不生成移动附着点、解除附着或新的抓取约束补丁。附着诊断仍为只读 `qa.attachments`,只汇总一次;最终时间编辑后的 QA 仍另行重测,不宣称自动修复后处理或多人约束。
|
|
7
|
+
|
|
8
|
+
|
|
9
|
+
多动作帧图、视频和导出现在对全部冻结动作的最终时间线重测人物胶囊碰撞,报告为 `previs-motion-set-qa.v1`,`scope=person-capsules-only`、`fullMotionQaRechecked=false`、`autoRepair=false`。每个角色使用自己的正式编译规格及接触允许项,不修改源动作 QA。完整报告只保存于第一个正式输出版本,节点回执只保存汇总;任何来源选版变化使报告 `available=false`。网页输出节点提供报告入口;CLI 使用 `canvas previs read <nodeId> --project <projectId> --qa --json`,内置助手使用 `canvas_previs_read` 的 `mode=qa`。必须检查 `available`、逐角色 `uncheckedCharacterIds` 和问题组,不能把未测代理角色或人物胶囊通过当成完整动作 QA、联合求解或自动修复通过。该入口仅对实际生成联合报告的帧图、视频和导出节点有效;单动作使用原有 `--motion`/`mode=motion` 报告。任务总预算在骨骼采样前检查,超出时报 `PREVIS_PEOPLE_BUDGET_EXCEEDED`。
|
|
10
|
+
|
|
11
|
+
|
|
12
|
+
预演帧图/视频/导出节点的 motion 端口现允许连接最多16个不同角色的正式动作节点。所有动作必须来自同一冻结场景,统一24 fps且最终帧数一致;重复角色、重复来源、同一物体的多个驱动、错版或附件总量超过128 MiB明确拒绝。任务冻结并复核每个来源,任一来源换版使旧结果失效。人物骨骼、物体轨道、骨骼附着和镜头目标按同一合并时间线采样。导出按相同顺序保存全部引用及 motion-001/002 等报告和附件,原单动作文件名保持不变;导出总字节上限仍为64 MiB。媒体来源按完整动作版本组匹配,连线顺序可不同。物理预览仍只接受单动作;多人联合碰撞QA见上方最新说明,联合求解尚未完成。 使用现有节点创建/连线和执行入口;不把多个动作附件直接写入节点配置。
|
|
13
|
+
|
|
14
|
+
用 `canvas node types` 核对当前开放节点。创建和连线复用画布命令,不使用旧导演台。
|
|
15
|
+
|
|
16
|
+
`canvas previs read <nodeId> --project <projectId> --json` 返回场景和 `base`。把完整 base 原样写入操作文件,运行 `canvas previs apply <nodeId> --project <projectId> --file edit.json --json`。
|
|
17
|
+
|
|
18
|
+
文件结构为 `{ "base": { "canvasVersion": 1, "nodeVersion": 0, "sceneVersionId": null }, "actions": [{ "type": "project.rename", "name": "预演" }] }`。示例版本必须替换成实际读取结果。历史恢复用 `restoreVersionId` 替代 actions。共享服务严格拒绝未知操作、字段和任意脚本;409 后重读并审阅,不自动换基线重试。
|
|
19
|
+
|
|
20
|
+
保存追加不可变版本并使下游过期,不自动渲染。帧图和视频执行复用 `canvas node execute`;只使用实际生成的输出角色,不把首尾帧和辅助通道混为第一张图。预演不自动成为身份依据或审核通过记录。
|
|
21
|
+
|
|
22
|
+
`canvas previs upload <nodeId> <imageFile> --project <projectId> --base base.json` 上传 PNG/JPEG/WebP 参考图,最多 16 MiB,`base.json` 仅保存 read 返回的完整 base 对象。服务端重新解码为 PNG 并按正式字节计算内容哈希,素材资产、来源版本和场景绑定同事务保存。移除绑定提交 `asset.remove {assetId}`,assetId 是场景 assets 中的绑定 id;不删除历史素材。参考图用于存档和工程导出,不自动进入画面;仅存档的参考图不会阻止已适配场景渲染。模型和 HDR 需走各自的正式适配入口。
|
|
23
|
+
|
|
24
|
+
内置助手已吸收相同版本、冲突、角色及审核规则,使用 `canvas_previs_read`、`canvas_previs_apply` 和 `canvas_execute`。内置助手不能直接上传本地文件;动作编译及导出可通过对应节点的现有创建、配置、连线和执行入口完成。
|
|
25
|
+
|
|
26
|
+
导出创建 `previs-export`,将场景连到 scene、匹配的可选动作连到 motion。config.previs 为 `{sceneId,formats:["project"|"otio"|"usd-camera"|"media"|"frame-pack"],shotIds?:string[]}`,formats 至少一项且不重复。省略 shotIds 导出全部镜头;工程保留全部场景,筛选只影响 OTIO/USD。使用 `canvas node execute` 显式提交并等待成功,再用 `canvas previs read <nodeId> --project <projectId> --export --json` 取得 file(ZIP)和 manifest(JSON)的真实版本及短期下载链接;不能同时传 --motion。链接到期后重新读取,不写入工程。工程格式的 ZIP 包含全部正式绑定的原始素材文件、平台场景合同和原生 cclayproject;原生工程内嵌实际引用的物体模型、纹理和 HDR,保留来源版本及完整动作 QA。角色 FBX 原字节随包保存,但原生角色恢复仍需对应模型加载器,manifest.nativeWarnings 会明确标记。来源字节合计最多64 MiB,逐个核验权限、冻结版本和实际 SHA-256;不支持的绑定拒绝导出。骨骼根路径的 OTIO 布局须连接匹配动作,纯工程可保留未编译的路径意图;keys/follow/rail 相机使用正式共享采样;媒体和首尾帧包通过对应的 image、start-frame、end-frame、depth、normal、video、contact-sheet 输入接收正式预演帧图/视频节点的同名输出(可多连);不接受普通生图/视频节点或角色串接。media 保存原始媒体,frame-pack 为每个所选镜头生成原生帧包,clip 必须有准确起止帧,still 仅需起始帧并保留 hold。视频须覆盖完整所选镜头,辅助通道须采样镜头起始帧,分辨率须一致;缺端点、歧义角色、未消费输入及来源场景/动作不匹配均拒绝。绑定与实际字节 SHA-256 冻结到任务,来源节点编辑或换版后旧任务不能回写;缺少历史媒体哈希时需重新渲染,不猜测或补造哈希。帧包灰模只提供构图/运动参考,camera.json 标记 identityReference=false,prompt.txt 只是已写镜头备注,不是已通过模型门禁的最终提示词。助手已吸收配置、执行、版本和缺口规则,用 `canvas_previs_read {nodeId,mode:"export"}` 读取文件版本及大小;助手工具不提供下载链接或本地文件保存,不能照搬 CLI 参数。
|
|
27
|
+
|
|
28
|
+
动作编译:创建 `previs-motion`,将已保存场景的 `scene` 输出连到动作节点 `scene` 输入。节点 `config.previs` 使用类型目录返回的 schema,指定 sceneId、characterId、model(x-bot-tpose/y-bot-tpose)和原生 24 fps spec,可选 repair、probes 和 bake(yaw 单位为度)。调用现有 `canvas node execute` 显式编译;保存配置不会执行。`canvas previs read <motionNodeId> --project <projectId> --motion --json` 返回正式报告、完整 QA、available 和 capabilities。available 只表示版本有效,QA 失败不变成通过,报告不代表素材已审核。场景换版后应重新编译;网页动作节点可显式打开有效版本的编译动作播放,提供 24 fps 播放、暂停和跳帧;播放不提交任务。
|
|
29
|
+
|
|
30
|
+
|
|
31
|
+
角色模型上传:`canvas previs upload <nodeId> <model.fbx> --project <projectId> --base base.json --scene <sceneId> --character <characterId> --model x-bot-tpose`,也可显式指定 y-bot-tpose。目标角色须已保存在场景中,三个绑定参数必须同时提供;二进制 FBX 上限 32 MiB。仅上传有权使用的素材,不自动下载或随平台分发第三方模型。服务端隔离进程校验文件结构、解压预算、蒙皮与固定骨架,拒绝贴图和外链资源;通过后原子创建 FILE 来源版本、更新角色型号并保存场景。替换绑定保留历史来源。已有模型绑定时,不能通过 character.update 把型号改为另一个骨架,须上传替换模型或先显式移除旧绑定。原生角色的静态姿态已可走正式帧图/视频节点后台渲染:任务按场景绑定的固定来源版本读取模型,核验权限与实际字节哈希,经隔离进程送入软件 Chromium;素材当前选版不影响冻结来源。仅支持当前已适配的原生 X/Y 灰模与姿态;网页已能从正式绑定加载静态角色;网页动作节点可显式打开有效版本的编译动作播放,提供 24 fps 播放、暂停和跳帧;播放不提交任务。
|
|
32
|
+
|
|
33
|
+
|
|
34
|
+
编译动作渲染:读取动作报告确认 available=true,并如实保留 QA;将同一已保存场景的 scene 输出接到帧图/视频节点的 scene 输入,将动作节点的 motion 输出接到它的可选 motion 输入,再显式执行渲染。一次最多一份编译动作,角色必须已有正式 X/Y 模型绑定。采样帧和视频结束帧必须小于动作 frameCount;不自动循环、裁剪或换用其他场景。任务冻结场景、动作及模型来源版本,任一来源换版或节点编辑后旧结果不能覆盖当前输出。QA 可失败,渲染成功也不表示已审核。
|
|
35
|
+
|
|
36
|
+
|
|
37
|
+
动作报告的 playback 能力表示网页可用的只读预览;CLI/助手没有图形播放工具,仍通过正式执行生成媒体供检查。预览会核验冻结场景、角色、模型和动作附件;过期版本或场景时间线不足会拒绝,不自动裁剪、换版或重新编译。新动作或场景选版生效后须重新读取 available,旧 QA 可以查看但不能作为当前输出。
|
|
38
|
+
|
|
39
|
+
|
|
40
|
+
原生角色静态 FK:用共享 `character.update {sceneId,characterId,patch:{pose}}` 写入姿态。pose 为 `{id,label,prompt,bones,rootY?}`;bones 键使用 hips/spine/chest/upperChest/neck/head、lShoulder/rShoulder、lArm/rArm、lForeArm/rForeArm、lHand/rHand、lUpLeg/rUpLeg、lLeg/rLeg、lFoot/rFoot,每个值为 XYZ 原生弧度三元组,rootY 为模型骨盆局部高度偏移(厘米)。代理角色不支持骨骼姿态。不要把网页显示的角度直接写成弧度,也不把静态姿态当成已编译动作。
|
|
41
|
+
|
|
42
|
+
项目姿态库使用 `pose-library.save {pose}` 按显式 ID 保存/更新,`pose-library.remove {poseId}` 删除;两者均不带 sceneId,仍使用完整 base 保存为新工程版本。读取 `scene.project.poseLibrary` 后复制完整姿态到目标角色即可应用;角色持有独立快照,库修改/删除不会改变已经摆好的角色。最多 500 条,不使用 localStorage 或 IndexedDB 作为正式来源。网页支持关节数值编辑、自然/绑定姿态、另存和删除;动作范围关键帧和姿态照片制作仍待适配。
|
|
43
|
+
|
|
44
|
+
|
|
45
|
+
静态 IK 使用 `character.solve-ik {sceneId,characterId,track,kind,target}`:track 为 leftHand/rightHand/leftFoot/rightFoot,kind 为 end(手腕/脚踝)或 mid(手肘/膝盖),target 为世界坐标米制 XYZ 三元组。只支持固定 X/Y 原生骨架,保留角色位移、朝向、比例、根高度及无关关节,结果存为静态 FK 姿态,可再保存到项目姿态库。原生求解器限制不可达目标;不自动避碰、贴地、审核或改写编译动作。操作同样需要读取后的三重基线,冲突须重新读取,渲染仍显式调用正式节点执行。
|
|
46
|
+
|
|
47
|
+
|
|
48
|
+
网页可显式启用「视口摆姿态」:四肢末端圆点、肘/膝方点沿当前相机平面拖动,方向键每次移动 5 厘米;松手生成一条相同的 character.solve-ik 操作。手势中临时预览不保存,Esc、指针取消或失焦恢复原姿态,单步撤销可回退整次手势。画面黑边不计入目标坐标,控件不写入导出的图像。附着角色暂不支持 IK;当前 still 镜头有 cast 覆盖时须显式选择镜头范围,基础范围不会覆盖它;此入口不修正编译动作。CLI/助手继续提交世界坐标操作,没有鼠标手势工具。
|
|
49
|
+
|
|
50
|
+
|
|
51
|
+
静帧镜头姿态:`shot-cast.update {sceneId,shotId,characterId,patch}` 只接受 x/z(米)、rot(度)、posture 和 pose;必须是存在的 still 镜头与场景角色。创建覆盖会补齐上游要求的 x/z/rot,保留其他人物、镜头、基础角色和已有部门字段。`patch:{pose:null}` 仅移除该镜头的姿态覆盖,继承基础姿态并保留位置;`shot-cast.remove {sceneId,shotId,characterId}` 清除该人物的整个镜头覆盖。`character.solve-ik` 可显式带 shotId,按该镜头覆盖后的位置求解并保存到该镜头;省略 shotId 始终编辑场景基础姿态,不根据当前播放头猜写入范围。网页数值和拖动共用该规则,基础姿态被当前镜头覆盖时会提示。镜头不存在、非 still 或附着角色的 IK 明确拒绝;所有写入仍走三重版本校验,旧动作结果随场景换版过期。
|
|
52
|
+
|
|
53
|
+
对象与角色分组已接入共享操作:`object.set-parent {sceneId,objectId,parentId}`、`character.set-parent {sceneId,characterId,parentId}`;parentId 为同场景对象 ID,null 回到根级。分组保留世界坐标,移动/旋转父级带动成员,缩放独立;隐藏父级会隐藏后代,删除父级将直属成员提升到根级并保留位置。网页父级选择、层级列表与撤销使用同一合同,循环、悬空父级及冲突附着明确拒绝;分组角色暂不支持静态 IK,需先解除分组。动作附着/碰撞约束仍未闭环。
|
|
54
|
+
|
|
55
|
+
物体路径使用 `object.set-path {sceneId,objectId,path}`,path:null 清除路径但保留基础变换。path.points 为 2~64 个世界坐标米制 {x,y,z},x/z 在 ±240、y 在 0~60;speed=0 铺满场景时间线,正速度为 0.01~50 米/秒,faceTravel/loop/extend 控制朝向、循环及终点延伸。可传最多 6 个递增 marks(t 弧长比例,端点间距至少 0.03,bank/pitch 为 ±90 度)及 timing(递增 cuts[{t,d}]、每段非负 envelopes)。白名单校验后复用原生 Catmull-Rom、弧长及速度归一化;不接受脚本和未知字段。网页数值编辑点位和开关,高级区编辑 marks/timing,应用到草稿后再保存。基础位置平移会连同路径一起移动,分组成员随原生刚体矩阵运动,编译物体轨道优先;不会自动渲染、避碰或生成动作。附着物体须先解除附着;人物根路径见下述路径点合同;命名抓取插槽见下述合同;附着感知自动修复仍待接入。
|
|
56
|
+
|
|
57
|
+
人物根路径通过 `character-waypoint.set {sceneId,characterId,waypoint:{id,frame,x,z,heading?}}` 按稳定 ID 创建/修改,remove 用 waypointId,clear 清空。layer.waypoints 最多32点,x/z 为米制±11,帧从1开始且小于场景总帧数、同帧唯一,24 fps;点间至少8帧、移动速度0.5~3米/秒,5厘米内可停留。代理角色继续使用原生路径插值并优先于 still 覆盖。X/Y骨骼角色保存路径点后不自动平移骨骼或生成步态,静态编辑预览不代表动作;请显式编写原生 standIdle/walkTo 等动作规格并执行 previs-motion,帧数必须覆盖全部路径点。编译 qa.rootPath 比较帧0和每个路径点的真实渲染骨骼根位置(容差0.1米)及显式 heading(容差10度);heading:null 不要求朝向。位置/朝向未满足会合并总 QA,原生 QA 不被覆盖,报告 scope=authored-waypoint-frames-only、autoRepair=false;不是连续轨迹拟合或自动修复。父组的运行时路径随原生携带矩阵作用于目标及动作,静态编辑父组仍保留世界路径点,不能拿旧动作当新版本。正式出图和 OTIO 布局须连接匹配动作;帧图/视频/导出可连接多角色动作,多角色骨骼路径缺动作会明确拒绝。纯工程导出保留路径意图,可不带动作。没有原生外部路径生成服务,不调用或下载第三方模型。
|
|
58
|
+
|
|
59
|
+
|
|
60
|
+
运镜共享操作:`camera-block.set {sceneId,shotId,camera}` 整体设置镜头的原生 Camera Block,mode 为 keys/follow/rail;保留镜头关键帧,切回 keys 可继续编辑。follow 默认跟随场景首位角色(原生 charA 语义),读取分组后的世界位置及编译动作髋部。followCam 支持 distance(0.5~15 米)、height(至少 0.2 米)、response(0.1~3 秒)、lead(0~1 秒)、railStartMode(head/nearest)、maxDollySpeed(0.2~40 米/秒)、pitchOffsetDeg(±170)、orbitOffsetDeg(±180)。rail 必须给 cameraRail 的 2~512 个非退化世界 x/z 点;railFollow 可省略/null(全镜头)、`{mode:"range",startFrame,endFrame}`(镜头内相对帧,24 fps,至少 10 帧)或 `{mode:"off"}`。轨道区间外、关闭或镜头不足 10 帧时使用保留的关键帧。craneHeight 为 `{points:[{t,height}]}`,2~8 个严格递增标记,t 从 0 到 1、高度至少 0.1 米;dollyTiming 使用 cuts/envelopes 的原生速度曲线结构。aim 可为 `{ids:[演员或物体ID],height?}`(最多四个且不重复)或 `{point:{x,y,z}}`;focalMm 为正毫米焦距。缺失目标、非法模式/范围/参数、退化轨道明确拒绝,不执行脚本。相机离线积分与网页、后台、OTIO/USD 和帧包共享;轨道准备限制 frameCount×(物体数+人数)不超过 2,000,000,超限须拆场景。网页有模式和跟随参数控件,高级轨道配置用 JSON;应用到草稿后仍需显式保存和执行,保存不触发渲染。CLI/助手走现有操作入口与三重基线,不需打开面板,也没有鼠标绘制轨道工具。
|
|
61
|
+
|
|
62
|
+
|
|
63
|
+
故事板/联系表:帧图和视频节点的 config.previs 支持 `contactSheet:{columns:1..6,shotIds?:string[]}`,省略 shotIds 选择全部镜头;最多 96 镜,按时间顺序冻结实际镜头 ID,以每镜起始帧采样。联系表每格 320×180,输出实际尺寸为 columns×320 和 ceil(镜头数/columns)×180,任一边不超过 8192;空列表、缺失/重复/越界镜头和超尺寸明确拒绝。可以只配置 `captures:[]` 与 contactSheet,不必额外生成 image。正式图片版本使用独立 `contact-sheet` 输出,不能把它当首帧/尾帧;连到预演导出的同名输入,配合 formats:["media"] 可保存原始联系表,不参与 frame-pack 端点选择。联系表包含名称、时长与镜头备注,格线、编号、文字和界面元素不得带入最终图片/视频;板型仍由项目 storyboard_strategy 决定,灰模不提供人物身份、不自动审核。
|
|
64
|
+
|
|
65
|
+
视频节点可显式配置 `animatic:true`:still 镜头在其原生区间内保持整个起始场景图(人物、背景物体和相机一起保持),clip 继续按 24 fps 采样;false/省略维持原有逐帧预演。必须有 video 区间,区间内不能有空白镜头;动作附件仍须满足正式帧范围,不循环或静默延长。标题/备注只进入联系表,视频没有板线和控件。网页提供联系表、列数、镜头 ID 与 animatic 配置;CLI/助手使用现有节点配置、canvas_execute 和正式版本读取,无鼠标编辑或本地下载能力。全部操作仍需先保存正式场景、冻结版本、显式执行;配置保存不启动渲染。
|
|
66
|
+
|
|
67
|
+
|
|
68
|
+
基础几何体材质通过共享 `object.update {sceneId,objectId,patch:{material,finish}}` 编辑,保存仍需三重基准版本。material 可选 clay、wood、straw、stone、brick、concrete、metal、glass、ceramic、plastic、rubber、fabric、paper、foliage;finish 可选 matte、satin、gloss。传 null 仅清除相应覆盖,未传字段保持原值;基础色仍由 patch.color 控制,默认灰采用原生材质底色。空组不接受材质,不把该能力用于代理角色或 FBX 蒙皮材质。纹理颗粒、玻璃厚度和反射由原生材质实现,渲染仍须显式执行。内置 HDR 另由 stage.update 设置;外部 HDR 使用正式素材绑定。
|
|
69
|
+
|
|
70
|
+
|
|
71
|
+
灯光通过同一 actions 入口编辑:`stage.apply-lighting {sceneId,preset,keep?}` 应用 studio、day、overcast、golden、dusk、night、interior、stage 八种原生预设;keep 可保留 keyLight.position/intensity/color,或 lighting.sky/skyTop/ambient/hemiSky/hemiGround/fill/fog/exposure/shadowSoftness/envLight/ao/hdr。保留 lighting.hdr 同时保留 HDR 选择、旋转、强度及背景开关,外部 HDR 还须有正式素材绑定。未保留的项目按原生预设重置。
|
|
72
|
+
|
|
73
|
+
局部修改使用 `stage.update {sceneId,patch:{keyLight:{x?,y?,z?,intensity?,warmth?,color?},lighting:{sky?,skyTop?,hemiSky?,hemiGround?,ambient?,fill?,fog?,exposure?,shadowSoftness?,envLight?,ao?,hdr?,hdrRotation?,hdrIntensity?,hdrBackground?}}}`;两个嵌套对象只合并已传字段,不整体覆盖其他设置。位置用米;x/z 为 -30..30,y 为 0.5..30;主光强度 0..4,暖度 0..1;ambient/fill 为 0..3,雾/阴影柔度/AO 为 0..1,曝光为 0.2..3,环境贴图光强为 0..2。颜色为 #rrggbb;keyLight.color 为 null 恢复暖度控制,sky 为 null 恢复默认背景,skyTop 为 null 关闭渐变,半球颜色不接受 null。程序化天空环境、渐变和 AO 共享前后台渲染,辅助深度/法线不经过 AO。内置 hdr 仅允许 builtin:night-street、builtin:overcast-field、builtin:studio-softbox,null 关闭;hdrRotation 为 -180..180 度(180 规范为 -180),hdrIntensity 为 0..4,hdrBackground 为布尔值。背景亮度由 hdrIntensity 控制,表面环境光由 hdrIntensity × envLight 控制;关闭背景仍保留环境照明。内置环境由固定源码程序生成,不下载模型或贴图。外部环境贴图使用已正式绑定的 hdr- 加32位哈希 ID;仅可选择当前工程 assets 中 purpose=hdr 的绑定,禁止 URL 或未上传 ID。支持 HDR/EXR/PNG/JPEG,最大32 MiB、16,777,216像素;解码宽度最多2048,原文件字节及来源版本固定,签名链接执行时生成。关闭 HDR 保留绑定,asset.remove 会清除引用它的场景选择;保存不自动渲染。
|
|
74
|
+
|
|
75
|
+
|
|
76
|
+
独立灯具通过 `object.add {sceneId,kind:"point-light"|"spot-light",placement?}` 创建,使用已有对象位置、旋转、隐藏、分组及路径操作。灯具没有几何体,不能设置材质。用 `object.update {sceneId,objectId,patch:{light:{type?,color?,intensity?,range?,angle?,softness?,shadow?,flicker?,aim?}}}` 局部修改;不向普通对象写入 light。type 为 point 或 spot,color 为 #rrggbb;intensity 0..1000,range 0..100 米(0 表示不限距离),angle 1..89 度为聚光半角,softness/flicker 0..1,shadow 为布尔值,aim 为世界坐标 `{x,y,z}` 或 null(恢复灯具自身下方向)。只有聚光灯使用 angle/softness/aim;切换类型保留已有数值。闪烁按对象 ID 和 24 fps 帧地址确定,不依赖播放历史。
|
|
77
|
+
|
|
78
|
+
最多两盏未隐藏的独立灯具投影,按工程对象顺序决定;其余仍照明,工程中 shadow 请求保持为 true,读取和保存回执的 warnings 用 SHADOW_CAP 列出受限灯具(附 sceneId/id/message,沿用上游每次最多四项)。网页同时显示完整受限列表。保存不自动渲染;自发光另用共享 glow 操作,见下文。辅助深度/法线不包含灯具标记,不随灯光强度或闪烁改变。
|
|
79
|
+
|
|
80
|
+
|
|
81
|
+
物体自发光通过 `object.update {sceneId,objectId,patch:{glow:{color?,intensity?,halo?}}}` 编辑。color 为 #rrggbb,intensity 为 0..20,halo 为 0..4;首次提供任一字段后,其余沿用原生默认值,后续局部合并;`glow:null` 关闭并恢复基础材质和投影。适用于基础几何体、空组及独立灯具,不写入 character。光晕大小随物体原生尺寸及缩放计算,空组/灯具使用原生点状半径。开启 glow 后物体不投影,光晕不写深度,不进入深度/法线;它只让自身发亮,不照明其他物体,需要照明时另加点光源或聚光灯。灯具上的 glow 随该灯的 24 fps 闪烁与动作 level 变化;其他物体随动作 level 变化。保存不自动渲染,不修改模型或提示词。
|
|
82
|
+
|
|
83
|
+
程序化雕刻使用共享 `sculpt.add {sceneId,name?,recipe,placement?}` 创建,已有雕刻用 `object.update {sceneId,objectId,patch:{recipe}}` 替换配方;普通对象不能写 recipe。recipe 遵守固定上游 v1 合同,含 parts、11 种形状、parent、mirror、颜色/渐变、材质、detail、scatter,以及子工具的 subtract/intersect。位置以米、旋转以度表示;完整配方必须通过共享校验,不接受脚本或未知参数。替换保留对象身份与外部变换,并重算占地尺寸。网页“程序化雕刻”页签与实体配方框使用同一操作,非法输入保留当前草稿和正式工程;撤销生成既有版本流程的新当前版本。布尔构建失败明确拒绝渲染,不静默跳过切割交付缺损参考。保存不自动编译或渲染。参考图比较与自动拟合尚未接入;助手无本地文件上传工具。
|
|
84
|
+
|
|
85
|
+
轮廓比较通过 `canvas previs compare <nodeId> --project <projectId> --file compare.json --json` 显式执行。JSON 为 `{base,sceneId,objectId,references:[{assetId,yaw?,weight?}],options?:{yaw?,elevation?,candidates?:[{label,edits}]}}`,base 必须来自最新 read;仅比较已保存的雕刻。references 使用工程已绑定的参考素材 ID,不能给 URL、data URL、任意媒体 ID 或本地路径;最多4图,多图每项必须给 yaw,单图省略 yaw 时沿用原生 -45..45 度寻角。yaw 为 -180..180,elevation 为 -60..60;weight 为0..1,未给时原生前/侧/后权重为0.6/0.25/0.15,比例偏离前视图35%以上的视图权重为0。最多12组候选,每组最多48项 `{set:id,...字段}`/`{add:part}`/`{remove:id}` 编辑,只排名不应用;拒绝的候选单独列出,sheetLabel 指明对照图使用的候选,report.iou 仍为当前配方得分。返回 base、authored:false、数值报告、轮廓测量和 PNG sheetDataUrl。轮廓为原生近似正交投影,不检查布尔孔洞、材质、身份或审核状态;不能用高 IoU 代替成片或模型 QA。灰色重合、红色缺失、蓝色多余。无主体、零有效权重、版本冲突明确报错,不自动换基准或应用赢家。计算在不携带主站凭据的可终止子进程中进行,60秒超时;保存不自动比较。网页实体面板使用同一入口;草稿未保存时不可比较。
|
|
86
|
+
|
|
87
|
+
|
|
88
|
+
OBJ/GLB/FBX 物体素材通过 `canvas previs upload <nodeId> <model-file> --project <projectId> --base base.json --scene <sceneId> --object <objectId>` 显式上传,限 32 MiB;不能混用角色参数。不存在的物体 ID 会创建 mesh,已有 mesh 会换源并保留位置、旋转、缩放和历史来源,其他类型不能覆盖。上传前保存草稿并读取最新完整 base,冲突不自动重试。正式场景 assets 的 meshTarget 保存 sceneId/objectId,物体 assetId 指向绑定 ID;平台场景合同不内嵌模型字节,project 导出包携带原始素材。OBJ/GLB/FBX 由受限子进程检查,GLB 内嵌 PNG/JPEG/WebP 在像素预算内解码;拒绝外部 URI、未知必要扩展与未支持压缩。OBJ 的 MTL 名称只作元数据,不下载材质或贴图。网页按需预览与帧图/视频节点共享对应格式的解析和原生拟合;后台只读取固定正式版本,权限、MIME、大小和实际哈希均须通过。删除物体同时移除当前绑定,历史来源保留。通用物体 FBX 使用 --object,与需要 --model/--character 的角色 FBX 合同分开,接受二进制 FBX 或 7000–7700 版本 ASCII FBX,支持有界内嵌 PNG/JPEG/WebP 图片(每张最多 1600 万像素、合计 3200 万像素、最多 128 张);保留原生 UV、采样与颜色空间,拒绝外部图片。角色 FBX 入口仍要求无纹理二进制。独立 glTF、GLB 的 AVIF/data URI、FBX 的其他图片格式和外部 MTL/纹理尚未接入,不伪造绑定代替上传。
|
|
89
|
+
|
|
90
|
+
已绑定 mesh 另支持 `object.update {sceneId,objectId,patch:{height,clay}}`:height 为正数米值,按原生规则同步缩放占地,clay 为布尔值;其他物体类型不接受这两个字段。网页提供同一高度和灰模控制,编辑不重下素材,仍须保存并显式执行渲染。
|
|
91
|
+
|
|
92
|
+
|
|
93
|
+
文字物体使用共享操作 `object.add {sceneId,kind:"text",text?:{value,size,depth,align}}` 创建;`object.update {sceneId,objectId,patch:{text:{...}}}` 局部编辑已有文字。value 最多 200 个字符、8 行且不能全空白;size 为 0.02–10 米,depth 为 0–2 米,align 为 left/center/right。尺寸由原生排版测量,不手写 footprint;文字面向本地 +z,底部为 y=0。depth 大于零且全部为可打印 ASCII 时使用立体字,包含中文或其他字符时按原生行为保留平面文字。变换、分组、物体路径、保存、撤销和显式帧图/视频执行沿用现有合同;保存不会自动渲染。网页提供文字类型与内容、字高、厚度、对齐面板;助手通过现有 canvas_previs_apply 操作,无需打开面板。文字不能写到其他物体,未知字段和超预算输入拒绝。字体来自固定上游版本并保留原授权;目标镜像的中文字体仍须实际验收。
|
|
94
|
+
|
|
95
|
+
|
|
96
|
+
粒子效果通过共享 `object.add {sceneId,kind:"effect",effect?:{preset,...}}` 创建,`object.update {sceneId,objectId,patch:{effect:{...}}}` 局部编辑;不能把 effect 写到其他物体。preset 为 smoke、exhale、steam、fire、sparks、dust、rain、snow、trail。更换预设采用原生默认值并保留种子,显式参数覆盖新默认值;wind/area 支持 x/y/z 局部修改。参数包括 rate(0–2000/秒)、life(0.05–12秒)、size(0.001–5米)、grow(0.05–20)、speed(0–60米/秒)、spread(0–1)、gravity(-30–30米/秒²)、opacity(0–1)、width(0–10米)、seed(0–2147483647整数)、color(#rrggbb)、additive(布尔)、wind(各轴-20–20米/秒)、area(各轴0–100米)。拖尾配合 object.set-path 使用。效果按24 fps和种子确定采样,发射后的粒子保持世界空间运动,发射器缩放不改变粒子米制尺寸。全场景最多显示2000粒子和512段拖尾,超限由原生模拟器均匀抽稀;显示上限不代表CPU耗时上限。效果不进入深度/法线,不照明其他物体,也不包含操作标记。网页属性面板支持这些参数;CLI和助手走现有apply入口,渲染仍显式执行。当前绑定角色骨骼的发射器和正式逐帧效果统计读取尚未接通,不得伪造这些结果;这里只能读取工程配置和正式渲染产物。
|
|
97
|
+
|
|
98
|
+
|
|
99
|
+
道具套件使用 `object.create-kit {sceneId,kit,name?,position?:{x,y,z,rot}}`;kit 仅接受 cigarette、lighter、exhale、bat、ball、sword、pistol。整组原生零件一次创建且可整批撤销;根对象是握持点,所有零件保持原生米制比例和父组。返回 `actionOutputs`,其中 rootId、parts、bind、props(若有)和 skill(若有)可用于后续动作配置;这些结果随同正式场景版本存档,不能猜测 ID。按既有 motion 节点合同显式配置和编译,创建/保存不会执行任务。燃烧、枪口闪光等 showOnlyInTake 零件及呼气套件静态不可见;真实角色/队列/目标容器验收尚未完成,不能仅凭创建回执宣称动作已成功。删除根节点按原生分组行为提升子对象,不级联删除整套道具。
|
|
100
|
+
|
|
101
|
+
|
|
102
|
+
套件动作配置已验证共享采样链路:创建 cigarette、lighter、exhale 后,使用回执的 rootId 分别填入原生 `spec.use` 的 `{skill:"smokeCigarette",f0:1,args:{kit:{cig,lighter,exhale}}}`。该技能前必须有姿态,例如 `{skill:"standIdle",f0:0,args:{at:[x,z],heading:角度}}`;完整示例采用 266 帧、24 fps。动作节点仍按正式场景版本显式编译,并把 motion 输出连到帧图/视频节点。握持与跟随使用编译物体轨道;纯显隐/亮度轨道不能覆盖父组运动,showOnlyInTake 只有通道驱动时显示。X/Y 骨架的数学采样及共享 WebGL 已验证,但合成测试骨架不代表真实角色皮肤、实际队列或生产容器验收;任意 object.attach 的编辑与逐帧跟随规则见下文。
|
|
103
|
+
|
|
104
|
+
固定吸烟示例在 X 骨架的原生 QA 通过,在 Y 骨架报告右前臂与躯干穿插(本基准 72 个逐帧问题、2 组 BODY);必须读取当前实际 QA、按报告修正后重编译,不得因已出图而标记通过,也不能把这个基准数字当作所有动作的固定结果。
|
|
105
|
+
|
|
106
|
+
|
|
107
|
+
骨骼附着:`object.set-attach {sceneId,objectId,attach,frame}` 使用同场景 X/Y 角色,`attach:{characterId,bone}` 或 null 解除;bone 使用原生 SCENE_ATTACH_BONES ID,null 为动画根部。frame 为场景内的整数帧,换骨骼与解除按该帧的场景姿态保持世界变换;此编辑操作不读取独立动作版本。附着后 object.update 的 XYZ 为局部米制坐标,允许负高度;分组子对象保留原生世界坐标语义,不自动跟随附着父物体。移除或替换角色前必须先解除所有附着。网页选择、CLI 与助手共用操作合同;静态/编译动作渲染和 OTIO blocking 导出共用逐帧骨骼采样。物体路径须先清除再附着;效果粒子已按出生帧骨骼位置采样,拖尾、显隐和亮度使用原生模拟,不积攒全视频帧;附着体的原生身体胶囊/OBB 碰撞已逐帧补测,抓取约束与自动修正仍待适配,不能把渲染跟随视为交互 QA 通过。合成 X/Y 骨架测试不替代真实模型、队列和目标容器验收。
|
|
108
|
+
|
|
109
|
+
|
|
110
|
+
附着碰撞补测:新编译报告的 `qa.attachments`(存在实体附着碰撞体时才有)使用最终动作逐帧采样,复用原生身体胶囊、物体 OBB 和允许穿透阈值。其问题合并到 qa.ok/total/problems/groups;不能因主动作已编译或渲染成功忽略新增 COLLIDE。支持原生 checks.allow 的 part/object/depth;自己的握持手与前臂允许贴合。报告列出 objectIds、characterIds、uncheckedCharacterIds 和 scope;代理角色不在这份胶囊补测范围,不能宣称全场景接触验证完成。补测不自动修正,抓取/接触约束仍由原生动作 spec 声明;同一物体不能同时由骨骼 attach 和独立运动轨道驱动,须先解除附着。历史报告没有 qa.attachments 不等于已通过新检查,必要时重编译。CLI 和助手均可通过现有 motion 读取入口查看完整报告,无需新增写入工具。
|
|
111
|
+
|
|
112
|
+
|
|
113
|
+
网页动作预览新增只读物理诊断:重心、支撑面、腾空轨迹和弹簧物体最近24帧末端拖尾。默认关闭,勾选后按需加载,不更改工程、撤销历史、任务、媒体版本或审核状态;关闭面板释放叠加层。测量保持冻结动作的原生编译坐标;叠加随角色位姿和缩放显示,不重新计算动力学。纯测量报告列出 excludedAttachedObjectIds 和 unmeasuredPathObjectIds;附着碰撞须另读 qa.attachments,路径支撑不在本诊断范围,普通导出任务不启用它,深度/法线始终排除诊断标记。诊断颜色和轨迹用于理解动作,不代表完整 QA 或已审核。完整 QA 仍通过 motion 读取。逐帧只读报告包含 frame、space=compiled-world-metres、placement(16项显示矩阵)、com、support、当前腾空段 arcs 的实测 point/拟合 fit 及 float/worst、弹簧 trails(最多最近24帧)和未测物体 ID 清单;不返回整段腾空数组,不创建版本、不触发渲染,也不批准素材。float/worst 描述整个腾空段,point/fit 只对应当前帧;placement 仅用于显示 com/support/arcs,trails 是物体世界轨道,不再套角色变换。帧号从0开始,必须小于动作帧数。换版/画布编辑返回409,重新读取正式回执后再决定是否检查新版本,不自动重试;取消不交付迟到结果。超出192 KiB报告预算会显式失败,不裁剪数据。没有远程开关浏览器叠加的工具,不能把原生 motion.physicsOverlay 当作正式编辑操作。 先用 `canvas previs read <motionNodeId> --motion --project <projectId> --json` 获取 receipt.versionId,再执行 `canvas previs physics <motionNodeId> --project <projectId> --motion-version <receipt.versionId> --frame <frame> --json`。
|
|
114
|
+
|
|
115
|
+
|
|
116
|
+
抓取插槽通过共享 `object.update {sceneId,objectId,patch:{grasp}}` 整表替换,`grasp:null` 清除。grasp 是1~8个命名插槽的对象,名称为1~32位字母、数字、下划线或连字符;每项 `{at:[x,y,z],axis?,from?,thumb?}`,at 是相对物体底部枢轴的米制坐标(各轴±10),可选方向为各轴±1000的非零向量并按原生规则归一化。非法字段、零方向或超限会拒绝保存,原工程不变。空对象不表示清除。分组自己的插槽与零件插槽保留原生名称空间,零件名为 `<objectId>.<socketName>`;局部插槽随物体运动。网页实体面板可编辑、替换、清除及撤销重做。
|
|
117
|
+
|
|
118
|
+
使用时在现有 previs-motion 的 config.previs.spec 定义 `anchors.grip={kind:"object",object:真实对象ID,grasp:"power",socket:"handle"}`、`fits:[{side:"l",anchor:"grip",effector:{joints:["LeftHand"]}}]`,关键帧 set 中显式开启 `w_grip_l:1` 和 `armw_l:1`;grasp 可选 power/pinch/hook/palm/spherical,side 为 l/r,骨骼使用 LeftHand/RightHand 等原生名称。可以用 checks.contacts 的 joint/anchor 引用和 when 检查接触;保留原生 CONTACT、抓取与修正 QA,缺失插槽明确报错。请根据实际物体位置和动作规格验证接触结果,不把示例直接视为成功握持。通过现有配置与执行工具显式编译,再读取完整 QA;保存插槽不自动执行抓取、附着、动作或渲染。场景骨骼附着体仍不能作为静态抓取目标;附着碰撞后验 QA 不自动修复。多动作联合QA与附着感知修复仍待接入。
|
|
119
|
+
|
|
120
|
+
|
|
121
|
+
动作裁切和变速保存到 previs-motion 的 `config.previs.timing={sourceFrameCount,segments:[{id,sourceStart,sourceEnd,speed}]}`。sourceFrameCount 取当前编译报告 `motion.compilation.timing.sourceFrameCount`,未编辑时取 `motion.frameCount`;不能根据场景总帧数猜测。sourceStart/sourceEnd 为闭区间源帧,speed 为0.1~4,ID唯一,最多128段;每段时长为 max(1,round((sourceEnd-sourceStart+1)/speed)),总编辑长度最多20000帧,所有源区间须在实际编译源内。字段严格校验,改规格导致源长度变化时须重新审阅剪辑。原生分段支持切分、删除、裁切、重排和重复源区间(各段仍需不同ID),不隐式补帧或调用生成模型。
|
|
122
|
+
|
|
123
|
+
例如48帧动作的 timing 为 `{sourceFrameCount:48,segments:[{id:"first",sourceStart:0,sourceEnd:23,speed:0.5},{id:"last",sourceStart:24,sourceEnd:47,speed:1}]}`,结果72帧。网页在动作配置中提供切分、分段速度、删除、闭区间裁切和恢复完整时间;这些按钮先改本地配置草稿,仍须保存动作配置并显式执行。速度按钮按原生0.1步长取整。CLI/助手使用现有节点配置写入和执行入口;没有新增 motion.cut 等命令或预演场景 action。工具包独立 timing 入口提供同一原生映射及编辑函数。恢复时移除 timing,或保存全范围1倍速段并执行;全范围恒等映射不额外保存剪辑状态。
|
|
124
|
+
|
|
125
|
+
正式附件保留完整未改写的原始骨骼/根位移/物体轨道和 edit 描述;统一解码入口按原生规则一次性采样编辑后数组。骨骼四元数按原生最短向归一化插值,位移/亮度线性插值,显隐/握持/世界标记取最近源帧。网页预览、CPU渲染、物理测量、OTIO布局和工程包消费同一结果,输出采样帧按编辑后时间线。元数据 frameCount 为编辑后长度,compilation.timing 保留源帧合同;元数据与附件的剪辑描述不符会拒绝,媒体附件仍受128MiB上限。
|
|
126
|
+
|
|
127
|
+
源编译、修正、接触、附着碰撞与根路径QA仍保留源时间线,存于 `qa.source`;使用剪辑后 `qa.frameSpace="mixed"`,汇总分组各自标记source或edited,`qa.timing` 同时返回源长度、编辑后长度、完整分段布局、`qaScope="source-compile-and-source-post-checks"` 和 `editedDynamicsRechecked=false`。不能把源QA帧号当成成片帧号,也不能把源QA通过当成变速后的动力学或审核通过。物理逐帧入口测量的是实际编辑后姿态;源编译 timeline/probes/observations 不自动改写为新的动作意图。时间编辑后的动作须覆盖渲染请求,并与场景正式版本匹配;扩长动作超过场景长度时应先调整场景时间线,再重编译,不自动扩工程。
|
|
128
|
+
|
|
129
|
+
动作区间 IK 使用动作节点 `config.previs.rangePins={frameCount,timing?,pins:[{id,track,startFrame,endFrame,blend,reach?,target}]}`;不是预演场景 action。frameCount 是最终编辑后的动作长度,timing 必须与同一配置中的时间映射精确一致(未编辑时省略);裁切或变速后不能沿用旧基准。track 为 leftHand/rightHand/leftFoot/rightFoot,闭区间帧号在最终动作内,blend 为1~240帧,reach 为 limb(默认)或 body(移动髋部并重新保持支撑脚)。target 为 `{space:"world",position:[x,y,z]}` 或 `{space:"object",objectId,local:[x,y,z]}`,坐标米制,物体目标沿冻结场景的完整世界变换采样;不支持目标直接附着在正在求解的角色上。ID唯一、最多32条、累计最多20000约束帧;共享拥有轨道的区间不得重叠,body 拥有髋部、双脚及所选末端。未知字段、缺失目标、错误基准明确拒绝。
|
|
130
|
+
|
|
131
|
+
网页区间面板可选择四肢/全身、帧段、过渡及世界目标,添加/移除/清空只改本地配置草稿;物体局部目标可用完整 JSON 配置。保存后显式执行动作编译。CLI/内置助手使用已有节点配置写入和 canvas_execute,没有新增 mouse、motion.pin 或 scene action。删除 rangePins 并重新编译恢复原始动作。编译在可终止子进程完成,正式附件保留源数组、时间映射与 `ikBake` 最终骨骼/髋部及逐帧残差;统一解码先应用时间映射,再一次性使用修正数组,重复烘焙回存及元数据不匹配被拒绝。网页、后台渲染和工程导出读取同一附件。
|
|
132
|
+
|
|
133
|
+
`qa.rangePins` 以最终编辑帧测量每条目标误差,body 另含支撑脚误差;完整 Float32 残差在 `artifact.ikBake.residuals`,报告含最差帧、米制误差、1厘米容差和失败分组。后续约束改变先前结果时以最终姿态重新测量,不把中间求解结果当成最终QA。不可达目标不会伪装通过。源编译仍在修正前执行;修正后的接触/抓取补测范围见 qa.postEdit.contacts,完整动力学尚未闭环,`sourceChecksBeforeRangePins=true`、`fullMotionQaRechecked=false`;物体轨道仍是原始编译轨道,抓取跟随及完整避碰不能据此宣称完成或审核通过。其他角色目标使用冻结静态姿态,尚无多动作联合求解。
|
|
134
|
+
|
|
135
|
+
|
|
136
|
+
时间编辑或区间 IK 后新增 `qa.postEdit`:frameSpace="edited",frameCount 为最终帧数。collisions 按最终骨骼胶囊与实际场景 OBB 补测全部支持的碰撞体,包含附着、物体路径、分组和编译轨道;物体对至少有一方发生运动才计入,静态布景已有相交不重复归因。隐藏角色/父组和编辑后的显隐轨道参与筛选,checks.allow 保留;自身附着手/前臂允许贴合。原生编译 carry 依据技能展开后的主手合同及重采样后的 hold 标记,仅在实际握持帧豁免主手/前臂,compiledCarryHandExemptions="primary-hand-and-forearm-while-hold-flag";带 carryQa 附件的新编译结果 secondHandAndNearSupportExemptions=true:第二手只豁免 hand 胶囊,须有原生第二手诊断且达到0.5握持权重,或最终手掌位于道具盒内;前臂仍检查。原生抓取支撑归属被冻结,nearSupportFrames=3按源帧的抓放窗口映射到最终时间线;重复剪辑分别生效。旧附件缺 carryQa 时该字段为false并保守检测,不隐式补写;不据此自动修复。工作量按最终帧数×碰撞体数×(支持角色数×胶囊数+所有支持人物双脚探针数+2×运动记录数)估算,超过2,000,000时以 PREVIS_SCENE_COLLISION_BUDGET_EXCEEDED 拒绝,需拆分场景或动作。
|
|
137
|
+
|
|
138
|
+
postEdit.rootPath 在场景原定帧0及每个骨骼路径点检查最终髋部位置/朝向,沿用0.1米/10度容差,不随裁切、变速隐式移动路径合同。剪短后不存在的路径点记入 missingFrames 和 ROOT_PATH_MISSING_FRAME 失败,不采样夹紧到镜尾;frameContract="authored-scene-frames-no-implicit-remap"。源编译及源附着/路径报告完整保存在 qa.source(source 帧空间);汇总 qa.frameSpace="mixed",每个 qa.groups 条目单独标记 source 或 edited,不能统一用一个帧空间跳转。任一源检查、区间残差或最终补测失败都会令总 ok=false;计数包含各检查阶段,不能把源/最终重复问题相加理解为独立事件数。未编辑动作继续保持原报告格式。postEdit.fullMotionQaRechecked=false:完整最终 QA 尚未闭环;接触/抓取补测范围见 qa.postEdit.contacts,不能把补测通过当作审核通过。旧正式版本缺少 postEdit 时须显式重新编译取得新证据。
|
|
139
|
+
|
|
140
|
+
`qa.postEdit.body` 另按最终骨骼复用原生皮肤碰撞、手指活动范围/指间碰撞与双手重叠检查,失败进入总 QA。scope="native-skin-fingers-and-anatomy",坐标为编译单位骨架米制,scenePlacementRechecked=false;保留 checks.allow/limits,不复用源命中诊断。fullMotionQaRechecked=false,尚不包含抓取、手持道具、完整接触与动力学复验;不是自动修复或审核通过。
|
|
141
|
+
|
|
142
|
+
`qa.postEdit.kinematics` 按最终编辑帧复用原生 POP 突跳检查,并只在 checks.limits 明确声明时检查 speedCore/speedLimb(米/帧)、accCore/accLimb(米/帧²)及 knee(度)。scope="native-pop-speed-acceleration-knee",declaredLimits 返回实际启用的风格限值;速度未声明时不判超速。变速、拼接或区间 IK 后重新测量,失败合并总 QA,每组 frameSpace="edited";正式附件回读可重测同一结果。坐标为编译单位骨架,不测显示放缩或场景携带产生的速度;平衡/支撑/腾空由下述 postEdit.support 补测;接触/抓取另见 postEdit.contacts,其余完整动力学仍待验收,fullMotionQaRechecked=false,不能把部分检查通过当作完整动作验收。
|
|
143
|
+
|
|
144
|
+
`qa.postEdit.support` 以正式渲染的世界骨骼和场景盒子补测 GROUND(脚底穿过地面)、SLIDE(着地脚滑动)、FLOAT(不少于4帧腾空且缺少重力减速),并仅在 checks.limits.balance 显式声明时检查 BALANCE。scope="native-world-ground-slide-balance-float",coordinateSpace="rendered-world-metres",scenePlacementRechecked=true;实际角色缩放、父组/物体路径、编译物体轨道、显隐和脚底朝向参与测量,checks.supports 支持物按最终世界位置判定。自己的骨骼附着体及原生 carry/follow 物体排除为支撑,excludedObjectIds/candidateObjectIds 明确列出。
|
|
145
|
+
|
|
146
|
+
保持原生世界坐标脚滑语义,slideSpace="world-no-support-velocity-subtraction":不扣除支撑物水平速度,运动平台上的水平随动仍可能报告 SLIDE;不是相对平台的摩擦仿真。平衡距离/穿透/支撑阈值以世界米计,重力按24 fps计算。工作量按 最终帧数×(骨骼数+支持场景盒子数+1)×12 估算;超过2,000,000以 PREVIS_SUPPORT_BUDGET_EXCEEDED 拒绝,需拆分场景或片段。报告失败并入总 QA;fullMotionQaRechecked=false、autoRepair=false,接触/抓取补测另见 postEdit.contacts,完整场景接触与其余约束仍待验收,不能视为审核通过。
|
|
147
|
+
|
|
148
|
+
`qa.postEdit.contacts` 在时间编辑/区间 IK 后,以最终骨骼与冻结物体轨道复跑原生声明的 CONTACT、ORIENT、BELOW、CLEARANCE、APPEAR,以及抓握指尖/支撑、手腕与手持道具检查;失败进入总 QA。身体锚点使用最终髋部位置/朝向,重复剪辑逐段映射接触及握持区间;抓握开关和主手归属按最近源帧采样,数值通道插值。scope="native-declared-constraints-grasp-wrist-held-props-goals-load-and-keys",正式编译 coordinateSpace="rendered-world-metres"、scenePlacementRechecked=true,frozenObjectTracks=true。完整编译上下文仅保存在本地编译过程中,不进入 Worker 消息或正式附件;重测需要相同编译上下文与附件,不能只凭附件重建声明语义。超过逐帧骨骼/物体预算以 PREVIS_CONTACT_BUDGET_EXCEEDED 拒绝。源报告仍在 qa.source;fullMotionQaRechecked=false、autoRepair=false,附着感知修复、完整最终原生约束及多动作联合求解仍未完成,不代表审核通过。
|
|
149
|
+
|
|
150
|
+
附件 carryQa 只包含版本1、源帧数、携带物/抓放时刻/原生支撑ID及第二手离散状态(0无诊断、1低于0.5、2达到0.5);不包含闭包、密钥或完整逐帧诊断。第二手使用最近源帧,支撑窗口使用连续源时间,遵循原生端点保持的变速映射;不能简单将帧号乘速度倒数。非法版本、长度、状态及字段在附件解码时拒绝,PREVIS_CARRY_QA_CONTEXT_INVALID;旧附件仍可读取。该信息只用于碰撞豁免,不驱动动画、不授权素材、不改变审核状态;完整最终QA与附着感知修复仍待完成。
|
|
151
|
+
|
|
152
|
+
正式编译的 `qa.postEdit.contacts` 现以 coordinateSpace="rendered-world-metres"、scenePlacementRechecked=true 测量:与渲染共用骨骼和物体采样,角色放缩、父组/路径、编译物体轨道及实际显隐参与判定。world 锚点保持绝对位置;身体/骨骼/道具相对绑定随所属坐标系移动,物体锚点保留原编译选定的插槽,不重新求解道具以追随手部。CONTACT/ORIENT/BELOW/CLEARANCE/APPEAR、抓握与手持道具问题进入总QA;隐藏角色不生成可见接触问题。手腕仍使用原生局部关节角,wristCoordinateSpace="compiled-world-metres"。胶囊半径按最大世界轴放缩(capsuleScale="maximum-world-axis-conservative"),boxTransform="decomposed-world-obb";非均匀放缩/剪切仍是保守胶囊/OBB近似,不是三角网格碰撞。原生不等轴球体的盒子近似继续保留。完整重测需要相同本地编译上下文、最终附件和正式场景;纯运行时未传场景时仍只测编译坐标。预算同时计入骨骼、物体、分组、锚点、声明检查和fit数量,超限拒绝。正式生产的多动作联合QA、完整最终原生QA及自动修复仍未完成,不能把该报告当作审核通过。
|
|
153
|
+
|
|
154
|
+
`qa.postEdit.body` 的 scope 现为 native-skin-fingers-and-anatomy,anatomyChecks 列出 FACE/SELF/KNEE/ELBOW/FLIP/LENGTH:除皮肤、手指及双手重叠外,还检查膝反折/膝肘折叠极限、腿部相交、弯曲平面逐帧突翻和骨长漂移,失败合并总QA。仍按编译单位骨架测量,不能把角色显示放缩当成骨骼拉伸;骨长沿用原生整段最大漂移及帧0归因。正式世界 contacts 另检查手部/手持道具进入头部,头部椭球和探针半径随最大世界轴放缩,保留 checks.mouthPoints 对明确道具点的豁免。原生 generalChecks 在固定原文回放中逐条一致。fullMotionQaRechecked 仍为 false:最终求解目标/对象键残差、抓取与接球事件及多人约束仍需完成最终复验,不能因上述检查通过宣称完整动作QA已闭环。
|
|
155
|
+
|
|
156
|
+
最终场景碰撞报告 scope="native-body-capsules-feet-and-object-boxes",footCollisionsRechecked=true:除身体胶囊外,沿用原生拟合脚部皮肤探针(无拟合体时使用脚底探针),检测脚趾穿入台阶侧面。脚踩盒顶沿用 groundAllow,侧面沿用 allow,checks.allow 对 foot_l/foot_r 可单独覆盖;不豁免自身携带物与脚的碰撞。角色实际放缩影响探针,原生分组仍只传递刚性运动、不传递缩放。隐藏物体/角色和显隐轨道不生成可见碰撞问题;失败进入总QA,未启用自动修复。工作量预算增加所有支持人物的双脚探针总数,仍以 PREVIS_SCENE_COLLISION_BUDGET_EXCEEDED 拒绝超过2,000,000的估算。历史报告需重新编译,不自动改写。
|
|
157
|
+
|
|
158
|
+
最终动作目标在 qa.postEdit.contacts.goals 逐项返回 name/kind/ok/value/at/need,GOAL 失败进入总QA。near、above、moved、still、speed 沿用原生判定,物体表面/杯口与嘴部地标保持原生引用语义,嘴部偏移按完整世界变换取样。goalWindowSampling="source-interval-membership":源目标区间映射到每次出现的最终帧,重复片段分别测量,中间无关区间排除;goalEventSpace="edited-timeline":after/before 使用最终时间线的首次满足事件,点位移从事件切窗内首个实际目标帧起算。速度按最终24fps重测。目标区间完全被剪掉、引用无法测量或事件窗无可测结果时显式失败,不能静默当通过。目标区间被部分裁切时只测保留下来的映射帧,不声称被删掉的源帧仍满足。重测仍需要原编译上下文和正式附件,完整最终QA、多动作联合求解与自动修复仍待完成。
|
|
159
|
+
|
|
160
|
+
最终负载在 qa.postEdit.contacts.load 返回原生每手的 object/mass/maxNm/at/frames,LOAD 问题进入总QA。力矩按最终肩腕水平距离×质量×9.81计算,单手超过25 N·m且缺少原生第二手权重支持时失败;第二手锚点权重必须严格大于0.5,权重从源通道映射到每个最终帧。loadMassBasis="original-motion-spec-and-scene":质量仍取原生显式mass或源场景体积估算,人物显示放缩不会自动改写物体质量;世界肩腕距离包含实际人物放缩和路径。loadSecondHandBasis="native-declared-anchor-weight":这是原生声明权重规则,不是新的接触力求解或已验证第二手实际接触;接触/抓握由同一总QA的其他检查负责。fix=false或fix.grasp=false时按原生规则禁用负载物理,load为null。重复剪辑、变速和IK后的最终帧重新测量,不重新下垂、重新抓握或自动修复。预算另计携带体数量×(锚点数量+1)的逐帧扫描开销,超过既有总预算以 PREVIS_CONTACT_BUDGET_EXCEEDED 拒绝。对象键/求解目标残差、抓取/接球事件、完整多人约束及修复仍待完成。
|
|
161
|
+
|
|
162
|
+
最终持物关键帧残差在 qa.postEdit.contacts.keyedResiduals 报告:以原生源曲线和物体源尺寸角点,对比最终冻结轨道的位置及朝向;REACH 失败进入总 QA,不从修正后的手部重新生成物体。重复片段逐次检测,变速按分数源帧采样曲线。原生弹簧摆动不属于 REACH,按源 drawn-to-base 相对偏移扣除,额外冻结轨道变化仍可检测。整个关键帧窗口被剪掉时仅列入 unmeasuredObjectIds,不宣称已测通过。重测依赖原编译上下文;此项不替代求解目标残差、抓取事件、多人约束及修复。证据见 validation/p2-key-qa.json。
|
|
163
|
+
|
|
164
|
+
脚部求解目标补测见 qa.postEdit.contacts.solverTargets:scope=native-leg-and-arm-solver-targets,以最终 LeftFoot/RightFoot 骨骼端点对比源编译帧 foot_l/foot_r 目标,不沿用源 leg_miss 诊断;超出原生 reach 容差的 REACH 合并总 QA。重复区间各自测量,目标数值线性插值,是否启用按最近源帧判定;没有目标时不生成零目标。坐标明确为 compiled-world-metres,不包含人物显示缩放、父组或路径的世界变换;同报告其他接触检查仍可使用渲染世界坐标。measuredFrames 列出每侧实际测量帧数,armTargetsRechecked=true、heldTargetsRechecked=true,autoRepair=false。手臂目标的原生语义见下述补测说明。证据见 validation/p2-foot-target-qa.json。
|
|
165
|
+
|
|
166
|
+
手臂与握持求解目标已接入 qa.postEdit.contacts.solverTargets:scope=native-leg-and-arm-solver-targets,armTargetsRechecked=true、heldTargetsRechecked=true。源编译器只记录混合、避障、负载、软可达修正后的实际 IK 目标,以及最后一次握持迭代目标,不改变求解结果。最终帧直接测量手腕到冻结目标的距离;目标保留原生后续抓握/握持造成的手腕位移(armTargetBasis=captured-native-solver-target-with-downstream-pose-offset),避免将制作步骤误报为后处理漂移。普通 IK 误差乘以原生 1-hold.w,完整握持时由握持目标负责;armWeightBasis=native-one-minus-hold-weight。arm_miss_l/r、hold_miss_l/r 的 REACH 进入总 QA,measuredFrames 列出各项启用帧数。重复/变速采用数值线性插值及最近源帧启用规则;依赖原始本地编译上下文,缺少目标记录时报 PREVIS_SOLVER_TARGET_CONTEXT_MISSING,正式附件不保存这些闭包或目标记录。坐标仍为 compiled-world-metres,不重新解析经过显示缩放、父组或路径移动后的实时锚点;渲染世界接触由其他补测负责。autoRepair=false;抓放事件、完整多人约束及修复仍未完成。证据见 validation/p2-arm-target-qa.json。
|
|
167
|
+
|
|
168
|
+
抓取/接球事件在 qa.postEdit.contacts.grabEvents 返回:eligibleObjectIds、events 和 unmeasuredObjectIds。复用原生抓取前静止/下落轨迹,以最终 prop.origin 骨骼均值到原实体盒表面的距离测量,不使用已经跟手的持物轨道;GRAB 使用 checks.limits.grab(默认0.03米),CATCH 保留原生速度标记判定及固定0.03米阈值。首帧即持有、未声明 grab 或抓取前原生可见通道隐藏的物体按原生规则免检。每段重复剪辑先用原生 sourceToTimeline 映射,再按附件的最近源帧握持采样规则定位首个实际抓取帧;events 同时记录 sourceFrame、最终 frame、sampledSourceFrame、gap、limit、ok,变速采样可能不恰好落在源事件帧。整个事件被剪掉或压缩后未采到抓取仅列为未测,不宣称通过。失败合并总 QA,预算含携带组内实体数量。正式场景测量返回 coordinateSpace=rendered-world-metres、scenePlacementRechecked=true、targetBasis=rendered-native-resting-before-grab:手部使用实际显示缩放与父组/人物路径,抓取前实体按最终时间线的父组路径移动,并保留原尺寸及下落姿态;分组逐成员实体测量,隐藏人物或无可见成员的目标列为未测。分组携带保持原生刚体语义,不额外继承父组尺寸。仅提供编译上下文时仍返回 compiled-world-metres、scenePlacementRechecked=false。autoRepair=false,完整多人约束、世界求解目标和修复仍待完成。证据见 validation/p2-world-grab-qa.json;原编译事件基准见 validation/p2-grab-event-qa.json。
|
|
169
|
+
|
|
170
|
+
人物之间的碰撞补测在 qa.people(源动作)和 qa.postEdit.people(时间编辑/区间 IK 后)返回,失败为 PERSON 并合并总 QA。复用原生身体胶囊与线段距离、checks.allow 的 part 前缀和 object:"person:<id>" 规则,允许深度仍为米制;胶囊半径及远距粗筛包含实际人物放缩。其他角色按正式场景的姿态/父组/人物路径逐帧采样,父组显隐读取最终附件轨道。scope=native-person-capsules-against-scene-poses、coordinateSpace=rendered-world-metres、visibilitySampling=scene-hidden-and-final-track。personIds 为候选 X/Y 角色;hiddenCharacterIds 为工程静态隐藏角色;其他可见代理角色列入 uncheckedCharacterIds,不得宣称它们碰撞通过。单动作编译报告仍为otherMotionVersionsRechecked=false;多动作任务另存上方联合人物胶囊报告,不包含联合求解。工作量预算为最终帧数×候选人数×胶囊数平方×9,超过2,000,000抛 PREVIS_PEOPLE_BUDGET_EXCEEDED。胶囊为保守近似,autoRepair=false;完整多人交互、附着感知修复和目标容器验收仍待完成。证据见 validation/p2-people-qa.json。
|
|
171
|
+
|
|
172
|
+
环境贴图上传:`canvas previs upload <nodeId> sky.hdr --project <projectId> --base base.json --hdr --scene <sceneId> --json`,也支持 .exr/.png/.jpg/.jpeg;不能与 --model/--character/--object 混用。网页在灯光页上传,须先保存草稿;上传会保存新来源版本及场景版本并选中该环境。
|
|
173
|
+
|
|
174
|
+
## 场景纸片
|
|
175
|
+
|
|
176
|
+
参考图上传只存档,不自动进入场景。使用 `cutout.add {sceneId,objectId,assetId,aspect,height?,name?,placement?}` 显式创建:assetId 必须是当前工程已有 purpose=reference、format=png 的正式绑定;objectId 为同场景唯一对象 ID;aspect 为图片宽高比(0.02~50),height 为米(至少0.05,默认1.8),placement 为 x/y/z/rot。网页从正式媒体记录的图片尺寸读取比例;Agent 应从已知图片尺寸取得比例,不凭空声明尺寸,未知时先确认构图意图。
|
|
177
|
+
|
|
178
|
+
尺寸使用 `object.update {sceneId,objectId,patch:{height?,width?,stretch?}}`:width 为目标米制宽度,stretch 为0.1~10的宽度倍率,宽度优先于同次 stretch;底部枢轴和占地由原生实现重算。位置、旋转、分组、路径及骨骼附着沿用已有操作。删除所有场景中引用它的纸片后才能 `asset.remove`,否则返回 PREVIS_ASSET_IN_USE;删除纸片保留正式图片及历史版本。保存仍用 read 返回的三重版本,不自动渲染;渲染显式执行。纸片只提供空间/构图参考,不自动建立人物身份或审核记录。深度/法线保留透明孔洞,闲置参考图不进入渲染清单。网页支持按需打开画笔,以原图像素进行背景取样及擦除/恢复;预览不保存,须显式提交新版本。原生复制尚未接入,不能宣称已具备该入口。
|
|
179
|
+
|
|
180
|
+
|
|
181
|
+
显式抠图与蒙版重编辑使用同一编辑合同:`{base,matte:{sceneId,objectId,selection:"auto"|"saved",options:{...}}}`,与 actions/restoreVersionId 互斥。先读取当前已保存场景和纸片 ID;保留完整 base,不自动重读替换。auto 默认按边缘颜色选择背景,也可给 points 原图像素坐标(1~128点)及 tolerance=0.01~0.9;saved 使用已有原尺寸蒙版,不接受 points/tolerance。options 可设 shrink/feather 整数0~8、trim 布尔值,以及最多4096条 strokes:`{x,y,radius,value}`,x/y 为原图像素,radius>0且<=512,value=1 擦除、-1 恢复。输入不接受 URL、媒体ID或任意脚本;原图、选区、渲染图保留各自不可变版本。裁剪沿用原生全图高度补偿,重复操作不累乘比例;操作会保存场景新版本并使下游过期,不自动渲染或审核。409 后重新读取并审阅;结果未知时查询原回执,不能盲目重试。
|
|
182
|
+
|
|
183
|
+
CLI 用 `ai-short-studio canvas previs apply <nodeId> --project <projectId> --file matte.json --json` 提交此合同。
|
|
184
|
+
|
|
185
|
+
网页画笔与远程抠图共用像素处理合同:画笔预览始终显示全幅原图坐标,trim 只影响正式输出的包围盒。取样和笔画不是人物身份或审核证据;Agent 不操作网页画笔,而是用已支持的结构化 points/strokes。已有蒙版保持源图尺寸,saved 禁止自动取样参数。网页预览可清空本次笔画,关闭预览保留当前面板的编辑;切换对象、恢复版本或离开编辑器时,未保存笔画需要用户明确丢弃。关闭预览或改变参数会终止旧 Worker,预览失败不自动提交或降级。原生边缘清理可能删除触边的小孤立区域,恢复笔画不绕过该规则。
|
|
186
|
+
|
|
187
|
+
当前 strokes 为原图像素修补,不代表上游区域生长画笔已接入;原生区域笔画、选区局部历史和缩放平移仍有缺口。PREVIS_MATTE_EMPTY 不产生正式版本;网页可显示原图供修正,但不能将该原图当作成功抠图产物。
|
|
188
|
+
|
|
189
|
+
|
|
190
|
+
帧图和视频渲染位置:`previs-frame` 与 `previs-video` 支持 `config.previs.executionLocation=auto|client|server`。网页及内置助手的 auto 任务优先由当前用户打开的本项目画布页面领取,客户端不可用或断线后可后台接管。client 必须保持画布页面打开,无法领取、断线或编码失败会失败;server 使用后台。CLI 默认 auto 且没有网页能力声明时使用后台;显式 client 会等待网页。内置助手仍通过 canvas_execute 提交,无需再次点击运行。客户端 WebGL 使用 GPU,视频按固定 24fps 时间戳使用 WebCodecs 编码 H.264 MP4,优先硬件编码,实际设备由浏览器决定;软件 WebGL 不作为客户端 GPU 路径。单帧、首尾帧、深度、法线、联系表和视频使用同一冻结版本及角色合同。正式媒体由服务端验证执行权、来源、PNG 尺寸、MP4 编码/帧数/帧率/时长并解码后提交;客户端上传不等于审核通过。工程导出继续后台。
|