chore: add implementation tracking files

This commit is contained in:
Yoilun
2026-05-25 15:45:24 +08:00
parent f66a097dc3
commit a067956e30
5 changed files with 108 additions and 0 deletions

30
docs/project.md Normal file
View File

@@ -0,0 +1,30 @@
# Project Documentation
## Goal
构建一个本机 Codex 智能体管理台,用中文管理 agent 配置、项目运行状态、动态工作流和安全写回流程。
## Architecture
Go 后端提供 localhost HTTP APIVue 3 + Vite 前端提供中文工作台界面。后端只读访问 Codex SQLite 状态库,安全读取 `.codex` 配置,并仅在用户确认后写回 `.codex/agents/*.toml`
## Configuration
- `CODEX_HOME`: 默认 `/Users/yoilun/.codex`
- 后端监听地址:默认 `127.0.0.1:18083`
- 前端开发地址:默认 `127.0.0.1:13083`
## Runbook
实施完成后记录实际命令。
## Security Boundaries
- 不读取 `.codex/auth.json`
- 不写入 Codex SQLite。
- `.codex/agents/*.toml` 写回必须先备份。
## Known Risks
- Codex 内部 SQLite schema 可能变化。
- 运行状态由多来源推断,必须显示置信度。