@itradingai/aiwiki 0.2.18 → 0.2.20

package/README.md

@@ -23,7 +23,7 @@ AIWiki 是一个开源的 Agent-first 本地 LLM-wiki CLI。
 用户给 URL / 正文 / 文件
   -> 宿主 Agent 读取内容并尽量生成 analysis / wiki_entry
   -> aiwiki ingest-agent --stdin
-  -> AIWiki 写入 Raw / Source Card / Wiki Entry / Claim / Topic / Outline / Run Log
+  -> AIWiki 写入 Raw / Source Card / Wiki Entry / Run Summary；有明确内容或请求时再写 Claim / Topic / Outline / Asset
 ```
 
 ### Query：从 Wiki 调度知识
@@ -43,6 +43,15 @@ aiwiki lint
 
 `lint` 会检查缺失链接、重复来源、fallback Wiki 条目、enriched 条目缺字段等问题，并写入 `dashboards/Lint Report.md`。
 
+## 示例
+
+仓库内置了一个由当前 CLI 重新生成的样例：
+
+- `examples/demo-run/`：输入材料、执行命令和关键 CLI 输出。
+- `examples/obsidian-vault-sample/`：可直接查看的样例知识库。
+
+样例展示了核心产物优先的约定：Raw、Source Card、Wiki Entry、Run Summary、Processing Summary 总是最先检查；Claim、Asset、Topic、Outline 只在 payload 有对应内容或明确请求时出现。
+
 ## 快速开始
 
 ### 第一步：安装 AIWiki CLI
@@ -55,7 +64,7 @@ aiwiki lint
 我的知识库路径：F:\knowledges
 
 请检查 Node.js >=20，执行 aiwiki setup --path "我的知识库路径" --yes，
-然后运行 aiwiki agent list / aiwiki agent install 完成宿主 Agent 对接。
+然后运行 aiwiki agent sync --yes 和 aiwiki agent check --json 完成宿主 Agent 对接。
 最后执行 aiwiki doctor 和 aiwiki status，告诉我实际执行了哪些命令和还差什么手动步骤。
 ```
 
@@ -63,16 +72,15 @@ aiwiki lint
 
 ```bash
 npx @itradingai/aiwiki@latest setup
-aiwiki agent list
-aiwiki agent install
+aiwiki agent sync --yes
+aiwiki agent check --json
 ```
 
 ### 第二步：接入宿主 Agent
 
 ```bash
-aiwiki agent list
-aiwiki agent install
-aiwiki agent check
+aiwiki agent sync --yes
+aiwiki agent check --json
 ```
 
 也可以直接输出通用协议：
@@ -118,15 +126,11 @@ aiwiki query "xxx"
 ```text
 02-raw/articles/
 03-sources/article-cards/
-04-claims/_suggestions/
 05-wiki/source-knowledge/
-06-assets/_suggestions/
-07-topics/ready/
-08-outputs/outlines/
 09-runs/<run-id>/
 ```
 
-其中 `05-wiki/source-knowledge/<slug>.md` 是默认 Wiki Entry。
+其中 `02-raw/articles/`、`03-sources/article-cards/`、`05-wiki/source-knowledge/` 和 `09-runs/<run-id>/` 是核心产物。`04-claims/_suggestions/`、`06-assets/_suggestions/`、`07-topics/ready/`、`08-outputs/outlines/` 只在 payload 有对应内容或 `request.outputs` 明确请求时生成。
 
 ### Agent-Enriched Wiki Entry
 

package/dist/src/app.js

@@ -6,7 +6,7 @@ import { fileURLToPath } from "node:url";
 import { flagBool, flagString, parseArgs } from "./args.js";
 import { buildContext } from "./context.js";
 import { deriveFileTitle, ingestFile, ingestPayload } from "./ingest.js";
