Skip to content

TASK_LIST.md

Latest commit

 

History

History
176 lines (156 loc) · 14.1 KB

TASK_LIST.md

File metadata and controls

176 lines (156 loc) · 14.1 KB

CodeHarbor 任务清单（稳定性增强 + 平台集成）

任务分解

阶段 1：文档对齐（已完成）

任务ID 任务描述 预估时间 优先级 依赖 状态
T1.1 盘点 src/ 已实现能力与 README 差异 1h P0 - ✅
T1.2 更新 REQUIREMENTS 为当前真实实现（Node/Codex CLI） 1h P0 T1.1 ✅
T1.3 更新任务清单并标注后续开发阶段 0.5h P0 T1.2 ✅

阶段 2：配置 UI 需求设计（已完成）

任务ID 任务描述 预估时间 优先级 依赖 状态
T2.1 定义配置 UI MVP 范围（全局配置/房间配置/健康检查） 1h P0 T1.2 ✅
T2.2 设计房间工作目录映射与数据模型 1h P0 T2.1 ✅
T2.3 定义配置生效策略（热更新 vs 重启）与验收标准 1h P0 T2.1 ✅

阶段 3：配置 UI 开发实现（已完成）

任务ID 任务描述 预估时间 优先级 依赖 状态
T3.1 新增配置持久化表（room_settings / config_revisions）与迁移脚本 3h P0 T2.2 ✅
T3.2 实现配置服务层（读取、校验、保存、回滚） 4h P0 T3.1 ✅
T3.3 Orchestrator 接入 room 级 workdir 路由 4h P0 T3.2 ✅
T3.4 实现 codeharbor admin serve（配置 UI 后端接口） 4h P0 T3.2 ✅
T3.5 实现管理 UI 页面（全局配置/房间配置/健康检查） 6h P0 T3.4 ✅
T3.6 实现配置变更审计展示 2h P1 T3.2 ✅
T3.7 补充访问控制（本地令牌或白名单） 3h P0 T3.4 ✅

阶段 4：测试验证与发布（已完成）

任务ID 任务描述 预估时间 优先级 依赖 状态
T4.1 单元测试：配置服务与路由策略 3h P0 T3.2,T3.3 ✅
T4.2 集成测试：多房间并发 + room-workdir 映射 4h P0 T3.3,T3.5 ✅
T4.3 回归测试：现有命令与消息编排不退化 2h P0 T3.3 ✅
T4.4 文档更新：README 管理 UI 使用说明 1h P0 T4.2 ✅
T4.5 发布策略：新增 CI 检查与版本发布说明 1h P1 T4.4 ✅

阶段 5：工程化能力补全（进行中）

任务ID 任务描述 预估时间 优先级 依赖 状态
T5.1 可观测性：新增 /metrics 指标导出与基础仪表盘对接 6h P0 - ✅
T5.2 可观测性：增加关键异常告警（失败率/队列等待/升级失败） 4h P0 T5.1 ✅
T5.3 可靠性：引入可恢复任务队列（重启后恢复待处理任务） 10h P0 T5.1 ✅
T5.4 可靠性：统一重试/退避/失败归档策略 6h P0 T5.3 ✅
T5.5 架构扩展：抽象 Channel 接口并保持 Matrix 兼容 8h P0 T5.1 ✅

阶段 6：平台集成能力（待开始）

任务ID 任务描述 预估时间 优先级 依赖 状态
T6.1 API 入口：实现任务提交接口（鉴权、幂等、入队） 3h P1 T5.3,T5.5 ✅
T6.2 API 入口：实现任务查询接口（状态、阶段、错误摘要） 3h P1 T6.1 ✅
T6.3 Webhook 入口：实现签名校验与请求映射（兼容 CI/工单） 4h P1 T6.1 ✅
T6.4 文档输入：支持 txt/pdf/docx 抽取为纯文本（大小/类型限制） 4h P1 T5.3 ✅
T6.5 文档上下文：实现分块/摘要注入策略，避免超长上下文 4h P1 T6.4 ✅
T6.6 热更新基础：实现高频配置白名单热生效与审计记录 3h P1 T5.1 ✅
T6.7 热更新验证：补充回归测试与回滚策略说明 2h P1 T6.6 ✅

