cocoon/.cocoon-plan.md

Cocoon 发展规划（自主维护）

此文件由 cron 任务每3小时更新，记录项目状态与下一步计划。

路线图

Phase 1 — 核心稳定（当前）

• HTTP/1.1 请求解析
• 响应头格式化
• 静态文件服务（sendfile）
• 目录浏览
• Range 请求
• MIME 类型识别
• 多线程 M:N 调度
• 命令行参数
• 优雅关闭

Phase 2 — 健壮性

• HTTP 缓存（ETag / Last-Modified / If-None-Match）
• Gzip / Brotli 压缩
• 完整的单元测试框架
• 压力测试 + 性能基准
• 连接超时管理（空闲连接自动清理）
• 请求体解析（POST 支持）

Phase 3 — 扩展

• 配置文件支持（JSON / YAML）
• 虚拟主机 / 多站点
• 反向代理支持
• HTTPS / TLS
• HTTP/2

Phase 4 — 生态

• WebSocket 支持
• 中间件机制
• 插件系统

当前状态

• 编译通过，基本功能可用
• 示例页面正常
• 缺少测试和性能数据

待办池

1. 添加缓存支持 — ETag + Last-Modified + 304 Not Modified
2. 添加测试 — 用 curl/bats 或写 C 单元测试
3. 性能基准 — wrk/ab 压测，记录 RPS 和延迟
4. 修复编译警告 — 还有几个 stringop-truncation 警告
5. 连接池管理 — 空闲连接超时、最大连接数限制
6. 日志系统 — 结构化日志、分级输出

最近行动记录

• 2026-06-03: 项目初始化，核心模块全部实现