外观
帮助中心：常见问题与故障排查
遇到问题先来这里。按"症状 → 原因 → 解决"查表，多数问题 1 分钟解决。解决不了再问我。
一、快速排查表（按症状查）
| 症状 | 可能原因 | 快速解决 |
|---|---|---|
| 我找不到你给的文件 | 文件不在工作目录 | 把文件放进工作目录，或给我绝对路径 |
| 我回答的内容与你预期差很远 | 需求描述太模糊 | 用四要素补全（目标/输入/约束/验收），见第 2 章 |
| 我读不了某个文件 | 格式不支持或编码问题 | 告诉我文件格式，转成常见格式（txt/md/csv） |
| 我执行命令失败 | 环境/权限问题 | 把完整报错发我，我按堆栈排查 |
| 输出是乱码 | 编码问题（常见 GBK/UTF-8） | 告诉我原编码，统一转 UTF-8 |
| 本地预览/构建失败 | 依赖没装好 | 检查 node_modules，重装依赖 |
| 我"一本正经说错话"（幻觉） | 没给资料/凭记忆答 | 给资料、要引用、让它读着答（见课外阅读第 2 节） |
二、常用问题 FAQ
Q1：momawork-rs 到底是什么？
一个运行在 MomaWork 桌面程序里的 AI 工作助手。与聊天机器人的区别是：我拥有你的工作目录，能真正读写文件、执行命令、调用技能。详情见第 1 章。
Q2：我看不到工作目录之外的文件，怎么办？
把需要的文件复制或移动到工作目录，或给我文件的绝对路径。我就是"生活在工作目录里的同事"，目录之外的内容我默认看不到。
Q3：我能让你联网吗？
取决于你提供的工具。我默认不能随意浏览互联网；你给链接、文件、或告诉我可用工具，我就能基于这些内容工作。重要信息请提供原文或链接，我不编造。
Q4：你会删除我的文件吗？
不会主动删。 删除、覆盖、推送远程等不可逆操作，我都会先征得你确认再执行。如果遇到我请求确认，请看清再回答。
Q5：为什么我明明说了，你还是做错了？
90% 的"做错"来自两个环节：
- 需求没对齐：我没复述或你没纠正我的理解 → 回到第 2 章的"复述确认法"；
- 没有中间检查：直接等最终结果 → 要求"中间产物"，先看大纲/计划再继续。
Q6：记忆存在哪？安全吗？
记忆存在项目对应的 memory 目录，是明文 Markdown 文件，你可以随时查看、修改、删除。请勿把密码、密钥等敏感信息写入记忆或项目文件。
Q7：任务做到一半断了/我忘了上次进度，怎么办？
记忆系统会记录项目状态和上下文。恢复会话后，说"继续上次的任务"，我会读取记忆接着干。建议关键任务中途让它"记录当前进度"。
Q8：怎么让重复任务以后自动跑？
把流程沉淀为 Skill（第 17 章）→ 再用自动化定期调用（第 15 章）。这样你只需要说"生成本周周报"，它就会按标准流程跑。
三、故障排查流程（三步法）
1. 描述症状：发生了什么 + 完整的报错信息/截图/输出
2. 回顾改动：最近改了什么（文件/配置/环境）？
3. 最小复现：能不能用最小例子复现？能 → 一起定位；不能 → 现场排查排查心态
报错信息越完整，解决越快。 完整堆栈 + 触发步骤 + 最近改动，三样给齐，通常几分钟就能定位。
四、联系与反馈
- 遇到文档错误：告诉我具体章节和问题，我来修正；
- 希望新增内容：描述你想要的场景，我评估后扩充白皮书；
- 提出改进建议：任何让这本白皮书更好的想法，都欢迎直接说。