@page.su/ai-blog-cli 0.1.0-beta.1 → 0.1.0-beta.10

package/package.json

@@ -1,10 +1,16 @@
 {
   "name": "@page.su/ai-blog-cli",
-  "version": "0.1.0-beta.1",
+  "version": "0.1.0-beta.10",
   "private": false,
   "description": "CLI tool for AI agents to write, manage, and publish posts on ai-blog.",
   "license": "MIT",
-  "keywords": ["cli", "blog", "ai", "agent", "markdown"],
+  "keywords": [
+    "cli",
+    "blog",
+    "ai",
+    "agent",
+    "markdown"
+  ],
   "author": "苏培森",
   "engines": {
     "node": ">=18"
@@ -29,13 +35,13 @@
     "prepublishOnly": "pnpm build && pnpm test"
   },
   "dependencies": {
-    "commander": "^12.1.0",
-    "zod": "^3.23.8"
+    "commander": "^12.1.0"
   },
   "devDependencies": {
     "@types/node": "^20.0.0",
     "tsx": "^4.19.2",
     "typescript": "^5.5.4",
     "vitest": "^4.1.0"
-  }
-}
+  },
+  "repository": "https://debian.hellosu.top:3000/supeisen/ai-blog.git"
+}

package/dist/index.d.ts

@@ -1,3 +0,0 @@
-#!/usr/bin/env node
-export {};
-//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":""}

package/dist/index.js

@@ -1,100 +0,0 @@
-#!/usr/bin/env node
-import { readFileSync } from "node:fs";
-import { fileURLToPath } from "node:url";
-import { dirname, resolve } from "node:path";
-import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
-import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
-import { createApiClient } from "./api-client.js";
-import { loadMcpServerConfig } from "./config.js";
-/**
- * 从和入口同级的 package.json 读取版本号（编译后 dist/index.js 位于 dist/，
- * package.json 在其上一级目录）。这样后续发新版时只需改 package.json 一处。
- */
-function readOwnVersion() {
-    const distDir = dirname(fileURLToPath(import.meta.url));
-    const pkgPath = resolve(distDir, "..", "package.json");
-    try {
-        const raw = readFileSync(pkgPath, "utf-8");
-        const pkg = JSON.parse(raw);
-        return pkg.version ?? "0.0.0";
-    }
-    catch {
-        return "0.0.0";
-    }
-}
-import { registerBuildTools } from "./tools/build.js";
-import { registerCommentTools } from "./tools/comments.js";
-import { registerDemoTools } from "./tools/demos.js";
-import { registerPostTools } from "./tools/posts.js";
-import { registerTaxonomyTools } from "./tools/taxonomy.js";
-import { registerUploadTools } from "./tools/uploads.js";
-import { registerKnowledgeTools } from "./tools/knowledge.js";
-import { registerScoutTools } from "./tools/scout.js";
-import { registerSeriesTools } from "./tools/series.js";
-import { registerCodeRepoTools } from "./tools/code-repos.js";
-import { registerSyntaxCapabilitiesTools } from "./tools/syntax-capabilities.js";
-import { registerWorkflowTools } from "./tools/workflows.js";
-import { registerSyntaxSpecResources } from "./resources/syntax-spec.js";
-import { registerPrompts } from "./prompts/index.js";
-/**
- * ai-blog MCP server 入口（stdio）。
- *
- * 启动流程：
- *  1. 读取环境变量配置（缺失即直接退出，避免半残运行）
- *  2. 实例化 McpServer，注册 tools / resources
- *  3. 通过 StdioServerTransport 接管 stdin / stdout，进入消息循环
- *
- * 任何运行期错误都会写到 stderr —— 务必避免污染 stdout，
- * 否则会破坏 MCP JSON-RPC 协议帧。
- */
-async function main() {
-    const config = loadMcpServerConfig();
-    const api = createApiClient(config);
-    const serverVersion = readOwnVersion();
-    const server = new McpServer({
-        name: "ai-blog-mcp-server",
-        version: serverVersion,
-    }, {
-        capabilities: {
-            tools: {},
-            resources: {},
-            prompts: {},
-        },
-    });
-    // 注册 tools
-    registerPostTools(server, api);
-    registerDemoTools(server, api);
-    registerCommentTools(server, api);
-    registerTaxonomyTools(server, api);
-    registerKnowledgeTools(server, api);
-    registerBuildTools(server, api);
-    registerUploadTools(server, api);
-    registerScoutTools(server, api);
-    registerSeriesTools(server, api);
-    registerCodeRepoTools(server, api);
-    registerSyntaxCapabilitiesTools(server);
-    registerWorkflowTools(server);
-    // 注册 resources
-    registerSyntaxSpecResources(server, api);
-    // 注册 prompts（写作模板）
-    registerPrompts(server);
-    const transport = new StdioServerTransport();
-    await server.connect(transport);
-    // 友好的退出处理：收到信号时先 close 再退出
-    const shutdown = async (signal) => {
-        process.stderr.write(`[ai-blog-mcp] received ${signal}, shutting down...\n`);
-        try {
-            await server.close();
-        }
-        finally {
-            process.exit(0);
-        }
-    };
-    process.on("SIGINT", () => void shutdown("SIGINT"));
-    process.on("SIGTERM", () => void shutdown("SIGTERM"));
-}
-main().catch((error) => {
-    process.stderr.write(`[ai-blog-mcp] fatal: ${error instanceof Error ? error.message : String(error)}\n`);
-    process.exit(1);
-});
-//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/dist/prompts/index.d.ts

