@kevlns/art-workshop 0.4.2 → 0.5.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 (68) hide show
  1. package/AGENTS.md +25 -105
  2. package/LICENSE +21 -21
  3. package/README.md +63 -63
  4. package/art-workshop.mjs +174 -167
  5. package/docs/commands.md +116 -8
  6. package/docs/configuration.md +82 -82
  7. package/docs/core-guidance.md +50 -50
  8. package/docs/data-formats.md +85 -79
  9. package/docs/deployment.md +32 -32
  10. package/docs/local-models/qwen-image-2.1.json +73 -73
  11. package/docs/local-models/qwen-image-2.1.md +33 -33
  12. package/docs/model-architecture.md +78 -78
  13. package/docs/modes.md +67 -67
  14. package/lib/agent.mjs +32 -47
  15. package/lib/analysis-worker.mjs +32 -29
  16. package/lib/analyze.mjs +85 -78
  17. package/lib/asset-profile.mjs +23 -0
  18. package/lib/candidates.mjs +103 -101
  19. package/lib/comfy-recovery.mjs +17 -17
  20. package/lib/conversation.mjs +77 -0
  21. package/lib/core.mjs +75 -89
  22. package/lib/deployment-guide.mjs +12 -12
  23. package/lib/design.mjs +29 -29
  24. package/lib/dimensions.mjs +22 -22
  25. package/lib/edit.mjs +41 -38
  26. package/lib/environment-operations.mjs +49 -49
  27. package/lib/environment-runtime.mjs +99 -99
  28. package/lib/environments.mjs +55 -55
  29. package/lib/errors.mjs +32 -0
  30. package/lib/executor.mjs +107 -107
  31. package/lib/generate.mjs +58 -59
  32. package/lib/heartbeat.mjs +16 -16
  33. package/lib/images.mjs +1 -1
  34. package/lib/lifecycle.mjs +53 -53
  35. package/lib/migration.mjs +154 -154
  36. package/lib/object-format.mjs +112 -0
  37. package/lib/presentation.mjs +18 -2
  38. package/lib/process-identity.mjs +14 -14
  39. package/lib/project.mjs +39 -39
  40. package/lib/prompt-structure.mjs +7 -3
  41. package/lib/refs.mjs +26 -26
  42. package/lib/runtime.mjs +25 -25
  43. package/lib/service.mjs +126 -126
  44. package/lib/settings.mjs +50 -50
  45. package/lib/shared.mjs +67 -66
  46. package/lib/style-bundle.mjs +85 -85
  47. package/lib/style-contract.mjs +74 -35
  48. package/lib/style-evidence.mjs +39 -0
  49. package/lib/style-lifecycle.mjs +125 -120
  50. package/lib/style-report.mjs +201 -0
  51. package/lib/style-review.mjs +14 -75
  52. package/lib/task-contract.mjs +93 -59
  53. package/lib/tasks.mjs +497 -495
  54. package/lib/templates.mjs +80 -70
  55. package/lib/vision.mjs +56 -46
  56. package/lib/workspace.mjs +292 -238
  57. package/package.json +3 -5
  58. package/rules/core-guidance.json +22 -22
  59. package/skills/art-workshop/SKILL.md +17 -112
  60. package/skills/art-workshop/references/conversation.md +11 -0
  61. package/skills/art-workshop/references/expression.md +27 -0
  62. package/skills/art-workshop/references/getty.md +76 -0
  63. package/skills/art-workshop/references/project.md +109 -0
  64. package/skills/art-workshop/references/style-discussion.md +27 -0
  65. package/skills/art-workshop/scripts/getty.py +269 -0
  66. package/v-cli.plugin.json +2747 -2491
  67. package/scripts/sync-skill.mjs +0 -6
  68. /package/{skills/art-workshop → adapters/codex}/agents/openai.yaml +0 -0
