boos
e0a5f57793
Vendor the rebranded BoosAPI Desktop client (Tauri + Vue) into metapi as a monorepo subdirectory under desktop/. Source only — node_modules, dist, Cargo target and the upstream .git history are excluded. desktop/ keeps its own independent Cargo workspace (desktop/src-tauri with crates/*); it is not part of the backend boosapi crate, so a `cargo check` at the metapi root still compiles only the backend. Build the desktop app from desktop/src-tauri per desktop/README.md. Note: app icons are still placeholder assets pending the final BoosAPI logo. The updater signing keys live outside the repo and are not included.
4.0 KiB
4.0 KiB
description
| description |
|---|
| 按任务组织的 markstream-vue 指南，帮助你在安装、流式渲染、VitePress 文档站、组件覆盖和迁移之间快速找到正确入口。 |
指南
这份文档优先按“用户任务”组织，而不是默认要求你从第一页看到最后一页。先从和你当前问题最接近的入口开始。
我想先把它跑起来
- 安装：先按场景装对 peer 依赖，并理顺 CSS 顺序。
- 快速开始：最小 Vue 3 示例。
- 使用与流式渲染：决定该用
content还是nodes。 - 文档站与 VitePress 集成：把文档页、
enhanceApp、可信标签和 CSS 顺序串起来。 - AI 聊天与流式输出：当页面持续更新时，一次看完 peers、解析、性能和排障。
- 按症状排查：先判断问题属于样式、peers、SSR，还是自定义标签接法。
- Props 与选项：已经能跑，只是需要调配置。
我想做业务定制
- API 参考：解析器工具、作用域覆盖和渲染流程入口。
- 渲染器与节点组件：导出的渲染器和节点组件参考。
- 覆盖内置组件：替换
image、code_block、mermaid、link等内置节点。 - 自定义标签与高级组件：支持
thinking这类可信标签。 - 高级解析 与 解析器 API：需要 token / AST 级改造时再看。
我想接入到现有项目里
- Nuxt SSR：处理浏览器专属依赖和
ClientOnly。 - AI / Skills 工作流：复制即用的任务模板、skill 清单和迁移提示词。
- 从 react-markdown 迁移 与 迁移 Cookbook：适合 React 团队。
- 故障排除：安装能跑但样式、SSR 或 peers 出问题时先看。
框架入口
Vue 3 (markstream-vue) ⭐ 推荐
| 页面 | 描述 |
|---|---|
| 安装 | 只安装你真正需要的依赖组合 |
| 快速开始 | 渲染第一篇 Markdown |
| 使用与流式渲染 | 决定 content 与 nodes 的接入方式 |
| 文档站与 VitePress 集成 | 文档页、enhanceApp、可信标签与 CSS 顺序的一站式路径 |
| AI 聊天与流式输出 | 适合聊天 UI、SSE 与逐 token 输出的场景路径 |
| API 参考 | 解析器工具、作用域覆盖和渲染流程入口 |
| 渲染器与节点组件 | 渲染器和节点组件总览 |
| 自定义 | 覆盖内置组件与扩展自定义标签 |
Vue 2 (markstream-vue2)
| 页面 | 描述 |
|---|---|
| 安装 | Vue 2 专用安装 |
| 快速开始 | Vue 2 示例 |
| 组件与 API | Vue 2 组件参考 |
React (markstream-react)
| 页面 | 描述 |
|---|---|
| 安装 | React 专用安装 |
| 快速开始 | React 示例 |
| React 组件 | React 渲染器和节点组件 |
| 从 react-markdown 迁移 | 面向现有 React Markdown 项目的迁移路径 |
| 迁移 Cookbook | 常见迁移场景的 before/after 示例 |
Angular (markstream-angular)
| 页面 | 描述 |
|---|---|
| 安装 | Angular 专用安装 |
| 快速开始 | standalone Angular 示例 |
Nuxt
- Nuxt SSR 指南：处理客户端边界、workers 和浏览器专属 peers。