@ninkch/dsh-artcraft 0.2.7 → 0.2.8

package/client.js

@@ -62,10 +62,19 @@ window.__ModuleLoader__.load({
       useEffect(() => () => { alive.current = false; }, []);
 
       const loadStatus = useCallback(async () => {
+        setBusy('refresh');
         try {
+          // 刷新 = 状态 + 顺带一次家族安装探测（后装软件/改安装目录后自动修正配置；
+          // 探测端点在旧版插件上不存在时静默跳过）
+          try {
+            await api('/discover', {
+              method: 'POST', headers: { 'content-type': 'application/json' }, body: '{}',
+            });
+          } catch { /* 旧版无此路由 → 静默跳过 */ }
           const s = await api('/status');
           if (alive.current) { setStatus(s); setStatusErr(null); }
         } catch (e) { if (alive.current) setStatusErr(String(e.message || e)); }
+        finally { if (alive.current) setBusy(''); }
       }, []);
 
       const checkUpdate = useCallback(async () => {

package/index.js

@@ -42,7 +42,7 @@ import crypto from 'node:crypto';
 import { fileURLToPath } from 'node:url';
 
 const NAME = 'artcraft';
-const VERSION = '0.2.7';
+const VERSION = '0.2.8';
 const HERE = path.dirname(fileURLToPath(import.meta.url));
 
 const BINS = ['photocraft', 'vectorcraft', 'filmcraft', 'lightcraft', 'pdfcraft', 'effectcraft', 'designcraft'];
@@ -70,6 +70,11 @@ const DEFAULT_CONFIG = {
   control: { ...DEFAULT_PORTS },
 };
 
+const APP_DISPLAY = {
+  photocraft: 'PhotoCraft', vectorcraft: 'VectorCraft', filmcraft: 'FilmCraft',
+  lightcraft: 'LightCraft', pdfcraft: 'PdfCraft', effectcraft: 'EffectCraft', designcraft: 'DesignCraft',
+};
+
 /* ============================ 配置 ============================ */
 
 async function loadConfig() {
@@ -77,6 +82,7 @@ async function loadConfig() {
     bins: { ...DEFAULT_CONFIG.bins },
     control: { ...DEFAULT_PORTS },
     configPath: null, // 实际生效的配置文件（供界面显示"配置目录"）
+    autoDiscovered: false, // 首次运行是否由自动探测生成了配置
   };
   // 配置查找顺序：~/.dsh（持久，推荐 —— 更新替换包目录也不丢）→ 包目录（旧版兼容）
   const candidates = [
@@ -101,9 +107,46 @@ async function loadConfig() {
       break; // 第一个可解析的配置生效
     } catch { /* 该候选不存在/非法 → 试下一个 */ }
   }
+  // 首次运行（没有任何配置文件）：自动探测本机家族软件安装位置并生成持久配置
+  if (!cfg.configPath) {
+    try {
+      const found = await discoverBinPaths();
+      const target = path.join(os.homedir(), '.dsh', 'artcraft.config.json');
+      await fs.mkdir(path.dirname(target), { recursive: true });
+      await fs.writeFile(target, JSON.stringify({ bins: { ...cfg.bins, ...found }, control: { ...cfg.control } }, null, 2) + '\n');
+      for (const k of Object.keys(found)) cfg.bins[k] = found[k];
+      cfg.configPath = target;
+      cfg.autoDiscovered = Object.keys(found).length > 0;
+    } catch { /* 自动探测失败不影响默认行为 */ }
+  }
   return cfg;
 }
 
+/** 自动探测：扫描常见安装位置（Program Files 等）里的家族 CLI */
+async function discoverBinPaths() {
+  const isWin = process.platform === 'win32';
+  const pf = process.env['ProgramFiles'] || (isWin ? 'C:\\Program Files' : '/usr/local/bin');
+  const pf86 = process.env['ProgramFiles(x86)'] || '';
+  const lap = process.env['LOCALAPPDATA']
+    ? path.join(process.env['LOCALAPPDATA'], 'Programs')
+    : path.join(os.homedir(), '.local');
+  const roots = [pf, ...(pf86 ? [pf86] : []), lap];
+  const found = {};
+  for (const key of BINS) {
+    const cliName = cliNameFor(key);
+    const names = [APP_DISPLAY[key], key, key.toUpperCase(), key.toLowerCase()];
+    outer: for (const root of roots) {
+      for (const name of names) {
+        const exe = path.join(root, name, cliName);
+        try {
+          if ((await fs.stat(exe)).isFile()) { found[key] = path.join(root, name); break outer; }
+        } catch { /* 继续 */ }
+      }
+    }
+  }
+  return found;
+}
+
 /* ============================ 路径与进程 ============================ */
 
 /**
@@ -421,7 +464,7 @@ async function statusInfo(cfg, meta) {
     plugin: NAME,
     version: VERSION,
     platform: process.platform,
-    config: { path: configPath, found: !!configPath },
+    config: { path: configPath, found: !!configPath, autoDiscovered: !!cfg.autoDiscovered },
     bins,
     control: cfg.control,
     jobs: {
@@ -533,17 +576,30 @@ async function detectInstall() {
   return { mode: repoDir ? 'git' : 'npm', here, real, repoDir, profileDir, gitClean, branch };
 }
 
+const REGISTRIES = ['https://registry.npmjs.org', 'https://registry.npmmirror.com'];
+
 async function fetchLatestVersion() {
-  const url = `https://registry.npmjs.org/${PKG_NAME.replace('/', '%2f')}/latest`;
-  try {
-    const res = await fetch(url, { signal: AbortSignal.timeout(12000) });
-    if (res.status === 404) return { latest: null, note: 'npm 上还没有这个包' };
-    if (!res.ok) throw new Error('registry 返回 ' + res.status);
-    const j = await res.json();
-    return { latest: j.version ?? null, tarball: j.dist?.tarball ?? null, integrity: j.dist?.integrity ?? null };
-  } catch (e) {
-    return { latest: null, note: '查询 npm 失败: ' + String(e?.cause?.message || e?.message || e) };
+  const slug = PKG_NAME.replace('/', '%2f');
+  const errors = [];
+  // 回退链：官方源 → npmmirror 镜像（国内无代理机器也能完成检查与更新）
+  for (const reg of REGISTRIES) {
+    try {
+      const res = await fetch(`${reg}/${slug}/latest`, { signal: AbortSignal.timeout(12000) });
+      if (res.status === 404) { errors.push(`${reg}: 404`); continue; }
+      if (!res.ok) throw new Error('HTTP ' + res.status);
+      const j = await res.json();
+      if (!j.version) { errors.push(`${reg}: 无版本数据`); continue; }
+      return {
+        latest: j.version ?? null,
+        tarball: j.dist?.tarball ?? null,
+        integrity: j.dist?.integrity ?? null,
+        source: reg,
+      };
+    } catch (e) {
+      errors.push(`${reg}: ${String(e?.cause?.message || e?.message || e)}`);
+    }
   }
+  return { latest: null, note: '查询失败（官方源与 npmmirror 均不可达）—— ' + errors.join('；') };
 }
 
 async function updateCheck() {
@@ -585,8 +641,20 @@ async function updateApply() {
   await fs.mkdir(tmp, { recursive: true });
   try {
     const tgzPath = path.join(tmp, 'pkg.tgz');
-    const res = await fetch(meta.tarball, { signal: AbortSignal.timeout(180000) });
-    if (!res.ok) throw new Error('下载 tarball 失败: HTTP ' + res.status);
+    // 下载：优先元数据自带的官方地址；失败时回退 npmmirror 镜像（sha512 校验保证内容一致）
+    let res;
+    try {
+      res = await fetch(meta.tarball, { signal: AbortSignal.timeout(180000) });
+      if (!res.ok) throw new Error('HTTP ' + res.status);
+    } catch (e) {
+      const slug = PKG_NAME.replace('/', '%2f');
+      const mirrorUrl = `https://registry.npmmirror.com/${slug}/-/${PKG_NAME.split('/')[1]}-${meta.latest}.tgz`;
+      WriteMirrorRetry: {
+        res = await fetch(mirrorUrl, { signal: AbortSignal.timeout(180000) });
+        if (!res.ok) throw new Error('HTTP ' + res.status);
+        break WriteMirrorRetry;
+      }
+    }
     const buf = Buffer.from(await res.arrayBuffer());
     if (buf.length > 64 * 1024 * 1024) throw new Error('tarball 超过 64MB 上限，已终止');
     const digest = crypto.createHash('sha512').update(buf).digest('base64');
@@ -793,6 +861,63 @@ export function apply(ctx) {
       },
     });
 
+    attempt({
+      name: 'artcraft_discover',
+      description: '自动探测本机 ArtCraft 家族软件安装位置（Program Files / LocalAppData\\Programs 等），写入/修复配置：填充默认空缺项，并自动纠正已失效的路径（改安装目录、卸载重装到别处）；用户显式配置仍有效则不动。',
+      schema: { type: 'object', properties: {}, additionalProperties: false },
+      async execute() {
+        const cfg = await loadConfig();
+        const found = await discoverBinPaths();
+        const applied = {};
+        for (const k of BINS) {
+          if (!found[k]) continue;
+          let effective = null;
+          try { effective = await resolveBin(cfg, k); } catch { /* 未配置 */ }
+          const ok = effective ? await fileExists(effective) : false;
+          if (ok) continue; // 现有配置仍有效 → 不动
+          applied[k] = found[k];
+        }
+        if (!Object.keys(applied).length) {
+          return { applied: {}, configPath: cfg.configPath, note: '家族程序路径均已就绪，无需更新' };
+        }
+        const target = cfg.configPath || path.join(os.homedir(), '.dsh', 'artcraft.config.json');
+        let obj = {};
+        try { obj = JSON.parse(await fs.readFile(target, 'utf8')); } catch { /* 新文件 */ }
+        obj.bins = { ...(obj.bins ?? {}), ...applied };
+        await fs.mkdir(path.dirname(target), { recursive: true });
+        await fs.writeFile(target, JSON.stringify(obj, null, 2) + '\n');
+        return { applied, configPath: target, note: '已写入配置，立即生效' };
+      },
+    });
+
+    attempt({
+      name: 'artcraft_recipes',
+      description: '内置专家处理方案库：ArtCraft 家族的专业工作流配方（短剧海报、分镜批量调色、横转竖、响度标准化、SRT 字幕烧录、动态片头、多平台分发包、先探测后验证纪律）。action=list 列出全部；action=get + id 取单个配方的专业原则、执行步骤与验证清单。',
+      schema: {
+        type: 'object',
+        properties: {
+          action: { type: 'string', enum: ['list', 'get'] },
+          id: { type: 'string', description: 'action=get 时的配方 id' },
+        },
+        required: ['action'],
+        additionalProperties: false,
+      },
+      async execute(args) {
+        const recipesPath = path.join(HERE, 'recipes', 'recipes.json');
+        const catalog = JSON.parse(await fs.readFile(recipesPath, 'utf8'));
+        if (String(args.action) === 'get') {
+          const r = catalog.recipes.find((x) => x.id === String(args.id ?? ''));
+          if (!r) throw new Error('配方不存在: ' + args.id + '（可用: ' + catalog.recipes.map((x) => x.id).join(', ') + '）');
+          return r;
+        }
+        return {
+          version: catalog.version,
+          recipes: catalog.recipes.map((r) => ({ id: r.id, title: r.title, apps: r.apps, goal: r.goal })),
+          hint: 'action=get + id 取完整配方（专业原则 + 执行步骤 + 验证清单）',
+        };
+      },
+    });
+
     return () => {
       for (const d of disposers) { try { d(); } catch { /* ignore */ } }
     };