@@ -1,9 +0,0 @@
-import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
-/**
- * 写作辅助类 MCP Prompts。
- *
- * 每个模板在 messages 开头都引导 AI 先调 `describe_workflows` 获取完整工作流路线图，
- * 再按推荐步骤执行。大文章场景引导使用 outline/section 精准读写工作流。
- */
-export declare function registerPrompts(server: McpServer): void;
-//# sourceMappingURL=index.d.ts.map

package/dist/prompts/index.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/prompts/index.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAEzE;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CA4LvD"}

package/dist/prompts/index.js

@@ -1,178 +0,0 @@
-import { z } from "zod";
-/**
- * 写作辅助类 MCP Prompts。
- *
- * 每个模板在 messages 开头都引导 AI 先调 `describe_workflows` 获取完整工作流路线图，
- * 再按推荐步骤执行。大文章场景引导使用 outline/section 精准读写工作流。
- */
-export function registerPrompts(server) {
-    // ─── write-tutorial-post ────────────────────────────────────────────────
-    server.registerPrompt("write-tutorial-post", {
-        title: "Write a tutorial post",
-        description: "技术教程模板：含 callout 提醒、live-demo 多文件代码沙箱、图片配图。",
-        argsSchema: {
-            topic: z.string().describe("教程主题，例如 'React Server Components 入门'"),
-            audience: z
-                .string()
-                .describe("目标读者画像，例如 '有 1-2 年前端经验的工程师'")
-                .optional(),
-        },
-    }, ({ topic, audience }) => ({
-        messages: [
-            {
-                role: "user",
-                content: {
-                    type: "text",
-                    text: [
-                        `请写一篇技术教程文章：${topic}。`,
-                        audience ? `目标读者：${audience}。` : "",
-                        "",
-                        "准备工作（按顺序执行）：",
-                        "0) 先调用 `describe_workflows` 获取完整工作流指南，按 'create-post' 工作流执行。",
-                        "1) 调用 `post.describe_syntax_capabilities` 了解 14 类高级 Markdown 语法（首次写文章时）。",
-                        "2) 调用 `taxonomy.list` 获取合法的 tagIds / categoryIds。",
-                        "3) 可选：调用 `knowledge.find_or_suggest` 查找正文涉及的术语。",
-                        "4) 可选：调用 `scout.search_items` 搜索相关参考资料。",
-                        "",
-                        "写作约束：",
-                        "- 参考语法资源：mcp://syntax-spec/overview、callout、live-demo、image-attributes、checklist",
-                        "- 文章结构推荐：背景动机 → 核心概念 → 渐进式示例（含 ```live-demo） → 常见坑（用 callout） → 总结",
-                        "- 超长文章（>10000字）：先 `post.create` 创建骨架，再用 `post.append_content` 分批追加章节",
-                        "- 写好正文后必须 `post.validate_markdown` 校验，errors 必须修复",
-                        "- 创建为 `status=draft`，让作者决定何时发布",
-                    ]
-                        .filter(Boolean)
-                        .join("\n"),
-                },
-            },
-        ],
-    }));
-    // ─── write-deep-dive ────────────────────────────────────────────────────
-    server.registerPrompt("write-deep-dive", {
-        title: "Write a deep-dive analysis",
-        description: "深度解析模板：含 mermaid 架构图、KaTeX 数学公式、参考文献引用。",
-        argsSchema: {
-            topic: z.string().describe("深度解析的主题"),
-            depthHint: z
-                .string()
-                .describe("希望深入的方向，例如 '内部数据结构与时间复杂度'")
-                .optional(),
-        },
-    }, ({ topic, depthHint }) => ({
-        messages: [
-            {
-                role: "user",
-                content: {
-                    type: "text",
-                    text: [
-                        `请写一篇深度解析文章：${topic}。`,
-                        depthHint ? `重点方向：${depthHint}。` : "",
-                        "",
-                        "准备工作（按顺序执行）：",
-                        "0) 先调用 `describe_workflows` 获取完整工作流指南，按 'create-post' 工作流执行。",
-                        "1) 参考语法资源：mcp://syntax-spec/mermaid、math、footnote、site-post-reference",
-                        "2) 调用 `taxonomy.list` 获取分类和标签。",
-                        "3) 调用 `scout.search_items` 搜索相关论文/文档作为参考资料。",
-                        "",
-                        "写作约束：",
-                        "- 至少包含一个 mermaid 图与一组数学公式",
-                        "- 引用论文/文档用 ```ref 参考文献语法（用 `post.build_reference` 构造），不要用 GFM 脚注",
-                        "- 站内引用前先用 `post.list_for_reference` 校验 slug 存在",
-                        "- 超长文章：先创建骨架，再用 `post.append_content` 分批追加",
-                        "- 写完后 `post.validate_markdown` 校验",
-                        "- 创建为 `status=draft`",
-                    ]
-                        .filter(Boolean)
-                        .join("\n"),
-                },
-            },
-        ],
-    }));
-    // ─── write-changelog ────────────────────────────────────────────────────
-    server.registerPrompt("write-changelog", {
-        title: "Write a changelog post",
-        description: "变更说明模板：版本号 + 三段式（新增/优化/修复）+ 站内引用相关文档。",
-        argsSchema: {
-            version: z.string().describe("版本号，例如 v1.4.0"),
-            highlights: z.string().describe("本次发布要点，逗号或换行分隔").optional(),
-        },
-    }, ({ version, highlights }) => ({
-        messages: [
-            {
-                role: "user",
-                content: {
-                    type: "text",
-                    text: [
-                        `请写一篇 ${version} 的变更说明（changelog）。`,
-                        highlights ? `本次要点：${highlights}` : "",
-                        "",
-                        "准备工作：",
-                        "0) 先调用 `describe_workflows` 获取工作流指南。",
-                        "1) 调用 `taxonomy.list` 获取分类和标签。",
-                        "2) 调用 `post.list_for_reference` 获取站内文章 slug 列表。",
-                        "",
-                        "写作约束：",
-                        "- 标题形如 \"vX.Y.Z 变更说明\"；slug 必须包含版本号",
-                        "- 三段式结构：✨ 新增 / ♻️ 优化 / 🐛 修复，使用三级标题",
-                        "- 涉及到本站文章时，用 [标题](../posts/<slug>) 站内引用（slug 必须从 list_for_reference 获取）",
-                        "- 仅在解释复杂行为变更时插入 callout；其它用项目符号",
-                        "- 创建为 `status=draft`",
-                    ]
-                        .filter(Boolean)
-                        .join("\n"),
-                },
-            },
-        ],
-    }));
-    // ─── rewrite-existing-post ──────────────────────────────────────────────
-    server.registerPrompt("rewrite-existing-post", {
-        title: "Rewrite an existing post",
-        description: "重写已有文章：支持全量重写和章节级精准修改两种模式。",
-        argsSchema: {
-            postId: z.string().describe("要重写的文章 id (uuid)"),
-            intent: z
-                .string()
-                .describe("重写意图，例如 '让结构更清晰，补充 2025 年的最新进展'")
-                .optional(),
-        },
-    }, ({ postId, intent }) => ({
-        messages: [
-            {
-                role: "user",
-                content: {
-                    type: "text",
-                    text: [
-                        `请重写文章（id=${postId}）。`,
-                        intent ? `重写目标：${intent}` : "",
-                        "",
-                        "准备工作：",
-                        "0) 先调用 `describe_workflows` 获取工作流指南。",
-                        "1) 调用 `post.get_outline` 查看文章结构和各章节大小。",
-                        "",
-                        "选择执行模式：",
-                        "",
-                        "【模式 A：章节级精准修改】（推荐，适用于只改部分章节）",
-                        "- 按 'update-section' 工作流执行",
-                        "- 用 `post.get_section(index)` 读取需要修改的章节",
-                        "- 用 `post.replace_section(sectionIndex)` 替换修改后的章节",
-                        "- 用 `post.insert_section` 在指定位置插入新章节",
-                        "- 可重复以上步骤修改多个章节",
-                        "",
-                        "【模式 B：全量重写】（适用于结构大改、整体推翻重来）",
-                        "- 按 'rewrite-post' 工作流执行",
-                        "- 用 `post.get` 读取完整原文",
-                        "- 改写后用 `post.update` 提交完整新版本",
-                        "",
-                        "通用约束：",
-                        "- 保留原 slug 不变（避免外链失效）",
-                        "- 写完后 `post.validate_markdown` 校验，errors 必须 0",
-                        "- 不要主动 update_status 到 published",
-                    ]
-                        .filter(Boolean)
-                        .join("\n"),
-                },
-            },
-        ],
-    }));
-}
-//# sourceMappingURL=index.js.map

