@yosai/cli 0.2.1-test.0 → 0.2.1-test.2

package/dist/cli.js

@@ -25,7 +25,8 @@ export function renderHelp() {
         '',
         '环境变量（均优先于配置文件，便于 CI 免落盘）:',
         '  YOS_API_KEY     访问令牌',
-        '  YOS_ENDPOINT    BFF 服务地址',
+        '  YOS_ENV         服务环境（prod / test / dev；缺省生产）',
+        '  YOS_ENDPOINT    自定义服务地址（CI / 本地联调，一般无需设置）',
         '  YOS_CONFIG_DIR  配置目录（缺省 ~/.config/yos）',
         '',
         '示例:',

package/dist/commands/doctor.js

@@ -1,5 +1,6 @@
 import { register } from '../cli.js';
 import { loadConfig, maskKey, resolveEndpoint, resolveKey } from '../config.js';
+import { envLabel } from '../endpoints.js';
 import { CliError, EXIT } from '../errors.js';
 import { formatIdentity, OpenApisClient } from '../openapis-client.js';
 import { print, printJson } from '../output.js';
@@ -15,15 +16,16 @@ register({
     async run({ flags }) {
         const checks = [];
         const config = loadConfig();
+        const endpoint = resolveEndpoint(config);
         checks.push({
             name: '配置文件',
             ok: config !== null,
             detail: config ? '已找到' : '未找到，请执行 yos login',
         });
         checks.push({
-            name: '服务端点',
+            name: '服务环境',
             ok: true,
-            detail: `${resolveEndpoint(config)}（来自 ${endpointSource(config)}）`,
+            detail: `${envLabel(endpoint)}（来自 ${endpointSource(config)}）`,
         });
         let key = null;
         try {
@@ -39,7 +41,7 @@ register({
         }
         else {
             try {
-                const identity = await new OpenApisClient(`${resolveEndpoint(config)}/open-apis`, key).whoami();
+                const identity = await new OpenApisClient(`${endpoint}/open-apis`, key).whoami();
                 checks.push({ name: '服务连通', ok: true, detail: `身份 ${formatIdentity(identity)}` });
             }
             catch (e) {
@@ -58,7 +60,7 @@ register({
         checks.push({
             name: 'CLI 版本',
             ok: meta !== null,
-            detail: meta ? `${meta.version}（endpoint=${resolveEndpoint(config)}）` : 'unknown（未找到 package.json）',
+            detail: meta ? `${meta.version}（环境=${envLabel(endpoint)}）` : 'unknown（未找到 package.json）',
         });
         const state = loadVersionState();
         checks.push({
@@ -83,7 +85,10 @@ function endpointSource(config) {
     if (process.env.YOS_ENDPOINT) {
         return 'YOS_ENDPOINT';
     }
-    return config?.endpoint ? '配置文件' : '内置缺省';
+    if (process.env.YOS_ENV) {
+        return 'YOS_ENV';
+    }
+    return config?.endpoint || config?.env ? '配置文件' : '内置缺省';
 }
 function skillSyncDetail(meta, state, skillDirs) {
     if (skillDirs.length === 0) {

package/dist/commands/login.js

@@ -1,27 +1,31 @@
 import { register } from '../cli.js';
-import { loadConfig, maskKey, normalizeEndpoint, saveConfig } from '../config.js';
-import { DEFAULT_ENDPOINT } from '../endpoints.js';
+import { loadConfig, maskKey, resolveEndpoint, saveConfig } from '../config.js';
+import { envLabel, envNameOf } from '../endpoints.js';
 import { UsageError } from '../errors.js';
 import { formatIdentity, OpenApisClient } from '../openapis-client.js';
 import { print } from '../output.js';
 import { readHiddenLine } from '../prompt.js';
 register({
     name: 'login',
-    description: '配置访问令牌与 BFF 端点（校验身份后保存）',
-    usage: 'yos login [--endpoint <url>] [--key <key>]',
+    description: '配置访问令牌与服务环境（校验身份后保存）',
+    usage: 'yos login [--env <name>] [--endpoint <url>] [--key <key>]',
     group: '基础',
     options: {
+        env: { type: 'string' },
         endpoint: { type: 'string' },
         key: { type: 'string' },
     },
     paramNotes: [
-        ['--endpoint', 'BFF 服务地址（缺省读 YOS_ENDPOINT，再缺省生产环境；本地联调 http://localhost:8080）'],
+        ['--env', '服务环境（prod / test / dev；缺省读 YOS_ENV，再缺省生产）'],
+        ['--endpoint', '自定义服务地址（本地联调等；优先于 --env）'],
         ['--key', '访问令牌（40 位小写 hex，缺省读 YOS_API_KEY，否则交互输入）'],
     ],
     async run({ flags }) {
         const config = loadConfig();
-        const endpoint = normalizeEndpoint(flags.endpoint
-            ?? process.env.YOS_ENDPOINT ?? config?.endpoint ?? DEFAULT_ENDPOINT);
+        const endpoint = resolveEndpoint(config, {
+            endpoint: flags.endpoint,
+            env: flags.env,
+        });
         const key = flags.key
             ?? process.env.YOS_API_KEY
             ?? await readHiddenLine('请粘贴访问令牌（输入不回显，客户端「个人设置-访问令牌」页创建并复制）: ');
@@ -29,7 +33,8 @@ register({
             throw new UsageError('令牌格式不正确（应为 40 位小写 hex）', '请在客户端「个人设置-访问令牌」页创建并复制完整令牌');
         }
         const identity = await new OpenApisClient(`${endpoint}/open-apis`, key).whoami();
-        saveConfig({ ...config, endpoint, apiKey: key });
-        print(`已保存配置：endpoint=${endpoint}，key=${maskKey(key)}，身份 ${formatIdentity(identity)}`);
+        const envName = envNameOf(endpoint);
+        saveConfig({ ...config, env: envName ?? undefined, endpoint: envName ? undefined : endpoint, apiKey: key });
+        print(`已保存配置：环境=${envLabel(endpoint)}，key=${maskKey(key)}，身份 ${formatIdentity(identity)}`);
     },
 });

package/dist/commands/ping.js

@@ -1,5 +1,6 @@
 import { register } from '../cli.js';
 import { loadConfig, resolveEndpoint, resolveKey } from '../config.js';
+import { envNameOf } from '../endpoints.js';
 import { CliError, EXIT } from '../errors.js';
 import { formatIdentity, OpenApisClient } from '../openapis-client.js';
 import { print, printErr, printJson } from '../output.js';
@@ -9,14 +10,15 @@ register({
     usage: 'yos ping [--json]',
     group: '基础',
     options: { json: { type: 'boolean' } },
-    paramNotes: [['--json', '结构化输出（ok / endpoint / userCode / userName / error）']],
+    paramNotes: [['--json', '结构化输出（ok / env / userCode / userName / error）']],
     async run({ flags }) {
         const config = loadConfig();
         const endpoint = resolveEndpoint(config);
+        const env = envNameOf(endpoint) ?? endpoint;
         try {
             const identity = await new OpenApisClient(`${endpoint}/open-apis`, resolveKey(config)).whoami();
             if (flags.json) {
-                printJson({ ok: true, endpoint, userCode: identity.userCode, userName: identity.userName });
+                printJson({ ok: true, env, userCode: identity.userCode, userName: identity.userName });
             }
             else {
                 print(`✓ 连接成功，令牌有效：身份 ${formatIdentity(identity)}`);
@@ -26,7 +28,7 @@ register({
         catch (e) {
             const failure = e instanceof CliError ? e : new CliError(String(e), EXIT.BUSINESS);
             if (flags.json) {
-                printJson({ ok: false, endpoint, error: failure.message });
+                printJson({ ok: false, env, error: failure.message });
             }
             else {
                 printErr(`错误: ${failure.message}`);

package/dist/commands/version.js

@@ -1,5 +1,6 @@
 import { register } from '../cli.js';
 import { loadConfig, resolveEndpoint } from '../config.js';
+import { envNameOf } from '../endpoints.js';
 import { BusinessError } from '../errors.js';
 import { compareVersions, detectGlobalInstall, fetchLatestVersion, readPackageMeta } from '../npm-meta.js';
 import { print, printJson } from '../output.js';
@@ -18,10 +19,11 @@ register({
         const meta = readPackageMeta();
         const version = meta?.version ?? 'unknown';
         const endpoint = resolveEndpoint(loadConfig());
+        const env = envNameOf(endpoint) ?? endpoint;
         if (!flags.check) {
             if (flags.json) {
                 const installedGlobally = meta ? (await detectGlobalInstall(meta)).global : false;
-                printJson({ version, installedGlobally, endpoint });
+                printJson({ version, installedGlobally, env });
             }
             else {
                 print(`yos CLI ${version}`);
@@ -34,7 +36,7 @@ register({
         const latest = await fetchLatestVersion(meta.name);
         const outdated = compareVersions(meta.version, latest) < 0;
         if (flags.json) {
-            printJson({ version, latest, outdated, installedGlobally: (await detectGlobalInstall(meta)).global, endpoint });
+            printJson({ version, latest, outdated, installedGlobally: (await detectGlobalInstall(meta)).global, env });
             return;
         }
         print(outdated

package/dist/config.js

@@ -1,7 +1,7 @@
 import { existsSync, mkdirSync, readFileSync, writeFileSync } from 'node:fs';
 import { homedir } from 'node:os';
 import { join } from 'node:path';
-import { DEFAULT_ENDPOINT } from './endpoints.js';
+import { DEFAULT_ENDPOINT, DEFAULT_ENV, endpointOfEnv } from './endpoints.js';
 import { UsageError } from './errors.js';
 export function configDir() {
     return process.env.YOS_CONFIG_DIR ?? join(homedir(), '.config', 'yos');
@@ -35,12 +35,26 @@ export function resolveKey(config) {
     }
     throw new UsageError('未配置访问令牌', '请执行 `yos login` 或设置环境变量 YOS_API_KEY');
 }
-export function resolveEndpoint(config) {
-    const fromEnv = process.env.YOS_ENDPOINT;
-    if (fromEnv) {
-        return normalizeEndpoint(fromEnv);
+export function resolveEndpoint(config, flags) {
+    if (flags?.endpoint) {
+        return normalizeEndpoint(flags.endpoint);
+    }
+    if (flags?.env) {
+        return endpointOfEnv(flags.env);
+    }
+    if (process.env.YOS_ENDPOINT) {
+        return normalizeEndpoint(process.env.YOS_ENDPOINT);
+    }
+    if (process.env.YOS_ENV) {
+        return endpointOfEnv(process.env.YOS_ENV);
+    }
+    if (config?.endpoint) {
+        return normalizeEndpoint(config.endpoint);
+    }
+    if (config?.env) {
+        return endpointOfEnv(config.env);
     }
-    return normalizeEndpoint(config?.endpoint ?? DEFAULT_ENDPOINT);
+    return DEFAULT_ENDPOINT;
 }
 export function normalizeEndpoint(endpoint) {
     return endpoint.replace(/\/+$/, '');
@@ -49,7 +63,8 @@ export function maskKey(key) {
     return key.length <= 12 ? '****' : `${key.slice(0, 8)}****${key.slice(-4)}`;
 }
 export function updateConfig(patch) {
-    const merged = { endpoint: DEFAULT_ENDPOINT, ...loadConfig(), ...patch };
+    const existing = loadConfig();
+    const merged = existing ? { ...existing, ...patch } : { env: DEFAULT_ENV, ...patch };
     saveConfig(merged);
     return merged;
 }

package/dist/endpoints.js

@@ -1 +1,28 @@
-export const DEFAULT_ENDPOINT = 'https://yos-bff.linkduoo.com';
+import { UsageError } from './errors.js';
+export const ENVIRONMENTS = {
+    prod: { url: 'https://yos-bff.linkduoo.com', label: '生产' },
+    test: { url: 'https://yos-bff-test.linkduoo.com', label: '测试' },
+    dev: { url: 'http://localhost:8080', label: '开发' },
+};
+export const DEFAULT_ENV = 'prod';
+export const DEFAULT_ENDPOINT = ENVIRONMENTS[DEFAULT_ENV].url;
+export function endpointOfEnv(env) {
+    const found = ENVIRONMENTS[env];
+    if (!found) {
+        throw new UsageError(`无法识别的环境：${env}`, `可用环境：${Object.keys(ENVIRONMENTS).join(' / ')}`);
+    }
+    return found.url;
+}
+export function envNameOf(endpoint) {
+    const normalized = endpoint.replace(/\/+$/, '');
+    for (const [name, env] of Object.entries(ENVIRONMENTS)) {
+        if (env.url === normalized) {
+            return name;
+        }
+    }
+    return null;
+}
+export function envLabel(endpoint) {
+    const name = envNameOf(endpoint);
+    return name ? ENVIRONMENTS[name].label : endpoint;
+}

package/dist/openapis-client.js

@@ -1,5 +1,6 @@
 import { readFile, stat } from 'node:fs/promises';
 import { basename } from 'node:path';
+import { envLabel } from './endpoints.js';
 import { AuthError, BusinessError, NetworkError } from './errors.js';
 export const MAX_UPLOAD_SIZE_BYTES = 20 * 1024 * 1024;
 export function formatIdentity(identity) {
@@ -38,11 +39,14 @@ export class OpenApisClient {
             });
         }
         catch (e) {
-            throw new NetworkError(`无法连接 YOS 服务：endpoint=${this.base}，原因：${e.message}`);
+            throw new NetworkError(`无法连接 YOS 服务（${envLabelOfBase(this.base)}），原因：${e.message}`);
         }
         return parseEnvelope(response);
     }
 }
+function envLabelOfBase(base) {
+    return envLabel(base.replace(/\/open-apis$/, ''));
+}
 async function parseEnvelope(response) {
     if (response.status === 401) {
         let reason = '访问令牌无效或已过期';
@@ -57,7 +61,7 @@ async function parseEnvelope(response) {
         throw new AuthError(`鉴权失败：${reason}`);
     }
     if (response.status === 404) {
-        throw new NetworkError(`HTTP 404：服务端不存在该接口（${response.url}）`, '确认服务端已部署开放接口通道；端点配错时用 yos login --endpoint <url> --key <key> 重新指定');
+        throw new NetworkError(`HTTP 404：服务端不存在该接口（${response.url}）`, '确认服务端已部署开放接口通道；环境配置有误时用 yos login 重新指定');
     }
     let payload;
     try {
@@ -106,7 +110,7 @@ export async function uploadKnowledgeFile(endpoint, apiKey, filePath, kbCode, pa
         });
     }
     catch (e) {
-        throw new NetworkError(`无法连接 YOS 服务：endpoint=${endpoint}，原因：${e.message}`);
+        throw new NetworkError(`无法连接 YOS 服务（${envLabel(endpoint)}），原因：${e.message}`);
     }
     return parseEnvelope(response);
 }

package/dist/skills/yos/SKILL.md

@@ -10,7 +10,7 @@ YOS 是企业 AI 底座：公司知识、会议录音、帮助手册等能力都
 ## 0. 开工前先确认环境（30 秒）
 
 ```bash
-yos doctor      # 七项 ✓ 才继续：配置文件 / 服务端点 / 访问令牌 / 服务连通（回显身份）/ Skill 安装 / CLI 版本 / Skill 同步
+yos doctor      # 七项 ✓ 才继续：配置文件 / 服务环境 / 访问令牌 / 服务连通（回显身份）/ Skill 安装 / CLI 版本 / Skill 同步
 yos ping        # 只要探活，退出码即结论（0 通 / 3 网络 / 4 鉴权）
 ```
 
@@ -50,8 +50,8 @@ yos ping        # 只要探活，退出码即结论（0 通 / 3 网络 / 4 鉴
 
 1. 用户在 YOS 客户端「个人设置-访问令牌」页创建并复制令牌（40 位小写 hex）
 2. `yos login` 交互粘贴（不回显）；Agent 代执行时用 `yos login --key <令牌>`（注意令牌会进入 shell 历史，优先让用户自己在终端执行，或用 `YOS_API_KEY`）
-3. 配置文件 `~/.config/yos/config.json`（0600）。三个环境变量**优先于配置文件**：`YOS_CONFIG_DIR`（换配置目录）、`YOS_API_KEY`（换令牌）、`YOS_ENDPOINT`（换端点）
-4. 端点缺省生产环境 `https://yos-bff.linkduoo.com`，切换用 `yos login --endpoint <url>`（本地联调 `http://localhost:8080`）；临时切换可用 `YOS_ENDPOINT`，`yos doctor` 会显示当前生效端点及其来源
+3. 配置文件 `~/.config/yos/config.json`（0600）。环境变量**优先于配置文件**：`YOS_CONFIG_DIR`（换配置目录）、`YOS_API_KEY`（换令牌）、`YOS_ENV`（换服务环境，如 test）
+4. 服务环境缺省生产，切换用 `yos login --env test`（临时可用 `YOS_ENV=test`）；`yos doctor` 会显示当前生效环境及其来源。开发者本地调试用 `--env dev`（指向本机 8080 起的服务），其他自定义地址用 `--endpoint <url>` / `YOS_ENDPOINT`，一般无需使用
 5. 退出码 4 = 令牌无效/已吊销/已过期 → 引导重新 `yos login`，不要反复重试同一命令
 
 ## 4. 常用编排（已实测）

package/dist/skills/yos-install/SKILL.md

@@ -60,15 +60,15 @@ yos login --key '<40 位令牌>'
 3. 成功输出（原样回给用户即可，`key` 已是掩码）：
 
 ```
-已保存配置：endpoint=https://yos-bff.linkduoo.com，key=xxxxxxxx****xxxx，身份 张三（U00000001）
+已保存配置：环境=生产，key=xxxxxxxx****xxxx，身份 张三（U00000001）
 ```
 
 关键语义：
 
 - `login` 会**先调服务端校验身份再落盘**，校验失败不写配置 → 报网络或令牌错时无需清理"半成品"配置，改对参数重跑即可
-- 端点缺省为生产环境 `https://yos-bff.linkduoo.com`。切环境用 `yos login --endpoint <url>`（本地联调 `http://localhost:8080`）；`--endpoint` 不传时沿用配置文件里已有的值
+- 服务环境缺省为生产。切换环境用 `yos login --env test`（临时切换可先 `export YOS_ENV=test`）；地址由 CLI 内置映射，无需关心。不指定时沿用已保存的环境
 - 配置文件 `~/.config/yos/config.json`（目录 0700、文件 0600）
-- CI/容器可完全跳过 `login`：`export YOS_API_KEY=<令牌>`、`export YOS_ENDPOINT=<端点>`（两者都优先于配置文件）；`YOS_CONFIG_DIR` 可换配置目录（多环境隔离用）
+- CI/容器可完全跳过 `login`：`export YOS_API_KEY=<令牌>`、`export YOS_ENV=test` 指定服务环境（两者都优先于配置文件）；`YOS_CONFIG_DIR` 可换配置目录（多环境隔离用）
 
 ## 4. 安装内置 Skill 到 AI 工具
 
@@ -110,11 +110,11 @@ yos kb list --json    # 端到端实跑一条只读命令收尾
 
 ```
 ✓ 配置文件: 已找到
-✓ 服务端点: https://yos-bff.linkduoo.com（来自 内置缺省）
+✓ 服务环境: 生产（来自 内置缺省）
 ✓ 访问令牌: xxxxxxxx****xxxx
 ✓ 服务连通: 身份 张三（U00000001）
 ✓ Skill 安装: ~/.claude/skills
-✓ CLI 版本: 0.2.0（endpoint=https://yos-bff.linkduoo.com）
+✓ CLI 版本: 0.2.0（环境=生产）
 ✗ Skill 同步: 缺少版本状态（Skill 目录 1 个），执行 yos update 重同步
 ```
 
@@ -148,7 +148,7 @@ ls ~/.claude/skills | grep -E '^yos'                   # 先看要删哪些，
 | `npm error code E404` / `'@yosai/cli' is not in this registry` | 包名拼错、该版本尚未发布到 npmjs，或 npm 镜像未同步 | 核对包名 `@yosai/cli`；已发布仍 404 多为镜像未同步，加 `--registry=https://registry.npmjs.org` 重试；仍有问题联系维护者 |
 | `npm error code EACCES`（写全局目录失败） | npm 全局前缀指向了 root 目录 | 让用户同意后再改前缀：`npm config set prefix ~/.npm-global`，把 `~/.npm-global/bin` 加进 PATH，重开终端重装。**不要 sudo** |
 | `错误: 令牌格式不正确（应为 40 位小写 hex）` + `提示: 请在客户端「个人设置-访问令牌」页创建并复制完整令牌` | 令牌长度不对 / 大写 / 粘了空格或前缀 | 让用户重新整段复制（40 位、仅 `0-9a-f`）；不要让用户逐字补 |
-| `错误: 无法连接 YOS 服务：endpoint=http://.../open-apis，原因：fetch failed` | 端点不可达（环境填错、本地服务没起、网络受限） | `yos login --endpoint <正确地址>` 重配；本地联调时确认本地服务已在 8080 端口起来 |
+| `错误: 无法连接 YOS 服务（生产），原因：fetch failed` | 服务不可达（环境选错、网络受限、服务异常） | 先 `yos doctor` 看「服务环境」项确认环境与来源；环境选错用 `yos login --env <环境>` 重配；网络问题找运维确认 |
 | `未配置访问令牌` + `请执行 yos login 或设置环境变量 YOS_API_KEY` | 没配置也没 env | 回第 3 步 |
 | `错误: 未发现已安装的 Agent 技能目录` | 本机没有已知的 AI 工具 Skill 目录 | `yos skill install --target <该工具 skills 目录>`，见第 4 步 |
 | `yos --version` 无输出或报未知命令 | 装的是 0.2.0 之前的旧版本（旧版没有 version/update 命令） | 先 `npm install -g @yosai/cli@latest` 升到最新版（≥0.2.0），之后即可用 `yos version` / `yos update` |
@@ -159,4 +159,5 @@ ls ~/.claude/skills | grep -E '^yos'                   # 先看要删哪些，
 - 让用户从 `yos` skill（总入口）开始使用；命令细节看各领域 skill：`yos-kb`（知识库管理）、`yos-retrieval`（检索与引用）、`yos-transcript`（录音转写）、`yos-support`（帮助/版本/反馈）、`yos-shared`（共享约定）
 - 本机可用能力：28 个领域命令（kb 4 / docs 11 / retrieve 5 / support 6 / transcript 2）+ `yos tool` 兜底通道，覆盖知识库检索与管理、文档上传下载、会议转写查询、帮助手册、客户端版本与反馈；新建与删除知识库不在 CLI 内，需到 YOS 客户端手动操作
 - 边界（别过度承诺）：不能实时控制转写、不能申请/变更权限、反馈不带附件、只能看到当前令牌归属用户可见的数据
-- 排查建议：任何失败先跑 `yos doctor`；退出码 `4` 一律重新登录，`3` 先查端点与网络
+- 排查建议：任何失败先跑 `yos doctor`；退出码 `4` 一律重新登录，`3` 先看「服务环境」项与网络
+

package/dist/skills/yos-shared/SKILL.md

@@ -17,11 +17,11 @@ yos doctor      # 七项全 ✓ 才能继续；任一项 ✗ 按下方「未登
 
 ```
 ✓ 配置文件: 已找到
-✓ 服务端点: https://yos-bff.linkduoo.com（来自 内置缺省）
+✓ 服务环境: 生产（来自 内置缺省）
 ✓ 访问令牌: xxxxxxxx****xxxx
 ✓ 服务连通: 身份 张三（U00000001）
 ✓ Skill 安装: ~/.claude/skills, ~/.qoder-cn/skills
-✓ CLI 版本: 0.2.0（endpoint=https://yos-bff.linkduoo.com）
+✓ CLI 版本: 0.2.0（环境=生产）
 ✓ Skill 同步: 与 CLI 一致（2 个目录）
 ```
 
@@ -30,14 +30,14 @@ yos doctor      # 七项全 ✓ 才能继续；任一项 ✗ 按下方「未登
 | `command not found: yos` | CLI 未安装或全局 bin 不在 PATH，按 `yos-install` skill 引导安装（`npm install -g @yosai/cli` → `yos login` → 验证），不要继续猜命令 |
 | `✗ 配置文件: 未找到，请执行 yos login` | 执行 `yos login --key <令牌>`（令牌由用户在 YOS 客户端「个人设置-访问令牌」页创建并复制，40 位小写 hex） |
 | `✗ 访问令牌: 未配置访问令牌` | 同上；CI/容器可改为设置环境变量 `YOS_API_KEY` |
-| `✗ 服务连通: ...` | 看错误类型：网络不可达（退出码 3）→ 检查端点与网络；鉴权失败（4）→ 令牌失效，重新 `yos login` |
+| `✗ 服务连通: ...` | 看错误类型：网络不可达（退出码 3）→ 检查服务环境与网络；鉴权失败（4）→ 令牌失效，重新 `yos login` |
 | `✗ Skill 安装: 尚未安装，执行 yos skill install` | 执行 `yos skill install`，未探测到目录时 `--target ~/.claude/skills` |
 
 配置细节（排障时才需要）：
 
-- 配置文件 `~/.config/yos/config.json`（目录 0700、文件 0600），字段 `{endpoint, apiKey, installedSkillDirs}`
-- 环境变量优先级：`YOS_API_KEY` > 配置文件 `apiKey`；`YOS_ENDPOINT` > 配置文件 `endpoint`；`YOS_CONFIG_DIR` 覆盖配置目录（测试隔离用）
-- 端点缺省 `https://yos-bff.linkduoo.com`，切换用 `yos login --endpoint <url>`（本地联调 `http://localhost:8080`）；实际请求基址为 `<endpoint>/open-apis`
+- 配置文件 `~/.config/yos/config.json`（目录 0700、文件 0600），字段 `{env, apiKey, installedSkillDirs}`；本地联调等自定义地址场景存 `endpoint` 字段替代 `env`
+- 环境变量优先级：`YOS_API_KEY` > 配置文件 `apiKey`；`YOS_ENV` > 配置文件 `env`；`YOS_CONFIG_DIR` 覆盖配置目录（测试隔离用）
+- 服务环境缺省生产，切换用 `yos login --env test`（临时用 `YOS_ENV=test`）；开发者本地调试用 `--env dev`（指向本机 8080 起的服务）；其他自定义地址用 `--endpoint <url>` / `YOS_ENDPOINT`，一般无需使用；`yos doctor` 的「服务环境」项显示当前环境与来源
 - 令牌格式先本地校验：`yos login` 粘贴了非 40 位小写 hex 会直接报 `错误: 令牌格式不正确（应为 40 位小写 hex）`，不会落盘
 
 **安全**：绝不把令牌写进命令历史可见的日志、代码仓库或对用户的回复里；`--key` 传令牌仅用于无交互场景，回复中一律用掩码形式（`xxxxxxxx****xxxx`）。
@@ -86,7 +86,7 @@ CLI 对两套编码原样透出不做映射。遇到 cortex 侧编码时：可
 | 0 | 成功 | — | 继续 |
 | 1 | 业务失败（服务端拒绝/资源不存在） | `工具执行失败：知识库不存在：KB不存在`<br>`节点类型不符：ND... 实际是文档，本操作要求文件夹` | 按文案修参数，不要盲目重试 |
 | 2 | 参数/用法错误（CLI 本地拦截，未发请求） | `错误: 缺少 --kind`<br>`提示: 用法: yos retrieve neighbors <target> --kind <值> ...` | 照 `提示:` 里的用法改写 |
-| 3 | 网络错误/服务不可达 | `错误: fetch failed`（或超时文案） | 确认端点与网络连通，`yos ping` 复测 |
+| 3 | 网络错误/服务不可达 | `错误: 无法连接 YOS 服务（生产），原因：fetch failed` | 确认服务环境与网络连通，`yos ping` 复测 |
 | 4 | 鉴权失败 | `错误: 鉴权失败...`<br>`提示: 请执行 \`yos login\` 重新配置访问令牌` | 令牌无效/吊销/过期 → 让用户重新创建后 `yos login` |
 
 `1` 与 `2` 的关键差别：**2 根本没发请求**，改法一定写在 `提示:` 里；**1 是服务端结论**，文案里带具体编码，直接引用给用户。

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@yosai/cli",
-  "version": "0.2.1-test.0",
+  "version": "0.2.1-test.2",
   "description": "YOS 能力的 Agent 执行入口：工具调用、知识库管理与文件上传",
   "type": "module",
   "bin": {