WHCandCursor
f30b4ede48
Ship hermit binary (cst-agent symlink), ~/.config/hermit with legacy fallback, Hermit color theme and mini crab frames, plus SVG→PUA font build pipeline. Co-authored-by: Cursor <cursoragent@cursor.com>
88 lines
2.5 KiB
Markdown
88 lines
2.5 KiB
Markdown
# Hermit
|
||
|
||
本地 coding agent（原 CST-Agent）：终端 TUI、可选 WebUI / 桌面 GUI，在工作区里读改文件、跑命令、管会话。
|
||
C11 实现，OpenAI 兼容网关（DeepSeek / Kimi / MiniMax / OpenAI 等）。
|
||
|
||
**适合**：有监督的本地改动与仓库探索（权限确认、diff、`/undo`、沙箱）。
|
||
**慎用**：完全无人值守的长任务；headless 默认自动批准。
|
||
|
||
文档索引：[docs/README.md](docs/README.md)。
|
||
|
||
兼容：安装后提供 `cst-agent` → `hermit` 软链；环境变量 `HERMIT_*` 优先，仍接受 `CST_*`；配置目录优先 `~/.config/hermit`，若无则回退 `~/.config/cst-agent`。
|
||
|
||
---
|
||
|
||
## 安装
|
||
|
||
### Linux / WSL / macOS
|
||
|
||
```bash
|
||
# 预编译包（快；失败则回退源码）
|
||
curl -fsSL https://git.whcself.xyz/WHC/CST-agent/raw/branch/main/scripts/bootstrap_linux.sh | bash -s -- --release
|
||
|
||
# 源码增量编译 → ~/.local/bin/hermit（+ cst-agent 软链）
|
||
curl -fsSL https://git.whcself.xyz/WHC/CST-agent/raw/branch/main/scripts/bootstrap_linux.sh | bash
|
||
```
|
||
|
||
```bash
|
||
./scripts/bootstrap_linux.sh .
|
||
hermit --version # hermit 0.10.0
|
||
cst-agent-update # 升级助手仍可用
|
||
```
|
||
|
||
[Release](https://git.whcself.xyz/WHC/CST-agent/releases)：`hermit-VERSION-linux-{x86_64,x86,aarch64}.tar.gz`。
|
||
|
||
### Windows
|
||
|
||
见 [docs/README-windows.md](docs/README-windows.md)（产物名逐步改为 `hermit-…`；旧 `cst-agent-…` 包过渡期可能仍有）。
|
||
|
||
### 第一次用
|
||
|
||
```bash
|
||
cd ~/my-project && hermit
|
||
```
|
||
|
||
---
|
||
|
||
## 构建
|
||
|
||
```bash
|
||
make -j$(nproc) # 产出 hermit（并链 cst-agent）
|
||
make -j$(nproc) check
|
||
make hermit-font # 可选：SVG→PUA 字体（需 rsvg/fonttools）
|
||
make install PREFIX=$HOME/.local
|
||
```
|
||
|
||
TUI 图标：`HERMIT_ICONS=auto|mini|font`（默认极简字符帧；`font` 需安装 `share/hermit/hermit-icons.ttf`）。
|
||
|
||
---
|
||
|
||
## 用法速览
|
||
|
||
```bash
|
||
hermit # TUI
|
||
hermit --web # http://127.0.0.1:8787/
|
||
hermit --headless --prompt '…'
|
||
```
|
||
|
||
首页品牌 **HERMIT** + 寄居蟹色块动效；色板：brand `#277F94`、crab `#F68042`、eye `#9957AD`。
|
||
|
||
更多：Provider / 工具 / 议会 / WebUI 见 [docs/](docs/)。
|
||
|
||
---
|
||
|
||
## CI 与发布
|
||
|
||
`.gitea/workflows/ci.yml`：TinyCC check → 打 Linux/Windows 包 → `scripts/ci_publish.sh`。
|
||
共用逻辑：[scripts/lib_release.sh](scripts/lib_release.sh)。
|
||
|
||
## 开发者
|
||
|
||
```bash
|
||
make check
|
||
scripts/prompt_smoke.sh
|
||
scripts/e2e_webui.sh
|
||
```
|
||
|
||
`icons/agent-motion/` 为 SVG 资产；TUI 默认用字体序列极简轨，`make hermit-font` 生成 PUA 字体轨。
|