sayacode 0.3.1

SAYACODE CLI coding assistant

SAYACODE

终端里的 AI 编程搭档。基于 LangChain / LangGraph，接上你常用的模型就能用。聊天、改代码、跑命令、管 Git，都在一个框里搞定。

---

角色风格

SAYACODE 内置了 9 种对话人格：标准、简洁、傲娇、元气、雌小鬼、姐姐、偶像、猫娘、无口。随时用 /style 切换。

---

安装

环境要求：Python >= 3.11

pip install sayacode

源码安装：

git clone https://github.com/saya-ch/sayacode.git
cd sayacode
pip install .

conda 用户：

conda create -n sayacode python=3.12 -y
conda activate sayacode
pip install sayacode

安装完成后，在任意目录执行 sayacode 即可启动。首次运行将进入配置向导，引导完成模型 Provider 和 API Key 的设置，配置自动保存至 ~/.sayacode/。

---

使用

sayacode                          # 交互式对话
sayacode --workspace ./my-project # 指定工作区
sayacode --style catgirl          # 切换角色
sayacode --doctor                 # 自诊断

对话内命令：

命令	说明
/help, /guide, /start	帮助与引导
/status, /workspace, /context	状态与工作区
/model, /mode, /style, /lang	模型 / 模式 / 风格 / 语言
/session, /sessions, /history	会话管理
/tools, /commands, /mcp, /hooks	工具 & 扩展
/doctor, /permissions, /stats	诊断 & 安全
/git, /clear, /compact, /reset	快捷操作
/prefs, /settings, /config, /paths	偏好与配置
/symbols, /analyze	代码分析
/quit	退出

---

模型支持

接口	说明
OpenAI 兼容	GPT-4o 等，以及 Azure、自定义端点
Anthropic 兼容	Claude Opus / Sonnet / Haiku
Gemini	Google Gemini 系列
Ollama	本地运行，免费

---

能力

• 文件：读写、搜索、正则替换、批量编辑
• Shell：执行命令、安全检查、查看环境
• Git：status / diff / add / commit / branch / stash / pull / push
• 项目分析：结构扫描、符号索引、依赖梳理
• MCP 扩展：通过 Model Context Protocol 接外部工具

安全

危险操作（删系统文件、rm -rf /、格式化等）在执行前被硬拦截。密钥和私钥文件默认禁止读取。所有工具调用落审计日志。

---

开发

pip install -e ".[dev]"
pytest tests/ -v

---

License

MIT © SAYACODE Contributors