@aswless_854771076/ai_short_studio_cli 0.1.183 → 0.1.184
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 +10 -0
- package/dist/commands/canvas/asset/reuse-context.d.ts +18 -0
- package/dist/commands/canvas/asset/reuse-context.js +13 -0
- package/dist/commands/canvas/asset/reuse.d.ts +18 -0
- package/dist/commands/canvas/asset/reuse.js +15 -0
- package/dist/domain/vvicat-api.d.ts +2 -0
- package/dist/domain/vvicat-api.js +7 -0
- package/package.json +1 -1
- package/skills/using-vvicat-ai-short-studio-cli/references/agent-recovery.md +12 -0
package/README.md
CHANGED
|
@@ -252,3 +252,13 @@ Agents author freeform JSON documents directly in `text-resource` nodes and pres
|
|
|
252
252
|
画布 settings 管理制作配置,不修改内置助手 agentModel;项目 outputLanguage 创建后不可改。null 只对可覆盖字段恢复默认。内置助手使用专用工具复用同一保存服务,CLI 继续使用 canvas settings get/set。
|
|
253
253
|
|
|
254
254
|
连续性 --apply-ready 只配置尾帧提取节点和连线,不运行媒体任务。网页、CLI与内置助手复用同一分析规则;读取图和设置版本不一致时重新分析,不覆盖新图。内置助手的专用工具额外核对分析指纹和指定建议。
|
|
255
|
+
|
|
256
|
+
## 失效视频复用 / Reuse an existing stale video
|
|
257
|
+
|
|
258
|
+
先用 `canvas asset reuse-context <assetId> --project <projectId> --node <producerNodeId> --version <versionId> --json` 检查原媒体及当前合同。修复返回的来源阻塞并实际完整播放后,通过 `canvas asset reuse <assetId> --project <projectId> --file reuse.json --json` 提交上下文指纹与逐项审核。服务端追加同媒体复用版本,不触发视频生成;旧版本保留,字幕和剪辑须重新核对。完整合同见随包 `references/agent-recovery.md`。
|
|
259
|
+
|
|
260
|
+
Read `canvas asset reuse-context` before submitting `canvas asset reuse`. The context includes the original and current contracts, source differences, media digest, canvas version, and context hash. Resolve blocked sources and fully watch and listen to the existing video before submitting observations and playback evidence. Reuse appends a new version referencing the same media; it preserves generation history and never calls the video provider. Rebuild caption and edit bindings against the returned version. Frame samples, ASR, and technical checks do not prove full playback.
|
|
261
|
+
|
|
262
|
+
人工完整审看后,可加 `--approve-only` 单独保存验收声明,把返回的 `approvalAssetId` / `approvalVersionId` 交给内置助手继续。内置工具仅接受该引用,不能自行填写人审结论;声明不改变视频选版。
|
|
263
|
+
|
|
264
|
+
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.
|
|
@@ -0,0 +1,18 @@
|
|
|
1
|
+
import { BaseCommand } from '../../../base-command.js';
|
|
2
|
+
export default class CanvasAssetReuseContext extends BaseCommand {
|
|
3
|
+
static description: string;
|
|
4
|
+
static args: {
|
|
5
|
+
assetId: 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
|
+
node: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
|
|
10
|
+
version: import("@oclif/core/interfaces").OptionFlag<string, 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,13 @@
|
|
|
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 CanvasAssetReuseContext extends BaseCommand {
|
|
5
|
+
static description = '只读检查失效视频、新旧合同和复用门禁;不生成、不选版';
|
|
6
|
+
static args = { assetId: Args.string({ required: true }) };
|
|
7
|
+
static flags = { ...BaseCommand.baseFlags, project: projectFlag, node: Flags.string({ required: true }), version: Flags.string({ required: true }) };
|
|
8
|
+
async run() {
|
|
9
|
+
const { args, flags } = await this.parse(CanvasAssetReuseContext);
|
|
10
|
+
const { api } = await commandApi(flags);
|
|
11
|
+
this.print(await api.videoReuseContext(flags.project, args.assetId, flags.node, flags.version));
|
|
12
|
+
}
|
|
13
|
+
}
|
|
@@ -0,0 +1,18 @@
|
|
|
1
|
+
import { BaseCommand } from '../../../base-command.js';
|
|
2
|
+
export default class CanvasAssetReuse extends BaseCommand {
|
|
3
|
+
static description: string;
|
|
4
|
+
static args: {
|
|
5
|
+
assetId: 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
|
+
'approve-only': import("@oclif/core/interfaces").BooleanFlag<boolean>;
|
|
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, readJsonInput } from '../../../command-helpers.js';
|
|
4
|
+
export default class CanvasAssetReuse extends BaseCommand {
|
|
5
|
+
static description = '提交对当前合同的完整播放审核,追加同媒体复用版本;不调用视频生成';
|
|
6
|
+
static args = { assetId: Args.string({ required: true }) };
|
|
7
|
+
static flags = { ...BaseCommand.baseFlags, project: projectFlag, file: Flags.string({ description: '复用 JSON 文件;省略时读取 stdin' }),
|
|
8
|
+
'approve-only': Flags.boolean({ description: '人工提交独立验收声明,返回供内置助手使用的审核引用,不修改视频选版', default: false }) };
|
|
9
|
+
async run() {
|
|
10
|
+
const { args, flags } = await this.parse(CanvasAssetReuse);
|
|
11
|
+
const body = await readJsonInput(flags.file);
|
|
12
|
+
const { api } = await commandApi(flags);
|
|
13
|
+
this.print(await api.reuseVideo(flags.project, args.assetId, body, flags['approve-only']));
|
|
14
|
+
}
|
|
15
|
+
}
|
|
@@ -176,6 +176,8 @@ export declare class VvicatApi {
|
|
|
176
176
|
runNode(projectId: string, nodeId: string): Promise<JsonObject>;
|
|
177
177
|
listAssets(projectId: string, query?: string): Promise<JsonObject>;
|
|
178
178
|
asset(projectId: string, assetId: string): Promise<JsonObject>;
|
|
179
|
+
videoReuseContext(projectId: string, assetId: string, nodeId: string, versionId: string): Promise<JsonObject>;
|
|
180
|
+
reuseVideo(projectId: string, assetId: string, body: JsonObject, approveOnly?: boolean): Promise<JsonObject>;
|
|
179
181
|
mediaReviewContext(projectId: string, assetId: string, nodeId: string, versionId: string, stage: string): Promise<JsonObject>;
|
|
180
182
|
reviewAsset(projectId: string, assetId: string, body: JsonObject): Promise<JsonObject>;
|
|
181
183
|
selectAssetVersion(projectId: string, assetId: string, versionId: string): Promise<JsonObject>;
|
|
@@ -401,6 +401,13 @@ export class VvicatApi {
|
|
|
401
401
|
asset(projectId, assetId) {
|
|
402
402
|
return this.client.request(`/api/projects/${projectId}/canvas/assets/${assetId}`);
|
|
403
403
|
}
|
|
404
|
+
videoReuseContext(projectId, assetId, nodeId, versionId) {
|
|
405
|
+
const query = new URLSearchParams({ nodeId, versionId });
|
|
406
|
+
return this.client.request(`/api/projects/${projectId}/canvas/assets/${assetId}/reuse?${query}`);
|
|
407
|
+
}
|
|
408
|
+
reuseVideo(projectId, assetId, body, approveOnly = false) {
|
|
409
|
+
return this.client.request(`/api/projects/${projectId}/canvas/assets/${assetId}/reuse${approveOnly ? '?approveOnly=true' : ''}`, { method: 'POST', body });
|
|
410
|
+
}
|
|
404
411
|
mediaReviewContext(projectId, assetId, nodeId, versionId, stage) {
|
|
405
412
|
const query = new URLSearchParams({ nodeId, versionId, stage });
|
|
406
413
|
return this.client.request(`/api/projects/${projectId}/canvas/assets/${assetId}/reviews?${query}`);
|
package/package.json
CHANGED
|
@@ -101,3 +101,15 @@ ai-short-studio canvas node storyboard-draft "$BREAKDOWN_NODE_ID" --project "$PR
|
|
|
101
101
|
修复后单独提交 `action:"promote"`,`operations:[]`,并携带当前画布/草稿版本及新 `requestId`。批准失败仍保留草稿和诊断;批准成功才更新正式父子版本并派生已选板型节点,不调用生成模型。软建议不阻断批准;不得从资产历史直接选中未批准草稿。
|
|
102
102
|
|
|
103
103
|
规划内置最多三轮;后续模型输出无效时上一完整草稿仍可修复,不自动追加第四轮。需要拆镜重组的时长问题,应按完整来源单元拆分,并更新素材时长与剪辑保留时长;不要删词、加速或静默夹取到15秒。草稿批准没有运行的摄影、表演、细化阶段如实标为跳过,不宣称已完成独立设计。
|
|
104
|
+
|
|
105
|
+
## 失效视频的受控复用(不重新付费生成)
|
|
106
|
+
|
|
107
|
+
先运行 `canvas asset reuse-context <assetId> --project <projectId> --node <video-generate-nodeId> --version <selectedVersionId> --json`。
|
|
108
|
+
此只读入口允许检查 stale 视频,返回原始生成合同、当前合同、changedFields、媒体 SHA256、技术指标、expectedVersion 和 contextHash。
|
|
109
|
+
`eligibleForReview:false` 时先修复 blockedReason:提示词资源 stale 应基于当前文档重写正式提示词并回读,不必先生成视频。仅支持正式 Agent 提示词合同,不支持任意历史媒体转移到其他镜头。
|
|
110
|
+
|
|
111
|
+
有真实完整播放和听音能力时,对照 current 合同核对原视频。通过后运行 `canvas asset reuse <assetId> --project <projectId> --file reuse.json --json`,正文为 `{nodeId,versionId,expectedVersion,contextHash,reason,review}`。review 使用 reviewContext 的 shotKey、sourceVersionIds、media 身份,media.sha256 取 mediaSha256;填写全部 video criteria 和真实 watchEvidence,必要时带 speechTiming。未播放、只抽帧、只 ASR 或只技术探测不得填写完整播放证据。
|
|
112
|
+
|
|
113
|
+
服务端重验当前来源、技术 QC、完整审核和上下文指纹,原子追加引用同一媒体的复用版本及审核,同时恢复匹配旧选版的生产节点和视频资源。旧生成快照和 stale 历史不变;不调用视频供应商。保存后回读新 versionId,再重编译字幕和剪辑;旧字幕绑定旧版本,不能直接沿用选版。409 后重新读取并复核,不重发旧证据。验收失败只重生成受影响镜头,不将整集重跑视为默认恢复手段。
|
|
114
|
+
|
|
115
|
+
人工已完整审看、准备让内置助手继续时,可对上述复用正文执行 `canvas asset reuse <assetId> --project <projectId> --file reuse.json --approve-only --json`。它只保存独立人工验收声明,返回 approvalAssetId/approvalVersionId,不切换视频选版。将真实引用提供给内置助手;其 canvas_reuse_video 只接受引用与精确目标/画布版本,不接受模型自填 review/watchEvidence。声明绑定提交用户、当前媒体和合同;来源变化或声明删除后必须重新验收。此命令是人工声明入口,自动 Agent 不得代替用户声明已播放。
|