101 lines
2.7 KiB
Markdown
101 lines
2.7 KiB
Markdown
# aide-program-decide
|
||
|
||
> 路径：aide-program/aide/decide/
|
||
> 最后更新：2025-12-15
|
||
|
||
## 概述
|
||
|
||
待定项确认模块，提供 Web 界面让用户对任务中的待定项进行决策。服务在后台运行，用户提交后自动关闭。
|
||
|
||
## 文件清单
|
||
|
||
| 文件 | 说明 |
|
||
|------|------|
|
||
| `__init__.py` | 模块初始化，导出 cmd 函数 |
|
||
| `cli.py` | CLI 入口（~134 行） |
|
||
| `server.py` | HTTP 服务器管理（~280 行） |
|
||
| `daemon.py` | 后台进程启动器（~30 行） |
|
||
| `handlers.py` | HTTP 请求处理器（~170 行） |
|
||
| `storage.py` | 数据存储（~155 行） |
|
||
| `types.py` | 数据结构定义（~300 行） |
|
||
| `errors.py` | 自定义异常 |
|
||
| `web/` | Web 前端资源 |
|
||
|
||
## 核心组件
|
||
|
||
### CLI 入口
|
||
|
||
- **职责**：解析参数并调度功能
|
||
- **位置**：`cli.py`
|
||
- **关键函数**：
|
||
- `cmd_decide_submit(file_path)` - 提交待定项数据
|
||
- `cmd_decide_result()` - 获取决策结果
|
||
|
||
### DecideServer
|
||
|
||
- **职责**：HTTP 服务器生命周期管理
|
||
- **位置**：`server.py:26`
|
||
- **关键方法**：
|
||
- `start()` - 前台启动服务
|
||
- `start_daemon(pid)` - 后台启动服务
|
||
- `stop(reason)` - 停止服务
|
||
|
||
### DecideStorage
|
||
|
||
- **职责**：管理待定项和决策结果的存储
|
||
- **位置**：`storage.py`
|
||
- **关键方法**：
|
||
- `save_pending(input)` - 保存待定项到 pending.json
|
||
- `load_pending()` - 加载待定项
|
||
- `save_result(result)` - 保存决策结果
|
||
- `load_result()` - 加载决策结果
|
||
- `is_server_running()` - 检查服务是否运行
|
||
|
||
### 数据结构
|
||
|
||
- `DecideInput` - 待定项输入数据
|
||
- `DecideItem` - 单个待定项（含多个选项）
|
||
- `DecideOption` - 选项（value, label, score, pros, cons）
|
||
- `DecideResult` - 决策结果
|
||
- `DecidedItem` - 单个决策（chosen, note）
|
||
|
||
## 接口说明
|
||
|
||
```python
|
||
# CLI 入口
|
||
aide decide submit <file> # 提交待定项，启动后台服务
|
||
aide decide result # 获取决策结果
|
||
|
||
# Web 界面
|
||
GET / # 主页面
|
||
GET /api/data # 获取待定项数据
|
||
POST /api/submit # 提交决策
|
||
```
|
||
|
||
## 配置项
|
||
|
||
在 `.aide/config.toml` 的 `[decide]` 节：
|
||
|
||
| 配置项 | 默认值 | 说明 |
|
||
|--------|--------|------|
|
||
| `port` | 3721 | 起始端口 |
|
||
| `bind` | 127.0.0.1 | 监听地址 |
|
||
| `url` | "" | 自定义访问地址 |
|
||
| `timeout` | 0 | 超时时间（秒） |
|
||
|
||
## 数据文件
|
||
|
||
- `.aide/decisions/pending.json` - 当前待定项数据
|
||
- `.aide/decisions/{timestamp}.json` - 决策记录归档
|
||
|
||
## 依赖关系
|
||
|
||
- 依赖：core（output, config）
|
||
- 被依赖：main.py
|
||
|
||
## 注意事项
|
||
|
||
- 服务作为后台进程运行，与 CLI 脱离
|
||
- 用户提交决策后服务自动关闭
|
||
- 如果 recommend 字段存在，对应选项默认选中
|