Appearance
命名约定
@flowporr/* 用层后缀统一标识包的运行环境,一眼可辨:
| 层 | 规则 | 例子 |
|---|---|---|
| 通用(框架无关) | 无后缀 | @flowporr/ai-core、@flowporr/x-sender |
| 前端渲染层 | -vue / -react | @flowporr/ai-chat-vue、@flowporr/x-markdown-vue |
| 服务端(Node) | -server | @flowporr/ai-server |
规则:
- 框架无关包禁止引入框架依赖(vue / fastify / h3 / uni-app),任何端可消费
- 渲染层每框架一个包,核心逻辑留在无后缀的通用包(如
ai-core是框架无关的,ai-chat-vue只是它的 Vue 壳) - 新增框架用对应后缀:React 版就是
@flowporr/xxx-react
这样加包不用纠结命名,且能从名字直接判断能不能用在你的环境里。
当前包一览
| 包 | 层 | 说明 |
|---|---|---|
@flowporr/ai-core | 通用 | AI 聊天核心:markdown 管线 / SSE 解析 / 文件工具 / 平台契约 |
@flowporr/x-sender | 通用(前端 DOM) | 富文本聊天输入引擎 |
@flowporr/x-markdown-vue | 前端 | Markdown 渲染器(GFM / Shiki / Mermaid / KaTeX) |
@flowporr/ai-chat-vue | 前端 | AI 聊天组件库 |
@flowporr/ai-server | 服务端 | AI 客户端(能力注册表 / OpenAI SDK / 图片编辑) |