核心用法
Amber-Hunter 是 Huper琥珀 生态的记忆捕获与召回层，运行于本地机器（Mac/Linux/Windows），通过 localhost:18998 为 Claude Code、OpenClaw 等本地AI客户端提供API，同时以 huper.org/api 为 ChatGPT、Claude.ai 等云端AI提供服务。
三大核心能力：
- 主动捕获：AI通过
/ingest推送记忆，用户审核后入库；内置6类信号自动检测（决定、偏好、个人事实、总结、洞察、明确保存请求） - 即时召回：
/recall端点采用混合检索（0.4×关键词 + 0.6×语义），支持类别前缀匹配与insight缓存，为RAG管道提供结构化上下文 - 跨平台同步：AES-256-GCM端到端加密，可选加密上传至云端实现多设备访问
记忆分类系统：8大固定类别（想法💭、学习📖、决策🎯、成长🌱、关系🤝、生活🏃、创意🎨、开发💻）+ 自动关键词打标，支持18+规则化本地自动标签。
技术亮点：
- LanceDB向量检索 + 本地GPT微调（AmberGPT，6层256维，96token窗口）
- Session WAL热存储捕获即时偏好/修正信号
- G1自校正循环：用户编辑行为自动优化未来标签预测
- MCP协议服务器暴露7大工具，兼容Claude桌面版
显著优点
1. 真正的隐私优先：主密码存于系统钥匙串，明文永不上传；支持DID多设备身份与派生胶囊密钥
2. 零摩擦集成：同一套API同时服务本地AI和云端大模型，无需改造客户端
3. 智能主动：v1.2.13+ 的 proactive hook 让AI主动提议保存，而非被动等待用户指令
4. 可解释召回：返回匹配关键词、语义相似度、WAL信号来源，用户知道AI为何记得
5. 持续进化：用户校正历史 → 标签归一化规则 → 增量模型训练，形成数据飞轮
潜在缺点与局限性
- Windows功能残缺：主动捕获、
/freeze会话快照暂不支持（v1.2.37状态） - 密钥管理摩擦：VPS部署需手动配置
AMBER_TOKEN，首次使用门槛较高 - 云端依赖风险：跨设备同步依赖
huper.org，单点故障或政策变更可能影响服务 - 语义模型冷启动：新用户需积累50+胶囊或等待10秒延迟触发首次训练
- 评审队列堆积：高置信度自动入库（≥0.95）标准严格，日常对话大多需人工审核
适合人群
- 深度AI协作者：每天与Claude Code、ChatGPT高频交互的开发者、创作者
- 个人知识管理爱好者：希望构建跨越会话边界的「第二大脑」
- 隐私敏感用户：拒绝将个人记忆托管至Notion/Obsidian云端的本地优先主义者
- 多设备工作者：macOS+Linux双机或本地+VPS混合部署的技术用户
常规风险
| 风险类别 | 具体描述 | 缓解措施 |
|---------|---------|---------|
| 密钥泄露 | API token以明文形式存在于shell历史或config.json | 使用OS keychain存储主密码，token定期轮换 |
| 本地攻击 | localhost无额外认证，同一机器其他进程可访问 | 绑定127.0.0.1，防火墙限制入站 |
| 同步冲突 | 多设备同时写入可能导致胶囊版本冲突 | `POST /sync/resolve/{id}` 手动仲裁 || 模型偏见 | AmberGPT在用户数据上微调可能放大记忆偏差 | 定期审查 `/corrections/stats` 校正模式 |
| 供应商锁定 | 深度依赖huper.org生态，迁移成本较高 | 定期使用 `/admin/export` 本地备份 |
---
版本 1.2.37 (2026-04-05) | 构建者：Anke Chen | 协议：端到端加密优先