chore(陶泥儿导出): 更新技能包版本与校验值,调整文档格式与说明细节

This commit is contained in:
2026-10-07 21:00:58 +08:00
parent 14ff5170e0
commit a2700f3eee
3 changed files with 12 additions and 11 deletions
@@ -1,6 +1,6 @@
{
"schemaVersion": "agc-skill-pack.v1",
"version": "2026-08-26.74",
"version": "2026-08-26.75",
"skills": [
{
"name": "agc-unity-editor",
@@ -195,7 +195,7 @@
"scripts/pack.mjs",
"scripts/vite.config.taonier.mjs"
],
"sha256": "c73edcd88384e8824c5d6b932562196020b305e926a7837929272130df515364"
"sha256": "0a63c68ef0565fb186885208697200d70d8050372446e94fa5dd77b457acc494"
},
{
"name": "vite-export-xhs-minitool",
@@ -220,7 +220,7 @@
"scripts/validate.mjs",
"scripts/vite.config.xhs-minitool.mjs"
],
"sha256": "fd869242fdd40bb46fc3fbf30d1509c79d306e769e87dad3430b2ab0e5449b12"
"sha256": "bf061887e04c582465eb0706ef1ebd8aefdb81a52094598ab8e2d617009f5130"
}
]
}
@@ -10,18 +10,19 @@ metadata:
* 实现打包脚本 `build:taonier`: 用 `scripts/vite.config.taonier.mjs` 把 vite 项目构建到 `dist-taonier`,
再用 `scripts/pack.mjs` 产出 zip 到固定文件: `.export/taonier.zip`
1. 复制 (并按实际情况修改) `scripts/vite.config.taonier.mjs` 作为 vite 构建配置, 这个配置把 dist 收尾成可托管的 H5
1. 复制 (并按实际情况修改) `scripts/vite.config.taonier.mjs` 作为 (另一个)vite 构建配置, 这个配置把 dist 收尾成可托管的
H5
根目录: 相对路径入口、根目录 `index.html`、清空空目录. 该配置不做语法降级.
2. 使用 `scripts/pack.mjs` 打包成 zip; `--zip-out` 默认 **`../.export/taonier.zip`** (假设 cwd 是 `game/` 子工程,
产物落在 **项目根** `.export/taonier.zip`; 相对 cwd 解析).
3. 跑通流程后请把需要的脚本配置复制 (agc_install_skill_resource )到项目里 (以免依赖skill), 并形成最终的打包脚本.
3. 跑通流程后请把需要的脚本配置复制 (agc_install_skill_resource)到项目里 (以免依赖skill), 并形成最终的打包脚本.
* 不干扰正常的web构建
# 平台要求:
* 仅支持单个 `.zip` 压缩包.
* zip 解压后**根目录**须有 `index.html`(**不得有外层文件夹**): 服务端只认存档根条目 `index.html`,
* zip 解压后 **根目录**须有 `index.html`( **不得有外层文件夹**): 服务端只认存档根条目 `index.html`,
`game/index.html` 之类会被判缺入口而拒收.
* 因此 `scripts/pack.mjs` 默认把构建产物内容直接放到 zip 存档根 (`index.html`、`assets/...`), 结构不合格时
整体失败, 不会留下可误传的 zip. `--root-dir` 是可选参数: 只有调用方显式给出时才会额外套一层顶层文件夹.
@@ -35,9 +36,9 @@ metadata:
# 脚本参数:
| 脚本 | 参数 |
|-----------------------------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| `scripts/vite.config.taonier.mjs` | `build.outDir`(默认 `dist-taonier`;与打包时的 `--vite-built-dir` 必须是同一个目录) |
| 脚本 | 参数 |
|-----------------------------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| `scripts/vite.config.taonier.mjs` | `build.outDir`(默认 `dist-taonier`;与打包时的 `--vite-built-dir` 必须是同一个目录) |
| `scripts/pack.mjs` | `--vite-built-dir <dir>`(默认 `dist-taonier`)、`--zip-out <path>`(默认 `../.export/taonier.zip`,必须以 `.zip` 结尾)、`--root-dir <name>`(**可选**,默认不套外层文件夹;给出时才把内容套进单层文件夹 `<name>/`) |
# 一些情况:
@@ -9,12 +9,12 @@ metadata:
# 目标:
* 实现打包脚本 `build:xhs-minitool` 支持vite构建, validate, pack, 产出zip到固定文件: .export/xhs-minitool.zip
1. 复制 (并按实际情况修改) `scripts/vite.config.xhs-minitool.mjs` 作为vite构建配置, 这个配置保证了产物符合小红书小工具的规范.
1. 复制 (并按实际情况修改) `scripts/vite.config.xhs-minitool.mjs` 作为(另一个)vite构建配置, 这个配置保证了产物符合小红书小工具的规范.
2. 使用 `scripts/validate.mjs` 验证上述配置构建产物目录, 这个脚本实现了一些硬性检查, 此外有一些手动检查项:
`references/manual-checks.md`
3. 使用 `scripts/pack.mjs` 打包成zip; `--zip-out` 默认 **`../.export/xhs-minitool.zip`** (假设 cwd 是 `game/` 子工程,
产物落在 **项目根** `.export/xhs-minitool.zip`; 相对 cwd 解析)
4. 跑通流程后请把需要的脚本配置复制 (agc_install_skill_resource )到项目里 (以免依赖skill), 并形成最终的打包脚本
4. 跑通流程后请把需要的脚本配置复制 (agc_install_skill_resource)到项目里 (以免依赖skill), 并形成最终的打包脚本
* 不干扰正常的web构建