agent-wiki 0.1.0

package/README.md

@@ -0,0 +1,98 @@
+# Agent-Wiki
+
+卡帕西智能知识库 MCP 插件。一行安装，纯对话交互。
+
+帮你把收藏的文章自动整理成维基、打标签、生成摘要，还能基于知识库写有人味儿的原创文章。
+
+## 安装
+
+**Claude Code：**
+```bash
+claude mcp add agent-wiki -- npx agent-wiki
+```
+
+**Cursor / Windsurf**（编辑 MCP 配置）：
+```json
+{
+  "mcpServers": {
+    "agent-wiki": {
+      "command": "npx",
+      "args": ["agent-wiki"]
+    }
+  }
+}
+```
+
+装完重启 Agent 就行，不需要别的配置。
+
+## 首次使用
+
+装完后打开 Agent，它会主动引导你：
+
+```
+Agent：你好！我是 agent-wiki 知识库助手。
+我可以帮你搭一个个人知识库。还能基于你的知识库
+帮你写有人味儿的原创文章，适合直接发微信公众号。
+
+先设置一下：
+1. 你想把知识库放在哪个目录？
+2. 你主要关注什么方向？
+```
+
+你回答两个问题就建好了。
+
+## 日常使用
+
+纯对话，不需要记任何命令：
+
+```
+你：把 ~/Downloads/这篇文章.md 加到知识库
+你：整理一下知识库
+你：搜一下 RAG 相关的内容
+你：帮我写一篇 Agent 工程化的综述
+你：检查一下知识库健不健康
+```
+
+## 知识库结构
+
+```
+你的知识库目录/
+├── SCHEMA.md       # 知识库说明书（Agent 自动读取）
+├── raw/            # 原始文章（不可变）
+├── wiki/           # AI 编译后的维基页面
+│   ├── INDEX.md    # 分类索引
+│   ├── LOG.md      # 操作日志
+│   └── *.md        # Wiki 页面
+└── outputs/        # 原创文章（可直接发微信公众号）
+```
+
+## 工具列表
+
+| 工具 | 功能 |
+|------|------|
+| wiki_status | 查询知识库状态，首次使用自动引导 |
+| wiki_init | 初始化知识库（创建目录 + SCHEMA.md） |
+| wiki_ingest | 摄入文章到 raw/ |
+| wiki_tag | 写入标签到 frontmatter |
+| wiki_compile | 生成 Wiki 页面 + 更新索引 + 记录日志 |
+| wiki_search | 标签 + 全文搜索 |
+| wiki_article | 保存原创文章到 outputs/ |
+| wiki_lint | 自检死链接、缺摘要等 |
+
+## 写文章风格
+
+插件内置了去 AI 味规则，写出来的文章：
+- 像跟朋友聊天，不像写论文
+- 有自己的观点和态度
+- 适合直接发微信公众号
+
+## 技术栈
+
+- TypeScript + @modelcontextprotocol/sdk
+- 零外部依赖（只用 Node.js 标准库）
+- LLM 由宿主 Agent 提供，插件不碰 LLM
+- MCP stdio 协议
+
+## License
+
+MIT

package/dist/index.d.ts

@@ -0,0 +1,12 @@
+#!/usr/bin/env node
+/**
+ * Agent-Wiki MCP Server
+ *
+ * 卡帕西智能知识库 MCP 插件
+ * 一行安装，纯对话交互，Agent 自动帮你管理知识库、写有人味儿的原创文章
+ *
+ * 零 LLM、零 HTTP、零外部依赖
+ * 所有智能工作由宿主 Agent 的 LLM 完成
+ * 本插件只负责文件操作（搬文件、读写元数据、搜索、生成模板）
+ */
+export {};

package/dist/index.js

