tyc-cli 0.3.5 → 0.3.7

package/README.md

@@ -11,9 +11,9 @@
 
 ## 📖 项目简介
 
-`tyc-cli` 是天眼查 MCP Server 的官方命令行客户端。通过 MCP 协议（JSON-RPC 2.0 over
-Streamable HTTP）调用天眼查 162 个业务语义聚合工具，覆盖企业工商、知产、司法风险、
-董监高等全维度商业数据。
+`tyc-cli` 是天眼查 MCP Server 的官方命令行客户端。CLI 通过 shared core HTTP 入口
+调用天眼查 162 个业务语义聚合工具，覆盖企业工商、知产、司法风险、董监高等全维度
+商业数据。
 
 当前 MCP Server 的 `tools/list` 默认只公开少量 AI Agent 入口工具
 （搜索、公司画像、能力目录、`call_tool` / `call_tools_batch` 等），但 162 个业务语义
@@ -22,11 +22,11 @@ Streamable HTTP）调用天眼查 162 个业务语义聚合工具，覆盖企业
 
 **核心特点**：
 
-- 🧠 **MCP 客户端架构**：CLI 只做协议转换与参数透传；多源合并、时间戳格式化、
+- 🧠 **Shared Core 客户端架构**：CLI 只做命令解析与参数透传；多源合并、时间戳格式化、
   空结果归一化、`_summary` 注入等业务逻辑由 MCP Server 完成
 - 🔌 **公网优先**：默认连接天眼查 MCP 端点 `https://mcp.tianyancha.com/mcp`；
   支持 `--url` 指向本地或私有部署
-- 🔄 **Session 复用**：`Mcp-Session-Id` 本地缓存 24 小时，后续调用零 initialize 开销
+- 🔄 **无本地 MCP Session**：CLI 调用 stateless shared core endpoint，不缓存 `Mcp-Session-Id`
 - 🎯 **6 大业务分类 / 162 个工具**：企业基础信息 · 风险合规 · 知识产权 · 经营与公示 · 历史信息 · 董监高
 - 🤖 **AI Agent 友好**：tyc 英文 key 透传 / 时间戳格式化 / `_summary / _empty / _warnings` 元数据
 
@@ -61,6 +61,10 @@ tyc login
 tyc login --url "https://ai-mcp-pre.tianyancha.com/mcp"
 tyc login --url "http://localhost:8080/mcp" --issuer "http://localhost:8080/oauth"
 
+# 非阻塞 OAuth：只打印授权 URL，不占住命令行；授权后手动传回 callback code
+tyc login --no-open --no-block
+tyc login --callback-token "<callback_code_or_full_callback_url>"
+
 # API key 兼容路径：已有天眼查 OpenAPI token 时可直接写入
 tyc init --authorization "YOUR_API_TOKEN"
 
@@ -70,9 +74,14 @@ tyc init --authorization "YOUR_API_TOKEN" --no-verify
 
 > `tyc login` 会从 MCP protected-resource metadata 发现 OAuth 授权服务器，启动本地
 > loopback 回调，使用 PKCE 授权码流程打开浏览器登录；成功后自动把
-> `Authorization: Bearer <access_token>` 写入 `~/.tyc/config.json`。
-> `tyc init` 保存配置后会立即向 MCP 发一次 `initialize`：成功则打印 `已建立 MCP session`，
-> 失败则退出码 1 并提示连通性问题。加 `--no-verify` 可跳过校验。
+> `Authorization: Bearer <access_token>` 和 refresh token 上下文写入
+> `~/.tyc/config.json`。后续业务命令会在 access token 临期时自动刷新；
+> 如果服务端返回 401，会强制刷新一次并重试当前请求。
+> `tyc login --no-open --no-block` 会打印授权 URL 后立即退出，并把一次性 PKCE 上下文
+> 保存到 `~/.tyc/oauth_pending.json`；完成浏览器授权后，页面会跳转到天眼查 CLI
+> 回调页并展示可复制命令，执行 `tyc login --callback-token "<...>"` 完成换 token。
+> `tyc init` 保存配置后会立即校验 shared core endpoint；失败则退出码 1 并提示连通性问题。
+> 加 `--no-verify` 可跳过校验。
 
 配置存于 `~/.tyc/config.json`（权限 600）：
 
