From 95323ce5428fdc225bea1fa75a79d524a9318cbf Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?=E7=8E=8B=E5=BE=B7=E5=AE=87?= Date: Mon, 5 Oct 2026 16:08:53 +0800 Subject: [PATCH] =?UTF-8?q?=E5=B0=8F=E7=BA=A2=E4=B9=A6=E5=AF=BC=E5=87=BA?= =?UTF-8?q?=20skill=EF=BC=9A=E6=96=B0=E5=A2=9E=E7=A1=AE=E5=AE=9A=E7=9A=84?= =?UTF-8?q?=20zip=20=E8=90=BD=E7=82=B9=E5=8F=82=E6=95=B0=E5=B9=B6=E5=86=99?= =?UTF-8?q?=E6=B8=85=20AGC=20=E6=8E=A5=E5=85=A5=E5=A5=91=E7=BA=A6?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit - pack.mjs 新增 --zip-out ：相对当前工作目录解析、父目录自动创建，供「产物必须落在项目根 .export/ 下」的调用方指定落点；原 --zip 默认行为不变。 - SKILL.md 增加「被 AGC 导出面板调用时」一节：三条硬契约（脚本名 build:xhs-minitool、非空 .export/xhs-minitool.zip、--out-dir 只指向构建输出目录）与拷贝到 .export/ 后如何定位项目根。 - vite.config.xhs-minitool.mjs 的注释点明 build.outDir 与 pack 的 --out-dir 必须一致，配错会删源码。 - manifest.json 同步 sha256 与版本 2026-08-26.41（文件清单不变，仍 36 个）。 --- .../resources/agc-skills/manifest.json | 4 ++-- .../vite-export-xhs-minitool/SKILL.md | 13 ++++++++++++- .../vite-export-xhs-minitool/scripts/pack.mjs | 17 ++++++++++++++--- .../scripts/vite.config.xhs-minitool.mjs | 3 +++ 4 files changed, 31 insertions(+), 6 deletions(-) diff --git a/apps/ai-game-creator-shell/src-tauri/resources/agc-skills/manifest.json b/apps/ai-game-creator-shell/src-tauri/resources/agc-skills/manifest.json index 22b99d640..af8677d85 100644 --- a/apps/ai-game-creator-shell/src-tauri/resources/agc-skills/manifest.json +++ b/apps/ai-game-creator-shell/src-tauri/resources/agc-skills/manifest.json @@ -1,6 +1,6 @@ { "schemaVersion": "agc-skill-pack.v1", - "version": "2026-08-26.40", + "version": "2026-08-26.41", "skills": [ { "name": "agc-unity-editor", @@ -204,7 +204,7 @@ "scripts/validate.mjs", "scripts/vite.config.xhs-minitool.mjs" ], - "sha256": "c5cae916577f1192972da5a986d8226ba56fbef1462243ca9e2b2d6bdd66ff58" + "sha256": "9799b44c6de4c375148abdeb9dcbbe8c0acdf0eea11511c9f9da2cda96f6af7c" } ] } diff --git a/apps/ai-game-creator-shell/src-tauri/resources/agc-skills/vite-export-xhs-minitool/SKILL.md b/apps/ai-game-creator-shell/src-tauri/resources/agc-skills/vite-export-xhs-minitool/SKILL.md index cb1889db2..fb3f86ac1 100644 --- a/apps/ai-game-creator-shell/src-tauri/resources/agc-skills/vite-export-xhs-minitool/SKILL.md +++ b/apps/ai-game-creator-shell/src-tauri/resources/agc-skills/vite-export-xhs-minitool/SKILL.md @@ -3,7 +3,7 @@ name: vite-export-xhs-minitool description: >- vite 项目导出适配小红书小工具的制品 metadata: - version: "1.6.0" + version: "1.7.0" --- 1. 新增 `scripts/vite.config.xhs-minitool.mjs` (示例)作为vite构建配置, 这个配置保证了产物符合小红书小工具的规范. @@ -13,6 +13,17 @@ metadata: 3. 使用 `scripts/pack.mjs` 打包成zip +## 被 AGC 导出面板调用时 + +宿主只按三条硬契约校验, 接入的项目 MUST 逐条满足: + +- npm 包 (声明 `package.json` 的那层目录) MUST 声明脚本 `build:xhs-minitool`. +- 该脚本跑完 MUST 在项目根留下非空的 `.export/xhs-minitool.zip`; 用 `pack.mjs --zip-out <项目根>/.export/xhs-minitool.zip` 指定落点, 不要依赖默认文件名. +- `pack.mjs --out-dir` MUST 只指向 vite 构建输出目录: 它会就地删掉该目录里白名单之外的扩展名文件, 指向源码目录会删掉用户代码. + +把示例脚本拷贝到 `<项目根>/.export/` 下再改 (拷贝是项目自己的代码, 允许改路径与入口); +拷贝自身的位置就是项目根: `dirname(import.meta.url)/..`. + * 如果使用了外部能力, 参考platform-abstract skill对项目先重构 以下是其他参考文档, 非必要不读 diff --git a/apps/ai-game-creator-shell/src-tauri/resources/agc-skills/vite-export-xhs-minitool/scripts/pack.mjs b/apps/ai-game-creator-shell/src-tauri/resources/agc-skills/vite-export-xhs-minitool/scripts/pack.mjs index 58f52c9a2..91e4e5989 100644 --- a/apps/ai-game-creator-shell/src-tauri/resources/agc-skills/vite-export-xhs-minitool/scripts/pack.mjs +++ b/apps/ai-game-creator-shell/src-tauri/resources/agc-skills/vite-export-xhs-minitool/scripts/pack.mjs @@ -46,9 +46,13 @@ const ALLOWED = new Set([ const FORBIDDEN_ENTRY = /(^|\/)(?:node_modules|\.git)\/|(^|\/)\.DS_Store$|\.map$|(^|\/)(?:vite|webpack|rollup)\.config\.[^/]+$/i; -const USAGE = `用法：node pack.mjs [--out-dir ] [--zip ] [--skip-validate] [--no-strict] +const USAGE = `用法：node pack.mjs [--out-dir ] [--zip ] [--zip-out ] [--skip-validate] [--no-strict] -把 vite dist-xhs-minitool 产物整理成符合小红书规范、根目录带 index.html 的 zip。`; +把 vite dist-xhs-minitool 产物整理成符合小红书规范、根目录带 index.html 的 zip。 + +--zip 只给文件名时用：写到当前工作目录下。 +--zip-out 需要指定落点（例如 AGC 导出面板要求的 .export/xhs-minitool.zip）时用： + 相对路径按当前工作目录解析，父目录不存在会自动建。`; function walk(dir) { const out = []; @@ -296,6 +300,7 @@ function readPackageName(cwd) { * cwd?: string, * outDir?: string, * zipName?: string, + * zipOut?: string, * publicDir?: string, * skipValidate?: boolean, * strict?: boolean, @@ -305,13 +310,18 @@ export function packMinitool(options = {}) { const cwd = resolve(options.cwd || process.cwd()); const outDir = resolve(cwd, options.outDir || 'dist-xhs-minitool'); const zipName = options.zipName || `${readPackageName(cwd)}-xhs-tool.zip`; - const zipPath = resolve(cwd, zipName); + // `zipOut` 优先：调用方（如 .export/ 下的项目拷贝）要的是确定的落点，而不是"当前目录下叫什么名字"。 + const zipPath = options.zipOut + ? resolve(cwd, options.zipOut) + : resolve(cwd, zipName); const publicDir = resolve(cwd, options.publicDir || 'public'); const strict = options.strict !== false; if (!existsSync(outDir)) { throw new Error(`缺少输出目录 ${outDir}`); } + // 落点的父目录可能还不存在（`.export/` 是宿主按需创建的），先建再写。 + mkdirSync(dirname(zipPath), { recursive: true }); for (const icon of ['icon-192.svg', 'icon-512.svg']) { const dest = join(outDir, 'icons', icon); @@ -375,6 +385,7 @@ if (isMainModule()) { const code = packMinitool({ outDir: getFlagValue('--out-dir'), zipName: getFlagValue('--zip'), + zipOut: getFlagValue('--zip-out'), skipValidate: flags.has('--skip-validate'), strict: !flags.has('--no-strict'), }); diff --git a/apps/ai-game-creator-shell/src-tauri/resources/agc-skills/vite-export-xhs-minitool/scripts/vite.config.xhs-minitool.mjs b/apps/ai-game-creator-shell/src-tauri/resources/agc-skills/vite-export-xhs-minitool/scripts/vite.config.xhs-minitool.mjs index bf9e65d01..a848ec431 100644 --- a/apps/ai-game-creator-shell/src-tauri/resources/agc-skills/vite-export-xhs-minitool/scripts/vite.config.xhs-minitool.mjs +++ b/apps/ai-game-creator-shell/src-tauri/resources/agc-skills/vite-export-xhs-minitool/scripts/vite.config.xhs-minitool.mjs @@ -8,6 +8,9 @@ * import { defineMinitoolConfig } from '<此文件路径>'; * export default defineMinitoolConfig({ plugins: [...] }); * + * 下面 build.outDir 的值与打包脚本的 --out-dir 是同一个目录，两处必须一致： + * pack.mjs 会就地删掉该目录里白名单之外的扩展名文件，配错会删掉源码。 + * * 约束来源：minitool-zip-builder/references/js-compatibility.md、css-compatibility.md、 * zip-artifact-spec.md —— Chrome 61 / ES2017 基线、相对路径、IIFE 单入口、无 sourcemap。 */