如何 10 分钟上手 LongHorizon-Harness:从安装到跑通第一个桌面自动化任务的快速教程

发布时间:2026/10/11 12:21:33
如何 10 分钟上手 LongHorizon-Harness:从安装到跑通第一个桌面自动化任务的快速教程 人工智能AI AgentAgent 工作流Agent 评测GUI 自动化【免费下载链接】LongHorizon-HarnessThe long-horizon computer-use harness. Run AI agents across desktop apps and the CLI for extended periods while preserving task state and making reliable progress on complex workflows. Features fresh-context execution, durable verified state, independent auditing, recoverable progress, and native Claude Code / Codex / OpenClaw integration.项目地址https://gitcode.com/gh_mirrors/lo/LongHorizon-Harness点击查看免费下载LongHorizon-Harness 是一个面向 AI Agent 的长程电脑使用computer-use执行框架你只需给出一次目标它就能驱动 Claude Code、Codex、OpenCode 或 DeepSeek Harness跨桌面 App 和终端连续工作数十小时并且每一步都会在真实环境中被验证、被存档。本文是一份新手友好的快速教程环境检查 → 一键安装 → 项目初始化 → 在网页工作台或命令行中跑通第一个桌面自动化任务全程约 10 分钟。先懂原理三个角色组成的执行闭环LongHorizon-Harness 的核心思想是Loop Engineering闭环工程不训练新模型而是给现有 Agent 套上一层规划 → 执行 → 验证 → 保存或恢复的循环。它内部有三个职责清晰的分工角色干什么一句话理解Manager调度每轮重建任务全貌决定下一步做什么项目的项目经理⚡Executor执行用全新上下文完成一项边界明确的操作点鼠标、跑命令动手的执行者Auditor审计独立检查真实文件、界面、日志不轻信执行者的汇报把关的质检员只有通过 Auditor 独立验证的进度才会被保存为可信状态失败的结果只作为证据进入下一轮。这意味着任务即使中途失败或上下文刷新也能从上一个检查点可靠恢复——这正是长程桌面自动化可靠性的来源。三个角色的完整实现分别在 src/lh_harness/manager.pyManager 调度逻辑、src/lh_harness/auditor_agent.py独立审计感兴趣的读者可以直接阅读源码。环境准备4 项依赖快速清单开始前确认电脑上具备以下条件lh-harness doctor会帮你逐项检查依赖用途备注Python 3.10运行框架本体uv tool install会自带独立环境uv推荐隔离式安装习惯 pip 也可以跳过一个 Agent CLI实际执行任务claude/codex/opencode/dsh任选其一Node.js 20GUI 电脑操作插件需要任务不碰 GUI 可不装 目前官方在 macOS 上测试最充分Windows 可用但未经完整测试。一键安装步骤两行命令搞定第 1 步安装 LongHorizon-Harness 本体uv tool install lh-harness # 或者pip install lh-harness第 2 步可选安装电脑操作插件如果你的任务不涉及点击桌面软件纯命令行任务可以跳过这步。需要操作 GUI 时按你使用的 Agent 安装对应插件# 使用 Codex lh-harness plugin install codex-computer-use # 使用 Claude Code或两者都用 lh-harness plugin install open-computer-use插件安装一次即覆盖本机所有项目macOS 上需要手动到系统设置 → 隐私与安全性中授权辅助功能和屏幕录制权限安装过程会提示。第 3 步环境自检lh-harness doctordoctor是只读检查会报告 Python 运行时、各 Agent CLI通过实际执行--version验证而非仅查找路径、Node.js 和插件状态有任何一项失败都会给出修复提示。项目初始化生成专属配置文件进入你想让 Agent 操作的项目目录执行cd /path/to/your/project lh-harness init这会在项目下生成./.lh-harness/config.toml已存在则不覆盖可用--force重新生成。配置文件的核心是[run]段agent/model全局默认后端与模型如codexgpt-5.6-solmax_rounds最多允许的规划-执行-审计轮数默认 30dashboard是否在每次运行时自动打开网页监控台[run.roles.*]为每个角色单独指定后端和模型——比如用旗舰模型做 Manager 和 Auditor用便宜快速的模型做 Executor按需控制成本完整的字段说明见 src/lh_harness/config.py 与 README.zh-CN.md 中的配置参考章节。跑通第一个桌面自动化任务两条路径任选路径 A浏览器工作台推荐新手lh-harness web --workspace-root .浏览器会自动打开http://127.0.0.1:8799/的 Web 工作台。在这里你可以为每个角色分别选择后端和模型、发起任务、处理审批请求、运行中追加指令、随时停止或重启。工作台前端源码位于 frontend/web/src/服务端在 src/lh_harness/dashboard/ 和 src/lh_harness/webapi/。路径 B命令行直接运行TASK检查当前目录并总结其中的文件结构。 lh-harness run --task ${TASK} --agent codex几个实用细节命令行参数如--agent会临时覆盖配置文件中的同名字段任务默认作用于你启动命令的目录.lh-harness/目录本身受保护不会把日志误当成任务内容长任务建议写成文件再运行lh-harness run --task task.md每次运行结束后你会得到一段基于已验证状态的自然语言总结任务未完成时会直说未完成。运行中你能看到什么运行期间控制台按角色逐行打印进展Dashboard 则展示每一轮的 计划 → ⚡ 执行结果 → 审计证据 → ♻️ 返工原因。所有运行产物任务状态、事件流、审计报告、各角色轨迹、最终报告都保存在./.lh-harness/runs/run-id/下完整报告在logs/report.json让每一次进度都可检查、可恢复、可复现。效果实测同一模型只换执行框架LongHorizon-Harness 不是靠个别成功案例撑场面而是在数百个 GUI CLI 混合的真实任务上做了规模化评测同一骨干模型 Qwen 3.7-Plus、同一执行后端只改变外层框架基准指标Claude Code 裸跑LongHorizon-Harness提升WeaveBench114 个 GUICLI 任务PassRate51.880.728.9OSWorld 2.0108 个桌面工作流完整完成率2.88.33.0×Terminal-Bench 2.1CLI 长程任务成功率69.777.27.5且 token 少 24%三大基准的完整复现套件随仓库提供分别位于 eval/WeaveBench-harness/、eval/OSWorldv2-harness/ 和 eval/TB-harness/每个目录都配有环境配置与启动脚本说明。源码结构速览与常见问题核心源码全部在 src/lh_harness/ 下几个值得关注的入口命令行入口src/lh_harness/cli.pyAgent 后端适配Claude Code / Codex / OpenCode / DeepSeeksrc/lh_harness/adapters/本地执行环境src/lh_harness/environment/local.py角色提示词src/lh_harness/role_prompts.py如果想通读源码可以克隆仓库浏览git clone https://gitcode.com/gh_mirrors/lo/LongHorizon-Harness新手常见卡点排查doctor报 Agent CLI 失败 → 常见于 Windows 上 Microsoft Store 安装留下的 0 字节codex.exe别名按doctor输出的提示重装 CLI 即可macOS 上 GUI 操作无反应 → 检查辅助功能和屏幕录制权限是否已授权单轮超时 → 运行会保留部分轨迹和已验证状态下一轮 Manager 会自动从工作区现状中恢复无需人工干预版本问题 →lh-harness check-update可随时检查 PyPI 上的新版本。写在最后LongHorizon-Harness 把让 AI 用一次鼠标变成了让 AI 连续可靠地工作数十小时规划、执行、独立验证、断点恢复四件事它都替你工程化好了。现在就可以运行uv tool install lh-harness给自己定一个跨 App 的实际任务10 分钟后你会拥有一个真正跑起来的桌面自动化系统。赞分享人工智能AI AgentAgent 工作流Agent 评测GUI 自动化【免费下载链接】LongHorizon-HarnessThe long-horizon computer-use harness. Run AI agents across desktop apps and the CLI for extended periods while preserving task state and making reliable progress on complex workflows. Features fresh-context execution, durable verified state, independent auditing, recoverable progress, and native Claude Code / Codex / OpenClaw integration.项目地址https://gitcode.com/gh_mirrors/lo/LongHorizon-Harness点击查看免费下载相关推荐5分钟快速上手Guardian从安装配置到跑通第一个AI自动化渗透测试5分钟快速上手Guardian从安装配置到跑通第一个AI自动化渗透测试 Guardian 是一款 AI 驱动的渗透测试自动化 CLI 工具 只需安装 PytDLSS Swapper 批量替换 DLSS 文件7 大平台游戏统一管理 DLSS 版本DLSS Swapper 批量替换 DLSS 文件7 大平台游戏统一管理 DLSS 版本 场景切入 你刚给《赛博朋克 2077》调完画质却发现新版本的 DL桌面应用Buzz离线音频转录工具用 Whisper 在本地完成语音转文字Buzz离线音频转录工具用 Whisper 在本地完成语音转文字 开会录音、播客内容、课程讲解想转成文字却又不放心把音频传到云端Buzz 基于 Open人工智能语音音频本地部署桌面应用创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考

关于本文作者

来自尧图内容编辑团队

尧图内容编辑团队 内容团队

尧图内容编辑团队

本文由尧图网络内容编辑团队执笔。团队由资深项目经理、前端工程师与设计师组成,所有内容均来自亲手交付的真实项目,先讲清问题、再给出可落地的解法。尧图深耕北京网站建设十年,服务过京华建材集团、智造科技等各行业客户,把一线经验沉淀为可复用的行业观察。

  • 十年建站经验,覆盖建材、制造、服务、文创等
  • 项目经理把关选题与事实准确性
  • 工程师与设计师联合撰写专业细节
  • 统一编辑规范,保证文风与排版一致
  • 每月复盘转化数据,迭代选题方向

延伸阅读

相关资讯与近期热门内容

深度阅读推荐

建站决策前值得细读的三篇

网站改版的5个关键决策
2024-08-12

网站改版的5个关键决策

什么时候该改版、改到什么程度、如何避免流量掉光,京华建材集团改版复盘给出答案。

获取专属建站方案

看完文章,把您的行业与预算告诉我们,免费获取一份量身定制的官网建设方案与报价。

立即免费咨询