@itradingai/aiwiki 0.2.10 → 0.2.11

package/dist/src/ingest.js

@@ -4,6 +4,7 @@ import { randomBytes } from "node:crypto";
 import { normalizePayload } from "./payload.js";
 import { appendRunIdBeforeExt, relativePath, safeJoin, slugify } from "./paths.js";
 import { initWorkspace } from "./workspace.js";
+import { renderWikiEntry } from "./wiki-entry.js";
 export async function ingestPayload(rootPath, rawPayload) {
     await initWorkspace(rootPath);
     const root = path.resolve(rootPath);
@@ -29,11 +30,14 @@ export async function ingestPayload(rootPath, rawPayload) {
     const links = buildArtifactLinks(root, slug, runDirName, runStartedAt, longTermTargets);
     await writeFile(path.join(runDir, "raw.md"), contentFile(payload, content, links), generatedFiles);
     await writeFile(path.join(runDir, "source-card.md"), sourceCard(payload, runDirName, links), generatedFiles);
+    const wikiEntryResult = renderWikiEntry(payload, links);
+    await writeFile(path.join(runDir, "wiki-entry.md"), wikiEntryResult.markdown, generatedFiles);
     await writeFile(path.join(runDir, "creative-assets.md"), creativeAssets(payload, links), generatedFiles);
     await writeFile(path.join(runDir, "topics.md"), topics(payload, links), generatedFiles);
     await writeFile(path.join(runDir, "draft-outline.md"), outline(payload, links), generatedFiles);
     await writeFile(longTermTargets.raw, contentFile(payload, content, links), generatedFiles);
     await writeFile(longTermTargets.sourceCard, sourceCard(payload, runDirName, links), generatedFiles);
+    await writeFile(longTermTargets.wikiEntry, wikiEntryResult.markdown, generatedFiles);
     await writeFile(longTermTargets.claims, claims(payload, links), generatedFiles);
     await writeFile(longTermTargets.assets, creativeAssets(payload, links), generatedFiles);
     await writeFile(longTermTargets.topics, topics(payload, links), generatedFiles);
@@ -72,6 +76,7 @@ async function chooseLongTermTargets(root, slug, runId, warnings) {
     return {
         raw: await chooseLongTermTarget(root, "02-raw/articles", `${slug}.md`, runId, warnings),
         sourceCard: await chooseLongTermTarget(root, "03-sources/article-cards", `${slug}.md`, runId, warnings),
+        wikiEntry: await chooseLongTermTarget(root, "05-wiki/source-knowledge", `${slug}.md`, runId, warnings),
         claims: await chooseLongTermTarget(root, "04-claims/_suggestions", `${slug}-claims.md`, runId, warnings),
         assets: await chooseLongTermTarget(root, "06-assets/_suggestions", `${slug}-assets.md`, runId, warnings),
         topics: await chooseLongTermTarget(root, "07-topics/ready", `${slug}-topics.md`, runId, warnings),
@@ -168,6 +173,7 @@ function contentFile(payload, content, links) {
         "",
         "## AIWiki 链接",
         "",
+        `- Wiki 条目：${obsidianLink(links.wikiEntry, "Wiki 条目")}`,
         `- 资料卡：${obsidianLink(links.sourceCard, "资料卡")}`,
         `- 处理记录：${obsidianLink(links.runSummary, "处理记录")}`,
         "",
@@ -199,6 +205,7 @@ function sourceCard(payload, runId, links) {
         "",
         "## Obsidian 链接",
         "",
+        `- Wiki 条目：${obsidianLink(links.wikiEntry, "Wiki 条目")}`,
         `- 原文：${obsidianLink(links.raw, "原文")}`,
         `- Claim 建议：${obsidianLink(links.claims, "Claim 建议")}`,
         `- 素材建议：${obsidianLink(links.assets, "素材建议")}`,
@@ -231,6 +238,7 @@ function claims(payload, links) {
         "",
         "# Claim 建议",
         "",
+        `- Wiki 条目：${obsidianLink(links.wikiEntry, "Wiki 条目")}`,
         `- 资料卡：${obsidianLink(links.sourceCard, "资料卡")}`,
         `- 原文：${obsidianLink(links.raw, "原文")}`,
         `- 待人工审阅：${payload.source.title ?? "Untitled"}`,
@@ -256,6 +264,7 @@ function creativeAssets(payload, links) {
         "",
         "# 素材建议",
         "",
+        `- Wiki 条目：${obsidianLink(links.wikiEntry, "Wiki 条目")}`,
         `- 资料卡：${obsidianLink(links.sourceCard, "资料卡")}`,
         `- 原文：${obsidianLink(links.raw, "原文")}`,
         `- 可复用素材：${payload.source.title ?? "Untitled"}`,
@@ -281,6 +290,7 @@ function topics(payload, links) {
         "",
         "# 选题候选",
         "",
+        `- Wiki 条目：${obsidianLink(links.wikiEntry, "Wiki 条目")}`,
         `- 资料卡：${obsidianLink(links.sourceCard, "资料卡")}`,
         `- 大纲：${obsidianLink(links.outline, "大纲")}`,
         `- ${payload.source.title ?? "Untitled"}`,
@@ -306,6 +316,7 @@ function outline(payload, links) {
         "",
         "# 草稿大纲",
         "",
+        `Wiki 条目：${obsidianLink(links.wikiEntry, "Wiki 条目")}`,
         `资料卡：${obsidianLink(links.sourceCard, "资料卡")}`,
         `原文：${obsidianLink(links.raw, "原文")}`,
         "",
@@ -334,11 +345,14 @@ function buildAgentReport(root, runDir, payload, generatedFiles) {
         summary: fetchFailed ? (payload.source.fetch_notes ?? "宿主 Agent 没有提供可读正文。") : summarizeContent(content),
         keyFiles: {
             processingSummary: relativePath(root, path.join(runDir, "processing-summary.md")),
+            wikiEntry: findGeneratedFileInDir(root, generatedFiles, "05-wiki/source-knowledge"),
             sourceCard: findGeneratedFileInDir(root, generatedFiles, "03-sources/article-cards"),
             draftOutline: findGeneratedFile(root, generatedFiles, "draft-outline.md"),
             dashboard: "dashboards/AIWiki Home.md",
             reviewQueue: "dashboards/Review Queue.md"
-        }
+        },
+        wikiEntryGenerationMode: fetchFailed ? undefined : (payload.wiki_entry || payload.analysis ? "agent_enriched" : "deterministic_fallback"),
+        wikiEntryQuality: fetchFailed ? undefined : (payload.wiki_entry || payload.analysis ? "enriched" : "scaffold")
     };
 }
 function estimateFitScore(payload, content) {
@@ -394,6 +408,7 @@ function buildArtifactLinks(root, slug, runDirName, createdAt, longTermTargets)
         createdAt,
         raw: relativePath(root, longTermTargets.raw),
         sourceCard: relativePath(root, longTermTargets.sourceCard),
+        wikiEntry: relativePath(root, longTermTargets.wikiEntry),
         claims: relativePath(root, longTermTargets.claims),
         assets: relativePath(root, longTermTargets.assets),
         topics: relativePath(root, longTermTargets.topics),
@@ -403,6 +418,7 @@ function buildArtifactLinks(root, slug, runDirName, createdAt, longTermTargets)
 }
 function relationshipFrontmatter(links) {
     return [
+        `wiki_entry: "${escapeYaml(obsidianLink(links.wikiEntry, "Wiki 条目"))}"`,
         `source_card: "${escapeYaml(obsidianLink(links.sourceCard, "资料卡"))}"`,
         `raw_note: "${escapeYaml(obsidianLink(links.raw, "原文"))}"`,
         `claims_note: "${escapeYaml(obsidianLink(links.claims, "Claim 建议"))}"`,

package/dist/src/lint.js

@@ -0,0 +1,188 @@
+import { promises as fs } from "node:fs";
+import path from "node:path";
+import { frontmatterBoolean, frontmatterString, parseMarkdown } from "./frontmatter.js";
+import { relativePath, safeJoin } from "./paths.js";
+import { exists } from "./workspace.js";
+export async function lintWorkspace(rootPath, now = new Date().toISOString()) {
+    const root = path.resolve(rootPath);
+    const wikiEntries = await readNotes(root, "05-wiki/source-knowledge");
+    const sourceCards = await readNotes(root, "03-sources/article-cards");
+    const rawFiles = await readNotes(root, "02-raw/articles");
+    const runs = await runDirs(root);
+    const allNotes = [
+        ...wikiEntries,
+        ...sourceCards,
+        ...rawFiles,
+        ...await readNotes(root, "04-claims/_suggestions"),
+        ...await readNotes(root, "06-assets/_suggestions"),
+        ...await readNotes(root, "07-topics/ready"),
+        ...await readNotes(root, "08-outputs/outlines")
+    ];
+    const issues = [];
+    const wikiSourceCards = new Set(wikiEntries.map((note) => frontmatterString(note.frontmatter, "source_card")).filter(Boolean));
+    for (const card of sourceCards) {
+        if (!wikiSourceCards.has(card.path)) {
+            issues.push({
+                severity: "warning",
+                path: card.path,
+                message: "Source Card 没有对应 Wiki Entry。",
+                suggestion: `重新入库或生成 05-wiki/source-knowledge/${path.basename(card.path)}`
+            });
+        }
+    }
+    for (const entry of wikiEntries) {
+        const sourceCard = frontmatterString(entry.frontmatter, "source_card");
+        const rawFile = frontmatterString(entry.frontmatter, "raw_file");
+        const mode = frontmatterString(entry.frontmatter, "generation_mode");
+        if (!sourceCard) {
+            issues.push({ severity: "warning", path: entry.path, message: "Wiki Entry 缺少 source_card。", suggestion: "补写 source_card vault 路径。" });
+        }
+        if (!rawFile) {
+            issues.push({ severity: "warning", path: entry.path, message: "Wiki Entry 缺少 raw_file。", suggestion: "补写 raw_file vault 路径。" });
+        }
+        if (mode === "deterministic_fallback") {
+            issues.push({ severity: "info", path: entry.path, message: "Wiki Entry 是 deterministic fallback，仅包含来源和正文预览。", suggestion: "让宿主 Agent 基于原文补充 analysis 或 wiki_entry。" });
+            const createdAt = Date.parse(frontmatterString(entry.frontmatter, "created_at") ?? "");
+            if (Number.isFinite(createdAt) && Date.parse(now) - createdAt > 7 * 24 * 60 * 60 * 1000) {
+                issues.push({ severity: "warning", path: entry.path, message: "fallback Wiki Entry 超过 7 天未补全。", suggestion: "重新运行宿主 Agent 生成 enriched Wiki Entry。" });
+            }
+        }
+        if (mode === "agent_enriched") {
+            const hasSummary = /## 一句话总结/.test(entry.body) || Boolean(frontmatterString(entry.frontmatter, "summary"));
+            const hasKeyPoints = /## 核心观点[\s\S]*-\s+/.test(entry.body);
+            if (!hasSummary) {
+                issues.push({ severity: "warning", path: entry.path, message: "agent_enriched Wiki Entry 缺少 summary。", suggestion: "让宿主 Agent 提供 analysis.summary。" });
+            }
+            if (!hasKeyPoints) {
+                issues.push({ severity: "warning", path: entry.path, message: "agent_enriched Wiki Entry 缺少 key_points。", suggestion: "让宿主 Agent 提供 analysis.key_points。" });
+            }
+        }
+        if (frontmatterBoolean(entry.frontmatter, "represents_user_view") === true && frontmatterString(entry.frontmatter, "source_role") === "input") {
+            issues.push({ severity: "warning", path: entry.path, message: "外部 input 被标记为代表用户观点。", suggestion: "将 represents_user_view 改为 false，或在 P1 使用 source_role=output。" });
+        }
+    }
+    issues.push(...duplicateIssues(sourceCards, "source_url", "重复 URL"));
+    issues.push(...duplicateTitles(allNotes));
+    issues.push(...brokenLinkIssues(root, allNotes));
+    return {
+        generated_at: now,
+        summary: {
+            wiki_entries: wikiEntries.length,
+            source_cards: sourceCards.length,
+            raw_files: rawFiles.length,
+            runs: runs.length
+        },
+        issues
+    };
+}
+export async function writeLintReport(rootPath, report) {
+    const root = path.resolve(rootPath);
+    const target = safeJoin(root, "dashboards", "Lint Report.md");
+    await fs.mkdir(path.dirname(target), { recursive: true });
+    await fs.writeFile(target, renderLintReport(report), "utf8");
+    return relativePath(root, target);
+}
+export function renderLintReport(report) {
+    return [
+        "# AIWiki Lint Report",
+        "",
+        `Generated at: ${report.generated_at}`,
+        "",
+        "## Summary",
+        "",
+        `- Wiki Entries: ${report.summary.wiki_entries}`,
+        `- Source Cards: ${report.summary.source_cards}`,
+        `- Raw Files: ${report.summary.raw_files}`,
+        `- Runs: ${report.summary.runs}`,
+        "",
+        "## Issues",
+        "",
+        ...(report.issues.length ? report.issues.map((issue) => {
+            const suffix = issue.path ? ` (${issue.path})` : "";
+            const suggestion = issue.suggestion ? `\n  - Suggested Fix: ${issue.suggestion}` : "";
+            return `- [${issue.severity}] ${issue.message}${suffix}${suggestion}`;
+        }) : ["- none"]),
+        ""
+    ].join("\n");
+}
+async function readNotes(root, dir) {
+    const absolute = path.join(root, dir);
+    if (!(await exists(absolute))) {
+        return [];
+    }
+    const files = await listMarkdownFiles(absolute);
+    return Promise.all(files.map(async (file) => {
+        const text = await fs.readFile(file, "utf8");
+        const parsed = parseMarkdown(text);
+        return {
+            path: relativePath(root, file),
+            title: frontmatterString(parsed.frontmatter, "title") ?? path.basename(file, ".md"),
+            sourceUrl: frontmatterString(parsed.frontmatter, "source_url") ?? "",
+            body: parsed.body,
+            frontmatter: parsed.frontmatter
+        };
+    }));
+}
+async function runDirs(root) {
+    const dir = path.join(root, "09-runs");
+    if (!(await exists(dir))) {
+        return [];
+    }
+    return (await fs.readdir(dir, { withFileTypes: true })).filter((entry) => entry.isDirectory()).map((entry) => entry.name);
+}
+async function listMarkdownFiles(dir) {
+    const entries = await fs.readdir(dir, { withFileTypes: true });
+    const files = [];
+    for (const entry of entries) {
+        const target = path.join(dir, entry.name);
+        if (entry.isDirectory()) {
+            files.push(...await listMarkdownFiles(target));
+        }
+        else if (entry.isFile() && entry.name.toLowerCase().endsWith(".md")) {
+            files.push(target);
+        }
+    }
+    return files;
+}
+function duplicateIssues(notes, field, label) {
+    const seen = new Map();
+    for (const note of notes) {
+        const value = field === "source_url" ? note.sourceUrl : "";
+        if (!value) {
+            continue;
+        }
+        seen.set(value, [...(seen.get(value) ?? []), note.path]);
+    }
+    return Array.from(seen.entries()).flatMap(([value, paths]) => paths.length > 1
+        ? [{ severity: "warning", message: `${label}: ${value}`, suggestion: paths.join(", ") }]
+        : []);
+}
+function duplicateTitles(notes) {
+    const seen = new Map();
+    for (const note of notes) {
+        if (!note.title) {
+            continue;
+        }
+        seen.set(note.title, [...(seen.get(note.title) ?? []), note.path]);
+    }
+    return Array.from(seen.entries()).flatMap(([title, paths]) => paths.length > 1
+        ? [{ severity: "info", message: `重复标题: ${title}`, suggestion: paths.join(", ") }]
+        : []);
+}
+function brokenLinkIssues(root, notes) {
+    const existing = new Set(notes.map((note) => note.path.replace(/\.md$/i, "")));
+    const issues = [];
+    for (const note of notes) {
+        for (const link of note.body.matchAll(/\[\[([^\]|]+)(?:\|[^\]]+)?\]\]/g)) {
+            const target = link[1].replace(/\\/g, "/").replace(/\.md$/i, "");
+            if (!existing.has(target) && !isRunLocalLink(target)) {
+                issues.push({ severity: "error", path: note.path, message: `内部链接断裂: ${target}`, suggestion: "检查目标文件是否存在或更新 wikilink。" });
+            }
+        }
+    }
+    return issues;
+}
+function isRunLocalLink(target) {
+    // Run-local notes are valid trace links but are not part of the long-term note set.
+    return target.startsWith("09-runs/");
+}

package/dist/src/payload.js

@@ -39,8 +39,8 @@ export function normalizePayload(raw, runStartedAt) {
     const requestedOutputs = Array.isArray(requestRaw.outputs)
         ? requestRaw.outputs.filter((item) => typeof item === "string")
         : ["source_card", "creative_assets", "topics", "draft_outline", "processing_summary"];
-    const outputs = ["source_card", "creative_assets", "topics", "draft_outline", "processing_summary"];
-    if (fetchStatus !== "failed" && requestedOutputs.length && requestedOutputs.length !== outputs.length) {
+    const outputs = ["source_card", "wiki_entry", "creative_assets", "topics", "draft_outline", "processing_summary"];
+    if (fetchStatus !== "failed" && requestedOutputs.length && hasCustomOutputRequest(requestedOutputs)) {
         warnings.push("AIWiki 会为每条输入生成完整资料产物，request.outputs 已按全量输出处理。");
     }
     if (typeof raw.target_kb === "string" && raw.target_kb.trim()) {
@@ -55,6 +55,8 @@ export function normalizePayload(raw, runStartedAt) {
     if (fetchNotesRepair.repaired) {
         warnings.push("source.fetch_notes 检测到疑似 UTF-8 mojibake，已自动修复。");
     }
+    const analysis = normalizeAnalysis(raw.analysis, warnings);
+    const wikiEntry = normalizeWikiEntry(raw.wiki_entry, warnings);
     if (fetchStatus === "failed" && content?.trim()) {
         throw new Error("source.content must be empty when source.fetch_status is failed");
     }
@@ -80,6 +82,8 @@ export function normalizePayload(raw, runStartedAt) {
             outputs,
             language: stringValue(requestRaw.language) ?? stringValue(sourceRaw.language)
         },
+        analysis,
+        wiki_entry: wikiEntry,
         warnings
     };
 }
@@ -99,6 +103,9 @@ function rejectWriteControlFields(raw) {
     if (typeof raw.output_file === "string") {
         throw new Error("payload must not control output paths");
     }
+    if (isRecord(raw.wiki_entry) && typeof raw.wiki_entry.path === "string") {
+        throw new Error("payload must not control output paths");
+    }
 }
 function stringValue(value) {
     return typeof value === "string" ? value : undefined;
@@ -106,3 +113,137 @@ function stringValue(value) {
 function isRecord(value) {
     return typeof value === "object" && value !== null && !Array.isArray(value);
 }
+function normalizeAnalysis(value, warnings) {
+    if (value === undefined) {
+        return undefined;
+    }
+    if (!isRecord(value)) {
+        warnings.push("analysis 已忽略：必须是对象。");
+        return undefined;
+    }
+    const analysis = {
+        summary: stringValue(value.summary),
+        key_points: stringArray(value.key_points, "analysis.key_points", warnings),
+        reusable_knowledge: reusableKnowledgeArray(value.reusable_knowledge, warnings),
+        related_concepts: stringArray(value.related_concepts, "analysis.related_concepts", warnings),
+        use_cases: stringArray(value.use_cases, "analysis.use_cases", warnings),
+        topic_candidates: stringArray(value.topic_candidates, "analysis.topic_candidates", warnings),
+        claims: claimsArray(value.claims, warnings),
+        outline: outlineValue(value.outline, warnings)
+    };
+    return hasAnalysisContent(analysis) ? analysis : undefined;
+}
+function normalizeWikiEntry(value, warnings) {
+    if (value === undefined) {
+        return undefined;
+    }
+    if (!isRecord(value)) {
+        warnings.push("wiki_entry 已忽略：必须是对象。");
+        return undefined;
+    }
+    const entry = {
+        title: stringValue(value.title),
+        summary: stringValue(value.summary),
+        sections: wikiSections(value.sections, warnings),
+        markdown: stringValue(value.markdown)
+    };
+    return entry.title || entry.summary || entry.sections.length || entry.markdown ? entry : undefined;
+}
+function stringArray(value, field, warnings) {
+    if (value === undefined) {
+        return [];
+    }
+    if (!Array.isArray(value)) {
+        warnings.push(`${field} 已忽略：必须是字符串数组。`);
+        return [];
+    }
+    return value.filter((item) => typeof item === "string" && item.trim().length > 0);
+}
+function reusableKnowledgeArray(value, warnings) {
+    if (value === undefined) {
+        return [];
+    }
+    if (!Array.isArray(value)) {
+        warnings.push("analysis.reusable_knowledge 已忽略：必须是数组。");
+        return [];
+    }
+    return value.flatMap((item) => {
+        if (typeof item === "string" && item.trim()) {
+            return [{ content: item.trim() }];
+        }
+        if (isRecord(item) && typeof item.content === "string" && item.content.trim()) {
+            return [{ title: stringValue(item.title), content: item.content.trim() }];
+        }
+        return [];
+    });
+}
+function claimsArray(value, warnings) {
+    if (value === undefined) {
+        return [];
+    }
+    if (!Array.isArray(value)) {
+        warnings.push("analysis.claims 已忽略：必须是数组。");
+        return [];
+    }
+    return value.flatMap((item) => {
+        if (typeof item === "string" && item.trim()) {
+            return [{ claim: item.trim() }];
+        }
+        if (isRecord(item) && typeof item.claim === "string" && item.claim.trim()) {
+            return [{
+                    claim: item.claim.trim(),
+                    confidence: stringValue(item.confidence),
+                    source_quote: stringValue(item.source_quote)
+                }];
+        }
+        return [];
+    });
+}
+function outlineValue(value, warnings) {
+    if (value === undefined) {
+        return undefined;
+    }
+    if (!isRecord(value)) {
+        warnings.push("analysis.outline 已忽略：必须是对象。");
+        return undefined;
+    }
+    const sections = stringArray(value.sections, "analysis.outline.sections", warnings);
+    if (!sections.length && !stringValue(value.title)) {
+        return undefined;
+    }
+    return { title: stringValue(value.title), sections };
+}
+function wikiSections(value, warnings) {
+    if (value === undefined) {
+        return [];
+    }
+    if (!Array.isArray(value)) {
+        warnings.push("wiki_entry.sections 已忽略：必须是数组。");
+        return [];
+    }
+    return value.flatMap((item) => {
+        if (!isRecord(item) || typeof item.heading !== "string" || !item.heading.trim()) {
+            return [];
+        }
+        return [{
+                heading: item.heading.trim(),
+                items: stringArray(item.items, "wiki_entry.sections.items", warnings)
+            }];
+    });
+}
+function hasAnalysisContent(analysis) {
+    return Boolean(analysis.summary ||
+        analysis.key_points.length ||
+        analysis.reusable_knowledge.length ||
+        analysis.related_concepts.length ||
+        analysis.use_cases.length ||
+        analysis.topic_candidates.length ||
+        analysis.claims.length ||
+        analysis.outline);
+}
+function hasCustomOutputRequest(outputs) {
+    const legacyDefault = ["source_card", "creative_assets", "topics", "draft_outline", "processing_summary"];
+    const currentDefault = ["source_card", "wiki_entry", "creative_assets", "topics", "draft_outline", "processing_summary"];
+    const sameSet = (left, right) => left.length === right.length && left.every((item) => right.includes(item));
+    return !sameSet(outputs, legacyDefault) && !sameSet(outputs, currentDefault);
+}

package/dist/src/wiki-entry.js

@@ -0,0 +1,151 @@
+export function renderWikiEntry(payload, links) {
+    const enriched = Boolean(payload.wiki_entry || payload.analysis);
+    const mode = enriched ? "agent_enriched" : "deterministic_fallback";
+    const quality = enriched ? "enriched" : "scaffold";
+    const title = payload.wiki_entry?.title ?? payload.source.title ?? "Untitled";
+    const frontmatter = wikiFrontmatter(payload, links, title, mode, quality);
+    const body = enriched ? enrichedBody(payload, links, title) : fallbackBody(payload, links, title);
+    return {
+        mode,
+        quality,
+        markdown: `${frontmatter}\n${body}`
+    };
+}
+function wikiFrontmatter(payload, links, title, mode, quality) {
+    return [
+        "---",
+        `aiwiki_id: "${escapeYaml(`${links.slug}:wiki-entry`)}"`,
+        `type: "wiki_entry"`,
+        `wiki_type: "source_knowledge"`,
+        `source_role: "input"`,
+        `represents_user_view: false`,
+        `status: "active"`,
+        `generation_mode: "${mode}"`,
+        `quality: "${quality}"`,
+        `generated_by: "${mode === "agent_enriched" ? "host_agent" : "aiwiki_cli"}"`,
+        `llm_enriched: ${mode === "agent_enriched" ? "true" : "false"}`,
+        `title: "${escapeYaml(title)}"`,
+        `slug: "${escapeYaml(links.slug)}"`,
+        `source_url: "${escapeYaml(payload.source.url ?? "")}"`,
+        `source_type: "${escapeYaml(payload.source.kind)}"`,
+        `source_card: "${escapeYaml(links.sourceCard)}"`,
+        `raw_file: "${escapeYaml(links.raw)}"`,
+        `claims_file: "${escapeYaml(links.claims)}"`,
+        `topics_file: "${escapeYaml(links.topics)}"`,
+        `outline_file: "${escapeYaml(links.outline)}"`,
+        `run_summary: "${escapeYaml(links.runSummary)}"`,
+        `run_id: "${escapeYaml(links.runId)}"`,
+        `created_at: "${escapeYaml(links.createdAt)}"`,
+        `updated_at: "${escapeYaml(links.createdAt)}"`,
+        ...(mode === "agent_enriched" ? [`summary: "${escapeYaml(payload.wiki_entry?.summary ?? payload.analysis?.summary ?? "")}"`] : []),
+        `topics: ${yamlStringArray(payload.analysis?.related_concepts ?? [])}`,
+        `claims: ${yamlStringArray(payload.analysis?.claims.map((claim) => claim.claim) ?? [])}`,
+        `tags: ["aiwiki/wiki-entry"]`,
+        "---"
+    ].join("\n");
+}
+function enrichedBody(payload, links, title) {
+    const sections = [`# ${title}`, ""];
+    if (payload.wiki_entry?.summary || payload.analysis?.summary) {
+        sections.push("## 一句话总结", "", payload.wiki_entry?.summary ?? payload.analysis?.summary ?? "", "");
+    }
+    if (payload.wiki_entry?.markdown?.trim()) {
+        sections.push(payload.wiki_entry.markdown.trim(), "");
+        if (payload.wiki_entry.sections.length) {
+            for (const section of payload.wiki_entry.sections) {
+                if (bodyHasHeading(payload.wiki_entry.markdown, section.heading)) {
+                    continue;
+                }
+                sections.push(`## ${section.heading}`, "", ...listOrFallback(section.items, "待宿主 Agent 补充。"), "");
+            }
+        }
+        sections.push(sourceSection(links));
+        return sections.join("\n");
+    }
+    if (payload.wiki_entry?.sections.length) {
+        for (const section of payload.wiki_entry.sections) {
+            sections.push(`## ${section.heading}`, "", ...listOrFallback(section.items, "待宿主 Agent 补充。"), "");
+        }
+    }
+    else {
+        sections.push("## 核心观点", "", ...listOrFallback(payload.analysis?.key_points ?? [], "待宿主 Agent 补充。"), "");
+        sections.push("## 可复用知识点", "", ...knowledgeList(payload), "");
+        sections.push("## 相关概念", "", ...listOrFallback(payload.analysis?.related_concepts ?? [], "待宿主 Agent 补充。"), "");
+        sections.push("## 适合用于什么场景", "", ...listOrFallback(payload.analysis?.use_cases ?? [], "待宿主 Agent 补充。"), "");
+        sections.push("## 可转化的选题", "", ...listOrFallback(payload.analysis?.topic_candidates ?? [], "待宿主 Agent 补充。"), "");
+    }
+    sections.push(sourceSection(links));
+    return sections.join("\n");
+}
+function bodyHasHeading(markdown, heading) {
+    const escaped = heading.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+    return new RegExp(`^#{1,6}\\s+${escaped}\\s*$`, "m").test(markdown);
+}
+function fallbackBody(payload, links, title) {
+    const preview = trimPreview(payload.source.content ?? payload.source.fetch_notes ?? "", 1000);
+    return [
+        `# ${title}`,
+        "",
+        "## 说明",
+        "",
+        "这是 AIWiki 根据原文和元数据生成的基础 Wiki 条目。当前条目未经过宿主 Agent 的深度分析，仅用于建立知识库索引、来源追踪和后续 Query。",
+        "",
+        "## 来源信息",
+        "",
+        `- 原文链接：${payload.source.url ?? "无"}`,
+        `- Source Card：${obsidianLink(links.sourceCard, "资料卡")}`,
+        `- Raw：${obsidianLink(links.raw, "原文")}`,
+        `- Run：${obsidianLink(links.runSummary, "处理记录")}`,
+        "",
+        "## 内容预览",
+        "",
+        preview ? blockquote(preview) : "暂无可用正文预览。",
+        "",
+        "## 待 Agent 补全",
+        "",
+        "以下内容需要宿主 Agent 基于原文进一步生成：",
+        "",
+        "- 一句话总结",
+        "- 核心观点",
+        "- 可复用知识点",
+        "- 相关概念",
+        "- 适用场景",
+        "- 可转化选题",
+        "",
+        sourceSection(links)
+    ].join("\n");
+}
+function knowledgeList(payload) {
+    const items = payload.analysis?.reusable_knowledge ?? [];
+    if (!items.length) {
+        return ["待宿主 Agent 补充。"];
+    }
+    return items.flatMap((item) => item.title ? [`### ${item.title}`, "", item.content] : [`- ${item.content}`]);
+}
+function listOrFallback(values, fallback) {
+    return values.length ? values.map((value) => `- ${value}`) : [fallback];
+}
+function sourceSection(links) {
+    return [
+        "## 来源",
+        "",
+        `- Source Card: ${obsidianLink(links.sourceCard, "资料卡")}`,
+        `- Raw: ${obsidianLink(links.raw, "原文")}`,
+        `- Run: ${obsidianLink(links.runSummary, "处理记录")}`
+    ].join("\n");
+}
+function obsidianLink(vaultPath, label) {
+    return `[[${vaultPath.replace(/\\/g, "/").replace(/\.md$/i, "")}|${label}]]`;
+}
+function blockquote(value) {
+    return value.split(/\r?\n/).map((line) => `> ${line}`).join("\n");
+}
+function trimPreview(value, length) {
+    return value.replace(/\s+/g, " ").trim().slice(0, length);
+}
+function yamlStringArray(values) {
+    return `[${values.map((value) => `"${escapeYaml(value)}"`).join(", ")}]`;
+}
+function escapeYaml(value) {
+    return value.replace(/\\/g, "\\\\").replace(/"/g, '\\"');
+}

package/dist/src/workspace.js

@@ -10,6 +10,7 @@ export const REQUIRED_DIRS = [
     "03-sources/article-cards",
     "04-claims/_suggestions",
     "05-wiki",
+    "05-wiki/source-knowledge",
     "06-assets/_suggestions",
     "07-topics/ready",
     "08-outputs/outlines",