dsh-brain/docs/troubleshooting.md

819 B
Raw Blame History

故障排查

常见问题的定位方法:热力图不涨、令牌缺失、网络不可用、令牌安全。


故障排查

  • 热力图不涨:看 /cloud-memory/status 的 reporter.skipped 与 lastError;常见原因是没配 activityToken、插件被 enabled:false 关掉,或令牌缺 activity:write scope。
  • 工具报“未配置记忆令牌”:填 memoryToken;写入还需要云端已配置 WebDAV 主存储(否则服务端 409 storage_not_configured)。
  • 网络不可用:上报会进队列,恢复后 30 秒内自动补发;也可以在配置页点“重试上报队列”。
  • 令牌泄漏风险:令牌只存在本机 JSON 文件里,页面只回显掩码(cmt_act…0001)。文件权限依赖用户目录 ACL(Windows 无 POSIX 位)。