mcpField
O
olares-publish

olares-publish

github.com/beclab营销与增长5.3k149 次安装今天更新
代码仓库

关于 olares-publish

用于将已在本地运行的 Olares 应用提交到公开 Olares Market，涵盖上架文案、本地化、素材、多架构准备及 GitHub 提交流程。

主要功能

  1. 01Market 上架流程
  2. 02Manifest 文案与本地化
  3. 03图标和上架图片准备
  4. 04多架构发布检查
  5. 05GitHub PR 与 GitBot 指引

适用场景

  1. 01提交已在本地验证的应用
  2. 02修改或翻译上架文案
  3. 03准备图标和 Market 图片
  4. 04添加付费应用上架信息

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/beclab/olares --skill olares-publish

安装后在 Claude Code 中输入/olares-publish确认已加载。

包含的文件

除 SKILL.md 外，安装时一起下载的参考资料和脚本。

references/
olares-publish-icon.md
olares-publish-listing-images.md
olares-publish-listing-layout.md
olares-publish-localization.md
olares-publish-manifest-copy.md
olares-publish-paid-apps.md
olares-publish-submit.md
olares-publish-targets.md
scripts/
generate_icon.py
render_promo.py

详细介绍

将 Olares 应用发布到公共 Market

统一入口： 加载 ../olares-shared/SKILL.md，了解套件路由和平台入口。发布本身不需要登录 Olares；只有在返回本地上传／安装验证时，才应用共享的身份验证门槛。

此技能介绍的是公开分发步骤，而非应用创作步骤。 将仓库／compose／Helm chart 转换为 Olares 应用、优化应用，并验证其能在你自己的 Olares 上安装并进入 running 状态，这些内容都在 ../olares-chart/SKILL.md 中。只有在应用已能在本地运行，并且你想将其发布到公共 Olares Market 时，才来这里。

图表语法和创作请使用 olares-cli chart lint --help 和 olares-chart。

适用场景

  • 将应用发布／公开上架／提交／分发到公共 Olares Market
  • 向 beclab/apps 提交 PR 或修复 PR
  • 销售应用（付费下载／付费上架）
  • 制作上架素材，包括应用图标、Market 截图／宣传图
  • 编写、修改、翻译或审核 OlaresManifest.yaml 和本地化清单中的公共 Market 文案
  • 关键词：发布到 Market、提交到 beclab/apps、应用商店上架、应用描述、fullDescription、upgradeDescription、i18n、区域设置、应用图标、metadata.icon、featuredImage / promoteImage、spec.supportArch、多架构、GitBot、owners 文件、price.yaml、付费应用

前提条件——应用必须已能在你的 Olares 上运行。 尚未验证本地安装就提交公开申请，会浪费 GitBot 的处理周期和审核人员的时间。请先按照 olares-chart 技能中的部署步骤完成部署流程。

基本思路

发布是向 beclab/apps 提交的单向贡献，并非 olares-cli publish 生命周期。请从已在本地验证可用的 chart 开始，完善准确的英文上架文案，仅对已声明并维护的区域设置进行本地化，添加公开上架素材和匹配的多架构支持，重新运行 lint，然后通过 GitHub 和 GitBot 提交。

GitBot 会检查机械性政策要求，但不会验证产品质量、截图真实性或安全声明。提交者需对这些声明负责。

工作流索引

当前意图／状态阅读
判断哪些事项会阻止提交、哪些可以延后、元数据深度和架构发布目标
调研、起草或审核英文 Manifest 上架文案Manifest 文案
翻译或审核本地化的 Manifest 文案Manifest 本地化
使用上游素材制作所需的 256×256 图标图标工作流
获取／制作 1440×900 Market 图片上架图片
编写上架图片标题并设计图片布局上架布局
准备文件夹、owners、PR 标题，并处理 GitBot 状态提交工作流
添加付费下载付费应用

发布决策

  • 由于 metadata.icon 是 lint 必填项，图标属于关键路径。主视觉图/截图为可选项，可在 UPDATE 中补充。
  • 为 spec.supportArch 声明的架构构建镜像；单节点本地运行成功，并不能证明公开提供了多架构支持。
  • 资源必须来自上游项目、其网站或用户正在运行的实例。不得虚构 Logo、截图、用户评价或功能。
  • 市场文案必须客观准确、语气中立，并面向应用用户。不要将图表实现细节包装成功能或升级说明。
  • upgradeDescription 为条件字段：首次上架，或没有可靠用户可见升级信息的更新，应省略此字段；绝不要仅为填充字段而添加 Initial release。当获批的英文内容包含有意义的升级说明时，所有已声明的语言区域都必须保持同步。
  • 公开图表所需的凭据必须来自安装时输入、中间件或图表生成过程；绝不要提交有效密钥。
  • 付费分发需要添加 price.yaml 并在应用侧强制执行 VERIFIABLE_CREDENTIAL；这不能替代常规公开上架要求。

验证与异步语义

  • 每次更改清单或资源路径后，都要重新运行图表 lint。
  • 本地化或提交前，解决根目录 Manifest 与英文语言区域 Manifest 之间的文案差异；不要悄悄择一采用或合并。
  • 本地安装和 running 验证属于 Chart/Market 范畴，且可能是异步的；不要据上传 ACK 成功就推断应用可安装。
  • GitBot 处理是异步的。请依据提交引用解读其当前标签/检查状态；不要反复创建重复 PR。

安全与升级处理

  • 未经明确同意，不要代表开发者 fork、推送或创建 PR——这些操作会写入其 GitHub 账号。
  • **此处的 fork 合法且必需。**向公开 Market 提交是标准的开源贡献流程：fork beclab/apps，推送分支并创建 PR。这是公开应用目录，与工作区“禁止 fork，推送到 origin”规则所涵盖的 beclab 开发仓库不同——该规则不适用于向 beclab/apps 提交内容。
  • 对于付费应用，不要运行 did-cli rsa set（这是链上操作，会产生 Gas 费用），不要接触钱包助记词，也不要处理 rsa-private.pem——应引导用户自行操作。
  • 请根据市场就绪检查清单验证图表、编写 price.yaml、接入清单，并解读 GitBot 标签。
  • 如果上游许可、资源来源、架构支持、所有者身份、定价、钱包操作或使用 GitHub 的权限尚不明确，请停止操作。
  • 本地验证所需的上传/安装操作应使用 olares-market。

评论

支持 Markdown