环境变量
Anyy 优先推荐明确的 CLI Flag 和经过校验的 Profile Config。环境变量适合进程级默认值、无人值守安装、终端兼容和 Credential Reference。
Profile 与 Runtime 解析
| 变量 | 作用 |
|---|---|
ANYY_HOME | 没有更明确 Flag 时，指定 Anyy Home |
ANYY_DEFAULT_HOME | 改变 Profile Manager 以及命名 Profiles 的 Base Home |
ANYY_TIMEZONE | Profile Config 未设置时，提供 IANA Timezone |
TZ | Profile 与 ANYY_TIMEZONE 都未提供有效值时，作为 Host Timezone 来源 |
不同命令的完整优先级略有差异，但显式 --home/--profile 比隐藏在 Shell 中的 Export 更容易排查。最终以 anyy config 显示为准。
不要随意混用路径选择器
Named Profile、--profile-root、Command --home 与 Env Override 混在一起，可能让两个终端访问不同数据。日常使用应固定一种解析方式。
终端显示与兼容
| 变量 | 值 | 作用 |
|---|---|---|
NO_COLOR | 任意非空 | 关闭 CLI/Setup 彩色输出 |
FORCE_COLOR | 任意非空 | 在终端条件允许时强制使用颜色 |
TERM | dumb | 关闭需要较完整终端能力的颜色/Emoji |
ANYY_TUI_SPLASH | 0 | 不显示 TUI Splash |
ANYY_TUI_BRACKETED_PASTE | off | 为不兼容终端关闭 Bracketed Paste |
ANYY_SKIP_VERSION_CHECK | 任意非空 | 跳过 TUI Update Availability Check |
只影响一条命令时，优先使用 --no-color。
托管 Browser 可执行文件
| 变量 | 作用 |
|---|---|
ANYY_CHROME_BIN | 指定托管 Browser Backend 使用的 Chrome/Chromium 路径 |
ANYY_EDGE_BIN | 指定 Microsoft Edge 路径 |
自动发现没有找到目标 Browser 时再设置：
ANYY_CHROME_BIN=/opt/chrome/chrome anyy browser connect --browser chrome --headless --yes
路径必须存在于运行 Anyy 的主机，而不是远程浏览器客户端。
GitHub Skill 来源
| 变量 | 作用 |
|---|---|
GITHUB_TOKEN | 为 Skill 安装时的 GitHub API 请求认证 |
GH_TOKEN | GITHUB_TOKEN 为空时的 Fallback |
Token Scope 应尽量小。不要把 Token 写入 SKILL.md、Prompt、Shell History 或文档示例。
Credential References
受支持的配置字段可以使用 env:NAME 引用环境变量。具体名称由集成决定；Runtime 读取变量，不会把秘密复制进 config.yaml。
只有常驻进程真正继承了该变量，引用才是 Healthy。你在 Interactive Shell 中 export 的值，不会自动进入 System Service。
Installer 变量
| 变量 | 默认 | 用途 |
|---|---|---|
ANYY_HOME | 普通用户 $HOME/.anyy；root /root/.anyy | 选择安装 Home |
VERSION | 最新发布版本 | 固定到确实存在的 Release Tag |
ANYY_INSTALL_COMPACT | 0 | 设置为 1 时减少保留的 Rollback History |
ANYY_RELEASE_BASE_URL | https://anyy.ai/releases | 使用可信兼容的 Release Mirror |
curl -fsSL https://anyy.ai/install.sh | VERSION=v0.1.105 sh
curl -fsSL https://anyy.ai/install.sh | ANYY_INSTALL_COMPACT=1 sh
自定义 Mirror 必须由你控制或已经独立验证，并提供兼容的 Binary 与 Checksum Endpoint。
安全原则
- 长期凭据优先使用 Anyy Secret Storage。
- Env Secret 只应被需要它的 Service/Process 继承。
- 支持请求中不要输出完整 Environment。
- 怀疑泄露时在服务商处轮换。
- 用
anyy config检查 Reference Health，不会显示秘密值。
常见问题
| 现象 | 检查 |
|---|---|
| 打开了错误 Profile | 检查 ANYY_HOME、ANYY_DEFAULT_HOME、Active Profile 与显式 Flags |
| Schedule 时间不对 | 在 Profile Config 或 ANYY_TIMEZONE 设置有效 IANA 名称 |
| TUI Paste 异常 | 尝试 ANYY_TUI_BRACKETED_PASTE=off |
| 找不到 Browser | 在 Anyy 主机设置正确的 ANYY_CHROME_BIN/ANYY_EDGE_BIN |
Gateway 无法解析 env:NAME | 把变量加入常驻 Service Environment，而不只是 Login Shell |
Profile 设置和凭据存储见配置。