The Harmony Extension（和谐扩展）
一个具备主权架构且供应商中立的 AI 合作者，直接在您的 IDE 中连接东西方模型生态系统。
开始之前
The Harmony Extension 在 GitHub 上以实验性软件的形式公开可见。此标签反映的是多模型编排和主权密钥管理的学习曲线——而非不稳定性。THE 稳定、功能完备，对于愿意投入时间理解它的用户而言已可投入生产。协调多个 AI 供应商会产生实际费用，需要审慎配置。请仔细阅读、认真配置、用心协作。
核心功能
Harmony 扩展直接集成到 VS Code 和 Cursor 中，作为专用侧边栏和 @harmony 对话交互角色。除 IDE 之外，THE 还包括命令行界面、终端模式以及实验性的基于 Rust 的独立界面——全部独立于任何编辑器运行。这些界面功能可用，正在积极优化中。除了代码生成，它还作为持久的 AI 合作者，具备工作区感知工具、长期记忆和每项操作的密码学凭证。
@harmony 聊天与侧边栏
一个原生的 VS Code 聊天参与者，拥有完整的工作区访问权限——在每一步都需获得您的明确批准后，方可读取、搜索和编辑文件。
集群规划（Swarm Planning）
多个专业 AI 代理共同审议复杂的架构决策，交叉验证结果，并在执行变更前达成共识。
持久记忆
加密日志、跨项目回忆和连续性交接——让您的 AI 合作者在会话和平台之间保持上下文。
密码学凭证
每次文件编辑、终端命令和供应商调用都生成 SHA256 验证的凭证——为 THE 在工作区中的所有操作提供完整审计追踪。
超越 IDE
命令行界面、终端模式以及实验性的基于 Rust 的独立界面，让您在 VS Code 和 Cursor 之外也能使用 THE。这些功能可用，正在积极优化中。
Ask Harmony（定向提问）
在初始消息中请求逐步对话，或让 Harmony 在需要时于对话中途提出澄清性问题。在各编排步骤之间暂停，裁决分歧、优化提案并保持完整的作者控制权。不是固定模式——而是您在精度至关重要时启用的协作工具，从简单澄清到大规模多模型审议皆可。
供应商架构
建立在主权、供应商中立的架构之上。Harmony 坚持"您的密钥，您的选择"理念——您的代码永远不会经过专有中间件。它通过 VS Code Secret Storage 直接连接您配置的供应商，原生桥接东西方生态系统。
| 东方生态系统 | DeepSeek、Moonshot/Kimi、阿里巴巴/Qwen、腾讯 |
| 西方生态系统 | OpenAI、Anthropic/Claude、Google Gemini、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