researchharnesslisted

# ResearchHarness ## 总览 - ResearchHarness 是轻量、可审计的 tool-using LLM agent runtime，支持 CLI、本地前端、Python API 和 OpenAI-compatible API server。 - 主文件保留使用边界和 reference 导航；涉及安装、环境变量、API 协议、tools、workspace、trace 或测试时，按下面导航读取对应 reference。 - 任何源码阅读都只用于确认行为和参数，不能修改第三方源码、`site-packages`、editable checkout 或共享环境。 ## 上游版本锚点 - 当前 skill 对照 ResearchHarness GitHub `VERSION`：`v0.0.52`。 - 当前 skill 对照 GitHub HEAD：`72e8a44737aadabc8c3f9e5c7ea76883b9c7032f`。 - 维护本 skill 前，先重新检查上游 `VERSION` 和 HEAD；如果任一变化，必须阅读 README、`.env.example`、官方教程和相关源码后再更新。 ## 文件导航 | 序号 | 文件内容概览 | 关键词 | 触发时机 | 文件路径 | | --- | --- | --- | --- | --- | | 1 | 概括 ResearchHarness 的定位和边界，说明 CLI、本地 UI、Python API、OpenAI-compatible server 四种模式、必须先配置工具 key���workspace/trace 安全和禁止修改源码/共享环境。 | ResearchHarness、agent runtime、CLI、local UI、Python API、OpenAI-compatible API、tool keys、workspace、trace、source read-only、shared env、safety boundary | 触发本 skill 后默认读取；判断是否适合用 ResearchHarness 前；开始安装/运行/部署/调试前；涉及工具 key、workspace、trace 或源码阅读边界时读取 | `SKILL.md` | | 2 | 说明如何通过 PyPI 或 GitHub 获取 ResearchHarness、如何确认版本和仓库结构、如何阅读官方中英文教程、如何处理 relaxed dependency constraints、如何用 `module.__file__`/`inspect` 只读定位包内源码和关键模块。 | PyPI、pip install、GitHub repo、requirements.txt、dependency constraints、structai>=0.1.23、source tree、docs/tutorial_en.md、docs/tutorial_zh.md、agent_base/model_profiles.py、agent_base/provider_compat.py、agent_base/tools/README.md、`module.__file__`、`__version__`、`inspect.getsource`、package path、read-only source、do not patch | 安装或升级前；排查依赖版本兼容前；需要确认当前版本行为前；