-import { filterLintReport, lintWorkspace, renderLintReport, renderLintSummary, writeLintReport } from "./lint.js";
+import { attachAppliedSafeFixes, filterLintReport, lintWorkspace, removeEmptyOptionalDirs, renderLintReport, renderLintSummary, writeLintReport } from "./lint.js";
 import { CliError, writeLine } from "./output.js";
 import { confirmInit, directorySummary, doctor, exists, initWorkspace, promptForSetup, promptForInitPath, readConfig, resolveWorkspace, setDefaultWorkspace, statusSummary } from "./workspace.js";
 export async function runCli(argv, streams = { stdout: process.stdout, stderr: process.stderr }) {
@@ -44,8 +44,8 @@ export async function runCli(argv, streams = { stdout: process.stdout, stderr: p
             writeLine(streams.stdout, `默认知识库: ${defaultConfig.defaultPath}`);
             writeLine(streams.stdout, `用户配置: ${defaultConfig.configPath}`);
             writeLine(streams.stdout, "Obsidian 入口: dashboards/AIWiki Home.md");
-            writeLine(streams.stdout, "下一步: 运行 `aiwiki agent install`，把 AIWiki 安装到宿主 Agent。");
-            writeLine(streams.stdout, "Agent 设置完成后: 向 Agent 发送 `入库 <url>`");
+            writeLine(streams.stdout, "下一步: 运行 `aiwiki agent sync --yes`，同步 AIWiki 宿主 Agent 对接文件。");
+            writeLine(streams.stdout, "Agent 设置完成后: 让宿主 Agent 提供正文并调用 `aiwiki ingest-agent --stdin`，或运行 `aiwiki ingest-file --file <file>`。");
             return 0;
         }
         if (command === "agent" && subcommand === "install") {
@@ -184,7 +184,8 @@ export async function runCli(argv, streams = { stdout: process.stdout, stderr: p
         if (command === "lint") {
             const root = await resolveWorkspace(flagString(args, "path"));
             const severity = parseLintSeverity(flagString(args, "severity"));
-            const report = filterLintReport(await lintWorkspace(root), severity);
+            const appliedSafeFixes = flagBool(args, "fix-empty-dirs") ? await removeEmptyOptionalDirs(root) : [];
+            const report = filterLintReport(attachAppliedSafeFixes(await lintWorkspace(root), appliedSafeFixes), severity);
             if (flagBool(args, "json")) {
                 writeLine(streams.stdout, JSON.stringify(report, null, 2));
                 return 0;
@@ -268,25 +269,16 @@ function printHelp(stream) {
     writeLine(stream, "用法:");
     writeLine(stream, "  aiwiki setup");
     writeLine(stream, "  aiwiki setup --path <path> --yes");
-    writeLine(stream, "  aiwiki agent list");
-    writeLine(stream, "  aiwiki agent install");
-    writeLine(stream, "  aiwiki agent install --agent codex --yes");
     writeLine(stream, "  aiwiki agent sync --yes");
     writeLine(stream, "  aiwiki agent check --json");
-    writeLine(stream, "  aiwiki prompt agent");
+    writeLine(stream, "  aiwiki ingest-agent --stdin");
+    writeLine(stream, "  aiwiki ingest-file --file <file>");
     writeLine(stream, "  aiwiki doctor");
     writeLine(stream, "  aiwiki status");
     writeLine(stream, "  aiwiki context <query>");
     writeLine(stream, "  aiwiki query <query>");
-    writeLine(stream, "  aiwiki next");
     writeLine(stream, "  aiwiki lint");
-    writeLine(stream, "  aiwiki ingest-agent --stdin");
-    writeLine(stream, "  aiwiki ingest-file --file <file>");
-    writeLine(stream, "  aiwiki init --path <path> --yes --set-default");
-    writeLine(stream, "  aiwiki config show");
-    writeLine(stream, "  aiwiki ingest-agent --payload <file>");
-    writeLine(stream, "  aiwiki ingest-url <url> --content-file <file>");
-    writeLine(stream, "  aiwiki agent check");
+    writeLine(stream, "  aiwiki lint --fix-empty-dirs --json");
 }
 function printAgentHelp(stream) {
     writeLine(stream, "AIWiki Agent commands");
@@ -633,7 +625,7 @@ function printAgentPrompt(stream) {
     writeLine(stream, "回复措辞：成功时说“AIWiki 已完成入库，并生成 Wiki 条目。” 如果 wiki_entry_quality=scaffold，说明该条目只是可追溯脚手架，仍需宿主 Agent 后续补全。Dataview 是可选增强，不要替用户安装插件或修改 .obsidian。");
     writeLine(stream, "");
     writeLine(stream, "查询：当用户要求从 AIWiki 里了解某个主题时，调用 `aiwiki context <主题>`。");
-    writeLine(stream, "整理：当用户要求检查或整理知识库时，调用 `aiwiki lint`。");
+    writeLine(stream, "整理：当用户要求检查或整理知识库时，先调用 `aiwiki lint --json`；若只有 safe fix 且用户允许整理，再调用 `aiwiki lint --fix-empty-dirs --json`，随后重跑 `aiwiki lint --json`。");
     writeLine(stream, "");
     writeLine(stream, "禁止：让用户保存 payload；让用户每次输入 --path；声称 AIWiki CLI 负责网页抓取；声称 AIWiki CLI 会在没有 Agent 分析字段时自动高质量总结。");
 }

package/dist/src/ingest.js

@@ -30,23 +30,38 @@ export async function ingestPayload(rootPath, rawPayload) {
     const contentFingerprint = createContentFingerprint(content);
     const collisionWarnings = [];
     await detectDuplicateContent(root, payload, contentFingerprint, collisionWarnings);
-    const longTermTargets = await chooseLongTermTargets(root, slug, runId, collisionWarnings);
+    const optionalOutputs = optionalOutputPlan(payload);
+    const longTermTargets = await chooseLongTermTargets(root, slug, runId, collisionWarnings, optionalOutputs);
     const links = buildArtifactLinks(root, slug, runDirName, runStartedAt, contentFingerprint, longTermTargets);
     const grounding = buildGroundingReport(payload);
     await writeFile(path.join(runDir, "raw.md"), contentFile(payload, content, links), generatedFiles);
     await writeFile(path.join(runDir, "source-card.md"), sourceCard(payload, runDirName, links, grounding), 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);
+    if (optionalOutputs.assets && links.assets) {
+        await writeFile(path.join(runDir, "creative-assets.md"), creativeAssets(payload, links), generatedFiles);
+    }
+    if (optionalOutputs.topics && links.topics) {
+        await writeFile(path.join(runDir, "topics.md"), topics(payload, links), generatedFiles);
+    }
+    if (optionalOutputs.outline && links.outline) {
+        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, grounding), generatedFiles);
     await writeFile(longTermTargets.wikiEntry, wikiEntryResult.markdown, generatedFiles);
-    await writeFile(longTermTargets.claims, claims(payload, links, grounding), generatedFiles);
-    await writeFile(longTermTargets.assets, creativeAssets(payload, links), generatedFiles);
-    await writeFile(longTermTargets.topics, topics(payload, links), generatedFiles);
-    await writeFile(longTermTargets.outline, outline(payload, links), generatedFiles);
+    if (optionalOutputs.claims && longTermTargets.claims) {
+        await writeFile(longTermTargets.claims, claims(payload, links, grounding), generatedFiles);
+    }
+    if (optionalOutputs.assets && longTermTargets.assets) {
+        await writeFile(longTermTargets.assets, creativeAssets(payload, links), generatedFiles);
+    }
+    if (optionalOutputs.topics && longTermTargets.topics) {
+        await writeFile(longTermTargets.topics, topics(payload, links), generatedFiles);
+    }
+    if (optionalOutputs.outline && longTermTargets.outline) {
+        await writeFile(longTermTargets.outline, outline(payload, links), generatedFiles);
+    }
     const warnings = [...payload.warnings, ...groundingWarnings(grounding), ...collisionWarnings];
     await writeSummary(root, runDir, payload, generatedFiles, warnings, links, grounding);
     return { runId, runDir, generatedFiles, warnings, agentReport: buildAgentReport(root, runDir, payload, generatedFiles) };
@@ -69,7 +84,7 @@ export async function ingestFile(rootPath, filePath) {
         },
         request: {
             mode: "ingest",
-            outputs: ["source_card", "creative_assets", "topics", "draft_outline", "processing_summary"],
+            outputs: ["source_card", "wiki_entry", "processing_summary"],
             language: "zh-CN"
         }
     });
@@ -77,19 +92,29 @@ export async function ingestFile(rootPath, filePath) {
 export function deriveFileTitle(filePath) {
     return path.basename(filePath, path.extname(filePath));
 }
-async function chooseLongTermTargets(root, slug, runId, warnings) {
+async function chooseLongTermTargets(root, slug, runId, warnings, plan) {
     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),
-        outline: await chooseLongTermTarget(root, "08-outputs/outlines", `${slug}-outline.md`, runId, warnings)
+        claims: plan.claims ? await chooseLongTermTarget(root, "04-claims/_suggestions", `${slug}-claims.md`, runId, warnings) : undefined,
+        assets: plan.assets ? await chooseLongTermTarget(root, "06-assets/_suggestions", `${slug}-assets.md`, runId, warnings) : undefined,
+        topics: plan.topics ? await chooseLongTermTarget(root, "07-topics/ready", `${slug}-topics.md`, runId, warnings) : undefined,
+        outline: plan.outline ? await chooseLongTermTarget(root, "08-outputs/outlines", `${slug}-outline.md`, runId, warnings) : undefined
+    };
+}
+function optionalOutputPlan(payload) {
+    const outputs = new Set(payload.request.outputs);
+    return {
+        claims: outputs.has("claims") || outputs.has("claim_suggestions") || Boolean(payload.analysis?.claims.length),
+        assets: outputs.has("creative_assets"),
+        topics: outputs.has("topics") || Boolean(payload.analysis?.topic_candidates.length),
+        outline: outputs.has("draft_outline") || Boolean(payload.analysis?.outline || payload.analysis?.suggested_links.length || payload.analysis?.reusable_judgments.length)
     };
 }
 async function chooseLongTermTarget(root, dir, fileName, runId, warnings) {
     const target = safeJoin(root, dir, fileName);
+    await fs.mkdir(path.dirname(target), { recursive: true });
     try {
         await fs.access(target);
     }
@@ -260,10 +285,10 @@ function sourceCard(payload, runId, links, grounding) {
         "",
         `- Wiki 条目：${obsidianLink(links.wikiEntry, "Wiki 条目")}`,
         `- 原文：${obsidianLink(links.raw, "原文")}`,
-        `- Claim 建议：${obsidianLink(links.claims, "Claim 建议")}`,
-        `- 素材建议：${obsidianLink(links.assets, "素材建议")}`,
-        `- 选题：${obsidianLink(links.topics, "选题")}`,
-        `- 大纲：${obsidianLink(links.outline, "大纲")}`,
+        ...(links.claims ? [`- Claim 建议：${obsidianLink(links.claims, "Claim 建议")}`] : []),
+        ...(links.assets ? [`- 素材建议：${obsidianLink(links.assets, "素材建议")}`] : []),
+        ...(links.topics ? [`- 选题：${obsidianLink(links.topics, "选题")}`] : []),
+        ...(links.outline ? [`- 大纲：${obsidianLink(links.outline, "大纲")}`] : []),
         `- 处理记录：${obsidianLink(links.runSummary, "处理记录")}`,
         "",
         "## 摘要",
@@ -380,7 +405,7 @@ function topics(payload, links) {
         "",
         `- Wiki 条目：${obsidianLink(links.wikiEntry, "Wiki 条目")}`,
         `- 资料卡：${obsidianLink(links.sourceCard, "资料卡")}`,
-        `- 大纲：${obsidianLink(links.outline, "大纲")}`,
+        ...(links.outline ? [`- 大纲：${obsidianLink(links.outline, "大纲")}`] : []),
         `- ${payload.source.title ?? "Untitled"}`,
         ""
     ].join("\n");
@@ -530,10 +555,10 @@ function buildArtifactLinks(root, slug, runDirName, createdAt, contentFingerprin
         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),
-        outline: relativePath(root, longTermTargets.outline),
+        claims: longTermTargets.claims ? relativePath(root, longTermTargets.claims) : undefined,
+        assets: longTermTargets.assets ? relativePath(root, longTermTargets.assets) : undefined,
+        topics: longTermTargets.topics ? relativePath(root, longTermTargets.topics) : undefined,
+        outline: longTermTargets.outline ? relativePath(root, longTermTargets.outline) : undefined,
         runSummary: `09-runs/${runDirName}/processing-summary.md`
     };
 }
@@ -545,10 +570,10 @@ function relationshipFrontmatter(links) {
         `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 建议"))}"`,
-        `assets_note: "${escapeYaml(obsidianLink(links.assets, "素材建议"))}"`,
-        `topics_note: "${escapeYaml(obsidianLink(links.topics, "选题"))}"`,
-        `outline_note: "${escapeYaml(obsidianLink(links.outline, "大纲"))}"`,
+        ...(links.claims ? [`claims_note: "${escapeYaml(obsidianLink(links.claims, "Claim 建议"))}"`] : []),
+        ...(links.assets ? [`assets_note: "${escapeYaml(obsidianLink(links.assets, "素材建议"))}"`] : []),
+        ...(links.topics ? [`topics_note: "${escapeYaml(obsidianLink(links.topics, "选题"))}"`] : []),
+        ...(links.outline ? [`outline_note: "${escapeYaml(obsidianLink(links.outline, "大纲"))}"`] : []),
         `run_summary: "${escapeYaml(obsidianLink(links.runSummary, "处理记录"))}"`
     ];
 }

package/dist/src/lint.js

@@ -2,7 +2,7 @@ import { promises as fs } from "node:fs";
 import path from "node:path";
 import { frontmatterArray, frontmatterBoolean, frontmatterString, parseMarkdown } from "./frontmatter.js";
 import { relativePath, safeJoin } from "./paths.js";
-import { exists } from "./workspace.js";
+import { exists, OPTIONAL_DIRS, OPTIONAL_PARENT_DIRS } 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");
@@ -20,6 +20,7 @@ export async function lintWorkspace(rootPath, now = new Date().toISOString()) {
     ];
     const issues = [];
     issues.push(...await systemFileIssues(root));
+    issues.push(...await emptyOptionalDirectoryIssues(root));
     const wikiSourceCards = new Set(wikiEntries.map((note) => frontmatterString(note.frontmatter, "source_card")).filter(Boolean));
     for (const card of sourceCards) {
         if (!wikiSourceCards.has(card.path)) {
@@ -135,6 +136,7 @@ export async function lintWorkspace(rootPath, now = new Date().toISOString()) {
             raw_files: rawFiles.length,
             runs: runs.length
         },
+        safe_fixes: safeFixSummary(issues),
         issues
     };
 }
@@ -144,9 +146,31 @@ export function filterLintReport(report, severity) {
     }
     return {
         ...report,
+        safe_fixes: safeFixSummary(report.issues.filter((issue) => issue.severity === severity), report.safe_fixes.applied),
         issues: report.issues.filter((issue) => issue.severity === severity)
     };
 }
+export async function removeEmptyOptionalDirs(rootPath) {
+    const root = path.resolve(rootPath);
+    const applied = [];
+    for (const dir of [...OPTIONAL_DIRS].sort((left, right) => right.length - left.length)) {
+        if (await removeKnownEmptyDir(root, dir)) {
+            applied.push(safeFixFor(dir));
+        }
+    }
+    for (const dir of [...OPTIONAL_PARENT_DIRS].sort((left, right) => right.length - left.length)) {
+        if (await removeKnownEmptyDir(root, dir)) {
+            applied.push(safeFixFor(dir));
+        }
+    }
+    return applied;
+}
+export function attachAppliedSafeFixes(report, applied) {
+    return {
+        ...report,
+        safe_fixes: safeFixSummary(report.issues, applied)
+    };
+}
 export async function writeLintReport(rootPath, report) {
     const root = path.resolve(rootPath);
     const target = safeJoin(root, "dashboards", "Lint Report.md");
@@ -171,6 +195,8 @@ export function renderLintReport(report) {
         `- Errors: ${counts.error}`,
         `- Warnings: ${counts.warning}`,
         `- Info: ${counts.info}`,
+        `- Safe Fixes Available: ${report.safe_fixes.available}`,
+        `- Only Safe Fixes: ${report.safe_fixes.only_safe_fixes ? "yes" : "no"}`,
         `- Top Issue: ${topIssue ? formatIssueLine(topIssue) : "none"}`,
         "",
         "## Suggested Handling Order",
@@ -190,6 +216,7 @@ export function renderLintSummary(report, reportPath) {
     const topIssue = report.issues[0];
     return [
         `lint_summary: errors=${counts.error} warnings=${counts.warning} info=${counts.info}`,
+        `safe_fixes: available=${report.safe_fixes.available} applied=${report.safe_fixes.applied.length} only_safe_fixes=${report.safe_fixes.only_safe_fixes ? "yes" : "no"}`,
         `top_issue: ${topIssue ? formatIssueLine(topIssue) : "none"}`,
         ...(reportPath ? [`report: ${reportPath}`] : [])
     ].join("\n");
@@ -211,6 +238,62 @@ async function systemFileIssues(root) {
     }
     return issues;
 }
+async function emptyOptionalDirectoryIssues(root) {
+    const issues = [];
+    for (const dir of [...OPTIONAL_DIRS, ...OPTIONAL_PARENT_DIRS]) {
+        if (!(await isExistingEmptyDirectory(path.join(root, dir)))) {
+            continue;
+        }
+        issues.push({
+            severity: "info",
+            path: dir,
+            category: "empty_optional_directory",
+            action: "remove_empty_optional_dir",
+            message: `Optional directory is empty and can be safely removed: ${dir}`,
+            suggestion: "Run aiwiki lint --fix-empty-dirs --json to remove known empty optional directories.",
+            safe_fix: safeFixFor(dir)
+        });
+    }
+    return issues;
+}
+async function removeKnownEmptyDir(root, dir) {
+    const target = path.join(root, dir);
+    if (!(await isExistingEmptyDirectory(target))) {
+        return false;
+    }
+    await fs.rmdir(target);
+    return true;
+}
+async function isExistingEmptyDirectory(target) {
+    try {
+        const stats = await fs.stat(target);
+        if (!stats.isDirectory()) {
+            return false;
+        }
+        return (await fs.readdir(target)).length === 0;
+    }
+    catch (error) {
+        if (error.code === "ENOENT") {
+            return false;
+        }
+        throw error;
+    }
+}
+function safeFixFor(dir) {
+    return {
+        action: "remove_empty_optional_dir",
+        path: dir,
+        command: "aiwiki lint --fix-empty-dirs --json"
+    };
+}
+function safeFixSummary(issues, applied = []) {
+    const available = issues.filter((issue) => issue.safe_fix).length;
+    return {
+        available,
+        applied,
+        only_safe_fixes: issues.length > 0 && issues.every((issue) => Boolean(issue.safe_fix))
+    };
+}
 async function readNotes(root, dir) {
     const absolute = path.join(root, dir);
     if (!(await exists(absolute))) {

package/dist/src/payload.js

@@ -40,11 +40,8 @@ export function normalizePayload(raw, runStartedAt) {
     const requestRaw = isRecord(raw.request) ? raw.request : {};
     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", "wiki_entry", "creative_assets", "topics", "draft_outline", "processing_summary"];
-    if (fetchStatus !== "failed" && requestedOutputs.length && hasCustomOutputRequest(requestedOutputs)) {
-        warnings.push("AIWiki 会为每条输入生成完整资料产物，request.outputs 已按全量输出处理。");
-    }
+        : undefined;
+    const outputs = normalizeOutputs(requestedOutputs, fetchStatus, warnings);
     if (typeof raw.target_kb === "string" && raw.target_kb.trim()) {
         warnings.push(`target_kb=${raw.target_kb} 已被当前知识库流程忽略。`);
     }
@@ -313,9 +310,27 @@ function hasAnalysisContent(analysis) {
         analysis.suggested_links.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);
+function normalizeOutputs(outputs, fetchStatus, warnings) {
+    if (fetchStatus === "failed") {
+        return ["processing_summary"];
+    }
+    const core = ["source_card", "wiki_entry", "processing_summary"];
+    const allowed = new Set([
+        ...core,
+        "claims",
+        "claim_suggestions",
+        "creative_assets",
+        "topics",
+        "draft_outline"
+    ]);
+    const requested = outputs ?? core;
+    const normalized = new Set(core);
+    for (const output of requested) {
+        if (!allowed.has(output)) {
+            warnings.push(`request.outputs ignored unknown output: ${output}`);
+            continue;
+        }
+        normalized.add(output);
+    }
+    return [...normalized];
 }

package/dist/src/wiki-entry.js

@@ -32,9 +32,9 @@ function wikiFrontmatter(payload, links, title, mode, quality, grounding) {
         `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)}"`,
+        ...(links.claims ? [`claims_file: "${escapeYaml(links.claims)}"`] : []),
+        ...(links.topics ? [`topics_file: "${escapeYaml(links.topics)}"`] : []),
+        ...(links.outline ? [`outline_file: "${escapeYaml(links.outline)}"`] : []),
         `run_summary: "${escapeYaml(links.runSummary)}"`,
         `run_id: "${escapeYaml(links.runId)}"`,
         `content_fingerprint: "${escapeYaml(links.contentFingerprint)}"`,

package/dist/src/workspace.js

@@ -7,21 +7,30 @@ import { frontmatterBoolean, frontmatterString, parseMarkdown } from "./frontmat
 import { CliError } from "./output.js";
 import { relativePath } from "./paths.js";
 export const CONFIG_FILE = "aiwiki.yaml";
-export const REQUIRED_DIRS = [
+export const CORE_DIRS = [
     "02-raw/articles",
     "03-sources/article-cards",
-    "04-claims/_suggestions",
     "05-wiki",
     "05-wiki/source-knowledge",
-    "06-assets/_suggestions",
-    "07-topics/ready",
-    "08-outputs/outlines",
     "09-runs",
     "dashboards",
     "_system/templates",
     "_system/schemas",
     "_system/logs"
 ];
+export const OPTIONAL_DIRS = [
+    "04-claims/_suggestions",
+    "06-assets/_suggestions",
+    "07-topics/ready",
+    "08-outputs/outlines"
+];
+export const OPTIONAL_PARENT_DIRS = [
+    "04-claims",
+    "06-assets",
+    "07-topics",
+    "08-outputs"
+];
+export const REQUIRED_DIRS = CORE_DIRS;
 const WORKSPACE_SEEDS = [
     {
         path: "_system/purpose.md",
@@ -357,7 +366,7 @@ export async function initWorkspace(rootPath) {
     const root = resolveRoot(rootPath);
     await fs.mkdir(root, { recursive: true });
     const createdDirs = [];
-    for (const dir of REQUIRED_DIRS) {
+    for (const dir of CORE_DIRS) {
         const absolute = path.join(root, dir);
         const existed = await exists(absolute);
         await fs.mkdir(absolute, { recursive: true });
@@ -452,7 +461,7 @@ export async function promptForSetup(options) {
         if (!options.yes) {
             const root = resolveRoot(rootPath);
             output.write(`将创建或补齐 AIWiki 目录: ${root}\n`);
-            for (const dir of REQUIRED_DIRS) {
+            for (const dir of CORE_DIRS) {
                 output.write(`  - ${dir}\n`);
             }
             const answer = await rl.question("确认创建？输入 y 继续: ");
@@ -483,7 +492,7 @@ async function promptForSetupFromPipe(options) {
     if (!options.yes) {
         const root = resolveRoot(rootPath);
         output.write(`将创建或补齐 AIWiki 目录: ${root}\n`);
-        for (const dir of REQUIRED_DIRS) {
+        for (const dir of CORE_DIRS) {
             output.write(`  - ${dir}\n`);
         }
         output.write("确认创建？输入 y 继续: ");
@@ -503,7 +512,7 @@ export async function confirmInit(rootPath) {
     const rl = createInterface({ input, output });
     try {
         output.write(`将创建或补齐 AIWiki 目录: ${root}\n`);
-        for (const dir of REQUIRED_DIRS) {
+        for (const dir of CORE_DIRS) {
             output.write(`  - ${dir}\n`);
         }
         const answer = await rl.question("确认创建？输入 y 继续: ");