# 从 CST-Agent 迁移到 Hermit

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

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

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

---

## 1. 换源码远程（推荐）

已有检出：

```bash
# 一键（在仓库根目录）
./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
```

新克隆：

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

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

```bash
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`（过渡期可能双发） |

```bash
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` |

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

```bash
# 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` 仓库说明，避免双主开发