agent-wiki 0.1.0

package/dist/tools/init.d.ts

@@ -0,0 +1,16 @@
+/**
+ * wiki_init — 首次初始化知识库
+ *
+ * 创建目录结构（raw/、wiki/、outputs/）
+ * 生成 SCHEMA.md（知识库说明书 + Agent 操作指南 + 写作规则）
+ * 生成 wiki/INDEX.md（空索引）
+ * 生成 wiki/LOG.md（空日志）
+ * 保存全局配置到 ~/.agent-wiki/config.json
+ * 初始化 state.json
+ */
+import { ToolResult } from "../types.js";
+export declare function handleInit(params: {
+    dir: string;
+    topics: string[];
+    interests: string[];
+}): Promise<ToolResult>;

package/dist/tools/init.js

@@ -0,0 +1,127 @@
+/**
+ * wiki_init — 首次初始化知识库
+ *
+ * 创建目录结构（raw/、wiki/、outputs/）
+ * 生成 SCHEMA.md（知识库说明书 + Agent 操作指南 + 写作规则）
+ * 生成 wiki/INDEX.md（空索引）
+ * 生成 wiki/LOG.md（空日志）
+ * 保存全局配置到 ~/.agent-wiki/config.json
+ * 初始化 state.json
+ */
+import * as path from "path";
+import * as fs from "fs";
+import { setConfig, getRawDir, getWikiPagesDir, getOutputsDir } from "../state.js";
+import { ensureDir, todayStr, writeJSON } from "../utils.js";
+import { textResult } from "../types.js";
+/** SCHEMA.md 模板 */
+function generateSchemaMd(topics, interests) {
+    return `# 知识库 Schema
+
+## 这是什么
+一个关于 ${topics.join("、")} 的个人知识库，基于 Karpathy LLM Wiki 方案。
+
+## 目录规则
+- raw/ — 未处理的源材料，永远不要修改这些文件
+- wiki/ — AI 维护的维基，用户只读
+- outputs/ — 生成的原创文章，适合直接发微信公众号
+
+## 维基规则
+- 每个主题在 wiki/ 中有自己的 .md 文件
+- 每个维基文件以一段摘要开头
+- 使用 [[topic-name]] 格式链接相关主题
+- 维护 wiki/INDEX.md，列出每个主题及一行描述
+- 每次操作追加到 wiki/LOG.md
+- 当添加新的源材料时，更新相关的维基文章
+
+## Agent 操作指南
+当用户说以下内容时，你应该：
+- "把这篇文章加入知识库" / "加个文章" → wiki_ingest → 用 LLM 提取标签 → wiki_tag → 用 LLM 生成摘要/洞察/分类 → wiki_compile
+- "整理知识库" / "全部处理一下" → wiki_ingest（全部新文件）→ 逐篇 LLM 打标签 → wiki_tag → 逐篇 LLM 生成摘要 → wiki_compile
+- "搜一下 XX" / "有没有关于 XX 的" → wiki_search
+- "写一篇关于 XX 的文章" → wiki_search 找参考资料 → 按"写原创文章规则"用 LLM 写文 → wiki_article 保存
+- "检查知识库" / "知识库健康吗" → wiki_lint
+- "知识库状态" → wiki_status
+
+## 写原创文章规则
+
+文章风格：微信公众号适合的、有人味的中文写作。
+
+### 人味标准
+- 像跟朋友聊天，不像写论文
+- 有自己的观点和态度，不当理中客
+- 短句为主，该断就断
+- 敢用"我"，敢说"我觉得"
+- 该短就短，不是每篇都要 3000 字
+
+### 微信公众号适配
+- 标题直接说事，不超过 20 字
+- 开头 3 句话内抓住读者
+- 每 3-4 段一个小标题
+- 关键句加粗，方便快速扫读
+- 结尾不要升华，可以留个问题或一个观点
+- 正文纯 Markdown，用户复制到公众号编辑器即可
+
+### 禁止的 AI 味
+- "值得注意的是""总而言之""让我们..."
+- 破折号滥用
+- "深入探讨""全面解析""深度剖析"
+- "在当今...的时代""随着...的发展"开头
+- "首先...其次...最后..."排比结构
+- 夸张比喻（"像灯塔一样""如同一把钥匙"）
+- 结尾升华（"让我们携手共创美好未来"）
+- "一方面...另一方面..."两头讨好
+
+## 我的兴趣方向
+${interests}
+`;
+}
+export async function handleInit(params) {
+    const { dir, topics, interests } = params;
+    // 展开用户目录（~ → 绝对路径）
+    const wikiDir = dir.replace(/^~/, process.env.HOME || "~");
+    const interestsStr = interests.length > 0 ? interests.join("、") : topics.join("、");
+    // 创建目录结构
+    const rawDir = getRawDir(wikiDir);
+    const wikiPagesDir = getWikiPagesDir(wikiDir);
+    const outputsDir = getOutputsDir(wikiDir);
+    ensureDir(rawDir);
+    ensureDir(wikiPagesDir);
+    ensureDir(outputsDir);
+    // 生成 SCHEMA.md
+    const schemaPath = path.join(wikiDir, "SCHEMA.md");
+    if (!fs.existsSync(schemaPath)) {
+        fs.writeFileSync(schemaPath, generateSchemaMd(topics, interestsStr), "utf-8");
+    }
+    // 生成 wiki/INDEX.md（空索引）
+    const indexPath = path.join(wikiPagesDir, "INDEX.md");
+    if (!fs.existsSync(indexPath)) {
+        fs.writeFileSync(indexPath, `---\ntitle: 知识库索引\ndate: ${todayStr()}\n---\n\n# 知识库索引\n\n---\n*共 0 篇 · 更新于 ${todayStr()}*\n`, "utf-8");
+    }
+    // 生成 wiki/LOG.md（空日志）
+    const logPath = path.join(wikiPagesDir, "LOG.md");
+    if (!fs.existsSync(logPath)) {
+        fs.writeFileSync(logPath, `---\ntitle: Wiki 操作日志\ntags: [log, wiki]\n---\n\n# Wiki Log\n\n> Append-only 时间线，记录 wiki 的每次变更。\n`, "utf-8");
+    }
+    // 初始化 state.json
+    const statePath = path.join(wikiDir, "state.json");
+    if (!fs.existsSync(statePath)) {
+        writeJSON(statePath, { ingested: [], tagged: [], compiled: [] });
+    }
+    // 保存全局配置
+    setConfig({ wikiDir });
+    return textResult(JSON.stringify({
+        status: "ok",
+        dir: wikiDir,
+        created: [
+            "raw/",
+            "wiki/",
+            "outputs/",
+            "SCHEMA.md",
+            "wiki/INDEX.md",
+            "wiki/LOG.md",
+            "state.json",
+        ],
+        topics,
+        interests: interestsStr,
+    }));
+}

