tyc-cli 0.1.1

package/dist/index.js

@@ -0,0 +1,19 @@
+#!/usr/bin/env node
+import { Command } from "commander";
+import { registerInitCommand } from "./commands/init.js";
+import { registerCategoryCommands } from "./commands/category.js";
+import { getTotalCount, getCategories } from "./registry.js";
+const program = new Command()
+    .name("tyc")
+    .description(`天眼查 CLI — ${getTotalCount()} 个业务语义聚合工具 · ${getCategories().length} 个分类 · 返回 tyc 英文 key 透传结构`)
+    .version("0.1.0")
+    .option("--pretty", "格式化 JSON 输出（缩进 2 空格）")
+    .option("--md", "Markdown 表格化输出（适合人类阅读 / Agent 上屏）")
+    .option("--verbose", "输出请求详情到 stderr");
+registerInitCommand(program);
+registerCategoryCommands(program);
+program.parseAsync(process.argv).catch((err) => {
+    const msg = err instanceof Error ? err.message : String(err);
+    console.error(msg);
+    process.exit(1);
+});

package/dist/registry.js

@@ -0,0 +1,46 @@
+import { readFileSync } from "node:fs";
+import { resolve, dirname } from "node:path";
+import { fileURLToPath } from "node:url";
+const __dirname = dirname(fileURLToPath(import.meta.url));
+const REGISTRY_PATH = resolve(__dirname, "generated/t1_1-registry.json");
+let _registry = null;
+let _byName = null;
+let _byGroup = null;
+function load() {
+    if (!_registry) {
+        const raw = readFileSync(REGISTRY_PATH, "utf-8");
+        _registry = JSON.parse(raw);
+    }
+    return _registry;
+}
+function byName() {
+    if (!_byName) {
+        _byName = new Map();
+        for (const t of load().tools)
+            _byName.set(t.name, t);
+    }
+    return _byName;
+}
+function byGroup() {
+    if (!_byGroup) {
+        _byGroup = new Map();
+        for (const t of load().tools) {
+            const arr = _byGroup.get(t.group) || [];
+            arr.push(t);
+            _byGroup.set(t.group, arr);
+        }
+    }
+    return _byGroup;
+}
+export function getTotalCount() {
+    return load().tools.length;
+}
+export function getCategories() {
+    return load().categories;
+}
+export function getToolsByGroup(group) {
+    return byGroup().get(group) || [];
+}
+export function getTool(name) {
+    return byName().get(name);
+}

package/dist/transformer.js

