@fgbg/mdocs 0.8.25 → 1.1.0

package/dist/server/documents/graph/graph-agent.integration.test.js

@@ -0,0 +1,95 @@
+/**
+ * 图谱 Agent 集成测试。
+ *
+ * 真实调用 Anthropic API，验证：
+ * 1. runComplete 纯文本问答
+ * 2. runToolExtractionWithFallback 正常调用
+ * 3. runToolExtractionWithFallback 降级调用（内容太少时）
+ *
+ * 默认跳过（.skip），需要手动运行：
+ * pnpm vitest run graph-agent.integration.test.ts -t "纯文本"
+ */
+import fs from 'node:fs/promises';
+import os from 'node:os';
+import path from 'node:path';
+import { describe, it, expect } from 'vitest';
+import { Type } from '@earendil-works/pi-ai';
+import { z } from 'zod';
+import { runComplete, runToolExtractionWithFallback } from './graph-agent.js';
+async function loadAgentConfig() {
+    const settingsPath = path.join(os.homedir(), '.claude', 'settings.json');
+    const raw = await fs.readFile(settingsPath, 'utf-8');
+    const settings = JSON.parse(raw);
+    const env = settings.env ?? {};
+    const baseUrl = env.ANTHROPIC_BASE_URL;
+    const apiKey = env.ANTHROPIC_AUTH_TOKEN;
+    const modelId = settings.model ?? 'ddmc';
+    if (!baseUrl || !apiKey) {
+        throw new Error('settings.json 中缺少 ANTHROPIC_BASE_URL 或 ANTHROPIC_AUTH_TOKEN');
+    }
+    return { baseUrl, apiKey, modelId };
+}
+describe.skip('GraphAgent 集成测试（真实 API 调用）', () => {
+    it('纯文本问答可以正常工作', async () => {
+        const config = await loadAgentConfig();
+        const result = await runComplete(config, '你是一个助手，只回答问题。', '用一句话介绍什么是知识图谱。');
+        expect(typeof result).toBe('string');
+        expect(result.length).toBeGreaterThan(0);
+    });
+    it('runToolExtractionWithFallback 正常场景：调用主 tool', async () => {
+        const config = await loadAgentConfig();
+        const primaryTool = {
+            name: 'submitTestResult',
+            description: '提交测试结果',
+            parameters: Type.Object({
+                name: Type.String({ description: '名称' }),
+                value: Type.Number({ description: '数值' }),
+            }),
+            schema: z.object({ name: z.string(), value: z.number() }),
+        };
+        const fallbackTool = {
+            name: 'submitNoResult',
+            description: '当无法生成结果时调用，说明原因',
+            parameters: Type.Object({
+                reason: Type.String({ description: '原因' }),
+            }),
+            schema: z.object({ reason: z.string() }),
+        };
+        const result = await runToolExtractionWithFallback(config, primaryTool, fallbackTool, '你是一个测试助手。必须调用 submitTestResult 或 submitNoResult 之一提交结果。', '请提交一个对象，name 字段为 "test"，value 字段为 42。');
+        expect(result.ok).toBe(true);
+        if (result.ok) {
+            expect(result.data.name).toBe('test');
+            expect(result.data.value).toBe(42);
+        }
+    });
+    it('runToolExtractionWithFallback 降级场景：内容太少时调用降级 tool', async () => {
+        const config = await loadAgentConfig();
+        const primaryTool = {
+            name: 'submitKnowledgePoints',
+            description: '提交从文章中提取的知识要点',
+            parameters: Type.Object({
+                points: Type.Array(Type.Object({
+                    label: Type.String(),
+                    description: Type.String(),
+                })),
+            }),
+            schema: z.object({ points: z.array(z.object({ label: z.string(), description: z.string() })) }),
+        };
+        const fallbackTool = {
+            name: 'submitNoKnowledgePoints',
+            description: '当内容太少无法提取知识要点时调用',
+            parameters: Type.Object({
+                reason: Type.String({ description: '原因' }),
+            }),
+            schema: z.object({ reason: z.string() }),
+        };
+        const result = await runToolExtractionWithFallback(config, primaryTool, fallbackTool, '你是知识提取专家。内容太少时必须调用 submitNoKnowledgePoints。', '以下文章内容只有一个标题，没有正文：\n\n# 测试标题\n');
+        // 内容太少时应该走降级
+        expect(result.ok).toBe(false);
+        if (!result.ok) {
+            expect(typeof result.reason).toBe('string');
+            expect(result.reason.length).toBeGreaterThan(0);
+        }
+    });
+});
+//# sourceMappingURL=graph-agent.integration.test.js.map

