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 或共享环境。 ## 文件导航 | 序号 | 文件内容概览 | 关键词 | 触发时机 | 文件路径 | | --- | --- | --- | --- | --- | | 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、如何确认版本和仓库结构、如何用 `module.__file__`/`inspect` 只读定位包内源码和关键模块。 | PyPI、pip install、GitHub repo、source tree、`module.__file__`、`__version__`、`inspect.getsource`、package path、read-only source、do not patch | 安装或升级前；需要确认当前版本行为前；需要从源码追溯工具 schema、参数默认值或模块路径前；遇到文档和实际行为不一致时必须读取 | [references/setup-and-source.md](references/setup-and-source.md) | | 3 | 记录 CLI、本地浏览器前端和 Python API 的运行方法，列出 `.env`、模型、工具 key、生命周期、上下文压缩、LLM wrapper 和常用环境变量配置。 | CLI、local frontend、Python API、`.env`、env.example、tool API keys、model config、lifecycle、compaction、LLM wrapper、workspace root、interactive run | 运行 CLI 前；启动本地 UI 前；写 Python 调用前；配置 `.env`/工具 key/模型参数前；排查生命周期、上下文压缩、workspace root 或交互运行问题时必须读取 | [references/runtime-