@zan_team/cli 0.0.1 → 0.0.2

package/README.md

@@ -28,8 +28,7 @@ pnpm build
 node dist/cli.js --help
 ```
 
-下文统一使用 `zan`。测试构建产物时，将 `zan` 替换为 `node dist/cli.js`；
-本地源码联调推荐使用下方的 `cli:local` 入口，无需反复构建。
+下文统一使用 `zan`。运行源码构建产物时，将 `zan` 替换为 `node dist/cli.js`。
 
 ### 配置服务地址
 
@@ -37,74 +36,12 @@ CLI 未显式配置服务地址时默认连接生产环境 `https://zan.top`。
 环境变量覆盖 Auth/API Origin：
 
 ```sh
-export ZAN_ENV=dev
 export ZAN_AUTH_BASE_URL=https://auth.example.com
 export ZAN_API_BASE_URL=https://api.example.com
 ```
 
-仓库提供 DEV、SIT、PRE 和 PROD 四套调试配置：
-
-| 环境 | 配置文件    | Origin                                 |
-| ---- | ----------- | -------------------------------------- |
-| DEV  | `.env.dev`  | `http://127.0.0.1:8088`                |
-| SIT  | `.env.sit`  | `https://zan.unchartedw3s.com`         |
-| PRE  | `.env.pre`  | `https://pre.zan.top`                  |
-| PROD | `.env.prod` | `https://zan.top`                      |
-
-### 本地源码联调
-
-开发者可在 CLI 仓库中通过 `pnpm cli:local` 选择一次环境，后续命令会自动沿用；
-源码修改后下一次调用立即生效：
-
-```sh
-pnpm cli:local -- env use dev
-pnpm cli:local -- env status
-pnpm cli:local -- --json --no-interactive usage
-
-# 切换到 SIT
-pnpm cli:local -- env use sit
-
-# 仅本次使用 DEV，不改变保存的选择；--env 必须放在最前面
-pnpm cli:local -- --env dev --json --no-interactive usage
-```
-
-选择保存在当前工作目录的 `.zan-dev.json`，只包含 `environment`，支持
-`dev`、`sit`、`pre`。仅读取当前目录，不向上查找；未选择环境时会报错，
-也可以直接用 `--env sit` 单次指定。`env status` 始终以 JSON 返回环境、
-配置路径、工作目录、源码仓库和 Auth/API 地址，不包含凭据。
-
-测试 Agent 应直接通过 Node 调用源码入口，避免 pnpm 的脚本横幅影响 JSON 解析。
-在其他业务项目中，保留该项目的工作目录，使用源码入口的绝对路径：
-
-```sh
-node /absolute/path/to/zan-cli/scripts/zan-dev.mjs env use sit
-node /absolute/path/to/zan-cli/scripts/zan-dev.mjs --json --no-interactive usage
-```
-
-该入口从 CLI 仓库读取依赖、源码和环境文件，保留调用方工作目录。
-每个测试项目分别保存环境选择；登录、Project/Network 等仍是用户级、按环境共享的状态。
-同目录并发测试不同环境时，各命令显式使用 `--env`。
-
-此功能仅用于源码联调：正式 `zan` 和发布的 CLI 不读取 `.zan-dev.json`，
-开发脚本不随 npm 包发布。给最终用户的 Skill 只保留正式 CLI 用法。
-Agent 入口约定、写文件命令和状态隔离说明见[本地开发指南](docs/local-development.md)。
-
-也可以通过 DEV、SIT、PRE 和 PROD 脚本直接指定环境，`--` 后的参数会完整传给 CLI：
-
-```sh
-pnpm cli:dev -- auth login
-pnpm cli:sit -- auth status --verify
-pnpm cli:pre -- --json project list
-pnpm cli:prod -- auth login
-pnpm cli:prod -- --json project list
-pnpm cli:prod -- usage
-```
-
-环境脚本会覆盖当前终端残留的 `ZAN_ENV`、`ZAN_AUTH_BASE_URL` 和
-`ZAN_API_BASE_URL`。DEV、SIT、PRE 分别使用独立的系统凭据 Profile、Session、
-Project/Network 设置和 Endpoint 缓存；PROD 继续使用兼容既有安装的
-`profile-default`、`session.json` 和 `settings.json`。非生产设置分别保存在
-`settings.dev.json`、`settings.sit.json` 和 `settings.pre.json`。
+上述 `example.com` 地址仅用于展示配置方式，不能直接使用。日常使用无需覆盖
+服务地址；内部环境地址和配置请通过授权渠道获取，不要写入公开文档或示例。
 
 ### 登录
 
