@zhizhi-ai/cli 0.1.0 → 0.1.2

package/README.md

@@ -0,0 +1,84 @@
+# @zhizhi-ai/cli
+
+Zhizhi 命令行客户端。
+
+## 用法
+
+不全局安装，直接通过 `npx` 运行：
+
+```sh
+npx @zhizhi-ai/cli --help
+```
+
+也可以全局安装后使用 `zhizhi` 命令：
+
+```sh
+npm install -g @zhizhi-ai/cli
+zhizhi --help
+```
+
+## 远端机器接入
+
+在远端机器上使用 Web 端生成的 pairing token 注册 runtime connector：
+
+```sh
+npx @zhizhi-ai/cli connect \
+  --server https://your-zhizhi-server.example.com \
+  --workspace-id <workspace-id> \
+  --pairing-token <pairing-token> \
+  --name "Remote Computer"
+```
+
+注册成功后，启动 connector：
+
+```sh
+npx @zhizhi-ai/cli serve
+```
+
+后台启动 connector，并把日志写入本机 Zhizhi root 下的 daemon 日志文件：
+
+```sh
+npx @zhizhi-ai/cli serve --background
+```
+
+只执行一轮 heartbeat/claim，用于轻量诊断：
+
+```sh
+npx @zhizhi-ai/cli serve --once
+```
+
+## 常用命令
+
+```sh
+# 查看本地 connector profile 和 server live status
+npx @zhizhi-ai/cli status
+
+# 查看本地 daemon 状态
+npx @zhizhi-ai/cli daemon status
+
+# 查看本地 daemon 日志尾部，默认 80 行
+npx @zhizhi-ai/cli daemon logs --tail 120
+
+# 停止后台 daemon
+npx @zhizhi-ai/cli daemon stop
+
+# revoke connection key 并删除本地 profile
+npx @zhizhi-ai/cli disconnect
+
+# 轮换 connection key
+npx @zhizhi-ai/cli rotate-key
+
+# 输出 CLI 版本
+npx @zhizhi-ai/cli version
+
+# 本地轻量诊断
+npx @zhizhi-ai/cli doctor
+```
+
+## 本地配置位置
+
+所有命令都支持全局参数 `--root <PATH>` 覆盖本机 Zhizhi root；它的优先级高于 `ZHIZHI_ROOT` 环境变量。
+
+```sh
+npx @zhizhi-ai/cli --root /opt/zhizhi-client status
+```

package/bin/zhizhi.js

@@ -6,7 +6,7 @@ const require = createRequire(import.meta.url);
 
 const targets = {
   "darwin-arm64": "@zhizhi-ai/cli-darwin-arm64",
-  "linux-x64": "@zhizhi-ai/cli-linux-x64"
+  "linux-x64": "@zhizhi-ai/cli-linux-x64-musl"
 };
 
 const targetKey = `${process.platform}-${process.arch}`;
@@ -24,7 +24,7 @@ try {
   binaryPath = require.resolve(`${packageName}/bin/zhizhi`);
 } catch {
   console.error(
-    `Missing platform package ${packageName}. Reinstall @zhizhi/cli on this machine and try again.`
+    `Missing platform package ${packageName}. Reinstall @zhizhi-ai/cli on this machine and try again.`
   );
   process.exit(1);
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zhizhi-ai/cli",
-  "version": "0.1.0",
+  "version": "0.1.2",
   "description": "Zhizhi command line client",
   "license": "UNLICENSED",
   "type": "module",
@@ -8,11 +8,12 @@
     "zhizhi": "bin/zhizhi.js"
   },
   "files": [
-    "bin/zhizhi.js"
+    "bin/zhizhi.js",
+    "README.md"
   ],
   "optionalDependencies": {
-    "@zhizhi-ai/cli-darwin-arm64": "0.1.0",
-    "@zhizhi-ai/cli-linux-x64": "0.1.0"
+    "@zhizhi-ai/cli-darwin-arm64": "0.1.2",
+    "@zhizhi-ai/cli-linux-x64-musl": "0.1.2"
   },
   "publishConfig": {
     "access": "public"