人工智能AI AgentAgent 框架代码智能体工具调用MCP 服务Agent 记忆多智能体【免费下载链接】OpenHarnessOpenHarness: Open Agent Harness with a Built-in Personal Agent--Ohmo!项目地址https://gitcode.com/gh_mirrors/op/OpenHarness点击查看免费下载OpenHarness v0.1.8Providers, ohmo Feishu Groups, and Safer Remotes是面向稳定性和 Provider 扩展的版本新增多个一等公民的模型服务商工作流、完善 ohmo 在飞书群组中的体验、加固远程通道安全并修复若干 Windows 与 MCP 可靠性问题。本文以版本发布说明为主体结合当前仓库源码逐项解析新增能力、配置参数与底层实现帮助读者理解各功能的启用方式、适用前提与源码依据。一、版本定位与安装v0.1.8 延续 OpenHarness Open Agent Harness with a Built-in Personal Agentohmo的定位属于稳定化 Provider 扩展版本核心改动集中在四类Provider 工作流、ohmo 飞书群组、远程通道安全、Windows/Shell 可靠性。安装方式发布说明原文pip install --upgrade openharness-ai0.1.8也可以从仓库文档中的安装脚本执行scripts/install.sh、scripts/install.ps1开发环境可用 scripts/install_dev.sh。二、新增 Provider 工作流2.1 内置 OpenAI 兼容 ProviderNVIDIA NIM发布说明新增 NVIDIA NIM 为内置 OpenAI 兼容 Provider使用NVIDIA_API_KEY。源码中 src/openharness/config/settings.py 定义了对应内置档案nvidia: ProviderProfile( labelNVIDIA NIM, providernvidia, api_formatopenai, auth_sourcenvidia_api_key, default_modelopenai/gpt-oss-120b, base_urlhttps://integrate.api.nvidia.com/v1, ),环境变量读取顺序为OPENHARNESS_NVIDIA_API_KEY→NVIDIA_API_KEY见 settings.py 的auth_source_env_var_candidates因此同时支持带OPENHARNESS_前缀的全局配置变量与标准变量默认模型为openai/gpt-oss-120b默认端点https://integrate.api.nvidia.com/v1在 src/openharness/swarm/spawn_utils.py 中OPENHARNESS_NVIDIA_API_KEY与OPENHARNESS_MINIMAX_API_KEY被列入子进程环境透传列表说明 swarm 多智能体场景下密钥会随 teammate 传递。2.2 ModelScope 与 QwenDashScopeModelScope内置档案见 settings.pyauth_sourcemodelscope_api_key、默认模型deepseek-ai/DeepSeek-V4-Flash、端点https://api-inference.modelscope.cn/v1对应环境变量为MODELSCOPE_API_KEY见 src/openharness/api/registry.py 的 ProviderSpec。该特性由外部贡献者 Mcy0618 提交PR #224。QwenDashScope内置档案见 settings.pyproviderdashscope、auth_sourcedashscope_api_key、默认模型qwen-plus、端点https://dashscope.aliyuncs.com/compatible-mode/v1。该档案由 ZevGit 的 PR #207 引入。2.3 MiniMax 与 GeminiMiniMaxsettings.py 中default_modelMiniMax-M2.7、端点https://api.minimax.io/v1Geminisettings.py 中default_modelgemini-2.5-flash、端点https://generativelanguage.googleapis.com/v1beta/openai走 OpenAI 兼容模式。两者均在 registry.py 注册 ProviderSpecGemini 的env_keyGEMINI_API_KEYMiniMax 的env_keyMINIMAX_API_KEY。2.4 Provider 注册与检测机制所有 Provider 元数据集中在 src/openharness/api/registry.py 的PROVIDERS元组中这是单一事实来源single source of truth检测、展示、配置均由此派生。ProviderSpec支持三种后端类型anthropic走 Anthropic SDKclaude-* 模型默认openai_compat走 OpenAI 兼容 REST API绝大多数新增 Provider 属此类copilot走 GitHub Copilot OAuth 流程。自动检测优先级registry.pyAPI Key 前缀如sk-or-→ OpenRouterbase_url 关键字如 URL 中含modelscope→ ModelScope模型名关键字如qwen→ DashScope。注意内置 Provider 档案ProviderProfile与检测注册表ProviderSpec是两个层面——档案决定配置默认值与显示标签注册表负责运行时自动识别。2.5 OpenAI 兼容行为的改进发布说明提到的两点改进在 src/openharness/api/openai_client.py 中均有源码对应显式 Bearer 授权头客户端构造请求时使用显式default_headers: {Authorization: fBearer {api_key}}openai_client.py确保各兼容服务商正确识别鉴权。think块过滤兼容流式响应中客户端按 chunk 缓冲文本仅在闭合后剥离完整think.../think块未闭合的think会暂存等待下一 chunkopenai_client.py。正则_THINK_RE re.compile(rthink.*?/think, re.DOTALL)支持跨行匹配。该功能由 yl-jiang 的 PR #174 提交。此外思考型模型的reasoning_content往返逻辑也得到处理有捕获的推理内容时总是回放对严格 OpenAI 兼容服务商如 Cerebras、NVIDIA NIM、OpenAI 直连默认省略空的reasoning_content字段避免 400wrong_api_format错误Kimi 系则可通过环境变量OPENHARNESS_REQUIRE_EMPTY_REASONING_CONTENT1选择补齐空字段openai_client.py。三、ohmo 飞书群组支持3.1 受管群组创建流程发布说明新增飞书受管群组创建流程对应源码 ohmo/gateway/group_tool.py 中的ohmo_create_feishu_group工具仅当当前入站消息是飞书私聊的/group请求时允许执行ohmo_group_request元数据校验校验 channel 为feishu且 chat_type 为p2p/private/im/direct等私聊类型拒绝群聊直接创建创建成功后通过 ohmo/group_registry.py 的save_managed_group_record持久化受管群组记录含 owner open_id、channel、repo 等元数据并发布欢迎消息。可见该流程遵循私聊发起、群组落地的安全模型群组只能由已认证的私聊请求者创建避免群成员越权拉群。3.2 网关作用域的 Provider/Model 命令新增gateway-scoped网关作用域的 provider/model 命令实现在 ohmo/gateway/provider_commands.pyhandle_gateway_provider_command处理 provider 相关命令handle_gateway_model_command处理 model 相关命令。在 ohmo/gateway/runtime.py 中_handle_gateway_scoped_command按命令名路由到上述两个处理函数供 chat 场景聊天操作使用而不是在本地 TUI 中执行。3.3 群路由与提及策略发布说明ohmo 只在被明确 时响应共享飞书群的策略由群路由与提及策略共同实现ohmo/gateway/group_tool.py、ohmo/gateway/bridge.py群聊消息必须满足提及条件才会触发 ohmo 响应从而避免机器人在共享群中抢答。3.4 飞书附件文件名加固飞书渠道的附件文件名处理被加固相关逻辑位于 src/openharness/channels/impl/feishu.py防止恶意文件名带来的路径风险该渠道另有独立安全测试 tests/test_channels/test_feishu_security.py。四、安全与远程通道加固4.1 敏感命令默认仅本地可用发布说明的核心安全策略敏感配置/认证/Provider/模型/移植ship命令默认仅在本地通道可用。源码在 ohmo/gateway/runtime.py远程管理命令是白名单 显式 opt-in机制命令需声明remote_admin_opt_inTrue网关配置需同时设置allow_remote_admin_commandsTrue且命令名在allowed_remote_admin_commands列表中配置字段见 ohmo/gateway/models.py未被允许的命令在远程通道返回/{command} is only available in the local OpenHarness UI.。bridge 命令同样默认仅本地可用bridge 相关命令ohmo/gateway/bridge.py的远程调用被默认阻止并有对应测试覆盖 bridge spawn 阻断行为见 tests/test_ohmo/test_gateway.py。4.2 插件卸载的路径穿越防护发布说明Rejected path traversal names during plugin uninstall卸载插件时拒绝路径穿越名称。插件加载与元数据解析在 src/openharness/plugins/loader.py路径安全校验的同类实现可参见 src/openharness/memory/team.pyValidate a write target against traversal and symlink escape即对写入目标做目录穿越与符号链接逃逸双重校验。该安全修复由 Hinotoi-agent 的多项远程命令安全 PR#232、#209、#208、#198、#197引入。五、Windows 与 Shell 可靠性5.1 Windows 子智能体直执行发布说明Windows agent/subagent spawning by direct-executing teammate argv instead of shell-wrapping Python paths修复 nsxdavid 的 PR #231在 Windows 上teammate 的 argv 直接执行 Python 路径不再通过 shell 包装避免路径空格/引号导致的启动失败。相关代码在 src/openharness/swarm/spawn_utils.py。5.2 Windows Shell 解析回退Windows shell 解析现在会跳过无法实际运行命令的bash.exe回退到 PowerShell/cmd见 src/openharness/utils/shell.py。同时避免在 Windows 上通过 shell 打开浏览器相关改动来自 glitch-ux 的 PR #217。5.3 Windows 网关进程生命周期改进 Windows 网关进程生命周期处理Escapingbug 的 PR #193、#192相关实现位于 ohmo/gateway/ 与 src/openharness/ui/backend_host.py。六、MCP、工具与稳定性6.1 MCP 启动隔离MCP 启动时隔离失败的服务器而不是让整个 OpenHarness 启动失败Litianhui888 的 PR #237。这意味着单个 MCP 服务器配置错误不会阻塞主程序启动MCP 客户端错误处理可参见 src/openharness/mcp/client.py 与测试 tests/test_mcp/。6.2 子进程 stderr 管道死锁修复修复 grep/glob/bash/session runner 路径的子进程 stderr 管道死锁yl-jiang PR #205、flobo3 PR #179对应实现 src/openharness/tools/grep_tool.py、src/openharness/tools/glob_tool.py、src/openharness/tools/bash_tool.py。6.3 大工具结果截断与上下文压缩在会话历史中限制大型工具结果并改进大/视觉上下文下的压缩行为。相关逻辑位于 src/openharness/services/tool_outputs.py 与 src/openharness/services/compact/。6.4 Skill frontmatter 的 YAML safe_load改进内置与用户技能的 frontmatter 解析统一使用yaml.safe_loadvoidborne-d 的 PR #229。源码证据src/openharness/skills/_frontmatter.py解析---定界的 YAML frontmatter明确注明使用safe_load避免任意对象反序列化src/openharness/coordinator/agent_definitions.pyagent 定义的 frontmatter 同样采用yaml.safe_load。七、TUI 与 UX 修复raw DEL 退格恢复修复 macOS Terminal 风格环境下的原始DEL退格处理powAu3 的 PR #182斜杠命令补全改进 slash-command 补全体验he-yufeng 的 PR #185Markdown 表格渲染、Spinner 行为、Esc 中断均有改进image-to-text 回退为纯文本模型提供 image-to-text 回退能力并支持--vision-model覆盖参数Mcy0618 的 PR #227。多模态能力检测见 src/openharness/api/provider.py 的_MULTIMODAL_MODEL_PATTERNS与is_model_multimodal()其设计上对未知模型默认返回 False从而触发 image-to-text 回退工具而非静默失败。八、版本安装与升级路径升级到 v0.1.8pip install --upgrade openharness-ai0.1.8v0.1.8 之后v0.1.9见 RELEASE_NOTES_v0.1.9.md作为小版本跟进补充了 bundledskill-creator技能、用户可调用的技能斜杠命令以及oh setup/oh provider edit profile --api-key key的 Provider API Key 更新路径。若你正从 v0.1.8 向上升级可关注这两个版本的衔接。九、总结v0.1.8 的价值在于把接更多模型和远程更安全两条线同时做实Provider 层面NVIDIA NIM、ModelScope、QwenDashScope、MiniMax、Gemini 以 OpenAI 兼容方式内置配合 API Key 前缀/base_url/模型名三级自动检测实现了改配置即切换的 Provider 扩展模型安全层面敏感命令与 bridge 命令默认仅本地可用、远程管理命令白名单 opt-in、路径穿越防护把远程渠道飞书、Telegram 等的攻击面收窄稳定性层面MCP 启动隔离、stderr 管道死锁修复、Windows 子进程直执行让日常使用与多智能体 swarm 场景更可靠。对于需要在共享群中部署 ohmo、或希望快速接入更多兼容服务商的用户v0.1.8 提供的机制内置 ProviderProfile 注册表检测 网关命令白名单都可以直接作为后续版本的参照基线。赞分享人工智能AI AgentAgent 框架代码智能体工具调用MCP 服务Agent 记忆多智能体【免费下载链接】OpenHarnessOpenHarness: Open Agent Harness with a Built-in Personal Agent--Ohmo!项目地址https://gitcode.com/gh_mirrors/op/OpenHarness点击查看免费下载相关推荐OpenHarnessoh入门指南安装、Provider 配置、Dry-run 安全预览与 ohmo 个人 Agent 实战OpenHarness oh 入门指南安装、Provider 配置、Dry run 安全预览与 ohmo 个人 Agent 实战 OpenHarness人工智能AI AgentAgent 框架代码智能体工具调用MCP 服务Agent 记忆多智能体Kubernetes v1.7 版本深度解析安全加固、有状态应用与可扩展性里程碑Kubernetes v1.7 版本深度解析安全加固、有状态应用与可扩展性里程碑 本文以 CHANGELOG 1.7.md https://link.gitc云原生容器编排集群管理微服务OpenProject 14.3.0 版本解析主机头安全加固、项目列表新能力与 API 扩展全览OpenProject 14.3.0 版本解析主机头安全加固、项目列表新能力与 API 扩展全览 OpenProject 14.3.0 于 2024 07 1后端前端项目管理企业应用协同办公上一篇iOS设备型号识别ipwndfu如何通过CPID判断设备兼容性下一篇builder1/builder性能优化技巧让你的网站加载速度提升50%创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考