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 字段存在，对应选项默认选中
|