展开本页目录
开始前准备什么
- 先下载并解压本题工程，在独立练习目录保留starter、reference和原始输入。
- 本地参考主要需要Python 3与现代桌面浏览器；涉及Chrome扩展、LibreOffice、Git时按本文单独要求准备。
- 目标工具账号、模型额度与平台导入能力由读者另行确认；本文实际运行范围见执行记录，不自动调用付费服务。
- 启动隔离GET夹具服务
- 在Dify建立HTTP节点正常出口与原生Fail Branch
- 把正常出口连接Code校验
- 将HTTP错误变量和业务校验错误映射成显式status/error_ki…
- 仅给可重放GET配置小次数有限重试
- 用五种输入逐一Test Run
- 导出DSL和实际运行轨迹
starter、七步任务、原始输入、人工完成的可运行参考、真实运行结果与独立验收；不含账号、数据库或缓存。
原生账号任务、本地工程运行和官方示例分开说明。
1. 启动隔离GET夹具服务
启动隔离GET夹具服务，浏览器/终端先核对五种响应本体和请求计数。
正常JSON、合法空数组、超时、503两次后恢复、200 HTML都有可控输入。本站HTTP服务每次运行先重置计数，避免残留次数造成假恢复。
2. 在Dify建立HTTP节点正常出口与原生Fail Branch
在Dify建立HTTP节点正常出口与原生Fail Branch，记录实际节点版本。
native-dify-draft.yml提供HTTP/Code/原生fail-branch结构草案。Dify官方设置图为真实官方素材；导入类型、版本和连接handle尚待读者原生验收。
3. 把正常出口连接Code校验
把正常出口连接Code校验，区分JSON空数组与非JSON HTML。
HTTP200 HTML是普通成功传输，必须由业务Code解析后返回invalid_data。示例Code显式返回统一结构，不靠抛异常让工作流意外停止。
4. 将HTTP错误变量和业务校验错误映射成显式status/error_ki…
将HTTP错误变量和业务校验错误映射成显式status/error_kind/data结构，避免用空字符串冒充成功。
status/error_kind/data是作者字段；Dify原生error_type/error_message另从失败出口映射。成功、合法空数据和失败不能都塞成空字符串。
5. 仅给可重放GET配置小次数有限重试
仅给可重放GET配置小次数有限重试，观察临时503在该安装版本的真实处理。
本地参照只对GET做最多3次总请求。Dify安装版的“重试次数是否含首次”和非2xx处理须结合夹具请求计数重验，不能照抄本地计数当原生事实。
独立目录练习命令
python3 serve.py6. 用五种输入逐一Test Run
用五种输入逐一Test Run，截图原生橙色错误出口和每次下游变量。
点击各模式实际发HTTP请求，记录状态/正文/超时；503恢复应看到503、503、200，200 HTML则是invalid_data。
7. 导出DSL和实际运行轨迹
导出DSL和实际运行轨迹，按期望出口、body类型、请求次数回读验收。
本地运行证据和原生DSL草案分开交付。未登录Dify、未导入或执行Dify工作流，也没有调用付费模型；不把参照浏览器画成Dify原生UI。
怎样确认已经完成
- 正常JSON为ok；HTTP200 HTML经Code验证变为invalid_data，不能被误当空结果。
- 超时走原生错误出口且包含实际错误类别/信息，下游不读取不存在的成功字段。
- 临时503的重试/恢复轨迹与请求计数一致，永远不超过所设次数；空数组仍是合法成功数据。
常见问题
Dify里接口失败了，怎么让后面知道是没结果还是空结果？
native-dify-draft.yml提供HTTP/Code/原生fail-branch结构草案。Dify官方设置图为真实官方素材；导入类型、版本和连接handle尚待读者原生验收。 本地参照只对GET做最多3次总请求。Dify安装版的“重试次数是否含首次”和非2xx处理须结合夹具请求计数重验，不能照抄本地计数当原生事实。
工作流显示成功却没有有效数据，应该在哪一层拦住？
status/error_kind/data是作者字段；Dify原生error_type/error_message另从失败出口映射。成功、合法空数据和失败不能都塞成空字符串。 本地运行证据和原生DSL草案分开交付。未登录Dify、未导入或执行Dify工作流，也没有调用付费模型；不把参照浏览器画成Dify原生UI。
下载包哪些内容已实际运行，哪些需要自己在原生工具中验证？
已运行可重置的本地GET参照，保存正常、空数据、超时、503恢复和200 HTML轨迹；Dify导入/原生工作流未执行。 官方图片只证明所标入口或设置，不是本站原生任务执行截图。