【免费下载链接】agnes-harnessAgnes Harness: A pluggable agent harness for Forward Deployed Engineering (FDE). Built for trust. Made for the real world.项目地址https://gitcode.com/gh_mirrors/ag/agnes-harness点击查看免费下载Agnes Harness 是一个面向 Forward Deployed EngineeringFDE场景的可插拔智能体运行框架。当 daemon 启动失败、模型调用报错或会话打开卡住时这篇 Agnes Harness 故障排查指南带你用doctor诊断命令、错误码对照表和运行时审计日志三件套快速完成 Troubleshooting 定位。先判断问题位置4 大故障场景排错的第一步不是敲命令而是先分辨问题发生在哪个环节。官方排错文档把问题归为四类场景典型表现 构建环节缺少dist/local/agnes.mjs、native helper 不兼容、Node 版本太旧 连接环节daemon 启动后立即退出、listen EPERM、端口占用、Origin/Host 不匹配 模型配置缺少 Provider、RATE_LIMIT/ HTTP 429、TRANSPORT/TIMEOUT 插件运行插件装好了却没有工具、Skill 被 shadow、MCP 目录为空 排查前先记下当前 commit、Node 版本、执行的命令、错误码和所用的 home/profile——不要输出整个环境或凭据。完整对照表见 troubleshooting.zh-CN.md 与 troubleshooting.md。30 秒环境快照doctor 诊断命令速查doctor是 Agnes Harness 内置的只读体检命令覆盖platform、provider、storage、credentials、profile、extensions、daemon、binary、code-runtime十个检查段定义见 doctor.ts。故障时的标准开场动作node packages/cli/dist/local/agnes.mjs --version node packages/cli/dist/local/agnes.mjs daemon status node packages/cli/dist/local/agnes.mjs doctor platform --json node packages/cli/dist/local/agnes.mjs doctor storage --json node packages/cli/dist/local/agnes.mjs doctor provider --json几条容易踩坑的读法doctor platform会在每个低于full的能力下方输出能力.reason…。看到sandbox.l1unavailable且原因是awaiting sandbox backend full-boundary probe说明沙箱后端只是尚未探测并非平台不支持真正的探测失败文案是no runnable OS sandbox backend passed its full-boundary probe。doctor storage只建立并清理临时探测数据库不会修复现有数据。doctor provider --probe会真实调用模型可能计费排错时不要随手加上。凭据目录权限不合格时用doctor credentials做只读检查它会列出每个不合格路径并给出可直接执行的chmod命令详见 security.zh-CN.md。高频错误码实战对照表Agnes Harness 的错误码是闭集host 层固定 25 个见 errors.tsAI 装配层固定 6 个见 errors.ts。遇到报错先认码再对下表动手错误码 / 现象含义下一步E_DAEMON_SOCKET_PATH/ daemon 启动即退出socket 路径过长、目录身份或权限不合格核对 helper 与 home/profile用短路径/tmp/agh-*实验 home 排除路径因素E_LEDGER_INTEGRITY会话历史哈希链不符记录被改动或序号中断先停后台、复制 dataDir 保留证据再用备份恢复sessions.db不要编辑数据库E_LEASE_EXPIRED工具行已卸载、撤权或被新版本替换核对运行产物版本后按实际状态重新加载旧版本曾有默认 24 小时到期问题SECRET_UNRESOLVEDWindowsreason 为private-file密钥存储被拒绝而非缺失icacls 目录 /inheritance:r关闭继承再授予当前用户与SYSTEMRATE_LIMIT/ HTTP 429模型服务限流稍后重试持续出现则检查账号限额max_tokens/OUTPUT_LIMIT输出达到额度本轮停止且不自动重试要求模型分步继续或配置 preset 的model.max_tokensTRANSPORT/TIMEOUT连接重置、DNS 失败、流式中断等自动重试后仍失败检查网络/代理/VPNCERT_HAS_EXPIRED不重试通常是代理拦截了 TLSTOOL_ARGS_INVALID工具参数不符合 schema按错误中的参数路径补齐参数重试被拒绝的调用不会写文件LOAD_STALLED/ 卡在正在准备会话后台 30 秒无消息大会话打开可能要几分钟先看daemon status再看audit/runtime.jsonl的session.open记录E_FORMAT会话由更新版本写入当前版本无法打开见 支持范围与已知限制读懂运行时状态两个审计日志文件错误现场之外daemon 会在所选 dataDir 下写两个脱敏日志是运行时状态排查的核心audit/daemon.jsonl—— 请求审计记录失败的请求和每个发起的批次。没有失败请求的行只代表没有请求失败不代表 daemon 没有日志。audit/runtime.jsonl—— 运行日志工作进程退出/启动失败、会话中断、每次会话打开耗时、daemon 启动/停止/崩溃。超过 2 MiB 前轮转为runtime.jsonl.1。️ 意外错误常附带diagnosticId用它匹配audit/daemon.jsonl中的记录即可还原失败请求若返回diagnosticUnavailable说明审计写入失败不能据此断定没有错误。一个实用技巧audit/runtime.jsonl中的detail.session不是会话 ID而是其 SHA-256 的前 16 位。找某会话的记录时用同样方式对 ID 求哈希即可命中。会话打开慢时比较session.load的ms.open/ms.authorityReplay/ms.acpReplay三项再看对应session.open的ms.read、ms.verify、ms.fold构成——checkpoint.used: false且ms.verify很大说明正在完整核对很长的历史原理见 sessions.zh-CN.md · 历史完整性校验。排障清单该做的 8 件事与 4 条红线✅该做先跑--version和daemon status确认版本与后台状态用doctor 段名 --json输出机器可读的诊断结果记下错误码 diagnosticId对照审计日志用doctor provider --probe明确愿意计费时验证模型链路版本切换前结束任务、停止对应 daemon、备份自有数据见 install.zh-CN.md浏览器断线后先查后台历史确认最终状态而不是盲目重发导入失败时保留输入与错误用脱敏最小夹具复现需要更细的命令行参考时查 cli.zh-CN.md 的命令总表红线不会让问题消失只会让证据消失不删除 owner、锁、SQLite 数据库或回滚快照来消除错误不通过修改产品安全策略绕过listen EPERM不为绕过慢打开去复制或编辑数据库不复制其他平台的单文件二进制混用延伸阅读完整排错对照表troubleshooting.zh-CN.md支持范围与已知限制limitations.zh-CN.md会话导出与导入sessions.zh-CN.md命令参考cli.zh-CN.md赞分享【免费下载链接】agnes-harnessAgnes Harness: A pluggable agent harness for Forward Deployed Engineering (FDE). Built for trust. Made for the real world.项目地址https://gitcode.com/gh_mirrors/ag/agnes-harness点击查看免费下载相关推荐MCP Python SDK 故障排查完全指南逐条解析官方 Troubleshooting 错误清单MCP Python SDK 故障排查完全指南逐条解析官方 Troubleshooting 错误清单 导读 本文是官方 Python SDKModel Co人工智能MCP 服务MCP Clients工具调用NodeOS 编译与运行故障排查实战指南Troubleshooting 全解析NodeOS 编译与运行故障排查实战指南Troubleshooting 全解析 NodeOS 是一款以 Node.js 作为用户空间的轻量级操作系统其构建过操作系统嵌入式Vue Flow 故障排查完全指南错误码体系、根因分析与运行时错误处理Vue Flow 故障排查完全指南错误码体系、根因分析与运行时错误处理 本指南基于 Vue Flow 官方 Troubleshooting 文档展开系统梳理前端UI组件图表库上一篇如何用RevokeMsgPatcher彻底告别消息撤回烦恼终极防撤回指南下一篇MXC配置示例大全从简单脚本到复杂应用的终极指南创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考