simon/wecom_it_smart_desk
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

feat: 2026-07-12~13 全量更新 - AI对话链路改造+H5 v4/v5+坐席端v5+上下文感知诊断+知识库迭代3

Browse Source 
## H5 员工端 v4 (2026-07-13 00:48 已部署)
- 人工按钮三态文案统一为"人工坐席"
- 按钮位置移至发送键和语音按钮上方(垂直堆叠)
- 点按钮直接调 store.shakeAgent()，删除 CallAgentModal 弹窗动画
- 截图快捷键提示改为"截图->粘贴：Alt+Shift+A-Ctrl+V ---> Ctrl+V"
- 移动端隐藏截图提示(CSS 媒体查询)
- AI转人工提示改为"已为您呼叫人工坐席，请稍等!"
- 坐席接入提示改为"坐席正在查看您的信息，请等待处理回复！"
- 删除"摇铃呼叫坐席"入口和文案
- 删除孤儿组件 MessageList.vue + shake 动画 CSS

## H5 员工端 v5 (2026-07-13 02:08 已部署)
- RightPanel v2.1：删除"软件安装"和"资源权限"标签页
- 移除标签栏，智能推荐(DynamicRecommend)直接展示
- 删除 SoftwareDownloads/ApprovalLinks 引用和相关 CSS

## AI 对话链路全栈改造 Phase 1-6 (已部署)
- Phase 1: Dify JSON输出 + 后端blocking解析 + 双WS推送 + 错误降级
- Phase 2: 关键词收窄(~25强意图词) + 两级分类Prompt + 删除前端checkApprovalIntent
- Phase 3: WS扩展(ai_thinking+dynamic_recommend) + ai_structured气泡 + RightPanel v2 + 选项回传
- Phase 4: VisionService接入 + 图片消息融合(5秒窗口) + 降级策略
- Phase 5: 坐席端ai_thinking指示器 + ai_structured/byod_card渲染 + handleNewMessage修复
- Phase 6: diagnosis_stage(6值) + response_time_ms计时 + 慢响应告警(>10s)

## 坐席端 v5 (2026-07-13 01:38 已部署)
- ai_structured/byod_card 只读渲染
- AI思考指示器 UI
- handleNewMessage 透传 msg_type/extra_data 修复
- 布局优化v2.0: QuickReplyBar L1+L2悬浮 + ReplyBox左右分区 + 右栏260/560px切换
- 键盘快捷键v2.3: 纯数字路由 + ESC分层撤销 + Shift+Space用event.code

## 上下文感知智能诊断闭环 (2026-07-12 已部署)
- 三层诊断(API→Script→AI) + 三段排队(VIP→info_locked→not locked)
- 答题插队 + 五场景关闭
- 迁移052(6表+6列) + queue_service + quiz_service + closing_service
- H5前端: QueueWaiting + RightPanel双Tab + InputBar三态 + ResolveConfirmCard
- 坐席前端: pending_close结单流程 + 信息锁定(Dify步骤完成+有效回答率≥70%)

## 知识库迭代3 (2026-07-12 已部署)
- 分诊交互(H5+坐席+Dify独立应用)
- 拓扑预览(ECharts只读)
- 代答排除(4种匹配器: keyword/regex/intent/category)
- 迁移051 + 44文件43测试通过

## 后端变更
- 6个Python文件改造(h5_ai_task.py/h5.py/ai_service.py/closing_service.py等)
- funny_phrase_service.py: shake/connected/keyword 默认文案更新
- session_service.py: 企微消息文案同步
- 新增: queue.py/quiz.py/triage.py/exclusion_rules.py 等API端点
- 新增: diagnostic.py/quiz.py/triage_session.py 等模型
- 新增: closing_service/queue_service/quiz_service/triage_service 等服务

## 文档更新
- CHANGELOG.md: 新增 [未发布] 区全部变更记录
- 项目管理主文档 v2.5: 新增v0.7.3版本 + 已完成看板 + 最近搞定
- 版本记录: 新增v0.7.3条目
- AI对话链路实施计划: Phase 1-6 全部标记✅已实施
- 新增架构图/时序图/类图(mermaid)

## 部署路径修正
- 服务器项目根路径: /opt/wecom-it-desk/
- 所有前端dist均为ro bind mount，只能在宿主机源路径操作
- 服务器nginx /h5/ 是静态文件服务(非proxy_pass)
- elFinder上传二进制不可靠(MD5不匹配)，改用base64分块上传
This commit is contained in:
Simon
2026-07-13 02:17:03 +08:00
parent bea288e414
commit 449c6d4875
176 changed files with 46637 additions and 4805 deletions
Download Patch File Download Diff File Expand all files Collapse all files
.workbuddy/automations/automation-1782986180887/memory.md
+35 -3
View File
@@ -1,5 +1,37 @@
# 早班巡检自动化 - 执行记录
## 2026-07-12 09:30 执行结果
**数据来源**：`docs/10-项目管理/任务说明书/IT智能服务台-项目管理主文档.md` (v2.4, 2026-07-10) + `.workbuddy/memory/2026-07-11.md` + `.workbuddy/memory/2026-07-12.md`
**说明**：指定看板路径仍不存在，状态看板在主文档第四章；看板版本滞后2天，07-11/07-12大量产出未入看板
### 关键发现
1. **P0阻塞2项持续未推进**：#48 IP白名单收窄（阻塞≈29天，自06-13）、#81 敏感词检测（阻塞≈8天，自07-04）— 均>3天，需PM立即关注
2. **#105数据不一致持续3次巡检**：已完成区+P1清单双重列出，07-04/07-10/07-11三次巡检指出至今未修正
3. **07-11/07-12大量产出未入看板**：代办事项集成(8bug修复链)、IT资产审批推送、语音识别、截图拍照、复杂场景重构、会议室预定系统(全栈部署)、知识库迭代3功能(44文件43测试通过)、知识迭代3Bug修复、坐席v9/v10部署修复、AI辅助消息框+布局优化技术设计文档
4. **进行中2项**：#91 忘记密码 + #107 后端卷挂载改造（后者07-11已恢复卷挂载，可能已完成需确认）
5. **等用户决策5项**：企微会议室Secret未申请、ITSM API授权待申请、ITSM代办API待抓包、布局优化v2.0的8个待明确事项、知识库迭代待确认
6. **看板版本严重滞后**：v2.4截止07-10，07-11全日+07-12产出均未入看板
### 全局状态
- P0待办：3项（2项长期阻塞）
- P1待办：5项（1项#105已完成未清理，1项#75可能已完成）
- 等决策：5项
- 进行中：2项（1项可能已完成）
### PM行动项
1. 联系网络组确认代理IP段（#48阻塞29天）⚠️紧急
2. 确认敏感词库来源/语气优化范围（#81阻塞8天）⚠️紧急
3. 从P1清单移除#105（连续3次巡检指出）⚠️数据质量
4. 确认#75头像同步是否已完成（07-08已交付12/12测试）
5. 确认#107卷挂载改造是否已完成（07-11已恢复卷挂载）
6. 企微管理后台申请会议室Secret
7. 向ITSM平台方申请app_id/app_secret
8. 确认布局优化v2.0的8个待明确事项
9. 更新看板至v2.5+，将07-11/07-12产出纳入已完成区
---
## 2026-07-11 09:30 执行结果
**数据来源**：`docs/10-项目管理/任务说明书/IT智能服务台-项目管理主文档.md` (v2.4, 2026-07-10) + `.workbuddy/memory/2026-07-11.md`
@@ -59,10 +91,10 @@
## 2026-07-04 09:30 执行结果
**数据来源**：`.taskboard-cache/任务执行状态看板_cache.json`（缓存时间 2026-07-03T08:44:12）
**⚠️ 原始看板文件缺失**：`docs/小组任务书/任务执行状态看板.md` 不存在，本次巡检基于缓存数据 + 07-03巡检记录 + REVIEW_B_T10.md 综合分析
**⚠️ 原始看板文件缺失**：`docs/小组任务/任务执行状态看板.md` 不存在，本次巡检基于缓存数据 + 07-03巡检记录 + REVIEW_B_T10.md 综合分析
### 关键发现
1. **看板源文件丢失**：`docs/小组任务书/任务执行状态看板.md` 路径不存在，该目录也未创建，PRD中有引用但实际文件缺失
1. **看板源文件丢失**：`docs/小组任务/任务执行状态看板.md` 路径不存在，该目录也未创建，PRD中有引用但实际文件缺失
2. **B-T10双重可激活信号**：①依赖B-T8已完成(33/33 PASS) ②REVIEW_B_T10.md显示代码评审已于07-03通过(IS_PASS: YES)，但缓存中仍为⏳等待中
3. **3个阻塞已逾期2天**：BLOCK-17(企微SSO)、BLOCK-19(扫码登录超时)、BLOCK-20(管理后台Network Error) 均 due 07-02，现已逾期2天
4. **BLOCK-18状态矛盾持续**：B-T17标记🟢已修复，但BLOCK-18阻塞表仍为🔵排查中（07-03已发现，至今未修正）
@@ -76,7 +108,7 @@
- 整体：39/55 (71%) — 若计入🟢则41/55 (75%)
### PM行动项
1. **恢复看板源文件** — `docs/小组任务书/任务执行状态看板.md` 缺失，需重建
1. **恢复看板源文件** — `docs/小组任务/任务执行状态看板.md` 缺失，需重建
2. 通知B组激活B-T10（依赖已完成 + 评审已通过）
3. 优先解决3个逾期阻塞(BLOCK-17/19/20)，已逾期2天
4. 确认BLOCK-18/B-T17真实状态并校正看板
.workbuddy/memory/MEMORY.md
+65 -46
View File
@@ -1,9 +1,13 @@
# IT智能服务台 - 项目记忆
## 设计决策（锁定）
- AI交互：小段多回合；术语："人工"=用户呼叫坐席，"摇人"=坐席呼叫坐席
- AI交互：小段多回合；术语：**员工端"人工坐席"按钮** = 用户呼叫坐席（统一命名，不再用"人工"/"摇人"变体）；"摇人"=坐席呼叫坐席
- 原型：坐席v5.3 + H5 v1.1；UI：企微浅色扁平，accent=#07C160
- 统一入口 `/itportal/` → user/agent/admin；admin需OTP
- **H5 v4（2026-07-13 00:48 已部署）**：人工按钮三态文案统一为"人工坐席"；位置在"发送键和语音按钮上方"（垂直堆叠于 `.input-bar__controls` 容器内）；点按钮直接调 `store.shakeAgent()`，不弹 CallAgentModal 浮窗动画；截图说明 PC 显示/移动端隐藏（CSS 媒体查询）
- **H5 v5（2026-07-13 02:08 已部署）**：RightPanel v2.1 — 删除"软件安装"和"资源权限"标签页，移除标签栏，智能推荐直接展示；JS hash `index-BP1rEZIf.js`，CSS hash `index-DC1iZpKe.css`
- **Agent v5（2026-07-13 01:38 已部署）**：ai_structured/byod_card 只读渲染 + AI思考指示器 + handleNewMessage 透传 msg_type/extra_data 修复；JS hash `index-2BTn4SZz.js`
- **后端 v5（2026-07-13 01:38 已部署）**：6个Python文件（h5_ai_task.py/h5.py/ai_service.py/closing_service.py等）；diagnosis_stage(6值)+response_time_ms计时+VisionService接入+双WS推送(ai_reply+dynamic_recommend)+ai_thinking同时推员工和坐席
## 技术架构
- 前端：坐席(Vue3+Element Plus) / H5(Vue3+Vant4) / 管理后台(Vue3+Element+Tailwind)
@@ -14,63 +18,78 @@
## 部署
- 正式服务器：itsupport.servyou.com.cn (10.90.5.110)，出口IP `218.75.34.87`
- 堡垒机：sxn@10.212.189.210:2222 (OTP)，脚本 `C:\Users\simon\.workbuddy\skills\jumpserver-ops\scripts\jms_ops.py`
- **服务器项目根路径**：`/opt/wecom-it-desk/`（非本地仓库路径）
- 后端卷挂载：`./app:/app/app`，`.py`变更→`docker compose restart backend`；env变更→`up -d backend`
- 前端：rm旧→tar解压dist/→`restart nginx`；Nginx: H5→`/html/h5` / Agent→`/html/itagent` / Admin→`/html/itadmin`
- Docker bind mount铁律：rm后重建必须重启容器
- 部署工具：`jms_ops.py pack-upload <local_dir> <remote_dir>`（≥100KB用此）
- httpx.Timeout须含default：`httpx.Timeout(timeout=30.0, connect=10.0, read=30.0)`
- **前端部署铁律**：所有前端 dist 均为 ro bind mount，**只能在宿主机源路径操作**，不可在容器内修改
- H5：`/opt/wecom-it-desk/frontend-h5/dist` → `/usr/share/nginx/html/h5` (ro)
- Agent：`/opt/wecom-it-desk/frontend-agent/dist` → `/usr/share/nginx/html/itagent` (ro)
- Admin：`/opt/wecom-it-desk/frontend-admin/dist` → `/usr/share/nginx/html/itadmin` (ro)
- Portal：`/opt/wecom-it-desk/frontend-portal/dist` → `/usr/share/nginx/html/itportal` (ro)
- Terminal：`/opt/wecom-it-desk/frontend-terminal/dist` → `/usr/share/nginx/html/itterminal` (ro)
- nginx.conf：`/opt/wecom-it-desk/nginx/nginx.conf` → `/etc/nginx/nginx.conf` (ro)
- 部署命令模板：`H5_DIR=/opt/wecom-it-desk/frontend-h5/dist && cp -r $H5_DIR ${H5_DIR}_bak && rm -rf $H5_DIR/* && tar -xzf /tmp/h5-dist-vX.tar.gz -C $H5_DIR/ && docker exec wecom_it_nginx nginx -s reload`
- **服务器 nginx /h5/ 配置**（与本地仓库不同）：静态文件服务 `root /usr/share/nginx/html; try_files $uri /h5/index.html;` + `/h5/api/` 反代后端
- Docker bind mount铁律：rm后重建必须重启容器（或 `nginx -s reload` 热重载）
- **文件上传**：elFinder Web UI（`hz-oa-ai-g-dataquery-90-5-110`目录=服务器`/tmp/`）/ fast_upload_v3.py（~20KB/s）/ jms_ops.py pack-upload
- ⚠️ **elFinder 上传二进制文件不可靠**（2026-07-13 确认）：tar.gz 上传后 MD5 不匹配（差90字节）。**推荐用 base64 分块上传**：`jms_ops.py batch` 模式，45KB/块，~113秒/7.6MB（脚本 `.workbuddy/tmp/chunked_upload_v2.py`）
- pscp/plink -T不可用；elFinder上传后需手动mv；httpx.Timeout须含default
- **JumpServer v2.28 变更**：登录新增图片验证码(CAPTCHA)；connection-token 端点改为 `/api/v1/authentication/connection-token/`
## 外部集成
- 企微通讯录：Secret `BM6iosc3gKnPqkEXmsQN3ErJUpfO-whfMUN646eezB8`，Redis key=`wecom:contact_access_token`
- Dify：`http://yw-dify.dc.servyou-it.com/v1/chat-messages`；审批意图Key `app-7jkRkAzvX4QM9v9SM3P8mMEO`
- Dify：`http://yw-dify.dc.servyou-it.com/v1/chat-messages`；审批意图Key `app-7jkRkAzvX4QM9v9SM3P8mMEO`；分诊Key `app-z3S9AEUUAVPbtR2rioxpiIvp`
- ⚠️ **禁止使用** `app-UaTWYdBSwN6VktKQlbh5YN5H`（老线上Dify应用，未收到明确指令前不可调用）；应使用副本 `app-7jkRkAzvX4QM9v9SM3P8mMEO` 或自建 `app-J3s8sHarZQ2SCaNF3xCppliL`（后者不适合dify2openai代理，仅限直接API调用）
- RAGFlow：生产 `http://10.80.0.85:8080/` / API `:9380`
- 映射策略：联软(主) > aTrust(VPN) > eHR(静态)
## 群聊系统
- 摇人(`collaborating_agent_ids`) / 邀请(`participants`)；四角色权限
- 参与者展开/缩略双模式；头像代理 `/api/avatar/proxy` 解决 COEP/CSP
## 企微JS-SDK技术
- 双鉴权：`wx.config()`(jsapi_ticket) + `wx.agentConfig()`(agent_config_ticket)，签名算法相同但**不能混用**
- `wx.invoke('thirdPartyOpenPage', {oaType:'10001', templateId, thirdNo, extData})` 原生打开审批表单
- 后端端点：`GET /wecom/jsapi-config?url=...&with_agent_config=true`
- 前端composable：`frontend-h5/src/composables/useWecomApproval.ts`（懒加载+全降级+超时保护）
- 既有bug：`EmergencyDispatcher.vue` 第99-119行 复用jsapi签名给agentConfig（靠3秒超时兜底）
## 审批流程系统（2026-07-10上线）
- 12种审批类型 / 18个流程；意图识别三级链路：关键词→Dify→降级
- 卡片导航用 `window.location.href`（同窗口）
## 已上线功能模块
- 群聊(摇人/邀请/四角色) / 审批(12类型18流程/三级意图) / 代办(getapprovalinfo+Semaphore/缓存45s)
- IT资产推送(模板`Bs7ucT...`) / 语音转文字(手机JS-SDK/PC百度ASR) / 截图拍照 / 复杂场景P0~P3
- 会议室预定(终端`/itterminal/`，企微会议室Secret待申请)
## 代办事项真实数据源集成（2026-07-11部署+修复完成）
- **PRD**：`docs/02-产品需求/prd_todo_integration.md`
- **后端**：`todo_source_service.py` / `itsm_service.py` / `todo_aggregator_service.py`(Redis缓存45s)
- **前端**：`TodoPanel.vue` / `todo.ts`(API+Store)
- **企微审批API**：`getapprovalinfo`（旧`getapprovaldata`已废弃404）→ Semaphore(10)并发`getapprovaldetail` → 代码层过滤template_id
- **Token方案**：统一用 `TokenManager`（IT支持应用Secret，IP已在白名单）
- **缓存策略**：初始+60s自动=用缓存(无_force) / 手动🔄=跳过缓存(_force=1) / TTL=45s
- **8个Bug修复链**：env未注入→Redis密码→bind mount丢失→API废弃→token decode→IP白名单60020→filter参数301025→**_extract_current_approver字段名全错**
- **企微API实际字段名**（dump确认）：`sp_record[].sp_status`（非status）/ `details[].approver.userid`（非approver[].userid）
- **验证**：sxn名下2条审批单正确返回（IT资产外修申请）
- **ITSM**：工单详情API已实现，代办列表API待抓包；签名 app_id+app_secret+SHA1
- **测试**：40/40通过
## 坐席端布局优化v2.0（2026-07-12 部署）
- 8新增+7修改+3删除；QuickReplyBar L1+L2悬浮；ReplyBox左右分区；右栏260↔560px模式切换
- **键盘快捷键v2.3**：纯数字1~9上下文路由(AI/L1/L2)；ESC分层撤销；Shift+Space用`event.code`匹配(不受IME影响)
- `useKeyboardShortcuts.ts`中央管理器，IME/ScreenCapture守卫；L1 chip移除模板数量徽章只保留kbd编号
## IT资产升级审批推送（待部署）
- 模板ID：`Bs7ucTGsPuFhxfk8pn8EydxrWxkVetB4JR8Pb6PHS`
- 新建 `asset_service.py`；修改 `approval.py`(+urge端点) / `config.py`(+asset_excel_path)
- 资产Excel：12月度sheet，编码列(2)匹配，日期列(41)算年限
## 知识库迭代3功能（2026-07-12 部署）
- 分诊交互(H5+坐席+Dify独立应用) + 拓扑预览(ECharts只读) + 代答排除(4种匹配器)
- 44文件43测试通过；迁移051；路由顺序铁律：固定路径必须在参数路由前注册
## 语音识别转文字（2026-07-11部署）
- 手机企微=JS-SDK / PC企微=百度ASR(AppID=123947532) / Mac=隐藏
- H5内联录音：🎤→⏹→⏳(disabled)
## 上下文感知智能诊断→修复闭环（2026-07-12 已部署）
- 三层诊断(API→Script→AI) + 三段排队(VIP→info_locked→not locked) + 答题插队 + 五场景关闭
- 后端：迁移052(6表+6列) / queue_service / quiz_service / closing_service / seed_quiz / 每日3:00定时生成
- H5前端：QueueWaiting / RightPanel双Tab / InputBar三态"人工"按钮 / ResolveConfirmCard
- 坐席前端：pending_close结单流程；信息锁定(Dify步骤完成+有效回答率≥70%)
- **部署时间**：2026-07-12 21:24（H5前端通过jms_ops.py upload elFinder通道上传7.61MB）
- **验证**：Queue API 200 ✅ / Quiz API 200 ✅ / H5页面200+新JS hash ✅ / Agent前端v2.3 ✅ / Nginx healthy ✅
## 坐席端截图+拍照（2026-07-11部署）
- 截图编辑器(马赛克/文字/箭头/矩形/撤销)；拍照(getUserMedia→兜底input capture)
- 铁律：`.selection-box`必须`pointer-events:none`；文字工具CSS类切换非v-if；`getDisplayMedia()`必须同步调用
## 复杂场景重构（2026-07-11部署）
- P0~P3：任务中断恢复/信息更正/上下文压缩/多轮纠错
- 路由前缀`/itportal/automation/`；迁移链修复041→028_merge_heads
## 知识库迭代（待确认）
- 技术方案：`docs/03-技术架构/增量设计-知识库迭代与痛点缓解-20260711.md`
- 原型图：`docs/01-产品设计/知识库迭代-未实现功能原型设计-20260711.md`
## 近期修复 (2026-07)
- H5非企微环境→扫码登录页；Vue版本不一致白屏→重装+`ElMessage._context`
- 消息重复/头像COEP/OAuth残留→已修
## Dify App改造 + 右边栏v2（2026-07-12 设计确认 → Phase 1-3 已完成）
- **Dify App现状**：85节点→计划精简至~35；保留RAGFlow+Vision节点（后端未接入前不删）
- **单通道统一消息架构**：Dify输出JSON `{text, action, options}` → 后端发两条WS（ai_reply+dynamic_recommend）→ 文字到聊天气泡/卡片到侧边栏
- **审批意图优化**：删除前端`checkApprovalIntent()`；关键词预过滤收窄(~40→~25)；两级分类(4粗→12细)；后端统一入口
- **右边栏v2.1已实施**（v2.1 2026-07-13：删除软件安装/资源权限标签，全面AI化）：
- 手风琴两大区域：设备信息(默认折叠) / 自助诊断(默认折叠)
- 智能推荐区域：DynamicRecommend 组件直接展示（无标签栏切换，始终可见）
- 设备信息：CPU/内存/硬盘默认隐藏（避免焦虑）
- 自助诊断标签：网络联通/账号权限/设备硬件
- **Phase 1-3 完成状态**（2026-07-12）：
- Phase 1 ✅：Dify Prompt(JSON输出) + 后端blocking+JSON解析+双WS推送 + 错误降级(30s超时/15s still_thinking)
- Phase 2 ✅：关键词收窄(~25强意图词) + 两级分类Prompt v4.0 + 删除前端checkApprovalIntent
- Phase 3 ✅：WS扩展(ai_thinking+dynamic_recommend) + MessageBubble ai_structured渲染(文字+选项按钮) + RightPanel v2.1(手风琴+智能推荐直接展示) + DynamicRecommend.vue(新建) + sendOptionSelect WS回传
- **Phase 4 ✅**：VisionService接入(`_enrich_image_content`+`_fetch_recent_employee_text`5秒融合) + 图片消息跳过关键词拦截 + 降级策略
- **Phase 5 ✅**：坐席端`ai_thinking` WS+指示器UI + `MessageBubble` ai_structured/byod_card渲染 + `handleNewMessage`修复(msg_type/extra_data透传)
- **Phase 6 ✅**：`diagnosis_stage`字段(6种值) → `closing_service`辅助方法 + `response_time_ms`计时+慢响应告警(>10s)
- **v2.0 新增前端文件**：`DynamicRecommend.vue`（动态推荐卡片，3种类型 approval/action/info）
- **v2.0 关键架构**：`sendWsMessage()` 模块级导出函数（useH5WebSocket.ts），供 store 在 composable 外部发送 WS 消息
- **实施计划文档**：`docs/02-产品需求/AI对话链路全栈改造实施计划-v1.0.md`（6阶段Phase 1-6，10个Task #59-#69跟踪）
## 运维工具
- SOP：`docs/10-项目管理/IT智能服务台-标准作业流程SOP.md`