Skip to content

[v2] 工作流节点会话对团队可见,运行显示发起人 - #385

Open
wanglongan587 wants to merge 6 commits into
ora-space:mainfrom
wanglongan587:feat/1211-workflow-session-team-visibility
Open

wanglongan587 wants to merge 6 commits into
ora-space:mainfrom
wanglongan587:feat/1211-workflow-session-team-visibility

Conversation

@wanglongan587

@wanglongan587 wanglongan587 commented Nov 17, 2026 •

Copy link
Copy Markdown
Collaborator

v2,不涉及 specs

Refs ora-space/circus#1211

本轮返工(rebase 到最新 main 9fbc9d71,回应 owner 第 1 轮 review 的 M1 / L1 / L2 / L3)

  • 已按要求 rebase 到最新 upstream/main(9fbc9d71,含 cloud#362、cloud#386、cloud#389、cloud#390、cloud#391);合并了 frontend-v2/README.md 与 #391 在「交互式 Agent 节点」段落的冲突,保留 #391 的消息送达回执说明并对齐本 PR 的团队可见说明。
  1. M1(节点会话对全租户可见 & 选择个人 Skill 的团队共享提示):
    • v2-server/README.md、frontend-v2/README.md 写明节点会话对整个租户可见,包含 Agent 读取的文件内容与工具调用;在共享工作流运行里选择个人 Skill,等同于向所有可见这次运行的成员共享该 Skill 内容,且对已合入 main(#386)的从任务评论发起的运行同样适用(发起人就是评论人)。
    • frontend-v2/src/features/workflows/editor/workflow-inspector.tsx 与 translations.ts 在 Agent 节点「必需 Skill」提示区新增说明:「运行的节点会话对团队可见,所选个人 Skill 的内容也会被看到。」并用 aria-describedby 关联到 #workflow-add-skill 按钮;补充 workflow-inspector.test.tsx 断言。
  2. L1(CI !realAgents E2E 覆盖 + 真正到达 handler 的跨租户 404):
    • frontend-v2/e2e/workflow-runs.spec.ts 在 !realAgents 分支写入归属于运行发起人 started_by(非 colleague)的 v2_execution_sessions、v2_execution_turns 与 v2_execution_events 并绑定到 起草 节点尝试,随后以 colleague 刷新并点击「查看节点会话」核对 text/event-stream 返回 200 及发起人会话 prompt/回答渲染(验证回到按调用者读取时会在 CI 模式直接失败)。
    • 在 realAgents 与 !realAgents 两路都在 PostgreSQL 临时写入一个 colleague 本人所属的第二个租户,验证携带该有效成员租户请求原租户 workflowRun 与 workflowNodeEvents 均真实到达 handler 并返回 404(code: workflow_run_not_found)。
  3. L2(动画首帧时钟锚定单测):
    • 新增 frontend-v2/src/features/chat/workflow-run/theater-overlay-motion.test.ts,固定 requestAnimationFrame 与 performance.now() 存在时钟原点偏差的场景,断言首帧 progress 仍从 0 起步并按 rAF 时钟收敛。
  4. L3(无发起人记录旧运行回退与续跑补记说明):
    • v2-server/README.md 与 frontend-v2/README.md 均补全说明:无记录发起人时读取节点会话回退为调用者,续跑这样的运行会通过 EnsureWorkflowStarter 把续跑调用者记为发起人。

此前改动内容

  • 节点会话对团队成员可见(v2-server)
    • internal/server/workflow_run_events.go:workflowNodeEvents 先按现有 workflowScope 校验调用者属于该租户、再确认节点尝试属于该运行,然后用运行记录的发起人身份(run.StartedBy,无记录时兜底调用者)作为 execution.Scope 订阅会话并读取 TurnPrompt。跨租户仍 404 workflow_run_not_found;未派发(sessionId 为空)仍是 404 workflow_node_session_not_found。
    • internal/workflowhost/resume.go:续跑无发起人记录的旧运行时用 EnsureWorkflowStarter 把续跑者补记为发起人。
    • internal/store:运行行读出发起人 started_by,详情与列表 LEFT JOIN users 带出展示名;FinishWorkflowRun / cancelWorkflowRun 补展示名。workflow_runs_test.go、workflow_run_events_test.go 覆盖发起人持久化/返回、同租户成员读实时与回放会话、跨租户 404。
  • 页面(frontend-v2)
    • run-pane.tsx 头部与 run-sidebar.tsx 列表项在有 startedByName 时显示「由 <发起人> 发起」。
    • node-session.ts、translations.ts、README 去掉「只有启动这次运行的人能查看实时会话」,拒收文案改为「无法读取这个节点的实时会话」。
    • theater-overlay-motion.ts 首帧时钟锚定修复与单测。

授权边界(owner 的验收重点)

  • 能读运行详情的成员才能读会话:v2 的运行读取权限就是租户级(workflowRunScope → workflowScope 只校验租户成员),项目只是运行的字段、小队在 v2 不是访问边界,所以会话可见范围等于运行详情的可见范围,没有额外放宽;选择了个人 Skill 的工作流运行时,其节点会话(含读取到的个人 Skill 内容与工具调用)也会按同口径对租户内成员可见。
  • 事件流只带会话内容:execution.Event 是文本增量、历史快照(含工具调用)和 TurnResult,不含发起人的模型连接、设置或凭据;TurnPrompt 读的是这一轮发给 Agent 的 prompt。
  • 交互节点的写操作仍只给发起人:发消息、停止本轮、完成继续走 #380 的 startedBy 门禁,本 PR 没有动。

验证(head c1ed689d)

  • v2-server:gofmt -l . 干净、go vet ./... 通过;GitHub Actions server(全量 go test -race ./...)已在 c1ed689d 通过;本机 619e338e(rebase 至 #386)go test -race -p 2 -count=1 ./... 27 个测试包全部通过。
  • frontend-v2(rebase 后 c1ed689d):api:check:*、typecheck、lint、vitest run --maxWorkers=4(117 文件 / 978 用例全部通过)、npm run build 通过;GitHub Actions frontend 已在 c1ed689d 通过。
  • Playwright E2E:
    • 本机(WSL Linux v2-server + PostgreSQL 18):真实 Node(V2_NODE_ASSETS_DIR=/root/.cache/ora-v2-node)下 e2e/workflow-runs.spec.ts 3/3、e2e/workflow-skills.spec.ts 1/1 通过;CI 模式下 e2e/workflow-runs.spec.ts 3/3 通过。
    • GitHub Actions e2e(c1ed689d)运行/结果见 PR checks。

截图

新增:Agent 节点「必需 Skill」团队可见提示(c1ed689d)

Agent 节点必需 Skill 选择器下方的团队共享提示

先前核心流程截图(637b3cf3,真实 Node + fixture 模型)

成员(非发起人)在运行中打开「起草」节点的实时会话:

成员实时看到节点会话,头部与列表项显示「由 协作空间 Owner 发起」

成员看到运行成功后的头部与列表:

成员看到运行成功,头部与列表项仍显示发起人

成员刷新后回放「审阅」节点,能读到工具调用与回答:

成员刷新后回放会话,包含 shell 工具调用与回答

发起人视角的结果页:

发起人视角的结果页

合并顺序

cloud#386 与 cloud#391 已合并;按 owner 指示,cloud#387 排在最后。

@zhangxinhao zhangxinhao left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

LGTM(064431e)

@wanglongan587 我看了这个 PR,理解它是要让同租户成员按发起人身份读取工作流节点的实时会话和历史回放,并在运行头部及列表展示发起人。整体没问题,可以合并。

  • 测试:cd v2-server && go test -race -count=1 -run 'TestWorkflow(NodeEvents|RunsOverHTTP|RunReadsNodesAndScopes)' ./internal/server ./internal/store 通过;cd v2-server && go test -race -count=1 -run 'Test(Resume|RefusedStartForgetsTheStarter|WorkflowRunTerminalTransitions|WorkflowRunCancel)' ./internal/workflowhost ./internal/store 通过;cd frontend-v2 && npx vitest run src/features/chat/workflow-run/run-flow.test.tsx src/features/chat/workflow-run/server-runs.test.tsx src/features/chat/workflow-run/server-run-adapter.test.ts src/features/chat/workflow-run/run-resume-dialog.test.tsx --maxWorkers=2 通过;cd frontend-v2 && npm run api:check:workflows 通过;没跑全量和 e2e。

涉及对外 API/协议、鉴权,建议 owner 再看一眼。

以上都是建议,怎么处理由你决定。

自动检视 · 基于 064431e · 第 1 轮(全量)

@wanglongan587
wanglongan587 force-pushed the feat/1211-workflow-session-team-visibility branch 2 times, most recently from c5b58e1 to 4b5e642 Compare November 17, 2026 07:40

@zhangxinhao zhangxinhao left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

LGTM(4b5e642)

@wanglongan587 我看了这个 PR,理解它是要让同租户成员按运行发起人的身份读取工作流节点的实时会话和历史回放,并在运行头部及列表展示发起人。整体没问题,可以合并。建议同步 PR 描述中的字段说明;本地测试因缺少数据库配置和前端依赖未能执行,相关 Go 包的 vet 检查通过。

  • 💬 其他建议:nit-1 同步描述中的发起人字段说明
  • 测试:cd v2-server && go test -race -count=1 -v -run 'TestWorkflow(NodeEvents|RunsOverHTTP|RunReadsNodesAndScopes|RunTerminalTransitions|RunCancel)' ./internal/server ./internal/store 没跑(命令完成编译,但匹配的测试均因未设置 TEST_DATABASE_URL 而跳过。);cd frontend-v2 && npx --no-install vitest run src/features/chat/workflow-run/run-flow.test.tsx src/features/chat/workflow-run/server-runs.test.tsx src/features/chat/workflow-run/server-run-adapter.test.ts src/features/chat/workflow-run/run-theater-interactive.test.tsx src/features/chat/workflow-run/run-resume-dialog.test.tsx --maxWorkers=4 没跑(本地未安装 Vitest,测试未能启动。);cd v2-server && go vet ./internal/server ./internal/store ./internal/workflowhost 通过;没跑全量和 e2e。

涉及对外 API/协议、鉴权,建议 owner 再看一眼。

没法放到行内的意见

nit-1(可选) PR 描述说 WorkflowRun 和 WorkflowRunSummary 都新增必填字符串 startedBy、startedByName,但实际只新增了 startedByName;startedBy 仍是运行详情外层已有的可空字段,列表并不返回它。建议按最终契约更新描述,避免调用方误以为列表也能取得发起人 ID。

以上都是建议,怎么处理由你决定。

自动检视 · 基于 4b5e642 · 第 2 轮(全量)

@zhangxinhao zhangxinhao left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

LGTM(637b3cf)

@wanglongan587 我看了这个 PR,理解它是要让同租户成员按运行发起人的身份读取工作流节点的实时会话和历史回放,并在运行头部及列表展示发起人。整体没问题,可以合并。

  • ✅ 上轮的 nit-1 已处理,谢谢。
  • 测试:cd v2-server && go test -race -count=1 -v -run 'TestWorkflow(NodeEvents|RunsOverHTTP|RunReadsNodesAndScopes|RunTerminalTransitions|RunCancel)|TestResume|TestRefusedStartForgetsTheStarter' ./internal/server ./internal/store ./internal/workflowhost 没跑(编译完成,但相关用例均因未设置 TEST_DATABASE_URL 而跳过。);cd frontend-v2 && npx --no-install vitest run src/features/chat/workflow-run/run-flow.test.tsx src/features/chat/workflow-run/server-runs.test.tsx src/features/chat/workflow-run/server-run-adapter.test.ts src/features/chat/workflow-run/run-theater-interactive.test.tsx src/features/chat/workflow-run/run-resume-dialog.test.tsx 没跑(缺少 @tailwindcss/vite 等前端依赖,测试配置未能加载。);cd v2-server && go vet ./internal/server ./internal/store ./internal/workflowhost 通过;没跑全量和 e2e。

涉及对外 API/协议、鉴权,建议 owner 再看一眼。

以上都是建议,怎么处理由你决定。

自动检视 · 基于 637b3cf · 第 3 轮(全量)

@EricWvi EricWvi left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

owner 验收第 1 轮(637b3cf3):0H/1M/3L。M1(个人 Skill 经事件流对成员可见)owner 决定接受并写进文档;需要补 README 和前端提示,修 L1 的 e2e。详情见 ora-space/circus#1211。

@wanglongan587
wanglongan587 force-pushed the feat/1211-workflow-session-team-visibility branch from efc3dbe to 619e338 Compare November 17, 2026 12:53
@wanglongan587
wanglongan587 force-pushed the feat/1211-workflow-session-team-visibility branch from 619e338 to c1ed689 Compare November 17, 2026 12:55
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants