[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"similar-BigSweetPotatoStudio--HyperChat":3,"tool-BigSweetPotatoStudio--HyperChat":62},[4,18,26,36,46,54],{"id":5,"name":6,"github_repo":7,"description_zh":8,"stars":9,"difficulty_score":10,"last_commit_at":11,"category_tags":12,"status":17},4358,"openclaw","openclaw\u002Fopenclaw","OpenClaw 是一款专为个人打造的本地化 AI 助手，旨在让你在自己的设备上拥有完全可控的智能伙伴。它打破了传统 AI 助手局限于特定网页或应用的束缚，能够直接接入你日常使用的各类通讯渠道，包括微信、WhatsApp、Telegram、Discord、iMessage 等数十种平台。无论你在哪个聊天软件中发送消息，OpenClaw 都能即时响应，甚至支持在 macOS、iOS 和 Android 设备上进行语音交互，并提供实时的画布渲染功能供你操控。\n\n这款工具主要解决了用户对数据隐私、响应速度以及“始终在线”体验的需求。通过将 AI 部署在本地，用户无需依赖云端服务即可享受快速、私密的智能辅助，真正实现了“你的数据，你做主”。其独特的技术亮点在于强大的网关架构，将控制平面与核心助手分离，确保跨平台通信的流畅性与扩展性。\n\nOpenClaw 非常适合希望构建个性化工作流的技术爱好者、开发者，以及注重隐私保护且不愿被单一生态绑定的普通用户。只要具备基础的终端操作能力（支持 macOS、Linux 及 Windows WSL2），即可通过简单的命令行引导完成部署。如果你渴望拥有一个懂你",349277,3,"2026-04-06T06:32:30",[13,14,15,16],"Agent","开发框架","图像","数据工具","ready",{"id":19,"name":20,"github_repo":21,"description_zh":22,"stars":23,"difficulty_score":10,"last_commit_at":24,"category_tags":25,"status":17},3808,"stable-diffusion-webui","AUTOMATIC1111\u002Fstable-diffusion-webui","stable-diffusion-webui 是一个基于 Gradio 构建的网页版操作界面，旨在让用户能够轻松地在本地运行和使用强大的 Stable Diffusion 图像生成模型。它解决了原始模型依赖命令行、操作门槛高且功能分散的痛点，将复杂的 AI 绘图流程整合进一个直观易用的图形化平台。\n\n无论是希望快速上手的普通创作者、需要精细控制画面细节的设计师，还是想要深入探索模型潜力的开发者与研究人员，都能从中获益。其核心亮点在于极高的功能丰富度：不仅支持文生图、图生图、局部重绘（Inpainting）和外绘（Outpainting）等基础模式，还独创了注意力机制调整、提示词矩阵、负向提示词以及“高清修复”等高级功能。此外，它内置了 GFPGAN 和 CodeFormer 等人脸修复工具，支持多种神经网络放大算法，并允许用户通过插件系统无限扩展能力。即使是显存有限的设备，stable-diffusion-webui 也提供了相应的优化选项，让高质量的 AI 艺术创作变得触手可及。",162132,"2026-04-05T11:01:52",[14,15,13],{"id":27,"name":28,"github_repo":29,"description_zh":30,"stars":31,"difficulty_score":32,"last_commit_at":33,"category_tags":34,"status":17},1381,"everything-claude-code","affaan-m\u002Feverything-claude-code","everything-claude-code 是一套专为 AI 编程助手（如 Claude Code、Codex、Cursor 等）打造的高性能优化系统。它不仅仅是一组配置文件，而是一个经过长期实战打磨的完整框架，旨在解决 AI 代理在实际开发中面临的效率低下、记忆丢失、安全隐患及缺乏持续学习能力等核心痛点。\n\n通过引入技能模块化、直觉增强、记忆持久化机制以及内置的安全扫描功能，everything-claude-code 能显著提升 AI 在复杂任务中的表现，帮助开发者构建更稳定、更智能的生产级 AI 代理。其独特的“研究优先”开发理念和针对 Token 消耗的优化策略，使得模型响应更快、成本更低，同时有效防御潜在的攻击向量。\n\n这套工具特别适合软件开发者、AI 研究人员以及希望深度定制 AI 工作流的技术团队使用。无论您是在构建大型代码库，还是需要 AI 协助进行安全审计与自动化测试，everything-claude-code 都能提供强大的底层支持。作为一个曾荣获 Anthropic 黑客大奖的开源项目，它融合了多语言支持与丰富的实战钩子（hooks），让 AI 真正成长为懂上",158594,2,"2026-04-16T23:34:05",[14,13,35],"语言模型",{"id":37,"name":38,"github_repo":39,"description_zh":40,"stars":41,"difficulty_score":42,"last_commit_at":43,"category_tags":44,"status":17},8272,"opencode","anomalyco\u002Fopencode","OpenCode 是一款开源的 AI 编程助手（Coding Agent），旨在像一位智能搭档一样融入您的开发流程。它不仅仅是一个代码补全插件，而是一个能够理解项目上下文、自主规划任务并执行复杂编码操作的智能体。无论是生成全新功能、重构现有代码，还是排查难以定位的 Bug，OpenCode 都能通过自然语言交互高效完成，显著减少开发者在重复性劳动和上下文切换上的时间消耗。\n\n这款工具专为软件开发者、工程师及技术研究人员设计，特别适合希望利用大模型能力来提升编码效率、加速原型开发或处理遗留代码维护的专业人群。其核心亮点在于完全开源的架构，这意味着用户可以审查代码逻辑、自定义行为策略，甚至私有化部署以保障数据安全，彻底打破了传统闭源 AI 助手的“黑盒”限制。\n\n在技术体验上，OpenCode 提供了灵活的终端界面（Terminal UI）和正在测试中的桌面应用程序，支持 macOS、Windows 及 Linux 全平台。它兼容多种包管理工具，安装便捷，并能无缝集成到现有的开发环境中。无论您是追求极致控制权的资深极客，还是渴望提升产出的独立开发者，OpenCode 都提供了一个透明、可信",144296,1,"2026-04-16T14:50:03",[13,45],"插件",{"id":47,"name":48,"github_repo":49,"description_zh":50,"stars":51,"difficulty_score":32,"last_commit_at":52,"category_tags":53,"status":17},2271,"ComfyUI","Comfy-Org\u002FComfyUI","ComfyUI 是一款功能强大且高度模块化的视觉 AI 引擎，专为设计和执行复杂的 Stable Diffusion 图像生成流程而打造。它摒弃了传统的代码编写模式，采用直观的节点式流程图界面，让用户通过连接不同的功能模块即可构建个性化的生成管线。\n\n这一设计巧妙解决了高级 AI 绘图工作流配置复杂、灵活性不足的痛点。用户无需具备编程背景，也能自由组合模型、调整参数并实时预览效果，轻松实现从基础文生图到多步骤高清修复等各类复杂任务。ComfyUI 拥有极佳的兼容性，不仅支持 Windows、macOS 和 Linux 全平台，还广泛适配 NVIDIA、AMD、Intel 及苹果 Silicon 等多种硬件架构，并率先支持 SDXL、Flux、SD3 等前沿模型。\n\n无论是希望深入探索算法潜力的研究人员和开发者，还是追求极致创作自由度的设计师与资深 AI 绘画爱好者，ComfyUI 都能提供强大的支持。其独特的模块化架构允许社区不断扩展新功能，使其成为当前最灵活、生态最丰富的开源扩散模型工具之一，帮助用户将创意高效转化为现实。",108322,"2026-04-10T11:39:34",[14,15,13],{"id":55,"name":56,"github_repo":57,"description_zh":58,"stars":59,"difficulty_score":32,"last_commit_at":60,"category_tags":61,"status":17},6121,"gemini-cli","google-gemini\u002Fgemini-cli","gemini-cli 是一款由谷歌推出的开源 AI 命令行工具，它将强大的 Gemini 大模型能力直接集成到用户的终端环境中。对于习惯在命令行工作的开发者而言，它提供了一条从输入提示词到获取模型响应的最短路径，无需切换窗口即可享受智能辅助。\n\n这款工具主要解决了开发过程中频繁上下文切换的痛点，让用户能在熟悉的终端界面内直接完成代码理解、生成、调试以及自动化运维任务。无论是查询大型代码库、根据草图生成应用，还是执行复杂的 Git 操作，gemini-cli 都能通过自然语言指令高效处理。\n\n它特别适合广大软件工程师、DevOps 人员及技术研究人员使用。其核心亮点包括支持高达 100 万 token 的超长上下文窗口，具备出色的逻辑推理能力；内置 Google 搜索、文件操作及 Shell 命令执行等实用工具；更独特的是，它支持 MCP（模型上下文协议），允许用户灵活扩展自定义集成，连接如图像生成等外部能力。此外，个人谷歌账号即可享受免费的额度支持，且项目基于 Apache 2.0 协议完全开源，是提升终端工作效率的理想助手。",100752,"2026-04-10T01:20:03",[45,13,15,14],{"id":63,"github_repo":64,"name":65,"description_en":66,"description_zh":67,"ai_summary_zh":68,"readme_en":69,"readme_zh":70,"quickstart_zh":71,"use_case_zh":72,"hero_image_url":73,"owner_login":74,"owner_name":75,"owner_avatar_url":76,"owner_bio":77,"owner_company":78,"owner_location":78,"owner_email":79,"owner_twitter":78,"owner_website":80,"owner_url":81,"languages":82,"stars":107,"forks":108,"last_commit_at":109,"license":110,"difficulty_score":32,"env_os":111,"env_gpu":112,"env_ram":112,"env_deps":113,"category_tags":118,"github_topics":119,"view_count":32,"oss_zip_url":78,"oss_zip_packed_at":78,"status":17,"created_at":126,"updated_at":127,"faqs":128,"releases":164},8237,"BigSweetPotatoStudio\u002FHyperChat","HyperChat","HyperChat is a Chat client that strives for openness, utilizing APIs from various LLMs to achieve the best Chat experience, as well as implementing productivity tools through the MCP protocol.","HyperChat 是一款革命性的本地 AI Agent 平台，旨在为每个开发项目打造专属的\"AI 大脑”。它通过配置文件驱动的方式，将 AI 能力完全本地化，让用户告别对云端的依赖，实现数据不出本地、隐私安全可控的高效协作。\n\nHyperChat 主要解决了传统 AI 工具难以深度理解项目上下文、数据隐私顾虑以及配置难以版本化管理的痛点。它将 AI 设定转化为代码（AI as Code），所有配置均可通过 Git 进行管理和迁移，确保团队成员拥有统一且可追溯的智能助手。此外，基于 MCP 协议，它能直接操作本地文件系统，让 AI 真正具备执行复杂任务的能力。\n\n这款工具特别适合开发者、技术团队及追求数据隐私的研究人员使用。无论是日常代码编写、自动化脚本集成，还是 CI\u002FCD 流程嵌入，HyperChat 都能提供强大支持。其独特的双层架构设计是一大亮点：既提供可视化的 Web 多工作区界面，方便团队协作与项目管理；又提供极速响应的 CLI 命令行模式，支持按需加载 Agent 和智能文件引用（如多@路径分析），完美适配从长期项目开发到临时快速对话的各种场景。通过 HyperChat，","HyperChat 是一款革命性的本地 AI Agent 平台，旨在为每个开发项目打造专属的\"AI 大脑”。它通过配置文件驱动的方式，将 AI 能力完全本地化，让用户告别对云端的依赖，实现数据不出本地、隐私安全可控的高效协作。\n\nHyperChat 主要解决了传统 AI 工具难以深度理解项目上下文、数据隐私顾虑以及配置难以版本化管理的痛点。它将 AI 设定转化为代码（AI as Code），所有配置均可通过 Git 进行管理和迁移，确保团队成员拥有统一且可追溯的智能助手。此外，基于 MCP 协议，它能直接操作本地文件系统，让 AI 真正具备执行复杂任务的能力。\n\n这款工具特别适合开发者、技术团队及追求数据隐私的研究人员使用。无论是日常代码编写、自动化脚本集成，还是 CI\u002FCD 流程嵌入，HyperChat 都能提供强大支持。其独特的双层架构设计是一大亮点：既提供可视化的 Web 多工作区界面，方便团队协作与项目管理；又提供极速响应的 CLI 命令行模式，支持按需加载 Agent 和智能文件引用（如多@路径分析），完美适配从长期项目开发到临时快速对话的各种场景。通过 HyperChat，用户可以轻松拥有随项目迁移、懂业务上下文且安全可靠的私人 AI 专家。","# HyperChat 中文文档\n\n# HyperChat\n\n> 🌟 **本地 AI Agent 平台** - 首创 AI as Code 理念，让每个项目都有专属的 AI 大脑\n\nHyperChat 是一个革命性的**本地 AI Agent 平台**，通过**配置文件驱动**的方式，让 AI 能力完全本地化、可迁移、可版本控制。告别云端依赖，拥有真正属于自己的项目级 AI 专家。\n\n### 🎯 核心特色\n- 🏠 **完全本地化**：数据不出本地，隐私安全可控\n- 🧠 **Agent记忆**：AI Agent 理解并记住你的项目上下文  \n- 📁 **配置即代码**：所有 AI 能力通过文件配置，支持 Git 管理\n- 🔧 **深度工具集成**：MCP 协议支持，可直接操作本地文件系统\n- 📦 **一键迁移**：完整的 `.hyperchat\u002F` 配置目录，随项目迁移\n- 📂 **多@文件路径**：智能识别多个文件引用，支持复杂文件操作 ✨**新功能**\n- 🎯 **Agent自定义命令**：Markdown模板驱动的快捷命令系统 ✨**新功能**\n\n[![Build](https:\u002F\u002Fgithub.com\u002FBigSweetPotatoStudio\u002FHyperChat\u002Factions\u002Fworkflows\u002Fbuild.yml\u002Fbadge.svg)](https:\u002F\u002Fgithub.com\u002FBigSweetPotatoStudio\u002FHyperChat\u002Factions\u002Fworkflows\u002Fbuild.yml)\n[![@dadigua\u002Fhyperchat](https:\u002F\u002Fimg.shields.io\u002Fnpm\u002Fv\u002F%40dadigua%2Fhyperchat)](https:\u002F\u002Fwww.npmjs.com\u002Fpackage\u002F@dadigua\u002Fhyperchat)\n[![npm downloads](https:\u002F\u002Fimg.shields.io\u002Fnpm\u002Fdm\u002F@dadigua\u002Fhyperchat)](https:\u002F\u002Fnpm-stat.com\u002Fcharts.html?package=@dadigua\u002Fhyperchat)\n\n## 🎯 项目愿景\n\n**[HyperChat 1.0](.\u002Farchive\u002FREADME.1.md)** 是一个完全手工编写的项目，正在迁移到2.0。\n\n**HyperChat 2.0** 大家一起 **Vibe Coding**，欢迎使用 Claude Code 和 GitHub Copilot 等 AI 工具一起开发。\n\n## 🎯 双层架构设计\n\n> **创新的双模式架构** - 根据不同使用场景优化用户体验\n\n### 🌐 Web 前端：多工作区协作中心\n**设计理念**：项目级协作，统一资源管理\n\n- **🗂️ 多工作区标签页管理**：同时打开多个项目工作区，一键切换\n- **👥 团队协作优化**：工作区级别的 Agent 集合、MCP 服务池\n- **📊 可视化管理界面**：图形化配置、实时监控、数据统计\n- **💼 适用场景**：项目开发、团队协作、工作区管理、可视化操作\n\n### 💻 CLI 前端：Agent 优先快速交互\n**设计理念**：Agent 中心化，极速启动单个智能体\n\n- **⚡ 快速启动**：直接选择 Agent，从工作区按需加载 MCP 工具\n- **🎯 专注对话**：Agent 专属记忆、上下文、聊天历史\n- **🔧 灵活工具链**：Agent 内置 MCP 工具，回退到工作区共享资源\n- **🚀 适用场景**：快速对话、自动化脚本、命令行工作流、CI\u002FCD 集成\n\n### 📋 架构对比\n\n| 功能特性 | 🌐 Web 多工作区模式 | 💻 CLI Agent 优先模式 |\n|---------|---------------------|----------------------|\n| **核心理念** |\n| 设计中心 | 🗂️ 工作区协作中心 | 🤖 Agent 直接交互 |\n| 资源管理 | 工作区统一 MCP 池 | Agent按需启动MCP |\n| 使用方式 | 多标签页并发管理 | 单 Agent 快速启动 |\n| **界面体验** |\n| 界面风格 | 🖥️ 现代 Web 界面 | 📟 命令行 + 🎨 TUI |\n| 交互模式 | 鼠标点击 + 表单操作 | 键盘输入 + 命令参数 |\n| 实时更新 | ✅ SSE 流式推送 | ✅ 终端流式输出 |\n| **适用场景** |\n| 主要用途 | 项目开发、团队协作 | 快速对话、脚本集成 |\n| 使用环境 | 桌面浏览器、开发 IDE | 终端、服务器、CI\u002FCD |\n| 工作流程 | 长期项目管理 | 临时对话处理 |\n\n## 🚀 快速体验\n\n### ⌨️ 命令行快速启动\n```bash\n# 全局安装\nnpm install -g @dadigua\u002Fhyperchat\n\n# 或直接运行\nnpx -y @dadigua\u002Fhyperchat\n```\n\n**快速配置环境变量**：\n```bash\n# 基础配置 - 设置默认 AI 模型\nexport HyperChat_API_KEY=your-api-key           # API 密钥\nexport HyperChat_API_URL=your-api-url           # API 端点 URL\nexport HyperChat_AI_Provider=openai             # AI 提供商 (openai\u002Fclaude\u002Fgemini\u002Fkimi\u002Fqwen等)\nexport HyperChat_AI_Model=gpt-4o                # 默认模型名称\n\n# 然后直接使用\nhyperchat \"你好，世界！\"                        # 使用配置的默认模型\n```\n\n### 🌐 Web 多工作区模式使用示例\n```bash\n# 启动多工作区 Web 界面\nhyperchat serve                        # 访问: http:\u002F\u002Flocalhost:16100\n\n# Web 界面功能特色：\n# ✅ 多工作区标签页管理\n# ✅ 每个标签页独立的 Agent 集合、MCP 服务、聊天记录\n# ✅ 可视化配置和实时监控\n# ✅ 团队协作和项目管理\n```\n\n### 💻 CLI Agent 优先模式使用示例\n```bash\n# 🚀 Agent 优先快速启动 - 核心特色\nhyperchat agent list                   # 发现可用 Agent（全局 + 工作区）\nhyperchat agent mybot \"你好\"           # 🎯 直接启动 Agent，按需加载 MCP\nhyperchat agent mybot chat             # 🎯 Agent 专属对话会话\n\n# 快速 AI 聊天（使用默认 Agent）\nhyperchat \"你好，今天怎么样？\"           # 直接与默认模型聊天\nhyperchat chat \"写一个 Python 脚本\"     # 聊天命令\nhyperchat chat                         # 交互式聊天模式\n\n# 📁 智能文件处理 - 多@符号支持 ✨新功能\nhyperchat \"分析 @.\u002Fsrc\u002Findex.ts 的代码质量\"\nhyperchat \"对比 @.\u002Fpackage.json 和 @.\u002Fyarn.lock\"\nhyperchat \"请比较 @.\u002Fsrc\u002Fcomponents\u002F 和 @.\u002Fdocs\u002F 的结构\"\n\n# 🎯 Agent自定义命令 - 快捷输入专业提示词 ✨新功能\nhyperchat agent coder \"\u002Fbug-fix @.\u002Fsrc\u002Flogin.ts 登录功能异常\"\nhyperchat agent coder \"\u002Freview @.\u002Fsrc\u002Fapi\u002Fuser.js\"\nhyperchat agent coder \"\u002Foptimize 这段代码性能不好\"\n\n# Agent 管理（在当前工作区或全局）\nhyperchat agent create mybot           # 创建新 Agent\nhyperchat agent delete mybot           # 删除 Agent\n\n# 工作区管理\nhyperchat workspace create             # 在当前目录创建工作区\n\n\n# 全局选项和工作区指定\nhyperchat chat --workspace \u002Fpath\u002Fto\u002Fproject  # 使用特定工作区\nhyperchat --verbose chat \"你好\"             # 详细日志\nhyperchat --help                            # 显示帮助\n\n# CLI 模式优势：\n# ⚡ Agent 直接启动，无需切换界面\n# 🔧 按需从工作区加载 MCP 工具\n# 💾 Agent 专属记忆和聊天历史\n# 🚀 适合脚本集成和自动化\n```\n\n### 🔄 双模式协同工作\n```bash\n# 场景1：开发时 Web\nhyperchat serve                       # 启动 Web 界面管理项目\n\n# 场景2：CI\u002FCD 自动化使用 CLI\nhyperchat agent test-runner \"运行所有测试并生成报告\"\n\n# 场景3：团队协作使用 Web\n# 在 Web 界面中管理多个项目工作区，配置共享的 Agent 和 MCP 服务\n```\n\n\n### 🔧 环境变量配置\n\nHyperChat 2.0 实现了强大的**5层优先级环境变量系统**，让配置管理更加灵活：\n\n**优先级顺序**（从低到高）：\n1. **默认值** - 代码中的内置默认配置\n2. **process.env** - 系统环境变量\n3. **全局 .env** - `~\u002FDocuments\u002FHyperChat\u002F.env`\n4. **工作区 .env** - 项目目录下的 `.env` 文件\n5. **CLI 参数** - 命令行传入的参数（最高优先级）\n\n**支持的核心环境变量**：\n```bash\n# 快速配置 - 默认 AI 模型\nHyperChat_API_KEY=your-api-key              # 默认 API 密钥\nHyperChat_API_URL=your-api-url              # 默认 API 端点\nHyperChat_AI_Provider=openai                # 默认 AI 提供商\nHyperChat_AI_Model=gpt-4o                   # 默认模型名称\n\n\n# 服务配置\nHYPERCHAT_WEB_PASSWORD=your-web-password    # Web 界面访问密码\nHYPERCHAT_PORT=16100                        # Web 服务端口\nHYPERCHAT_HOST=localhost                    # 服务绑定地址\n\n# 界面配置\nHYPERCHAT_LANGUAGE=zh                       # 界面语言 (zh\u002Fen)\nHYPERCHAT_LOG_LEVEL=info                    # 日志级别\n\n# 自定义 API 端点\nHYPERCHAT_OPENAI_BASE_URL=https:\u002F\u002Fapi.openai.com\u002Fv1\nHYPERCHAT_CLAUDE_BASE_URL=https:\u002F\u002Fapi.anthropic.com\n```\n\n**使用示例**：\n```bash\n# 方式1：快速配置默认模型\nexport HyperChat_API_KEY=sk-1234567890\nexport HyperChat_AI_Provider=openai\nexport HyperChat_AI_Model=gpt-4o\nhyperchat \"你好\"                            # 直接使用默认配置\n\n# 方式2：Web 服务配置\nexport HYPERCHAT_WEB_PASSWORD=mypassword\nhyperchat serve\n\n# 方式3：项目 .env 文件\necho \"HyperChat_API_KEY=your-key\" > .env\necho \"HyperChat_AI_Provider=claude\" >> .env\nhyperchat chat\n\n# 方式4：CLI 参数（最高优先级）\nhyperchat serve --password=clipass\n\n# 方式5：全局配置文件\necho \"HyperChat_API_KEY=global-key\" > ~\u002FDocuments\u002FHyperChat\u002F.env\necho \"HyperChat_AI_Provider=gemini\" >> ~\u002FDocuments\u002FHyperChat\u002F.env\n```\n\n\n\n## 🛠️ 技术架构\n\n### 🎯 双层架构技术实现\n\nHyperChat 2.0 采用**双层架构设计**，根据不同使用场景提供最优化的体验：\n\n#### 🌐 Web 层：工作区中心架构\n```typescript\n\u002F\u002F Web 前端：工作区统一 MCP 管理\nconst workspace = workspaceManager.get(workspacePath);\nconst mcpManager = workspace.getMcpManager();\nconst client = mcpManager.getClient(clientName);\n```\n\n**技术特点**：\n- 🗂️ **多工作区并发管理**：`WorkspaceManager-enhanced` 支持多个工作区实例缓存\n- 🔌 **工作区级 MCP 服务池**：统一的 MCP 客户端管理\n- 📊 **实时数据同步**：SSE 流式推送，多标签页独立状态管理\n- 🔄**配置合并机制**：全局配置 + 工作区配置的智能合并\n\n#### 💻 CLI 层：Agent 优先架构\n```typescript\n\u002F\u002F CLI 前端：Agent 专属 MCP 访问\nconst agentInstance = workspace.getAgentInstance(agentName);\nconst client = agentInstance.getMCPClient(clientName);\n\u002F\u002F 回退到工作区共享 MCP（如果需要）\n```\n\n**技术特点**：\n- ⚡ **Agent 直接启动**：省略工作区初始化，直接访问 Agent 实例\n- 🔧 **工具链按需加载**：从 Agent 内置工具到工作区共享资源的渐进式加载\n- 💾 **专属上下文**：Agent 独立记忆、聊天历史、配置管理\n- 🚀 **极速响应**：无 UI 渲染开销，适合脚本和自动化\n\n\n```\nHyperChat 双层架构\u002F\n├── packages\u002F\n│   ├── shared\u002F              # 共享代码和类型定义\n│   ├── core\u002F                # Node.js 核心服务 + CLI Agent 优先层\n│   │   ├── src\u002Fcli\u002F         # 💻 CLI Agent 直接交互层\n│   │   ├── src\u002Fworkspace\u002F   # 双层工作区管理系统\n│   │   │   ├── workspaceManager-enhanced.mts  # 🌐 多工作区并发管理\n│   │   ├── src\u002Fmcp\u002F         # MCP 协议实现\n│   │   └── src\u002Fcommands\u002F    # Web API 命令系统\n│   ├── web\u002F                 # 🌐 React Web 多工作区层\n│   │   ├── src\u002Fpages\u002Fworkspace\u002F  # 多工作区管理组件\n│   │   │   ├── WorkspaceManage.tsx   # 多标签页管理器\n│   │   │   └── workspace.tsx         # 单工作区实例组件\n│   │   └── src\u002Fhooks\u002FuseChatStream.ts    # workspacePath 参数化\n│   └── electron\u002F            # Electron 应用封装\n└── docs\u002F                    # 双层架构文档\n```\n\n### 💼 双层架构配置管理\n\n```\n🌐 Web 多工作区模式配置：\n项目目录\u002F\n├── .hyperchat\u002F                    # 工作区统一配置目录\n│   ├── mcp.json                   # 🔌 工作区级 MCP 服务池\n│   ├── ai_models.json             # 🤖 工作区 AI 模型配置\n│   ├── .env                       # 工作区环境变量\n│   └── agents\u002F                    # 🗂️ 工作区 Agent 集合\n│       ├── project-assistant\u002F     # 项目专用 Agent\n│       │   ├── agent.yaml         # Agent 配置\n│       │   ├── memory.md          # 项目上下文记忆\n│       │   └── chatlogs\u002F          # 团队对话历史\n│       └── code-reviewer\u002F         # 代码审查 Agent\n├── .git\u002F                         # 版本控制\n└── package.json                  # 项目配置\n\n💻 CLI Agent 优先模式访问：\n全局配置\u002F\n~\u002FDocuments\u002FHyperChat\u002F\n  .hyperchat\u002F\n  ├── mcp.json                     # 🌍 全局 MCP 服务池\n  ├── .env                         # 全局环境变量\n  └── agents\u002F                      # 🚀 全局 Agent 库\n      ├── personal-assistant\u002F      # 个人助手 Agent\n      │   ├── agent.yaml           # Agent 配置\n      │   ├── memory.md            # 个人上下文记忆\n      │   └── chatlogs\u002F            # 个人对话历史\n      └── code-expert\u002F             # 专业代码 Agent\n```\n\n**双层配置的核心优势**：\n- 🌐 **Web 模式**：工作区中心化，适合项目级管理和团队协作\n- 💻 **CLI 模式**：Agent 中心化，支持跨项目的个人工具使用\n- 🔄 **智能合并**：全局配置 + 工作区配置的 5 层优先级管理\n- 💾 **数据隔离**：项目级和个人级数据完全分离，互不干扰\n\n```\n\n## 🌟 AI as Code 的革命性优势\n\n### 🔄 双层架构下的智能管理\n\n#### 🌐 Web 模式：团队协作版本控制\n```bash\n# 📁 项目级 AI 配置版本管理\ngit add .hyperchat\u002Fagents\u002Fproject-assistant\u002F\ngit commit -m \"添加项目专用 AI 助手\"\ngit push origin feature\u002Fproject-ai\n\n# 👥 团队 AI 最佳实践分享\ngit clone https:\u002F\u002Fgithub.com\u002Fteam\u002Fai-workspace-templates.git\ncp -r ai-workspace-templates\u002Freact-fullstack\u002F.hyperchat .\u002F\n\n# 🔄 项目 AI 配置回滚\ngit checkout HEAD~1 -- .hyperchat\u002F\n```\n\n#### 💻 CLI 模式：个人工具管理\n```bash\n# 🚀 快速部署个人 Agent\nhyperchat agent create personal-coder --template ~\u002Fai-templates\u002F\n\n# 🌍 跨项目使用个人 Agent\ncd \u002Fproject-a && hyperchat agent personal-coder \"分析这个项目\"\ncd \u002Fproject-b && hyperchat agent personal-coder \"分析这个项目\"\n\n# 💾 Agent 记忆和上下文自动切换\n# personal-coder 会记住不同项目的特点和上下文\n```\n\n\n\n### Agent 配置与自定义命令 ✨**新功能**\n\n#### Agent 基础配置\n```yaml\n# .hyperchat\u002Fagents\u002Fproject-assistant\u002Fagent.yaml\nname: \"项目助手\"\ndescription: \"专门为本项目设计的 React + Node.js 全栈助手\"\nmodelKey: \"claude-3-5-sonnet\"\nisConfirmCallTool: false\n# 🔌 使用工作区级 MCP 服务池\nallowMCPs: [\"filesystem\", \"git\", \"npm\", \"database\"]\nprompt: |\n  你是本项目的专属 AI 助手，熟悉：\n  - 项目架构：React + TypeScript + Node.js\n  - 业务领域：电商平台开发\n  - 团队规范：ESLint + Prettier + Jest\n  \n  请基于项目上下文提供专业建议。\ntags: [\"project\", \"fullstack\", \"ecommerce\"]\n```\n\n#### Agent 自定义命令目录结构 ✨**新功能**\n```\n.hyperchat\u002Fagents\u002Fproject-assistant\u002F\n├── agent.yaml              # Agent 配置\n├── memory.md               # Agent 记忆\n├── commands\u002F               # 🎯 自定义命令目录\n│   ├── bug-fix.md         # 修复bug命令\n│   ├── review.md          # 代码审查命令\n│   ├── explain.md         # 代码解释命令\n│   ├── test.md            # 测试用例命令\n│   ├── optimize.md        # 代码优化命令\n│   └── document.md        # 文档生成命令\n└── chatlogs\u002F              # 聊天记录\n```\n\n#### 命令模板示例（纯Markdown）\n```markdown\n# commands\u002Fbug-fix.md\n请帮我修复以下代码中的bug：\n\n$ARG\n\n要求：\n1. 仔细分析问题的根本原因\n2. 提供详细的修复方案\n3. 给出修复后的完整代码\n4. 解释修复的原理和最佳实践\n5. 提供预防类似问题的建议\n```\n\n```markdown\n# commands\u002Freview.md\n请对以下代码进行全面的code review：\n\n$ARG\n\nReview要点：\n1. **代码质量**：可读性、维护性、命名规范\n2. **性能问题**：算法效率、内存使用、潜在瓶颈\n3. **安全隐患**：输入验证、权限控制、数据泄露风险\n4. **最佳实践**：设计模式、架构原则、团队规范\n5. **改进建议**：具体的优化方案和替代实现\n\n请提供具体的修改建议和代码示例。\n```\n\n#### 使用示例\n```bash\n# 使用自定义命令进行bug修复\nhyperchat agent project-assistant \"\u002Fbug-fix @.\u002Fsrc\u002Flogin.ts 用户登录后跳转异常\"\n\n# 实际发送给AI的内容：\n# 请帮我修复以下代码中的bug：\n# @.\u002Fsrc\u002Flogin.ts 用户登录后跳转异常\n# 要求：\n# 1. 仔细分析问题的根本原因\n# 2. 提供详细的修复方案\n# 3. 给出修复后的完整代码\n# 4. 解释修复的原理和最佳实践\n# 5. 提供预防类似问题的建议\n\n# 使用代码审查命令\nhyperchat agent project-assistant \"\u002Freview @.\u002Fsrc\u002Fcomponents\u002FUserProfile.tsx\"\n\n# 在交互式聊天中使用\nhyperchat agent project-assistant chat\n> \u002Fbug-fix 这个函数有内存泄漏问题\n> \u002Foptimize @.\u002Fsrc\u002Futils\u002FdataProcessor.js\n```\n\n```yaml\n# ~\u002FDocuments\u002FHyperChat\u002F.hyperchat\u002Fagents\u002Fpersonal-coder\u002Fagent.yaml\nname: \"个人编程助手\"\ndescription: \"跨项目的通用编程助手，支持多种技术栈\"\nmodelKey: \"gpt-4o\"\nisConfirmCallTool: true\n# ⚡ Agent 专属 MCP 工具 + 回退到工作区\nallowMCPs: [\"terminal\", \"browser\", \"calculator\"]\nprompt: |\n  你是我的个人编程助手，擅长：\n  - 多语言开发：Python, JavaScript, Go, Rust\n  - 架构设计和代码审查\n  - 快速原型开发和问题解决\n  \n  根据不同项目的上下文调整回答风格。\ntags: [\"personal\", \"general\", \"cross-project\"]\n```\n\n\n\n### 🤖 AI 模型推荐\n| 模型提供商 | 推荐程度 | 特色功能 |\n|------------|----------|----------|\n| Claude | ⭐⭐⭐⭐⭐⭐ | 最强 |\n| Kimi k2 | ⭐⭐⭐⭐⭐ | 很不错 |\n\n\n## 🔧 开发指南\n\n### 💻 本地开发\n```bash\n# 克隆项目\ngit clone https:\u002F\u002Fgithub.com\u002FBigSweetPotatoStudio\u002FHyperChat.git\ncd HyperChat\n\n# 安装依赖\nnpm install\ncd packages\u002Felectron && npm install\ncd packages\u002Fweb && npm install\ncd ..\u002F..\n\n# 启动开发服务器\nnpm run dev\n\n\n\n## 🤝 社区交流\n\n- [Telegram](https:\u002F\u002Ft.me\u002Fdadigua001)\n- [QQ 群](https:\u002F\u002Fqm.qq.com\u002Fcgi-bin\u002Fqm\u002Fqr?k=KrNWdu5sp7H3ves3ZPSd7ppKjQiPrAvZ&jump_from=webapi&authKey=xnW+Lcgk5KLh5NPh3lU0ddz9CFDbXgvjEy35wsYipUrCsqXFcqlvM5Yorh6jkGim)\n\n## 📄 免责声明\n\n本项目仅供学习交流使用。使用本项目进行的任何操作（如爬虫行为等）与项目开发者无关。\n\n## 📜 许可证\n\n本项目采用开源许可证，详情请查看 [LICENSE](LICENSE) 文件。\n\n","# HyperChat 中文文档\n\n# HyperChat\n\n> 🌟 **本地 AI 代理平台** - 首创 AI as Code 理念，让每个项目都有专属的 AI 大脑\n\nHyperChat 是一个革命性的**本地 AI 代理平台**，通过**配置文件驱动**的方式，让 AI 能力完全本地化、可迁移、可版本控制。告别云端依赖，拥有真正属于自己的项目级 AI 专家。\n\n### 🎯 核心特色\n- 🏠 **完全本地化**：数据不出本地，隐私安全可控\n- 🧠 **Agent记忆**：AI 代理理解并记住你的项目上下文  \n- 📁 **配置即代码**：所有 AI 能力通过文件配置，支持 Git 管理\n- 🔧 **深度工具集成**：MCP 协议支持，可直接操作本地文件系统\n- 📦 **一键迁移**：完整的 `.hyperchat\u002F` 配置目录，随项目迁移\n- 📂 **多@文件路径**：智能识别多个文件引用，支持复杂文件操作 ✨**新功能**\n- 🎯 **Agent自定义命令**：Markdown模板驱动的快捷命令系统 ✨**新功能**\n\n[![Build](https:\u002F\u002Fgithub.com\u002FBigSweetPotatoStudio\u002FHyperChat\u002Factions\u002Fworkflows\u002Fbuild.yml\u002Fbadge.svg)](https:\u002F\u002Fgithub.com\u002FBigSweetPotatoStudio\u002FHyperChat\u002Factions\u002Fworkflows\u002Fbuild.yml)\n[![@dadigua\u002Fhyperchat](https:\u002F\u002Fimg.shields.io\u002Fnpm\u002Fv\u002F%40dadigua%2Fhyperchat)](https:\u002F\u002Fwww.npmjs.com\u002Fpackage\u002F@dadigua\u002Fhyperchat)\n[![npm downloads](https:\u002F\u002Fimg.shields.io\u002Fnpm\u002Fdm\u002F@dadigua\u002Fhyperchat)](https:\u002F\u002Fnpm-stat.com\u002Fcharts.html?package=@dadigua\u002Fhyperchat)\n\n## 🎯 项目愿景\n\n**[HyperChat 1.0](.\u002Farchive\u002FREADME.1.md)** 是一个完全手工编写的项目，正在迁移到2.0。\n\n**HyperChat 2.0** 大家一起 **Vibe Coding**，欢迎使用 Claude Code 和 GitHub Copilot 等 AI 工具一起开发。\n\n## 🎯 双层架构设计\n\n> **创新的双模式架构** - 根据不同使用场景优化用户体验\n\n### 🌐 Web 前端：多工作区协作中心\n**设计理念**：项目级协作，统一资源管理\n\n- **🗂️ 多工作区标签页管理**：同时打开多个项目工作区，一键切换\n- **👥 团队协作优化**：工作区级别的 Agent 集合、MCP 服务池\n- **📊 可视化管理界面**：图形化配置、实时监控、数据统计\n- **💼 适用场景**：项目开发、团队协作、工作区管理、可视化操作\n\n### 💻 CLI 前端：Agent 优先快速交互\n**设计理念**：Agent 中心化，极速启动单个智能体\n\n- **⚡ 快速启动**：直接选择 Agent，从工作区按需加载 MCP 工具\n- **🎯 专注对话**：Agent 专属记忆、上下文、聊天历史\n- **🔧 灵活工具链**：Agent 内置 MCP 工具，回退到工作区共享资源\n- **🚀 适用场景**：快速对话、自动化脚本、命令行工作流、CI\u002FCD 集成\n\n### 📋 架构对比\n\n| 功能特性 | 🌐 Web 多工作区模式 | 💻 CLI Agent 优先模式 |\n|---------|---------------------|----------------------|\n| **核心理念** |\n| 设计中心 | 🗂️ 工作区协作中心 | 🤖 Agent 直接交互 |\n| 资源管理 | 工作区统一 MCP 池 | Agent按需启动MCP |\n| 使用方式 | 多标签页并发管理 | 单 Agent 快速启动 |\n| **界面体验** |\n| 界面风格 | 🖥️ 现代 Web 界面 | 📟 命令行 + 🎨 TUI |\n| 交互模式 | 鼠标点击 + 表单操作 | 键盘输入 + 命令参数 |\n| 实时更新 | ✅ SSE 流式推送 | ✅ 终端流式输出 |\n| **适用场景** |\n| 主要用途 | 项目开发、团队协作 | 快速对话、脚本集成 |\n| 使用环境 | 桌面浏览器、开发 IDE | 终端、服务器、CI\u002FCD |\n| 工作流程 | 长期项目管理 | 临时对话处理 |\n\n## 🚀 快速体验\n\n### ⌨️ 命令行快速启动\n```bash\n# 全局安装\nnpm install -g @dadigua\u002Fhyperchat\n\n# 或直接运行\nnpx -y @dadigua\u002Fhyperchat\n```\n\n**快速配置环境变量**：\n```bash\n# 基础配置 - 设置默认 AI 模型\nexport HyperChat_API_KEY=your-api-key           # API 密钥\nexport HyperChat_API_URL=your-api-url           # API 端点 URL\nexport HyperChat_AI_Provider=openai             # AI 提供商 (openai\u002Fclaude\u002Fgemini\u002Fkimi\u002Fqwen等)\nexport HyperChat_AI_Model=gpt-4o                # 默认模型名称\n\n# 然后直接使用\nhyperchat \"你好，世界！\"                        # 使用配置的默认模型\n```\n\n### 🌐 Web 多工作区模式使用示例\n```bash\n# 启动多工作区 Web 界面\nhyperchat serve                        # 访问: http:\u002F\u002Flocalhost:16100\n\n# Web 界面功能特色：\n# ✅ 多工作区标签页管理\n# ✅ 每个标签页独立的 Agent 集合、MCP 服务、聊天记录\n# ✅ 可视化配置和实时监控\n# ✅ 团队协作和项目管理\n```\n\n### 💻 CLI Agent 优先模式使用示例\n```bash\n# 🚀 Agent 优先快速启动 - 核心特色\nhyperchat agent list                   # 发现可用 Agent（全局 + 工作区）\nhyperchat agent mybot \"你好\"           # 🎯 直接启动 Agent，按需加载 MCP\nhyperchat agent mybot chat             # 🎯 Agent 专属对话会话\n\n# 快速 AI 聊天（使用默认 Agent）\nhyperchat \"你好，今天怎么样？\"           # 直接与默认模型聊天\nhyperchat chat \"写一个 Python 脚本\"     # 聊天命令\nhyperchat chat                         # 交互式聊天模式\n\n# 📁 智能文件处理 - 多@符号支持 ✨新功能\nhyperchat \"分析 @.\u002Fsrc\u002Findex.ts 的代码质量\"\nhyperchat \"对比 @.\u002Fpackage.json 和 @.\u002Fyarn.lock\"\nhyperchat \"请比较 @.\u002Fsrc\u002Fcomponents\u002F 和 @.\u002Fdocs\u002F 的结构\"\n\n# 🎯 Agent自定义命令 - 快捷输入专业提示词 ✨新功能\nhyperchat agent coder \"\u002Fbug-fix @.\u002Fsrc\u002Flogin.ts 登录功能异常\"\nhyperchat agent coder \"\u002Freview @.\u002Fsrc\u002Fapi\u002Fuser.js\"\nhyperchat agent coder \"\u002Foptimize 这段代码性能不好\"\n\n# Agent 管理（在当前工作区或全局）\nhyperchat agent create mybot           # 创建新 Agent\nhyperchat agent delete mybot           # 删除 Agent\n\n# 工作区管理\nhyperchat workspace create             # 在当前目录创建工作区\n\n\n# 全局选项和工作区指定\nhyperchat chat --workspace \u002Fpath\u002Fto\u002Fproject  # 使用特定工作区\nhyperchat --verbose chat \"你好\"             # 详细日志\nhyperchat --help                            # 显示帮助\n\n# CLI 模式优势：\n# ⚡ Agent 直接启动，无需切换界面\n# 🔧 按需从工作区加载 MCP 工具\n# 💾 Agent 专属记忆和聊天历史\n# 🚀 适合脚本集成和自动化\n```\n\n### 🔄 双模式协同工作\n```bash\n# 场景1：开发时 Web\nhyperchat serve                       # 启动 Web 界面管理项目\n\n# 场景2：CI\u002FCD 自动化使用 CLI\nhyperchat agent test-runner \"运行所有测试并生成报告\"\n\n# 场景3：团队协作使用 Web\n# 在 Web 界面中管理多个项目工作区，配置共享的 Agent 和 MCP 服务\n```\n\n\n### 🔧 环境变量配置\n\nHyperChat 2.0 实现了强大的**5层优先级环境变量系统**，让配置管理更加灵活：\n\n**优先级顺序**（从低到高）：\n1. **默认值** - 代码中的内置默认配置\n2. **process.env** - 系统环境变量\n3. **全局 .env** - `~\u002FDocuments\u002FHyperChat\u002F.env`\n4. **工作区 .env** - 项目目录下的 `.env` 文件\n5. **CLI 参数** - 命令行传入的参数（最高优先级）\n\n**支持的核心环境变量**：\n```bash\n# 快速配置 - 默认 AI 模型\nHyperChat_API_KEY=your-api-key              # 默认 API 密钥\nHyperChat_API_URL=your-api-url              # 默认 API 端点\nHyperChat_AI_Provider=openai                # 默认 AI 提供商\nHyperChat_AI_Model=gpt-4o                   # 默认模型名称\n\n\n# 服务配置\nHYPERCHAT_WEB_PASSWORD=your-web-password    # Web 界面访问密码\nHYPERCHAT_PORT=16100                        # Web 服务端口\nHYPERCHAT_HOST=localhost                    # 服务绑定地址\n\n# 界面配置\nHYPERCHAT_LANGUAGE=zh                       # 界面语言 (zh\u002Fen)\nHYPERCHAT_LOG_LEVEL=info                    # 日志级别\n\n# 自定义 API 端点\nHYPERCHAT_OPENAI_BASE_URL=https:\u002F\u002Fapi.openai.com\u002Fv1\nHYPERCHAT_CLAUDE_BASE_URL=https:\u002F\u002Fapi.anthropic.com\n```\n\n**使用示例**：\n```bash\n# 方式1：快速配置默认模型\nexport HyperChat_API_KEY=sk-1234567890\nexport HyperChat_AI_Provider=openai\nexport HyperChat_AI_Model=gpt-4o\nhyperchat \"你好\"                            # 直接使用默认配置\n\n# 方式2：Web 服务配置\nexport HYPERCHAT_WEB_PASSWORD=mypassword\nhyperchat serve\n\n# 方式3：项目 .env 文件\necho \"HyperChat_API_KEY=your-key\" > .env\necho \"HyperChat_AI_Provider=claude\" >> .env\nhyperchat chat\n\n# 方式4：CLI 参数（最高优先级）\nhyperchat serve --password=clipass\n\n# 方式5：全局配置文件\necho \"HyperChat_API_KEY=global-key\" > ~\u002FDocuments\u002FHyperChat\u002F.env\necho \"HyperChat_AI_Provider=gemini\" >> ~\u002FDocuments\u002FHyperChat\u002F.env\n```\n\n\n\n## 🛠️ 技术架构\n\n### 🎯 双层架构技术实现\n\nHyperChat 2.0 采用**双层架构设计**，根据不同使用场景提供最优化的体验：\n\n#### 🌐 Web 层：工作区中心架构\n```typescript\n\u002F\u002F Web 前端：工作区统一 MCP 管理\nconst workspace = workspaceManager.get(workspacePath);\nconst mcpManager = workspace.getMcpManager();\nconst client = mcpManager.getClient(clientName);\n```\n\n**技术特点**：\n- 🗂️ **多工作区并发管理**：`WorkspaceManager-enhanced` 支持多个工作区实例缓存\n- 🔌 **工作区级 MCP 服务池**：统一的 MCP 客户端管理\n- 📊 **实时数据同步**：SSE 流式推送，多标签页独立状态管理\n- 🔄**配置合并机制**：全局配置 + 工作区配置的智能合并\n\n#### 💻 CLI 层：Agent 优先架构\n```typescript\n\u002F\u002F CLI 前端：Agent 专属 MCP 访问\nconst agentInstance = workspace.getAgentInstance(agentName);\nconst client = agentInstance.getMCPClient(clientName);\n\u002F\u002F 回退到工作区共享 MCP（如果需要）\n```\n\n**技术特点**：\n- ⚡ **Agent 直接启动**：省略工作区初始化，直接访问 Agent 实例\n- 🔧 **工具链按需加载**：从 Agent 内置工具到工作区共享资源的渐进式加载\n- 💾 **专属上下文**：Agent 独立记忆、聊天历史、配置管理\n- 🚀 **极速响应**：无 UI 渲染开销，适合脚本和自动化\n\n\n```\nHyperChat 双层架构\u002F\n├── packages\u002F\n│   ├── shared\u002F              # 共享代码和类型定义\n│   ├── core\u002F                # Node.js 核心服务 + CLI Agent 优先层\n│   │   ├── src\u002Fcli\u002F         # 💻 CLI Agent 直接交互层\n│   │   ├── src\u002Fworkspace\u002F   # 双层工作区管理系统\n│   │   │   ├── workspaceManager-enhanced.mts  # 🌐 多工作区并发管理\n│   │   ├── src\u002Fmcp\u002F         # MCP 协议实现\n│   │   └── src\u002Fcommands\u002F    # Web API 命令系统\n│   ├── web\u002F                 # 🌐 React Web 多工作区层\n│   │   ├── src\u002Fpages\u002Fworkspace\u002F  # 多工作区管理组件\n│   │   │   ├── WorkspaceManage.tsx   # 多标签页管理器\n│   │   │   └著 workspace.tsx         # 单工作区实例组件\n│   │   └著 src\u002Fhooks\u002FuseChatStream.ts    # workspacePath 参数化\n│   └著 electron\u002F            # Electron 应用封装\n└著 docs\u002F                    # 双层架构文档\n```\n\n### 💼 双层架构配置管理\n\n```\n🌐 Web 多工作区模式配置：\n项目目录\u002F\n├著 .hyperchat\u002F                    # 工作区统一配置目录\n│   ├── mcp.json                   # 🔌 工作区级 MCP 服务池\n│   ├── ai_models.json             # 🤖 工作区 AI 模型配置\n│   ├── .env                       # 工作区环境变量\n│   └著 agents\u002F                    # 🗂️ 工作区 Agent 集合\n│       ├── project-assistant\u002F     # 项目专用 Agent\n│       │   ├── agent.yaml         # Agent 配置\n│       │   ├── memory.md          # 项目上下文记忆\n│       │   └著 chatlogs\u002F          # 团队对话历史\n│       └著 code-reviewer\u002F         # 代码审查 Agent\n├著 .git\u002F                         # 版本控制\n└著 package.json                  # 项目配置\n\n💻 CLI Agent 优先模式访问：\n全局配置\u002F\n~\u002FDocuments\u002FHyperChat\u002F\n  .hyperchat\u002F\n  ├── mcp.json                     # 🌍 全局 MCP 服务池\n  ├── .env                         # 全局环境变量\n  └著 agents\u002F                      # 🚀 全局 Agent 库\n      ├── personal-assistant\u002F      # 个人助手 Agent\n      │   ├── agent.yaml           # Agent 配置\n      │   ├── memory.md            # 个人上下文记忆\n      │   └著 chatlogs\u002F            # 个人对话历史\n      └著 code-expert\u002F             # 专业代码 Agent\n```\n\n**双层配置的核心优势**：\n- 🌐 **Web 模式**：工作区中心化，适合项目级管理和团队协作\n- 💻 **CLI 模式**：Agent 中心化，支持跨项目的个人工具使用\n- 🔄 **智能合并**：全局配置 + 工作区配置的 5 层优先级管理\n- 💾 **数据隔离**：项目级和个人级数据完全分离，互不干扰\n\n```\n\n## 🌟 AI as Code 的革命性优势\n\n### 🔄 双层架构下的智能管理\n\n#### 🌐 Web 模式：团队协作版本控制\n```bash\n# 📁 项目级 AI 配置版本管理\ngit add .hyperchat\u002Fagents\u002Fproject-assistant\u002F\ngit commit -m \"添加项目专用 AI 助手\"\ngit push origin feature\u002Fproject-ai\n\n# 👥 团队 AI 最佳实践分享\ngit clone https:\u002F\u002Fgithub.com\u002Fteam\u002Fai-workspace-templates.git\ncp -r ai-workspace-templates\u002Freact-fullstack\u002F.hyperchat .\u002F\n\n# 🔄 项目 AI 配置回滚\ngit checkout HEAD~1 -- .hyperchat\u002F\n```\n\n#### 💻 CLI 模式：个人工具管理\n```bash\n# 🚀 快速部署个人 Agent\nhyperchat agent create personal-coder --template ~\u002Fai-templates\u002F\n\n# 🌍 跨项目使用个人 Agent\ncd \u002Fproject-a && hyperchat agent personal-coder \"分析这个项目\"\ncd \u002Fproject-b && hyperchat agent personal-coder \"分析这个项目\"\n\n# 💾 Agent 记忆和上下文自动切换\n# personal-coder 会记住不同项目的特点和上下文\n```\n\n\n\n### Agent 配置与自定义命令 ✨**新功能**\n\n#### Agent 基础配置\n```yaml\n# .hyperchat\u002Fagents\u002Fproject-assistant\u002Fagent.yaml\nname: \"项目助手\"\ndescription: \"专门为本项目设计的 React + Node.js 全栈助手\"\nmodelKey: \"claude-3-5-sonnet\"\nisConfirmCallTool: false\n# 🔌 使用工作区级 MCP 服务池\nallowMCPs: [\"filesystem\", \"git\", \"npm\", \"database\"]\nprompt: |\n  你是本项目的专属 AI 助手，熟悉：\n  - 项目架构：React + TypeScript + Node.js\n  - 业务领域：电商平台开发\n  - 团队规范：ESLint + Prettier + Jest\n  \n  请基于项目上下文提供专业建议。\ntags: [\"project\", \"fullstack\", \"ecommerce\"]\n```\n\n#### Agent 自定义命令目录结构 ✨**新功能**\n```\n.hyperchat\u002Fagents\u002Fproject-assistant\u002F\n├著 agent.yaml              # Agent 配置\n├著 memory.md               # Agent 记忆\n├著 commands\u002F               # 🎯 自定义命令目录\n│   ├── bug-fix.md         # 修复bug命令\n│   ├── review.md          # 代码审查命令\n│   ├── explain.md         # 代码解释命令\n│   ├── test.md            # 测试用例命令\n│   ├── optimize.md        # 代码优化命令\n│   └著 document.md        # 文档生成命令\n└著 chatlogs\u002F              # 聊天记录\n```\n\n#### 命令模板示例（纯Markdown）\n```markdown\n# commands\u002Fbug-fix.md\n请帮我修复以下代码中的bug：\n\n$ARG\n\n要求：\n1. 仔细分析问题的根本原因\n2. 提供详细的修复方案\n3. 给出修复后的完整代码\n4. 解释修复的原理和最佳实践\n5. 提供预防类似问题的建议\n```\n\n```markdown\n# commands\u002Freview.md\n请对以下代码进行全面的code review：\n\n$ARG\n\nReview要点：\n1. **代码质量**：可读性、维护性、命名规范\n2. **性能问题**：算法效率、内存使用、潜在瓶颈\n3. **安全隐患**：输入验证、权限控制、数据泄露风险\n4. **最佳实践**：设计模式、架构原则、团队规范\n5. **改进建议**：具体的优化方案和替代实现\n\n请提供具体的修改建议和代码示例。\n```\n\n#### 使用示例\n```bash\n# 使用自定义命令进行bug修复\nhyperchat agent project-assistant \"\u002Fbug-fix @.\u002Fsrc\u002Flogin.ts 用户登录后跳转异常\"\n\n# 实际发送给AI的内容：\n# 请帮我修复以下代码中的bug：\n# @.\u002Fsrc\u002Flogin.ts 用户登录后跳转异常\n# 要求：\n# 1. 仔细分析问题的根本原因\n# 2. 提供详细的修复方案\n# 3. 给出修复后的完整代码\n# 4. 解释修复的原理和最佳实践\n# 5. 提供预防类似问题的建议\n\n# 使用代码审查命令\nhyperchat agent project-assistant \"\u002Freview @.\u002Fsrc\u002Fcomponents\u002FUserProfile.tsx\"\n\n# 在交互式聊天中使用\nhyperchat agent project-assistant chat\n> \u002Fbug-fix 这个函数有内存泄漏问题\n> \u002Foptimize @.\u002Fsrc\u002Futils\u002FdataProcessor.js\n```\n\n```yaml\n# ~\u002FDocuments\u002FHyperChat\u002F.hyperchat\u002Fagents\u002Fpersonal-coder\u002Fagent.yaml\nname: \"个人编程助手\"\ndescription: \"跨项目的通用编程助手，支持多种技术栈\"\nmodelKey: \"gpt-4o\"\nisConfirmCallTool: true\n# ⚡ Agent 专属 MCP 工具 + 回退到工作区\nallowMCPs: [\"terminal\", \"browser\", \"calculator\"]\nprompt: |\n  你是我的个人编程助手，擅长：\n  - 多语言开发：Python, JavaScript, Go, Rust\n  - 架构设计和代码审查\n  - 快速原型开发和问题解决\n  \n  根据不同项目的上下文调整回答风格。\ntags: [\"personal\", \"general\", \"cross-project\"]\n```\n\n\n\n### 🤖 AI 模型推荐\n| 模型提供商 | 推荐程度 | 特色功能 |\n|------------|----------|----------|\n| Claude | ⭐⭐⭐⭐⭐⭐ | 最强 |\n| Kimi k2 | ⭐⭐⭐⭐⭐ | 很不错 |\n\n\n## 🔧 开发指南\n\n### 💻 本地开发\n```bash\n# 克隆项目\ngit clone https:\u002F\u002Fgithub.com\u002FBigSweetPotatoStudio\u002FHyperChat.git\ncd HyperChat\n\n# 安装依赖\nnpm install\ncd packages\u002Felectron && npm install\ncd packages\u002Fweb && npm install\ncd ..\u002F..\n\n# 启动开发服务器\nnpm run dev\n\n\n\n## 🤝 社区交流\n\n- [Telegram](https:\u002F\u002Ft.me\u002Fdadigua001)\n- [QQ 群](https:\u002F\u002Fqm.qq.com\u002Fcgi-bin\u002Fqm\u002Fqr?k=KrNWdu5sp7H3ves3ZPSd7ppKjQiPrAvZ&jump_from=webapi&authKey=xnW+Lcgk5KLh5NPh3lU0ddz9CFDbXgvjEy35wsYipUrCsqXFcqlvM5Yorh6jkGim)\n\n## 📄 免责声明\n\n本项目仅供学习交流使用。使用本项目进行的任何操作（如爬虫行为等）与项目开发者无关。\n\n## 📜 许可证\n\n本项目采用开源许可证，详情请查看 [LICENSE](LICENSE) 文件。","# HyperChat 快速上手指南\n\nHyperChat 是一个革命性的**本地 AI Agent 平台**，首创\"AI as Code\"理念。它通过配置文件驱动，让 AI 能力完全本地化、可迁移且支持版本控制，是真正属于你项目的专属 AI 专家。\n\n## 🛠️ 环境准备\n\n在开始之前，请确保你的开发环境满足以下要求：\n\n*   **操作系统**：Windows, macOS, 或 Linux\n*   **运行时依赖**：已安装 [Node.js](https:\u002F\u002Fnodejs.org\u002F) (推荐 v18 或更高版本)\n*   **API 密钥**：准备好你所选 AI 模型提供商的 API Key（如 OpenAI, Claude, Kimi, Qwen 等）\n\n## 📦 安装步骤\n\n你可以通过 npm 全局安装或直接使用 npx 运行，无需复杂配置。\n\n### 方式一：全局安装（推荐）\n适合频繁使用的开发者，安装后可在任何目录直接使用 `hyperchat` 命令。\n\n```bash\nnpm install -g @dadigua\u002Fhyperchat\n```\n\n### 方式二：临时运行\n适合快速体验或不想全局安装的用户。\n\n```bash\nnpx -y @dadigua\u002Fhyperchat\n```\n\n## 🚀 基本使用\n\n### 1. 配置环境变量\n在使用前，需设置默认的 AI 模型信息。你可以选择临时导出或在项目中创建 `.env` 文件。\n\n**临时配置（当前终端会话有效）：**\n```bash\nexport HyperChat_API_KEY=your-api-key           # 替换为你的 API 密钥\nexport HyperChat_API_URL=your-api-url           # 替换为 API 端点（如有）\nexport HyperChat_AI_Provider=openai             # 提供商：openai\u002Fclaude\u002Fkimi\u002Fqwen 等\nexport HyperChat_AI_Model=gpt-4o                # 模型名称\n```\n\n**永久配置（项目级）：**\n在项目根目录创建 `.env` 文件，写入上述变量。HyperChat 会自动读取。\n\n### 2. 快速对话 (CLI 模式)\n配置完成后，即可直接在命令行与 AI 交互。\n\n**简单问答：**\n```bash\nhyperchat \"你好，世界！\"\n```\n\n**交互式聊天：**\n```bash\nhyperchat chat\n```\n\n**智能文件分析（支持多文件引用）：**\n使用 `@` 符号直接引用本地文件，AI 将基于文件内容回答。\n```bash\nhyperchat \"分析 @.\u002Fsrc\u002Findex.ts 的代码质量\"\nhyperchat \"对比 @.\u002Fpackage.json 和 @.\u002Fyarn.lock 的差异\"\n```\n\n### 3. 启动 Web 协作界面\n适合项目管理、多工作区切换及团队协作场景。\n\n```bash\nhyperchat serve\n```\n启动后访问：`http:\u002F\u002Flocalhost:16100`\n*   **功能亮点**：多标签页管理不同项目、可视化配置 MCP 工具、实时监控对话状态。\n\n### 4. 使用自定义 Agent 命令 ✨\nHyperChat 支持通过 Markdown 模板定义快捷命令（如 `\u002Fbug-fix`, `\u002Freview`）。\n\n```bash\n# 使用预设命令修复 Bug\nhyperchat agent coder \"\u002Fbug-fix @.\u002Fsrc\u002Flogin.ts 登录功能异常\"\n\n# 代码审查\nhyperchat agent coder \"\u002Freview @.\u002Fsrc\u002Fapi\u002Fuser.js\"\n```\n\n> **提示**：更多高级用法（如创建专属 Agent、配置 MCP 工具链）请参考完整文档或通过 `hyperchat --help` 查看。","某全栈开发团队在维护一个包含前端、后端及文档的复杂微服务项目时，需要频繁进行跨文件代码审查与自动化修复。\n\n### 没有 HyperChat 时\n- **隐私与上下文割裂**：担心代码泄露不敢使用云端 AI，且每次对话需手动复制粘贴多个文件内容，AI 难以理解项目整体架构。\n- **协作配置繁琐**：新成员加入或切换设备时，需重新口头同步 Prompt 技巧和 API 配置，无法统一团队的 AI 行为标准。\n- **操作效率低下**：缺乏本地文件直接操作能力，AI 生成的修复建议需人工逐行复制回编辑器，无法通过命令一键应用。\n- **记忆缺失**：AI 无法记住之前的讨论结论，重复解释业务逻辑和特定编码规范浪费大量时间。\n\n### 使用 HyperChat 后\n- **本地化智能上下文**：利用 `@` 符号直接引用 `@.\u002Fsrc\u002Fapi` 和 `@.\u002Fdocs` 等多个路径，数据完全本地运行，AI 瞬间掌握项目全貌且保障隐私。\n- **配置即代码（AI as Code）**：将定制好的 Agent 提示词与 MCP 工具配置存入 `.hyperchat\u002F` 目录并提交 Git，团队成员拉取代码即可获得相同的“项目专家”。\n- **命令驱动高效执行**：通过 `hyperchat agent coder \"\u002Fbug-fix @.\u002Fsrc\u002Flogin.ts\"` 快捷命令，直接调用本地 MCP 协议读取并修复文件，无需手动复制粘贴。\n- **持久化项目记忆**：Agent 自动记录项目特定的业务规则与历史决策，后续对话无需重复背景，直接进入深度开发环节。\n\nHyperChat 通过将 AI 能力转化为可版本控制的项目资产，让每个开发者都拥有了懂代码、守隐私且能直接动手的专属本地技术伙伴。","https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002FBigSweetPotatoStudio_HyperChat_11f2009e.png","BigSweetPotatoStudio","dadigua","https:\u002F\u002Foss.gittoolsai.com\u002Favatars\u002FBigSweetPotatoStudio_c1aa0835.png","",null,"0laopo0@gmail.com","https:\u002F\u002Fwww.dadigua.men\u002F","https:\u002F\u002Fgithub.com\u002FBigSweetPotatoStudio",[83,87,91,95,99,103],{"name":84,"color":85,"percentage":86},"TypeScript","#3178c6",91.7,{"name":88,"color":89,"percentage":90},"JavaScript","#f1e05a",7,{"name":92,"color":93,"percentage":94},"CSS","#663399",0.8,{"name":96,"color":97,"percentage":98},"HTML","#e34c26",0.3,{"name":100,"color":101,"percentage":102},"Shell","#89e051",0.2,{"name":104,"color":105,"percentage":106},"Dockerfile","#384d54",0.1,712,75,"2026-04-15T08:51:43","NOASSERTION","Linux, macOS, Windows","未说明",{"notes":114,"python":112,"dependencies":115},"该工具为基于 Node.js 的本地 AI Agent 平台，非本地部署大模型，因此无特定 GPU\u002F显存\u002FCUDA 要求。运行需安装 Node.js 环境并通过 npm 全局安装或 npx 运行。核心功能依赖外部 AI 提供商（如 OpenAI, Claude, Gemini 等）的 API 密钥及网络访问。支持 Web 界面（默认端口 16100）和 CLI 命令行两种模式。",[116,117],"Node.js (npm\u002Fnpx)","@dadigua\u002Fhyperchat",[35,14,13],[120,121,122,123,124,125],"chat-application","llm","mcp","modelcontextprotocol","agent","local-agent","2026-03-27T02:49:30.150509","2026-04-17T08:25:24.682779",[129,134,139,144,149,154,159],{"id":130,"question_zh":131,"answer_zh":132,"source_url":133},36883,"为什么某些模型（如 OpenRouter 上的 Qwen）不支持工具调用，而其他软件（如 Cherry Studio）可以？","部分模型本身不支持原生的 Function Calling (FC) 参数。其他软件可能通过在系统提示词中注入工具描述来模拟支持，但这会消耗更多 Token 且稳定性较差（容易出现幻觉或参数错误）。HyperChat 优先使用官方标准的 tools 参数，对于不支持的模型，目前只能通过提示词注入方式变通，但效果取决于模型本身的理解能力。","https:\u002F\u002Fgithub.com\u002FBigSweetPotatoStudio\u002FHyperChat\u002Fissues\u002F104",{"id":135,"question_zh":136,"answer_zh":137,"source_url":138},36884,"连接 Gemini 或其他海外模型时出现 400 错误或网络连接错误怎么办？","这通常是网络问题。目前软件尚未内置 HTTPS_PROXY 代理配置功能。解决方法是先在操作系统层面开启全局代理（例如使用 Clash 的 Tun 模式），然后再运行软件。后续版本计划加入内置代理设置功能。","https:\u002F\u002Fgithub.com\u002FBigSweetPotatoStudio\u002FHyperChat\u002Fissues\u002F53",{"id":140,"question_zh":141,"answer_zh":142,"source_url":143},36885,"从源码运行开发环境（npm run dev）时，添加 LLM 报错 404 Not Found 如何解决？","在开发模式下，需要分步启动前后端：\n1. 首先构建前端：进入 web 目录运行 `cd web && npm run build`。\n2. 然后启动后端：进入 electron 目录运行 `cd electron && npm run dev:node`。\n注意：不要直接在 Docker 开发环境中运行，8080 端口通常是前端 Webpack 服务，生产环境或测试建议使用 `npx -y @dadigua\u002Fhyper-chat` 运行打包好的版本。","https:\u002F\u002Fgithub.com\u002FBigSweetPotatoStudio\u002FHyperChat\u002Fissues\u002F80",{"id":145,"question_zh":146,"answer_zh":147,"source_url":148},36886,"MCP 工具调用时默认连续执行多个操作，能否像 Cursor 一样一步步确认执行？","该功能已在 v1.2.13 版本中加入。现在调用 MCP 工具时会弹出用户确认框，允许用户逐步确认每个操作，防止自动误操作。请更新到该版本或更高版本即可使用。","https:\u002F\u002Fgithub.com\u002FBigSweetPotatoStudio\u002FHyperChat\u002Fissues\u002F50",{"id":150,"question_zh":151,"answer_zh":152,"source_url":153},36887,"如何修改或自定义内置的系统提示词（System Prompt）？","默认情况下没有强制固定的内置提示词，用户可以完全自定义。你可以通过浏览器的开发者工具（Console\u002FNetwork 标签页）查看发送给 LLM 提供商的具体请求内容，确认提示词是否生效。如果发现效果差异大，可能是不同软件对 Tool 参数的处理方式不同（有的使用原生参数，有的使用提示词注入）。","https:\u002F\u002Fgithub.com\u002FBigSweetPotatoStudio\u002FHyperChat\u002Fissues\u002F94",{"id":155,"question_zh":156,"answer_zh":157,"source_url":158},36881,"安装后提示无法检测到环境，但实际上已经安装了，如何解决？","请尝试更新到最新版本。如果问题仍然存在，请重新提交一个 Issue 以便维护者进一步排查。","https:\u002F\u002Fgithub.com\u002FBigSweetPotatoStudio\u002FHyperChat\u002Fissues\u002F10",{"id":160,"question_zh":161,"answer_zh":162,"source_url":163},36882,"使用 OpenAI 兼容接口添加大模型时，Tool Call（工具调用）测试失败怎么办？","这通常是因为大模型 API 后端不稳定导致的。建议点击“重新生成”按钮重试，并检查工具调用是否有返回内容。如果接口状态显示为红色，说明后端连接有问题。","https:\u002F\u002Fgithub.com\u002FBigSweetPotatoStudio\u002FHyperChat\u002Fissues\u002F23",[165,169,173,178,182,186,190,194,198,202,206,210,215,220,225,229,233,238,242,246],{"id":166,"version":167,"summary_zh":78,"released_at":168},297255,"v2.0.0-alpha.63","2025-08-18T06:52:05",{"id":170,"version":171,"summary_zh":78,"released_at":172},297256,"v2.0.0-alpha.62","2025-08-17T11:16:12",{"id":174,"version":175,"summary_zh":176,"released_at":177},297257,"v1.8.4","* 【英文】https:\u002F\u002Fgithub.com\u002FBigSweetPotatoStudio\u002FHyperChat\u002Fblob\u002Fdoc\u002FChangeLog.md\n* 【中文】https:\u002F\u002Fgithub.com\u002FBigSweetPotatoStudio\u002FHyperChat\u002Fblob\u002Fdoc\u002FChangeLog.zh.md","2025-06-18T07:39:56",{"id":179,"version":180,"summary_zh":176,"released_at":181},297258,"v1.8.3","2025-06-13T08:05:26",{"id":183,"version":184,"summary_zh":176,"released_at":185},297259,"v1.8.2","2025-06-09T10:59:51",{"id":187,"version":188,"summary_zh":176,"released_at":189},297260,"v1.8.1","2025-05-23T12:13:28",{"id":191,"version":192,"summary_zh":176,"released_at":193},297261,"v1.8.0","2025-05-19T06:37:07",{"id":195,"version":196,"summary_zh":176,"released_at":197},297262,"v1.7.3","2025-05-11T10:41:58",{"id":199,"version":200,"summary_zh":176,"released_at":201},297263,"v1.7.0","2025-05-06T00:24:16",{"id":203,"version":204,"summary_zh":176,"released_at":205},297264,"v1.6.5","2025-04-30T07:11:55",{"id":207,"version":208,"summary_zh":176,"released_at":209},297265,"v1.6.4","2025-04-27T06:11:42",{"id":211,"version":212,"summary_zh":213,"released_at":214},297266,"v1.5.4","【英文】 https:\u002F\u002Fgithub.com\u002FBigSweetPotatoStudio\u002FHyperChat\u002Fblob\u002Fdoc\u002FChangeLog.md\n【中文】https:\u002F\u002Fgithub.com\u002FBigSweetPotatoStudio\u002FHyperChat\u002Fblob\u002Fdoc\u002FChangeLog.zh.md","2025-04-20T15:24:45",{"id":216,"version":217,"summary_zh":218,"released_at":219},297267,"v1.5.3","【English】 https:\u002F\u002Fgithub.com\u002FBigSweetPotatoStudio\u002FHyperChat\u002Fblob\u002Fdoc\u002FChangeLog.md\r\n【中文】https:\u002F\u002Fgithub.com\u002FBigSweetPotatoStudio\u002FHyperChat\u002Fblob\u002Fdoc\u002FChangeLog.zh.md","2025-04-20T09:55:04",{"id":221,"version":222,"summary_zh":223,"released_at":224},297268,"v1.5.0","*  【English】 https:\u002F\u002Fgithub.com\u002FBigSweetPotatoStudio\u002FHyperChat\u002Fblob\u002Fdoc\u002FChangeLog.md\r\n*  【中文】https:\u002F\u002Fgithub.com\u002FBigSweetPotatoStudio\u002FHyperChat\u002Fblob\u002Fdoc\u002FChangeLog.zh.md","2025-04-16T11:43:54",{"id":226,"version":227,"summary_zh":223,"released_at":228},297269,"v1.4.17","2025-04-13T13:39:25",{"id":230,"version":231,"summary_zh":223,"released_at":232},297270,"v1.4.16","2025-04-13T07:38:29",{"id":234,"version":235,"summary_zh":236,"released_at":237},297271,"v1.4.6","*  【English】 https:\u002F\u002Fgithub.com\u002FBigSweetPotatoStudio\u002FHyperChat\u002Fblob\u002Falpha\u002FChangeLog.md\r\n*  【中文】https:\u002F\u002Fgithub.com\u002FBigSweetPotatoStudio\u002FHyperChat\u002Fblob\u002Falpha\u002FChangeLog.zh.md","2025-04-09T08:30:49",{"id":239,"version":240,"summary_zh":236,"released_at":241},297272,"v1.4.4","2025-04-07T05:43:02",{"id":243,"version":244,"summary_zh":236,"released_at":245},297273,"v1.4.2","2025-04-04T07:51:52",{"id":247,"version":248,"summary_zh":236,"released_at":249},297274,"v1.4.0","2025-04-01T10:02:23"]