SuperAPI AI 工具集

mir-publish-guide

编程与开发

查看项目

更新于 10-16 08:44

技能介绍

用途:当用户询问「如何公开 snippet」「publish 的步骤」「怎样注册到 registry」时,该技能用于向用户说明 mir snippet 的公开方法,分为本地 registry 与远程 registry 两种。

流程:先确认用户情况,包括 snippet 是否已创建,并必须让用户确认公开目标。选项为本地 registry(~/.mir/registry/,仅保存在自己的 PC 内)与 official-registry(全世界任何人可查看和安装,需充分确认公开无问题)。

本地 registry 发布:确认 .mir/snippets/<name>.yaml 与 .mir/snippets/<name>/ 齐备;发布前用 npx mir sync <name> 更新变量定义、npx mir preview <name> 预览生成内容;执行 npx mir publish <name>。若已存在同名 snippet 会显示确认提示,可用 --force 跳过:npx mir publish <name> --force。本地 registry 无需特殊认证。

远程 registry 发布:先登录获取 publish token,npx mir login,或指定 registry:npx mir login --registry=my-remote。浏览器会打开 GitHub OAuth 登录,token 自动保存到配置。也可在 mirconfig.yaml 手动配置 url 与 publish_token(registries 下 name、url、publish_token)。发布执行 npx mir publish <name> --registry=my-remote,会向 POST <url>/api/snippets 发送 snippet 定义与文件群。登出使用 npx mir logout。

公开前确认:变量定义是否为最新、snippet.yaml 的 name、description、version、tags 是否设置妥当、生成内容是否无问题。

限制与注意:远程 registry 基本为只读,发布需要 publish_token;本地 registry 不需要特别认证。资料未提供其他平台、收费或效果信息。