@dshtrading/knowledge 0.4.0 → 0.5.0

package/lib/authors.d.ts

@@ -0,0 +1,13 @@
+import { KnowledgeCard } from "./types.js";
+//#region src/authors.d.ts
+declare const AUTHOR_ALIASES: Readonly<Record<string, string>>;
+/** 把作者名归一到规范名；未登记的写法原样返回（仅去除首尾空白）。 */
+declare function canonicalAuthor(author: string): string;
+/**
+ * 返回作者已归一的卡片副本；已是规范名时原样返回同一引用。
+ * 非破坏性：不修改传入卡片。缺 `source`/`author` 的畸形条目按原样放行——文件读取
+ * 层不为历史脏数据抛错，结构校验只在入库（`validateKnowledgeCard`）发生。
+ */
+declare function canonicalizeCardAuthor(card: KnowledgeCard): KnowledgeCard;
+//#endregion
+export { AUTHOR_ALIASES, canonicalAuthor, canonicalizeCardAuthor };

package/lib/authors.js

@@ -0,0 +1,35 @@
+//#region src/authors.ts
+const AUTHOR_ALIASES = Object.freeze({
+	"鳄鱼派": "鳄鱼派（像鳄鱼一样思考）",
+	"鳄鱼派（公众号：像鳄鱼一样思考）": "鳄鱼派（像鳄鱼一样思考）",
+	"像鳄鱼一样思考（鳄鱼派）": "鳄鱼派（像鳄鱼一样思考）",
+	"zcl × DSH Master（自有分析，非外部素材）": "zcl × DSH Master（自有分析）",
+	"zcl × DSH Master（自有框架综合，非外部素材）": "zcl × DSH Master（自有分析）",
+	"山基说（素材提炼）/ zcl（分层核查，事实依据 facts/oil.md、facts/fed.md）": "山基说",
+	"小鹿投研日记（转播大摩闭门会 9.14，发言人Robin/Steven/钟申/Jenny；Laura股票部分视频截断未录）": "小鹿投研日记",
+	"中金点睛（刘刚、杨萱庭）": "中金点睛"
+});
+/** 把作者名归一到规范名；未登记的写法原样返回（仅去除首尾空白）。 */
+function canonicalAuthor(author) {
+	const trimmed = author.trim();
+	return AUTHOR_ALIASES[trimmed] ?? trimmed;
+}
+/**
+* 返回作者已归一的卡片副本；已是规范名时原样返回同一引用。
+* 非破坏性：不修改传入卡片。缺 `source`/`author` 的畸形条目按原样放行——文件读取
+* 层不为历史脏数据抛错，结构校验只在入库（`validateKnowledgeCard`）发生。
+*/
+function canonicalizeCardAuthor(card) {
+	if (!card || typeof card !== "object" || !card.source || typeof card.source.author !== "string") return card;
+	const canonical = canonicalAuthor(card.source.author);
+	if (canonical === card.source.author) return card;
+	return {
+		...card,
+		source: {
+			...card.source,
+			author: canonical
+		}
+	};
+}
+//#endregion
+export { AUTHOR_ALIASES, canonicalAuthor, canonicalizeCardAuthor };

package/lib/index.d.ts