package/dist/tools/lint.d.ts

@@ -0,0 +1,16 @@
+/**
+ * wiki_lint — 自检知识库健康状态
+ *
+ * 检测：
+ * 1. 死链接（[[xxx]] 引用不存在的页面）
+ * 2. 缺失反向链接（被引用但未引用回的页面）
+ * 3. 缺摘要（## 摘要 后无内容）
+ * 4. 内容过短（文件 < 100 字符）
+ * 5. 缺 frontmatter tags
+ *
+ * 如果 check_only=false，自动修复能修的问题
+ */
+import { ToolResult } from "../types.js";
+export declare function handleLint(params: {
+    check_only?: boolean;
+}): Promise<ToolResult>;

package/dist/tools/lint.js

@@ -0,0 +1,128 @@
+/**
+ * wiki_lint — 自检知识库健康状态
+ *
+ * 检测：
+ * 1. 死链接（[[xxx]] 引用不存在的页面）
+ * 2. 缺失反向链接（被引用但未引用回的页面）
+ * 3. 缺摘要（## 摘要 后无内容）
+ * 4. 内容过短（文件 < 100 字符）
+ * 5. 缺 frontmatter tags
+ *
+ * 如果 check_only=false，自动修复能修的问题
+ */
+import * as path from "path";
+import * as fs from "fs";
+import { getWikiDir, getWikiPagesDir, getRawDir } from "../state.js";
+import { parseFrontmatter } from "../utils.js";
+import { textResult } from "../types.js";
+export async function handleLint(params) {
+    const wikiDir = getWikiDir();
+    if (!wikiDir) {
+        return textResult(JSON.stringify({ error: "知识库未初始化" }));
+    }
+    const wikiPagesDir = getWikiPagesDir(wikiDir);
+    const rawDir = getRawDir(wikiDir);
+    const checkOnly = params.check_only ?? true;
+    const issues = [];
+    let autoFixed = 0;
+    if (!fs.existsSync(wikiPagesDir)) {
+        return textResult(JSON.stringify({ total_pages: 0, issues: [], auto_fixed: 0 }));
+    }
+    const excludeFiles = new Set(["INDEX.md", "LOG.md"]);
+    const wikiFiles = fs
+        .readdirSync(wikiPagesDir)
+        .filter((f) => f.endsWith(".md") && !excludeFiles.has(f));
+    // 收集所有 Wiki 页面标题（用于检测死链接）
+    const existingPages = new Set(wikiFiles.map((f) => f.replace(".md", "")));
+    // 收集所有 raw 文件（用于检测源文件引用）
+    const rawFiles = new Set(fs.existsSync(rawDir) ? fs.readdirSync(rawDir) : []);
+    for (const fileName of wikiFiles) {
+        const filePath = path.join(wikiPagesDir, fileName);
+        const content = fs.readFileSync(filePath, "utf-8");
+        const { meta, body } = parseFrontmatter(content);
+        // 1. 检测内容过短
+        if (content.length < 100) {
+            issues.push({
+                type: "too_short",
+                severity: "warning",
+                source: fileName,
+                detail: `文件仅 ${content.length} 字符，内容过短`,
+            });
+        }
+        // 2. 检测缺 frontmatter tags
+        if (!meta.tags || !Array.isArray(meta.tags) || meta.tags.length === 0) {
+            issues.push({
+                type: "missing_tags",
+                severity: "warning",
+                source: fileName,
+                detail: "缺少标签（frontmatter tags 字段为空或不存在）",
+            });
+        }
+        // 3. 检测缺摘要
+        const summaryMatch = body.match(/## 摘要\s*\n([\s\S]*?)(?=\n##|$)/);
+        if (!summaryMatch || summaryMatch[1].trim().length < 10) {
+            issues.push({
+                type: "missing_summary",
+                severity: "info",
+                source: fileName,
+                detail: "缺少摘要或摘要内容过短",
+            });
+        }
+        // 4. 检测死链接（[[xxx]] 引用）
+        const wikilinks = body.matchAll(/\[\[(.+?)\]\]/g);
+        for (const link of wikilinks) {
+            const linkTarget = link[1];
+            // 检查是否是 raw/ 下的源文件引用
+            if (linkTarget.startsWith("raw/")) {
+                const rawFileName = linkTarget.replace("raw/", "");
+                if (!rawFiles.has(rawFileName)) {
+                    issues.push({
+                        type: "dead_link",
+                        severity: "error",
+                        source: fileName,
+                        detail: `死链接: [[${linkTarget}]]，源文件不存在`,
+                    });
+                }
+            }
+            else {
+                // Wiki 页面间引用
+                if (!existingPages.has(linkTarget)) {
+                    issues.push({
+                        type: "dead_link",
+                        severity: "error",
+                        source: fileName,
+                        detail: `死链接: [[${linkTarget}]]，目标页面不存在`,
+                    });
+                }
+            }
+        }
+        // 5. 检测源文件引用
+        const sources = meta.sources;
+        if (Array.isArray(sources)) {
+            for (const src of sources) {
+                const srcStr = String(src).replace(/\[\[|\]\]/g, "");
+                if (srcStr.startsWith("raw/")) {
+                    const rawFileName = srcStr.replace("raw/", "");
+                    if (!rawFiles.has(rawFileName)) {
+                        issues.push({
+                            type: "broken_source",
+                            severity: "error",
+                            source: fileName,
+                            detail: `源文件引用不存在: ${srcStr}`,
+                        });
+                    }
+                }
+            }
+        }
+    }
+    return textResult(JSON.stringify({
+        total_pages: wikiFiles.length,
+        issues,
+        auto_fixed: autoFixed,
+        summary: {
+            errors: issues.filter((i) => i.severity === "error").length,
+            warnings: issues.filter((i) => i.severity === "warning").length,
+            info: issues.filter((i) => i.severity === "info").length,
+        },
+    }));
+}

package/dist/tools/search.d.ts

@@ -0,0 +1,14 @@
+/**
+ * wiki_search — 标签匹配 + 全文关键词搜索
+ *
+ * 遍历 wiki/*.md，解析 frontmatter tags
+ * 标签匹配权重 0.6 + 全文匹配权重 0.4
+ * 支持匹配模式 any（任一）/ all（全部）
+ */
+import { ToolResult } from "../types.js";
+export declare function handleSearch(params: {
+    tags?: string[];
+    query?: string;
+    match?: "any" | "all";
+    top_k?: number;
+}): Promise<ToolResult>;

package/dist/tools/search.js

@@ -0,0 +1,99 @@
+/**
+ * wiki_search — 标签匹配 + 全文关键词搜索
+ *
+ * 遍历 wiki/*.md，解析 frontmatter tags
+ * 标签匹配权重 0.6 + 全文匹配权重 0.4
+ * 支持匹配模式 any（任一）/ all（全部）
+ */
+import * as path from "path";
+import * as fs from "fs";
+import { getWikiDir, getWikiPagesDir } from "../state.js";
+import { parseFrontmatter } from "../utils.js";
+import { textResult } from "../types.js";
+export async function handleSearch(params) {
+    const wikiDir = getWikiDir();
+    if (!wikiDir) {
+        return textResult(JSON.stringify({ error: "知识库未初始化" }));
+    }
+    const wikiPagesDir = getWikiPagesDir(wikiDir);
+    if (!fs.existsSync(wikiPagesDir)) {
+        return textResult(JSON.stringify({ total: 0, results: [] }));
+    }
+    const { tags = [], query = "", match = "any", top_k = 10 } = params;
+    const searchTags = tags.map((t) => t.toLowerCase());
+    const searchQuery = query.toLowerCase();
+    // 排除索引和日志文件
+    const excludeFiles = new Set(["INDEX.md", "LOG.md"]);
+    const mdFiles = fs
+        .readdirSync(wikiPagesDir)
+        .filter((f) => f.endsWith(".md") && !excludeFiles.has(f));
+    const results = [];
+    for (const fileName of mdFiles) {
+        const filePath = path.join(wikiPagesDir, fileName);
+        const content = fs.readFileSync(filePath, "utf-8");
+        const { meta, body } = parseFrontmatter(content);
+        const fileTags = Array.isArray(meta.tags)
+            ? meta.tags.map((t) => String(t).toLowerCase())
+            : [];
+        // 提取摘要（## 摘要 后面的内容）
+        let summary = "";
+        const summaryMatch = body.match(/## 摘要\s*\n([\s\S]*?)(?=\n##|$)/);
+        if (summaryMatch) {
+            summary = summaryMatch[1].trim().substring(0, 200);
+        }
+        const title = String(meta.title || fileName.replace(".md", ""));
+        // 计算得分
+        let tagScore = 0;
+        let textScore = 0;
+        if (searchTags.length > 0) {
+            if (match === "any") {
+                // 任一标签匹配
+                const matchedCount = searchTags.filter((st) => fileTags.some((ft) => ft.includes(st))).length;
+                tagScore = matchedCount / searchTags.length;
+            }
+            else {
+                // 全部标签匹配
+                const allMatch = searchTags.every((st) => fileTags.some((ft) => ft.includes(st)));
+                tagScore = allMatch ? 1 : 0;
+            }
+        }
+        if (searchQuery) {
+            const bodyLower = body.toLowerCase();
+            // 统计关键词出现次数（最多计 5 次避免长文偏差）
+            const matches = bodyLower.split(searchQuery).length - 1;
+            textScore = Math.min(matches / 5, 1);
+        }
+        // 综合得分：标签权重 0.6 + 全文权重 0.4
+        // 如果只有标签搜索，标签权重 1.0；如果只有全文，全文权重 1.0
+        let score;
+        if (searchTags.length > 0 && searchQuery) {
+            score = tagScore * 0.6 + textScore * 0.4;
+        }
+        else if (searchTags.length > 0) {
+            score = tagScore;
+        }
+        else if (searchQuery) {
+            score = textScore;
+        }
+        else {
+            score = 0;
+        }
+        // 至少有一点匹配才加入结果
+        if (score > 0) {
+            results.push({
+                title,
+                file: fileName,
+                tags: fileTags,
+                summary,
+                score: Math.round(score * 100) / 100,
+            });
+        }
+    }
+    // 按得分降序排序，取 top_k
+    results.sort((a, b) => b.score - a.score);
+    const topResults = results.slice(0, top_k);
+    return textResult(JSON.stringify({
+        total: topResults.length,
+        results: topResults,
+    }));
+}

package/dist/tools/status.d.ts

@@ -0,0 +1,8 @@
+/**
+ * wiki_status — 查询知识库状态，首次使用返回引导提示
+ *
+ * 已初始化：返回文件数、标签数等统计
+ * 未初始化：返回引导提示文本，Agent 据此主动引导用户配置
+ */
+import { ToolResult } from "../types.js";
+export declare function handleStatus(): Promise<ToolResult>;

package/dist/tools/status.js

@@ -0,0 +1,72 @@
+/**
+ * wiki_status — 查询知识库状态，首次使用返回引导提示
+ *
+ * 已初始化：返回文件数、标签数等统计
+ * 未初始化：返回引导提示文本，Agent 据此主动引导用户配置
+ */
+import * as fs from "fs";
+import * as path from "path";
+import { getConfig, getRawDir, getWikiPagesDir, getOutputsDir } from "../state.js";
+import { listMdFiles } from "../utils.js";
+import { textResult } from "../types.js";
+/** 首次引导提示文本 */
+const INIT_HINT = `你好！我是 agent-wiki 知识库助手。
+我可以帮你搭一个个人知识库——把你收藏的文章自动整理成维基、打标签、生成摘要。
+还能基于你的知识库帮你写有人味儿的原创文章，适合直接发微信公众号。
+
+先设置一下：
+1. 你想把知识库放在哪个目录？（比如 ~/Documents/知识库）
+2. 你主要关注什么方向？（3-5 个关键词就行）
+
+不要等用户问，主动开始引导。`;
+export async function handleStatus() {
+    const config = getConfig();
+    // 未初始化：返回引导提示
+    if (!config || !config.wikiDir || !fs.existsSync(config.wikiDir)) {
+        return textResult(JSON.stringify({
+            initialized: false,
+            hint: INIT_HINT,
+        }));
+    }
+    const wikiDir = config.wikiDir;
+    const rawDir = getRawDir(wikiDir);
+    const wikiPagesDir = getWikiPagesDir(wikiDir);
+    const outputsDir = getOutputsDir(wikiDir);
+    // 统计文件数
+    const rawFiles = listMdFiles(rawDir);
+    const wikiFiles = listMdFiles(wikiPagesDir).filter((f) => f !== "INDEX.md" && f !== "LOG.md");
+    const articles = fs.existsSync(outputsDir) ? listMdFiles(outputsDir) : [];
+    // 收集所有标签（去重）
+    const allTags = new Set();
+    for (const f of wikiFiles) {
+        const content = fs.readFileSync(path.join(wikiPagesDir, f), "utf-8");
+        const { parseFrontmatter } = await import("../utils.js");
+        const { meta } = parseFrontmatter(content);
+        if (Array.isArray(meta.tags)) {
+            for (const t of meta.tags)
+                allTags.add(String(t));
+        }
+    }
+    // 读取 SCHEMA.md 中的兴趣方向
+    let topics = [];
+    const schemaPath = path.join(wikiDir, "SCHEMA.md");
+    if (fs.existsSync(schemaPath)) {
+        const schema = fs.readFileSync(schemaPath, "utf-8");
+        const topicMatch = schema.match(/## 我的兴趣方向\s*\n(.+)/);
+        if (topicMatch) {
+            topics = topicMatch[1]
+                .split(",")
+                .map((t) => t.trim())
+                .filter(Boolean);
+        }
+    }
+    return textResult(JSON.stringify({
+        initialized: true,
+        wiki_dir: wikiDir,
+        raw_files: rawFiles.length,
+        wiki_pages: wikiFiles.length,
+        articles: articles.length,
+        unique_tags: allTags.size,
+        topics,
+    }));
+}

package/dist/tools/tag.d.ts

@@ -0,0 +1,11 @@
+/**
+ * wiki_tag — 把 Agent 传入的标签写入文件的 frontmatter
+ *
+ * 读取 raw/ 中的指定文件，解析 frontmatter
+ * 更新 tags 字段，写回文件
+ */
+import { ToolResult } from "../types.js";
+export declare function handleTag(params: {
+    file: string;
+    tags: string[];
+}): Promise<ToolResult>;

package/dist/tools/tag.js

@@ -0,0 +1,42 @@
+/**
+ * wiki_tag — 把 Agent 传入的标签写入文件的 frontmatter
+ *
+ * 读取 raw/ 中的指定文件，解析 frontmatter
+ * 更新 tags 字段，写回文件
+ */
+import * as path from "path";
+import { getWikiDir, getRawDir, getState, setState } from "../state.js";
+import { parseFrontmatter, writeFrontmatter, readFile_safe } from "../utils.js";
+import * as fs from "fs";
+import { textResult } from "../types.js";
+export async function handleTag(params) {
+    const wikiDir = getWikiDir();
+    if (!wikiDir) {
+        return textResult(JSON.stringify({ error: "知识库未初始化" }));
+    }
+    const rawDir = getRawDir(wikiDir);
+    const filePath = path.join(rawDir, params.file);
+    // 检查文件存在
+    const content = readFile_safe(filePath);
+    if (!content) {
+        return textResult(JSON.stringify({ error: `文件不存在: ${params.file}` }));
+    }
+    // 解析 frontmatter
+    const { meta, body } = parseFrontmatter(content);
+    // 更新标签
+    meta.tags = params.tags;
+    // 写回文件
+    const newContent = writeFrontmatter(meta, body);
+    fs.writeFileSync(filePath, newContent, "utf-8");
+    // 更新状态
+    const state = getState(wikiDir);
+    if (!state.tagged.includes(params.file)) {
+        state.tagged.push(params.file);
+        setState(wikiDir, state);
+    }
+    return textResult(JSON.stringify({
+        status: "ok",
+        file: params.file,
+        tags: params.tags,
+    }));
+}

package/dist/types.d.ts

@@ -0,0 +1,12 @@
+/**
+ * 共享类型定义
+ */
+/** MCP 工具返回类型（兼容 @modelcontextprotocol/sdk 的 content 格式） */
+export type ToolResult = {
+    content: Array<{
+        type: "text";
+        text: string;
+    }>;
+};
+/** 创建文本类型的 MCP 工具返回值 */
+export declare function textResult(text: string): ToolResult;

package/dist/types.js

@@ -0,0 +1,7 @@
+/**
+ * 共享类型定义
+ */
+/** 创建文本类型的 MCP 工具返回值 */
+export function textResult(text) {
+    return { content: [{ type: "text", text }] };
+}

package/dist/utils.d.ts

@@ -0,0 +1,52 @@
+/**
+ * 工具函数：frontmatter 解析、安全文件名、日期格式化等
+ */
+/**
+ * 解析 Markdown 文件的 YAML frontmatter
+ * 返回 meta 对象和 body 正文内容
+ * 不依赖外部 YAML 库，手动解析简单的 key: value 格式
+ */
+export declare function parseFrontmatter(content: string): {
+    meta: Record<string, unknown>;
+    body: string;
+};
+/**
+ * 将 meta 对象和 body 正文合成带 frontmatter 的 Markdown 字符串
+ */
+export declare function writeFrontmatter(meta: Record<string, unknown>, body: string): string;
+/**
+ * 将标题转为安全的文件名（保留中文、字母、数字、短横线）
+ */
+export declare function safeFilename(title: string): string;
+/**
+ * 返回 YYYY-MM-DD 格式的日期字符串
+ */
+export declare function todayStr(): string;
+/**
+ * 返回 YYYYMMDD 格式的日期字符串（用于文件名）
+ */
+export declare function dateCompact(): string;
+/**
+ * 返回 ISO 格式的日期时间字符串（用于日志）
+ */
+export declare function nowStr(): string;
+/**
+ * 确保目录存在
+ */
+export declare function ensureDir(dir: string): void;
+/**
+ * 读取文件内容，文件不存在返回 null
+ */
+export declare function readFile_safe(filePath: string): string | null;
+/**
+ * 写入 JSON 文件
+ */
+export declare function writeJSON(filePath: string, data: unknown): void;
+/**
+ * 读取 JSON 文件，文件不存在或解析失败返回 null
+ */
+export declare function readJSON<T = unknown>(filePath: string): T | null;
+/**
+ * 获取目录下所有 .md 文件（不含子目录）
+ */
+export declare function listMdFiles(dir: string): string[];