Differences

This shows you the differences between two versions of the page.

--- 研发复盘:冷启动文件 [2026/08/18 15:58] – 研发任务日复盘冷启动文件 v1.0 172.17.0.1
+++ 研发复盘:冷启动文件 [2026/08/27 07:58] (current) – v4.4 负责人折叠/创建带更新 172.17.0.1
@@ Line 1: / Line 1: @@
-======= 研发任务日复盘 — 冷启动文件 =======
+======= 研发任务（日复盘 + H5 管理）— 冷启动文件 =======
-> 版本: 1.0 ｜ 日期: 2026-08-18 ｜ 用途: 研发任务日复盘工作流的冷启动/重建/排障手册
+> 版本: 4.4 ｜ 日期: 2026-08-27 ｜ 用途: 研发任务日复盘推送 + H5 任务管理工具的冷启动/重建/排障手册
 > 服务器: 腾讯云轻量 lhins-1dai07vu ｜ 系统: Ubuntu ｜ 时区: Asia/Shanghai
-> 工作流名称: **研发任务日复盘**（每天09:00微信自动推送任务清单+更新提示）
+> 工作流: ①**研发任务日复盘**（工作日09:00微信推送）②**研发任务 H5**（http://82.156.85.124:13544/rd/ 浏览器管理）③**钉钉日报**（工作日10:00发钉钉群）
+> v4.4 更新: 负责人折叠选择器（默认收起点击展开，去+更多）、创建任务/子任务可带更新内容、日报子任务只显最新一条、家务每日小初按摩+每10天施肥（家庭侧）
+> v4.3 更新: 钉钉全家桶（通讯录MCP+免登+组织架构同步+权限控制）、人员库 people.json 动态化+勾选快捷栏、日报（昨日/今日可选+子任务归属去重+钉钉群webhook发送 cron 52967bf00170）、负责人钉钉下拉+自定义、更新记录倒序、AI对话语言表(SOUL.md)
+> v4.2 更新: raw 前缀自动补全（后端 add/update 保证 [优先级](项目) 前缀，防微信复盘缺显示）、name 字段撤回（列表仍显示 raw）、详情页任务名称输入框保留
+> v4.1 更新: 临时小任务独立体系（独立序号/无项目优先级/时间补填/组内分类统计）、子任务更新【任务名-子任务名·负责人】、更新与进度解耦、跟踪任务开始/结束时间自动记录、任务名称字段
+> v4.0 更新: 新增 H5 管理工具章节（部署/API/功能/同步机制/排障）；v3.0 的负责人彩色分组、编号复用、工作日周期规则保留
 ---
@@ Line 10: / Line 15: @@
 <code>
-任务清单(~/docs/rd_tasks.json)
+~/docs/rd_tasks.json（唯一数据源）
-  → 每天09:00 cron 触发 rd_daily_review.py
+  ├─→ 复盘推送: cron b9dbd39c3f34（工作日 09:00）→ rd_daily_review.py → 微信
-  → 生成复盘文本（编号: 颜色【优先级】(项目名)任务内容 📝【今日：更新】）
+  └─→ H5 管理: systemd rd-h5.service（:13544）→ rd_h5.py + rd_h5.html → 浏览器
-  → 微信推送（no_agent 脚本模式，stdout 即消息）
+         ↑ 双向同步：H5 里改任务 → JSON → 复盘推送同步显示
 </code>
-**用户更新方式（随时）：**
+**两个入口（同一份数据）：**
-- 「更新N：内容」→ 记录今日更新
+| 入口 | 用途 | 地址 |
-- 「N：完成」→ 标记完成
+|------|------|------|
-- 「新增[高](项目)任务内容」→ 自动续号新增
+| 微信复盘 | 每日 09:00 自动推送任务清单+超期提示 | cron b9dbd39c3f34 |
+| H5 管理 | 浏览器操作（筛选/进度/子任务/日报/只读）| http://82.156.85.124:13544/rd/ |
+| H5 只读 | 给团队/领导查看（无编辑权限）| http://82.156.85.124:13544/rd/?ro=1 |
 ====== 2. 文件清单 ======
