trivium 是一个面向 Termux 的单二进制工具：TUI 供应商管理器 + 本地协议路由器 + 三端（OpenCode / Claude Code / Codex）配置管理器。
通过统一供应商（provider）管理，把上游 API（如 OpenCode Zen 免费层、zen-go 付费层）接入 OpenCode / Claude Code / Codex 三端，并在本地做协议转换（Anthropic Messages / OpenAI Chat / OpenAI Responses 互通）。所有写操作都带 dry-run 预览、脱敏 diff、时间戳备份与回滚。
⚠️ 成本提醒：上游按模型独立计费。默认请只用便宜模型（如 zen 免费层deepseek-v4-flash-free、zen-go 付费层deepseek-v4-flash）。claude-opus-5/claude-sonnet-5/gpt-5.6-sol等模型很贵，不要配进defaultModel。
- 供应商管理：预设添加、测试连通、编辑、复制、删除、模型拉取、导入导出、应用到三端
- 协议路由：
trivium serve本地服务，Anthropic Messages / OpenAI Chat / OpenAI Responses 三协议互通（同协议直通透传，跨协议 IR 转换） - 缓存双模式：供应商级
cacheMode配置（auto按厂商自动识别 /compat通用前缀缓存 /deepseek特化：tools 稳定排序 + system 固定前置 + usage 归一化不双计） - MCP / Skills / Projects / Prompts：统一 store + 三端非破坏式投影
- Agent 安装更新：OpenCode / Claude Code / Codex 的 Termux 环境诊断、安装、升级
- 会话浏览：归一化浏览三端本地会话记录
- runit 自启：
trivium serve由 termux-services 托管，开机自动运行
# 1. 构建
cd xu-rs
cargo build --release
cp target/release/trivium $PREFIX/bin/trivium
# 2. 环境诊断 + 安装三端 Agent（可选）
trivium agent doctor
trivium agent setup --yes # 安装/更新 opencode、claude、codex
# 3. 自启本地协议服务（termux-services）
# 已提供 runit 服务：/var/service/spec-serve
sv up spec-serve # 启动；sv status spec-serve 查看；sv down 停止npm i -g @240xu/trivium
trivium --version
trivium agent doctor # 含 DSH 补丁漂移检测（[ok]/[DRIFT] 逐项列出）新版 npm 若拦截 postinstall（
npm warn install-scripts），先npm config set ignore-scripts false或npm install-scripts approve @240xu/trivium，否则 vendor 二进制不会下载。
sh scripts/install-termux.sh
trivium agent doctor
trivium agent setup --yes
# 或一步完成：./install-termux.sh --setup-agents# zen 免费层（零成本）
trivium provider add zen \
--kind chat --name "OpenCode Zen (free)" \
--base-url https://opencode.ai/zen/v1 \
--model deepseek-v4-flash-free --model mimo-v2.5-free
# 免费层无需 apiKey；也可以直接 `--preset opencode-zen`
# zen-go 付费层（用便宜模型，默认 deepseek-v4-flash，并开 deepseek 缓存模式）
trivium provider add zen-go \
--kind chat --name "zen-go" \
--base-url https://opencode.ai/zen/go/v1 \
--model deepseek-v4-flash
trivium provider update zen-go --default-model deepseek-v4-flash
# 缓存模式在配置文件 ~/.codex/xu-chat-providers.json 的 options.cacheMode 设置：
# "options": { "baseURL": "https://opencode.ai/zen/go/v1", "apiKey": "...", "cacheMode": "deepseek" }
# 测试连通并应用到三端
trivium test zen
trivium use zen --target opencode
trivium use zen --target claude # 需要 trivium serve 运行
trivium use zen --target codex # 需要 trivium serve 运行应用方式：OpenCode 直写 opencode.json；Claude / Codex 按需直连或走本地 trivium serve 路由（多供应商或跨协议时必走）。
trivium # 打开 TUI
trivium list # 列出供应商
trivium current opencode # 查看目标当前供应商
trivium use zen --target codex --dry-run # 预览切换（不写文件）
trivium test zen # 测试连通（显式请求才发起网络请求）
trivium doctor # 路径与环境诊断
trivium provider preset list # 内置模板（19 个：openai/deepseek/gemini/glm/qwen/…）
trivium provider add myid --preset openrouter --api-key sk-...
trivium provider models zen # 拉取 /models 列表
trivium provider models zen --apply --yes # 写回供应商配置
trivium provider update zen --default-model model-a
trivium provider show zen # 查看（密钥脱敏）
trivium provider export # 导出（默认脱敏，--include-secrets 才含密钥）
trivium provider import ./providers.json --replace
trivium provider delete zen --yes
trivium provider sync-opencode # 从 opencode.json 导入供应商
trivium agent doctor # 诊断三端环境
trivium agent status --latest # 版本与更新状态
trivium agent install all --yes # 安装/更新三端
trivium opencode permission allow|ask|deny # OpenCode 全局权限
trivium mcp list / mcp add / mcp enable|disable / mcp import / mcp apply / mcp delete
trivium prompt list / add / edit / import / activate / deactivate / delete
trivium skill list / import / enable|disable / verify / install-zip / install-github / update / uninstall
trivium project list / create / capture / plan / switch / rename / delete
trivium session list / delete
trivium backup list / show / restore / prune --keep 5 --yes
trivium runtime status|start|stop # 本地协议服务守护进程管理
trivium serve # 前台运行本地协议服务（127.0.0.1:9316）
trivium config path # 显示所有配置文件路径多数写入类命令默认 dry-run 预览，需显式
--yes才真正写盘；写前自动备份（*.xu.<时间戳>.bak，0600 权限），失败自动回滚。
问：Claude Code 一直要求登录？
答：应用 Claude 时 trivium 写的是 ANTHROPIC_AUTH_TOKEN（空 key 供应商用占位 local-proxy 跳过登录门禁，有 key 则写真实 key），不写 ANTHROPIC_API_KEY。若仍要求登录，检查 ~/.claude/settings.json 的 env 是否被外部覆盖，或运行 trivium agent doctor 看是否有 ANTHROPIC_* 环境变量残留。
问：/compact 报 400？
答：/compact 是 Claude Code 命令，报错通常来自上游接口（限流/参数不支持）。trivium 会把上游返回的 error.message 原样透传——看报错正文是哪个上游、什么原因，而非 trivium 本身故障。
问：模型不被识别（"cannot map model … to a configured provider"）？
答：路由按 <模型名>_<供应商id> 格式映射（如 deepseek-v4-flash-free_zen），或单供应商时直传模型名。模型名必须是供应商 models 里配置过的；[1m]/[1M] 上下文后缀会被自动剥离。三端里改模型请用 trivium 应用过的模型名，或运行 trivium provider models <id> --apply --yes 拉取最新列表。
问：runit 服务怎么管理？
sv status spec-serve
sv up spec-serve # 启动
sv down spec-serve # 停止
sv restart spec-serve # 重启（改配置后）服务日志：/data/data/com.termux/files/usr/var/log/spec-serve.err。也可以不用 runit，直接 trivium runtime start（写 pidfile 的后台守护）。
问：密钥安全？
答：dry-run diff、trivium provider show、trivium provider export 均默认脱敏密钥；导出需显式 --include-secrets。TUI 导出永远脱敏。
- TERMUX_DSH_PATCHING.md — DSH Termux 兼容补丁链：18 项补丁的锚点/标记/恢复方式、
spec doctor漂移检测、dsh web 原生运维、已知故障模式速查 - RELEASE_RUNBOOK.md — GitHub Release + npm 发版手册：版本三层解耦、资产契约、缓存破坏位、E2E 验证、Git Data API 推送降级
cargo fmt --check
cargo test
cargo clippy --all-targets -- -D warnings
sh scripts/package.sh # 产物在 dist/详细使用指南见 docs/USER_GUIDE.md。
- 每次请求自动记录 input/output/cached tokens（
~/.codex/stats/tokens-YYYY-MM-DD.jsonl） - 统计页展示 24h / 48h / 7d / 30d 四档位 + 缓存命中率
- 右下角标记「⚠ passthrough 直通流量为近似统计」（同协议直通流式的 usage 为尽力扫描）
- 查询：
GET /api/stats/tokens?period=24h|48h|7d|30d（本地）
trivium sync skills <源> <目标...> [--dry-run]：Skill 任意源→目标镜像（opencode/claude/codex，零转换）trivium sync mcp <源> <目标...> [--dry-run]：MCP 全部 server 跨端同步（command/env/headers/type 自动转换）- TUI「同步」页：选源 → 多选目标 → 预览 diff → 执行
trivium snapshot save|list|switch|delete|overwrite（project为兼容别名）- 捕获「供应商配置 + MCP + Skill + 提示词」整套状态，一键切换；旧
xu-projects.json自动迁移到xu-snapshots.json
- 顶部 Tab 导航：供应商 / 统计 / 同步 / 快照 / 运行时 / 工具（按钮式，鼠标/触摸/键盘均可用）
- 搜索框（圆角线框 + ⌕ 实时过滤）、卡片列表、单·多供应商分开选择
- 更新入口：仅在检测到新版本时显示「更新 xxx」