{
  "markdown": "# Agent Harness\n\n以 Deep Agents 的 `create_deep_agent` 为主入口，直接使用网络检索、文件工具、Python 脚本和原生子任务委派。保留模型选择、会话历史、流式输出、取消、审批恢复、上下文压缩和用量统计。子任务继承工作区、敏感路径权限、审批和上下文预算；只读模式禁止委派。\n\nPython 接口统一通过类调用，例如 `AgentComposer.build_agent(settings)`、`AgentStreaming.astream_agent(...)` 和 `StoreFactory.open_store(settings)`。目录职责见 [架构说明](docs/ARCHITECTURE.md)。\n\n## 开发\n\n```powershell\nuv sync --all-packages --extra dev --extra desktop\nCopy-Item .env.example .env\n# 填写 VA_MODEL、VA_API_KEY，按需填写 EXA_API_KEY\nuv run vertical-agent \"检查当前工作区文件\"\ncd desktop\nnpm ci\nnpm run dev\n```\n\n网络检索使用 Exa，缺少密钥时返回不可用提示，不影响文件和脚本。文本搜索使用 ripgrep；桌面运行时自带 rg。文件工具支持分页读取、定位、精确替换和原子写入，编辑保留原换行与 UTF-8 BOM。\n\nOffice/PDF 使用 Microsoft MarkItDown 提取 Markdown，仅用于阅读。修改、生成或精确读取使用保存的 Python 脚本，调用 openpyxl、python-docx、python-pptx、pypdf；科学计算库继续随桌面运行时提供。扫描件 OCR 和版式保真转换未包含。\n\n脚本必须先保存为工作区 .py 文件，再调用 execute_python_file。脚本使用当前用户权限，保留超时、取消、输出日志和环境凭据过滤。文件工具的工作区和敏感路径检查不构成 Python 沙箱。\n\n## 数据与升级\n\n数据库默认位于工作区同级的 .runtime 目录，桌面使用应用数据目录。仅支持当前运行格式；不迁移旧对话、工作流和审批状态。升级前清除旧会话索引与检查点；项目文件、附件和产物保留。\n\n## 验证与打包\n\n```powershell\nuv run pytest\nuv run ruff check .\nuv run mypy\ncd desktop\nnpm run typecheck\nnpm test\nnpm run build\nnpm run test:smoke\nnpm run prepare:python\n```\n\nprepare:python 创建可移动的独立 Python 运行时，包含科学计算库和 rg。已有目标目录时会拒绝覆盖。\n",
  "bytes": 1242,
  "sha": "e818286580e4b63490bb3ad7778da45438e5c075289157a8d92b6deff840582d",
  "repo_slug": "0passion0/agent_harness",
  "fonte": "repo",
  "truncated": false,
  "api": "https://api.agentalog.com/api/listings/okf_0passion0_agent_harness_openwiki_index_m_30dda65b/readme"
}