@@ -0,0 +1,110 @@
+#!/usr/bin/env node
+/**
+ * Agent-Wiki MCP Server
+ *
+ * 卡帕西智能知识库 MCP 插件
+ * 一行安装，纯对话交互，Agent 自动帮你管理知识库、写有人味儿的原创文章
+ *
+ * 零 LLM、零 HTTP、零外部依赖
+ * 所有智能工作由宿主 Agent 的 LLM 完成
+ * 本插件只负责文件操作（搬文件、读写元数据、搜索、生成模板）
+ */
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { z } from "zod";
+import { handleStatus } from "./tools/status.js";
+import { handleInit } from "./tools/init.js";
+import { handleIngest } from "./tools/ingest.js";
+import { handleTag } from "./tools/tag.js";
+import { handleCompile } from "./tools/compile.js";
+import { handleSearch } from "./tools/search.js";
+import { handleArticle } from "./tools/article.js";
+import { handleLint } from "./tools/lint.js";
+const server = new McpServer({
+    name: "agent-wiki",
+    version: "0.1.0",
+});
+// ─── 注册 8 个 MCP 工具 ───
+/**
+ * wiki_status — 查询知识库状态
+ * 首次调用返回 initialized: false + 引导提示
+ * Agent 应根据 hint 主动引导用户完成初始化
+ */
+server.tool("wiki_status", "查询知识库状态。首次调用如果返回 initialized: false，你应该主动引导用户：1. 问知识库目录 2. 问兴趣方向 3. 调用 wiki_init。不要等用户说'帮我建知识库'，你主动开始。", {}, async () => handleStatus());
+/**
+ * wiki_init — 初始化知识库
+ * 创建目录结构（raw/、wiki/、outputs/）
+ * 生成 SCHEMA.md（知识库说明书 + Agent 操作指南 + 写作规则）
+ */
+server.tool("wiki_init", "初始化知识库。创建目录结构和 SCHEMA.md。需要用户提供：目录路径、关注主题、兴趣方向。", {
+    dir: z.string().describe("知识库根目录路径，如 ~/Documents/知识库"),
+    topics: z.array(z.string()).describe("关注主题列表，如 ['AI', '产品管理']"),
+    interests: z.array(z.string()).describe("兴趣方向列表，如 ['LLM', '创业', 'RAG']"),
+}, async (params) => handleInit(params));
+/**
+ * wiki_ingest — 摄入 MD 文件到知识库
+ * 从指定路径复制 MD 文件到 raw/（增量）
+ * 返回每个文件的前 500 字预览供 Agent 用 LLM 处理
+ */
+server.tool("wiki_ingest", "摄入 MD 文件到知识库。从指定路径复制 .md 文件到 raw/ 目录（增量，已摄入的跳过）。返回新文件内容预览，供你用 LLM 提取标签和摘要。", {
+    source: z.string().describe("源文件路径或目录路径"),
+    force: z.boolean().optional().describe("强制重新摄入已存在的文件，默认 false"),
+}, async (params) => handleIngest(params));
+/**
+ * wiki_tag — 写入标签到文件 frontmatter
+ * Agent 用 LLM 提取标签后，调用此工具写入
+ */
+server.tool("wiki_tag", "将标签写入文件的 frontmatter。你应该先用 LLM 为文件提取 5-10 个标签，然后调用此工具写入。", {
+    file: z.string().describe("raw/ 下的文件名"),
+    tags: z.array(z.string()).describe("标签列表，如 ['AI', 'RAG', '知识管理']"),
+}, async (params) => handleTag(params));
+/**
+ * wiki_compile — 生成 Wiki 页面
+ * 接收 Agent 用 LLM 生成的结构化内容，生成 Wiki 页面
+ * 自动更新 INDEX.md 和 LOG.md
+ */
+server.tool("wiki_compile", "根据你用 LLM 生成的摘要、洞察、分类生成 Wiki 页面。同时更新 INDEX.md 和 LOG.md。你应该先读 SCHEMA.md 了解 Wiki 页面格式，用 LLM 生成内容后再调用。", {
+    file: z.string().describe("raw/ 下的源文件名"),
+    title: z.string().describe("Wiki 页面标题"),
+    summary: z.string().describe("2-3 句话的核心内容摘要"),
+    insights: z.array(z.string()).describe("3-5 个核心洞察"),
+    category: z.string().describe("分类名，如 'AI工程化'、'知识管理'"),
+    tags: z.array(z.string()).describe("5-10 个标签"),
+    source_file: z.string().describe("raw/ 下的源文件名（同 file 参数）"),
+}, async (params) => handleCompile(params));
+/**
+ * wiki_search — 搜索知识库
+ * 支持标签匹配 + 全文关键词搜索
+ */
+server.tool("wiki_search", "搜索知识库。支持按标签和关键词搜索，返回匹配的 Wiki 页面列表。标签匹配权重 0.6 + 全文匹配权重 0.4。", {
+    tags: z.array(z.string()).optional().describe("按标签搜索"),
+    query: z.string().optional().describe("全文关键词搜索"),
+    match: z.enum(["any", "all"]).optional().describe("标签匹配模式：any=任一匹配，all=全部匹配。默认 any"),
+    top_k: z.number().optional().describe("返回结果数量，默认 10"),
+}, async (params) => handleSearch(params));
+/**
+ * wiki_article — 保存原创文章
+ * Agent 写好文章后调用此工具保存到 outputs/
+ * 写作前必须读 SCHEMA.md 的"写原创文章规则"
+ */
+server.tool("wiki_article", "保存原创文章到 outputs/ 目录。保存前，你必须先读 SCHEMA.md 的'写原创文章规则'，确保文章是有人味儿的微信公众号风格，没有 AI 味。", {
+    topic: z.string().describe("文章主题"),
+    content: z.string().describe("文章正文（Markdown 格式）"),
+    refs: z.array(z.string()).optional().describe("参考资料文件名列表"),
+}, async (params) => handleArticle(params));
+/**
+ * wiki_lint — 自检知识库健康状态
+ * 检测死链接、缺摘要、内容过短等问题
+ */
+server.tool("wiki_lint", "自检知识库健康状态。检测死链接、缺失摘要、内容过短、缺少标签等问题，返回问题列表。", {
+    check_only: z.boolean().optional().describe("仅检测不修复，默认 true"),
+}, async (params) => handleLint(params));
+// ─── 启动 MCP Server ───
+async function main() {
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+}
+main().catch((err) => {
+    console.error("Agent-Wiki MCP Server 启动失败:", err);
+    process.exit(1);
+});

