From ca02f23b2b892d66392c01cca16f7afae0307e90 Mon Sep 17 00:00:00 2001 From: gdemonc <1502689916@qq.com> Date: Tue, 14 Apr 2026 18:40:39 +0800 Subject: [PATCH 1/6] docs: add product-requirement-document --- docs/product-requriement-document.md | 610 +++++++++++++++++++++++++++ 1 file changed, 610 insertions(+) create mode 100644 docs/product-requriement-document.md diff --git a/docs/product-requriement-document.md b/docs/product-requriement-document.md new file mode 100644 index 000000000..bc683db38 --- /dev/null +++ b/docs/product-requriement-document.md @@ -0,0 +1,610 @@ +# CialloClaw 产品需求文档（PRD） + +| 文档信息 | | +| -------- | ---------------------- | +| 产品名称 | CialloClaw | +| 文档版本 | v3.4 | +| 文档状态 | 最终版 | +| 创建日期 | 2026-04-14 | +| 目标平台 | Windows / macOS 桌面端 | +| 产品定位 | 桌面常驻协作型 Agent | + +------ + +## 1. 项目背景 + +当前桌面端用户在真实工作流中使用 Agent 时，长期存在三类未被良好满足的问题： + +**问题 A —— Agent 发起门槛高：** +用户通常需要先打开聊天窗口、进入某个工作区或组织 prompt，系统才开始理解需求。很多“本可以顺手发起”的帮助，最终因为路径太长而没有发生。 + +**问题 B —— 上下文迁移成本高：** +用户需要手动复制网页、文档、报错、文件内容，再搬运到另一个产品中让 Agent 理解。帮助发生在任务现场之外，而不是围绕现场直接展开。 + +**问题 C —— 执行不可信、长期价值不可见：** +很多 Agent 可以给建议，但用户不敢交出执行权，因为不清楚它会改什么、保存到哪里、失败后能否恢复、为什么需要授权。同时，系统即便记住了偏好，也常以黑箱方式存在，难以形成长期协作信任。 + +**市场机会：** +当前聊天型 AI 擅长问答，但不自然嵌入桌面任务现场；自动化工具能做事，但学习成本高、交互生硬；桌面小组件有入口，却缺乏持续协作能力。CialloClaw 希望填补这几类产品之间的空白：既不要求用户离开当前工作流，又能在可控边界内帮助理解、提醒、推进与有限执行。 + +**产品机会：** +用户真正需要的，不是一个“必须专门去使用”的 AI 工具，而是一个“在当前桌面现场中顺手出现、顺手帮忙、不会乱来”的协作对象。只要产品能同时解决“发起门槛、上下文承接、结果可消费、边界可理解”四个问题，就有机会形成长期使用习惯。 + +------ + +## 2. 项目目的 + +打造一款**面向真实桌面任务现场的常驻协作型 Agent 产品**，让用户在日常使用电脑时拥有一个： + +- 不必先进入聊天窗口即可发起协作的桌面入口 +- 能围绕当前页面、文件、文本、任务和异常现场提供帮助的上下文助手 +- 能从“理解内容”推进到“给出下一步、生成草稿、推动事项”的协作对象 +- 能在明确边界内执行有限动作，并让用户清楚知道影响范围、恢复方式与资源消耗的可信系统 + +补充原则： + +- 默认常驻，按需展开 +- 通话优先，文字补充 +- 上下文优先，聊天后置 +- 先提示，再确认，后执行 +- 高风险动作必须可控 +- 开箱即用优先 + +------ + +## 3. 项目目标 + +### 3.1 产品目标 + +#### 目标一：降低桌面协作发起门槛 + +用户应能够通过单击、长按、悬停、拖拽、选中等轻动作，在当前桌面现场顺手发起一次协作，而不是先打开另一个产品再组织需求。 + +#### 目标二：让帮助直接发生在任务现场 + +系统应优先围绕当前页面、文本、文件、视频、错误信息、任务事项等上下文承接需求，减少复制粘贴、切换工具和解释背景的成本。 + +#### 目标三：从“回答问题”走向“推进任务” + +CialloClaw 不只负责给出解释和总结，还应帮助用户明确下一步、生成草稿、打开资料、推动事项进入执行，并在必要时把未来安排转化为正在推进的任务。 + +#### 目标四：建立长期协作与可控执行信任 + +系统应逐步形成对用户偏好、习惯、任务脉络的长期理解，并通过风险分级、授权确认、日志、恢复点、资源消耗可见等能力，建立“敢用、敢托付一点事”的信任基础。 + +### 3.2 用户价值目标 + +| 目标维度 | 目标说明 | +| ---------- | -------------------------------------------- | +| 发起效率 | 用户在当前桌面现场发起协作的成本明显降低 | +| 上下文效率 | 用户补充背景与搬运内容的成本明显下降 | +| 推进效率 | 用户从“知道问题”到“进入下一步动作”的路径缩短 | +| 信任感 | 用户能理解系统边界、恢复方式和资源消耗 | +| 长期协作 | 用户能感知系统记住了什么，并从中获得持续价值 | + +### 3.3 产品成功标准 + +从最终产品视角，CialloClaw 需要稳定达成以下主观结果： + +- 它总是在，但不烦 +- 我不必先去打开它，它就在当前任务附近 +- 它能看懂我正在做什么，不必让我重复解释 +- 它不只是说建议，还会帮我推进下一步 +- 它做事之前会让我明白边界 +- 我能知道它做了什么、花了什么、出了问题怎么退 +- 它越来越像一个熟悉我工作方式的协作者 + +------ + +## 4. 需求变更说明 + +本文档为最终版总纲 PRD。其目标是在一份文档内完整说明产品定位、目标、模块边界、核心规则和需求范围，使其能够独立成立并作为后续设计、交互、实现和评审的统一上位依据。 + +| 版本 | 日期 | 变更内容 | +| ---- | ---------- | ------------------------------------------------------------ | +| v1.0 | 2026-04-05 | 初版 PRD，明确产品定位、目标用户、核心问题、产品原则与整体交互主线，建立“桌面常驻入口 + 轻量承接 + 仪表盘 + 可控执行”的基础框架。 | +| v1.1 | 2026-04-05 | 在初版基础上细化产品形态与整体交互，补充悬浮球、语音、气泡、仪表盘四层结构，以及单击、双击、长按、悬停、拖拽、文本选中的入口语义，强化“主动输入 / 主动协助”双闭环。 | +| v1.2 | 2026-04-05 | 补充差异化能力目标与能力边界，新增开箱即用原则、多模型与插件接入、自动化任务、屏幕 / 硬件感知、执行沙盒、中断恢复与成本熔断等内容，增强产品的长期协作与可控执行能力。 | +| v1.3 | 2026-04-05 | 在既有 PRD 基础上进一步向架构承接过渡，明确产品分层、模块职责、信息流、状态流、页面承接关系、能力边界及 MVP 承接范围。 | +| v1.4 | 2026-04-05 | 进一步强化任务系统、记忆系统与安全治理体系，补充任务状态流、记忆分层与读写规则、风险分级、结果分层交付及指标验证思路。 | +| v2.0 | 2026-04-06 | 在原版基础上补充已明确的模块设计与交互承接，强化待办管家、任务状态 / 任务巡检分工、安全卫士、恢复回滚、授权审计、费用治理等模块内容。 | +| v2.1 | 2026-04-06 | 在上一版基础上继续补充能力扩展与自动协助逻辑，增强任务巡检的自动推进能力，并增加视频总结、长内容理解等场景能力。 | +| v3.0 | 2026-04-13 | 按 PRD 模板重构章节结构，统一为产品表达版，整合前序内容并吸收已明确的产品模块关系，形成更标准化的总纲文档。 | +| v3.1 | 2026-04-13 | 为 v3.0 瘦身，保留产品定义、模块边界和关键规则，把字段清单、按钮穷举、说明书式段落压缩掉。 | +| v3.2 | 2026-04-14 | 在 v3.1 结构基础上，进一步补齐交互原则、能力边界与模块补充，沉淀为总纲版 PRD。 | +| v3.3 | 2026-04-14 | 收敛模块命名口径，明确悬浮球、气泡区与轻量输入、仪表盘、控制面板等核心对象，降低产品表达与实现表达的歧义。 | +| v3.4 | 2026-04-14 | 作为总纲最终版完成整理：保留优先级管理，但统一落在模块 / 能力层；将高价值信息球并入仪表盘首页机制；按“用户可见模块 + 系统映射”重写需求详情，使文档可独立作为完整 PRD 使用。 | + +------ + +## 5. 功能清单 + +### 5.1 用户需求及对应功能点 + +| 用户需求 | 对应功能点 | 优先级 | +| -------------------------------------------------- | --------------------------------------------- | ------ | +| 在当前页面、文本、文件上快速获得帮助 | 内容理解、总结、翻译、解释、重点提炼 | P0 | +| 遇到报错、阻塞或异常时获得原因和下一步建议 | 异常理解、任务推进建议、阻塞解释 | P0 | +| 把未来要做的事情整理起来，并在合适时机被提醒或推进 | 便签协作、临期识别、重复事项、Agent 建议 | P0 | +| 把某件事项正式交给 Agent 推进 | 便签转任务、任务状态模块、任务详情 | P0 | +| 了解当前任务做到哪一步、是否卡住、是否需要授权 | 任务状态模块、进度时间线、信任摘要 | P0 | +| 希望系统越来越懂自己，但又不想被黑箱记住 | 镜子模块、历史概要、用户画像、记忆管理 | P0 | +| 希望清楚知道系统会改什么、影响什么、能不能撤回 | 安全卫士、风险分级、恢复点、审计记录 | P0 | +| 需要一个稳定的桌面入口，而不是聊天窗口 | 悬浮球、气泡区与轻量输入、仪表盘 | P0 | +| 希望能启用或关闭主动协助、记忆、预算等全局行为 | 控制面板、记忆策略、主动协助、预算设置 | P1 | +| 希望系统支持更多自动化与扩展能力 | 自动化设置、平台扩展、模型路由、插件 / Skills | P2 | + +### 5.2 功能模块总览 + +| 功能模块 | 功能项 | 优先级 | +| ------------------ | ---------------------------------------------------- | ------ | +| 悬浮球 | 常驻入口、状态提示、单击 / 双击 / 长按 / 悬停承接 | P0 | +| 气泡区与轻量输入 | 短结果、轻提示、补充输入、意图确认 | P0 | +| 内容理解 | 总结、翻译、解释、错误分析、重点提炼 | P0 | +| 任务推进 | 下一步建议、草稿生成、资料入口、阻塞解释 | P0 | +| 任务状态模块 | 进行中 / 等待中 / 异常中 / 已结束任务查看与管理 | P0 | +| 便签协作模块 | 近期要做、后续安排、重复事项、已结束事项 | P0 | +| 镜子模块 | 历史概要、阶段总结、用户画像、记忆管理 | P0 | +| 安全卫士模块 | 风险分级、待确认项、授权记录、恢复与费用 | P0 | +| 仪表盘首页 | 焦点区、任务总览、首页高价值召回机制 | P0 | +| 控制面板 | 全局行为、记忆策略、主动协助、预算与默认结果位置设置 | P1 | +| 自动化与扩展 | 周期巡检、定时任务、插件 / Skills、模型路由 | P2 | +| 高阶理解与能力扩展 | 视频总结、长内容理解、多模型协同 | P2-P3 | + +### 5.3 版本范围说明 + +**P0：主链路能力** + +- 悬浮球 +- 气泡区与轻量输入 +- 内容理解 +- 任务推进 +- 任务状态模块 +- 便签协作模块 +- 镜子模块概览能力 +- 安全卫士最小闭环 +- 仪表盘首页 + +**P1：增强型管理能力** + +- 控制面板 +- 便签协作增强 +- 恢复详情 +- 记忆管理增强 +- 自动化基础设置 + +**P2-P3：扩展型能力** + +- 高阶主动协助 +- 视频总结 +- 长内容理解增强 +- 多模型协同 +- 插件 / Skills 生态 +- 更复杂的自动化执行能力 + +### 5.4 核心功能逻辑 + +CialloClaw 的核心运行逻辑可归纳为一条统一的“**现场识别 → 理解判断 → 结果交付 → 任务推进 → 长期沉淀**”链路： + +```mermaid +flowchart TD + A[当前桌面现场 / 用户输入 / 环境信号] --> B[识别任务对象] + B --> C[理解意图与帮助机会] + C --> D{系统判断} + D --> E[返回轻量结果] + D --> F[进入正式结果交付] + D --> G[生成下一步建议] + D --> H[进入确认流] + H --> I[有限执行] + E --> J[更新任务与事项状态] + F --> J + G --> J + I --> J + J --> K[沉淀历史、记忆与治理记录] +``` + +**关键设计决策：** + +- 产品主入口是悬浮球，而不是聊天窗口 +- 轻量结果优先在当前任务现场附近交付，长结果自动分流到正式交付层 +- “便签协作”与“任务状态”严格区分：前者是未来安排，后者是已被 Agent 接手推进的工作 +- 高风险动作必须进入确认流，不允许在黑箱中直接执行 +- 长期记忆必须对用户可见、可管理、可纠正 + +------ + +## 6. 产品架构 + +### 6.1 用户可见模块流程图 + +```mermaid +flowchart TD + Start[悬浮球待机] --> Trigger{用户发起 / 系统识别帮助机会} + Trigger --> A[气泡区与轻量输入] + A --> B{结果类型判断} + B --> C[轻量结果返回] + B --> D[正式结果交付] + B --> E[进入任务推进] + E --> F{是否涉及风险动作} + F -- 否 --> G[继续推进或完成] + F -- 是 --> H[等待确认] + H --> I[执行 / 拒绝 / 修改] + G --> J[写入历史与状态] + I --> J + Start --> K[打开仪表盘] + K --> K0[仪表盘首页] + K --> K1[任务状态模块] + K --> K2[便签协作模块] + K --> K3[镜子模块] + K --> K4[安全卫士模块] +``` + +### 6.2 功能架构图（信息架构图） + +```mermaid +graph TD + Root[CialloClaw 功能架构] + + Root --> A[近场交互层] + Root --> B[仪表盘] + Root --> C[控制面板] + Root --> D[核心能力系统] + + A --> A1[悬浮球] + A --> A2[气泡区] + A --> A3[轻量输入] + A --> A4[当前任务对象承接] + + B --> B0[仪表盘首页] + B --> B1[任务状态模块] + B --> B2[便签协作模块] + B --> B3[镜子模块] + B --> B4[安全卫士模块] + B --> B5[首页高价值召回机制] + + C --> C1[入口与外观设置] + C --> C2[记忆与主动协助设置] + C --> C3[自动化与预算设置] + C --> C4[结果位置与数据清理] + + D --> D1[内容理解] + D --> D2[任务推进] + D --> D3[长期记忆] + D --> D4[执行与自动化] + D --> D5[安全与治理] +``` + +------ + +## 7. 通用规则 + +### 7.1 全局运行策略 + +| 场景 | 策略 | +| ------------ | ---------------------------------------------------------- | +| 默认状态 | 产品以低存在感方式常驻，可随时接近，但不持续抢占注意力 | +| 用户主动发起 | 优先围绕当前对象承接，先给短结果或意图确认，再进入正式交付 | +| 系统主动协助 | 仅以轻提示方式出现，不使用高侵入打断 | +| 长结果生成 | 自动分流到文档、结果页、任务详情等正式交付层 | +| 风险动作 | 统一进入风险分级和授权确认链路 | +| 中断与失败 | 必须告诉用户卡在哪一步、是否有恢复点、能否重试 | + +### 7.2 文案展示通用规则 + +| 规则项 | 说明 | +| ------------ | ---------------------------------------------- | +| 表达风格 | 以任务导向、清晰、可理解为主，避免抽象系统术语 | +| 结果长度 | 轻量结果应控制在一屏内；超出必须自动分流 | +| 推荐语句 | 必须短、直接、可点击，不应写成长解释 | +| 风险说明 | 必须具体说明会改什么、影响什么、能否撤回 | +| 主动提示频率 | 必须克制，避免在用户无操作或离开时高频打扰 | + +### 7.3 名称定义说明 + +以下术语为正式命名。括号仅在首次出现时用于术语映射或能力澄清，后续正文不重复使用解释性括号。 + +| 术语 | 定义 | +| ------------------ | -------------------------------------------------------- | +| 悬浮球 | 桌面常驻入口，用户接近 CialloClaw 的默认近场入口 | +| 气泡区 | 当前任务现场附近的短结果、轻提示与状态反馈承接层 | +| 轻量输入 | 围绕当前对象的一句话补充输入与意图确认入口 | +| 仪表盘 | 任务状态、便签协作、镜子、安全卫士的统一工作台 | +| 控制面板 | 低频全局设置与系统策略入口，不承担任务承接和结果查看职责 | +| 任务 | 已经被 Agent 接手并正在推进的工作 | +| 便签协作 | 未来安排、周期事项和可转交给 Agent 的异步协作入口 | +| 镜子 | 系统对历史、偏好、总结和长期理解的显性表达层 | +| 安全卫士 | 风险、授权、恢复、审计、成本的解释与接管层 | +| 首页高价值召回机制 | 用户打开仪表盘时，系统按优先级提示当前最值得关注的信息 | +| 正式交付 | 文档、结果页、任务详情、文件等可继续消费和回看的结果 | + +------ + +## 8. 需求详情说明 + +### 模块 1：悬浮球与气泡区 + +**系统映射：** + +- 悬浮球：默认常驻近场入口 +- 气泡区与轻量输入：短结果、确认、补充输入承接 + +**模块定位：** +悬浮球与气泡区共同构成桌面近场交互层。它们负责让协作在当前任务附近被低成本发起、低打扰承接，而不是让用户先打开一个聊天窗口再组织需求。 + +**用户可见能力：** + +- 提供可随时接近的常驻入口 +- 展示当前系统主状态 +- 承接用户单击、双击、长按、悬停、拖拽、文本选中后的后续动作 +- 在识别到帮助机会时，以低打扰方式提示用户 +- 显示短结果、状态反馈、下一步建议与意图确认 +- 承接一句话补充输入 + +**核心交互：** + +| 交互行为 | 系统响应 | +| -------- | ------------------------------------------------ | +| 单击 | 轻量接近；若已有任务对象，则进入围绕该对象的承接 | +| 双击 | 打开仪表盘 | +| 长按 | 进入语音承接 | +| 悬停 | 展示轻量输入与推荐问题 | +| 文件拖拽 | 识别文件对象并进入确认流 | +| 文本选中 | 标记为已识别对象，等待用户继续发起 | + +**设计原则：** + +- 单击用于低成本发起协作，不是默认打开应用 +- 长按是语音主入口，上滑锁定、下滑取消 +- 悬停用于一句话补充和推荐问题，不演化为聊天弹窗 +- 文本选中与文件拖拽的目标，是让任务对象直接进入协作链路，而不是让用户先复制粘贴到对话框中 +- 轻量承接默认轻量，不演化为聊天窗口 +- 生命周期可控，可隐藏、恢复、置顶、删除 +- 一旦内容超出承载范围，必须自动分流到正式交付层 + +### 模块 2：任务状态模块 + +**系统映射：** 仪表盘中的任务状态工作区 + +**模块定位：** +任务是“已经被 Agent 接手并正在推进的工作”；便签协作中的事项是“未来的安排”。当便签协作中的某件事正式交给 Agent 推进后，应自动生成一个任务，并与原始事项保持关联。 + +**预览态要承载的内容：** + +未完成任务至少展示： + +- 任务名称 +- 任务状态 +- 当前执行到哪一步 + +已结束任务至少展示： + +- 任务名称 +- 最终状态 + +首页焦点区必须让用户快速判断： + +- 这个任务是否卡住 +- 是否需要我现在介入 +- 当前是否接近完成 + +**详情态要承载的内容：** + +- 任务头部：任务名称、当前状态、来源、开始时间、最近更新时间 +- 进度时间线：完整步骤、当前停留步骤、已完成 / 进行中 / 未开始的清晰区分 +- 关键上下文：资料、记忆摘要、用户约束、重要前提 +- 成果区：文件、草稿、网页、清单、模板等，并支持直接打开 +- 信任摘要：风险状态、待授权数量、恢复点、最近边界触发 +- 操作区：暂停 / 继续、取消、修改任务、查看安全详情、重启任务 + +**建议采用的状态语言：** + +- 进行中：正在进行、接近完成 +- 等待中：暂停、等待授权、等待补充信息、等待上游条件 +- 异常中：失败、阻塞、执行异常 +- 已结束：已完成、已取消、已结束未完成 + +### 模块 3：便签协作模块 + +**系统映射：** 仪表盘中的便签协作工作区 + +**模块定位：** +便签协作不是传统待办清单，而是 Agent 异步协作的入口。它负责把“记下来的事情、周期性的事情、尚未开始但需要记住的事情”整理成可巡检、可提醒、可转交给 Agent 的结构。 + +**分类结构与预览逻辑：** + +- 近期要做：快到时间、今天要做、最近几天要处理的事项 +- 后续安排：已记下但还没到处理窗口的事项 +- 重复事项：每天、每周、每月等循环发生的规则 +- 已结束：已完成或已取消的事项 + +**Agent 建议的表现方式：** + +- 下一步建议：先打开模板、先整理材料、先生成草稿等 +- 待办转任务：用户确认后，直接生成任务并跳转到任务状态页 +- 流程化建议：反复延期或频繁出现时，提示整理成固定流程或模板 + +### 模块 4：镜子模块 + +**系统映射：** 仪表盘中的镜子工作区 + +**模块定位：** +镜子模块承接的是 Agent 的长期理解能力，但页面表现不能像原始日志仓库，而应像“可以被用户理解和管理的认知镜像”。 + +它至少要承担三件事： + +- 替代传统聊天中的历史承接，让用户能看到最近一段时间的对话概要与上下文脉络 +- 生成日报或阶段总结，让用户知道今天做了什么、完成了什么、涉及了哪些关键权限或成果 +- 逐步沉淀用户画像、偏好与习惯，并允许用户查看、纠正、关闭或删除 + +**可管理动作：** + +- 保留 +- 修改 +- 删除 +- 忽略本次建议 +- 关闭该类记忆 + +**补充要求：** + +- 记忆默认以结构化信息为主，不以原始文本堆积为目标 +- 支持短期记忆、长期记忆、任务级记忆分层 +- 周期性总结要对用户可见、可验证、可管理 + +### 模块 5：安全卫士模块 + +**系统映射：** 仪表盘中的安全与治理工作区 + +**模块定位：** +安全卫士是仪表盘里的最后一道解释与接管层。它不应该只在出事时出现，而应始终让用户知道： + +- 当前有没有待确认操作 +- 最近是否发生过拦截 +- 成果会保存到哪里 +- 如果现在停下能否恢复 + +**预览态至少展示：** + +- 当前安全状态 +- 待确认操作数 +- 最近一次异常 +- 最近恢复点 +- 当前任务资源消耗 +- 今日累计资源消耗 + +**详细态包含：** + +- 待确认 / 被拦截操作 +- 授权记录 +- 审计记录 +- 影响范围 +- 恢复与回滚 +- 规则与权限管理 +- Token 与费用 +- 执行日志 + +**风险等级的页面表达：** + +- 绿灯：低风险、可静默执行，页面记录即可 +- 黄灯：会修改内容或改变环境，先解释影响范围，再给确认入口 +- 红灯：删除、外发、不可逆、越界或涉及身份与关键文件的动作，必须显式人工确认 + +**补充边界能力：** + +- 默认工作区与写入边界校验 +- 高风险执行进入更强隔离环境 +- 一键中断与恢复 +- 任务工作区级回滚与项目级快照恢复的预留设计 + +### 模块 6：控制面板 + +**系统映射：** 全局设置与系统策略入口 + +**模块定位：** +控制面板是 CialloClaw 的低频配置入口，用于承接全局行为、默认偏好和系统维护相关设置，不承担任务承接和结果查看职责。 + +**负责内容：** + +- 桌面入口行为 +- 主动协助与感知开关 +- 记忆启用与生命周期 +- 自动化与巡检基础设置 +- 默认结果位置 +- 成本与预算设置 +- 数据清理与恢复默认 + +**设计原则：** + +- 低频使用 +- 不打扰主流程 +- 与仪表盘职责分离 +- 高风险设置需明确确认 + +### 仪表盘首页补充机制：高价值信息球 + +**系统映射：** 仪表盘首页焦点区 / 首页召回提示机制 + +**定位说明：** +高价值信息球不是独立一级模块，而是仪表盘首页的一种优先级展示与召回机制。用户打开仪表盘时，系统可按优先级弹出当前最值得关注的信息，帮助用户快速知道“现在最应该看什么”。 + +**展示内容：** + +- 简略的事件描述 +- 简略的任务执行状态 +- 查看详情的提醒 +- 取消或稍后处理入口 + +**设计要求：** + +- 必须从属于仪表盘首页，不独立成新的业务层 +- 不与首页焦点区、任务状态卡片重复造层 +- 用于召回最值得先看的内容，而不是承接完整详情 + +------ + +## 9. 效果评估与数据统计 + +### 9.1 核心数据看板 + +| 数据指标 | 统计维度 | 采集方式 | +| -------------- | ------------ | ------------------------------ | +| 悬浮球交互率 | 日 / 周 / 月 | 单击、长按、悬停、拖拽等事件 | +| 任务发起率 | 日 / 周 | 协作任务创建事件 | +| 任务完成率 | 日 / 周 | 任务状态流转事件 | +| 任务推进率 | 周 | 获得结果后继续下一步动作的比例 | +| 便签转任务率 | 周 | 事项正式交给 Agent 推进的比例 | +| 主动提示接受率 | 周 | 主动提示点击 / 展示 | +| 镜子模块回看率 | 周 / 月 | 镜子模块访问事件 | +| 待确认处理率 | 日 / 周 | 待确认项被处理的比例 | +| 恢复点使用率 | 周 / 月 | 恢复动作事件 | +| 资源消耗可见率 | 周 | 用户查看成本 / 预算信息的比例 | + +### 9.2 核心验证指标 + +| 目标维度 | 指标 | 判断方向 | +| -------- | ---------------------------------------------- | ---------------------- | +| 发起效率 | 文本选中后继续协作率、文件拖拽发起率 | 验证入口是否自然 | +| 协作效率 | 任务完成率、任务推进率 | 验证是否不只停留在回答 | +| 长期价值 | 镜子回看率、个性化结果认可度 | 验证长期协作是否成立 | +| 信任治理 | 高风险确认通过率、恢复点使用率、风险可控感评分 | 验证是否建立信任 | + +补充建议指标： + +- 长按通话率 +- 双击打开仪表盘率 +- 主动提示后继续协作率 +- 单任务平均 Token / 成本 +- 中断后恢复率 + +------ + +## 10. 性能与安全性等非功能性需求 + +### 10.1 性能要求 + +| 指标 | 目标要求 | +| -------------- | ------------------------------------ | +| 悬浮球可接近性 | 应始终快速可触达，不可因复杂状态阻塞 | +| 轻量反馈速度 | 应尽可能即时出现 | +| 长任务反馈 | 必须明确展示处理中状态 | +| 结果分流体验 | 长结果不得阻塞气泡区与轻量输入 | +| 仪表盘理解效率 | 用户打开后 10 秒内应能定位最重要信息 | + +### 10.2 安全性要求 + +| 安全领域 | 具体要求 | +| -------- | -------------------------------------------- | +| 风险控制 | 高风险动作必须进入确认流 | +| 边界管理 | 系统必须明确说明会改什么、影响什么、能否撤回 | +| 审计能力 | 重要动作必须可查、可追踪 | +| 恢复能力 | 中断和失败后必须提供恢复或回退信息 | +| 成本透明 | 当前任务与今日累计资源消耗必须可见 | +| 记忆管理 | 用户必须可查看、删除、关闭或纠正长期记忆 | + +### 10.3 可用性要求 + +| 场景 | 处理方式 | +| ------------------ | ------------------------------------------------------ | +| 用户不想被打扰 | 主动协助可关闭，且支持免打扰策略 | +| 用户看不懂系统状态 | 首页、仪表盘首页召回提示和任务卡必须用直白状态语言表达 | +| 任务被阻塞 | 必须明确说明缺什么、卡在哪，而不是只显示失败 | +| 任务完成 | 必须能直接看到成果、打开结果或进入下一步 | \ No newline at end of file From eed4f17967f4ebd4a53f7736cc71525c949c8d05 Mon Sep 17 00:00:00 2001 From: gdemonc <1502689916@qq.com> Date: Tue, 14 Apr 2026 18:42:20 +0800 Subject: [PATCH 2/6] docs: delete something --- docs/product-requriement-document.md | 90 ++++++++++++++-------------- 1 file changed, 45 insertions(+), 45 deletions(-) diff --git a/docs/product-requriement-document.md b/docs/product-requriement-document.md index bc683db38..27528d6da 100644 --- a/docs/product-requriement-document.md +++ b/docs/product-requriement-document.md @@ -96,24 +96,24 @@ CialloClaw 不只负责给出解释和总结，还应帮助用户明确下一步 ------ -## 4. 需求变更说明 - -本文档为最终版总纲 PRD。其目标是在一份文档内完整说明产品定位、目标、模块边界、核心规则和需求范围，使其能够独立成立并作为后续设计、交互、实现和评审的统一上位依据。 - -| 版本 | 日期 | 变更内容 | -| ---- | ---------- | ------------------------------------------------------------ | -| v1.0 | 2026-04-05 | 初版 PRD，明确产品定位、目标用户、核心问题、产品原则与整体交互主线，建立“桌面常驻入口 + 轻量承接 + 仪表盘 + 可控执行”的基础框架。 | -| v1.1 | 2026-04-05 | 在初版基础上细化产品形态与整体交互，补充悬浮球、语音、气泡、仪表盘四层结构，以及单击、双击、长按、悬停、拖拽、文本选中的入口语义，强化“主动输入 / 主动协助”双闭环。 | -| v1.2 | 2026-04-05 | 补充差异化能力目标与能力边界，新增开箱即用原则、多模型与插件接入、自动化任务、屏幕 / 硬件感知、执行沙盒、中断恢复与成本熔断等内容，增强产品的长期协作与可控执行能力。 | -| v1.3 | 2026-04-05 | 在既有 PRD 基础上进一步向架构承接过渡，明确产品分层、模块职责、信息流、状态流、页面承接关系、能力边界及 MVP 承接范围。 | -| v1.4 | 2026-04-05 | 进一步强化任务系统、记忆系统与安全治理体系，补充任务状态流、记忆分层与读写规则、风险分级、结果分层交付及指标验证思路。 | -| v2.0 | 2026-04-06 | 在原版基础上补充已明确的模块设计与交互承接，强化待办管家、任务状态 / 任务巡检分工、安全卫士、恢复回滚、授权审计、费用治理等模块内容。 | -| v2.1 | 2026-04-06 | 在上一版基础上继续补充能力扩展与自动协助逻辑，增强任务巡检的自动推进能力，并增加视频总结、长内容理解等场景能力。 | -| v3.0 | 2026-04-13 | 按 PRD 模板重构章节结构，统一为产品表达版，整合前序内容并吸收已明确的产品模块关系，形成更标准化的总纲文档。 | -| v3.1 | 2026-04-13 | 为 v3.0 瘦身，保留产品定义、模块边界和关键规则，把字段清单、按钮穷举、说明书式段落压缩掉。 | -| v3.2 | 2026-04-14 | 在 v3.1 结构基础上，进一步补齐交互原则、能力边界与模块补充，沉淀为总纲版 PRD。 | -| v3.3 | 2026-04-14 | 收敛模块命名口径，明确悬浮球、气泡区与轻量输入、仪表盘、控制面板等核心对象，降低产品表达与实现表达的歧义。 | -| v3.4 | 2026-04-14 | 作为总纲最终版完成整理：保留优先级管理，但统一落在模块 / 能力层；将高价值信息球并入仪表盘首页机制；按“用户可见模块 + 系统映射”重写需求详情，使文档可独立作为完整 PRD 使用。 | +## ~~4. 需求变更说明~~ + +~~本文档为最终版总纲 PRD。其目标是在一份文档内完整说明产品定位、目标、模块边界、核心规则和需求范围，使其能够独立成立并作为后续设计、交互、实现和评审的统一上位依据。~~ + +| ~~版本~~ | ~~日期~~ | ~~变更内容~~ | +| -------- | -------------- | ------------------------------------------------------------ | +| ~~v1.0~~ | ~~2026-04-05~~ | ~~初版 PRD，明确产品定位、目标用户、核心问题、产品原则与整体交互主线，建立“桌面常驻入口 + 轻量承接 + 仪表盘 + 可控执行”的基础框架。~~ | +| ~~v1.1~~ | ~~2026-04-05~~ | ~~在初版基础上细化产品形态与整体交互，补充悬浮球、语音、气泡、仪表盘四层结构，以及单击、双击、长按、悬停、拖拽、文本选中的入口语义，强化“主动输入 / 主动协助”双闭环。~~ | +| ~~v1.2~~ | ~~2026-04-05~~ | ~~补充差异化能力目标与能力边界，新增开箱即用原则、多模型与插件接入、自动化任务、屏幕 / 硬件感知、执行沙盒、中断恢复与成本熔断等内容，增强产品的长期协作与可控执行能力。~~ | +| ~~v1.3~~ | ~~2026-04-05~~ | ~~在既有 PRD 基础上进一步向架构承接过渡，明确产品分层、模块职责、信息流、状态流、页面承接关系、能力边界及 MVP 承接范围。~~ | +| ~~v1.4~~ | ~~2026-04-05~~ | ~~进一步强化任务系统、记忆系统与安全治理体系，补充任务状态流、记忆分层与读写规则、风险分级、结果分层交付及指标验证思路。~~ | +| ~~v2.0~~ | ~~2026-04-06~~ | ~~在原版基础上补充已明确的模块设计与交互承接，强化待办管家、任务状态 / 任务巡检分工、安全卫士、恢复回滚、授权审计、费用治理等模块内容。~~ | +| ~~v2.1~~ | ~~2026-04-06~~ | ~~在上一版基础上继续补充能力扩展与自动协助逻辑，增强任务巡检的自动推进能力，并增加视频总结、长内容理解等场景能力。~~ | +| ~~v3.0~~ | ~~2026-04-13~~ | ~~按 PRD 模板重构章节结构，统一为产品表达版，整合前序内容并吸收已明确的产品模块关系，形成更标准化的总纲文档。~~ | +| ~~v3.1~~ | ~~2026-04-13~~ | ~~为 v3.0 瘦身，保留产品定义、模块边界和关键规则，把字段清单、按钮穷举、说明书式段落压缩掉。~~ | +| ~~v3.2~~ | ~~2026-04-14~~ | ~~在 v3.1 结构基础上，进一步补齐交互原则、能力边界与模块补充，沉淀为总纲版 PRD。~~ | +| ~~v3.3~~ | ~~2026-04-14~~ | ~~收敛模块命名口径，明确悬浮球、气泡区与轻量输入、仪表盘、控制面板等核心对象，降低产品表达与实现表达的歧义。~~ | +| ~~v3.4~~ | ~~2026-04-14~~ | ~~作为总纲最终版完成整理：保留优先级管理，但统一落在模块 / 能力层；将高价值信息球并入仪表盘首页机制；按“用户可见模块 + 系统映射”重写需求详情，使文档可独立作为完整 PRD 使用。~~ | ------ @@ -151,36 +151,36 @@ CialloClaw 不只负责给出解释和总结，还应帮助用户明确下一步 | 自动化与扩展 | 周期巡检、定时任务、插件 / Skills、模型路由 | P2 | | 高阶理解与能力扩展 | 视频总结、长内容理解、多模型协同 | P2-P3 | -### 5.3 版本范围说明 +### ~~5.3 优先级说明~~ -**P0：主链路能力** +~~**P0：主链路能力**~~ -- 悬浮球 -- 气泡区与轻量输入 -- 内容理解 -- 任务推进 -- 任务状态模块 -- 便签协作模块 -- 镜子模块概览能力 -- 安全卫士最小闭环 -- 仪表盘首页 +- ~~悬浮球~~ +- ~~气泡区与轻量输入~~ +- ~~内容理解~~ +- ~~任务推进~~ +- ~~任务状态模块~~ +- ~~便签协作模块~~ +- ~~镜子模块概览能力~~ +- ~~安全卫士最小闭环~~ +- ~~仪表盘首页~~ -**P1：增强型管理能力** +~~**P1：增强型管理能力**~~ -- 控制面板 -- 便签协作增强 -- 恢复详情 -- 记忆管理增强 -- 自动化基础设置 +- ~~控制面板~~ +- ~~便签协作增强~~ +- ~~恢复详情~~ +- ~~记忆管理增强~~ +- ~~自动化基础设置~~ -**P2-P3：扩展型能力** +~~**P2-P3：扩展型能力**~~ -- 高阶主动协助 -- 视频总结 -- 长内容理解增强 -- 多模型协同 -- 插件 / Skills 生态 -- 更复杂的自动化执行能力 +- ~~高阶主动协助~~ +- ~~视频总结~~ +- ~~长内容理解增强~~ +- ~~多模型协同~~ +- ~~插件 / Skills 生态~~ +- ~~更复杂的自动化执行能力~~ ### 5.4 核心功能逻辑 @@ -213,9 +213,9 @@ flowchart TD ------ -## 6. 产品架构 +## ~~6. 流程图~~ -### 6.1 用户可见模块流程图 +### ~~6.1 用户可见模块流程图~~ ```mermaid flowchart TD @@ -239,7 +239,7 @@ flowchart TD K --> K4[安全卫士模块] ``` -### 6.2 功能架构图（信息架构图） +### ~~6.2 功能架构图（信息架构图）~~ ```mermaid graph TD From 68e8080d25e204341056f34f9a6916cd87b38405 Mon Sep 17 00:00:00 2001 From: gdemonc <1502689916@qq.com> Date: Tue, 14 Apr 2026 19:31:19 +0800 Subject: [PATCH 3/6] docs: Update the product requirements document: revise the version number and status, and remove redundant sections. --- docs/product-requriement-document.md | 290 +++++++++++---------------- 1 file changed, 121 insertions(+), 169 deletions(-) diff --git a/docs/product-requriement-document.md b/docs/product-requriement-document.md index 27528d6da..44bda813a 100644 --- a/docs/product-requriement-document.md +++ b/docs/product-requriement-document.md @@ -3,8 +3,8 @@ | 文档信息 | | | -------- | ---------------------- | | 产品名称 | CialloClaw | -| 文档版本 | v3.4 | -| 文档状态 | 最终版 | +| 文档版本 | v3.5 | +| 文档状态 | 整理版 | | 创建日期 | 2026-04-14 | | 目标平台 | Windows / macOS 桌面端 | | 产品定位 | 桌面常驻协作型 Agent | @@ -96,30 +96,9 @@ CialloClaw 不只负责给出解释和总结，还应帮助用户明确下一步 ------ -## ~~4. 需求变更说明~~ - -~~本文档为最终版总纲 PRD。其目标是在一份文档内完整说明产品定位、目标、模块边界、核心规则和需求范围，使其能够独立成立并作为后续设计、交互、实现和评审的统一上位依据。~~ - -| ~~版本~~ | ~~日期~~ | ~~变更内容~~ | -| -------- | -------------- | ------------------------------------------------------------ | -| ~~v1.0~~ | ~~2026-04-05~~ | ~~初版 PRD，明确产品定位、目标用户、核心问题、产品原则与整体交互主线，建立“桌面常驻入口 + 轻量承接 + 仪表盘 + 可控执行”的基础框架。~~ | -| ~~v1.1~~ | ~~2026-04-05~~ | ~~在初版基础上细化产品形态与整体交互，补充悬浮球、语音、气泡、仪表盘四层结构，以及单击、双击、长按、悬停、拖拽、文本选中的入口语义，强化“主动输入 / 主动协助”双闭环。~~ | -| ~~v1.2~~ | ~~2026-04-05~~ | ~~补充差异化能力目标与能力边界，新增开箱即用原则、多模型与插件接入、自动化任务、屏幕 / 硬件感知、执行沙盒、中断恢复与成本熔断等内容，增强产品的长期协作与可控执行能力。~~ | -| ~~v1.3~~ | ~~2026-04-05~~ | ~~在既有 PRD 基础上进一步向架构承接过渡，明确产品分层、模块职责、信息流、状态流、页面承接关系、能力边界及 MVP 承接范围。~~ | -| ~~v1.4~~ | ~~2026-04-05~~ | ~~进一步强化任务系统、记忆系统与安全治理体系，补充任务状态流、记忆分层与读写规则、风险分级、结果分层交付及指标验证思路。~~ | -| ~~v2.0~~ | ~~2026-04-06~~ | ~~在原版基础上补充已明确的模块设计与交互承接，强化待办管家、任务状态 / 任务巡检分工、安全卫士、恢复回滚、授权审计、费用治理等模块内容。~~ | -| ~~v2.1~~ | ~~2026-04-06~~ | ~~在上一版基础上继续补充能力扩展与自动协助逻辑，增强任务巡检的自动推进能力，并增加视频总结、长内容理解等场景能力。~~ | -| ~~v3.0~~ | ~~2026-04-13~~ | ~~按 PRD 模板重构章节结构，统一为产品表达版，整合前序内容并吸收已明确的产品模块关系，形成更标准化的总纲文档。~~ | -| ~~v3.1~~ | ~~2026-04-13~~ | ~~为 v3.0 瘦身，保留产品定义、模块边界和关键规则，把字段清单、按钮穷举、说明书式段落压缩掉。~~ | -| ~~v3.2~~ | ~~2026-04-14~~ | ~~在 v3.1 结构基础上，进一步补齐交互原则、能力边界与模块补充，沉淀为总纲版 PRD。~~ | -| ~~v3.3~~ | ~~2026-04-14~~ | ~~收敛模块命名口径，明确悬浮球、气泡区与轻量输入、仪表盘、控制面板等核心对象，降低产品表达与实现表达的歧义。~~ | -| ~~v3.4~~ | ~~2026-04-14~~ | ~~作为总纲最终版完成整理：保留优先级管理，但统一落在模块 / 能力层；将高价值信息球并入仪表盘首页机制；按“用户可见模块 + 系统映射”重写需求详情，使文档可独立作为完整 PRD 使用。~~ | +## 4. 功能清单 ------- - -## 5. 功能清单 - -### 5.1 用户需求及对应功能点 +### 4.1 用户需求及对应功能点 | 用户需求 | 对应功能点 | 优先级 | | -------------------------------------------------- | --------------------------------------------- | ------ | @@ -134,7 +113,7 @@ CialloClaw 不只负责给出解释和总结，还应帮助用户明确下一步 | 希望能启用或关闭主动协助、记忆、预算等全局行为 | 控制面板、记忆策略、主动协助、预算设置 | P1 | | 希望系统支持更多自动化与扩展能力 | 自动化设置、平台扩展、模型路由、插件 / Skills | P2 | -### 5.2 功能模块总览 +### 4.2 功能模块总览 | 功能模块 | 功能项 | 优先级 | | ------------------ | ---------------------------------------------------- | ------ | @@ -142,47 +121,47 @@ CialloClaw 不只负责给出解释和总结，还应帮助用户明确下一步 | 气泡区与轻量输入 | 短结果、轻提示、补充输入、意图确认 | P0 | | 内容理解 | 总结、翻译、解释、错误分析、重点提炼 | P0 | | 任务推进 | 下一步建议、草稿生成、资料入口、阻塞解释 | P0 | +| 仪表盘首页 | 首页焦点区、任务总览、首页优先级召回入口 | P0 | +| 高价值信息球 | 首页内优先级召回、待处理提醒、快速跳转详情 | P0-P1 | | 任务状态模块 | 进行中 / 等待中 / 异常中 / 已结束任务查看与管理 | P0 | -| 便签协作模块 | 近期要做、后续安排、重复事项、已结束事项 | P0 | -| 镜子模块 | 历史概要、阶段总结、用户画像、记忆管理 | P0 | -| 安全卫士模块 | 风险分级、待确认项、授权记录、恢复与费用 | P0 | -| 仪表盘首页 | 焦点区、任务总览、首页高价值召回机制 | P0 | +| 便签协作模块 | 近期要做、后续安排、重复事项、已结束事项 | P0-P1 | +| 镜子模块 | 历史概要、阶段总结、用户画像、记忆管理 | P1 | +| 安全卫士模块 | 风险分级、待确认项、授权记录、恢复与费用 | P0-P1 | | 控制面板 | 全局行为、记忆策略、主动协助、预算与默认结果位置设置 | P1 | | 自动化与扩展 | 周期巡检、定时任务、插件 / Skills、模型路由 | P2 | | 高阶理解与能力扩展 | 视频总结、长内容理解、多模型协同 | P2-P3 | -### ~~5.3 优先级说明~~ +### 4.3 优先级说明 + +本节不重复列出具体功能清单，而用于说明本文档为何采用当前优先级划分方式，以及不同优先级背后的判断标准。 -~~**P0：主链路能力**~~ +**优先级划分原则：** -- ~~悬浮球~~ -- ~~气泡区与轻量输入~~ -- ~~内容理解~~ -- ~~任务推进~~ -- ~~任务状态模块~~ -- ~~便签协作模块~~ -- ~~镜子模块概览能力~~ -- ~~安全卫士最小闭环~~ -- ~~仪表盘首页~~ +1. **是否直接影响主链路成立** + 优先保证用户能够完成“发起协作 → 获得结果 → 继续推进任务”的完整闭环。凡是直接决定主链路能否成立的能力，应优先进入更高优先级。 -~~**P1：增强型管理能力**~~ +2. **是否决定产品的第一认知与第一体验** + 用户首次接触产品时，最先感知到的是入口是否自然、反馈是否及时、当前状态是否清楚。因此，直接影响首轮体验与产品成立感的能力，应优先保障。 -- ~~控制面板~~ -- ~~便签协作增强~~ -- ~~恢复详情~~ -- ~~记忆管理增强~~ -- ~~自动化基础设置~~ +3. **是否承担系统级承接职责** + 某些模块虽然不是单点功能，但承担统一承接、统一聚合、统一管理的作用。这类能力会影响整体结构稳定性，因此优先级通常高于纯增强型能力。 -~~**P2-P3：扩展型能力**~~ +4. **是否属于增强理解、增强治理或增强个性化能力** + 这类能力能够显著提升长期价值，但不会阻断产品最小闭环成立，因此可以放在主链路之后，按阶段逐步完善。 -- ~~高阶主动协助~~ -- ~~视频总结~~ -- ~~长内容理解增强~~ -- ~~多模型协同~~ -- ~~插件 / Skills 生态~~ -- ~~更复杂的自动化执行能力~~ +5. **是否依赖更复杂的系统能力或更高实现成本** + 涉及自动化、多模型协同、复杂执行、长内容理解等能力，往往依赖更高的工程复杂度、治理成本或验证周期，因此应后置处理。 -### 5.4 核心功能逻辑 +**各优先级的含义：** + +- **P0**：用于保证产品最小可用闭环成立，是首版必须具备的能力。 +- **P0-P1**：与主链路高度相关，建议尽早纳入，但可根据实现复杂度分阶段补齐。 +- **P1**：不决定首版是否可用，但会显著影响管理体验、长期协作体验与系统可控感。 +- **P2**：属于效率增强或扩展能力，应在核心体验稳定后逐步引入。 +- **P2-P3**：属于高阶能力探索，更多服务于差异化提升与长期演进，不应抢占首版资源。 + + +### 4.4 核心功能逻辑 CialloClaw 的核心运行逻辑可归纳为一条统一的“**现场识别 → 理解判断 → 结果交付 → 任务推进 → 长期沉淀**”链路： @@ -205,80 +184,17 @@ flowchart TD **关键设计决策：** -- 产品主入口是悬浮球，而不是聊天窗口 -- 轻量结果优先在当前任务现场附近交付，长结果自动分流到正式交付层 +- 产品主入口是悬浮球，而非聊天窗口 +- 轻量结果优先在当前任务现场附近交付，长结果自动分流至正式交付层 - “便签协作”与“任务状态”严格区分：前者是未来安排，后者是已被 Agent 接手推进的工作 -- 高风险动作必须进入确认流，不允许在黑箱中直接执行 +- 高风险动作必须进入确认流，不允许以黑箱方式直接执行 - 长期记忆必须对用户可见、可管理、可纠正 ------ -## ~~6. 流程图~~ - -### ~~6.1 用户可见模块流程图~~ - -```mermaid -flowchart TD - Start[悬浮球待机] --> Trigger{用户发起 / 系统识别帮助机会} - Trigger --> A[气泡区与轻量输入] - A --> B{结果类型判断} - B --> C[轻量结果返回] - B --> D[正式结果交付] - B --> E[进入任务推进] - E --> F{是否涉及风险动作} - F -- 否 --> G[继续推进或完成] - F -- 是 --> H[等待确认] - H --> I[执行 / 拒绝 / 修改] - G --> J[写入历史与状态] - I --> J - Start --> K[打开仪表盘] - K --> K0[仪表盘首页] - K --> K1[任务状态模块] - K --> K2[便签协作模块] - K --> K3[镜子模块] - K --> K4[安全卫士模块] -``` - -### ~~6.2 功能架构图（信息架构图）~~ - -```mermaid -graph TD - Root[CialloClaw 功能架构] - - Root --> A[近场交互层] - Root --> B[仪表盘] - Root --> C[控制面板] - Root --> D[核心能力系统] - - A --> A1[悬浮球] - A --> A2[气泡区] - A --> A3[轻量输入] - A --> A4[当前任务对象承接] - - B --> B0[仪表盘首页] - B --> B1[任务状态模块] - B --> B2[便签协作模块] - B --> B3[镜子模块] - B --> B4[安全卫士模块] - B --> B5[首页高价值召回机制] - - C --> C1[入口与外观设置] - C --> C2[记忆与主动协助设置] - C --> C3[自动化与预算设置] - C --> C4[结果位置与数据清理] - - D --> D1[内容理解] - D --> D2[任务推进] - D --> D3[长期记忆] - D --> D4[执行与自动化] - D --> D5[安全与治理] -``` - ------- - -## 7. 通用规则 +## 5. 通用规则 -### 7.1 全局运行策略 +### 5.1 全局运行策略 | 场景 | 策略 | | ------------ | ---------------------------------------------------------- | @@ -289,7 +205,7 @@ graph TD | 风险动作 | 统一进入风险分级和授权确认链路 | | 中断与失败 | 必须告诉用户卡在哪一步、是否有恢复点、能否重试 | -### 7.2 文案展示通用规则 +### 5.2 文案展示通用规则 | 规则项 | 说明 | | ------------ | ---------------------------------------------- | @@ -299,27 +215,27 @@ graph TD | 风险说明 | 必须具体说明会改什么、影响什么、能否撤回 | | 主动提示频率 | 必须克制，避免在用户无操作或离开时高频打扰 | -### 7.3 名称定义说明 +### 5.3 名称定义说明 以下术语为正式命名。括号仅在首次出现时用于术语映射或能力澄清，后续正文不重复使用解释性括号。 -| 术语 | 定义 | -| ------------------ | -------------------------------------------------------- | -| 悬浮球 | 桌面常驻入口，用户接近 CialloClaw 的默认近场入口 | -| 气泡区 | 当前任务现场附近的短结果、轻提示与状态反馈承接层 | -| 轻量输入 | 围绕当前对象的一句话补充输入与意图确认入口 | -| 仪表盘 | 任务状态、便签协作、镜子、安全卫士的统一工作台 | -| 控制面板 | 低频全局设置与系统策略入口，不承担任务承接和结果查看职责 | -| 任务 | 已经被 Agent 接手并正在推进的工作 | -| 便签协作 | 未来安排、周期事项和可转交给 Agent 的异步协作入口 | -| 镜子 | 系统对历史、偏好、总结和长期理解的显性表达层 | -| 安全卫士 | 风险、授权、恢复、审计、成本的解释与接管层 | -| 首页高价值召回机制 | 用户打开仪表盘时，系统按优先级提示当前最值得关注的信息 | -| 正式交付 | 文档、结果页、任务详情、文件等可继续消费和回看的结果 | +| 术语 | 定义 | +| ------------ | ------------------------------------------------------------ | +| 悬浮球 | 桌面常驻入口，用户接近 CialloClaw 的默认近场入口 | +| 气泡区 | 当前任务现场附近的短结果、轻提示与状态反馈承接层 | +| 轻量输入 | 围绕当前对象的一句话补充输入与意图确认入口 | +| 仪表盘 | 承载首页、高价值信息球、任务状态、便签协作、镜子、安全卫士的统一工作台 | +| 控制面板 | 低频全局设置与系统策略入口，不承担任务承接与结果查看职责 | +| 任务 | 已经被 Agent 接手并正在推进的工作 | +| 便签协作 | 未来安排、周期事项和可转交给 Agent 的异步协作入口 | +| 镜子 | 系统对历史、偏好、总结和长期理解的显性表达层 | +| 安全卫士 | 风险、授权、恢复、审计、成本的解释与接管层 | +| 高价值信息球 | 仪表盘首页中的优先级召回机制，用于提示当前最值得关注的信息 | +| 正式交付 | 文档、结果页、任务详情、文件等可继续消费和回看的结果 | ------ -## 8. 需求详情说明 +## 6. 需求详情说明 ### 模块 1：悬浮球与气泡区 @@ -361,7 +277,51 @@ graph TD - 生命周期可控，可隐藏、恢复、置顶、删除 - 一旦内容超出承载范围，必须自动分流到正式交付层 -### 模块 2：任务状态模块 +### 模块 2：仪表盘 + +**系统映射：** 统一工作台，承接首页、高价值信息球、任务状态、便签协作、镜子与安全卫士 + +**模块定位：** +仪表盘是产品的统一工作台。它不是单一页面，而是用户查看当前进展、理解系统状态、管理异步协作、回看长期沉淀以及处理风险确认的主阵地。所有需要“回看、管理、判断、接管”的内容，都应收口到仪表盘内部完成。首页与任务状态属于主链路优先级，镜子、安全卫士增强项与高价值召回机制可按阶段逐步完善。 + +**仪表盘整体职责：** + +- 聚合当前最值得关注的信息 +- 统一承接任务、事项、记忆与安全治理信息 +- 让用户在一个工作台内完成查看、确认、调整与接管 +- 提供从首页预览到详情管理的清晰层级 +- 避免各模块分散漂浮，降低理解和操作成本 + +#### 2.1 仪表盘首页与高价值信息球 + +**系统映射：** 仪表盘首页焦点区 / 首页召回提示机制 + +**定位说明：** +仪表盘首页负责在用户打开产品后第一时间回答三个问题：现在最该看什么、哪里需要我介入、哪些事情可以继续推进。高价值信息球从属于首页焦点区，是首页的优先级召回机制，而不是独立一级业务模块。 + +**首页应承载的内容：** + +- 当前最值得优先关注的信息 +- 关键任务的简要状态 +- 待确认或待处理事项摘要 +- 最近一次重要产出或异常摘要 +- 进入详情页的明确入口 + +**高价值信息球展示内容：** + +- 简略的事件描述 +- 简略的任务执行状态 +- 查看详情的提醒 +- 取消或稍后处理入口 + +**设计要求：** + +- 必须从属于仪表盘首页，不独立成新的业务层 +- 不与首页焦点区、任务状态卡片重复造层 +- 用于召回最值得先看的内容，而不是承接完整详情 +- 页面语言必须帮助用户快速判断“是否需要立即处理” + +#### 2.2 任务状态模块 **系统映射：** 仪表盘中的任务状态工作区 @@ -403,7 +363,7 @@ graph TD - 异常中：失败、阻塞、执行异常 - 已结束：已完成、已取消、已结束未完成 -### 模块 3：便签协作模块 +#### 2.3 便签协作模块 **系统映射：** 仪表盘中的便签协作工作区 @@ -423,7 +383,7 @@ graph TD - 待办转任务：用户确认后，直接生成任务并跳转到任务状态页 - 流程化建议：反复延期或频繁出现时，提示整理成固定流程或模板 -### 模块 4：镜子模块 +#### 2.4 镜子模块 **系统映射：** 仪表盘中的镜子工作区 @@ -450,7 +410,7 @@ graph TD - 支持短期记忆、长期记忆、任务级记忆分层 - 周期性总结要对用户可见、可验证、可管理 -### 模块 5：安全卫士模块 +#### 2.5 安全卫士模块 **系统映射：** 仪表盘中的安全与治理工作区 @@ -495,12 +455,12 @@ graph TD - 一键中断与恢复 - 任务工作区级回滚与项目级快照恢复的预留设计 -### 模块 6：控制面板 +### 模块 3：控制面板 **系统映射：** 全局设置与系统策略入口 **模块定位：** -控制面板是 CialloClaw 的低频配置入口，用于承接全局行为、默认偏好和系统维护相关设置，不承担任务承接和结果查看职责。 +控制面板是 CialloClaw 的低频配置入口，用于承接全局行为、默认偏好和系统维护相关设置，不承担任务承接与结果查看职责。 **负责内容：** @@ -519,31 +479,23 @@ graph TD - 与仪表盘职责分离 - 高风险设置需明确确认 -### 仪表盘首页补充机制：高价值信息球 +### 模块补充：系统能力说明 -**系统映射：** 仪表盘首页焦点区 / 首页召回提示机制 - -**定位说明：** -高价值信息球不是独立一级模块，而是仪表盘首页的一种优先级展示与召回机制。用户打开仪表盘时，系统可按优先级弹出当前最值得关注的信息，帮助用户快速知道“现在最应该看什么”。 - -**展示内容：** - -- 简略的事件描述 -- 简略的任务执行状态 -- 查看详情的提醒 -- 取消或稍后处理入口 - -**设计要求：** +以下能力不作为独立一级页面模块存在，但会贯穿悬浮球、气泡区、正式交付层与仪表盘各处： -- 必须从属于仪表盘首页，不独立成新的业务层 -- 不与首页焦点区、任务状态卡片重复造层 -- 用于召回最值得先看的内容，而不是承接完整详情 +| 能力项 | 作用说明 | +| ------------ | ------------------------------------------------------------ | +| 内容理解 | 负责总结、翻译、解释、重点提炼、错误分析等基础理解能力 | +| 任务推进 | 负责下一步建议、草稿生成、资料打开、阻塞解释和推动事项继续前进 | +| 长期记忆 | 负责偏好沉淀、上下文继承、镜子内容生成与任务级记忆承接 | +| 执行与自动化 | 负责确认后执行、周期巡检、自动化任务、插件 / Skills 扩展 | +| 安全与治理 | 负责风险判断、授权确认、恢复回滚、审计与成本治理 | ------ -## 9. 效果评估与数据统计 +## 7. 效果评估与数据统计 -### 9.1 核心数据看板 +### 7.1 核心数据看板 | 数据指标 | 统计维度 | 采集方式 | | -------------- | ------------ | ------------------------------ | @@ -558,7 +510,7 @@ graph TD | 恢复点使用率 | 周 / 月 | 恢复动作事件 | | 资源消耗可见率 | 周 | 用户查看成本 / 预算信息的比例 | -### 9.2 核心验证指标 +### 7.2 核心验证指标 | 目标维度 | 指标 | 判断方向 | | -------- | ---------------------------------------------- | ---------------------- | @@ -577,9 +529,9 @@ graph TD ------ -## 10. 性能与安全性等非功能性需求 +## 8. 性能与安全性等非功能性需求 -### 10.1 性能要求 +### 8.1 性能要求 | 指标 | 目标要求 | | -------------- | ------------------------------------ | @@ -589,7 +541,7 @@ graph TD | 结果分流体验 | 长结果不得阻塞气泡区与轻量输入 | | 仪表盘理解效率 | 用户打开后 10 秒内应能定位最重要信息 | -### 10.2 安全性要求 +### 8.2 安全性要求 | 安全领域 | 具体要求 | | -------- | -------------------------------------------- | @@ -600,7 +552,7 @@ graph TD | 成本透明 | 当前任务与今日累计资源消耗必须可见 | | 记忆管理 | 用户必须可查看、删除、关闭或纠正长期记忆 | -### 10.3 可用性要求 +### 8.3 可用性要求 | 场景 | 处理方式 | | ------------------ | ------------------------------------------------------ | From a88ec84b213af218f96ce8acb0d1c1b312742d74 Mon Sep 17 00:00:00 2001 From: gdemonc <1502689916@qq.com> Date: Wed, 15 Apr 2026 13:28:54 +0800 Subject: [PATCH 4/6] chore(docs): Rename the incorrect filename. --- ...ent.md => product-requirement-document.md} | 47 +++++++++---------- 1 file changed, 22 insertions(+), 25 deletions(-) rename docs/{product-requriement-document.md => product-requirement-document.md} (96%) diff --git a/docs/product-requriement-document.md b/docs/product-requirement-document.md similarity index 96% rename from docs/product-requriement-document.md rename to docs/product-requirement-document.md index 44bda813a..aa11250f6 100644 --- a/docs/product-requriement-document.md +++ b/docs/product-requirement-document.md @@ -122,11 +122,10 @@ CialloClaw 不只负责给出解释和总结，还应帮助用户明确下一步 | 内容理解 | 总结、翻译、解释、错误分析、重点提炼 | P0 | | 任务推进 | 下一步建议、草稿生成、资料入口、阻塞解释 | P0 | | 仪表盘首页 | 首页焦点区、任务总览、首页优先级召回入口 | P0 | -| 高价值信息球 | 首页内优先级召回、待处理提醒、快速跳转详情 | P0-P1 | | 任务状态模块 | 进行中 / 等待中 / 异常中 / 已结束任务查看与管理 | P0 | -| 便签协作模块 | 近期要做、后续安排、重复事项、已结束事项 | P0-P1 | -| 镜子模块 | 历史概要、阶段总结、用户画像、记忆管理 | P1 | -| 安全卫士模块 | 风险分级、待确认项、授权记录、恢复与费用 | P0-P1 | +| 便签协作模块 | 近期要做、后续安排、重复事项、已结束事项 | P0 | +| 镜子模块 | 历史概要、阶段总结、用户画像、记忆管理 | P0 | +| 安全卫士模块 | 风险分级、待确认项、授权记录、恢复与费用 | P0 | | 控制面板 | 全局行为、记忆策略、主动协助、预算与默认结果位置设置 | P1 | | 自动化与扩展 | 周期巡检、定时任务、插件 / Skills、模型路由 | P2 | | 高阶理解与能力扩展 | 视频总结、长内容理解、多模型协同 | P2-P3 | @@ -155,12 +154,10 @@ CialloClaw 不只负责给出解释和总结，还应帮助用户明确下一步 **各优先级的含义：** - **P0**：用于保证产品最小可用闭环成立，是首版必须具备的能力。 -- **P0-P1**：与主链路高度相关，建议尽早纳入，但可根据实现复杂度分阶段补齐。 - **P1**：不决定首版是否可用，但会显著影响管理体验、长期协作体验与系统可控感。 - **P2**：属于效率增强或扩展能力，应在核心体验稳定后逐步引入。 - **P2-P3**：属于高阶能力探索，更多服务于差异化提升与长期演进，不应抢占首版资源。 - ### 4.4 核心功能逻辑 CialloClaw 的核心运行逻辑可归纳为一条统一的“**现场识别 → 理解判断 → 结果交付 → 任务推进 → 长期沉淀**”链路： @@ -219,19 +216,19 @@ flowchart TD 以下术语为正式命名。括号仅在首次出现时用于术语映射或能力澄清，后续正文不重复使用解释性括号。 -| 术语 | 定义 | -| ------------ | ------------------------------------------------------------ | -| 悬浮球 | 桌面常驻入口，用户接近 CialloClaw 的默认近场入口 | -| 气泡区 | 当前任务现场附近的短结果、轻提示与状态反馈承接层 | -| 轻量输入 | 围绕当前对象的一句话补充输入与意图确认入口 | +| 术语 | 定义 | +| ------------ | -------------------------------------------------------------- | +| 悬浮球 | 桌面常驻入口，用户接近 CialloClaw 的默认近场入口 | +| 气泡区 | 当前任务现场附近的短结果、轻提示与状态反馈承接层 | +| 轻量输入 | 围绕当前对象的一句话补充输入与意图确认入口 | | 仪表盘 | 承载首页、高价值信息球、任务状态、便签协作、镜子、安全卫士的统一工作台 | -| 控制面板 | 低频全局设置与系统策略入口，不承担任务承接与结果查看职责 | -| 任务 | 已经被 Agent 接手并正在推进的工作 | -| 便签协作 | 未来安排、周期事项和可转交给 Agent 的异步协作入口 | -| 镜子 | 系统对历史、偏好、总结和长期理解的显性表达层 | -| 安全卫士 | 风险、授权、恢复、审计、成本的解释与接管层 | -| 高价值信息球 | 仪表盘首页中的优先级召回机制，用于提示当前最值得关注的信息 | -| 正式交付 | 文档、结果页、任务详情、文件等可继续消费和回看的结果 | +| 控制面板 | 低频全局设置与系统策略入口，不承担任务承接与结果查看职责 | +| 任务 | 已经被 Agent 接手并正在推进的工作 | +| 便签协作 | 未来安排、周期事项和可转交给 Agent 的异步协作入口 | +| 镜子 | 系统对历史、偏好、总结和长期理解的显性表达层 | +| 安全卫士 | 风险、授权、恢复、审计、成本的解释与接管层 | +| 高价值信息球 | 仪表盘首页中的优先级召回机制，用于提示当前最值得关注的信息 | +| 正式交付 | 文档、结果页、任务详情、文件等可继续消费和回看的结果 | ------ @@ -483,13 +480,13 @@ flowchart TD 以下能力不作为独立一级页面模块存在，但会贯穿悬浮球、气泡区、正式交付层与仪表盘各处： -| 能力项 | 作用说明 | -| ------------ | ------------------------------------------------------------ | -| 内容理解 | 负责总结、翻译、解释、重点提炼、错误分析等基础理解能力 | +| 能力项 | 作用说明 | +| ------------ | ---------------------------------------------------------- | +| 内容理解 | 负责总结、翻译、解释、重点提炼、错误分析等基础理解能力 | | 任务推进 | 负责下一步建议、草稿生成、资料打开、阻塞解释和推动事项继续前进 | -| 长期记忆 | 负责偏好沉淀、上下文继承、镜子内容生成与任务级记忆承接 | -| 执行与自动化 | 负责确认后执行、周期巡检、自动化任务、插件 / Skills 扩展 | -| 安全与治理 | 负责风险判断、授权确认、恢复回滚、审计与成本治理 | +| 长期记忆 | 负责偏好沉淀、上下文继承、镜子内容生成与任务级记忆承接 | +| 执行与自动化 | 负责确认后执行、周期巡检、自动化任务、插件 / Skills 扩展 | +| 安全与治理 | 负责风险判断、授权确认、恢复回滚、审计与成本治理 | ------ @@ -559,4 +556,4 @@ flowchart TD | 用户不想被打扰 | 主动协助可关闭，且支持免打扰策略 | | 用户看不懂系统状态 | 首页、仪表盘首页召回提示和任务卡必须用直白状态语言表达 | | 任务被阻塞 | 必须明确说明缺什么、卡在哪，而不是只显示失败 | -| 任务完成 | 必须能直接看到成果、打开结果或进入下一步 | \ No newline at end of file +| 任务完成 | 必须能直接看到成果、打开结果或进入下一步 | From 8f41fd10c4edcbc1e31b0f241f7ae306d7fb5969 Mon Sep 17 00:00:00 2001 From: gdemonc <1502689916@qq.com> Date: Sat, 18 Apr 2026 13:58:24 +0800 Subject: [PATCH 5/6] docs: refine the product requirements document structure --- docs/product-requirement-document.md | 865 +++++++++++++++------------ 1 file changed, 472 insertions(+), 393 deletions(-) diff --git a/docs/product-requirement-document.md b/docs/product-requirement-document.md index aa11250f6..3f43e4e19 100644 --- a/docs/product-requirement-document.md +++ b/docs/product-requirement-document.md @@ -1,60 +1,83 @@ # CialloClaw 产品需求文档（PRD） -| 文档信息 | | -| -------- | ---------------------- | -| 产品名称 | CialloClaw | -| 文档版本 | v3.5 | -| 文档状态 | 整理版 | -| 创建日期 | 2026-04-14 | -| 目标平台 | Windows / macOS 桌面端 | -| 产品定位 | 桌面常驻协作型 Agent | +| 文档信息 | 内容 | +| -------- | ------------------------------------------ | +| 产品名称 | CialloClaw | +| 文档版本 | v4.0 | +| 文档状态 | 正式版 | +| 创建日期 | 2026-04-18 | +| 目标平台 | Windows / macOS 桌面端（首发优先 Windows） | +| 产品定位 | 桌面常驻协作型 Agent | ------ -## 1. 项目背景 +## 1. 文档定位 -当前桌面端用户在真实工作流中使用 Agent 时，长期存在三类未被良好满足的问题： +本文件是 CialloClaw 在开工前使用的 **产品总览 PRD**。 -**问题 A —— Agent 发起门槛高：** -用户通常需要先打开聊天窗口、进入某个工作区或组织 prompt，系统才开始理解需求。很多“本可以顺手发起”的帮助，最终因为路径太长而没有发生。 +它用于统一回答以下问题： + +- 为什么要做这个产品 +- 这个产品服务哪些用户 +- 用户会在什么场景下使用它 +- 产品整体由哪些能力和模块构成 +- 首版必须成立的最小闭环是什么 +- 后续版本如何分阶段推进 +- 如何判断产品是否成功 +- 产品必须满足哪些体验、安全与信任底线 + +本文件定义的是产品层目标、范围、原则和总览结构，不承担接口、数据结构、状态枚举、页面组件和实现时序的详细定义；这些内容由后续协议、交互、模块和实现文档继续展开。 + +------ + +## 2. 项目背景 + +当前桌面端用户在真实工作流中使用 Agent 时，长期存在三类未被良好满足的问题。 + +### 问题 A：发起门槛高 + +用户通常需要先打开聊天窗口、进入某个工作区或组织 prompt，系统才开始理解需求。很多本可以顺手发起的帮助，最终因为路径太长而没有发生。 + +### 问题 B：上下文迁移成本高 -**问题 B —— 上下文迁移成本高：** 用户需要手动复制网页、文档、报错、文件内容，再搬运到另一个产品中让 Agent 理解。帮助发生在任务现场之外，而不是围绕现场直接展开。 -**问题 C —— 执行不可信、长期价值不可见：** +### 问题 C：执行不可信、长期价值不可见 + 很多 Agent 可以给建议，但用户不敢交出执行权，因为不清楚它会改什么、保存到哪里、失败后能否恢复、为什么需要授权。同时，系统即便记住了偏好，也常以黑箱方式存在，难以形成长期协作信任。 -**市场机会：** -当前聊天型 AI 擅长问答，但不自然嵌入桌面任务现场；自动化工具能做事，但学习成本高、交互生硬；桌面小组件有入口，却缺乏持续协作能力。CialloClaw 希望填补这几类产品之间的空白：既不要求用户离开当前工作流，又能在可控边界内帮助理解、提醒、推进与有限执行。 +### 市场机会 + +当前聊天型 AI 擅长问答，但并不自然嵌入桌面任务现场；自动化工具能做事，但学习成本高、交互生硬；桌面小组件有入口，却缺乏持续协作能力。CialloClaw 希望填补这几类产品之间的空白：既不要求用户离开当前工作流，又能在可控边界内帮助理解、提醒、推进与有限执行。 + +### 产品机会 -**产品机会：** -用户真正需要的，不是一个“必须专门去使用”的 AI 工具，而是一个“在当前桌面现场中顺手出现、顺手帮忙、不会乱来”的协作对象。只要产品能同时解决“发起门槛、上下文承接、结果可消费、边界可理解”四个问题，就有机会形成长期使用习惯。 +用户真正需要的，不是一个“必须专门去打开使用”的 AI 工具，而是一个“在当前桌面现场中顺手出现、顺手帮忙、不会乱来”的协作对象。只要产品能同时解决“发起门槛、上下文承接、结果可消费、边界可理解”四个问题，就有机会形成长期使用习惯。 ------ -## 2. 项目目的 +## 3. 产品愿景与目标 -打造一款**面向真实桌面任务现场的常驻协作型 Agent 产品**，让用户在日常使用电脑时拥有一个： +### 3.1 产品愿景 + +打造一款 **面向真实桌面任务现场的常驻协作型 Agent 产品**，让用户在日常使用电脑时拥有一个： - 不必先进入聊天窗口即可发起协作的桌面入口 - 能围绕当前页面、文件、文本、任务和异常现场提供帮助的上下文助手 - 能从“理解内容”推进到“给出下一步、生成草稿、推动事项”的协作对象 - 能在明确边界内执行有限动作，并让用户清楚知道影响范围、恢复方式与资源消耗的可信系统 -补充原则： - -- 默认常驻，按需展开 -- 通话优先，文字补充 -- 上下文优先，聊天后置 -- 先提示，再确认，后执行 -- 高风险动作必须可控 -- 开箱即用优先 +### 3.2 产品定位 ------- +CialloClaw 不是一个以聊天框为中心的桌面 AI，而是一个： -## 3. 项目目标 +- 以桌面现场为默认入口 +- 以低打扰近场交互为主要承接方式 +- 以任务推进为核心价值 +- 以正式结果交付和可信治理建立长期信任 +- 以长期记忆和阶段总结提升持续协作价值 -### 3.1 产品目标 +### 3.3 产品目标 #### 目标一：降低桌面协作发起门槛 @@ -66,494 +89,550 @@ #### 目标三：从“回答问题”走向“推进任务” -CialloClaw 不只负责给出解释和总结，还应帮助用户明确下一步、生成草稿、打开资料、推动事项进入执行，并在必要时把未来安排转化为正在推进的任务。 +CialloClaw 不只负责给出解释和总结，还应帮助用户明确下一步、生成草稿、打开资料、推动事项进入执行，并在必要时把未来安排转化为持续推进的正式任务。 #### 目标四：建立长期协作与可控执行信任 系统应逐步形成对用户偏好、习惯、任务脉络的长期理解，并通过风险分级、授权确认、日志、恢复点、资源消耗可见等能力，建立“敢用、敢托付一点事”的信任基础。 -### 3.2 用户价值目标 +### 3.4 产品形态关键词 -| 目标维度 | 目标说明 | -| ---------- | -------------------------------------------- | -| 发起效率 | 用户在当前桌面现场发起协作的成本明显降低 | -| 上下文效率 | 用户补充背景与搬运内容的成本明显下降 | -| 推进效率 | 用户从“知道问题”到“进入下一步动作”的路径缩短 | -| 信任感 | 用户能理解系统边界、恢复方式和资源消耗 | -| 长期协作 | 用户能感知系统记住了什么，并从中获得持续价值 | +- 默认常驻，按需展开 +- 语音优先，文字补充 +- 上下文优先，聊天后置 +- 轻量承接，正式交付 +- 先提示，再确认，后执行 +- 高风险动作必须可控 +- 开箱即用优先 -### 3.3 产品成功标准 +------ -从最终产品视角，CialloClaw 需要稳定达成以下主观结果： +## 4. 目标用户与典型场景 -- 它总是在，但不烦 -- 我不必先去打开它，它就在当前任务附近 -- 它能看懂我正在做什么，不必让我重复解释 -- 它不只是说建议，还会帮我推进下一步 -- 它做事之前会让我明白边界 -- 我能知道它做了什么、花了什么、出了问题怎么退 -- 它越来越像一个熟悉我工作方式的协作者 +### 4.1 目标用户 + +| 用户类型 | 核心特征 | 主要痛点 | +| ----------------- | -------------------------------------- | ------------------------------ | +| 知识工作者 | 高频切换网页、文档、表格、IM、会议材料 | 上下文搬运成本高，任务容易断掉 | +| 开发者 / 技术用户 | 频繁处理报错、日志、代码片段、命令结果 | 需要快速解释问题并推进下一步 | +| 项目型协作者 | 管理长期事项、临期事项和重复事项 | 任务记录多，推进和提醒不连续 | + +### 4.2 典型使用场景 + +#### 场景一：文本现场理解 + +用户在网页、文档、聊天记录或代码片段中选中一段内容，希望立即获得解释、翻译、总结、提炼重点或改写建议。 + +#### 场景二：文件现场协作 + +用户将一个文件拖给 Agent，希望围绕该文件进行总结、分析、提炼、改写、生成草稿或得到下一步建议。 + +#### 场景三：错误与阻塞排查 + +用户遇到报错、异常页面、失败提示或阻塞信息时，希望快速知道原因、影响和下一步排查方向。 + +#### 场景四：即时表达需求 + +用户不想打字或无法精确组织 prompt，希望通过语音或一句话补充输入快速表达需求，让 Agent 先理解再推进。 + +#### 场景五：未来安排与任务推进 + +用户把未来要做的事情记录下来，希望系统在合适时机提醒、整理、给建议，并在必要时正式交给 Agent 推进。 + +#### 场景六：可信执行与结果回看 + +用户愿意让 Agent 做一点事，但前提是能看见边界、确认风险、知道结果在哪里、失败后如何恢复。 + +#### 场景七：长期协作 + +用户希望系统逐渐理解自己的习惯、偏好和工作节奏，但又要求这一切是可见、可纠正、可关闭的。 ------ -## 4. 功能清单 +## 5. 产品设计原则 + +### 原则一：桌面现场优先 + +产品优先围绕当前页面、选中文本、拖入文件、错误信息、待办事项和当前桌面上下文承接需求，而不是把聊天窗口作为默认主入口。 + +### 原则二：低摩擦发起优先 -### 4.1 用户需求及对应功能点 +用户应能够通过单击、长按、悬停、拖拽、选中等轻动作，在当前桌面现场顺手发起协作，而不是先打开另一个产品再组织需求。 -| 用户需求 | 对应功能点 | 优先级 | -| -------------------------------------------------- | --------------------------------------------- | ------ | -| 在当前页面、文本、文件上快速获得帮助 | 内容理解、总结、翻译、解释、重点提炼 | P0 | -| 遇到报错、阻塞或异常时获得原因和下一步建议 | 异常理解、任务推进建议、阻塞解释 | P0 | -| 把未来要做的事情整理起来，并在合适时机被提醒或推进 | 便签协作、临期识别、重复事项、Agent 建议 | P0 | -| 把某件事项正式交给 Agent 推进 | 便签转任务、任务状态模块、任务详情 | P0 | -| 了解当前任务做到哪一步、是否卡住、是否需要授权 | 任务状态模块、进度时间线、信任摘要 | P0 | -| 希望系统越来越懂自己，但又不想被黑箱记住 | 镜子模块、历史概要、用户画像、记忆管理 | P0 | -| 希望清楚知道系统会改什么、影响什么、能不能撤回 | 安全卫士、风险分级、恢复点、审计记录 | P0 | -| 需要一个稳定的桌面入口，而不是聊天窗口 | 悬浮球、气泡区与轻量输入、仪表盘 | P0 | -| 希望能启用或关闭主动协助、记忆、预算等全局行为 | 控制面板、记忆策略、主动协助、预算设置 | P1 | -| 希望系统支持更多自动化与扩展能力 | 自动化设置、平台扩展、模型路由、插件 / Skills | P2 | +### 原则三：语音优先，文字补充 -### 4.2 功能模块总览 +语音是产品的重要表达方式，适合自然描述、连续补充和低门槛发起；文字输入保留为精确补充、修正和静默场景下的重要入口。 -| 功能模块 | 功能项 | 优先级 | -| ------------------ | ---------------------------------------------------- | ------ | -| 悬浮球 | 常驻入口、状态提示、单击 / 双击 / 长按 / 悬停承接 | P0 | -| 气泡区与轻量输入 | 短结果、轻提示、补充输入、意图确认 | P0 | -| 内容理解 | 总结、翻译、解释、错误分析、重点提炼 | P0 | -| 任务推进 | 下一步建议、草稿生成、资料入口、阻塞解释 | P0 | -| 仪表盘首页 | 首页焦点区、任务总览、首页优先级召回入口 | P0 | -| 任务状态模块 | 进行中 / 等待中 / 异常中 / 已结束任务查看与管理 | P0 | -| 便签协作模块 | 近期要做、后续安排、重复事项、已结束事项 | P0 | -| 镜子模块 | 历史概要、阶段总结、用户画像、记忆管理 | P0 | -| 安全卫士模块 | 风险分级、待确认项、授权记录、恢复与费用 | P0 | -| 控制面板 | 全局行为、记忆策略、主动协助、预算与默认结果位置设置 | P1 | -| 自动化与扩展 | 周期巡检、定时任务、插件 / Skills、模型路由 | P2 | -| 高阶理解与能力扩展 | 视频总结、长内容理解、多模型协同 | P2-P3 | +### 原则四：轻量承接优先，长结果正式分流 -### 4.3 优先级说明 +短结果、轻提示、状态反馈和意图确认优先在悬浮球附近承接；长文本、结构化结果和连续任务结果应进入正式交付层，而不是把近场交互做成重聊天界面。 -本节不重复列出具体功能清单，而用于说明本文档为何采用当前优先级划分方式，以及不同优先级背后的判断标准。 +### 原则五：任务推进优先于纯回答 + +产品不只负责解释、翻译和总结，还应帮助用户明确下一步、生成草稿、打开相关资料、推动事项进入执行，并在必要时形成持续推进的正式任务。 + +### 原则六：可信执行是成立条件 + +高风险动作必须可理解、可确认、可审计、可恢复。系统必须让用户知道会改什么、影响什么、花费什么、出了问题如何退出。 + +### 原则七：长期协作必须显性化 + +系统形成的长期记忆、偏好、阶段总结和用户画像必须对用户可见、可管理、可纠正，不能以黑箱方式存在。 + +------ -**优先级划分原则：** +## 6. 产品信息架构 -1. **是否直接影响主链路成立** - 优先保证用户能够完成“发起协作 → 获得结果 → 继续推进任务”的完整闭环。凡是直接决定主链路能否成立的能力，应优先进入更高优先级。 +从用户视角，CialloClaw 由八个相互配合的产品层组成： -2. **是否决定产品的第一认知与第一体验** - 用户首次接触产品时，最先感知到的是入口是否自然、反馈是否及时、当前状态是否清楚。因此，直接影响首轮体验与产品成立感的能力，应优先保障。 +1. 悬浮球 +2. 气泡区与轻量输入 +3. 内容理解与任务推进能力 +4. 仪表盘 +5. 便签协作 +6. 镜子 +7. 安全卫士 +8. 控制面板 -3. **是否承担系统级承接职责** - 某些模块虽然不是单点功能，但承担统一承接、统一聚合、统一管理的作用。这类能力会影响整体结构稳定性，因此优先级通常高于纯增强型能力。 +### 6.1 悬浮球 -4. **是否属于增强理解、增强治理或增强个性化能力** - 这类能力能够显著提升长期价值，但不会阻断产品最小闭环成立，因此可以放在主链路之后，按阶段逐步完善。 +悬浮球是默认常驻入口，负责让 Agent 始终贴近当前桌面工作流。它不是默认主界面，而是“我现在可以顺手找你帮忙”的低摩擦锚点。 -5. **是否依赖更复杂的系统能力或更高实现成本** - 涉及自动化、多模型协同、复杂执行、长内容理解等能力，往往依赖更高的工程复杂度、治理成本或验证周期，因此应后置处理。 +它应承担的职责： -**各优先级的含义：** +- 作为桌面常驻入口，始终可接近 +- 让用户通过单击、双击、长按、悬停等动作发起协作 +- 在文本选中、文件拖拽、错误承接等场景下成为明确的任务承接目标 +- 作为系统主状态和可用性的视觉锚点 -- **P0**：用于保证产品最小可用闭环成立，是首版必须具备的能力。 -- **P1**：不决定首版是否可用，但会显著影响管理体验、长期协作体验与系统可控感。 -- **P2**：属于效率增强或扩展能力，应在核心体验稳定后逐步引入。 -- **P2-P3**：属于高阶能力探索，更多服务于差异化提升与长期演进，不应抢占首版资源。 +### 6.2 气泡区与轻量输入 -### 4.4 核心功能逻辑 +气泡区与轻量输入共同构成近场承接层，负责把协作留在当前任务附近，而不是立即拉进重交互页面。 -CialloClaw 的核心运行逻辑可归纳为一条统一的“**现场识别 → 理解判断 → 结果交付 → 任务推进 → 长期沉淀**”链路： +它们应承担的职责： + +- 承接短结果、轻提示与状态反馈 +- 承接一句话补充输入 +- 承接意图确认与修正 +- 在必要时把内容分流到正式交付层 + +### 6.3 内容理解与任务推进能力 + +这是用户最先感受到的核心能力层，覆盖： + +- 内容总结 +- 翻译 +- 解释 +- 重点提炼 +- 错误原因分析 +- 下一步建议 +- 草稿生成 +- 打开资料或结果入口 + +这些能力的目标不是堆叠功能，而是让用户在当前现场获得可立即消费、可继续推进的帮助。 + +### 6.4 仪表盘 + +仪表盘是统一工作台，不是功能入口页。它首先要回答三个问题： + +- 现在最值得关注的是什么 +- 哪些事情需要我接管或确认 +- 哪些结果和历史值得我回看 + +仪表盘应统一承接： + +- 当前焦点 +- 任务状态 +- 未来安排 +- 镜子信息 +- 安全治理信息 + +### 6.5 便签协作 + +便签协作不是传统待办列表，而是 Agent 异步协作的入口。它负责承接未来安排、临期事项、重复事项和后续计划，并在合适时机把其中一部分升级为正式任务。 + +它应提供的价值： + +- 让记录下来的事情不只是被保存 +- 让系统能做提醒、整理、优先级建议和下一步建议 +- 让用户在需要时把事项交给 Agent 正式推进 + +### 6.6 镜子 + +镜子模块承接的是 Agent 的长期理解能力，但它的表现不能像日志仓库，而应像“用户可以理解和管理的认知镜像”。 + +它应承接的内容包括： + +- 历史概要 +- 日报或阶段总结 +- 用户画像与偏好 +- 最近被引用的记忆 +- 记忆管理动作 + +### 6.7 安全卫士 + +安全卫士是产品信任与边界的统一入口。它不应该只在出事时出现，而应持续让用户知道： + +- 当前有没有待确认动作 +- 最近发生了什么拦截或异常 +- 成果会保存到哪里 +- 如果现在停下，能否恢复 +- 当前任务和今日累计花费了多少资源 + +### 6.8 控制面板 + +控制面板是低频设置与策略入口，不承担任务承接和结果查看职责。它负责： + +- 桌面入口行为设置 +- 主动协助与感知开关 +- 记忆策略与生命周期 +- 自动化与巡检设置 +- 成本与预算设置 +- 数据清理与维护设置 + +------ + +## 7. 核心产品闭环 + +从产品视角，CialloClaw 的核心运行逻辑是一条统一闭环： ```mermaid flowchart TD - A[当前桌面现场 / 用户输入 / 环境信号] --> B[识别任务对象] + A[当前桌面现场 / 用户输入 / 环境信号] --> B[近场承接] B --> C[理解意图与帮助机会] C --> D{系统判断} D --> E[返回轻量结果] - D --> F[进入正式结果交付] + D --> F[进入意图确认] D --> G[生成下一步建议] - D --> H[进入确认流] + D --> H[进入正式任务] H --> I[有限执行] - E --> J[更新任务与事项状态] - F --> J - G --> J - I --> J - J --> K[沉淀历史、记忆与治理记录] + I --> J[风险确认 / 恢复保护] + E --> K[正式交付与工作台承接] + F --> K + G --> K + J --> K + K --> L[历史沉淀、记忆与治理回看] ``` -**关键设计决策：** +### 7.1 闭环要求 -- 产品主入口是悬浮球，而非聊天窗口 -- 轻量结果优先在当前任务现场附近交付，长结果自动分流至正式交付层 -- “便签协作”与“任务状态”严格区分：前者是未来安排，后者是已被 Agent 接手推进的工作 -- 高风险动作必须进入确认流，不允许以黑箱方式直接执行 -- 长期记忆必须对用户可见、可管理、可纠正 +- 用户的第一落点应是近场承接，而不是聊天页 +- 产品对外应始终围绕任务组织，而不是围绕聊天轮次组织 +- 短结果应能在当前现场附近消费，长结果必须可回看、可打开、可继续使用 +- 执行前的边界解释和执行后的结果说明同等重要 +- 记忆沉淀必须服务长期协作，而不是变成黑箱历史记录 ------- +### 7.2 用户必须感受到的产品结果 -## 5. 通用规则 - -### 5.1 全局运行策略 - -| 场景 | 策略 | -| ------------ | ---------------------------------------------------------- | -| 默认状态 | 产品以低存在感方式常驻，可随时接近，但不持续抢占注意力 | -| 用户主动发起 | 优先围绕当前对象承接，先给短结果或意图确认，再进入正式交付 | -| 系统主动协助 | 仅以轻提示方式出现，不使用高侵入打断 | -| 长结果生成 | 自动分流到文档、结果页、任务详情等正式交付层 | -| 风险动作 | 统一进入风险分级和授权确认链路 | -| 中断与失败 | 必须告诉用户卡在哪一步、是否有恢复点、能否重试 | - -### 5.2 文案展示通用规则 - -| 规则项 | 说明 | -| ------------ | ---------------------------------------------- | -| 表达风格 | 以任务导向、清晰、可理解为主，避免抽象系统术语 | -| 结果长度 | 轻量结果应控制在一屏内；超出必须自动分流 | -| 推荐语句 | 必须短、直接、可点击，不应写成长解释 | -| 风险说明 | 必须具体说明会改什么、影响什么、能否撤回 | -| 主动提示频率 | 必须克制，避免在用户无操作或离开时高频打扰 | - -### 5.3 名称定义说明 - -以下术语为正式命名。括号仅在首次出现时用于术语映射或能力澄清，后续正文不重复使用解释性括号。 - -| 术语 | 定义 | -| ------------ | -------------------------------------------------------------- | -| 悬浮球 | 桌面常驻入口，用户接近 CialloClaw 的默认近场入口 | -| 气泡区 | 当前任务现场附近的短结果、轻提示与状态反馈承接层 | -| 轻量输入 | 围绕当前对象的一句话补充输入与意图确认入口 | -| 仪表盘 | 承载首页、高价值信息球、任务状态、便签协作、镜子、安全卫士的统一工作台 | -| 控制面板 | 低频全局设置与系统策略入口，不承担任务承接与结果查看职责 | -| 任务 | 已经被 Agent 接手并正在推进的工作 | -| 便签协作 | 未来安排、周期事项和可转交给 Agent 的异步协作入口 | -| 镜子 | 系统对历史、偏好、总结和长期理解的显性表达层 | -| 安全卫士 | 风险、授权、恢复、审计、成本的解释与接管层 | -| 高价值信息球 | 仪表盘首页中的优先级召回机制，用于提示当前最值得关注的信息 | -| 正式交付 | 文档、结果页、任务详情、文件等可继续消费和回看的结果 | +- 它总是在，但不烦 +- 我不必先去打开它，它就在当前任务附近 +- 它能看懂我正在处理的对象，不必让我重复解释 +- 它不只是回答，还会帮我推进下一步 +- 它做事前会让我明白边界，做事后有结果、有记录、能回退 ------ -## 6. 需求详情说明 - -### 模块 1：悬浮球与气泡区 - -**系统映射：** +## 8. 功能能力版图 + +本章回答“产品需要具备哪些能力与模块”，不再承担版本优先级说明；阶段优先级统一以下文第 10 章为准。 + +### 8.1 用户需求与功能映射 + +| 用户需求 | 对应能力 | +| ---------------------------------------------- | -------------------------------------- | +| 在当前页面、文本、文件上快速获得帮助 | 总结、翻译、解释、重点提炼 | +| 遇到报错、阻塞或异常时获得原因和下一步建议 | 错误分析、阻塞解释、下一步建议 | +| 通过轻动作顺手发起协作 | 悬浮球、语音、悬停、文本选中、拖拽 | +| 获得短反馈并在需要时进入正式结果 | 气泡区、轻量输入、正式交付层 | +| 把某件事项正式交给 Agent 推进 | 便签协作、任务状态、任务详情 | +| 了解当前任务做到哪一步、是否卡住、是否需要授权 | 仪表盘、任务状态、安全摘要 | +| 希望系统越来越懂自己，但又不想被黑箱记住 | 镜子、历史概要、记忆管理 | +| 希望清楚知道系统会改什么、影响什么、能不能撤回 | 安全卫士、风险分级、恢复点、审计记录 | +| 希望能启用或关闭主动协助、记忆、预算等全局行为 | 控制面板、记忆策略、主动协助、预算设置 | +| 希望系统支持更多自动化和扩展能力 | 自动化、模型路由、插件 / Skills | + +### 8.2 关键功能模块 + +| 功能模块 | 核心功能 | +| ------------------ | ------------------------------------------------- | +| 悬浮球 | 常驻入口、状态提示、单击 / 双击 / 长按 / 悬停承接 | +| 气泡区与轻量输入 | 短结果、轻提示、补充输入、意图确认 | +| 内容理解 | 总结、翻译、解释、重点提炼、错误分析 | +| 任务推进 | 下一步建议、草稿生成、阻塞解释、资料入口 | +| 仪表盘首页 | 当前焦点、任务总览、信任摘要、召回入口 | +| 任务状态 | 进行中 / 等待中 / 异常中 / 已结束任务查看与管理 | +| 便签协作 | 近期要做、后续安排、重复事项、已结束事项 | +| 镜子 | 历史概要、阶段总结、用户画像、记忆管理 | +| 安全卫士 | 风险分级、待确认项、授权记录、恢复与费用 | +| 控制面板 | 全局行为、记忆策略、主动协助、预算与默认结果位置 | +| 自动化与扩展 | 周期巡检、定时任务、插件 / Skills、模型路由 | +| 高阶理解与能力扩展 | 视频总结、长内容理解、多模型协同 | + +### 8.3 范围边界 + +本 PRD 关注的是产品主链路和用户价值成立，不把以下内容作为首版产品成立条件： + +- 面向开发者的复杂插件生态 +- 多模型路由的高级配置能力 +- 跨设备同步和团队协作能力 +- 需要高复杂度治理和基础设施支撑的规模化能力 + +这些方向应在核心闭环稳定后，再纳入后续阶段规划。 -- 悬浮球：默认常驻近场入口 -- 气泡区与轻量输入：短结果、确认、补充输入承接 +------ -**模块定位：** -悬浮球与气泡区共同构成桌面近场交互层。它们负责让协作在当前任务附近被低成本发起、低打扰承接，而不是让用户先打开一个聊天窗口再组织需求。 +## 9. 关键体验要求 -**用户可见能力：** +### 9.1 近场发起体验 -- 提供可随时接近的常驻入口 -- 展示当前系统主状态 -- 承接用户单击、双击、长按、悬停、拖拽、文本选中后的后续动作 -- 在识别到帮助机会时，以低打扰方式提示用户 -- 显示短结果、状态反馈、下一步建议与意图确认 -- 承接一句话补充输入 +产品必须让用户能够在当前桌面现场低成本发起协作，而不是先进入主界面或聊天窗口。 -**核心交互：** +具体要求： -| 交互行为 | 系统响应 | -| -------- | ------------------------------------------------ | -| 单击 | 轻量接近；若已有任务对象，则进入围绕该对象的承接 | -| 双击 | 打开仪表盘 | -| 长按 | 进入语音承接 | -| 悬停 | 展示轻量输入与推荐问题 | -| 文件拖拽 | 识别文件对象并进入确认流 | -| 文本选中 | 标记为已识别对象，等待用户继续发起 | +- 悬浮球默认常驻，可随时接近 +- 单击用于轻量接近，而不是默认打开主界面 +- 双击用于进入仪表盘 +- 长按用于进入语音承接 +- 悬停可展示轻量输入与推荐问题 +- 文本选中、文件拖拽、错误承接都能围绕当前对象进入协作链路 -**设计原则：** +### 9.2 近场承接体验 -- 单击用于低成本发起协作，不是默认打开应用 -- 长按是语音主入口，上滑锁定、下滑取消 -- 悬停用于一句话补充和推荐问题，不演化为聊天弹窗 -- 文本选中与文件拖拽的目标，是让任务对象直接进入协作链路，而不是让用户先复制粘贴到对话框中 -- 轻量承接默认轻量，不演化为聊天窗口 -- 生命周期可控，可隐藏、恢复、置顶、删除 -- 一旦内容超出承载范围，必须自动分流到正式交付层 +近场承接层必须足够轻，能够快速反馈当前状态，但不能演化为重聊天界面。 -### 模块 2：仪表盘 +具体要求： -**系统映射：** 统一工作台，承接首页、高价值信息球、任务状态、便签协作、镜子与安全卫士 +- 能表达系统当前状态 +- 能承接意图确认与修正 +- 能返回短结果 +- 能承接一句话补充输入 +- 结果超过近场承载范围时，必须自动分流到正式交付层 -**模块定位：** -仪表盘是产品的统一工作台。它不是单一页面，而是用户查看当前进展、理解系统状态、管理异步协作、回看长期沉淀以及处理风险确认的主阵地。所有需要“回看、管理、判断、接管”的内容，都应收口到仪表盘内部完成。首页与任务状态属于主链路优先级，镜子、安全卫士增强项与高价值召回机制可按阶段逐步完善。 +### 9.3 工作台体验 -**仪表盘整体职责：** +工作台的职责不是展示功能列表，而是帮助用户快速判断现在最值得关注的事情，并进入正确的接管入口。 -- 聚合当前最值得关注的信息 -- 统一承接任务、事项、记忆与安全治理信息 -- 让用户在一个工作台内完成查看、确认、调整与接管 -- 提供从首页预览到详情管理的清晰层级 -- 避免各模块分散漂浮，降低理解和操作成本 +具体要求： -#### 2.1 仪表盘首页与高价值信息球 +- 首页先回答“现在最该看什么” +- 任务状态必须让用户看懂任务推进到了哪一步 +- 未来安排必须和正在推进的任务区分清楚 +- 安全与恢复必须始终可达 +- 镜子信息应帮助用户理解长期协作价值，而不是变成原始日志堆积 -**系统映射：** 仪表盘首页焦点区 / 首页召回提示机制 +### 9.4 事项到任务的桥接体验 -**定位说明：** -仪表盘首页负责在用户打开产品后第一时间回答三个问题：现在最该看什么、哪里需要我介入、哪些事情可以继续推进。高价值信息球从属于首页焦点区，是首页的优先级召回机制，而不是独立一级业务模块。 +产品必须让用户清楚区分“未来安排”和“已进入推进的任务”，并让二者之间的转换自然成立。 -**首页应承载的内容：** +具体要求： -- 当前最值得优先关注的信息 -- 关键任务的简要状态 -- 待确认或待处理事项摘要 -- 最近一次重要产出或异常摘要 -- 进入详情页的明确入口 +- 支持近期要做、后续安排、重复事项、已结束事项四类组织方式 +- 能围绕事项提供提醒、建议和转交给 Agent 的桥接 +- 事项在被转交前后，应保持语义清晰，不与正式任务混为一体 +- 被转交后，应形成清晰的持续推进体验 -**高价值信息球展示内容：** +### 9.5 长期协作体验 -- 简略的事件描述 -- 简略的任务执行状态 -- 查看详情的提醒 -- 取消或稍后处理入口 +长期协作价值必须被用户感知，而不是只停留在系统内部。 -**设计要求：** +具体要求： -- 必须从属于仪表盘首页，不独立成新的业务层 -- 不与首页焦点区、任务状态卡片重复造层 -- 用于召回最值得先看的内容，而不是承接完整详情 -- 页面语言必须帮助用户快速判断“是否需要立即处理” +- 能回看近期协作概要 +- 能展示日报或阶段总结 +- 能让用户看到偏好与画像的形成结果 +- 能提供保留、修改、删除、忽略、关闭等记忆管理动作 -#### 2.2 任务状态模块 +### 9.6 信任与治理体验 -**系统映射：** 仪表盘中的任务状态工作区 +用户不仅要知道 Agent 在做什么，还要知道它会影响什么、何时需要确认、出问题后如何退出。 -**模块定位：** -任务是“已经被 Agent 接手并正在推进的工作”；便签协作中的事项是“未来的安排”。当便签协作中的某件事正式交给 Agent 推进后，应自动生成一个任务，并与原始事项保持关联。 +具体要求： -**预览态要承载的内容：** +- 能解释当前有没有待确认动作 +- 能展示最近异常、恢复点和资源消耗 +- 能让用户看见影响范围和授权记录 +- 能说明边界、恢复方式和可控程度 -未完成任务至少展示： +### 9.7 设置与策略体验 -- 任务名称 -- 任务状态 -- 当前执行到哪一步 +设置体系必须服务长期使用，但不能干扰主链路。 -已结束任务至少展示： +具体要求： -- 任务名称 -- 最终状态 +- 控制面板是低频设置页，而不是任务工作台 +- 能管理桌面入口、记忆策略、自动化策略、预算与数据维护 +- 风险较高的设置必须清楚说明影响和生效方式 -首页焦点区必须让用户快速判断： +------ -- 这个任务是否卡住 -- 是否需要我现在介入 -- 当前是否接近完成 +## 10. 阶段规划 -**详情态要承载的内容：** +本章回答“这些能力按什么顺序进入版本计划”，不再重复定义模块本身。 -- 任务头部：任务名称、当前状态、来源、开始时间、最近更新时间 -- 进度时间线：完整步骤、当前停留步骤、已完成 / 进行中 / 未开始的清晰区分 -- 关键上下文：资料、记忆摘要、用户约束、重要前提 -- 成果区：文件、草稿、网页、清单、模板等，并支持直接打开 -- 信任摘要：风险状态、待授权数量、恢复点、最近边界触发 -- 操作区：暂停 / 继续、取消、修改任务、查看安全详情、重启任务 +### 10.1 P0：产品最小闭环 -**建议采用的状态语言：** +P0 不是最少功能，而是 **必须能让产品成立** 的最小闭环。P0 必须实现： -- 进行中：正在进行、接近完成 -- 等待中：暂停、等待授权、等待补充信息、等待上游条件 -- 异常中：失败、阻塞、执行异常 -- 已结束：已完成、已取消、已结束未完成 +- 自然的桌面近场入口 +- 至少几类高频理解能力的真实承接 +- 从近场到正式结果的结果分流 +- 能看见当前任务与最小工作台状态 +- 至少一条可信执行链路 +- 至少一种未来安排到正式任务的桥接方式 -#### 2.3 便签协作模块 +### 10.2 P1：持续使用体验 -**系统映射：** 仪表盘中的便签协作工作区 +P1 解决“能用”之后的“能持续用”，重点包括： -**模块定位：** -便签协作不是传统待办清单，而是 Agent 异步协作的入口。它负责把“记下来的事情、周期性的事情、尚未开始但需要记住的事情”整理成可巡检、可提醒、可转交给 Agent 的结构。 +- 巡检和提醒完整化 +- 任务详情、安全详情、恢复查看和镜子增强 +- 设置中心完善 +- 成本、预算、降级和长期协作可见性增强 -**分类结构与预览逻辑：** +### 10.3 P2：更自然、更智能、更低打扰 -- 近期要做：快到时间、今天要做、最近几天要处理的事项 -- 后续安排：已记下但还没到处理窗口的事项 -- 重复事项：每天、每周、每月等循环发生的规则 -- 已结束：已完成或已取消的事项 +P2 重点提升体验自然度和帮助时机质量，包括： -**Agent 建议的表现方式：** +- 更聪明的主动推荐 +- 更细腻的近场动画和轻提示 +- 更强的首页焦点与召回能力 +- 更复杂的内容理解和生成能力 -- 下一步建议：先打开模板、先整理材料、先生成草稿等 -- 待办转任务：用户确认后，直接生成任务并跳转到任务状态页 -- 流程化建议：反复延期或频繁出现时，提示整理成固定流程或模板 +### 10.4 P3：生态扩展与规模化能力 -#### 2.4 镜子模块 +P3 重点扩展能力边界，包括： -**系统映射：** 仪表盘中的镜子工作区 +- 多模型切换与路由 +- 社区 Skills 与插件生态 +- 感知包扩展 +- 多设备协作、同步和更广泛的长期协作场景 -**模块定位：** -镜子模块承接的是 Agent 的长期理解能力，但页面表现不能像原始日志仓库，而应像“可以被用户理解和管理的认知镜像”。 +------ -它至少要承担三件事： +## 11. 状态表达与结果承接原则 -- 替代传统聊天中的历史承接，让用户能看到最近一段时间的对话概要与上下文脉络 -- 生成日报或阶段总结，让用户知道今天做了什么、完成了什么、涉及了哪些关键权限或成果 -- 逐步沉淀用户画像、偏好与习惯，并允许用户查看、纠正、关闭或删除 +### 11.1 用户可理解的状态表达 -**可管理动作：** +从产品展示层面，任务状态应优先使用用户能直观理解的语言，而不是直接暴露底层实现状态： -- 保留 -- 修改 -- 删除 -- 忽略本次建议 -- 关闭该类记忆 +- **进行中：** 正在进行、接近完成 +- **等待中：** 等待授权、等待补充信息、等待外部条件、暂停中 +- **异常中：** 失败、阻塞、执行异常 +- **已结束：** 已完成、已取消、已结束未完成 -**补充要求：** +页面表达的重点不是给状态起名，而是让用户快速回答三个问题： -- 记忆默认以结构化信息为主，不以原始文本堆积为目标 -- 支持短期记忆、长期记忆、任务级记忆分层 -- 周期性总结要对用户可见、可验证、可管理 +- 现在进行到哪一步了 +- 为什么停住了 +- 我下一步该做什么 -#### 2.5 安全卫士模块 +### 11.2 结果承接原则 -**系统映射：** 仪表盘中的安全与治理工作区 +- 短结果优先在近场承接 +- 长文本优先进入文档或正式结果页 +- 文件类结果应支持打开或定位 +- 连续任务和失败任务应进入任务详情承接 +- 失败、中断和高风险结果必须附带结构化说明与恢复入口 -**模块定位：** -安全卫士是仪表盘里的最后一道解释与接管层。它不应该只在出事时出现，而应始终让用户知道： +### 11.3 风险等级表达 -- 当前有没有待确认操作 -- 最近是否发生过拦截 -- 成果会保存到哪里 -- 如果现在停下能否恢复 +- **绿灯：** 低风险，记录即可 +- **黄灯：** 会修改内容或改变环境，先解释影响范围，再给确认入口 +- **红灯：** 删除、外发、越界、不可逆或涉及关键身份与关键文件的动作，必须显式人工确认 -**预览态至少展示：** +------ -- 当前安全状态 -- 待确认操作数 -- 最近一次异常 -- 最近恢复点 -- 当前任务资源消耗 -- 今日累计资源消耗 +## 12. 成功标准与效果评估 -**详细态包含：** +### 12.1 产品成功标准 -- 待确认 / 被拦截操作 -- 授权记录 -- 审计记录 -- 影响范围 -- 恢复与回滚 -- 规则与权限管理 -- Token 与费用 -- 执行日志 +从最终产品视角，CialloClaw 需要稳定达成以下主观结果： -**风险等级的页面表达：** +- 它总是在，但不烦 +- 我不必先去打开它，它就在当前任务附近 +- 它能看懂我正在做什么，不必让我重复解释 +- 它不只是说建议，还会帮我推进下一步 +- 它做事之前会让我明白边界 +- 我能知道它做了什么、花了什么、出了问题怎么退 +- 它越来越像一个熟悉我工作方式的协作者 -- 绿灯：低风险、可静默执行，页面记录即可 -- 黄灯：会修改内容或改变环境，先解释影响范围，再给确认入口 -- 红灯：删除、外发、不可逆、越界或涉及身份与关键文件的动作，必须显式人工确认 +### 12.2 核心指标 -**补充边界能力：** +| 目标维度 | 代表指标 | 判断方向 | +| ---------- | ---------------------------------------------------- | ---------------------- | +| 发起效率 | 文本选中后继续协作率、文件拖拽发起率、长按语音发起率 | 验证入口是否自然 | +| 上下文效率 | 围绕当前对象直接完成的比例、补充背景次数下降 | 验证是否减少上下文搬运 | +| 推进效率 | 任务发起率、任务推进率、便签转任务率 | 验证是否从回答走向推进 | +| 信任治理 | 高风险确认处理率、恢复点查看率、成本查看率 | 验证是否建立边界与信任 | +| 长期价值 | 镜子回看率、记忆认可度、个性化建议接受率 | 验证长期协作是否成立 | -- 默认工作区与写入边界校验 -- 高风险执行进入更强隔离环境 -- 一键中断与恢复 -- 任务工作区级回滚与项目级快照恢复的预留设计 +### 12.3 首版验收感知 -### 模块 3：控制面板 +首版达成时，至少应让团队和用户感受到： -**系统映射：** 全局设置与系统策略入口 +- 多种主要入口可以在真实场景下完成一轮完整协作 +- 至少一种高风险动作链路是可理解、可确认、可回看的 +- 结果不只停留在气泡，而是能进入正式交付层被继续使用 +- 工作台可以承接当前任务、未来安排、安全摘要和最小长期记忆 -**模块定位：** -控制面板是 CialloClaw 的低频配置入口，用于承接全局行为、默认偏好和系统维护相关设置，不承担任务承接与结果查看职责。 +------ -**负责内容：** +## 13. 非功能性要求 -- 桌面入口行为 -- 主动协助与感知开关 -- 记忆启用与生命周期 -- 自动化与巡检基础设置 -- 默认结果位置 -- 成本与预算设置 -- 数据清理与恢复默认 +### 13.1 低打扰与可接近性 -**设计原则：** +- 产品默认常驻，但不持续抢占注意力 +- 主动提示必须克制，避免高频打断 +- 用户应随时能重新接近 Agent，而不需要重新打开复杂工作区 -- 低频使用 -- 不打扰主流程 -- 与仪表盘职责分离 -- 高风险设置需明确确认 +### 13.2 性能与反馈 -### 模块补充：系统能力说明 +- 悬浮球和近场承接必须保持轻量、顺滑、快速可触达 +- 用户发起后应尽快获得短反馈、处理中状态或意图确认 +- 长任务必须持续反馈当前状态，不能静默悬空 +- 用户打开仪表盘后，应在短时间内定位当前最重要的信息 -以下能力不作为独立一级页面模块存在，但会贯穿悬浮球、气泡区、正式交付层与仪表盘各处： +### 13.3 安全与恢复 -| 能力项 | 作用说明 | -| ------------ | ---------------------------------------------------------- | -| 内容理解 | 负责总结、翻译、解释、重点提炼、错误分析等基础理解能力 | -| 任务推进 | 负责下一步建议、草稿生成、资料打开、阻塞解释和推动事项继续前进 | -| 长期记忆 | 负责偏好沉淀、上下文继承、镜子内容生成与任务级记忆承接 | -| 执行与自动化 | 负责确认后执行、周期巡检、自动化任务、插件 / Skills 扩展 | -| 安全与治理 | 负责风险判断、授权确认、恢复回滚、审计与成本治理 | +- 高风险动作必须进入确认链路 +- 系统必须明确说明会改什么、影响什么、能否撤回 +- 重要动作必须可查、可追踪、可回看 +- 中断和失败后必须提供恢复或回退信息 ------- +### 13.4 成本透明 -## 7. 效果评估与数据统计 +- 当前任务与当日累计资源消耗必须可见 +- 预算、限制与降级策略必须对用户可理解 -### 7.1 核心数据看板 +### 13.5 记忆可控 -| 数据指标 | 统计维度 | 采集方式 | -| -------------- | ------------ | ------------------------------ | -| 悬浮球交互率 | 日 / 周 / 月 | 单击、长按、悬停、拖拽等事件 | -| 任务发起率 | 日 / 周 | 协作任务创建事件 | -| 任务完成率 | 日 / 周 | 任务状态流转事件 | -| 任务推进率 | 周 | 获得结果后继续下一步动作的比例 | -| 便签转任务率 | 周 | 事项正式交给 Agent 推进的比例 | -| 主动提示接受率 | 周 | 主动提示点击 / 展示 | -| 镜子模块回看率 | 周 / 月 | 镜子模块访问事件 | -| 待确认处理率 | 日 / 周 | 待确认项被处理的比例 | -| 恢复点使用率 | 周 / 月 | 恢复动作事件 | -| 资源消耗可见率 | 周 | 用户查看成本 / 预算信息的比例 | +- 用户必须能查看、删除、关闭或纠正长期记忆 +- 长期记忆不应以黑箱形式影响用户决策 -### 7.2 核心验证指标 +### 13.6 平台体验 -| 目标维度 | 指标 | 判断方向 | -| -------- | ---------------------------------------------- | ---------------------- | -| 发起效率 | 文本选中后继续协作率、文件拖拽发起率 | 验证入口是否自然 | -| 协作效率 | 任务完成率、任务推进率 | 验证是否不只停留在回答 | -| 长期价值 | 镜子回看率、个性化结果认可度 | 验证长期协作是否成立 | -| 信任治理 | 高风险确认通过率、恢复点使用率、风险可控感评分 | 验证是否建立信任 | +- 产品应适应桌面多窗口、多任务与边工作边协作的使用方式 +- 桌面入口、结果承接和工作台之间的切换应自然连续 -补充建议指标： +------ -- 长按通话率 -- 双击打开仪表盘率 -- 主动提示后继续协作率 -- 单任务平均 Token / 成本 -- 中断后恢复率 +## 14. 产品术语说明 + +| 术语 | 定义 | +| -------- | ---------------------------------------------------- | +| 悬浮球 | 桌面常驻入口，用户接近 CialloClaw 的默认近场锚点 | +| 气泡区 | 当前任务现场附近的短结果、轻提示与状态反馈承接层 | +| 轻量输入 | 围绕当前对象的一句话补充输入与修正入口 | +| 仪表盘 | 承载当前焦点、任务、未来安排、镜子与安全的统一工作台 | +| 控制面板 | 低频全局设置与系统策略入口 | +| 任务 | 已经被 Agent 接手并正在推进的工作 | +| 便签协作 | 未来安排、周期事项和可转交给 Agent 的异步协作入口 | +| 镜子 | 系统对历史、偏好、总结和长期理解的显性表达层 | +| 安全卫士 | 风险、授权、恢复、审计、成本的统一解释与接管层 | +| 正式交付 | 文档、结果页、任务详情、文件等可继续消费和回看的结果 | ------ -## 8. 性能与安全性等非功能性需求 - -### 8.1 性能要求 - -| 指标 | 目标要求 | -| -------------- | ------------------------------------ | -| 悬浮球可接近性 | 应始终快速可触达，不可因复杂状态阻塞 | -| 轻量反馈速度 | 应尽可能即时出现 | -| 长任务反馈 | 必须明确展示处理中状态 | -| 结果分流体验 | 长结果不得阻塞气泡区与轻量输入 | -| 仪表盘理解效率 | 用户打开后 10 秒内应能定位最重要信息 | - -### 8.2 安全性要求 - -| 安全领域 | 具体要求 | -| -------- | -------------------------------------------- | -| 风险控制 | 高风险动作必须进入确认流 | -| 边界管理 | 系统必须明确说明会改什么、影响什么、能否撤回 | -| 审计能力 | 重要动作必须可查、可追踪 | -| 恢复能力 | 中断和失败后必须提供恢复或回退信息 | -| 成本透明 | 当前任务与今日累计资源消耗必须可见 | -| 记忆管理 | 用户必须可查看、删除、关闭或纠正长期记忆 | - -### 8.3 可用性要求 - -| 场景 | 处理方式 | -| ------------------ | ------------------------------------------------------ | -| 用户不想被打扰 | 主动协助可关闭，且支持免打扰策略 | -| 用户看不懂系统状态 | 首页、仪表盘首页召回提示和任务卡必须用直白状态语言表达 | -| 任务被阻塞 | 必须明确说明缺什么、卡在哪，而不是只显示失败 | -| 任务完成 | 必须能直接看到成果、打开结果或进入下一步 | +## 15. 一句话结论 + +CialloClaw 的目标不是做一个更会聊天的桌面 AI，而是做一个 **能在当前任务现场被顺手发起、能围绕上下文理解并推进任务、能把结果正式交付、能把风险和恢复讲清楚、并能逐步形成长期协作价值的桌面常驻 Agent**。 From 131e95fc48c9b7b5194a9fd3e932f28596313bca Mon Sep 17 00:00:00 2001 From: gdemonc <1502689916@qq.com> Date: Sun, 19 Apr 2026 16:31:11 +0800 Subject: [PATCH 6/6] docs: Refactor PRD structure, consolidate module descriptions, and focus on service PRD. --- docs/product-requirement-document.md | 247 +++++++++++---------------- 1 file changed, 98 insertions(+), 149 deletions(-) diff --git a/docs/product-requirement-document.md b/docs/product-requirement-document.md index 3f43e4e19..46c605000 100644 --- a/docs/product-requirement-document.md +++ b/docs/product-requirement-document.md @@ -3,7 +3,7 @@ | 文档信息 | 内容 | | -------- | ------------------------------------------ | | 产品名称 | CialloClaw | -| 文档版本 | v4.0 | +| 文档版本 | v4.1 | | 文档状态 | 正式版 | | 创建日期 | 2026-04-18 | | 目标平台 | Windows / macOS 桌面端（首发优先 Windows） | @@ -13,7 +13,7 @@ ## 1. 文档定位 -本文件是 CialloClaw 在开工前使用的 **产品总览 PRD**。 +本文件是 CialloClaw 在开工前使用的 **PRD**。 它用于统一回答以下问题： @@ -81,7 +81,7 @@ CialloClaw 不是一个以聊天框为中心的桌面 AI，而是一个： #### 目标一：降低桌面协作发起门槛 -用户应能够通过单击、长按、悬停、拖拽、选中等轻动作，在当前桌面现场顺手发起一次协作，而不是先打开另一个产品再组织需求。 +用户应能够通过低成本的近场动作，在当前桌面现场顺手发起一次协作，而不是先打开另一个产品再组织需求。 #### 目标二：让帮助直接发生在任务现场 @@ -157,7 +157,7 @@ CialloClaw 不只负责给出解释和总结，还应帮助用户明确下一步 ### 原则二：低摩擦发起优先 -用户应能够通过单击、长按、悬停、拖拽、选中等轻动作，在当前桌面现场顺手发起协作，而不是先打开另一个产品再组织需求。 +用户应能够通过低成本的近场动作，在当前桌面现场顺手发起协作，而不是先打开另一个产品再组织需求。 ### 原则三：语音优先，文字补充 @@ -183,112 +183,20 @@ CialloClaw 不只负责给出解释和总结，还应帮助用户明确下一步 ## 6. 产品信息架构 -从用户视角，CialloClaw 由八个相互配合的产品层组成： +从产品层视角，CialloClaw 由八个相互配合的模块构成。本章只定义产品级模块划分与范围边界，不进一步展开页面职责、具体交互动作或组件行为；这些细节应分别下放到交互设计、仪表盘设计和控制面板设计文档，避免形成双重真源。 -1. 悬浮球 -2. 气泡区与轻量输入 -3. 内容理解与任务推进能力 -4. 仪表盘 -5. 便签协作 -6. 镜子 -7. 安全卫士 -8. 控制面板 +| 产品模块 | 产品角色 | 本文档定义边界 | +| --- | --- | --- | +| 悬浮球 | 默认近场入口与在场锚点 | 只定义入口价值与存在意义，不定义具体交互动作 | +| 气泡区与轻量输入 | 近场反馈、补充输入与轻量承接层 | 只定义承接目标与分流原则，不定义页面细节 | +| 内容理解与任务推进能力 | 用户最先感知的核心价值层 | 只定义能力范围，不定义具体流程编排 | +| 仪表盘 | 统一工作台与持续协作承接面 | 只定义承接范围，不定义页面结构与模块排布 | +| 便签协作 | 未来安排与正式任务之间的桥接层 | 只定义产品语义，不定义列表组织与页面规则 | +| 镜子 | 长期理解、历史概要与记忆显性层 | 只定义长期协作价值，不定义展示形态 | +| 安全卫士 | 风险、授权、恢复与成本的解释与接管层 | 只定义信任职责，不定义详情页结构 | +| 控制面板 | 低频全局设置与策略入口 | 只定义设置范围，不定义设置项布局 | -### 6.1 悬浮球 - -悬浮球是默认常驻入口，负责让 Agent 始终贴近当前桌面工作流。它不是默认主界面，而是“我现在可以顺手找你帮忙”的低摩擦锚点。 - -它应承担的职责： - -- 作为桌面常驻入口，始终可接近 -- 让用户通过单击、双击、长按、悬停等动作发起协作 -- 在文本选中、文件拖拽、错误承接等场景下成为明确的任务承接目标 -- 作为系统主状态和可用性的视觉锚点 - -### 6.2 气泡区与轻量输入 - -气泡区与轻量输入共同构成近场承接层，负责把协作留在当前任务附近，而不是立即拉进重交互页面。 - -它们应承担的职责： - -- 承接短结果、轻提示与状态反馈 -- 承接一句话补充输入 -- 承接意图确认与修正 -- 在必要时把内容分流到正式交付层 - -### 6.3 内容理解与任务推进能力 - -这是用户最先感受到的核心能力层，覆盖： - -- 内容总结 -- 翻译 -- 解释 -- 重点提炼 -- 错误原因分析 -- 下一步建议 -- 草稿生成 -- 打开资料或结果入口 - -这些能力的目标不是堆叠功能，而是让用户在当前现场获得可立即消费、可继续推进的帮助。 - -### 6.4 仪表盘 - -仪表盘是统一工作台，不是功能入口页。它首先要回答三个问题： - -- 现在最值得关注的是什么 -- 哪些事情需要我接管或确认 -- 哪些结果和历史值得我回看 - -仪表盘应统一承接： - -- 当前焦点 -- 任务状态 -- 未来安排 -- 镜子信息 -- 安全治理信息 - -### 6.5 便签协作 - -便签协作不是传统待办列表，而是 Agent 异步协作的入口。它负责承接未来安排、临期事项、重复事项和后续计划，并在合适时机把其中一部分升级为正式任务。 - -它应提供的价值： - -- 让记录下来的事情不只是被保存 -- 让系统能做提醒、整理、优先级建议和下一步建议 -- 让用户在需要时把事项交给 Agent 正式推进 - -### 6.6 镜子 - -镜子模块承接的是 Agent 的长期理解能力，但它的表现不能像日志仓库，而应像“用户可以理解和管理的认知镜像”。 - -它应承接的内容包括： - -- 历史概要 -- 日报或阶段总结 -- 用户画像与偏好 -- 最近被引用的记忆 -- 记忆管理动作 - -### 6.7 安全卫士 - -安全卫士是产品信任与边界的统一入口。它不应该只在出事时出现，而应持续让用户知道： - -- 当前有没有待确认动作 -- 最近发生了什么拦截或异常 -- 成果会保存到哪里 -- 如果现在停下，能否恢复 -- 当前任务和今日累计花费了多少资源 - -### 6.8 控制面板 - -控制面板是低频设置与策略入口，不承担任务承接和结果查看职责。它负责： - -- 桌面入口行为设置 -- 主动协助与感知开关 -- 记忆策略与生命周期 -- 自动化与巡检设置 -- 成本与预算设置 -- 数据清理与维护设置 +这些模块共同构成产品总览层：近场入口负责发起与承接，能力层负责理解与推进，仪表盘负责持续查看与接管，治理层负责解释边界与恢复，设置层负责长期使用策略。 ------ @@ -342,7 +250,7 @@ flowchart TD | ---------------------------------------------- | -------------------------------------- | | 在当前页面、文本、文件上快速获得帮助 | 总结、翻译、解释、重点提炼 | | 遇到报错、阻塞或异常时获得原因和下一步建议 | 错误分析、阻塞解释、下一步建议 | -| 通过轻动作顺手发起协作 | 悬浮球、语音、悬停、文本选中、拖拽 | +| 通过轻动作顺手发起协作 | 近场入口、自然表达、当前对象承接 | | 获得短反馈并在需要时进入正式结果 | 气泡区、轻量输入、正式交付层 | | 把某件事项正式交给 Agent 推进 | 便签协作、任务状态、任务详情 | | 了解当前任务做到哪一步、是否卡住、是否需要授权 | 仪表盘、任务状态、安全摘要 | @@ -355,7 +263,7 @@ flowchart TD | 功能模块 | 核心功能 | | ------------------ | ------------------------------------------------- | -| 悬浮球 | 常驻入口、状态提示、单击 / 双击 / 长按 / 悬停承接 | +| 悬浮球 | 常驻入口、状态提示、近场发起与对象承接 | | 气泡区与轻量输入 | 短结果、轻提示、补充输入、意图确认 | | 内容理解 | 总结、翻译、解释、重点提炼、错误分析 | | 任务推进 | 下一步建议、草稿生成、阻塞解释、资料入口 | @@ -383,18 +291,18 @@ flowchart TD ## 9. 关键体验要求 +本章定义的是产品级体验目标和首版必须保证的体验闭环，不定义具体手势、按钮行为、页面状态机或组件交互细节。 + ### 9.1 近场发起体验 产品必须让用户能够在当前桌面现场低成本发起协作，而不是先进入主界面或聊天窗口。 具体要求： -- 悬浮球默认常驻，可随时接近 -- 单击用于轻量接近，而不是默认打开主界面 -- 双击用于进入仪表盘 -- 长按用于进入语音承接 -- 悬停可展示轻量输入与推荐问题 -- 文本选中、文件拖拽、错误承接都能围绕当前对象进入协作链路 +- 首版必须具备稳定的近场发起入口，而不是以聊天窗口作为默认入口 +- 首版必须至少覆盖一种自然表达入口、一种围绕当前对象的入口和一种轻量补充入口 +- 发起过程应尽量减少用户重新组织需求和搬运上下文的成本 +- 入口设计应优先服务“顺手发起协作”，而不是增加新的操作负担 ### 9.2 近场承接体验 @@ -402,23 +310,21 @@ flowchart TD 具体要求： -- 能表达系统当前状态 -- 能承接意图确认与修正 -- 能返回短结果 -- 能承接一句话补充输入 -- 结果超过近场承载范围时，必须自动分流到正式交付层 +- 能快速表达系统当前状态和结果方向 +- 能承接最小必要的确认、修正和补充输入 +- 能承接短结果，但不承担冗长历史和复杂管理任务 +- 当结果超出近场承载范围时，必须进入正式交付层继续承接 -### 9.3 工作台体验 +### 9.3 仪表盘体验 -工作台的职责不是展示功能列表，而是帮助用户快速判断现在最值得关注的事情，并进入正确的接管入口。 +仪表盘的职责不是展示功能列表，而是帮助用户快速判断现在最值得关注的事情，并进入正确的接管入口。 具体要求： -- 首页先回答“现在最该看什么” -- 任务状态必须让用户看懂任务推进到了哪一步 -- 未来安排必须和正在推进的任务区分清楚 -- 安全与恢复必须始终可达 -- 镜子信息应帮助用户理解长期协作价值，而不是变成原始日志堆积 +- 用户打开仪表盘后，应快速判断当前最值得关注的事 +- 仪表盘必须同时承接当前任务、未来安排、治理信息和长期协作信息 +- 仪表盘中的不同信息层必须语义清晰，避免互相混淆 +- 仪表盘应优先帮助用户接管和继续推进，而不是堆叠功能入口 ### 9.4 事项到任务的桥接体验 @@ -426,10 +332,10 @@ flowchart TD 具体要求： -- 支持近期要做、后续安排、重复事项、已结束事项四类组织方式 -- 能围绕事项提供提醒、建议和转交给 Agent 的桥接 +- 未来安排与正式任务必须保持明确区分 +- 产品应支持围绕事项进行提醒、建议和转交给 Agent 的桥接 - 事项在被转交前后，应保持语义清晰，不与正式任务混为一体 -- 被转交后，应形成清晰的持续推进体验 +- 被转交后，应形成可持续查看与推进的任务体验 ### 9.5 长期协作体验 @@ -437,10 +343,9 @@ flowchart TD 具体要求： -- 能回看近期协作概要 -- 能展示日报或阶段总结 -- 能让用户看到偏好与画像的形成结果 -- 能提供保留、修改、删除、忽略、关闭等记忆管理动作 +- 用户应能理解系统沉淀了哪些长期价值 +- 长期协作信息应帮助用户回看历史、理解偏好和复用经验 +- 记忆相关内容必须可见、可理解、可管理，而不是黑箱存在 ### 9.6 信任与治理体验 @@ -448,10 +353,9 @@ flowchart TD 具体要求： -- 能解释当前有没有待确认动作 -- 能展示最近异常、恢复点和资源消耗 -- 能让用户看见影响范围和授权记录 -- 能说明边界、恢复方式和可控程度 +- 用户必须能理解当前是否存在待确认动作和风险边界 +- 产品必须让用户看见影响范围、异常情况、恢复能力和资源消耗 +- 高风险动作必须体现“先理解边界，再决定是否继续”的治理体验 ### 9.7 设置与策略体验 @@ -459,13 +363,13 @@ flowchart TD 具体要求： -- 控制面板是低频设置页，而不是任务工作台 -- 能管理桌面入口、记忆策略、自动化策略、预算与数据维护 -- 风险较高的设置必须清楚说明影响和生效方式 +- 设置体系应服务长期使用，而不是抢占主流程 +- 用户应能理解并调整入口策略、记忆策略、自动化策略、预算与数据维护策略 +- 风险较高的设置必须清楚说明影响范围和生效方式 ------ -## 10. 阶段规划 +## 10. 阶段规划与首版边界 本章回答“这些能力按什么顺序进入版本计划”，不再重复定义模块本身。 @@ -480,6 +384,50 @@ P0 不是最少功能，而是 **必须能让产品成立** 的最小闭环。P0 - 至少一条可信执行链路 - 至少一种未来安排到正式任务的桥接方式 +#### 10.1.1 首版必须包含的范围 + +首版必须至少覆盖以下产品范围： + +- **入口层成立：** 首版至少形成一种自然表达入口、一种轻量补充入口和一种围绕当前对象的稳定承接入口 +- **高频理解成立：** 总结、解释、翻译、错误分析、下一步建议、草稿生成中，至少覆盖最常见的高频办公与信息处理场景 +- **结果承接成立：** 短结果可在近场消费，长结果可进入正式交付层继续查看、打开或复用 +- **任务承接成立：** 用户能看到当前任务状态、等待原因、结果入口和最小安全摘要 +- **治理闭环成立：** 至少一种高风险动作在首版中具备边界解释、确认、结果回看与恢复说明 +- **未来安排桥接成立：** 至少一种事项来源能被整理、建议并升级为正式推进任务 + +#### 10.1.2 首版明确不包含的范围 + +以下内容不作为首版成立条件： + +- 面向开发者的复杂插件生态 +- 多模型路由的高级配置与复杂策略切换 +- 跨设备同步、云端协同和团队级共享能力 +- 大规模自治执行和长链路无人值守自动化 +- 完整的个性化画像管理后台和复杂记忆治理体系 +- 依赖高复杂基础设施的规模化能力与生态能力 + +这些方向只有在核心闭环稳定之后，才进入后续版本规划。 + +#### 10.1.3 首版完成定义 + +首版做到以下结果时，才可认为 P0 闭环成立： + +- 用户能在真实桌面场景下，通过近场入口完成至少一轮“发起 → 获得结果 → 继续推进或结束”的完整协作 +- 至少一种短结果和至少一种长结果都能被正确承接，而不是只停留在近场提示 +- 用户能在工作台中看见当前任务、最小安全摘要、结果入口和最小历史沉淀 +- 至少一条高风险动作链路具备确认、记录和恢复说明 +- 用户能够清楚区分“未来安排”“正在推进的任务”“正式结果”和“风险确认”四类对象 + +#### 10.1.4 首版关键边界 + +首版必须明确守住以下产品边界： + +- 首版不是一个以聊天窗口为主入口的聊天产品 +- 首版不是一个默认全自动、可无限制代替用户执行动作的自治系统 +- 首版不是一个复杂插件平台、多模型控制台或团队协同平台 +- 首版的长期记忆必须可见、可理解、可关闭，不能以黑箱方式主导协作 +- 首版的高风险动作必须经过用户理解和确认，不能以“聪明”为理由绕过边界 + ### 10.2 P1：持续使用体验 P1 解决“能用”之后的“能持续用”，重点包括： @@ -566,14 +514,15 @@ P3 重点扩展能力边界，包括： | 信任治理 | 高风险确认处理率、恢复点查看率、成本查看率 | 验证是否建立边界与信任 | | 长期价值 | 镜子回看率、记忆认可度、个性化建议接受率 | 验证长期协作是否成立 | -### 12.3 首版验收感知 +### 12.3 首版验收标准 -首版达成时，至少应让团队和用户感受到： +首版验收时，至少应满足以下标准： -- 多种主要入口可以在真实场景下完成一轮完整协作 -- 至少一种高风险动作链路是可理解、可确认、可回看的 -- 结果不只停留在气泡，而是能进入正式交付层被继续使用 -- 工作台可以承接当前任务、未来安排、安全摘要和最小长期记忆 +- 至少一类近场发起方式能在真实桌面场景中稳定触发完整协作链路 +- 至少一类短结果和一类长结果都能被正确承接并继续消费 +- 工作台能够承接当前任务、安全摘要、结果入口和最小历史沉淀 +- 至少一条高风险动作链路具备可理解、可确认、可回看的治理过程 +- 用户能够清楚区分未来安排、正式任务、正式交付和风险确认四类产品对象 ------