package/dist/prompts/index.js.map

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

package/dist/resources/syntax-spec.d.ts

@@ -1,23 +0,0 @@
-import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
-import type { ApiClient } from "../api-client.js";
-/**
- * 把 docs/markdown-advanced-syntax-spec.md 的 13 个章节挂载为 MCP resource。
- *
- * 实现：
- *  - mcp-server 仅注册 URI（如 mcp://syntax-spec/live-demo），不内置文档内容
- *  - 内容来自 ai-blog 后端的 `/api/mcp/syntax-spec/<section>` 端点（按需读取）
- *  - 这样保证 ai-blog 仓库里的 spec 文档变更后，MCP 客户端无需重装 mcp-server
- */
-/** spec 章节定义；section 字段对应 ai-blog 端 `/api/mcp/syntax-spec/<section>` 的最后一段 */
-interface SyntaxSpecSection {
-    uri: string;
-    section: string;
-    name: string;
-    description: string;
-}
-/** 把全部 syntax-spec 章节注册为静态 MCP resource */
-export declare function registerSyntaxSpecResources(server: McpServer, api: ApiClient): void;
-/** 测试用：导出全部章节列表，便于单测断言注册数量与 URI 完整性 */
-export declare const SYNTAX_SPEC_SECTIONS_FOR_TEST: readonly SyntaxSpecSection[];
-export {};
-//# sourceMappingURL=syntax-spec.d.ts.map

