节点与运行实例
节点清单用于回答“哪个运行实例在什么环境中，以什么身份、版本和策略工作”。它记录可公开的运维元数据，不保存 node_secret、Hub token 或私钥。
Desktop 与独立节点分开记录
Desktop 的本地节点有未注册、已注册未认领、已由账号认领三种状态。进入 EvoMap 面板检查注册与认领；登录账号和本地节点身份分别记录。以下 CLI 状态采集用于独立 Evolver，不用机器名或账号登录状态推断节点已认领。
一台设备上有哪些不同的身份
设备、应用使用者、运行实例和网络节点分别回答不同问题。设备说明程序在哪里运行；账号说明谁登录应用；运行实例由启动入口、进程用户和数据目录确定；节点身份用于关联 Hub 上的活动。盘点时必须保留它们之间的对应关系。
例如，同一台电脑上同时使用 Desktop 和独立 Evolver，不能只建一行“某人的电脑”。应分别记录两个运行对象，再关联到同一设备。Desktop 已登录账号，不足以证明它的本地节点已注册或认领；独立 Evolver 的目录也不能根据 Desktop 的路径推断。
区分迁移、重建与新增实例
迁移的目标是让原有职责转移到新位置，需要记录接管时间、原实例停止状态和新目录。重建身份会改变后续活动的身份关联，应保留旧节点与新节点的对应说明。新增实例则需要独立记录负责人、用途与允许范围，不能直接复用旧清单的验收结论。
核对异常时，以进程实际读取的配置为起点。如果服务使用的系统账号与当前终端不同，默认 home 也要分别确认。此时终端命令返回健康，只证明该命令读到的实例健康；必须先对齐身份和目录，才能用它解释后台服务的状态。
每个节点应记录什么
| 字段 | 用途 |
|---|---|
node_id | 在 Hub、任务和日志中定位节点 |
| 环境与用途 | 区分个人开发、试点、持续运行和发布节点 |
| 负责人 | 明确配置、凭证和故障处理责任 |
| 身份与数据目录 | 记录 EVOMAP_HOME、--evomap-home 和运行数据根目录 |
| 版本 | Node.js、Evolver、EvoX Desktop 或 sidecar 版本 |
| 网络角色 | Public/Private Hub、Worker、Validator 与发布权限 |
| 服务方式 | 手动、Windows 服务、systemd 或 launchd |
| 最近检查 | 最后心跳、健康检查、备份与凭证轮换时间 |
采集当前状态
evolver status
evolver doctor
evolver lifecycle status
独立 Evolver 与 EvoX Desktop 分别管理身份目录。看到相同机器名不能推断它们共享同一个节点；清单必须以实际目录和 node_id 为准。
更新规则
- 安装、迁移、重建身份、切换 Hub 或更改服务方式后立即更新。
- 版本升级和凭证轮换应保留前后时间，不覆盖历史记录。
- 节点退役时记录停止时间、资产交接、凭证撤销和备份位置。
- 定期从实际状态反查清单，避免只维护表格却不验证运行实例。
安全边界
清单可以包含 node_id、版本和负责人，但不得包含秘密、完整环境文件或可直接访问内部系统的 URL 参数。需要共享日志时同时遵循脱敏和请求追踪规范。
核对实例与目录
先从实际服务或启动配置记录进程用户、启动入口与数据目录，再与状态输出中的身份对应。独立 Evolver 状态根目录按 EVOLVER_HOME、EVOMAP_HOME、默认 ~/.evomap 的顺序解析；具体入口的身份目录覆盖参数另行记录。Desktop 使用自己的内部目录，不能直接复制独立节点的路径假设。
同一节点 ID 对应多个同时运行的实例，或同一服务前后指向不同目录时，先暂停新增任务并排查启动配置，不直接删除其中一个目录。验收时必须做到每个实例有负责人、明确的版本与目录，注册、认领和账号登录状态各自有依据。
相关页面
EvoX 文档 · 开发者 · 独立 Evolver 维护