package/dist/server/documents/graph/graph-agent.integration.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"graph-agent.integration.test.js","sourceRoot":"","sources":["../../../../src/server/documents/graph/graph-agent.integration.test.ts"],"names":[],"mappings":"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"}

package/dist/server/documents/graph/graph-agent.js

@@ -0,0 +1,185 @@
+/**
+ * 图谱专用的 Agent 工具。
+ *
+ * 基于 @earendil-works/pi-agent-core + @earendil-works/pi-ai 构建。
+ * 提供两种用法：
+ * 1. runComplete — 纯文本单轮问答（简单场景）
+ * 2. runToolExtractionWithFallback — 通过「主 tool + 降级 tool」提取结构化数据
+ *
+ * 每次调用创建一个新的 Agent 实例，没有状态残留。
+ */
+import { Agent } from '@earendil-works/pi-agent-core';
+import { createModels, createProvider } from '@earendil-works/pi-ai';
+import { anthropicMessagesApi } from '@earendil-works/pi-ai/api/anthropic-messages.lazy';
+import { openAICompletionsApi } from '@earendil-works/pi-ai/api/openai-completions.lazy';
+// ========== 纯文本问答 ==========
+/**
+ * 单轮纯文本问答。
+ * 每次调用创建一个新的 Agent，没有状态残留。
+ */
+export async function runComplete(config, system, user) {
+    const agent = createAgent(config);
+    return new Promise((resolve, reject) => {
+        let fullText = '';
+        const unsubscribe = agent.subscribe((event) => {
+            if (event.type === 'message_update' &&
+                event.assistantMessageEvent.type === 'text_delta') {
+                fullText += event.assistantMessageEvent.delta;
+            }
+            if (event.type === 'agent_end') {
+                unsubscribe();
+                resolve(fullText.trim());
+            }
+        });
+        agent.state.systemPrompt = system;
+        agent.prompt(user).catch((err) => {
+            unsubscribe();
+            reject(err instanceof Error ? err : new Error(String(err)));
+        });
+    });
+}
+// ========== Tool 结构化输出（主 + 降级） ==========
+/**
+ * 通过「主 tool + 降级 tool」提取结构化数据。
+ *
+ * 当 AI 认为无法产出有效结果时，可以调用降级 tool 说明原因。
+ * 两个 tool 二选一，AI 必须调用其中一个。
+ *
+ * 外部调用方不需要感知降级逻辑 —— 如果降级了，各链路自己处理成空数组等默认值。
+ *
+ * @param config Agent 配置
+ * @param primaryTool 正常结果 tool
+ * @param fallbackTool 降级结果 tool（参数通常带 reason 字段）
+ * @param systemPrompt 系统提示词
+ * @param userPrompt 用户提示词
+ * @returns 成功返回 { ok: true; data: TPrimary }，降级返回 { ok: false; reason: string }
+ */
+export async function runToolExtractionWithFallback(config, primaryTool, fallbackTool, systemPrompt, userPrompt) {
+    const primarySpec = buildAgentTool(primaryTool, (params) => ({
+        result: { ok: true, data: params },
+    }));
+    const fallbackSpec = buildAgentTool(fallbackTool, (params) => {
+        const fallback = params;
+        return {
+            result: { ok: false, reason: fallback.reason ?? '无法生成结果' },
+        };
+    });
+    const agent = createAgent(config, [primarySpec, fallbackSpec]);
+    return new Promise((resolve, reject) => {
+        let result = null;
+        const unsubscribe = agent.subscribe((event) => {
+            // 任一 tool 执行完成都存结果（tool 返回 terminate: true，agent 随后会结束）
+            if (event.type === 'tool_execution_end') {
+                result = event.result?.details;
+            }
+            if (event.type === 'agent_end') {
+                unsubscribe();
+                if (result !== null) {
+                    resolve(result);
+                }
+                else {
+                    reject(new Error('Agent 结束但未调用任何结果 tool'));
+                }
+            }
+        });
+        const fullSystemPrompt = `${systemPrompt}
+
+重要：你必须调用 ${primaryTool.name} 或 ${fallbackTool.name} 其中一个工具来提交结果，不能直接用文本回答。
+- 如果能正常提取/归纳/生成结果 → 调用 ${primaryTool.name}
+- 如果内容太少或无法生成有效结果 → 调用 ${fallbackTool.name} 并说明原因`;
+        agent.state.systemPrompt = fullSystemPrompt;
+        agent.prompt(userPrompt).catch((err) => {
+            unsubscribe();
+            reject(err instanceof Error ? err : new Error(String(err)));
+        });
+    });
+}
+/** 把 GraphToolDefinition 转成 AgentTool（共享构造逻辑） */
+function buildAgentTool(tool, onExecute) {
+    return {
+        name: tool.name,
+        label: tool.name,
+        description: tool.description,
+        parameters: tool.parameters,
+        async execute(_toolCallId, params) {
+            const { result } = onExecute(params);
+            return {
+                content: [{ type: 'text', text: '结果已收到。' }],
+                details: result,
+                terminate: true,
+            };
+        },
+    };
+}
+// ========== 内部：创建 Agent ==========
+function createAgent(config, tools = []) {
+    const providerId = 'graph-llm';
+    const apiType = config.apiType ?? 'anthropic-messages';
+    const auth = {
+        apiKey: {
+            name: 'Graph LLM API key',
+            async resolve() {
+                return { auth: { apiKey: config.apiKey }, source: 'graph_config' };
+            },
+        },
+    };
+    const models = createModels();
+    if (apiType === 'anthropic-messages') {
+        const model = {
+            id: config.modelId,
+            name: config.modelId,
+            api: 'anthropic-messages',
+            provider: providerId,
+            baseUrl: config.baseUrl,
+            input: ['text'],
+            cost: { input: 0, output: 0, cacheRead: 0, cacheWrite: 0 },
+            contextWindow: config.contextWindow ?? 200000,
+            maxTokens: config.maxTokens ?? 4096,
+            reasoning: false,
+        };
+        models.setProvider(createProvider({
+            id: providerId,
+            name: 'Graph LLM',
+            baseUrl: config.baseUrl,
+            auth,
+            models: [model],
+            api: anthropicMessagesApi(),
+        }));
+    }
+    else {
+        const model = {
+            id: config.modelId,
+            name: config.modelId,
+            api: 'openai-completions',
+            provider: providerId,
+            baseUrl: config.baseUrl,
+            input: ['text'],
+            cost: { input: 0, output: 0, cacheRead: 0, cacheWrite: 0 },
+            contextWindow: config.contextWindow ?? 200000,
+            maxTokens: config.maxTokens ?? 4096,
+            reasoning: true,
+            compat: config.compat,
+        };
+        models.setProvider(createProvider({
+            id: providerId,
+            name: 'Graph LLM',
+            baseUrl: config.baseUrl,
+            auth,
+            models: [model],
+            api: openAICompletionsApi(),
+        }));
+    }
+    const resolved = models.getModel(providerId, config.modelId);
+    if (!resolved) {
+        throw new Error(`模型 ${config.modelId} 未找到`);
+    }
+    return new Agent({
+        initialState: {
+            systemPrompt: '',
+            model: resolved,
+            tools,
+        },
+        streamFn: models.streamSimple.bind(models),
+    });
+}
+//# sourceMappingURL=graph-agent.js.map