package/dist/resources/syntax-spec.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"syntax-spec.d.ts","sourceRoot":"","sources":["../../src/resources/syntax-spec.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACzE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAElD;;;;;;;GAOG;AAEH,8EAA8E;AAC9E,UAAU,iBAAiB;IACzB,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;CACrB;AAoFD,2CAA2C;AAC3C,wBAAgB,2BAA2B,CAAC,MAAM,EAAE,SAAS,EAAE,GAAG,EAAE,SAAS,GAAG,IAAI,CAwBnF;AAED,uCAAuC;AACvC,eAAO,MAAM,6BAA6B,8BAAuB,CAAC"}

package/dist/resources/syntax-spec.js

@@ -1,105 +0,0 @@
-/** 13 个章节（spec 主文档 + checklist 附录） */
-const SYNTAX_SPEC_SECTIONS = [
-    {
-        uri: "mcp://syntax-spec/overview",
-        section: "overview",
-        name: "syntax-spec / overview",
-        description: "ai-blog 12 类非标准语法总览（不超过 800 字）",
-    },
-    {
-        uri: "mcp://syntax-spec/frontmatter",
-        section: "frontmatter",
-        name: "syntax-spec / frontmatter",
-        description: "§1 Frontmatter（YAML）规范",
-    },
-    {
-        uri: "mcp://syntax-spec/callout",
-        section: "callout",
-        name: "syntax-spec / callout",
-        description: "§2 Callout（>[!TIP] 等）规范",
-    },
-    {
-        uri: "mcp://syntax-spec/mermaid",
-        section: "mermaid",
-        name: "syntax-spec / mermaid",
-        description: "§4 Mermaid 图表代码块规范",
-    },
-    {
-        uri: "mcp://syntax-spec/live-demo",
-        section: "live-demo",
-        name: "syntax-spec / live-demo",
-        description: "§5 Live Demo 多文件代码块规范（含 tailwind / cdn meta）",
-    },
-    {
-        uri: "mcp://syntax-spec/math",
-        section: "math",
-        name: "syntax-spec / math",
-        description: "§6 数学公式 $..$ / $$..$$ 规范",
-    },
-    {
-        uri: "mcp://syntax-spec/image-attributes",
-        section: "image-attributes",
-        name: "syntax-spec / image-attributes",
-        description: "§7 图片扩展属性（title 编码 w= / align= / ratio= 等）",
-    },
-    {
-        uri: "mcp://syntax-spec/image-gallery",
-        section: "image-gallery",
-        name: "syntax-spec / image-gallery",
-        description: "§8 图片宫格自动检测规则",
-    },
-    {
-        uri: "mcp://syntax-spec/image-whitelist",
-        section: "image-whitelist",
-        name: "syntax-spec / image-whitelist",
-        description: "§9 图片 src 白名单（前台严格模式）",
-    },
-    {
-        uri: "mcp://syntax-spec/url-whitelist",
-        section: "url-whitelist",
-        name: "syntax-spec / url-whitelist",
-        description: "§10 URL 协议白名单（链接）",
-    },
-    {
-        uri: "mcp://syntax-spec/footnote",
-        section: "footnote",
-        name: "syntax-spec / footnote",
-        description: "§11 GFM 脚注规范",
-    },
-    {
-        uri: "mcp://syntax-spec/site-post-reference",
-        section: "site-post-reference",
-        name: "syntax-spec / site-post-reference",
-        description: "§12 站内文章引用 [标题](../posts/<slug>) 规范",
-    },
-    {
-        uri: "mcp://syntax-spec/checklist",
-        section: "checklist",
-        name: "syntax-spec / checklist",
-        description: "附录 D：保存前 Checklist（AI 自检清单）",
-    },
-];
-/** 把全部 syntax-spec 章节注册为静态 MCP resource */
-export function registerSyntaxSpecResources(server, api) {
-    for (const section of SYNTAX_SPEC_SECTIONS) {
-        server.registerResource(section.name, section.uri, {
-            title: section.name,
-            description: section.description,
-            mimeType: "text/markdown",
-        }, async (uri) => {
-            const text = await api.getText(`/api/mcp/syntax-spec/${section.section}`);
-            return {
-                contents: [
-                    {
-                        uri: uri.href,
-                        mimeType: "text/markdown",
-                        text,
-                    },
-                ],
-            };
-        });
-    }
-}
-/** 测试用：导出全部章节列表，便于单测断言注册数量与 URI 完整性 */
-export const SYNTAX_SPEC_SECTIONS_FOR_TEST = SYNTAX_SPEC_SECTIONS;
-//# sourceMappingURL=syntax-spec.js.map