@@ -0,0 +1,133 @@
+// Transformer (TS 版本)
+// 对齐 tools/t1_1/transformer/transformer.go：
+//   1. 按 sources 声明顺序做顶层 map 覆盖合并
+//   2. 时间戳字段值格式化为 Asia/Shanghai 字符串（key 不变）
+//   3. 注入 _summary / _warnings / _empty
+const TIMESTAMP_FIELDS = new Set([
+    "estiblishTime", "approvedTime", "fromTime", "toTime", "updateTimes",
+    "cancelDate", "revokeDate",
+    "changeTime", "createTime", "subscriptionTime", "paidinTime", "ftShareholding",
+    "publishDate", "publishTime", "judgeTime", "submitTime", "submittime",
+    "caseRegTime", "caseCreateTime", "filingDate", "endCaseDate",
+    "decisionDate", "startDate",
+    "appDate", "regDate", "rtm", "eventTime", "pubDate",
+    "applicationTime", "regtime", "publishtime",
+    "releaseTime", "grantDate", "applicationPublishTime",
+    "freezeStartDate", "freezeEndDate", "expiryDate", "issueDate",
+    "recordDate", "establishDate", "joinDate",
+    "investTime", "time", "pubTime",
+    "reportDate", "listingDate", "validFrom", "validTo",
+    "occurDate", "checkDate", "startdate", "bidWinDate",
+    "noticePeriodStart", "noticePeriodEnd", "evaluationDate",
+    "occurTime", "finishDate", "firstPublishDate", "ratingTime",
+    "examineDate",
+]);
+const DATETIME_FIELDS = new Set([
+    "updateTimes", "rtm", "pubTime", "eventTime", "startTime",
+]);
+function pad(n) {
+    return n < 10 ? "0" + n : String(n);
+}
+function formatMs(ms, dateTime) {
+    if (!ms || ms <= 0)
+        return "";
+    // 转换到 Asia/Shanghai（UTC+8）
+    const shanghai = new Date(ms + 8 * 3600 * 1000);
+    const y = shanghai.getUTCFullYear();
+    const mo = pad(shanghai.getUTCMonth() + 1);
+    const d = pad(shanghai.getUTCDate());
+    if (!dateTime)
+        return `${y}-${mo}-${d}`;
+    const h = pad(shanghai.getUTCHours());
+    const mi = pad(shanghai.getUTCMinutes());
+    const s = pad(shanghai.getUTCSeconds());
+    return `${y}-${mo}-${d} ${h}:${mi}:${s}`;
+}
+function formatTimestampsInPlace(v) {
+    if (v === null || v === undefined)
+        return;
+    if (Array.isArray(v)) {
+        for (const item of v)
+            formatTimestampsInPlace(item);
+        return;
+    }
+    if (typeof v === "object") {
+        const obj = v;
+        for (const [k, val] of Object.entries(obj)) {
+            if (TIMESTAMP_FIELDS.has(k) && typeof val === "number" && val > 0) {
+                obj[k] = formatMs(val, DATETIME_FIELDS.has(k));
+                continue;
+            }
+            if (TIMESTAMP_FIELDS.has(k) && typeof val === "string" && /^\d{10,13}$/.test(val)) {
+                const n = Number(val);
+                obj[k] = formatMs(n, DATETIME_FIELDS.has(k));
+                continue;
+            }
+            formatTimestampsInPlace(val);
+        }
+    }
+}
+function summaryCount(count, label) {
+    return `该查询实体共有${count}条${label}记录。`;
+}
+function summaryCountTruncated(total, returned, label) {
+    return `该查询实体共有${total}条${label}记录。已为您展示前${returned}条。`;
+}
+function summaryEmpty(label) {
+    return `已全量扫描该主体${label}数据库，未发现任何记录。`;
+}
+function summaryEmptyRisk(name, label) {
+    return `经天眼查底层数据库全量核查实体 ${name}，当前未发现任何【${label}】记录。此项核心合规风控排查安全，允许进入下一步审计。`;
+}
+export function applyTransformer(tool, results, warnings) {
+    const out = {};
+    // 1. 按 sources 顺序合并
+    const singleSource = tool.sources.length <= 1;
+    for (const src of tool.sources) {
+        const r = results[src.scope];
+        if (!r)
+            continue;
+        if (singleSource || src.scope === "root") {
+            for (const [k, v] of Object.entries(r))
+                out[k] = v;
+        }
+        else {
+            for (const [k, v] of Object.entries(r))
+                out[k] = v;
+            out["_" + src.scope] = r;
+        }
+    }
+    // 2. 时间戳格式化
+    formatTimestampsInPlace(out);
+    // 3. 元数据
+    if (Object.keys(warnings).length > 0)
+        out._warnings = warnings;
+    const items = Array.isArray(out.items) ? out.items : null;
+    if (items && items.length === 0)
+        out._empty = true;
+    if (tool.summary) {
+        const name = typeof out.name === "string" ? out.name : "";
+        const count = items ? items.length : 0;
+        const label = tool.summary.label;
+        switch (tool.summary.template) {
+            case "count":
+                out._summary = count > 0 ? summaryCount(count, label) : summaryEmpty(label);
+                break;
+            case "count_truncated": {
+                let total = count;
+                if (typeof out.total === "number" && out.total > 0)
+                    total = out.total;
+                out._summary = count > 0 ? summaryCountTruncated(total, count, label) : summaryEmpty(label);
+                break;
+            }
+            case "empty_risk":
+                out._summary = count > 0 ? summaryCount(count, label) : summaryEmptyRisk(name, label);
+                break;
+            case "empty_generic":
+            default:
+                out._summary = count > 0 ? summaryCount(count, label) : summaryEmpty(label);
+                break;
+        }
+    }
+    return out;
+}

package/dist/types.js

@@ -0,0 +1 @@
+export {};

package/dist/utils/jsonToMarkdown.js

