@blueking/chat-x 0.0.43 → 0.0.45-beta.2

package/dist/mcp/generated/docs/interrupt.md

@@ -0,0 +1,282 @@
+<!-- AI SUMMARY -->
+## 快速了解
+
+定义 RunFinishedOutcome、BaseInterrupt、AIDevToolApprovalInterrupt、UserQuestionInterrupt、BaseResume、InterruptMessage 与 OnInterruptResume。 与 MessageRole.Interrupt、InterruptMessageRender、UserQuestionCard、ToolApprovalCard 配合，对应 RUN_FINISHED outcome。
+
+### 关联组件
+- **interrupt-message** — 根据 outcome.interrupts 与 reason 渲染中断 UI，success 时回显 UserQuestion 回答
+- **user-question-card** — UserQuestion 交互面板，挂载在 ChatInput 上方
+- **tool-approval-card** — AIDevToolApproval 专用卡片
+- **message-render** — role 为 interrupt 时派发 InterruptMessageRender
+
+---
+<!-- FULL DOC -->
+
+# 中断类型 Interrupt
+
+> **分类**：type
+
+AG-UI [Interrupts](https://docs.ag-ui.com/drafts/interrupts) 协议相关类型，定义在 `src/ag-ui/types/interrupt.ts`，由 `@blueking/chat-x` 导出。
+
+中断链路分为两段：
+
+1. Agent 返回 `RUN_FINISHED { outcome: { type: 'interrupt', interrupts } }`，前端渲染等待用户处理的 UI。
+2. 用户操作后调用 `onInterruptResume(payload, interrupt)`，业务侧将 `payload` 作为 `RunAgentInput.resume` 回传给 Agent。
+
+## RunFinishedOutcome
+
+`RUN_FINISHED` 事件的 `outcome` 联合类型：
+
+```typescript
+type RunFinishedOutcome =
+  | { interrupts: Interrupt[]; type: 'interrupt' }
+  | { type: 'success' };
+```
+
+| `type`        | 说明                                                                 |
+| ------------- | -------------------------------------------------------------------- |
+| `'interrupt'` | 等待用户响应；`interrupts` 驱动 UI 渲染审批卡片、用户问题面板等       |
+| `'success'`   | 用户已通过 `resume` 处理；若 `result.reason === UserQuestion` 则回显回答内容 |
+
+## BaseInterrupt
+
+所有中断项的公共结构：
+
+```typescript
+type BaseInterrupt<T extends InterruptReason, M extends Record<string, any>> = {
+  expiresAt?: string;
+  id: string;
+  message?: string;
+  metadata?: M;
+  properties?: Record<string, any>;
+  reason: T;
+  toolCallId: string;
+};
+```
+
+## AIDevToolApprovalInterrupt
+
+AI Dev 第三方工具审批中断，`reason` 为 `InterruptReason.AIDevToolApproval`（`'aidev:tool_approval'`）：
+
+```typescript
+type AIDevToolApprovalInterrupt = BaseInterrupt<
+  InterruptReason.AIDevToolApproval,
+  {
+    ticket: {
+      approvers: string[];
+      sn: string;
+      status: APPROVAL_STATUS;
+      submit_time: string;
+      title: string;
+      url: string;
+    };
+  }
+>;
+```
+
+## UserQuestionInterrupt
+
+用户回答问题中断，`reason` 为 `InterruptReason.UserQuestion`（`'aidev:user_question'`）。交互面板由 `ChatContainer` 挂载到 `ChatInput` 上方。
+
+```typescript
+type UserQuestionInterrupt = BaseInterrupt<
+  InterruptReason.UserQuestion,
+  {
+    questions: UserQuestionItem[];
+  }
+>;
+
+type UserQuestionItem = {
+  header: string;
+  /** 是否多选；仅选择题语义，自定义表单类问题可不传 */
+  multiSelect?: boolean;
+  options?: UserQuestionOptionItem[];
+  question: string;
+};
+
+type UserQuestionOptionItem = {
+  description: string;
+  label: string;
+};
+```
+
+约定：
+
+- `multiSelect: false` 表示单选题，`true` 表示多选题；**不传**时 UI 不展示单选/多选标签，默认选择题组件仍按单选行为处理。
+- 前端会为每道**选择题**追加 `label: 'others'` 的自由输入项；后端无需重复下发该选项。
+- 当用户选择 Others 时，`answer[].description` 为用户输入文本。
+- 业务可通过 `UserQuestionCard` 的 `#question` slot 渲染自定义表单；作答有效时调用 `setAnswer` 回传 `UserQuestionAnswerItem`，无效时传 `undefined`。
+
+## Interrupt
+
+当前支持的中断联合类型：
+
+```typescript
+type Interrupt =
+  | AIDevToolApprovalInterrupt
+  | UserQuestionInterrupt
+  | BaseInterrupt<InterruptReason, Record<string, any>>;
+```
+
+## BaseResume / UserQuestionResume
+
+`UserQuestion` 的 resume payload 为单个对象，与 `chat-helper` 的 `IResume` 保持一致：
+
+```typescript
+type BaseResume<T extends InterruptReason, P extends Record<string, any>> = {
+  interruptId: string;
+  payload: P;
+  reason: T;
+  status: 'cancelled' | 'resolved';
+};
+
+type UserQuestionAnswerItem = {
+  answer: UserQuestionOptionItem[];
+  multiSelect?: boolean;
+  question: string;
+};
+
+type UserQuestionResume = BaseResume<
+  InterruptReason.UserQuestion,
+  {
+    answers: UserQuestionAnswerItem[];
+  }
+>;
+```
+
+示例：
+
+```typescript
+const resume: UserQuestionResume = {
+  interruptId: 'interrupt_user_question',
+  reason: InterruptReason.UserQuestion,
+  status: 'resolved',
+  payload: {
+    answers: [
+      {
+        question: '请选择语言',
+        multiSelect: true,
+        answer: [
+          { label: 'Java', description: 'Java' },
+          { label: 'others', description: 'Rust' },
+        ],
+      },
+    ],
+  },
+};
+```
+
+## InterruptMessage
+
+`MessageRole.Interrupt` 对应的消息类型，`content` 承载 outcome、可选说明文案与 resume 结果：
+
+```typescript
+type InterruptMessage = BaseMessage<
+  MessageRole.Interrupt,
+  {
+    message?: string;
+    outcome?: RunFinishedOutcome;
+    result?: BaseResume<InterruptReason>;
+    runId?: string;
+    threadId?: string;
+  }
+>;
+```
+
+| 字段       | 说明                                                         |
+| ---------- | ------------------------------------------------------------ |
+| `message`  | 消息组顶部可选说明文案，由 `InterruptMessageRender` 展示     |
+| `outcome`  | `type: 'interrupt'` 时从 `interrupts` 渲染交互；`success` 时进入已处理态 |
+| `result`   | 用户 resume 后回传的单对象 payload；`UserQuestion` 会用于会话内回显 |
+| `runId`    | 关联 AG-UI run 标识                                          |
+| `threadId` | 关联会话线程标识                                             |
+
+## OnInterruptResume
+
+用户完成中断操作后的回调（由 `ChatContainer` / `MessageContainer` / `MessageRender` 透传）：
+
+```typescript
+type OnInterruptResume = (
+  payload: InterruptResume,
+  interrupt: Interrupt,
+) => Promise<void> | void;
+```
+
+| 参数        | 说明                                                                       |
+| ----------- | -------------------------------------------------------------------------- |
+| `payload`   | 用户操作产生的 resume 负载；审批取消为 `{ action: 'cancel' }`，用户问题为 `UserQuestionResume` |
+| `interrupt` | 原始中断项，业务侧可读取 `interrupt.id`、`toolCallId`、`metadata` 等上下文 |
+
+## 使用示例
+
+```typescript
+import {
+  APPROVAL_STATUS,
+  InterruptReason,
+  MessageRole,
+  MessageStatus,
+  type InterruptMessage,
+  type OnInterruptResume,
+} from '@blueking/chat-x';
+
+const message: InterruptMessage = {
+  id: 'msg_interrupt_1',
+  messageId: 'msg_interrupt_1',
+  role: MessageRole.Interrupt,
+  status: MessageStatus.Pending,
+  content: {
+    message: '需要您处理以下中断',
+    outcome: {
+      type: 'interrupt',
+      interrupts: [
+        {
+          id: 'interrupt_approval_1',
+          reason: InterruptReason.AIDevToolApproval,
+          toolCallId: 'tool_call_approval_1',
+          metadata: {
+            ticket: {
+              approvers: ['张三'],
+              sn: 'REV-2026-04-24-001',
+              status: APPROVAL_STATUS.PENDING,
+              submit_time: '2026-04-24 14:30:15',
+              title: '算法方案评审单',
+              url: 'https://example.com/tickets/REV-2026-04-24-001',
+            },
+          },
+        },
+        {
+          id: 'interrupt_question_1',
+          reason: InterruptReason.UserQuestion,
+          toolCallId: 'tool_call_question_1',
+          message: '请选择实现方案',
+          metadata: {
+            questions: [
+              {
+                header: '请选择实现方案',
+                multiSelect: false,
+                question: '你希望采用哪种排序实现？',
+                options: [
+                  { label: 'basic', description: '基础冒泡排序' },
+                  { label: 'optimized', description: '提前终止优化版' },
+                ],
+              },
+            ],
+          },
+        },
+      ],
+    },
+  },
+};
+
+const handleInterruptResume: OnInterruptResume = async (payload, interrupt) => {
+  console.log('resume', interrupt.id, payload);
+};
+```
+
+## 关联文档
+
+- [常量枚举 Constants](./constants.md) — `InterruptReason`、`APPROVAL_STATUS`
+- [消息类型 Messages](./messages.md) — `InterruptMessage` 在消息联合类型中的位置
+- [InterruptMessage 中断消息](../components/agent/interrupt-message)
+- [UserQuestionCard 用户问题中断](../components/agent/user-question-card)
+- [ToolApprovalCard 审批卡片](../components/agent/tool-approval-card)

package/dist/mcp/generated/docs/key-value-content.md

@@ -1,7 +1,7 @@
 <!-- AI SUMMARY -->
 ## 快速了解
 
-KeyValueContent 以多行 key : value 形式展示结构化数据，可选标题栏与 ThinkingIcon。 常见于用户消息等需要表格化键值的气泡展示。
+以键值列表展示结构化内容。 源码位置：src/components/chat-content/key-value-content/key-value-content.vue。
 
 ### 关联组件
 - **user-message** — 用户消息内展示结构化附加信息
@@ -10,10 +10,15 @@ KeyValueContent 以多行 key : value 形式展示结构化数据，可选标题
 <!-- FULL DOC -->
 
 # KeyValueContent 键值对内容
+## 源码事实
 
-> **层级**：原子组件 · **功能域**：辅助组件
+- **源码位置**：`src/components/chat-content/key-value-content/key-value-content.vue`
+- **能力域**：内容渲染
+- **能力说明**：以键值列表展示结构化内容。
 
-键值对列表展示原子组件，每行以 `key : value` 格式渲染一条数据，支持可选标题栏（带 `ThinkingIcon`）。
+> **能力域**：内容渲染
+
+键值对列表展示基础组件，每行以 `key : value` 格式渲染一条数据，支持可选标题栏（带 `ThinkingIcon`）。
 
 主要被 `UserMessage` 内部用于渲染结构化引用内容（`property.extra.cite.data`），通常不需要手动引入。
 
@@ -121,4 +126,4 @@ const message = {
 
 ## 关联组件
 
-- [UserMessage](../molecular/user-message.md) — 键值气泡展示
+- [UserMessage](/components/message/user-message) — 键值气泡展示

package/dist/mcp/generated/docs/knowledge-rag-content.md

@@ -0,0 +1,126 @@
+<!-- AI SUMMARY -->
+## 快速了解
+
+渲染知识召回活动，包含加载态、Markdown 内容与引用来源。 源码位置：src/components/chat-content/knowledge-rag-content/knowledge-rag-content.vue。
+
+### 关联组件
+- **activity-message** — activityType 为 knowledge_rag 时分发到本组件
+- **activity-layout** — 提供可折叠的活动容器外壳
+- **markdown-content** — 渲染知识召回摘要正文
+- **reference-content** — 渲染召回引用来源列表
+
+---
+<!-- FULL DOC -->
+
+# KnowledgeRagContent 知识召回内容
+
+> **能力域**：Agent 能力
+
+`KnowledgeRagContent` 用于渲染知识召回活动内容，包含活动标题、加载态、Markdown 摘要和引用来源列表。它是 `ActivityMessage` 在 `activityType === 'knowledge_rag'` 时使用的具体内容组件。
+
+通常不需要直接使用，`MessageRender -> ActivityMessage` 会根据消息类型自动分发到本组件。
+
+## 源码事实
+
+- **源码位置**：`src/components/chat-content/knowledge-rag-content/knowledge-rag-content.vue`
+- **能力说明**：渲染知识召回活动，包含加载态、Markdown 内容与引用来源。
+
+## 核心能力
+
+- **活动外壳**：基于 `ActivityLayout` 渲染可折叠活动区域，默认展开
+- **状态标题**：`status` 为 `pending` / `streaming` 时标题显示“检索中”并展示 Loading；其他状态显示“检索完成”
+- **Markdown 摘要**：使用 `MarkdownContent` 渲染 `content.content`
+- **引用来源**：使用 `ReferenceContent` 渲染 `content.referenceDocument`
+- **空值兜底**：正文缺失时传入空字符串，引用缺失时传入空数组
+
+## 基础用法
+
+```vue
+<template>
+  <KnowledgeRagContent
+    v-model:collapsed="collapsed"
+    :content="content"
+    status="complete"
+  />
+</template>
+
+<script setup lang="ts">
+  import { ref } from 'vue';
+  import KnowledgeRagContent from '@blueking/chat-x/src/components/chat-content/knowledge-rag-content/knowledge-rag-content.vue';
+  import type { KnowledgeRagMessageContent } from '@blueking/chat-x';
+
+  const collapsed = ref(false);
+
+  const content: KnowledgeRagMessageContent = {
+    content: '根据知识库检索，**蓝鲸智云** 常见 Agent 接入流程包括...',
+    referenceDocument: [
+      { name: 'Agent 接入指南', url: 'https://example.com/agent-guide', originFile: 'https://example.com/docs/agent-guide' },
+    ],
+  };
+</script>
+```
+
+**渲染效果**
+
+## 检索中状态
+
+当消息状态为 `pending` 或 `streaming` 时，标题区域显示 Loading，标题文案为“检索中”。
+
+## 折叠状态
+
+`collapsed` 通过 `v-model:collapsed` 与 `ActivityLayout` 双向绑定，适合由父级活动消息统一控制展开/收起。
+
+## API
+
+### Props
+
+| 属性名     | 类型                         | 必填 | 默认值 | 说明                                     |
+| ---------- | ---------------------------- | ---- | ------ | ---------------------------------------- |
+| content    | `KnowledgeRagMessageContent` | 否   | —      | 知识召回摘要与引用来源                   |
+| messageUid | `string`                     | 否   | —      | 所属消息唯一标识，当前组件暂未直接使用   |
+| status     | `MessageStatus`              | 否   | —      | 消息状态，影响标题文案与 Loading 显示    |
+
+### Models
+
+| 名称      | 类型      | 默认值  | 说明             |
+| --------- | --------- | ------- | ---------------- |
+| collapsed | `boolean` | `false` | 活动内容是否折叠 |
+
+### Emits
+
+- 无显式 emits；`v-model:collapsed` 会产生 `update:collapsed`。
+
+### Slots
+
+- 无。
+
+### Expose
+
+- 无。
+
+## 类型定义
+
+```typescript
+export type KnowledgeRagMessageContent = {
+  content: string;
+  referenceDocument: ReferenceDocumentContent[];
+};
+
+export type ReferenceDocumentContent = {
+  name: string;
+  originFile: string;
+  url: string;
+};
+```
+
+## 使用建议
+
+- 业务接入时优先通过 [ActivityMessage](../message/activity-message.md) 或完整消息链路使用，避免重复判断 `activityType`。
+- `referenceDocument` 为空时组件仍会渲染正文区域，引用列表由 `ReferenceContent` 处理空数组。
+
+## 关联组件
+
+- [ActivityMessage](../message/activity-message.md) — 活动消息分发入口。
+- [ActivityLayout](../helper/activity-layout.md) — 折叠活动外壳。
+- [MarkdownContent](../rendering/markdown-content.md) — Markdown 摘要渲染。
+- [ReferenceContent](../rendering/reference-content.md) — 引用来源列表。

package/dist/mcp/generated/docs/latex-content.md

@@ -1,7 +1,7 @@
 <!-- AI SUMMARY -->
 ## 快速了解
 
-LatexContent 使用 KaTeX 渲染 math_block / math_inline 等 token，支持行内块级混排与流式防抖。 必填 props 为 token 数组；失败时静默降级展示原始 LaTeX 文本。 由 MarkdownContent 在数学插件解析后自动调用。
+使用 KaTeX 渲染 LaTeX 公式内容。 源码位置：src/components/markdown-token/latex-content/latex-content.vue。
 
 ### 关联组件
 - **markdown-content** — 插件解析 $...$ / $$...$$ 后生成数学 token 并挂载本组件
@@ -10,10 +10,15 @@ LatexContent 使用 KaTeX 渲染 math_block / math_inline 等 token，支持行
 <!-- FULL DOC -->
 
 # LatexContent LaTeX 公式渲染
+## 源码事实
 
-> **层级**：原子组件 · **功能域**：内容渲染
+- **源码位置**：`src/components/markdown-token/latex-content/latex-content.vue`
+- **能力域**：内容渲染
+- **能力说明**：使用 KaTeX 渲染 LaTeX 公式内容。
 
-Markdown Token 层的 LaTeX 公式渲染原子组件，基于 **KaTeX** 实现。被 `MarkdownContent` 在解析到数学公式 token 时自动调用，通常无需手动引入。
+> **能力域**：内容渲染
+
+Markdown Token 层的 LaTeX 公式渲染基础组件，基于 **KaTeX** 实现。被 `MarkdownContent` 在解析到数学公式 token 时自动调用，通常无需手动引入。
 
 核心能力：**流式防抖渲染**（throttle 100ms）、**语法自动补全**（`completeLatexContent`）、**渐进式降级重试**（最多 5 次）、**错误静默**（错误文本白色不可见）。
 
@@ -193,4 +198,4 @@ const displayMode = token.type === 'math_block' || token.meta?.displayMode === t
 
 ## 关联组件
 
-- [MarkdownContent](./markdown-content.md) — 数学公式 token 的来源与挂载
+- [MarkdownContent](/components/rendering/markdown-content) — 数学公式 token 的来源与挂载

package/dist/mcp/generated/docs/loading-message.md

@@ -1,19 +1,24 @@
 <!-- AI SUMMARY -->
 ## 快速了解
 
-LoadingMessage 展示等待 AI 响应的加载动画（内部 AiLoading），无必填 Props，默认插槽可自定义「请求中」文案。 典型用法是由 MessageContainer 在末尾为用户消息时自动注入 Loading 组；也可在自定义布局中手动放置。
+消息列表中的加载占位，默认使用 AiLoading，也支持默认插槽覆盖。 源码位置：src/components/chat-message/loading-message/loading-message.vue。
 
 ### 关联组件
 - **message-container** — 在消息列表末尾自动追加 Loading 消息组
 - **message-render** — role 为 loading 时由 MessageRender 渲染
-- **ai-loading** — 内部使用 AiLoading 原子组件
+- **ai-loading** — 内部使用 AiLoading 基础组件
 
 ---
 <!-- FULL DOC -->
 
 # LoadingMessage 加载中消息
+## 源码事实
 
-> **层级**：分子组件 · **功能域**：消息展示
+- **源码位置**：`src/components/chat-message/loading-message/loading-message.vue`
+- **能力域**：消息系统
+- **能力说明**：消息列表中的加载占位，默认使用 AiLoading，也支持默认插槽覆盖。
+
+> **能力域**：消息系统
 
 加载等待状态组件，展示 AI 正在处理请求时的过渡动画。由旋转渐变环 + 脉冲星形图标（蓝→紫→粉渐变）和"请求中..."文案组成。支持通过默认插槽自定义加载文案。
 
@@ -166,6 +171,6 @@ enum MessageRole {
 
 ## 关联组件
 
-- [MessageContainer](./message-container.md) — 自动注入加载组
-- [MessageRender](./message-render.md) — loading 角色派发
-- [AiLoading](../atomic/ai-loading.md) — 内部动画组件
+- [MessageContainer](/components/setup/message-container) — 自动注入加载组
+- [MessageRender](/components/message/message-render) — loading 角色派发
+- [AiLoading](/components/helper/ai-loading) — 内部动画组件

package/dist/mcp/generated/docs/markdown-container.md

@@ -53,4 +53,4 @@ const md = new MarkdownIt({ html: true }).use(markdownItContainer, /^hljs-(left|
 
 ## 关联
 
-- [MarkdownContent](../components/atomic/markdown-content.md) — 实际接入与样式
+- [MarkdownContent](../components/rendering/markdown-content) — 实际接入与样式

package/dist/mcp/generated/docs/markdown-content.md

@@ -1,7 +1,7 @@
 <!-- AI SUMMARY -->
 ## 快速了解
 
-MarkdownContent 将 Markdown 字符串解析为 token 并渲染，集成代码块、公式、Mermaid 等子渲染器。 核心 props 为 content 与 status；内置流式节流、语法补全与 DOMPurify 安全策略。 通常由 ContentRender、AssistantMessage 等间接使用，无需业务直接挂载。
+Markdown 主渲染器，集成代码块、公式、错误降级和 codeHeader 插槽。 源码位置：src/components/chat-content/markdown-content/markdown-content.vue。
 
 ### 关联组件
 - **code-content** — fence 代码块语法高亮与复制
@@ -13,12 +13,17 @@ MarkdownContent 将 Markdown 字符串解析为 token 并渲染，集成代码
 <!-- FULL DOC -->
 
 # MarkdownContent Markdown 内容渲染
+## 源码事实
 
-> **层级**：原子组件 · **功能域**：内容渲染
+- **源码位置**：`src/components/chat-content/markdown-content/markdown-content.vue`
+- **能力域**：内容渲染
+- **能力说明**：Markdown 主渲染器，集成代码块、公式、错误降级和 codeHeader 插槽。
 
-AI 消息内容渲染的核心原子组件，集成代码高亮、LaTeX 公式、Mermaid 图表等能力，内置流式渲染优化（5ms throttle + 语法补全 + 防闪烁）。
+> **能力域**：内容渲染
 
-由 `AssistantMessage`、`ReasoningMessage` 等分子组件内部自动使用，通常不需要手动引入。
+AI 消息内容渲染的核心基础组件，集成代码高亮、LaTeX 公式、Mermaid 图表等能力，内置流式渲染优化（5ms throttle + 语法补全 + 防闪烁）。
+
+由 `AssistantMessage`、`ReasoningMessage` 等组合组件内部自动使用，通常不需要手动引入。
 
 ## 组件结构与渲染流程
 
@@ -177,7 +182,6 @@ props.content → completeMarkdownSyntax → md.parse → groupTokens → groupe
 
 | 插件                        | 语法                | 功能                 |
 | --------------------------- | ------------------- | -------------------- |
-| `markdownItBkInlineStyle`   | 见下文「蓝鲸行内样式」 | 安全行内颜色/字号/粗斜体（非 HTML） |
 | `markdown-it-footnote`      | `[^1]`              | 脚注                 |
 | `markdown-it-ins`           | `++text++`          | 下划线               |
 | `markdown-it-mark`          | `==text==`          | 高亮                 |
@@ -188,30 +192,8 @@ props.content → completeMarkdownSyntax → md.parse → groupTokens → groupe
 | `markdownItLatex`           | `$...$` / `$$...$$` | KaTeX 数学公式 token |
 | `markdownItContainer`       | `::: hljs-left` 等  | 自定义对齐容器（class 与 highlight.js 命名对齐） |
 
-### 蓝鲸行内样式（`markdownItBkInlineStyle`）
-
-不开启 `html: true`，由专用语法生成带白名单 `style` 的 `<span class="bk-md-inline-style">`。
-
-**语法**：`::bk{` *属性* `}` *正文* `:/bk::`
-
-- 属性写在 `{}` 内，使用 `;` 分隔；每项为 `键=值` 或 `键:值`。
-- 正文支持行内 Markdown（如 `**粗体**`）。
-- 结束标记必须为字面量 `:/bk::`，请勿在正文中出现该序列。
-
-**支持的键**：`color` / `c`、`background-color`、`font-size`、`bold`、`italic`（详见 `plugins/markdown-bk-inline-style.ts` 内注释）。
-
-**示例**：
-
-```markdown
-::bk{color:#c00;font-size:18px}**重要**:/bk::
-::bk{background-color:yellow}高亮:/bk::
-::bk{bold;italic}强调:/bk::
-```
-
 ### 安全性
 
-`MarkdownIt` **不**开启 `html: true`，用户无法插入任意 HTML 标签；行内彩色/字号等请使用上文「蓝鲸行内样式」扩展。
-
 `VNodeRenderer` 渲染的 HTML 统一经过 DOMPurify 过滤，并额外允许 KaTeX 所需标签：
 
 ```typescript
@@ -225,7 +207,7 @@ const domPurifyConfig = {
 
 ## 关联组件
 
-- [CodeContent](./code-content.md) — 代码 fence 高亮
-- [LatexContent](./latex-content.md) — 公式渲染
-- [MermaidContent](./mermaid-content.md) — Mermaid 图表
-- [ContentRender](../molecular/content-render.md) — 内容类型分发入口
+- [CodeContent](/components/rendering/code-content) — 代码 fence 高亮
+- [LatexContent](/components/rendering/latex-content) — 公式渲染
+- [MermaidContent](/components/rendering/mermaid-content) — Mermaid 图表
+- [ContentRender](/components/rendering/content-render) — 内容类型分发入口

package/dist/mcp/generated/docs/markdown-latex.md

@@ -203,6 +203,6 @@ KaTeX 限制：
 
 ## 关联组件
 
-- [LatexContent](../components/atomic/latex-content.md) — KaTeX 渲染
-- [MarkdownContent](../components/atomic/markdown-content.md) — Markdown 内容
-- [ContentRender](../components/molecular/content-render.md) — 内容渲染
+- [LatexContent](../components/rendering/latex-content) — KaTeX 渲染
+- [MarkdownContent](../components/rendering/markdown-content) — Markdown 内容
+- [ContentRender](../components/rendering/content-render) — 内容渲染

package/dist/mcp/generated/docs/markdown-mermaid.md

@@ -245,6 +245,6 @@ erDiagram
 
 ## 关联组件
 
-- [MermaidContent](../components/atomic/mermaid-content.md) — Mermaid 渲染
-- [MarkdownContent](../components/atomic/markdown-content.md) — Markdown 内容
-- [ContentRender](../components/molecular/content-render.md) — 内容渲染
+- [MermaidContent](../components/rendering/mermaid-content) — Mermaid 渲染
+- [MarkdownContent](../components/rendering/markdown-content) — Markdown 内容
+- [ContentRender](../components/rendering/content-render) — 内容渲染

package/dist/mcp/generated/docs/mermaid-content.md

@@ -1,7 +1,7 @@
 <!-- AI SUMMARY -->
 ## 快速了解
 
-MermaidContent 将 info 为 mermaid 的 fence token 渲染为 SVG，模块级懒加载单例 Mermaid。 具备流式 throttle、错误静默与 SVG ID 随机化，避免多实例冲突。 由 MarkdownContent 在解析 mermaid 代码块时调用。
+渲染 Mermaid 图表并处理渲染事件。 源码位置：src/components/markdown-token/mermaid-content/mermaid-content.vue。
 
 ### 关联组件
 - **markdown-content** — 解析 mermaid 类型 fence 代码块后传入 token
@@ -10,10 +10,15 @@ MermaidContent 将 info 为 mermaid 的 fence token 渲染为 SVG，模块级懒
 <!-- FULL DOC -->
 
 # MermaidContent Mermaid 图表渲染
+## 源码事实
 
-> **层级**：原子组件 · **功能域**：内容渲染
+- **源码位置**：`src/components/markdown-token/mermaid-content/mermaid-content.vue`
+- **能力域**：内容渲染
+- **能力说明**：渲染 Mermaid 图表并处理渲染事件。
 
-Markdown Token 层的 Mermaid 图表渲染原子组件，被 `MarkdownContent` 在检测到 mermaid fence token 时自动调用，通常无需手动引入。
+> **能力域**：内容渲染
+
+Markdown Token 层的 Mermaid 图表渲染基础组件，被 `MarkdownContent` 在检测到 mermaid fence token 时自动调用，通常无需手动引入。
 
 核心能力：**按需懒加载 Mermaid**（动态 import 单例）、**三级去重跳过**（代码比对 → 语法校验 → SVG 比对）、**100ms throttle** 流式防抖、**错误静默**（parse 失败时保持上一次 SVG）。
 
@@ -182,4 +187,4 @@ mermaid.default.render('mermaid-content-' + Math.random().toString(36).substring
 
 ## 关联组件
 
-- [MarkdownContent](./markdown-content.md) — mermaid fence token 的来源与挂载
+- [MarkdownContent](/components/rendering/markdown-content) — mermaid fence token 的来源与挂载