package/dist/state.d.ts

@@ -0,0 +1,56 @@
+/**
+ * 状态管理：全局配置 + 知识库状态
+ *
+ * 全局配置存放在 ~/.agent-wiki/config.json，记录知识库目录路径
+ * 知识库状态存放在 {wikiDir}/state.json，记录已摄入/已打标签/已编译的文件列表
+ */
+/** 全局配置（~/.agent-wiki/config.json） */
+export interface GlobalConfig {
+    /** 知识库根目录（绝对路径） */
+    wikiDir: string;
+}
+/** 知识库状态（{wikiDir}/state.json） */
+export interface WikiState {
+    /** 已摄入到 raw/ 的文件名列表 */
+    ingested: string[];
+    /** 已打标签的文件名列表 */
+    tagged: string[];
+    /** 已编译为 Wiki 页面的源文件名列表 */
+    compiled: string[];
+}
+/**
+ * 获取全局配置目录路径
+ */
+export declare function getGlobalConfigDir(): string;
+/**
+ * 读取全局配置，未初始化返回 null
+ */
+export declare function getConfig(): GlobalConfig | null;
+/**
+ * 保存全局配置
+ */
+export declare function setConfig(config: GlobalConfig): void;
+/**
+ * 检查是否已初始化（全局配置存在且 wikiDir 目录存在）
+ */
+export declare function isInitialized(): boolean;
+/**
+ * 获取知识库根目录
+ * 优先从全局配置读取，如果没有则返回 null
+ */
+export declare function getWikiDir(): string | null;
+/**
+ * 获取 state.json 文件路径
+ */
+export declare function getStatePath(wikiDir: string): string;
+/**
+ * 读取知识库状态，state.json 不存在则返回空状态
+ */
+export declare function getState(wikiDir: string): WikiState;
+/**
+ * 保存知识库状态
+ */
+export declare function setState(wikiDir: string, state: WikiState): void;
+export declare function getRawDir(wikiDir: string): string;
+export declare function getWikiPagesDir(wikiDir: string): string;
+export declare function getOutputsDir(wikiDir: string): string;