@@ -0,0 +1,208 @@
+/**
+ * JSON → Markdown 输出格式化
+ *
+ * 设计目标：
+ * - 顶层简单字段渲染为 key/value 表格
+ * - 项目元数据（_summary / _empty / _warnings）单独凸显
+ * - items 列表自动渲染为表格
+ * - 嵌套对象/对象数组优雅折叠
+ */
+const META_KEYS = new Set(["_summary", "_empty", "_warnings", "_tip"]);
+function isPlainObject(v) {
+    return v !== null && typeof v === "object" && !Array.isArray(v);
+}
+function isEmptyValue(v) {
+    if (v === null || v === undefined || v === "")
+        return true;
+    if (Array.isArray(v) && v.length === 0)
+        return true;
+    if (isPlainObject(v) && Object.keys(v).length === 0)
+        return true;
+    return false;
+}
+function formatPrimitive(v) {
+    if (v === null || v === undefined || v === "")
+        return "-";
+    if (typeof v === "boolean")
+        return v ? "是" : "否";
+    return String(v);
+}
+function getAllKeys(arr) {
+    const seen = new Set();
+    for (const item of arr) {
+        if (isPlainObject(item)) {
+            for (const k of Object.keys(item))
+                seen.add(k);
+        }
+    }
+    return Array.from(seen);
+}
+function escapeCell(s) {
+    // Markdown 表格内禁用 `|` 和换行
+    return s.replace(/\|/g, "\\|").replace(/\r?\n/g, " ");
+}
+function formatArrayCell(arr) {
+    if (arr.length === 0)
+        return "-";
+    // 全是基本类型：逗号分隔
+    if (arr.every((x) => !isPlainObject(x) && !Array.isArray(x))) {
+        return arr.map(formatPrimitive).join(", ");
+    }
+    // 对象数组：紧凑 JSON
+    return JSON.stringify(arr).slice(0, 80) + (JSON.stringify(arr).length > 80 ? "…" : "");
+}
+function formatObjectInline(obj) {
+    const parts = [];
+    for (const [k, v] of Object.entries(obj)) {
+        if (isEmptyValue(v))
+            continue;
+        if (isPlainObject(v) || Array.isArray(v)) {
+            parts.push(`${k}=…`);
+        }
+        else {
+            parts.push(`${k}=${formatPrimitive(v)}`);
+        }
+    }
+    return parts.join("; ") || "-";
+}
+function renderItemsTable(items, title = "items") {
+    if (items.length === 0) {
+        return `\n### ${title} (空)\n`;
+    }
+    // 全基本类型 → 编号列表
+    if (items.every((x) => !isPlainObject(x) && !Array.isArray(x))) {
+        const lines = [`\n### ${title}（${items.length} 条）`, ""];
+        items.forEach((v, i) => lines.push(`${i + 1}. ${formatPrimitive(v)}`));
+        return lines.join("\n") + "\n";
+    }
+    // 对象数组 → Markdown 表格
+    const cols = getAllKeys(items);
+    if (cols.length === 0)
+        return `\n### ${title} (无字段)\n`;
+    const lines = [`\n### ${title}（${items.length} 条）`, ""];
+    lines.push("| # | " + cols.join(" | ") + " |");
+    lines.push("|---|" + cols.map(() => "---").join("|") + "|");
+    items.forEach((row, i) => {
+        if (!isPlainObject(row)) {
+            lines.push(`| ${i + 1} | ${formatPrimitive(row)} |${" |".repeat(cols.length - 1)}`);
+            return;
+        }
+        const cells = cols.map((c) => {
+            const v = row[c];
+            if (Array.isArray(v))
+                return escapeCell(formatArrayCell(v));
+            if (isPlainObject(v))
+                return escapeCell(formatObjectInline(v));
+            return escapeCell(formatPrimitive(v));
+        });
+        lines.push(`| ${i + 1} | ${cells.join(" | ")} |`);
+    });
+    return lines.join("\n") + "\n";
+}
+function renderTopFields(obj) {
+    const lines = ["", "## 主要字段", "", "| 字段 | 值 |", "|------|------|"];
+    for (const [k, v] of Object.entries(obj)) {
+        if (META_KEYS.has(k))
+            continue;
+        if (k === "items")
+            continue;
+        if (Array.isArray(v)) {
+            lines.push(`| ${k} | ${escapeCell(formatArrayCell(v))} |`);
+        }
+        else if (isPlainObject(v)) {
+            lines.push(`| ${k} | ${escapeCell(formatObjectInline(v))} |`);
+        }
+        else {
+            lines.push(`| ${k} | ${escapeCell(formatPrimitive(v))} |`);
+        }
+    }
+    return lines.join("\n") + "\n";
+}
+function renderMeta(obj) {
+    const lines = [];
+    if (obj._summary) {
+        lines.push(`> 📋 **摘要**：${formatPrimitive(obj._summary)}`);
+    }
+    if (obj._tip) {
+        lines.push(`> 💡 **提示**：${formatPrimitive(obj._tip)}`);
+    }
+    if (obj._empty === true) {
+        lines.push(`> ⚪ **空结果**：未发现该维度记录`);
+    }
+    if (obj._warnings && isPlainObject(obj._warnings) && Object.keys(obj._warnings).length > 0) {
+        lines.push(`> ⚠️ **警告**：`);
+        for (const [path, msg] of Object.entries(obj._warnings)) {
+            lines.push(`>    - \`${path}\`: ${formatPrimitive(msg)}`);
+        }
+    }
+    return lines.length > 0 ? lines.join("\n") + "\n" : "";
+}
+function renderNestedObjects(obj) {
+    const lines = [];
+    for (const [k, v] of Object.entries(obj)) {
+        if (META_KEYS.has(k) || k === "items")
+            continue;
+        if (isPlainObject(v) && Object.keys(v).length > 0) {
+            lines.push(`\n### ${k}（嵌套对象）`);
+            lines.push("");
+            lines.push("| 字段 | 值 |");
+            lines.push("|------|------|");
+            for (const [k2, v2] of Object.entries(v)) {
+                if (Array.isArray(v2)) {
+                    lines.push(`| ${k2} | ${escapeCell(formatArrayCell(v2))} |`);
+                }
+                else if (isPlainObject(v2)) {
+                    lines.push(`| ${k2} | ${escapeCell(formatObjectInline(v2))} |`);
+                }
+                else {
+                    lines.push(`| ${k2} | ${escapeCell(formatPrimitive(v2))} |`);
+                }
+            }
+        }
+        else if (Array.isArray(v) && v.length > 0 && v.every((x) => isPlainObject(x))) {
+            // 顶层非 items 的对象数组也渲染为表格
+            lines.push(renderItemsTable(v, k));
+        }
+    }
+    return lines.join("\n");
+}
+/**
+ * 主入口：把任意 JSON 值渲染为 Markdown。
+ * @param value 工具返回的 JSON（已 parse 为对象）
+ * @param toolName 工具名（可选，用作标题）
+ */
+export function jsonToMarkdown(value, toolName) {
+    if (value === null || value === undefined) {
+        return "_(空)_\n";
+    }
+    if (!isPlainObject(value)) {
+        if (Array.isArray(value))
+            return renderItemsTable(value);
+        return "```\n" + formatPrimitive(value) + "\n```\n";
+    }
+    const obj = value;
+    const parts = [];
+    // 标题
+    if (toolName) {
+        parts.push(`# ${toolName}\n`);
+    }
+    if (typeof obj.name === "string") {
+        parts.push(`**主体**：${obj.name}\n`);
+    }
+    // 元数据
+    const meta = renderMeta(obj);
+    if (meta)
+        parts.push(meta);
+    // 顶层字段
+    const topFields = renderTopFields(obj);
+    parts.push(topFields);
+    // items 列表
+    if (Array.isArray(obj.items)) {
+        parts.push(renderItemsTable(obj.items, "items"));
+    }
+    // 其他嵌套对象 / 对象数组
+    const nested = renderNestedObjects(obj);
+    if (nested.trim())
+        parts.push(nested);
+    return parts.join("\n").replace(/\n{3,}/g, "\n\n");
+}

