Amber-Hunter 更新日志

记录 Amber-Hunter 技能的所有版本更新。

---

v0.8.9 (2026-03-22) 🧠

发布日期: 2026-03-22
类型: 重大更新 - 主动记忆 + 主动回忆

✨ 新增功能

1. 主动回忆 /recall

功能：在 AI 响应前自动搜索相关的琥珀记忆

API 端点:

GET /recall?q=<query>&limit=3

响应示例:

{
  "memories": [
    {
      "id": 123,
      "memo": "架构评审",
      "injected_prompt": "用户之前讨论过模块结构...",
      "relevance_score": 0.92
    }
  ],
  "semantic_available": true
}

搜索模式:

• keyword - 关键词匹配
• semantic - 语义搜索（sentence-transformers）

---

2. 主动记忆捕获

功能：自动检测重要时刻并捕获

检测信号:

• correction - 用户纠正 AI
• error_fix - 错误修复
• decision - 重要决策
• preference - 用户偏好
• discovery - 新发现

运行频率: 每 10 分钟自动运行

特点:

• ✅ 完全静默
• ✅ 零用户干扰
• ✅ 自动识别重要时刻

---

3. 自动同步开关

功能：配置冻结后是否自动同步到云端

API:

GET /config    # 查看配置
POST /config   # 更新配置

配置项:

{
  "auto_sync": true,
  "cloud_provider": "huper.org"
}

---

4. 跨平台密钥链

系统	实现
macOS	Keychain (security 命令)
Linux	GNOME Keyring (secret-tool)
Windows	Credential Manager (cmdkey)

---

5. 跨平台自启动

系统	实现
macOS	LaunchAgent
Linux	systemd user service
Windows	Task Scheduler

---

🐛 Bug 修复

1. CORS 预检 405

   • 切换到 StarletteCORSMiddleware
   • 添加显式 OPTIONS 处理

2. 混合内容问题

   • HTTPS→HTTP 请求被浏览器阻止
   • 改用查询参数 ?token= 替代 Authorization header

3. SSE 500 错误

   • threading.Queue → queue.Queue
   • Python 3.10 兼容性修复

---

📡 新增 API 端点

端点	方法	说明
/recall	GET	主动记忆检索
/sync	GET	云端同步（查询参数认证）
/config	GET/POST	自动同步配置
/master-password	POST	设置主密码（仅 localhost）
/token	GET	获取本地 API key（仅 localhost）

---

v0.8.4 (2026-03-22) 🔒

发布日期: 2026-03-22
类型: 安全修复

安全修复

• 🔐 加密增强

  • content 字段 AES-256-GCM 加密后存储
  • salt+nonce 持久化
  • 加密密钥从 master_password 派生

• 🔑 认证机制

  • 本地 API token 验证
  • 防止同一机器上其他进程滥用
  • Bearer token 前缀验证

• 🌐 CORS 修复

  • 修复预检请求 405 错误
  • 使用 Starlette CORSMiddleware
  • 仅允许 huper.org 和 localhost

• 🔒 Keychain 安全

  • master_password 读不到直接报错
  • 不再 fallback 到文件
  • 密码仅存储在系统密钥链

---

API 变更

端点	变更	说明
/freeze	🔒 需认证	添加 Bearer token 验证
/token	✨ 新增	暴露 API key（仅 localhost）
/status	🔧 优化	返回配置状态

---

v0.8.3 (2026-03-22) 🌙

发布日期: 2026-03-22
类型: 首版发布

新增功能

• ✨ 浏览器冻结

  • huper.org 点击"冻结当下"
  • 自动预填充当前上下文
  • 无需手动复制粘贴

• 🎯 Raycast 集成

  • amber freeze 命令
  • 快速触发冻结
  • 系统级快捷键支持

---

📅 更新频率

• 早期版本（v0.8-v0.9）：快速迭代，每日多版本
• 稳定版本（v1.0+）：功能完善，按需更新
• 计划版本（v1.1+）：分布式存储

---

🚀 未来计划

v1.0 (计划)

• 🌐 分布式存储
• 🧩 纠删码碎片化
• 🌼 蒲公英模式散布
• ☁️ 不依赖单一服务器

v1.1+ (愿景)

• 🤖 AI 主动回忆增强
• 🔍 语义搜索优化
• 📊 记忆可视化
• 👥 协作分享功能

---

🔗 相关资源

资源	说明
GitHub 仓库	源代码
安装教程	完整安装指南
Huper 琥珀	官方网站

---

提示：建议所有用户升级到 v0.8.9，包含主动记忆和主动回忆功能。