package/dist/resources/syntax-spec.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"syntax-spec.js","sourceRoot":"","sources":["../../src/resources/syntax-spec.ts"],"names":[],"mappings":"AAoBA,sCAAsC;AACtC,MAAM,oBAAoB,GAAiC;IACzD;QACE,GAAG,EAAE,4BAA4B;QACjC,OAAO,EAAE,UAAU;QACnB,IAAI,EAAE,wBAAwB;QAC9B,WAAW,EAAE,gCAAgC;KAC9C;IACD;QACE,GAAG,EAAE,+BAA+B;QACpC,OAAO,EAAE,aAAa;QACtB,IAAI,EAAE,2BAA2B;QACjC,WAAW,EAAE,wBAAwB;KACtC;IACD;QACE,GAAG,EAAE,2BAA2B;QAChC,OAAO,EAAE,SAAS;QAClB,IAAI,EAAE,uBAAuB;QAC7B,WAAW,EAAE,yBAAyB;KACvC;IACD;QACE,GAAG,EAAE,2BAA2B;QAChC,OAAO,EAAE,SAAS;QAClB,IAAI,EAAE,uBAAuB;QAC7B,WAAW,EAAE,oBAAoB;KAClC;IACD;QACE,GAAG,EAAE,6BAA6B;QAClC,OAAO,EAAE,WAAW;QACpB,IAAI,EAAE,yBAAyB;QAC/B,WAAW,EAAE,8CAA8C;KAC5D;IACD;QACE,GAAG,EAAE,wBAAwB;QAC7B,OAAO,EAAE,MAAM;QACf,IAAI,EAAE,oBAAoB;QAC1B,WAAW,EAAE,0BAA0B;KACxC;IACD;QACE,GAAG,EAAE,oCAAoC;QACzC,OAAO,EAAE,kBAAkB;QAC3B,IAAI,EAAE,gCAAgC;QACtC,WAAW,EAAE,4CAA4C;KAC1D;IACD;QACE,GAAG,EAAE,iCAAiC;QACtC,OAAO,EAAE,eAAe;QACxB,IAAI,EAAE,6BAA6B;QACnC,WAAW,EAAE,eAAe;KAC7B;IACD;QACE,GAAG,EAAE,mCAAmC;QACxC,OAAO,EAAE,iBAAiB;QAC1B,IAAI,EAAE,+BAA+B;QACrC,WAAW,EAAE,uBAAuB;KACrC;IACD;QACE,GAAG,EAAE,iCAAiC;QACtC,OAAO,EAAE,eAAe;QACxB,IAAI,EAAE,6BAA6B;QACnC,WAAW,EAAE,mBAAmB;KACjC;IACD;QACE,GAAG,EAAE,4BAA4B;QACjC,OAAO,EAAE,UAAU;QACnB,IAAI,EAAE,wBAAwB;QAC9B,WAAW,EAAE,cAAc;KAC5B;IACD;QACE,GAAG,EAAE,uCAAuC;QAC5C,OAAO,EAAE,qBAAqB;QAC9B,IAAI,EAAE,mCAAmC;QACzC,WAAW,EAAE,qCAAqC;KACnD;IACD;QACE,GAAG,EAAE,6BAA6B;QAClC,OAAO,EAAE,WAAW;QACpB,IAAI,EAAE,yBAAyB;QAC/B,WAAW,EAAE,6BAA6B;KAC3C;CACF,CAAC;AAEF,2CAA2C;AAC3C,MAAM,UAAU,2BAA2B,CAAC,MAAiB,EAAE,GAAc;IAC3E,KAAK,MAAM,OAAO,IAAI,oBAAoB,EAAE,CAAC;QAC3C,MAAM,CAAC,gBAAgB,CACrB,OAAO,CAAC,IAAI,EACZ,OAAO,CAAC,GAAG,EACX;YACE,KAAK,EAAE,OAAO,CAAC,IAAI;YACnB,WAAW,EAAE,OAAO,CAAC,WAAW;YAChC,QAAQ,EAAE,eAAe;SAC1B,EACD,KAAK,EAAE,GAAG,EAAE,EAAE;YACZ,MAAM,IAAI,GAAG,MAAM,GAAG,CAAC,OAAO,CAAC,wBAAwB,OAAO,CAAC,OAAO,EAAE,CAAC,CAAC;YAC1E,OAAO;gBACL,QAAQ,EAAE;oBACR;wBACE,GAAG,EAAE,GAAG,CAAC,IAAI;wBACb,QAAQ,EAAE,eAAe;wBACzB,IAAI;qBACL;iBACF;aACF,CAAC;QACJ,CAAC,CACF,CAAC;IACJ,CAAC;AACH,CAAC;AAED,uCAAuC;AACvC,MAAM,CAAC,MAAM,6BAA6B,GAAG,oBAAoB,CAAC"}

