lxwx-ext

灵犀万象 (LXWX) 扩展开发命令行工具 — 面向合作方开发者的一站式扩展开发 CLI:从初始化、本地调试、测试、预检到发布与运营数据,全流程命令行覆盖。

安装

npm i -g lxwx-ext

要求 Node.js >= 18。安装后命令名为 trade-ext。

快速开始(五分钟上手)

trade-ext                 # 不带参数运行,按当前状态给出下一步指引
trade-ext doctor          # 环境自检:Node / Docker / 登录态 / 平台连通,有问题先跑这个
trade-ext login           # 登录(平台「账号设置」中获取 Developer Token)
trade-ext init my-ext     # 初始化扩展工作区(默认多扩展,-s 创建单扩展项目)
cd my-ext/extensions/*    # 进入扩展目录
trade-ext dev             # 启动本地开发环境(Docker 热重载,-S 连接云沙箱)

开发流程

trade-ext new my-module   # 工作区内新增扩展
trade-ext validate        # 发布前本地预检(不联网):manifest / i18n / 构建配置
trade-ext test            # 运行扩展测试(转发 package.json 的 test 脚本)
trade-ext logs            # 查看开发环境日志,-f 持续跟踪
trade-ext publish -n      # dry-run:预检 + 展示将发布的文件与体积,不上传
trade-ext publish         # 正式发布(内置预检,含前端页面自动构建远程产物)

市场与运营

trade-ext search 关键词    # 搜索市场扩展,-c 按分类过滤
trade-ext info <包名>      # 查看扩展详情:版本 / 认证 / 下载量 / 评分 / 价格
trade-ext stats            # 我的扩展运营数据:下载量 / 评分 / 上架状态
trade-ext versions         # 我的发布版本与审核进度(待审核 / 已通过 / 已拒绝)
trade-ext unpublish <包名> # 下架我的扩展(-r 恢复上架)

账户与其他

trade-ext whoami          # 当前登录身份与 Registry
trade-ext logout          # 退出登录(共享电脑必用)
trade-ext upgrade         # 升级 CLI 到最新版(每次运行也会自动提醒新版本)
trade-ext docs            # 打开扩展开发文档

常见问题

• 命令执行到一半报错 → 先跑 trade-ext doctor,每个失败项都带修复建议。
• publish 被预检拦下 → 预检错误会在上传前拦截,按提示修复后重试;警告不阻塞发布。
• 多环境切换 → trade-ext login -u <registry-url> 指定不同平台地址即可。

版本

• 0.2.0 — 2026-08-15 发布

• 0.2.0 — 2026-08-16 新增 doctor / logout / validate / test / logs / info / stats / versions / unpublish / docs、零参数引导、publish 预检与 dry-run、新版本自动提醒

• 0.1.0 — 2026-08-16 发布