@@ -400,27 +337,17 @@ zan project cache clear
 Project 使用不同缓存文件与密钥。普通设置文件仍只保存 Project ID 和 Network
 ID，不保存 Endpoint 或 API Key。
 
-#### SIT 调试与 RPC API Key 覆盖
-
-源码调试时可以直接使用环境脚本：
-
-```sh
-pnpm cli:sit -- project use <project-id>
-pnpm cli:sit -- evm networks
-pnpm cli:sit -- evm networks --refresh
-pnpm cli:sit -- project cache status
-pnpm cli:sit -- project cache clear
-```
+#### RPC API Key 覆盖
 
 需要临时替换当前 Project 的 RPC API Key 时，通过隐藏输入或 stdin 写入系统
 凭据库：
 
 ```sh
-pnpm cli:sit -- project rpc-key set
+zan project rpc-key set
 printf '%s\n' "$TEST_RPC_API_KEY" \
-  | pnpm cli:sit -- project rpc-key set --stdin
-pnpm cli:sit -- project rpc-key status
-pnpm cli:sit -- project rpc-key clear
+  | zan project rpc-key set --stdin
+zan project rpc-key status
+zan project rpc-key clear
 ```
 
 覆盖值不会出现在命令参数、普通配置、Endpoint 缓存或命令输出中。启用覆盖后，
@@ -430,8 +357,6 @@ RPC 401/403 不会自动换回服务端下发的 Key，便于稳定测试指定
 
 ```sh
 zan project rpc-key pull
-# 源码 SIT 调试：
-pnpm cli:sit -- project rpc-key pull
 ```
 
 命令写入当前工作目录中固定的 `ZAN_API_KEY`：已存在时替换，缺少时追加，文件
@@ -441,8 +366,8 @@ pnpm cli:sit -- project rpc-key pull
 后的文件在 POSIX 系统上使用 `0600` 权限，并通过文件锁和原子替换写入；符号链接
 或非普通 `.env` 会被拒绝。
 
-`pull` 只写 `.env`，不会修改 `.env.dev`、`.env.sit`、`.env.pre` 或
-`.env.prod`。它不会检查 Git 跟踪状态或自动更新 `.gitignore`，请自行确保 `.env`
+`pull` 只写 `.env`，不会修改其他环境配置文件。
+它不会检查 Git 跟踪状态或自动更新 `.gitignore`，请自行确保 `.env`
 不会被提交。写入后，任何拥有当前目录读取权限的进程或 Agent 都可能读取这个明文
 文件；“不泄露”保证只覆盖该命令自身的参数、输出、错误和日志边界。
 
@@ -518,7 +443,9 @@ printf '["0x0000000000000000000000000000000000000000","latest"]' \
 ~/.zan-cli/config.yaml
 ```
 
-`~` 由操作系统用户目录 API 解析。该文件是个人 CLI 策略，与 `.env.dev`、`.env.sit`、`.env.pre`、`.env.prod`、`ZAN_ENV` 及所选 ZAN 后端环境完全无关；`ZAN_HOME` 不会改变它的位置，DEV、SIT、PRE、PROD 读取同一个文件。
+`~` 由操作系统用户目录 API 解析。该文件是个人 CLI 策略，与环境配置文件、
+`ZAN_ENV` 及所选 ZAN 后端环境无关；`ZAN_HOME` 不会改变它的位置，所有环境
+读取同一个文件。
 
 YAML schema 支持两个顶层属性，分别控制 Raw JSON-RPC 和 Hyperliquid Info 方法：
 
@@ -683,17 +610,6 @@ Agent 可用 `inspect` 检查本地状态；`ready: false` 需结合实际命令
 Project/Network 选择、套餐与 Key 用量、EVM/Hyperliquid 查询、RPC Key 拉取及钱包签名指引。
 `skills/` 随 npm 包发布；安装 CLI 后仍需将技能目录放入 Agent 的发现路径。
 
-本仓库已通过 `.agents/skills/zan-cli` 软链接指向 `skills/zan-cli`。在 Codex
-中打开本仓库即可发现技能，修改源文件无需复制。若未显示，重启 Codex 后尝试：
-
-```text
-使用 $zan-cli 列出当前支持的命令。本任务把技能中的 zan 统一替换为
-node /absolute/path/to/zan-cli/scripts/zan-dev.mjs --env sit。
-```
-
-将示例路径替换为实际 CLI 仓库路径。该入口约定仅用于本地测试；
-环境选择和状态隔离说明见[本地开发指南](docs/local-development.md)。
-
 npm 包发布后，安装 CLI 并选择 Agent 安装技能：
 
 ```sh
@@ -796,13 +712,6 @@ zan completions fish
 名称，或通过 `zan project list` 查找项目后执行 `zan project use <id>` 使用已有
 项目；此错误不可重试，仍使用 `ZAN_API_ERROR` 和退出码 `8`。
 
-本地联调遇到 “No free Node Service plan is configured for this environment” 时，
-需在 `webtservice` 的本地数据库中配置 `/default/AVAILABLE_FREE_SPEC`，其中
-`AVAILABLE_FREE_SPEC.NODE_SERVICE.specId` 必须指向有效的 `drw3_service_spec`
-商品规格。只启动 MySQL、Redis 或重新登录不会生成这些商品数据；应导入环境
-对应的测试商品配置，并确认该规格所需的套餐开通及回调链路可用。后端代码
-修改后，需要重新编译并重启实际监听本地 API 端口的进程。
-
 已认证的 Project 与 Network 请求如果通过 HTTP 401 或已发布的 WebResult
 语义表明 Access Token 无效，会刷新一次 Access Token 并重放一次请求。第二次
 仍失败时返回 `AUTH_EXPIRED`，不会继续刷新。普通 HTTP 403 和 Scope 不足不会
@@ -810,6 +719,8 @@ zan completions fish
 
 ### 安全注意事项
 
+- 对外文档、截图和问题反馈中不要包含内部开发、测试或预发域名、IP、端口及环境配置；
+  示例统一使用 `example.com` 等占位地址，分享命令输出前先检查并脱敏。
 - 不要把 Access Token、Refresh Token、Project Token 或完整 Endpoint 写入脚本、日志和普通配置。
 - 不要使用 `--verbose` 输出处理结果中的敏感字段。
 - 完整 RPC Endpoint 只在当前进程内解密使用；本地仅保存 AES-256-GCM 密文，

package/dist/cli.js

@@ -1891,7 +1891,7 @@ function registerSign(program, outputWriter, getRuntimeContext) {
 }
 
 // src/version.ts
-var CLI_VERSION = true ? "0.0.1" : pkg.version;
+var CLI_VERSION = true ? "0.0.2" : pkg.version;
 
 // src/commands/version.ts
 function registerVersion(program, outputWriter) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zan_team/cli",
-  "version": "0.0.1",
+  "version": "0.0.2",
   "description": "Unified ZAN command-line interface for developers, automation, and AI agents",
   "type": "module",
   "bin": {