chore: add implementation tracking files
This commit is contained in:
2
.gitignore
vendored
2
.gitignore
vendored
@@ -3,3 +3,5 @@
|
|||||||
dist/
|
dist/
|
||||||
node_modules/
|
node_modules/
|
||||||
*.log
|
*.log
|
||||||
|
tmp/
|
||||||
|
*.bak.*
|
||||||
|
|||||||
30
docs/project.md
Normal file
30
docs/project.md
Normal file
@@ -0,0 +1,30 @@
|
|||||||
|
# Project Documentation
|
||||||
|
|
||||||
|
## Goal
|
||||||
|
|
||||||
|
构建一个本机 Codex 智能体管理台,用中文管理 agent 配置、项目运行状态、动态工作流和安全写回流程。
|
||||||
|
|
||||||
|
## Architecture
|
||||||
|
|
||||||
|
Go 后端提供 localhost HTTP API,Vue 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 可能变化。
|
||||||
|
- 运行状态由多来源推断,必须显示置信度。
|
||||||
29
findings.md
Normal file
29
findings.md
Normal file
@@ -0,0 +1,29 @@
|
|||||||
|
# Findings
|
||||||
|
|
||||||
|
## Architecture
|
||||||
|
|
||||||
|
- 后端使用 Go。
|
||||||
|
- 前端使用 Vue 3 + Vite。
|
||||||
|
- 工具以 localhost Web 应用运行。
|
||||||
|
|
||||||
|
## Data Sources
|
||||||
|
|
||||||
|
- `.codex/agents/*.toml`: 智能体配置。
|
||||||
|
- `.codex/config.toml`: 项目信任配置。
|
||||||
|
- `.codex/state_5.sqlite`: threads、thread_spawn_edges、thread_dynamic_tools。
|
||||||
|
- `.codex/goals_1.sqlite`: thread_goals。
|
||||||
|
- 本机进程表:Codex 进程辅助判断。
|
||||||
|
- 项目工作流文件:task_plan.md、findings.md、progress.md、docs/project.md。
|
||||||
|
|
||||||
|
## Constraints
|
||||||
|
|
||||||
|
- 禁止读取或展示 `.codex/auth.json`。
|
||||||
|
- 禁止写入 SQLite。
|
||||||
|
- 默认不写 `.codex/config.toml`。
|
||||||
|
- `.codex/agents/*.toml` 仅允许经草稿、校验、diff、备份、确认后写回。
|
||||||
|
|
||||||
|
## Decisions
|
||||||
|
|
||||||
|
- 工作流显示使用动态事件流/DAG,不写死阶段或 agent 顺序。
|
||||||
|
- 所有推断状态必须显示来源和置信度。
|
||||||
|
- UI 全中文,技术缩写保留英文。
|
||||||
16
progress.md
Normal file
16
progress.md
Normal file
@@ -0,0 +1,16 @@
|
|||||||
|
# Progress
|
||||||
|
|
||||||
|
## Session Log
|
||||||
|
|
||||||
|
| Time | Phase | Actor | Action | Result |
|
||||||
|
| --- | --- | --- | --- | --- |
|
||||||
|
|
||||||
|
## Test Results
|
||||||
|
|
||||||
|
| Time | Command | Result | Notes |
|
||||||
|
| --- | --- | --- | --- |
|
||||||
|
|
||||||
|
## Bug Loop
|
||||||
|
|
||||||
|
| Phase | Bug | Fix Attempt | Retest Result |
|
||||||
|
| --- | --- | --- | --- |
|
||||||
31
task_plan.md
Normal file
31
task_plan.md
Normal file
@@ -0,0 +1,31 @@
|
|||||||
|
# Task Plan
|
||||||
|
|
||||||
|
## Goal
|
||||||
|
|
||||||
|
构建 Codex 智能体管理台:Go 后端 + Vue 3 前端,支持中文界面、agent 配置管理、项目运行状态、动态工作流交接和安全写回。
|
||||||
|
|
||||||
|
## Stop Conditions
|
||||||
|
|
||||||
|
- [ ] 所有阶段完成
|
||||||
|
- [ ] Go 测试通过
|
||||||
|
- [ ] 前端构建通过
|
||||||
|
- [ ] 浏览器验证关键页面
|
||||||
|
- [ ] docs/project.md 记录目标、架构、配置、运行方式、安全边界和恢复方式
|
||||||
|
- [ ] 无 blocking bug 或未处理高风险问题
|
||||||
|
|
||||||
|
## Phases
|
||||||
|
|
||||||
|
| Phase | Status | Goal | Acceptance Criteria |
|
||||||
|
| --- | --- | --- | --- |
|
||||||
|
| 0 | pending | 项目初始化与风险边界 | 计划文件存在;安全边界明确;不读取 auth.json;不改 .codex |
|
||||||
|
| 1 | pending | Go 只读数据层 | 能读取 agents、projects、threads、spawn edges、goals;SQLite 只读 |
|
||||||
|
| 2 | pending | 运行状态与动态工作流模型 | 状态含来源/置信度;工作流不写死固定流程 |
|
||||||
|
| 3 | pending | 中文 UI 只读工作台 | 项目/工作流/智能体视图可浏览;空数据可用 |
|
||||||
|
| 4 | pending | 草稿、TOML 校验和 diff | 草稿不覆盖原文件;无效 TOML 阻止写回 |
|
||||||
|
| 5 | pending | 备份与确认写回 | 备份成功后才能写回;失败可恢复 |
|
||||||
|
| 6 | pending | 集成验证与文档 | 测试/构建/浏览器验证通过;文档完整 |
|
||||||
|
|
||||||
|
## Errors Encountered
|
||||||
|
|
||||||
|
| Time | Phase | Error | Attempt | Resolution |
|
||||||
|
| --- | --- | --- | --- | --- |
|
||||||
Reference in New Issue
Block a user