節點與運行實例
節點清單用於回答“哪個運行實例在什麼環境中，以什麼身份、版本和策略工作”。它記錄可公開的運維元數據，不保存 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 維護