---

目录

• 为什么选择 AISH
• 快速开始
• 安装
• 卸载
• 配置
• 使用方式
• 安全与风险控制
• Skills（插件）
• 数据与隐私
• 文档
• 开发与测试
• 贡献
• 许可证

---

为什么选择 AISH

• 真正的交互式 Shell：完整 PTY 支持，可运行 vim / ssh / top 等交互程序
• AI 原生集成：用自然语言描述任务，生成、解释并执行命令
• 安全可控：AI 命令有风险分级与确认流程；可选沙箱预跑做变更评估
• 可扩展：Skills 插件系统，支持热加载与优先级覆盖
• 低迁移成本：兼容常规命令与工作流，默认在终端里完成

---

功能对比

特性	AISH	Claude Code
🎯 核心定位	运维/系统排障 CLI	开发编码助手
🤖 多模型支持	✅ 完全开放	⚠️ 主要 Claude
🔧 子代理系统	✅ ReAct 诊断代理	✅ 多类型代理
🧩 Skills 支持	✅ 热加载	✅
🖥️ 原生终端集成	✅ PTY 完整支持	⚠️ 有限支持
🛡️ 安全风险评估	✅ 安全确认	✅ 安全确认
🌐 本地模型支持	✅ 完全支持	✅ 完全支持
📁 文件操作工具	✅ 核心能力支持	✅ 完整支持
💰 完全免费	✅ 开源	❌ 付费服务
📊 可观测性	✅ Langfuse 可选	⚠️ 内置
🌍 多语言输出	✅ 自动检测	✅

快速开始

1) 安装并启动

方式一：一键安装（推荐）

curl -fsSL https://www.aishell.ai/repo/install.sh | bash

方式二：手动安装二进制 bundle

先从官方发布目录下载对应架构的 aish-<version>-linux-<arch>.tar.gz，然后执行：

tar -xzf aish-<version>-linux-<arch>.tar.gz
cd aish-<version>-linux-<arch>
sudo ./install.sh

然后启动：

aish

说明：aish 无子命令时等价于 aish run。

2) 像普通 Shell 一样用

aish> ls -la
aish> cd /etc
aish> vim hosts

3) 用 AI 做事（首字符输入 ；）

以 ; 或 ； 开头会进入 AI 模式：

aish> ;查找当前目录大于 100M 的文件并按大小排序
aish> ;解释一下这个命令：tar -czf a.tgz ./dir

---

安装

Linux 二进制 Bundle

curl -fsSL https://www.aishell.ai/repo/install.sh | bash

该安装器会解析最新稳定版本，下载与你当前架构匹配的 bundle，并把 aish、aish-sandbox 和 aish-uninstall 安装到 /usr/local/bin。

从源码运行（开发/试用）

cargo run --bin aish

---

卸载

卸载（保留配置文件）：

sudo aish-uninstall

彻底卸载（同时删除系统级安全策略）：

sudo aish-uninstall --purge-config

可选：清理用户级配置（会清空模型/API Key 等）：

rm -rf ~/.config/aish

---

配置

配置文件位置

• 默认：~/.config/aish/config.yaml（如设置了 XDG_CONFIG_HOME，则在 $XDG_CONFIG_HOME/aish/config.yaml）

优先级（从高到低）

1. 命令行参数
2. 环境变量
3. 配置文件

最小配置示例

# ~/.config/aish/config.yaml
model: openai/deepseek-chat
api_base: https://openrouter.ai/api/v1
api_key: your_api_key

也可通过环境变量（更适合放置密钥）：

export AISH_MODEL="openai/deepseek-chat"
export AISH_API_BASE="https://openrouter.ai/api/v1"
export AISH_API_KEY="your_api_key"

提示：LiteLLM 也支持读取特定厂商的环境变量（如 OPENAI_API_KEY、ANTHROPIC_API_KEY）。

交互式配置（可选）：

aish setup

工具调用兼容性检查（确认所选模型/渠道支持 tool calling）：

aish check-tool-support --model openai/deepseek-chat --api-base https://openrouter.ai/api/v1 --api-key your_api_key

Langfuse（可选观测性）：

1. 在配置里打开：

enable_langfuse: true

1. 设置环境变量：

export LANGFUSE_PUBLIC_KEY="..."
export LANGFUSE_SECRET_KEY="..."
export LANGFUSE_HOST="https://cloud.langfuse.com"