@@ -2,4 +2,5 @@ import { BuildGraphOptions, GraphLinkKind, KnowledgeCard, KnowledgeCardInput, Kn
 import { ValidationResult, generateCardId, validateKnowledgeCard } from "./validate.js";
 import { buildGraph } from "./graph.js";
 import { createMemoryKnowledgeCardStore } from "./store-memory.js";
-export { type BuildGraphOptions, type GraphLinkKind, type KnowledgeCard, type KnowledgeCardInput, type KnowledgeCardStore, type KnowledgeCredibility, type KnowledgeFactCheck, type KnowledgeGraphData, type KnowledgeGraphLink, type KnowledgeGraphNode, type KnowledgeSource, type KnowledgeSourceType, type ValidationResult, buildGraph, createMemoryKnowledgeCardStore, generateCardId, validateKnowledgeCard };
+import { AUTHOR_ALIASES, canonicalAuthor, canonicalizeCardAuthor } from "./authors.js";
+export { AUTHOR_ALIASES, type BuildGraphOptions, type GraphLinkKind, type KnowledgeCard, type KnowledgeCardInput, type KnowledgeCardStore, type KnowledgeCredibility, type KnowledgeFactCheck, type KnowledgeGraphData, type KnowledgeGraphLink, type KnowledgeGraphNode, type KnowledgeSource, type KnowledgeSourceType, type ValidationResult, buildGraph, canonicalAuthor, canonicalizeCardAuthor, createMemoryKnowledgeCardStore, generateCardId, validateKnowledgeCard };

package/lib/index.js

@@ -1,4 +1,5 @@
+import { AUTHOR_ALIASES, canonicalAuthor, canonicalizeCardAuthor } from "./authors.js";
 import { generateCardId, validateKnowledgeCard } from "./validate.js";
 import { buildGraph } from "./graph.js";
 import { createMemoryKnowledgeCardStore } from "./store-memory.js";
-export { buildGraph, createMemoryKnowledgeCardStore, generateCardId, validateKnowledgeCard };
+export { AUTHOR_ALIASES, buildGraph, canonicalAuthor, canonicalizeCardAuthor, createMemoryKnowledgeCardStore, generateCardId, validateKnowledgeCard };

package/lib/knowledge-fs.js

@@ -1,3 +1,4 @@
+import { canonicalizeCardAuthor } from "./authors.js";
 import { readFile } from "node:fs/promises";
 import { writeJsonAtomic } from "@dshtrading/dsh-home";
 //#region src/knowledge-fs.ts
@@ -15,7 +16,13 @@ function createFileKnowledgeCardStore(filePath) {
 			const parsed = JSON.parse(content);
 			const map = /* @__PURE__ */ new Map();
 			if (Array.isArray(parsed)) {
-				for (const item of parsed) if (item && typeof item.id === "string") map.set(item.id, item);
+				let healed = 0;
+				for (const item of parsed) if (item && typeof item.id === "string") {
+					const card = canonicalizeCardAuthor(item);
+					if (card !== item) healed += 1;
+					map.set(item.id, card);
+				}
+				if (healed > 0) console.warn(`[dsh-trading/knowledge] 作者别名归一：读取时治愈 ${healed} 张历史卡片（${filePath}）；下一次写操作会把结果落盘`);
 			}
 			cache = map;
 			return map;
@@ -42,7 +49,7 @@ function createFileKnowledgeCardStore(filePath) {
 		},
 		async save(card) {
 			const map = await load();
-			map.set(card.id, { ...card });
+			map.set(card.id, canonicalizeCardAuthor({ ...card }));
 			await flush(map);
 		},
 		async delete(id) {

package/lib/store-memory.js

@@ -1,7 +1,8 @@
+import { canonicalizeCardAuthor } from "./authors.js";
 //#region src/store-memory.ts
 function createMemoryKnowledgeCardStore(initialCards = []) {
 	const map = /* @__PURE__ */ new Map();
-	for (const c of initialCards) map.set(c.id, { ...c });
+	for (const c of initialCards) map.set(c.id, canonicalizeCardAuthor({ ...c }));
 	return {
 		async list() {
 			return Array.from(map.values());
@@ -14,7 +15,7 @@ function createMemoryKnowledgeCardStore(initialCards = []) {
 			for (const card of map.values()) if (card.source.url.trim() === trimmed) return card;
 		},
 		async save(card) {
-			map.set(card.id, { ...card });
+			map.set(card.id, canonicalizeCardAuthor({ ...card }));
 		},
 		async delete(id) {
 			return map.delete(id);

package/lib/tool.js

@@ -186,7 +186,10 @@ function createKnowledgeIngestTool(store, options = {}) {
 			const card = validation.card;
 			await store.save(card);
 			onWritten?.(card);
-			return `[knowledge_ingest] ${!!existingByUrl ? "成功更新已有知识卡片" : "成功创建新知识卡片"} [${card.id}] "${card.title}" (标签: ${card.tags.join(", ")}${card.related?.length ? `, 关联: ${card.related.join(", ")}` : ""})`;
+			const actionDesc = !!existingByUrl ? "成功更新已有知识卡片" : "成功创建新知识卡片";
+			const requestedAuthor = typeof args.sourceAuthor === "string" ? args.sourceAuthor.trim() : "";
+			const authorNote = requestedAuthor !== "" && requestedAuthor !== card.source.author ? `（作者已归一：${requestedAuthor} → ${card.source.author}）` : "";
+			return `[knowledge_ingest] ${actionDesc} [${card.id}] "${card.title}"${authorNote} (标签: ${card.tags.join(", ")}${card.related?.length ? `, 关联: ${card.related.join(", ")}` : ""})`;
 		}
 	});
 }

package/lib/validate.js

@@ -1,3 +1,4 @@
+import { canonicalAuthor } from "./authors.js";
 //#region src/validate.ts
 const ALLOWED_CREDIBILITY = /* @__PURE__ */ new Set([
 	"high",
@@ -103,7 +104,7 @@ function validateKnowledgeCard(input, existingCards = []) {
 			source: {
 				type: input.source.type,
 				url: input.source.url.trim(),
-				author: input.source.author.trim(),
+				author: canonicalAuthor(input.source.author),
 				publishedAt: input.source.publishedAt
 			},
 			credibility: input.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.4.0",
+  "version": "0.5.0",
   "type": "module",
   "main": "lib/index.js",
   "types": "./lib/index.d.ts",
@@ -25,9 +25,9 @@
   ],
   "license": "PolyForm-Noncommercial-1.0.0",
   "dependencies": {
-    "@deepseek-ai/dsh-tools": "0.1.5-rc.1",
-    "@deepseek-ai/schemastery": "^3.18.2",
-    "@dshtrading/dsh-home": "^0.4.0"
+    "@deepseek-ai/dsh-tools": "0.2.0-rc.2",
+    "@deepseek-ai/schemastery": "^3.18.4",
+    "@dshtrading/dsh-home": "^0.5.0"
   },
   "peerDependencies": {
     "@deepseek-ai/cordis": ">=4.0.0"