@kevlns/art-workshop 0.5.2 → 0.6.1

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.
Files changed (53) hide show
  1. package/README.md +13 -11
  2. package/art-workshop.mjs +50 -10
  3. package/docs/channels.md +49 -0
  4. package/docs/commands.md +2158 -91
  5. package/docs/configuration.md +8 -0
  6. package/docs/core-guidance.md +12 -4
  7. package/docs/data-formats.md +10 -6
  8. package/docs/local-models/qwen-image-2.1.json +1 -1
  9. package/docs/modes.md +12 -6
  10. package/docs/release-0.6.0.md +9 -0
  11. package/lib/analysis-worker.mjs +9 -5
  12. package/lib/backends.mjs +2 -0
  13. package/lib/candidates.mjs +2 -1
  14. package/lib/channel-operation.mjs +84 -0
  15. package/lib/core.mjs +33 -2
  16. package/lib/edit.mjs +5 -3
  17. package/lib/generate.mjs +5 -3
  18. package/lib/generation-policy.mjs +1 -1
  19. package/lib/object-format.mjs +2 -2
  20. package/lib/prompt-structure.mjs +3 -3
  21. package/lib/service.mjs +21 -0
  22. package/lib/style-bundle.mjs +19 -6
  23. package/lib/style-contract.mjs +3 -3
  24. package/lib/style-lifecycle.mjs +7 -73
  25. package/lib/style-report.mjs +1 -1
  26. package/lib/style-samples.mjs +94 -0
  27. package/lib/task-contract.mjs +2 -1
  28. package/lib/templates.mjs +1 -1
  29. package/lib/video/PROVENANCE.json +63 -0
  30. package/lib/video/atomic.mjs +32 -0
  31. package/lib/video/channel.mjs +70 -0
  32. package/lib/video/contract-local-media.mjs +42 -0
  33. package/lib/video/contract-story.mjs +213 -0
  34. package/lib/video/contract-video.mjs +117 -0
  35. package/lib/video/contracts.mjs +3 -0
  36. package/lib/video/h3.mjs +232 -0
  37. package/lib/video/local-runtime.mjs +20 -0
  38. package/lib/video/media.mjs +223 -0
  39. package/lib/video/models.mjs +336 -0
  40. package/lib/video/path.mjs +18 -0
  41. package/lib/video/process.mjs +15 -0
  42. package/lib/video/resource.mjs +15 -0
  43. package/lib/video/service.mjs +731 -0
  44. package/lib/video/workflow.mjs +571 -0
  45. package/lib/video.mjs +12 -0
  46. package/lib/workspace.mjs +35 -21
  47. package/package.json +8 -3
  48. package/rules/core-guidance.json +1 -1
  49. package/skills/art-workshop/SKILL.md +4 -2
  50. package/skills/art-workshop/references/project.md +18 -9
  51. package/skills/art-workshop/references/style-discussion.md +8 -6
  52. package/skills/art-workshop/references/video.md +13 -0
  53. package/v-cli.plugin.json +4380 -276
@@ -12,6 +12,8 @@
12
12
 
13
13
  ### 配置入口
14
14
 
15
+ 本页的全局配置默认属于图片通道,`image` 前缀与旧命令使用同一份配置。视频通道显式绑定工程根目录,模型和工作流单独保存到 `.vant/config/video.json`,任务及成片保存在 `.vant/video`;不会把视频配置写入图片全局设置。详见 [图片与视频通道](channels.md)。
16
+
15
17
  `config path/show/init/validate` 分别查询位置、生效配置、创建模板和校验。`config init` 不覆盖已有文件。查询、发现和预演不创建参考目录;`config validate` 不联网、不启动服务。
16
18
 
17
19
  配置位置优先级为 CLI `--config`、`ART_WORKSHOP_CONFIG`、`<VANT_HOME 或 ~/.vant>/tools/art-workshop/config.json`。资源路径优先级为 CLI 路径选项、配置 paths、默认路径。配置文件和资源均须位于工具安装目录之外。
@@ -67,6 +69,12 @@ Vant 系统模型配置统一保存 Provider 实例及凭据,工程只引用
67
69
 
68
70
  对象变更锁和执行登记归 workspace/.runtime;更换配置文件不产生另一套占用。共享服务登记归用户数据根的 state/art-services,环境索引、接入日志和证据归 state/art-environments。安装根保存模型、程序与 vant.art.config.json,控制数据写入用户 .vant 数据目录。
69
71
 
72
+ ### 风格规则与样张
73
+
74
+ 风格的 config.rules 是可编辑配置,保存有效规则时维护当前核心与历史哈希快照,不需要先派生或采用。原始 style/palette/rendering 参考仅用于分析指定关注点;用户通过 style sample-select 认可的候选复制到风格 samples 目录,独立保存文件和规则哈希。候选的样张定版开关将图片加入或移出“风格配置 → 运行时参考”,按图片内容哈希去重。移除关系保留历史文件,不修改用户源图,不调用资产定版或导出。
75
+
76
+ 生成和编辑任务以 config.styleReferenceMode 选择 approved(默认)或 text-only。approved 使用匹配当前规则哈希的样张;从未采用样张时按规则生成并在预案标记 no-samples;已有样张全部过期时拒绝使用。text-only 明确仅使用文字规则。后端不支持图片输入时明确报错,不把已配置样张静默丢弃。打样任务固定 text-only,创建任务后仍需配置模型和执行预案。
77
+
70
78
 
71
79
 
72
80
  ## 执行边界
@@ -23,7 +23,7 @@
23
23
 
24
24
  生成提示按主题组织,保留条件与强度。正向表达绘制语言,负向排除抽象的渲染、笔触或语言混杂等特征;负向不能变成主体、部件、身份色、具体材质和纹理的黑名单。不得从参考图中未出现的内容推断禁止条件。
25
25
 
26
- negative 为可选的被排除特征列表,不加“避免、不要、禁止、no、without”等否定前缀。instruction 为同一规则的阅读说明;条件与例外写入 when。仅无条件 avoid 且明确填写 negative 时编译进独立负向段;其余文字约束及条件排除保留在正向规则段,不猜测条件、不机械转换。default 不升级为负向禁止;正向与负向按路由去重,完整冻结配置保留阅读说明。
26
+ negative 为可选的被排除特征列表,不加“避免、不要、禁止、no、without”等否定前缀。instruction 为同一规则的阅读说明;条件与例外写入 when。仅无条件 avoid 且明确填写 negative 时编译进独立负向段;其余文字约束及条件排除保留在正向规则段,不猜测条件、不机械转换。default 不升级为负向禁止;正向与负向按路由去重,完整已保存配置保留阅读说明。
27
27
 
28
28
  模型支持独立 negative_prompt 时直接发送;不支持时适配器将负向约束明确并入正向排除段,使用合并后的提示词长度限制,不默默丢弃或截断。ComfyUI 将其绑定到 negativePrompt 输入,缺少绑定则明确报错。界面预案显示适配后实际请求,条件排除和全局负向分别说明。最终核心只使用规则,不把聊天记录、问题解释或证据局限混入生成规范。
29
29
 
@@ -31,15 +31,23 @@ negative 为可选的被排除特征列表,不加“避免、不要、禁止
31
31
 
32
32
  summary 概述当前方案,observations 保存分类证据,notes 保存不影响执行的提醒。issues 只表达真正需要用户选择的矛盾,每项有稳定 id、question、reopenReason 与2至5个 options。选项含 id、label、remove 规则ID和 upsert 规则。
33
33
 
34
- style resolve 校验 revision、报告来源和选项,记录 issueId、问题指纹、optionId、用户依据和时间。选择应用于候选规范,不改变原始模型响应;reviewHistory 记录历次选择。覆盖已有决定涉及的规则时,相关已记录决定重新打开,不静默覆盖。采用要求当前来源匹配、所有问题已有有效决定;notes 非空仍可采用。
34
+ style resolve 校验 revision、报告来源和选项,记录 issueId、问题指纹、optionId、用户依据和时间,reviewHistory 记录历次选择。报告建议中的矛盾按用户实际选择处理;不要清空问题或伪造分析证据。用户直接编辑的 config.rules 通过 style update 保存,不要求报告 ready 或再次采用。
35
35
 
36
- 修改草稿或参考保留报告并标记需复核。已有规则按用户要求修改时,style revise 接收完整 rules、summary 与 note,沿用未变化的参考证据,记录原报告及用户依据,不调用模型、不自动冻结;自由补充不被删除。参考或分析配置改变时须重新分析,未决问题先集中确认。
36
+ 风格规则可以随时增删修改并保存,包括历史状态为 frozen 的风格。style update 接收完整 config,保存有效 rules 后同步当前 core.json,旧核心按 coreHash 存入 core-history;历史运行中的快照保持原样,未执行预案须重新编译。分析配置或参考变化保留原报告并标记需复核,但不强制用户重新分析才能保存规则。style revise 作为兼容修订入口记录用户依据,不自动调用模型。
37
37
 
38
- 当前职责版本的冻结风格派生后保留结构化规则及独立参考,报告标记 inherited-frozen;用户规则修订标记 user-rules,原模型观察作为证据保留,不伪称重新分析。旧职责版本仍保留只读证据,不能自动转换。
38
+ 独立派生仍可保留结构化规则与参考,用于创建不同方向的风格;不再作为修改的前提。旧职责版本保留原始证据,通过显式迁移整理,不能自动解释为当前规则。内部 status=frozen 兼容表示已有可执行核心,界面不应据此禁用编辑。
39
39
 
40
40
  需要分析复核时,复核提供上一版方案和决定;同一证据、问题与选项不变时保留决定,新证据或明确重新打开理由要求重新确认。逐图观察按内容和分类契约缓存,未改变的图不重复请求。
41
41
 
42
+ ### 用样张验证规则并定版
42
43
 
44
+ 保存规则后用 style sample-job 创建仅规则打样任务;按普通生成流程配置模型和执行,不自动发起生图。使用简单且不同的主体检查这套规则组合的实际表现,用户不满意时直接修改保存规则并重新打样。用户选定后通过 style sample-select 完成样张定版并保存独立运行时参考,来源和当前规则哈希随样张记录;样张定版不调用 candidate finalize,不导出到 VantArtForge。
45
+
46
+ 后续任务可以选择 approved 运行时参考或 text-only 仅规则。原始分主题图不会因存在于风格中而直接传给生成模型。运行时参考仅表达绘制语言,主体、结构、身份色与构图由当前任务决定。规则变化后的旧样张显示过期;已有样张全部过期时不能用于 approved,混合新旧样张只采用当前匹配项。模型不支持图片参考时明确报错,不静默改变模式。规则保存本身不意味着已经通过实际视觉验证。
47
+
48
+
49
+
50
+ 候选图片使用“样张定版 / 取消样张定版”开关,对应兼容 API style sample-select / sample-remove;这只维护当前风格的运行时参考,不执行资产定版或导出。定版图片在“风格配置 → 运行时参考”显示,按图片内容哈希去重,重复图片不会新增一份。任务的 approved/text-only 决定是否使用运行时参考,不为每张参考另设启用开关。
43
51
 
44
52
  ## 结果验证
45
53
 
@@ -18,23 +18,27 @@ art 工程与输入结构,适用于当前随包实现。
18
18
 
19
19
  project.json 必须声明 schemaVersion=2、revision、id、name、analysisModel、execution、cores、defaultCore。工程身份与目录匹配,核心必须属于同一工程。
20
20
 
21
- projects/<projectId>/styles/<styleId>/style.json 与 tasks/<taskId>/task.json 使用 schema=art-workshop/style 或 art-workshop/task,schemaVersion=2、稳定 id、project、展示 name、revision、status、createdAt/updatedAt、config、references 和 report。正式风格的 core.json 不可原地覆写。任务的 config.kind 是 generate/edit,不能改身份与类型。
21
+ projects/<projectId>/styles/<styleId>/style.json 与 tasks/<taskId>/task.json 使用 schema=art-workshop/style 或 art-workshop/task,schemaVersion=2、稳定 id、project、展示 name、revision、status、createdAt/updatedAt、config、references 和 report。风格允许直接编辑保存;core.json 是当前可执行快照,历史核心保存在同目录 core-history/<coreHash>.json。内部 frozen 状态不代表只读。任务的 config.kind 是 generate/edit,不能改身份与类型。
22
22
 
23
23
  参考记录包括 id、所属对象、对象内相对 path、SHA256、来源、category/purposes、usage、note、ignore。风格三类:style、palette、rendering。任务用途:subject、composition、pose、identity-color、surface、scene-light、text。sources 只放编辑底图。
24
24
 
25
+ 风格 samples 数组按图片内容 hash 去重,保存样张定版后的运行时参考:id、path、hash、rulesHash、jobId、runId、candidateId、itemId、note、createdAt、model、backend。path 位于风格 samples 目录,文件独立复制;规则哈希仅绑定 rules,styleView 返回 stale 投影用于显示当前匹配状态。core.approvedSamples 保存该版本的样张快照。移除当前采用关系保留历史图片,规则改变不会改写旧样张。
26
+
27
+ style sample-job 的可选 count 为 1~4 的整数,表示三个默认主体各自的候选数量,保存为 config.execution.perValue;创建普通生成任务,source.kind=style-sample,记录 styleId、revision、rulesHash 和 coreHash,config.styleReferenceMode=text-only。style sample-select 只接受当前风格规则对应的已停止成功候选,样张定版不执行资产导出。style sample-remove 移除当前样张身份。
28
+
25
29
  ### 需求与计划
26
30
 
27
- 风格 config 包含 description、constraints、rules 与 analysis(均按需要填写)。rules 每条为 id、scope、strength、instruction、when,avoid 可含 negative 抽象排除表达数组;条件写入 when,职责见 [风格规则](core-guidance.md)。report.evidenceHash 绑定参考与分析配置;provenance.method 区分模型分析、inherited-frozen 沿用冻结证据和 user-rules 用户修订。规则修订保留原报告与依据,采用后生成独立核心哈希。
31
+ 风格 config 包含 description、constraints、rules 与 analysis(均按需要填写)。rules 每条为 id、scope、strength、instruction、when,avoid 可含 negative 抽象排除表达数组;条件写入 when,职责见 [风格规则](core-guidance.md)。有效 config.rules 保存后生效,报告 recommendation.rules 只是建议。report.evidenceHash 绑定参考与分析配置,原报告与用户修订依据保留,不把保存解释成重新分析。
28
32
 
29
- 生成 config 包括 project、kind、core、execution、analysis、generation、items,以及互斥的 profile 或内联 asset 规格;实体及效果有稳定 id、数量、颜色、角色与关系。具体主体、构图、动作不冻结进风格。规格定义资产约束、设计基准与检查要点,内联规格属于当前任务,编译时形成同一不可变快照。编辑 config 的 items 明确 source、changes、preserve、mustRead、seed。
33
+ 生成 config 包括 project、kind、core、styleReferenceMode、execution、analysis、generation、items,以及互斥的 profile 或内联 asset 规格;实体及效果有稳定 id、数量、颜色、角色与关系。styleReferenceMode 为 approved(默认)或 text-only,分别选择当前运行时参考或仅文字规则,编辑任务也支持该字段。具体主体、构图、动作由任务决定。规格定义资产约束、设计基准与检查要点,内联规格属于当前任务,编译时形成同一不可变快照。编辑 config 的 items 明确 source、changes、preserve、mustRead、seed。
30
34
 
31
35
  生成实体可选 material 描述物理材质,按原文进入主体行。composition 的 lightDirection/lightQuality 由资产规格 allowedOverrides 成对提供非空词表,defaults 成对提供词表内默认值。有效值按规格、任务、variant 顺序覆盖,允许单项覆盖;未开放时携带光照键报错。新 custom 模板开放光照,既有规格不自动改写。
32
36
 
33
37
  mustRead 保持视觉特征字符串数组。生成和编辑 item 均可选 textSpecs 数组,每项为 {content,hierarchy,zone,fontHint?}:准确文字、层级、位置或载体为必填描述,字形可选,均不限制字数。草稿允许暂缺或留空,编译检查完整性。相同文字的不同位置、层级、字形保留,完全相同项仅在编译输出去重。生成禁文字规格仅拒绝非空 textSpecs,不拒绝视觉特征;编辑任务按底图和修改/保留集处理。文字要求独立编译为画面文字规格段,有文字规格时追加文字保真负向;候选 checks.content 保持字符串数组,accepted 只代表技术完整性。
