Skip to content

About

No description, website, or topics provided.

Resources

Stars

3 stars

Watchers

0 watching

Forks

Repository files navigation

AI Companion CLI

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/                  # 类型定义

About

No description, website, or topics provided.

Resources

Stars

3 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages