用途：在 macOS 上通过单一入口管理 Dash docsets 和 cheatsheets，覆盖搜索与发现、缺失 docset 的安装引导、无法安装时的生成指导，以及 agent 侧 Dash MCP、本地 HTTP、URL 或 Service 之间的回退路径。需要 Apple 或 Swift 执行、诊断、构建测试或 Dash 之外的文档推理时，建议改用 apple-xcode-workflow；新建 Swift 包时建议 apple-swift-package-bootstrap。
主要能力：将请求分为 search、install、generate 三个阶段；未指定时从 search 开始。运行 scripts/run_workflow.py 执行所选阶段：search 按配置的回退顺序返回结构化访问路径决策，install 按配置的来源优先级和审批门控执行，generate 返回结构化自动化优先指导。输出包含 status、path_type 和输出契约。
使用方式：输入 stage、query（search 必需）、docset_identifiers（可选，仅限已安装标识符）、docset_request（install 和 generate 必需）、approval（有副作用的安装前必需）。默认入口为可执行的 scripts/run_workflow.py；search 访问顺序为 mcp -> http -> url-service；install 来源优先级为 built-in、user-contributed、cheatsheet；默认搜索结果上限 20，默认启用搜索片段。
限制与停止条件：安装需明确用户批准；不得虚构 docset 标识符或目录匹配；当 MCP、HTTP 和 URL 或 Service 路径均不可用时以 blocked 停止；install 或 generate 缺少具体 docset 请求时停止；保持 search、install、generate 的正向阶段顺序。search 无法完成时按契约交给 install，install 无可用目录匹配时交给 generate。