package/dist/state.js

@@ -0,0 +1,80 @@
+/**
+ * 状态管理：全局配置 + 知识库状态
+ *
+ * 全局配置存放在 ~/.agent-wiki/config.json，记录知识库目录路径
+ * 知识库状态存放在 {wikiDir}/state.json，记录已摄入/已打标签/已编译的文件列表
+ */
+import * as path from "path";
+import * as os from "os";
+import * as fs from "fs";
+import { ensureDir, readJSON, writeJSON } from "./utils.js";
+// ─── 路径常量 ───
+const GLOBAL_CONFIG_DIR = path.join(os.homedir(), ".agent-wiki");
+const GLOBAL_CONFIG_PATH = path.join(GLOBAL_CONFIG_DIR, "config.json");
+// ─── 全局配置操作 ───
+/**
+ * 获取全局配置目录路径
+ */
+export function getGlobalConfigDir() {
+    return GLOBAL_CONFIG_DIR;
+}
+/**
+ * 读取全局配置，未初始化返回 null
+ */
+export function getConfig() {
+    return readJSON(GLOBAL_CONFIG_PATH);
+}
+/**
+ * 保存全局配置
+ */
+export function setConfig(config) {
+    ensureDir(GLOBAL_CONFIG_DIR);
+    writeJSON(GLOBAL_CONFIG_PATH, config);
+}
+/**
+ * 检查是否已初始化（全局配置存在且 wikiDir 目录存在）
+ */
+export function isInitialized() {
+    const config = getConfig();
+    if (!config)
+        return false;
+    return fs.existsSync(config.wikiDir);
+}
+// ─── 知识库状态操作 ───
+/**
+ * 获取知识库根目录
+ * 优先从全局配置读取，如果没有则返回 null
+ */
+export function getWikiDir() {
+    const config = getConfig();
+    return config?.wikiDir ?? null;
+}
+/**
+ * 获取 state.json 文件路径
+ */
+export function getStatePath(wikiDir) {
+    return path.join(wikiDir, "state.json");
+}
+/**
+ * 读取知识库状态，state.json 不存在则返回空状态
+ */
+export function getState(wikiDir) {
+    const state = readJSON(getStatePath(wikiDir));
+    return state ?? { ingested: [], tagged: [], compiled: [] };
+}
+/**
+ * 保存知识库状态
+ */
+export function setState(wikiDir, state) {
+    writeJSON(getStatePath(wikiDir), state);
+}
+// ─── 知识库子目录路径 ───
+export function getRawDir(wikiDir) {
+    return path.join(wikiDir, "raw");
+}
+export function getWikiPagesDir(wikiDir) {
+    return path.join(wikiDir, "wiki");
+}
+export function getOutputsDir(wikiDir) {
+    return path.join(wikiDir, "outputs");
+}

package/dist/tools/article.d.ts

@@ -0,0 +1,13 @@
+/**
+ * wiki_article — 保存 Agent 写好的原创文章到 outputs/
+ *
+ * 文件名格式：YYYYMMDD-主题.md
+ * 自动添加 frontmatter（title, date, tags）
+ * 追加 LOG.md 记录
+ */
+import { ToolResult } from "../types.js";
+export declare function handleArticle(params: {
+    topic: string;
+    content: string;
+    refs?: string[];
+}): Promise<ToolResult>;

package/dist/tools/article.js

