AI Companion CLI 是一个终端 AI 聊天应用,支持多轮对话、流式输出、工具调用,以及基于文件的本地持久化。
git clone git@github.com:harmonarch/ai-companion-cli.git
cd ai-companion-cli
npm install
npm run build依赖 Node.js 20+。
在 ~/.config/ai-companion/config.toml 创建配置文件:
defaultProvider = "deepseek"
defaultModel = "deepseek-chat"
[providers.deepseek]
apiKey = "<your-api-key>"所有配置项都可以通过环境变量覆盖:
| 变量 | 说明 |
|---|---|
AI_COMPANION_PROVIDER |
默认 provider(deepseek) |
AI_COMPANION_MODEL |
默认模型 |
AI_COMPANION_STORAGE_PATH |
数据存储路径(默认 ~/.ai-companion) |
AI_COMPANION_HISTORY_MAX_MESSAGES |
上下文消息上限(默认 24) |
AI_COMPANION_MEMORY_ENABLED |
是否启用记忆功能(默认 true) |
DEEPSEEK_API_KEY |
DeepSeek API key |
配置优先级:环境变量 > TOML 配置文件 > 默认值。
npm run dev # 开发模式(tsx 直接运行)
npm run build # 构建
npm run start # 运行构建产物构建后全局安装使用:
npm install -g .
ai-companion进入交互界面后,输入消息即可开始对话。支持以下 slash command:
/new— 新建会话/sessions— 查看会话列表/switch <n|id>— 切换会话/memory— 查看记忆/emotion— 查看情绪状态/profile— 查看 assistant profile/model— 查看当前模型/reset— 重置上下文/help— 查看帮助/exit— 退出
AI 在对话中可调用以下工具:
read_file— 读取文件list_dir— 列出目录search_text— 文本搜索http_fetch— HTTP 请求local_time— 获取本地时间
src/
├── cli.ts # 入口
├── app.tsx # 顶层 UI
├── app/ # 应用组装与输入处理
├── controller/ # 聊天编排、会话管理、slash command
├── graph/ # LangGraph 对话循环
├── tools/ # 工具注册与执行
├── providers/ # AI provider 抽象与实现
├── prompts/ # prompt 模板
├── infra/ # 基础设施(配置、存储)
└── types/ # 类型定义