采集学院：网页空白排错
文档同步日期： 2026 年 8 月 31 日“采集学院 → 操作指南 → 规则排错与优化 → 流程优化”新增网页空白的排错方法，位于“自动重试”之后。页面说明详情页出现
about:blank 的常见原因、Ajax 加载设置方式，以及无法返回列表页时添加“返回上一级网页”步骤的解决方法。
DataHub MCP 能力说明
文档同步日期： 2026 年 8 月 28 日DataHub 栏目新增 DataHub MCP 能力说明，梳理通用 MCP 的 6 个稳定工具、同步与异步运行、结果分页、
handoff 大结果处理和取消任务规则。Data App 会随市场更新，实际使用时应通过 search_data_apps 与 App 详情实时确认。
八爪鱼采集器 MCP 工具与工作流同步
文档同步日期： 2026 年 8 月 28 日八爪鱼采集器 MCP 当前主入口实测公开 12 个工具。文档新增
get_task_status 和 describe_ecommerce_dataset 页面，并将模板云采集主流程更新为：search_templates 精确读取实时模板契约 → execute_task 自动检查并启动 → get_task_status 获取状态与 lotNo → export_data 分页读取或使用签名链接下载。
同步修正了模板搜索的 query 参数和 sourceTree 选项规则、导出的 taskId + lotNo + page/pageSize 契约，以及 Temu / TikTok Shop 从任务提交、结果集描述到查询的流程。客户端验证、Coze / Dify 提示词、速率限制与故障排查不再将 validateOnly、MCP Tasks 或旧导出字段描述为当前接口。
DataHub 通用 MCP 连接与选 App 模式
文档同步日期： 2026 年 8 月 28 日DataHub“Agent 连接”新增 通用连接：在 Agent 中选择 App。通用模式不需要预先选择 Data App：用户先连接 DataHub MCP，再由 Agent 搜索市场、查看 App 详情、确认参数并运行。页面完整说明 API Key 与 OAuth 两种认证方式、WorkBuddy 授权、搜索提示词、异步结果查询和常见问题。 原有两篇教程同步明确为“先选 App，再连接”的固定能力模式，并分别更名为 Codex：连接指定 App 与 WorkBuddy：连接指定 App。用户现在可以根据需求选择“先连接后搜索”或“先选 App 后连接”，两种方式调用的都是 DataHub Data App。
DataHub 新手入门教程
文档同步日期： 2026 年 8 月 26 日DataHub 栏目新增新手入门教程，完整说明登录市场、在线体验 Data App，以及通过 MCP 将 Data App 接入 AI Agent 的流程。当前内容包括 客户端直接使用、通用连接、Codex：连接指定 App和WorkBuddy：连接指定 App。
DataHub 产品介绍
文档同步日期： 2026 年 8 月 25 日文档站顶部导航新增 DataHub 栏目，位于“采集学院”和“MCP 服务”之间。首发页面介绍 DataHub 如何将采集模板、存量数据、第三方接口和数据处理能力统一封装为 Data App，供 Agent、业务系统和用户通过网站门户、API、MCP 或 SDK 使用。 页面同步说明了 Data App 的机器可读描述、输入输出、在线体验、按量计费和发布者/应用名标识，并补充价格监测、内容趋势、招投标、招聘研究、周期报表和 AI 取数等典型场景。当前可从 Data Hub 市场浏览已上线能力，并通过 客户端直接使用、通用连接或指定 App 教程了解在线体验与 MCP 接入流程。
采集学院视频专区
文档同步日期： 2026 年 8 月 24 日“采集学院”顶部导航现使用原生菜单区分“图文”和“视频”。视频内容按“界面介绍、操作指导、问题排查、操作实践、直播回放”分层展示；各视频保留独立详情页和云端 HTML5 播放器，无需将视频文件提交到文档仓库。 本轮已迁移视频专区中除 XPath 相关内容以外的现有教程。详情页已移除标题下方的重复教程说明，仅保留视频播放器与返回分类页的链接，使页面阅读更简洁。
文档链接审核与跳转修复
文档同步日期： 2026 年 8 月 24 日中文文档正文中的本站、旧帮助中心和外站链接现统一在新标签页打开，并使用
noopener noreferrer 安全属性。旧帮助中心可点击链接已映射至当前文档站的对应教程、视频详情页或已存在的学院入口，不再跳转到旧站；导航、Card、代码示例和 source 追溯元数据保持原有行为。
后续可运行 npm run docs:links:check 审核链接，运行 npm run docs:links:fix 执行修复。映射报告输出至 reports/document-link-audit.json，用于复核未能一对一对应的历史教程链接。
CLI v0.1.33
更新日期： 2026 年 8 月 7 日
当前安装版本：bazhuayu-cli@0.1.33
bazhuayu --help：命令按 Create、Run、Manage、Data 和 Config 分类展示，发布版不再在帮助中暴露 env、runs 等内部开发命令。bazhuayu capabilities --help 现在只显示帮助文字；Agent 和自动化流程应继续使用稳定的 bazhuayu capabilities --json 读取机器契约。
模板市场同步更新：搜索结果按公开 templateId 全局去重并在去重后分页，同一模板的多语言记录只保留排序靠前的名称；总数表示唯一模板数量。CLI 参数、帮助和公开 JSON 输出统一使用 templateId，新脚本不应再使用 --template-registration-id，也不应依赖 templateRegistrationId、status、raw 等内部字段。后端所需的注册 ID 映射由 CLI 在内部处理。
task list 新增 --status、--task-type 和 --scheduled true|false 筛选，可与 --template-id、关键词和任务组筛选组合使用。相关文档：CLI 概述、安装与验证、任务管理、命令速查表。
OpenAPI 支持 API Key 认证
文档同步日期： 2026 年 8 月 3 日OpenAPI 业务接口现补充 API Key 授权说明。调用时在请求头中传入
x-api-key: op_sk_xxxxxx；API Key 与 MCP 使用同一套密钥，可在八爪鱼官网账户中心创建。
交互式 OpenAPI 界面现声明 x-api-key 的 API-key security scheme，并保留既有 Access Token 作为兼容认证方式。每个请求只需选择其中一种，不要把 API Key 写成 Bearer Token，也不要将真实密钥提交到代码、截图或日志中。
相关文档：OpenAPI 概述、认证、获取 API Key