@@ -0,0 +1,46 @@
+/**
+ * wiki_article — 保存 Agent 写好的原创文章到 outputs/
+ *
+ * 文件名格式：YYYYMMDD-主题.md
+ * 自动添加 frontmatter（title, date, tags）
+ * 追加 LOG.md 记录
+ */
+import * as path from "path";
+import * as fs from "fs";
+import { getWikiDir, getOutputsDir, getWikiPagesDir } from "../state.js";
+import { safeFilename, todayStr, dateCompact, nowStr, ensureDir } from "../utils.js";
+import { textResult } from "../types.js";
+export async function handleArticle(params) {
+    const wikiDir = getWikiDir();
+    if (!wikiDir) {
+        return textResult(JSON.stringify({ error: "知识库未初始化" }));
+    }
+    const { topic, content, refs = [] } = params;
+    const outputsDir = getOutputsDir(wikiDir);
+    ensureDir(outputsDir);
+    // 生成文件名：YYYYMMDD-主题.md
+    const fileName = `${dateCompact()}-${safeFilename(topic)}.md`;
+    const filePath = path.join(outputsDir, fileName);
+    // 添加 frontmatter
+    const refsStr = refs.length > 0 ? `\nrefs:\n${refs.map((r) => `  - "[[${r}]]"`).join("\n")}` : "";
+    const fullContent = `---
+title: "${topic}"
+date: ${todayStr()}
+type: article${refsStr}
+---
+
+${content}
+`;
+    fs.writeFileSync(filePath, fullContent, "utf-8");
+    // 追加 LOG.md
+    const logPath = path.join(getWikiPagesDir(wikiDir), "LOG.md");
+    const logEntry = `\n## [${nowStr()}] article | ${topic}\n输出文件: outputs/${fileName}${refs.length > 0 ? ` | 参考资料: ${refs.join(", ")}` : ""}\n`;
+    if (fs.existsSync(logPath)) {
+        fs.appendFileSync(logPath, logEntry, "utf-8");
+    }
+    return textResult(JSON.stringify({
+        status: "ok",
+        file: `outputs/${fileName}`,
+        topic,
+    }));
+}

package/dist/tools/compile.d.ts

@@ -0,0 +1,19 @@
+/**
+ * wiki_compile — 根据 Agent 传入的内容生成 Wiki 页面
+ *
+ * 接收 Agent 用 LLM 生成的结构化内容（摘要、洞察、分类、标签）
+ * 生成 Wiki 页面 MD 文件
+ * 更新 wiki/INDEX.md（按分类分组）
+ * 追加 wiki/LOG.md（append-only）
+ * 更新 state.json
+ */
+import { ToolResult } from "../types.js";
+export declare function handleCompile(params: {
+    file: string;
+    title: string;
+    summary: string;
+    insights: string[];
+    category: string;
+    tags: string[];
+    source_file: string;
+}): Promise<ToolResult>;

package/dist/tools/compile.js

