From 85e119db088f69e80a6dceea3a76b9f2ede18c3e Mon Sep 17 00:00:00 2001 From: fengxiangdebaozi <10845145+fengxiangdebaozi@user.noreply.gitee.com> Date: Tue, 21 Jul 2026 17:49:25 +0800 Subject: [PATCH] feat(position-roundtable): add standalone position collaboration --- ...position-roundtable-implementation-plan.md | 508 ++++++++ .../src/position-roundtable/api/sessions.ts | 264 ++++ .../components/PositionNodeChat.tsx | 285 +++++ .../lib/mock-task-source.ts | 72 ++ .../src/position-roundtable/lib/positions.ts | 39 + .../pages/PositionRoundtablePage.tsx | 1069 ++++++++++++++--- .../components/Step1Panel.tsx | 5 +- .../hooks/useStep1Intent.ts | 17 + .../roundtable-planning/lib/business-chain.ts | 5 + .../pages/BusinessChainEditorPage.tsx | 90 +- offline-backend-20260512/backend/CLAUDE.md | 20 + offline-backend-20260512/backend/README.md | 2 + .../backend/app/gateway/app.py | 14 +- .../backend/app/gateway/deps.py | 12 +- .../gateway/routers/position_roundtable.py | 563 +++++++++ .../app/gateway/routers/roundtable_chains.py | 3 + ...0260721_01_position_roundtable_sessions.py | 87 ++ .../deerflow/persistence/models/__init__.py | 6 + .../position_roundtable/__init__.py | 22 + .../persistence/position_roundtable/model.py | 83 ++ .../persistence/position_roundtable/sql.py | 279 +++++ .../test_position_roundtable_sessions.py | 250 ++++ 22 files changed, 3494 insertions(+), 201 deletions(-) create mode 100644 frontend-web/docs/position-roundtable-implementation-plan.md create mode 100644 frontend-web/src/position-roundtable/api/sessions.ts create mode 100644 frontend-web/src/position-roundtable/components/PositionNodeChat.tsx create mode 100644 frontend-web/src/position-roundtable/lib/mock-task-source.ts create mode 100644 frontend-web/src/position-roundtable/lib/positions.ts create mode 100644 offline-backend-20260512/backend/app/gateway/routers/position_roundtable.py create mode 100644 offline-backend-20260512/backend/packages/harness/deerflow/persistence/migrations/versions/20260721_01_position_roundtable_sessions.py create mode 100644 offline-backend-20260512/backend/packages/harness/deerflow/persistence/position_roundtable/__init__.py create mode 100644 offline-backend-20260512/backend/packages/harness/deerflow/persistence/position_roundtable/model.py create mode 100644 offline-backend-20260512/backend/packages/harness/deerflow/persistence/position_roundtable/sql.py create mode 100644 offline-backend-20260512/backend/tests/test_position_roundtable_sessions.py diff --git a/frontend-web/docs/position-roundtable-implementation-plan.md b/frontend-web/docs/position-roundtable-implementation-plan.md new file mode 100644 index 00000000..78aeb5c8 --- /dev/null +++ b/frontend-web/docs/position-roundtable-implementation-plan.md @@ -0,0 +1,508 @@ +# 岗位智能体协同页面 · 分步实现计划 + +> 页面：`/page/strategy/qa/position-roundtable` +> +> 核心模式：**不使用总控智能体**。情报分析岗先完成意图识别；其他岗位直接与业务链中分配给本岗位的智能体问答。每个节点独立保存对话和产物，并在问答时自动获得上游节点的有效结果。 + +--- + +## 0. 已确认的产品决策 + +- 新功能使用独立路由、独立业务状态和独立后端存储，不修改原多智能体会商页面的运行逻辑。 +- 岗位先使用前端固定枚举；下拉框、选择器等表单控件使用 `tdesign-react`。 +- **情报分析岗**负责任务意图识别，复用现有 `useStep1Intent`、`Step1Panel` 和意图接口。 +- 其他岗位不经过总控派活，直接使用节点配置的 `agent_id` 调用对应智能体。 +- 不调用原会商的 `multi-agent/init`、总控循环、后台圆桌作业和自动收口流程。 +- 每个业务链节点对应一条独立智能体对话线程；同一节点可以在该线程内多轮追问。 +- 当前岗位只能向分配给本岗位的节点提问；其他节点允许查看，但输入框只读。 +- 节点问答时自动获得任务、意图和已完成上游节点的问答结果与产物。 +- 左侧流程图从上到下排列，节点可点击，画布支持鼠标拖动；连接线保留但不显示依赖文字。 +- 右侧保留“智能体配置 / 分析结果”两个标签页。 + +### 0.1 默认实现口径 + +以下口径在产品未另行调整前作为实现默认值： + +- 业务链上一阶段的所有节点至少产生一次有效回答后，下一阶段节点进入 `ready` 状态。 +- 同一阶段的节点互不依赖，可以分别问答。 +- 上游节点产生新回答或新产物后，已经执行过的下游节点标记为 `stale`，但不删除历史。 +- “分析结果”同时收录智能体最终回答和文件产物；文件产物优先展示。 +- 第一版岗位下拉只是页面工作视角，不代表真实用户权限；后续接入用户岗位关系后再启用服务端岗位授权。 +- 一个外部任务允许创建多个岗位协同会话；页面默认打开最近更新的一条。 + +### 0.2 待业务最终确认 + +- 固定岗位的正式编码和名称清单。 +- 情报分析岗完成意图识别后，是否还允许承担业务链节点问答。 +- 下游解锁采用“上游首次有效回答”还是增加人工“提交完成”动作。 +- 新任务接口提供的字段、外部任务 ID 和页面进入方式。 +- 岗位是否最终与登录用户绑定，以及一名用户是否允许属于多个岗位。 + +--- + +## 1. 目标与非目标 + +### 1.1 本期目标 + +- 为业务链席位增加岗位分配能力，且只在从岗位协同页面进入配置时显示。 +- 为岗位协同任务提供可刷新、可恢复、可跨页面重新打开的持久化会话。 +- 按“任务 → 意图 → 业务链阶段 → 节点智能体”组织对话和产物。 +- 当前岗位仅展示和调用本岗位被分配的智能体。 +- 点击流程图节点可查看该节点完整问答和产物。 +- 下游智能体自动获得上游结果，不要求用户手工复制粘贴。 +- 保持现有多智能体会商、任务深链、普通智能体聊天行为不变。 + +### 1.2 本期非目标 + +- 不保留总控智能体，不做总控派活、共识判断或自动多轮研讨。 +- 不把岗位协同记录写入 `roundtable_drafts` 或 `roundtable_jobs`。 +- 不自动生成最终综合报告；后续可增加按需调用总结智能体的“生成汇总”功能。 +- 第一版不实现复杂条件分支、人工改线或动态跳转，只遵循现有业务链阶段顺序。 +- 第一版不实现完整组织权限系统；真实岗位授权作为独立阶段接入。 + +--- + +## 2. 目标业务流程 + +1. 页面根据外部任务参数创建或恢复一条岗位协同会话。 +2. 情报分析岗查看任务信息并选择业务链。 +3. 情报分析岗与意图识别智能体问答，确认结构化任务意图。 +4. 系统保存任务、意图和业务链快照，初始化所有业务链节点状态。 +5. 用户切换到其他岗位，只看到分配给当前岗位的可问答智能体。 +6. 用户点击流程图节点： + - 本岗位节点：加载或创建该节点的智能体线程，允许问答； + - 其他岗位节点：加载已有线程和产物，只读查看； + - 尚未解锁节点：展示依赖提示，不允许发送。 +7. 每次发送问题前，系统构建隐藏上下文并注入当前智能体。 +8. 智能体回答完成后保存节点最新回答、产物清单和版本号，并重新计算下游状态。 +9. 右侧“分析结果”按时间倒序聚合全部节点回答和产物。 + +--- + +## 3. 总体技术方案 + +### 3.1 复用范围 + +| 能力 | 方案 | +|------|------| +| 意图识别 | 复用 `useStep1Intent`、`Step1Panel`、`/api/intent/*` | +| 智能体问答 | 复用 `useThreadStream` 和现有 Agent Chat 消息/输入组件 | +| 消息存储 | 复用 LangGraph thread/checkpoint，不新增消息表 | +| 文件产物 | 复用 `/api/threads/{thread_id}/artifacts` | +| 隐藏上下文 | 复用 `task_external_context` 和 `TaskExternalContextMiddleware` | +| 智能体详情 | 复用 `AgentDetailPanel` | +| 业务链 | 扩展现有 `roundtable_chains.seats` JSON | +| 页面业务状态 | 新增岗位协同 Session/Node 存储 | + +### 3.2 明确不复用的圆桌能力 + +- `initMultiAgent` +- `useStep2Orchestration` +- `roundtable-coordinator` +- `roundtable_jobs` +- 圆桌共识百分比与最大循环轮次 +- 自动 Step 3 收口和报告绘制 + +### 3.3 目录建议 + +```text +frontend-web/src/position-roundtable/ +├── api/ +│ ├── sessions.ts +│ └── handoff.ts +├── components/ +│ ├── PositionTaskPanel.tsx +│ ├── PositionChainFlow.tsx +│ ├── PositionAgentChat.tsx +│ ├── PositionAgentList.tsx +│ └── PositionResults.tsx +├── hooks/ +│ ├── usePositionSession.ts +│ ├── usePositionNodeChat.ts +│ └── usePositionHandoff.ts +├── lib/ +│ ├── positions.ts +│ ├── chain-nodes.ts +│ └── types.ts +└── pages/ + └── PositionRoundtablePage.tsx +``` + +后端建议新增： + +```text +offline-backend-20260512/backend/ +├── app/gateway/routers/position_roundtable.py +└── packages/harness/deerflow/persistence/ + ├── position_roundtable_sessions/ + └── position_roundtable_nodes/ +``` + +--- + +## 4. 数据模型 + +### 4.1 业务链席位扩展 + +在现有 `ChainSeat` 中增加： + +```ts +interface ChainSeat { + agent_id: string; + name: string; + description?: string; + position_id?: string | null; +} +``` + +后端 `ChainSeatSchema` 同步增加可选 `position_id`。席位本身存储在 JSON 中，因此无需新增数据库列，但必须确保： + +- 创建、读取、更新接口都保留该字段； +- 普通编辑模式虽然不显示岗位控件，保存时也不能删除已有岗位字段； +- 老链条没有该字段时按“未配置岗位”处理； +- 原圆桌编排忽略该字段，行为保持不变。 + +### 4.2 岗位协同会话表 + +`position_roundtable_sessions` 建议字段： + +| 字段 | 含义 | +|------|------| +| `id` | 岗位协同会话 ID | +| `external_task_id` | 新任务系统提供的任务 ID，可空 | +| `task_snapshot` | 任务信息 JSON 快照 | +| `chain_id` | 来源业务链 ID | +| `chain_snapshot` | 启动时业务链完整快照 | +| `intent_thread_id` | 意图识别线程 ID | +| `intent_snapshot` | `useStep1Intent` 快照及结构化意图 | +| `status` | `intent_pending / active / completed / archived` | +| `created_by` | 创建人 | +| `created_at` | 创建时间 | +| `updated_at` | 更新时间 | + +### 4.3 岗位协同节点表 + +`position_roundtable_nodes` 建议字段： + +| 字段 | 含义 | +|------|------| +| `id` | 节点记录 ID | +| `session_id` | 所属岗位协同会话 | +| `node_key` | 会话内稳定节点键 | +| `stage_index` | 所属业务链阶段 | +| `seat_index` | 阶段内顺序 | +| `agent_id` | 对应智能体 | +| `position_id` | 分配岗位 | +| `thread_id` | 对应智能体聊天线程，可空 | +| `status` | `locked / ready / running / done / stale / error` | +| `latest_answer` | 最新有效回答快照 | +| `artifact_manifest` | 当前产物清单 JSON | +| `revision` | 本节点结果版本号 | +| `upstream_revision` | 最近一次问答使用的上游版本摘要 | +| `created_at` | 创建时间 | +| `updated_at` | 更新时间 | + +唯一约束：`(session_id, node_key)`。 + +### 4.4 Thread metadata + +节点线程创建后写入： + +```json +{ + "thread_type": "position_roundtable", + "position_session_id": "session-id", + "position_node_id": "node-id", + "position_id": "position-code", + "chain_id": "chain-id", + "agent_id": "agent-id" +} +``` + +Thread 继续保存真实消息；节点表只保存业务索引、状态和便于列表展示的快照。 + +--- + +## 5. API 规划 + +建议前缀：`/api/position-roundtable`。 + +### 5.1 会话接口 + +| 方法 | 路径 | 用途 | +|------|------|------| +| `POST` | `/sessions` | 根据任务创建岗位协同会话 | +| `GET` | `/sessions/{id}` | 加载会话、意图和全部节点状态 | +| `GET` | `/sessions?external_task_id=` | 查询任务下的会话历史 | +| `PUT` | `/sessions/{id}/task` | 更新尚未启动的任务快照 | +| `PUT` | `/sessions/{id}/intent` | 保存意图线程和意图快照 | +| `POST` | `/sessions/{id}/activate` | 冻结链条快照并初始化节点 | +| `POST` | `/sessions/{id}/archive` | 归档会话，不删除线程和产物 | + +### 5.2 节点接口 + +| 方法 | 路径 | 用途 | +|------|------|------| +| `GET` | `/sessions/{id}/nodes/{node_key}` | 获取节点、线程、状态和产物 | +| `POST` | `/sessions/{id}/nodes/{node_key}/thread` | 幂等创建节点智能体线程 | +| `POST` | `/sessions/{id}/nodes/{node_key}/context` | 构建本轮隐藏上游上下文 | +| `POST` | `/sessions/{id}/nodes/{node_key}/complete-turn` | 回答结束后同步回答、产物和版本 | +| `GET` | `/sessions/{id}/results` | 聚合全部岗位分析结果 | + +### 5.3 幂等与并发要求 + +- 节点线程接口必须幂等，同一节点并发请求只能创建一个有效 thread。 +- `complete-turn` 使用节点 `revision` 做乐观锁，避免旧请求覆盖新结果。 +- 会话激活后不允许直接替换链条；需要重新建会话或显式“基于新链条重建”。 +- 删除业务链不能删除已有会话中的链条快照。 + +--- + +## 6. 上游结果交接规则 + +### 6.1 上游节点计算 + +- 线性链：当前节点之前的所有已完成节点均为上游。 +- 分层链：只读取当前阶段之前的已完成阶段；同阶段节点不互相引用。 +- 注入顺序按 `stage_index`、`seat_index` 排列，确保每次构建稳定。 + +### 6.2 隐藏上下文结构 + +每次发送问题前，通过 `task_external_context` 注入： + +```json +{ + "kind": "position_roundtable_handoff", + "task": {}, + "intent": {}, + "current_node": {}, + "upstream_nodes": [ + { + "agent_id": "...", + "position_id": "...", + "latest_answer": "...", + "artifacts": [] + } + ], + "upstream_revision": "..." +} +``` + +### 6.3 产物传递 + +- Markdown、TXT、JSON、CSV、YAML 等文本产物：读取正文并按总字符上限注入。 +- PDF、Word、Excel、图片等非纯文本产物：复制到当前节点线程的只读上游资料目录，并在上下文中提供可读虚拟路径。 +- 单文件和总上下文均设置大小限制；发生截断时在上下文中标记 `truncated=true`。 +- 当前节点生成的文件仍写入自己的 `/mnt/user-data/outputs/`，不写回上游线程。 + +### 6.4 上游更新传播 + +1. 节点完成一次回答后 `revision + 1`。 +2. 系统重新计算所有下游节点的上游版本摘要。 +3. 已问答下游节点的摘要不一致时，将状态改为 `stale`。 +4. 用户再次向该节点提问后，使用最新上下文并把状态恢复为 `done`。 + +--- + +## 7. 分阶段实施计划 + +### 阶段 0：边界固定与基线测试 + +目标：明确新旧功能边界，给后续改造建立回归保护。 + +- [x] 固定岗位枚举及意图岗位编码（当前为 `intelligence` / 情报分析岗）。 +- [x] 固定新任务数据适配接口：当前使用可替换的模拟任务源，后续只需替换 `mock-task-source.ts`。 +- [ ] 为原圆桌路由、岗位协同路由分别增加基本渲染测试。 +- [ ] 记录原圆桌业务链创建、编辑、运行的基线行为。 +- [ ] 确认岗位协同模块不导入 `useStep2Orchestration` 或 `initMultiAgent`。 + +完成标准：原会商页面无行为变化；岗位协同页面仍可独立打开。 + +### 阶段 1：业务链岗位配置 + +目标：业务链节点能够持久化岗位，但普通业务链编辑体验不受影响。 + +- [x] `ChainSeat`、前端 API 映射增加 `position_id`。 +- [x] 后端 `ChainSeatSchema` 增加 `position_id` 并补充长度校验。 +- [x] 业务链编辑器识别 `mode=position`。 +- [x] 岗位模式下为每个节点增加 TDesign 岗位选择器。 +- [ ] 增加“未配置岗位”提示、岗位图例和保存校验。 +- [x] 普通模式隐藏岗位控件，但完整保留原岗位字段。 +- [x] 岗位协同页面增加“配置岗位”入口和返回参数。 +- [ ] 增加老链条、普通保存、岗位保存的前后端测试。 + +完成标准：从岗位页面进入时可以配置岗位；从原入口进入时看不到岗位控件；两种入口交替保存不丢字段。 + +### 阶段 2：岗位协同持久化底座 + +目标：任务、意图、链条快照和节点状态可以跨刷新恢复。 + +- [ ] 新增 Session/Node ORM、Repository 和数据库迁移。 +- [ ] 新增会话创建、查询、更新意图、激活和归档接口。 +- [ ] 激活时校验链条、岗位配置和意图结果。 +- [ ] 激活时根据链条快照一次性生成全部 Node 记录。 +- [ ] 新增前端 `sessions.ts` API 和 `usePositionSession`。 +- [ ] 用服务端 Session 替换 `POSITION_TASK_DRAFT_KEY` 主路径。 +- [ ] 页面刷新后恢复任务、意图、选中链条、节点状态和当前会话。 + +完成标准：刷新浏览器后不丢任务和意图；业务链后续编辑不改变已启动会话。 + +### 阶段 3：情报分析岗意图流程 + +目标：把情报分析岗固定为岗位协同的入口阶段。 + +- [ ] 将当前“组织筹划岗负责意图”调整为“情报分析岗负责意图”。 +- [ ] 仅意图岗位渲染 `Step1Panel` 和意图输入能力。 +- [ ] 将任务信息自动作为首轮隐藏背景或开场消息提供给意图智能体。 +- [ ] 意图变化时自动保存 `intent_snapshot`。 +- [ ] 增加“确认意图并启动业务链”动作。 +- [ ] 启动前校验业务链已选、节点岗位已配置、意图已完成。 +- [ ] 其他岗位在未启动时显示只读等待状态。 + +完成标准：情报分析岗确认意图后成功生成节点；其他岗位不能修改意图。 + +### 阶段 4：岗位直连智能体问答 + +目标：去除总控，当前岗位直接与自己节点的智能体多轮问答。 + +- [ ] 抽取或封装可嵌入的 Agent Chat 主区，复用现有消息列表和输入框。 +- [ ] 右侧智能体列表改为当前链条、当前岗位的交集。 +- [ ] 点击智能体或流程节点时切换 `activeNodeKey`。 +- [ ] 节点首次发送前幂等创建 thread，`assistantId = node.agent_id`。 +- [ ] 写入岗位协同 thread metadata。 +- [ ] 本岗位且状态为 `ready/running/done/stale` 时允许输入。 +- [ ] 其他岗位节点和 `locked` 节点使用同一消息列表只读展示。 +- [ ] 移除流程图“总控协调”节点，首部展示“情报分析岗 · 意图识别”。 + +完成标准：页面不调用任何总控接口；不同节点对话互不串线；岗位不能向未分配节点发送问题。 + +### 阶段 5：节点查看与流程状态 + +目标：流程图成为对话、产物和状态的统一导航。 + +- [ ] 节点增加 `locked/ready/running/done/stale/error` 可视状态。 +- [ ] 当前节点增加选中态，并与中间聊天和右侧智能体详情同步。 +- [ ] 点击任意已有节点加载完整消息历史。 +- [ ] 节点运行时防止重复发送并支持停止当前生成。 +- [ ] 计算上一阶段完成情况并自动解锁下一阶段。 +- [ ] 画布拖动时阻止节点误点击，双击空白区域复位。 +- [ ] 保持左侧滚动条、固定画布高度和父容器裁剪。 + +完成标准：用户能从流程图定位任意节点，并准确区分可问答、只读、待上游和结果过期状态。 + +### 阶段 6：上游问答与产物自动交接 + +目标：下游智能体真正获得上游信息，而不只是页面能够查看。 + +- [ ] 新增节点上下文构建接口。 +- [ ] 读取上游节点最新有效回答和结构化意图。 +- [ ] 读取上游文本产物并执行字符数限制与截断标记。 +- [ ] 为非文本产物实现安全复制或只读挂载。 +- [ ] 发送消息时通过 `task_external_context` 注入上下文。 +- [ ] 回答结束后同步 `latest_answer`、产物清单和 `revision`。 +- [ ] 上游更新时传播 `stale` 状态。 +- [ ] 增加上下文顺序、截断、文件隔离和版本传播测试。 + +完成标准：下游回答能够引用上游真实结论；不需要用户复制粘贴；不同 thread 的文件不串写。 + +### 阶段 7：分析结果聚合 + +目标：右侧结果页展示全部岗位、节点的真实结果。 + +- [ ] 新增 Session 结果聚合接口。 +- [ ] 回答结论生成“问答结果”记录。 +- [ ] 每个实际文件生成独立产物记录。 +- [ ] 卡片显示智能体名称、产物名称、岗位、生成时间和状态。 +- [ ] 支持按岗位、节点、产物类型筛选。 +- [ ] 点击结果跳转并高亮对应流程节点。 +- [ ] 文本产物复用现有预览组件，其他文件复用下载地址。 +- [ ] `stale` 结果显示“上游已更新”提示，不自动隐藏旧结果。 + +完成标准：结果数量、节点文件清单和实际线程产物一致；点击结果能回到对应对话。 + +### 阶段 8：嵌入、权限与恢复 + +目标：满足外部系统嵌入及多人岗位使用场景。 + +- [ ] 支持从 URL/外部任务接口恢复 `external_task_id` 和 Session。 +- [ ] 复用现有 `embed=1` 模式隐藏全局侧边栏和导航外壳。 +- [ ] 深浅主题下核对左、中、右三栏背景和 TDesign 控件。 +- [ ] 明确岗位下拉在嵌入系统中的来源和默认值。 +- [ ] 若接入真实用户岗位，新增 Session 成员/岗位授权模型。 +- [ ] 服务端校验当前用户是否能向目标节点发送问题。 +- [ ] 定义会话归档、任务关闭和只读历史规则。 + +完成标准：嵌入刷新不丢会话；不同岗位用户只能写自己的节点，同时可以按规则查看上游节点。 + +### 阶段 9：测试、回归与发布 + +目标：新功能可上线，原功能零回归。 + +- [ ] 前端类型检查、Chrome 109 CSS 兼容检查和生产构建通过。 +- [ ] 后端 Repository、Router、上下文构建和并发创建测试通过。 +- [ ] 覆盖线性链、分层链、同阶段并行节点、无岗位配置和智能体被删除场景。 +- [ ] 覆盖刷新恢复、重复点击、新旧上游版本、文件过大和产物为空场景。 +- [ ] 回归原业务链编辑、原多智能体会商和普通 Agent Chat。 +- [ ] 使用真实数据完成浅色、深色、嵌入三种视图的截图对比。 +- [ ] 编写接口说明、部署迁移说明和回滚说明。 + +完成标准：自动化测试通过；真实链条端到端走通；原页面和原接口行为不变。 + +--- + +## 8. 建议的提交拆分 + +每个提交保持可独立审查和回滚： + +1. `feat(chain): add optional position assignment to seats` +2. `feat(position-roundtable): add session persistence` +3. `feat(position-roundtable): persist intent workflow` +4. `feat(position-roundtable): add direct agent node chats` +5. `feat(position-roundtable): add interactive chain navigation` +6. `feat(position-roundtable): inject upstream handoff context` +7. `feat(position-roundtable): aggregate node artifacts` +8. `test(position-roundtable): cover workflow and regressions` + +--- + +## 9. 验收清单 + +- [ ] 岗位协同页面与原会商页面使用不同路由和不同业务存储。 +- [ ] 页面运行过程中没有创建或调用总控智能体。 +- [ ] 情报分析岗能够完成并持久化意图识别。 +- [ ] 业务链岗位配置只在岗位模式入口显示。 +- [ ] 当前岗位的智能体列表只包含被分配的链条节点。 +- [ ] 非本岗位节点可查看但不能发送消息。 +- [ ] 点击节点可以恢复对应的完整聊天记录和文件产物。 +- [ ] 下游智能体能够获得上游问答结果和产物内容。 +- [ ] 上游更新后下游结果能够提示过期。 +- [ ] 刷新、重新进入和嵌入模式下数据不丢失。 +- [ ] 原业务链配置、原多智能体会商和普通智能体问答均无回归。 + +--- + +## 10. 第一轮推荐实施范围 + +第一轮建议完成阶段 0～4，形成可实际操作的最小闭环： + +```text +岗位配置 → 创建会话 → 情报分析岗确认意图 → 生成业务链节点 +→ 切换岗位 → 点击本岗位节点 → 直接调用对应智能体问答 → 刷新恢复 +``` + +第二轮完成阶段 5～7，把流程图查看、上游自动交接和结果聚合补齐；第三轮处理真实岗位权限、外部任务接口和上线回归。 + +## 11. 当前实现状态（2026-07-21） + +已完成的首个可运行闭环： + +- 业务链席位已支持可选 `position_id`；只有从岗位协同页面进入业务链编辑器时才显示 TDesign 岗位选择器，普通会商配置会完整保留该字段且不显示该控件。未配置岗位的席位会在业务链选择区标明，并在启动前阻止进入节点执行。 +- 新任务入口已先以 `mock-task-source.ts` 提供 3 条模拟任务；页面通过 `taskId` 识别任务、自动恢复该任务最近一条未归档会话，支持“新建会话”和会话归档。正式任务接口确认后只替换这一数据源即可。 +- 新增独立的 `position_roundtable_sessions` / `position_roundtable_nodes` 持久化、迁移和 `/api/position-roundtable` 接口；它不使用原会商的草稿、总控、作业或自动收口流程。 +- 情报分析岗复用既有意图识别对话。确认意图后会冻结业务链、创建节点、将会话 ID 写入新页面 URL，刷新可恢复节点与其已绑定的标准聊天线程。 +- 业务链节点直接调用其配置的 `agent_id`，复用原消息列表和输入框。节点问答会注入任务、意图、已完成上游的回答和产物引用；同阶段全部完成后才解锁下一阶段，上游重答会把下游标记为 `stale`。 +- 节点交接接口会额外读取上游节点自身线程里的文本产物正文（Markdown、文本、JSON、CSV 等），按总量和单文件长度截断后注入下游智能体；二进制产物仍仅传递安全引用，且不会跨线程写入或共享工作目录。 +- 左侧流程图、右侧岗位智能体列表和结果卡片均以当前会话节点为准；跨岗位和未解锁节点保持只读。分析结果会把每条问答、每个实际文件分别列卡，支持按岗位、节点、产物类型筛选，并对 `stale` 结果标明“上游已更新”。 +- 选中流程节点或分析结果卡片后，中间对话区会同时展示该节点的产物清单；点击文件复用既有预览组件，读取的始终是该节点绑定线程下的产物。归档会话保持完整可读，但前后端均拒绝继续写入、绑定节点或生成上下文。 + +仍需在产品/组织接口确定后替换：新任务系统的正式字段与进入方式、真实用户岗位授权、上游非文本产物的安全挂载或复制，以及使用真实登录数据的完整端到端回归。 diff --git a/frontend-web/src/position-roundtable/api/sessions.ts b/frontend-web/src/position-roundtable/api/sessions.ts new file mode 100644 index 00000000..793eb5b0 --- /dev/null +++ b/frontend-web/src/position-roundtable/api/sessions.ts @@ -0,0 +1,264 @@ +/** Client for the independent position-collaboration Session / Node API. + * + * Messages themselves stay in LangGraph threads. These endpoints only persist + * task/intent snapshots, frozen chain topology, node states and indexes that + * let the UI recover the correct thread after a refresh. + */ +import { apiFetch } from "@/core/api/fetch-client"; +import { getBackendBaseURL } from "@/core/config"; + +export type PositionNodeStatus = + | "locked" + | "ready" + | "running" + | "done" + | "stale" + | "error"; + +export interface PositionRoundtableNode { + id: string; + sessionId: string; + nodeKey: string; + stageIndex: number; + seatIndex: number; + agentId: string; + positionId: string | null; + threadId: string | null; + status: PositionNodeStatus; + latestAnswer: string | null; + artifactManifest: Array>; + revision: number; + upstreamRevision: Record | null; + createdAt?: string; + updatedAt?: string; +} + +export interface PositionRoundtableSession { + id: string; + externalTaskId: string | null; + taskSnapshot: Record; + chainId: string | null; + chainSnapshot: Record | null; + intentThreadId: string | null; + intentSnapshot: Record | null; + status: "intent_pending" | "active" | "completed" | "archived"; + createdAt?: string; + updatedAt?: string; + nodes?: PositionRoundtableNode[]; +} + +interface ServerNode { + id: string; + session_id: string; + node_key: string; + stage_index: number; + seat_index: number; + agent_id: string; + position_id: string | null; + thread_id: string | null; + status: PositionNodeStatus; + latest_answer: string | null; + artifact_manifest?: Array>; + revision?: number; + upstream_revision?: Record | null; + created_at?: string; + updated_at?: string; +} + +interface ServerSession { + id: string; + external_task_id: string | null; + task_snapshot?: Record; + chain_id: string | null; + chain_snapshot?: Record | null; + intent_thread_id: string | null; + intent_snapshot?: Record | null; + status: PositionRoundtableSession["status"]; + created_at?: string; + updated_at?: string; + nodes?: ServerNode[]; +} + +const BASE = () => `${getBackendBaseURL()}/api/position-roundtable`; + +async function readJson(response: Response, label: string): Promise { + if (!response.ok) { + const detail = await response.text().catch(() => ""); + throw new Error(`${label} failed (${response.status}): ${detail}`); + } + return response.json() as Promise; +} + +function toNode(node: ServerNode): PositionRoundtableNode { + return { + id: node.id, + sessionId: node.session_id, + nodeKey: node.node_key, + stageIndex: node.stage_index, + seatIndex: node.seat_index, + agentId: node.agent_id, + positionId: node.position_id, + threadId: node.thread_id, + status: node.status, + latestAnswer: node.latest_answer, + artifactManifest: node.artifact_manifest ?? [], + revision: node.revision ?? 0, + upstreamRevision: node.upstream_revision ?? null, + createdAt: node.created_at, + updatedAt: node.updated_at, + }; +} + +function toSession(session: ServerSession): PositionRoundtableSession { + return { + id: session.id, + externalTaskId: session.external_task_id, + taskSnapshot: session.task_snapshot ?? {}, + chainId: session.chain_id, + chainSnapshot: session.chain_snapshot ?? null, + intentThreadId: session.intent_thread_id, + intentSnapshot: session.intent_snapshot ?? null, + status: session.status, + createdAt: session.created_at, + updatedAt: session.updated_at, + nodes: session.nodes?.map(toNode), + }; +} + +export async function listPositionSessions(externalTaskId?: string): Promise { + const params = externalTaskId ? `?external_task_id=${encodeURIComponent(externalTaskId)}` : ""; + const result = await readJson( + await apiFetch(`${BASE()}/sessions${params}`), + "list position sessions", + ); + return result.map(toSession); +} + +export async function createPositionSession(input: { + externalTaskId?: string; + taskSnapshot: Record; +}): Promise { + const result = await readJson( + await apiFetch(`${BASE()}/sessions`, { + method: "POST", + headers: { "Content-Type": "application/json" }, + body: JSON.stringify({ + external_task_id: input.externalTaskId || null, + task_snapshot: input.taskSnapshot, + }), + }), + "create position session", + ); + return toSession(result); +} + +export async function getPositionSession(sessionId: string): Promise { + const result = await readJson( + await apiFetch(`${BASE()}/sessions/${encodeURIComponent(sessionId)}`), + "get position session", + ); + return toSession(result); +} + +export async function savePositionIntent( + sessionId: string, + input: { intentThreadId?: string | null; intentSnapshot: object | null }, +): Promise { + const result = await readJson( + await apiFetch(`${BASE()}/sessions/${encodeURIComponent(sessionId)}/intent`, { + method: "PUT", + headers: { "Content-Type": "application/json" }, + body: JSON.stringify({ + intent_thread_id: input.intentThreadId || null, + intent_snapshot: input.intentSnapshot, + }), + }), + "save position intent", + ); + return toSession(result); +} + +export async function activatePositionSession( + sessionId: string, + chainId: string, +): Promise { + const result = await readJson( + await apiFetch(`${BASE()}/sessions/${encodeURIComponent(sessionId)}/activate`, { + method: "POST", + headers: { "Content-Type": "application/json" }, + body: JSON.stringify({ chain_id: chainId }), + }), + "activate position session", + ); + return toSession(result); +} + +export async function archivePositionSession(sessionId: string): Promise { + const result = await readJson( + await apiFetch(`${BASE()}/sessions/${encodeURIComponent(sessionId)}/archive`, { + method: "POST", + }), + "archive position session", + ); + return toSession(result); +} + +export async function bindPositionNodeThread( + sessionId: string, + nodeKey: string, + threadId: string, +): Promise { + const result = await readJson( + await apiFetch( + `${BASE()}/sessions/${encodeURIComponent(sessionId)}/nodes/${encodeURIComponent(nodeKey)}/thread`, + { + method: "POST", + headers: { "Content-Type": "application/json" }, + body: JSON.stringify({ thread_id: threadId }), + }, + ), + "bind position node thread", + ); + return toNode(result); +} + +/** Fetch the bounded hidden task/intent/upstream handoff before one node turn. */ +export async function getPositionNodeContext( + sessionId: string, + nodeKey: string, +): Promise> { + return readJson>( + await apiFetch( + `${BASE()}/sessions/${encodeURIComponent(sessionId)}/nodes/${encodeURIComponent(nodeKey)}/context`, + { method: "POST" }, + ), + "build position node context", + ); +} + +export async function completePositionNodeTurn( + sessionId: string, + nodeKey: string, + input: { + latestAnswer: string; + artifactManifest?: Array>; + upstreamRevision?: Record | null; + }, +): Promise { + const result = await readJson( + await apiFetch( + `${BASE()}/sessions/${encodeURIComponent(sessionId)}/nodes/${encodeURIComponent(nodeKey)}/complete-turn`, + { + method: "POST", + headers: { "Content-Type": "application/json" }, + body: JSON.stringify({ + latest_answer: input.latestAnswer, + artifact_manifest: input.artifactManifest ?? [], + upstream_revision: input.upstreamRevision ?? null, + }), + }, + ), + "complete position node turn", + ); + return toNode(result); +} diff --git a/frontend-web/src/position-roundtable/components/PositionNodeChat.tsx b/frontend-web/src/position-roundtable/components/PositionNodeChat.tsx new file mode 100644 index 00000000..306dd84a --- /dev/null +++ b/frontend-web/src/position-roundtable/components/PositionNodeChat.tsx @@ -0,0 +1,285 @@ +import { useCallback, useEffect, useMemo, useRef, useState } from "react"; +import { Bot, FileText, LockKeyhole, Loader2 } from "lucide-react"; +import { toast } from "sonner"; + +import type { PromptInputMessage } from "@/components/ai-elements/prompt-input"; +import { InputBox } from "@/components/workspace/input-box"; +import { ThreadContext } from "@/components/workspace/messages/context"; +import { MessageList } from "@/components/workspace/messages"; +import { useLocalSettings } from "@/core/settings"; +import { useThreadStream } from "@/core/threads/hooks"; +import { textOfMessage } from "@/core/threads/utils"; +import { uuid } from "@/core/utils/uuid"; +import { + bindPositionNodeThread, + completePositionNodeTurn, + getPositionNodeContext, + type PositionRoundtableNode, +} from "@/position-roundtable/api/sessions"; +import { listSessionArtifacts } from "@/roundtable-planning/api/multi-agent"; +import { ArtifactPreviewModal } from "@/roundtable-planning/components/ArtifactPreviewModal"; + +interface PositionNodeChatProps { + sessionId: string; + chainId: string | null; + node: PositionRoundtableNode; + currentPositionId: string; + sessionStatus: "intent_pending" | "active" | "completed" | "archived"; + onNodeUpdate: (node: PositionRoundtableNode) => void; +} + +interface NodeArtifact { + name: string; + path: string; + mimeType: string | null; +} + +function readNodeArtifacts(manifest: Array>): NodeArtifact[] { + return manifest.flatMap((artifact) => { + const path = typeof artifact.path === "string" ? artifact.path : ""; + if (!path) return []; + const name = + typeof artifact.name === "string" && artifact.name.trim() + ? artifact.name + : path.split("/").filter(Boolean).at(-1) || "未命名产物"; + const mimeType = + typeof artifact.mime_type === "string" + ? artifact.mime_type + : typeof artifact.mimeType === "string" + ? artifact.mimeType + : null; + return [{ name, path, mimeType }]; + }); +} + +/** + * Direct single-agent chat for one frozen business-chain node. + * + * It deliberately uses the regular `useThreadStream` + `MessageList` + + * `InputBox` stack. The position Session merely records which existing thread + * belongs to the node; it is not a second message persistence mechanism. + */ +export function PositionNodeChat({ + sessionId, + chainId, + node, + currentPositionId, + sessionStatus, + onNodeUpdate, +}: PositionNodeChatProps) { + const [settings, setSettings] = useLocalSettings(); + const [boundThreadId, setBoundThreadId] = useState(node.threadId); + const boundThreadIdRef = useRef(node.threadId); + const draftThreadIdRef = useRef(node.threadId ?? uuid()); + const upstreamRevisionRef = useRef | null>(null); + const [previewArtifact, setPreviewArtifact] = useState(null); + const nodeArtifacts = useMemo(() => readNodeArtifacts(node.artifactManifest), [node.artifactManifest]); + const canWrite = + sessionStatus !== "archived" && + node.positionId === currentPositionId && + node.status !== "locked" && + node.status !== "error"; + + useEffect(() => { + setBoundThreadId(node.threadId); + boundThreadIdRef.current = node.threadId; + }, [node.threadId]); + + const bindCreatedThread = useCallback( + (threadId: string) => { + boundThreadIdRef.current = threadId; + setBoundThreadId(threadId); + void bindPositionNodeThread(sessionId, node.nodeKey, threadId) + .then(onNodeUpdate) + .catch((error) => { + toast.error(`节点对话绑定失败：${error instanceof Error ? error.message : String(error)}`); + }); + }, + [node.nodeKey, onNodeUpdate, sessionId], + ); + + const [thread, sendMessage] = useThreadStream({ + threadId: boundThreadId, + assistantId: node.agentId, + context: { ...settings.context, agent_id: node.agentId }, + threadMetadata: { + thread_type: "position_roundtable", + position_session_id: sessionId, + position_node_id: node.id, + position_id: node.positionId, + chain_id: chainId, + agent_id: node.agentId, + }, + onStart: bindCreatedThread, + onFinish: (state) => { + const threadId = boundThreadIdRef.current; + const latestAi = [...(state.messages ?? [])] + .reverse() + .find((message) => message.type === "ai"); + const latestAnswer = latestAi ? textOfMessage(latestAi) ?? "" : ""; + if (!threadId || !latestAnswer.trim()) return; + void (async () => { + let artifactManifest: Array> = []; + try { + const artifacts = await listSessionArtifacts(threadId); + artifactManifest = artifacts.files.map((file) => ({ + name: file.name, + path: file.path, + mime_type: file.mimeType, + modified_at: file.modifiedAt, + })); + } catch { + // Artifact listing is best-effort: a valid text answer must still be + // persisted and unlock downstream work even if files cannot be read. + } + try { + const updated = await completePositionNodeTurn(sessionId, node.nodeKey, { + latestAnswer, + artifactManifest, + upstreamRevision: upstreamRevisionRef.current, + }); + onNodeUpdate(updated); + } catch (error) { + toast.error(`节点结果保存失败：${error instanceof Error ? error.message : String(error)}`); + } + })(); + }, + }); + + const handleSubmit = useCallback( + async (message: PromptInputMessage) => { + if (!canWrite) { + toast.info( + sessionStatus === "archived" + ? "该会话已归档，仅可查看历史记录" + : node.status === "locked" + ? "该节点尚未解锁" + : "当前岗位只能查看该节点对话", + ); + return; + } + try { + const taskExternalContext = await getPositionNodeContext(sessionId, node.nodeKey); + const upstreamRevision = taskExternalContext.upstream_revision; + upstreamRevisionRef.current = + upstreamRevision && typeof upstreamRevision === "object" && !Array.isArray(upstreamRevision) + ? (upstreamRevision as Record) + : null; + await sendMessage(boundThreadIdRef.current ?? draftThreadIdRef.current, message, { + agent_id: node.agentId, + task_external_context: taskExternalContext, + }); + } catch (error) { + toast.error(`发送失败：${error instanceof Error ? error.message : String(error)}`); + } + }, + [canWrite, node.agentId, node.nodeKey, node.status, sendMessage, sessionId, sessionStatus], + ); + + const status = thread.error ? "error" : thread.isLoading ? "streaming" : "ready"; + const displayThreadId = boundThreadId ?? `position-node-${node.id}`; + const readOnlyHint = + sessionStatus === "archived" + ? "该会话已归档，仅可查看历史对话和产物" + : node.status === "locked" + ? "等待上游岗位完成后解锁" + : node.positionId !== currentPositionId + ? "当前岗位仅可查看该节点的对话和产物" + : ""; + + return ( + +
+
+ + {node.status === "locked" ? : } + +
+

