tyc-cli 0.3.8 → 0.3.9

package/dist/utils/jsonToMarkdown.js

@@ -5,21 +5,14 @@
  * - 顶层简单字段渲染为 key/value 表格
  * - 项目元数据（_summary / _empty / _warnings）单独凸显
  * - items 列表自动渲染为表格
- * - 嵌套对象/对象数组优雅折叠
+ * - 嵌套对象/对象数组完整保留；显式截断由统一输出层负责
  */
-const META_KEYS = new Set(["_summary", "_empty", "_warnings", "_tip"]);
+import { renderChangeRecords, splitChangeRecords } from "./personnelChanges.js";
+import { renderHistoryGuide, splitHistoricalPersonnel } from "./history.js";
+const META_KEYS = new Set(["_summary", "_empty", "_warnings", "_tip", "_truncated", "_pagination", "_riskOverview", "_dateSemantics", "_fieldSemantics", "_historyGuide", "_source"]);
 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 "-";
@@ -49,21 +42,16 @@ function formatArrayCell(arr) {
         return arr.map(formatPrimitive).join(", ");
     }
     // 对象数组：紧凑 JSON
-    return JSON.stringify(arr).slice(0, 80) + (JSON.stringify(arr).length > 80 ? "…" : "");
+    return JSON.stringify(arr);
 }
 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("; ") || "-";
+    return JSON.stringify(obj);
+}
+function renderJSONBlock(value) {
+    const text = JSON.stringify(value, null, 2);
+    const longestFence = Math.max(0, ...(text.match(/`+/g) || []).map((s) => s.length));
+    const fence = "`".repeat(Math.max(3, longestFence + 1));
+    return `${fence}json\n${text}\n${fence}\n`;
 }
 function renderItemsTable(items, title = "items") {
     if (items.length === 0) {
@@ -75,6 +63,9 @@ function renderItemsTable(items, title = "items") {
         items.forEach((v, i) => lines.push(`${i + 1}. ${formatPrimitive(v)}`));
         return lines.join("\n") + "\n";
     }
+    if (!items.every(isPlainObject)) {
+        return `\n### ${title}（${items.length} 条）\n\n${renderJSONBlock(items)}`;
+    }
     // 对象数组 → Markdown 表格
     const cols = getAllKeys(items);
     if (cols.length === 0)
@@ -119,16 +110,71 @@ function renderTopFields(obj) {
     return lines.join("\n") + "\n";
 }
 function renderMeta(obj) {
-    const lines = [];
+    const lines = renderHistoryGuide(obj._historyGuide);
+    const sourceNotes = (payload, prefix = "") => {
+        if (!isPlainObject(payload._source))
+            return;
+        const source = payload._source;
+        lines.push(`> ${prefix}数据来源：${escapeCell(formatPrimitive(source.api))}；${escapeCell(formatPrimitive(source.meaning))}`);
+        lines.push(`> ${prefix}来源时间口径：${escapeCell(formatPrimitive(source.temporalNote))}`);
+    };
+    sourceNotes(obj);
+    if (isPlainObject(obj.sources)) {
+        for (const [scope, payload] of Object.entries(obj.sources)) {
+            if (isPlainObject(payload))
+                sourceNotes(payload, `${scope}：`);
+        }
+    }
+    if (isPlainObject(obj._fieldSemantics)) {
+        for (const key of Object.keys(obj._fieldSemantics).sort()) {
+            const note = obj._fieldSemantics[key];
+            if (typeof note === "string" && note)
+                lines.push(`> 字段口径：${escapeCell(note)}`);
+        }
+    }
+    if (isPlainObject(obj._dateSemantics)) {
+        for (const key of ["change_time", "ftShareholding", "changeTime", "createTime", "historicalTime", "firstAppointment"]) {
+            const note = obj._dateSemantics[key];
+            if (typeof note === "string" && note)
+                lines.push(`> 时间口径：${escapeCell(note)}`);
+        }
+    }
     if (obj._summary) {
         lines.push(`> 📋 **摘要**：${formatPrimitive(obj._summary)}`);
     }
     if (obj._tip) {
         lines.push(`> 💡 **提示**：${formatPrimitive(obj._tip)}`);
     }
-    if (obj._empty === true) {
+    if (obj._empty === true && !isPlainObject(obj._riskOverview)) {
         lines.push(`> ⚪ **空结果**：未发现该维度记录`);
     }
+    if (isPlainObject(obj._pagination)) {
+        const p = obj._pagination;
+        const parts = [];
+        if (p.page !== undefined)
+            parts.push(`第${p.page}页`);
+        if (p.requested_page_size !== undefined)
+            parts.push(`请求每页${p.requested_page_size}条`);
+        if (p.effective_page_size !== undefined)
+            parts.push(`实际每页${p.effective_page_size}条`);
+        if (p.max_page_size !== undefined)
+            parts.push(`上游每页上限${p.max_page_size}条`);
+        parts.push(`本次返回${p.returned}条`);
+        parts.push(p.total === undefined ? "全量总数未知" : `共${p.total}条`);
+        if (p.has_more === true) {
+            parts.push(`还有下一页；沿用原命令和主体/筛选参数，传 --pageNum ${p.next_page} --pageSize ${p.effective_page_size}`);
+        }
+        else if (p.has_more === false) {
+            parts.push("已到末页");
+        }
+        else {
+            parts.push("尚不能确定是否还有下一页");
+        }
+        lines.push(`> 分页：${parts.join("；")}。`);
+    }
+    else if (obj._truncated === 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)) {
@@ -137,6 +183,55 @@ function renderMeta(obj) {
     }
     return lines.length > 0 ? lines.join("\n") + "\n" : "";
 }
+function renderRiskOverview(obj) {
+    const parts = [];
+    const meta = obj._riskOverview;
+    if (isPlainObject(meta)) {
+        // State and counts come from Shared Core; never derive them from local rows.
+        parts.push(`> 数据状态：${formatPrimitive(meta.dataStatus)}；摘要及诊断行数：${formatPrimitive(meta.displayRowCount)}；风险事件总数：未确认。`);
+        parts.push(`> 计数口径：${formatPrimitive(meta.countMeaning)}`);
+        if (meta.reportedTotal !== undefined) {
+            parts.push(`> 上游报告总数：${formatPrimitive(meta.reportedTotal)}（保留原始口径，未经事件去重核实）。`);
+        }
+        if (Array.isArray(meta.reportedCounts) && meta.reportedCounts.length > 0) {
+            parts.push(renderItemsTable(meta.reportedCounts, "上游计数来源"));
+        }
+        if (Array.isArray(meta.issues)) {
+            parts.push(...meta.issues.map((issue) => `> 数据说明：${escapeCell(formatPrimitive(issue))}`));
+        }
+    }
+    const sections = [
+        ["toolRisks", "可用专项工具获取详情"],
+        ["detailRisks", "需通过风险 ID 获取详情"],
+        ["relationRiskNotes", "周边风险提示"],
+        ["warningRisks", "预警提醒"],
+        ["unclassifiedRisks", "未分类风险及诊断信息"],
+    ];
+    const sectionKeys = new Set(sections.map(([key]) => key));
+    const otherFields = Object.fromEntries(Object.entries(obj).filter(([key]) => !META_KEYS.has(key) && !sectionKeys.has(key) && key !== "name" && !(key === "total" && isPlainObject(meta))));
+    if (Object.keys(otherFields).length > 0)
+        parts.push(renderTopFields(otherFields));
+    for (const [key, title] of sections) {
+        const rows = obj[key];
+        if (!Array.isArray(rows) || rows.length === 0)
+            continue;
+        if (key === "detailRisks") {
+            parts.push("使用 get_risk_detail，将 riskId 作为 id 参数、同一行 type 作为 type 参数。");
+        }
+        parts.push(renderItemsTable(rows.map((row) => {
+            if (!isPlainObject(row) || !Array.isArray(row.examples))
+                return row;
+            const { examples, ...rest } = row;
+            return rest;
+        }), title));
+        for (const row of rows) {
+            if (isPlainObject(row) && Array.isArray(row.examples) && row.examples.length > 0) {
+                parts.push(renderItemsTable(row.examples, `${title} / ${formatPrimitive(row.riskType)}：关联主体与原始风险示例`));
+            }
+        }
+    }
+    return parts.join("\n\n");
+}
 function renderNestedObjects(obj) {
     const lines = [];
     for (const [k, v] of Object.entries(obj)) {
@@ -181,6 +276,15 @@ export function jsonToMarkdown(value, toolName) {
         return "```\n" + formatPrimitive(value) + "\n```\n";
     }
     const obj = value;
+    const historical = splitHistoricalPersonnel(obj, toolName);
+    if (historical)
+        return jsonToMarkdown(historical.rest, toolName) + "\n" + historical.markdown;
+    const changes = splitChangeRecords(obj, toolName);
+    if (changes) {
+        // The recursive call receives a copy without the extracted list. Keep raw
+        // code blocks verbatim: the generic newline compaction must not touch them.
+        return jsonToMarkdown(changes.rest, toolName) + "\n" + renderChangeRecords(changes.records, changes.title);
+    }
     const parts = [];
     // 标题
     if (toolName) {
@@ -193,6 +297,10 @@ export function jsonToMarkdown(value, toolName) {
     const meta = renderMeta(obj);
     if (meta)
         parts.push(meta);
+    if (toolName === "get_risk_overview" || isPlainObject(obj._riskOverview)) {
+        parts.push(renderRiskOverview(obj));
+        return parts.join("\n").replace(/\n{3,}/g, "\n\n");
+    }
     // 顶层字段
     const topFields = renderTopFields(obj);
     parts.push(topFields);

package/dist/utils/personnelChanges.js

@@ -0,0 +1,74 @@
+// Presentation only: all personnel extraction and statuses come from Shared Core.
+import { changeRecordsForDisplay } from "./history.js";
+const object = (v) => v !== null && typeof v === "object" && !Array.isArray(v);
+const text = (v) => typeof v === "string" ? v : JSON.stringify(v) ?? "null";
+const cell = (v) => (v === undefined || v === "" ? "-" : text(v)).replace(/\|/g, "\\|").replace(/\r?\n/g, " ");
+function block(value) {
+    const raw = text(value);
+    const longest = Math.max(0, ...(raw.match(/`+/g) ?? []).map((s) => s.length));
+    const fence = "`".repeat(Math.max(3, longest + 1));
+    return `${fence}text\n${raw}\n${fence}\n`;
+}
+export function splitChangeRecords(obj, toolName) {
+    if (toolName === "get_change_records" && Array.isArray(obj.items)) {
+        const rest = { ...obj };
+        delete rest.items;
+        return { rest, records: obj.items, title: "变更记录" };
+    }
+    if (toolName === "get_historical_registration" && object(obj.sources) && object(obj.sources.cb) && Array.isArray(obj.sources.cb.changeList)) {
+        const cb = { ...obj.sources.cb };
+        delete cb.changeList;
+        return { rest: { ...obj, sources: { ...obj.sources, cb } }, records: obj.sources.cb.changeList, title: "工商信息 / 变更记录" };
+    }
+    return undefined;
+}
+function renderSide(title, side) {
+    if (!object(side))
+        return "";
+    const out = [`#### ${title}\n`, `解析状态：${cell(side.status)}\n`];
+    const people = Array.isArray(side.people) ? side.people : [];
+    if (people.length) {
+        out.push("| 姓名 | 职务原值 | 法定代表人标志原值 | 显式变更标记 | 其他登记字段 |", "|---|---|---|---|---|");
+        for (const person of people) {
+            if (!object(person)) {
+                out.push(block(person));
+                continue;
+            }
+            const fields = Array.isArray(person.fields) ? person.fields : [];
+            const other = fields.filter((field) => !object(field) || !["姓名", "职务", "法定代表人标志"].includes(String(field.key)));
+            out.push(`| ${[person.name, person.position, person.legalRepresentativeFlag, person.marker, other].map(cell).join(" | ")} |`);
+        }
+        out.push("");
+    }
+    if (Array.isArray(side.warnings))
+        for (const warning of side.warnings)
+            out.push(`> 解析说明：${cell(warning)}\n`);
+    if (Array.isArray(side.unparsedFragments))
+        for (const fragment of side.unparsedFragments)
+            out.push("未解析片段：\n", block(fragment));
+    return out.join("\n");
+}
+export function renderChangeRecords(records, title) {
+    const out = [`## ${title}（${records.length} 条）\n`, "> 本次返回记录按变更日期倒序展示；同日维持来源顺序，日期未知置后，不代表全量历程。\n"];
+    changeRecordsForDisplay(records).forEach((value, index) => {
+        if (!object(value)) {
+            out.push(block(value));
+            return;
+        }
+        out.push(`### 第 ${index + 1} 条 · ${cell(value.changeTime)} · ${cell(value.changeItem)}\n`);
+        const parsed = object(value._parsed) && value._parsed.version === 1 ? value._parsed : undefined;
+        for (const [key, v] of Object.entries(value)) {
+            if (["changeTime", "changeItem", "contentBefore", "contentAfter"].includes(key) || (key === "_parsed" && parsed))
+                continue;
+            out.push(`${key === "createTime" ? "记录创建日期" : key}：${cell(v)}\n`);
+        }
+        if (parsed) {
+            out.push(`> 解析版本：${cell(parsed.version)}；原文完整性：${cell(parsed.sourceCompleteness)}（未确认）。解析结果不是完整任职快照，标志原值未转换。\n`);
+            out.push(renderSide("变更前人员", parsed.before), renderSide("变更后人员", parsed.after));
+        }
+        for (const [key, name] of [["contentBefore", "变更前原文"], ["contentAfter", "变更后原文"]]) {
+            out.push(`#### ${name}\n`, key in value ? block(value[key]) : "_(原字段未返回)_\n");
+        }
+    });
+    return out.join("\n");
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "tyc-cli",
-  "version": "0.3.8",
+  "version": "0.3.9",
   "description": "天眼查 AI CLI — 162 个业务语义聚合工具 · 默认 Shared Core 调用 · 兼容 MCP transport",
   "main": "dist/index.js",
   "bin": {