@dshtrading/knowledge 0.1.5 → 0.2.0

package/lib/graph.js

@@ -141,5 +141,58 @@ function buildGraph(cards, options = {}) {
 		links
 	};
 }
+/**
+* 只计数的图概要（knowledge_graph 工具专用）：与默认模式 buildGraph 的
+* { nodes.length, links.length } 严格同值，但不物化节点/边对象——
+* related 边 O(E) 键去重、co-author 边按作者分组 Σk(k-1)/2（同作者对唯一）、
+* co-tag 边按标签索引逐标签枚举对并全局去重 O(Σ k_t²)。工具只要规模数字时
+* 避免全配对边的对象分配（215 卡 ≈ 2 万+边对象的构建与丢弃）。
+*/
+function countGraphSummary(cards) {
+	if (!cards || cards.length === 0) return {
+		nodeCount: 0,
+		edgeCount: 0
+	};
+	const ids = /* @__PURE__ */ new Set();
+	for (const c of cards) ids.add(c.id);
+	const related = /* @__PURE__ */ new Set();
+	for (const card of cards) {
+		if (!Array.isArray(card.related)) continue;
+		for (const targetId of card.related) {
+			if (!ids.has(targetId) || targetId === card.id) continue;
+			const [a, b] = card.id < targetId ? [card.id, targetId] : [targetId, card.id];
+			related.add(`${a}:${b}`);
+		}
+	}
+	const byTag = /* @__PURE__ */ new Map();
+	for (const card of cards) {
+		const seen = /* @__PURE__ */ new Set();
+		for (const tag of card.tags) {
+			if (seen.has(tag)) continue;
+			seen.add(tag);
+			const members = byTag.get(tag);
+			if (members === void 0) byTag.set(tag, [card.id]);
+			else members.push(card.id);
+		}
+	}
+	const coTag = /* @__PURE__ */ new Set();
+	for (const members of byTag.values()) for (let i = 0; i < members.length; i++) for (let j = i + 1; j < members.length; j++) {
+		const a = members[i];
+		const b = members[j];
+		coTag.add(a < b ? `${a}:${b}` : `${b}:${a}`);
+	}
+	const byAuthor = /* @__PURE__ */ new Map();
+	for (const card of cards) {
+		const author = card.source.author.trim();
+		if (!author || author === "manual" || author === "手工") continue;
+		byAuthor.set(author, (byAuthor.get(author) ?? 0) + 1);
+	}
+	let coAuthor = 0;
+	for (const k of byAuthor.values()) coAuthor += k * (k - 1) / 2;
+	return {
+		nodeCount: cards.length,
+		edgeCount: related.size + coTag.size + coAuthor
+	};
+}
 //#endregion
-export { buildGraph };
+export { buildGraph, countGraphSummary };

package/lib/knowledge-fs.js

