chrome-store-cli

English · 简体中文

非官方命令行工具：面向 Chrome 网上应用店、Firefox Add-ons、Microsoft Edge 扩展 的发布与素材工作流。

短命令： cws · 版本： 1.3.1

声明： 本项目为非官方工具，与 Google、Mozilla、Microsoft 无隶属、背书或赞助关系。

安装

需要 Node.js 18+。安装后可执行文件：cws、chrome-store-cli。

# 推荐 — 无需全局安装
npx chrome-store-cli --help
npx chrome-store-cli init

# 项目 / 全局安装
npm install -D chrome-store-cli
npm install -g chrome-store-cli
cws --help

快速开始

cws init
cws auth chrome                 # 写入 .env（已 gitignore，切勿提交密钥）
cws materials generate          # 图标 / 截图 / 宣传图 / Listing 草稿
cws materials translate --locales zh_CN
cws materials sync --scaffold --write
cws materials check
cws preflight
cws release --env dev           # 建议先发测试通道
cws status

多商店：

cws firefox upload --dry-run
cws edge publish --dry-run
cws multi publish --stores chrome,firefox,edge --dry-run

命令速览

| 类别 | 命令 | |------|------| | 核心 | init、doctor、checklist、prepare、pack、upload、publish、config | | 体验 | preflight、auth、release、scan、status --watch、tutorial | | 素材 | materials check/generate/translate/locales/sync | | 多商店 | firefox *、edge *、multi publish、adapt | | 辅助 | reject-help、whatsnew、dashboard-fill、review-notes、report、skill install |

多数命令支持 --env <name> 与 --extension <name>。

多语言 Listing（官方能力对齐）

扩展包内提供 _locales/<code>，商店后台才会出现对应语言选项； 按语言维护详细描述、截图与可选宣传视频，放在 store/listing/<locale>/。 小宣传图 / Marquee 仅全局，不可按语言配置。

cws materials generate --listing --locales en,zh_CN --force
cws materials translate --locales zh_CN,ja --force
cws materials sync --scaffold --write
cws materials locales
cws materials check

配置与安全

密钥请放在环境变量或 .env（已忽略）。cws.config.json 中密钥字段建议留空。

详见 docs/credentials.md 与 .env.example。

cws pack --env dev --extension main
cws action-init   # 生成 GitHub Action 模板

给 AI Agent（主入口）

本仓库内置 Agent Skill，可在任意扩展项目中让 Cursor / Claude / Codex 按同一套发版流程工作。

安装 Skill

# A) skills.sh CLI（推荐，有助于 skills.sh 收录与排序）
npx skills add nickylin/chrome-store-cli -g -y

# B) 安装 CLI 之后
cws skill install

# C) 克隆本仓库后
npm run skill:install

安装到 ~/.cursor/skills/chrome-store-cli（若存在则会同步到 ~/.agents/skills）。

然后在任意扩展仓库说：「按 chrome-store-cli skill 发版」。

Skill 与 CLI 同仓维护即可，不必单独拆库。npm 发布步骤见 docs/npm-publish.md。

开发

npm install
npm run build
npm test
npm run selftest

文档

• 凭据说明
• npm 发布
• 路线图
• 配图资源
• 贡献指南
• 行为准则

许可证

MIT