wangmiaozero/pi-harness

本页介绍外部开源仓库，并非 HDATF 产品。

它做什么

Pi-Harness是用可视化工作区包装Pi Coding Agent的AGPL-3.0-only Electron桌面应用，智能体仍由原生Pi runtime运行。它可在macOS、Windows和Linux上运行，会话、配置、工具、Skill和extension都与Pi兼容，因此同一工作可以在应用外的Pi中继续。工作区涵盖对话、项目、文件浏览器和编辑器、Git的diff、历史、commit和worktree、模型provider，以及Skill、package和MCP。Harness界面记录trace、replay、fork与重试的run tree以及token、费用和时长，并提供工具策略、按运行的预算和checkpoint。在源码中，评估不使用AI评判模型，而是根据test、lint、typecheck、build命令及其退出码和Git状态等运行证据计算。默认策略禁止工作区外的文件变更和force push，在删除、push和网络命令前询问，对rm -rf等命令要求确认，预算上限留空。智能体团队分配带依赖和优先级的任务，按顺序或并行执行，传递结果，使用review gate，并用Git worktree隔离变更。历史界面以只读方式读取Claude Code、Codex、Cursor、Cursor Agent、Gemini CLI、OpenCode和Pi的本地对话记录，并通过handoff在新的Pi对话中继续任务。安装包在GitHub Releases上，最新版是跟进Pi 1.2.0不兼容变更的10月14日的2.0.0，macOS社区构建可能没有签名。在Windows和Linux上，API key加密保存在应用自己的vault中，但写入Pi的models.json的是原始key值。

许可证

AGPL-3.0 网络 Copyleft 许可。以服务形式提供修改版也须公开源码。用于产品前需要评估。

同领域的其他仓库

• perplexityai/SPACE
  SPACE是Perplexity用Rust编写的Apache-2.0平台，在Firecracker microVM(轻量虚拟机)中隔离运行智能体代码。它面向需要为智能体、用户工作空间或代码运行任务提供独立执行环境的应用，运行什么、保留什么由应用决定。template是初始环境，sandbox是由template创建的实例，在自己的VM和可写文件系统中运行多条命令。应用通过HTTP API创建sandbox和命令会话，sandbox的状态变更用operation ID确认完成，命令输出和退出结果则通过使用会话专用token的独立连接以server-sent events接收。暂停时内存保留在worker上，suspend时保存为snapshot，默认6小时无活动即suspend。E2B兼容wrapper让现有E2B客户端可以把SPACE用作backend，测试基准是Python包e2b 2.21.1和e2b-code-interpreter 2.6.2。network policy允许或阻止sandbox访问的地址，默认关闭的credential rule启用后，拦截TLS的gateway会在发往指定host的请求中加入credential header。本地部署在带KVM的apt系Linux x86_64主机上创建Kind(Docker中的Kubernetes)集群，macOS不在支持范围内。仓库描述称runtime可以替换，但文档记载的当前实现只有KVM上的Firecracker。0.8.0是公开基线版本，1.0之前仍可能有不兼容的变更，安全修复只进入最新的minor release。
