tyc-cli 0.2.0 → 0.2.2

package/CHANGELOG.md

@@ -30,7 +30,7 @@
 - `tyc <group> <method>` 命令形态与 0.1.0 完全一致
 - `--pretty / --md / --verbose` 三种输出模式
 - tyc 英文 key 透传（由 MCP Server 保证）
-- 6 分类 / 167 工具全量覆盖
+- 6 分类 / 163 工具全量覆盖
 
 ## [0.1.0] - 2026-04-25
 

package/README.md

@@ -12,7 +12,7 @@
 ## 📖 项目简介
 
 `tyc-cli` 是天眼查 MCP Server 的官方命令行客户端。通过 MCP 协议（JSON-RPC 2.0 over
-Streamable HTTP）调用天眼查 167 个业务语义聚合工具，覆盖企业工商、知产、司法风险、
+Streamable HTTP）调用天眼查 163 个业务语义聚合工具，覆盖企业工商、知产、司法风险、
 董监高等全维度商业数据。
 
 **核心特点**：
@@ -22,7 +22,7 @@ Streamable HTTP）调用天眼查 167 个业务语义聚合工具，覆盖企业
 - 🔌 **即插即用**：默认连接官方 MCP 端点 `https://ai-mcp.tianyancha.com/mcp`；
   支持 `--url` 指向私有部署
 - 🔄 **Session 复用**：`Mcp-Session-Id` 本地缓存 24 小时，后续调用零 initialize 开销
-- 🎯 **6 大业务分类 / 167 个工具**：企业基础信息 · 风险合规 · 知识产权 · 经营与公示 · 历史信息 · 董监高
+- 🎯 **6 大业务分类 / 163 个工具**：企业基础信息 · 风险合规 · 知识产权 · 经营与公示 · 历史信息 · 董监高
 - 🤖 **AI Agent 友好**：tyc 英文 key 透传 / 时间戳格式化 / `_summary / _empty / _warnings` 元数据
 
 ---
@@ -119,7 +119,7 @@ tyc executive personnel-dishonest "..." --humanName "张三"
 
 ## 📚 查询指令手册
 
-### 企业基础信息（company，52）
+### 企业基础信息（company，50）
 
 ```bash
 tyc company registration-info "北京百度网讯科技有限公司"   # 工商登记
@@ -298,7 +298,7 @@ tyc-cli/
 | 职责 | 命令树 · 参数透传 · 格式化输出 | 多源聚合 · 时间戳格式化 · 元数据注入 · Authorization 透传至 OpenAPI |
 | 运维 | 用户本地安装 | 官方托管 `ai-mcp.tianyancha.com`，或用户自建 |
 
-CLI 和 MCP Server 共享同一 167 工具清单；工具元数据从打包内的 `catalog.json`
+CLI 和 MCP Server 共享同一 163 工具清单；工具元数据从打包内的 `catalog.json`
 读取，保证命令树冷启动零网络开销。
 
 ---

package/dist/catalog.json

@@ -5,12 +5,12 @@
     {
       "group": "company",
       "name_zh": "企业基础信息",
-      "tool_count": 52
+      "tool_count": 49
     },
     {
       "group": "risk",
       "name_zh": "风险合规",
-      "tool_count": 36
+      "tool_count": 35
     },
     {
       "group": "intellectual_property",
@@ -40,15 +40,15 @@
     },
     {
       "layer": "L1",
-      "count": 13
+      "count": 6
     },
     {
       "layer": "L2",
-      "count": 53
+      "count": 57
     },
     {
       "layer": "L3",
-      "count": 100
+      "count": 99
     }
   ],
   "tools": [
@@ -199,7 +199,7 @@
     {
       "name": "get_company_profile",
       "group": "company",
-      "layer": "L1",
+      "layer": "L2",
       "cliMethod": "profile",
       "categoryNameZh": "企业基础信息",
       "description": "查询企业的简介信息，包括企业名称、简介，适用于企业画像构建、企业业务分析场景。",
@@ -231,7 +231,7 @@
     {
       "name": "get_company_scale",
       "group": "company",
-      "layer": "L1",
+      "layer": "L2",
       "cliMethod": "scale",
       "categoryNameZh": "企业基础信息",
       "description": "查询企业规模相关指标，包括人员规模、参保人数、分支机构数量、对外投资数量等。",
@@ -247,7 +247,7 @@
     {
       "name": "get_company_tags",
       "group": "company",
-      "layer": "L1",
+      "layer": "L2",
       "cliMethod": "tags",
       "categoryNameZh": "企业基础信息",
       "description": "查询企业标签，包括领域分类、主营业务、榜单等标签信息。",
@@ -292,38 +292,6 @@
         }
       ]
     },
-    {
-      "name": "get_enterprise_report_basic",
-      "group": "company",
-      "layer": "L1",
-      "cliMethod": "enterprise-report-basic",
-      "categoryNameZh": "企业基础信息",
-      "description": "查询企业基础版信用报告，包括工商信息、分支机构、变更记录、主要人员、联系方式等。",
-      "params": [
-        {
-          "name": "searchKey",
-          "type": "string",
-          "required": true,
-          "description": "企业名称 或 统一社会信用代码"
-        }
-      ]
-    },
-    {
-      "name": "get_enterprise_report_professional",
-      "group": "company",
-      "layer": "L1",
-      "cliMethod": "enterprise-report-professional",
-      "categoryNameZh": "企业基础信息",
-      "description": "查询企业专业版信用报告，包括基础版所有字段 + 司法风险、经营风险、知识产权、经营信息、上市等全维度数据。",
-      "params": [
-        {
-          "name": "searchKey",
-          "type": "string",
-          "required": true,
-          "description": "企业名称 或 统一社会信用代码"
-        }
-      ]
-    },
     {
       "name": "get_equity_ratio",
       "group": "company",
@@ -407,7 +375,7 @@
     {
       "name": "get_financial_summary",
       "group": "company",
-      "layer": "L1",
+      "layer": "L2",
       "cliMethod": "financial-summary",
       "categoryNameZh": "企业基础信息",
       "description": "查询上市公司财务简析数据，包括营业收入、净利润、总资产、净资产、净利率、毛利率、资产负债率。",
@@ -773,22 +741,6 @@
         }
       ]
     },
-    {
-      "name": "get_tax_invoice_info",
-      "group": "company",
-      "layer": "L2",
-      "cliMethod": "tax-invoice-info",
-      "categoryNameZh": "企业基础信息",
-      "description": "查询企业税号开票信息，包括纳税人识别号、企业类型、地址、联系电话、开户行、开户行账号，适用于财务开票场景。",
-      "params": [
-        {
-          "name": "searchKey",
-          "type": "string",
-          "required": true,
-          "description": "企业名称 或 统一社会信用代码"
-        }
-      ]
-    },
     {
       "name": "search_companies",
       "group": "company",
@@ -903,7 +855,7 @@
     {
       "name": "verify_company_accuracy",
       "group": "company",
-      "layer": "L1",
+      "layer": "L2",
       "cliMethod": "accuracy",
       "categoryNameZh": "企业基础信息",
       "description": "核实企业名称、法定代表人与统一社会信用代码的匹配性，适用于企业实名认证、准入资质初审及基础信息准确性校验。",
@@ -2443,22 +2395,6 @@
         }
       ]
     },
-    {
-      "name": "get_disciplinary_list",
-      "group": "risk",
-      "layer": "L3",
-      "cliMethod": "disciplinary-list",
-      "categoryNameZh": "风险合规",
-      "description": "查询企业被纳入惩戒/黑名单情况（数据来源：天眼查风险标签聚合）。",
-      "params": [
-        {
-          "name": "searchKey",
-          "type": "string",
-          "required": true,
-          "description": "企业名称 或 统一社会信用代码"
-        }
-      ]
-    },
     {
       "name": "get_dishonest_info",
       "group": "risk",

package/dist/commands/layers.js

@@ -10,9 +10,9 @@ const LAYER_SPECS = [
     {
         layer: "L1",
         title: "Overview · 概要层",
-        summary: "跨维度聚合、总览、评分、实体校验。Agent 拿到 USCC 后的第 1 跳，回包带 _summary + drill_down 线索。",
-        trigger: '"这家公司是什么 / 整体怎么样 / 有没有风险 / 能不能信任"',
-        contract: "不需要你提前知道维度；一次调用就能拿到 _summary + drill_down 线索。",
+        summary: "**6 个 facet 队长，每 facet 1 个总览**：company-base / 风险 / 知产 / 经营信用 / 历史 / 董监高 各 1 个 L1 工具，单次调用聚合该 facet 多子维度。",
+        trigger: '"这家公司整体怎么样 / 风险如何 / 知产实力 / 经营状况 / 历史变更 / 这个人是谁"',
+        contract: "Agent 按 facet 选 1 个 L1 调用即得 _summary + drill_down 线索；不需要你预先在 facet 内挑子维度。",
     },
     {
         layer: "L2",
@@ -115,11 +115,11 @@ function renderLayersText() {
     const total = getTotalCount();
     const defaultSurface = getLayerCount("L0") + getLayerCount("L1");
     const lines = [];
-    lines.push("tyc-cli · Layered Tool Architecture (v5 §3.3 ①)");
+    lines.push("tyc-cli · Layered Tool Architecture");
     lines.push(`Total ${total} tools  ·  L0=${getLayerCount("L0")}  L1=${getLayerCount("L1")}  L2=${getLayerCount("L2")}  L3=${getLayerCount("L3")}`);
     lines.push("Rationale: LLM tool-selection accuracy collapses beyond 30 tools.");
     lines.push(`  tyc carves L0 into a single entity-resolution tool, so the default LLM`);
-    lines.push(`  surface is L0 + L1 = ${defaultSurface} tools (≤ v5's 15-tool limit);`);
+    lines.push(`  surface is L0 + L1 = ${defaultSurface} tools (≤ 15-tool exposure limit);`);
     lines.push("  L2/L3 are discovered on demand via _summary / drill_down_tools.");
     lines.push("");
     for (const s of LAYER_SPECS) {
@@ -145,7 +145,7 @@ function renderLayersMarkdown() {
     lines.push("# tyc-cli · Layered Tool Architecture");
     lines.push("");
     lines.push(`> Total **${getTotalCount()}** tools · **L0=${getLayerCount("L0")}** · **L1=${getLayerCount("L1")}** · **L2=${getLayerCount("L2")}** · **L3=${getLayerCount("L3")}**  `);
-    lines.push(`> Design rationale (v5 §3.3 ①): LLM tool-selection accuracy collapses above 30 tools; tyc carves L0 into a dedicated entity-resolution tool so the default LLM surface = L0 + L1 = ${defaultSurface} tools (≤ 15-tool limit), discovers L2/L3 on demand.`);
+    lines.push(`> Design rationale: LLM tool-selection accuracy collapses above 30 tools; tyc carves L0 into a dedicated entity-resolution tool so the default LLM surface = L0 + L1 = ${defaultSurface} tools (≤ 15-tool limit), discovers L2/L3 on demand.`);
     lines.push("");
     lines.push("| Layer | Tools | Summary | Trigger |");
     lines.push("|---|---:|---|---|");

package/dist/index.js

@@ -7,7 +7,7 @@ import { getCategories, getLayerCount, getTotalCount, } from "./registry.js";
 // 顶层 help：把"最懂 AI 的 CLI"落在 4 层架构 + 调用顺序 + 可发现性上。
 // Agent 看 tyc --help 时应立刻读懂"先 L0 锚定企业，再 L1 概览，再 L2 下钻，最后 L3 详情"这条主线。
 const helpText = `
-ARCHITECTURE — Layered Tool Discovery for LLM Agents (v5 §3.3 ①)
+ARCHITECTURE — Layered Tool Discovery for LLM Agents
 
   Cognitive research shows LLM tool-selection accuracy collapses above
   30 tools (>95% at 10, ~70% at 30, <50% at 100+). tyc counters this with
@@ -15,7 +15,7 @@ ARCHITECTURE — Layered Tool Discovery for LLM Agents (v5 §3.3 ①)
   entity-resolution layer:
 
     ┌─ L0  Resolve       ${pad(getLayerCount("L0"), 3)} tool    entity resolution · 简称/曾用名/模糊名 → 精确企业
-    ├─ L1  Overview     ${pad(getLayerCount("L1"), 3)} tools   cross-facet aggregation · scoring · entity-check
+    ├─ L1  Overview     ${pad(getLayerCount("L1"), 3)} tools   one captain per facet · returns _summary + drill_down
     ├─ L2  Drill-down   ${pad(getLayerCount("L2"), 3)} tools   one-hop into a specific data dimension
     └─ L3  Specialized  ${pad(getLayerCount("L3"), 3)} tools   id-based detail · search_* · vertical SKILLs
 
@@ -34,7 +34,7 @@ ARCHITECTURE — Layered Tool Discovery for LLM Agents (v5 §3.3 ①)
   Rule of thumb: the smaller the layer number, the higher the information
   density per token. L0 is MANDATORY — skipping it (without a USCC already
   in hand) wastes downstream calls on the wrong entity.
-  Default LLM surface = L0 + L1 = ${getLayerCount("L0") + getLayerCount("L1")} tools (≤ v5's 15-tool limit).
+  Default LLM surface = L0 + L1 = ${getLayerCount("L0") + getLayerCount("L1")} tools (≤ 15-tool exposure limit).
 
 DISCOVER BY LAYER
 

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "tyc-cli",
-  "version": "0.2.0",
-  "description": "天眼查 MCP CLI — 167 个业务语义聚合工具 · 命令行直达企业数据 · 通过 MCP Server 调用",
+  "version": "0.2.2",
+  "description": "天眼查 MCP CLI — 163 个业务语义聚合工具 · 命令行直达企业数据 · 通过 MCP Server 调用",
   "main": "dist/index.js",
   "bin": {
     "tyc": "./dist/index.js"