Muse Marketplace

Muse Marketplace

面向可分享 Muse 资源的开放市场与注册表。

Muse 用户很快就能彼此分享 Muse Avatars——包括头像分享弹窗、展示头像“模式”（如 工作中）的动画预览等。但分享需要一个存放的地方：一个开放的注册表，任何人都可以在其中发布头像、角色设定、语音或资源包；每个文件都带有校验和，而“安全”意味着经过实际检查，而非仅仅声称安全。

这就是本仓库。我们现在就开始以开源方式构建 Muse Avatar 市场。

npx @reneturcios/muse-marketplace list
npx @reneturcios/muse-marketplace search tree
npx @reneturcios/muse-marketplace show jolly
npx @reneturcios/muse-marketplace install jolly
npx @reneturcios/muse-marketplace doctor

也可以通过网站浏览：打开 site/index.html（或 GitHub Pages 部署版本）——这是一个深色、可搜索的网格，每个头像都有一个动画模式切换器。

内容一览

• registry/ — 注册表本身。每个条目都是一个文件夹 registry/<kind>s/<slug>/，其中包含 listing.json 和资源文件。类型包括：avatar（主要类型）、persona、voice、bundle。registry/index.json 根据条目自动生成（使用 muse-marketplace index），绝不手动编辑；若两者不一致，CI 将失败。
• 首发目录（9 个条目，均为原创且均可安装） — 6 个头像：Jolly（友善的绿色伙伴）、Tree（森林精灵）、Straw Hat Explorer、Neon Founder、Cozy Scholar、Pixel Sprite——每个头像的各个模式都有原创动画 SVG（空闲 / 工作中 / 思考中 / 庆祝中，另有制作、跳舞、里程碑、错误等模式）。2 个角色设定：Sharp Operator、Warm Companion。1 个资源包：Starter Pack（包含全部内容）。
• CLI + MCP 集于一个可执行文件 — 面向用户的 muse-marketplace（别名 mmkt）；同一二进制文件也可作为 MCP 服务（muse-marketplace mcp），提供 marketplace_search、marketplace_list、marketplace_show、marketplace_validate、marketplace_install。
• site/ — 无需构建的静态市场：支持搜索、按类型和标签筛选；点击卡片即可查看动画模式切换器并复制安装命令。
• docs/ — SPEC（条目架构）、PUBLISHING（通过 PR 提交）、VETTING（安全模型）、MODES、ARCHITECTURE、ROADMAP。

快速开始

npm install
npm run build
npm test

node dist/cli.js list
node dist/cli.js install jolly --dest ./muse-assets   # copies files, verifies sha256 before AND after, writes install-receipt.json
node dist/cli.js init my-avatar --kind avatar          # scaffold a listing of your own
node dist/cli.js validate my-avatar
node dist/cli.js index                                  # rebuild registry/index.json
node dist/cli.js doctor                                 # registry health

发布条目

1. muse-marketplace init <your-slug> --kind avatar
2. 将占位 SVG / persona.md 替换为你的实际资源。
3. 运行 muse-marketplace validate <your-slug>，直到检查通过，然后运行 muse-marketplace index。
4. 提交 PR。完整流程请参阅：docs/PUBLISHING.md。

审核 / 安全模型（简版）

没有凭据，就不能在这里自称安全——我们在整个系统中都遵循同一规则：凡是标记为安全的内容，都必须经过实际检查验证。

• 绝不允许可执行文件。 仅允许白名单中的媒体类型（SVG/PNG/JPEG/GIF/WebP、Markdown、纯文本、JSON、音频）。验证会直接拒绝可执行文件扩展名。
• 所有内容均带校验和。 每个条目中的每个文件都会记录其 sha256 和字节大小。validate 会重新计算这些值；install 会在复制前后进行验证，并拒绝已被篡改的条目。
• 路径安全。 拒绝绝对路径和 .. 路径遍历条目；安装操作仅会在你指定的目标目录内进行。
• 审核通过需凭实力。 只有审核者完成 VETTING.md 检查清单后，safety.vetted 才会变为 true——作者不能自行勾选。
• 角色设定采用纯 Markdown，使用前可以通读全文——文件本身就是全部内容，没有隐藏信息。

完整模型：docs/VETTING.md · 安全报告：SECURITY.md

MCP 用法

{ "mcpServers": { "muse-marketplace": { "command": "npx", "args": ["-y", "@reneturcios/muse-marketplace", "mcp"] } } }

工具：marketplace_search · marketplace_list · marketplace_show · marketplace_validate · marketplace_install（安装仅限于调用者在当前工作目录下提供的目标目录）。

路线图

评分与评论、签名条目、站点播放器中的语音预览、可为你创建 PR 的 publish 命令、与其他注册表联合，以及在 Muse 的原生头像分享功能上线后提供一流支持。详情：docs/ROADMAP.md。

MIT。作者：Rene Turcios / CloudCorpRecords。团队：https://github.com/CloudCorpRecords