怎么跑起来

怎么跑起来

这一栏每页都是一次安装的完整记录,按顺序写:跑了什么、返回了什么、怎么知道它成了。

机房内成排的服务器机柜,顺着通道纵深拍过去
图: Hugovanmeijeren· CC BY-SA 3.0· 维基共享资源

这一栏管什么

用它的头一个小时。安装器跑完、终端打出几行字,然后你就该在跟一个 agent 对话了。这一栏记录的就是这一个小时在真机上发生了什么:安装器往磁盘写了什么、哪个平台先死、报错原文是什么、以及怎么做一份真的能还原的备份。这里没有一页是靠读文档写出来的——我们没跑过的,就不写。

一页是怎么写成的

  • 跑了什么——原命令,连参数一起。
  • 返回了什么——终端原样输出,报错不改写。
  • 在哪一步偏了——机器开始和说明书对不上的那一刻。
  • 怎么知道成了——事后跑的校验,以及“通过”长什么样。
  • 怎么回滚——需要之前就该知道要删或要还原哪些文件。

这一栏现有的篇目

  1. 安装器到底往磁盘放了什么——四个目录承载状态,其中三个永远不该离开这台机器。
  2. Windows、WSL、macOS:各自最早死在哪一步——我们踩到的 MSYS 路径坑,以及没测的部分。
  3. 升级前必须备份什么——122 MB、5,279 个条目,以及用哈希校验过的还原。
  4. 桌面端接 WSL 后端——一个 JSON 文件决定请求往哪走;看着像配置的那些故障,多数是发行版停着。
  5. 让它无人值守地跑——nohup 与 setsid 都活过了 shell 退出;杀掉它们的是关机,而扛得住关机的是 unit 文件。
  6. 那个从没打开的端口——没配认证就暴露后端会被拒绝,而它拒绝的时候退出码是 0。

这一栏不写什么

输出质量与提示词技巧、API 集成、账单争议、厂商支持请求。价格在 成本与模型,磁盘上的状态在 记忆与工具。如果有哪一页没回答你的问题,那值得来一封邮件——通常意味着我们跳过了一步,而别人也卡在同一步。

照着做之前,先跑这四条

版本会动。动手前先把自己机器的实情打出来:

  • node -v——安装器和 agent 都依赖的运行时。
  • wsl.exe -l -v——Windows 上有没有 WSL、是第几版。
  • ls -1 "$LOCALAPPDATA/hermes" | wc -l——你的安装已经生成了多少顶层条目。
  • hermes --version——你要对照的那个构建。

四条里如果有两条跟我们页面上写的不一样,就把那一页当成假设而不是配方,并先看页首的核验日期。