• onehumanbeing/esp32-iphone-agent
  ESP32 iPhone Agent是一个由Python服务器和Arduino固件组成、采用MIT许可证的项目，它让AI视觉模型在无需Mac、Xcode、开发者账号、手机应用或越狱的情况下操作一部真实的iPhone。目标用户是希望通过人使用手机的同一途径，即屏幕和指针，来自动化iPhone的开发者和爱好者，README要求只自动化自己拥有或获准使用的设备和账号，并遵守各应用的条款。手机通过AirPlay把屏幕镜像到macOS或Linux电脑上的UxPlay，由GStreamer转成JPEG帧，插在手机USB口上的ESP32-S3开发板被识别为标准USB鼠标和键盘。打开iOS AssistiveTouch(在屏幕上显示指针的辅助功能设置)后，点击就是点按，拖动就是滑动，开发板只执行通过2.4GHz Wi-Fi收到的click、type等单行命令。所有判断都由电脑上的FastAPI服务器负责，在这套代码中，网页API和开发板端口默认不经登录就在所有网络接口上开放，命令以明文经TCP传输。用户在8890端口的网页中输入目标后，planner模型写出最多6步的计划，actor模型针对每张新截图以0到1000的坐标返回最多6个tap、swipe等动作。由于指针按相对位移移动，服务器会轻微晃动指针并在镜像画面中找到它来校准，每个动作后检查屏幕是否变化并告知模型，在无效的相同动作重复时重新规划。一次运行到40步或连续3次出错时结束，网页显示在每次决策所依据的截图上画出动作的step wall，以及也可用Esc键触发的紧急停止。所需准备包括刷写了固件的ESP32-S3开发板(测试用板是约7美元的Seeed XIAO ESP32S3)、USB-C接口的iPhone或配合相机转接器的Lightning接口iPhone，以及Python 3.10及以上。模型可以是任何接受图像的OpenAI兼容聊天API，planner和actor可以使用不同的模型，由于每次调用都会附带当前截图，使用云端API时，手机屏幕上显示的内容会传给该服务商。开发和计时使用的是在两台NVIDIA DGX Spark上运行的本地模型(每个动作约1.3秒，每次规划2秒)，附带的serve文件夹中的服务器是尚未经过完整智能体运行测试的实验版本。README列出的限制是，iOS会把密码输入、Apple Pay和受DRM保护的视频排除在镜像之外，智能体看不到这些画面，手机锁屏后镜像会停止，输入只支持ASCII，横屏应用尚未支持。
• SakanaAI/AI-Scientist-v3
  The Agentic Scientist(仓库AI-Scientist-v3)是Sakana AI的Apache-2.0 Python流水线，让编码智能体把任务从实验一路推进到论文。它面向有可改进程序和可打分evaluator的计算型研究，示例是在CPU上运行的圆形填充(circle packing)和用两块GPU的GRPO训练。输入是包含task.md、初始程序和evaluator的任务文件夹，仅凭简短说明生成任务的功能仍属实验性，对圆形填充这类小任务可用，对较大任务可能失败。任务编写、反复进行想法和实验的探索、与基线对比的ablation、封闭的最终评估、事后分析和论文写作这六个阶段依次运行。每次运行生成一个文件夹，内含任务snapshot、尝试与结果、费用记录以及LaTeX论文和PDF，run inspector可在浏览器中查看。论文阶段把每个论点与带hash的证据文件关联，从Semantic Scholar、OpenAlex或Google Scholar收集文献，引用或证据关联未通过验证时即以失败结束。它通过Headless CLI驱动Claude Code、Codex、Cursor、OpenCode、Gemini和Pi，可选的review阶段会把完成的论文发送给基于OpenAI的审稿模型。上手需要Python 3.11以上和uv、Docker以及.env中的API key或Claude登录，GPU只在GPU preset时需要，第一步检查是agsci doctor。README警告，智能体以全部工具权限执行任意命令、继承API key并受所读文件左右，因此要求在Docker中运行。一次GRPO评估要训练1到2小时，费用文件区分provider报告的费用和按标价的估算，不包含硬件费用，计费以provider的账单为准。
