The Harmony Extension（和谐扩展）
一个具备主权架构且提供商中立的 AI 合作者，直接在您的 IDE 中连接全球模型生态系统。
开始之前
The Harmony Extension 在 GitHub 上以实验性软件的形式公开可见。此标签反映的是多模型编排和主权密钥管理的学习曲线——而非不稳定性。THE 稳定、功能完备，对于愿意投入时间理解它的用户而言已可投入生产。协调多个 AI 提供商会产生实际费用，需要审慎配置。请仔细阅读、认真配置、用心协作。
核心功能
Harmony 扩展直接集成到 VS Code 和 Cursor 中，作为专用侧边栏和 @harmony 对话交互角色。除 IDE 之外，THE 还包括命令行界面、终端模式以及实验性的基于 Rust 的独立界面——全部独立于任何编辑器运行。这些界面功能可用，正在积极优化中。除了代码生成，它还作为持久的 AI 合作者，具备基于 15 个集群原语的 175+ 个工作区工具、长期记忆和每项操作的密码学凭证。
@harmony 聊天与侧边栏
一个原生的 VS Code 聊天参与者，拥有完整的工作区访问权限——在每一步都需获得您的明确批准后，方可读取、搜索和编辑文件。
集群规划（Swarm Planning）
多个专业 AI 智能体共同审议复杂的架构决策，交叉验证结果，并在执行变更前达成共识。
持久记忆
加密日志、跨项目回忆和连续性交接——让您的 AI 合作者在会话和平台之间保持上下文。
密码学凭证
每次文件编辑、终端命令和提供商调用都生成 SHA256 验证的凭证——为 THE 在工作区中的所有操作提供完整审计追踪。
超越 IDE
命令行界面、终端模式以及实验性的基于 Rust 的独立界面，让您在 VS Code 和 Cursor 之外也能使用 THE。这些功能可用，正在积极优化中。
Ask Harmony（定向提问）
在初始消息中请求逐步对话，或让 Harmony 在需要时于对话中途提出澄清性问题。在各编排步骤之间暂停，裁决分歧、优化提案并保持完整的作者控制权。不是固定模式——而是您在精度至关重要时启用的协作工具，从简单澄清到大规模多模型审议皆可。
上下文缓存管理
中段移除式上下文编辑通常会破坏前缀缓存。Harmony 在长上下文主模型上保持 98% 的输入 token 缓存命中，覆盖 25 亿输入 token（2026 年 6 月）。Flash 集群扇出每次调用携带独立上下文，因此无可缓存内容。
独特能力
目前没有任何其他 AI 编码助手提供的功能——每一项都是 Harmony 首创。
耳语模式（Whisper Mode）
在工作进行中给 Harmony 发消息——无需打开聊天或重新开始。一个单向异步的人→AI 侧通道。
Concert Hall 协作空间
持久的多智能体协作空间，重启后依然保留——AI 推理过程的可审查记录。
心流模式（Flow State Mode）
自动进入下一个自然步骤，并总是询问下一步——专为神经多样性用户设计。
跨对话连续性
在 Copilot、Harmony、Gemini 和终端之间保持同一条上下文线索——无缝接续。
可逆变更账本
每次受追踪的变更都被记录并可回滚——撤销文件写入、终止派生进程、从中断中恢复。
自愈机制（Self-Healing Harness）
SHA256 验证的原子化编辑与检查点——不会出现部分写入，失败的编辑自动回滚。
HarmonyHub 本地主权记忆
本地优先的主权记忆——您的上下文永不离开您的设备。
翻译中心（Translation Hub）
基于多模型共识的英中翻译，防范单一模型错误——专为技术标准文档打造。
CareBloom 自学习工具使用
自我改进的工具使用能力，本地学习，零额外 API 调用（默认关闭）。
创意工具（Creative Tools）
通过本地创意后端实现图像生成、画布编辑与视频生成。
中英本地化
完整的中英双语界面、150+ 条翻译字符串与中文 README——从侧边栏即时切换。
提供商架构
建立在主权、提供商中立的架构之上。Harmony 坚持"您的密钥，您的选择"理念——您的代码永远不会经过专有中间件。它通过 VS Code Secret Storage 直接连接您配置的提供商。每个提供商支持最多 4 个 API 密钥槽位——聊天、智能体、外部与视觉——让不同密钥承担不同职责。
| 提供商 | 阿里巴巴/Qwen、Anthropic/Claude、字节跳动/豆包、DeepSeek、Google Gemini、Kimi Code、Moonshot/Kimi、OpenAI、StepFun、腾讯、智谱 Coding、智谱/GLM |
| 聚合器 | OpenRouter —— 通过单一密钥路由至上述提供商及其他模型 |
| 本地与内置 | VS Code LM（Copilot），本地模型（规划中） |
未配置 API 密钥 = 无外部调用。按需逐步添加提供商。端点控制可将请求路由到国际、中国大陆或其他区域端点。Harmony 既能处理日常编码，也能进行编排——对独立开发者而言通常成本更低。如需同时使用两者，Copilot 交叉使用模式可供选择。
编排模式
THE 不是一键自动化工具。它奖励投入、专注的沟通——协作越深入，能力越强大。编排让您配置多个模型处理不同职责——起草、审查、验证——然后共同审议结果。参数由您定义：哪些模型、什么角色、多少轮审查，以及是否在各步骤之间暂停以获取您的意见。
策略性模型选择
根据各模型的优势，定义哪些模型处理哪些职责。您可以将架构推理分配给一个提供商，将边缘案例分析分配给另一个——选择权在您手中，每次分配均可配置。
人机协同
让 Harmony 在各步骤之间使用有针对性的提问，创建专注的对话。这使您能够裁决分歧、优化提案并保持完整的作者控制权——但这是您主动参与的协作模式，而非自动关卡。可能产生额外的 API 调用；在启用逐步确认之前，请先了解成本模型。
多模型共识
当模型意见不一，更强大的解决方案随之浮现——每个视角不断优化结果，直至一个和谐的方案被呈现。
集群共识、密码学凭证和跨模型验证自动运行——THE 自行验证，无需暂停。但有意义的共识并非自动驾驶：在发送请求或通过 Ask Harmony 回应时，分享您的参数（哪些模型、多少轮次、什么角色）。您定义范围；Harmony 协助审议。人机协同监督通过 ask_question 模式可用但为可选项——启用后可在各步骤之间暂停，以便您进行有针对性的审查和反馈。
⚠️ 编排可从单一咨询扩展至大规模、多层次的审查：集群互相检查工作成果，并行集群交叉验证，模型在汇报前进行共识轮次——Harmony 如同指挥一场复杂的交响乐，规模取决于任务需求。一份经过编排的文档可能产生数十次 API 调用。请审慎使用，逐步审查，如费用超出预期请立即停止。
翻译中心（EN↔ZH）
一个严谨的文档翻译流水线，支持英文 ↔ 中文，专为技术标准、法律文件和工程规范设计。多模型共识确保准确性——而非单一模型的最佳猜测。
- ◆多模型翻译，跨 2–4 个提供商进行交叉验证
- ◆标准感知：保留 GB/T、CJJ、JGJ 编号和条款锚点
- ◆采用 AES-256-GCM 加密的术语表——您的术语保持私密
- ◆争议账本追踪每个有争议的术语选择，提供完整审计追踪
- ◆批处理模式：处理整个文件夹，提供逐文档费用保护
AI 生成的翻译——对于关键、法律或技术内容，请始终由合格的人类翻译人员审核。内容仅传输至 AI 提供商进行处理；Harmony 或提供商均不保留任何数据。
成本与责任
运营多提供商集群需要有意识的财务监督。THE 的力量源于并行咨询多个模型——而这种力量伴随着真实的成本。
您控制密钥
Harmony 只调用您明确配置的提供商。未配置密钥 = 无外部调用。逐步添加密钥，逐一测试。
多提供商 = 成本倍增
集群、编排和翻译每次操作调用 2–4 个模型。单次请求可能触发数十次 API 调用。
保护措施为尽力而为
费用保护措施有助于管理支出，但提供商定价可能随时变更。没有自动上限是万无一失的。
您承担责任
定期查看提供商账单仪表板。Harmony 无法预测、限制或退还提供商费用。
如果您不完全理解某个功能的作用或可能的费用——请不要使用它。放弃使用某个功能，总比面临意外的 API 账单更安全。
快速开始
git clone https://github.com/eternalharmonyai/the-harmony-extensionnpm installnpm run compile在 VS Code 中按 F5 打开扩展开发主机直接安装到您的主 VS Code 或 Cursor：npm run install:vsix:both