package/dist/resources/syntax-spec.test.d.ts

@@ -1,2 +0,0 @@
-export {};
-//# sourceMappingURL=syntax-spec.test.d.ts.map

package/dist/resources/syntax-spec.test.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"syntax-spec.test.d.ts","sourceRoot":"","sources":["../../src/resources/syntax-spec.test.ts"],"names":[],"mappings":""}

package/dist/resources/syntax-spec.test.js

@@ -1,47 +0,0 @@
-import { describe, expect, it } from "vitest";
-import { SYNTAX_SPEC_SECTIONS_FOR_TEST } from "./syntax-spec.js";
-/**
- * 验证 syntax-spec resource 列表：
- *  - 共 13 条（与 spec 文档章节一一对应）
- *  - URI 形如 mcp://syntax-spec/<section>
- *  - section slug 在 ai-blog 后端的 SECTION_HEADING_MAP 范围内
- *
- * 这里不做"读真实文档"的端到端测试（属于 P1.5 集成测试范畴），
- * 仅做静态契约校验，确保两端 section 定义不漂移。
- */
-const EXPECTED_SLUGS = [
-    "overview",
-    "frontmatter",
-    "callout",
-    "mermaid",
-    "live-demo",
-    "math",
-    "image-attributes",
-    "image-gallery",
-    "image-whitelist",
-    "url-whitelist",
-    "footnote",
-    "site-post-reference",
-    "checklist",
-];
-describe("SYNTAX_SPEC_SECTIONS_FOR_TEST", () => {
-    it("正好 13 个章节", () => {
-        expect(SYNTAX_SPEC_SECTIONS_FOR_TEST).toHaveLength(13);
-    });
-    it("section slug 与后端 SECTION_HEADING_MAP 完全一致", () => {
-        const slugs = SYNTAX_SPEC_SECTIONS_FOR_TEST.map((section) => section.section);
-        expect(slugs.sort()).toEqual([...EXPECTED_SLUGS].sort());
-    });
-    it("URI 形如 mcp://syntax-spec/<section>", () => {
-        for (const section of SYNTAX_SPEC_SECTIONS_FOR_TEST) {
-            expect(section.uri).toBe(`mcp://syntax-spec/${section.section}`);
-        }
-    });
-    it("name / description 都非空", () => {
-        for (const section of SYNTAX_SPEC_SECTIONS_FOR_TEST) {
-            expect(section.name.length).toBeGreaterThan(0);
-            expect(section.description.length).toBeGreaterThan(0);
-        }
-    });
-});
-//# sourceMappingURL=syntax-spec.test.js.map

