HyperChat：本地 AI Agent 平台

项目简介

HyperChat 是一个本地 AI Agent 平台，主打「AI as Code」理念：AI 能力通过 .hyperchat/ 配置目录定义，可随项目一起迁移、用 Git 做版本控制，聊天记录与项目上下文都保存在本地。项目使用 TypeScript 编写，采用双层架构——Web 多工作区模式面向项目级管理与团队协作，CLI Agent 优先模式面向终端里的快速对话与脚本集成。

主要功能

• 完全本地化：数据不出本地，隐私可控。
• Agent 记忆：AI Agent 能理解并记住项目上下文。
• 配置即代码：Agent、MCP 服务、模型配置全部以文件形式保存，可纳入 Git 管理、一键迁移。
• MCP 协议集成：可接入 MCP 工具，直接操作本地文件系统。
• 多 @ 文件路径：一条指令中智能识别多个文件引用，便于对比、分析复杂文件结构。
• Agent 自定义命令：在 commands/ 目录放置 Markdown 模板（用 $ARG 占位），即可生成 /bug-fix、/review 等快捷命令。
• 5 层优先级环境变量：默认值 → process.env → 全局 .env → 工作区 .env → CLI 参数。

双模式架构

功能特性	Web 多工作区模式	CLI Agent 优先模式
设计中心	工作区协作中心	Agent 直接交互
资源管理	工作区统一 MCP 池	Agent 按需启动 MCP
界面风格	现代 Web 界面	命令行 + TUI
主要用途	项目开发、团队协作	快速对话、脚本集成、CI/CD

安装与使用

# 全局安装
npm install -g @dadigua/hyperchat

# 或直接运行
npx -y @dadigua/hyperchat

配置默认模型（环境变量）：

export HyperChat_API_KEY=your-api-key      # API 密钥
export HyperChat_API_URL=your-api-url      # API 端点 URL
export HyperChat_AI_Provider=openai        # openai/claude/gemini/kimi/qwen 等
export HyperChat_AI_Model=gpt-4o           # 默认模型名称

常用命令：

# Web 多工作区界面（默认 http://localhost:16100）
hyperchat serve

# Agent 优先模式
hyperchat agent list                   # 发现可用 Agent
hyperchat agent mybot "你好"           # 直接启动某个 Agent
hyperchat agent mybot chat             # Agent 专属对话会话
hyperchat agent create mybot           # 创建 Agent

# 普通聊天
hyperchat "你好，今天怎么样？"
hyperchat chat                         # 交互式聊天

# 多 @ 文件引用
hyperchat "分析 @./src/index.ts 的代码质量"
hyperchat "对比 @./package.json 和 @./yarn.lock"

# 使用自定义命令
hyperchat agent coder "/bug-fix @./src/login.ts 登录功能异常"

# 工作区
hyperchat workspace create             # 在当前目录创建工作区
hyperchat chat --workspace /path/to/project

Web 服务相关环境变量：

export HYPERCHAT_WEB_PASSWORD=your-web-password   # Web 界面访问密码
export HYPERCHAT_PORT=16100                       # 服务端口
export HYPERCHAT_HOST=localhost                   # 绑定地址
export HYPERCHAT_LANGUAGE=zh                      # 界面语言

本地开发：

git clone https://github.com/BigSweetPotatoStudio/HyperChat.git
cd HyperChat
npm install
cd packages/electron && npm install
cd packages/web && npm install
cd ../..
npm run dev

注意事项

• 需要自备所使用模型服务商的 API Key 与端点，项目本身不包含模型额度。
• 项目处于 1.0 向 2.0 迁移阶段，配置目录结构以文档中的 .hyperchat/ 为准。
• README 推荐的模型提供商为 Claude 与 Kimi k2。
• 项目仅供学习交流使用，使用本项目进行的任何操作与开发者无关。

---

本作品整理自 GitHub 开源项目 BigSweetPotatoStudio/HyperChat，原作者 @BigSweetPotatoStudio。中文介绍由 AI 根据项目 README 整理，以原仓库为准。