阶段 7：产品化增强（进行中）

任务ID 任务描述 预估时间 优先级 依赖 状态
T7.1 权限模型：定义 token scope 与接口/动作权限矩阵 3h P2 T6.2 ✅
T7.2 权限落地：在 Admin/API/Webhook 执行 RBAC 校验 4h P2 T7.1 ✅
T7.3 历史索引：实现会话检索与按条件过滤（房间/用户/时间） 4h P2 T5.3 ✅
T7.4 历史导出：支持会话导出与保留策略配置（含清理任务） 4h P2 T7.3 ✅
T7.5 路由策略：实现 backend/model 自动选择规则引擎 4h P2 T6.2,T6.7 ✅
T7.6 路由诊断：新增策略命中说明与回退原因诊断输出 3h P2 T7.5 ✅

阶段 8：社区路线图投票落地（进行中）

任务ID 任务描述 预估时间 优先级 依赖 状态
T8.1 多模态体验：增强 Matrix 消息中的图片/语音结果渲染（结构化展示、摘要与可读性） 6h P1 T7.6 ✅
T8.2 安装与升级：跨平台自动安装/升级流程增强（减少手工重启与失败恢复成本） 6h P1 T7.6 ✅
T8.3 后端工具生态：扩展 backend 工具接入与会话切换体验（上下文桥接与一致性） 6h P1 T7.5 ✅
T8.4 管理后台增强：补齐诊断视图、配置校验与导入导出能力 6h P1 T6.7,T7.6 ✅
T8.5 安全与审计：细粒度 RBAC 与操作审计能力增强 6h P1 T7.2 ✅
T8.6 生态集成：新增 Matrix 工作流联动与外部通知/工单集成能力 8h P2 T6.3,T7.6 ✅
T8.7 投票结果映射：将社区优先级映射为可执行里程碑并更新发布计划 3h P1 T8.1,T8.2,T8.3,T8.4,T8.5,T8.6 ✅
T8.8 文档与验收：更新 README/手册/诊断命令说明并补齐回归用例 3h P1 T8.7 ✅

阶段 9：多实例主机器人治理与可用性补全（进行中）

任务ID 任务描述 预估时间 优先级 依赖 状态
T9.1 管理后台：为机器人实例补齐触发策略表单字段（groupDirectMode、mention/reply/active/prefix）并持久化 4h P0 T8.4 ✅
T9.2 管理后台：引入主机器人标记（isPrimary）与唯一性校验（最多/必须一个，按模式条件生效） 4h P0 T9.1 ✅
T9.3 配置应用链路：/api/admin/bot-profiles/apply 保留并下发实例级触发策略，避免被默认值覆盖 4h P0 T9.1 ✅
T9.4 运行时路由：主机器人支持群聊非@直通，执行/评审机器人默认保持点名触发，避免串话 4h P0 T9.2,T9.3 ✅
T9.5 兼容迁移：旧版本升级后提供“单实例 -> 主机器人模式”引导/一键迁移（CLI 或后台向导） 5h P1 T9.2,T9.3 ✅
T9.6 安全与边界：未配置主机器人时阻止启用群聊直通并给出可操作错误提示 3h P0 T9.2 ✅
T9.7 回归测试：覆盖主机器人直通、实例点名隔离、apply 不覆盖策略、升级迁移路径 5h P0 T9.4,T9.5,T9.6 ✅
T9.8 文档更新：补充“主机器人架构/配置步骤/升级迁移/故障排查”到 README 与用户手册 3h P1 T9.7 ✅