@@ Line 25: / Line 32: @@
 | 文件 | 说明 |
 |------|------|
-| ~/docs/rd_tasks.json | 任务清单（唯一数据源）|
+| ~/docs/rd_tasks.json | 任务清单（唯一数据源，H5 与复盘共用）|
-| ~/.hermes/scripts/rd_daily_review.py | 每日复盘生成器（09:00 cron 调用）|
+| ~/docs/rd_tasks_completed.json | 已完成任务归档 |
-| ~/.hermes/scripts/rd_task_update.py | 任务更新/新增工具 |
+| ~/.hermes/scripts/rd_daily_review.py | 复盘生成器（cron 调用，no_agent）|
-| cron b9dbd39c3f34 | 「研发任务日复盘」每天 09:00（no_agent=true）|
+| ~/.hermes/scripts/rd_task_update.py | 微信更新工具（--add 编号复用）|
+| ~/.hermes/scripts/rd_history.py | 历史查询（--month/--week/--last/--all）|
+| ~/.hermes/scripts/rd_h5.py | **H5 后端**（Flask :13544，API + 日报 + 免登 + 组织架构）|
+| ~/.hermes/scripts/rd_h5.html | **H5 前端**（单文件，无外链）|
+| ~/.hermes/scripts/rd_logo.jpg | H5 首页慧飞 logo |
+| ~/.hermes/scripts/ding_daily_report.py | 日报发送钉钉群（webhook 通道）|
+| ~/docs/people.json | 人员库（简称→全名 + roles 管理员名单）|
+| ~/docs/ding_org.json | 钉钉组织架构快照 |
+| ~/docs/AI对话语言表.md | AI 行为规范（已并入 SOUL.md）|
+| /etc/systemd/system/rd-h5.service | H5 常驻服务（开机自启，root 运行）|
+| cron b9dbd39c3f34 | 复盘推送（0 9 * * 1-5，no_agent）|
+| cron 52967bf00170 | 钉钉日报（0 10 * * 1-5，no_agent → ding_daily_report.py）|
+| cron af464d70c514 | 古筝课每周课时（无关，勿混）|
-====== 3. 推送格式（微信优化版） ======
+====== 3. H5 管理工具（v4 新增） ======
-<code>
+**启动/重启：** `sudo systemctl restart rd-h5.service`（用 ctwing-2 venv 的 python，有 flask）
-📋 研发任务日复盘 2026-08-18（在办 32 项）
-: 🟡【中】(其他)25年项目验收(8月底统一处理)
+**API 一览：**
-: 🟡【中】(表压)爆破胶测试，50套 📝【今日：今日已安排任务】
+| 接口 | 方法 | 功能 |
-: 🔴【高】(P3)双球阀测试，阀体测试(漏，等新阀体，上盖等新上盖)
+|------|------|------|
-⏸️ 挂起:
+| /rd/ | GET | H5 页面（no-cache 头）|
-: ⚪【挂起】(其他)发明专利申请
+| /rd/?ro=1 | GET | 只读模式（隐藏所有编辑入口）|
+| /rd/logo.jpg | GET | 首页 logo |
+| /api/tasks | GET | 任务列表（含 owner_map/projects）|
+| /api/tasks | POST | 新增任务（type: track/temp）|
+| /api/tasks/&lt;id&gt; | POST | 更新（priority/owners/project/status/progress/subtasks）|
+| /api/tasks/&lt;id&gt; | DELETE | 删除（编号释放）|
+| /api/tasks/&lt;id&gt;/note | POST | 记录更新（自动+2%，99 封顶）|
+| /api/tasks/&lt;id&gt;/subtask/&lt;i&gt;/note | POST | 子任务更新（+2%，记录【子任务·负责人】）|
+| /api/report/today | GET | 生成研发中心日报（?date=昨日/今日可选；星级评价+只读链接）|
+| /api/ding/login | POST | 钉钉免登：authCode → 员工身份（userid/name）|
+| /api/ding/org | GET | 钉钉组织架构同步（30分钟缓存）|
+| /api/people | GET/POST | 人员库查询/加入（自动简称）|
+**H5 功能清单（v4.1，用户定稿）：**
+- 筛选：优先级/项目/状态/更新天数(1-30 工作日)/搜索/人员点击(多选)
+- 默认按人员分组，组内分 **📌跟踪任务 / ⏱️临时小任务** 两个子区；点人显示主负责+子任务负责两组；"全部"按钮
+- 进度条：宽度=百分比数字（.pfill 必须 display:block）；**进度仅手动设置（更新内容不加进度，2026-08-26 定稿）**；有子任务时任务进度=子任务平均
+- 详情页：任务名称/内容/项目/多负责人/优先级/状态/进度可改；**状态含 未开始/进行中/暂停/已完成**；**开始时间=设进行中或首次更新时自动记录，结束时间=设已完成时自动记录**
+- **负责人选择器**：折叠式（默认收起只显示已选，点击"👤 选择负责人"展开钉钉人员复选框勾选）；人员=钉钉通讯录固定
+- **创建任务可带更新内容**：新增表单（跟踪/临时）有"更新"输入框，创建时自动记录
+- **创建子任务可带更新内容**：子任务行"更新内容"输入，保存任务后自动记录【任务名-子任务名·负责人】
+- 子任务管理：名称/负责人/进度/更新内容；子任务更新：内容必填→进度+2%（99 封顶），记入总 notes 格式 `【任务名-子任务名·负责人】内容`
+- 新增任务两种类型：
+  - 📌**跟踪任务**：持续多人跟踪，时间跨天（字段：任务名称/内容/项目/优先级/负责人）
+  - ⏱️**临时小任务**：着急当天完成，5分钟<耗时<2小时，负责人必选（字段：任务名称/内容/负责人/开始时间/耗时；创建后默认进行中，时间可完成后补填）
+- 临时小任务显示：**独立序号**（每人每天从1开始⏱️1/⏱️2，历史显示📅日期），无项目/优先级/进度条/更新标记，列表只显示任务名称（详情显示完整内容），组头统计`（N项·共X小时Y分）`
+- 生成日报：标题"研发中心日报"，只读链接最前面，负责人全名，任务前【项目名】，星级评价（★~★★★★★）；**今日/昨日可选（?date=）**；**子任务归属**（子任务更新协同主任务显示到子任务负责人名下，同子任务只显示最新一条）
+- 今日已更新 ✓ 标记；日期按本地零点计算（防 UTC 偏移）
+====== 3.5 钉钉集成（v4.3） ======
+- **免登**：钉钉工作台打开 → authCode → /api/ding/login → 员工身份（凭证 .env DINGTALK_CLIENT_ID/SECRET）
+- **权限**：people.json roles.admin（武燕青/张景茹/潘保琰/席江锋/宋逊文/刘瑞红）= 全功能；普通员工=只看自己任务（主负责+子任务）只读；未登录=只读
+- **组织架构**：/api/ding/org 拉取钉钉部门+员工（30分钟缓存）；人员筛选快捷栏=钉钉全量+勾选配置（localStorage rd_people_picks）
+- **负责人下拉**：钉钉通讯录 + 自定义人员（"＋更多负责人"→ /api/people 自动加入）
+- **日报发送**：ding_daily_report.py → 群机器人 webhook（.env DINGTALK_GROUP_WEBHOOK，研发中心日报群）；cron 52967bf00170 工作日10:00自动发当日日报；命令行支持指定日期（发昨日）
+- **钉钉 MCP**（Hermes 侧）：dingtalk-contacts/bot/todo/group/oa（重启 gateway 生效）
+====== 4. 推送格式（微信复盘） ======
+<code>
+📋 研发任务日复盘 2026-08-26（在办 N 项）
-💬 更新方式：发「更新N：内容」或「N：完成」；新增任务发「新增[高](项目)任务内容」
+🔵武 1: ✅【中】(其他)25年项目验收(8月底统一处理) 📊0%  📝 今日: 内容
+🟣张 7: 【中】(P3)P3电路测试(安排) 📊50%  📝 昨天: 内容
+...
+⏸️ 挂起: ...
+⚠️ 超期未更新（工作日）: #N（...）← 超期X个工作日
+🏁 已完成: ...
+💬 更新方式：发「更新N：内容」或「N：完成」；新增任务发「新增(高)(项目)任务内容」
 </code>
