cosh-ng 配置
先使用默认值启动。交互式设置使用 /auth、/mode 和 /config language；需要持久化或共享设置时再编辑 TOML。
文件与权限
| 文件 | 读取者 | 作用域 |
|---|---|---|
/etc/copilot-shell/config.toml | cosh-core 和审计 | 管理员默认值 |
~/.copilot-shell/config.toml | cosh-core 和 cosh-shell | 用户设置 |
<workspace>/.copilot-shell/config.toml | cosh-core | 项目运行偏好 |
Core 按系统 → 用户 → 项目的顺序合并配置。项目配置可以设置 Agent、Skill、会话、active_model 和回答语言偏好，但会忽略 active_provider、Provider 定义、MCP server、Hook 定义、agent.approval_mode、agent.allowed_tools 和项目审计设置。cosh-shell 只读取用户文件，不读取系统或项目文件。
最小用户配置
[ai]
active_provider = "dashscope"
active_model = "qwen3.7-plus"
output_language = "en"
[ai.providers.dashscope]
type = "dashscope"
base_url = "https://dashscope.aliyuncs.com/compatible-mode/v1"
api_key = "${DASHSCOPE_API_KEY}"
model = "qwen3.7-plus"
[agent]
approval_mode = "recommend"
max_turns = 50
max_tool_calls_per_turn = 10
[skills]
custom_paths = ["~/team-skills"]
[session]
auto_persist = true
persist_dir = "~/.copilot-shell/cosh-core/sessions"
[logging]
level = "info"
[ui]
language = "auto"
[shell]
default = "auto"
integration = "enhanced"
login_identity = true
adapter_default = "cosh-core"
analysis_mode = "smart"
approval_mode = "auto"
status_symbols = false
优先使用环境变量或 /auth，不要把原始 secret 写入 TOML。Provider 选择见 Providers。
审批与轮次预算
Core 审批模式适用于直接集成：
| 模式 | ReadOnly | FileEdit | Shell、network、MCP、external |
|---|---|---|---|
trust | 执行 | 执行 | 执行 |
auto | 执行 | 执行 | 询问 |
recommend | 执行 | 询问 | 询问 |
Core 和 Shell 统一使用 recommend、auto 和 trust。已有的 balanced、
suggest 和 strict 会按 recommend 读取；非法配置值也会回退到
recommend。agent.max_turns 限制一次 Agent 请求（默认 50），
max_tool_calls_per_turn 默认 10。每次新 prompt 都会重新开始轮次预算。
会话与压缩
[session]
auto_persist = true
persist_dir = "~/.copilot-shell/cosh-core/sessions"
[session.compaction]
enabled = true
auto = true
trigger_ratio = 0.70
emergency_ratio = 0.90
target_ratio = 0.30
preserve_recent_runs = 2
# auto_compact_token_limit = 89600
# model_context_window = 128000
# model_max_output_tokens = 8192
保持 target_ratio <= trigger_ratio <= emergency_ratio。压缩只改变模型可见的历史，持久化的完整 transcript 不变。设置 auto_persist = false 可关闭该进程的会话恢复。
MCP 与其他可选部分
MCP client 只能定义在系统或用户配置中。每个 server 使用 command（stdio）或 url（Streamable HTTP）之一；省略 allowed_tools 表示全部工具，[] 表示不暴露工具。示例、OAuth 和生命周期命令见接入 MCP server。
只添加实际需要的 Shell 建议和健康检查：
[shell.recommendations]
enabled = true
bash_history = false
[health]
enabled = true
role = "web-server"
critical_mounts = ["/", "/var"]
[[health.services]]
name = "nginx"
expected = "active"
integration 支持 native 和 enhanced。默认的 Enhanced 从 Assisted
模式启动，提供基于 marker 的 Agent 路由和命令事件。在空提示符按
Shift+Tab 可在 Assisted 与 Shell-only 之间切换。Shell-only 保留
命令事件和执行后洞察，但把普通输入交给 bash 或 zsh。Native 把输入、Shell
选项、trap 和启动文件完全交给 bash 或 zsh，不进行 Cosh 观察，也不提供洞察。
cosh 在启动时读取集成值，修改后需要新建会话；非法值会显示错误并拒绝启动。
status_symbols 默认为 false。设为 true（或单次会话使用
COSH_SHELL_STATUS_SYMBOLS=1）后，每个 Enhanced 提示符上方会显示
◇ （Assisted）或 ◌ （Shell-only）状态行。Native 会话不显示状态符号。
该值在启动时读取；非法值回退为 false。
analysis_mode 支持 smart、auto、manual；Shell 审批支持 recommend、
auto、trust。health.services.expected 支持 active 或 inactive。
login_identity（默认 true）让交互式 Enhanced 登录 shell 拥有真实的 login
身份：内层 bash 以登录 shell 启动（shopt -q login_shell == yes），像 bash -l 一样读取 /etc/profile 和 ~/.bash_profile。设 login_identity = false
可回退到旧的非 login 启动（--rcfile）。Bash 4 及以上版本在有界的真实启动能力
探测通过时走真实 login 身份路径；Bash 3.2（包括 macOS 系统 Bash）、探测失败，或父环境导出了
POSIX 启动无法导入的函数名时都会自动回退。fallback marker 仍只读取一次 login profile。
Enhanced Bash login 会在 login profile 和首轮用户 PROMPT_COMMAND hook 执行后、
第一个 Cosh prompt 边界前，一次性记录最终 PATH。该值只传给 Provider 子进程，不会
修改 Cosh 进程的全局 PATH。报告缺失、格式错误、超长、身份伪造或到达过晚时，Provider
继续使用继承 PATH。设置 COSH_SHELL_BOOTSTRAP_PATH=0 会同时关闭旧 PATH 探针和
这条 Bash 启动 PATH 交接；zsh 与 Bash non-login 的其他探针行为不变。
登录升级提示
登录时，cosh-shell 会在后台检查托管安装的 cosh-ng 是否有可用更新，并在发现更新时显示提示。该检查默认开启。将 COSH_SHELL_UPGRADE_CHECK 设为 off、0、false 或 no（不区分大小写），可在下一次会话禁用检查。设置 COSH_SHELL_UPGRADE_CHECK_CACHE 可覆盖缓存文件路径；默认路径为 ~/.copilot-shell/cosh/upgrade-check.json。
如果 cosh-ng 由 anolisa 以 system 作用域、默认 raw 后端安装，只有 root 会话会显示升级提示。普通用户无法执行 system 作用域的更新检查（需要写入 /var/cache/anolisa），因此不会看到提示。如需手动检查，请运行 sudo anolisa --install-mode system update cosh-ng --dry-run。RPM 后端安装不受影响。
日志
[logging].level 同时设置 cosh-shell 与 cosh-core 的日志过滤级别
（默认 info）。解析顺序为：
- 环境变量
COSH_LOG - 环境变量
RUST_LOG [logging].level
[ui].log_level 仍被接受，作为存量配置的兼容别名；两者同时设置时
[logging].level 优先。级别仍为默认 info 时，[ui].debug = true 会把
有效级别提升为 debug。
取值是 tracing EnvFilter 表达式，支持按模块控制：例如
COSH_LOG=cosh_core=debug 只打开 cosh-core 的 debug 记录。
日志写入 ~/.copilot-shell/logs/ 下的 cosh-shell.log.<日期> 与
cosh-core.log.<日期>；目录不可写时降级输出到 stderr。保留策略为今天
加前两个 UTC 日期，且两个组件共享每用户 20 MiB 预算；预算耗尽后该进程
停止写日志（stderr 有提示），删除旧日志并重启会话后恢复。
审计设置
系统文件包含 [audit] 表时，以系统设置为准；否则使用用户设置。项目审计表会被忽略。
[audit]
mode = "best_effort" # best_effort | required
retention_days = 30
max_disk_bytes = 1073741824
retention_days 和 max_disk_bytes 必须大于零。存储根目录默认为 $XDG_STATE_HOME/cosh/audit 或 ~/.local/state/cosh/audit；设置绝对路径的 COSH_AUDIT_DIR 可以覆盖它。
遥测 opt-out
cosh-ng 会采集匿名的运营指标以改进服务质量，包括工具调用次数、Token 用量、审批统计、操作系统类型/架构，以及用于跨会话关联的持久化 installation UUID。不会采集用户 prompt、代码内容或对话内容。
遥测默认开启。要为当前用户关闭遥测，创建用户级哨兵文件：
mkdir -p ~/.copilot-shell
touch ~/.copilot-shell/telemetry_disabled
系统管理员可以通过创建系统级哨兵文件，为整台机器上的所有用户关闭遥测：
sudo mkdir -p /etc/anolisa
sudo touch /etc/anolisa/.telemetry_disabled
任一哨兵文件创建后立即对运行中的进程生效，无需重启。
环境变量覆盖
| 变量 | 作用 |
|---|---|
COSH_AI_PROVIDER、COSH_MODEL、COSH_OUTPUT_LANGUAGE | Core Provider、模型和回答语言 |
COSH_APPROVAL_MODE、COSH_MAX_TURNS | Core 审批和单次请求轮次预算 |
DASHSCOPE_API_KEY、OPENAI_API_KEY、OPENAI_BASE_URL | OpenAI-compatible 凭据和 URL 回退 |
ALIBABA_CLOUD_ACCESS_KEY_ID、ALIBABA_CLOUD_ACCESS_KEY_SECRET、ALIBABA_CLOUD_SECURITY_TOKEN | Aliyun 凭据回退 |
COSH_SHELL_DEFAULT_SHELL、COSH_SHELL_ADAPTER、COSH_SHELL_ANALYSIS_MODE、COSH_SHELL_APPROVAL_MODE | 交互式 Shell 选择 |
COSH_SHELL_INTEGRATION | 下一次会话使用 native 或 enhanced Shell 集成 |
COSH_SHELL_LOGIN_IDENTITY | 下一次 Enhanced 登录 shell 是否启用真实 login 身份，on/off（默认 on） |
COSH_SHELL_BOOTSTRAP_PATH | 设为 0 可关闭启动 PATH 探测和 Bash login PATH 交接 |
COSH_SHELL_LANG、COSH_SHELL_AI、COSH_SHELL_INPUT_WAIT_TIMEOUT_SECS | Shell 语言、AI 开关和输入等待超时 |
COSH_SHELL_UPGRADE_CHECK | 登录升级提示检查；默认开启，设为 off、0、false 或 no 可禁用 |
COSH_SHELL_UPGRADE_CHECK_CACHE | 覆盖登录升级提示缓存路径（默认 ~/.copilot-shell/cosh/upgrade-check.json） |
COSH_RECOMMENDATIONS_BASH_HISTORY | 允许使用 Bash history 生成建议 |
COSH_LOG、RUST_LOG | 日志过滤（COSH_LOG 优先） |
COSH_AUDIT_DIR | 审计存储根目录 |
相关二进制支持时，环境变量优先于配置文件。日志在 ~/.copilot-shell/logs/ 下按日轮转，保留策略见日志。