# 使用说明 · 在其它 Vue 项目中引入 本组件库只对外暴露**一个**组件 `ParallelAgentsPanel`(其余 `MessageBubble` / `MessageStepsCard` / `ParallelSeatStrip` / `Avatar` / `MarkdownContent` 都是它的内部子组件,**无需也不要单独引入**)。 宿主只管把它放进自己的页面 / 抽屉 / 弹窗,并传几个 prop。 > **⚠️ 契约变更(纯展示版)**:面板**不再自带顶部表单与按钮**。 > - **任务名称 / 简介 / 模型** 全部由宿主通过 props 传入(`taskName` / `brief` 支持 `v-model`); > - **「重新分析 / 保存 / 停止」按钮由宿主自己渲染**,通过模板 ref 调用面板 `defineExpose` 出的 > `reanalyze()` / `save()` / `cancel()` 等方法(见 [§六·二](#六二暴露的方法与状态模板-ref)); > - 面板本体只展示「席位状态条 + 并行会话 + 错误提示」。 > > 完整的宿主参考实现见仓库 `src/App.vue`(弹窗里宿主自渲染工具条 + 调用 ref 方法)。 --- ## 一、要引入的东西(就这两样) 1. **组件**:`ParallelAgentsPanel` 2. **样式**:`parallel-agents-vue/style.css`(一次性引入即可,样式作用域全在 `.parallel-agents` 下) > 依赖说明:`vue ^3.4`(宿主提供,库不打包 vue);`markdown-it` 已打进库内,无需宿主安装。 > **无需 Tailwind 或任何 CSS 框架**:布局样式已内置为 `parallel-agents.css` 末尾的「最小工具类子集」 > (全部作用域在 `.parallel-agents` 下,不污染宿主)。宿主项目**不用**装 / 配 Tailwind。 --- ## 二、两种引入方式 ### 方式 A:构建成库后按包引入(推荐) 1. 在本项目构建: ```bash pnpm install pnpm build:lib # 产出 dist/parallel-agents-vue.{js,umd.cjs,css} ``` 2. 宿主项目里安装(任选其一): - 把本目录作为本地依赖:`"parallel-agents-vue": "file:../parallel-agents-vue"`; - 或发到你们的私有 npm 后正常 `pnpm add parallel-agents-vue`。 3. 代码里引入: ```ts import { ParallelAgentsPanel } from "parallel-agents-vue"; import "parallel-agents-vue/style.css"; ``` ### 方式 B:直接拷贝源码(无需发包,**推荐给需要改源码的人**) 所有实现已收进**一个自包含文件夹** `src/parallel-agents/`。把**整个文件夹**拷进宿主项目的 `src/` 下即可,内部全是相对路径引用、不依赖任何构建别名: ``` src/parallel-agents/ ← 整个文件夹拷走即用 index.ts 入口:自动引样式 + 导出组件/类型 ParallelAgentsPanel.vue 主组件 ParallelSeatStrip.vue · MessageBubble.vue · MessageStepsCard.vue · StepIcon.vue ClarificationCard.vue · MarkdownContent.vue · Avatar.vue (子组件) useParallelRun.ts 并行运行编排 api.ts · types.ts · config.ts · avatar-constants.ts · step-display.ts parallel-agents.css 作用域样式(深色 token + 语义类 + 工具类子集,无 Tailwind) README.md 本文件夹的速用说明 ``` 引入(样式由 `index.ts` 自动引入,无需手动 import css): ```ts import { ParallelAgentsPanel } from "@/parallel-agents"; // 或相对路径: import { ParallelAgentsPanel } from "./parallel-agents"; ``` 宿主需有 `markdown-it` 依赖(`pnpm add markdown-it`),并保证构建支持 `.vue`(Vite/@vitejs/plugin-vue)。 **不需要 Tailwind**。 --- ## 三、注册与使用 ### 局部引入(推荐) 宿主持有任务名 / 简介 / 模型,并自渲染按钮调用面板暴露的方法: ```vue