用 AI Agent 一键上架授权产品

v1.0.0

用 AI Agent 一键上架授权产品

适用于：需要在幂栈网上架多个授权软件产品、反复走"注册 → 申请合作伙伴 → 上传素材 → 提交产品"链路的开发者。

一、这是什么

我们把这个上架流程沉淀成了一份 Agent Skill（AI 编码助手用的 Markdown 剧本 + 零依赖 Node 脚本），放在公开仓库：

仓库：https://github.com/mizhanchengxi/powersoftware-agent-skills
Skill 名：publish-license-product
许可证：MIT

Skill 会告诉 Qoder / Claude Code / 任意兼容 Agent 如何按顺序调用平台 HTTP 接口完成整个上架链路，并在必须人工介入的节点强制停下。

二、一键安装

macOS / Linux / WSL：

bash <(curl -sL https://raw.githubusercontent.com/mizhanchengxi/powersoftware-agent-skills/main/install.sh)

Windows PowerShell：

iwr -useb https://raw.githubusercontent.com/mizhanchengxi/powersoftware-agent-skills/main/install.ps1 | iex

Claude Code Plugin Marketplace（推荐 Claude 用户）：

/plugin marketplace add mizhanchengxi/powersoftware-agent-skills
/plugin install publish-license-product@powersoftware-agent-skills

装完之后，直接在 AI 助手里说一句"帮我在幂栈上架一个 TRIAL_FIRST 产品"即可触发。

三、Skill 覆盖的完整链路

阶段	干什么	谁来做
1. 注册	`POST /user/register` + 邮箱验证码	AI 全自动
2. 登录	拿 `SESSION_ID` cookie	AI 全自动
3. 申请合作伙伴	`POST /developer/save` 提交入驻资料	AI 全自动
4. 平台运营人工审核	审批 `auditStatus` → `PASS`	⛔ 必须人工，AI 会停在这一步
5. 重新登录	审核通过后必须再登一次，`DEVELOPER` 角色只在登录时注入	AI 全自动
6. 上传素材	封面 / 3-20 详情图 / 安装包，走 `checkFileExists → getPreSignedUrl → PUT` 三步	AI 全自动
7. 提交产品	`POST /product/submit` 组装完整 payload	AI 全自动

四、为什么审核这一步不能自动

DEVELOPER 角色只在登录时注入，判断依据是 developer.auditStatus === PASS。也就是说：

就算你材料已经提交，运营没点通过，session 里就没有 DEVELOPER；
/product/submit 第一行会校验 session.role.includes(DEVELOPER)，否则返回 need_developer_role。

Skill 把这一点编码成硬暂停点——apply-partner.mjs 提交完会打印 ⛔ HUMAN GATE 并退出，等你手动通过审核后再跑 login.mjs 拿新 session，然后 publish.mjs 才能成功。不能、也不应该绕过。

五、素材上传为什么必须严格按顺序

产品的封面、详情图、安装位在 payload 里存的都是 objectName（相对 URI），必须先完成三步上传：

POST /file/upload/checkFileExists（md5 内容寻址去重，秒传）
POST /file/upload/getPreSignedUrl（拿 R2 预签名 PUT URL）
PUT 二进制到 signedUrl

businessType 必须用枚举值 product_cover_picture / product_detail_picture / product_file，字面量 FILE 会被后端 zod 校验拒绝。这些细节 publish.mjs 已经全部处理，你只需要在 spec 里贴本地文件路径。

六、授权产品的关键字段（速查）

Skill 附带的 templates/product.license.example.json 展示了一个完整 TRIAL_FIRST 授权产品：

salesModel = TRIAL_FIRST 时 productPrice 必须为 0 / null，trialDays 必填
licenseEditions（BASIC / PRO / ULTIMATE）价格必须严格升序
softwareVersion 遵循 x.y.z 语义化版本
introduce.images 数量必须在 3–20 之间

七、下一步

Skill 里包含 5 个零依赖 Node 18+ 脚本，你可以直接改脚本或加接口
反馈 / Issue / PR 都欢迎：https://github.com/mizhanchengxi/powersoftware-agent-skills/issues

本指南由 publish-license-product Skill 自动同步；Skill 与文档同源。