@page.su/ai-blog-cli 0.1.0-beta.4 → 0.1.0-beta.5

package/dist/cli.js

@@ -15,6 +15,7 @@ import { registerSeriesCommands } from "./commands/series.js";
 import { registerTaxonomyCommands } from "./commands/taxonomy.js";
 import { registerCommentCommands } from "./commands/comments.js";
 import { registerUploadCommands } from "./commands/uploads.js";
+import { registerSyntaxCommands } from "./commands/syntax.js";
 import { registerSkillsCommand } from "./commands/skills.js";
 function readOwnVersion() {
     const distDir = dirname(fileURLToPath(import.meta.url));
@@ -64,6 +65,7 @@ async function main() {
     registerTaxonomyCommands(program, api);
     registerCommentCommands(program, api);
     registerUploadCommands(program, api);
+    registerSyntaxCommands(program, api);
     registerSkillsCommand(program);
     program.parse();
 }

package/dist/cli.js.map

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

package/dist/commands/skills.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"skills.d.ts","sourceRoot":"","sources":["../../src/commands/skills.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAyEzC,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAO5D"}
+{"version":3,"file":"skills.d.ts","sourceRoot":"","sources":["../../src/commands/skills.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AA0GzC,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAO5D"}

package/dist/commands/skills.js

@@ -1,5 +1,5 @@
 /**
- * Agent skills 速查表 (~500 tokens)。
+ * Agent skills 速查表 (~600 tokens)。
  *
  * 适合注入 Agent system prompt，让 Agent 快速了解可用命令。
  * Agent 不确定用法时调 `aib <command> --help` 按需获取详情。
@@ -26,6 +26,48 @@ Env: AI_BLOG_BASE_URL + AI_BLOG_PAT
 4. \`aib post append <id> --content-file chapter.md\` — append new chapter
 5. \`aib post insert-section <id> --after-index 2 --content-file section.md\` — insert
 
+## Advanced Markdown syntax
+Use these in post content for rich rendering. Build with \`aib build\` or write directly.
+Sections: overview, frontmatter, callout, mermaid, live-demo, math, image-attributes, image-gallery, footnote, site-post-reference
+Read full docs: \`aib syntax get live-demo\` or \`aib syntax get math\`
+
+### Reference (academic/blog citations)
+\`\`\`ref key=vaswani2017 title="Attention Is All You Need" type=paper
+Authors: Vaswani et al. | Source: NeurIPS 2017 | URL: https://arxiv.org/abs/1706.03762
+\`\`\`
+Build: \`aib build reference --key "..." --title "..." --type paper --url "..." --authors "..." --source "..." --json\`
+
+### Live Demo (interactive iframe sandbox)
+\`\`\`live-demo title="Counter" tailwind height=300
+/* @tab index.html */ <button>Click</button>
+/* @tab script.js */ console.log('hi')
+\`\`\`
+Build: \`aib build live-demo --title "..." --files-file files.json --tailwind --height 300\`
+
+### Code Group (multi-tab code switcher)
+\`\`\`code-group
+/* @tab TypeScript */ const x: number = 1;
+/* @tab JavaScript */ var x = 1;
+\`\`\`
+Build: \`aib build code-group tabs.json\` (tabs.json: [{label, lang?, code}])
+
+### Details (folding block)
+:::details title="Expand for details"
+Hidden content here
+:::
+Build: \`aib build details --title "..." --content-file body.md\`
+
+### Timeline
+:::timeline
+- time: 2017 | title: Transformer | content: Attention mechanism
+- time: 2020 | title: GPT-3 | active: true
+:::
+Build: \`aib build timeline --events-file events.json\`
+
+### Image (with width/align/ratio)
+![alt text](/api/assets/oss/image.png){width=50 align=center ratio=16:9}
+Build: \`aib build image --url "..." --alt "..." --width 50 --align center\`
+
 ## Demos (interactive code sandboxes)
 - \`aib demo list <postId>\` — list demos (slot, title, file sizes)
 - \`aib demo get-file <postId> <slot> <fileName>\` — read single file (preferred)
@@ -51,15 +93,6 @@ Env: AI_BLOG_BASE_URL + AI_BLOG_PAT
 - \`aib series create --slug "guide" --title "Guide"\`
 - \`aib series add-post <seriesId> <postId>\`
 
-## Build syntax blocks
-- \`aib build frontmatter --title "..." --status draft\`
-- \`aib build image --url "..." --alt "..." --width 50\`
-- \`aib build reference --key "vaswani2017" --title "..." --type paper\`
-- \`aib build live-demo --title "Demo" --files-file files.json\`
-- \`aib build code-group tabs.json\`
-- \`aib build details --title "Details" --content-file body.md\`
-- \`aib build timeline --events-file events.json\`
-
 ## Upload images
 - \`aib upload image-from-url <url>\` — upload to blog OSS
 
@@ -71,7 +104,7 @@ Env: AI_BLOG_BASE_URL + AI_BLOG_PAT
 export function registerSkillsCommand(program) {
     program
         .command("skills")
-        .description("Output a lightweight skills reference for Agent system prompts (~500 tokens)")
+        .description("Output a lightweight skills reference for Agent system prompts (~600 tokens)")
         .action(() => {
         console.log(SKILLS_MD);
     });

package/dist/commands/skills.js.map

@@ -1 +1 @@
-{"version":3,"file":"skills.js","sourceRoot":"","sources":["../../src/commands/skills.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;GAUG;AACH,MAAM,SAAS,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;mDA0DiC,CAAC;AAEpD,MAAM,UAAU,qBAAqB,CAAC,OAAgB;IACpD,OAAO;SACJ,OAAO,CAAC,QAAQ,CAAC;SACjB,WAAW,CAAC,8EAA8E,CAAC;SAC3F,MAAM,CAAC,GAAG,EAAE;QACX,OAAO,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;IACzB,CAAC,CAAC,CAAC;AACP,CAAC"}
+{"version":3,"file":"skills.js","sourceRoot":"","sources":["../../src/commands/skills.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;GAUG;AACH,MAAM,SAAS,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;mDA2FiC,CAAC;AAEpD,MAAM,UAAU,qBAAqB,CAAC,OAAgB;IACpD,OAAO;SACJ,OAAO,CAAC,QAAQ,CAAC;SACjB,WAAW,CAAC,8EAA8E,CAAC;SAC3F,MAAM,CAAC,GAAG,EAAE;QACX,OAAO,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;IACzB,CAAC,CAAC,CAAC;AACP,CAAC"}

package/dist/commands/syntax.d.ts

@@ -0,0 +1,4 @@
+import type { Command } from "commander";
+import type { ApiClient } from "../api-client.js";
+export declare function registerSyntaxCommands(program: Command, api: ApiClient): void;
+//# sourceMappingURL=syntax.d.ts.map

package/dist/commands/syntax.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"syntax.d.ts","sourceRoot":"","sources":["../../src/commands/syntax.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACzC,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAGlD,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,OAAO,EAAE,GAAG,EAAE,SAAS,GAAG,IAAI,CA2B7E"}

package/dist/commands/syntax.js

@@ -0,0 +1,29 @@
+import { run, isJson } from "./helpers.js";
+export function registerSyntaxCommands(program, api) {
+    const syntax = program
+        .command("syntax")
+        .description("Read advanced Markdown syntax documentation");
+    // ── syntax list ──
+    syntax
+        .command("list")
+        .description("List all syntax spec sections (names + descriptions)")
+        .option("--json", "Output as JSON")
+        .action(async (opts) => {
+        await run(() => api.get("/api/cli/syntax-spec/overview"), isJson(opts));
+    });
+    // ── syntax get <section> ──
+    syntax
+        .command("get <section>")
+        .description("Read a single syntax spec section (full documentation)")
+        .option("--json", "Output as JSON")
+        .action(async (section, opts) => {
+        const text = await api.getText(`/api/cli/syntax-spec/${encodeURIComponent(section)}`);
+        if (isJson(opts)) {
+            console.log(JSON.stringify({ section, content: text }));
+        }
+        else {
+            console.log(text);
+        }
+    });
+}
+//# sourceMappingURL=syntax.js.map

package/dist/commands/syntax.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"syntax.js","sourceRoot":"","sources":["../../src/commands/syntax.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAE3C,MAAM,UAAU,sBAAsB,CAAC,OAAgB,EAAE,GAAc;IACrE,MAAM,MAAM,GAAG,OAAO;SACnB,OAAO,CAAC,QAAQ,CAAC;SACjB,WAAW,CAAC,6CAA6C,CAAC,CAAC;IAE9D,oBAAoB;IACpB,MAAM;SACH,OAAO,CAAC,MAAM,CAAC;SACf,WAAW,CAAC,sDAAsD,CAAC;SACnE,MAAM,CAAC,QAAQ,EAAE,gBAAgB,CAAC;SAClC,MAAM,CAAC,KAAK,EAAE,IAAI,EAAE,EAAE;QACrB,MAAM,GAAG,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,+BAA+B,CAAC,EAAE,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC;IAC1E,CAAC,CAAC,CAAC;IAEL,6BAA6B;IAC7B,MAAM;SACH,OAAO,CAAC,eAAe,CAAC;SACxB,WAAW,CAAC,wDAAwD,CAAC;SACrE,MAAM,CAAC,QAAQ,EAAE,gBAAgB,CAAC;SAClC,MAAM,CAAC,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,EAAE;QAC9B,MAAM,IAAI,GAAG,MAAM,GAAG,CAAC,OAAO,CAAC,wBAAwB,kBAAkB,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;QACtF,IAAI,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC;YACjB,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;QAC1D,CAAC;aAAM,CAAC;YACN,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QACpB,CAAC;IACH,CAAC,CAAC,CAAC;AACP,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@page.su/ai-blog-cli",
-  "version": "0.1.0-beta.4",
+  "version": "0.1.0-beta.5",
   "private": false,
   "description": "CLI tool for AI agents to write, manage, and publish posts on ai-blog.",
   "license": "MIT",
@@ -42,5 +42,6 @@
     "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"}