diff --git a/.cocoon-plan.md b/.cocoon-plan.md new file mode 100644 index 0000000..b54159a --- /dev/null +++ b/.cocoon-plan.md @@ -0,0 +1,55 @@ +# Cocoon 发展规划(自主维护) + +> 此文件由 cron 任务每3小时更新,记录项目状态与下一步计划。 + +## 路线图 + +### Phase 1 — 核心稳定(当前) +- [x] HTTP/1.1 请求解析 +- [x] 响应头格式化 +- [x] 静态文件服务(sendfile) +- [x] 目录浏览 +- [x] Range 请求 +- [x] MIME 类型识别 +- [x] 多线程 M:N 调度 +- [x] 命令行参数 +- [x] 优雅关闭 + +### 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: 项目初始化,核心模块全部实现