feat: add project-scoped work assistant results

This commit is contained in:
2026-07-21 04:44:15 +08:00
parent 53b15e506c
commit 4536d607e3
75 changed files with 3281 additions and 507 deletions
@@ -1,6 +1,6 @@
# 银城数字师傅产品方案(整合修订)
> 版本:v1.5 | 日期:2026-07-19
> 版本:v1.7 | 日期:2026-07-21
> 输入源:①客户方《物业数字师傅系统三期建设方案》(2026-07-08 早,下称"第三版")②《企业内部AI培训学习APP产品需求与发布会内容讨论》会议纪要(2026-07-08)③客户方会后微信补充(学模块课程化+考试;巡检点位转入职学习任务)④2026-07-11 客户微信语音补充(员工个人 AI 助理/个人知识空间)。
> v1.1 重构:按"产品是什么 → 发布会做什么 → 决策记录 → 执行"四部分分层,产品定义与发布会演示不再混写。
> v1.2 更新(2026-07-08,客户回复三项待确认):①多端跳转议题**暂缓**,现阶段只保证能打开小程序页面;②工作积分排行榜**保留功能、可选择不用**(开关配置);③员工评价管理团队**按组织架构与权限控制**,需有权限才能评价。详见 §3.3。
@@ -8,6 +8,7 @@
> v1.4 更新(2026-07-19):个人助理增加确认式长期记忆,并把一级入口收敛为“工作助手 / 查全网”;内部个人资料、项目记录和企业知识默认自动路由,来源在答案中透明展示。
> v1.5 更新(2026-07-19):“工作上报”由传统表单主路径改为微信式语音/照片/视频会话,AI 整理并按需追问,用户确认后才提交既有审核链。
> v1.6 更新(2026-07-19):“记一下”升级为确认式统一采集。系统先建议服务线索、住户画像、优秀案例、个人想法、待跟进事项或工作记录,用户选择仅自己保存或提交公司处理;位置字段缺失不阻断保存,公司处理在正式接口接入前只标记待流转。
> v1.7 收口(2026-07-21):日常工作采集统一归“工作助手”,按自然日汇总为“今日工作成果”;现有 CASE/VIDEO/SOP/KNOWLEDGE 审核链产品语义收敛为“成果投稿”,当前页面和 API 名称仍保留“工作上报”。项目工作记录后续必须从项目名称下拉列表确认当前项目,不要求用户输入项目编码。施工顺序见[专项迭代计划](../工作助手与今日工作成果迭代计划-20260721.md)。
> 与《银城员工端APP分阶段实施总纲》《AI陪练二期开发推进计划》的关系:本方案是增量修订,不推翻既有阶段划分;§4.2 回写清单已于 2026-07-08 执行——总纲升 v0.3、二期计划升 v0.8。BRD 已升至 v1.4,同步个人助理与工作上报交互定案;BRD 4.4 师徒演练等旧口径仍待后续版本继续修订。
---
@@ -79,21 +80,21 @@
- **打勾/打叉**:每条 AI 答案可标好/差;打叉的知识条目在该问题上后续**不再推送**,并进后台待复核清单——解决"错误知识反复出现"的历史问题;
- 悬赏问答不在问模块内,独立为问题榜(1.3.5)。
### 1.3.4 报——案例上报与经验沉淀
### 1.3.4 报——成果投稿与经验沉淀
> 高保真实现基准:[工作上报微信式语音会话 v1](../prototypes/work-report-voice-conversation-v1.png)。该图是目标交互,不是当前生产截图。
> 高保真实现基准:[工作上报微信式语音会话 v1](../prototypes/work-report-voice-conversation-v1.png)。当前会话式页面已实现,该图只作为视觉回归基准,不代表工作助手日常采集或今日成果页面。
![工作上报微信式语音会话高保真设计](../prototypes/work-report-voice-conversation-v1.png)
- **2026-07-19 交互定案**:员工端不再以“先选类型 → 填标题 → 填说明 → 传附件”的传统表单作为主路径,而是复用「问」的微信式会话语言。首页“工作上报”仍作为清晰任务入口,进入后直接提示“今天处理了什么?按住说,也可以发照片或视频”。
- 主流程固定为:`语音/文字/照片/视频 → ASR 与 AI 理解 → 必要时追问 1–2 个缺失信息 → 生成结构化确认卡 → 用户确认上报 → 主管/运营审核 → 会话内展示状态`。
- **当前交互**:员工端已经不再以“先选类型 → 填标题 → 填说明 → 传附件”的传统表单作为主路径,而是复用「问」的微信式会话语言。当前首页和页面仍显示“工作上报”,后续迭代 4 再统一改成“成果投稿”。
- 主流程固定为:`语音/文字/附件 → ASR 与文字整理 → 必要时追问 1–2 个缺失信息 → 生成结构化确认卡 → 用户确认上报 → 主管/运营审核 → 会话内展示状态`。当前附件可以保存,但整理服务不会读取图片/视频内容,不能宣传为已完成视觉理解。
- 前端默认复用现有 `ChatComposer`:语音优先,键盘次之;图片、视频和音频继续走附件入口。不得为了“报”再建设第二套录音、附件或聊天组件。
- “优秀案例 / 操作视频 / 完整 SOP / 有用知识”仍是后台结构化类型,但由 AI 优先判断并在确认卡中展示,员工可以修改,不要求普通员工在表达前理解分类。
- 确认卡至少展示类型、标题、事情经过、处理方法、结果和附件;卡片动作收敛为“修改 / 确认上报”,继续补充直接使用底部语音/文字输入,避免重复入口。只有明确点击“确认上报”才能创建正式记录,AI 不得自动提交。
- “我的上报”作为历史入口,审核中、已通过、已驳回及审核意见以会话消息或状态卡呈现。审核通过只代表上报通过;最终进入案例库或知识库仍由运营在对应模块人工完成,不自动入库。
- 上报目标仍为**每个生活顾问每月至少 1 个有价值案例**;后台采纳后计学分并署名,与问题榜优质回答共同构成“行业经验知识库”原料。
- “工作上报”与“记一件事”必须区分:前者会提交给企业审核并可能共享入库,后者只进入已授权的个人或项目记忆域;两者都必须在最终动作前向用户说明保存范围。
- “报”字面易与报事报修歧义,对外入口统一使用“工作上报”,不使用单独的“报”字作为页面标题。
- “成果投稿”与“工作助手记一件事”必须区分:前者会提交给企业审核并可能共享入库,后者进入本人日常工作记录或待公司处理队列;两者都必须在最终动作前说明保存范围。
- “报”字面易与报事报修、日常汇报混淆。当前代码兼容“工作上报”名称,后续产品文案统一迁移到“成果投稿”,不再新增第三种同义入口。
高保真评审后的实施修订:
+12 -5
View File
@@ -14,12 +14,14 @@
| 案例沉淀 `/knowledge/cases` | `GET /api/knowledge/case/capabilities`、`POST /api/knowledge/case/upload`、`/organize`、`/curate`、`GET /records`、`GET /records/{caseId}`、`POST /records/{caseId}/review`、`GET /records/{caseId}/media` | `/capabilities` 返回服务端判定的案例提交/查看能力,移动端不再向普通员工展示无权提交的素材表单;`/upload` 改为 multipart 真实语音上传并走 ASR,服务端只接受 MP3/WAV/M4A/WebM/OGG/AAC/FLAC,成功后原始音频写入 `sys_oss`,案例记录只保存 `mediaOssId` 供受保护媒体接口读取,不向客户端回传原始 `mediaUrl`;`/organize` 用真实转写调 chat 模型整理案例,未配置模型时按真实 transcript 本地结构化,并从背景外的真实摘要项提取学习点;APP 用户的项目范围从 `aihr_org_snapshot` 登录身份解析,上传、整理、入库、列表和详情均按项目范围校验,未完成正式组织映射时安全拒绝,不接受前端伪造项目范围;员工列表/详情只返回 `已入库` 案例,管理端系统用户保留全局运营视图;移动端和管理端案例详情通过受保护媒体接口回放原始音频,主管/项目负责人可提交脱敏点评;预渲染视频样片仍待正式媒体资产接入 |
| 案例媒体安全 | `GET /api/knowledge/case/records/{caseId}/media` | 案例详情只返回 `mediaOssId`,不返回原始 `sys_oss.url`;媒体下载会重复执行登录、后台角色或 APP 项目范围校验,再由服务端流式读取 OSS。管理端与 `mobile-uni` 通过鉴权 blob/temp 文件播放,关闭详情页时释放本地对象 URL |
| 问师傅与 SOP 知识库 `/pages/user/sop/index`、`/knowledge/sop` | `POST /api/knowledge/query`、`POST /api/knowledge/query-media`、`GET /api/knowledge/resources/{attachmentId}/content`、`POST /api/knowledge/answer-feedback`、`GET /api/knowledge/position-sop`、`GET /api/aihr/mobile/onboard/tasks`、`POST /api/aihr/mobile/onboard/tasks/{id}/complete`、`GET /api/aihr/mobile/qualification`、`POST /api/knowledge/doc/upload` | 文字/现场附件查询走统一知识空间授权和 MySQL Fulltext + Qdrant 混合召回;内部登录端可选传 `conversationId/contextVersion`,服务端保留 30 分钟不活跃过期、最近 6 轮脱敏截断上下文,用现有 chat 模型或保守规则输出 `QA/FILE/VIDEO/DATA_TOOL` 和 `rewrittenQuery`,旧版本冲突返回 `409`。原文件/视频仅从当前命中且仍有授权的附件返回,内容接口每次重新计算租户、应用和主体权限;无资源时明确返回空列表,不生成假链接。旧客户端和外部 API 保持单轮无状态。搜索继续返回 `reviewId/promptVersion`,员工反馈保存评审批次;详细边界见 [专项设计](20260718/问师傅多轮会话与原始资料交付设计.md)。员工学习页按当前 APP 身份读取正式岗前/入职任务,资格证据无正式数据时明确返回 `NOT_CONFIGURED` |
| 工作助手确认式统一采集 `/pages/user/sop/index`、`/pages/user/assistant/memories` | 既有 `POST /api/knowledge/query` 可选返回 `memoryCandidate`;`GET /api/aihr/personal-assistant/memory-candidates?status=DRAFT`、`POST /api/aihr/personal-assistant/memory-candidates/{id}/confirm`、`POST .../{id}/dismiss`、`GET /api/aihr/personal-assistant/assistant-captures?limit=50`;旧项目记录继续使用 `/api/aihr/service-memories` | 文字或 ASR 转写复用同一候选检测。显式“记一下”生成 `ASSISTANT_CAPTURE/DRAFT`,项目和房屋位置缺失只作可选提示;系统建议 `SERVICE_LEAD/RESIDENT_PROFILE/CASE/PERSONAL_NOTE/FOLLOW_UP/PROJECT_NOTE`。确认必须带 `expectedVersion + idempotencyKey + saveScope(PRIVATE|COMPANY)`;PRIVATE 仅本人可见,COMPANY 写入 PENDING 待流转,正式外部接收端未配置前不得显示已送达。提醒默认关闭且单独确认;音色不在本次范围 |
| 工作助手确认式统一采集 `/pages/user/sop/index`、`/pages/user/assistant/memories` | 既有 `POST /api/knowledge/query` 和 `POST /api/knowledge/query-media` 可选返回 `memoryCandidate`;`GET /api/aihr/personal-assistant/memory-candidates?status=DRAFT`、`POST /api/aihr/personal-assistant/memory-candidates/{id}/confirm`、`POST .../{id}/dismiss`、`GET /api/aihr/personal-assistant/assistant-captures?limit=50`、`POST /assistant-captures/{id}/status`、`GET /assistant-captures/{id}/status-history`、`GET /assistant-captures/{id}/source`;旧项目记录继续使用 `/api/aihr/service-memories` | 文字、ASR 转写和现场媒体复用同一候选检测。项目工作必须从 `/api/aihr/mobile/me` 返回的项目名称列表选择当前项目,内部 `projectCode` 仍由服务端按当前登录主体授权收窄;个人笔记可以不绑定项目。显式“记一下”生成 `ASSISTANT_CAPTURE/DRAFT`,系统建议 `ATTENDANCE/INSPECTION/SERVICE_LEAD/RESIDENT_PROFILE/CASE/PERSONAL_NOTE/FOLLOW_UP/PROJECT_NOTE`。确认必须带 `expectedVersion + idempotencyKey + saveScope(PRIVATE|COMPANY)`;PRIVATE 仅本人可见,COMPANY 写入 PENDING 待流转。状态更新只允许 `RECORDED/PENDING/IN_PROGRESS/COMPLETED/VOID`,幂等键不得跨记录或目标状态复用。来源文件重新鉴权交付;正式外部接收端未配置前不得显示已送达 |
| 今日工作成果 `/pages/user/work-results/index`、`/pages/supervisor/work-results/index` | 员工 `POST /api/aihr/work-results/mine/generate?projectCode=...&workDate=YYYY-MM-DD`;主管 `GET /api/aihr/work-results/project?projectCode=...&workDate=YYYY-MM-DD` | 按员工 + 项目 + Asia/Shanghai 自然日确定性聚合已确认记录;内容未变化时重复生成不增加版本,记录或状态变化后版本递增。主管只可查看本人在目标项目具备主管身份的团队结果,普通员工或跨项目请求返回 403。外部接口未接通时只显示本地状态和 PENDING,不伪造派单或考勤同步成功 |
| 成果投稿(当前页面名“工作上报”)`/pages/user/report/index` | `POST /api/aihr/work-report/organize`、`POST /attachment`、`POST /reports`、`GET /reports/mine`;主管/运营另有列表和审核接口 | 只承载 CASE/VIDEO/SOP/KNOWLEDGE 四类投稿。会话式页面、无状态整理、附件、幂等正式提交和历史状态已部署;审核通过不自动入知识库。当前整理服务不读取图片/视频内容,只把附件名称作为不可信元数据;不得与日常工作记录或“今日工作成果”混用 |
| 资料处理 `/knowledge/processing` | `GET /api/knowledge/processing/overview`、`POST /api/knowledge/doc/upload-async`、`GET /api/knowledge/doc/upload-items`、`POST /api/knowledge/doc/upload-items/{id}/retry` | 已接入解析任务状态聚合;页面只保留“批量导入”,接口暂存+入队即秒回,后台 worker(并发 2)逐条解析/归类/向量化;ZIP 在 worker 内安全解压后把支持的子文件继续入同一批次队列,页面按批次轮询进度、失败可单文件重试;不提供浏览器目录选择或服务端目录导入入口 |
| 组织人员同步 | `POST /api/aihr/org/sync` | 从开放组织同步系统的 `/api/open/v1/sync/snapshot` 拉取 `company/department/employee` 快照,分页参数使用 `limit`;员工手机号只落 `person_phone` 用于移动端身份映射,不在组织列表响应暴露;岗位识别 `position/job_title/post/job_name/role/title` 等字段。`dryRun` 必须显式传入 `true`(预检)或 `false`(写入),省略或传 `null` 直接拒绝,避免空请求意外写库;默认 `replaceExisting=true`,写入前必须先用 `{"dryRun":true}`;dry-run 不访问本地快照表、不执行 DDL/写库,返回 `phoneLinked/maskedPhone/suspectText/warnings` 且 `syncedCount=0`。非 dry-run 覆盖写入遇到员工被跳过、手机号不完整、脱敏手机号或疑似乱码时默认拒绝,只有确认 dry-run 结果后显式传 `allowPartialReplace=true` 才允许覆盖;重复 `ext_party_id` 始终拒绝写入,因为数据库唯一键会折叠重复身份;`replaceExisting=false` 不触发不完整快照覆盖闸门,但仍拒绝重复身份。2026-07-15 线上已用 `/api/open/v1` 前缀完成配置、dry-run 和覆盖同步:开放平台返回公司 17、部门 963、员工 3417;生产 `aihr_org_snapshot` 为 3417 行,`phoneLinked=3392`、`maskedPhone=25`、`suspectText=0`,在职 2943、离职 474。当前剩余 25 人手机号不可用属于上游数据质量问题;功能发布不再被组织同步能力阻塞 |
| 组织人员同步 | `POST /api/aihr/org/sync` | 从开放组织同步系统的 `/api/open/v1/sync/snapshot` 拉取 `company/department/employee/employee_project_assignment` 快照,分页参数使用 `limit`;员工手机号只落 `person_phone` 用于移动端身份映射,不在组织列表响应暴露;岗位识别 `position/job_title/post/job_name/role/title` 等字段。`dryRun` 必须显式传入 `true`(预检)或 `false`(写入),省略或传 `null` 直接拒绝,避免空请求意外写库;默认 `replaceExisting=true`,写入前必须先用 `{"dryRun":true}`;dry-run 不访问本地快照表、不执行 DDL/写库,返回 `phoneLinked/maskedPhone/suspectText/warnings` 且 `syncedCount=0`。非 dry-run 覆盖写入遇到员工被跳过、手机号不完整、脱敏手机号或疑似乱码时默认拒绝,只有确认 dry-run 结果后显式传 `allowPartialReplace=true` 才允许覆盖。相同员工可由多条有效项目分配展开为多个项目成员行,唯一约束为 `tenant_id + project_code + ext_party_id`;只拒绝同一项目内的重复成员关系。`replaceExisting=false` 不触发不完整快照覆盖闸门,但仍拒绝同项目重复关系。2026-07-15 线上已用 `/api/open/v1` 前缀完成配置、dry-run 和覆盖同步:开放平台返回公司 17、部门 963、员工 3417;生产 `aihr_org_snapshot` 为 3417 行,`phoneLinked=3392`、`maskedPhone=25`、`suspectText=0`,在职 2943、离职 474。该统计发生在多项目成员迁移前;发布迁移后必须重新 dry-run 并核对展开后的项目成员行数。当前剩余 25 人手机号不可用属于上游数据质量问题 |
| 移动端手机号登录 | `GET /resource/sms/code`、`POST /auth/mobile/sms-login` | 已复用 sms4j 阿里云配置 `config1` 和 RuoYi `sms` 授权策略;短信发送成功后才写 Redis 验证码;手机号不存在时自动注册 `app_user`;`aihr.sms.dev-fixed-code` 非空时不真发短信、验证码固定(dev 默认 `123456`)。prod 默认关闭,试点期只有同时设置 `AIHR_SMS_DEV_FIXED_CODE` 与 `AIHR_SMS_PROD_FIXED_CODE_ENABLED=true` 才启用固定码。 |
| 用户侧三端首页 `mobile-uni` hash 路由;旧 `/h5/user`、`/h5/candidate`、`/h5/supervisor` 兼容重定向 | `GET /api/aihr/mobile/home/{role}` | 未登录请求只返回不读取租户业务统计的公开首屏 seed;已登录移动端请求自动携带 `Authorization/clientid`,才返回员工/主管真实统计;移动端本地 fallback 保演示 |
| 移动端登录后角色识别 | `GET /api/aihr/mobile/me` | 认证后按手机号匹配组织快照;`position_level` 为“主管/项目经理”时进入主管端,否则进入员工端;接口失败回退员工端 |
| 移动端登录后角色识别 | `GET /api/aihr/mobile/me` | 认证后按手机号匹配组织快照;`position_level` 为“主管/项目经理”时进入主管端,否则进入员工端。响应返回去重后的 `projects[]` 供页面按项目名称选择,不要求用户输入或记忆编码;同一人员在多个项目的快照行按 `tenant_id + project_code + ext_party_id` 保留。接口失败回退员工端 |
| 移动端员工训练与主管复盘闭环 | 员工复用 `POST /api/train/practice/start`、`/turn`、`/finish`,查询 `GET /api/aihr/mobile/practice/history`、`/practice/mistakes`、`/profile`;训练完成后提交 `POST /api/aihr/mobile/practice/satisfaction`;主管查询 `GET /api/aihr/mobile/practice/team`、`/practice/alerts`、`/practice/reviews`、`/practice/reviews/{id}`,标记 `POST /api/aihr/mobile/practice/reviews/{id}/reviewed`,指派 `POST /api/aihr/mobile/practice/assignments` | 员工端登录后带 `Authorization` 与 `clientid` 调用;`mode=mobile` 完成后写入 `aihr_practice_session`。满意度接口只接受本人已完成训练的 1-5 分,意见脱敏后落库,未填写不补默认值。错题本按员工本人聚合低分/红线回合,并关联已有 `retry` assignment,不伪造错题结论。主管 `/practice/team` 在同一项目权限范围内额外返回 `mistakes` 聚合,按场景/归因统计次数、影响人数、平均分和最近发生时间;普通员工返回“无主管权限”。主管接口以后端当前登录手机号映射在职组织快照,仅允许岗位为“主管/项目经理”的账号,并按租户和项目范围返回真实成员、全状态训练记录及非 daily 专项。复盘标记只允许首次 `待复盘 -> 已复盘` 创建后续专项,并发重复提交幂等;可带 `incentivePoint` 写入贡献度。每日三题正式只对 `hire_date` 在当前日期前三个月内的在职员工派发;没有入职日期时不使用训练次数推断,开发 Demo 的旧回退只有在 `dev/local` profile 且由 `aihr.practice.allow-legacy-daily-drill-fallback` 显式开启时生效,生产 profile 强制关闭。 |
| 移动端候选人闭环 | 页面拆为 `/pages/candidate/index/index`、`/interview/index`、`/materials/index`、`/progress/index`、`/study/index`;面试复用 `POST /api/recruit/interview/start`、`/answer`、`/finish` 和 `GET /records`;资料 `POST/GET /api/aihr/mobile/candidate/materials`;预习 `POST /api/knowledge/search`;HR 审核 `GET /api/aihr/hr/candidate/materials`、`POST /api/aihr/hr/candidate/materials/{id}/review` | 候选人端登录后带 `Authorization` 与 `clientid` 调用;首页只按当前手机号对应的真实面试记录和最新资料状态分流,不读取公开 home seed。APP 候选人身份以后端登录手机号为准,前端 `candidateId/candidateName` 只作非 APP 场景兼容参数;面试支持文字作答和复用 `/api/ai/asr` 的录音转文字/选音频,`/answer` 可带可选 `answerAudioOssId`,服务端只接受当前候选人名下处于 `staged/bound` 状态的音频并将 `ossId` 写入问题快照,不向客户端暴露原始 OSS URL;`/answer` 与 `/finish` 还会校验当前 APP 手机号与启动会话的候选人 ID 一致,未知或他人会话直接拒绝;面试拉题/评分走真实模型优先;资料写 `sys_oss`/MinIO 和 `aihr_candidate_material`,HR 审核后进度页同步三态;岗前预习查询正式 SOP,不兜前端示例答案 |
| 每日题反馈与常见难题 | `POST /api/aihr/mobile/practice/assignments/{id}/feedback`、`GET /api/aihr/mobile/practice/difficulties`、`POST /api/aihr/mobile/practice/difficulties/assign` | 反馈区分题目有用性与答案正确性;主管/管理端按岗位、时间、次数、人数和均分聚合,并可基于难题创建专项;身份和项目范围由服务端解析 |
@@ -224,6 +226,8 @@ Content-Type: application/json
## 工作助手确认式统一采集
本节记录当前已经部署的接口。当前版本仍允许候选项目为空,也没有当前项目下拉、项目化短会话、原始媒体绑定或今日工作成果接口;这些属于[《工作助手与今日工作成果迭代计划》](工作助手与今日工作成果迭代计划-20260721.md),在代码和接口落地前不得提前写入本指南的可调用接口表。
该链路复用上面的短会话请求,不新增另一套问答 session。登录员工说“帮我记一下三栋 3203 需要保洁服务”时,`POST /api/knowledge/query` 在正常回答字段之外可返回;缺少单元不会阻断用户保存:
```json
@@ -249,7 +253,7 @@ Content-Type: application/json
}
```
确认请求只提交用户在卡片上确认或修改的草稿;`projectCode` 即使传入也不能作为授权依据:
确认请求只提交用户在卡片上确认或修改的草稿。`PERSONAL_NOTE` 可以不绑定项目;晨会、巡检、业主服务、画像、线索等项目工作必须先由用户按项目名称选择,草稿携带内部 `projectCode`,但服务端仍以当前登录主体的授权项目集合复核,不能把客户端字段当授权依据:
```http
POST /api/aihr/personal-assistant/memory-candidates/301/confirm
@@ -262,15 +266,18 @@ Content-Type: application/json
"saveScope": "COMPANY",
"enableReminder": false,
"draft": {
"projectCode": "PRJ-XHW1",
"buildingName": "3栋",
"unitName": "",
"roomNo": "3203",
"category": "服务线索",
"summary": "需要保洁服务",
"occurredAt": "2026-07-19T14:00:00+08:00",
"workDate": "2026-07-19",
"businessStatus": "PENDING",
"followUpAt": null
}
}
```
服务端在事务中锁定候选,写入 `aihr_assistant_capture` 后才把候选改为 `CONFIRMED`。`PRIVATE` 对应 `deliveryStatus=NOT_REQUIRED`;`COMPANY` 对应 `PENDING`。`DRAFT` 默认 24 小时过期,列表查询强制过滤当前租户与 owner。`GET /api/aihr/personal-assistant/assistant-captures?saveScope=COMPANY&limit=50` 只展示本人的企业流转状态;PENDING 不是已生成工单或已上报成功。后续 `/api/knowledge/query` 可受控召回确认记录,引用域分别为 `PERSONAL / COMPANY / PROJECT_SERVICE`;个人和公司采集按 `tenant_id + owner_user_id` 过滤,旧项目记录继续按项目权限过滤。
服务端在事务中锁定候选,写入 `aihr_assistant_capture` 后才把候选改为 `CONFIRMED`。`PRIVATE` 对应 `deliveryStatus=NOT_REQUIRED`;`COMPANY` 对应 `PENDING`。`DRAFT` 默认 24 小时过期,列表查询强制过滤当前租户与 owner。`GET /api/aihr/personal-assistant/assistant-captures?saveScope=COMPANY&limit=50` 只展示本人的企业流转状态;PENDING 不是已生成工单或已上报成功。状态更新带独立 `idempotencyKey`,相同记录和目标状态可安全重试,跨记录或跨目标状态复用返回 409。`/api/knowledge/query` 可受控召回确认记录,引用域分别为 `PERSONAL / COMPANY / PROJECT_SERVICE`;个人和公司采集按 `tenant_id + owner_user_id` 过滤,旧项目记录继续按项目权限过滤。
+5 -3
View File
@@ -1,6 +1,6 @@
# BRD 功能审查与未完成项记录
> 当前基线:2026-07-18,生产功能包提交 `064816a784dad535f2320c4321f73f2e6e364d69`。
> 当前基线:2026-07-21。阶段一生产功能包以 `064816a784dad535f2320c4321f73f2e6e364d69` 为已记录基线;2026-07-20 确认式采集与会话式工作上报增量另按生产 JAR、H5 资源和数据库结构复核。
>
> 本文只维护当前结论、证据层级和剩余门槛。逐提交发布流水已从当前真相文档移除,需要追溯时使用 Git 历史;不得再用 2026-07-14/15 的“尚未发布”记录判断现网。
@@ -21,9 +21,11 @@
“已部署”不等于“正式试点通过”。当前可以确认生产包和基础运行状态,不能把未执行的正式账号、真机和业务窗口验收写成已完成。
### 未发布工作区增量(2026-07-20)
### 2026-07-20 已部署增量与验收边界
工作助手“记一下”统一采集已完成本地编码、数据库迁移、目标测试、390×844 视觉交互和真实 HTTP 召回验证;`PRIVATE` 仅本人可见,`COMPANY` 只写 `PENDING`。该增量尚未提交或部署,不属于上表的生产包;外部线索/工单投递、正式回执、个人文件/网页知识空间仍未实现。
工作助手“记一下”统一采集已提交并部署:生产 `ruoyi-aihr` 包包含 `AihrMemoryService`,H5 包含确认卡资源,生产库存在 `aihr_memory_candidate/aihr_assistant_capture` 及关键确认、范围和流转字段。会话式工作上报也已出现在生产 H5 与后端包中,生产 `aihr_work_report` 已有幂等字段。以上属于生产基础存在性复核;本轮未重新执行正式账号端到端、多项目、真机媒体或真实审核样本验收。
`PRIVATE` 仅本人可见,`COMPANY` 只写 `PENDING`。项目名称选择、项目化会话、确认记录来源绑定、员工今日成果和主管项目成果已完成本地实现与 390×844 验证,尚未部署和生产验证;外部线索/工单投递、正式回执及个人文件/网页知识空间仍未实现。后续顺序以[《工作助手与今日工作成果迭代计划》](工作助手与今日工作成果迭代计划-20260721.md)为准。
## 2. 三端输入与 BRD 匹配
+3 -1
View File
@@ -14,7 +14,7 @@
上述事实只证明本批版本和 schema 已发布。正式 OTP、真机能力、角色权限正反例和严格试点窗口仍需按发布后回归及 `DEMO_ACCEPTANCE.md` 验收。
2026-07-20 待发布增量把“项目服务记忆最小切片”扩展为工作助手确认式统一采集:显式“记一下”生成候选,用户确认后按 `PRIVATE/COMPANY` 写入 `aihr_assistant_capture`;个人记录仅本人可见,公司记录先保持 `PENDING`,正式接收端和回执尚未实现。旧 `aihr_service_memory/version` 继续兼容项目记录;本批仍不包含个人文件/网页知识空间、自动派单或向量化个人资料。同批“工作上报语音会话化”只为既有 `aihr_work_report` 补 `request_key/request_hash` 和唯一索引。加入统一采集表后,待发布结构门禁为 `41/41`。
2026-07-20 增量已把“项目服务记忆最小切片”扩展为工作助手确认式统一采集:显式“记一下”生成候选,用户确认后按 `PRIVATE/COMPANY` 写入 `aihr_assistant_capture`;个人记录仅本人可见,公司记录先保持 `PENDING`,正式接收端和回执尚未实现。旧 `aihr_service_memory/version` 继续兼容项目记录;本批仍不包含项目名称选择、今日工作成果、原始来源绑定、个人文件/网页知识空间、自动派单或向量化个人资料。同批“工作上报语音会话化”继续使用既有 `aihr_work_report`,并补 `request_key/request_hash` 和唯一索引。2026-07-21 只读复核确认生产 JAR、H5 资源、两张确认式采集表和工作上报幂等字段存在;完整迁移计数仍应在下一次发布前由 `release-preflight.sh` 重跑,不沿用历史 `41/41` 数字。
## 发布前置条件
@@ -52,6 +52,8 @@ mysql --default-character-set=utf8mb4 "$DB_NAME" < backend/script/sql/update/aih
mysql --default-character-set=utf8mb4 "$DB_NAME" < backend/script/sql/update/aihr_20260718_release_collation_compat_mysql8.sql
mysql --default-character-set=utf8mb4 "$DB_NAME" < backend/script/sql/update/aihr_20260718_unify_all_collations_mysql8.sql
mysql --default-character-set=utf8mb4 "$DB_NAME" < backend/script/sql/update/aihr_20260719_service_memory_mysql8.sql
mysql --default-character-set=utf8mb4 "$DB_NAME" < backend/script/sql/update/aihr_20260721_org_multi_project_membership_mysql8.sql
mysql --default-character-set=utf8mb4 "$DB_NAME" < backend/script/sql/update/aihr_20260721_work_assistant_results_mysql8.sql
mysql --default-character-set=utf8mb4 "$DB_NAME" < backend/script/sql/update/aihr_20260719_work_report_idempotency_mysql8.sql
mysql --default-character-set=utf8mb4 "$DB_NAME" < backend/script/sql/update/aihr_20260719_web_ai_database_secret_mysql8.sql
mysql --default-character-set=utf8mb4 "$DB_NAME" < backend/script/sql/update/aihr_20260719_web_search_qwen_mysql8.sql
+1 -1
View File
@@ -1,6 +1,6 @@
# 一期 MVP 演示与验收清单
本文件是 MVP 现场演示入口:先跑预检,再按演示流逐条点击。当前证明一期 MVP 路径可讲、可点、可截图;用户侧三端已在 `mobile-uni/` 按真实页面栈重建,portless 入口为 `https://wygj-mobile-uni.localhost/h5/`,已接手机号登录、问师傅、员工训练、员工学习、案例素材、候选人面试/资料和主管复盘/派专项;员工端训练完成后写入 `aihr_practice_session`,用于训练历史、主管待复盘列表和能力画像;候选人端面试复用 AI 面试 API,补充资料上传写 `sys_oss` 和 `aihr_candidate_material`,HR 可在管理端审核通过/驳回;SOP 检索已可查本地 MySQL seed 片段,并支持 txt/md/PDF/Word/Excel/PPT 上传解析为本地 fragment,配置 vector 模型后会写入 embedding 并尽力同步 Qdrant,管理端 AI 面试和案例沉淀按真实模型/ASR 优先验收。
本文件是当前能力的 MVP 现场演示入口:先跑预检,再按演示流逐条点击。它不包含尚未实施的项目名称选择、项目化会话、原始来源绑定、今日工作成果或主管项目日报;这些以[后续迭代计划](工作助手与今日工作成果迭代计划-20260721.md)为准。当前证明一期 MVP 路径可讲、可点、可截图;用户侧三端已在 `mobile-uni/` 按真实页面栈重建,portless 入口为 `https://wygj-mobile-uni.localhost/h5/`,已接手机号登录、问师傅、员工训练、员工学习、案例素材、候选人面试/资料和主管复盘/派专项;员工端训练完成后写入 `aihr_practice_session`,用于训练历史、主管待复盘列表和能力画像;候选人端面试复用 AI 面试 API,补充资料上传写 `sys_oss` 和 `aihr_candidate_material`,HR 可在管理端审核通过/驳回;SOP 检索已可查本地 MySQL seed 片段,并支持 txt/md/PDF/Word/Excel/PPT 上传解析为本地 fragment,配置 vector 模型后会写入 embedding 并尽力同步 Qdrant,管理端 AI 面试和案例沉淀按真实模型/ASR 优先验收。
## 演示前预检
+1
View File
@@ -219,6 +219,7 @@ RELEASE_REMOTE_URL=https://peilian.njzhmj.top RELEASE_VERIFY_REMOTE_MATCH=true R
- 资料处理:进入 `/knowledge/processing`,应看到资料总量、解析任务表、处理链路、规则与风险;页面只保留“批量导入”和“刷新”,不应出现“选择目录”“服务端导入”或目录导入任务面板。**批量导入走异步队列**:提交即返回,页面出现“本次批量上传”进度面板(排队/加工中/完成/失败 + 单条重试),后台 worker 并发 2 逐条解析入库;支持多文件和 ZIP,暂存目录默认 `./.data/staging`(`aihr.upload.staging` 覆盖)。
- uni-app 员工端:进入 `https://wygj-mobile-uni.localhost/h5/#/pages/user/today/index`,手机号登录(dev 验证码固定 `123456`)。今日页进入问师傅、练习、案例素材和个人页;练习页应能完成开始练习、提交回应、结束评分、每日三题提交,个人页同步训练历史和成长证据包。每日三题正式按组织快照 `hire_date` 判断入职三个月窗口;本地 Demo 若快照尚无该字段,仅由 `dev/local` profile 且 `application-dev.yml` 的 `aihr.practice.allow-legacy-daily-drill-fallback=true` 启用训练次数回退,生产 profile 即使误传环境变量也强制关闭。
- 工作助手确认式统一采集:`/h5/#/pages/user/sop/index` 一级入口只保留“工作助手 / 查全网”,既有文字、ASR、媒体、数据工具和 30 分钟/最近 6 轮短会话链保持不变;显式“记一下/帮我记/保存一下”返回 `DRAFT` 确认卡,位置缺失只作可选提示。确认后写 `aihr_assistant_capture`:`PRIVATE/NOT_REQUIRED` 仅本人可见,`COMPANY/PENDING` 只表示待流转;旧项目记录继续使用 `aihr_service_memory/version`。`/h5/#/pages/user/assistant/memories` 展示待确认候选和本人已确认记录;不依赖新的 Qdrant collection,提醒默认关闭。
- 上一条只验证当前已部署的确认式采集;项目名称下拉、项目化会话、原始来源绑定、今日工作成果和主管按日汇总仍属[后续迭代](工作助手与今日工作成果迭代计划-20260721.md),不得在本地回归结果中写成已完成。
- 移动端登录后若组织快照接口返回 `401/403`,只降级为手动岗位确认,不应清除手机号登录态;岗位确认页仍需允许员工选择“生活顾问”后继续进入业务页。
- uni-app 主管端:进入 `https://wygj-mobile-uni.localhost/h5/#/pages/supervisor/index/index`,应看到团队概览、团队画像、团队预警、指派专项、待复盘和复盘详情;从团队画像派专项后,最近专项应立即回读新记录。
- uni-app 候选人端:进入 `https://wygj-mobile-uni.localhost/h5/#/pages/candidate/index/index`,手机号登录(dev 验证码固定 `123456`)→ “开始面试/面试练习”完成答题评分;“补充资料”选择 PDF/Word/图片后上传,应看到资料状态。Codex 内置浏览器不支持本地文件选择时,用真实 HTTP multipart smoke 代替浏览器文件选择。
+9 -9
View File
@@ -20,7 +20,7 @@
- 本矩阵回答“Figma 设计的页面在代码/线上完成到什么程度”,覆盖 MVP、二期、阶段二/三和已取消设计。
- 二期计划回答“生活顾问 AI 陪练阶段一的工程闭环和 M5 试点条件是否满足”,不要求实现索引原口径下的全部 70 张 Figma 正式画板。
- 因此,矩阵中的“未实现”不等于二期延期。开放问题榜和积分基础能力已因 2026-07-17 客户明确要求提前实现并发布;个人 AI 助理、完整徽章荣誉和完整偏好体系仍属阶段二/三。
- 因此,矩阵中的“未实现”不等于二期延期。开放问题榜和积分基础能力已因 2026-07-17 客户明确要求提前实现并发布;工作助手确认式采集也已在 2026-07-20 增量中部署。矩阵中仍未实现的“个人 AI 助理”主要指个人文件/网页、独立个人知识空间、分享和 PPT 页面;完整徽章荣誉和完整偏好体系仍属阶段二/三。
- 矩阵中的“已实现”也不等于 M5 业务验收通过;评分校准、SOP 评审、正式组织身份和真实试点数据仍以严格预检为准。
与二期计划的主要对应关系:
@@ -112,13 +112,13 @@
| 61 | AI 教练训练计划 | `97:5` | `mobile-uni/src/pages/supervisor/assign/index.vue` | 按二期计划已实现;按 Figma 部分对齐 | 已用主管派发、低分再练、每日三题和成长证据承载;独立 AI 教练编排属于后续范围 |
| 62 | 自动场景任务/自动复盘 | `97:778` | `mobile-uni/src/pages/user/practice/index.vue`、`supervisor/review/index.vue` | 按二期计划已实现基础闭环;按 Figma 部分对齐 | 已有训练、评分、标注、复盘和再练;自动编排/自动复盘报告不属于当前二期必做 |
| 63 | 积分/徽章/荣誉中心 | `97:823` | `mobile-uni/src/pages/user/points/index.vue` | 部分实现并部署;Figma 已修 | 积分/学习学分余额和明细已实现;完整徽章、荣誉中心仍属后续范围 |
| 64 | 企业发布申请 | `42:2` | — | 未实现 | 未修正,阶段二 |
| 65 | 个人 AI 助理发布记录 | `44:2` | — | 未实现 | 未修正,阶段二 |
| 66 | 个人 AI 助理报告大纲 | `44:229` | — | 未实现 | 未修正,阶段二 |
| 67 | 个人 AI 助理 PPT 生成 | `45:2` | — | 未实现 | 未修正,阶段二 |
| 68 | 企业知识发布审核列表 | `46:2` | — | 未实现 | 未修正,阶段二 |
| 69 | 企业知识发布审核详情 | `47:2` | — | 未实现 | 未修正,阶段二 |
| 70 | 个人 AI 助理运营/紧急审计 | `48:2` | — | 未实现 | 未修正,阶段二 |
| 64 | 个人资料申请发布到企业 | `42:2` | — | 未实现 | 确认式采集的 `COMPANY/PENDING` 已部署,但正式发布申请、接收端和回执仍属阶段二 |
| 65 | 个人资料发布记录 | `44:2` | — | 未实现 | 不等同于当前“我的记忆”列表;后续个人知识空间范围 |
| 66 | 个人资料汇报大纲 | `44:229` | — | 未实现 | 当前尚无跨资料生成汇报大纲能力 |
| 67 | 个人资料 PPT 生成 | `45:2` | — | 未实现 | 阶段二增强项,不阻塞确认式采集和工作助手迭代 |
| 68 | 企业知识发布审核列表 | `46:2` | — | 未实现 | 当前 `COMPANY/PENDING` 不等于已进入该审核列表 |
| 69 | 企业知识发布审核详情 | `47:2` | — | 未实现 | 正式接收接口、审核主体和回执尚未确定 |
| 70 | 个人知识空间运营/紧急审计 | `48:2` | — | 未实现 | 仅指个人文件/网页知识空间的运营审计,不否定已部署的确认式采集审计字段 |
## 已取消而不应补做
@@ -130,4 +130,4 @@
2. **P0:M5 正式试点证据**。本地严格门禁可跑通,但正式窗口内的员工、训练次数、校准、SOP 评审和完训率仍需真实数据。
3. **P1:按 BRD 补齐一期业务缺口**。优先是岗位-SOP匹配与上岗资格、错题本可见闭环、案例学习/视频详情的稳定数据模型。
4. **P2:案例详情数据模型**。`caseId`、原始音频媒体留痕、学习点和主管点评已具备;继续等待真实视频样片与相关训练场景契约,不用假视频占位。
5. **P3:剩余阶段二/三页面**。开放问题榜和积分基础能力已按客户要求提前发布;个人 AI 助理、完整徽章荣誉、完整偏好和独立 AI 教练编排仍按后续阶段单独立项。
5. **P3:剩余阶段二/三页面**。开放问题榜、积分基础能力和工作助手确认式采集已提前发布;个人文件/网页知识空间、发布审核、汇报/PPT、完整徽章荣誉、完整偏好和独立 AI 教练编排仍按后续阶段单独立项。
@@ -1,6 +1,8 @@
# Figma 需求覆盖与版本偏差审计
> 生产状态更新(2026-07-18):本文记录的 Figma 修复、代码恢复和新增学习能力已随 `32fa376d` 发布。管理端/H5/后端产物、21 个迁移、目标 schema 与关键生产页面已经验证;正式 OTP 写链路、真实手机权限、外部模型和严格试点仍未验收。文中带日期的“本轮未发布”仅描述当时批次,不再代表当前现网。
>
> 后续边界更新(2026-07-21):工作助手确认式采集已实现并部署;本文“个人 AI 助理未实现”仅继续适用于个人文件/网页、独立个人知识空间、分享和 PPT 等完整页面。项目名称选择、今日工作成果和主管项目汇总仍按[后续迭代计划](工作助手与今日工作成果迭代计划-20260721.md)管理。
> 日期:2026-07-17
> Figma 文件:[银城员工端与个人 AI 助理设计](https://www.figma.com/design/30hFiKtieGYraOZvJPJcPd)
@@ -58,7 +60,7 @@ Figma 当前存在五类风险:
| 问 AI(全网) | 旧版无;会议基线是企业内部知识 | 原设计索引未见独立外部 AI 入口、来源和免责声明 | 已与问师傅分入口/接口/来源并发布,提供方须测试后启用 | **新增范围已批准并实现**:Figma 仍需补来源、禁用、错误和免责声明状态;正式提供方待验收 |
| 图片/视频提问 | 历史文档列为新增/后置情境能力 | `79:11` 有回答侧视频内容,但没有提问附件上传流程 | 已补本次查询的图片/视频附件分析并发布 | **设计仍需追齐**:补权限、PII 外发、大小/失败状态,真机待验收 |
| 开放问题榜/有奖问答 | 原总纲列阶段二,2026-07-17 客户明确要求一并实现 | `95:6` 等画板已完整设计 | 提问、回答、审核、最佳答案、积分/学分已实现并发布 | **范围例外已落地**:正式运营规则和认证写链路待验收;不含现金/提现 |
| 个人 AI 助理/个人资料库 | 2026-07-11 新增,明确阶段二 | Figma 已有完整画板组 | 当前未实现 | **阶段混放风险**:从当前阶段一研发指令中排除,另建阶段二验收表 |
| 个人 AI 助理/个人资料库 | 2026-07-11 新增,明确阶段二;2026-07-19 增加确认式采集 | Figma 已有完整画板组 | “记一下”确认式采集已实现并部署;个人文件/网页资料库、发布审核、汇报/PPT 未实现 | **阶段混放风险**:不得用整组“已实现”或“未实现”概括;当前能力按专项 TechSpec 验收,后续能力另建阶段二验收表 |
## 4. 根因判断
+17 -2
View File
@@ -2,6 +2,17 @@
根目录 [README.md](../README.md) 是项目总入口。本文件只维护 `docs/` 区的文档索引。
## 事实源优先级
同一事项出现不同表述时,按以下顺序裁决,不以会议原文、旧计划或设计图推断当前实现:
1. [物业AI人力资源系统业务需求文档BRD.md](物业AI人力资源系统业务需求文档BRD.md) 定义当前业务范围,[物业AI人力资源系统开发规格TechSpec.md](物业AI人力资源系统开发规格TechSpec.md) 定义工程契约。
2. [BRD_IMPLEMENTATION_AUDIT.md](BRD_IMPLEMENTATION_AUDIT.md) 与 [API_INTEGRATION.md](API_INTEGRATION.md) 说明当前实现、部署证据和接口限制。
3. 专项 TechSpec 细化单个领域;实施计划只描述尚未完成的施工顺序,不构成“已经实现”的证据。
4. `prototypes/` 只作视觉回归基准;会议纪要、历史 Prompt、`legacy/` 与 `archive/` 只作需求来源和追溯材料。
工作助手相关术语、当前本地实现证据与文档关系集中在[《工作助手与今日工作成果迭代计划》](工作助手与今日工作成果迭代计划-20260721.md) §0、§1.5;不得把“本地今日成果已验证”外推为“已经生产发布、完整个人知识空间或外部流转已经实现”。
## 当前项目文档
| 文档 | 用途 |
@@ -22,10 +33,13 @@
| [AI人力资源系统项目规划方案与AI接口说明.md](AI人力资源系统项目规划方案与AI接口说明.md) | 对外会议版口径、数字师傅定位、AI 接口和供应商规划 |
| [银城员工端APP分阶段实施总纲.md](银城员工端APP分阶段实施总纲.md) | 三阶段总纲:陪练 → 大喇叭+知识学习平台(含学模块、开放问题榜、员工个人 AI 助理) → 北森对接;身份三轴模型与防遗漏分发策略 |
| [个人AI助理阶段二专项TechSpec.md](个人AI助理阶段二专项TechSpec.md) | 工作助手确认式统一采集的当前契约,以及后续个人知识空间的数据分域、检索、权限、安全和测试规格 |
| [工作助手与今日工作成果迭代计划-20260721.md](工作助手与今日工作成果迭代计划-20260721.md) | 工作助手项目选择、统一采集、来源追溯、今日成果、主管视图、成果投稿和外部流转的分阶段计划;含本地实施状态、390×844 证据和剩余生产边界 |
| [个人AI助理阶段二开发推进计划.md](个人AI助理阶段二开发推进计划.md) | 后续个人资料/网页/PPT 能力的 P0/P1 任务计划;“记一下”当前实现以专项 TechSpec 为准 |
| [prototypes/personal-assistant-work-helper-voice-first-v2.png](prototypes/personal-assistant-work-helper-voice-first-v2.png) | 个人助理并入「问 · 数字师傅」后的语音优先会话、自动内部路由与确认记忆卡实现基准 |
| [prototypes/work-report-voice-conversation-v1.png](prototypes/work-report-voice-conversation-v1.png) | 工作上报从传统表单升级为微信式语音/照片/视频采集、AI 整理追问和确认审核的高保真实现基准 |
| [WORK_REPORT_IMPLEMENTATION_AGENT_PROMPT.md](WORK_REPORT_IMPLEMENTATION_AGENT_PROMPT.md) | 可直接交给独立开发 Agent 的工作上报实现 Prompt,包含文件边界、API、交互修订、测试和视觉验收口径 |
| [prototypes/work-report-voice-conversation-v1.png](prototypes/work-report-voice-conversation-v1.png) | 当前“工作上报”(产品目标名“成果投稿”)会话式页面的视觉回归基准;不代表工作助手日常采集或今日成果页 |
| [prototypes/work-assistant-project-context-v3.png](prototypes/work-assistant-project-context-v3.png) | 工作助手多项目、项目化确认卡与今日成果的权威高保真输入;运行截图另见迭代计划 §1.5 |
| [visual-evidence/20260721/](visual-evidence/20260721/) | 工作助手项目选择、确认卡、员工今日成果和主管项目成果的 390×844 本地运行截图证据 |
| [presentations/数字师傅工作助手迭代汇报-20260721.pptx](presentations/数字师傅工作助手迭代汇报-20260721.pptx) | 工作助手、多项目、今日成果、权限与发布边界的 5 页内部汇报稿 |
| [AI陪练二期开发推进计划.md](AI陪练二期开发推进计划.md) | 总纲阶段一执行文档:AI 陪练从 MVP 演示闭环推进到管家(生活顾问)岗位试点可用;区分工程就绪与正式业务试点证据 |
| [员工端版本功能对比与功能对齐清单-20260717.md](员工端版本功能对比与功能对齐清单-20260717.md) | 旧版/历史需求/当前实现/生产验收的版本对比,以及 2026-07-17 客户反馈逐项处理结果 |
| [BRD_IMPLEMENTATION_AUDIT.md](BRD_IMPLEMENTATION_AUDIT.md) | 当前生产基线、三端输入/BRD 匹配、客户反馈完成分层和正式试点剩余硬门槛;旧发布流水从当前真相源移除 |
@@ -54,6 +68,7 @@
| 路径 | 用途 |
|---|---|
| [WORK_REPORT_IMPLEMENTATION_AGENT_PROMPT.md](WORK_REPORT_IMPLEMENTATION_AGENT_PROMPT.md) | 已完成的工作上报会话化历史实施说明,仅保留当前边界和后续权威入口,不再作为可执行 Prompt |
| [legacy/物业AI陪练系统一期建设实施方案.md](legacy/物业AI陪练系统一期建设实施方案.md) | 旧陪练系统一期方案,作为 HR 系统范围收敛的参考 |
| [legacy/物业AI陪练系统建设方案研判报告.md](legacy/物业AI陪练系统建设方案研判报告.md) | 旧陪练系统方案研判 |
+19 -122
View File
@@ -1,130 +1,27 @@
# 工作上报语音会话化开发 Agent Prompt
# 工作上报会话化历史实施说明
将下面整段 Prompt 交给负责“工作上报”的开发 Agent。该任务与个人助理开发并行时,工作上报 Agent 只负责本文列出的文件,不修改 `mobile-uni/src/pages/user/sop/index.vue` 或个人助理后端包。
> 状态:已归档,不再作为可执行 Agent Prompt。
>
> 原任务已完成:`mobile-uni/src/pages/user/report/index.vue` 已复用 `ChatComposer`,后端已有 `/api/aihr/work-report/organize`、附件上传、幂等提交、“我的上报”和主管/运营审核链。生产 H5、JAR 与目标表结构已确认包含该能力;正式账号和业务审核样本仍需独立验收。
---
## 当前术语
你正在 `/Users/yuanjiantsui/dev/11-project/wygj` 开发银城员工端 APP 的“工作上报”。请直接完成实现、测试和视觉验证,不要只输出方案。
- 页面和 API 当前仍名“工作上报”。
- 该链路只承载优秀案例、操作视频、完整 SOP 和有用知识,产品目标名称为“成果投稿”。
- 日常晨会、巡检、业主服务、住户画像、服务线索和待跟进事项进入工作助手,不进入 `aihr_work_report`。
## 必读事实源
## 当前限制
1. `AGENTS.md`
2. `docs/20260708/数字师傅学练问报整合方案.md` §1.3.4
3. `docs/物业AI人力资源系统业务需求文档BRD.md` §4.6
4. `docs/物业AI人力资源系统开发规格TechSpec.md` §5.3.1–5.3.2
5. 高保真基准:`docs/prototypes/work-report-voice-conversation-v1.png`
- AI 整理只读取员工文字/ASR 转写、当前草稿和附件名称。
- 附件名称是不可信元数据;当前整理服务没有分析图片或视频内容。
- 审核通过不自动进入案例库或企业知识库。
- 页面正式改名、项目归属、工作助手来源追溯和今日成果尚未实施。
设计图只约束结构和视觉方向。若图中存在“文字已经显示但仍写转文字”“承诺自动隐藏房号”“类型看似已审核”“继续补充入口重复”等问题,以 TechSpec §5.3.2 为准。
## 后续施工入口
## 目标
- 业务边界:[物业AI人力资源系统业务需求文档BRD.md](物业AI人力资源系统业务需求文档BRD.md)
- 当前开发契约:[物业AI人力资源系统开发规格TechSpec.md](物业AI人力资源系统开发规格TechSpec.md)
- 当前接口:[API_INTEGRATION.md](API_INTEGRATION.md)
- 下一阶段:[工作助手与今日工作成果迭代计划-20260721.md](工作助手与今日工作成果迭代计划-20260721.md)
把当前 `mobile-uni/src/pages/user/report/index.vue` 的传统表单主路径改成适合物业一线员工的微信式会话:
`语音/文字/照片/视频 → AI 整理 → 必要时追问 → 可编辑确认卡 → 用户确认上报 → 原审核链 → 会话内状态`
保留现有 `aihr_work_report`、附件上传、我的上报和主管审核,不创建第二套正式记录或草稿表。
## 文件所有权
主要允许修改:
- `mobile-uni/src/pages/user/report/index.vue`
- `mobile-uni/src/services/work-report.ts`
- `mobile-uni/tests/work-report.test.mjs`(新建或扩展现有契约测试)
- `backend/ruoyi-modules/ruoyi-aihr/src/main/java/org/dromara/aihr/report/*`
- 对应的 `backend/ruoyi-modules/ruoyi-aihr/src/test/**/report/*`
优先直接复用,不要复制或重写:
- `mobile-uni/src/components/chat/ChatComposer.vue`
- `mobile-uni/src/services/speech.ts`
- 现有 OSS、登录态、模型配置和 JSON 结构化输出能力
不要修改:
- `mobile-uni/src/pages/user/sop/index.vue`
- `org.dromara.aihr.personal` 或个人助理相关 SQL/文档
- 企业知识检索与短会话实现
多人共享工作区,不要回滚或覆盖其他 Agent 的改动。
## 后端要求
1. 保留现有接口:
- `POST /api/aihr/work-report/attachment`
- `POST /api/aihr/work-report/reports`
- `GET /api/aihr/work-report/reports/mine`
- `GET /api/aihr/work-report/reports`
- `POST /api/aihr/work-report/reports/{id}/review`
2. 新增登录态无状态整理接口:
```text
POST /api/aihr/work-report/organize
req: { transcript, currentDraft?, attachmentOssId?, attachmentName? }
resp: { suggestedType, title, content, missingQuestions[], privacyWarnings[], confidence }
```
3. `organize` 只返回草稿,绝不能写 `aihr_work_report`、创建审核记录或自动入知识库。
4. 复用现有 chat 模型运行时,要求结构化 JSON;模型未配置、超时或 JSON 解析失败时,不编造事实,返回基于原始转写的可编辑草稿和明确降级提示。
5. `suggestedType` 只能是 `CASE / VIDEO / SOP / KNOWLEDGE`。正式提交继续由现有 `create` 做白名单、标题/正文长度和 `VIDEO` 附件校验。
6. `privacyWarnings` 只提示检测到的姓名、手机号、房号等风险,不得宣称已经脱敏。没有真实服务端脱敏就不要返回“提交后会自动隐藏”。
7. 所有接口继续从登录态解析租户、用户和权限,不接受客户端提交人身份;附件不返回公开 OSS URL。
8. 审核通过仍只更新 `APPROVED`,不自动写案例库/知识库、不自动计分。
## 移动端要求
1. 页面标题“工作上报”,右上角“我的上报”。首屏不出现四类选择网格、标题输入框或大段说明表单。
2. 复用 `ChatComposer`,默认“按住说话”,键盘为次级切换,支持图片/视频/音频附件。
3. 用户语音经 ASR 后显示“语音转文字”气泡;整理接口根据当前草稿和补充内容生成下一版草稿。
4. `missingQuestions` 非空时只展示最必要的 1–2 个追问,不生成可提交状态。
5. 短追问直接显示文字并提供播放按钮;长回答才使用“语音条 + 转文字/收起文字”。文字已经可见时不得继续显示“转文字”。
6. 确认卡展示:建议类型、标题、场景/经过、处理、结果、附件、隐私提示。建议类型必须可修改,正式提交使用员工最后确认值。
7. 卡片只保留“修改 / 确认上报”。继续补充统一使用底部语音/文字输入,可显示弱提示“还可以继续说话补充”。
8. 隐私提示必须真实:未实现服务端脱敏时写“检测到具体房号,请修改后再提交”,确认卡展示的就是即将提交的最终文本。
9. 点击“确认上报”后才调用 `POST /reports`;成功在会话中显示 `PENDING / 待审核` 状态卡,并能从“我的上报”读取同一记录。
10. 模型失败、ASR 失败、上传失败、重复点击和未登录都要有明确可恢复状态,不使用假数据。
## 最小测试
后端至少覆盖:
- 整理接口不写数据库。
- 非法类型被拒绝或归一化为允许值。
- 模型失败不编造内容。
- 未登录 401、跨租户不可见、普通员工不能审核。
- 正式提交幂等防重复点击(若现有接口尚无幂等,增加最小请求幂等键并测试)。
移动端至少覆盖:
- 页面默认语音模式且不再呈现传统表单主路径。
- 文字追问可见时不存在“转文字”按钮。
- “建议类型”可修改,提交使用修改后的类型。
- 未实现脱敏时不存在“提交后自动隐藏”承诺。
- 只有一个继续补充入口,确认前不调用正式提交接口。
运行:
```bash
npm --prefix mobile-uni run test:unit
npm --prefix mobile-uni run typecheck
npm --prefix mobile-uni run build:h5
mvn -f backend/pom.xml -pl ruoyi-modules/ruoyi-aihr -am test
```
## 视觉与交互验证
启动真实 H5,在 390×844 视口完成并截图:
1. 初始语音输入。
2. 带照片/视频的用户消息。
3. AI 追问。
4. 完整确认卡。
5. 修改建议类型。
6. 确认后待审核状态。
7. “我的上报”可见同一记录。
检查固定输入栏不遮挡确认按钮,无横向滚动、文字截断、重复入口和虚假脱敏文案。截图不是功能验证的替代,必须实际点击受影响交互。
## 完成口径
分别报告:implemented、locally verified、visually verified、deployed、production-verified。没有真实生产账号、真实附件和线上审核链验证时,不得写 production-verified。提交时只暂存你负责的文件,使用 Conventional Commit,并给出提交哈希、测试结果、截图路径和未完成项。
不得再按本文件重建工作上报页面、接口、表或第二套会话组件。
Binary file not shown.

After

Width:  |  Height:  |  Size: 1.3 MiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 60 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 61 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 64 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 50 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 63 KiB

+27 -10
View File
@@ -1,6 +1,6 @@
# 员工个人 AI 助理 / 个人知识空间专项 TechSpec
> 版本:v1.2 | 日期:2026-07-19
> 版本:v1.4 | 日期:2026-07-21
>
> 归属:《银城员工端 APP 分阶段实施总纲》阶段二
>
@@ -11,8 +11,12 @@
> v1.1 需求补充:客户明确提出,员工在对话中描述住户需求、待跟进事项或个人经验时,个人助理应识别值得长期保留的信息,返回可编辑确认卡;仅在用户确认后写入对应记忆域,后续问答可按权限召回。模型不得直接修改数据库,提醒必须单独确认。
>
> v1.2 实施收口:显式“记一下 / 帮我记 / 保存一下”统一生成 `ASSISTANT_CAPTURE` 确认卡;楼栋、单元、房号和项目均为可补充信息,不再阻断保存。用户必须选择“仅自己保存 / 提交公司处理”;公司处理首批只可靠写入待流转队列,未配置正式接收接口前不得显示“已送达”。音色不在本次范围。
>
> v1.3 文档收口:v1.2 描述的是 2026-07-20 已部署行为;多项目工作采集按[《工作助手与今日工作成果迭代计划》](工作助手与今日工作成果迭代计划-20260721.md)执行。个人笔记允许项目为空,项目工作记录必须先按名称选择当前项目;项目编码只作内部授权字段,不由用户输入。
>
> v1.4 本地实施回填:项目名称选择、项目化短会话、项目化确认卡、来源快照、业务状态历史、员工今日成果和主管项目成果已完成本地实现、真实 HTTP 与 390×844 验证,尚未提交、部署或生产验证。外部线索/工单/考勤投递仍保持 PENDING。
当前代码状态(2026-07-20):候选检测、六类系统建议、同会话合并、可编辑确认、PRIVATE/COMPANY 持久化、可选跟进时间、“我的资料与记忆”列表,以及确认记录按 owner/项目权限参与后续问答召回均已实现。召回引用明确区分 `PERSONAL / COMPANY / PROJECT_SERVICE`。外部线索/工单投递 Worker、正式回执、统一采集转工作上报确认卡,以及个人文件/网页知识空间仍是后续工作,开发者不得从 `PENDING` 状态推断这些能力已完成。
当前代码状态(2026-07-21 复核):2026-07-20 生产版本已包含候选检测、可编辑确认、PRIVATE/COMPANY 持久化、可选跟进时间、“我的资料与记忆”列表和受控召回。当前工作树进一步完成多项目、`ATTENDANCE/INSPECTION` 分类、来源绑定、状态闭环和今日成果,但这部分仍只完成本地验证。个人文件/网页知识空间、PPT 自动生成、外部线索/工单投递 Worker 和正式回执仍是后续工作;开发者不得从 `PENDING` 推断已派单或已送达。
## 0. 交互设计基准
@@ -20,6 +24,8 @@
设计资产:[personal-assistant-work-helper-voice-first-v2.png](prototypes/personal-assistant-work-helper-voice-first-v2.png)
多项目与今日成果联合高保真资产:[work-assistant-project-context-v3.png](prototypes/work-assistant-project-context-v3.png),仓库绝对路径为 `/Users/yuanjiantsui/dev/11-project/wygj/docs/prototypes/work-assistant-project-context-v3.png`;逐状态运行截图路径见[迭代计划 §1.5](工作助手与今日工作成果迭代计划-20260721.md#15-本地运行视觉证据390844)。
该图是阶段二「问」页和确认记忆流程的实现参考,不是当前生产截图。后续 Agent 实施 `mobile-uni/src/pages/user/sop/index.vue` 与记忆确认卡时应遵守以下不变量:
1. 页面标题保持“问 · 数字师傅”,一级只区分“工作助手 / 查全网”,不增加“个人助理”一级 Tab。
@@ -202,12 +208,14 @@ org.dromara.aihr.knowledge.parse
### 3.4 项目业务记忆权限
1. `project_code` 必须由当前登录员工的有效项目任职解析,沿用 `aihr_org_snapshot.project_code` 和现有知识授权口径;客户端不得指定越权项目。
2. 项目业务记忆的列表、详情、修改和召回必须同时过滤 `tenant_id + project_code`,创建人不因“本人记录”获得跨项目访问权。
3. 住户姓名、电话、身份证件和健康信息不作为自由文本检索字段;首批优先保存房屋定位、需求摘要、跟进状态和必要说明。
4. 发送外部模型前先由服务端提取并令牌化可识别信息;模型输出不得覆盖服务端保存的主体定位。
5. 员工修改已确认记录必须携带 `expectedVersion`,成功后新增版本快照,不原地抹除历史。
6. 项目业务记忆不能通过个人资料删除接口删除;作废使用 `VOID` 状态并保留操作人、原因和版本记录。
1. 个人笔记允许 `project_code` 为空;晨会、巡检、业主服务、画像、线索等项目工作记录必须先选择当前项目。
2. 客户端展示员工有权限的项目名称下拉列表,不展示或要求手输项目编码;选择结果可携带内部项目标识,服务端必须按当前登录员工的有效项目任职重新解析并校验,不能信任客户端字段。
3. 项目授权沿用 `aihr_org_snapshot.project_code` 和现有知识授权口径;同一员工的多项目成员关系按 `tenant_id + project_code + ext_party_id` 保留,客户端不得指定越权项目。
4. 项目业务记忆的列表、详情、修改和召回必须同时过滤 `tenant_id + project_code`,创建人不因“本人记录”获得跨项目访问权。
5. 住户姓名、电话、身份证件和健康信息不作为自由文本检索字段;首批优先保存房屋定位、需求摘要、跟进状态和必要说明。
6. 发送外部模型前先由服务端提取并令牌化可识别信息;模型输出不得覆盖服务端保存的主体定位。
7. 员工修改已确认记录必须携带 `expectedVersion`,成功后新增版本快照,不原地抹除历史。
8. 项目业务记忆不能通过个人资料删除接口删除;作废使用 `VOID` 状态并保留操作人、原因和版本记录。
## 4. 数据模型
@@ -329,11 +337,13 @@ Message 保存:
### 4.8 `aihr_assistant_capture`
用户确认后的统一采集事实源。核心字段为 `tenant_id/owner_user_id/project_code/save_scope/suggested_type/building_name/unit_name/room_no/category/summary/detail/occurred_at/follow_up_at/source_conversation_id/source_request_id/delivery_status/delivery_attempts/next_delivery_at/external_record_id/last_error/confirm_idempotency_key/confirm_request_hash/version/create_time/update_time`。
用户确认后的统一采集事实源。核心字段为 `tenant_id/owner_user_id/project_code/save_scope/suggested_type/building_name/unit_name/room_no/category/summary/detail/occurred_at/follow_up_at/work_date/business_status/source_snapshot_json/source_conversation_id/source_request_id/delivery_status/delivery_attempts/next_delivery_at/external_record_id/last_error/confirm_idempotency_key/confirm_request_hash/version/create_time/update_time`。
- `save_scope=PRIVATE` 时 `delivery_status=NOT_REQUIRED`,查询必须同时带 `tenant_id + owner_user_id`。
- `save_scope=COMPANY` 时首批写 `delivery_status=PENDING`;`DELIVERED` 只能由拿到外部成功回执的投递 Worker 更新。
- `confirm_idempotency_key` 在租户和 owner 范围唯一,确认事务先写采集记录再关闭候选,任一步失败整体回滚。
- `business_status` 固定为 `RECORDED/PENDING/IN_PROGRESS/COMPLETED/VOID`;状态历史保留原状态、目标状态、操作人、说明和时间,状态幂等键不得跨记录或目标状态复用。
- `source_snapshot_json` 只保存最小必要来源快照和受保护 OSS 引用,源文件通过重新鉴权接口交付,不保存公开 URL。
- 表内不保存原始录音、模型原始输出或伪造的住户主体 ID;音色不属于本表和本次实现。
### 4.9 `aihr_service_memory`
@@ -513,6 +523,11 @@ Message 保存:
| POST | `/memory-candidates/{id}/confirm` | 提交编辑后的草稿、`expectedVersion`、`idempotencyKey`;分域写入 |
| POST | `/memory-candidates/{id}/dismiss` | 明确不保存;同源候选本会话不再提示 |
| GET | `/assistant-captures?saveScope=PRIVATE|COMPANY&limit=50` | 查看本人的已确认记录及公司流转状态 |
| POST | `/assistant-captures/{id}/status` | 带 `businessStatus/note/idempotencyKey` 推进本地处理状态 |
| GET | `/assistant-captures/{id}/status-history` | 查看状态审计历史 |
| GET | `/assistant-captures/{id}/source` | 重新鉴权读取确认记录绑定的原始媒体 |
| POST | `/api/aihr/work-results/mine/generate` | 按员工、项目和自然日幂等生成今日成果 |
| GET | `/api/aihr/work-results/project` | 主管按目标项目权限查看团队当日成果 |
| GET | `/api/aihr/service-memories` | 按当前项目、状态、日期、楼栋/单元/房号查询 |
| GET | `/api/aihr/service-memories/{id}` | 项目权限内查看详情、来源和版本 |
| PATCH | `/api/aihr/service-memories/{id}` | 携带 `expectedVersion` 修改必要字段或状态并生成版本 |
@@ -532,13 +547,15 @@ Message 保存:
"category": "服务线索",
"summary": "住户希望了解社区可提供的养老服务",
"occurredAt": "2026-07-19T14:00:00+08:00",
"workDate": "2026-07-19",
"businessStatus": "PENDING",
"followUpAt": null
},
"enableReminder": false
}
```
服务端必须忽略请求中的 `projectCode` 作为授权依据,仅用它与当前登录态可访问项目做一致性校验;客户端可省略该字段。确认成功返回 `targetDomain=PERSONAL|COMPANY/targetId/version`;同一 `idempotencyKey` 重放必须返回同一结果,不重复创建记录,同一键配不同请求体必须拒绝。
服务端必须忽略请求中的 `projectCode` 作为授权依据,仅用它与当前登录态可访问项目做一致性校验;个人笔记可省略该字段,项目工作记录不得省略。确认成功返回 `targetDomain=PERSONAL|COMPANY/targetId/version`;同一 `idempotencyKey` 重放必须返回同一结果,不重复创建记录,同一键配不同请求体必须拒绝。
## 7. 网页采集安全
@@ -8,9 +8,9 @@
**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) 为准。
**交互设计基准:** [工作助手语音优先与确认记忆设计图](prototypes/personal-assistant-work-helper-voice-first-v2.png)。该图用于现有确认式采集的视觉回归,不是当前生产截图;安全、权限、状态机和 API 冲突时以 [专项 TechSpec](个人AI助理阶段二专项TechSpec.md) 为准。
**当前边界:** Task 10 的“记一下”已复用 `/api/knowledge/query`、`aihr_memory_candidate` 和 `aihr_assistant_capture` 完成本地闭环;本计划其余个人文件、网页、独立 `/ask`、分享和 PPT 任务仍未实施,不得按计划文本推断已完成。
**当前边界:** Task 10 的“记一下”已复用 `/api/knowledge/query`、`aihr_memory_candidate` 和 `aihr_assistant_capture` 完成实现并部署;本计划其余个人文件、网页、独立 `/ask`、分享和 PPT 任务仍未实施,不得按计划文本推断已完成。项目名称选择、项目化会话、来源追溯和今日工作成果不在本文件重复规划,统一以[《工作助手与今日工作成果迭代计划》](工作助手与今日工作成果迭代计划-20260721.md)为施工入口。
---
@@ -979,135 +979,12 @@ Expected: 单测 PASS;匿名请求业务响应为 401,接口没有 @SaIgnore
---
### Task 10: 将现有「问」页升级为工作助手并接入个人助理
### 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
- Create: mobile-uni/src/pages/user/assistant/capture.vue
- Create: mobile-uni/src/pages/user/assistant/item.vue
- Create: mobile-uni/src/pages/user/assistant/sessions.vue
- Create: mobile-uni/tests/personal-assistant.test.mjs
- Modify: mobile-uni/src/pages.json
- Modify: mobile-uni/src/pages/user/sop/index.vue
- Modify: mobile-uni/src/pages/user/web-ai/index.vue
- Modify: mobile-uni/src/types/api.ts
- [ ] **Step 1: 写失败的页面契约测试**
import test from 'node:test';
import assert from 'node:assert/strict';
import { readFile } from 'node:fs/promises';
const source = (path) => readFile(new URL(path, import.meta.url), 'utf8');
test('工作助手默认自动选择内部资料范围', async () => {
const page = await source('../src/pages/user/sop/index.vue');
assert.match(page, /工作助手/);
assert.match(page, /资料范围/);
assert.match(page, /自动/);
assert.match(page, /收藏资料/);
assert.match(page, /citation\.domain/);
});
test('一级入口只区分工作助手与查全网', async () => {
const internalPage = await source('../src/pages/user/sop/index.vue');
const webPage = await source('../src/pages/user/web-ai/index.vue');
assert.match(internalPage, /工作助手/);
assert.match(webPage, /查全网/);
assert.doesNotMatch(internalPage, /企业问师傅\s*\/\s*个人助理\s*\/\s*全网/);
});
test('个人资料页面包含状态、重试和删除', async () => {
const page = await source('../src/pages/user/assistant/item.vue');
assert.match(page, /PARSING|解析中/);
assert.match(page, /retryPersonalItem/);
assert.match(page, /deletePersonalItem/);
});
- [ ] **Step 2: 运行测试确认失败**
Run:
npm --prefix mobile-uni run test:unit
Expected: FAIL,现有「问」页尚未提供工作助手 AUTO 范围和简化后的一级入口。
- [ ] **Step 3: 实现 API 客户端**
personal-assistant.ts 固定使用现有 apiRequest:
export type InternalKnowledgeScope = 'PERSONAL' | 'PROJECT_SERVICE' | 'ENTERPRISE';
export const askPersonalAssistant = (payload: {
sessionId?: number;
queryText: string;
scopeMode: 'AUTO' | 'MANUAL';
scope: InternalKnowledgeScope[];
dateFrom?: string;
dateTo?: string;
itemIds?: number[];
outputFormat?: 'ANSWER' | 'ACTION_PLAN' | 'OUTLINE';
}) => apiRequest<PersonalAskResponse>({
url: '/api/aihr/personal-assistant/ask',
method: 'POST',
data: payload,
timeout: 45000
});
export const deletePersonalItem = (id: number) =>
apiRequest<{ cleanupJobId: number }>({
url: '/api/aihr/personal-assistant/items/' + id,
method: 'DELETE',
timeout: 15000
});
- [ ] **Step 4: 实现页面交互**
关键状态必须唯一:
const scopeMode = ref<'AUTO' | 'MANUAL'>('AUTO');
const manualScopes = ref<InternalKnowledgeScope[]>([]);
const queryText = ref('');
const asking = ref(false);
const answer = ref<PersonalAskResponse>();
const submitQuestion = async () => {
const question = queryText.value.trim();
if (!question || asking.value) return;
asking.value = true;
try {
answer.value = await askPersonalAssistant({
queryText: question,
scopeMode: scopeMode.value,
scope: scopeMode.value === 'MANUAL' ? manualScopes.value : [],
outputFormat: 'ACTION_PLAN'
});
} finally {
asking.value = false;
}
};
一级只显示“工作助手 / 查全网”。工作助手默认 `AUTO`,只在 PERSONAL / PROJECT_SERVICE / ENTERPRISE 三个内部授权域路由;“资料范围”放在输入区次级设置中。引用卡按 `citation.domain` 显示“我的资料 / 项目记录 / 企业 SOP”,让用户看得见实际来源。公网查询继续使用独立页面和接口,内部无命中时只能提示用户主动进入“查全网”,不得自动转发原问题或住户/项目内容。
- [ ] **Step 5: 运行移动端检查**
Run:
npm --prefix mobile-uni run test:unit
npm --prefix mobile-uni run typecheck
npm --prefix mobile-uni run build:h5
Expected: 全部 PASS;无新增横向滚动;页面路由存在。
- [ ] **Step 6: 提交**
git add mobile-uni/src/pages.json mobile-uni/src/pages/user/assistant mobile-uni/src/pages/user/sop/index.vue mobile-uni/src/pages/user/web-ai/index.vue mobile-uni/src/services/personal-assistant.ts mobile-uni/src/types/api.ts mobile-uni/tests/personal-assistant.test.mjs
git commit -m "feat(mobile): add personal assistant knowledge flow"
- 已复用 `ChatComposer`、`/api/knowledge/query`、`aihr_memory_candidate` 和 `aihr_assistant_capture` 完成确认式采集并部署。
- 当前生产能力、接口和限制以[专项 TechSpec](个人AI助理阶段二专项TechSpec.md)、[API 对接指南](API_INTEGRATION.md)和[BRD 功能审查](BRD_IMPLEMENTATION_AUDIT.md)为准。
- 本文件原有的页面脚手架、失败测试和重复实现步骤已删除,避免后续 Agent 创建第二套工作助手或把未实现的个人资料 API 当成现有接口。
- 后续项目选择、来源追溯、今日成果和主管项目视图只执行[工作助手迭代计划](工作助手与今日工作成果迭代计划-20260721.md)。
---
@@ -0,0 +1,592 @@
# 工作助手与今日工作成果迭代计划
> 版本:v1.4
> 日期:2026-07-21
> 状态:迭代 0-4 已完成本地实现、目标测试、真实 HTTP 与 390×844 视觉交互验证;尚未提交、部署和生产验证
> 适用范围:员工端工作助手、今日工作成果、主管项目视图、成果投稿及后续外部流转
> v1.4:在 v1.3 基础上把 UI 变化、权威高保真图、仓库内运行截图和正式汇报 PPT 的准确路径统一落盘;设计目标、本地运行截图与生产状态继续严格区分。
## 0. 文档权威关系与冲突裁决
本文只回答“下一步按什么顺序建设”,不取代当前接口、生产状态或既有审核链的事实文档:
| 文档 | 职责 | 使用规则 |
|---|---|---|
| [业务需求 BRD](物业AI人力资源系统业务需求文档BRD.md) | 决定做什么及业务边界 | 业务需求事实源 |
| [开发规格 TechSpec](物业AI人力资源系统开发规格TechSpec.md) | 说明现有工程结构与已定技术契约 | 开发层当前事实源 |
| [个人助理专项 TechSpec](个人AI助理阶段二专项TechSpec.md) | 说明确认式采集、权限、记忆和个人知识空间边界 | 工作助手专项契约 |
| [API 对接指南](API_INTEGRATION.md) | 只列当前已经存在的接口 | 不把本文规划中的接口写成可调用接口 |
| [BRD 功能审查](BRD_IMPLEMENTATION_AUDIT.md) | 区分实现、部署、生产基础验证和正式验收 | 当前状态事实源 |
| 本文 | 项目选择、统一采集、今日成果、主管视图和外部流转的实施顺序与阶段证据 | 只能按本文状态列声明本地实现;部署和生产状态仍以审查文档及真实环境为准 |
| [数字师傅整合方案](20260708/数字师傅学练问报整合方案.md) | 保留产品演进背景和“学练问报”决策 | 与当前事实冲突时以上述事实文档为准 |
已裁决的矛盾:
1. **项目是否必填**:当前已部署的确认式采集允许项目为空;后续迭代中,个人笔记仍可不选项目,但晨会、巡检、业主服务、画像、线索等项目工作记录必须先从项目名称下拉列表选择当前项目。用户不输入项目编码。
2. **“工作上报”是什么**:`/pages/user/report/index` 已在员工界面改名为“成果投稿”,底层 `/api/aihr/work-report/**` 继续兼容既有优秀案例、操作视频、完整 SOP 和有用知识审核链;日常事实不进入该表。
3. **日常记录放在哪里**:日常事实统一进入工作助手和 `aihr_assistant_capture`;不得为了日报把既有 `aihr_work_report` 改造成万能工作记录表。
4. **附件是否已经被 AI 看懂**:工作助手的现场图片/视频已有本次分析能力;确认式采集已能把受保护 OSS 来源绑定到记录并重新鉴权回看。成果投稿链仍不能仅凭附件名称声称已经理解图片或视频内容。
5. **“个人助理已实现”是什么意思**:确认式采集已经提交并部署,但个人文件、网页收藏、独立个人向量库、分享和 PPT 生成仍未实现;两者不能合并宣称完成。
6. **今日成果与外部流转**:员工今日成果和主管项目成果已完成本地最小闭环;真实线索/工单投递仍未接通,`COMPANY/PENDING` 只表示待流转。
7. **部署与验收**:2026-07-20 生产 JAR、H5 资源及目标表结构已确认包含确认式采集和会话式工作上报;这属于部署与生产基础验证,不等于多项目、真机、正式账号和业务窗口验收通过。
## 1. 目标与边界
本轮不是新建另一套聊天、上传或工作上报系统,而是在现有「问 · 数字师傅」和确认式记忆链路上补齐项目上下文、日常工作采集、按日汇总与主管查看能力。
一线员工只需完成三个动作:
1. 按项目名称选择当前项目。
2. 通过语音、文字、照片或视频说明现场情况。
3. 检查 AI 整理结果并确认。
员工不需要记忆或输入项目编码,也不需要在表达前判断“线索、画像、案例、知识、工单”等专业分类。项目编码只作为前后端内部传输字段,服务端必须再次校验项目权限。
### 1.1 功能名称收敛
| 功能 | 用户理解 | 主要用途 |
|---|---|---|
| 工作助手 | 今天发生什么,直接告诉数字师傅 | 日常工作采集、记忆、待跟进 |
| 今日工作成果 | 今天做了什么,还有什么没完成 | 自动汇总、个人查看、主管查看 |
| 成果投稿 | 这条经验值得让公司复用 | 优秀案例、SOP、视频、知识投稿 |
当前代码和页面仍使用「工作上报」名称,其四类审核内容在产品语义上对应“成果投稿”。既有审核链继续保留,日常工作事实则统一进入工作助手。
### 1.2 业务链路
```mermaid
flowchart LR
A[选择当前项目名称] --> B[语音、文字、照片或视频]
B --> C[AI 理解并生成确认卡]
C --> D[本人工作记录]
C --> E[待跟进事项]
C --> F[公司处理 PENDING]
C --> G[成果投稿建议]
D --> H[今日工作成果]
E --> H
F --> H
G --> H
H --> I[主管项目视图]
```
### 1.3 UI 变化与高保真基准
迭代 1-3 在现有「问 · 数字师傅」页面内渐进完成,不新建第二套工作助手界面:
![工作助手项目上下文与今日成果高保真基准](prototypes/work-assistant-project-context-v3.png)
权威资产路径:`docs/prototypes/work-assistant-project-context-v3.png`。本地生成源为 `output/imagegen/work-assistant-project-context-v3.png`,该目录被 Git 忽略,后续 Agent 必须引用前者。
### 1.4 UI 设计交付清单
| 设计交付物 | 覆盖页面与状态 | 对应迭代 | 开发引用路径 | 当前性质 |
|---|---|---|---|---|
| 工作助手项目上下文与今日成果 v3 | 工作助手主会话、当前项目、项目化确认卡、今日成果摘要、待公司处理 | 迭代 1-3,兼顾迭代 5 状态语义 | `docs/prototypes/work-assistant-project-context-v3.png` | 目标高保真图,尚非生产截图 |
仓库内绝对路径:`/Users/yuanjiantsui/dev/11-project/wygj/docs/prototypes/work-assistant-project-context-v3.png`。
UI 与代码页面的对应关系:
| UI 变化 | 员工/主管路由 | 主要实现文件 | 说明 |
|---|---|---|---|
| 当前项目名称选择器与大尺寸底部面板 | `/pages/user/sop/index` | `mobile-uni/src/pages/user/sop/index.vue` | 用户只选择项目名称,不输入或记忆项目编码;切换项目同时切换会话上下文 |
| 项目化确认卡、来源与业务状态 | `/pages/user/sop/index` | `mobile-uni/src/components/chat/MemoryCandidateCard.vue` | 确认卡展示项目、工作日期、来源和状态,并区分个人记录与待公司处理 |
| 今日工作成果摘要与员工详情 | `/pages/user/sop/index`、`/pages/user/work-results/index` | `mobile-uni/src/pages/user/sop/index.vue`、`mobile-uni/src/pages/user/work-results/index.vue` | 会话内给出当日摘要入口,详情按员工 + 项目 + 日期聚合 |
| 主管项目成果 | `/pages/supervisor/work-results/index` | `mobile-uni/src/pages/supervisor/work-results/index.vue` | 按项目查看记录人数、成果人数、待跟进和高优问题,不展示无权限项目 |
| 原“工作上报”分流为“成果投稿” | `/pages/user/report/index` | `mobile-uni/src/pages/user/report/index.vue` | 仅承载优秀案例、操作视频、完整 SOP 和知识投稿,不承载日常事实记录 |
### 1.5 本地运行视觉证据(390×844)
下列文件是 2026-07-21 本地开发环境的实际页面截图,用于证明实现状态和记录视觉修正;它们不是高保真设计源,也不是生产截图:
| 实际页面或状态 | 仓库内截图路径 | 验证结论 |
|---|---|---|
| 多项目名称选择面板 | `docs/visual-evidence/20260721/work-assistant-project-picker-fixed-390x844.png` | 两个项目完整可见;面板使用 `--window-bottom` 避开底栏 |
| 已选择当前项目的工作助手 | `docs/visual-evidence/20260721/work-assistant-selected-project-390x844.png` | 顶部显示项目名称,切换提示明确,不显示项目编码 |
| 巡检确认卡自动定位到操作区 | `docs/visual-evidence/20260721/work-assistant-inspection-card-autoscroll-390x844.png` | 项目、日期、来源、业务状态与四个确认动作可操作 |
| 员工今日工作成果 | `docs/visual-evidence/20260721/employee-daily-work-result-fixed-390x844.png` | 按项目和日期聚合;已记录事项不再错误显示处理动作 |
| 主管项目成果 | `docs/visual-evidence/20260721/supervisor-project-work-results-fixed-390x844.png` | 显示记录人数、成果人数、待跟进、高优问题和员工来源类型;非文字记录可打开受保护原始来源 |
绝对目录:`/Users/yuanjiantsui/dev/11-project/wygj/docs/visual-evidence/20260721/`。这些文件是已纳入仓库的本地验收证据;正式设计目标仍只以 `docs/prototypes/` 下的权威高保真图为准。
后续开发和验收使用规则:
1. 产品、前端、后端和测试 Agent 都以 `docs/prototypes/work-assistant-project-context-v3.png` 为共同设计输入。
2. 图中项目名称、日期、来源、业务状态和今日成果入口必须与本计划的数据与权限规则同时实现,不能只还原视觉外壳。
3. `output/imagegen/work-assistant-project-context-v3.png` 仅保留生成过程来源,不纳入 Git,也不能写入开发任务或验收报告作为权威资产。
4. 新增项目选择面板、今日成果详情页或主管项目视图高保真图时,继续放入 `docs/prototypes/`,并回填本表和对应迭代章节。
相对当前页面的变化:
1. 页面标题继续使用「问 · 数字师傅」,顶部增加按项目名称操作的「当前项目」选择器,不展示项目编码。
2. 保留「工作助手 / 查全网」双入口,在会话顶部增加「今日工作成果」摘要入口。
3. 语音、照片和文字仍以微信式消息进入同一会话,不要求员工先选业务分类。
4. 确认卡增加项目、日期、地点、事项、原始语音/现场照片来源和本地业务状态;确认后才计入今日工作成果。
5. 「确认记录」与「提交公司处理」分开;后者只显示「进入待流转」,不得显示已派单或已送达。
6. 底部继续以「按住说话」为主入口,键盘、快捷指令和「今日 / 练 / 问 / 我」导航保持原有交互习惯。
| 图中元素 | 对应迭代 | 当前状态 |
|---|---|---|
| 当前项目名称选择器、切换提示 | 迭代 1 | 已本地实现并完成 390×844 视觉交互验证 |
| 项目化确认卡、来源入口、业务状态 | 迭代 2 | 已本地实现;文字链路已完成真实 HTTP 与页面验证,媒体来源仍需生产真机回归 |
| 今日工作成果摘要入口 | 迭代 3 | 已本地实现,员工详情页和主管项目视图已完成视觉验证 |
| 提交公司处理、进入待流转 | 当前确认式采集 + 迭代 5 | `PENDING` 已有;真实外部投递和回执未实现 |
该图只定义信息层级、交互语义和视觉方向,不是生产截图。项目选择面板、员工今日成果详情页和主管项目视图已按 390×844 运行页面完成视觉验收,证据见 §1.5;生产发布后仍需重新完成真机验收。
## 2. 当前能力审计
### 2.1 已存在并可复用
- 「问」页面已经支持语音优先、文字次之,以及照片和视频辅助输入。
- 已有统一 `ChatComposer`,不得再建设第二套聊天或上传组件。
- “记一下/帮我记/保存一下”已经具备识别、补充、确认、幂等保存链路。
- 已有 `PRIVATE/COMPANY` 保存范围和 `NOT_REQUIRED/PENDING` 流转状态。
- 后端已经能够得到员工有权限的项目编码集合,并在确认时校验项目权限。
- `aihr_assistant_capture` 已包含项目、房号、分类、摘要、跟进时间、来源请求和流转状态等基础字段。
### 2.2 已有基础但需要补齐
- `/api/aihr/mobile/me` 已返回完整授权项目列表;生产组织同步仍需用真实多项目人员验证。
- 数据层和前端已支持按项目名称选择、切换与账号隔离缓存。
- 图片和视频可用于本次分析,确认记录已支持绑定受保护原始附件;生产真机媒体链路尚待回归。
- 查询审计只保存问题哈希和来源类型,不能回看原始文字、语音、照片或视频。
- 短会话已绑定当前项目,项目不一致拒绝复用。
- 已能按“员工 + 项目 + 自然日”幂等生成工作成果。
### 2.3 尚未实现
- 真实外部线索、工单、考勤投递与回执。
- 生产真机语音、照片、视频来源回看验收。
- 未经确认的自动外发(本期明确不做)。
- 原始文字、语音、照片、视频追溯。
- 公司处理类事项的真实外部回执。
### 2.4 外部边界
以下能力在正式接口确定前只能保留 `PENDING`:
- 养老服务线索正式送达。
- 客户画像正式写入。
- 正式工单系统派单。
- 正式考勤系统同步。
- 线索奖励和结算。
没有真实接口回执前,界面只能显示“已记录”或“待公司处理”,不得显示“已派单”“已同步”或“已送达”。
## 3. 总体实施策略
1. 复用现有工作助手页面、`ChatComposer`、确认卡和 `aihr_assistant_capture`。
2. 先完成项目隔离和本地工作闭环,再建设外部接口。
3. 工作记录按自然日聚合;问师傅仍保持 30 分钟、最近六轮短会话,不全局改为 24 小时。
4. 分类由 AI 建议,用户只做确认或修改。
5. 业务处理状态与外部流转状态分开,避免把“已解决”误写成“已送达外部平台”。
6. 日报先用确定性规则聚合,LLM 只润色;模型失败时仍能生成结构化成果。
## 4. 迭代计划
## 4.1 迭代 0:统一产品与接口语义
**预计:0.5-1 人日**
**优先级:P0**
### 工作内容
- 文档和页面统一使用“工作助手、今日工作成果、成果投稿”。
- 明确“确认记录”和“提交公司处理”是两个动作。
- 明确 `COMPANY/PENDING` 为待流转,不是成功回执。
- 工作日按自然日处理,MVP 时区固定为 `Asia/Shanghai`,不采用滚动 24 小时。
- 更新专项 TechSpec、总 TechSpec、API 文档和后续 Agent 实施提示词。
### 验收标准
- 文档、页面名称、接口状态没有互相矛盾的表述。
- 原有工作上报审核链不被删除,也不被误改成日常记录表。
## 4.2 迭代 1:当前项目选择与严格隔离
**预计:1.5-2 人日**
**优先级:P0**
### 用户交互
本迭代 UI 设计输入:`docs/prototypes/work-assistant-project-context-v3.png`,详见 [§1.3](#13-ui-变化与高保真基准) 和 [§1.4](#14-ui-设计交付清单)。顶部项目选择器和大尺寸底部面板已实现;运行截图见 §1.5。
页面顶部展示:
> 当前项目:星河湾一期 ▼
点击后打开适合一线员工操作的大尺寸底部选择面板:
- 只展示项目名称,不展示项目编码。
- 项目较多时支持按名称搜索。
- 标记当前项目和最近使用项目。
- 切换项目前,如存在未发送内容或待确认卡,必须提示用户确认。
进入逻辑:
- 只有一个项目:自动选择并展示名称。
- 多个项目:首次进入或第一次工作记录前必须选择。
- 没有项目:禁用工作采集,并提示联系管理员。
- 组织权限变化导致原项目失效:清除旧选择并要求重新选择。
### 技术处理
- 扩展 `/api/aihr/mobile/me`,返回去重后的 `projects[]`。
- `aihr_org_snapshot` 同一员工的多项目成员关系使用 `UNIQUE(tenant_id, project_code, ext_party_id)`;组织同步把有效 `employee_project_assignment` 展开为多条项目成员行,不能再按员工 ID 折叠为单项目。
- `projectName` 仅用于展示;`projectCode` 仅作为内部传输字段。
- 当前项目缓存按租户和登录账号隔离,退出登录时清除。
- 查询、保存、汇总都携带内部项目值,服务端与授权项目集合再次求交集。
- 切换项目时创建新的 `conversationId`,清除当前草稿和待确认上下文。
- 短会话记录补充项目约束,项目不一致时拒绝复用。
### 验收场景
1. 单项目员工自动进入。
2. 多项目员工按项目名称选择。
3. 切换项目后旧对话不进入新项目。
4. 篡改内部项目值时服务端返回 403。
5. 更换登录账号后不沿用上一账号的项目。
6. 390×844 视口下选择面板没有截断、遮挡或误触问题。
## 4.3 迭代 2:统一日常工作采集与来源追溯
**预计:3-4 人日**
**优先级:P0**
### 分类体系
不让员工在表达前选择分类。系统内部沿用现有枚举并仅补充确有需要的类型,确认卡上使用通俗中文:
- 到岗/晨会记录。
- 巡检问题。
- 业主服务记录。
- 待跟进事项。
- 住户画像。
- 服务线索。
- 经验案例候选。
- 项目工作记录。
- 个人笔记。
兼容既有 `SERVICE_LEAD / RESIDENT_PROFILE / CASE / FOLLOW_UP / PROJECT_NOTE / PERSONAL_NOTE`,不重建平行分类系统。
### 确认卡
本迭代 UI 设计输入:`docs/prototypes/work-assistant-project-context-v3.png`,详见 [§1.3](#13-ui-变化与高保真基准) 和 [§1.4](#14-ui-设计交付清单)。确认卡的项目、日期、来源和业务状态已实现;文字巡检场景运行截图见 §1.5,媒体来源仍需生产真机回归。
确认卡至少展示:
- 当前项目名称。
- 发生日期。
- AI 建议类型。
- 地点或对象。
- 事项摘要。
- 跟进时间。
- 原始文字、语音或媒体入口。
操作保持精简:
- 确认记录。
- 修改。
- 暂不保存。
- 提交公司处理。
“提交公司处理”不是默认动作,AI 不得自动替用户执行。
### 数据补充
在候选记录和确认记录中补充:
- `work_date`:自然工作日期。
- `business_status`:本地业务处理状态。
- `source_snapshot_json`:最小必要来源快照。
`source_snapshot_json` 记录:
- 来源类型:`TEXT/VOICE/IMAGE/VIDEO`。
- 原始文字或语音转写。
- 受保护的 OSS 引用。
- 文件类型、时长等必要元数据。
- 图片或视频识别出的现场摘要。
不建设第二套对象存储,继续复用 `sys_oss/MinIO`。
### 媒体保存策略
- 用户发送媒体时完成识别,并产生临时来源引用。
- 用户确认后将来源引用绑定到采集记录。
- 未确认的临时素材在候选过期后清理。
- 下载必须重新鉴权,不返回公开 OSS 地址。
- 正式素材保留时长遵循租户隐私策略。
- 测试和演示只使用脱敏或合成材料。
### 状态模型
业务状态:
- 已记录。
- 待跟进。
- 处理中。
- 已完成。
- 已作废。
外部流转状态:
- 无需流转。
- 待流转。
- 已送达。
- 失败。
两组状态不得互相替代。
### 验收场景
1. 晨会照片加人数说明,保存为“AI 整理的到岗记录”。
2. 巡检照片加问题说明,保存为巡检问题。
3. 住户养老需求生成画像或线索建议,但不自动提交。
4. 语音“帮我记一下”产生完整确认卡。
5. 确认后的记录可以回看原始文字、语音或媒体。
6. 重复确认不会产生重复记录。
## 4.4 迭代 3:今日工作成果
**预计:2-3 人日**
**优先级:P1**
### 聚合口径
第一层:员工 + 项目 + 自然日。
第二层:主管 + 项目 + 自然日,聚合有权限员工的记录。
禁止按对话轮数或最近 30 分钟聚合。短会话继续使用原有时间窗口。
### 报告内容
- 当前项目、日期和记录人。
- 今日已完成工作。
- 巡检问题及处理状态。
- 业主服务和待跟进事项。
- 新增住户画像和服务线索。
- 到岗/晨会记录摘要。
- 未闭环事项和下一步。
- 每项内容的原始记录入口。
### 生成原则
- 先按记录类型和状态进行确定性分组。
- LLM 只压缩和润色,不决定记录是否存在。
- 生成接口必须幂等。
- 使用一个最小日报快照表,保存租户、员工、项目、工作日期、报告 JSON、来源记录 ID、版本和生成时间。
- 同一员工、项目和日期重新生成时更新版本,不重复创建日报。
- 暂不实现未经确认的自动外发。
### 页面入口
本迭代 UI 设计输入:`docs/prototypes/work-assistant-project-context-v3.png`,详见 [§1.3](#13-ui-变化与高保真基准) 和 [§1.4](#14-ui-设计交付清单)。工作助手摘要入口、员工详情页和主管项目视图均已本地实现并完成 390×844 验证,运行截图见 §1.5。
员工端:
- 今日首页“今日工作成果”。
- 工作助手顶部入口。
- “我 → 我的工作记录”。
主管端:
- 今日记录人数。
- 已形成成果人数。
- 待跟进数量。
- 高优先级问题。
- 按员工查看来源记录。
### 验收标准
- 同一天多种记录正确归类。
- 不同项目严格隔离。
- 跨天记录不串入。
- 每一项可以回到原始来源。
- LLM 不可用时仍能生成结构化报告。
## 4.5 迭代 4:本地闭环与成果投稿分流
**预计:2-3 人日**
**优先级:P1**
### 巡检和待跟进闭环
支持记录状态更新,并保留:
- 操作人。
- 操作时间。
- 修改前后状态。
- 处理备注。
### 成果投稿
现有「工作上报」页面改名为「成果投稿」或「经验沉淀」,保留:
- 优秀案例。
- 操作视频。
- 完整 SOP。
- 有用知识。
- 人工审核。
工作助手识别到高价值内容时,只提供建议:
> 这段处置过程可能适合作为优秀案例,是否整理成成果投稿?
用户明确同意后,才进入既有 `aihr_work_report` 审核链。
### 主管能力
- 查看团队今日成果。
- 查看待跟进事项。
- 查看成果投稿审核状态。
- 不虚构养老线索接收平台或外部工单后台。
## 4.6 迭代 5:外部线索、画像与工单接口
**预计:正式接口确定后 3-5 人日**
**当前状态:阻塞,不纳入内部 MVP**
实施前必须取得:
- 正式接口路径。
- 请求字段和必填规则。
- 鉴权方式。
- 幂等字段。
- 成功回执。
- 人工复核状态。
- 失败重试规则。
- 奖励回调规则。
- 测试环境。
实现时复用 `aihr_assistant_capture.delivery_status` 作为 Outbox:
- `COMPANY/PENDING` 记录由 Worker 异步投递。
- 保留请求摘要、尝试次数、错误和外部记录 ID。
- “满 100 条”或“每小时推送”只适用于外部线索流转,不应用于全部工作记录。
- 没有真实成功回执时绝不更新为 `DELIVERED`。
- 外部现金奖励与当前非现金积分体系保持分离。
## 5. 汇报 PPT 计划与交付
正式汇报稿已按 16:9、白底、银城红和深灰视觉体系完成,共 5 页;员工和主管页面均使用 2026-07-21 本地 390×844 脱敏运行截图,不用概念图冒充线上效果。
权威 PPTX 路径:`docs/presentations/数字师傅工作助手迭代汇报-20260721.pptx`。
仓库内绝对路径:`/Users/yuanjiantsui/dev/11-project/wygj/docs/presentations/数字师傅工作助手迭代汇报-20260721.pptx`。
### 第 1 页:从零散记录到可追溯成果
- 说明语音、照片和文字如何进入同一工作助手。
- 展示权威高保真图和本地实现/HTTP/390×844 验证状态。
### 第 2 页:一线员工体验
- 用户按项目名称选择,不输入项目编码。
- AI 自动建议类型,员工只需确认。
- “确认记录”与“提交公司处理”明确分开。
### 第 3 页:多项目与权限
- 展示项目选择、服务端授权求交集、项目化短会话和项目化日报。
- 明确越权返回 403,外部系统无真实回执时只显示 `PENDING`。
### 第 4 页:员工与主管今日工作成果
- 员工看个人闭环,主管看项目汇总。
- 事实由确定性规则聚合,LLM 不决定事实是否存在。
- 展示幂等版本和状态历史。
### 第 5 页:交付状态与下一步
- 严格区分已实现、已本地验证、已视觉验证、待部署和待外部接口。
- 给出备份、迁移、后端/H5 发布、真实账号回归和权限回归顺序。
### 交付物
- PPTX:`docs/presentations/数字师傅工作助手迭代汇报-20260721.pptx`。
- PDF。
- 演讲备注。
- 脱敏截图素材:`docs/visual-evidence/20260721/`。
- 无网络环境可播放的录屏备份。
## 6. 排期与发布批次
按一名熟悉项目的全栈开发者估算:
| 阶段 | 人日 | 可独立上线 |
|---|---:|---|
| 迭代 0:文档与语义 | 0.5-1 | 是 |
| 迭代 1:项目选择与隔离 | 1.5-2 | 是 |
| 迭代 2:统一采集与来源追溯 | 3-4 | 是 |
| 迭代 3:今日工作成果 | 2-3 | 是 |
| 迭代 4:本地闭环与成果投稿分流 | 2-3 | 是 |
| PPT 与演示材料 | 1-1.5 | 是 |
| 迭代 5:外部接口 | 3-5 | 否,等待正式契约 |
内部 MVP(迭代 0-4 加 PPT)合计约 10-15 人日。每个迭代单独提交、部署和生产验证,不进行一次性大爆炸发布。
推荐发布批次:
1. **R1:项目上下文** - 迭代 0、迭代 1。
2. **R2:一线采集闭环** - 迭代 2。
3. **R3:今日成果与主管查看** - 迭代 3、迭代 4。
4. **R4:外部流转** - 迭代 5,等待接口后单独发布。
## 7. 风险与控制
| 风险 | 等级 | 控制措施 |
|---|---|---|
| 多项目串数据 | 高 | 项目选择、服务端权限校验、项目化会话、日报组合唯一约束 |
| 用户被迫理解专业分类 | 高 | AI 自动建议,用户只确认或修改 |
| 把 PENDING 显示为已派单 | 高 | 业务状态和流转状态分离 |
| 原始媒体无法追溯 | 高 | OSS 受保护引用绑定确认记录 |
| 图片和住户信息泄露 | 高 | 临时素材清理、重新鉴权、脱敏测试 |
| 日期边界混乱 | 中 | 服务端按 `Asia/Shanghai` 计算 `work_date` |
| 重复保存和重复上报 | 中 | 确认、状态更新和日报均使用幂等键 |
| LLM 输出不稳定 | 中 | 分类规则和聚合确定性优先,LLM 只润色 |
| 外部接口尚未确定 | 高 | 保持 PENDING,不伪造成功 |
## 8. 验证与完成口径
每个发布批次必须分别报告:
- 已实现。
- 本地测试通过。
- 视觉与交互验证通过。
- 已部署。
- 生产验证通过。
- 仍受外部接口或业务规则阻塞的边界。
最小验证链:
1. 后端目标单元测试和数据库迁移验证。
2. 移动端类型检查与 H5 构建。
3. 真实本地 HTTP 链路验证创建、确认、查询、汇总和状态变化。
4. 390×844 视口验证项目选择、文字/语音/媒体采集、确认卡、状态、今日成果。
5. 实际操作项目切换、重复确认、来源回看和跨项目隔离。
6. 代码审查并处理确认问题。
7. 发布前备份,发布后使用真实试点账号完成生产回归。
### 8.1 2026-07-21 本地验证快照
- 后端目标测试通过:确认式采集、项目化会话、移动身份、多项目组织同步、今日成果和主管项目权限。
- 移动端新增目标测试 6/6 通过,`vue-tsc --noEmit` 通过,H5 正式构建通过。
- 真实本地 HTTP 已验证:手机号登录、两项目列表、越权项目 403、巡检识别、PRIVATE/COMPANY 确认、状态幂等重试、冲突键 409、状态历史、两项目日报隔离、内容不变版本不增长、普通员工团队视图 403、主管跨项目 403。
- 390×844 实际交互已验证:项目面板、项目切换、文字采集、确认卡、确认保存、今日成果、状态推进、主管项目成果;截图路径见 §1.5。
- 旧移动端组合合同测试仍有 15 条失败:其中多数是旧首页/旧“工作上报”文案合同与本轮产品定案冲突,另有 uni-app 测试打包器与当前 Vue 版本的既有兼容错误;不得据此声称全量移动端测试通过,提交前需把过期合同迁移或明确列为基线债务。
- 尚未完成:生产迁移、正式发布、生产真机媒体回看、真实组织多项目 dry-run、外部线索/工单/考勤投递与回执。
## 9. 推荐施工顺序
内部 MVP 在 R1-R3 中按以下顺序完成:
1. 项目名称下拉选择。
2. 项目切换后的会话隔离。
3. 确认卡展示项目、日期和 AI 建议分类。
4. 保存晨会、巡检、业主服务、画像和线索。
5. 原始来源追溯。
6. 今日工作成果。
完成以上六项后,项目将形成可供客户真实体验的一线工作闭环。主管项目汇总、成果投稿联动和外部接口进入后续发布批次。
@@ -1,12 +1,13 @@
# 物业行业 AI 人力资源系统 · 业务需求文档(BRD)
> 版本:v1.5(统一版)| 日期:2026-07-19
> 版本:v1.6(统一版)| 日期:2026-07-21
> 定位:本文是本项目的**唯一事实源(Single Source of Truth)**,收敛此前所有讨论与文档,取代分散的局部材料作为业务需求基准。
> v1.1 变更:第 5 章数据模型方向补充"HR 主干已对齐《手册》卷1 第9章"结论(见 5.2)。
> v1.2 变更:新增阶段二“员工个人 AI 助理 / 个人知识空间”需求(见 4.8),明确个人资料、网页链接、时间检索、来源引用、PPT 增强项和阶段三外部 HR 数据边界。
> v1.3 变更:个人助理新增确认式长期记忆;一级交互收敛为“工作助手 / 查全网”,内部个人资料、项目业务记录和企业知识默认自动路由并透明展示来源。
> v1.4 变更:员工“工作上报”改为复用数字师傅的微信式语音会话,AI 只整理可编辑草稿,用户确认后进入原有审核链,审核通过仍不自动入知识库。
> v1.5 变更:“记一下”收敛为统一采集确认卡,系统建议分类,用户选择仅自己保存或提交公司处理;项目和房屋位置缺失不阻断保存,正式企业接口未接入前只展示待流转。
> v1.6 变更:统一“工作助手 / 今日工作成果 / 成果投稿”边界;多项目员工按项目名称选择当前项目,用户不输入项目编码。个人笔记可不关联项目,项目工作记录必须先确认当前项目;后续迭代见[《工作助手与今日工作成果迭代计划》](工作助手与今日工作成果迭代计划-20260721.md)。
>
> **收敛来源**:
> - 《物业管家与生活顾问 AI 陪练系统建设方案》(原始业务方案,陪练视角)
@@ -161,7 +162,9 @@
- **个人资料收藏**:员工可保存个人工作文字、PDF/Word/Excel/PPT、图片和网页链接;系统记录来源、收藏时间、主题、解析状态和原始附件,支持删除与导出。
- **个人检索与问答**:支持按日期范围、主题和来源查询个人内容,例如“上周收藏了哪些保洁管理资料”;基于选定资料总结、分析和提炼行动建议,回答必须展示引用来源。
- **内部知识自动路由**:员工默认只使用“工作助手”,系统在个人资料、项目业务记录和企业知识之间按意图和权限自动路由并展示实际引用;“资料范围”仅作为次级手动筛选,不要求普通员工预先理解数据域。
- **确认式统一采集**:显式“记一下/帮我记/保存一下”从文字或语音转写生成可编辑候选卡,系统建议服务线索、住户画像、优秀案例、个人想法、待跟进事项或工作记录;项目/楼栋/单元/房号缺失只作可选提示。用户必须选择“仅自己保存”或“提交公司处理”,后者在正式接收接口接入前仅进入待流转状态,不得宣称已生成工单或已上报。
- **确认式统一采集**:显式“记一下/帮我记/保存一下”从文字或语音转写生成可编辑候选卡,系统建议服务线索、住户画像、优秀案例、个人想法、待跟进事项或工作记录。当前版本允许项目/楼栋/单元/房号缺失并作可选提示;后续多项目迭代中,个人笔记仍可不关联项目,晨会、巡检、业主服务、画像、线索等项目工作记录必须先从项目名称下拉列表确认当前项目,项目编码不向用户展示或要求输入。用户必须选择“仅自己保存”或“提交公司处理”,后者在正式接收接口接入前仅进入待流转状态,不得宣称已生成工单或已上报。
- **今日工作成果**:确认后的日常工作记录按“员工 + 当前项目 + 自然日”聚合为可追溯成果,至少覆盖已完成事项、巡检问题、业主服务、画像/线索、到岗摘要和未闭环事项;问师傅的 30 分钟短会话不得因此全局改成 24 小时记忆。
- **成果投稿边界**:现有“工作上报”审核链只承载优秀案例、操作视频、完整 SOP 和有用知识,产品语义为“成果投稿”;工作助手可建议投稿,但必须由员工明确确认后进入既有审核链,不得把全部日常记录自动写入 `aihr_work_report`。
- **工作思路整理**:对日常冲突、工作灵感和零散想法生成结论、行动项、待确认事项;AI 仅辅助整理,不自动代替员工对外发布或作出管理决策。
- **内容生成**:阶段二首批提供摘要、提纲和可编辑文字;多资料对比、周报/月报和 PPT 生成作为阶段二增强项,PPT 先确认大纲与模板再生成。
- **分享与入库**:个人资料默认本人可见;分享给团队或沉淀为企业知识时必须由本人明确发起,经过权限校验、脱敏、审核和版本治理。
@@ -1,6 +1,6 @@
# 物业行业 AI 人力资源系统 · 开发规格(Tech Spec)
> 版本:v1.6 | 日期:2026-07-19
> 版本:v1.8 | 日期:2026-07-21
> 定位:**开发层唯一依据**。回答"怎么建"——工程结构、数据表、API 契约、Prompt 规格、集成适配。
> v1.1 变更:数据模型对齐《手册》卷1 第9章 HR 主干,补 3 张 backbone 表(职位职责/雇员绩效/雇用终止),新增附录 D 对照表。
> v1.2 变更:第 6 章按 Codex 设计评审重写——状态机补异常/终止态、COACH_CHECK 工程化、评分引擎分层(P0 单 LLM / P1 融合)、澄清"单场对练评分 vs 跨期能力画像"两套评分、Prompt 加固 + RAG 硬约束、新增 6.5 P0/P1 切分。
@@ -8,6 +8,8 @@
> v1.4 变更:移动端拆为独立 `mobile/` Vue/Vite Web/H5 工程,承载员工端、候选人端、主管端;后台管理端继续在 `frontend/`。
> v1.5 变更:当前用户侧以 `mobile-uni/` 为准;员工工作上报复用 `ChatComposer` 改为语音优先会话,增加无状态 AI 整理草稿契约,确认后继续提交既有 `aihr_work_report` 审核链。
> v1.6 变更:工作助手显式“记一下”复用 `/api/knowledge/query` 的 `memoryCandidate`,确认后写 `aihr_assistant_capture`;位置字段改为可选,增加 PRIVATE/COMPANY 范围、跟进时间和待流转状态。音色不在本次实现范围。
> v1.7 文档收口:明确当前“工作上报”是四类成果投稿审核链,工作助手负责日常事实采集;项目名称选择、项目化会话、来源追溯和今日工作成果仍属后续迭代,不能从规划文档推断已实现。详见[迭代计划](工作助手与今日工作成果迭代计划-20260721.md)。
> v1.8 本地实施回填:项目名称选择、项目化会话、确认记录来源/状态、员工今日成果、主管项目成果和“成果投稿”界面名称已完成本地实现与 390×844 验证,尚未部署和生产验证;外部线索、工单和考勤投递仍保持 PENDING。
> 配套:需求见[《物业AI人力资源系统业务需求文档BRD》](物业AI人力资源系统业务需求文档BRD.md);2026-07 MVP 执行计划已归档到[《AI人力资源系统一期MVP版作战清单》](archive/2026-07-mvp-delivery/AI人力资源系统一期MVP版作战清单.md)。
> **优先级图例**:`P0`=2026-07-05 MVP 演示必需 · `P1`=一期必需 · `P2`=二期/推迟。
> 决策基线:若依基座 / 集中式前后端分离 / 本地登录 / 公有大模型API / 一期RAG / 组织人员外部同步(MVP 用快照) / 数据范围以项目为主体。
@@ -178,7 +180,10 @@ mobile/
| `/h5/#/pages/user/today/index` | 员工端首页,手机号登录后可“开始训练”并同步主管待复盘计数;旧 `/h5/user` 兼容重定向 | P0跑通 |
| `/h5/#/pages/candidate/index/index` | 候选人端首页,手机号登录后可面试练习、查岗位 SOP/案例、上传补充资料;旧 `/h5/candidate` 兼容重定向 | P0跑通 |
| `/h5/#/pages/supervisor/index/index` | 主管端首页,查看团队、待复盘、案例/SOP 工具;旧 `/h5/supervisor` 兼容重定向 | P0跑通 |
| `/h5/#/pages/user/report/index` | 员工工作上报;目标交互复用「问」的微信式语音会话,AI 整理确认后提交既有审核链 | 已有表单链路,待交互升级 |
| `/h5/#/pages/user/sop/index` | 工作助手;按项目名称选择当前项目,语音/文字/照片/视频统一采集,确认后形成日常工作记录 | 本地已实现;媒体生产真机回归未完成 |
| `/h5/#/pages/user/work-results/index` | 员工今日工作成果;按员工、项目、自然日汇总确认记录和待跟进 | 本地已实现并完成 390×844 验证 |
| `/h5/#/pages/supervisor/work-results/index` | 主管项目成果;按目标项目权限查看员工成果和高优问题 | 本地已实现并完成 390×844 验证 |
| `/h5/#/pages/user/report/index` | 员工成果投稿;复用「问」的微信式语音会话,AI 整理确认后提交既有审核链 | 会话式页面和接口已部署;本地界面已正式改名;项目归属和媒体内容理解未实现 |
| `/train/daily` | 每日一练 | P1 |
| `/train/camp` | 专项训练营 | P1 |
| `/train/mistakes` | 错题本 | P1 |
@@ -257,22 +262,24 @@ POST /api/knowledge/case/organize req: { caseId } resp
POST /api/knowledge/case/curate req: { criteria, limit } resp: { selectedCaseIds[] } // 从多案例筛选
```
#### 5.3.1 员工工作上报会话化交互
#### 5.3.1 成果投稿会话化交互
实现基准:[work-report-voice-conversation-v1.png](prototypes/work-report-voice-conversation-v1.png)。后续 Agent 应复用图中的语音主入口、必要追问、结构化确认卡和显式“确认上报”,但安全、权限、长度校验和审核状态以本 TechSpec 与后端契约为准。
实现基准:[work-report-voice-conversation-v1.png](prototypes/work-report-voice-conversation-v1.png)。当前页面、整理接口、附件上传、幂等提交和“我的投稿”已经存在;该图用于视觉回归,不再作为待开发 Prompt。安全、权限、长度校验和审核状态以本 TechSpec 与后端契约为准。
员工端 `mobile-uni/src/pages/user/report/index.vue` 的目标形态复用现有 `ChatComposer` 和「问」页消息语言,不再让四类选择、标题和说明字段占据首屏。后台仍使用 `aihr_work_report` 及现有审核链,避免为视觉改版复制数据模型。
员工端 `mobile-uni/src/pages/user/report/index.vue` 已复用现有 `ChatComposer` 和「问」页消息语言,不再让四类选择、标题和说明字段占据首屏。后台仍使用 `aihr_work_report` 及现有审核链,避免为视觉改版复制数据模型。
当前能力边界:附件可以上传并随正式记录保存,但成果投稿 `organize` 只根据员工文字/ASR 转写、草稿和附件名称整理,附件名称是不可信元数据;该审核链没有对图片或视频内容做视觉理解。不得把“支持发照片/视频”描述成“AI 已看懂现场”。现场媒体理解、确认记录来源绑定与日报追溯由工作助手 `/api/knowledge/query-media` 和 `aihr_assistant_capture` 链路承担,不能反向冒充成果投稿已具备视觉理解。
```text
进入工作上报
进入成果投稿
→ 默认语音模式,可切换键盘或添加图片/视频
→ ASR 转写进入当前页面草稿
→ AI 从自然表达推断 CASE / VIDEO / SOP / KNOWLEDGE
→ 信息不足时只追问必要字段
→ 返回可编辑确认卡
→ 用户点击“确认上报”
→ 用户点击“确认投稿”
→ POST /api/aihr/work-report/reports
→ 返回 PENDING,并在会话与“我的上报”中展示审核状态
→ 返回 PENDING,并在会话与“我的投稿”中展示审核状态
```
最小接口策略:附件继续复用 `POST /api/aihr/work-report/attachment`,正式提交继续复用 `POST /api/aihr/work-report/reports`,历史继续复用 `GET /api/aihr/work-report/reports/mine`。只增加一个无状态整理接口,不新增草稿表或第二套会话表:
@@ -316,6 +323,8 @@ POST /api/aihr/work-report/organize
- 未实现服务端脱敏时,页面不得出现“提交后将自动隐藏具体房号”等承诺性文案。
- 页面只有一个继续补充入口;确认提交后返回 `PENDING` 状态卡并可从“我的上报”查到同一记录。
术语边界:本节的 CASE / VIDEO / SOP / KNOWLEDGE 属于成果投稿审核链;工作助手中的晨会、巡检、业主服务、画像、线索和待跟进事项属于 `aihr_assistant_capture`,两者不得自动互写。工作助手只能提出投稿建议,员工再次确认后才能创建 `aihr_work_report`。
### 5.4 AI 适配层(P0)
```
@@ -1,6 +1,6 @@
# 银城员工端 APP 分阶段实施总纲
> 版本:v0.5 | 日期:2026-07-19
> 版本:v0.6 | 日期:2026-07-21
> 输入源:《基于AI的银城员工端APP项目立项与开发规划会议(2026-07-07)》纪要 +《BRD v1.1》+《AI陪练二期开发推进计划 v0.8》+《数字师傅学练问报整合方案 v1.1》(docs/20260708/)。
> 定位:立项会把交付物从"AI 人力资源系统"升级为**银城员工端 APP**(员工服务载体)。本总纲定义三阶段顺序与边界;各阶段的执行细节仍由对应专项计划承载(阶段一 = 二期推进计划)。
> 分阶段口径(已定):**第一步陪练相关全部工作 → 第二步银城大喇叭 + 知识学习平台 → 第三步北森人事考勤对接**。
@@ -8,6 +8,7 @@
> v0.3 修订(2026-07-08,客户产品讨论):①阶段二"知识学习平台"扩充**学模块**——标准学习计划/课程/防快进视频/最短阅读时长/不定期考试,见 §4.5;②"新问题挂榜共创"产品形态定案为**开放问题榜**,定向师带徒经会议否决不做,见 §4.4;③新增知识分级访问权限工程需求;④三项待确认已获客户回复(2026-07-08):多端跳转暂缓(只保证能打开小程序页面,D6 不动)、排行榜保留为可选开关、员工评管理层按组织架构权限控制,见 §8 与《数字师傅学练问报整合方案 v1.2》§3.3。
> v0.4 修订(2026-07-11,客户微信补充):阶段二新增**员工个人 AI 助理 / 个人知识空间**——员工收藏个人文件、表格、PPT、文字和网页链接,按时间/主题检索并生成带来源的总结与分析;PPT 生成为增强项;北森、考勤等外部个人数据仍归阶段三。
> v0.5 修订(2026-07-19,客户讨论确认):个人助理新增“候选记忆 → 用户确认 → 分域持久化 → 可追溯召回”闭环。一级交互只保留“工作助手 / 查全网”;个人资料、项目业务记录和企业知识由工作助手内部自动路由并展示来源,不要求普通员工理解数据域。
> v0.6 收口(2026-07-21):确认式采集已部署;后续把项目名称选择、日常工作按自然日汇总和主管视图纳入工作助手迭代。现有四类“工作上报”审核链产品语义收敛为“成果投稿”,不得与日常记录或今日工作成果混用。
## 1. 立项会带来的定位变化
@@ -111,7 +112,8 @@
| MVP | 收藏个人文字、PDF/Word/Excel/PPT、图片和网页链接;自动提取正文、标题、来源、收藏时间和主题标签 | 阶段二首批 |
| MVP | 按日期范围、主题、来源查询“我哪些天收藏了什么”;基于选定资料问答、总结、提炼工作想法,答案必须带来源 | 阶段二首批 |
| MVP | 将冲突处理、工作灵感、保洁管理等问题交给个人助理分析;允许同时引用个人资料与有权限的企业知识 | 阶段二首批 |
| MVP | 显式“记一下/帮我记/保存一下”生成可编辑确认卡;用户选择仅自己保存或提交公司处理,后者在正式接收端接入前只显示待流转 | 已完成本地实现,待发布验证 |
| MVP | 显式“记一下/帮我记/保存一下”生成可编辑确认卡;用户选择仅自己保存或提交公司处理,后者在正式接收端接入前只显示待流转 | 已实现并部署;生产基础存在性已复核,正式账号/真机/业务验收仍待完成 |
| 2026-07-21 本地增量 | 多项目员工按名称选择当前项目;日常工作按员工 + 项目 + 自然日汇总为今日工作成果;现有四类工作上报收敛为成果投稿 | 已完成本地实现、真实 HTTP、H5 构建和 390×844 交互验证;尚未部署和生产验证,详见《工作助手与今日工作成果迭代计划》 |
| 增强 | 多份资料对比、周报/月报、结构化汇报提纲、个人知识标签和长期记忆 | 阶段二后半 |
| 增强 | 将总结导出为 PPT/汇报材料;先生成可编辑大纲,再生成文件,不把“一键 PPT”作为首批阻塞项 | 阶段二后半/P1 |
| 外部数据 | 北森、考勤、请假、组织任职等个人数据接入后再做跨系统分析 | 阶段三 |
@@ -122,7 +124,7 @@
- 网页链接需保留原 URL、抓取时间和正文快照;抓取必须防 SSRF、尊重访问权限与版权,登录态/付费内容不绕过授权。
- 回答需区分“个人资料”“企业 SOP”“外部网页”三类引用;未命中时明确提示,不编造来源。
- 公网查询不得由内部 AUTO 路由自动触发;必须由用户明确进入“查全网”,且不得自动携带住户或项目内部信息。
- 开工前另出专项 TechSpec,至少覆盖个人资料元数据、内容解析、个人检索空间、来源引用、删除/导出和数据保留策略。
- 个人资料元数据、内容解析、个人检索空间、来源引用、删除/导出和数据保留策略以[《个人AI助理阶段二专项 TechSpec》](个人AI助理阶段二专项TechSpec.md)为准;工作助手日常采集与今日成果的施工顺序以[专项迭代计划](工作助手与今日工作成果迭代计划-20260721.md)为准。
## 5. 阶段二不做什么(边界)