-**格式规则：**
+**格式铁律：**
-- `编号: 颜色【优先级】(项目名)任务内容(备注) 📝【今日：更新内容】`
+- 负责人：彩色圆点+简称（🔵武/🟣张/🟠潘/🔴席/🟢宋/🟡刘/🟤汤/⚪无），按负责人分组，组内高→中→低
-- 颜色圆点：🔴高 ｜ 🟡中 ｜ 🟢低 ｜ ⚪挂起
+- **半角 `[中]` 是微信表情代码会被吞** → 必须全角【】；项目名必须用小括号且不能为空
-- **优先级必须用全角【】**——半角 `[中]` 会被微信当表情代码吞掉（只剩"中"且项目名连带丢失）
+- ✅ 绿钩=今日更新；📊N%=进度（H5 同步）；📝 只显示最新一条更新（今日覆盖历史）
-- **项目名必须用小括号**且不能为空（如 (乌苏)）
+- 更新记录日期：今日/昨天/前天/M月D日（自然日）
-- 今日更新用 `📝【今日：xxx】` 全角括号包裹（半角星号 `*xxx*` 会被微信渲染成斜体/引用样式，不要用）
+- 编号：阿拉伯数字；完成/删除后**释放复用**（新增用最小空缺，不重排）
-- 任务完全保留用户原始文本，只在前面加编号、后面附今日更新
-- 挂起任务排最后（⏸️ 挂起分组），不参与逾期提醒
-====== 4. 优先级与更新周期 ======
+====== 5. 更新周期（2026-08-25 定稿，按工作日） ======
-| 优先级 | 颜色 | 更新周期 | 逾期提示 |
+| 优先级 | 周期 | 说明 |
-|--------|------|----------|----------|
+|--------|------|------|
-| 高 | 🔴 | 每天 | 超1天提示 |
+| 高 | 1 个工作日 | 每日必更（进度%+内容描述）|
-| 中 | 🟡 | 2天 | 超2天提示 |
+| 中 | 3 个工作日 | |
-| 低 | 🟢 | 3天 | 超3天提示 |
+| 低 | 5 个工作日 | |
-| 挂起 | ⚪ | — | 不提醒 |
+| 挂起 | 30 个工作日 | |
-超过5天未更新 → 🔴「必须更新」红色提示。
+- 工作日 = 跳过周六日（H5 筛选与复盘超期提示一致）
+- 超期未更新 → ⚠️ 超期提示（H5 任务行红字 + 复盘推送末尾列表）
+- 周末不推送（cron 0 9 * * 1-5）
-====== 5. 任务清单 JSON 结构 ======
+====== 6. 负责人映射与项目规范 ======
+**负责人简称→全名（H5 显示全名，复盘显示简称）：**
+武=武燕青 ｜ 张=张景茹 ｜ 潘=**潘保琰** ｜ 席=席江峰 ｜ 宋=宋讯文 ｜ 刘=刘瑞红 ｜ 汤=汤宝岩
+**项目（2026-08-25 合并定稿）：**
+拓远T1（拓远+T1）｜ 普惠P1（P1+普惠P1）｜ 金穗S1（金穗+金穗S1+S1）｜ 其他（研发文件+管理+模具+测试）｜ P3 ｜ P5 ｜ 表压 ｜ 软管泵 ｜ 施肥阀 ｜ AI 等
+====== 7. 任务 JSON 结构 ======
 <code>
