@66rpg/lumimaker 0.1.33 → 0.1.34

package/README.md

@@ -26,4 +26,4 @@ npx lumimaker skill --platform cursor
 
 `publish-template` 首发必须有合法 `package.json.name`（不能含 `/` `@`）。空了会问你并写回；如果这个字段已经带 `@`，不要改它，发布时会再问展示名。模板 `package.json.version` 须 1–16 位，仅小写字母、数字、`.`、`-`；须以字母或数字开头和结尾，不能有连续符号。还没发布过时必须有工程 `assets/`，会自动上传数据包（不能绑已有数据包；`--with-assets` 可省略）。再发一版默认不带数据包；该 `data_ver` 尚无包且本地有 `assets/` 则自动上传。再带包用 `--with-assets`（开关）。数据包说明可用 `--data-summary`。数据包目录固定工程 `assets/`。只改资源、不发新模板版本用 `publish-template-data`。派生用 `--fork <版本ID>`；换绑已有包按提示给数据包 ID；要带本地包加 `--with-assets`。发版不传更新说明，请到网页改。
 
-说明都在本包 `skill/`：`lumimaker`（怎么发）、`lumimaker-template-spec`（目录规范）、`lumimaker-play-sdk`（宿主 SDK）。装到工程编辑器：`npx lumimaker skill`。
+说明都在本包 `skill/`：`lumimaker`（怎么发）、`lumimaker-template-spec`（目录规范）、`lumimaker-play-sdk`（宿主 SDK）、`lumimaker-free-audio`（免费 BGM / 音效，须下载到本地）。装到工程编辑器：`npx lumimaker skill`。

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@66rpg/lumimaker",
-  "version": "0.1.33",
+  "version": "0.1.34",
   "description": "幻光 lumimaker 平台工具：validate-template（TS）；login / publish 等转发 lumimaker",
   "type": "module",
   "bin": {
@@ -33,7 +33,7 @@
     "picocolors": "^1.1.1"
   },
   "optionalDependencies": {
-    "@66rpg/lumimaker-win32-x64": "0.1.33"
+    "@66rpg/lumimaker-win32-x64": "0.1.34"
   },
   "devDependencies": {
     "@types/node": "^22.15.0",

package/skill/lumimaker/SKILL.md

@@ -16,6 +16,7 @@ description: 幻光平台 CLI 命令操作与发布指引。用户询问如何
 - **CLI 命令操作与交互规范**：由本技能（`lumimaker`）说明。
 - **模板工程规范协议**：查阅 `lumimaker-template-spec`（校验工程目录、`package.json` 字段与脚本、构建产物）。
 - **游戏宿主 SDK 接入**：查阅 `lumimaker-play-sdk`（在游戏代码中通过 `window.CgMakerSdk` 调用平台功能）。
+- **免费背景音乐和音效**：查阅 `lumimaker-free-audio`（按用户描述挑选，下载到工程里再用，不要把网上的音频地址写进作品）。
 
 ---
 

package/skill/lumimaker/references/common-commands.md

@@ -28,7 +28,7 @@
 
 ## 3. Agent 技能管理命令
 
-将平台官方提供的技能（`lumimaker`、`lumimaker-template-spec`、`lumimaker-play-sdk`）同步安装到当前工程的编辑器配置目录中（如 `.cursor/skills/` 等）。
+将平台官方提供的技能（`lumimaker`、`lumimaker-template-spec`、`lumimaker-play-sdk`、`lumimaker-free-audio`）同步安装到当前工程的编辑器配置目录中（如 `.cursor/skills/` 等）。
 
 | 命令 | 用途 | 说明 |
 |---|---|---|

package/skill/lumimaker-free-audio/SKILL.md

@@ -0,0 +1,40 @@
+---
+name: lumimaker-free-audio
+description: 帮用户从幻光免费素材里选背景音乐或音效，并下载到工程里使用。用户提到免费音乐、配乐、背景音乐、BGM、音效、SE 时使用。按曲名和介绍做语义挑选。必须先存到本地再引用，不能把网上的音频地址写进游戏、模板或开源工程。
+---
+
+# 免费背景音乐和音效
+
+用户想给游戏、模板或开源工程配一段免费的背景音乐或音效时，用这份说明。背景音乐和 BGM 是同一件事，音效和 SE 是同一件事。
+
+跟用户说话用日常说法。不要提列表网址、`title`、`description`、`path`、`base_url`。
+
+## 跟用户怎么说
+
+- 选好了：说清是背景音乐还是音效、曲名，以及文件在工程里的位置。例如：「给你配了一段背景音乐，名字叫「作战」，已经放在工程的 `assets/bgm/` 里。」
+- 没有合适的：直接说免费素材里没有贴近这个场景的。不要凑合下一条。
+- 下载失败：说这条素材暂时取不到。不要改用网上的音频链接代替。
+
+## 只从这两份列表里选
+
+列表不区分测试、调试、正式。请求时带 `Referer: https://lumi.66rpg.com/`。不要把整份列表写进工程，也不要贴给用户。
+
+| 用户要的 | 列表 |
+|---|---|
+| 背景音乐 | `https://lumimaker.66rpg.com/common/asset-hub/release/public/bgm.json` |
+| 音效 | `https://lumimaker.66rpg.com/common/asset-hub/release/public/se.json` |
+
+对照用户描述的场景，只看每条的 `title` 和 `description` 做语义挑选。`path` 只用来下载，不拿来筛选。
+
+## 先下载到工程里再用
+
+下载地址是 `${base_url}${path}`，不要在网址末尾加 `.mp3`。`base_url` 和 `path` 都在对应列表里，`base_url` 末尾已经有斜杠。
+
+工程说明里如果已经规定了音频放在哪，就放进那个目录。没有规定时：
+
+- 背景音乐放 `assets/bgm/`
+- 音效放 `assets/se/`
+
+存到本地时，文件名用 `path` 最后一段，并加上 `.mp3`。`path` 为 `7d/7d5aadad0dfabb6e81540fcaba583940` 时，从 `https://wcdn1.cgyouxi.com/shareres/7d/7d5aadad0dfabb6e81540fcaba583940` 下载，背景音乐存成 `assets/bgm/7d5aadad0dfabb6e81540fcaba583940.mp3`。
+
+作品里只引用这个本地文件。列表地址和下载地址都不能写进网页、脚本、样式、数据或配置。只有存到本地的文件名才带 `.mp3`。