Beaver：从聊天到可验收工作的产品 PRD

Job Story

当我第一次试用 Beaver 时，我想注册后直接进入自己的工作实例，所以我能在不理解底层部署的情况下开始第一项 Agent 工作。

WWA

Why：私有实例是 Beaver 的信任基础。用户必须先进入稳定、隔离、可恢复的环境。

What：提供注册、登录、handoff、Provider 配置、实例状态展示和失败恢复提示。

• 用户能完成注册并进入实例。
• Provider 未配置时有清晰提示。
• 实例健康状态能被用户或管理员看到。
• 控制面服务不作为公共产品入口暴露。

测试场景

• 新用户注册后得到 token 和 handoff URL。
• 实例没有 Provider 时，发送任务前出现可理解错误。
• 访问 /api/ping 和 /api/status 返回健康数据。
• 错误 token 访问受保护接口返回 401。

Job Story

当我给 Agent 一个需要持续完成的工作时，我想看到它变成一个有状态的任务，所以我能知道它做到哪一步、产出了什么、是否值得接受。

WWA

Why：聊天只能回答，任务才能交付。Beaver 必须把“会话”升级为“工作单”。

What：支持发送消息和附件、任务识别、实时进度、任务列表、任务详情、验收与修订。

• 任务可从聊天、列表、详情页互相跳转。
• 用户能接受、要求修订或放弃结果。
• 修订保留原任务上下文。
• 任务状态和时间线在桌面和移动端可读。

测试场景

• 发送任务型请求后创建 active task。
• WebSocket 推送思考、工具、产物和完成事件。
• 点击接受后任务状态持久化。
• 输入修订意见后同一任务追加新 run。

Job Story

当我的任务依赖文档、图片或数据文件时，我想把文件放进 Beaver，并在结果里看到它如何被使用，所以我能信任任务产出。

WWA

Why：企业知识工作通常围绕文件展开。没有文件边界，Agent 工作就难以落地。

What：提供目录、上传、预览、下载、删除和新建文件夹能力；Agent 工具只能在允许路径内操作。

• 根目录和多级目录可浏览。
• Markdown、文本、图片可预览。
• 上传失败有可理解错误。
• 非法路径不能逃逸工作区。

测试场景

• 上传文件后列表立即出现。
• 打开 Markdown 文件显示预览。
• 下载文件内容与上传内容一致。
• 删除目录或文件后刷新仍不存在。
• 路径穿越请求被拒绝。

Job Story

当我准备让 Agent 调用外部工具时，我想先测试连接并看清权限范围，所以我能避免把不可靠或高风险工具交给 Agent。

WWA

Why：工具是 Agent 的行动边界，也是最大的安全风险。

What：支持 MCP server 的新增、编辑、删除、测试、工具发现、AuthZ scope 预览和本地/远程分类。

• 管理员能添加 stdio 或 remote server。
• 测试失败返回具体原因。
• 工具列表显示 server 来源。
• 需要授权的工具显示权限预览。

测试场景

• 新增 server 后出现在 MCP 列表。
• 测试可用 server 返回 ok。
• 删除 server 后工具列表同步减少。
• 无效 JSON 配置在前端被拦截。

Job Story

当一个任务结果被证明有用时，我想把它转成可审核的技能，所以团队以后不用从零开始重复同样方法。

WWA

Why：没有技能复用，Beaver 只是一次性执行工具；有技能复用，Beaver 才能积累团队能力。

What：提供已发布技能、候选、草稿、安全报告、评测报告、提交、批准、拒绝、发布、禁用、回滚、上传和市场安装。

• 候选能基于运行证据生成。
• 高风险草稿不能直接发布。
• 发布需要人审状态。
• 技能版本可查看、下载、回滚。

测试场景

• 运行学习任务后产生候选或明确说明无候选。
• 候选生成草稿后出现在草稿区。
• 安全检查失败时提交按钮不可用。
• 批准并发布后技能进入已发布列表。
• 回滚后当前版本发生变化。

Job Story

当一个任务需要调研、分析、生成和审核多步协作时，我想让 Beaver 自动拆分并展示每个子任务结果，所以我能判断最终答案是否可靠。

WWA

Why：复杂工作无法靠单轮问答稳定完成。多 Agent 执行能提高分工质量，但必须可解释。

What：支持 agent/subagent 管理、任务计划、执行图、子任务结果、失败状态和最终合成。

• 管理员能创建和编辑本地 subagent。
• 任务可生成可读执行计划。
• 子任务失败不会丢失部分证据。
• 最终答案能引用或总结子任务输出。

测试场景

• 创建 subagent 后刷新仍存在。
• 复杂任务生成 sequence/parallel/DAG 计划。
• 某节点失败时任务时间线显示失败节点。
• 最终合成包含子任务摘要。

Job Story

当我有固定周期的汇总或外部消息触发的工作时，我想让 Beaver 自动运行并通知我审核，所以我不用每天手动发起同样任务。

WWA

Why：企业工作有大量周期任务和外部事件。主动触发是 Agent 从助手变成运营系统的关键。

What：支持计划任务创建、开关、删除、立即运行，通知列表和详情，Outlook 连接、邮箱、日历、消息详情，渠道连接和验证。

• 计划任务可以被暂停和恢复。
• 计划输出可以进入正常任务验收流。
• 连接器失败显示可恢复错误。
• 外部写入必须受策略控制。

测试场景

• 创建 every/cron/at 三类计划任务。
• 点击 run now 产生一次 scheduled run。
• 通知详情页能 engage 到任务上下文。
• Outlook 配置测试失败时显示错误。
• 重复外部消息被 dedupe store 去重。

Job Story

当 Agent 任务失败或连接器不可用时，我想快速看到配置、运行状态和日志，所以我能恢复服务而不是猜问题在哪里。

WWA

Why：私有部署产品的体验不只在用户界面，也在故障恢复速度。

What：提供 Provider 配置、Agent 参数、渠道配置、连接器状态、运行时重启、系统状态、聊天日志、事件投影。

• Provider 保存后状态刷新。
• 运行时重启需要确认。
• 日志能按 session/run 展开。
• 错误状态能给出下一步处理提示。

测试场景

• 保存 Provider 配置后 /api/status 反映新状态。
• 重启按钮触发 /api/runtime/restart 并显示进行中。
• 日志页展示最近 run 和事件。
• 长配置值不撑破页面。