34
38
 
35
- job read/list 的 resolvedAsset 是当前有效规格只读投影,assetError 是解析失败说明;两者不属于 config,不能保存为需求。新编译计划带 compilerVersion=4 并参与 planHash;版本不作为执行准入门槛,已有计划缺字段时保留缺席,后端重绑定不补版本。
39
+ job read/list 的 resolvedAsset 是当前有效规格只读投影,assetError 是解析失败说明;两者不属于 config,不能保存为需求。新编译计划带 compilerVersion=5 并参与 planHash;版本不作为执行准入门槛,已有计划缺字段时保留缺席,后端重绑定不补版本。
36
40
 
37
- plan 包括 schema=art-workshop/plan、module/project/job、sources、snapshots、refs、execution、items、planHash。sources 绑定 taskRevision、taskConfigHash 和 coreHash;项目/核心/profile/任务形成快照。项含 inputHash、实际尺寸和 seed。透明背景为 {type:"transparent"};生成配置位于 composition.background,编辑配置位于 changes 中 target=background 的 value。预案项 output 固定 PNG、透明背景及处理版本并参与哈希;含完全透明区域的原生 alpha 保留,否则从边缘核实洋红底色,容许模型色偏,处理与外边界连通的底色及混合边缘。接近不透明的 alpha 噪声不视为透明背景。记录 outputProcessing,保留原图和透明 PNG。任何来源或哈希变化拒绝运行。
41
+ plan 包括 schema=art-workshop/plan、module/project/job、sources、snapshots、refs、execution、items、planHash。styleReferences 记录 mode、status、rulesHash、staleCount 和采用样张的 id/hash;样张输入进入 refs 与 item.imageArgs 并参与计划哈希,原始分析参考不作为图片输入。sources 绑定 taskRevision、taskConfigHash 和 coreHash;项目/核心/profile/任务形成快照。项含 inputHash、实际尺寸和 seed。透明背景为 {type:"transparent"};生成配置位于 composition.background,编辑配置位于 changes 中 target=background 的 value。预案项 output 固定 PNG、透明背景及处理版本并参与哈希;含完全透明区域的原生 alpha 保留,否则从边缘核实洋红底色,容许模型色偏,处理与外边界连通的底色及混合边缘。接近不透明的 alpha 噪声不视为透明背景。记录 outputProcessing,保留原图和透明 PNG。任何来源或哈希变化拒绝运行。
38
42
 
39
43
  analysis 为 {provider,model},风格和任务分别保存视觉分析实例。generation 为 {backend,remote?,options?},remote 为 {provider,model};选中后端的模型进入执行与请求快照,旧 execution.model 不覆盖所选后端。options 为当前任务的本地采样覆盖 {steps?,cfg?,sampler?,scheduler?},合并到冻结方案 backend.options,进入实际 ComfyUI 请求;远程后端拒绝这些字段。新任务本地推荐默认值为 steps=25、cfg=3、sampler=euler、scheduler=simple,内置工作流相同。显式值及历史计划保留。省略字段沿用后端或工作流默认值,数值 0 不视为省略。任务切换模型、后端或采样参数会改变配置哈希,必须重新编译。凭据由宿主按实例注入,不保存在配置。
40
44
 
@@ -53,7 +57,7 @@ task recover 根据工程和 operationId 找回唯一原执行;task resume 沿
53
57
 
54
58
 
55
59
 
56
- 风格报告与 core.json 使用 schemaVersion=3。recommendation.rules 保存带主题、强度和条件的定性规则,issues 保存具体决策选项,decisions 保存已确认取舍,notes 保存不阻塞的提醒。style list/read 返回 review(ready、stale、openIssues、reason、有效 recommendation)及 compatibility。对象存储使用 schemaVersion=2。详细字段见 core-guidance.md。
60
+ 风格报告与 core.json 使用 schemaVersion=3。recommendation.rules 保存带主题、强度和条件的建议,issues 保存具体决策选项,decisions 保存已确认取舍,notes 保存不阻塞的提醒。style list/read 返回 review(ready、stale、openIssues、reason、有效 recommendation)及 compatibility;review 是报告状态,不限制用户直接保存有效规则。对象存储使用 schemaVersion=2。详细字段见 core-guidance.md。
57
61
 
58
62
  ## 执行边界
59
63
 
@@ -59,7 +59,7 @@
59
59
  ],
60
60
  "maxExclusive": [
61
61
  3,
62
- 13
62
+ 14
63
63
  ],
64
64
  "preferred": "3.12",