package/dist/server/documents/graph/graph-agent.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"graph-agent.js","sourceRoot":"","sources":["../../../../src/server/documents/graph/graph-agent.ts"],"names":[],"mappings":"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"}

package/dist/server/documents/graph/graph-file.js

@@ -0,0 +1,58 @@
+/** 旧文章缓存 `{ commitId, nodes }` 或新 GraphFile → ArticleGraphFile */
+export function parseArticleGraphFile(raw) {
+    if (!raw || typeof raw !== "object")
+        return null;
+    const o = raw;
+    if (o.meta && typeof o.meta === "object") {
+        const meta = o.meta;
+        if (typeof meta.commitId !== "string")
+            return null;
+        return {
+            version: 1,
+            meta: {
+                commitId: meta.commitId,
+                dirty: meta.dirty === true,
+            },
+            nodes: Array.isArray(o.nodes) ? o.nodes : [],
+            edges: Array.isArray(o.edges) ? o.edges : [],
+        };
+    }
+    // 旧格式
+    if (typeof o.commitId === "string" && Array.isArray(o.nodes)) {
+        return {
+            version: 1,
+            meta: { commitId: o.commitId, dirty: false },
+            nodes: o.nodes,
+            edges: [],
+        };
+    }
+    return null;
+}
+/** 旧目录图 `{ nodes, edges }` 或新 GraphFile → DirGraphFile */
+export function parseDirGraphFile(raw) {
+    if (!raw || typeof raw !== "object")
+        return null;
+    const o = raw;
+    if (!Array.isArray(o.nodes))
+        return null;
+    const edges = Array.isArray(o.edges) ? o.edges : [];
+    if (o.meta && typeof o.meta === "object") {
+        const meta = o.meta;
+        return {
+            version: 1,
+            meta: { dirty: meta.dirty === true },
+            nodes: o.nodes,
+            edges,
+        };
+    }
+    return {
+        version: 1,
+        meta: { dirty: false },
+        nodes: o.nodes,
+        edges,
+    };
+}
+export function graphFileToGraph(file) {
+    return { nodes: file.nodes, edges: file.edges };
+}
+//# sourceMappingURL=graph-file.js.map