@@ -81,13 +90,24 @@ tyc init --authorization "YOUR_API_TOKEN" --no-verify
   "url": "https://mcp.tianyancha.com/mcp",
   "headers": {
     "Authorization": "Bearer <OAuth_ACCESS_TOKEN>"
+  },
+  "oauth": {
+    "tokenEndpoint": "https://ai.tianyancha.com/oauth/token",
+    "clientId": "<OAUTH_CLIENT_ID>",
+    "refreshToken": "<OAUTH_REFRESH_TOKEN>",
+    "resource": "https://mcp.tianyancha.com/mcp",
+    "accessTokenExpiresAt": 1760000000000
   }
 }
 ```
 
+`tyc init --authorization <token>` 会切回 API key 兼容路径，并清除 `oauth` 刷新上下文。
+
 ### 4. 开始查询
 
 ```bash
+tyc company companies "北京百度网讯科技有限公司" --head 40
+tyc company capabilities 2319755677 --company-name "北京百度网讯科技有限公司"
 tyc company registration-info "北京百度网讯科技有限公司"
 tyc risk dishonest-info "..." --md
 tyc executive personnel-dishonest "..." --humanName "张三"
@@ -101,13 +121,14 @@ tyc executive personnel-dishonest "..." --humanName "张三"
 
 | 命令 | 说明 |
 |------|------|
-| `tyc login` | 浏览器 OAuth 登录；自动发现 metadata、使用 PKCE 获取 access token 并写入配置 |
+| `tyc login` | 浏览器 OAuth 登录；自动发现 metadata、使用 PKCE 获取 access token / refresh token 并写入配置 |
+| `tyc login --no-open --no-block` | 打印 OAuth 授权 URL 并立即退出，授权完成后按天眼查 CLI 回调页提示继续 |
+| `tyc login --callback-token <code-or-url>` | 使用上一步保存的 PKCE 上下文，把回调 code 换成 access token |
 | `tyc login --url <url>` | 对指定 MCP endpoint 发起 OAuth 登录 |
-| `tyc init --authorization <token>` | 写入 `headers.Authorization`；保存后会立即向 MCP 发一次 `initialize` 校验连通性 |
+| `tyc init --authorization <token>` | 写入 `headers.Authorization`；保存后会立即校验 shared core 连通性 |
 | `tyc init --url <url>` | 设置 MCP endpoint |
 | `tyc init --header K=V` | 注入自定义 header（可重复）；值留空则删除该 key |
 | `tyc init --no-verify` | 仅写配置，跳过连通性校验（离线配置场景） |
-| `tyc init --clear-session` | 清除本地 session 缓存 |
 | `tyc --help` | 显示 6 个分类总览 |
 | `tyc <category> --help` | 显示某分类下全部命令 |
 | `tyc <category> <method> --help` | 显示具体命令的入参说明 |
@@ -122,7 +143,7 @@ tyc executive personnel-dishonest "..." --humanName "张三"
 | `--pretty` | 同默认；保留 flag 以保持向后兼容 / 显式声明意图 |
 | `--compact` | 紧凑单行 JSON（旧默认行为；管道 / `jq` 场景） |
 | `--md` | Markdown 表格化输出（人类阅读 / Agent 上屏） |
-| `--verbose` | 打印 MCP 请求详情到 stderr（与上述输出格式正交） |
+| `--verbose` | 打印 shared core 请求详情到 stderr（与上述输出格式正交） |
 
 #### 输出截断 / 落盘（与上述输出格式正交，可叠加任意子命令）
 
