Chat X Custom Component
Developmentchat-x-custom-componentChat X Custom Component is an Agent Skill for development published in the TencentBlueKing/bk-bcs repository on GitHub: a SKILL.md instruction file an AI agent can load to do this task.
帮助开发者创建 @blueking/chat-x 自定义 message 组件。当用户需要开发自定义消息类型时使用。
QUICK START
How to use this skill
Bring this guide into your coding agent with a prompt tailored to the tool you use.
- Open your project in Codex.
- Copy and paste the prompt below.
- Review files and risks before approving any action.
Prompt to paste
Inspect the Agent Skill at https://github.com/TencentBlueKing/bk-bcs/blob/HEAD/bcs-services/bcs-project-manager/.cursor/skills/chat-x-custom-component/SKILL.md and all supporting files. Report provenance, permissions, scripts, dependencies, and security risks. Propose an exact installation into .agents/skills/chat-x-custom-component, but wait for my approval before writing files or running scripts.
Copying this prompt does not install or run the skill. Review third-party files before use.
Chat-X 自定义 Message 组件开发
概述
自定义 message 组件允许你扩展内置消息类型、渲染任意 UI 组件。
开发流程
1. 声明类型扩展 → 2. 创建组件 → 3. 集成到 MessageContainer → 4. 测试
核心机制
类型扩展
import { type BaseMessage } from '@blueking/chat-x';
declare global {
interface AIBluekingMessageMap {
custom: BaseMessage<'custom', { content: string }>;
}
}
MessageSlot 机制
import { useMessageSlotId } from '@blueking/chat-x';
const { messageSlotId } = useMessageSlotId();
// 用于 Teleport: <Teleport :to="messageSlotId">
常见场景
- ECharts 图表消息
- bkui-vue 表格消息
- 动态表单消息
- 卡片列表消息
📦 可用资源
skill://chat-x-custom-component/references/api-reference.mdskill://chat-x-custom-component/references/best-practices.mdskill://chat-x-custom-component/references/full-example.mdskill://chat-x-custom-component/references/integration-guide.mdskill://chat-x-custom-component/references/type-extension.md
📦 可用资源
skill://chat-x-custom-component/references/QA.mdskill://chat-x-custom-component/references/api-reference.mdskill://chat-x-custom-component/references/best-practices.mdskill://chat-x-custom-component/references/component-templates.mdskill://chat-x-custom-component/references/full-example.mdskill://chat-x-custom-component/references/integration-guide.mdskill://chat-x-custom-component/references/type-extension.md
根据 SKILL.md 中的 IF-THEN 规则判断是否需要加载