package/dist/server/documents/graph/graph-file.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"graph-file.js","sourceRoot":"","sources":["../../../../src/server/documents/graph/graph-file.ts"],"names":[],"mappings":"AAQA,kEAAkE;AAClE,MAAM,UAAU,qBAAqB,CAAC,GAAY;IAChD,IAAI,CAAC,GAAG,IAAI,OAAO,GAAG,KAAK,QAAQ;QAAE,OAAO,IAAI,CAAC;IACjD,MAAM,CAAC,GAAG,GAA8B,CAAC;IAEzC,IAAI,CAAC,CAAC,IAAI,IAAI,OAAO,CAAC,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;QACzC,MAAM,IAAI,GAAG,CAAC,CAAC,IAA+B,CAAC;QAC/C,IAAI,OAAO,IAAI,CAAC,QAAQ,KAAK,QAAQ;YAAE,OAAO,IAAI,CAAC;QACnD,OAAO;YACL,OAAO,EAAE,CAAC;YACV,IAAI,EAAE;gBACJ,QAAQ,EAAE,IAAI,CAAC,QAAQ;gBACvB,KAAK,EAAE,IAAI,CAAC,KAAK,KAAK,IAAI;aAC3B;YACD,KAAK,EAAE,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAE,CAAC,CAAC,KAAqB,CAAC,CAAC,CAAC,EAAE;YAC7D,KAAK,EAAE,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAE,CAAC,CAAC,KAAqB,CAAC,CAAC,CAAC,EAAE;SAC9D,CAAC;IACJ,CAAC;IAED,MAAM;IACN,IAAI,OAAO,CAAC,CAAC,QAAQ,KAAK,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC,EAAE,CAAC;QAC7D,OAAO;YACL,OAAO,EAAE,CAAC;YACV,IAAI,EAAE,EAAE,QAAQ,EAAE,CAAC,CAAC,QAAQ,EAAE,KAAK,EAAE,KAAK,EAAE;YAC5C,KAAK,EAAE,CAAC,CAAC,KAAoB;YAC7B,KAAK,EAAE,EAAE;SACV,CAAC;IACJ,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,0DAA0D;AAC1D,MAAM,UAAU,iBAAiB,CAAC,GAAY;IAC5C,IAAI,CAAC,GAAG,IAAI,OAAO,GAAG,KAAK,QAAQ;QAAE,OAAO,IAAI,CAAC;IACjD,MAAM,CAAC,GAAG,GAA8B,CAAC;IACzC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC;IAEzC,MAAM,KAAK,GAAG,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAE,CAAC,CAAC,KAAqB,CAAC,CAAC,CAAC,EAAE,CAAC;IACrE,IAAI,CAAC,CAAC,IAAI,IAAI,OAAO,CAAC,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;QACzC,MAAM,IAAI,GAAG,CAAC,CAAC,IAA+B,CAAC;QAC/C,OAAO;YACL,OAAO,EAAE,CAAC;YACV,IAAI,EAAE,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,KAAK,IAAI,EAAE;YACpC,KAAK,EAAE,CAAC,CAAC,KAAoB;YAC7B,KAAK;SACN,CAAC;IACJ,CAAC;IACD,OAAO;QACL,OAAO,EAAE,CAAC;QACV,IAAI,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE;QACtB,KAAK,EAAE,CAAC,CAAC,KAAoB;QAC7B,KAAK;KACN,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,IAAgD;IAC/E,OAAO,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,CAAC;AAClD,CAAC"}

