跳到正文
minimachine.
← 学习路径
第 24 步 · 高效工作 简单 · 8 分钟

📚资源、帮助与排障

重要的链接、能问问题的社区，以及出岔子时的应急反应。这是您往后路上的通讯录。

好了，您的机器在转，您的智能体在干活。还剩一个简单的真相：您不可能全都记住，而总有一天会有东西坏掉。这很正常。这一篇，就是您的通讯录, 权威的文档、会回答您的人、以及出岔子时该做的动作。

官方文档

每当冒出一个技术疑问，官方来源永远胜过被抄了十遍的教程。下面是各工具的权威页面：

学习与汲取灵感

排障之外，这里是您抽身退一步、了解最新动向的地方：

  • Anthropic Engineering, Anthropic 的文章，其中包括 Claude Code 最佳实践。这些读物真能改变您驾驭智能体的方式。
  • Hugging Face, open-weight 模型的中枢。几乎所有能在本地跑的东西都从这里过。
  • r/LocalLLaMA, 本地模型社区的脉搏。新东西、民间跑分、一线反馈。
  • Artificial Analysis, 模型对比（速度、质量、价格），基于实测数据而非凭感觉。

去哪里求助

最划算的反射动作：别人早就碰到过您这个错误了。 真的。把那条错误信息原样粘进搜索引擎，您常常会撞上一个半年前和您一样焦头烂额的陌生人写下的解决方案。万一没有，下面这些地方欢迎提问：

排障的反射动作

有东西坏了，别慌。有一套操作顺序能解决 90% 的情况：

认真读错误信息

别慌着关掉它。大多数错误都清清楚楚地说了哪里不对。花十秒钟读一读。

把它交给您的智能体

把错误粘进 Claude Code 或 OpenCode。解读那些晦涩的信息，正是它最擅长的事。它常常会顺手诊断出来并给出修复方案。

看服务的日志

如果是某个服务出了问题，日志会说话：journalctl -u <service> -e 看最近几行，systemctl status <service> 看它是否在跑、以及为什么崩了。

搜索那条精确的错误字符串

把最精确的那段错误（不是全部，就那句关键的）复制进搜索引擎。在您之前，已经有人走过这条路。

git 是您的「撤销」按钮

如果您编辑时弄坏了什么，而您又有规律地在提交，那您可以毫无痛苦地退回去。这正是把提交当作安全网的全部意义, 详见保护访问。

重启

对，真的。一个 reboot 解决的问题比我们愿意承认的还多, 卡住的服务、闹脾气的挂载、不正常的状态。绝望之前先试试。

让机器保持状态

几条值得记住的命令，用于快速健康检查：

htop          # 实时 CPU/RAM 负载，以及谁在吃资源
df -h          # 磁盘空间, 模型会把它填满得飞快
ollama ps      # 此刻、当下，哪些模型加载在内存里

至于会自动运转的维护：自动安全更新（unattended-upgrades，在系统设置里配置好的）会在您毫不操心的情况下让系统保持打过补丁。这正是那种装一次就忘掉的东西, 恰到好处。