-{"id": 1, "raw": "[中](其他)25年项目验收(8月底统一处理)",
+{"id": 4, "raw": "[中](拓远T1)二维码，安排实际尺寸测试",
- "priority": "中", "last_update": "2026-08-18",
+ "priority": "中", "project": "拓远T1", "name": "二维码实际尺寸测试",
- "done": false, "notes": [{"date": "2026-08-18", "text": "今日更新内容"}]}
+ "owners": ["席"], "last_update": "2026-08-26",
+ "done": false, "progress": 51, "status": "进行中",
+ "start_time": "2026-08-26 15:50", "end_time": "",
+ "notes": [{"date": "2026-08-26", "text": "【任务名-子任务·负责人】内容"}],
+ "subtasks": [{"name": "子任务", "owner": "张", "progress": 50}],
+ "type": "track", "duration": 0}
 </code>
-- **raw**：用户原始任务文本（含[优先级](项目名)），一字不改
+- **id**：编号复用（最小空缺）；**raw**：用户原文（含[优先级](项目名)）
-- **priority**：高/中/低/挂起（必须与 raw 开头 [x] 一致！曾因正则 bug 污染成"中)(其他"导致显示异常）
+- **owners 数组**（H5 v2+）；旧数据兼容单值 owner（复盘 get_owner 兼容）
-- **notes**：更新日志（date+text），复盘取最后一条
+- **progress**：仅手动设置（更新内容不加）；有子任务时=子任务平均
-- **done**：完成标记（完成后从清单移入"已完成"）
+- **type**：track/temp；temp 任务含 start_time(当天时间)/duration(5<分钟<120)，创建后默认进行中
+- **name**：任务名称（跟踪任务，详情页维护）
+- **start_time/end_time**：开始=设"进行中"或首次更新时自动记；结束=设"已完成"时自动记
-====== 6. 排障速查（血泪教训） ======
+====== 8. 排障速查（血泪教训） ======
 | 症状 | 原因与修复 |
 |------|-----------|
