HelloAGENTS 会在项目下维护项目知识，默认落在 .helloagents/；用户级配置在 ~/.helloagents/helloagents.json。开发环境从本地搬到阿里云 ECS 后，这两处放哪、怎么持久化、多台机器怎么同步，就从「默认就好」变成要提前设计的事。
先分清两类数据
长期知识：context.md（概览、技术栈、架构、模块索引）、guidelines.md（编码约定）、verify.yaml（验证命令）、CHANGELOG.md、DESIGN.md，以及 modules/*.md、plans/<feature>/、archive/。
短时运行时：sessions/<workspace>/<session>/ 下的 STATE.md（人类可读恢复快照）、runtime.json（机器用）、artifacts/*.json（结构化回执），以及 sessions/active.json；events.jsonl 是可选的追踪输出，默认关闭。标准运行时证据与临时状态 72 小时后过期，长时 Codex goal 流程在明确需要时保留 720 小时上限。
意义在于：知识值得跟仓库走、进版本控制或共享存储；运行时是机器本地、过期即弃。混在一处备份是云上最常见的失手。
持久化位置与快照策略
默认 project_store_mode = "local"，知识在项目 .helloagents/ 里跟着 repo 走。项目目录若挂系统盘，建议给系统盘做定期快照，或把工作目录挂到独立数据盘 / NAS，避免快照回滚把知识一起退回旧版本。
~/.helloagents/helloagents.json 在 HOME 下、不在项目里，多台 ECS 各一份，记录 output_language、notify_level、kb_create_mode、project_store_mode、install_mode 等键；迁移时要么复制要么重新生成，host_install_modes 只在宿主设置成功后写入，别手工编。装插件前后各打一次快照、升级前再打一次；遇到宿主配置写坏，回滚比手工拆除可靠。
~init 与 repo-shared 的取舍
~init 在仓库内初始化该项目 workflow 并同步项目知识；helloagents --global 用于宿主级部署，两者不是一个层级，别混用。
把 project_store_mode 改成 "repo-shared" 后：本地 .helloagents/ 只留项目本地状态与运行时文件；稳定的知识与计划文件移到 ~/.helloagents/projects/<repo-key>/；同一 git 仓库的多个工作树共享同一份稳定知识。运行时状态与证据仍留在当前工作项目（state_path、sessions/active.json、runtime.json、artifacts/*.json）。repo-shared 下 verify.yaml 会从共享项目存储解析。
怎么选：单机单工作树用 local 就够；同机多工作树、多分支并行，repo-shared 能避免知识被反复重新发现，代价是知识挪到 HOME 下、机器之间不再天然共享。
多台 ECS 之间的同步边界
知识文件：希望跨机共享就让 .helloagents/ 进 git，或放共享存储（NAS / OSS 挂载），别靠 rsync 手工对拷。
运行时状态：不要跨机同步。STATE.md 绑定 workspace 与 session 映射，active.json 只留最新活跃映射，同步只会造成会话目录混乱。
宿主配置：~/.helloagents/helloagents.json 机器本地各自维护；Codex 的 hook 信任状态更是「机器本地生成元数据，由当前 ~/.codex/hooks.json 绝对路径派生，不是可移植配置，每台机器都要重新生成」。
一句话：知识可共享，运行时不可共享，宿主配置按机器重建。
升级与回滚的生命周期顺序
升级：helloagents doctor 记录现状 → 打快照 → 用包命令更新 → 显式 npm explore -g helloagents -- npm run sync-hosts -- ... → 重启目标 CLI → 再 doctor。重装、更新或切模式后，运行中的会话不会自动重载规则，必须重启。
回滚：ECS 快照回滚，再装回对应版本包，然后 doctor 复核。
卸载：先 npm explore -g helloagents -- npm run uninstall -- --all 清理宿主集成与稳定运行时副本，再 npm uninstall -g helloagents；项目 .helloagents/ 与 ~/.helloagents/helloagents.json 故意保留，去留自己定。切分支相对安全——switch-branch 会在内部 npm install / sync 前清掉残留的 HELLOAGENTS 生命周期环境变量——但切完仍要重启 CLI。
哪些不该交给云主机
别把密钥、token 写进 .helloagents/ 或提交进 repo，知识文件可能被推到远端。别跨机同步运行时状态。别在没快照的生产实例上直接升级宿主集成。别指望 Codex hook 信任状态能在机器间复制可用。另注意：只读工作且当前目录及父目录都没有项目本地 .helloagents/ 时，短时状态会落到 ~/.helloagents/runtime/<scope-key>/，那里只有 STATE.md、runtime.json 和 artifacts/，由 TTL 清理——它不是项目知识。
总结
把 HelloAGENTS 放进云上开发环境，核心是把「长期知识」与「短时运行时」分开：知识进 git 或共享存储、随快照保留，运行时与宿主配置按机器重建、不要跨机同步；升级回滚按 doctor → 快照 → 更新 → sync-hosts → 重启 CLI 的顺序走。想对照同类插件的中文清单与安装形态，见 DeepSeek Harness Hub 插件清单。
适合与不适合
适合：把 AI 编程 CLI 跑在阿里云 ECS、需要项目知识跨会话复用的团队；同一仓库多工作树并行、希望知识只维护一份的开发者；会用快照做升级回滚、在意持久化边界的运维。
不适合：只想单机临时用、不在意知识持久化的用户；把知识库与运行时状态混在一起备份的流程；不能接受工具向多个宿主 CLI 写配置、又不愿先看高危扫描证据的团队——项目仍在 developer-preview 阶段，风险应被真实评估。
标签：HelloAGENTS、DeepSeek Harness、阿里云 ECS、项目知识库、开发环境
本文由 DeepSeek Harness Hub 自动整理，数据来源于插件详情页。
