CST-agent/MIGRATION.md

从 CST-Agent 迁移到 Hermit

本仓库 WHC/CST-agent 保留为兼容入口。 产品名与规范克隆地址已改为：

https://git.whcself.xyz/WHC/Hermit

二进制、配置与环境变量自 0.10.0 起以 Hermit 为准；CST-agent 仓库与旧包名仅作过渡。

---

1. 换源码远程（推荐）

已有检出：

# 一键（在仓库根目录）
./scripts/migrate_remote_to_hermit.sh

# 或手动
git remote set-url origin https://git.whcself.xyz/WHC/Hermit.git
git fetch origin
git branch -u origin/main

新克隆：

git clone https://git.whcself.xyz/WHC/Hermit.git
cd Hermit
make -j$(nproc) && make install PREFIX=$HOME/.local

旧地址仍可拉代码一段时间：

git clone https://git.whcself.xyz/WHC/CST-agent.git   # 兼容；请改 origin 到 Hermit

---

2. 二进制与 PATH

旧	新
cst-agent	hermit（安装时仍提供 cst-agent → hermit 软链）
cst-agent-update	→ hermit-update（软链；议会助手 → hermit-service）
Release cst-agent-VERSION-linux-*.tar.gz	hermit-VERSION-linux-*.tar.gz（过渡期可能双发）

hermit --version    # hermit 1.0.x
hermit-update       # 升级；兼容名 cst-agent-update
cst-agent --version # 同二进制（软链）

---

3. 配置目录

旧	新
~/.config/cst-agent/	~/.config/hermit/
Windows %APPDATA%\cst-agent	%APPDATA%\hermit

程序若发现 仅有 旧目录、尚无新目录，会继续读旧路径。建议主动迁移：

# Linux / macOS
mkdir -p ~/.config/hermit
# 若尚未迁过：
cp -a ~/.config/cst-agent/. ~/.config/hermit/ 2>/dev/null || true

工作区 .agent/ 会话目录不变，无需改动。

---

4. 环境变量

HERMIT_* 优先；未设置时仍读 CST_*。

用途	新	旧（兼容）
Provider / Key / Model	HERMIT_PROVIDER 等	CST_PROVIDER 等
ASCII / Icons	HERMIT_ASCII / HERMIT_ICONS	CST_ASCII / CST_ICONS
议会密码等	HERMIT_REALM_PASSWORD（若已接双读）	CST_REALM_PASSWORD

systemd：EnvironmentFile 已同时尝试 ~/.config/hermit/parliament.env 与旧路径。

---

5. CI / 脚本 / 文档链接

• 安装脚本、bootstrap、文档中的规范 URL 改为 …/WHC/Hermit。
• 本文件与 README 顶栏是 CST-agent 仓库上的最后一次迁移说明；后续功能请在 Hermit 仓库跟进。

---

6. 核对清单

• git remote -v 指向 WHC/Hermit.git
• hermit --version 正常；PATH 上可选保留 cst-agent 软链
• ~/.config/hermit/ 有 credentials / settings（或确认仍在用旧目录回退）
• 书签 / 镜像 / CI 的 clone URL 已更新
• （可选）归档或只读化 CST-agent 仓库说明，避免双主开发