3步搞定Harmonist跨平台部署指南Windows/macOS/Linux零依赖原生运行教程【免费下载链接】harmonistPortable AI agent orchestration with mechanical protocol enforcement. 186 agents, zero runtime dependencies.项目地址: https://gitcode.com/gh_mirrors/ha/harmonistHarmonist 是一个可移植的AI 代理编排AI Agent Orchestration框架把 186 个专业代理、机械协议强制钩子和结构化记忆系统空投进你的项目让 Cursor、Claude Code、Copilot 等 AI 编码助手真正遵守工程纪律。它最大的亮点是零运行时依赖——不需要 npm、Docker、向量数据库纯 Python 标准库即可在Windows、macOS、Linux 原生运行Windows 甚至无需 WSL 或 Git Bash。为什么零依赖对新手很重要多数 Agent 框架安装后要折腾 Node 环境、pip 虚拟环境、Docker 容器跨平台更是各种坑。Harmonist 的部署模型完全不同传统框架Harmonist需要运行时 数据库 第三方库纯 Markdown Python 标准库Windows 常需 WSL/Git Bash 兼容原生 Windows 一等公民协议靠 Prompt口头约定钩子Hooks机械强制AI 无法跳过换句话说装好 Python 3.9 就能开始部署这也是整篇教程唯一的前置条件。环境要求一览部署前请确认你的系统满足以下条件详见 README.md 的 Requirements 章节Python 3.9—— 每个脚本内置版本守卫版本过旧会打印对应系统的安装提示Git—— 用于版本追踪Bash 3.2可选—— 仅 POSIX 便捷脚本需要所有集成/升级/安装工具均为纯 Python一个支持子代理Subagent分发的 AI 编码助手—— Cursor 为主力集成另支持 Claude Code、Copilot、Windsurf、Aider 等 11 款工具 macOS 自带 PythonUbuntu 通常预装Windows 建议从 python.org 安装自带py启动器后面会用到。第一步克隆仓库到项目根目录把 Harmonist 克隆为项目根目录下的一个子文件夹不要解压散落在项目根cd your-project/ git clone https://gitcode.com/gh_mirrors/ha/harmonist harmonist文件夹名可以任意文档中统一称PACK_DIR本教程示例用harmonist。第二步三选一完成集成方式 ACursor AI 自动集成推荐 用 Cursor 打开项目切换到Agent 模式粘贴 integration-prompt.md 的全部内容跟着 AI 向导走它会分析你的技术栈、询问项目启用的角色工程/设计/产品/营销等然后自动完成所有接线AI 会自动读取 agents/index.json 挑选匹配的专家、从 AGENTS.template.md 生成你的项目专属AGENTS.md、初始化.cursor/memory/并安装强制钩子。完成后开一个新对话规则即生效。方式 BmacOS / Linux 命令行集成不用 Cursor一条命令搞定integrate.pycd your-project/ python3 harmonist/agents/scripts/integrate.py --pack harmonist --project .该脚本会机械完成 9 步健康预检 → 写入钩子/严格代理/记忆工具 → 自动探测回归命令 → 生成AGENTS.md→ 引导规则文件 → 写入集成状态记忆 → 冒烟测试 → 客观验证器 → 打印剩余手工步骤。方式 CWindows 原生集成无需 WSL在 PowerShell 中直接用py -3启动器python.org 安装包自带cd your-project\ git clone https://gitcode.com/gh_mirrors/ha/harmonist harmonist py -3 harmonist\agents\scripts\integrate.py --pack harmonist --project .所有脚本均为跨平台纯标准库实现。v1.2.1/v1.2.2 还专门修复了 Windows 控制台的 Unicode 编码问题状态符号乱码、UTF-8 目录读取确保py -3路径在原生 Windows 上端到端可用——详见 CHANGELOG.md。第三步验证部署是否成功跑一下集成验证器它会以客观标准审计你的部署缺什么、改了什么一目了然# macOS / Linux python3 harmonist/agents/scripts/verify_integration.py # Windows 原生 py -3 harmonist\agents\scripts\verify_integration.py全部通过即表示钩子已安装、严格代理已就位、记忆系统已初始化、.gitignore隐私加固已完成。跨平台钩子是怎么工作的Harmonist 的强制层位于 hooks/ 目录集成时会安装到项目的.cursor/hooks/。每个钩子事件会话开始、文件编辑、子代理启停、Shell 命令拦截、结束门禁都有双实现POSIX.sh脚本—— 面向 macOS / Linux / WSL纯 Python hook_runner.py—— 所有操作系统的激活路径原生 Windows 上唯一的路径upgrade.py 会按宿主系统自动渲染 hooks/hooks.jsonWindows 写入py -3启动器POSIX 写入python3你不需要手工操心。.gitattributes 还固定了eollf避免 Windows 换行符破坏MANIFEST.sha256校验。核心的stop门禁会检查本次会话是否运行了qa-verifier、是否更新了session-handoff.md记忆。任何一项缺失回合就无法结束——AI 说我做完了没有用磁盘上的状态机说了算。常用后续操作 场景命令 / 文件给已集成项目添加专家python3 agents/scripts/install_extras.py --role marketing升级到新版带快照回滚upgrade.py审计包完整性每次git pull后python3 agents/scripts/check_pack_health.py了解首次使用细节GUIDE_EN.md记忆系统 Schemamemory/SCHEMA.md可选 7 阶段生命周期手册playbooks/常见问题 FAQQWindows 上真的不用 WSL 吗是的。原生 Windows 走纯 Python 的hook_runner.py钩子路径与 POSIX 脚本行为逐位对齐并有专门的 Windows CI 任务端到端验证安装路径。Q没有 Cursor 能用吗能。CLI 方式 B/C 对任何操作系统都适用包内还附带 10 款其他 AI 工具的转换器agents/scripts/convert.py --tool name。Q会上传我的数据吗不会。遥测仅记录到本地.cursor/telemetry/agent-usage.json纯 JSON、gitignored想彻底关闭可在.cursor/hooks/config.json设置telemetry_enabled: false。Q186 个代理会不会太臃肿不会。路由按domains × roles × tags交集过滤实际激活通常只有 10–20 个专家其余按需安装。总结Harmonist 的部署哲学就是一个文件夹、一个提示词、零依赖✅git clone到项目子目录✅ AI 提示词或一行 Python 完成集成✅ 验证器绿灯即开工Windows、macOS、Linux 三端命令几乎一致唯一区别是py -3与python3的启动器写法。现在就可以试试——让 AI 助手从口头守规矩变成机械守规矩。【免费下载链接】harmonistPortable AI agent orchestration with mechanical protocol enforcement. 186 agents, zero runtime dependencies.项目地址: https://gitcode.com/gh_mirrors/ha/harmonist创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考