• T-Auto/dsh-ops
  dsh-ops是面向DeepSeek Harness(DSH)的第三方插件，它为Windows上的AI智能体提供专用的bash和PowerShell 7以及Rust文件工具，以减少反复出现PowerShell错误所耗费的token和时间。0.3.0版本只支持Windows x64，目标宿主为DSH 0.2.0-rc.2，需要22系列中的Node.js 22.19及以上或24及以上，可以通过DSH插件marketplace或npx命令安装。默认开启的shell component会发布ops_bash，并让宿主的pwsh工具使用随包的PowerShell 7，同时保持系统默认终端和PATH不变。同样默认开启的file component在独立的Rust worker中运行文件工具，并为修改提供dry run和原子替换。在默认关闭的两个component中，background只在danger-full-access会话中处理长时间任务，PTC只在通过SDK从代码调用工具的PTC-only会话中添加ops_batch。ops_batch在执行复制、移动、删除时会进行SHA-256校验，在每项操作之前先写入逐项状态，并支持中断后恢复，其审计记录是.dsh-ops文件夹中workspace所有者可以改动的普通本地记录。在DSH的read-only和workspace-write模式下，任意Bash和PTC代码都在OS隔离(confinement)中运行，没有不受限的后备路径，但Windows宿主把这种隔离报告为partial。danger-full-access按设计会绕过这种隔离，插件还会对当前用户拥有的workspace根目录先备份原有权限，再只为该目录添加WRITE_OWNER权限。随包的bash和PowerShell 7以压缩大小分别为161.2 MB和107.6 MB的可选npm包形式安装，如果registry镜像中缺少这些包，安装仍会在没有警告的情况下以退出码0结束。README中token减少97%和65%的数据来自作者自己的benchmark，而PTC设计文档写明没有提出固定的节省比例，也没有实际模型轮次的benchmark。LICENSE文件把插件定为MIT，把FastCtx定为Apache-2.0，随包的shell遵循GPL(Git for Windows)和MIT(PowerShell)条款，PROVENANCE.md写明GPL源码提供义务尚未审查。文档还记录了各DSH版本上的实际安装尚未得到证实，以及2026-10-08旧版本因工具注册冲突导致所有新DSH会话启动失败，当前设计通过只注册自己的工具来避免这一问题。
• mksglu/context-mode
  Context Mode是面向使用AI编码智能体的开发者的MCP服务器兼hook插件，它把大型工具输出挡在context window之外，并在对话压缩(compaction)后恢复工作状态。在11个MCP工具中，ctx_execute、ctx_batch_execute和ctx_execute_file在独立的子进程中运行12种语言的代码，只把打印出的结果传入context。ctx_index、ctx_search和ctx_fetch_and_index把Markdown和抓取的网页存入SQLite FTS5索引，只返回按BM25排序的匹配部分。hook会把curl、wget和web fetch调用转到这些工具，并把文件编辑、git操作、错误和用户决定记录到按项目划分的SQLite数据库中，README还写明不带--continue启动新会话时会删除之前会话的数据。对话压缩后，它们会注入一份包含各分类摘要和搜索调用的恢复用snapshot，而固定commit中的代码会忽略README所写的2 KB限制。它需要Node.js 22.5及以上或Bun，Claude Code通过marketplace以插件形式安装，其他客户端则在配置文件中加入MCP服务器和hook条目，或使用客户端专用的插件。只安装MCP服务器时只能使用工具而没有自动routing，会话延续在Claude Code等客户端上为完整，在Cursor、Codex CLI和Kiro上为部分，在Antigravity IDE和Zed上则没有。README声明没有数据离开本机，也没有telemetry，但服务器在启动时会向npm registry查询最新版本，ctx_insight会打开context-mode.com上的Insight仪表板。README中没有说明的hooks/platform-bridge.mjs，只要platform.json中有API key和服务器地址，就会在遮盖部分秘密值格式、邮箱地址和主目录路径后，把每个会话事件发送到所配置的Insight服务器。ctx_execute_file被限制在项目文件夹内，但README写明ctx_execute和ctx_batch_execute以进程自身的文件访问权限运行任意代码，并建议保持主机层面的sandbox开启。用户的permission deny规则也适用于sandbox工具，ctx_fetch_and_index在设置CTX_FETCH_STRICT=1之前允许访问本地和私有网络地址。LICENSE文件是Elastic License 2.0(ELv2)，允许使用、修改和再分发，但禁止把软件作为托管或管理型服务提供给第三方以及删除许可声明。

只收录进入 Trendshift 排行榜的仓库，榜单仅用于寻找候选项目，不转载名次。说明、许可证和星标数来自各 GitHub 仓库。解读是我们自己的判断。我们尚未测试这些项目，上榜并不证明质量。