排障与 FAQ

日志在哪里？ 都在 ~/.klaus/ 下：桌面端的诊断写在 electron-host.log，每行一条 JSON，按 kind 字段找——定时任务是 cron，做梦与记忆维护是 memory-maintenance；MCP 诊断和频道收发在 logs/ 里。反馈问题时附上相关片段有助于定位（应用内反馈会自动带上会话信息，不用自己贴）。

我的数据存在哪里？ 会话、设置、记忆等本地数据都在 ~/.klaus/ 目录下。

连接器打不开 / 一直显示需要授权？ 先在「设置 → 系统授权」或 macOS 系统设置中完成对应授权，然后重启 Klaus——不重启不生效。

定时任务没有触发？ 依次检查：任务是否处于启用状态；下次运行时间是否符合预期（注意时区）；任务详情里的运行历史，以及 ~/.klaus/electron-host.log 中该时间点 kind 为 cron 的记录。单次运行默认 5 分钟超时，任务自带的「超时秒数」会被采用（上限 24 小时），跑得久的任务要把这个值调大。进程在运行途中退出（更新重启、崩溃），那些卡在「运行中」的记录会在下次启动时被标为失败。

Klaus 一直没做梦？ 自动做梦默认是关的，先去「设置 → 梦」打开；打开之后还要同时满足两个条件才会跑：距上次做梦满 24 小时，且累计 ≥ 5 个新会话。不想等就在记忆页手动「现在做一场梦」，手动触发不看这两个门槛，但同样要求那个开关是开着的，并且本次启动以来至少有一条会话跑完过一轮。（顺带一提，同一页那个「自动记录」开关也是默认关的，不开的话 Klaus 不会随手记东西。）

钩子写了却不跑？ 两个最常见的原因：事件名写错的条目会被直接丢掉（不报错）；或者那条钩子声明还没在「设置 → 钩子」里被信任——新声明和内容变过的声明一律不执行，见钩子。

为什么改了 MCP / 项目配置没生效？ 分两种：在 App 里改的（市场装技能、启停插件、钩子页点信任）会把已开着的会话标为过期，下一回合之间自动重建带上新值，不用重开；但你自己在编辑器里改磁盘文件的不行——Klaus 不监听这些目录，得开一个新会话才读得到。见扩展怎么被加载。

能让 Klaus 自己去改设置、建任务、装技能吗？ 能，直接说就行。读取类的它直接做，不可逆的动作会先问你，定时任务里的那一轮则一律不做不可逆改动。见让 Klaus 操作 Klaus。

Klaus 自己了解自己吗？ 本手册随应用内置，Klaus 可以直接检索它，所以关于产品行为、开关含义、内部机制的问题都可以直接问。

如何反馈问题？ 每条会话的 ⋯ 菜单里有「报告问题」，会自动带上会话上下文；或者邮件 support@klaus-ai.cn。提想法（建议）窗口里没有入口，直接跟 Klaus 说让它替你提交，见反馈与建议。