@@ -0,0 +1,145 @@
+/**
+ * wiki_compile — 根据 Agent 传入的内容生成 Wiki 页面
+ *
+ * 接收 Agent 用 LLM 生成的结构化内容（摘要、洞察、分类、标签）
+ * 生成 Wiki 页面 MD 文件
+ * 更新 wiki/INDEX.md（按分类分组）
+ * 追加 wiki/LOG.md（append-only）
+ * 更新 state.json
+ */
+import * as path from "path";
+import * as fs from "fs";
+import { getWikiDir, getWikiPagesDir, getState, setState } from "../state.js";
+import { safeFilename, todayStr, nowStr } from "../utils.js";
+import { textResult } from "../types.js";
+export async function handleCompile(params) {
+    const wikiDir = getWikiDir();
+    if (!wikiDir) {
+        return textResult(JSON.stringify({ error: "知识库未初始化" }));
+    }
+    const { file, title, summary, insights, category, tags, source_file } = params;
+    const wikiPagesDir = getWikiPagesDir(wikiDir);
+    // 生成 Wiki 页面文件名
+    const wikiFileName = safeFilename(title) + ".md";
+    const wikiFilePath = path.join(wikiPagesDir, wikiFileName);
+    // 生成 Wiki 页面内容
+    const wikiContent = `---
+title: "${title}"
+date: ${todayStr()}
+tags: [${tags.join(", ")}]
+category: ${category}
+sources:
+  - "[[raw/${source_file}]]"
+---
+
+# ${title}
+
+## 摘要
+${summary}
+
+## 核心洞察
+${insights.map((i) => `- ${i}`).join("\n")}
+
+## 标签
+${tags.join(", ")}
+
+---
+*来源: raw/${source_file} · 编译时间: ${todayStr()} ${nowStr().split(" ")[1] || ""}*
+`;
+    // 写入 Wiki 页面
+    fs.writeFileSync(wikiFilePath, wikiContent, "utf-8");
+    // 更新 INDEX.md
+    const indexPath = path.join(wikiPagesDir, "INDEX.md");
+    updateIndex(indexPath, title, category, tags.slice(0, 3), wikiFileName);
+    // 追加 LOG.md
+    const logPath = path.join(wikiPagesDir, "LOG.md");
+    appendLog(logPath, "compile", title, source_file, category, tags);
+    // 更新状态
+    const state = getState(wikiDir);
+    if (!state.compiled.includes(file)) {
+        state.compiled.push(file);
+        setState(wikiDir, state);
+    }
+    return textResult(JSON.stringify({
+        status: "ok",
+        wiki_file: wikiFileName,
+        title,
+        index_updated: true,
+        log_appended: true,
+    }));
+}
+/**
+ * 更新 INDEX.md：按分类分组，每个条目一行描述
+ */
+function updateIndex(indexPath, title, category, previewTags, wikiFileName) {
+    let content = "";
+    if (fs.existsSync(indexPath)) {
+        content = fs.readFileSync(indexPath, "utf-8");
+    }
+    // 解析已有索引，按分类收集条目
+    const sections = {};
+    const lines = content.split("\n");
+    let currentCategory = "";
+    for (const line of lines) {
+        if (line.startsWith("## ") && !line.includes("知识库索引")) {
+            currentCategory = line.replace("## ", "").trim();
+            if (!sections[currentCategory])
+                sections[currentCategory] = [];
+        }
+        else if (line.startsWith("- [[") && currentCategory) {
+            // 解析：- [[页面标题]] (标签1, 标签2)
+            const linkMatch = line.match(/- \[\[(.+?)\]\]\s*\((.+?)\)/);
+            if (linkMatch) {
+                if (!sections[currentCategory])
+                    sections[currentCategory] = [];
+                sections[currentCategory].push({
+                    title: linkMatch[1],
+                    tags: linkMatch[2].split(",").map((t) => t.trim()),
+                    file: "",
+                });
+            }
+        }
+    }
+    // 添加新条目
+    if (!sections[category])
+        sections[category] = [];
+    // 去重
+    const existing = sections[category].find((e) => e.title === title);
+    if (!existing) {
+        sections[category].push({ title, tags: previewTags, file: wikiFileName });
+    }
+    // 重新生成 INDEX.md
+    const totalEntries = Object.values(sections).reduce((s, e) => s + e.length, 0);
+    const newLines = [
+        "---",
+        `title: 知识库索引`,
+        `date: ${todayStr()}`,
+        "---",
+        "",
+        "# 知识库索引",
+        "",
+    ];
+    for (const [cat, entries] of Object.entries(sections)) {
+        if (entries.length === 0)
+            continue;
+        newLines.push(`## ${cat}`);
+        for (const entry of entries) {
+            newLines.push(`- [[${entry.title}]] (${entry.tags.join(", ")})`);
+        }
+        newLines.push("");
+    }
+    newLines.push(`---\n*共 ${totalEntries} 篇 · 更新于 ${todayStr()}*`);
+    fs.writeFileSync(indexPath, newLines.join("\n"), "utf-8");
+}
+/**
+ * 追加操作日志到 LOG.md（append-only）
+ */
+function appendLog(logPath, action, title, sourceFile, category, tags) {
+    const logEntry = `\n## [${nowStr()}] ${action} | ${title}\n来源: ${sourceFile} | 分类: ${category} | 标签: ${tags.join(", ")}\n`;
+    if (fs.existsSync(logPath)) {
+        fs.appendFileSync(logPath, logEntry, "utf-8");
+    }
+    else {
+        fs.writeFileSync(logPath, `---\ntitle: Wiki 操作日志\ntags: [log, wiki]\n---\n\n# Wiki Log\n\n> Append-only 时间线，记录 wiki 的每次变更。\n${logEntry}`, "utf-8");
+    }
+}