-| **微信里 [中] 变"中"、(乌苏) 消失** | 半角 `[中]` 是微信**表情代码**语法被吞！→ 输出时转**全角【中】**（raw 保持用户格式，显示层转换）|
+| H5 进度条不按比例 | `.pfill` 是 span(inline)，width% 无效 → 加 `display:block` |
-| **今日更新显示成斜体/引用样式** | 半角星号 `*今日:xxx*` 被微信渲染 → 改用 `📝【今日：xxx】` 全角括号 |
+| 昨天更新显示"今日" | daysAgo 用 UTC 解析偏移 8h → `setHours(0,0,0,0)` 本地零点 |
-| **某些任务【】转换不生效** | priority 字段被污染（如"中)(其他"）→ 从 raw 开头 `^\[([^\[\]]+)\]` 重新提取修复 |
+| "今日已更新"筛选含昨天 | workdaysBetween `while(d<t)` 漏算今天 → `while(d<=t)` |
-| **emoji 颜色不显示** | 微信正常显示 emoji 圆点（🔴🟡🟢⚪），若个别机型不显示可接受 |
+| 昨天更新仍在"今日已更新" | 浏览器缓存旧 JS → 后端加 no-cache 头 |
-| **挂起任务还提醒** | 复盘脚本已跳过 priority=挂起 的任务（normal/suspended 分组）|
+| H5 新增任务复盘显示⚪无 | owners 数组 vs owner 单值 → get_owner 兼容 |
+| H5 改项目复盘不更新 | project 字段与 raw 不同步 → update_task 同步 raw 项目名 |
+| **H5 保存后复盘缺【优先级】(项目)** | H5 add/update 曾把 raw 存成纯内容丢前缀 → 后端自动补 `[优先级](项目)` 前缀（新增/编辑都保证）|
+| 任务内容丢失 | H5 saveTask 空内容覆盖 → `if(raw)body.raw=raw` |
+| --add 新增任务优先级解析错 | 正则贪婪 → `^[\(\[]([^\)\]]+)[\)\]]` |
+| 挂起任务更新不显示 | v1 bug → 挂起分支也调 note_suffix |
+| 微信 [中] 变"中"(项目)丢失 | 半角[]是表情代码 → 全角【】 |
+| gateway 内重启被拦截 | 从外部 shell 重启（SIGTERM 传播）|
+| 用户报编号对不上 | 编号释放/复用 → 按任务名称匹配 |
-====== 7. 冷启动恢复步骤 ======
+====== 9. 冷启动恢复步骤 ======
-. 恢复 ~/docs/rd_tasks.json（任务清单）和 ~/.hermes/scripts/rd_daily_review.py、rd_task_update.py
+. 恢复 ~/docs/rd_tasks.json、rd_tasks_completed.json 与 ~/.hermes/scripts/ 全部脚本（rd_daily_review.py、rd_task_update.py、rd_history.py、rd_h5.py、rd_h5.html、rd_logo.jpg）
-. 建 cron：`研发任务日复盘` 每天 09:00，no_agent=true，script=rd_daily_review.py，deliver=origin
+. 复盘 cron：`研发任务日复盘` 工作日 09:00（0 9 * * 1-5），no_agent=true，script=rd_daily_review.py，deliver=origin
-. 测试：`python3 ~/.hermes/scripts/rd_daily_review.py` 手动看输出
+. H5 服务：`sudo cp rd-h5.service /etc/systemd/system/ && sudo systemctl enable --now rd-h5`（用 ctwing-2 venv python 跑）
-. 测试推送：cronjob run 或等 09:00
+. 防火墙放行 13544（腾讯云轻量 ap-beijing lhins-1dai07vu）
-. 更新任务：`python3 ~/.hermes/scripts/rd_task_update.py "关键词" "内容"` 或直接对话让 AI 调
+. 测试：`python3 ~/.hermes/scripts/rd_daily_review.py` + `curl http://127.0.0.1:13544/api/tasks`
-====== 8. 常用操作命令 ======
+====== 10. 常用命令 ======
 <code>
