utils — 横切基础设施
| 文件 | 说明 |
|---|---|
fsar_config.py |
FsarConfig：统一配置加载与原子写入（fsar.yaml 唯一访问器）。 |
config.py |
已弃用的薄壳，转发到 FsarConfig。 |
fsar_home.py |
get_fsar_home()：$FSAR_HOME 或 ~/.fsar。 |
llm_factory.py |
共享 LLM 客户端工厂：客户端构造、连接/读取超时、提供商 prompt-cache 标记，以及用量口径归一。 |
anthropic_cache.py / gemini_cache.py |
Anthropic prompt-cache / Gemini cachedContents provider 侧缓存。llm_cache.db 只存它们的记账——本地没有响应缓存。 |
responses_compat.py |
OpenAI Chat 与 Responses API 形状互转。 |
render.py |
CLI 的 Rich 终端渲染。 |
migrate.py + migrations/ |
把仓库内 config/data 迁入 FSAR home；带日期的 schema 迁移。 |
version.py |
从 HEAD 的 git tag 解析应用版本，回退到 pyproject.toml；解析频道、比较版本。 |
源文件 docs-public/modules/utils.md在 GitHub 上查看 ↗