阶段 10：AutoDev 架构可维护性重构（进行中）

任务ID 任务描述 预估时间 优先级 依赖 状态
T10.1 基线固化：补齐 autodev-runner 与 autodev-control 的行为快照（run/status/stop/progress/content）作为重构前对照 3h P0 - ✅
T10.2 设计拆分蓝图：定义 autodev-runner.ts 的目标模块边界（loop engine、stage executor、result reporter）与迁移顺序 2h P0 T10.1 ✅
T10.3 Runner 解耦 I：抽取 loop engine（轮次推进、deadline、stop/abort、重试状态）为独立模块并保持行为不变 5h P0 T10.2 ✅
T10.4 Runner 解耦 II：抽取 stage executor（preflight/执行/review/repair/release）与统一 stage result 协议 5h P0 T10.3 ✅
T10.5 Runner 解耦 III：抽取 result reporter（Matrix 回显、结构化摘要、归档摘要）并统一输出模板 4h P1 T10.4 ✅
T10.6 Control 解耦 I：拆分 autodev-control-command.ts 的命令解析、参数标准化、权限校验为独立 parser 层 4h P0 T10.1 ✅
T10.7 Control 解耦 II：建立 command handler registry（run/status/stop/progress/content）并消除分支式耦合 5h P0 T10.6 ✅
T10.8 Control 解耦 III：统一控制命令响应模型（成功/失败/校验错误）并补齐错误码与用户可操作提示 3h P1 T10.7 ✅
T10.9 策略抽离 I：提炼 completion gate policy（通过条件、失败分类、证据来源）为纯函数模块 4h P0 T10.4 ✅
T10.10 策略抽离 II：提炼 validation inference + status healing 规则（状态修复、冲突判定、来源优先级）为纯函数模块 4h P0 T10.9 ✅
T10.11 契约测试：新增 loop/gate/validation/status-heal 的契约测试矩阵，确保重构前后输出一致 5h P0 T10.5,T10.8,T10.10 ✅
T10.12 集成回归：覆盖多实例 + secondary review handoff + release gating 的端到端回归并纳入 CI 5h P0 T10.11 ✅
T10.13 文档同步：更新 AutoDev 架构图、控制命令说明、故障定位手册（含模块边界与排障路径） 3h P1 T10.12 ✅
T10.14 发布与回滚：制定灰度发布与回滚检查清单（按模块分批启用）并完成首版发布演练 3h P1 T10.13 ✅

阶段 11：API 生命周期与多实例治理补全（待开始）

任务ID 任务描述 预估时间 优先级 依赖 状态
T11.1 API 生命周期：补齐 GET /api/tasks（分页/筛选：status/source/room/time） 8h P0 T6.2,T5.3 ✅
T11.2 API 生命周期：补齐 POST /api/tasks/:id/cancel 与 POST /api/tasks/:id/retry 8h P0 T11.1 ✅
T11.3 API 生命周期：补齐 GET /api/tasks/:id/events（SSE 实时状态流） 12h P0 T11.1 ✅
T11.4 安全与审计：同步 scope matrix 与审计字段（action/resource/reason） 4h P0 T11.2,T11.3 ✅
T11.5 多实例治理：引入分布式限流（Redis 适配 + 本地回退） 16h P0 T5.4,T7.2 ✅
T11.6 可观测性：补齐 shared limiter/拒绝率/恢复耗时指标与诊断 8h P1 T11.5,T5.1 ✅
T11.7 集成回归：覆盖 API/Webhook/Queue 重启恢复场景 16h P1 T11.2,T11.3,T11.5 ✅
T11.8 质量门槛：新增核心模块覆盖率门槛与 CI 守卫 8h P1 T11.7 ✅

社区优先级 -> 可执行里程碑（T8.7 输出）

