OpenHarness --dry-run 安全预览模式如何零风险验证 AI 智能体运行配置【免费下载链接】OpenHarnessOpenHarness: Open Agent Harness with a Built-in Personal Agent--Ohmo!项目地址: https://gitcode.com/gh_mirrors/op/OpenHarnessOpenHarness 是一个开源的 AI 智能体Agent运行框架内置个人智能体 Ohmo。它的--dry-run安全预览模式能让你在零风险下提前验证 AI 智能体的运行配置——不执行模型、不调用工具、不启动子智能体先看清当前会话将会用到什么。在正式跑一个 AI 智能体之前你往往最担心的是模型配错了吗认证有效吗技能、工具、MCP 服务器是不是都加载对了传统做法只能真跑一把才能发现配置问题既烧 token 又可能触发意料之外的副作用。OpenHarness 的--dry-run模式就是为了解决这个痛点而生的——它做了一次静态预演把运行前的所有关键状态摊开给你看而不产生任何真实的模型调用或工具执行。一、为什么需要 --dry-run 安全预览模式直接运行 AI 智能体的隐患主要有三个烧钱烧 token配置错误照样触发一次完整的模型请求副作用不可控智能体可能真的去执行工具、改动文件或发起调用排查成本高报错往往出现在运行中途难定位根因。--dry-run通过只解析、不执行的方式把这些风险全部挡在真实运行之前。它是刻意保持静态的也就是说行为是否发生调用模型❌ 不会执行工具 / 生成子智能体❌ 不会连接 MCP 服务器❌ 不会解析设置、认证状态、Prompt 组装、技能、命令、工具、MCP 配置✅ 会换句话说它相当于给 AI 智能体做了一次发车前的检修让你安心地在真实运行前把问题找齐。二、--dry-run 快速上手4 条命令即可预览安装完成后只需在命令后追加--dry-run就能进入安全预览模式。以下是官方推荐的 4 种典型用法# 预览一个交互会话的完整配置 oh --dry-run # 预览单条提示词会用到哪些资源不执行模型与工具 oh --dry-run -p Review this bug fix and grep for failing tests # 预览某个 slash 命令的解析路径 oh --dry-run -p /plugin list # 输出结构化 JSON方便脚本或频道消费 oh --dry-run -p Explain this repository --output-format json可以看到--dry-run与--print简写-p组合使用时可以针对任意一条提示词做预览加上--output-format json后预览结果会变成机器可读的结构适合自动化校验或接入其他系统。三、如何读懂 dry-run 输出三级就绪判定--dry-run最实用的地方是它会给出一份明确的就绪判定Readiness并附上可直接照做的下一步动作。判定分为三档ready就绪配置看起来可用下一步通常是直接把提示词跑起来warning警告会话能建立但某处明显有问题比如 MCP 配置损坏、后续模型调用缺少认证blocked受阻当前这条路径无法成功运行例如未知的 slash 命令、或提示词无法解析出运行时客户端。除了档位输出里还会列出Resolved Settings实际生效的 profile、provider、model、base_url、权限模式、最大轮次、effort 等Validation认证状态、API 客户端能否解析、系统提示词长度、MCP 配置错误数量Discovery加载到的插件、技能、slash 命令、内置工具、MCP 服务器数量Likely Matches针对你的提示词智能推荐最可能匹配的技能、工具和命令slash 命令还会标注它是只读read_only还是会改动状态stateful。这套判定 理由 下一步的组合让你不用翻源码就能判断现在到底能不能放心跑。四、3 个最常见的安全预览使用场景场景 1上线前体检团队要把一个新配置推到生产环境前先跑oh --dry-run -p ...确认 provider、模型、认证、工具都齐备且无warning/blocked再真正执行。场景 2排查为什么跑不起来当某个提示词报错时用 dry-run 快速定位是认证缺失、MCP 配置坏了还是 slash 命令写错了输出里的next actions会直接告诉你要做什么。场景 3脚本化校验与 CI借助--output-format json把 dry-run 结果喂给脚本在 CI 流水线里自动校验配置合法性做到配置不对就不放行。 提示slash 命令在预览中会被自动分类。像/help、/status这类属于只读而/plugin、/config、/commit这类属于会改动状态的命令——dry-run 会如实标注帮助你判断该命令会不会动东西。五、使用注意与当前限制为了让零风险名副其实使用时记住几点它不执行任何东西不会真正调用模型、工具或 MCP所以别指望它帮你验证功能对不对它只验证配置和路径对不对-p需要带提示词内容-p 空值会被拒绝需要形如-p your prompt暂不支持--continue/--resume目前--dry-run还不能与继续/恢复会话同时使用输出格式仅支持text默认、json、stream-json三种传其他值会报错退出。想深入了解它的实现可以参考主命令入口 cli.py 中的预览构建逻辑、README 的 Dry Run 章节、变更说明 CHANGELOG.md 以及对应的测试用例 test_cli.py。小结oh --dry-run用一条命令就为你换来了零风险的运行前验证能力三级就绪判定帮你快速判断能否执行详细的配置与资源清单让你看清全貌结构化的 JSON 输出则把安全预览无缝接进了自动化流程。把 dry-run 养成跑智能体前的习惯动作能帮你省下大量排查时间和不必要的 token 消耗。【免费下载链接】OpenHarnessOpenHarness: Open Agent Harness with a Built-in Personal Agent--Ohmo!项目地址: https://gitcode.com/gh_mirrors/op/OpenHarness创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考