如何使用cosh升級版

本文介紹如何在 Alibaba Cloud Linux 4 Agentic Edition（ANOLISA）中切換到 cosh 升級版，並完成配置，開始使用。cosh 升級版完全相容 bash/zsh，在不改變原有終端習慣的前提下，引入 Agent 能力，提供命令自動診斷、自然語言營運、以及可擴充的外掛程式機制。

cosh（Computable Operating System Harness）是面向 AI Agent 的確定性作業系統介面，也是 copilot-shell 的升級替代版本。它提供 AI 增強互動式終端和結構化系統操作 CLI，讓使用者在終端中直接獲得 AI 分析、工具審批和智能建議。

安裝

cosh 升級版通過 cosh-ng RPM 包提供，與 copilot-shell 互斥（不可同時安裝）。可以使用以下命令進行安裝或替換。

說明

cosh-ng 作為 copilot-shell 的下一代升級版本，仍處於活躍開發狀態。可以隨時通過 cosh-switch 命令切換。

# 全新安裝，確保 copilot-shell 未安裝
sudo yum install cosh-ng

# 已有 copilot-shell 使用者切換
cosh-switch

安裝後提供以下命令：

命令	說明
`cosh`	主入口，啟動 AI 互動式終端
`cosh-cli`	結構化 JSON CLI（包管理、服務管理、工作區快照、安全審計）
`cosh-switch`	在 cosh-ng 與 copilot-shell 之間切換

注意安裝後 cosh 將會被註冊到 /etc/shells，可通過 chsh 手動設為使用者登入 shell。

從 copilot-shell 遷移

兩者共用設定檔和目錄結構，遷移對使用者透明：

專案	說明
設定檔	共用 `~/.copilot-shell/config.toml`，無需遷移
日誌目錄	共用 `~/.copilot-shell/logs/`
專案級配置	共用 `.copilot-shell/config.toml`
系統級配置	共用 `/etc/copilot-shell/config.toml`

切換命令底層通過 yum swap 實現 RPM 包替換，切換後重新開啟終端即可生效。

快速開始

啟動互動式終端

# 最常用的方式：直接輸入 cosh
cosh

# 指定底層 shell
cosh --shell zsh

# 直通模式：執行單條命令後退出
cosh -c 'ls -la'
cosh -- git status

# 登入 shell 模式
cosh --login

# 隔離模式（跳過使用者 ~/.bashrc 等）
cosh --isolated

啟動後即進入原生 bash/zsh 終端，正常執行 shell 命令的同時，cosh-ng 會在後台提供 AI 分析和工具審批能力。

使用 cosh-cli 進行結構化操作

# 包管理
cosh-cli pkg install nginx
cosh-cli pkg search "web server"
cosh-cli pkg remove nginx --dry-run

# 服務管理
cosh-cli svc status nginx
cosh-cli svc restart nginx --dry-run

# 工作區快照
cosh-cli checkpoint create --workspace ./project --id step-001 -m "safe point"
cosh-cli checkpoint restore step-001 --workspace ./project
cosh-cli checkpoint list --workspace ./project

# 安全審計
cosh-cli audit check --action "rm -rf /var/log"
cosh-cli audit policy show

所有 cosh-cli 命令輸出 JSON 格式，支援 --dry-run 預覽。

Slash 命令

在互動式終端中輸入以 / 開頭的命令可觸發內建控制功能。輸入 /help 查看當前可用命令列表。

配置與語言

命令	說明
`/help`	顯示可用命令協助
`/config`	查看當前配置
`/config language auto`	設定語言為自動檢測
`/config language zh-CN`	設定語言為中文
`/config language en-US`	設定語言為英文

模式切換

命令	說明
`/mode approval recommend`	審批模式：AI 建議，每次需使用者確認
`/mode approval auto`	審批模式：唯讀操作自動，寫操作需審批
`/mode approval trust`	審批模式：全部自動執行
`/mode analysis smart`	分析模式：根據命令類型自動決策是否分析
`/mode analysis auto`	分析模式：每次命令執行後自動分析
`/mode analysis manual`	分析模式：不自動分析，需手動觸發

Hook 管理

命令	說明
`/hooks`	查看 Hook 狀態（登入數量、來源、啟禁用情況）
`/hooks enable <name>`	啟用指定 Hook
`/hooks disable <name>`	禁用指定 Hook

當 Hook 產生髮現時，終端會渲染提示卡片，卡片內提供 analyze、ignore、details 等操作鏈結接，無需手動輸入。

擴充與技能管理

命令	說明
`/extensions`	列出所有擴充
`/extensions detail <name>`	查看擴充詳情
`/extensions enable <name>`	啟用擴充
`/extensions disable <name>`	禁用擴充
`/skills`	列出所有技能
`/skills detail <name>`	查看技能詳情
`/skills enable <name>`	啟用技能
`/skills disable <name>`	禁用技能

其他命令

命令	說明
`/auth`	觸發認證流程
`/debug session`	顯示會話調試資訊

配置

設定檔位於 ~/.copilot-shell/config.toml，初次開機時自動建立預設配置。

[shell]
# 預設 shell：auto | bash | zsh
default = "auto"
# 分析模式：smart | auto | manual
analysis_mode = "smart"
# 審批模式：recommend | auto | trust
approval_mode = "auto"

[ai]
# 活躍模型
active_model = "qwen-plus"

[ai.providers.dashscope]
type = "dashscope"
api_key = ""    # 或通過環境變數 DASHSCOPE_API_KEY
model = "qwen-plus"

配置優先順序

.copilot-shell/config.toml（專案級，目前的目錄）
~/.copilot-shell/config.toml（使用者級）
/etc/copilot-shell/config.toml（系統級）

常用環境變數

環境變數	說明
`DASHSCOPE_API_KEY`	DashScope API Key
`ALIBABA_CLOUD_ACCESS_KEY_ID`	阿里雲 AK
`ALIBABA_CLOUD_ACCESS_KEY_SECRET`	阿里雲 SK
`COSH_MODEL`	覆蓋活躍模型
`COSH_SHELL_ADAPTER`	覆蓋預設適配器
`COSH_SHELL_LANG`	覆蓋 UI 語言
`COSH_LOG`	全域記錄層級