SAI(Shell AI Agent) 使用说明

Shell AI Agent 使用说明

1. 简介

sai（Shell AI Agent） 是一个运行在终端里的 AI 任务执行助手。它把大语言模型（LLM）的能力与本地 Shell 工具打通，让你用一句自然语言，就能让 AI 直接在你的机器上执行命令、生成项目、修改文件。

轻量零依赖：单二进制，纯 Go 标准库实现，开箱即用
本地优先：默认对接本地 Ollama 服务，数据不出内网
跨平台：支持 Linux / macOS / Windows，自动适配 bash / PowerShell
安全可控：内置危险命令黑名单、执行超时、工作目录限制
会话持久化：支持保存/恢复工作进度，下次接着干

一句话：把"我想做某事"变成"机器已经做完某事"。

2. 使用方法

2.1 安装

bash 复制代码

git clone https://github.com/rimke/sai.git
make build

2.2 配置

运行参数配置文件为 /etc/sai/config.yaml，配置文件格式如下：

yaml 复制代码

# sai 项目配置文件
ollama:
  # Ollama 服务地址，不写死代码中，便于切换环境
  base_url: "http://127.0.0.1:11434"
  # 默认模型名称
  model: ""
  # 单次请求超时（秒）
  timeout: 300

agent:
  # Agent 核心循环最大步数，防止死循环
  max_steps: 10

配置说明：

字段	说明	默认值
ollama.base_url	Ollama	服务地址 http://127.0.0.1:11434
ollama.model	默认模型名称
ollama.timeout	单次请求超时（秒）	300
agent.max_steps	Agent	单次任务最大循环步数

2.3 运行

2.3.1 保存当前工作会话

shell 复制代码

# 保存当前工作会话，下次加载直接进入上次保存的工作进度
sai -cmd save

2.3.2 发送任务

shell 复制代码

# 发送任务到服务器
sai -t "生成一个go项目"

# 或
sai -text "生成一个go项目"

# 或
echo "生成一个go项目" | sai

2.3.3 指定模型

shell 复制代码

# 指定模型名称
sai -t "生成一个go项目" -m "chatglm2"

# 或
sai -text "生成一个go项目" -model "chatglm2"

# 或
echo "生成一个go项目" | sai -model "chatglm2"

常用参数速查

参数简写说明

-text -t 直接传入任务描述

-model -m 指定本次使用的模型

-cmd --- 执行子命令，如 save
安全提示

参数	简写	说明
-text	-t	直接传入任务描述
-model	-m	指定本次使用的模型
-cmd	---	执行子命令，如 save

Agent 会真实执行 Shell 命令，请在使用前确认任务描述准确

内置黑名单仅作第一层防护，无法覆盖所有攻击面

建议先在测试目录或容器中试用，确认行为符合预期后再用于生产

开发者

来源： Etsoftware

开发：半条虫(466814195)

Email： rimke@163.com

反馈与贡献

仓库：https://github.com/rimke/sai

下载
linux:
https://download.csdn.net/download/rimke/93517668
windows:
https://download.csdn.net/download/rimke/93517667

sai windows演示视频

android:

https://download.csdn.net/download/rimke/93517666

sai