package/package.json

@@ -0,0 +1,68 @@
+{
+  "name": "tyc-cli",
+  "version": "0.1.1",
+  "description": "天眼查 OpenAPI 业务语义层命令行工具 — 167 个聚合工具 / 15 个分类 / 命令行 30 秒直查企业数据",
+  "main": "dist/index.js",
+  "bin": {
+    "tyc": "./dist/index.js"
+  },
+  "scripts": {
+    "prebuild": "tsx scripts/build-registry.ts",
+    "build": "npm run prebuild && tsc && mkdir -p dist/generated && cp src/generated/t1_1-registry.json dist/generated/",
+    "dev": "tsx src/index.ts",
+    "lint": "eslint src/ scripts/",
+    "lint:fix": "eslint src/ scripts/ --fix",
+    "test": "vitest run",
+    "test:coverage": "vitest run --coverage",
+    "prepublishOnly": "npm run build"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "keywords": [
+    "tianyancha",
+    "tyc",
+    "openapi",
+    "cli",
+    "ai-agent",
+    "mcp",
+    "enterprise-data",
+    "due-diligence",
+    "kyb"
+  ],
+  "author": "tyc-cli contributors",
+  "license": "MIT",
+  "type": "module",
+  "homepage": "https://github.com/tianyancha-tech/tyc-cli#readme",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/tianyancha-tech/tyc-cli.git"
+  },
+  "bugs": {
+    "url": "https://github.com/tianyancha-tech/tyc-cli/issues"
+  },
+  "files": [
+    "dist/",
+    "api-registry.yaml",
+    "LICENSE",
+    "README.md",
+    "CHANGELOG.md"
+  ],
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org/"
+  },
+  "dependencies": {
+    "commander": "^13.0.0"
+  },
+  "devDependencies": {
+    "@types/node": "^22.0.0",
+    "@typescript-eslint/eslint-plugin": "^8.0.0",
+    "@typescript-eslint/parser": "^8.0.0",
+    "eslint": "^9.0.0",
+    "tsx": "^4.0.0",
+    "typescript": "^5.7.0",
+    "vitest": "^2.0.0",
+    "yaml": "^2.7.0"
+  }
+}