代码提交
This commit is contained in:
董宏凯 committed
1 parent
bd426ed1d3
commit
d9afd8d887
15 files changed
+497
-229
No files matched your search
@@ -51,6 +51,8 @@ src/
|
||||
├─ parallel-agents.css 作用域深色 token(--pa-*) + .pa-* 语义类 + Markdown 样式 + 工具类子集（无 Tailwind）
|
||||
├─ ParallelAgentsPanel.vue 主组件：席位条/会话区 + 全部状态编排（表单/按钮在宿主侧）
|
||||
├─ ParallelSeatStrip.vue 席位状态条（头像 + running/done/clarify/error 角标，点击切换单显）
|
||||
├─ AutoScrollPane.vue 自动下滑滚动窗格：包住单席位消息，超高出滚动条 + 流式自动钉底 +
|
||||
│ 用户滚动暂停 + 半透明「自动滚动」浮动按钮（每席位一实例，互不影响）
|
||||
├─ MessageBubble.vue 单条气泡：头像/发言人/徽标/时间/步骤条/正文/光标/协作卡片
|
||||
├─ MessageStepsCard.vue 步骤条（ChainOfThought 结构，1:1 对齐 Step2）
|
||||
├─ StepIcon.vue 步骤图标（lucide 风格 inline SVG，按 IconKey）
|
||||
@@ -100,7 +102,7 @@ panel emit "completed"(AgentResult[])；可点「保存」(按 taskId upsert) /
|
||||
| `agent_start` | `agent_id` | 该席位置 running |
|
||||
| `delta` | `agent_id, text` | 追加正文（节流） |
|
||||
| `step` | `agent_id, key(=`tool_calling:<tool>`), label, args` | 步骤条加一步（含完整 args） |
|
||||
| `agent_clarification`〔已禁用〕 | `agent_id, content, question, clarification_type, clarification_context, options, allow_*` | 设 `dialogue.clarification` → 卡片；席位置 **clarify**（待协助，非 done）。**注**：后端已把 `ask_clarification` 加入 `_EXCLUDED_TOOLS`，本面板**无人值守**不再发该事件；前端协作卡片相关代码保留（兜底，正常不触发） |
|
||||
| `agent_clarification` | `agent_id, content, question, clarification_type, clarification_context, options, allow_*` | 设 `dialogue.clarification` → 卡片；席位置 **clarify**（待协助，非 done）。澄清卡片**任何时候都可点**（即便整批仍在跑），用户答完 → `panel.onClarify` → `rerunAgent` 重跑该席位 |
|
||||
| `agent_done` | `agent_id, content` | 收口，正文以终态为准 |
|
||||
| `agent_error` | `agent_id, message` | 该席位置 error |
|
||||
| `all_done` | — | 全部结束 |
|
||||
@@ -122,17 +124,30 @@ panel emit "completed"(AgentResult[])；可点「保存」(按 taskId upsert) /
|
||||
```
|
||||
ParallelAgentsPanel
|
||||
├─ ParallelSeatStrip ── Avatar (席位条，点头像切换单显)
|
||||
└─ MessageBubble (当前选中席位)
|
||||
├─ Avatar
|
||||
├─ MessageStepsCard ── StepIcon (步骤条；getStepDisplay/getStepArgs 翻译 key+args)
|
||||
├─ MarkdownContent (markdown-it)
|
||||
└─ ClarificationCard (msg.clarification 存在时；提交→panel.onClarify→rerunAgent)
|
||||
└─ AutoScrollPane (当前选中席位；限高滚动 + 流式自动下滑 + 浮动「自动滚动」按钮)
|
||||
└─ MessageBubble
|
||||
├─ Avatar
|
||||
├─ MessageStepsCard ── StepIcon (步骤条；getStepDisplay/getStepArgs 翻译 key+args)
|
||||
├─ MarkdownContent (markdown-it)
|
||||
└─ ClarificationCard (msg.clarification 存在时；提交→panel.onClarify→rerunAgent)
|
||||
```
|
||||
|
||||
> **自动下滑 / 高度自适应**（`AutoScrollPane.vue`）：会话区只负责限高（`min-h-0 flex-1 overflow-hidden`），
|
||||
> 真正的滚动与自动下滑下放到**每个席位卡片内部**的窗格 —— 父元素不够高时窗格内出现滚动条；模型流式输出时
|
||||
> 用 `ResizeObserver` 监听内容增高并钉到底部；用户向上滚动（离开底部）即暂停自动下滑、滚回底部自动恢复；
|
||||
> 暂停且内容可滚动时底部居中浮出半透明「自动滚动」按钮（`.pa-autoscroll-btn`），点击恢复并滚到底。
|
||||
> 每个席位各一个实例（`v-for :key=agentId`），autoScroll / 滚动位置都在实例内，**多智能体互不影响**。
|
||||
> 席位卡片靠 `.pa-rows-fill`（`grid-auto-rows: minmax(0,1fr)`）受限于会话区高度，从而内部滚动而非撑破容器。
|
||||
|
||||
`ParallelAgentsPanel` 的对外接口（详见 [07-使用说明.md](./07-使用说明.md)）：
|
||||
- props：`agents`(必填) / `username` / `baseUrl` / `token` / `getToken` / `taskId` / `model` / `dark`
|
||||
- emits：`saved(SavedTask)` / `update:taskId(string)` / `completed(AgentResult[])`
|
||||
- `defineExpose`：`getResults()` / `getResult(id)` / `start()` / `cancel()`
|
||||
- emits：
|
||||
- `agent-completed(AgentReply)` —— **单个**智能体**真正完成（done）**时各触发一次；`AgentReply = {agent_id, name, content}`
|
||||
（智能体名称 + 模型返回结果，**不含 status**）。待用户协助（clarify）/ 出错（error）**不触发**。
|
||||
- `completed(AgentReply[])` —— **所有**智能体都完成（done/error、**没有任何 clarify 在等用户**）后，整批触发一次；
|
||||
若有席位在等用户协助，本轮不发，待其答完重跑完成后再发。
|
||||
- `saved(SavedTask)` / `update:taskId(string)` / `update:taskName(string)` / `update:brief(string)`
|
||||
- `defineExpose`：`getResults()`(返回 `AgentResult[]`，含 status) / `getResult(id)` / `start()` / `reanalyze()` / `save()` / `cancel()` / `loadTask(id)`
|
||||
|
||||
---
|
||||
|
||||
@@ -160,16 +175,20 @@ ParallelAgentsPanel
|
||||
| 模型列表 | `GET /api/models` → `{models:[{name, display_name}]}` |
|
||||
|
||||
**后端运行策略（重要）**：每个并行席位是「执行席位」，不是总控。
|
||||
- **禁用工具** `_EXCLUDED_TOOLS = [write_file, str_replace, agent_orchestration, bash, ask_clarification]`：
|
||||
①禁写文件（并行不互相打架）；②禁 `agent_orchestration`/`bash`（防弱模型模仿总控**派活**或绕道脚本逃逸）；
|
||||
③禁 `ask_clarification`（**禁用用户协助**：本面板是并行**无人值守**扇出，没有让单席位中途打断、向用户
|
||||
要澄清的交互位 —— 席位信息不足时自行做**合理假设**并写进正文交付，而非挂起等人）。
|
||||
- **保留** 只读 / 检索工具 → 步骤条正常。
|
||||
- 任务消息带**角色边界护栏**（「执行席位、不要模仿总控调度 / 派活」）+ **无人值守护栏**（「信息不足时
|
||||
自行合理假设并注明，不要反问用户 / 不要挂起等待补充」）。
|
||||
- **禁用工具** `_EXCLUDED_TOOLS = [write_file, str_replace, agent_orchestration, bash]`：①禁写文件（并行
|
||||
不互相打架）；②禁 `agent_orchestration`/`bash`（防弱模型模仿总控**派活**或绕道脚本逃逸）。
|
||||
- **保留** 只读 / 检索工具 + `ask_clarification` → 步骤条、协作卡片正常（**用户协助开启**）。
|
||||
- 任务消息带**角色边界护栏**（「执行席位、不要模仿总控调度 / 派活」）。
|
||||
- 步骤 `args` 通过累积 `tool_call_chunks` + 终态全量 `tool_calls` 补全（流式期间空 args 不发，防钉死）。
|
||||
- `ask_clarification` 已被禁用，正常不再产生 `agent_clarification` 事件；`_clarification_from_messages`
|
||||
仅作终态兜底（工具被禁后恒返回 `None`），不影响其他业务路由（圆桌 / 普通问答的澄清照常）。
|
||||
- `ask_clarification` 从终态 messages 抽成结构化 `agent_clarification` 事件。
|
||||
|
||||
**前端澄清（用户协助）交互要点**（`useParallelRun` / `ClarificationCard` / `ParallelAgentsPanel`）：
|
||||
- 协作卡片**不再因 `submitting` 禁用**：整批仍在跑时也能立刻回答某个已澄清的席位。
|
||||
- `rerunAgent` 放开了「整批 running 时禁止重跑」的限制（澄清是该席位合并流里的终态，不会再抢气泡），
|
||||
只拦同一席位的并发重跑；收尾循环（`start` 的 finally）**跳过 busy 席位**，交给 `rerunAgent` 自己结算。
|
||||
- 答澄清后**不立刻清空**正文/步骤：先移除卡片、置流式并标记 `rerunPending`，等重跑产出**第一条新事件**
|
||||
时（`maybeStartRerun`）再清空替换，避免单选视图整列空白闪烁。
|
||||
- 「单席位结算回传」`onAgentSettled`：**`clarify` 不回传**（待用户协助≠模型完成），等重跑出 `done/error` 再回传。
|
||||
|
||||
---
|
||||
|
||||
@@ -223,6 +242,7 @@ pnpm build:lib # 组件库：dist/parallel-agents-vue.{js,umd.cjs,css}
|
||||
| 改布局类 / 加新工具类 | `parallel-agents.css` 末尾的「工具类子集」补规则，或组件 scoped `<style>`（不要装 Tailwind） |
|
||||
| 改默认后端地址 / 模型 | `config.ts`（`DEFAULT_BASE_URL` / `DEFAULT_MODEL`） |
|
||||
| 多席位并排显示（取消单选） | `ParallelAgentsPanel.vue` 的 `selected` / `visibleSeats` / `toggleSeat` 逻辑 |
|
||||
| 改自动下滑 / 浮动按钮行为 | `AutoScrollPane.vue`（`BOTTOM_TOLERANCE` 容差 / `onScroll` 暂停恢复逻辑）+ `.pa-autoscroll-btn` 样式 |
|
||||
| 宿主自定义存储（不走后端） | 用 `@completed` + `getResults()` 取数据，自行存；不调用 `createTask/updateTask` |
|
||||
| 改鉴权方式 | `api.ts` 的 `resolveToken` / `loginByUsername` / `authedFetch` + `config.ts` 的 `TOKEN_PATH` |
|
||||
|
||||
@@ -232,9 +252,8 @@ pnpm build:lib # 组件库：dist/parallel-agents-vue.{js,umd.cjs,css}
|
||||
|
||||
- **agent_id 必须真实**（后端注册过的 id），只填名字不行；可用 id 见 [06-可用智能体清单.md](./06-可用智能体清单.md)。
|
||||
- 并行席位**禁派活/脚本/写文件**：本面板里每个智能体只做自己那份分析，产出走正文。
|
||||
- **已禁用「用户协助」**：并行无人值守，后端把 `ask_clarification` 加入 `_EXCLUDED_TOOLS`，席位不再向用户要
|
||||
澄清（信息不足时自行合理假设并在正文注明）。前端 `ClarificationCard.vue` / `onClarify` / `rerunAgent`
|
||||
等协作链路代码保留作兜底，正常不触发；**仅影响本面板**，圆桌 / 普通问答的澄清不受影响。
|
||||
- 协作卡片回答是**重跑单个智能体**（新线程 + 把回答拼进任务），不是 LangGraph 原地 resume（当前已禁用，仅兜底保留）。
|
||||
- **用户协助（澄清）已启用**：`ask_clarification` 保留；席位信息不足时可弹协作卡片。卡片任何时候都可点
|
||||
（含整批仍在跑时），用户答完即重跑该席位；待协助（clarify）不算完成、不回传给宿主。
|
||||
- 协作卡片回答是**重跑单个智能体**（新线程 + 把回答拼进任务），不是 LangGraph 原地 resume。
|
||||
- token 取自公共端点（无门槛旁路）—— 适合内网；若网关要暴露公网，建议给取 token 端点加共享密钥校验。
|
||||
- 跨域：宿主与后端不同源时，后端需放开该来源 CORS + `credentials`。
|
||||
Reference in new issue
Block a user