 wunianxiao
|
23c7fbac62
|
feat: 为全部 39 个 Rust 源文件添加系统性中文注释
为整个项目添加了详尽的中文文档注释，覆盖所有模块：
入口与架构:
- main.rs — 架构图、数据流、4 个关键设计决策
- cli.rs — 所有 CLI 子命令中文化
- Cargo.toml — 每个依赖的作用说明
- channel/mod.rs — 渠道标识设计意图
核心守护进程与消息队列:
- daemon.rs — 三消费者架构图、审批流
- queue/* — 公平轮转算法、路由调度架构
LLM 层:
- types.rs — Role/Message/ToolCall 等每个字段含义
- provider.rs — Provider trait 设计 + SSE 解析
- conversation.rs — 工具循环流程图、摘要机制
- deepseek.rs — API 请求格式
上下文管理:
- context/types.rs — ChatSession 消息生命周期
- context/builder.rs — Token 预算管理策略
- context/tools.rs — MemoryStore 双写策略
工具系统:
- tools/mod.rs — 两层元工具架构图
- tools/approval.rs — 审批流程
- tools/definitions.rs — 声明式工具三要素
- tools/subprocess.rs — 执行流程 + 缓存策略
数据库与状态:
- db/* — 5 张表用途、回退策略
- state.rs — 文件存储回退方案
- scheduler.rs — SKIP LOCKED 防重复
已废弃模块:
- ipc.rs — 旧 UDS 协议
- worker.rs — 旧 vs 新架构对比
|
2026-06-09 20:52:24 +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 |
|
|
wunianxiao
|
3f447668b8
|
fix: 用户隔离完整性 + 聊天去重
1. 启动时不加载历史消息（等第一条消息确定身份后按需恢复）
2. MemoryStore 改为 HashMap<user_id, Vec<mem>>，按用户隔离缓存
3. session.current_user_id 与外部 mutex 同步
4. chat_records.message_id 加 UNIQUE 索引 + ON CONFLICT DO NOTHING
|
2026-06-02 14:27:35 +08:00 |
|
|
wunianxiao
|
7ab5052642
|
fix: 5 个安全/正确性问题（第三轮）
1. (High) 启动加载历史消息无用户过滤
→ 有 current_user_id 时按用户过滤
2. (High) 长期记忆跨用户共享
→ read_for/write_for 按 user_id 隔离
3. (Medium) 摘要读取无用户过滤 — 待后续
4. (Medium) WeChat API 未检查错误
→ notifyStart 检查 ret!=0
→ getUpdates 检查 ret/errcode
→ post_json 加 error_for_status()
5. (Low) set_auth 未更新 base_url
→ &mut self + 实际赋值
|
2026-06-02 11:54:34 +08:00 |
|
|
wunianxiao
|
00002e4740
|
feat: 后台服务模式 + 日志滚动 + 修复 llm_usage 表兼容性
- 新增 logger.rs（tracing-appender，日滚日志，.data/logs/）
- service 子命令：等同 listen --llm 但日志同时写入文件
- systemd/ias.service 单元文件
- 迁移 0007：ALTER TABLE llm_usage ADD COLUMN IF NOT EXISTS
修复与 iPet 旧表的结构冲突
- ias usage 命令可正常查询 Token 统计
- 日志滚动保留 7 天，自动删除旧文件
|
2026-06-01 17:45:17 +08:00 |
|
|
wunianxiao
|
b9de3665d9
|
feat: iPet → iAs 完整迁移，Rust 版微信 AI 助手
Phase 1 ✅ CLI 框架 + 配置系统
- clap 子命令: login / listen / send / whoami / usage
- config.json + env var 替换
- tracing 日志系统
- state 持久化（auth/runtime 文件存 + PostgreSQL）
Phase 2 ✅ 微信通道
- wechat::client — 完整 iLink Bot HTTP API 实现
- 扫码登录（终端二维码 + 轮询状态）
- 长轮询 getupdates / 消息收发 / 监听注册
Phase 3 ✅ AI 对话（纯文本 + function calling）
- LlmProvider trait: DeepSeek + LM Studio 实现
- SSE 流式解析（text / reasoning / tool_calls delta / usage）
- Conversation: 消息历史 + chat / chat_with_tools 工具循环
Phase 4 ✅ PostgreSQL 集成
- app_state（认证 KV 存储）
- chat_records（消息收发记录）
- llm_usage（Token 用量统计缓存命中率）
- user_memories（长期记忆持久化）
- pending_approvals（审批确认码）
- scheduled_tasks（定时任务表）
Phase 5 ✅ 一切皆 Skill（工具系统）
- SkillRegistry: 系统 + 用户 skills 双目录合并
- SKILL.md 解析器 + 子进程执行器（stdin JSON → stdout）
- 9 个系统 Skills: datetime / weather / search / email /
shell / schedule / memos / read_memories / read_summaries
- ApprovalManager: High 风险技能 → 确认码审批（透明模式）
- High 风险技能：确认码审批（透明模式）
Phase 6 ✅ 定时任务调度器
上下文管理
- ChatSession: checkpoint + token budget (28K) + summaries
- Token 估算器（中英文自适应）
- 12h 空闲 → trigger_idle_summary（不入会话）
- Budget 溢出 → trigger_overflow_summary（入会话 + drain 旧消息）
- Summarizer: LLM 生成自然语言摘要（fallback 简单截断）
- 长期记忆 / 摘要 通过 read_memories / read_summaries 工具按需读取
工具调用日志 + Token 统计
- INFO: 工具名 + 参数 + 结果摘要
- DEBUG: 子进程 exit/stdout/stderr
- ias usage --since --until --model 查看用量和缓存命中率
|
2026-06-01 17:21:43 +08:00 |
|