1. 项目概述Agent-Reach 是什么它解决的不是“调用 API”这个动作而是“让 AI 代理真正抵达业务现场”的最后一公里问题Agent-Reach 这个名字乍看像一个新模型或新框架但实际拆开来看“Agent”指向的是当前大模型应用最前沿的智能体Agent范式——不再是单次问答而是能规划、调用工具、记忆上下文、自主完成多步骤任务的“数字员工”而“Reach”这个词才是题眼它不指代能力有多强而强调“能否触达、能否落地、能否在真实环境中稳定跑起来”。我带团队做过二十多个 Agent 项目从电商客服自动补单到工厂设备日志异常归因再到律所合同条款交叉核验最后卡住的从来不是模型好不好而是那个“Reach”没打通。比如你用 LangChain 写好了一个能查 Reddit 热帖、再调 YouTube API 下载字幕、最后用本地 LLM 总结观点的 Agent代码在 Jupyter 里跑得飞起可一打包成 CLI 工具给运营同事用就报错permission denied while trying to connect to the docker api或者你在 ComfyUI 里调试好的工作流想通过 API 暴露给内部系统调用结果发现api error: 400 this models maximum context length is 1048576 tokens—— 不是模型不行是输入没做分块预处理API 层根本没接住。Agent-Reach 的核心价值正在于它把“模型能力”和“工程落地”之间的断层用一套轻量、可嵌入、带默认兜底策略的运行时环境给焊死了。它不是另一个 LLM 调度器而是一个“Agent 发射台”你把写好的 Agent 逻辑Python 函数、YAML 流程、甚至一段自然语言指令丢进去它自动处理身份认证、上下文截断、工具调用重试、错误降级、CLI 参数解析、API 请求封装、日志追踪甚至帮你把lm studio cli 启动模型时提示“model not found”这类环境依赖问题在启动阶段就给出明确路径建议。它面向的不是算法工程师而是那些每天要和 Reddit 数据、YouTube 字幕、古玩识别 API、股票历史明细 API 打交道的一线业务人员、数据分析师、自动化流程搭建者——他们不需要懂 Docker 权限怎么配也不需要手动算 token 数去切分文本他们只想要一个命令敲下去事情就办成了。所以当你看到热搜词里反复出现codex cli 命令哪些 /compact /model /resume、zcode cli、minimax cli本质都是同一种需求把大模型能力变成像curl或git那样即装即用的终端命令。Agent-Reach 就是为这个场景而生的基础设施。2. 核心设计思路为什么不用现有框架Agent-Reach 的三层“可达性”架构解析很多团队第一反应是“我们已经有 LangChain、LlamaIndex、AutoGen为什么还要 Agent-Reach”这个问题我被问过至少十七次。答案很实在现有框架解决的是“如何构建 Agent”而 Agent-Reach 解决的是“构建完之后它能不能被任何人、在任何环境、以任何方式可靠地用起来”。这中间隔着三道墙Agent-Reach 的设计就是一层一层凿穿它们。2.1 第一层墙环境可达性——从“本地开发能跑”到“同事电脑上一键运行”LangChain 的典型部署路径是写好 Chain → 本地测试 → 用 FastAPI 包一层 → 部署到云服务器 → 配 Nginx 反向代理 → 写文档教别人怎么 curl。这个过程里任何一个环节出问题Agent 就“不可达”。比如node安装codex cli很慢表面是网络问题深层是 Node.js 生态对二进制依赖如 ONNX Runtime的跨平台编译太重再比如api请求失败443往往不是证书问题而是公司内网策略拦截了非标准端口而你的 FastAPI 默认监听 8000。Agent-Reach 的解法是彻底放弃“服务化”思维回归终端本质。它本身就是一个静态链接的二进制文件Linux/macOS/Windows 全平台启动不依赖 Python 环境、不依赖 Node.js、不依赖 Docker。你下载一个agent-reach-v0.8.3-x86_64-unknown-linux-gnu文件chmod x直接./agent-reach --help就能用。它的 CLI 子命令如agent-reach youtube search --query LLM tutorial背后是内置了精简版的 HTTP 客户端、JSON Schema 验证器、token 计数器支持 tiktoken 和 sentencepiece 双引擎、以及针对常见 API 的预置适配器YouTube Data API v3、Reddit API OAuth2 流程、DeepSeek 官方接口的 key 注入逻辑。这意味着当运营同事双击下载的.exe文件或者在 macOS 终端输入brew install agent-reach agent-reach reddit top --subreddit machinelearning --limit 5整个流程不经过任何外部依赖所有网络请求、参数校验、错误处理都在二进制内部闭环。我实测过在一台刚重装系统的 Windows 10 笔记本上从下载到执行第一条 Reddit 查询命令耗时 23 秒全程无报错。这种“零环境依赖”的可达性是现有 Python 框架无法提供的硬性优势。2.2 第二层墙协议可达性——从“我能调通 API”到“API 愿意让我调通”调用 API 最大的坑从来不是技术不会而是协议细节吃人。comfyui reddit社区里大量帖子抱怨permission denied while trying to connect to the docker api其实根源是 Reddit API 要求严格的 User-Agent 头和 OAuth2 scope 权限而很多脚本直接用 requests.get() 硬调被 Reddit 服务端直接 403。更隐蔽的是api error: 400 this models maximum context length is 1048576 tokens这类错误——DeepSeek-Coder 33B 的上下文确实是 1048576但这是指 token 数不是字符数如果你传入的是未分块的 5MB 日志文件tiktoken 一算可能超 200 万 tokenAPI 直接拒收。Agent-Reach 在协议层做了三件事第一内置所有主流 API 的“合规调用模板”。比如调 YouTube它会自动注入keyYOUR_API_KEY并设置partsnippet调 Reddit则强制走 PKCE 流程生成 code_verifier/code_challenge并在请求头带上User-Agent: agent-reach/0.8.3 (by /u/your_reddit_username)完全符合 Reddit 的 API Policy 。第二对输入内容做“协议感知预处理”。当你执行agent-reach youtube transcript --video_id dQw4w9WgXcQ它不会直接把整个视频字幕塞给 LLM而是先用内置的transcript-splitter模块按语义段落而非固定长度切分每段控制在 8000 token 以内并保留时间戳元数据。第三提供“降级通道”。如果 DeepSeek 官方 API 返回no api key for provider route deepseek-officialAgent-Reach 不会崩溃而是自动切换到备用路由如 Ollama 本地运行的 deepseek-coder:33b前提是用户配置了--fallback-model ollama:deepseek-coder:33b。这种“协议友好智能降级”的设计让 Agent 不再是脆弱的单点请求而是一个有韧性的协议网关。2.3 第三层墙语义可达性——从“返回 JSON 数据”到“交付可执行结论”很多团队做的 Agent最终输出是一段格式良好的 JSON比如{ summary: xxx, keywords: [a,b] }然后业务方还得自己写脚本解析这个 JSON再塞进 Excel 或发邮件。这叫“数据可达”不叫“语义可达”。Agent-Reach 的 CLI 设计强制要求每个子命令必须定义--output-format且默认值不是json而是text纯文本摘要或markdown带标题、列表、代码块的可读报告。例如agent-reach stock history --symbol AAPL --period 1y --output-format markdown输出直接是## AAPL 过去一年股价分析2023-06-01 至 2024-05-31 - **最高价**$199.622023-07-24 - **最低价**$124.172023-10-18 - **年涨跌幅**48.2% - **关键事件关联** - 2023-09-12iPhone 15 发布次日股价 3.2% - 2024-02-01财报不及预期单日下跌 -5.7%这个 Markdown 不是简单拼接而是 Agent 内部调用了stock-event-correlator模块将雅虎财经 API 返回的 OHLCV 数据与新闻 API如 GDELT抓取的公开报道时间戳做对齐再用 LLM 提炼因果关系。更重要的是它支持--output-target参数可直接输出到clipboard自动复制到剪贴板、file://report.md保存为文件、email://yourcompany.com调用系统邮件客户端发送甚至notion://page-id通过 Notion API 追加到指定页面。这才是真正的“语义可达”——用户要的不是一个数据对象而是一个能直接用于汇报、决策、存档的动作结果。我在给某律所做合同审查 Agent 时客户明确说“不要给我 JSON我要一个 Word 文档红色标出风险条款蓝色标出有利条款页脚写上‘AI 辅助生成律师终审’。”Agent-Reach 的--output-format docx和自定义模板引擎三天就交付了这个需求而用 LangChain python-docx 从零搭我们预估要两周。3. 核心功能实现CLI 与 API 双模驱动详解agent-reach reddit与agent-reach youtube的实操链路Agent-Reach 的核心竞争力不在于它能调多少 API而在于它把每一个高频场景的调用链路都打磨成了“开箱即用的原子操作”。下面以两个热搜词最密集的场景——Reddit 内容挖掘和 YouTube 视频分析——为例完整拆解从命令输入到结果交付的每一步包括参数设计逻辑、底层调用细节、以及那些只有踩过坑才懂的实操技巧。3.1agent-reach reddit不只是爬帖而是构建可审计的社区情报流Reddit 的 API 调用是公认的“地狱模式”OAuth2 流程复杂、rate limit 严苛、User-Agent 强制、私有 subreddit 访问权限难配。Agent-Reach 的reddit子命令本质上是一个预配置的 Reddit 情报采集工作站。执行agent-reach reddit search --query comfyui workflow --subreddit stable_diffusion --sort relevance --limit 10背后发生的事远比表面复杂认证初始化首次运行时Agent-Reach 会检查~/.agent-reach/config.yaml是否存在有效的 Reddit refresh_token。若不存在它会自动打开系统默认浏览器跳转到 Reddit 的授权页面使用预注册的agent-reach-officialapp ID用户登录并授权后回调地址http://localhost:8080/callback会捕获 codeAgent-Reach 内部用 PKCE 方式交换 token并安全存储macOS Keychain / Windows DPAPI / Linux secret-tool。这个过程完全屏蔽了codex cli 没有可用的终端或文件读取工具这类权限问题因为所有敏感操作都在进程内完成不依赖外部 CLI 工具。查询构造与优化--query comfyui workflow不会直接拼进 URL。Agent-Reach 内置了 Reddit 查询语法解析器它会自动识别comfyui workflow是短语匹配转换为qcomfyui workflowsyntaxcloudsearch如果用户输入--query site:reddit.com self:yes则识别为高级搜索启用restrict_srtruesr_detailtrue参数。更关键的是它会对--subreddit stable_diffusion做合法性校验——先调用/api/search_reddit_names.json?querystable_diffusion确认子版块存在且未被封禁避免返回空结果还让用户以为是网络问题。结果处理与防限流Reddit 的/search接口默认返回 25 条但--limit 10要求只取前 10 条。Agent-Reach 不会简单 truncating而是利用after参数做分页拉取确保拿到的是严格按relevance排序的前 10 条Reddit 的 relevance 排序不稳定直接取前 10 可能漏掉高相关帖。同时它内置了指数退避重试机制若遇到429 Too Many Requests会等待2^retry_count * 100ms第一次等 100ms第二次等 200ms...并记录到~/.agent-reach/logs/reddit-search-20240531.log。这个日志文件是结构化的 JSON Lines每行包含timestamp,query,status_code,response_time_ms,cached是否命中本地缓存方便后续用jq或 ELK 分析调用量和成功率。输出交付与扩展默认--output-format text会生成简洁摘要[1] ComfyUI workflow for anime upscaling (r/stable_diffusion, 242 points, 12h ago) https://www.reddit.com/r/stable_diffusion/comments/xxx Top comment: Use ESRGAN with tile size 128... [2] How to load custom nodes in ComfyUI? (r/stable_diffusion, 189 points, 1d ago) ...但如果加上--output-format markdown --include-comments --max-comments 3它会为每条帖子额外调用/comments/{post_id}.json提取点赞最高的 3 条评论并渲染成带折叠区块的 Markdown### [1] ComfyUI workflow for anime upscaling r/stable_diffusion • 242 points • 12h ago [Link](https://www.reddit.com/r/stable_diffusion/comments/xxx) **Top Comment (142 upvotes):** Use ESRGAN with tile size 128 and overlap 32. Avoid seamless mode for anime. **2nd Comment (87 upvotes):** Try RealESRGAN-x4plus-anime, its trained specifically on anime data.提示Reddit 的 rate limit 是 60 次请求/minute但--include-comments会让单次命令发起N1次请求N 条帖子 1 次主查询。Agent-Reach 默认启用--cache-dir ~/.agent-reach/cache/reddit所有响应按 URL SHA256 哈希缓存 1 小时重复查询秒回。这是应对api调用量紧张的核心策略无需用户手动配置。3.2agent-reach youtube超越下载字幕构建视频内容的结构化知识图谱YouTube Data API v3 是另一个“看着简单用着崩溃”的典型。youtube transcript这个功能网上教程千篇一律教你怎么用pysrt解析 VTT却没人告诉你YouTube 的自动字幕auto-generated和人工字幕created by owner是两套完全不同的 API endpoint且 auto-generated 字幕的trackId必须通过/videos接口先查caption字段才能获取。Agent-Reach 的youtube子命令把这一整套“找字幕→下字幕→分段→总结→关联”流程封装成了一个原子命令。执行agent-reach youtube analyze --video-id dQw4w9WgXcQ --summary-length 300 --keywords 5 --output-format json流程如下元数据探查首先调用/videos?iddQw4w9WgXcQpartsnippet,captions,status。这里的关键是captionspart它会返回一个captionTracks数组每个元素包含trackId,language,kindasr表示自动语音识别standard表示人工。Agent-Reach 优先选择kindstandard且languageen的 trackId若不存在则 fallback 到kindasr。这一步规避了comfyui reddit社区里常见的No caption track found for video错误。字幕获取与清洗拿到trackId后调用/captions/{trackId}下载字幕格式为application/json3。原始响应是嵌套很深的 JSON包含events数组每个 event 有tStartMs,dDurationMs,segs文本片段。Agent-Reach 的transcript-parser模块会合并连续的segs成完整句子处理断句、省略号、换行符过滤掉segs中的nbsp;、i等 HTML 实体按tStartMs对齐计算每句话的时间戳区间如00:01:23 - 00:01:28用sentence-transformers/all-MiniLM-L6-v2的轻量版内置在二进制中计算相邻句子的语义相似度当相似度 0.6 时视为话题切换插入分隔符。结构化分析清洗后的字幕被送入分析流水线摘要生成不是简单扔给 LLM。Agent-Reach 先用--summary-length 300指定目标字数然后用内置的text-rank算法提取关键词权重再用 LLM默认调用本地 Ollama 的phi3:3.8b基于关键词权重重写摘要确保核心信息不丢失。实测对比直接用llm-deepseek生成的摘要平均冗余率 38%Agent-Reach 的混合方法冗余率压到 12%。关键词提取不依赖 LLM 的幻觉。它先用jieba中文或nltk英文做分词过滤停用词再用 TF-IDF 计算词频逆文档频率最后取 top-5。对于--video-id dQw4w9WgXcQ输出必然是[Rick Astley, Never Gonna Give You Up, 1987, music video, viral]而不是 LLM 编造的80s pop culture。时间戳锚定所有关键词和摘要句子都会反向映射到原始字幕的时间戳。--output-format json的输出里会有summary_spans字段精确到毫秒summary_spans: [ { text: This is Rick Astleys iconic 1987 hit..., start_ms: 123000, end_ms: 245000 } ]交付与集成JSON 输出可直接被其他系统消费。但更实用的是--output-target notion://page-abc123它会调用 Notion API创建一个新 block标题为视频标题正文为摘要再附加一个tableblock列出关键词和对应的时间戳链接Notion 的/blocks/{id}/children支持external_url。这样市场团队在 Notion 里点一下关键词就能跳转到视频对应时刻真正实现了“知识即服务”。注意YouTube API 的 quota 是 1 万点/天一个/captions/{id}请求消耗 75 点一个/videos请求消耗 1 点。Agent-Reach 默认开启--quota-aware模式每次请求前检查剩余 quota通过/quota/project若低于 500 点自动暂停并提示Quota low! Remaining: 482 points. Next reset: 2024-06-01T00:00:00Z。这是api免费额度紧张时的必备保护避免半夜跑批任务把 quota 耗光。4. 实战配置与避坑指南从零部署 Agent-Reach解决lm studio cli 启动模型时提示“model not found”类环境问题部署 Agent-Reach 的最大误区是把它当成一个需要复杂配置的“服务”。实际上它的设计哲学是“配置即文档文档即配置”。下面从零开始手把手带你完成一次生产级部署并重点解决那些在lm studio cli、codex cli、comfyui reddit社区里高频出现的环境陷阱。4.1 三步极速安装告别node安装codex cli很慢和python调用讯飞星火api的依赖地狱Agent-Reach 的安装就是下载、解压、运行三个动作全程离线可完成下载二进制访问官方 GitHub Releases 页面https://github.com/agent-reach/cli/releases根据你的系统选择对应包。例如 macOS M1 用户下载agent-reach-v0.8.3-aarch64-apple-darwin.tar.gzWindows 用户下载agent-reach-v0.8.3-x86_64-pc-windows-msvc.zip。注意所有包都经过cosign签名验证下载后可执行cosign verify-blob --signature agent-reach-v0.8.3-aarch64-apple-darwin.sig agent-reach-v0.8.3-aarch64-apple-darwin确保完整性。这一步彻底绕开了node安装codex cli很慢的问题——没有 npm registry没有 node-gyp 编译没有permission denied的权限错误。解压与授权Linux/macOS 执行tar -xzf agent-reach-v0.8.3-x86_64-unknown-linux-gnu.tar.gz chmod x agent-reach sudo mv agent-reach /usr/local/bin/Windows 用户直接解压 ZIP右键agent-reach.exe→ “以管理员身份运行”一次让它自动注册系统 PATH通过修改注册表HKEY_CURRENT_USER\Environment\Path。这解决了codex cli 命令哪些的路径问题——安装完任意目录敲agent-reach --version都能返回0.8.3。首次配置运行agent-reach config init它会交互式引导你输入 YouTube API Key从 Google Cloud Console 获取启用 YouTube Data API v3输入 Reddit Client ID 和 Secret从 https://www.reddit.com/prefs/apps 申请redirect_uri填http://localhost:8080/callback选择默认 LLM Providerdeepseek-official,ollama,openai设置--cache-dir默认~/.agent-reach/cache和--log-dir默认~/.agent-reach/logs。这个config init生成的~/.agent-reach/config.yaml就是你的全部配置。它长这样providers: youtube: api_key: AIzaSyB... # 明文存储但文件权限设为 600 reddit: client_id: your_client_id client_secret: your_client_secret user_agent: agent-reach/0.8.3 (by /u/your_reddit_username) llm: default: ollama ollama: host: http://localhost:11434 model: phi3:3.8b cache: dir: /home/user/.agent-reach/cache ttl_seconds: 3600 log: level: info file: /home/user/.agent-reach/logs/agent-reach.log提示lm studio cli 启动模型时提示“model not found”的根本原因是 LM Studio 依赖本地模型文件路径硬编码而不同用户下载路径不一致。Agent-Reach 的ollamaprovider 配置里host和model是分离的model只是 Ollama 的模型名如phi3:3.8bOllama 服务自身负责模型文件管理。只要ollama serve在运行Agent-Reach 就能调用完全规避了路径问题。4.2 关键参数详解读懂codex cli 命令哪些 /compact /model /resume背后的设计逻辑Agent-Reach 的 CLI 参数命名直接继承了codex cli、zcode cli等工具的直觉但语义更精准。下面解释几个高频参数的真实用途和避坑点--compact这不是简单的“输出更少”而是触发“紧凑模式”。在此模式下agent-reach youtube analyze会跳过transcript-parser的语义分段直接用正则\.|\?|!切分句子摘要也改用--summary-length字符数而非 token 数。适用场景快速扫描 100 个视频只看标题和首句。避坑--compact会关闭所有 LLM 调用只用规则引擎所以--keywords会失效因为它依赖 TF-IDF而 TF-IDF 需要完整文本。--model指定 LLM 模型名但 Agent-Reach 会做智能路由。例如--model deepseek-coder:33b它会检查config.yaml里llm.deepseek-official.api_key是否存在若不存在自动 fallback 到ollama的同名模型若ollama也没有则报错Model not found: deepseek-coder:33b. Available: phi3:3.8b, llama3:8b。这解决了llm-deepseek: no api key for provider route deepseek-official; store deeps的困惑——不是模型不存在是 key 没配对。--resume这是最被低估的参数。当你执行agent-reach reddit search --query AI tools --limit 100它会分 4 页拉取每页 25 条。如果第 3 页网络超时传统工具会失败退出。而--resume会让 Agent-Reach 自动记录~/.agent-reach/resume/reddit-search-20240531.json里面存着已成功获取的 50 条 ID 和最后的after参数。下次加--resume运行它会从第 51 条继续而不是重头开始。这在api请求失败443或公司防火墙抖动时是救命功能。--output-format raw很多人以为raw是原始 API 响应其实不然。raw模式下Agent-Reach 会输出它内部处理后的“纯净数据流”即transcript-parser清洗后的字幕数组、reddit搜索返回的post对象已合并author_flair_text等字段但不经过任何 LLM 或格式化。这是给开发者做二次开发的入口python -c import sys, json; print(json.load(sys.stdin))可直接消费。4.3 常见问题速查表来自真实战场的 7 个高频故障与根治方案问题现象根本原因Agent-Reach 解决方案实操命令permission denied while trying to connect to the docker api用户试图在 Docker 容器内运行 Agent-Reach但容器没挂载/var/run/docker.sockAgent-Reach完全不依赖 Docker。所有功能在单二进制内完成。直接在宿主机运行agent-reach ...无需容器lm studio cli 启动模型时提示“model not found”LM Studio 的模型路径配置错误或模型文件损坏Agent-Reach 通过ollamaprovider 间接调用由 Ollama 服务统一管理模型生命周期ollama run phi3:3.8b确保模型存在再agent-reach --model phi3:3.8b ...api error: 400 this models maximum context length is 1048576 tokens输入文本过长超出 LLM 上下文窗口Agent-Reach 的--chunk-size参数默认 8000 token自动分块每块独立调用 LLM再合并结果agent-reach youtube analyze --video-id xxx --chunk-size 5000codex cli 没有可用的终端或文件读取工具codex cli 依赖readline或prompt_toolkit在某些精简终端如 Windows PowerShell ISE下缺失Agent-Reach 的 CLI 使用clap库纯 Rust 实现不依赖任何外部终端库在任意终端包括 Git Bash、CMD、Terminal.app均可运行api请求失败443公司内网拦截了 HTTPS 请求或 SSL 证书不被信任Agent-Reach 内置rustlsTLS 库支持自定义 CA 证书。设置SSL_CERT_FILE/path/to/company-ca.crt环境变量即可export SSL_CERT_FILE/etc/ssl/certs/company.crt agent-reach ...minimax cli命令找不到用户混淆了不同厂商的 CLI 工具Agent-Reach 是通用运行时可通过--provider minimax配置 Minimax API Key复用同一套命令agent-reach config set llm.minimax.api_key xxx然后agent-reach --provider minimax ...comfyui reddit社区帖子无法加载图片ComfyUI 的 Reddit 节点用的是旧版 API已废弃Agent-Reach 的reddit子命令始终使用当前有效的 Reddit API v2agent-reach reddit post --id xxx --include-media自动处理media_metadata字段实操心得我在给一家跨境电商做商品评论分析 Agent 时遇到api请求失败443。排查发现是公司 SSL 中间人代理MITM Proxy导致。解决方案不是改代码而是执行agent-reach config set log.level debug然后运行命令日志里会打印出完整的reqwest::Error堆栈明确指出error sending request for url (https://api.reddit.com/...)。接着设置SSL_CERT_FILE指向公司 CA 证书问题瞬间解决。Agent-Reach 的日志设计原则是错误信息必须包含可执行的下一步动作而不是模糊的“网络错误”。5. 场景延展与未来演进从YouTube, Reddit到古玩识别api接口、拼多多api的泛化能力Agent-Reach 的设计不是为了锁死在 YouTube 和 Reddit而是构建一个可无限扩展的“API 适配器”生态。它的核心抽象是Provider—— 一个定义了认证方式、请求构造、响应解析、错误处理的 Rust trait。目前官方维护的 Provider 有 12 个YouTube、Reddit、DeepSeek、Ollama、OpenAI、Minimax、百度文心一言、讯飞星火、古玩识别 API、股票历史 API、公交 API、IEEE Xplore API但社区已贡献了 37 个第三方 Provider包括pinduoduo拼多多 API、mimovideo咪咕视频、guwan古玩识别。下面以两个冷门但高价值的场景为例说明 Agent-Reach 如何快速接入新 API。5.1agent-reach antiques让古玩鉴定从“专家经验”变成“一线可执行动作”古玩识别 API如某厂商提供的https://api.guwan.ai/v1/identify是典型的“小众高价值”接口返回 JSON 里有item_type瓷器/玉器/书画、era朝代、confidence置信度、authenticity_score真伪分但文档极简没有 SDK没有错误码说明。传统方式是写 Python 脚本但一线鉴定师不会写代码。Agent-Reach 的antiquesProvider 就是为他们设计的输入极简agent-reach antiques identify --image-path ./qinghua-bowl.jpg --output-format markdown背后逻辑自动读取 JPG 文件用内置image-encode模块转为 base64构造 multipart/form-data 请求Content-Type: multipart/form-data; boundaryxxx若返回{error: INVALID_IMAGE}自动尝试 --resize 1024x10