package/lib/templates.mjs CHANGED
@@ -1,70 +1,80 @@
1
- import {loadCore} from './core.mjs';
2
- import {loadProject} from './project.mjs';
3
- import {LOCAL_SAMPLING_DEFAULTS} from './task-contract.mjs';
4
- function generateTemplate(projectId,core,kind) {
5
- return {
6
- project: projectId,
7
- kind: "generate",
8
- core,
9
- asset: {
10
- project: projectId,
11
- id: "custom",
12
- name: "自定义画布",
13
- constraints: {
14
- text: false,
15
- frame: false,
16
- scene: false,
17
- crop: false,
18
- shadow: false,
19
- },
20
- defaults: {
21
- preset: "centered",
22
- view: "正面",
23
- direction: "无方向",
24
- occupancy: 0.7,
25
- effectIntensity: "中",
26
- background: { type: "solid", color: "#FFFFFF" },
27
- },
28
- allowedOverrides: {
29
- preset: ["centered"],
30
- view: ["正面", "等距视角", "俯视"],
31
- direction: ["无方向"],
32
- occupancy: { min: 0.1, max: 0.95 },
33
- effectIntensity: ["弱", "中", "强"],
34
- },
35
- presets: { centered: "主体居中,完整展示,四周保留安全空间" },
36
- checks: ["主体完整", "需求明确"],
37
- design: { resolution: { width: 512, height: 512 }, outputScale: 1 },
38
- },
39
- items: [
40
- {
41
- id: "asset-1",
42
- intent: "",
43
- entities: [
44
- {
45
- id: "subject",
46
- kind,
47
- appearance: "",
48
- color: "保持需求所述身份色",
49
- role: "primary",
50
- count: 1,
51
- },
52
- ],
53
- effects: [],
54
- composition: { focalTarget: "subject" },
55
- mustRead: [],
56
- variants: [{ id: "base" }],
57
- },
58
- ],
59
- };
60
- }
61
-
62
-
63
- export function jobTemplate(root,projectId,{kind='generate',core}={}){
64
- loadProject(projectId,root);
65
- const generation={backend:'local-qwen',options:{...LOCAL_SAMPLING_DEFAULTS}};
66
- if(kind==='edit')return {project:projectId,kind:'edit',generation,items:[{id:'asset-1',changes:[],preserve:[],mustRead:[]}]};
67
- if(kind!=='generate'||!core)throw new Error('生成草稿需要选择已冻结核心');
68
- loadCore(projectId,core,root);
69
- return {...generateTemplate(projectId,core,'subject'),generation};
70
- }
1
+ import {loadCore} from './core.mjs';
2
+ import {loadProject} from './project.mjs';
3
+ import {LOCAL_SAMPLING_DEFAULTS} from './task-contract.mjs';
4
+ export function generateTemplate(projectId,core,kind) {
5
+ return {
6
+ project: projectId,
7
+ kind: "generate",
8
+ core,
9
+ asset: {
10
+ project: projectId,
11
+ id: "custom",
12
+ name: "自定义画布",
13
+ constraints: {
14
+ text: false,
15
+ frame: false,
16
+ scene: false,
17
+ crop: false,
18
+ shadow: false,
19
+ },
20
+ defaults: {
21
+ preset: "centered",
22
+ view: "正面",
23
+ direction: "无方向",
24
+ occupancy: 0.7,
25
+ effectIntensity: "中",
26
+ lightDirection: "左上方",
27
+ lightQuality: "柔和",
28
+ background: { type: "solid", color: "#FFFFFF" },
29
+ },
30
+ allowedOverrides: {
31
+ preset: ["centered"],
32
+ view: ["正面", "等距视角", "俯视"],
33
+ direction: ["无方向"],
34
+ occupancy: { min: 0.1, max: 0.95 },
35
+ effectIntensity: ["弱", "中", "强"],
36
+ lightDirection: ["左上方", "右上方", "正面", "顶部", "背面"],
37
+ lightQuality: ["柔和", "硬朗", "均匀棚光", "戏剧性对比"],
38
+ },
39
+ presets: { centered: "主体居中,完整展示,四周保留安全空间" },
40
+ checks: ["主体完整", "需求明确"],
41
+ design: { resolution: { width: 512, height: 512 }, outputScale: 1 },
42
+ },
43
+ items: [
44
+ {
45
+ id: "asset-1",
46
+ intent: "",
47
+ entities: [
48
+ {
49
+ id: "subject",
50
+ kind,
51
+ appearance: "",
52
+ color: "保持需求所述身份色",
53
+ role: "primary",
54
+ count: 1,
55
+ },
56
+ ],
57
+ effects: [],
58
+ composition: { focalTarget: "subject" },
59
+ mustRead: [],
60
+ variants: [{ id: "base" }],
61
+ },
62
+ ],
63
+ };
64
+ }
65
+
66
+
67
+ export function jobTemplate(root,projectId,{kind='generate',core}={}){
68
+ loadProject(projectId,root);
69
+ const generation={backend:'local-qwen',options:{...LOCAL_SAMPLING_DEFAULTS}};
70
+ if(kind==='edit')return {project:projectId,kind:'edit',generation,items:[{id:'asset-1',changes:[],preserve:[],mustRead:[]}]};
71
+ if(kind!=='generate'||!core)throw new Error('生成草稿需要选择已冻结核心');
72
+ loadCore(projectId,core,root);
73
+ return {...generateTemplate(projectId,core,'subject'),generation};
74
+ }
75
+
76
+ export function emptyJobTemplate(projectId,kind='generate'){
77
+ const generation={backend:'local-qwen',options:{...LOCAL_SAMPLING_DEFAULTS}};
78
+ if(kind==='edit')return {project:projectId,kind,generation,items:[{id:'asset-1',changes:[],preserve:[],mustRead:[]}]};
79
+ if(kind!=='generate')throw new Error('任务类型非法');return {...generateTemplate(projectId,null,'subject'),generation};
80
+ }
package/lib/vision.mjs CHANGED
@@ -1,46 +1,56 @@
1
- import {readFileSync} from 'node:fs';
2
-
3
- /** The harness supplies one selected credential in process memory, never in argv or run evidence. */
4
- export async function callVision(args,{cancelled=()=>false,onRemoteCancel,transport=fetch}={}) {
5
- const config=JSON.parse(process.env.ART_VISION_CONFIG??'null'),key=process.env.ART_VISION_KEY;
6
- if(!config||!key)throw new Error('视觉模型实例未配置');
7
- const value=name=>args[args.indexOf(name)+1],model=value('--model');
8
- const image=args.includes('--image')?value('--image'):null,text=args.includes('--prompt')?value('--prompt'):value('--message');
9
- if(!model||!text)throw new Error('视觉调用缺少模型或提示');
10
- if(config.model&&model!==config.model)throw new Error('视觉模型与授权实例不匹配');
11
- const configuredTokens=config.maxTokens??16384;if(!Number.isSafeInteger(configuredTokens)||configuredTokens<1024)throw new Error('视觉模型输出额度非法');
12
- const maxTokens=Math.min(configuredTokens,32768);
13
- const base=new URL(config.baseUrl);if(!['http:','https:'].includes(base.protocol)||base.username||base.password||base.search||base.hash)throw new Error('视觉模型地址非法');
14
- let mime='image/png',data;if(image){const bytes=readFileSync(image);mime=bytes[0]===255?'image/jpeg':bytes.subarray(0,4).toString()==='RIFF'?'image/webp':'image/png';data=bytes.toString('base64');}
15
- let endpoint,headers,body;
16
- if(config.api==='openai-completions'){
17
- endpoint='/chat/completions';headers={Authorization:'Bearer '+key};body={model,messages:[{role:'user',content:[{type:'text',text},...(data?[{type:'image_url',image_url:{url:`data:${mime};base64,${data}`}}]:[])]}],max_tokens:maxTokens};
18
- }else if(config.api==='openai-responses'){
19
- endpoint='/responses';headers={Authorization:'Bearer '+key};body={model,input:[{role:'user',content:[{type:'input_text',text},...(data?[{type:'input_image',image_url:`data:${mime};base64,${data}`}]:[])]}],max_output_tokens:maxTokens};
20
- }else if(config.api==='anthropic-messages'){
21
- endpoint='/messages';headers={'x-api-key':key,'anthropic-version':'2023-06-01'};body={model,max_tokens:maxTokens,messages:[{role:'user',content:[...(data?[{type:'image',source:{type:'base64',media_type:mime,data}}]:[]),{type:'text',text}]}]};
22
- }else if(config.api==='google-generative-ai'){
23
- endpoint='/models/'+encodeURIComponent(model)+':generateContent';headers={'x-goog-api-key':key};body={contents:[{role:'user',parts:[{text},...(data?[{inlineData:{mimeType:mime,data}}]:[])]}],generationConfig:{maxOutputTokens:maxTokens}};
24
- }else throw new Error('视觉模型协议尚未适配');
25
- if(cancelled())throw new Error('分析已取消');
26
- const controller=new AbortController();let sent=false;
27
- const timer=setInterval(()=>{if(cancelled())controller.abort();},100),timeout=setTimeout(()=>controller.abort(),300000);
28
- try{
29
- sent=true;
30
- const response=await transport(base.href.replace(/\/$/,'')+endpoint,{method:'POST',headers:{...headers,'Content-Type':'application/json'},body:JSON.stringify(body),redirect:'error',signal:controller.signal});
31
- if(!response.ok)throw new Error('视觉模型请求失败(HTTP '+response.status+')');
32
- const reader=response.body?.getReader();if(!reader)throw new Error('视觉模型未返回报告');
33
- const chunks=[];let size=0;
34
- while(true){const next=await reader.read();if(next.done)break;size+=next.value.byteLength;if(size>8_000_000){await reader.cancel();throw new Error('视觉响应过大');}chunks.push(next.value);}
35
- const raw=Buffer.concat(chunks).toString('utf8');
36
- const result=JSON.parse(raw);
37
- if(result.choices?.[0]?.finish_reason==='length'||result.status==='incomplete'||result.stop_reason==='max_tokens'||result.candidates?.some(c=>c.finishReason==='MAX_TOKENS'))throw new Error('视觉报告超出模型输出额度,请调整输出额度后重新分析;未回填截断结果');
38
- // Return only assistant text, rather than recursively interpreting arbitrary response metadata as a report.
39
- const texts=config.api==='openai-completions'?[result.choices?.[0]?.message?.content]:config.api==='openai-responses'?(result.output??[]).flatMap(item=>(item.content??[]).filter(c=>c.type==='output_text').map(c=>c.text)):config.api==='anthropic-messages'?(result.content??[]).filter(c=>c.type==='text').map(c=>c.text):(result.candidates??[]).flatMap(item=>(item.content?.parts??[]).map(c=>c.text));
40
- if(!texts.length||texts.some(t=>typeof t!=='string'))throw new Error('视觉模型未返回文字报告');
41
- return {text:texts.join('\n')};
42
- }catch(error){
43
- if(sent&&(controller.signal.aborted||error instanceof TypeError)){onRemoteCancel?.();throw new Error(cancelled()?'分析请求已取消;云端计算与计费是否停止无法确认,不会自动重发':'分析请求超时或连接中断;云端计算与计费是否停止无法确认,未回填报告,不会自动重发');}
44
- throw new Error(/^视觉/.test(error.message)?error.message:'视觉模型响应解析失败');
45
- }finally{clearInterval(timer);clearTimeout(timeout);}
46
- }
1
+ import {AnalysisError} from './errors.mjs';
2
+ import {readFileSync} from 'node:fs';
3
+
4
+ /** The harness supplies one selected credential in process memory, never in argv or run evidence. */
5
+ export async function callVision(args,{cancelled=()=>false,onRemoteCancel,onEvidence=()=>{},transport=fetch}={}) {
6
+ const config=JSON.parse(process.env.ART_VISION_CONFIG??'null'),key=process.env.ART_VISION_KEY;
7
+ if(!config||!key)throw new Error('视觉模型实例未配置');
8
+ const value=name=>args[args.indexOf(name)+1],model=value('--model');
9
+ const image=args.includes('--image')?value('--image'):null,text=args.includes('--prompt')?value('--prompt'):value('--message');
10
+ if(!model||!text)throw new Error('视觉调用缺少模型或提示');
11
+ if(config.model&&model!==config.model)throw new Error('视觉模型与授权实例不匹配');
12
+ const {effectiveMaxTokens:maxTokens}=visionOutputBudget(config);
13
+ const base=new URL(config.baseUrl);if(!['http:','https:'].includes(base.protocol)||base.username||base.password||base.search||base.hash)throw new Error('视觉模型地址非法');
14
+ let mime='image/png',data;if(image){const bytes=readFileSync(image);mime=bytes[0]===255?'image/jpeg':bytes.subarray(0,4).toString()==='RIFF'?'image/webp':'image/png';data=bytes.toString('base64');}
15
+ let endpoint,headers,body;
16
+ if(config.api==='openai-completions'){
17
+ endpoint='/chat/completions';headers={Authorization:'Bearer '+key};body={model,messages:[{role:'user',content:[{type:'text',text},...(data?[{type:'image_url',image_url:{url:`data:${mime};base64,${data}`}}]:[])]}],max_tokens:maxTokens};
18
+ }else if(config.api==='openai-responses'){
19
+ endpoint='/responses';headers={Authorization:'Bearer '+key};body={model,input:[{role:'user',content:[{type:'input_text',text},...(data?[{type:'input_image',image_url:`data:${mime};base64,${data}`}]:[])]}],max_output_tokens:maxTokens};
20
+ }else if(config.api==='anthropic-messages'){
21
+ endpoint='/messages';headers={'x-api-key':key,'anthropic-version':'2023-06-01'};body={model,max_tokens:maxTokens,messages:[{role:'user',content:[...(data?[{type:'image',source:{type:'base64',media_type:mime,data}}]:[]),{type:'text',text}]}]};
22
+ }else if(config.api==='google-generative-ai'){
23
+ endpoint='/models/'+encodeURIComponent(model)+':generateContent';headers={'x-goog-api-key':key};body={contents:[{role:'user',parts:[{text},...(data?[{inlineData:{mimeType:mime,data}}]:[])]}],generationConfig:{maxOutputTokens:maxTokens}};
24
+ }else throw new Error('视觉模型协议尚未适配');
25
+ if(cancelled())throw new Error('分析已取消');
26
+ const controller=new AbortController();let sent=false;
27
+ const timer=setInterval(()=>{if(cancelled())controller.abort();},100),timeout=setTimeout(()=>controller.abort(),300000);
28
+ try{
29
+ sent=true;
30
+ const response=await transport(base.href.replace(/\/$/,'')+endpoint,{method:'POST',headers:{...headers,'Content-Type':'application/json'},body:JSON.stringify(body),redirect:'error',signal:controller.signal});
31
+ if(!response.ok){
32
+ const reader=response.body?.getReader();let size=0,raw='';if(reader)try{while(size<8192){const next=await reader.read();if(next.done)break;size+=next.value.byteLength;raw+=Buffer.from(next.value).toString('utf8');}}finally{await reader.cancel().catch(()=>{});}
33
+ let code;try{const payload=JSON.parse(raw);const value=payload.error?.code??payload.code;if(typeof value==='string'&&/^[a-zA-Z0-9_.-]{1,100}$/.test(value)&&!value.includes(key))code=value;}catch{}
34
+ throw new AnalysisError('UPSTREAM_REJECTED','视觉模型请求失败(HTTP '+response.status+')'+(code?',错误码 '+code:''),{upstream:{status:response.status,...(code?{code}:{})},recovery:'fix-connection'});
35
+ }
36
+ const reader=response.body?.getReader();if(!reader)throw new Error('视觉模型未返回报告');
37
+ const chunks=[];let size=0;
38
+ while(true){const next=await reader.read();if(next.done)break;size+=next.value.byteLength;if(size>8_000_000){await reader.cancel();throw new Error('视觉响应过大');}chunks.push(next.value);}
39
+ const raw=Buffer.concat(chunks).toString('utf8');
40
+ const result=JSON.parse(raw);
41
+ // Return only assistant text, rather than recursively interpreting arbitrary response metadata as a report.
42
+ const texts=config.api==='openai-completions'?[result.choices?.[0]?.message?.content]:config.api==='openai-responses'?(result.output??[]).flatMap(item=>(item.content??[]).filter(c=>c.type==='output_text').map(c=>c.text)):config.api==='anthropic-messages'?(result.content??[]).filter(c=>c.type==='text').map(c=>c.text):(result.candidates??[]).flatMap(item=>(item.content?.parts??[]).map(c=>c.text));
43
+ const assistantText=texts.filter(t=>typeof t==='string').join('\n');
44
+ const truncated=result.choices?.[0]?.finish_reason==='length'||result.status==='incomplete'||result.stop_reason==='max_tokens'||result.candidates?.some(c=>c.finishReason==='MAX_TOKENS');
45
+ try{onEvidence({text:assistantText,effectiveMaxTokens:maxTokens,truncated});}catch(error){throw new AnalysisError('EVIDENCE_WRITE_FAILED','分析证据保存失败:'+error.message);}
46
+ if(truncated)throw new AnalysisError('OUTPUT_TRUNCATED','视觉报告超出模型输出额度(本次 '+maxTokens+' tokens);请核对实际额度,未回填截断结果',{effectiveMaxTokens:maxTokens,recovery:'review-budget'});
47
+ if(!assistantText.trim()||texts.some(t=>typeof t!=='string'))throw new Error('视觉模型未返回文字报告');
48
+ return {text:texts.join('\n')};
49
+ }catch(error){
50
+ if(error instanceof AnalysisError)throw error;
51
+ if(sent&&(controller.signal.aborted||error instanceof TypeError)){onRemoteCancel?.();throw new Error(cancelled()?'分析请求已取消;云端计算与计费是否停止无法确认,不会自动重发':'分析请求超时或连接中断;云端计算与计费是否停止无法确认,未回填报告,不会自动重发');}
52
+ throw new Error(/^视觉/.test(error.message)?error.message:'视觉模型响应解析失败');
53
+ }finally{clearInterval(timer);clearTimeout(timeout);}
54
+ }
55
+
56
+ export function visionOutputBudget(config={}){const max=config.maxTokens??16384;if(!Number.isSafeInteger(max)||max<1)throw new AnalysisError('INVALID_OUTPUT_BUDGET','视觉模型输出额度非法',{recovery:'fix-input'});return {configuredMaxTokens:max,effectiveMaxTokens:max,limitReason:null};}