aish check-langfuse 会在项目根目录存在 check_langfuse.py 时执行检查。

---

使用方式

常用输入类型

类型	示例	说明
Shell 命令	ls -la、cd /path、git status	直接执行常规命令
AI 请求	;如何查看端口占用、；查找大于100M的文件	以 ;/； 前缀进入 AI 模式
内置命令	help、clear、exit、quit	Shell 内置控制命令
模型切换	/model gpt-4	查看或切换模型

Shell 兼容性（PTY）

aish> ssh user@host
aish> top
aish> vim /etc/hosts

---

安全与风险控制

AI Shell 仅对 AI 生成并准备执行 的命令进行安全评估。

风险分级

• LOW：默认放行
• MEDIUM：执行前确认
• HIGH：默认阻断

安全策略文件路径

策略文件按以下顺序解析：

1. ~/.config/aish/security_policy.yaml（用户级；若不存在会自动生成模板）

沙箱预跑（可选，推荐生产启用）

默认策略 未开启 沙箱预跑。启用方法：

1. 在安全策略中设置：

global:
  enable_sandbox: true

1. 启动特权沙箱服务（systemd）：

sudo systemctl enable --now aish-sandbox.socket

Socket 默认：/run/aish/sandbox.sock。 沙箱不可用时，会按策略里的 sandbox_off_action（BLOCK/CONFIRM/ALLOW）兜底。

---

Skills（插件）

Skills 用于扩展 AI 的专用知识与工作流，支持热加载与覆盖优先级。

默认扫描目录与优先级：

• ~/.config/aish/skills/（或 $AISH_CONFIG_DIR/skills）
• ~/.claude/skills/

---

数据与隐私

本项目会在本地存储以下数据（便于排障与可追溯性）：

• 日志：默认 ~/.config/aish/logs/aish.log
• 会话/历史：默认 ~/.local/share/aish/sessions.db（SQLite）
• 大输出 offload：默认 ~/.local/share/aish/offload/

建议：

• 不要把真实 API Key 提交到仓库；优先使用环境变量或密钥管理系统。
• 生产环境可结合安全策略限制 AI 触达目录范围。

---

文档

• 配置说明：CONFIGURATION.md
• 快速入门：QUICKSTART.md
• 命令纠错机制：docs/command-interaction-correction.md

---

社区与支持

链接	说明
官方网站	项目官网与更多信息
GitHub 仓库	源码与问题反馈
GitHub Issues	Bug 报告
GitHub Discussions	社区讨论
Discord	加入社区
LINUX DO 社区	友链

如果 AISH 对你有帮助，欢迎给项目点一个 Star ⭐
这会帮助更多人发现它，也是我们持续迭代的重要动力。

---

开发与测试

当前仓库已经是使用 Rust 完全重写后的 aish，采用 Cargo workspace 组织，共 14 个 crate。

# 编译
cargo build --release

# 运行测试
cargo test --workspace

# 发布脚本冒烟测试
./packaging/tests/release_scripts_smoke.sh

# 运行
./target/release/aish

# 测试
cargo test

# 代码检查
cargo clippy

架构（14 个 crate）

Crate	说明
aish-core	错误类型、共享枚举（RiskLevel, MemoryCategory 等）
aish-config	YAML 配置加载，支持 XDG 路径和环境变量覆盖
aish-i18n	国际化系统，6 种语言，内嵌 en-US 回退
aish-pty	PTY 执行器，fork/exec、select I/O、输出卸载
aish-llm	OpenAI 兼容 HTTP 客户端，SSE 流式传输，工具调用
aish-session	SQLite 会话持久化，WAL 模式
aish-context	滑动窗口上下文管理，tiktoken token 计数
aish-security	安全策略引擎，glob-to-regex 模式匹配
aish-skills	技能插件发现，notify 热加载
aish-memory	Markdown 长期记忆，相关性评分
aish-tools	内置工具：bash、WebFetch、文件读写编辑、ask_user、memory、skill
aish-scripts	.aish 脚本系统，frontmatter、ai "prompt" 语法、hooks
aish-shell	主 Shell：REPL 循环、AI 处理器、内置命令、动画
aish-cli	CLI 入口，clap derive 宏

---

贡献

请参阅 CONTRIBUTING.md 了解贡献指南。

许可证

LICENSE（Apache 2.0）