diff --git a/docs/README.md b/docs/README.md index 9540b4d1..11504b86 100644 --- a/docs/README.md +++ b/docs/README.md @@ -23,6 +23,7 @@ | [银城员工端APP分阶段实施总纲.md](银城员工端APP分阶段实施总纲.md) | 三阶段总纲:陪练 → 大喇叭+知识学习平台(含学模块、开放问题榜、员工个人 AI 助理) → 北森对接;身份三轴模型与防遗漏分发策略 | | [个人AI助理阶段二专项TechSpec.md](个人AI助理阶段二专项TechSpec.md) | 员工个人知识空间的物理分域、数据模型、API、检索融合、权限、安全、删除和测试规格 | | [个人AI助理阶段二开发推进计划.md](个人AI助理阶段二开发推进计划.md) | 个人 AI 助理阶段二按 P0/P1 拆分的逐任务实施、测试、提交和试点闸门 | +| [prototypes/personal-assistant-work-helper-voice-first-v2.png](prototypes/personal-assistant-work-helper-voice-first-v2.png) | 个人助理并入「问 · 数字师傅」后的语音优先会话、自动内部路由与确认记忆卡实现基准 | | [AI陪练二期开发推进计划.md](AI陪练二期开发推进计划.md) | 总纲阶段一执行文档:AI 陪练从 MVP 演示闭环推进到管家(生活顾问)岗位试点可用；区分工程就绪与正式业务试点证据 | | [员工端版本功能对比与功能对齐清单-20260717.md](员工端版本功能对比与功能对齐清单-20260717.md) | 旧版/历史需求/当前实现/生产验收的版本对比，以及 2026-07-17 客户反馈逐项处理结果 | | [BRD_IMPLEMENTATION_AUDIT.md](BRD_IMPLEMENTATION_AUDIT.md) | 当前生产基线、三端输入/BRD 匹配、客户反馈完成分层和正式试点剩余硬门槛；旧发布流水从当前真相源移除 | diff --git a/docs/prototypes/personal-assistant-work-helper-voice-first-v2.png b/docs/prototypes/personal-assistant-work-helper-voice-first-v2.png new file mode 100644 index 00000000..dc376c22 Binary files /dev/null and b/docs/prototypes/personal-assistant-work-helper-voice-first-v2.png differ diff --git a/docs/个人AI助理阶段二专项TechSpec.md b/docs/个人AI助理阶段二专项TechSpec.md index fe37ea98..7be3ba0c 100644 --- a/docs/个人AI助理阶段二专项TechSpec.md +++ b/docs/个人AI助理阶段二专项TechSpec.md @@ -10,6 +10,24 @@ > > v1.1 需求补充：客户明确提出，员工在对话中描述住户需求、待跟进事项或个人经验时，个人助理应识别值得长期保留的信息，返回可编辑确认卡；仅在用户确认后写入对应记忆域，后续问答可按权限召回。模型不得直接修改数据库，提醒必须单独确认。 +## 0. 交互设计基准 + +![工作助手语音优先与确认记忆交互基准](prototypes/personal-assistant-work-helper-voice-first-v2.png) + +设计资产：[personal-assistant-work-helper-voice-first-v2.png](prototypes/personal-assistant-work-helper-voice-first-v2.png) + +该图是阶段二「问」页和确认记忆流程的实现参考，不是当前生产截图。后续 Agent 实施 `mobile-uni/src/pages/user/sop/index.vue` 与记忆确认卡时应遵守以下不变量： + +1. 页面标题保持“问 · 数字师傅”，一级只区分“工作助手 / 查全网”，不增加“个人助理”一级 Tab。 +2. 工作助手自动在已授权的个人资料、项目记录和企业知识中路由；首屏主路径不要求一线员工选择资料域，高级筛选只能放入次级入口。 +3. 会话保持语音优先：输入区默认“按住说话”，键盘为切换能力；师傅回复优先显示语音条，正文可通过“转文字”展开。 +4. ASR 转写以普通用户消息进入同一会话；候选检测不得绕过当前会话、登录态或项目权限。 +5. 确认卡至少展示类型、对象、事项、保存位置、可见范围、明确回访日期和“加入跟进提醒”选项。 +6. “修改 / 暂不保存 / 确认保存”必须是三个独立动作；只有“确认保存”可以触发长期持久化，保存和提醒分别确认。 +7. 回答或保存结果只展示实际使用的来源，不得暗示已查询未命中的资料，更不得自动把内部内容转发到全网。 + +若设计图中的示例文案、间距或字段与本文的数据权限、安全、状态机或 API 约束冲突，以本文约束为准；视觉实现应继续复用现有 `ChatComposer`、女性数字师傅头像和「今日 / 练 / 问 / 我」底栏。 + ## 1. 目标与非目标 ### 1.1 目标 @@ -582,6 +600,8 @@ Message 保存： ## 10. 前端设计 +本节视觉与交互基准见：[工作助手语音优先与确认记忆设计图](prototypes/personal-assistant-work-helper-voice-first-v2.png)。该图对应现有微信式会话的升级目标，不代表另建页面。 + ### 10.1 页面与入口 `mobile-uni` 新增： diff --git a/docs/个人AI助理阶段二开发推进计划.md b/docs/个人AI助理阶段二开发推进计划.md index 24cb7e43..10b1b549 100644 --- a/docs/个人AI助理阶段二开发推进计划.md +++ b/docs/个人AI助理阶段二开发推进计划.md @@ -8,6 +8,8 @@ **Tech Stack:** Spring Boot / Java 21、JdbcTemplate、Sa-Token、MySQL 8 Fulltext、Qdrant REST、MinIO/sys_oss、Apache Tika、uni-app Vue 3、TypeScript、Node test runner。 +**交互设计基准：** [工作助手语音优先与确认记忆设计图](prototypes/personal-assistant-work-helper-voice-first-v2.png)。该图是 Task 10 的实现参考，不是当前生产截图；安全、权限、状态机和 API 冲突时以 [专项 TechSpec](个人AI助理阶段二专项TechSpec.md) 为准。 + --- ## 0. 执行边界 @@ -977,6 +979,10 @@ Expected: 单测 PASS；匿名请求业务响应为 401，接口没有 @SaIgnore ### Task 10: 将现有「问」页升级为工作助手并接入个人助理 +**Design reference:** [personal-assistant-work-helper-voice-first-v2.png](prototypes/personal-assistant-work-helper-voice-first-v2.png) + +实现时复用当前 `ChatComposer` 的默认语音模式和师傅回答的“语音条 → 转文字”形态，不重建第二套会话组件。设计图中的确认卡用于约束信息层级和关键动作；首屏不暴露三种内部资料域，来源在回答或保存结果中按实际命中展示。 + **Files:** - Create: mobile-uni/src/services/personal-assistant.ts - Create: mobile-uni/src/pages/user/assistant/library.vue