Commit Graph

5 Commits

Author SHA1 Message Date
wunianxiao a04447c7bc docs: 为全部 38 个源文件补充详细模块级注释
为 iAs 项目的所有 Rust 源文件添加了系统化的模块级文档注释(//!),
覆盖全部 src/ 下的文件。每个文件包含模块职责、架构设计、数据流
和关键设计决策的说明。

主要变更:
- 入口/CLI: main.rs, cli.rs — 系统架构概览、子命令说明
- Daemon/Worker: daemon.rs, worker.rs — 三消费者架构、旧架构说明
- 微信通道: mod.rs, client.rs, types.rs — API 端点、登录流程
- LLM 系统: mod.rs, types.rs, provider.rs, deepseek.rs, conversation.rs
  — 架构分层、流式处理、工具循环、摘要机制
- 上下文管理: mod.rs, types.rs, builder.rs, tools.rs
  — Checkpoint 机制、Token Budget、双重摘要
- 工具系统: mod.rs, types.rs, builtin.rs, approval.rs
  — 两层元工具架构、审批流程
- 内置工具: mod.rs + 6 个工具 — API 端点、认证方式、参数说明
- 消息队列: mod.rs, message_queue.rs, runner.rs
  — 公平轮转算法、三消费者路由
- 数据库/状态/调度/日志: db/mod.rs, state.rs, scheduler.rs, logger.rs
  — 表结构、回退策略、定时任务、日志初始化
2026-06-10 09:46:42 +08:00
wunianxiao 8dc232ebab refactor(amap): 简化输出格式,返回原始API数据
- 移除自定义文本格式化函数(haversine_distance, format_distance, parse_location 等)
- 移除 build_route_output 函数
- execute 函数改为返回简短确认消息 + 原始 API JSON 数据
- CLI 命令同时输出 r.output 和 r.data(JSON)
- 移除 driving/riding API 的 show_fields=cost 参数
- 清理已删除函数的冗余单元测试
2026-06-04 13:27:04 +08:00
wunianxiao fec50b7be8 refactor(amap): 升级全部路线API到v5,完善输出文本及JSON数据
主要变更:
- 路线规划全部升级到v5: walking/driving/riding/transit → v5端点
- 新增 electrobike (电动车骑行) 路线规划
- POI搜索参数 page/offset → v5标准的 page_num/page_size
- 周边搜索添加 sortrule=distance 按距离排序
- 驾车strategy默认值 10→32 (高德推荐)
- 公交 city→city1/city2 (citycode)
- 骑行响应解析 errcode→status, data→route (v4→v5)
- 所有路线添加 show_fields=cost 获取耗时数据

输出文本:
- POI搜索: 详细列出名称/地址/类型/坐标/距离(km)/电话/评分/人均
- Haversine 距离计算: 有参考坐标时自行计算并格式化(≥1km显示km)
- 地理编码: 格式化地址+省市+坐标
- 路径规划: 距离/时间/费用/红绿灯/限行状态

JSON数据:
- 所有接口通过 ok_with_data 返回结构化JSON
- 路径规划提取关键字段(距离km/时间min/费用等)

新增辅助函数:
- val_f64(): 兼容v5字符串和数字两种数值格式
- haversine_distance(): 球面距离计算
- format_distance(): 距离格式化(km/m)
- path_distance/duration/tolls/traffic_lights(): v5路径字段提取
2026-06-03 23:05:48 +08:00
wunianxiao 69ba8887ff docs: 统一 README,删除冗余文档;refactor: 消除全部 15 个 warning
- 新建 README.md,整合项目架构、命令、配置、数据流
- 删除 6 个冗余/过时 md 文档
- save_summary_to_db 委托 db::models::save_summary,避免 SQL 重复
- #[allow(dead_code)] 标注 serde 反序列化字段和预留 API
- 移除未使用的 re-export (Summarizer, Message, Role, StreamChunk)
- 修复 README 中 manage_memos 风险等级和缺失的 AMAP_KEY 配置
2026-06-03 17:14:01 +08:00
wunianxiao b2fe054eaf feat: 高德地图工具 + 多轮 bug 修复
新增:
- 高德地图 6 个内置工具: amap_poi_search, amap_geocode, amap_reverse_geocode, amap_route_plan, amap_travel_plan, amap_map_link
- CLI 子命令: ias tool amap (poi-search/geocode/route-plan/travel-plan/map-link)
- 工具优先级指南: build_capability_guide() 含 amap > weather > web_search 优先级
- DEFAULT_SYSTEM_PROMPT 内置工具优先级说明(不再依赖环境变量)

Bug 修复:
1. (HIGH) call_capability 参数契约修复 — 新增 unpack_call_params() 统一解包 prompt 字段
2. (MEDIUM) 天气 hours=0 不再调用逐时 API
3. (MEDIUM) 长期记忆 daemon 双写缓存+DB,无 DB 不丢失
4. (HIGH) 审批流程状态语义修复 — handle_reply 返回 ApprovalDecision,拒绝/过期不再当作通过
5. (HIGH) 审批有效期基于 expires_at 时间戳而非 receiver drop
6. (MEDIUM) 摘要保存改为 current_user_id 与读取一致
7. (MEDIUM) worker 审批通过后删除孤立 tool result,仅保留 approved_tool 状态放行

架构:
- daemon + worker IPC 架构 (Unix Domain Socket)
- build_capability_guide 共享函数消除 main.rs/worker.rs 重复
2026-06-03 17:01:04 +08:00