用途:当用户反馈“记忆坏了”“recall 找不到内容”“remember 没保存”“结果质量为何很低”等问题时,调试 Signet 记忆系统。调用语法为 /memory-debug,可带说明,如 /memory-debug recall is empty、/memory-debug embeddings failing。
主要排查流程:
- 验证守护进程与配置。运行 signet status 与 curl -s http://localhost:3850/health。若守护进程未运行或无响应,可用 signet daemon start/restart 重启;CLI 重启无效时先 signet daemon stop,再 pkill -f "signet.*daemon",然后 signet daemon start。系统服务方式下,macOS 用 launchctl kickstart -k gui/$(id -u)/ai.signet.daemon,Linux 用 systemctl --user restart signet-daemon。重启后再次确认健康,并检查 ~/.agents/agent.yaml 与 ~/.agents/memory/memories.db 是否存在。
- 验证写入路径。执行 signet remember "memory-debug smoke test" -t debug,smoke -w claude-code,预期成功并返回 embedded: true 或明确的回退信息。失败时记录确切 CLI 错误,并建议相应修复。
- 验证读取路径。执行 signet recall "memory-debug smoke test" -l 5 --json。无结果时改用更简单关键词重试,检查 ~/.agents/agent.yaml 中的 search.min_score 与 search.alpha,并确认第 2 步确实写入。
- 检查嵌入健康。若记忆已保存但语义召回弱,查看分数是否偏关键词、嵌入是否不可用,并核对配置中的 embedding.provider、embedding.model、embedding.dimensions。常见修复包括提供方离线、模型名错误、更换模型后维度不匹配。
- 高级诊断。查看守护进程日志:signet daemon logs -c hooks、signet daemon logs -c memory;也可直接调用 API:curl -s "http://localhost:3850/api/memory/search?q=debug&limit=5" 和 curl -s http://localhost:3850/api/status。
报告格式:说明什么失败、确切命令与错误、可能根因、具体修复步骤、验证修复的命令。优先采用最小、可复现的检查,避免宽泛猜测。
限制:资料未提供该技能的收费、价格、支持平台、模型要求或效果保证等信息。