@zhiyueyun/cli 0.2.16

package/README.md

@@ -0,0 +1,48 @@
+# @zhiyueyun/cli
+
+职阅开放平台官方 CLI。命令 Catalog、业务域映射和领域 Skill 随二进制一起发布，
+本机只使用这份发布快照，运行时不会再拉内部仓库。
+
+## 安装
+
+```bash
+npm install -g @zhiyueyun/cli
+printf '%s\n' 'zy_...' | zhiyue-cli login --api-key-stdin --check
+```
+
+一个 npm 包包含 macOS、Linux 和 Windows 的原生二进制；运行时只启动当前
+系统和 CPU 架构对应的一份。支持 macOS（Apple Silicon/Intel）、Linux（x64/arm64）
+和 Windows（x64/arm64）。
+
+个人 API Key 在 [开放平台个人对接](https://open-platform.zhiyueyun.com/open-platform/personal-applications) 创建。
+
+从开放平台下载并安装 `zhiyue-unified` Skill（ZIP 根目录即为 Skill 根）。setup 会安装或检查
+`zhiyue-cli`，再调用 `zhiyue-cli skills sync --destination <zhiyue-unified>/references`
+把 CLI 内嵌的领域 Skill references 投影到统一 Skill。多个 Agent Host 可以共用
+同一个 CLI。
+
+```bash
+zhiyue-cli skills list
+zhiyue-cli skills read zhiyue-task
+zhiyue-cli skills sync --destination ~/.workbuddy/skills/zhiyue-unified/references
+```
+
+升级 CLI 后，在已安装的 `zhiyue-unified` 目录中再次运行 `scripts/setup.py`。
+
+## 命令
+
+| Command | Purpose |
+| --- | --- |
+| `doctor` | 检查 CLI、凭据和内嵌 Catalog 快照 |
+| `login` / `logout` | 管理个人 API Key |
+| `domains` | 列出内嵌业务域 |
+| `domain lookup <serviceCode>` | 查询内嵌 `serviceDomainMap` |
+| `schema [operationId]` | 查看操作参数、Scope 和命令路径 |
+| `catalog list` | 查看 CLI 内嵌的 Command Catalog 与映射 |
+| `skills list/read` | 查看 CLI 内嵌的共享规则和领域 references |
+| `skills sync` | 同步 CLI 内嵌的领域 references 到一个已安装的 `zhiyue-unified` |
+| `<domain> <resource> <action>` | 经开放平台网关调用业务能力 |
+
+写操作必须先以 `--dry-run` 预览，获得确认后再加 `--yes`。
+
+每次业务调用只使用目标 serviceCode 的小范围 Token，由网关再换成操作级 Token。CLI 将 service Token 按 serviceCode 缓存到期前的短暂时间（目录 700、文件 600），不持久化操作级 Token。

package/bin/zhiyue-cli.js

@@ -0,0 +1,47 @@
+#!/usr/bin/env node
+'use strict';
+
+const { spawnSync } = require('child_process');
+const { existsSync } = require('fs');
+const { join } = require('path');
+
+const BUNDLED_BINARIES = {
+  'darwin-arm64': 'native/darwin-arm64/zhiyue-cli',
+  'darwin-x64': 'native/darwin-x64/zhiyue-cli',
+  'linux-arm64': 'native/linux-arm64/zhiyue-cli',
+  'linux-x64': 'native/linux-x64/zhiyue-cli',
+  'win32-arm64': 'native/win32-arm64/zhiyue-cli.exe',
+  'win32-x64': 'native/win32-x64/zhiyue-cli.exe',
+};
+
+const resolveBundledBinary = (platform, arch) => BUNDLED_BINARIES[`${platform}-${arch}`];
+
+const main = () => {
+  const key = `${process.platform}-${process.arch}`;
+  const relativeBinary = resolveBundledBinary(process.platform, process.arch);
+  if (!relativeBinary) {
+    console.error(
+      `zhiyue-cli: unsupported platform ${key} (supported: ${Object.keys(BUNDLED_BINARIES).join(', ')})`,
+    );
+    process.exit(1);
+  }
+
+  const bin = join(__dirname, '..', relativeBinary);
+  if (!existsSync(bin)) {
+    console.error(`zhiyue-cli: bundled binary is missing for ${key}. Reinstall @zhiyueyun/cli.`);
+    process.exit(1);
+  }
+
+  const result = spawnSync(bin, process.argv.slice(2), { stdio: 'inherit' });
+  if (result.error) {
+    console.error(result.error.message);
+    process.exit(1);
+  }
+  process.exit(result.status ?? 1);
+};
+
+if (require.main === module) {
+  main();
+}
+
+module.exports = { resolveBundledBinary };

package/package.json

@@ -0,0 +1,47 @@
+{
+  "name": "@zhiyueyun/cli",
+  "version": "0.2.16",
+  "description": "Official Zhiyue Open Platform CLI with embedded command metadata and Agent Skills",
+  "keywords": [
+    "cli",
+    "zhiyue",
+    "open-platform",
+    "agent",
+    "skills"
+  ],
+  "author": "AnyBuilder Team",
+  "private": false,
+  "bin": {
+    "zhiyue-cli": "bin/zhiyue-cli.js",
+    "zy": "bin/zhiyue-cli.js"
+  },
+  "publishConfig": {
+    "registry": "https://registry.npmjs.org/",
+    "access": "public"
+  },
+  "files": [
+    "bin/zhiyue-cli.js",
+    "native",
+    "README.md"
+  ],
+  "scripts": {
+    "build": "make build",
+    "build:all": "make build-all",
+    "test": "make test",
+    "check": "make check",
+    "prepublishOnly": "python3 scripts/check_release_snapshot.py && test -f bin/zhiyue-cli.js && test -f internal/registry/catalog.json && test -f skills/zhiyue-shared/SKILL.md && make build-all"
+  },
+  "os": [
+    "darwin",
+    "linux",
+    "win32"
+  ],
+  "cpu": [
+    "x64",
+    "arm64"
+  ],
+  "engines": {
+    "node": ">=16"
+  },
+  "license": "MIT"
+}