+ {node.agentId} +

+

+ {readOnlyHint || `节点状态：${node.status}`} +

+
+ {thread.isLoading && } +
+ + {nodeArtifacts.length > 0 && ( +
+
+ + 节点产物 + + {nodeArtifacts.length} + +
+
+ {nodeArtifacts.map((artifact) => ( + + ))} +
+
+ )} + + {boundThreadId ? ( + void handleSubmit({ text, files: [] })} + /> + ) : ( +
+ + + +

+ {canWrite ? "向该岗位智能体发起第一次问答" : "该节点尚无可查看的对话"} +

+

+ {canWrite + ? "系统会自动传入任务意图和已完成上游节点的问答结果。" + : readOnlyHint || "请选择已启动的岗位节点。"} +

+
+ )} + +
+ setSettings("context", context)} + onSubmit={(message) => void handleSubmit(message)} + onStop={() => void thread.stop()} + /> +
+ {previewArtifact && boundThreadId && ( + setPreviewArtifact(null)} + /> + )} +
+ + ); +} diff --git a/frontend-web/src/position-roundtable/lib/mock-task-source.ts b/frontend-web/src/position-roundtable/lib/mock-task-source.ts new file mode 100644 index 00000000..de6fb023 --- /dev/null +++ b/frontend-web/src/position-roundtable/lib/mock-task-source.ts @@ -0,0 +1,72 @@ +/** + * Temporary task source for the standalone position-collaboration workspace. + * + * The real task-system adapter should replace only this module. The page and + * Session API consume the normalized `PositionTask` shape, so they do not need + * to know whether data came from an external task platform or this local demo. + */ + +export interface PositionTask { + id: string; + title: string; + description: string; + direction: string; + source: "mock"; +} + +export const MOCK_POSITION_TASKS: readonly PositionTask[] = [ + { + id: "mock-position-task-001", + title: "重点区域态势研判与协同处置方案", + description: + "围绕重点区域近期态势，梳理风险信号、影响范围与处置约束，形成可执行的协同方案及评估建议。", + direction: "态势研判", + source: "mock", + }, + { + id: "mock-position-task-002", + title: "重大活动保障资源统筹任务", + description: + "针对重大活动保障场景，识别关键保障目标、现有资源和跨部门协同难点，输出分阶段资源统筹方案。", + direction: "组织筹划", + source: "mock", + }, + { + id: "mock-position-task-003", + title: "专项行动效果复盘与优化建议", + description: + "汇总专项行动过程信息与阶段产物，研判实际效果、剩余风险和优化路径，形成后续行动建议。", + direction: "综合评估", + source: "mock", + }, +] as const; + +export const DEFAULT_MOCK_POSITION_TASK_ID = MOCK_POSITION_TASKS[0].id; + +export function getMockPositionTask(taskId?: string | null): PositionTask { + return ( + MOCK_POSITION_TASKS.find((task) => task.id === taskId) ?? + MOCK_POSITION_TASKS[0] + ); +} + +/** Normalizes a persisted Session task snapshot without exposing source internals. */ +export function taskFromPositionSnapshot( + snapshot: Record | null | undefined, + fallback: PositionTask, +): PositionTask { + if (!snapshot || Object.keys(snapshot).length === 0) return fallback; + const value = (keys: string[], defaultValue: string) => { + const found = keys + .map((key) => snapshot[key]) + .find((item) => typeof item === "string" && item.trim()); + return typeof found === "string" ? found : defaultValue; + }; + return { + id: value(["id", "taskId", "externalTaskId"], fallback.id), + title: value(["title", "taskName", "name"], fallback.title), + description: value(["description", "taskContent", "overview", "content"], fallback.description), + direction: value(["direction", "taskDirection", "category"], fallback.direction), + source: "mock", + }; +} diff --git a/frontend-web/src/position-roundtable/lib/positions.ts b/frontend-web/src/position-roundtable/lib/positions.ts new file mode 100644 index 00000000..34c0582f --- /dev/null +++ b/frontend-web/src/position-roundtable/lib/positions.ts @@ -0,0 +1,39 @@ +/** + * 岗位协同的第一版岗位目录。 + * + * 当前岗位仅代表页面工作视角；后续接入组织岗位 / 权限系统时，保留这里的稳定 id， + * 只替换数据源即可。业务链条席位用 `position_id` 持久化这组 id。 + */ +export const POSITION_OPTIONS = [ + { + id: "intelligence", + name: "情报分析岗", + description: "识别任务意图、补齐约束并确认业务链条", + isIntentPosition: true, + }, + { + id: "planning", + name: "组织筹划岗", + description: "承接上游信息并进行组织筹划", + isIntentPosition: false, + }, + { + id: "solution", + name: "方案设计岗", + description: "承接上游结果并形成方案产物", + isIntentPosition: false, + }, + { + id: "evaluation", + name: "综合评估岗", + description: "评估链条产物并提出综合建议", + isIntentPosition: false, + }, +] as const; + +export type PositionId = (typeof POSITION_OPTIONS)[number]["id"]; + +export const DEFAULT_POSITION_ID: PositionId = "intelligence"; + +export const positionNameById = (positionId: string | null | undefined): string => + POSITION_OPTIONS.find((position) => position.id === positionId)?.name ?? "未分配岗位"; diff --git a/frontend-web/src/position-roundtable/pages/PositionRoundtablePage.tsx b/frontend-web/src/position-roundtable/pages/PositionRoundtablePage.tsx index 34ba6e96..c0911b62 100644 --- a/frontend-web/src/position-roundtable/pages/PositionRoundtablePage.tsx +++ b/frontend-web/src/position-roundtable/pages/PositionRoundtablePage.tsx @@ -1,7 +1,9 @@ import { useCallback, useEffect, useMemo, useRef, useState } from "react"; import { useQuery } from "@tanstack/react-query"; +import { useNavigate, useSearchParams } from "react-router-dom"; import { ArrowLeft, + Archive, Bot, BriefcaseBusiness, CheckCircle2, @@ -12,7 +14,9 @@ import { Layers3, Loader2, MessageSquareText, + Plus, Search, + Settings, Sparkles, Target, UserRoundCog, @@ -35,73 +39,41 @@ import { desensitize } from "@/lib/desensitize"; import { cn } from "@/lib/utils"; import { listChains } from "@/roundtable-planning/api/chains"; import { Step1Panel } from "@/roundtable-planning/components/Step1Panel"; +import { PositionNodeChat } from "@/position-roundtable/components/PositionNodeChat"; import { getAvatar } from "@/roundtable-planning/components/Avatars"; import { useStep1Intent } from "@/roundtable-planning/hooks/useStep1Intent"; +import type { IntentSummary } from "@/roundtable-planning/api/intent"; import type { BusinessChain } from "@/roundtable-planning/lib/business-chain"; import { getAvatarTypeFor } from "@/roundtable-planning/lib/roundtable-constants"; - -/** - * 岗位会商与任务深链完全解耦：当前先以浏览器会话草稿承接任务信息， - * 新任务接口确认后只需要替换这组读写函数，不会影响既有会商或任务工作区。 - */ -const POSITION_TASK_DRAFT_KEY = "position-roundtable:task-draft"; - -interface PositionTaskDraft { - id: string; - title: string; - description: string; - direction: string; -} - -const DEFAULT_POSITION_TASK: PositionTaskDraft = { - id: "", - title: "未命名岗位会商任务", - description: "请补充本次岗位会商的任务背景、目标和交付要求。", - direction: "研判分析", -}; - -function readPositionTaskDraft(): PositionTaskDraft { - try { - const raw = sessionStorage.getItem(POSITION_TASK_DRAFT_KEY); - if (!raw) return DEFAULT_POSITION_TASK; - const data = JSON.parse(raw) as Partial; - return { - ...DEFAULT_POSITION_TASK, - ...data, - }; - } catch { - return DEFAULT_POSITION_TASK; - } -} +import { + DEFAULT_POSITION_ID, + POSITION_OPTIONS, + positionNameById, + type PositionId, +} from "@/position-roundtable/lib/positions"; +import { + activatePositionSession, + archivePositionSession, + createPositionSession, + getPositionSession, + listPositionSessions, + savePositionIntent, + type PositionRoundtableNode, + type PositionRoundtableSession, +} from "@/position-roundtable/api/sessions"; +import { + DEFAULT_MOCK_POSITION_TASK_ID, + getMockPositionTask, + MOCK_POSITION_TASKS, + taskFromPositionSnapshot, + type PositionTask, +} from "@/position-roundtable/lib/mock-task-source"; /** * 第一版先固定岗位，等岗位接口与权限范围确认后只替换常量数据源。 - * 组织筹划岗复用原会商 Step 1，承担意图识别。 + * 情报分析岗复用原会商 Step 1，承担意图识别。 */ -const POSITIONS = [ - { - id: "planning", - name: "组织筹划岗", - description: "识别任务意图、补齐约束并选择业务链条", - }, - { - id: "intelligence", - name: "情报分析岗", - description: "围绕已确认意图开展情报分析", - }, - { - id: "solution", - name: "方案设计岗", - description: "承接上游结果并形成方案产物", - }, - { - id: "evaluation", - name: "综合评估岗", - description: "汇总链条结果并完成综合评估", - }, -] as const; - -type PositionId = (typeof POSITIONS)[number]["id"]; +const POSITIONS = POSITION_OPTIONS; type WorkspaceTab = "agents" | "results"; function uniqueChains(chains: BusinessChain[]): BusinessChain[] { @@ -123,22 +95,56 @@ function timeLabel(): string { }).format(new Date()); } +function parseIntentSummary(snapshot: Record | null | undefined): IntentSummary | null { + if (!snapshot || typeof snapshot.objective !== "string" || !Array.isArray(snapshot.constraints)) { + return null; + } + return { + objective: snapshot.objective, + constraints: snapshot.constraints.filter((item): item is string => typeof item === "string"), + assumptions: Array.isArray(snapshot.assumptions) + ? snapshot.assumptions.filter((item): item is string => typeof item === "string") + : undefined, + }; +} + export default function PositionRoundtablePage() { + const navigate = useNavigate(); + const [searchParams, setSearchParams] = useSearchParams(); const { theme } = useTheme(); const isDark = theme === "dark"; - const [positionId, setPositionId] = useState("planning"); - const task = useMemo(readPositionTaskDraft, []); + const [positionId, setPositionId] = useState(DEFAULT_POSITION_ID); + const taskIdFromUrl = searchParams.get("taskId") ?? DEFAULT_MOCK_POSITION_TASK_ID; + const searchParamsString = searchParams.toString(); + const fallbackTask = useMemo(() => getMockPositionTask(taskIdFromUrl), [taskIdFromUrl]); + const sessionIdFromUrl = searchParams.get("sessionId"); + const forceNewSession = searchParams.get("new") === "1"; + const [positionSession, setPositionSession] = useState(null); + const [sessionLoading, setSessionLoading] = useState(false); + const [sessionDiscoveryDone, setSessionDiscoveryDone] = useState(Boolean(sessionIdFromUrl)); + const [startingChain, setStartingChain] = useState(false); const activePosition = POSITIONS.find((item) => item.id === positionId)!; + const frozenIntent = useMemo( + () => parseIntentSummary(positionSession?.intentSnapshot), + [positionSession?.intentSnapshot], + ); + const task = useMemo( + () => taskFromPositionSnapshot(positionSession?.taskSnapshot, fallbackTask), + [fallbackTask, positionSession?.taskSnapshot], + ); const { models } = useModels(); const selectedModel = models[0]?.name ?? ""; const triggerToast = useCallback((message: string) => toast.info(message), []); const intent = useStep1Intent({ // 全岗位共用原会商的对话接口与输入面板；岗位运行编排后续再按角色接入。 - currentStep: 1, + // An existing URL-bound session already owns an intent thread/snapshot. + // Do not create an unused fresh intent thread while that Session loads. + currentStep: sessionIdFromUrl || (!forceNewSession && !sessionDiscoveryDone) ? 0 : 1, selectedModel, triggerToast, }); + const hydratedIntentSessionRef = useRef(null); const { data: chains = [], isLoading: chainsLoading } = useQuery({ queryKey: ["position-roundtable", "chains"], @@ -157,8 +163,170 @@ export default function PositionRoundtablePage() { }, [chains, selectedChainId]); const selectedChain = chains.find((chain) => chain.id === selectedChainId) ?? null; - + const activeChain = useMemo(() => { + const frozen = positionSession?.chainSnapshot; + if ( + positionSession?.status !== "intent_pending" && + frozen && + Array.isArray(frozen.seats) + ) { + return frozen as unknown as BusinessChain; + } + return selectedChain; + }, [positionSession?.chainSnapshot, positionSession?.status, selectedChain]); + const assignedAgentIds = useMemo( + () => + new Set( + (activeChain?.seats ?? []) + .filter((seat) => seat.position_id === positionId) + .map((seat) => seat.agent_id), + ), + [activeChain, positionId], + ); const [selectedAgentId, setSelectedAgentId] = useState(null); + const [activeNodeKey, setActiveNodeKey] = useState(null); + const activeNode = useMemo( + () => positionSession?.nodes?.find((node) => node.nodeKey === activeNodeKey) ?? null, + [activeNodeKey, positionSession?.nodes], + ); + useEffect(() => { + const nodes = positionSession?.nodes ?? []; + const currentNodeStillVisible = nodes.some( + (node) => node.nodeKey === activeNodeKey && node.positionId === positionId, + ); + if (currentNodeStillVisible) return; + const next = nodes.find((node) => node.positionId === positionId) ?? null; + setActiveNodeKey(next?.nodeKey ?? null); + }, [activeNodeKey, positionId, positionSession?.nodes]); + const handleNodeUpdate = useCallback((updatedNode: PositionRoundtableNode) => { + setPositionSession((current) => { + if (!current?.nodes) return current; + return { + ...current, + nodes: current.nodes.map((node) => + node.nodeKey === updatedNode.nodeKey ? updatedNode : node, + ), + }; + }); + + // Completing a node can also unlock the next stage or invalidate a later + // result. Reload the compact Session graph so every panel reflects that + // server-side transition immediately. + if (updatedNode.sessionId === sessionIdFromUrl) { + void getPositionSession(updatedNode.sessionId) + .then((session) => setPositionSession(session)) + .catch(() => undefined); + } + }, [sessionIdFromUrl]); + + useEffect(() => { + if ( + !positionSession?.id || + hydratedIntentSessionRef.current === positionSession.id || + !positionSession.intentThreadId || + !frozenIntent + ) { + return; + } + hydratedIntentSessionRef.current = positionSession.id; + intent.hydrateFromDraft({ + intentThreadId: positionSession.intentThreadId, + intentReady: frozenIntent, + interactiveMessages: [], + timelineEntries: [], + }); + }, [frozenIntent, intent, positionSession?.id, positionSession?.intentThreadId]); + const handleSelectAgent = useCallback( + (agentId: string) => { + setSelectedAgentId(agentId); + const node = positionSession?.nodes?.find( + (item) => item.agentId === agentId && item.positionId === positionId, + ); + if (node) setActiveNodeKey(node.nodeKey); + }, + [positionId, positionSession?.nodes], + ); + const openPositionConfig = useCallback( + (chainId: string) => { + const taskQuery = `taskId=${encodeURIComponent(task.id)}${forceNewSession ? "&new=1" : ""}`; + const returnTo = sessionIdFromUrl + ? `/page/strategy/qa/position-roundtable?${taskQuery}&sessionId=${encodeURIComponent(sessionIdFromUrl)}` + : `/page/strategy/qa/position-roundtable?${taskQuery}`; + navigate( + `/page/workspace/roundtable/chains?chainId=${encodeURIComponent(chainId)}&mode=position&returnTo=${encodeURIComponent(returnTo)}`, + ); + }, + [forceNewSession, navigate, sessionIdFromUrl, task.id], + ); + + // The mock task source mirrors the future external-task contract: opening a + // task without a Session restores its latest non-archived collaboration. + // No session means Step 1 may create a new intent thread only after this + // discovery finishes, avoiding an unused thread during restoration. + useEffect(() => { + if (sessionIdFromUrl) { + setSessionDiscoveryDone(true); + return; + } + if (forceNewSession) { + setSessionDiscoveryDone(true); + setSessionLoading(false); + return; + } + let cancelled = false; + setSessionDiscoveryDone(false); + setSessionLoading(true); + void listPositionSessions(task.id) + .then((sessions) => { + if (cancelled) return; + const latest = sessions.find((session) => session.status !== "archived"); + if (!latest) { + setSessionDiscoveryDone(true); + return; + } + const next = new URLSearchParams(searchParamsString); + next.set("taskId", task.id); + next.set("sessionId", latest.id); + setSearchParams(next, { replace: true }); + }) + .catch(() => { + if (!cancelled) setSessionDiscoveryDone(true); + }) + .finally(() => { + if (!cancelled) setSessionLoading(false); + }); + return () => { + cancelled = true; + }; + }, [forceNewSession, searchParamsString, sessionIdFromUrl, setSearchParams, task.id]); + + // 只恢复岗位协同自己的 Session/Node 状态；聊天消息仍由后续节点直接按 threadId + // 读取，因此不会改变原圆桌 Step1 的初始化或存储逻辑。 + useEffect(() => { + if (!sessionIdFromUrl) { + setPositionSession(null); + return; + } + let cancelled = false; + setSessionLoading(true); + void getPositionSession(sessionIdFromUrl) + .then((session) => { + if (!cancelled) setPositionSession(session); + }) + .catch((error) => { + if (!cancelled) { + setPositionSession(null); + toast.error(`岗位协同会话加载失败：${error instanceof Error ? error.message : String(error)}`); + } + }) + .finally(() => { + if (!cancelled) setSessionLoading(false); + }); + return () => { + cancelled = true; + }; + }, [sessionIdFromUrl]); + const { agent: selectedAgent } = useAgent(selectedAgentId); const [intentCompletedAt, setIntentCompletedAt] = useState(""); useEffect(() => { @@ -181,6 +349,98 @@ export default function PositionRoundtablePage() { void intent.sendIntentMessage("请继续追问当前任务中尚未明确的关键条件。", []); }, [intent]); + const handleActivateChain = useCallback(async () => { + if (startingChain) return; + if (!selectedChain) { + toast.warning("请先选择业务链条"); + return; + } + const unassignedSeats = selectedChain.seats.filter((seat) => !seat.position_id?.trim()); + if (unassignedSeats.length > 0) { + toast.warning(`该业务链还有 ${unassignedSeats.length} 个席位未配置岗位，请点击齿轮完成配置`); + return; + } + if (!intent.intentReady) { + toast.warning("请先完成任务意图识别"); + return; + } + setStartingChain(true); + try { + let session = positionSession; + if (!session) { + session = await createPositionSession({ + externalTaskId: task.id || undefined, + taskSnapshot: { ...task }, + }); + } + session = await savePositionIntent(session.id, { + intentThreadId: intent.intentThreadId, + intentSnapshot: intent.intentReady, + }); + session = await activatePositionSession(session.id, selectedChain.id); + setPositionSession(session); + const next = new URLSearchParams(searchParams); + next.set("taskId", task.id); + next.set("sessionId", session.id); + next.delete("new"); + setSearchParams(next, { replace: true }); + toast.success(`已启动业务链：${session.nodes?.length ?? 0} 个岗位节点已生成`); + } catch (error) { + toast.error(`启动业务链失败：${error instanceof Error ? error.message : String(error)}`); + } finally { + setStartingChain(false); + } + }, [intent.intentReady, intent.intentThreadId, positionSession, searchParams, selectedChain, setSearchParams, startingChain, task]); + + const handleMockTaskChange = useCallback( + (value: unknown) => { + const nextTaskId = String(value); + if (nextTaskId === task.id || !MOCK_POSITION_TASKS.some((item) => item.id === nextTaskId)) { + return; + } + intent.resetIntent(); + hydratedIntentSessionRef.current = null; + setPositionSession(null); + setSessionDiscoveryDone(false); + setSelectedAgentId(null); + setActiveNodeKey(null); + setIntentCompletedAt(""); + const next = new URLSearchParams(searchParams); + next.set("taskId", nextTaskId); + next.delete("sessionId"); + setSearchParams(next); + }, + [intent, searchParams, setSearchParams, task.id], + ); + + const handleCreateNewSession = useCallback(() => { + intent.resetIntent(); + hydratedIntentSessionRef.current = null; + setPositionSession(null); + setSessionDiscoveryDone(true); + setSelectedAgentId(null); + setActiveNodeKey(null); + setIntentCompletedAt(""); + const next = new URLSearchParams(searchParams); + next.set("taskId", task.id); + next.delete("sessionId"); + next.set("new", "1"); + setSearchParams(next); + }, [intent, searchParams, setSearchParams, task.id]); + + const handleArchiveSession = useCallback(() => { + if (!positionSession || positionSession.status === "archived") return; + if (!window.confirm("归档后该会话将只读，是否继续？")) return; + void archivePositionSession(positionSession.id) + .then((session) => { + setPositionSession((current) => (current ? { ...current, ...session } : session)); + toast.success("会话已归档，可新建会话继续研讨"); + }) + .catch((error) => { + toast.error(`归档会话失败：${error instanceof Error ? error.message : String(error)}`); + }); + }, [positionSession]); + return (
+ {positionSession && ( + + {positionSession.status === "archived" + ? "会话已归档" + : positionSession.status === "active" + ? "业务链已启动" + : "意图识别中"} + + )}
+
+ 模拟任务 + ({ + label: mockTask.title, + value: mockTask.id, + }))} + onChange={handleMockTaskChange} + /> +
+ } + onClick={handleCreateNewSession} + > + 新建会话 + + {positionSession && positionSession.status !== "archived" && ( + } + onClick={handleArchiveSession} + > + 归档 + + )} 当前岗位 @@ -221,77 +527,98 @@ export default function PositionRoundtablePage() {
-
- {intent.intentInitError && ( -
- - 对话初始化失败：{intent.intentInitError} - - - 重试 - -
- )} - - -
-

- {activePosition.name} · {positionId === "planning" ? "意图识别" : "岗位对话"} -

-

- {activePosition.description} -

+
+ {activePosition.isIntentPosition ? ( + positionSession?.status !== "intent_pending" && frozenIntent ? ( + + ) : ( + <> + {intent.intentInitError && ( +
+ 对话初始化失败：{intent.intentInitError} + + 重试 +
-
- } - interactiveMessages={intent.interactiveMessages} - intentThreadId={intent.intentThreadId} - intentReady={intent.intentReady} - isIntentSending={intent.isIntentSending} - pendingIntentClarificationMsgId={ - intent.pendingIntentClarificationMsgId - } - intentClarificationSelections={ - intent.intentClarificationSelections - } - setIntentClarificationSelections={ - intent.setIntentClarificationSelections - } - onSendMessage={(text, files) => - void intent.sendIntentMessage(text, files) - } - onStopIntent={intent.stopIntentStream} - onSkipQuestion={handleSkipQuestion} - onFollowUp={handleFollowUp} - onEnterRoundtable={() => - toast.success("意图理解已确认，等待岗位链条执行逻辑接入") - } - onManualSave={() => undefined} - onTriggerToast={triggerToast} - submitIntentClarifications={intent.submitIntentClarifications} - /> + )} + + +
+

+ {activePosition.name} · 意图识别 +

+

{activePosition.description}

+
+
+ } + interactiveMessages={intent.interactiveMessages} + intentThreadId={intent.intentThreadId} + intentReady={intent.intentReady} + isIntentSending={intent.isIntentSending} + pendingIntentClarificationMsgId={intent.pendingIntentClarificationMsgId} + intentClarificationSelections={intent.intentClarificationSelections} + setIntentClarificationSelections={intent.setIntentClarificationSelections} + onSendMessage={(text, files) => void intent.sendIntentMessage(text, files)} + onStopIntent={intent.stopIntentStream} + onSkipQuestion={handleSkipQuestion} + onFollowUp={handleFollowUp} + onEnterRoundtable={() => void handleActivateChain()} + enterButtonLabel={startingChain ? "正在启动业务链…" : "确认意图并启动业务链 >"} + onManualSave={() => undefined} + onTriggerToast={triggerToast} + submitIntentClarifications={intent.submitIntentClarifications} + /> + {(startingChain || sessionLoading) && ( +
+ + {startingChain ? "正在保存意图并生成岗位节点…" : "正在恢复岗位协同会话…"} +
+ )} + + ) + ) : positionSession && activeNode ? ( + + ) : ( + 0} + /> + )}
@@ -299,10 +626,21 @@ export default function PositionRoundtablePage() { setSelectedAgentId(null)} - intentObjective={intent.intentReady?.objective} + intentObjective={frozenIntent?.objective ?? intent.intentReady?.objective} intentCompletedAt={intentCompletedAt} + assignedAgentIds={assignedAgentIds} + hasSelectedChain={Boolean(selectedChain)} + onConfigureChain={ + selectedChain ? () => openPositionConfig(selectedChain.id) : undefined + } + nodes={positionSession?.nodes ?? []} + chain={activeChain} + onSelectNode={(node) => { + setActiveNodeKey(node.nodeKey); + setSelectedAgentId(node.agentId); + }} />
@@ -310,8 +648,75 @@ export default function PositionRoundtablePage() { ); } +function PositionNodeEmptyState({ + hasSession, + hasAssignedAgent, +}: { + hasSession: boolean; + hasAssignedAgent: boolean; +}) { + return ( +
+ + + +

+ {hasSession ? "请选择当前岗位的智能体节点" : "等待情报分析岗启动业务链"} +

+

+ {hasSession + ? hasAssignedAgent + ? "从右侧智能体配置列表或左侧流程图选择一个节点后，即可查看或继续问答。" + : "当前岗位没有获配智能体，请由情报分析岗进入业务链配置补充分配。" + : "任务意图确认并启动业务链后，各岗位会按链条阶段依次解锁。"} +

+
+ ); +} + +/** 已启动会话中的意图是冻结快照；避免在情报岗视图意外覆盖它。 */ +function IntentConfirmedState({ intent }: { intent: IntentSummary }) { + return ( +
+
+
+ + + +
+

任务意图已确认

+

+ 此会话已冻结任务意图和业务链；如需变更，请新建岗位协同会话，避免影响已完成节点。 +

+
+
+
+

任务目标

+

+ {desensitize(intent.objective)} +

+
+
+

关键约束

+
+ {intent.constraints.map((constraint, index) => ( +
+ + {desensitize(constraint)} +
+ ))} +
+
+
+
+ ); +} + /** 仅展示岗位会商任务，不在会商页编辑任务。 */ -function TaskInformationCard({ task }: { task: PositionTaskDraft }) { +function TaskInformationCard({ task }: { task: PositionTask }) { return (
@@ -321,6 +726,11 @@ function TaskInformationCard({ task }: { task: PositionTaskDraft }) {

任务信息

+ {task.source === "mock" && ( + + 模拟数据 + + )}
@@ -362,11 +772,13 @@ function BusinessChainSelector({ loading, value, onChange, + onConfigure, }: { chains: BusinessChain[]; loading: boolean; value: string; onChange: (value: string) => void; + onConfigure: (chainId: string) => void; }) { const [expanded, setExpanded] = useState(true); const [relationOpenId, setRelationOpenId] = useState(null); @@ -413,6 +825,7 @@ function BusinessChainSelector({ const selected = chain.id === value; const relationOpen = relationOpenId === chain.id; const stageGroups = chainStages(chain); + const unassignedSeatCount = chain.seats.filter((seat) => !seat.position_id?.trim()).length; let avatarOrder = 0; return (
- + {unassignedSeatCount > 0 && ( + + {unassignedSeatCount} 席待配置 + )} - > - {chain.seats.length} 席 + + {chain.seats.length} 席 +

@@ -471,24 +891,40 @@ function BusinessChainSelector({ {selected && (

- +
+ + +
+ {unassignedSeatCount > 0 && ( +

+ 还有 {unassignedSeatCount} 个智能体席位未归属岗位，请点击右侧齿轮配置后再启动。 +

+ )} {relationOpen && (
{stageGroups.flatMap((stage, stageIndex) => { @@ -561,7 +997,7 @@ function IntentUnderstandingCard({
) : (
- 组织筹划岗完成意图识别后，其他岗位会在这里看到统一的任务意图与约束。 + 情报分析岗完成意图识别后，其他岗位会在这里看到统一的任务意图与约束。
)}
@@ -587,7 +1023,17 @@ const FLOW_NODE_GAP = 10; const FLOW_NODE_CENTER = FLOW_NODE_WIDTH / 2; /** 以业务链配置页的节点卡片语义绘制窄栏版，不显示连线依赖说明。 */ -function BusinessChainFlow({ chain }: { chain: BusinessChain | null }) { +function BusinessChainFlow({ + chain, + nodes, + activeNodeKey, + onSelectNode, +}: { + chain: BusinessChain | null; + nodes: PositionRoundtableNode[]; + activeNodeKey: string | null; + onSelectNode: (node: PositionRoundtableNode) => void; +}) { const stages = chain ? chainStages(chain) : []; const [view, setView] = useState({ tx: 0, ty: 0 }); const [panning, setPanning] = useState(false); @@ -643,7 +1089,7 @@ function BusinessChainFlow({ chain }: { chain: BusinessChain | null }) { {!chain ? (
- 请先由组织筹划岗选择业务链条 + 请先由情报分析岗选择业务链条
) : (
@@ -690,6 +1136,12 @@ function BusinessChainFlow({ chain }: { chain: BusinessChain | null }) {
{stage.seats.map((seat, seatIndex) => { const order = avatarOrder++; + const node = nodes.find( + (item) => + item.stageIndex === stageIndex && + item.seatIndex === seatIndex && + item.agentId === seat.agent_id, + ); return ( onSelectNode(node) : undefined} /> ); })} @@ -751,15 +1206,30 @@ function CompactChainNode({ description, accent, avatarType, + selected = false, + nodeStatus, + onClick, }: { title: string; description: string; accent: string; avatarType: string; + selected?: boolean; + nodeStatus?: PositionRoundtableNode["status"]; + onClick?: () => void; }) { return (
{ + if (onClick) event.stopPropagation(); + }} + className={cn( + "w-[158px] rounded-lg border border-slate-200 bg-white p-2.5 shadow-sm dark:border-[#2b8ffe]/40 dark:bg-[#0a2d58]", + onClick && "cursor-pointer transition hover:-translate-y-0.5 hover:shadow-md", + selected && "ring-2 ring-primary/50 dark:ring-[#2b8ffe]", + nodeStatus === "locked" && "opacity-65", + )} style={{ borderLeftWidth: 5, borderLeftColor: accent }} >
@@ -784,6 +1254,12 @@ function RightWorkspace({ onBackToAgents, intentObjective, intentCompletedAt, + assignedAgentIds, + hasSelectedChain, + onConfigureChain, + nodes, + chain, + onSelectNode, }: { selectedAgent: Agent | null; selectedAgentId: string | null; @@ -791,6 +1267,12 @@ function RightWorkspace({ onBackToAgents: () => void; intentObjective?: string; intentCompletedAt: string; + assignedAgentIds: Set; + hasSelectedChain: boolean; + onConfigureChain?: () => void; + nodes: PositionRoundtableNode[]; + chain: BusinessChain | null; + onSelectNode: (node: PositionRoundtableNode) => void; }) { const [tab, setTab] = useState("agents"); @@ -856,7 +1338,12 @@ function RightWorkspace({
) : ( - + )}
@@ -865,6 +1352,9 @@ function RightWorkspace({ )} @@ -872,8 +1362,18 @@ function RightWorkspace({ ); } -/** 复用 ai 写作页的智能体分组数据和同款分组卡片视觉。 */ -function PositionAgentList({ onSelect }: { onSelect: (agentId: string) => void }) { +/** 复用 ai 写作页的智能体分组数据和同款分组卡片视觉，只展示当前岗位获配的席位。 */ +function PositionAgentList({ + onSelect, + assignedAgentIds, + hasSelectedChain, + onConfigureChain, +}: { + onSelect: (agentId: string) => void; + assignedAgentIds: Set; + hasSelectedChain: boolean; + onConfigureChain?: () => void; +}) { const { theme } = useTheme(); const isDark = theme === "dark"; const { groups, isLoading } = useAgentModuleSidebarData("position-roundtable"); @@ -882,16 +1382,16 @@ function PositionAgentList({ onSelect }: { onSelect: (agentId: string) => void } const visibleGroups = useMemo(() => { const keyword = query.trim().toLowerCase(); - if (!keyword) return groups; return groups .map((group) => ({ ...group, - agents: group.agents.filter((agent) => - `${agent.name} ${agent.description ?? ""}`.toLowerCase().includes(keyword), - ), + agents: group.agents.filter((agent) => { + if (!assignedAgentIds.has(agent.id)) return false; + return !keyword || `${agent.name} ${agent.description ?? ""}`.toLowerCase().includes(keyword); + }), })) .filter((group) => group.agents.length > 0); - }, [groups, query]); + }, [assignedAgentIds, groups, query]); const toggleGroup = (key: string) => { setCollapsed((current) => { @@ -913,7 +1413,7 @@ function PositionAgentList({ onSelect }: { onSelect: (agentId: string) => void }

- {groups.reduce((total, group) => total + group.agents.length, 0)} 个 + {visibleGroups.reduce((total, group) => total + group.agents.length, 0)} 个 void } ) : visibleGroups.length === 0 ? (
- 没有找到匹配的智能体 +

{hasSelectedChain ? "当前岗位暂未分配智能体" : "请先选择业务链条"}

+ {hasSelectedChain && onConfigureChain && ( + + 去配置岗位 + + )}
) : (
@@ -1013,17 +1523,129 @@ function PositionAgentList({ onSelect }: { onSelect: (agentId: string) => void } function AnalysisResults({ intentObjective, intentCompletedAt, + nodes, + chain, + onSelectNode, }: { intentObjective?: string; intentCompletedAt: string; + nodes: PositionRoundtableNode[]; + chain: BusinessChain | null; + onSelectNode: (node: PositionRoundtableNode) => void; }) { - if (!intentObjective) { + type ResultKind = "intent" | "answer" | "artifact"; + interface ResultItem { + id: string; + kind: ResultKind; + node: PositionRoundtableNode | null; + agentName: string; + productName: string; + summary: string; + positionId: string | null; + updatedAt: string | undefined; + } + + const [positionFilter, setPositionFilter] = useState("all"); + const [nodeFilter, setNodeFilter] = useState("all"); + const [kindFilter, setKindFilter] = useState<"all" | ResultKind>("all"); + const seatsByAgentId = useMemo( + () => new Map((chain?.seats ?? []).map((seat) => [seat.agent_id, seat])), + [chain], + ); + const resultItems = useMemo(() => { + const items: ResultItem[] = []; + if (intentObjective) { + items.push({ + id: "intent", + kind: "intent", + node: null, + agentName: "情报分析智能体", + productName: "任务意图理解", + summary: intentObjective, + positionId: DEFAULT_POSITION_ID, + updatedAt: undefined, + }); + } + for (const node of nodes) { + const seat = seatsByAgentId.get(node.agentId); + const agentName = seat?.name ?? node.agentId; + if (node.latestAnswer) { + items.push({ + id: `${node.nodeKey}:answer:${node.revision}`, + kind: "answer", + node, + agentName, + productName: "问答结果", + summary: node.latestAnswer, + positionId: node.positionId, + updatedAt: node.updatedAt, + }); + } + node.artifactManifest.forEach((artifact, index) => { + const path = typeof artifact.path === "string" ? artifact.path : ""; + const name = + typeof artifact.name === "string" && artifact.name.trim() + ? artifact.name + : path.split("/").filter(Boolean).at(-1) || "未命名产物"; + const mimeType = + typeof artifact.mime_type === "string" + ? artifact.mime_type + : typeof artifact.mimeType === "string" + ? artifact.mimeType + : "文件产物"; + items.push({ + id: `${node.nodeKey}:artifact:${path || name}:${index}`, + kind: "artifact", + node, + agentName, + productName: name, + summary: `${mimeType}${node.status === "stale" ? " · 上游已更新，请基于最新结果复核" : ""}`, + positionId: node.positionId, + updatedAt: node.updatedAt, + }); + }); + } + return items.sort((left, right) => (right.updatedAt ?? "").localeCompare(left.updatedAt ?? "")); + }, [intentObjective, nodes, seatsByAgentId]); + const positionOptions = useMemo( + () => [ + { label: "全部岗位", value: "all" }, + ...POSITIONS.filter((position) => resultItems.some((item) => item.positionId === position.id)).map( + (position) => ({ label: position.name, value: position.id }), + ), + ], + [resultItems], + ); + const nodeOptions = useMemo( + () => [ + { label: "全部节点", value: "all" }, + ...nodes + .filter((node) => resultItems.some((item) => item.node?.nodeKey === node.nodeKey)) + .map((node) => ({ + label: desensitize(seatsByAgentId.get(node.agentId)?.name ?? node.agentId), + value: node.nodeKey, + })), + ], + [nodes, resultItems, seatsByAgentId], + ); + const visibleItems = useMemo( + () => + resultItems.filter( + (item) => + (positionFilter === "all" || item.positionId === positionFilter) && + (nodeFilter === "all" || item.node?.nodeKey === nodeFilter) && + (kindFilter === "all" || item.kind === kindFilter), + ), + [kindFilter, nodeFilter, positionFilter, resultItems], + ); + + if (resultItems.length === 0) { return (

暂无分析结果

- 组织筹划岗完成意图识别后，产物会先进入这里；后续岗位产物沿用同一张卡片追加入列。 + 情报分析岗完成意图识别后，产物会先进入这里；后续岗位的问答结果也会沿用同一张卡片追加入列。

); @@ -1037,33 +1659,100 @@ function AnalysisResults({

按生成时间倒序

- 1 个产物 + {visibleItems.length}/{resultItems.length} 项结果 -
-
- - - -
-

任务理解智能体

-

任务意图理解

-

- {desensitize(intentObjective)} -

-
+
+ setPositionFilter(String(value))} /> + setNodeFilter(String(value))} /> + setKindFilter(String(value) as "all" | ResultKind)} + /> +
+ {visibleItems.length === 0 ? ( +
+ 当前筛选条件下没有结果
-
- - - 组织筹划岗 - - - - {intentCompletedAt || "刚刚"} - -
-
+ ) : ( + visibleItems.map((item) => { + const displayedTime = item.updatedAt + ? new Intl.DateTimeFormat("zh-CN", { + month: "2-digit", + day: "2-digit", + hour: "2-digit", + minute: "2-digit", + hour12: false, + }).format(new Date(item.updatedAt)) + : intentCompletedAt || "刚刚"; + const stale = item.node?.status === "stale"; + const contents = ( + <> +
+ + {item.kind === "artifact" ? : } + +
+
+

{desensitize(item.agentName)}

+ {stale && ( + + 上游已更新 + + )} +
+

+ {desensitize(item.productName)} +

+

+ {desensitize(item.summary)} +

+
+
+
+ + + {positionNameById(item.positionId)} + + + + {displayedTime} + +
+ + ); + return item.node ? ( + + ) : ( +
+ {contents} +
+ ); + }) + )} ); } diff --git a/frontend-web/src/roundtable-planning/components/Step1Panel.tsx b/frontend-web/src/roundtable-planning/components/Step1Panel.tsx index 5278bf33..b50461ac 100644 --- a/frontend-web/src/roundtable-planning/components/Step1Panel.tsx +++ b/frontend-web/src/roundtable-planning/components/Step1Panel.tsx @@ -87,6 +87,8 @@ export interface Step1PanelProps { onSkipQuestion: () => void; onFollowUp: () => void; onEnterRoundtable: () => void; + /** 保持旧文案默认不变；嵌入式新工作流可覆写确认动作名称。 */ + enterButtonLabel?: string; onManualSave: () => void; onTriggerToast: (msg: string) => void; submitIntentClarifications: ( @@ -111,6 +113,7 @@ export function Step1Panel(props: Step1PanelProps) { onSkipQuestion, onFollowUp, onEnterRoundtable, + enterButtonLabel = "进入多智能体研讨 >", onManualSave, onTriggerToast, submitIntentClarifications, @@ -334,7 +337,7 @@ export function Step1Panel(props: Step1PanelProps) { }`} > - 进入多智能体研讨 > + {enterButtonLabel} diff --git a/frontend-web/src/roundtable-planning/hooks/useStep1Intent.ts b/frontend-web/src/roundtable-planning/hooks/useStep1Intent.ts index ec9c3683..caf27082 100644 --- a/frontend-web/src/roundtable-planning/hooks/useStep1Intent.ts +++ b/frontend-web/src/roundtable-planning/hooks/useStep1Intent.ts @@ -113,6 +113,8 @@ export interface UseStep1IntentReturn { // ─── Handlers ──────────────────────────────────────────────────────── /** 清空当前 Step 1 状态并重新拉取 intent thread。 */ runStep1Init: () => void; + /** 清空当前状态但不创建线程，供宿主切换任务后重新进入 Step 1。 */ + resetIntent: () => void; /** * 把 `userText` 作为用户气泡发给 intent agent,流式渲染回复。 * `files`:可选的本地文件,发送前先上传到 intent thread,再把引用随消息提交(后端 @@ -256,6 +258,20 @@ export function useStep1Intent(options: UseStep1IntentOptions): UseStep1IntentRe })(); }, []); + const resetIntent = useCallback(() => { + stopIntentStream(); + step1InitRef.current = false; + step1InitGenRef.current += 1; + setIntentThreadId(null); + setIntentReady(null); + setIntentInitError(null); + setIntentInitErrorDetail(null); + setPendingIntentClarificationMsgId(null); + setIntentClarificationSelections(new Map()); + setInteractiveMessages([]); + setTimelineEntries([]); + }, [stopIntentStream]); + // 离开 Step 1 自动中断流;`currentStep === 1` 但还没初始化 → runStep1Init。 useEffect(() => { if (currentStep !== 1) { @@ -648,6 +664,7 @@ export function useStep1Intent(options: UseStep1IntentOptions): UseStep1IntentRe timelineEntries, setIntentClarificationSelections, runStep1Init, + resetIntent, sendIntentMessage, submitIntentClarifications, updateIntentReady, diff --git a/frontend-web/src/roundtable-planning/lib/business-chain.ts b/frontend-web/src/roundtable-planning/lib/business-chain.ts index bfec7ac6..f6861ddf 100644 --- a/frontend-web/src/roundtable-planning/lib/business-chain.ts +++ b/frontend-web/src/roundtable-planning/lib/business-chain.ts @@ -45,6 +45,11 @@ export interface ChainSeat { * 数组在 `api/chains.ts` 不做 camel↔snake 转换，键名须与后端 schema 逐字匹配）。 */ seat_mode?: SeatMode | null; + /** + * 岗位协同专用的席位归属。普通圆桌会商不读取该字段；它跟随 `seats` JSON 保存， + * 使同一条业务链既能继续用于原会商，也能在岗位协同中按岗位筛选可问答的智能体。 + */ + position_id?: string | null; } /** 一条可复用的业务链条（与后端 `/api/roundtable-chains` 记录对应）。 */ diff --git a/frontend-web/src/roundtable-planning/pages/BusinessChainEditorPage.tsx b/frontend-web/src/roundtable-planning/pages/BusinessChainEditorPage.tsx index c577f9f8..2d4c3bc3 100644 --- a/frontend-web/src/roundtable-planning/pages/BusinessChainEditorPage.tsx +++ b/frontend-web/src/roundtable-planning/pages/BusinessChainEditorPage.tsx @@ -77,8 +77,13 @@ import { Switch } from "@/components/ui/switch"; import { useDesensitizeSubtree } from "@/roundtable-planning/lib/use-desensitize-subtree"; import { TagSearchBar } from "@/components/workspace/tags/tag-search-bar"; import { ModelNameSelect } from "@/components/workspace/model-name-select"; +import { Select as TSelect } from "tdesign-react"; import { listAgents } from "@/core/agents"; import { getStoredAuth } from "@/core/auth"; +import { + POSITION_OPTIONS, + type PositionId, +} from "@/position-roundtable/lib/positions"; import { filterRecommendCandidates, @@ -152,6 +157,14 @@ type ActiveDrag = export default function BusinessChainEditorPage() { const navigate = useNavigate(); const [searchParams] = useSearchParams(); + // 岗位配置只由岗位协同页入口开启，普通圆桌编辑器完全不显示也不依赖该控件。 + // `returnTo` 只接受站内绝对路径，避免把导航带往外部地址。 + const positionConfigMode = searchParams.get("mode") === "position"; + const requestedReturnTo = searchParams.get("returnTo"); + const returnPath = + positionConfigMode && requestedReturnTo?.startsWith("/") + ? requestedReturnTo + : "/page/workspace/roundtable/planning"; // 整片脱敏：链条配置页展示文本（链条名/描述/席位名/标题）。可编辑的 input/textarea 不脱敏（Hook 跳过），保证编辑用原文。 const dzRef = useDesensitizeSubtree(); @@ -415,6 +428,18 @@ export default function BusinessChainEditorPage() { setStageGroups((prev) => setSeatModeOnGroups(prev, agentId, mode)); }, []); + // 岗位协同专用席位归属。保留在同一个 ChainSeat JSON 内，普通会商不会读取它。 + const setSeatPositionCb = useCallback((agentId: string, positionId: PositionId | null) => { + setStageGroups((prev) => + prev.map((group) => ({ + ...group, + seats: group.seats.map((seat) => + seat.agent_id === agentId ? { ...seat, position_id: positionId } : seat, + ), + })), + ); + }, []); + // ── 提示词 AI 优化（总控提示词 / 各 Stage 阶段目标）──────────────────────── const [optimizingCoordinator, setOptimizingCoordinator] = useState(false); const [goalOptimizingIdx, setGoalOptimizingIdx] = useState(null); @@ -617,6 +642,8 @@ export default function BusinessChainEditorPage() { seat_skill_directive: s.seat_skill_directive ?? false, // 席位「推理深度覆盖」：随席位一起落库（null = 跟随链条级 seatMode）。 seat_mode: s.seat_mode ?? null, + // 岗位协同专用岗位归属：普通圆桌忽略，但保存时必须原样保留。 + position_id: s.position_id ?? null, }; }); // 总控编排提示：trim 后空串落 null（清空），与后端「空=不注入」一致。 @@ -893,14 +920,14 @@ export default function BusinessChainEditorPage() {
{/* 品牌标识 */} @@ -921,6 +948,17 @@ export default function BusinessChainEditorPage() { + {positionConfigMode && ( + + 岗位协同配置 + + )} + {/* 链条选择下拉 */}
@@ -1503,6 +1553,8 @@ function StagesColumn({ onSeatModelChange={onSeatModelChange} onSeatSkillDirectiveChange={onSeatSkillDirectiveChange} onSeatModeChange={onSeatModeChange} + positionConfigMode={positionConfigMode} + onSeatPositionChange={onSeatPositionChange} onGoalChange={(goal) => onStageGoalChange(stageIdx, goal)} goalOptimizing={goalOptimizingIdx === stageIdx} anyGoalOptimizing={goalOptimizingIdx !== null} @@ -1534,6 +1586,8 @@ function StageSection({ onSeatModelChange, onSeatSkillDirectiveChange, onSeatModeChange, + positionConfigMode, + onSeatPositionChange, onGoalChange, goalOptimizing, anyGoalOptimizing, @@ -1554,6 +1608,8 @@ function StageSection({ onSeatModelChange: (agentId: string, model: string | null) => void; onSeatSkillDirectiveChange: (agentId: string, enabled: boolean) => void; onSeatModeChange: (agentId: string, mode: SeatMode | null) => void; + positionConfigMode: boolean; + onSeatPositionChange: (agentId: string, positionId: PositionId | null) => void; onGoalChange: (goal: string) => void; /** 本 Stage 的阶段目标正在 AI 优化中。 */ goalOptimizing: boolean; @@ -1717,6 +1773,8 @@ function StageSection({ onModelChange={(model) => onSeatModelChange(seat.agent_id, model)} onSkillDirectiveChange={(enabled) => onSeatSkillDirectiveChange(seat.agent_id, enabled)} onSeatModeChange={(mode) => onSeatModeChange(seat.agent_id, mode)} + showPositionConfig={positionConfigMode} + onPositionChange={(positionId) => onSeatPositionChange(seat.agent_id, positionId)} onDetail={() => onSeatDetail(seat.agent_id, seat.name)} /> ))} @@ -1742,6 +1800,8 @@ function SeatStrip({ onModelChange, onSkillDirectiveChange, onSeatModeChange, + showPositionConfig, + onPositionChange, onDetail, }: { seat: ChainSeat; @@ -1760,6 +1820,9 @@ function SeatStrip({ onSkillDirectiveChange: (enabled: boolean) => void; /** 席位「推理深度覆盖」变更（null = 跟随链条级 seatMode）。 */ onSeatModeChange: (mode: SeatMode | null) => void; + /** 仅岗位协同入口展示的岗位配置。 */ + showPositionConfig: boolean; + onPositionChange: (positionId: PositionId | null) => void; onDetail: () => void; }) { const { attributes, listeners, setNodeRef, transform, transition, isDragging } = @@ -1810,6 +1873,29 @@ function SeatStrip({ )}
+ {/* 岗位协同从专用入口进来时才展示。使用 TDesign Select，未分配不会阻塞普通圆桌使用。 */} + {showPositionConfig && ( +
+ 岗位 + ({ + label: position.name, + value: position.id, + })), + ]} + onChange={(value) => + onPositionChange(value ? (String(value) as PositionId) : null) + } + className="w-[132px]" + popupProps={{ overlayClassName: "z-[80]" }} + /> +
+ )} + {/* 席位模型覆盖（右侧操作区）：空 = 跟随全局所选模型；选了则该席位作为子智能体 执行时用此模型。技能重的席位配强模型、边角席位配快模型，配合技能白名单实现 「强弱搭配」。放到右侧操作区，与名称/描述解耦，卡片更整洁。 */} diff --git a/offline-backend-20260512/backend/CLAUDE.md b/offline-backend-20260512/backend/CLAUDE.md index 70f6087a..87ffaaf0 100644 --- a/offline-backend-20260512/backend/CLAUDE.md +++ b/offline-backend-20260512/backend/CLAUDE.md @@ -375,6 +375,26 @@ Each agent/skill carries a single `square_id` column (`AgentRow` / `SkillRow`, ` Backs the zzJC / zzXD agent-chat left sidebar (「按类型聚合智能体 + 聊天记录」). An admin picks which agent **tags** belong to a module; the module's left sidebar then shows only agents under those tags (empty/unconfigured = show all visible agents). Stored in `system_settings.json` → `agent_modules` (`AgentModuleSettings`: `modules: {module_key → [tag_id, ...]}`); pure helpers `get_module_tag_ids` / `set_module_tag_ids` (de-dupe + strip). Endpoints (in `app/gateway/routers/system_settings.py`): `GET /api/system-settings/agent-modules/{key}` (readable by any user — the sidebar needs it to filter), `PUT /api/system-settings/agent-modules/{key}` (admin only, full replacement of the tag-id list). Module keys are frontend-defined (`AGENT_MODULES` in `components/workspace/agents/agent-module-sidebar.tsx`, keyed by the module's landing agent id: `6bf`→`zzjc`, `10d69…`→`zzxd`). Tests: `tests/test_agent_modules.py`. Frontend: `core/system-settings` (`useAgentModuleConfig`/`useUpdateAgentModuleConfig`), admin `AgentModuleSettingsDialog` (gear button in the agent-chat header). +### Position-collaboration foundation + +The position-collaboration workspace is a separate frontend route and must not +use the original roundtable coordinator or jobs. Its shared configuration +integration point is the existing `/api/roundtable-chains` store: each `seats` JSON item +may carry an optional `position_id` (validated by `ChainSeatSchema`, no schema +migration). The original roundtable only reads its established seat fields and +therefore remains unchanged. The separate `/api/position-roundtable` router +persists task/intent/frozen-chain snapshots in `position_roundtable_sessions` +and direct-agent node indexes in `position_roundtable_nodes` (migration +`20260721_01`). Message history remains in the established LangGraph thread +store; a node completion unlocks its next chain stage and a later upstream +revision marks downstream records `stale` for refresh. +For direct-agent handoff, the router resolves artifact paths only inside the +completed upstream node's own thread, then includes bounded UTF-8 excerpts for +text outputs; binary artifacts stay as metadata-only references. +`POST /sessions/{id}/archive` turns a session into a read-only historical +record: task/intent updates, node binding, hidden-context construction, and +turn completion are rejected, while read endpoints remain available. + ### 岗位 (Position) Subscription System An admin-managed aggregation layer that decides, per user, which agents / skills diff --git a/offline-backend-20260512/backend/README.md b/offline-backend-20260512/backend/README.md index 4091ccf4..c06233a1 100644 --- a/offline-backend-20260512/backend/README.md +++ b/offline-backend-20260512/backend/README.md @@ -122,6 +122,8 @@ FastAPI application providing REST endpoints for frontend integration: | `POST /api/skills/install` | Install skill from `.skill` archive | | `GET/POST /api/agents` | List visible agents or create a user-owned agent | | `GET/PUT/DELETE /api/agents/{id}` | Read, update, or delete an id-addressed agent | +| `GET/POST/PUT/DELETE /api/roundtable-chains` | Manage user-owned roundtable business chains; each seat may optionally carry `position_id` for the separate position-collaboration workspace (the original roundtable ignores it) | +| `GET/POST/PUT /api/position-roundtable/sessions` | Standalone position-collaboration sessions: freeze task/intent/chain snapshots, index one direct-agent node per seat, build upstream handoff context (including bounded UTF-8 excerpts of text artifacts), and make archived sessions read-only without invoking the original roundtable coordinator or jobs | | `GET /api/memory` | Retrieve memory data | | `POST /api/memory/reload` | Force memory reload | | `GET /api/memory/config` | Memory configuration | diff --git a/offline-backend-20260512/backend/app/gateway/app.py b/offline-backend-20260512/backend/app/gateway/app.py index fe20b1ce..2a1b6fde 100644 --- a/offline-backend-20260512/backend/app/gateway/app.py +++ b/offline-backend-20260512/backend/app/gateway/app.py @@ -53,9 +53,10 @@ from app.gateway.routers import ( notifications, open_3qfx, open_chat, - parallel_agent_tasks, - parallel_agents, - positions, + parallel_agent_tasks, + parallel_agents, + position_roundtable, + positions, public_config, public_embed, public_leaderboard, @@ -1443,8 +1444,11 @@ This gateway provides custom endpoints for models, MCP configuration, skills, an # Step3 流程图结构化抽取 + 校验 (SSE) at /api/flow-extract app.include_router(flow_extract.router) - # Roundtable-planning business chains at /api/roundtable-chains - app.include_router(roundtable_chains.router) + # Roundtable-planning business chains at /api/roundtable-chains + app.include_router(roundtable_chains.router) + + # 岗位协同独立会话 / 节点状态（不使用原圆桌总控或后台作业） + app.include_router(position_roundtable.router) # Global business ? agent / chain mapping at /api/business-mapping app.include_router(business_mapping.router) diff --git a/offline-backend-20260512/backend/app/gateway/deps.py b/offline-backend-20260512/backend/app/gateway/deps.py index 49db1366..69c1cb17 100644 --- a/offline-backend-20260512/backend/app/gateway/deps.py +++ b/offline-backend-20260512/backend/app/gateway/deps.py @@ -255,9 +255,15 @@ async def langgraph_runtime(app: FastAPI) -> AsyncGenerator[None, None]: app.state.roundtable_draft_share_store = make_roundtable_draft_share_store(sf) - from deerflow.persistence.roundtable_chains import make_roundtable_chain_store - - app.state.roundtable_chain_store = make_roundtable_chain_store(sf) + from deerflow.persistence.roundtable_chains import make_roundtable_chain_store + + app.state.roundtable_chain_store = make_roundtable_chain_store(sf) + + # 独立的岗位协同 Session / Node 存储。它只索引业务流程状态，真实消息和 + # 文件仍复用 LangGraph thread/checkpoint 与现有 artifact API。 + from deerflow.persistence.position_roundtable import make_position_roundtable_store + + app.state.position_roundtable_store = make_position_roundtable_store(sf) from deerflow.persistence.business_mapping import make_business_mapping_store diff --git a/offline-backend-20260512/backend/app/gateway/routers/position_roundtable.py b/offline-backend-20260512/backend/app/gateway/routers/position_roundtable.py new file mode 100644 index 00000000..c05afb34 --- /dev/null +++ b/offline-backend-20260512/backend/app/gateway/routers/position_roundtable.py @@ -0,0 +1,563 @@ +"""API for the standalone position-collaboration workspace. + +Unlike the existing multi-agent roundtable, this feature has no coordinator and +no background roundtable job. The API only persists the task/intent/chain +snapshot and indexes one direct-agent node per business-chain seat. Actual chat +messages and artifacts stay in the established LangGraph thread stores. +""" + +from __future__ import annotations + +import asyncio +from pathlib import Path +from typing import Any + +from fastapi import APIRouter, HTTPException, Request +from pydantic import BaseModel, Field + +from app.gateway.path_utils import aresolve_thread_virtual_path +from deerflow.runtime.user_context import get_effective_user_id + +router = APIRouter(prefix="/api/position-roundtable", tags=["position-roundtable"]) + +NODE_STATUSES = {"locked", "ready", "running", "done", "stale", "error"} +_HANDOFF_TEXT_BUDGET = 12_000 +_MAX_INLINE_ARTIFACTS_PER_NODE = 4 +_MAX_INLINE_ARTIFACT_CHARS = 1_800 +_TEXT_ARTIFACT_SUFFIXES = { + ".csv", + ".json", + ".log", + ".md", + ".markdown", + ".rst", + ".txt", + ".xml", + ".yaml", + ".yml", +} + + +class NodeResponse(BaseModel): + id: str + session_id: str + node_key: str + stage_index: int + seat_index: int + agent_id: str + position_id: str | None = None + thread_id: str | None = None + status: str + latest_answer: str | None = None + artifact_manifest: list[dict[str, Any]] = Field(default_factory=list) + revision: int = 0 + upstream_revision: dict[str, Any] | None = None + created_at: str | None = None + updated_at: str | None = None + + +class SessionResponse(BaseModel): + id: str + external_task_id: str | None = None + task_snapshot: dict[str, Any] = Field(default_factory=dict) + chain_id: str | None = None + chain_snapshot: dict[str, Any] | None = None + intent_thread_id: str | None = None + intent_snapshot: dict[str, Any] | None = None + status: str + created_at: str | None = None + updated_at: str | None = None + + +class SessionDetailResponse(SessionResponse): + nodes: list[NodeResponse] = Field(default_factory=list) + + +class SessionCreateRequest(BaseModel): + external_task_id: str | None = Field(default=None, max_length=128) + task_snapshot: dict[str, Any] = Field(default_factory=dict) + + +class TaskSnapshotUpdateRequest(BaseModel): + task_snapshot: dict[str, Any] = Field(default_factory=dict) + + +class IntentUpdateRequest(BaseModel): + intent_thread_id: str | None = Field(default=None, max_length=128) + intent_snapshot: dict[str, Any] | None = None + + +class ActivateRequest(BaseModel): + chain_id: str = Field(min_length=1, max_length=64) + + +class NodeThreadRequest(BaseModel): + thread_id: str = Field(min_length=1, max_length=128) + + +class CompleteTurnRequest(BaseModel): + latest_answer: str = Field(default="", max_length=500_000) + artifact_manifest: list[dict[str, Any]] = Field(default_factory=list) + upstream_revision: dict[str, Any] | None = None + + +def _current_user_id(request: Request) -> str: + user = getattr(request.state, "user", None) + return str(user.id) if user is not None else get_effective_user_id() + + +def _get_store(request: Request): + store = getattr(request.app.state, "position_roundtable_store", None) + if store is None: + raise HTTPException(status_code=503, detail="Position roundtable store not available") + return store + + +def _get_chain_store(request: Request): + store = getattr(request.app.state, "roundtable_chain_store", None) + if store is None: + raise HTTPException(status_code=503, detail="Business chain store not available") + return store + + +async def _require_writable_session( + request: Request, session_id: str +) -> tuple[Any, str, dict[str, Any]]: + """Load a Session that can still accept task, intent, or node updates.""" + store = _get_store(request) + user_id = _current_user_id(request) + session = await store.get_session(session_id, user_id) + if session is None: + raise HTTPException(status_code=404, detail="Position roundtable session not found") + if session.get("status") == "archived": + raise HTTPException(status_code=409, detail="该岗位协同会话已归档，仅可查看历史记录") + return store, user_id, session + + +def _project_session(row: dict[str, Any]) -> SessionResponse: + return SessionResponse(**row) + + +def _project_node(row: dict[str, Any]) -> NodeResponse: + return NodeResponse(**row) + + +async def _load_detail(request: Request, session_id: str) -> SessionDetailResponse: + store = _get_store(request) + user_id = _current_user_id(request) + row = await store.get_session(session_id, user_id) + if row is None: + raise HTTPException(status_code=404, detail="Position roundtable session not found") + nodes = await store.list_nodes(session_id, user_id) + return SessionDetailResponse(**row, nodes=[_project_node(node) for node in nodes or []]) + + +def _chain_nodes(chain: dict[str, Any]) -> list[dict[str, Any]]: + seats = chain.get("seats") if isinstance(chain.get("seats"), list) else [] + if not seats: + raise HTTPException(status_code=400, detail="业务链条没有可执行的智能体席位") + seat_by_agent_id = {str(seat.get("agent_id")): seat for seat in seats if seat.get("agent_id")} + if len(seat_by_agent_id) != len(seats): + raise HTTPException(status_code=400, detail="业务链条包含无效或重复的智能体席位") + + raw_stages = chain.get("stages") + stages: list[list[str]] + if isinstance(raw_stages, list) and raw_stages: + stages = [[str(agent_id) for agent_id in stage] for stage in raw_stages if isinstance(stage, list)] + else: + stages = [[str(seat["agent_id"])] for seat in seats] + if not stages or any(not stage for stage in stages): + raise HTTPException(status_code=400, detail="业务链条阶段配置无效") + + result: list[dict[str, Any]] = [] + for stage_index, stage in enumerate(stages): + for seat_index, agent_id in enumerate(stage): + seat = seat_by_agent_id.get(agent_id) + if seat is None: + raise HTTPException(status_code=400, detail=f"业务链条阶段包含不存在的席位: {agent_id}") + position_id = seat.get("position_id") + if not isinstance(position_id, str) or not position_id.strip(): + raise HTTPException( + status_code=400, + detail=f"智能体「{seat.get('name') or agent_id}」尚未配置岗位，请先从岗位协同入口配置", + ) + result.append( + { + "node_key": f"stage-{stage_index + 1}-seat-{seat_index + 1}-{agent_id}", + "stage_index": stage_index, + "seat_index": seat_index, + "agent_id": agent_id, + "position_id": position_id.strip(), + "status": "ready" if stage_index == 0 else "locked", + } + ) + return result + + +def _truncate_text(value: Any, limit: int) -> str: + if limit <= 0: + return "" + text = value if isinstance(value, str) else str(value or "") + if len(text) <= limit: + return text + return f"{text[:limit]}\n…（已按交接上下文长度截断）" + + +def _artifact_refs(artifacts: Any) -> list[dict[str, Any]]: + if not isinstance(artifacts, list): + return [] + refs: list[dict[str, Any]] = [] + for artifact in artifacts[:20]: + if not isinstance(artifact, dict): + continue + refs.append( + { + "name": artifact.get("name") or artifact.get("filename") or "未命名产物", + "path": artifact.get("path") or artifact.get("artifact_url") or "", + "mime_type": artifact.get("mimeType") or artifact.get("mime_type") or None, + } + ) + return refs + + +def _is_inline_text_artifact(artifact: dict[str, Any]) -> bool: + """Return whether a listed output is safe and useful to pass as text.""" + mime_type = artifact.get("mime_type") + if isinstance(mime_type, str) and mime_type.lower().startswith("text/"): + return True + path = artifact.get("path") + return isinstance(path, str) and Path(path).suffix.lower() in _TEXT_ARTIFACT_SUFFIXES + + +def _read_text_excerpt(path: Path, max_chars: int) -> tuple[str, bool] | None: + """Read one bounded UTF-8 text artifact without loading the whole file.""" + if max_chars <= 0: + return None + # Four bytes per UTF-8 code point is enough to obtain the requested + # character-sized excerpt without a potentially unbounded file read. + with path.open("rb") as file: + raw = file.read(max_chars * 4 + 1) + if b"\x00" in raw: + return None + try: + text = raw.decode("utf-8") + except UnicodeDecodeError as error: + if len(raw) == max_chars * 4 + 1 and error.start >= len(raw) - 4: + text = raw[: error.start].decode("utf-8") + else: + # Generated artifacts are expected to be UTF-8. Keep a non-UTF-8 + # output as a reference only instead of corrupting agent context. + return None + truncated = len(raw) > max_chars * 4 or len(text) > max_chars + return _truncate_text(text, max_chars), truncated + + +async def _artifact_refs_with_content( + thread_id: str | None, artifacts: Any, text_budget: int +) -> tuple[list[dict[str, Any]], int]: + """Attach bounded excerpts of text outputs, retaining binary files as refs. + + Paths are always resolved against the upstream node's own thread. This is + deliberate: an artifact manifest is client-supplied metadata, so it must + never be allowed to select another thread's user-data directory. + """ + refs = _artifact_refs(artifacts) + if not thread_id or text_budget <= 0: + return refs, 0 + + consumed = 0 + inline_count = 0 + for ref in refs: + if inline_count >= _MAX_INLINE_ARTIFACTS_PER_NODE: + break + if not _is_inline_text_artifact(ref): + continue + virtual_path = ref.get("path") + if not isinstance(virtual_path, str): + continue + normalized_path = virtual_path.replace("\\", "/").lstrip("/") + if not normalized_path.startswith("mnt/user-data/outputs/"): + continue + available = text_budget - consumed + if available <= 0: + break + excerpt_limit = min(_MAX_INLINE_ARTIFACT_CHARS, available) + try: + actual_path = await aresolve_thread_virtual_path(thread_id, normalized_path) + if not await asyncio.to_thread(actual_path.is_file): + continue + excerpt = await asyncio.to_thread(_read_text_excerpt, actual_path, excerpt_limit) + except (HTTPException, OSError): + # The file may have been removed after the manifest was stored. + # Keep its metadata so the UI still shows the original output. + continue + if excerpt is None: + continue + content, truncated = excerpt + ref["content"] = content + ref["content_truncated"] = truncated + consumed += len(content) + inline_count += 1 + return refs, consumed + + +async def _handoff_context(request: Request, session_id: str, node_key: str) -> dict[str, Any]: + """Construct bounded, deterministic hidden context for one direct-agent turn.""" + store = _get_store(request) + user_id = _current_user_id(request) + session = await store.get_session(session_id, user_id) + nodes = await store.list_nodes(session_id, user_id) + if session is None or nodes is None: + raise HTTPException(status_code=404, detail="Position roundtable session not found") + if session.get("status") == "archived": + raise HTTPException(status_code=409, detail="该岗位协同会话已归档，仅可查看历史记录") + current = next((node for node in nodes if node["node_key"] == node_key), None) + if current is None: + raise HTTPException(status_code=404, detail="Position roundtable node not found") + if current["status"] == "locked": + raise HTTPException(status_code=409, detail="上游节点尚未完成，当前节点未解锁") + + # Same-stage nodes are intentionally excluded. The business chain only + # hands off completed previous stages, in stage/seat order. + remaining = _HANDOFF_TEXT_BUDGET + upstream_candidates = [ + node + for node in nodes + if node["stage_index"] < current["stage_index"] + and node["status"] in {"done", "stale"} + ] + upstream_nodes: list[dict[str, Any]] = [] + for index, node in enumerate(upstream_candidates): + candidates_left = len(upstream_candidates) - index + per_node_limit = min(2_800, max(0, (remaining // candidates_left) * 2 // 3)) + answer = _truncate_text(node.get("latest_answer"), per_node_limit) + remaining -= len(answer) + artifact_budget = min( + _MAX_INLINE_ARTIFACT_CHARS, + max(0, remaining // candidates_left), + ) + artifacts, consumed = await _artifact_refs_with_content( + node.get("thread_id"), node.get("artifact_manifest"), artifact_budget + ) + remaining -= consumed + upstream_nodes.append( + { + "node_key": node["node_key"], + "agent_id": node["agent_id"], + "position_id": node.get("position_id"), + "revision": node.get("revision", 0), + "latest_answer": answer, + "artifacts": artifacts, + } + ) + if remaining <= 0: + break + return { + "kind": "position_roundtable_handoff", + "task": session.get("task_snapshot") or {}, + "intent": session.get("intent_snapshot") or {}, + "current_node": { + "node_key": current["node_key"], + "agent_id": current["agent_id"], + "position_id": current.get("position_id"), + "stage_index": current["stage_index"], + "seat_index": current["seat_index"], + }, + "upstream_nodes": upstream_nodes, + "upstream_revision": { + node["node_key"]: node.get("revision", 0) for node in upstream_nodes + }, + } + + +@router.get("/sessions", response_model=list[SessionResponse]) +async def list_sessions(request: Request, external_task_id: str | None = None) -> list[SessionResponse]: + rows = await _get_store(request).list_sessions( + _current_user_id(request), external_task_id=external_task_id + ) + return [_project_session(row) for row in rows] + + +@router.post("/sessions", response_model=SessionResponse, status_code=201) +async def create_session(request: Request, body: SessionCreateRequest) -> SessionResponse: + row = await _get_store(request).create_session( + _current_user_id(request), + external_task_id=body.external_task_id, + task_snapshot=body.task_snapshot, + ) + return _project_session(row) + + +@router.get("/sessions/{session_id}", response_model=SessionDetailResponse) +async def get_session(request: Request, session_id: str) -> SessionDetailResponse: + return await _load_detail(request, session_id) + + +@router.put("/sessions/{session_id}/task", response_model=SessionResponse) +async def update_task_snapshot( + request: Request, session_id: str, body: TaskSnapshotUpdateRequest +) -> SessionResponse: + store, user_id, _ = await _require_writable_session(request, session_id) + row = await store.update_session(session_id, user_id, task_snapshot=body.task_snapshot) + if row is None: + raise HTTPException(status_code=404, detail="Position roundtable session not found") + return _project_session(row) + + +@router.put("/sessions/{session_id}/intent", response_model=SessionResponse) +async def update_intent_snapshot( + request: Request, session_id: str, body: IntentUpdateRequest +) -> SessionResponse: + store, user_id, _ = await _require_writable_session(request, session_id) + row = await store.update_session( + session_id, + user_id, + intent_thread_id=body.intent_thread_id, + intent_snapshot=body.intent_snapshot, + ) + if row is None: + raise HTTPException(status_code=404, detail="Position roundtable session not found") + return _project_session(row) + + +@router.post("/sessions/{session_id}/activate", response_model=SessionDetailResponse) +async def activate_session( + request: Request, session_id: str, body: ActivateRequest +) -> SessionDetailResponse: + store, user_id, current = await _require_writable_session(request, session_id) + if not current.get("intent_snapshot"): + raise HTTPException(status_code=400, detail="请先完成并保存任务意图") + + chain = await _get_chain_store(request).get_chain( + body.chain_id, + user_id, + is_admin=getattr(getattr(request.state, "user", None), "system_role", None) == "admin", + ) + if chain is None: + raise HTTPException(status_code=404, detail="业务链条不存在或无权访问") + nodes = _chain_nodes(chain) + activated = await store.activate_session( + session_id, + user_id, + chain_id=body.chain_id, + chain_snapshot=chain, + nodes=nodes, + ) + if activated is None: + raise HTTPException(status_code=404, detail="Position roundtable session not found") + row, node_rows = activated + return SessionDetailResponse(**row, nodes=[_project_node(node) for node in node_rows]) + + +@router.post("/sessions/{session_id}/archive", response_model=SessionResponse) +async def archive_session(request: Request, session_id: str) -> SessionResponse: + row = await _get_store(request).archive_session(session_id, _current_user_id(request)) + if row is None: + raise HTTPException(status_code=404, detail="Position roundtable session not found") + return _project_session(row) + + +@router.get("/sessions/{session_id}/nodes/{node_key}", response_model=NodeResponse) +async def get_node(request: Request, session_id: str, node_key: str) -> NodeResponse: + row = await _get_store(request).get_node(session_id, node_key, _current_user_id(request)) + if row is None: + raise HTTPException(status_code=404, detail="Position roundtable node not found") + return _project_node(row) + + +@router.post("/sessions/{session_id}/nodes/{node_key}/thread", response_model=NodeResponse) +async def bind_node_thread( + request: Request, session_id: str, node_key: str, body: NodeThreadRequest +) -> NodeResponse: + store, user_id, _ = await _require_writable_session(request, session_id) + current = await store.get_node(session_id, node_key, user_id) + if current is None: + raise HTTPException(status_code=404, detail="Position roundtable node not found") + if current["status"] == "locked": + raise HTTPException(status_code=409, detail="上游节点尚未完成，当前节点未解锁") + if current.get("thread_id") and current["thread_id"] != body.thread_id: + raise HTTPException(status_code=409, detail="该节点已绑定另一条对话线程") + row = await store.update_node( + session_id, + node_key, + user_id, + thread_id=body.thread_id, + status="running" if current.get("status") == "ready" else current.get("status", "locked"), + ) + return _project_node(row) + + +@router.post("/sessions/{session_id}/nodes/{node_key}/context") +async def build_node_context(request: Request, session_id: str, node_key: str) -> dict[str, Any]: + """Return the bounded hidden task/intent/upstream context for a node turn.""" + return await _handoff_context(request, session_id, node_key) + + +@router.post("/sessions/{session_id}/nodes/{node_key}/complete-turn", response_model=NodeResponse) +async def complete_node_turn( + request: Request, session_id: str, node_key: str, body: CompleteTurnRequest +) -> NodeResponse: + store, user_id, _ = await _require_writable_session(request, session_id) + node = await store.get_node(session_id, node_key, user_id) + if node is None: + raise HTTPException(status_code=404, detail="Position roundtable node not found") + if node["status"] == "locked": + raise HTTPException(status_code=409, detail="上游节点尚未完成，当前节点未解锁") + row = await store.update_node( + session_id, + node_key, + user_id, + status="done", + latest_answer=body.latest_answer, + artifact_manifest=body.artifact_manifest, + upstream_revision=body.upstream_revision, + increment_revision=True, + ) + if row is None: + raise HTTPException(status_code=404, detail="Position roundtable node not found") + + # A node has no coordinator. Its completion alone drives the frozen chain: + # all parallel seats in the current stage must finish before the next stage + # is made writable. Re-answering an already completed upstream seat keeps + # downstream records for audit but marks them stale so they must be + # refreshed against the new handoff context. + nodes = await store.list_nodes(session_id, user_id) + if nodes is None: + raise HTTPException(status_code=404, detail="Position roundtable session not found") + if node.get("revision", 0) > 0: + for downstream in nodes: + if ( + downstream["stage_index"] > row["stage_index"] + and downstream["status"] in {"ready", "running", "done", "stale"} + ): + await store.update_node( + session_id, + downstream["node_key"], + user_id, + status="stale", + ) + nodes = await store.list_nodes(session_id, user_id) or [] + + current_stage = [item for item in nodes if item["stage_index"] == row["stage_index"]] + later_stages = sorted( + {item["stage_index"] for item in nodes if item["stage_index"] > row["stage_index"]} + ) + if current_stage and all(item["status"] == "done" for item in current_stage) and later_stages: + next_stage = later_stages[0] + for next_node in nodes: + if next_node["stage_index"] == next_stage and next_node["status"] == "locked": + await store.update_node( + session_id, + next_node["node_key"], + user_id, + status="ready", + ) + return _project_node(row) + + +@router.get("/sessions/{session_id}/results", response_model=list[NodeResponse]) +async def list_results(request: Request, session_id: str) -> list[NodeResponse]: + rows = await _get_store(request).list_results(session_id, _current_user_id(request)) + if rows is None: + raise HTTPException(status_code=404, detail="Position roundtable session not found") + return [_project_node(row) for row in rows] diff --git a/offline-backend-20260512/backend/app/gateway/routers/roundtable_chains.py b/offline-backend-20260512/backend/app/gateway/routers/roundtable_chains.py index 60ce2c1d..10244f38 100644 --- a/offline-backend-20260512/backend/app/gateway/routers/roundtable_chains.py +++ b/offline-backend-20260512/backend/app/gateway/routers/roundtable_chains.py @@ -62,6 +62,9 @@ class ChainSeatSchema(BaseModel): # 持久化，故无需迁移；仅需在此 schema 显式声明，否则 model_dump() 会剥掉它。非法值在运行期 # 被 _SEAT_MODE_PARAMS.get() 安全忽略（回退作业级），故此处只约束长度、不强校验取值。 seat_mode: str | None = Field(default=None, max_length=16) + # 岗位协同专用的席位岗位归属。字段保存在既有 seats JSON 中，普通圆桌编排 + # 忽略它；显式声明可确保 Pydantic 在 create/update 的 model_dump() 时不剥掉。 + position_id: str | None = Field(default=None, max_length=64) class ChainResponse(BaseModel): diff --git a/offline-backend-20260512/backend/packages/harness/deerflow/persistence/migrations/versions/20260721_01_position_roundtable_sessions.py b/offline-backend-20260512/backend/packages/harness/deerflow/persistence/migrations/versions/20260721_01_position_roundtable_sessions.py new file mode 100644 index 00000000..864fa6cc --- /dev/null +++ b/offline-backend-20260512/backend/packages/harness/deerflow/persistence/migrations/versions/20260721_01_position_roundtable_sessions.py @@ -0,0 +1,87 @@ +"""Create standalone position-collaboration sessions and nodes. + +The tables only index the task / intent / frozen business-chain workflow. +Conversation messages remain in LangGraph checkpoints and artifacts stay in the +existing thread artifact store, so this migration intentionally has no message +or file columns beyond lightweight snapshots and manifests. + +Revision ID: 20260721_01 +Revises: 20260701_01 +Create Date: 2026-07-21 +""" + +from __future__ import annotations + +import sqlalchemy as sa +from alembic import op +from sqlalchemy import inspect +from sqlalchemy.dialects.mysql import LONGTEXT + + +revision = "20260721_01" +down_revision = "20260701_01" +branch_labels = None +depends_on = None + + +def _has_table(table_name: str) -> bool: + return table_name in inspect(op.get_bind()).get_table_names() + + +def upgrade() -> None: + long_text = LONGTEXT() if op.get_bind().dialect.name == "mysql" else sa.Text() + if not _has_table("position_roundtable_sessions"): + op.create_table( + "position_roundtable_sessions", + sa.Column("id", sa.String(64), primary_key=True), + sa.Column("user_id", sa.String(64), nullable=False), + sa.Column("external_task_id", sa.String(128), nullable=True), + sa.Column("task_snapshot", long_text, nullable=True), + sa.Column("chain_id", sa.String(64), nullable=True), + sa.Column("chain_snapshot", long_text, nullable=True), + sa.Column("intent_thread_id", sa.String(128), nullable=True), + sa.Column("intent_snapshot", long_text, nullable=True), + sa.Column("status", sa.String(32), nullable=False, server_default="intent_pending"), + sa.Column("created_at", sa.DateTime(), nullable=False), + sa.Column("updated_at", sa.DateTime(), nullable=False), + ) + op.create_index("ix_position_roundtable_sessions_user_id", "position_roundtable_sessions", ["user_id"]) + op.create_index( + "ix_position_roundtable_sessions_external_task_id", + "position_roundtable_sessions", + ["external_task_id"], + ) + op.create_index("ix_position_roundtable_sessions_chain_id", "position_roundtable_sessions", ["chain_id"]) + op.create_index("ix_position_roundtable_sessions_status", "position_roundtable_sessions", ["status"]) + + if not _has_table("position_roundtable_nodes"): + op.create_table( + "position_roundtable_nodes", + sa.Column("id", sa.String(64), primary_key=True), + sa.Column("session_id", sa.String(64), sa.ForeignKey("position_roundtable_sessions.id", ondelete="CASCADE"), nullable=False), + sa.Column("node_key", sa.String(256), nullable=False), + sa.Column("stage_index", sa.Integer(), nullable=False), + sa.Column("seat_index", sa.Integer(), nullable=False), + sa.Column("agent_id", sa.String(128), nullable=False), + sa.Column("position_id", sa.String(64), nullable=True), + sa.Column("thread_id", sa.String(128), nullable=True, unique=True), + sa.Column("status", sa.String(32), nullable=False, server_default="locked"), + sa.Column("latest_answer", long_text, nullable=True), + sa.Column("artifact_manifest", long_text, nullable=True), + sa.Column("revision", sa.Integer(), nullable=False, server_default="0"), + sa.Column("upstream_revision", long_text, nullable=True), + sa.Column("created_at", sa.DateTime(), nullable=False), + sa.Column("updated_at", sa.DateTime(), nullable=False), + sa.UniqueConstraint("session_id", "node_key", name="uq_position_roundtable_nodes_session_key"), + ) + op.create_index("ix_position_roundtable_nodes_session_id", "position_roundtable_nodes", ["session_id"]) + op.create_index("ix_position_roundtable_nodes_agent_id", "position_roundtable_nodes", ["agent_id"]) + op.create_index("ix_position_roundtable_nodes_position_id", "position_roundtable_nodes", ["position_id"]) + op.create_index("ix_position_roundtable_nodes_status", "position_roundtable_nodes", ["status"]) + + +def downgrade() -> None: + if _has_table("position_roundtable_nodes"): + op.drop_table("position_roundtable_nodes") + if _has_table("position_roundtable_sessions"): + op.drop_table("position_roundtable_sessions") diff --git a/offline-backend-20260512/backend/packages/harness/deerflow/persistence/models/__init__.py b/offline-backend-20260512/backend/packages/harness/deerflow/persistence/models/__init__.py index 884be67d..1c18eb4e 100644 --- a/offline-backend-20260512/backend/packages/harness/deerflow/persistence/models/__init__.py +++ b/offline-backend-20260512/backend/packages/harness/deerflow/persistence/models/__init__.py @@ -46,6 +46,10 @@ from deerflow.persistence.menu_overrides.model import MenuOverrideRow from deerflow.persistence.models.run_event import RunEventRow from deerflow.persistence.notifications.model import NotificationRow from deerflow.persistence.parallel_agent_tasks.model import ParallelAgentTaskRow +from deerflow.persistence.position_roundtable.model import ( + PositionRoundtableNodeRow, + PositionRoundtableSessionRow, +) from deerflow.persistence.positions.model import PositionRow, PositionTagBindingRow from deerflow.persistence.recommended_questions.model import RecommendedQuestionRow from deerflow.persistence.research_templates.model import ResearchTemplateRow @@ -104,6 +108,8 @@ __all__ = [ "MenuOverrideRow", "NotificationRow", "ParallelAgentTaskRow", + "PositionRoundtableNodeRow", + "PositionRoundtableSessionRow", "PositionRow", "PositionTagBindingRow", "RecommendedQuestionRow", diff --git a/offline-backend-20260512/backend/packages/harness/deerflow/persistence/position_roundtable/__init__.py b/offline-backend-20260512/backend/packages/harness/deerflow/persistence/position_roundtable/__init__.py new file mode 100644 index 00000000..eb01db3f --- /dev/null +++ b/offline-backend-20260512/backend/packages/harness/deerflow/persistence/position_roundtable/__init__.py @@ -0,0 +1,22 @@ +"""Position-collaboration session and node persistence.""" + +from __future__ import annotations + +from deerflow.persistence.position_roundtable.model import ( + PositionRoundtableNodeRow, + PositionRoundtableSessionRow, +) +from deerflow.persistence.position_roundtable.sql import PositionRoundtableRepository + +__all__ = [ + "PositionRoundtableNodeRow", + "PositionRoundtableRepository", + "PositionRoundtableSessionRow", + "make_position_roundtable_store", +] + + +def make_position_roundtable_store(session_factory): + if session_factory is None: + return None + return PositionRoundtableRepository(session_factory) diff --git a/offline-backend-20260512/backend/packages/harness/deerflow/persistence/position_roundtable/model.py b/offline-backend-20260512/backend/packages/harness/deerflow/persistence/position_roundtable/model.py new file mode 100644 index 00000000..3ca7a2a3 --- /dev/null +++ b/offline-backend-20260512/backend/packages/harness/deerflow/persistence/position_roundtable/model.py @@ -0,0 +1,83 @@ +"""Persistence models for the standalone position-collaboration workspace. + +This deliberately does **not** reuse ``roundtable_drafts`` or +``roundtable_jobs``. A session captures the selected business chain and the +confirmed task intent; every chain seat then has one durable node record. The +node points at an existing LangGraph thread, which continues to own the actual +message history and generated artifacts. +""" + +from __future__ import annotations + +from datetime import UTC, datetime + +from sqlalchemy import ForeignKey, Integer, String, UniqueConstraint +from sqlalchemy.orm import Mapped, mapped_column + +from deerflow.persistence.base import Base +from deerflow.persistence.types import BeijingDateTime, PortableLongText + + +class PositionRoundtableSessionRow(Base): + __tablename__ = "position_roundtable_sessions" + + id: Mapped[str] = mapped_column(String(64), primary_key=True) + # Phase one uses normal account isolation. A future membership / role ACL + # can be added without changing the session or thread identifiers. + user_id: Mapped[str] = mapped_column(String(64), nullable=False, index=True) + external_task_id: Mapped[str | None] = mapped_column(String(128), nullable=True, index=True) + task_snapshot: Mapped[str | None] = mapped_column(PortableLongText, nullable=True) + chain_id: Mapped[str | None] = mapped_column(String(64), nullable=True, index=True) + chain_snapshot: Mapped[str | None] = mapped_column(PortableLongText, nullable=True) + intent_thread_id: Mapped[str | None] = mapped_column(String(128), nullable=True) + intent_snapshot: Mapped[str | None] = mapped_column(PortableLongText, nullable=True) + # intent_pending -> active -> completed / archived. The router owns legal + # transitions; the DB keeps it as a concise, portable string. + status: Mapped[str] = mapped_column(String(32), nullable=False, default="intent_pending", index=True) + created_at: Mapped[datetime] = mapped_column( + BeijingDateTime(), nullable=False, default=lambda: datetime.now(UTC) + ) + updated_at: Mapped[datetime] = mapped_column( + BeijingDateTime(), + nullable=False, + default=lambda: datetime.now(UTC), + onupdate=lambda: datetime.now(UTC), + ) + + +class PositionRoundtableNodeRow(Base): + __tablename__ = "position_roundtable_nodes" + __table_args__ = ( + UniqueConstraint("session_id", "node_key", name="uq_position_roundtable_nodes_session_key"), + ) + + id: Mapped[str] = mapped_column(String(64), primary_key=True) + session_id: Mapped[str] = mapped_column( + String(64), + ForeignKey("position_roundtable_sessions.id", ondelete="CASCADE"), + nullable=False, + index=True, + ) + # Stable inside one frozen chain snapshot; e.g. ``stage-1-seat-2-agent``. + node_key: Mapped[str] = mapped_column(String(256), nullable=False) + stage_index: Mapped[int] = mapped_column(Integer, nullable=False) + seat_index: Mapped[int] = mapped_column(Integer, nullable=False) + agent_id: Mapped[str] = mapped_column(String(128), nullable=False, index=True) + position_id: Mapped[str | None] = mapped_column(String(64), nullable=True, index=True) + # The real messages remain in the standard LangGraph/checkpoint store. + thread_id: Mapped[str | None] = mapped_column(String(128), nullable=True, unique=True) + # locked / ready / running / done / stale / error + status: Mapped[str] = mapped_column(String(32), nullable=False, default="locked", index=True) + latest_answer: Mapped[str | None] = mapped_column(PortableLongText, nullable=True) + artifact_manifest: Mapped[str | None] = mapped_column(PortableLongText, nullable=True) + revision: Mapped[int] = mapped_column(Integer, nullable=False, default=0) + upstream_revision: Mapped[str | None] = mapped_column(PortableLongText, nullable=True) + created_at: Mapped[datetime] = mapped_column( + BeijingDateTime(), nullable=False, default=lambda: datetime.now(UTC) + ) + updated_at: Mapped[datetime] = mapped_column( + BeijingDateTime(), + nullable=False, + default=lambda: datetime.now(UTC), + onupdate=lambda: datetime.now(UTC), + ) diff --git a/offline-backend-20260512/backend/packages/harness/deerflow/persistence/position_roundtable/sql.py b/offline-backend-20260512/backend/packages/harness/deerflow/persistence/position_roundtable/sql.py new file mode 100644 index 00000000..368d535f --- /dev/null +++ b/offline-backend-20260512/backend/packages/harness/deerflow/persistence/position_roundtable/sql.py @@ -0,0 +1,279 @@ +"""SQL repository for position-collaboration sessions and chain nodes.""" + +from __future__ import annotations + +import json +from datetime import UTC, datetime +from typing import Any +from uuid import uuid4 + +from sqlalchemy import select +from sqlalchemy.ext.asyncio import AsyncSession, async_sessionmaker + +from deerflow.persistence.position_roundtable.model import ( + PositionRoundtableNodeRow, + PositionRoundtableSessionRow, +) + +_UNSET = object() + + +def _dumps(value: Any) -> str | None: + if value is None: + return None + return json.dumps(value, ensure_ascii=False) + + +def _loads(value: Any) -> Any: + if not isinstance(value, str) or not value: + return None + try: + return json.loads(value) + except Exception: + return None + + +def _time(value: Any) -> str | Any: + return value.isoformat() if isinstance(value, datetime) else value + + +class PositionRoundtableRepository: + def __init__(self, session_factory: async_sessionmaker[AsyncSession]) -> None: + self._sf = session_factory + + @staticmethod + def _session_dict(row: PositionRoundtableSessionRow) -> dict[str, Any]: + return { + "id": row.id, + "external_task_id": row.external_task_id, + "task_snapshot": _loads(row.task_snapshot) or {}, + "chain_id": row.chain_id, + "chain_snapshot": _loads(row.chain_snapshot), + "intent_thread_id": row.intent_thread_id, + "intent_snapshot": _loads(row.intent_snapshot), + "status": row.status, + "created_at": _time(row.created_at), + "updated_at": _time(row.updated_at), + } + + @staticmethod + def _node_dict(row: PositionRoundtableNodeRow) -> dict[str, Any]: + return { + "id": row.id, + "session_id": row.session_id, + "node_key": row.node_key, + "stage_index": row.stage_index, + "seat_index": row.seat_index, + "agent_id": row.agent_id, + "position_id": row.position_id, + "thread_id": row.thread_id, + "status": row.status, + "latest_answer": row.latest_answer, + "artifact_manifest": _loads(row.artifact_manifest) or [], + "revision": row.revision, + "upstream_revision": _loads(row.upstream_revision), + "created_at": _time(row.created_at), + "updated_at": _time(row.updated_at), + } + + async def create_session( + self, + user_id: str, + *, + external_task_id: str | None, + task_snapshot: dict[str, Any] | None, + ) -> dict[str, Any]: + now = datetime.now(UTC) + row = PositionRoundtableSessionRow( + id=uuid4().hex, + user_id=user_id, + external_task_id=external_task_id or None, + task_snapshot=_dumps(task_snapshot or {}), + status="intent_pending", + created_at=now, + updated_at=now, + ) + async with self._sf() as session: + session.add(row) + await session.commit() + await session.refresh(row) + return self._session_dict(row) + + async def list_sessions( + self, user_id: str, *, external_task_id: str | None = None, limit: int = 50 + ) -> list[dict[str, Any]]: + stmt = select(PositionRoundtableSessionRow).where(PositionRoundtableSessionRow.user_id == user_id) + if external_task_id: + stmt = stmt.where(PositionRoundtableSessionRow.external_task_id == external_task_id) + stmt = stmt.order_by(PositionRoundtableSessionRow.updated_at.desc()).limit(limit) + async with self._sf() as session: + rows = (await session.execute(stmt)).scalars().all() + return [self._session_dict(row) for row in rows] + + async def get_session(self, session_id: str, user_id: str) -> dict[str, Any] | None: + async with self._sf() as session: + row = await session.get(PositionRoundtableSessionRow, session_id) + if row is None or row.user_id != user_id: + return None + return self._session_dict(row) + + async def update_session( + self, + session_id: str, + user_id: str, + *, + task_snapshot: dict[str, Any] | object = _UNSET, + intent_thread_id: str | None | object = _UNSET, + intent_snapshot: dict[str, Any] | None | object = _UNSET, + status: str | object = _UNSET, + ) -> dict[str, Any] | None: + async with self._sf() as session: + row = await session.get(PositionRoundtableSessionRow, session_id) + if row is None or row.user_id != user_id: + return None + if task_snapshot is not _UNSET: + row.task_snapshot = _dumps(task_snapshot) + if intent_thread_id is not _UNSET: + row.intent_thread_id = intent_thread_id or None + if intent_snapshot is not _UNSET: + row.intent_snapshot = _dumps(intent_snapshot) + if status is not _UNSET: + row.status = str(status) + row.updated_at = datetime.now(UTC) + await session.commit() + await session.refresh(row) + return self._session_dict(row) + + async def activate_session( + self, + session_id: str, + user_id: str, + *, + chain_id: str, + chain_snapshot: dict[str, Any], + nodes: list[dict[str, Any]], + ) -> tuple[dict[str, Any], list[dict[str, Any]]] | None: + """Freeze a chain snapshot and create its nodes once. + + Repeated requests are intentionally idempotent: once nodes exist the + existing snapshot and nodes are returned unchanged. + """ + now = datetime.now(UTC) + async with self._sf() as session: + row = await session.get(PositionRoundtableSessionRow, session_id) + if row is None or row.user_id != user_id: + return None + node_rows = ( + await session.execute( + select(PositionRoundtableNodeRow) + .where(PositionRoundtableNodeRow.session_id == session_id) + .order_by(PositionRoundtableNodeRow.stage_index, PositionRoundtableNodeRow.seat_index) + ) + ).scalars().all() + if node_rows: + return self._session_dict(row), [self._node_dict(node) for node in node_rows] + + row.chain_id = chain_id + row.chain_snapshot = _dumps(chain_snapshot) + row.status = "active" + row.updated_at = now + node_rows = [ + PositionRoundtableNodeRow( + id=uuid4().hex, + session_id=session_id, + node_key=str(node["node_key"]), + stage_index=int(node["stage_index"]), + seat_index=int(node["seat_index"]), + agent_id=str(node["agent_id"]), + position_id=node.get("position_id") or None, + status=str(node.get("status") or "locked"), + created_at=now, + updated_at=now, + ) + for node in nodes + ] + session.add_all(node_rows) + await session.commit() + await session.refresh(row) + for node in node_rows: + await session.refresh(node) + return self._session_dict(row), [self._node_dict(node) for node in node_rows] + + async def list_nodes(self, session_id: str, user_id: str) -> list[dict[str, Any]] | None: + async with self._sf() as session: + parent = await session.get(PositionRoundtableSessionRow, session_id) + if parent is None or parent.user_id != user_id: + return None + rows = ( + await session.execute( + select(PositionRoundtableNodeRow) + .where(PositionRoundtableNodeRow.session_id == session_id) + .order_by(PositionRoundtableNodeRow.stage_index, PositionRoundtableNodeRow.seat_index) + ) + ).scalars().all() + return [self._node_dict(row) for row in rows] + + async def get_node(self, session_id: str, node_key: str, user_id: str) -> dict[str, Any] | None: + async with self._sf() as session: + stmt = ( + select(PositionRoundtableNodeRow) + .join(PositionRoundtableSessionRow, PositionRoundtableSessionRow.id == PositionRoundtableNodeRow.session_id) + .where( + PositionRoundtableNodeRow.session_id == session_id, + PositionRoundtableNodeRow.node_key == node_key, + PositionRoundtableSessionRow.user_id == user_id, + ) + .limit(1) + ) + row = (await session.execute(stmt)).scalars().first() + return self._node_dict(row) if row is not None else None + + async def update_node( + self, + session_id: str, + node_key: str, + user_id: str, + *, + thread_id: str | None | object = _UNSET, + status: str | object = _UNSET, + latest_answer: str | None | object = _UNSET, + artifact_manifest: list[dict[str, Any]] | object = _UNSET, + upstream_revision: dict[str, Any] | object = _UNSET, + increment_revision: bool = False, + ) -> dict[str, Any] | None: + async with self._sf() as session: + stmt = ( + select(PositionRoundtableNodeRow) + .join(PositionRoundtableSessionRow, PositionRoundtableSessionRow.id == PositionRoundtableNodeRow.session_id) + .where( + PositionRoundtableNodeRow.session_id == session_id, + PositionRoundtableNodeRow.node_key == node_key, + PositionRoundtableSessionRow.user_id == user_id, + ) + .limit(1) + ) + row = (await session.execute(stmt)).scalars().first() + if row is None: + return None + if thread_id is not _UNSET: + row.thread_id = thread_id or None + if status is not _UNSET: + row.status = str(status) + if latest_answer is not _UNSET: + row.latest_answer = latest_answer + if artifact_manifest is not _UNSET: + row.artifact_manifest = _dumps(artifact_manifest) + if upstream_revision is not _UNSET: + row.upstream_revision = _dumps(upstream_revision) + if increment_revision: + row.revision += 1 + row.updated_at = datetime.now(UTC) + await session.commit() + await session.refresh(row) + return self._node_dict(row) + + async def archive_session(self, session_id: str, user_id: str) -> dict[str, Any] | None: + return await self.update_session(session_id, user_id, status="archived") + + async def list_results(self, session_id: str, user_id: str) -> list[dict[str, Any]] | None: + return await self.list_nodes(session_id, user_id) diff --git a/offline-backend-20260512/backend/tests/test_position_roundtable_sessions.py b/offline-backend-20260512/backend/tests/test_position_roundtable_sessions.py new file mode 100644 index 00000000..365120cd --- /dev/null +++ b/offline-backend-20260512/backend/tests/test_position_roundtable_sessions.py @@ -0,0 +1,250 @@ +"""Persistence coverage for the standalone position-collaboration workflow.""" + +from __future__ import annotations + +from types import SimpleNamespace + +import pytest +import pytest_asyncio +from fastapi import HTTPException +from sqlalchemy.ext.asyncio import async_sessionmaker, create_async_engine + +from app.gateway.routers import position_roundtable as position_roundtable_router +from deerflow.persistence.base import Base +from deerflow.persistence.position_roundtable import PositionRoundtableRepository + + +@pytest_asyncio.fixture +async def store(tmp_path): + engine = create_async_engine(f"sqlite+aiosqlite:///{tmp_path / 'position-roundtable.db'}") + async with engine.begin() as conn: + # Register both tables with Base.metadata before creating the temporary DB. + import deerflow.persistence.position_roundtable.model # noqa: F401 + + await conn.run_sync(Base.metadata.create_all) + return PositionRoundtableRepository(async_sessionmaker(engine, expire_on_commit=False)) + + +@pytest.mark.asyncio +async def test_session_activation_freezes_chain_and_creates_nodes_once(store): + created = await store.create_session( + "user-a", + external_task_id="task-1", + task_snapshot={"title": "测试任务"}, + ) + await store.update_session( + created["id"], + "user-a", + intent_thread_id="intent-thread", + intent_snapshot={"objective": "识别意图"}, + ) + chain = { + "id": "chain-a", + "seats": [ + {"agent_id": "agent-a", "position_id": "planning"}, + {"agent_id": "agent-b", "position_id": "solution"}, + ], + } + nodes = [ + { + "node_key": "stage-1-seat-1-agent-a", + "stage_index": 0, + "seat_index": 0, + "agent_id": "agent-a", + "position_id": "planning", + "status": "ready", + }, + { + "node_key": "stage-2-seat-1-agent-b", + "stage_index": 1, + "seat_index": 0, + "agent_id": "agent-b", + "position_id": "solution", + "status": "locked", + }, + ] + + activated, created_nodes = await store.activate_session( + created["id"], "user-a", chain_id="chain-a", chain_snapshot=chain, nodes=nodes + ) + assert activated["status"] == "active" + assert activated["chain_snapshot"] == chain + assert [node["status"] for node in created_nodes] == ["ready", "locked"] + + # Repeated activate calls must return the first frozen snapshot/nodes unchanged. + repeated, repeated_nodes = await store.activate_session( + created["id"], "user-a", chain_id="other", chain_snapshot={"id": "other"}, nodes=[] + ) + assert repeated["chain_id"] == "chain-a" + assert [node["node_key"] for node in repeated_nodes] == [node["node_key"] for node in created_nodes] + + +@pytest.mark.asyncio +async def test_node_updates_are_user_scoped_and_keep_thread_out_of_messages(store): + created = await store.create_session("user-a", external_task_id=None, task_snapshot={}) + _, nodes = await store.activate_session( + created["id"], + "user-a", + chain_id="chain-a", + chain_snapshot={"id": "chain-a"}, + nodes=[ + { + "node_key": "stage-1-seat-1-agent-a", + "stage_index": 0, + "seat_index": 0, + "agent_id": "agent-a", + "position_id": "planning", + "status": "ready", + } + ], + ) + assert len(nodes) == 1 + + updated = await store.update_node( + created["id"], + nodes[0]["node_key"], + "user-a", + thread_id="langgraph-thread-a", + status="done", + latest_answer="节点回答", + artifact_manifest=[{"name": "产物.md"}], + upstream_revision={"intent": 1}, + increment_revision=True, + ) + assert updated is not None + assert updated["thread_id"] == "langgraph-thread-a" + assert updated["latest_answer"] == "节点回答" + assert updated["artifact_manifest"] == [{"name": "产物.md"}] + assert updated["revision"] == 1 + assert await store.get_node(created["id"], nodes[0]["node_key"], "user-b") is None + + +@pytest.mark.asyncio +async def test_handoff_context_inlines_only_upstream_thread_text_artifacts(tmp_path, monkeypatch): + artifact = tmp_path / "handoff.md" + artifact.write_text("上游产物正文：可供下一岗位直接参考。", encoding="utf-8") + calls: list[tuple[str, str]] = [] + + class StubStore: + async def get_session(self, session_id, user_id): + assert (session_id, user_id) == ("session-a", "user-a") + return {"task_snapshot": {"title": "测试任务"}, "intent_snapshot": {"goal": "方案分析"}} + + async def list_nodes(self, session_id, user_id): + assert (session_id, user_id) == ("session-a", "user-a") + return [ + { + "node_key": "stage-1-seat-1-agent-a", + "stage_index": 0, + "seat_index": 0, + "agent_id": "agent-a", + "position_id": "planning", + "thread_id": "upstream-thread", + "status": "done", + "revision": 1, + "latest_answer": "上游问答结果", + "artifact_manifest": [ + { + "name": "handoff.md", + "path": "mnt/user-data/outputs/handoff.md", + "mime_type": "text/markdown", + }, + { + "name": "outside.md", + "path": "mnt/user-data/uploads/outside.md", + "mime_type": "text/markdown", + }, + ], + }, + { + "node_key": "stage-2-seat-1-agent-b", + "stage_index": 1, + "seat_index": 0, + "agent_id": "agent-b", + "position_id": "solution", + "thread_id": "current-thread", + "status": "ready", + "revision": 0, + "latest_answer": None, + "artifact_manifest": [], + }, + ] + + async def resolve(thread_id: str, path: str): + calls.append((thread_id, path)) + assert thread_id == "upstream-thread" + assert path == "mnt/user-data/outputs/handoff.md" + return artifact + + monkeypatch.setattr(position_roundtable_router, "aresolve_thread_virtual_path", resolve) + request = SimpleNamespace( + app=SimpleNamespace(state=SimpleNamespace(position_roundtable_store=StubStore())), + state=SimpleNamespace(user=SimpleNamespace(id="user-a")), + ) + + context = await position_roundtable_router._handoff_context( + request, "session-a", "stage-2-seat-1-agent-b" + ) + + upstream = context["upstream_nodes"][0] + assert upstream["latest_answer"] == "上游问答结果" + assert upstream["artifacts"][0]["content"] == "上游产物正文：可供下一岗位直接参考。" + assert "content" not in upstream["artifacts"][1] + assert calls == [("upstream-thread", "mnt/user-data/outputs/handoff.md")] + + +@pytest.mark.asyncio +async def test_archived_session_rejects_node_writes_and_keeps_history_readable(): + class ArchivedStore: + async def get_session(self, session_id, user_id): + assert (session_id, user_id) == ("session-a", "user-a") + return {"id": session_id, "status": "archived"} + + async def get_node(self, session_id, node_key, user_id): + return { + "node_key": node_key, + "status": "ready", + "thread_id": None, + } + + request = SimpleNamespace( + app=SimpleNamespace(state=SimpleNamespace(position_roundtable_store=ArchivedStore())), + state=SimpleNamespace(user=SimpleNamespace(id="user-a")), + ) + with pytest.raises(HTTPException) as error: + await position_roundtable_router.bind_node_thread( + request, + "session-a", + "stage-1-seat-1-agent-a", + position_roundtable_router.NodeThreadRequest(thread_id="thread-a"), + ) + assert error.value.status_code == 409 + assert "已归档" in str(error.value.detail) + + +@pytest.mark.asyncio +async def test_locked_node_cannot_bind_a_thread_before_its_stage_is_ready(): + class LockedStore: + async def get_session(self, session_id, user_id): + return {"id": session_id, "status": "active"} + + async def get_node(self, session_id, node_key, user_id): + return { + "node_key": node_key, + "status": "locked", + "thread_id": None, + } + + request = SimpleNamespace( + app=SimpleNamespace(state=SimpleNamespace(position_roundtable_store=LockedStore())), + state=SimpleNamespace(user=SimpleNamespace(id="user-a")), + ) + with pytest.raises(HTTPException) as error: + await position_roundtable_router.bind_node_thread( + request, + "session-a", + "stage-2-seat-1-agent-b", + position_roundtable_router.NodeThreadRequest(thread_id="thread-b"), + ) + assert error.value.status_code == 409 + assert "未解锁" in str(error.value.detail)