革命性的本地AI Agent平台，通过配置文件驱动实现AI能力本地化、可迁移、可版本控制，支持MCP协议和双层架构设计。
一分钟了解#
HyperChat是首个实现"AI as Code"理念的本地AI Agent平台，让每个项目都拥有专属AI大脑。它通过配置文件驱动的方式，实现AI能力的本地化、可迁移和版本控制，彻底告别云端依赖，为开发者提供真正属于项目级的AI专家。
核心价值：完全本地化的项目级AI助手，支持工作区管理和Agent命令自定义，实现AI能力的版本控制和团队协作。
快速上手#
安装难度：中 - 需要Node.js环境和npm安装，同时支持CLI和Web两种使用模式
# 全局安装
npm install -g @dadigua/hyperchat
# 或直接运行
npx -y @dadigua/hyperchat
适合我的场景吗？
- ✅ 项目开发：为每个项目提供专属AI助手，理解项目上下文和业务领域
- ✅ 团队协作：通过工作区管理实现团队AI最佳实践共享
- ✅ 代码任务：支持文件系统操作、代码审查、优化等专业任务
- ❌ 简单聊天：如果只需要基础AI对话，这可能是过度设计的解决方案
- ❌ 云服务需求：如果需要云端访问和远程协作，本项目完全本地化特性可能不符合需求
核心能力#
1. 双层架构设计 - 灵活适应不同场景#
- 提供Web多工作区模式和CLI Agent优先模式，根据使用场景优化用户体验
- Web模式适合项目开发和团队协作，CLI模式适合快速对话和脚本集成 实际价值：无论你是需要图形界面的项目协作，还是命令行快速交互，都能获得最佳体验
2. AI as Code - 配置即版本控制#
- 所有AI能力通过
.hyperchat/配置目录进行管理 - 完全支持Git版本控制，实现AI能力的迁移和团队共享 实际价值：AI配置随项目一起版本化，团队可以共享AI最佳实践，项目迁移时AI能力同步转移
3. Agent记忆与上下文#
- AI Agent能够理解并记住项目上下文和交流历史
- 每个Agent都有独立的记忆系统和上下文管理 实际价值：无需重复解释项目背景，Agent能持续理解你的项目特点和需求，提供连贯的专业建议
4. MCP协议深度集成#
- 通过MCP协议支持直接操作本地文件系统
- 支持文件分析、代码修改、项目结构理解等复杂操作 实际价值：AI助手可以真正理解并操作你的代码，而不是仅提供理论建议
5. 多文件引用功能#
- 智能识别多个文件引用，支持复杂文件操作和比较 实际价值：可以一次性分析项目中多个相关文件，提供更全面的代码分析和优化建议
6. Agent自定义命令系统#
- Markdown模板驱动的快捷命令系统，预定义专业提示词 实际价值：一键触发专业AI任务，如代码审查、bug修复、性能优化等，大幅提高开发效率
技术栈与集成#
开发语言：TypeScript, JavaScript 主要依赖：React, Node.js, Electron 集成方式：CLI工具 / Web应用 / 桌面应用
生态与扩展#
- 配置系统：基于YAML的Agent配置，支持自定义记忆和提示词
- 插件系统：通过MCP协议实现工具扩展，支持文件系统、Git、npm等
- 命令扩展：Agent自定义命令系统，支持Markdown模板定义专业任务
维护状态#
- 开发活跃度：项目正从1.0迁移到2.0，欢迎使用AI工具共同开发
- 最近更新：近期有活跃的开发活动，正在实现新功能如多文件引用和Agent自定义命令
- 社区响应：拥有Telegram和QQ群社区，保持用户交流和反馈
文档与学习资源#
- 文档质量：全面，包含详细的中文文档和使用示例
- 官方文档：项目README中包含完整的使用指南和架构说明
- 示例代码：提供丰富的使用示例和配置模板