package/dist/server/documents/graph/graph-file.test.js

@@ -0,0 +1,28 @@
+import { describe, it, expect } from "vitest";
+import { parseArticleGraphFile, parseDirGraphFile } from "./graph-file.js";
+describe("parseArticleGraphFile", () => {
+    it("升格旧格式", () => {
+        const f = parseArticleGraphFile({
+            commitId: "c1",
+            nodes: [{ id: "doc:a", type: "doc", label: "a", description: "d", confidence: 1, sources: [] }],
+        });
+        expect(f?.meta).toEqual({ commitId: "c1", dirty: false });
+        expect(f?.edges).toEqual([]);
+    });
+    it("读新格式 dirty", () => {
+        const f = parseArticleGraphFile({
+            version: 1,
+            meta: { commitId: "c2", dirty: true },
+            nodes: [],
+            edges: [],
+        });
+        expect(f?.meta.dirty).toBe(true);
+    });
+});
+describe("parseDirGraphFile", () => {
+    it("旧格式默认 dirty false", () => {
+        const f = parseDirGraphFile({ nodes: [], edges: [] });
+        expect(f?.meta.dirty).toBe(false);
+    });
+});
+//# sourceMappingURL=graph-file.test.js.map

package/dist/server/documents/graph/graph-file.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"graph-file.test.js","sourceRoot":"","sources":["../../../../src/server/documents/graph/graph-file.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAC9C,OAAO,EAAE,qBAAqB,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AAE3E,QAAQ,CAAC,uBAAuB,EAAE,GAAG,EAAE;IACrC,EAAE,CAAC,OAAO,EAAE,GAAG,EAAE;QACf,MAAM,CAAC,GAAG,qBAAqB,CAAC;YAC9B,QAAQ,EAAE,IAAI;YACd,KAAK,EAAE,CAAC,EAAE,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,KAAK,EAAE,GAAG,EAAE,WAAW,EAAE,GAAG,EAAE,UAAU,EAAE,CAAC,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC;SAChG,CAAC,CAAC;QACH,MAAM,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC,OAAO,CAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC,CAAC;QAC1D,MAAM,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;IAC/B,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,YAAY,EAAE,GAAG,EAAE;QACpB,MAAM,CAAC,GAAG,qBAAqB,CAAC;YAC9B,OAAO,EAAE,CAAC;YACV,IAAI,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE;YACrC,KAAK,EAAE,EAAE;YACT,KAAK,EAAE,EAAE;SACV,CAAC,CAAC;QACH,MAAM,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACnC,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC;AAEH,QAAQ,CAAC,mBAAmB,EAAE,GAAG,EAAE;IACjC,EAAE,CAAC,mBAAmB,EAAE,GAAG,EAAE;QAC3B,MAAM,CAAC,GAAG,iBAAiB,CAAC,EAAE,KAAK,EAAE,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC,CAAC;QACtD,MAAM,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACpC,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/server/documents/graph/index.js

@@ -0,0 +1,183 @@
+import { makeNodeId, findRootNodes } from './utils.js';
+/** 统计子树中的文章叶子数（用于进度 total） */
+export function countDocumentLeaves(node) {
+    if (node.type === "document")
+        return 1;
+    return node.children.reduce((sum, c) => sum + countDocumentLeaves(c), 0);
+}
+/**
+ * 从根节点构建图谱。
+ * 内部按类型分发到 buildDocumentGraph / buildFolderGraph；递归子节点时复用同一 ProgressCtx。
+ */
+export async function buildGraph(rootNode, deps, options = {}) {
+    // 为本棵树准备进度上下文（子树递归共用 ctx，index 连续递增）
+    const total = options.onArticle && rootNode.type === "folder"
+        ? countDocumentLeaves(rootNode)
+        : rootNode.type === "document"
+            ? 1
+            : countDocumentLeaves(rootNode);
+    const ctx = {
+        total: Math.max(total, 1),
+        index: 0,
+        onArticle: options.onArticle,
+        onFolderPhase: options.onFolderPhase,
+    };
+    if (rootNode.type === "document") {
+        return buildDocumentGraph(rootNode, deps, options, ctx);
+    }
+    return buildFolderGraph(rootNode, deps, options, ctx);
+}
+/** 单篇文章：读缓存或 AI 提取 doc 节点，写文章级 __graph__ 缓存 */
+async function buildDocumentGraph(docNode, deps, options, ctx) {
+    const documentId = docNode.documentId;
+    const docPath = docNode.displayName || docNode.name || docNode.path || documentId;
+    const index = ctx.index;
+    ctx.index += 1;
+    // 干净缓存且非 force → 直接复用
+    const cached = await deps.readArticleCache(documentId);
+    if (!options.force && cached && cached.meta.dirty === false) {
+        await ctx.onArticle?.({
+            phase: "cached",
+            documentId,
+            docPath,
+            index,
+            total: ctx.total,
+            nodesExtracted: cached.nodes.length,
+            durationMs: 0,
+        });
+        return { nodes: cached.nodes, edges: cached.edges };
+    }
+    await ctx.onArticle?.({
+        phase: "start",
+        documentId,
+        docPath,
+        index,
+        total: ctx.total,
+    });
+    const startedAt = Date.now();
+    try {
+        const currentCommitId = await deps.getCurrentCommitId(documentId);
+        const markdown = await deps.readMarkdown(documentId);
+        const stubs = await deps.extractDocNodes(markdown);
+        const docTitle = await deps.getDocTitle(documentId);
+        const nodes = stubs.map((stub) => ({
+            id: makeNodeId("doc", stub.label),
+            type: "doc",
+            label: stub.label,
+            definition: stub.definition,
+            description: stub.description,
+            confidence: stub.confidence,
+            sources: [
+                {
+                    type: "doc",
+                    documentId,
+                    title: docTitle,
+                    heading: stub.heading,
+                },
+            ],
+        }));
+        await deps.writeArticleCache(documentId, {
+            version: 1,
+            meta: { commitId: currentCommitId, dirty: false },
+            nodes,
+            edges: [],
+        });
+        await ctx.onArticle?.({
+            phase: "done",
+            documentId,
+            docPath,
+            index,
+            total: ctx.total,
+            nodesExtracted: nodes.length,
+            durationMs: Date.now() - startedAt,
+        });
+        return { nodes, edges: [] };
+    }
+    catch (err) {
+        await ctx.onArticle?.({
+            phase: "failed",
+            documentId,
+            docPath,
+            index,
+            total: ctx.total,
+            durationMs: Date.now() - startedAt,
+            error: err?.message ?? String(err),
+        });
+        throw err;
+    }
+}
+/**
+ * 目录：后序处理子节点，再对本层做归纳并写 ___graph___.json。
+ * 子节点通过 buildGraphWithCtx 复用同一 ProgressCtx（文章序号不重置）。
+ */
+async function buildFolderGraph(folderNode, deps, options, ctx) {
+    // 目录级干净缓存且非 force → 整包返回（子文章不会再走 onArticle）
+    if (!options.force) {
+        const cached = await deps.readDirGraph(folderNode.documentId);
+        if (cached && cached.meta.dirty === false) {
+            return { nodes: cached.nodes, edges: cached.edges };
+        }
+    }
+    const childGraphs = [];
+    for (const child of folderNode.children) {
+        childGraphs.push(await buildGraphWithCtx(child, deps, options, ctx));
+    }
+    const folderPath = folderNode.path || folderNode.name;
+    await ctx.onFolderPhase?.({
+        phase: "induce",
+        folderId: folderNode.documentId,
+        folderPath,
+    });
+    const result = await aggregateAndInduce(childGraphs, deps);
+    await ctx.onFolderPhase?.({
+        phase: "write",
+        folderId: folderNode.documentId,
+        folderPath,
+    });
+    await deps.writeDirGraph(folderNode.documentId, {
+        version: 1,
+        meta: { dirty: false },
+        nodes: result.nodes,
+        edges: result.edges,
+    });
+    return result;
+}
+/** 递归时复用同一 ProgressCtx，避免子树重新从 0 计数 */
+async function buildGraphWithCtx(rootNode, deps, options, ctx) {
+    if (rootNode.type === "document") {
+        return buildDocumentGraph(rootNode, deps, options, ctx);
+    }
+    return buildFolderGraph(rootNode, deps, options, ctx);
+}
+export async function aggregateAndInduce(childGraphs, deps) {
+    const allNodes = childGraphs.flatMap((g) => g.nodes);
+    const allEdges = childGraphs.flatMap((g) => g.edges);
+    const topLevelNodes = findRootNodes(allNodes, allEdges);
+    const conceptStubs = await deps.induceConceptNodes(topLevelNodes.map((n) => ({ label: n.label, description: n.description })));
+    const newConcepts = conceptStubs.map((stub) => ({
+        id: makeNodeId('concept', stub.label),
+        type: 'concept',
+        label: stub.label,
+        definition: stub.definition,
+        description: stub.description,
+        confidence: stub.confidence,
+    }));
+    const nodesForContains = [...topLevelNodes, ...newConcepts];
+    const containsEdges = await deps.generateContains(nodesForContains);
+    let conceptRelationEdges = [];
+    if (newConcepts.length >= 2) {
+        const stubs = await deps.induceConceptRelations(newConcepts);
+        conceptRelationEdges = stubs.map((r) => ({
+            from: r.fromId,
+            to: r.toId,
+            type: r.type,
+            confidence: r.confidence,
+            description: r.description,
+        }));
+    }
+    return {
+        nodes: [...allNodes, ...newConcepts],
+        edges: [...allEdges, ...containsEdges, ...conceptRelationEdges],
+    };
+}
+//# sourceMappingURL=index.js.map

package/dist/server/documents/graph/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/server/documents/graph/index.ts"],"names":[],"mappings":"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"}