← 返回知识库
# 5号看板 · 需求日志与整改清单
> 现状：v4 版，GDrive .md 数据源，11 个任务堆积，核心功能缺失严重。
> 目标：精简、稳定、可路由——不做花架子。
---
## 一、已实现的功能
| 功能 | 状态 | 备注 |
|:-----|:----:|:------|
| GDrive .md 文件读取 | ✅ | 数据源 `/mnt/gdrive/TaskBoard/` |
| 三列展示（待处理/执行中/已完成） | ✅ | |
| 看板 HTML 页面 | ✅ | 深色主题 |
| stats API | ✅ | `/kanban/stats` |
| tasks API | ✅ | `/kanban/tasks` |
| report/create/status API | ✅ | `/kanban/report`, `/kanban/create`, `/kanban/status` |
| 飞书多维表格桥接 | ✅ | `kanban_feishu_bridge.py`，30 秒轮询 |
---
## 二、未实现/缺失功能
### P0（必须修）
| # | 功能 | 现状 | 需求 |
|:-:|:-----|:-----|:------|
| 1 | **任务路由** | 任何人都能发，没人认领 | 任务必须@负责人，负责人必须回应。超 24h 无人认领的自动告警 |
| 2 | **状态流转** | 任务发出来永远在"待处理" | 支持拖拽移动 .md 文件到对应目录。带时间戳记录每次状态变更 |
| 3 | **任务清理** | 11 个任务里 10 个待处理，堆积 | 超过 7 天未更新的自动归档到 `04_归档/`。已完成的自动移出 |
| 4 | **看板首页精简** | 目前展示所有任务，太多太乱 | 默认只展示当天的任务。旧任务点"查看全部"才展开 |
| 5 | **Agent 状态栏** | 顶部无 Agent 工作状态 | 显示各 Agent 🟢工作中/🟡空闲/🔴离线，数据来自 MCP Hub 18901 |
### P1（应该修）
| # | 功能 | 现状 | 需求 |
|:-:|:-----|:-----|:------|
| 6 | **任务卡片拖拽** | 页面不支持拖拽 | 卡片可拖到其他列，自动移 .md 文件 |
| 7 | **搜索/筛选** | 无 | 按负责人、优先级、类型筛选 |
| 8 | **重复检测** | 同名任务不拦截 | 同文件名阻止重复提交，提示已有 |
| 9 | **页面响应式** | 桌面端正常，移动端变形 | 支持手机浏览器访问 |
### P2（建议修）
| # | 功能 | 现状 | 需求 |
|:-:|:-----|:-----|:------|
| 10 | **埋点/日志** | 无操作日志 | 每次状态变更写 events.log |
| 11 | **看板首页备注** | 无 | 首页显眼位置显示当前版本号 + 更新日期 |
| 12 | **API 鉴权** | 完全开放 | 简单 Token 验证，防止外部乱写 |
---
## 三、当前看板状态（2026-06-27）
```
📥 待处理: 10 个任务
├─ @trae 看板升级验证 (P0)
├─ @all 通讯录更新 (P1) ← 昨天发的
├─ @all 全员通知 (P1)
├─ @trae 飞书桥接 (P1)
├─ @5hao need_1生图 (P2)
├─ @蚁后 auto_decompose (P2)
├─ @5hao 晨检 (P2)
├─ @trae 残留测试 × 3 (无优先级)
🔄 执行中: 0 个任务
✅ 已完成: 1 个任务
```
**问题**：10 个待处理，0 个执行中——说明发完没人管。
---
## 四、整改优先级
```
第一刀（立即）：
① 清理无人认领的残留测试任务（3 个）
② 对 7 天以上的旧任务归档
③ 看板首页只显示当天任务
第二刀（本周）：
④ 实现任务路由——必须@负责人
⑤ 拖拽流转 + 日志
⑥ Agent 状态栏接入 MCP Hub
第三刀（本月）：
⑦ 搜索/筛选
⑧ 移动端适配
⑨ API 鉴权
```
---
## 五、技术要求
### 环境
- 5号服务器，Python 3.11
- `/usr/local/bin/kanban-server.py`
- 数据源：`/mnt/gdrive/TaskBoard/`
- 飞书桥接：`kanban_feishu_bridge.py`（systemd 运行中）
- MCP Hub：`:18901`（systemd 注册，nginx 反代待修复）
### 约束
- 不改 Agent 侧代码——Agent 只管写 .md
- 看板只是展示层，不能成为单点故障
- 所有操作必须有日志，可回溯
### 验收标准
- [ ] 11 个任务清理到 ≤5 个有效任务
- [ ] 新发任务 24h 内必有人认领
- [ ] 看板首页一眼看清谁在干什么
- [ ] 旧任务不堆积