-# 手动生成复盘文本
+# 手动生成复盘
 python3 ~/.hermes/scripts/rd_daily_review.py
+# 微信更新任务
-# 更新任务 #5
+python3 ~/.hermes/scripts/rd_task_update.py "N" "内容"      # 更新
-python3 ~/.hermes/scripts/rd_task_update.py "5" "今日完成XX"
+python3 ~/.hermes/scripts/rd_task_update.py "N" "完成" --done  # 完成归档
+python3 ~/.hermes/scripts/rd_task_update.py --add "[中](项目)内容"  # 新增(自动最小空缺编号)
-# 标记完成
+# H5 重启
-python3 ~/.hermes/scripts/rd_task_update.py "5" "完成"
+sudo systemctl restart rd-h5.service
+# 历史查询
-# 新增任务（自动续号）
+python3 ~/.hermes/scripts/rd_history.py --month 2026-08
-python3 ~/.hermes/scripts/rd_task_update.py --add "[高](金穗)xxx任务"
+# 生成日报
+curl http://127.0.0.1:13544/api/report/today
 </code>
-====== 9. 注意事项 ======
+====== 11. 注意事项 ======
-- **任务清单是唯一数据源**，直接改 JSON 前先备份（cp rd_tasks.json rd_tasks.json.bak）
+- 任务清单是唯一数据源，改 JSON 前先备份
-- 用户原始文本（raw）**一字不改**，只加编号和尾部更新
+- **删除任务需用户明确确认**；删除/完成后不重排编号，空缺供新任务复用
-- 删除任务需用户明确确认（2026-08-18 定稿规则：所有删除操作必须先经用户同意）
+- H5 与复盘共用 JSON：H5 里的修改（项目/优先级/负责人/进度/内容/子任务）全部同步到复盘推送
-- 新增任务自动取 max(id)+1；删除后重排编号需手动处理（用户要求时执行）
+- raw 用户原文一字不改；只加编号/项目/进度展示层转换
+- 只读链接 `/rd/?ro=1` 无任何编辑入口，适合外发