@@ -939,6 +1064,36 @@ export function apply(ctx) {
         sendJson(res, 200, await updateApply());
       }),
 
+      makeRoute(`/${NAME}/api/discover`, async (req, res) => {
+        if (req.method !== 'POST') throw new Error('仅支持 POST');
+        const cfg = await loadConfig();
+        const found = await discoverBinPaths();
+        // 只填充默认空缺项；显式配置仅在已失效（改安装目录/卸载重装）时自动纠正，有效则不动
+        const applied = {};
+        for (const k of BINS) {
+          if (!found[k]) continue;
+          let effective = null;
+          try { effective = await resolveBin(cfg, k); } catch { /* 未配置 */ }
+          const ok = effective ? await fileExists(effective) : false;
+          if (ok) continue;
+          applied[k] = found[k];
+        }
+        if (Object.keys(applied).length) {
+          const target = cfg.configPath || path.join(os.homedir(), '.dsh', 'artcraft.config.json');
+          let obj = {};
+          try { obj = JSON.parse(await fs.readFile(target, 'utf8')); } catch { /* 新文件 */ }
+          obj.bins = { ...(obj.bins ?? {}), ...applied };
+          await fs.mkdir(path.dirname(target), { recursive: true });
+          await fs.writeFile(target, JSON.stringify(obj, null, 2) + '\n');
+        }
+        sendJson(res, 200, {
+          discovered: found,
+          applied,
+          configPath: cfg.configPath,
+          note: Object.keys(applied).length ? '已探测并写入配置，立即生效' : '没有需要更新的家族程序',
+        });
+      }),
+
       makeRoute(`/${NAME}/api/control`, async (req, res) => {
         if (req.method !== 'POST') throw new Error('仅支持 POST');
         const cfg = await loadConfig();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ninkch/dsh-artcraft",
-  "version": "0.2.7",
+  "version": "0.2.8",
   "type": "module",
   "description": "Drive the open-source ArtCraft studio apps (PhotoCraft / FilmCraft / EffectCraft) from DeepSeek Harness ? agent tools, a same-origin HTTP API, and plugins-page status with self-update.",
   "keywords": [
@@ -35,6 +35,7 @@
     "client.js",
     "cordis.patch.yml",
     "artcraft.config.json.example",
+    "recipes",
     "README.md",
     "README.zh-CN.md",
     "NOTICE.md"

package/recipes/recipes.json

@@ -0,0 +1,143 @@
+{
+  "version": 1,
+  "updated": "2026-10-10",
+  "recipes": [
+    {
+      "id": "poster-short-drama",
+      "title": "短剧海报（竖版）",
+      "apps": ["photocraft"],
+      "goal": "生成竖版短剧海报：标题层级、装饰元素、无损输出",
+      "principles": [
+        "视觉层级：主标题 → 副标题 → 装饰元素，字号/字重至少差 2 级，同屏不超过 3 个信息层",
+        "对比度：文字与背景亮度差 ≥ 4.5:1，浅背景加深色字，深背景加浅色字，或加投影/描边兜底",
+        "安全边距：四周留 5% 不放关键内容（平台裁切友好）",
+        "中文字体显式指定（如 Noto Sans SC），不要依赖默认字体（缺 CJK 字形会变方框）",
+        "HTTP 传中文参数一律走 UTF-8 字节体，避免编码损坏"
+      ],
+      "steps": [
+        "photocraft-cli run --new '{\"width\":1080,\"height\":1440}' --cmd <背景填充/渐变命令> --out <工作空间>/poster.png",
+        "标题：Noto Sans SC，主标题字号 ≥ 120，副标题 ≤ 48；装饰条用像素层绘制",
+        "逐层 --cmd 叠加（每条 --params 作用于前一个 --cmd），最后 --out 输出 PNG 无损"
+      ],
+      "checks": ["取回产物做视觉检查：字形完整、层级清晰、四边安全区无关键内容"]
+    },
+    {
+      "id": "storyboard-color-grade",
+      "title": "分镜批量调色（一致性）",
+      "apps": ["photocraft"],
+      "goal": "整批分镜图统一色调，保持跨镜一致性",
+      "principles": [
+        "先定基调再微调：一条柔和 S 曲线 + 少量 vibrance，避免逐张各调各的",
+        "保护肤色：调整幅度宁小勿大，人脸偏色比不够风格化更伤观感",
+        "锐化放在调色之后（amount 60-80），避免锐化放大噪点",
+        "actions.json 一处定义、整批复用，保证批次内完全一致"
+      ],
+      "steps": [
+        "写 craft/grade.json：[{\"cmd\":\"layer.newAdjustmentLayer.curves\",\"params\":{\"points\":[[0,0],[64,48],[192,212],[255,255]]}},{\"cmd\":\"filter.sharpen.smartSharpen\",\"params\":{\"amount\":80}}]",
+        "photocraft-cli batch --actions <项目>/craft/grade.json --in <项目>/media --out <项目>/out/graded",
+        "抽 2-3 张对比原图检查，不满意只调曲线中段（64,48 / 192,212 两点）重跑"
+      ],
+      "checks": ["抽样对比：同场景相邻分镜色调一致；高光不过曝、暗部不死黑"]
+    },
+    {
+      "id": "vertical-reframe",
+      "title": "横转竖重构图",
+      "apps": ["filmcraft", "photocraft"],
+      "goal": "16:9 素材适配 9:16 竖屏，三种策略按画面主体选择",
+      "principles": [
+        "策略选择：主体居中 → 居中裁切；主体偏侧 → 位移裁切（保主体）；多主体/全景 → 模糊填充（上原图下补景，不裁掉信息）",
+        "人脸安全：裁切框上缘留在头顶上方 10%，下缘到胸口",
+        "分辨率对齐目标平台：抖音/快手/视频号 1080×1920@30fps"
+      ],
+      "steps": [
+        "filmcraft-cli probe <素材> 先量分辨率/时长/帧率（永远先探测再动手）",
+        "序列设 1080×1920@30，放置后按位移/缩放保留主体",
+        "导出 H.264：--quality 80 起步"
+      ],
+      "checks": ["导出后 probe 验证分辨率/时长；抽帧目检主体完整、不切脸"]
+    },
+    {
+      "id": "loudness-web",
+      "title": "网络平台响度标准化",
+      "apps": ["filmcraft"],
+      "goal": "成片响度对齐平台标准，避免用户手动调音量",
+      "principles": [
+        "主流短视频平台目标：integrated -14 LUFS，true peak ≤ -1 dBTP",
+        "导出时一次完成（file.exportMedia loudnessLufs 参数），不要二次压限",
+        "BGM 与人声分层：人声为主轨，BGM 侧链闪避 6-10 dB"
+      ],
+      "steps": [
+        "exec file.exportMedia {\"path\":<out>,\"format\":\"h264\",\"loudnessLufs\":-14,\"wait\":true}",
+        "probe 产物核对时长/编码/音轨"
+      ],
+      "checks": ["probe 报告音轨存在且响度参数已应用；多平台分发时每平台独立导出"]
+    },
+    {
+      "id": "srt-burn",
+      "title": "字幕烧录（SRT）",
+      "apps": ["filmcraft"],
+      "goal": "SRT 字幕导入并烧录进成片",
+      "principles": [
+        "单行 ≤ 15 个中文字符，超长拆条；每条最短停留 1 秒",
+        "位置：底部安全区，避开平台 UI（进度条/互动栏约占底部 15%）",
+        "样式统一：描边 2-3px 或半透明底条，全片一种字体"
+      ],
+      "steps": [
+        "exec captions.import {\"path\":<srt 绝对路径>}",
+        "可选 exec captions.setStyle {\"font\":…,\"size\":…,\"outline\":…}",
+        "exec file.exportMedia {\"path\":<out>,\"format\":\"h264\",\"burnCaptions\":true,\"wait\":true}"
+      ],
+      "checks": ["抽帧目检字幕：无溢出、无遮挡主体、时间轴同步"]
+    },
+    {
+      "id": "title-motion",
+      "title": "动态片头/花字（EffectCraft）",
+      "apps": ["effectcraft"],
+      "goal": "生成动态片头，叠加回剪辑或直接使用",
+      "principles": [
+        ".ecproj 是版本化 JSON —— 直接生成或模板替换文本，比逐帧描述高效",
+        "动画时长 1.5-3s：入场 0.3-0.5s 缓动（ease），停留 ≥ 1s，出场 0.3s",
+        "双出口：MP4 直用；或导出 Lottie 嵌网页预览；带 alpha 的 ProRes 4444 可叠进 FilmCraft 当图形层"
+      ],
+      "steps": [
+        "生成/填充 intro.ecproj（composition 尺寸对齐主序列）",
+        "effectcraft-cli render --comp Main --out <项目>/out/intro.mp4 <项目>/craft/intro.ecproj",
+        "或 exec file.exportLottie 导出 .json 给网页端播放"
+      ],
+      "checks": ["render 后 probe 时长/分辨率；视觉检查动画节奏（入场不突兀、停留可读完整标题）"]
+    },
+    {
+      "id": "delivery-pack",
+      "title": "多平台分发包",
+      "apps": ["filmcraft"],
+      "goal": "同一成片产出多平台版本（分辨率/帧率/响度/命名规范）",
+      "principles": [
+        "平台参数表：抖音/快手/视频号 1080×1920@30 -14LUFS；B 站/西瓜 1920×1080@30 -14LUFS",
+        "命名规范：<项目>_<平台>_v<序号>.mp4，一次导出成组不散落",
+        "每平台独立导出（各自过 loudness 与 probe），不要一份文件多处转发"
+      ],
+      "steps": [
+        "逐平台 exec file.exportMedia {\"path\":<out>,\"format\":\"h264\",\"width\":…,\"height\":…,\"loudnessLufs\":-14,\"wait\":true}",
+        "每个产物跑一次 probe 核对"
+      ],
+      "checks": ["probe 全部产物：分辨率/帧率/音轨符合平台表；文件命名一致"]
+    },
+    {
+      "id": "probe-verify",
+      "title": "通用纪律：先探测、后验证",
+      "apps": ["filmcraft", "photocraft", "effectcraft"],
+      "goal": "所有媒体操作的通用工作流纪律（来自专业剪辑技能的通用实践）",
+      "principles": [
+        "先探测再动手：永远先 probe 素材拿真实时长/分辨率/帧率/音轨，不从文件名猜",
+        "能无损不重编：剪切片段优先流复制，只在必须（精确剪切/滤镜/换格式）时重编码",
+        "做完必验证：产物 probe 一次 + 关键帧目检，报告里写明验证结果",
+        "诚实标注：成功是 Done、失败是 Failed，部分完成必须写出缺口"
+      ],
+      "steps": [
+        "任何处理前：filmcraft-cli probe <media>",
+        "处理后：filmcraft-cli probe <out> + 抽帧目检"
+      ],
+      "checks": ["probe 输出与预期一致；差异写入报告而不是含糊带过"]
+    }
+  ]
+}