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>
Hermit
本地 coding agent（原 CST-Agent）：终端 TUI、可选 WebUI / 桌面 GUI，在工作区里读改文件、跑命令、管会话。 C11 实现，OpenAI 兼容网关（DeepSeek / Kimi / MiniMax / OpenAI 等）。
适合：有监督的本地改动与仓库探索（权限确认、diff、/undo、沙箱）。
慎用：完全无人值守的长任务；headless 默认自动批准。
文档索引：docs/README.md。
兼容：安装后提供 cst-agent → hermit 软链；环境变量 HERMIT_* 优先，仍接受 CST_*；配置目录优先 ~/.config/hermit，若无则回退 ~/.config/cst-agent。
安装
Linux / WSL / macOS
# 预编译包（快；失败则回退源码）
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
./scripts/bootstrap_linux.sh .
hermit --version # hermit 0.10.0
cst-agent-update # 升级助手仍可用
Release：hermit-VERSION-linux-{x86_64,x86,aarch64}.tar.gz。
Windows
见 docs/README-windows.md（产物名逐步改为 hermit-…；旧 cst-agent-… 包过渡期可能仍有）。
第一次用
cd ~/my-project && hermit
构建
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）。
用法速览
hermit # TUI
hermit --web # http://127.0.0.1:8787/
hermit --headless --prompt '…'
首页品牌 HERMIT + 寄居蟹色块动效；色板：brand #277F94、crab #F68042、eye #9957AD。
更多：Provider / 工具 / 议会 / WebUI 见 docs/。
CI 与发布
.gitea/workflows/ci.yml：TinyCC check → 打 Linux/Windows 包 → scripts/ci_publish.sh。
共用逻辑：scripts/lib_release.sh。
开发者
make check
scripts/prompt_smoke.sh
scripts/e2e_webui.sh
icons/agent-motion/ 为 SVG 资产；TUI 默认用字体序列极简轨，make hermit-font 生成 PUA 字体轨。