package/dist/tools/ingest.d.ts

@@ -0,0 +1,12 @@
+/**
+ * wiki_ingest — 从指定路径复制 MD 文件到 raw/（增量）
+ *
+ * source 可以是单个文件或目录
+ * 已摄入的文件跳过（除非 force=true）
+ * 返回每个文件的名称和前 500 字预览（供 Agent 用 LLM 处理）
+ */
+import { ToolResult } from "../types.js";
+export declare function handleIngest(params: {
+    source: string;
+    force?: boolean;
+}): Promise<ToolResult>;

package/dist/tools/ingest.js

@@ -0,0 +1,73 @@
+/**
+ * wiki_ingest — 从指定路径复制 MD 文件到 raw/（增量）
+ *
+ * source 可以是单个文件或目录
+ * 已摄入的文件跳过（除非 force=true）
+ * 返回每个文件的名称和前 500 字预览（供 Agent 用 LLM 处理）
+ */
+import * as path from "path";
+import * as fs from "fs";
+import { getWikiDir, getRawDir, getState, setState } from "../state.js";
+import { readFile_safe, ensureDir } from "../utils.js";
+import { textResult } from "../types.js";
+export async function handleIngest(params) {
+    const wikiDir = getWikiDir();
+    if (!wikiDir) {
+        return textResult(JSON.stringify({ error: "知识库未初始化，请先调用 wiki_init" }));
+    }
+    const rawDir = getRawDir(wikiDir);
+    ensureDir(rawDir);
+    const state = getState(wikiDir);
+    const source = params.source.replace(/^~/, process.env.HOME || "~");
+    const force = params.force ?? false;
+    // 收集要摄入的文件列表
+    let filesToIngest = [];
+    if (fs.statSync(source).isDirectory()) {
+        filesToIngest = fs
+            .readdirSync(source)
+            .filter((f) => f.endsWith(".md"))
+            .map((f) => path.join(source, f));
+    }
+    else if (source.endsWith(".md")) {
+        filesToIngest = [source];
+    }
+    else {
+        return textResult(JSON.stringify({ error: "source 必须是 .md 文件或包含 .md 文件的目录" }));
+    }
+    // 增量过滤
+    const results = [];
+    let ingested = 0;
+    for (const filePath of filesToIngest) {
+        const fileName = path.basename(filePath);
+        const destPath = path.join(rawDir, fileName);
+        // 已摄入则跳过（除非 force）
+        if (!force && state.ingested.includes(fileName)) {
+            results.push({ name: fileName, content_preview: "(已摄入，跳过)", skipped: true });
+            continue;
+        }
+        // 复制到 raw/
+        const content = readFile_safe(filePath);
+        if (!content) {
+            results.push({ name: fileName, content_preview: "(无法读取文件)", skipped: true });
+            continue;
+        }
+        fs.writeFileSync(destPath, content, "utf-8");
+        // 更新状态
+        if (!state.ingested.includes(fileName)) {
+            state.ingested.push(fileName);
+        }
+        results.push({
+            name: fileName,
+            content_preview: content.substring(0, 500),
+        });
+        ingested++;
+    }
+    // 保存状态
+    setState(wikiDir, state);
+    return textResult(JSON.stringify({
+        status: "ok",
+        ingested,
+        total: filesToIngest.length,
+        files: results,
+    }));
+}