65
65
  "windowsPortable": {
package/docs/modes.md CHANGED
@@ -10,17 +10,23 @@
10
10
 
11
11
  ## 操作流程
12
12
 
13
- ### 风格分析与核心冻结
13
+ ### 风格保存、打样与样张定版
14
14
 
15
- 创建风格草稿,按 style、palette、rendering 分类导入专属参考。讨论澄清意图并回填草稿。style analyze --dry 只编译;实际 analyze 创建 taskId 与独立证据,逐图观察后生成风格报告。
15
+ 创建风格,按 style、palette、rendering 分类导入分析参考。讨论澄清意图,按当前 revision 保存完整配置;规则可随时增删修改,有效 rules 保存后即可用于任务,无需派生或采用。style analyze 是可选辅助:--dry 只编译,实际 analyze 创建 taskId 与独立证据,逐图观察后生成建议报告。
16
16
 
17
- 报告含 summary、observations、recommendation、issues、notes、decisions 和 provenance。recommendation.rules 是可以独立使用的精炼规范,不含讨论过程。notes 不阻塞采用;issues 给出可执行选项。用户选择后通过 style resolve 记录决定,无需重新分析。style read 的 review.ready 为采用条件,不以聊天中的“可采用”作为事实。
17
+ 报告含 summary、observations、recommendation、issues、notes、decisions 和 provenance。recommendation.rules 是精炼建议,不自动替换已保存的 config.rules。issues 给出实质矛盾的可执行选项,用户选择后可通过 style resolve 记录;review.ready 只表示分析建议可采用,不是直接保存规则的前置条件。
18
18
 
19
- 已有规则可按明确要求通过 style revise 修订,沿用未改变的证据,不重复分析。派生当前版本的冻结风格时保留结构化规则与独立参考,并标记沿用原冻结证据;不继承核心、授权、执行与对话。
19
+ 按明确要求使用 style update 保存规则,不为普通措辞修改重复分析;style revise 保留兼容入口并记录用户修订依据。每次保存维护当前核心与按哈希保留的历史快照,历史运行不覆写。derive 仅用于用户需要独立风格时,不是修改的必经步骤。
20
20
 
21
21
  需要新增参考证据或分析复核时,复核复用未变化的图片观察并接收已有方案和决定。错误保留草稿和证据,本地完成后允许编辑;云端计算不确定性单独提示,见 [状态与恢复](troubleshooting.md)。
22
22
 
23
- style adopt 冻结当前有效规则与决策证据,style recover 只恢复原已授权事务。正式风格只读,修改使用 derive。任务动态参考仍使用 job analyze,不替代静态风格。
23
+ 使用 style sample-job --id STYLE --revision N 创建仅规则打样任务,--count 可指定每个主体生成 1~4 张候选,配置模型后按普通计划与执行流程出图;创建任务不自动启动生成。用户认可候选时使用 style sample-select --id STYLE --revision N --job JOB --run RUN --candidate HASH 完成样张定版,加入当前风格的运行时参考;style sample-remove --sample SAMPLE 移除采用关系并保留历史文件。
24
+
25
+ 样张绑定 rulesHash。任务 styleReferenceMode 默认 approved:从未采用样张时按文字规则生成并在预案标识 no-samples;已有样张全部过期时拒绝使用,混合新旧样张只使用当前规则匹配项;text-only 明确仅使用规则。原始分主题参考不会自动上传。模型不支持样张输入时明确报错,可显式切换 text-only。多图输入的风格用途说明不保证完全隔离主体与构图,需要真实出图验证。
26
+
27
+ style adopt 和 style recover 仅保留既有报告采用及中断事务的兼容路径,不是规则保存门槛。任务动态参考仍使用 job analyze。
28
+
29
+ 候选图片使用“样张定版 / 取消样张定版”开关,对应兼容 API style sample-select / sample-remove;这只维护当前风格的运行时参考,不执行资产定版或导出。定版图片在“风格配置 → 运行时参考”显示,按图片内容哈希去重,重复图片不会新增一份。任务的 approved/text-only 决定是否使用运行时参考,不为每张参考另设启用开关。
24
30
 
25
31
  ### 远程文生图
26
32
 
@@ -28,7 +34,7 @@ style adopt 冻结当前有效规则与决策证据,style recover 只恢复原
28
34
 
29
35
  型号的生成/编辑模式、输入数量、尺寸、提示词与参数限制统一来自 [模型目录](remote-models.md)。不能把 URL+Key 或 image 标签视为已经适配;不能以注册型号推定账号权限。
30
36
 
31
- 生成提示词顺序为用途与主体、静态冻结风格、动态主体与关系、动态构图与背景、交付规格、必须可读特征及参考观察。风格的无条件抽象负向表达独立编译;有条件的排除完整保留在条件段。适配器根据模型能力保留独立负向参数或明确并入排除段。编辑提示分别列出修改与保留要求;同一范围可修改局部并保留其他特征,不按标签重叠直接判错。
37
+ 生成提示词顺序为用途与主体、已保存风格规则、动态主体与关系、动态构图与背景、交付规格、必须可读特征及参考观察。风格的无条件抽象负向表达独立编译;有条件的排除完整保留在条件段。适配器根据模型能力保留独立负向参数或明确并入排除段。编辑提示分别列出修改与保留要求;同一范围可修改局部并保留其他特征,不按标签重叠直接判错。
32
38
 
33
39
  透明输出通过 {type:"transparent"} 配置,计划绑定 PNG 处理契约;原图保留,候选使用校验后的透明 PNG。同色细节和半透明材质存在色键处理局限,不能承诺任意抠图质量。
34
40
 
@@ -0,0 +1,9 @@
1
+ # art-workshop 0.6.0
2
+
3
+ 本版本提供图片与视频独立通道及可导入的视频 SDK,包含可编辑风格规则、样张任务、样张定版引用、原始会话出图、分析证据与有界报告修复。宿主通过机器清单发现能力,不能仅凭包版本推断命令存在。
4
+
5
+ 风格分析是可选复核;已整理的规则可直接创建样张任务。样张只使用当前规则,原始分析参考不会自动进入生成输入;用户定版后的样张才可作为后续运行参考。
6
+
7
+ Qwen 本地部署支持 Python >=3.11 且 <3.14,继续优先为新环境准备 Python 3.12。原 `<3.13` 上界与指南固定的 ComfyUI 提交不一致:该提交的 README 明确支持 Python 3.13,Windows 便携版使用 Python 3.13 / CUDA 13.0。已有 3.13 环境无需因此替换。版本通过后仍需检查模型、节点、服务能力及进程归属。
8
+
9
+ 发布验证包括完整测试、命令文档校验、包文件与能力清单检查,以及隔离安装中的 CLI、视频导出和原操作回执。真实模型生成、GPU 输出效果和外部视频服务并不由这些测试自动证明。
@@ -6,6 +6,8 @@ import {existsSync} from 'node:fs';
6
6
  import {join} from 'node:path';
7
7
  import {readJson,writeJson,hash} from './shared.mjs';
8
8
  import {readObject,objectFile,objectDirectory} from './workspace.mjs';
9
+ import {syncStyleCore} from './core.mjs';
10
+ import {locked} from './runtime.mjs';
9
11
  import {callBailian} from './transport/cli.mjs';
10
12
  import {callVision} from './vision.mjs';
11
13
  import {analyzeStyle} from './analyze.mjs';
@@ -20,13 +22,15 @@ try{
20
22
  const analyzer=task.objectKind==='task'?analyzeTaskReferences:analyzeStyle;
21
23
  const report=await analyzer({projectId:task.project,input:task.input,root:task.workspace,refsDir:task.workspace,analysisModel:task.model,cacheDir:join(task.cache,'analysis'),onProgress:progress=>{if(cancelled())throw new Error('分析已取消');task.currentItem={...progress,startedAt:new Date().toISOString()};persist();},runner:async args=>{if(cancelled())throw new Error('分析已取消');const call=process.env.ART_VISION_CONFIG?callVision:callBailian;let captured=false;const capture=data=>{writeJson(join(objectDirectory(task.workspace,task.project,task.objectKind,task.objectId),'reports',task.taskId,'responses',String(++responseIndex)+'.json'),{stage:task.currentItem,...data});captured=true;};const response=await call([...args,'--output','json'],{cancelled,onEvidence:capture,onRemoteCancel:()=>{task.remoteCancellation='client-stopped; upstream execution cannot be confirmed';task.unsettled=true;persist();}});if(!captured)capture({text:extractText(response).join('\n')});return response;}});
22
24
  if(cancelled())throw new Error('分析已取消');
23
- {
24
- // This run owns the object until its final heartbeat; mutation entrypoints refuse active runs.
25
+ await locked(task.root,'control',async()=>{
26
+ // A style may be edited during analysis. Commit only if its source revision still matches.
25
27
  const record=readObject(task.workspace,task.project,task.objectKind,task.objectId);
26
- if(record.revision!==task.sourceRevision||record.status!=='draft'||hash({config:record.config,references:record.references})!==task.sourceHash)throw new Error('分析来源已变化,不回填旧结果');
28
+ if(record.revision!==task.sourceRevision||!['draft',...(task.objectKind==='style'?['frozen']:[])].includes(record.status)||hash({config:record.config,references:record.references})!==task.sourceHash)throw new Error('分析来源已变化,不回填旧结果');
27
29
  assertReportIdentity(report,{project:task.project,id:task.objectId});
28
30
  const reportPath=join(objectDirectory(task.workspace,task.project,task.objectKind,task.objectId),'reports',task.taskId,'report.json');writeJson(reportPath,report);
29
- record.report={data:report,runId:task.taskId,sourceHash:task.sourceHash,sourceRevision:task.sourceRevision,path:reportPath};record.revision++;record.updatedAt=new Date().toISOString();writeJson(objectFile(task.workspace,task.project,task.objectKind,task.objectId),record);task.reportPath=reportPath;
30
- }task.status='succeeded';
31
+ record.report={data:report,runId:task.taskId,sourceHash:task.sourceHash,sourceRevision:task.sourceRevision,path:reportPath};record.revision++;record.updatedAt=new Date().toISOString();
32
+ const rollback=task.objectKind==='style'?syncStyleCore(task.workspace,record):()=>{};
33
+ try{writeJson(objectFile(task.workspace,task.project,task.objectKind,task.objectId),record);}catch(error){rollback();throw error;}task.reportPath=reportPath;
34
+ });task.status='succeeded';
31
35
  }catch(error){task.status=cancelled()?'cancelled':'failed';task.error=error.message;task.errorDetail=errorDetail(error,task.currentItem?.stage??'preflight');}
32
36
  finally{clearInterval(heartbeat);task.stopConfirmed=!task.unsettled&&!task.remoteCancellation;task.finishedAt=new Date().toISOString();persist();}
package/lib/backends.mjs CHANGED
@@ -235,6 +235,8 @@ export function bindBackend(plan, settings, selection) {
235
235
  return bindRemotePlan(plan);
236
236
  }
237
237
  const backend = loadBackend(settings, name, plan.module);
238
+ if (backend.provider === 'comfyui' && plan.items.some(item => (item.imageArgs?.length ?? 0) > (plan.module === 'edit' ? 1 : 0)))
239
+ throw new Error('当前本地工作流尚未适配风格样张输入;请选择支持图片参考的远程模型,或将 styleReferenceMode 设为 text-only');
238
240
  if (sampling !== undefined) backend.options = { ...backend.options, ...sampling };
239
241
  const compatibility =
240
242
  backend.provider !== "comfyui"
@@ -35,7 +35,8 @@ export function candidates(settings,projectId,taskId,runTaskId){
35
35
  return checkRun(manifest,path).filter(c=>c.file).map(c=>{
36
36
  const candidateId=hash({runId:runTaskId,assetId:c.itemId,variantId:c.variantId,file:c.file});
37
37
  const deleted=tombstones.some(d=>d.candidateId===candidateId);
38
- return {...c,runId:runTaskId,candidateId,deleted,editable:c.editable&&!deleted&&executionSettled(run)};
38
+ const output=manifest.items.find(item=>item.itemId===c.itemId&&item.variantId===c.variantId);
39
+ return {...c,...(c.integrity?{hash:output.outputHashes[c.file]}:{}),runId:runTaskId,candidateId,deleted,editable:c.editable&&!deleted&&executionSettled(run)};
39
40
  });
40
41
  }
41
42
  export function finalizations(settings,projectId,taskId){return readObject(settings.paths.workspace,projectId,'task',taskId).finalizations??[];}
@@ -0,0 +1,84 @@
1
+ import {createHash} from 'node:crypto';
2
+ import {mkdir,open,readFile,rm,stat} from 'node:fs/promises';
3
+ import {dirname} from 'node:path';
4
+ import {projectPath} from './video/path.mjs';
5
+ import {withResource} from './video/resource.mjs';
6
+ import {atomicJson} from './video/atomic.mjs';
7
+ const base='.vant/state/video';
8
+ const fail=(code,message,extra={})=>Object.assign(new Error(message),{code,...extra});
9
+ const canonical=value=>Array.isArray(value)?'['+value.map(canonical).join(',')+']':value&&typeof value==='object'?'{'+Object.keys(value).sort().map(key=>JSON.stringify(key)+':'+canonical(value[key])).join(',')+'}':JSON.stringify(value);
10
+ const digest=value=>createHash('sha256').update(value).digest('hex');
11
+ const validExecution=id=>typeof id==='string'&&/^video-[a-f0-9-]{36}$/.test(id);
12
+ export function videoExecutionId(value){
13
+ if(validExecution(value))return value;
14
+ if(typeof value!=='string'||!/^[A-Za-z0-9][A-Za-z0-9._-]{0,127}$/.test(value)||value.endsWith('.')||/^(?:con|prn|aux|nul|com[1-9]|lpt[1-9])(?:\.|$)/i.test(value))throw fail('video-cli-operation-invalid','视频写入需要稳定的 --operation(1–128位字母数字、点、下划线或连字符)。');
15
+ const hash=digest('art-workshop/video/cli/'+value);
16
+ return `video-${hash.slice(0,8)}-${hash.slice(8,12)}-5${hash.slice(13,16)}-a${hash.slice(17,20)}-${hash.slice(20,32)}`;
17
+ }
18
+ async function readRecord(root,path){
19
+ const file=await projectPath(root,path);
20
+ try{const info=await stat(file);if(!info.isFile()||info.size>64*1024*1024)throw new Error('视频操作记录不是有效文件');return JSON.parse(await readFile(file,'utf8'));}
21
+ catch(error){if(error.code==='ENOENT')return null;throw fail('video-cli-record-unknown','视频原操作记录不可读取,请保留并核对,不得重投。',{unknown:true,cause:error});}
22
+ }
23
+ async function syncFile(file){const handle=await open(file,'r+');try{await handle.sync();}finally{await handle.close();}}
24
+ async function durableCreate(root,path,value,{raw=false}={}){
25
+ let file=await projectPath(root,path);await mkdir(dirname(file),{recursive:true});file=await projectPath(root,path);
26
+ const handle=await open(file,'wx',0o600);try{await handle.writeFile(raw?value:JSON.stringify(value));await handle.sync();}finally{await handle.close();}
27
+ }
28
+ async function durableReceipt(file,value){await atomicJson(file,value);await syncFile(file);}
29
+ const terminal=receipt=>receipt&&['succeeded','failed','cancelled','submitted'].includes(receipt.status)&&!receipt.unknown;
30
+ function receiptResult(receipt){
31
+ if(!terminal(receipt))throw fail('video-execution-unknown','原操作结果未知;请查询原身份,不得再次执行。',{unknown:true,operationId:receipt.operationId});
32
+ if(!Object.hasOwn(receipt,'result'))throw fail(receipt.error?.code||'video-failed',receipt.error?.message||'原操作已失败,保留原回执。',{operationId:receipt.operationId});
33
+ const metadata={operationId:receipt.operationId,originOperationId:receipt.originOperationId||null,status:receipt.status},value=receipt.result;
34
+ return value&&typeof value==='object'&&!Array.isArray(value)?{...value,cliExecution:metadata}:{result:value,cliExecution:metadata};
35
+ }
36
+ export async function readChannelOperation({root,operationId}){
37
+ const id=videoExecutionId(operationId),value=await readRecord(root,`${base}/operations/${id}.json`);
38
+ if(!value)return {operationId:id,originOperationId:operationId,status:'not-found'};
39
+ if(value.version!==1||value.operationId!==id)throw fail('video-cli-record-unknown','原操作意图格式损坏,请人工核对。',{unknown:true,operationId:id});
40
+ return {...value,status:value.status==='executing'?'unknown':value.status,unknown:value.unknown===true||['executing','unknown'].includes(value.status)};
41
+ }
42
+ async function claimSharedIntent(root,operationId,request){
43
+ const semanticDigest=digest(canonical(request)),path=`${base}/unresolved/${semanticDigest}.json`,file=await projectPath(root,path),prior=await readRecord(root,path);
44
+ if(prior){
45
+ if(prior.version!==1||prior.semanticDigest!==semanticDigest||!validExecution(prior.operationId))throw fail('business-intent-corrupt','未决操作索引损坏,不得重投。',{unknown:true,operationId:prior.operationId||operationId});
46
+ const receipt=await readChannelOperation({root,operationId:prior.operationId});
47
+ if(!terminal(receipt))throw fail('business-intent-unresolved','相同业务请求已有未决原操作;不能换入口或身份再次执行。',{unknown:true,operationId:prior.operationId});
48
+ await rm(file);
49
+ }
50
+ const value={version:1,operationId,semanticDigest,action:request.action,origin:'cli',createdAt:new Date().toISOString()},raw=JSON.stringify(value);
51
+ await durableCreate(root,path,raw,{raw:true});
52
+ return {semanticDigest,async release(){if(await readFile(file,'utf8').catch(()=>null)===raw)await rm(file,{force:true});}};
53
+ }
54
+ /** CLI admission shares DSH's unresolved claims and receipt format, not a second video state machine. */
55
+ export async function executeChannelOperation({root,workspaceId,operationId:originOperationId,action,input,execute,writeReceipt=durableReceipt}){
56
+ const operationId=videoExecutionId(originOperationId),request={action,input},raw=JSON.stringify(request),requestDigest=digest(raw);
57
+ return withResource(root,`${base}/cli-journal`,async()=>{
58
+ const requestPath=`${base}/requests/${operationId}.json`,receiptPath=`${base}/operations/${operationId}.json`;
59
+ const priorRequest=await readRecord(root,requestPath);
60
+ if(priorRequest&&canonical(priorRequest)!==canonical(request))throw fail('video-operation-conflict','原视频执行身份已用于不同请求;保留原意图。',{operationId});
61
+ const prior=await readChannelOperation({root,operationId});
62
+ if(prior.status!=='not-found'){
63
+ if(prior.workspaceId!==workspaceId||prior.semanticDigest&&prior.semanticDigest!==digest(canonical(request))||!priorRequest)throw fail('video-operation-conflict','原视频回执与当前请求不匹配。',{operationId});
64
+ return receiptResult(prior);
65
+ }
66
+ if(!priorRequest)await durableCreate(root,requestPath,raw,{raw:true});
67
+ const claim=await claimSharedIntent(root,operationId,request);
68
+ const ledger={version:1,operationId,originOperationId,requestDigest,semanticDigest:claim.semanticDigest,workspaceId,action,origin:'cli',sessionId:null,status:'executing',createdAt:new Date().toISOString()};
69
+ await durableCreate(root,receiptPath,ledger);
70
+ let result;
71
+ try{result=JSON.parse(JSON.stringify(await execute()));}
72
+ catch(error){
73
+ ledger.status='unknown';ledger.unknown=true;ledger.error={code:error.code||'video-cli-operation-unknown',message:error.message||'视频写入结果未知'};ledger.settledAt=new Date().toISOString();
74
+ try{await writeReceipt(await projectPath(root,receiptPath),ledger);}catch{}
75
+ throw fail(ledger.error.code,ledger.error.message,{unknown:true,operationId,cause:error});
76
+ }
77
+ const run=result?.operations?.find(operation=>operation.id===input.operationId)?.runs?.at(-1);
78
+ ledger.result=result;ledger.status=run?.status==='unknown'?'unknown':run&&['running','dispatching'].includes(run.status)?'submitted':'succeeded';ledger.unknown=ledger.status==='unknown';ledger.settledAt=new Date().toISOString();
79
+ try{await writeReceipt(await projectPath(root,receiptPath),ledger);}
80
+ catch(error){throw fail('video-receipt-unknown','视频业务已返回但回执未完整落盘;请核对原操作,不得重投。',{unknown:true,operationId,cause:error});}
81
+ if(ledger.status!=='unknown')await claim.release().catch(()=>{});
82
+ return receiptResult(ledger);
83
+ });
84
+ }
package/lib/core.mjs CHANGED
@@ -3,6 +3,7 @@ import { dirname, join } from 'node:path';
3
3
  import { hash, readJson, id, keys, text, texts, choice, writeJson } from './shared.mjs';
4
4
  import { ROOT, loadProject, projectPath } from './project.mjs';
5
5
  import { TOOL_ROOT } from './settings.mjs';
6
+ import {ownedPath} from './workspace.mjs';
6
7
  import {EXAMPLE_CONFIG,STYLE_SCHEMA_VERSION,STYLE_BOUNDARY,OBSERVATION_SCOPES,RULE_TOPICS,RULE_LABELS} from './style-contract.mjs';
7
8
  export {EXAMPLE_CONFIG} from './style-contract.mjs';
8
9
 
@@ -29,20 +30,50 @@ export function freezeCore({ projectId, report, root = ROOT, note = '确认采
29
30
  catch (error) { unlinkSync(path); throw error; }
30
31
  return core;
31
32
  }
33
+ /** Publish a saved style while retaining every prior execution snapshot by hash. */
34
+ export function syncStyleCore(root, record) {
35
+ if (!Array.isArray(record.config.rules) || ['discarded','cleanup-required'].includes(record.status)) return () => {};
36
+ validateCoreConfig({rules:record.config.rules});
37
+ const path=projectPath(root,record.project,'cores',record.id),previous=existsSync(path)?readJson(path):null;
38
+ if(previous){const {coreHash,...body}=previous;if(hash(body)!==coreHash||previous.id!==record.id||previous.project!==record.project)throw new Error('风格核心身份或哈希校验失败');}
39
+ const projectFile=join(root,'projects',record.project,'project.json'),previousProject=loadProject(record.project,root),project=structuredClone(previousProject);
40
+ const body={schema:'art-workshop/core',schemaVersion:STYLE_SCHEMA_VERSION,project:record.project,id:record.id,
41
+ revision:record.revision,guidance:guidance(),config:{rules:structuredClone(record.config.rules)},
42
+ report:record.report?.data??previous?.report??null,approvedSamples:structuredClone(record.samples??[]),
43
+ savedAt:record.updatedAt??record.createdAt};
44
+ const core={...body,coreHash:hash(body)},history=ownedPath(dirname(path),'core-history');
45
+ for(const snapshot of [previous,core].filter(Boolean)){
46
+ const file=ownedPath(history,snapshot.coreHash+'.json');
47
+ if(existsSync(file)){if(hash(readJson(file))!==hash(snapshot))throw new Error('历史风格快照完整性校验失败');}
48
+ else {mkdirSync(history,{recursive:true});writeFileSync(file,JSON.stringify(snapshot,null,2)+'\n',{encoding:'utf8',flag:'wx'});}
49
+ }
50
+ const rollback=()=>{if(previous)writeJson(path,previous);else if(existsSync(path))unlinkSync(path);writeJson(projectFile,previousProject);};
51
+ try{
52
+ writeJson(path,core);
53
+ if(!project.cores.includes(record.id)){project.cores.push(record.id);project.defaultCore??=record.id;project.revision=(project.revision??1)+1;writeJson(projectFile,project);}
54
+ }catch(error){rollback();throw error;}
55
+ record.status='frozen';record.coreHash=core.coreHash;
56
+ return rollback;
57
+ }
32
58
  export function loadCore(projectId, coreId, root = ROOT) {
33
59
  const project = loadProject(projectId, root);
34
60
  if (!project.cores.includes(coreId)) throw new Error(`核心 ${coreId} 不属于工程 ${projectId}`);
61
+ const recordFile=join(dirname(projectPath(root,projectId,'cores',coreId)),'style.json'),record=existsSync(recordFile)?readJson(recordFile):null;
62
+ if(record&&['discarded','cleanup-required'].includes(record.status))throw new Error('风格已归档或不可用,请选择有效风格');
35
63
  const core = readJson(projectPath(root, projectId, 'cores', coreId));
36
64
  const { coreHash, ...body } = core;
37
65
  if (core.schema !== 'art-workshop/core' || core.project !== projectId || core.id !== coreId || hash(body) !== coreHash) throw new Error('冻结核心身份或哈希校验失败');
38
- if(core.schemaVersion!==STYLE_SCHEMA_VERSION)throw new Error('旧风格核心需派生并重新分析采用,不能自动转换造型、材质或光照约束');
66
+ if(core.revision!==undefined&&record&&(record.revision!==core.revision||record.coreHash!==coreHash))throw new Error('风格保存尚未完成,请重新读取并保存;不能执行不匹配的版本');
67
+ if(core.schemaVersion!==STYLE_SCHEMA_VERSION)throw new Error('旧风格核心需派生并重新整理保存规则,不能自动转换造型、材质或光照约束');
39
68
  validateCoreConfig(core.config); return core;
40
69
  }
41
70
  export function selectCore(project, job, requested, root = ROOT) {
42
71
  if (requested && job.core && requested !== job.core) throw new Error('指定核心与任务绑定冲突;请明确修改任务的 core');
43
72
  const selected = requested ?? job.core ?? project.defaultCore;
44
73
  if (!selected) throw new Error('未选定基础核心;请指定 core,不能猜测或跨工程回退');
45
- return { core: loadCore(project.id, selected, root), source: requested ? '显式选择' : job.core ? '任务绑定' : '工程默认' };
74
+ const core=loadCore(project.id,selected,root);
75
+ if(!core.config.rules.length)throw new Error('config.rules 至少需要一条有效绘制规则才能编译生成预案');
76
+ return { core, source: requested ? '显式选择' : job.core ? '任务绑定' : '工程默认' };
46
77
  }
47
78
 
48
79
  export function corePrompt(core) {
package/lib/edit.mjs CHANGED
@@ -4,6 +4,7 @@ import {description,descriptions} from './shared.mjs';
4
4
  import {editingPrompt,COMPILER_VERSION} from './prompt-structure.mjs';
5
5
  import {TRANSPARENT_OUTPUT} from './transparent-output.mjs';
6
6
  import {taskReferencePrompt} from './task-references.mjs';
7
+ import {styleSampleInputs} from './style-samples.mjs';
7
8
  import {readObject,verifyReferences} from './workspace.mjs';
8
9
  import {keys,id,text,integer,hash} from './shared.mjs';
9
10
  import {ROOT,loadProject,loadJob,sourcePath} from './project.mjs';
@@ -14,10 +15,11 @@ import {sha256File} from './bl.mjs';
14
15
  export function compileEdit({projectId,jobId,coreId,root=ROOT,localExecution={}}) {
15
16
  const taskRecord=readObject(root,projectId,'task',jobId);assertObjectCurrent(root,taskRecord);const dynamicRefs=verifyReferences(root,taskRecord);
16
17
  const project=loadProject(projectId,root),job=loadJob(projectId,jobId,'edit',root);
17
- keys(job,['project','kind','core','execution','analysis','generation','items'],'edit job');
18
+ keys(job,['project','kind','core','execution','analysis','generation','styleReferenceMode','items'],'edit job');
18
19
  if(job.generation&&localExecution.model)job.execution={...job.execution,model:localExecution.model};
19
20
  if(coreId&&job.core&&coreId!==job.core) throw new Error('核心与编辑任务绑定冲突');
20
21
  const selected=coreId??job.core,core=selected?loadCore(projectId,selected,root):null,refs=dynamicRefs.map(r=>({path:r.path,hash:r.hash})),items=[],ids=new Set();
22
+ const styleInputs=styleSampleInputs(root,projectId,core,job.styleReferenceMode);refs.push(...styleInputs.refs);
21
23
  if(!Array.isArray(job.items)||!job.items.length) throw new Error('编辑 items 必须非空');
22
24
  for(const [sourceIndex,source] of job.items.entries()) {
23
25
  keys(source,EDIT_FIELDS,'edit item');
@@ -35,7 +37,7 @@ export function compileEdit({projectId,jobId,coreId,root=ROOT,localExecution={}}
35
37
  if(source.changes.filter(x=>x.target==='background').length>1) throw new Error(`编辑对象 ${source.id} 只能设置一个最终背景,请合并 changes 中的 background`);
36
38
  if(core&&(changed.has('style')||preserved.has('style'))) throw new Error('绑定核心时,风格由核心负责,不能再声明修改或保留原风格');
37
39
  descriptions(source.mustRead,'mustRead');const seed=source.seed??parseInt(hash([projectId,jobId,source.id]).slice(0,7),16);integer(seed,'seed');
38
- items.push({...(source.changes.some(x=>x.target==='background'&&x.value?.type==='transparent')?{output:TRANSPARENT_OUTPUT}:{}),itemId:source.id,variantId:'base',seed,brief:source,prompt:editingPrompt({changes,preserve,frozen:core?corePrompt(core):'',references:taskReferencePrompt(taskRecord,source.id),mustRead:source.mustRead,textSpecs:readable}),negativeBlock:textFidelityNegative(core?coreNegative(core):'',readable),imageArgs:[path],checks:{content:readable.length?[...source.mustRead,...readable.map(textSpecLine)]:source.mustRead,style:core?[corePrompt(core)]:['原图风格保持一致'],asset:changes.concat(preserve)}});
40
+ items.push({...(source.changes.some(x=>x.target==='background'&&x.value?.type==='transparent')?{output:TRANSPARENT_OUTPUT}:{}),itemId:source.id,variantId:'base',seed,brief:source,prompt:editingPrompt({changes,preserve,frozen:core?corePrompt(core):'',references:[taskReferencePrompt(taskRecord,source.id),styleInputs.prompt?'输入图1是编辑底图,后续图片按顺序是风格样张。\n'+styleInputs.prompt:''].filter(Boolean).join('\n'),mustRead:source.mustRead,textSpecs:readable}),negativeBlock:textFidelityNegative(core?coreNegative(core):'',readable),imageArgs:[path,...styleInputs.refs.map(ref=>ref.path)],checks:{content:readable.length?[...source.mustRead,...readable.map(textSpecLine)]:source.mustRead,style:core?[corePrompt(core)]:['原图风格保持一致'],asset:changes.concat(preserve)}});
39
41
  }
40
- return finishPlan({compilerVersion:COMPILER_VERSION,module:'edit',project:projectId,job:jobId,execution:execution(project,job.execution,localExecution),sources:{taskRevision:taskRecord.revision,taskConfigHash:hash(taskRecord.config),core:core?.id??null,coreHash:core?.coreHash??null,selection:selected?'编辑显式绑定':'保留原图'},snapshots:{project,core,job},refs,items});
42
+ return finishPlan({compilerVersion:COMPILER_VERSION,module:'edit',project:projectId,job:jobId,execution:execution(project,job.execution,localExecution),sources:{taskRevision:taskRecord.revision,taskConfigHash:hash(taskRecord.config),core:core?.id??null,coreHash:core?.coreHash??null,selection:selected?'编辑显式绑定':'保留原图'},snapshots:{project,core,job},styleReferences:styleInputs.selection,refs,items});
41
43
  }
package/lib/generate.mjs CHANGED
@@ -4,6 +4,7 @@ import {generationPrompt,COMPILER_VERSION} from './prompt-structure.mjs';
4
4
  import {TRANSPARENT_OUTPUT} from './transparent-output.mjs';
5
5
  import {GENERATION_FIELDS,textSpecs,textSpecLine,textFidelityNegative} from './task-contract.mjs';
6
6
  import {taskReferencePrompt} from './task-references.mjs';
7
+ import {styleSampleInputs} from './style-samples.mjs';
7
8
  import {readObject,verifyReferences} from './workspace.mjs';
8
9
  import { keys, id, integer, hash } from './shared.mjs';
9
10
  import { ROOT,loadProject,loadJob } from './project.mjs';
@@ -15,9 +16,10 @@ import {design,designPrompt} from './design.mjs';
15
16
  export function compileGenerate({projectId,jobId,coreId,root=ROOT,localExecution={}}) {
16
17
  const taskRecord=readObject(root,projectId,'task',jobId);assertObjectCurrent(root,taskRecord);const dynamicRefs=verifyReferences(root,taskRecord);
17
18
  const project=loadProject(projectId,root),job=loadJob(projectId,jobId,'generate',root);
18
- keys(job,['project','kind','core','profile','asset','execution','analysis','generation','items'],'job');
19
+ keys(job,['project','kind','core','profile','asset','execution','analysis','generation','styleReferenceMode','items'],'job');
19
20
  if(job.generation&&localExecution.model)job.execution={...job.execution,model:localExecution.model};
20
21
  const selected=selectCore(project,job,coreId,root),core=selected.core;
22
+ const styleInputs=styleSampleInputs(root,projectId,core,job.styleReferenceMode);
21
23
  const profile=resolveAssetProfile(root,projectId,job);
22
24
  const items=[],ids=new Set();
23
25
  if(!Array.isArray(job.items)||!job.items.length) throw new Error('任务 items 必须非空');
@@ -51,8 +53,8 @@ export function compileGenerate({projectId,jobId,coreId,root=ROOT,localExecution
51
53
  const p=presentation(profile,{...source.composition,...variant.composition},d);
52
54
  if(!objectIds.has(p.value.focalTarget)) throw new Error('视觉焦点不存在');
53
55
  const seed=variant.seed??source.seed??parseInt(hash([projectId,jobId,source.id]).slice(0,7),16); integer(seed,'seed');
54
- items.push({...(p.value.background.type==='transparent'?{output:TRANSPARENT_OUTPUT}:{}),...(d?{design:d,execution:execution(project,{...job.execution,size:`${d.outputSize.width}*${d.outputSize.height}`},localExecution)}:{}),itemId:source.id,variantId:variant.id,seed,brief:{...source,composition:p.value},prompt:generationPrompt({intent:source.intent,frozen:corePrompt(core),details:lines,composition:`视觉焦点:${p.value.focalTarget}。\n${p.prompt}`,delivery:d?designPrompt(d):'',asset:assetPrompt(profile),references:taskReferencePrompt(taskRecord,source.id),mustRead:source.mustRead,textSpecs:readable}),negativeBlock:textFidelityNegative([coreNegative(core),profile.constraints.text?'':'文字, 字母, 水印',profile.constraints.frame?'':'装饰外框'].filter(Boolean).join(', '),readable),imageArgs:[],checks:{content:readable.length?[...source.mustRead,...readable.map(textSpecLine)]:source.mustRead,style:[corePrompt(core)],asset:[...profile.checks,p.background]}});
56
+ items.push({...(p.value.background.type==='transparent'?{output:TRANSPARENT_OUTPUT}:{}),...(d?{design:d,execution:execution(project,{...job.execution,size:`${d.outputSize.width}*${d.outputSize.height}`},localExecution)}:{}),itemId:source.id,variantId:variant.id,seed,brief:{...source,composition:p.value},prompt:generationPrompt({intent:source.intent,frozen:corePrompt(core),details:lines,composition:`视觉焦点:${p.value.focalTarget}。\n${p.prompt}`,delivery:d?designPrompt(d):'',asset:assetPrompt(profile),references:[taskReferencePrompt(taskRecord,source.id),styleInputs.prompt].filter(Boolean).join('\n'),mustRead:source.mustRead,textSpecs:readable}),negativeBlock:textFidelityNegative([coreNegative(core),profile.constraints.text?'':'文字, 字母, 水印',profile.constraints.frame?'':'装饰外框'].filter(Boolean).join(', '),readable),imageArgs:styleInputs.refs.map(ref=>ref.path),checks:{content:readable.length?[...source.mustRead,...readable.map(textSpecLine)]:source.mustRead,style:[corePrompt(core)],asset:[...profile.checks,p.background]}});
55
57
  }
56
58
  }
57
- return finishPlan({compilerVersion:COMPILER_VERSION,module:'generate',project:projectId,job:jobId,execution:execution(project,job.execution,localExecution),sources:{taskRevision:taskRecord.revision,taskConfigHash:hash(taskRecord.config),core:core.id,coreHash:core.coreHash,selection:selected.source},snapshots:{project,core,profile,job},refs:dynamicRefs.map(r=>({path:r.path,hash:r.hash})),items});
59
+ return finishPlan({compilerVersion:COMPILER_VERSION,module:'generate',project:projectId,job:jobId,execution:execution(project,job.execution,localExecution),sources:{taskRevision:taskRecord.revision,taskConfigHash:hash(taskRecord.config),core:core.id,coreHash:core.coreHash,selection:selected.source},snapshots:{project,core,profile,job},styleReferences:styleInputs.selection,refs:[...dynamicRefs.map(r=>({path:r.path,hash:r.hash})),...styleInputs.refs],items});
58
60
  }
@@ -67,7 +67,7 @@ export function validateRemotePlan(plan, registry = modelRegistry) {
67
67
  )
68
68
  throw new Error("seed 超出模型范围");
69
69
  if ((item.imageArgs ?? []).length > compatibility.maxImages)
70
- throw new Error("参考输入图片超过模型上限");
70
+ throw new Error("参考输入图片超过模型上限(包括编辑底图和风格样张);请减少运行时参考,或选择 text-only");
71
71
  if (plan.module === "edit" && !(item.imageArgs ?? []).length)
72
72
  throw new Error("编辑模型需要输入底图");
73
73
  if (!compatibility.fields?.promptExtend && e.promptExtend)
@@ -51,7 +51,7 @@ export function inspectObjectFormat(record, { core, dependency } = {}) {
51
51
  );
52
52
  }
53
53
  if (
54
- record.report &&
54
+ !Array.isArray(c.rules) && record.report &&
55
55
  record.report.data?.schemaVersion !== STYLE_SCHEMA_VERSION
56
56
  )
57
57
  reasons.push("风格报告职责格式已弃用");
@@ -97,7 +97,7 @@ export function inspectObjectFormat(record, { core, dependency } = {}) {
97
97
  return {
98
98
  status,
99
99
  reasons,
100
- canEdit: status === "current" && record.status !== "frozen",
100
+ canEdit: status === "current" && !["discarded", "cleanup-required"].includes(record.status),
101
101
  canDerive: !["discarded", "cleanup-required"].includes(record.status),
102
102
  };
103
103
  }
@@ -1,10 +1,10 @@
1
1
  import {textSpecLine} from './task-contract.mjs';
2
- export const COMPILER_VERSION = 4;
2
+ export const COMPILER_VERSION = 5;
3
3
  const textSection=entries=>entries?.length?`【画面文字规格】\n仅将「」内的内容作为画面文字,其余为布局要求。\n${entries.map(entry=>'- '+textSpecLine(entry)).join('\n')}`:'';
4
4
  export function generationPrompt({intent,frozen,details,composition,delivery,asset,references,mustRead,textSpecs}){
5
5
  return [
6
6
  `【本次用途与主体】\n${intent}。`,
7
- `【静态冻结风格】\n${frozen}`,
7
+ `【当前风格规则】\n${frozen}`,
8
8
  `【动态需求:主体、细节与关系】\n${details.join('\n')}`,
9
9
  `【动态构图与背景】\n${composition}`,
10
10
  `【交付规格与约束】\n${[delivery,asset].filter(Boolean).join('\n')}`,
@@ -18,7 +18,7 @@ export function editingPrompt({changes,preserve,frozen,references,mustRead,textS
18
18
  '【本次任务】\n基于输入原图编辑。未声明修改的部分保持原样。',
19
19
  `【动态修改要求】\n${changes.join('\n')}`,
20
20
  `【动态保留要求】\n${preserve.join('\n')}`,
21
- frozen?`【静态冻结风格】\n${frozen}`:'',
21
+ frozen?`【当前风格规则】\n${frozen}`:'',
22
22
  mustRead?.length?`【必须可读的特征】\n${[...new Set(mustRead)].map(x=>'- '+x).join('\n')}`:'',
23
23
  textSection(textSpecs),
24
24
  references,
package/lib/service.mjs CHANGED
@@ -121,6 +121,27 @@ export async function shutdownOwnedServices() {
121
121
  export async function closeService(root,endpoint,backend) {
122
122
  return locked(serviceRoot(),'queue-'+new URL(endpoint).port,()=>closeSharedService(serviceRoot(),endpoint,backend));
123
123
  }
124
+ const ownedCloseFailure=(code,message)=>Object.assign(new Error(message),{code});
125
+ async function assertOwnedPortReleased(endpoint){
126
+ const url=new URL(endpoint),hosts=url.hostname==='localhost'?['127.0.0.1','::1']:[url.hostname.replace(/^\[|\]$/g,'')];
127
+ for(const host of hosts)await new Promise((resolve,reject)=>{const probe=createServer();probe.once('error',error=>reject(Object.assign(ownedCloseFailure('service-owned-stop-unconfirmed','原服务已停止,但端口仍被占用或无法核对;不会停止其他进程'),{cause:error})));probe.listen({host,port:Number(url.port||80),exclusive:true},()=>probe.close(error=>error?reject(error):resolve()));});
128
+ }
129
+ /** Strict application-owned close: checks stay inside the shared queue/service locks and never adopt an external PID. */
130
+ export async function closeOwnedService(root,endpoint,backend,{owner,identity}={},dependencies={}){
131
+ const url=new URL(endpoint);
132
+ if(url.protocol!=='http:'||!['127.0.0.1','localhost','[::1]'].includes(url.hostname)||url.pathname!=='/'||url.search||url.hash||url.username||url.password)throw ownedCloseFailure('service-owned-endpoint-invalid','只能关闭已记录的本机服务');
133
+ if(!owner?.instanceId||!Number.isSafeInteger(identity?.pid)||identity.pid<=0)throw ownedCloseFailure('service-owner-mismatch','缺少明确的服务所有者与原进程身份');
134
+ const expected=structuredClone({owner,identity}),controlRoot=serviceRoot();
135
+ const lock=dependencies.lock||locked,read=dependencies.readRecord||rememberedService,inspect=dependencies.inspect||processIdentity,health=dependencies.health||healthy,queue=dependencies.queue||((endpoint)=>http(endpoint,'/queue')),stop=dependencies.stop||stopIdentity,portReleased=dependencies.portReleased||assertOwnedPortReleased,write=dependencies.writeRecord||((root,endpoint,value)=>writeJson(serviceFile(root,endpoint),value));
136
+ const assertRecord=(checkProcess=true)=>{const record=read(root,endpoint);if(record?.endpoint!==endpoint||record.owned!==true||record.stopped||hash(record.owner)!==hash(expected.owner)||hash(record.identity)!==hash(expected.identity))throw ownedCloseFailure('service-owner-mismatch','服务所有者或原进程记录已变化,停止未确认');if(checkProcess&&hash(inspect(expected.identity.pid))!==hash(expected.identity))throw ownedCloseFailure('service-owner-mismatch','原服务进程身份已变化,拒绝关闭其他进程');return record;};
137
+ return lock(controlRoot,'queue-'+url.port,()=>lock(controlRoot,'services',async()=>{
138
+ assertRecord();const reachable=await health(endpoint,backend);assertRecord();
139
+ if(reachable){const observed=await queue(endpoint);assertRecord();if((observed.queue_running??[]).length||(observed.queue_pending??[]).length)throw ownedCloseFailure('service-shared-busy','共享服务仍有其他任务,保留服务');}
140
+ assertRecord();await stop(expected.identity);
141
+ if(hash(inspect(expected.identity.pid))===hash(expected.identity)||await health(endpoint,backend))throw ownedCloseFailure('service-owned-stop-unconfirmed','原服务停止尚未确认;不会关闭新占用端口的进程');
142
+ await portReleased(endpoint);const record=assertRecord(false);write(root,endpoint,{...record,owned:false,stopped:true,stoppedAt:new Date().toISOString()});return {endpoint,stopped:true,portReleased:true};
143
+ }));
144
+ }
124
145
  async function closeSharedService(root,endpoint,backend) {
125
146
  if(await healthy(endpoint,backend)){const queue=await http(endpoint,'/queue');if((queue.queue_running??[]).length||(queue.queue_pending??[]).length)throw new Error('共享服务仍有其他任务,保留服务');}
126
147
  const remembered=rememberedService(root,endpoint);