package/dist/resources/syntax-spec.test.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"syntax-spec.test.js","sourceRoot":"","sources":["../../src/resources/syntax-spec.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AAC9C,OAAO,EAAE,6BAA6B,EAAE,MAAM,kBAAkB,CAAC;AAEjE;;;;;;;;GAQG;AAEH,MAAM,cAAc,GAAG;IACrB,UAAU;IACV,aAAa;IACb,SAAS;IACT,SAAS;IACT,WAAW;IACX,MAAM;IACN,kBAAkB;IAClB,eAAe;IACf,iBAAiB;IACjB,eAAe;IACf,UAAU;IACV,qBAAqB;IACrB,WAAW;CACZ,CAAC;AAEF,QAAQ,CAAC,+BAA+B,EAAE,GAAG,EAAE;IAC7C,EAAE,CAAC,WAAW,EAAE,GAAG,EAAE;QACnB,MAAM,CAAC,6BAA6B,CAAC,CAAC,YAAY,CAAC,EAAE,CAAC,CAAC;IACzD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,2CAA2C,EAAE,GAAG,EAAE;QACnD,MAAM,KAAK,GAAG,6BAA6B,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;QAC9E,MAAM,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC,GAAG,cAAc,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;IAC3D,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,oCAAoC,EAAE,GAAG,EAAE;QAC5C,KAAK,MAAM,OAAO,IAAI,6BAA6B,EAAE,CAAC;YACpD,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,qBAAqB,OAAO,CAAC,OAAO,EAAE,CAAC,CAAC;QACnE,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,wBAAwB,EAAE,GAAG,EAAE;QAChC,KAAK,MAAM,OAAO,IAAI,6BAA6B,EAAE,CAAC;YACpD,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC;YAC/C,MAAM,CAAC,OAAO,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC;QACxD,CAAC;IACH,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/tools/build.d.ts

@@ -1,13 +0,0 @@
-import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
-import type { ApiClient } from "../api-client.js";
-/**
- * 高级语法构造工具：post.build_frontmatter / build_live_demo / build_image
- *
- * 设计要点：
- *  - mcp-server **不直接 import** ai-blog 项目里的 ts 文件（避免路径耦合 + 打包难题）
- *  - 全部通过 HTTP 调用 ai-blog 后端的 `/api/mcp/build/*` 端点，复用真正的
- *    `buildLiveDemoBlockText` / `serializeImageAttributes` 等函数
- *  - 工具返回的字符串是"可以原样写进文章"的 markdown 片段
- */
-export declare function registerBuildTools(server: McpServer, api: ApiClient): void;
-//# sourceMappingURL=build.d.ts.map

package/dist/tools/build.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"build.d.ts","sourceRoot":"","sources":["../../src/tools/build.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACzE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAGlD;;;;;;;;GAQG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,SAAS,EAAE,GAAG,EAAE,SAAS,GAAG,IAAI,CAyN1E"}