@@ -181,6 +202,8 @@ tyc company registration-info "百度" --compact | jq .name
 ### 企业基础信息（company，49）
 
 ```bash
+tyc company companies "北京百度网讯科技有限公司"            # 先锚定主体，复制返回 items[*].id
+tyc company capabilities 2319755677 --company-name "北京百度网讯科技有限公司"  # 获取可调用 tool_name 白名单
 tyc company registration-info "北京百度网讯科技有限公司"   # 工商登记
 tyc company actual-controller "..."                       # 实际控制人
 tyc company beneficial-owners "..."                       # UBO
@@ -254,22 +277,21 @@ tyc executive person-risk-overview "..." --humanName "张三"
 
 ```
 ┌─────────────┐         ┌─────────────────────────────┐         ┌─────────────────┐
-│   tyc-cli   │ ──JSON──▶│  天眼查 MCP Server           │ ──HTTP──▶│ tyc OpenAPI     │
-│ (npm / TS)  │ ◀───RPC──│  (mcp.tianyancha.com/mcp) │ ◀───────│                 │
+│   tyc-cli   │ ──HTTP──▶│  天眼查 MCP Server           │ ──HTTP──▶│ tyc OpenAPI     │
+│ (npm / TS)  │ ◀──JSON──│  (/v1/core/tools/call)       │ ◀───────│                 │
 └─────────────┘         └─────────────────────────────┘         └─────────────────┘
        │                              │
        │                              └─ 多源并发聚合 · 时间戳格式化 · _summary 注入 · 空结果归一化
        │
