开发环境与工具
环境配置速查。开发流程详见 proc-dev-flow.md。
目录结构
~/DEV/
├── active/ # 主力项目
├── labs/ # 实验/学习项目
├── configs/ # 配置和脚本
├── templates/ # 项目模板 & 文档模板
│ ├── docs/process/ # 14 个流程模板
│ ├── docs/architecture/ # 10 个架构模板
│ ├── docs/planning/ # 3 个管理模板
│ ├── docs/data/ # 4 个数据模板
│ ├── docs/ops/ # 6 个运维模板
│ ├── docs/research/ # 4 个研究模板
│ └── scaffolds/ # 5 个项目脚手架
├── docs/
├── scripts/
└── README.md
工具清单
| 工具 | 用途 |
|---|
| just | 项目命令入口 |
| pre-commit | Git 提交门禁 |
| act | 本地 CI |
| fzf | 模糊搜索 |
| bat | 代码高亮 |
| fd | 快速查找 |
| jq/yq | JSON/YAML/TOML 处理 |
AI 工具分工
| 工具 | 职责 |
|---|
| Claude Code | 深度编码、代码审阅、复杂推理、重构 |
| Codex | 全自动功能开发、批量修 bug、测试编写 |
| OpenCode | 研究任务、轻量编码、免费模型优先 |
| Hermes | 流程协调、文档生成、模板维护、配置管理 |
| DeepTutor | 学习答疑、面试模拟 |
| CodeGraph | 代码索引、调用关系分析 |
常驻服务
| 服务 | 管理方式 | 端口 |
|---|
| Hermes 网关 | hermes gateway run | — |
| DeepTutor API | launchd 自启 | 8001 |
| DeepTutor Web | launchd 自启（生产模式） | 3782 |
| Uptime Kuma | Docker 自启 | 3001 |
| PostgreSQL | Docker 自启 | 5432 |
| Caddy 反向代理 | caddy run | 8080 |
端口一览
| 端口 | 服务 | 说明 |
|---|
| 8080 | Caddy | 统一入口（反向代理） |
| 8001 | DeepTutor API | FastAPI 后台 |
| 3782 | DeepTutor Web | Next.js 前端 |
| 5432 | PostgreSQL | 数据库 |
| 3001 | Uptime Kuma | 监控面板 |
| 7892 | 夜煞云 | 代理 |
命令速查
# 新项目
cp -r ~/DEV/templates/python-project ~/DEV/active/项目名
# 日常开发
just lint && just test
# 提交前检查
just lint && just test && act push
# 部署
just docker-build && docker-compose up -d
安全
just audit # 检查依赖漏洞
just license # 检查开源许可证
just compliance # 合规全检