社区优先级主题 可执行里程碑 任务集合 目标版本区间 发布顺序 回滚点
P1：体验与交付效率 M1：多模态与安装升级 T8.1,T8.2,T8.3 v0.1.53 ~ v0.1.54 1 v0.1.52
P1：治理与安全可控 M2：管理后台与审计增强 T8.4,T8.5 v0.1.55 ~ v0.1.56 2 v0.1.54
P2：生态协同扩展 M3：工作流与外部联动 T8.6 v0.1.57 3 v0.1.56
P1：发布收敛与验收 M4：计划映射与文档验收 T8.7,T8.8 v0.1.58 ~ v0.1.59 4 v0.1.57
P0：平台闭环与治理 M5：API 生命周期闭环 T11.1,T11.2,T11.3,T11.4 v0.1.102 5 v0.1.101
P0：多实例稳定性 M6：分布式限流与指标补齐 T11.5,T11.6 v0.1.102 6 v0.1.101
P1：质量收敛 M7：集成回归与覆盖率门槛 T11.7,T11.8 v0.1.102 7 v0.1.101

大功能 -> 发布映射（执行约定，当前版本：v0.1.105）

大功能任务 完成后目标版本 发布提交示例 发布状态
T8.1 v0.1.53 release: v0.1.53 [publish-npm] ✅ 已发布
T8.2 v0.1.54 release: v0.1.54 [publish-npm] ✅ 已发布
T8.3 v0.1.54 release: v0.1.54 [publish-npm] ✅ 已发布（与 T8.2 同版本）
T8.4 v0.1.55 release: v0.1.55 [publish-npm] ✅ 已发布
T8.5 v0.1.56 release: v0.1.56 [publish-npm] ✅ 已发布
T8.6 v0.1.57 release: v0.1.57 [publish-npm] ✅ 已发布
T8.7 v0.1.58 release: v0.1.58 [publish-npm] ⬜ 待发布
T8.8 v0.1.59 release: v0.1.59 [publish-npm] ⬜ 待发布
T11.1 v0.1.102 release: v0.1.102 [publish-npm] ✅ 已发布
T11.2 v0.1.102 release: v0.1.102 [publish-npm] ✅ 已发布（与 T11.1 同版本）
T11.3 v0.1.102 release: v0.1.102 [publish-npm] ✅ 已发布（与 T11.1 同版本）
T11.4 v0.1.102 release: v0.1.102 [publish-npm] ✅ 已发布（与 T11.1 同版本）
T11.5 v0.1.102 release: v0.1.102 [publish-npm] ✅ 已发布（与 T11.1 同版本）
T11.6 v0.1.102 release: v0.1.102 [publish-npm] ✅ 已发布（与 T11.1 同版本）
T11.7 v0.1.102 release: v0.1.102 [publish-npm] ✅ 已发布（与 T11.1 同版本）
T11.8 v0.1.102 release: v0.1.102 [publish-npm] ✅ 已发布（与 T11.1 同版本）

说明：若中途插入热修复版本，后续版本号顺延；默认保持“每个大功能独立一个可回滚发布版本”，允许相邻任务并版（如 T8.2/T8.3）。当前 T11.x 按 v0.1.102 单版本收敛执行。

任务依赖关系图

[文档对齐] -> [需求设计] -> [开发实现] -> [测试发布] -> [工程化补全] -> [平台集成] -> [产品增强] -> [多实例主机器人治理] -> [AutoDev可维护性重构] -> [API生命周期与多实例治理补全]
  T1.x         T2.x         T3.x         T4.x         T5.x           T6.x         T7.x         T9.x           T10.x             T11.x

优先级说明

  • P0：必须完成（核心功能）
  • P1：重要（增强能力）
  • P2：可选（优化项）

状态标记

  • ⬜ 待开始
  • 🔄 进行中
  • ✅ 已完成
  • ❌ 已取消
  • 🚫 阻塞

生成时间：2026-04-14 21:30:00 CST