-       └─ 仅命令树 · 参数透传 · Session 管理 · pretty/--md/--compact 呈现 · --head/--tail/--full/--threshold/--output-file 截断与落盘
+       └─ 仅命令树 · 参数透传 · pretty/--md/--compact 呈现 · --head/--tail/--full/--threshold/--output-file 截断与落盘
 ```
 
 **CLI 的职责**：
 
 1. 解析命令行（commander）
-2. 组装 `tools/call` JSON-RPC 请求，透传 `Authorization` header
-3. Session 管理（`initialize` + 24h 缓存 + 失效重建）
-4. 解析 MCP Streamable HTTP 响应（当前服务端返回单包 JSON）
-5. 格式化输出（默认 pretty / `--compact` / `--md`），并可叠加 `--head/--tail/--full/--threshold/--output-file` 做截断与落盘
+2. 组装 shared core `/v1/core/tools/call` 请求，透传 `Authorization` header
+3. 解析 shared core 响应并包装成统一输出结构
+4. 格式化输出（默认 pretty / `--compact` / `--md`），并可叠加 `--head/--tail/--full/--threshold/--output-file` 做截断与落盘
 
 **CLI 不做**：
 
@@ -292,10 +314,9 @@ tyc-cli/
 │
 └── src/
     ├── index.ts              # CLI 入口（commander 注册）
-    ├── types.ts              # Catalog / Session / MCP 类型
+    ├── types.ts              # Catalog / tool result 类型
     ├── config.ts             # ~/.tyc/config.json 读写 · 环境变量兜底
-    ├── session.ts            # ~/.tyc/session.json 读写 · 24h TTL
-    ├── mcpClient.ts          # MCP JSON-RPC client · SSE 解析 · 失效重建
+    ├── coreClient.ts         # Shared Core HTTP client · ready/auth 校验 · tools/call
     ├── oauth.ts              # OAuth metadata discovery · PKCE · loopback callback
     ├── registry.ts           # 读取打包内 catalog.json（命令树元数据）
     ├── catalog.json          # 命令元数据：name / group / cliMethod / params
@@ -310,26 +331,11 @@ tyc-cli/
 
 ---
 
-## ⚙️ Session 管理
-
-| 场景 | 行为 |
-|------|------|
-| 首次调用 | `initialize` → 读 `Mcp-Session-Id` header → 存 `~/.tyc/session.json` |
-| 24h 内复用 | 直接用缓存 `sessionId`，跳过 `initialize` |
-| 缓存过期（>24h） | 自动 re-initialize，用户无感 |
-| 服务端主动失效（404/410/"session not found"） | 删缓存 → 重建 → 重试 1 次 |
-| `tyc init` 变更 url / Authorization | 配置写入后自动清掉旧 session |
-
-`~/.tyc/session.json` 示例：
+## ⚙️ Shared Core 调用
 
-```json
-{
-  "url": "https://mcp.tianyancha.com/mcp",
-  "sessionId": "mcp-session-xxx",
-  "initializedAt": 1777272039739,
-  "protocolVersion": "2024-11-05"
-}
-```
+CLI 不直接维护 MCP session，也不会写 `~/.tyc/session.json`。所有业务命令统一调用
+`/v1/core/tools/call`；`tyc init` 用 `/v1/core/ready` 做连通性校验，`tyc login`
+用 `/v1/core/auth/ready` 做鉴权校验。
 
 ---
 
@@ -355,7 +361,7 @@ tyc-cli/
 
 | 维度 | `tyc-cli` | 天眼查 MCP Server |
 |-----|---------|-------------------|
-| 协议 | MCP client（JSON-RPC over Streamable HTTP） | MCP server |
+| 协议 | Shared Core HTTP client | MCP server |
 | 实现 | TypeScript | Go |
 | 职责 | 命令树 · 参数透传 · 格式化输出 | 多源聚合 · 时间戳格式化 · 元数据注入 · Authorization 透传至 OpenAPI |
 | 运维 | 用户本地安装 | 默认连接官方托管 `mcp.tianyancha.com`，也可切到本机 apimcp 或用户自建 |

package/dist/commands/capabilities.js

@@ -0,0 +1,32 @@
+import { callCoreToolWithOAuthRefresh } from "./coreCall.js";
+import { emitToolResult } from "./output.js";
+const TOOL_NAME = "get_company_capabilities";
+export function registerCompanyCapabilitiesCommand(companyCmd, program) {
+    companyCmd
+        .command("capabilities")
+        .description("[DISCOVER] 输入 search_companies 候选表 company_id，返回该企业可直接执行的 tyc CLI 工具清单")
+        .argument("<company_id>", "search_companies 候选表 items[*].id 中的数字企业 ID")
+        .option("--company-name <value>", "企业名称（可选，仅用于展示和后续主体参数示例）")
+        .action(async (companyID, options) => {
+        const args = {
+            company_id: companyID,
+        };
+        if (options.companyName !== undefined) {
+            args.company_name = options.companyName;
+        }
+        const opts = program.opts();
+        const verbose = !!opts.verbose;
+        try {
+            const result = await callCoreToolWithOAuthRefresh(TOOL_NAME, args, {
+                verbose,
+                format: "markdown",
+            });
+            emitToolResult(result, opts, TOOL_NAME);
+        }
+        catch (err) {
+            const msg = err instanceof Error ? err.message : String(err);
+            console.error(`请求失败: ${msg}`);
+            process.exit(1);
+        }
+    });
+}

package/dist/commands/category.js

@@ -1,9 +1,10 @@
 import { getCategories, getToolsByGroup } from "../registry.js";
-import { resolveConfig } from "../config.js";
-import { callCoreTool } from "../coreClient.js";
-import { callTool } from "../mcpClient.js";
-import { jsonToMarkdown } from "../utils/jsonToMarkdown.js";
-import { applyTruncation, resolveOptionalInt, TRUNCATE_DEFAULTS, } from "../utils/truncate.js";
+import { registerCompanyCapabilitiesCommand } from "./capabilities.js";
+import { callCoreToolWithOAuthRefresh } from "./coreCall.js";
+import { emitToolResult } from "./output.js";
+const GLOBAL_OUTPUT_HELP = `
+全局输出选项：所有工具命令均支持 --md / --compact / --pretty / --head / --tail / --full / --threshold / --output-file / --verbose；完整说明见 tyc --help。
+`;
 export function registerCategoryCommands(program) {
     for (const cat of getCategories()) {
         const tools = getToolsByGroup(cat.group);
@@ -11,6 +12,9 @@ export function registerCategoryCommands(program) {
         const catCmd = program
             .command(cat.group)
             .description(`${cat.name_zh}（${cat.tool_count} 个 · L0=${layerCounts.L0} L1=${layerCounts.L1} L2=${layerCounts.L2} L3=${layerCounts.L3}）`);
+        if (cat.group === "company") {
+            registerCompanyCapabilitiesCommand(catCmd, program);
+        }
         for (const tool of tools) {
             bindMethod(catCmd, tool, program);
         }
@@ -37,11 +41,12 @@ function bindMethod(catCmd, tool, program) {
         methodCmd = methodCmd.argument(`<${positional.name}>`, positional.description);
     }
     for (const p of remainingRequired) {
-        methodCmd = methodCmd.requiredOption(`--${p.name} <value>`, p.description);
+        methodCmd = methodCmd.requiredOption(`--${p.name} <value>`, `必填；${p.description}`);
     }
     for (const p of optionalParams) {
         methodCmd = methodCmd.option(`--${p.name} <value>`, p.description);
     }
+    methodCmd.addHelpText("after", GLOBAL_OUTPUT_HELP);
     methodCmd.action(async (posVal, options) => {
         const args = {};
         if (positional && posVal)
@@ -50,14 +55,11 @@ function bindMethod(catCmd, tool, program) {
             if (options[p.name] !== undefined)
                 args[p.name] = options[p.name];
         }
-        const cfg = resolveConfig();
         const opts = program.opts();
         const verbose = !!opts.verbose;
         try {
-            const result = cfg.transport === "mcp"
-                ? await callTool(cfg, tool.name, args, { verbose })
-                : await callCoreTool(cfg, tool.name, args, { verbose });
-            emit(result, opts, tool.name);
+            const result = await callToolWithOAuthRefresh(tool.name, args, verbose);
+            emitToolResult(result, opts, tool.name);
         }
         catch (err) {
             const msg = err instanceof Error ? err.message : String(err);
@@ -66,68 +68,6 @@ function bindMethod(catCmd, tool, program) {
         }
     });
 }
-function emit(result, opts, toolName) {
-    // MCP 业务错误：isError + content[0].text = 错误描述
-    if (result.isError) {
-        const errText = extractText(result) || "未知业务错误";
-        console.error(errText);
-        process.exit(1);
-    }
-    const text = extractText(result);
-    if (text === null) {
-        console.error("tools/call 返回无可解析内容");
-        process.exit(1);
-    }
-    // MCP Server 返回的是 JSON 字符串（已完成多源合并 / 时间戳格式化 /
-    // _summary / _empty / _warnings 注入）。CLI 只做呈现格式化。
-    let payload;
-    try {
-        payload = JSON.parse(text);
-    }
-    catch {
-        // 非 JSON 文本：直接原样输出（仍走截断 / 落盘）
-        emitWithTruncation(text.endsWith("\n") ? text.slice(0, -1) : text, opts);
-        return;
-    }
-    // 输出模式选择（互斥优先级 --md > --compact > --pretty / 默认 = pretty）
-    let rendered;
-    if (opts.md) {
-        rendered = jsonToMarkdown(payload, toolName);
-    }
-    else if (opts.compact) {
-        rendered = JSON.stringify(payload);
-    }
-    else {
-        // 默认 = pretty（含 --pretty 显式情况）
-        rendered = JSON.stringify(payload, null, 2);
-    }
-    emitWithTruncation(rendered, opts);
-}
-function emitWithTruncation(rendered, opts) {
-    // 解析 head / tail / threshold：commander 对 `[n]` 在未传值时给 true
-    const head = resolveOptionalInt(opts.head, TRUNCATE_DEFAULTS.HEAD);
-    const tail = resolveOptionalInt(opts.tail, TRUNCATE_DEFAULTS.TAIL);
-    const threshold = resolveOptionalInt(opts.threshold, TRUNCATE_DEFAULTS.THRESHOLD);
-    const outputFile = typeof opts.outputFile === "string" && opts.outputFile.length > 0
-        ? opts.outputFile
-        : undefined;
-    const r = applyTruncation(rendered, {
-        full: !!opts.full,
-        head,
-        tail,
-        threshold,
-        outputFile,
-    });
-    console.log(r.rendered);
-    for (const n of r.notices) {
-        process.stderr.write(n + "\n");
-    }
-}
-function extractText(result) {
-    const content = result.content || [];
-    for (const c of content) {
-        if (typeof c.text === "string" && c.text.length > 0)
-            return c.text;
-    }
-    return null;
+async function callToolWithOAuthRefresh(name, args, verbose) {
+    return callCoreToolWithOAuthRefresh(name, args, { verbose });
 }

package/dist/commands/coreCall.js

@@ -0,0 +1,23 @@
+import { refreshResolvedConfigOAuth, resolveConfigWithFreshOAuth, } from "../config.js";
+import { callCoreTool } from "../coreClient.js";
+function isUnauthorizedError(err) {
+    const msg = err instanceof Error ? err.message : String(err);
+    return /\bHTTP 401\b/i.test(msg) || /invalid_token|expired_token|token expired/i.test(msg);
+}
+export async function callCoreToolWithOAuthRefresh(name, args, opts) {
+    let refreshResult = await resolveConfigWithFreshOAuth({ verbose: !!opts?.verbose });
+    try {
+        return await callCoreTool(refreshResult.config, name, args, opts);
+    }
+    catch (err) {
+        if (!isUnauthorizedError(err))
+            throw err;
+        refreshResult = await refreshResolvedConfigOAuth(refreshResult.config, {
+            force: true,
+            verbose: !!opts?.verbose,
+        });
+        if (!refreshResult.refreshed)
+            throw err;
+        return callCoreTool(refreshResult.config, name, args, opts);
+    }
+}

package/dist/commands/init.js

@@ -1,45 +1,36 @@
 import { DEFAULT_MCP_URL, defaultCoreURL, loadConfig, resolveConfig, saveConfig, } from "../config.js";
 import { verifyCoreEndpoint } from "../coreClient.js";
-import { clearSession } from "../session.js";
-import { ensureSession } from "../mcpClient.js";
-function parseTransport(raw) {
-    if (!raw)
-        return undefined;
-    const v = raw.trim().toLowerCase();
-    if (v === "core" || v === "mcp")
-        return v;
-    throw new Error(`invalid --transport: ${raw} (expected core or mcp)`);
-}
 export function registerInitCommand(program) {
     program
         .command("init")
-        .description("配置 MCP endpoint / Authorization（保存到 ~/.tyc/config.json，并校验连通性）")
+        .description("配置 endpoint / Authorization（保存到 ~/.tyc/config.json，并校验 shared core 连通性）")
         .option("--authorization <token>", "tyc OpenAPI Authorization（写入 headers.Authorization）")
         .option("--url <url>", `MCP endpoint（默认 ${DEFAULT_MCP_URL}）`)
         .option("--core-url <url>", "Shared Core HTTP endpoint（默认从 --url 推导 /v1/core/tools/call）")
-        .option("--transport <core|mcp>", "默认调用通道（默认 core；mcp 保留旧 session 链路）")
         .option("--header <kv...>", "自定义 header，格式 K=V，可重复；留空清除该 key")
-        .option("--clear-session", "仅清除本地 MCP session 缓存（~/.tyc/session.json）")
-        .option("--no-verify", "跳过连通性校验（不发 initialize）")
+        .option("--no-verify", "跳过 shared core 连通性校验")
         .action(async (opts) => {
         const cfg = loadConfig() || {};
         if (!cfg.headers)
             cfg.headers = {};
-        if (opts.url)
+        let resetOAuth = false;
+        if (opts.url) {
             cfg.url = opts.url;
+            resetOAuth = true;
+        }
         if (!cfg.url)
             cfg.url = DEFAULT_MCP_URL;
-        const transport = parseTransport(opts.transport);
-        if (transport)
-            cfg.transport = transport;
-        if (!cfg.transport)
-            cfg.transport = "core";
-        if (opts.coreUrl)
+        delete cfg.transport;
+        if (opts.coreUrl) {
             cfg.coreUrl = opts.coreUrl;
-        if (!cfg.coreUrl)
+        }
+        else if (opts.url || !cfg.coreUrl) {
             cfg.coreUrl = defaultCoreURL(cfg.url);
-        if (opts.authorization)
+        }
+        if (opts.authorization) {
             cfg.headers.Authorization = opts.authorization;
+            resetOAuth = true;
+        }
         if (opts.header && opts.header.length > 0) {
             for (const kv of opts.header) {
                 const idx = kv.indexOf("=");
@@ -51,34 +42,26 @@ export function registerInitCommand(program) {
                 const v = kv.slice(idx + 1);
                 if (!k)
                     continue;
+                if (k.toLowerCase() === "authorization")
+                    resetOAuth = true;
                 if (v === "")
                     delete cfg.headers[k];
                 else
                     cfg.headers[k] = v;
             }
         }
+        if (resetOAuth)
+            delete cfg.oauth;
         saveConfig(cfg);
-        // 任何配置变更都清掉 session 缓存，避免 endpoint/鉴权切换后复用旧 sessionId
-        clearSession();
-        if (opts.clearSession) {
-            console.log("已清除 ~/.tyc/session.json");
-        }
-        console.log(`已保存 ~/.tyc/config.json  (transport=${cfg.transport}, url=${cfg.url}, coreUrl=${cfg.coreUrl})`);
+        console.log(`已保存 ~/.tyc/config.json  (url=${cfg.url}, coreUrl=${cfg.coreUrl})`);
         if (opts.verify === false) {
             return;
         }
-        // core 模式只探活 stateless endpoint；mcp 模式才 initialize 并缓存 session。
         try {
             const resolved = resolveConfig();
             const verbose = !!program.opts().verbose;
-            if (resolved.transport === "mcp") {
-                const sess = await ensureSession(resolved, { verbose });
-                console.log(`已建立 MCP session（sessionId=${sess.sessionId.slice(0, 16)}…）`);
-            }
-            else {
-                await verifyCoreEndpoint(resolved, verbose);
-                console.log("Shared Core endpoint 校验通过");
-            }
+            await verifyCoreEndpoint(resolved, verbose);
+            console.log("Shared Core endpoint 校验通过");
         }
         catch (err) {
             const msg = err instanceof Error ? err.message : String(err);

package/dist/commands/layers.js

@@ -82,7 +82,7 @@ function registerLayerCmd(program, spec) {
     const layer = spec.layer;
     const cmd = program
         .command(layer)
-        .description(`${spec.title}（${getLayerCount(layer)} 个）— ${spec.summary}`);
+        .description(layerCommandDescription(spec));
     cmd
         .command("list")
         .description(`列出 ${layer} 全部 ${getLayerCount(layer)} 个工具（默认按分类分组文本表格）`)
@@ -120,6 +120,18 @@ function registerLayerCmd(program, spec) {
         console.log(renderLayerListText(spec, tools));
     });
 }
+function layerCommandDescription(spec) {
+    switch (spec.layer) {
+        case "L0":
+            return `实体锚定层（${getLayerCount("L0")} 个）— 把简称、曾用名或模糊指代解析成精确企业。`;
+        case "L1":
+            return `概要总览层（${getLayerCount("L1")} 个）— 每个业务面 1 个总览工具，用 _summary 指引下一跳。`;
+        case "L2":
+            return `维度下钻层（${getLayerCount("L2")} 个）— 股权、诉讼、招投标、年报、知识产权等明细维度。`;
+        case "L3":
+            return `专项工具层（${getLayerCount("L3")} 个）— id 详情、search_*、垂直场景和专业查询。`;
+    }
+}
 // ─────────────────────────── 渲染：tyc layers ───────────────────────────
 function renderLayersText() {
     const total = getTotalCount();