aaden-cli
v1.6.134
Published
Aaden系统的Cli应用.
Readme
aaden-cli
Aaden系统的Cli应用.
usage:
$ >npm istall -g aaden-cli
$ >aaden-cli
_ _____ _ _____
/\ | | / ____| | |_ _|
/ \ __ _ __| | ___ _ __ | | | | | |
/ /\ \ / _` |/ _` |/ _ \ '_ \ | | | | | |
/ ____ \ (_| | (_| | __/ | | | | |____| |____ _| |_
/_/ \_\__,_|\__,_|\___|_| |_| \_____|______|_____|
Aaden@InnerKen CLI Version:1.0.19
Usage: index [options] [command]
Options:
-V, --version output the version number
-d, --debug use Debug Out put
-h, --help display help for command
Commands:
update [channel]
install [options] <deviceId> [channel] 装机(= AadenDeploy/aadensetup.sh):撞号检查、装软件、部署后端、设备号、自检并上报
set-device-id [deviceId] 设定本机设备号:撞号检查、config.ini、主机名、ngrok、立即上报(镜像克隆的机器改号也用它)
setup-wifi
upgrade
where
help [command] display help for command
发布
- 在 master 上运行
npm run update:release-it 把版本号升一个 patch,提交aaden-cli: release vX.Y.Z,打 tagX.Y.Z并推上去。本地不再发布 npm。 要在普通 clone 里运行:release-it 13 认不出git worktree,在 worktree 里只会改版本号,不会提交、打 tag。 - tag 推上去后,GitHub Actions 的
.github/workflows/publish.yml自动执行:- 校验 tag 和
package.json的版本一致,并且 tag 指向的提交在 master 上; - 从这个 tag 对应的提交
npm ci并用 ncc 打包,冒烟检查dist/index.js --version; - 用 npm Trusted Publishing(OIDC)执行
npm publish,不需要 npm token 或 OTP; - 创建 GitHub Release。
- 校验 tag 和
- 全网设备在第二天 04:55 自动
npm install aaden-cli -g装上新版本。
⚠️ latest 一发布就是全网发布。要先在个别设备上试,用预发布通道:
- 在任意分支的提交上打
x.y.z-后缀形式的 tag(如1.6.103-rc.0)并推上去,CI 会把这个提交按 tag 的版本号发到 npm 的next(不需要提交版本号)。 - 设备每天只装
latest,不会自动装next。要试的设备上手动运行sudo npm i -g aaden-cli@next;这台设备第二天 04:55 会自动回到latest。
CI 发布失败时的手动兜底:在 tag 对应的提交上运行 npx ncc build index.js -o dist -C && npm publish(需要 npm 2FA)。
一次性配置:npmjs.com → aaden-cli → Settings → Trusted Publisher → GitHub Actions,填组织 innerken-gmbh、仓库 aaden-cli、workflow publish.yml;允许的操作要勾上 npm publish(2026-09-03 之后新建的配置默认只允许 npm stage publish,直接 publish 会报 403 "OIDC permission denied for this action")。
私有分发(self-update,POS-46 第 2 期)
aaden-cli self-update:从云端拿签名过的版本装到/opt/aaden-cli/<版本>/,/usr/local/bin/aaden-cli指向/opt/aaden-cli/current/package/dist/index.js。第一次跑就把这台设备切到私有通道(root crontab 里的 npm 重装换成 self-update,标记/etc/aaden/config/cli-channel=private)。实现见modules/self-update.js。- 设备命令白名单里只有
SELF_UPDATE(aaden-cli self-update)和CLI_BACK_TO_NPM(aaden-cli self-update --back-to-npm),没有带--force或--allow-downgrade的版本:- 用
--back-to-npm退回过 npm 的设备(标记是npm),之后的self-update会拒绝,只能有人登录上去手动跑aaden-cli self-update --force才能切回 private; - 降级同理,只能登录上去手动
aaden-cli self-update --allow-downgrade。
- 用
- 私有通道的设备上不要跑
npm i -g aaden-cli:链接指向/opt时 npm 会报 EEXIST,还会把/usr/local/lib/node_modules/aaden-cli整个删掉。cron(/usr/local/sbin/aaden-cli-install,即AadenDeploy/Utils/cliInstall.sh)和upgrade.sh都按链接实际指向自动选 self-update;--back-to-npm发现 npm 那份不在会先挪开链接再重装。
