HyperChat 中文文档

HyperChat

🌟 本地 AI Agent 平台 - 首创 AI as Code 理念，让每个项目都有专属的 AI 大脑

HyperChat 是一个革命性的本地 AI Agent 平台，通过配置文件驱动的方式，让 AI 能力完全本地化、可迁移、可版本控制。告别云端依赖，拥有真正属于自己的项目级 AI 专家。

🎯 核心特色

• 🏠 完全本地化：数据不出本地，隐私安全可控
• 🧠 Agent记忆：AI Agent 理解并记住你的项目上下文
• 📁 配置即代码：所有 AI 能力通过文件配置，支持 Git 管理
• 🔧 深度工具集成：MCP 协议支持，可直接操作本地文件系统
• 📦 一键迁移：完整的 .hyperchat/ 配置目录，随项目迁移
• 📂 多@文件路径：智能识别多个文件引用，支持复杂文件操作 ✨新功能
• 🎯 Agent自定义命令：Markdown模板驱动的快捷命令系统 ✨新功能

🎯 项目愿景

HyperChat 1.0 是一个完全手工编写的项目，正在迁移到2.0。

HyperChat 2.0 大家一起 Vibe Coding，欢迎使用 Claude Code 和 GitHub Copilot 等 AI 工具一起开发。

🎯 双层架构设计

创新的双模式架构 - 根据不同使用场景优化用户体验

🌐 Web 前端：多工作区协作中心

设计理念：项目级协作，统一资源管理

• 🗂️ 多工作区标签页管理：同时打开多个项目工作区，一键切换
• 👥 团队协作优化：工作区级别的 Agent 集合、MCP 服务池
• 📊 可视化管理界面：图形化配置、实时监控、数据统计
• 💼 适用场景：项目开发、团队协作、工作区管理、可视化操作

💻 CLI 前端：Agent 优先快速交互

设计理念：Agent 中心化，极速启动单个智能体

• ⚡ 快速启动：直接选择 Agent，从工作区按需加载 MCP 工具
• 🎯 专注对话：Agent 专属记忆、上下文、聊天历史
• 🔧 灵活工具链：Agent 内置 MCP 工具，回退到工作区共享资源
• 🚀 适用场景：快速对话、自动化脚本、命令行工作流、CI/CD 集成

📋 架构对比

🚀 快速体验

⌨️ 命令行快速启动

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

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

快速配置环境变量：

# 基础配置 - 设置默认 AI 模型
export HyperChat_API_KEY=your-api-key           # API 密钥
export HyperChat_API_URL=your-api-url           # API 端点 URL
export HyperChat_AI_Provider=openai             # AI 提供商 (openai/claude/gemini/kimi/qwen等)
export HyperChat_AI_Model=gpt-4o                # 默认模型名称

# 然后直接使用
hyperchat "你好，世界！"                        # 使用配置的默认模型

🌐 Web 多工作区模式使用示例

# 启动多工作区 Web 界面
hyperchat serve                        # 访问: http://localhost:16100

# Web 界面功能特色：
# ✅ 多工作区标签页管理
# ✅ 每个标签页独立的 Agent 集合、MCP 服务、聊天记录
# ✅ 可视化配置和实时监控
# ✅ 团队协作和项目管理

💻 CLI Agent 优先模式使用示例

# 🚀 Agent 优先快速启动 - 核心特色
hyperchat agent list                   # 发现可用 Agent（全局 + 工作区）
hyperchat agent mybot "你好"           # 🎯 直接启动 Agent，按需加载 MCP
hyperchat agent mybot chat             # 🎯 Agent 专属对话会话

# 快速 AI 聊天（使用默认 Agent）
hyperchat "你好，今天怎么样？"           # 直接与默认模型聊天
hyperchat chat "写一个 Python 脚本"     # 聊天命令
hyperchat chat                         # 交互式聊天模式

# 📁 智能文件处理 - 多@符号支持 ✨新功能
hyperchat "分析 @./src/index.ts 的代码质量"
hyperchat "对比 @./package.json 和 @./yarn.lock"
hyperchat "请比较 @./src/components/ 和 @./docs/ 的结构"

# 🎯 Agent自定义命令 - 快捷输入专业提示词 ✨新功能
hyperchat agent coder "/bug-fix @./src/login.ts 登录功能异常"
hyperchat agent coder "/review @./src/api/user.js"
hyperchat agent coder "/optimize 这段代码性能不好"

# Agent 管理（在当前工作区或全局）
hyperchat agent create mybot           # 创建新 Agent
hyperchat agent delete mybot           # 删除 Agent

# 工作区管理
hyperchat workspace create             # 在当前目录创建工作区

# 全局选项和工作区指定
hyperchat chat --workspace /path/to/project  # 使用特定工作区
hyperchat --verbose chat "你好"             # 详细日志
hyperchat --help                            # 显示帮助

# CLI 模式优势：
# ⚡ Agent 直接启动，无需切换界面
# 🔧 按需从工作区加载 MCP 工具
# 💾 Agent 专属记忆和聊天历史
# 🚀 适合脚本集成和自动化