@@ -1,5 +1,5 @@
-import { mkdir, readFile, rename, unlink, writeFile } from "node:fs/promises";
-import { dirname } from "node:path";
+import { readFile } from "node:fs/promises";
+import { writeJsonAtomic } from "@dshtrading/dsh-home";
 //#region src/knowledge-fs.ts
 /**
 * 文件持久化版知识卡片存储（Node.js 宿主端专用）。
@@ -26,27 +26,7 @@ function createFileKnowledgeCardStore(filePath) {
 		}
 	}
 	async function flush(map) {
-		const dir = dirname(filePath);
-		const tmpPath = `${filePath}.tmp.${Date.now()}.${Math.random().toString(36).slice(2, 8)}`;
-		const data = JSON.stringify([...map.values()], null, 2);
-		try {
-			await mkdir(dir, { recursive: true });
-			await writeFile(tmpPath, data, "utf8");
-			let lastError;
-			for (let attempt = 0; attempt < 3; attempt++) try {
-				await rename(tmpPath, filePath);
-				return;
-			} catch (err) {
-				if (err?.code !== "EPERM" && err?.code !== "EBUSY") throw err;
-				lastError = err;
-				await new Promise((resolve) => setTimeout(resolve, 25 * (attempt + 1)));
-			}
-			throw lastError;
-		} catch (error) {
-			console.error(`[dsh-trading/knowledge] failed to atomic flush knowledge cards to ${filePath}:`, error);
-			await unlink(tmpPath).catch(() => {});
-			throw error;
-		}
+		await writeJsonAtomic(filePath, [...map.values()], "[dsh-trading/knowledge] failed to atomic flush knowledge cards to");
 	}
 	return {
 		async list() {

package/lib/plugin.d.ts

@@ -12,7 +12,7 @@ declare const TRADING_KNOWLEDGE_CARDS_KEY = "tradingKnowledgeCards";
 interface TradingEventsPublisher {
   emit(store: 'knowledge'): void;
 }
-/** 默认存储路径：~/.dsh/knowledge/cards.json（与 client-ui-trading 旧路径一致）。 */
+/** 默认存储路径：$DSH_HOME/knowledge/cards.json（缺省 ~/.dsh；与 client-ui-trading 同源解析）。 */
 declare function defaultStorePath(): string;
 interface KnowledgeGraphToolOptions {
   store: KnowledgeCardStore;

package/lib/plugin.js

@@ -1,10 +1,10 @@
-import { buildGraph } from "./graph.js";
+import { countGraphSummary } from "./graph.js";
 import { createFileKnowledgeCardStore } from "./knowledge-fs.js";
 import { createKnowledgeDeleteTool, createKnowledgeGetTool, createKnowledgeIngestTool, createKnowledgeSearchTool } from "./tool.js";
 import { defineTool } from "@deepseek-ai/dsh-tools";
-import path from "node:path";
+import { dshHomeDir } from "@dshtrading/dsh-home";
 import { Service } from "@deepseek-ai/cordis";
-import os from "node:os";
+import path from "node:path";
 //#region src/plugin.ts
 /** Cordis 插件名 = patch 行 id（TEMPLATES §8）。 */
 const name = "dsh-trading-knowledge";
@@ -12,9 +12,9 @@ const name = "dsh-trading-knowledge";
 const inject = [];
 /** SDK 服务键：知识卡片 store 单实例。 */
 const TRADING_KNOWLEDGE_CARDS_KEY = "tradingKnowledgeCards";
-/** 默认存储路径：~/.dsh/knowledge/cards.json（与 client-ui-trading 旧路径一致）。 */
+/** 默认存储路径：$DSH_HOME/knowledge/cards.json（缺省 ~/.dsh；与 client-ui-trading 同源解析）。 */
 function defaultStorePath() {
-	return path.join(os.homedir(), ".dsh", "knowledge", "cards.json");
+	return path.join(dshHomeDir(), "knowledge", "cards.json");
 }
 /** knowledge_graph 工厂（issue #33 新增；只读结构概要，不倾倒全量 label）。 */
 function createKnowledgeGraphTool(options) {
@@ -32,7 +32,7 @@ function createKnowledgeGraphTool(options) {
 		},
 		async execute() {
 			const cards = await store.list();
-			const data = buildGraph(cards);
+			const data = countGraphSummary(cards);
 			const clusterCounts = /* @__PURE__ */ new Map();
 			const credibility = {
 				high: 0,
@@ -51,8 +51,8 @@ function createKnowledgeGraphTool(options) {
 			return JSON.stringify({
 				ok: true,
 				cards: cards.length,
-				nodeCount: data.nodes.length,
-				edgeCount: data.links.length,
+				nodeCount: data.nodeCount,
+				edgeCount: data.edgeCount,
 				clusters,
 				credibility
 			});

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@dshtrading/knowledge",
   "description": "Knowledge base data plane for dsh-trading: KnowledgeCard data model, validation, graph builder, atomic file store, and knowledge_ingest / knowledge_search agent tools.",
-  "version": "0.1.5",
+  "version": "0.2.0",
   "type": "module",
   "main": "lib/index.js",
   "types": "./lib/index.d.ts",
@@ -26,7 +26,8 @@
   "license": "PolyForm-Noncommercial-1.0.0",
   "dependencies": {
     "@deepseek-ai/dsh-tools": "^0.1.2-alpha.2",
-    "@deepseek-ai/schemastery": "^3.18.2"
+    "@deepseek-ai/schemastery": "^3.18.2",
+    "@dshtrading/dsh-home": "^0.2.0"
   },
   "peerDependencies": {
     "@deepseek-ai/cordis": ">=4.0.0"