From a067956e30d6e0753905586c5858312b9b2f9e02 Mon Sep 17 00:00:00 2001 From: Yoilun Date: Mon, 25 May 2026 15:45:24 +0800 Subject: [PATCH] chore: add implementation tracking files --- .gitignore | 2 ++ docs/project.md | 30 ++++++++++++++++++++++++++++++ findings.md | 29 +++++++++++++++++++++++++++++ progress.md | 16 ++++++++++++++++ task_plan.md | 31 +++++++++++++++++++++++++++++++ 5 files changed, 108 insertions(+) create mode 100644 docs/project.md create mode 100644 findings.md create mode 100644 progress.md create mode 100644 task_plan.md diff --git a/.gitignore b/.gitignore index cb50307..28f04c3 100644 --- a/.gitignore +++ b/.gitignore @@ -3,3 +3,5 @@ dist/ node_modules/ *.log +tmp/ +*.bak.* diff --git a/docs/project.md b/docs/project.md new file mode 100644 index 0000000..910fde3 --- /dev/null +++ b/docs/project.md @@ -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 可能变化。 +- 运行状态由多来源推断，必须显示置信度。 diff --git a/findings.md b/findings.md new file mode 100644 index 0000000..7f71443 --- /dev/null +++ b/findings.md @@ -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 全中文，技术缩写保留英文。 diff --git a/progress.md b/progress.md new file mode 100644 index 0000000..373e6c4 --- /dev/null +++ b/progress.md @@ -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 | +| --- | --- | --- | --- | diff --git a/task_plan.md b/task_plan.md new file mode 100644 index 0000000..d51ac6a --- /dev/null +++ b/task_plan.md @@ -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 | +| --- | --- | --- | --- | --- |