// DOCS · 待办看板

待办看板 · Task Board

跨 WorkBuddy 所有对话窗口的全局任务系统，本地文件为单一真相源，可视化看板半公开发布到站点。

入口： /tasks/task-board.html（看板本体）· /tasks/ 会跳转到 /lab/todo-hub.html（模块介绍页）。

1. 它是什么

不只是待办清单，而是任务管理系统：进度、当前节点、计划、截止、来源窗口、每任务独立文档、定时提醒，全部收口到一处。核心价值是跨对话框共享——在任何一个 WorkBuddy 窗口记的任务，在别的窗口也看得到。

实现载体是 wb-todo-hub 技能（用户级 skill，跨 workspace 生效），不依赖企微 / 钉钉等外部连接器。

2. 数据模型

任务索引 ~/todo-hub/data/tasks.md

轻量总览，一行一个任务，按状态分组：

## 进行中
- [进行中] | 进度:40% | 节点:开发中 | 截止:2026-08-01 | 来自:简历网站 | T003 重构登录页

## 待办
- [待办] | 进度:0% | 节点:未开始 | 截止:- | 来自:AI雷达 | T004 整理本周AI新闻
字段说明
状态待办 / 进行中 / 阻塞 / 完成
进度百分比
节点当前所处环节，如「等接口」「开发中」
截止日期或 -
来自任务在哪个对话窗口/项目产生
IDT00X 全局序号，跨窗口唯一

任务文档 ~/todo-hub/data/tasks/<ID>.md

每个任务一份独立 Markdown，存需求、计划、节点清单、会议纪要、代码片段、参考链接。索引行与文档头部字段始终保持一致。

3. 日常怎么用（对话触发词）

意图说法示例
查看「看任务」「我的任务列表」「T003 什么情况」
新建「新建任务：重构登录页」「记个任务」
改进度「T003 进度 60%」
改节点/计划「节点到开发」「计划改成先做接口」
删除「删除任务 T003」
设提醒「提醒我 T003 三天后」「T005 下周一上午提醒」
写文档「写文档：T002 的需求是…」

提醒通过 automation 实现：相对时间（「3 天后」）会先用系统日期命令算出绝对时间，再建 once 定时任务；周期性提醒建 recurring。

4. 看板生成与部署

看板是生成物，不是手写页面：

~/todo-hub/data/tasks.md + tasks/<ID>.md
  ↓ scripts/generate_board.py 读取并渲染
board/task-board.html（含任务卡、节点连线 SVG）
  ↓ scripts/deploy_board.sh · tar 管道 over SSH
ECS /www/wwwroot/appin.site/tasks/ 
# 一键更新（任何有 Bash + python + SSH 的窗口，加载 skill 即可）
bash scripts/deploy_board.sh

5. 反向同步：在看板上勾完回写数据源

看板不只是只读展示，可以直接在浏览器里勾选节点完成状态：

  1. 在看板上勾/取消节点复选框，改动暂存在浏览器 localStorage，顶部同步条实时显示「N 项已修改」。
  2. 点同步按钮 📋 → 自动把改动拼成文本并复制到剪贴板，格式如下：
【任务看板更改】
T003 | ✅ | 接口联调
T005 | ⬜ | 等设计稿

（贴给八戒即可写入数据源）
  1. 把这段贴回 WorkBuddy 对话 → 写入 ~/todo-hub/data/ 落库。
  2. 重置按钮清空 localStorage，丢弃未同步的本地改动。
注意： 浏览器里的勾选不会自动回写服务器——必须走「复制 → 贴回对话」这一步，否则下次重新生成看板时改动会丢失。这是刻意设计：站点是静态托管，没有写接口，避免开放写权限带来的安全面。

6. 边界与限制

7. 已完成的强化