linktools-cli

LinkTools 子工具的前端脚手架、本地联调与打包发布 CLI。

安装

npm install -g linktools-cli

或在仓库内本地链接：

npm install
npm link

命令

| 命令 | 说明 | |------|------| | linktools init <name> | 从 template/ 初始化 com.tools.<name> 工程 | | linktools dev | 启动静态服务并写入 ~/.tools/dev_active.json 供宿主联调 | | linktools build | 校验 manifest.json 并打包 {appId}.zip + SHA-256 |

典型工作流

linktools init my-tool
cd com.tools.my-tool
npm install
npm run build
linktools dev

在 LinkTools 主页打开 (Dev) 卡片即可加载本地工程。修改代码后需重新 npm run build 并刷新工具窗口。

发布前执行 linktools build，将 zip 与哈希填入宿主 OTA 安装面板。

模板说明

template/ 为 React 19 + TypeScript + Chakra UI v3 子工具前端模板，由 init 拷贝到目标目录。

强制更新检查

每次执行 init / dev / build 前，CLI 会向 npm registry 查询 linktools-cli 最新版本。若本地版本落后，将拒绝执行并提示：

npm install -g linktools-cli@<最新版本>

本地开发（npm link）可跳过检查：

export LINKTOOLS_SKIP_UPDATE_CHECK=1

发布包内容

npm 包仅包含 index.js 与 template/（见 package.json 的 files 字段）。