agent-aide/.aide/project-docs/blocks/aide-program-decide.md

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）

接口说明

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