opensource/dify
2
0
Fork 0
mirror of https://github.com/langgenius/dify.git synced 2026-09-08 11:04:27 +08:00
Code Issues Packages Projects Releases Wiki Activity

docs(test): record KnowledgeFS workflow v2 coverage

Browse Source 
Document the executed Workflow Knowledge Retrieval v2 matrix, Linear issue mapping, fix verification, remaining environment blockers, and reusable DSL fixtures.
This commit is contained in:
Jyong 2026-08-11 11:51:08 -04:00
parent c8780dcb7c
commit a220bf394f
5 changed files with 769 additions and 350 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

567
test-results/knowledge-fs/2026-08-11/knowledge-fs-detailed-test-cases.md
View File

@ -1,5 +1,7 @@
# KnowledgeFS 详细功能测试用例
Workflow `knowledge-retrieval-v2` 的 39 个已执行场景、15 个环境阻塞项、3 个规格/实现阻塞项及完整证据见：[Workflow Knowledge Retrieval v2 / KnowledgeFS 功能补测报告](./knowledge-retrieval-v2-functional-test-report.md)。
## 使用说明
### 通用前置条件
@ -29,317 +31,336 @@
## A. 入口、路由与导航
| ID | P | 测试场景/步骤 | 预期结果 | 本轮结果 |
|---|---|---|---|---|
| TC-NAV-001 | P0 | 直接访问 `/datasets?view=new` | 进入新版 Knowledge 列表，New 按钮为 pressed | PASS |
| TC-NAV-002 | P0 | 在列表点击“旧版”，再切回“新版” | 路由、选中状态和列表内容同步；新版恢复 `view=new` | PASS |
| TC-NAV-003 | P0 | 在概览/Sources/Documents/Retrieval/Quality/Settings 刷新 | 深链可独立恢复，不回到列表或旧版 | PASS |
| TC-NAV-004 | P0 | 打开合法 space ID 的深链 | 左侧导航、名称、模式和页面内容加载正常 | PASS |
| TC-NAV-005 | P0 | 打开不存在的 UUID 空间 | 显示本地化的不存在/无权页，不泄露后端信息 | FAIL，见 KF-BUG-004 |
| TC-NAV-006 | P1 | 点击“欢迎使用新版知识库”，关闭后再进入 | 引导弹层可关闭，不阻断页面操作 | PASS |
| TC-NAV-007 | P1 | 左侧导航折叠/展开后逐项访问 | 每个链接路由正确，焦点与选中项一致 | PARTIAL，路由已验证 |
| TC-NAV-008 | P1 | 390×844 视口访问所有二级导航 | 所有页签有明确滚动/折叠可达性，不遮挡内容 | FAIL-CANDIDATE，见 KF-BUG-012 |
| TC-NAV-009 | P1 | 使用 Tab/Shift+Tab/Enter/Escape 访问页签、菜单、抽屉和对话框 | 键盘可完成主流程，焦点不丢失 | NOT-RUN |
| TC-NAV-010 | P1 | 用无 new-rag feature flag 的 workspace 访问 | 不显示新版入口或给出明确说明 | NOT-RUN |
| ID | P | 测试场景/步骤 | 预期结果 | 本轮结果 |
| ---------- | --- | ------------------------------------------------------------ | ------------------------------------------------- | ----------------------------- |
| TC-NAV-001 | P0 | 直接访问 `/datasets?view=new` | 进入新版 Knowledge 列表，New 按钮为 pressed | PASS |
| TC-NAV-002 | P0 | 在列表点击“旧版”，再切回“新版” | 路由、选中状态和列表内容同步；新版恢复 `view=new` | PASS |
| TC-NAV-003 | P0 | 在概览/Sources/Documents/Retrieval/Quality/Settings 刷新 | 深链可独立恢复，不回到列表或旧版 | PASS |
| TC-NAV-004 | P0 | 打开合法 space ID 的深链 | 左侧导航、名称、模式和页面内容加载正常 | PASS |
| TC-NAV-005 | P0 | 打开不存在的 UUID 空间 | 显示本地化的不存在/无权页，不泄露后端信息 | FAIL，见 KF-BUG-004 |
| TC-NAV-006 | P1 | 点击“欢迎使用新版知识库”，关闭后再进入 | 引导弹层可关闭，不阻断页面操作 | PASS |
| TC-NAV-007 | P1 | 左侧导航折叠/展开后逐项访问 | 每个链接路由正确，焦点与选中项一致 | PARTIAL，路由已验证 |
| TC-NAV-008 | P1 | 390×844 视口访问所有二级导航 | 所有页签有明确滚动/折叠可达性，不遮挡内容 | FAIL-CANDIDATE，见 KF-BUG-012 |
| TC-NAV-009 | P1 | 使用 Tab/Shift+Tab/Enter/Escape 访问页签、菜单、抽屉和对话框 | 键盘可完成主流程，焦点不丢失 | NOT-RUN |
| TC-NAV-010 | P1 | 用无 new-rag feature flag 的 workspace 访问 | 不显示新版入口或给出明确说明 | NOT-RUN |
## B. 列表、搜索和筛选
| ID | P | 测试场景/步骤 | 预期结果 | 本轮结果 |
|---|---|---|---|---|
| TC-LI-001 | P0 | 加载有数据的新版列表 | 每张卡显示名称、描述、文档/应用计数、更新时间 | PASS |
| TC-LI-002 | P0 | 输入名称子串 `ces` | 只显示 `ceshi` | PASS |
| TC-LI-003 | P0 | 输入大写 `CESHI` | 搜索大小写不敏感，显示 `ceshi` | PASS |
| TC-LI-004 | P1 | 输入不存在的唯一字符串 | 显示“无搜索结果”及清除条件入口 | FAIL，见 KF-BUG-011 |
| TC-LI-005 | P1 | 清空搜索框 | 恢复全部列表 | PASS |
| TC-LI-006 | P1 | 打开“创建者”下拉 | 显示成员搜索、列表和重置入口 | PASS |
| TC-LI-007 | P1 | 搜索不存在的创建者 | 显示“没有找到创建者” | PASS |
| TC-LI-008 | P1 | 选中当前创建者 | 条件显示“创建者: 1”，结果与成员匹配 | PASS |
| TC-LI-009 | P1 | 重置创建者筛选 | 标签和列表恢复 | PASS |
| TC-LI-010 | P1 | 创建新空间后回列表 | 新空间出现在列表前部，描述和计数正确 | PASS |
| TC-LI-011 | P1 | 点击“标签” | 如后端未提供则给出明确不可用提示 | PASS，提示 KnowledgeFS 待提供 metadata |
| TC-LI-012 | P1 | 点击“外部知识库 API” | 打开管理抽屉，无凭据泄露 | PASS |
| TC-LI-013 | P1 | 点击“服务 API” | 显示 endpoint 和 key 管理入口 | PASS |
| TC-LI-014 | P1 | 超过一页数据时搜索只在末页出现的名称 | 搜索全数据集，不只过滤已加载卡片 | STATIC-RISK，数据不足未实证 |
| TC-LI-015 | P2 | 连续快速改变搜索和创建者条件 | 旧请求不覆盖新请求，无闪回 | NOT-RUN |
| ID | P | 测试场景/步骤 | 预期结果 | 本轮结果 |
| --------- | --- | ------------------------------------ | --------------------------------------------- | -------------------------------------- |
| TC-LI-001 | P0 | 加载有数据的新版列表 | 每张卡显示名称、描述、文档/应用计数、更新时间 | PASS |
| TC-LI-002 | P0 | 输入名称子串 `ces` | 只显示 `ceshi` | PASS |
| TC-LI-003 | P0 | 输入大写 `CESHI` | 搜索大小写不敏感，显示 `ceshi` | PASS |
| TC-LI-004 | P1 | 输入不存在的唯一字符串 | 显示“无搜索结果”及清除条件入口 | FAIL，见 KF-BUG-011 |
| TC-LI-005 | P1 | 清空搜索框 | 恢复全部列表 | PASS |
| TC-LI-006 | P1 | 打开“创建者”下拉 | 显示成员搜索、列表和重置入口 | PASS |
| TC-LI-007 | P1 | 搜索不存在的创建者 | 显示“没有找到创建者” | PASS |
| TC-LI-008 | P1 | 选中当前创建者 | 条件显示“创建者: 1”，结果与成员匹配 | PASS |
| TC-LI-009 | P1 | 重置创建者筛选 | 标签和列表恢复 | PASS |
| TC-LI-010 | P1 | 创建新空间后回列表 | 新空间出现在列表前部，描述和计数正确 | PASS |
| TC-LI-011 | P1 | 点击“标签” | 如后端未提供则给出明确不可用提示 | PASS，提示 KnowledgeFS 待提供 metadata |
| TC-LI-012 | P1 | 点击“外部知识库 API” | 打开管理抽屉，无凭据泄露 | PASS |
| TC-LI-013 | P1 | 点击“服务 API” | 显示 endpoint 和 key 管理入口 | PASS |
| TC-LI-014 | P1 | 超过一页数据时搜索只在末页出现的名称 | 搜索全数据集，不只过滤已加载卡片 | STATIC-RISK，数据不足未实证 |
| TC-LI-015 | P2 | 连续快速改变搜索和创建者条件 | 旧请求不覆盖新请求，无闪回 | NOT-RUN |
## C. 创建知识库
| ID | P | 测试场景/输入 | 预期结果 | 本轮结果 |
|---|---|---|---|---|
| TC-CR-001 | P0 | 点击“创建” | 打开创建对话框，默认从空白开始/only_me | PASS |
| TC-CR-002 | P0 | 名称留空 | 创建按钮禁用或显示必填错误 | PASS |
| TC-CR-003 | P0 | 名称仅空格 | 视为空值，禁止创建 | PASS |
| TC-CR-004 | P0 | 名称 1 字 | 创建成功 | NOT-RUN |
| TC-CR-005 | P0 | 名称精确 40 字 | 允许提交并保存成功 | PASS，在 QA Settings 验证同约束 |
| TC-CR-006 | P0 | 名称 41 字 | 字段级拦截，不请求后端 | FAIL，见 KF-BUG-002 |
| TC-CR-007 | P0 | 描述精确 2000 字 | 允许保存 | PASS，在 QA Settings 实测 |
| TC-CR-008 | P0 | 描述 2001 字 | 字段级拦截，不请求后端 | FAIL，Settings 同约束见 KF-BUG-003 |
| TC-CR-009 | P0 | 从空白开始 + 合法名称 | 只创建 1 个空间，202/provisioning 后进入 active Sources | PASS |
| TC-CR-010 | P0 | 在加载中连续双击“创建知识库” | 幂等，只创建 1 个空间 | NOT-RUN |
| TC-CR-011 | P0 | 提交后制造超时，再点重试 | 通过幂等 key 收敛到同一 space | NOT-RUN |
| TC-CR-012 | P1 | 可见权限选择 only_me | 只有 owner 可见，创建成功 | PASS |
| TC-CR-013 | P1 | 可见权限选择 all_team_members | 所有有效成员可以 viewer 身份查看 | NOT-RUN，缺多用户 |
| TC-CR-014 | P1 | 选择 partial_members 但不选成员 | 显示“至少一名成员”并禁止保存 | PASS，Settings 实测 |
| TC-CR-015 | P1 | 连接数据源方式创建 | 创建空间后进入 provider 配置，取消不留垃圾数据 | NOT-RUN |
| TC-CR-016 | P1 | 上传文件方式创建 | 创建与 staged upload claim 原子收敛，不重复文档 | ENV-BLOCKED，Documents 入口已证实 staging 服务异常，本轮未再创建空间 |
| TC-CR-017 | P1 | 模型配置 pending/fail/retry | 显示可解释状态和重试，不重复创建 | NOT-RUN |
| TC-CR-018 | P1 | 同 slug 不同创建意图/幂等载荷 | 返回可理解 409/4xx，不出现 500 | STATIC-RISK |
| ID | P | 测试场景/输入 | 预期结果 | 本轮结果 |
| --------- | --- | ------------------------------- | ------------------------------------------------------- | -------------------------------------------------------------------- |
| TC-CR-001 | P0 | 点击“创建” | 打开创建对话框，默认从空白开始/only_me | PASS |
| TC-CR-002 | P0 | 名称留空 | 创建按钮禁用或显示必填错误 | PASS |
| TC-CR-003 | P0 | 名称仅空格 | 视为空值，禁止创建 | PASS |
| TC-CR-004 | P0 | 名称 1 字 | 创建成功 | NOT-RUN |
| TC-CR-005 | P0 | 名称精确 40 字 | 允许提交并保存成功 | PASS，在 QA Settings 验证同约束 |
| TC-CR-006 | P0 | 名称 41 字 | 字段级拦截，不请求后端 | FAIL，见 KF-BUG-002 |
| TC-CR-007 | P0 | 描述精确 2000 字 | 允许保存 | PASS，在 QA Settings 实测 |
| TC-CR-008 | P0 | 描述 2001 字 | 字段级拦截，不请求后端 | FAIL，Settings 同约束见 KF-BUG-003 |
| TC-CR-009 | P0 | 从空白开始 + 合法名称 | 只创建 1 个空间，202/provisioning 后进入 active Sources | PASS |
| TC-CR-010 | P0 | 在加载中连续双击“创建知识库” | 幂等，只创建 1 个空间 | NOT-RUN |
| TC-CR-011 | P0 | 提交后制造超时，再点重试 | 通过幂等 key 收敛到同一 space | NOT-RUN |
| TC-CR-012 | P1 | 可见权限选择 only_me | 只有 owner 可见，创建成功 | PASS |
| TC-CR-013 | P1 | 可见权限选择 all_team_members | 所有有效成员可以 viewer 身份查看 | NOT-RUN，缺多用户 |
| TC-CR-014 | P1 | 选择 partial_members 但不选成员 | 显示“至少一名成员”并禁止保存 | PASS，Settings 实测 |
| TC-CR-015 | P1 | 连接数据源方式创建 | 创建空间后进入 provider 配置，取消不留垃圾数据 | NOT-RUN |
| TC-CR-016 | P1 | 上传文件方式创建 | 创建与 staged upload claim 原子收敛，不重复文档 | ENV-BLOCKED，Documents 入口已证实 staging 服务异常，本轮未再创建空间 |
| TC-CR-017 | P1 | 模型配置 pending/fail/retry | 显示可解释状态和重试，不重复创建 | NOT-RUN |
| TC-CR-018 | P1 | 同 slug 不同创建意图/幂等载荷 | 返回可理解 409/4xx，不出现 500 | STATIC-RISK |
## D. 数据源与网站抓取
| ID | P | 测试场景/输入 | 预期结果 | 本轮结果 |
|---|---|---|---|---|
| TC-SO-001 | P0 | 空间打开 Sources | 显示空状态、常用 provider 和“添加数据源” | PASS |
| TC-SO-002 | P0 | 打开添加数据源 | 显示 Website/Online Documents/Online Drive 三类 | PASS |
| TC-SO-003 | P0 | 检查 provider 清单 | Firecrawl/Jina/WaterCrawl、Notion/Google Docs/Confluence、Drive/OneDrive/S3 入口正确 | PASS |
| TC-SO-004 | P0 | Website 根 URL 输入 `not-a-url` | 提示必须为 http(s)，抓取按钮禁用 | PASS |
| TC-SO-005 | P0 | Website 根 URL 输入 `https://example.com` | URL 校验通过，名称有效后可抓取 | PASS |
| TC-SO-006 | P0 | 最大页数输入 0 | 提示最小为 1，禁止抓取 | FAIL，可见 0/实际 1 |
| TC-SO-007 | P0 | 最大页数输入 1 | 允许抓取 1 页 | PASS |
| TC-SO-008 | P0 | 最大页数输入 1.5 | 提示只能是整数，禁止抓取 | FAIL，可见 1.5/实际 1 |
| TC-SO-009 | P0 | 最大页数输入 200 | 允许 | PASS |
| TC-SO-010 | P0 | 最大页数输入 1001 | 提示最大 200，禁止抓取 | FAIL，可见 1001/实际 200 |
| TC-SO-011 | P0 | Firecrawl 连接状态 | 显示已连接时才允许预览 | PASS |
| TC-SO-012 | P0 | Firecrawl 对 example.com 抓取预览 | 在可接受时间内返回页列表或明确失败 | ENV，36+ 秒仍 0 页 |
| TC-SO-013 | P0 | 抓取进行中点击 Stop | 进入 stopping，最终 stopped，表单可再操作 | PASS |
| TC-SO-014 | P0 | stopped 后点 Retry | 仅新建 1 个后续工作流，进度重置 | NOT-RUN，只检查入口 |
| TC-SO-015 | P0 | 抓取返回页面后全选/反选/单选 | 选中数量、最多 200 和添加按钮状态正确 | ENV |
| TC-SO-016 | P0 | 选择页面后“添加数据源” | 创建 source，文档进入解析/索引，不留临时 workflow | ENV |
| TC-SO-017 | P1 | 有草稿时点击取消/离开 | 弹出“放弃数据源更改”确认 | PASS |
| TC-SO-018 | P1 | 在确认对话框点“取消” | 草稿保留，返回配置页 | PASS |
| TC-SO-019 | P1 | 在确认对话框点“放弃草稿” | 临时配置/预览被清理，列表无 source | PENDING-CONFIRM |
| TC-SO-020 | P1 | 选 Jina Reader | 未安装时明确显示安装入口 | PASS，环境显示未安装 |
| TC-SO-021 | P1 | 选 WaterCrawl 并验证凭据 | 未安装/未配置时给出可操作的状态 | NOT-RUN |
| TC-SO-022 | P1 | 同时提供 connectionId 和 credentials | 请求被 422 拒绝，不创建 source | NOT-RUN |
| TC-SO-023 | P1 | Source PATCH 为空 payload | 拒绝无效操作，无 revision 变化 | NOT-RUN |
| TC-SO-024 | P1 | sync policy custom interval = 3599/3600/2592000/2592001 | 只允许 3600–2592000 秒 | NOT-RUN |
| TC-SO-025 | P1 | manual mode 同时提交 customInterval | 拒绝矛盾组合，不静默保留无效值 | STATIC-RISK |
| TC-SO-026 | P1 | stale expectedRevision/sourceVersion 保存数据源 | 返回 409，UI 提示刷新后重试 | NOT-RUN |
| TC-SO-027 | P1 | 删除 source 选 `documents=keep` | source 删除，文档和检索仍可用 | PENDING-CONFIRM |
| TC-SO-028 | P1 | 删除 source 选 `documents=cascade` | source 和所属文档按 durable job 完成清理 | PENDING-CONFIRM |
| ID | P | 测试场景/输入 | 预期结果 | 本轮结果 |
| --------- | --- | ------------------------------------------------------- | ------------------------------------------------------------------------------------ | ------------------------ |
| TC-SO-001 | P0 | 空间打开 Sources | 显示空状态、常用 provider 和“添加数据源” | PASS |
| TC-SO-002 | P0 | 打开添加数据源 | 显示 Website/Online Documents/Online Drive 三类 | PASS |
| TC-SO-003 | P0 | 检查 provider 清单 | Firecrawl/Jina/WaterCrawl、Notion/Google Docs/Confluence、Drive/OneDrive/S3 入口正确 | PASS |
| TC-SO-004 | P0 | Website 根 URL 输入 `not-a-url` | 提示必须为 http(s)，抓取按钮禁用 | PASS |
| TC-SO-005 | P0 | Website 根 URL 输入 `https://example.com` | URL 校验通过，名称有效后可抓取 | PASS |
| TC-SO-006 | P0 | 最大页数输入 0 | 提示最小为 1，禁止抓取 | FAIL，可见 0/实际 1 |
| TC-SO-007 | P0 | 最大页数输入 1 | 允许抓取 1 页 | PASS |
| TC-SO-008 | P0 | 最大页数输入 1.5 | 提示只能是整数，禁止抓取 | FAIL，可见 1.5/实际 1 |
| TC-SO-009 | P0 | 最大页数输入 200 | 允许 | PASS |
| TC-SO-010 | P0 | 最大页数输入 1001 | 提示最大 200，禁止抓取 | FAIL，可见 1001/实际 200 |
| TC-SO-011 | P0 | Firecrawl 连接状态 | 显示已连接时才允许预览 | PASS |
| TC-SO-012 | P0 | Firecrawl 对 example.com 抓取预览 | 在可接受时间内返回页列表或明确失败 | ENV，36+ 秒仍 0 页 |
| TC-SO-013 | P0 | 抓取进行中点击 Stop | 进入 stopping，最终 stopped，表单可再操作 | PASS |
| TC-SO-014 | P0 | stopped 后点 Retry | 仅新建 1 个后续工作流，进度重置 | NOT-RUN，只检查入口 |
| TC-SO-015 | P0 | 抓取返回页面后全选/反选/单选 | 选中数量、最多 200 和添加按钮状态正确 | ENV |
| TC-SO-016 | P0 | 选择页面后“添加数据源” | 创建 source，文档进入解析/索引，不留临时 workflow | ENV |
| TC-SO-017 | P1 | 有草稿时点击取消/离开 | 弹出“放弃数据源更改”确认 | PASS |
| TC-SO-018 | P1 | 在确认对话框点“取消” | 草稿保留，返回配置页 | PASS |
| TC-SO-019 | P1 | 在确认对话框点“放弃草稿” | 临时配置/预览被清理，列表无 source | PENDING-CONFIRM |
| TC-SO-020 | P1 | 选 Jina Reader | 未安装时明确显示安装入口 | PASS，环境显示未安装 |
| TC-SO-021 | P1 | 选 WaterCrawl 并验证凭据 | 未安装/未配置时给出可操作的状态 | NOT-RUN |
| TC-SO-022 | P1 | 同时提供 connectionId 和 credentials | 请求被 422 拒绝，不创建 source | NOT-RUN |
| TC-SO-023 | P1 | Source PATCH 为空 payload | 拒绝无效操作，无 revision 变化 | NOT-RUN |
| TC-SO-024 | P1 | sync policy custom interval = 3599/3600/2592000/2592001 | 只允许 3600–2592000 秒 | NOT-RUN |
| TC-SO-025 | P1 | manual mode 同时提交 customInterval | 拒绝矛盾组合，不静默保留无效值 | STATIC-RISK |
| TC-SO-026 | P1 | stale expectedRevision/sourceVersion 保存数据源 | 返回 409，UI 提示刷新后重试 | NOT-RUN |
| TC-SO-027 | P1 | 删除 source 选 `documents=keep` | source 删除，文档和检索仍可用 | PENDING-CONFIRM |
| TC-SO-028 | P1 | 删除 source 选 `documents=cascade` | source 和所属文档按 durable job 完成清理 | PENDING-CONFIRM |
## E. 文档上传、列表与任务
| ID | P | 测试场景/输入 | 预期结果 | 本轮结果 |
|---|---|---|---|---|
| TC-DO-001 | P0 | 空知识库打开 Documents | 显示“暂无文档”和上传入口 | PASS |
| TC-DO-002 | P0 | 点击“添加文档” | 打开上传表单，显示支持格式和 15 MB 限制 | PASS |
| TC-DO-003 | P0 | 上传 TXT/MD/CSV/JSONL/HTML/PDF/DOCX/XLSX 小文件 | staged upload 成功，claim 一次，文档进入 processing→ready | FAIL，3 个合法 TXT/MD 均显示 `Internal Server Error`，0 文档 |
| TC-DO-004 | P0 | 上传 Unicode 文件名和中文内容 | 文件名、内容、分块和下载名不乱码 | FAIL-BLOCKED，中文文件名本地显示正常，但 staging 500，无法验证解析 |
| TC-DO-005 | P0 | 上传空文件 | 返回 422，UI 明确说明空文件，无空文档 | FAIL，0 B 被计为有效并启用提交，后端 422 仅显示英文通用错误 |
| TC-DO-006 | P0 | 上传不支持 `.exe` | 客户端或服务端拒绝，无 staged upload 残留 | PASS，本地显示“不支持或无效的文件类型”，0/1 有效且提交禁用 |
| TC-DO-007 | P0 | 上传精确 15 MiB 文件 | 根据合同允许边界值，不会 413 | PARTIAL/FAIL，前端正确接收，但 43+ 秒停留“正在上传…”；取消后无文档 |
| TC-DO-008 | P0 | 上传 15 MiB + 1 byte | 返回 413，UI 提示超限，无计费/索引任务 | PASS，本地标记“超过 15 MB 限制”，0/1 有效且未 staging |
| TC-DO-009 | P0 | 同时上传合法、空、超限和不支持文件 | 每个文件独立结果，部分失败不丢成功项，可重试失败项 | PARTIAL/FAIL，合法文件逐个报错并另有汇总错误；未能进入 claim 部分成功 |
| TC-DO-010 | P0 | 对同一 staged upload 网络重试 | 同 upload ID 仅被 claim 一次，无重复文档 | ENV-BLOCKED，staging 未成功返回 upload ID |
| TC-DO-011 | P0 | claim 前 abort staged upload | 上传被废弃，不可再 claim | PARTIAL，取消 15 MiB in-flight 上传后表单关闭且 0 文档，但请求随后仍弹失败提示 |
| TC-DO-012 | P0 | claim 后再 abort | 拒绝废弃，已创建文档状态不被破坏 | ENV-BLOCKED，无可 claim 的 upload ID |
| TC-DO-013 | P0 | 不同用户或不同 space 试图 claim upload | 统一返回无权/不存在，不能跨用户移动文件 | NOT-RUN |
| TC-DO-014 | P1 | 上传同内容不同文件名 | 产品按规则创建两个 logical document 或明确去重，不静默丢失 | ENV-BLOCKED，两个文件均 staging 500，未创建 logical document |
| TC-DO-015 | P0 | 现有文档列表加载 | 显示名称、来源、状态、修订、更新时间 | PASS，7 条 |
| TC-DO-016 | P0 | 状态筛选 Ready | 只显示 ready 文档 | PASS，4 条 |
| TC-DO-017 | P0 | 状态筛选 Failed | 只显示 failed 文档 | PASS，3 条 |
| TC-DO-018 | P1 | 文档名大小写不敏感搜索 | 返回匹配项，清空后恢复 | PASS |
| TC-DO-019 | P1 | 搜索无匹配 | 显示明确无结果空状态 | PASS |
| TC-DO-020 | P0 | 打开 Tasks 抽屉 | 显示需关注/失败任务、原因和可用操作 | PASS，5 条失败/中断 |
| TC-DO-021 | P0 | 对失败任务点 Retry | 只创建一个 retry attempt，状态可跟踪 | PENDING-CONFIRM，不重试既有业务文档 |
| TC-DO-022 | P1 | 对进行中任务 Cancel | 任务进入 canceling/canceled，无半索引残留 | PENDING-CONFIRM |
| TC-DO-023 | P1 | 任务 SSE 断网再连 | 续接或 polling 收敛，不倒退、不重复任务 | NOT-RUN |
| TC-DO-024 | P1 | 打开 Metadata schema 对话框 | 显示现有 schema；能力未开放时按钮禁用且有说明 | PASS，Add Metadata 禁用 |
| TC-DO-025 | P1 | 勾选一个文档 | 显示批量操作条和正确选中计数 | PASS |
| TC-DO-026 | P1 | 选中文档后查看 Reindex/Download/Delete 状态 | 按权限和实现能力准确启用/禁用 | PASS，Reindex 可用，Download/Delete 禁用 |
| TC-DO-027 | P0 | 批量 Reindex 选择 1/1000/1001 文档 | 只允许 1–1000；单一 durable job，不重复 | PENDING-CONFIRM |
| TC-DO-028 | P0 | Reindex payload 同时包含 `all=true` 和 documentIds | 返回 422，不运行任务 | NOT-RUN |
| TC-DO-029 | P0 | 批量删除含存在/不存在 ID | 事件结果可追踪，幂等重放不多删 | PENDING-CONFIRM |
| TC-DO-030 | P1 | 行菜单打开 | 根据状态显示 rename/reindex/disable/archive/download/delete | PASS |
| TC-DO-031 | P1 | Rename 留空 | 保存禁用或字段必填 | PASS |
| TC-DO-032 | P1 | Rename 输入 304 字 | 按后端合同限制，超限时前端拦截 | FAIL-CANDIDATE，保存仍可用，未提交 |
| TC-DO-033 | P1 | Ready/Failed/Processing 文档的禁用、归档、下载按钮 | 按状态机正确启用，禁用项有解释 | PARTIAL，已检查当前状态 |
| TC-DO-034 | P1 | 两标签页并发 metadata PATCH，使用 stale rowVersion | 第二个返回 409，UI 刷新后可重试 | NOT-RUN |
| TC-DO-035 | P0 | 删除文档时重复使用同 Idempotency-Key/不同 payload | 同 payload 重放同结果，不同 payload 返回冲突 | PENDING-CONFIRM |
| ID | P | 测试场景/输入 | 预期结果 | 本轮结果 |
| --------- | --- | -------------------------------------------------- | ----------------------------------------------------------- | ------------------------------------------------------------------------------ |
| TC-DO-001 | P0 | 空知识库打开 Documents | 显示“暂无文档”和上传入口 | PASS |
| TC-DO-002 | P0 | 点击“添加文档” | 打开上传表单，显示支持格式和 15 MB 限制 | PASS |
| TC-DO-003 | P0 | 上传 TXT/MD/CSV/JSONL/HTML/PDF/DOCX/XLSX 小文件 | staged upload 成功，claim 一次，文档进入 processing→ready | FAIL，3 个合法 TXT/MD 均显示 `Internal Server Error`，0 文档 |
| TC-DO-004 | P0 | 上传 Unicode 文件名和中文内容 | 文件名、内容、分块和下载名不乱码 | FAIL-BLOCKED，中文文件名本地显示正常，但 staging 500，无法验证解析 |
| TC-DO-005 | P0 | 上传空文件 | 返回 422，UI 明确说明空文件，无空文档 | FAIL，0 B 被计为有效并启用提交，后端 422 仅显示英文通用错误 |
| TC-DO-006 | P0 | 上传不支持 `.exe` | 客户端或服务端拒绝，无 staged upload 残留 | PASS，本地显示“不支持或无效的文件类型”，0/1 有效且提交禁用 |
| TC-DO-007 | P0 | 上传精确 15 MiB 文件 | 根据合同允许边界值，不会 413 | PARTIAL/FAIL，前端正确接收，但 43+ 秒停留“正在上传…”；取消后无文档 |
| TC-DO-008 | P0 | 上传 15 MiB + 1 byte | 返回 413，UI 提示超限，无计费/索引任务 | PASS，本地标记“超过 15 MB 限制”，0/1 有效且未 staging |
| TC-DO-009 | P0 | 同时上传合法、空、超限和不支持文件 | 每个文件独立结果，部分失败不丢成功项，可重试失败项 | PARTIAL/FAIL，合法文件逐个报错并另有汇总错误；未能进入 claim 部分成功 |
| TC-DO-010 | P0 | 对同一 staged upload 网络重试 | 同 upload ID 仅被 claim 一次，无重复文档 | ENV-BLOCKED，staging 未成功返回 upload ID |
| TC-DO-011 | P0 | claim 前 abort staged upload | 上传被废弃，不可再 claim | PARTIAL，取消 15 MiB in-flight 上传后表单关闭且 0 文档，但请求随后仍弹失败提示 |
| TC-DO-012 | P0 | claim 后再 abort | 拒绝废弃，已创建文档状态不被破坏 | ENV-BLOCKED，无可 claim 的 upload ID |
| TC-DO-013 | P0 | 不同用户或不同 space 试图 claim upload | 统一返回无权/不存在，不能跨用户移动文件 | NOT-RUN |
| TC-DO-014 | P1 | 上传同内容不同文件名 | 产品按规则创建两个 logical document 或明确去重，不静默丢失 | ENV-BLOCKED，两个文件均 staging 500，未创建 logical document |
| TC-DO-015 | P0 | 现有文档列表加载 | 显示名称、来源、状态、修订、更新时间 | PASS，7 条 |
| TC-DO-016 | P0 | 状态筛选 Ready | 只显示 ready 文档 | PASS，4 条 |
| TC-DO-017 | P0 | 状态筛选 Failed | 只显示 failed 文档 | PASS，3 条 |
| TC-DO-018 | P1 | 文档名大小写不敏感搜索 | 返回匹配项，清空后恢复 | PASS |
| TC-DO-019 | P1 | 搜索无匹配 | 显示明确无结果空状态 | PASS |
| TC-DO-020 | P0 | 打开 Tasks 抽屉 | 显示需关注/失败任务、原因和可用操作 | PASS，5 条失败/中断 |
| TC-DO-021 | P0 | 对失败任务点 Retry | 只创建一个 retry attempt，状态可跟踪 | PENDING-CONFIRM，不重试既有业务文档 |
| TC-DO-022 | P1 | 对进行中任务 Cancel | 任务进入 canceling/canceled，无半索引残留 | PENDING-CONFIRM |
| TC-DO-023 | P1 | 任务 SSE 断网再连 | 续接或 polling 收敛，不倒退、不重复任务 | NOT-RUN |
| TC-DO-024 | P1 | 打开 Metadata schema 对话框 | 显示现有 schema；能力未开放时按钮禁用且有说明 | PASS，Add Metadata 禁用 |
| TC-DO-025 | P1 | 勾选一个文档 | 显示批量操作条和正确选中计数 | PASS |
| TC-DO-026 | P1 | 选中文档后查看 Reindex/Download/Delete 状态 | 按权限和实现能力准确启用/禁用 | PASS，Reindex 可用，Download/Delete 禁用 |
| TC-DO-027 | P0 | 批量 Reindex 选择 1/1000/1001 文档 | 只允许 1–1000；单一 durable job，不重复 | PENDING-CONFIRM |
| TC-DO-028 | P0 | Reindex payload 同时包含 `all=true` 和 documentIds | 返回 422，不运行任务 | NOT-RUN |
| TC-DO-029 | P0 | 批量删除含存在/不存在 ID | 事件结果可追踪，幂等重放不多删 | PENDING-CONFIRM |
| TC-DO-030 | P1 | 行菜单打开 | 根据状态显示 rename/reindex/disable/archive/download/delete | PASS |
| TC-DO-031 | P1 | Rename 留空 | 保存禁用或字段必填 | PASS |
| TC-DO-032 | P1 | Rename 输入 304 字 | 按后端合同限制，超限时前端拦截 | FAIL-CANDIDATE，保存仍可用，未提交 |
| TC-DO-033 | P1 | Ready/Failed/Processing 文档的禁用、归档、下载按钮 | 按状态机正确启用，禁用项有解释 | PARTIAL，已检查当前状态 |
| TC-DO-034 | P1 | 两标签页并发 metadata PATCH，使用 stale rowVersion | 第二个返回 409，UI 刷新后可重试 | NOT-RUN |
| TC-DO-035 | P0 | 删除文档时重复使用同 Idempotency-Key/不同 payload | 同 payload 重放同结果，不同 payload 返回冲突 | PENDING-CONFIRM |
## F. 文档详情、修订、分块与 Metadata
| ID | P | 测试场景/步骤 | 预期结果 | 本轮结果 |
|---|---|---|---|---|
| TC-DD-001 | P0 | 打开 Ready 文档详情 | 标题、内容、来源、状态正常加载，无错误 toast | FAIL，内容成功但 3 条 404 toast |
| TC-DD-002 | P0 | 详情页不展示未授权原始内容 | viewer 仅读且内容遵循 workspace 隔离 | NOT-RUN |
| TC-DD-003 | P1 | 点击 Metadata “编辑” | 打开编辑器或明确提示不支持，按钮可恢复 | FAIL，见 KF-BUG-007 |
| TC-DD-004 | P1 | 查看 revisions 列表 | 按时间倒序，active revision 明确标识 | PENDING-CONFIRM，需自有文档 |
| TC-DD-005 | P1 | 切换不同 revision | 内容、chunk 和 outline 与修订一致，无版本竞态 | PENDING-CONFIRM |
| TC-DD-006 | P1 | 查看 revision chunks | 分页/游标无重复丢失，chunk 内容与解析结果一致 | PENDING-CONFIRM |
| TC-DD-007 | P1 | 打开单个 chunk 详情 | 显示标识、位置、内容和 metadata，新版不提供编辑假入口 | PENDING-CONFIRM |
| TC-DD-008 | P1 | 查看 outline | 层级顺序与原文档匹配，空 outline 有空状态 | PENDING-CONFIRM |
| TC-DD-009 | P1 | schema 名称 1/255/256 字及重名 | 允许 1–255，拒绝 256/重名/内建名 | PENDING-CONFIRM |
| TC-DD-010 | P1 | schema type 为 string/number/time | 每种类型保存和文档值校验正确 | PENDING-CONFIRM |
| TC-DD-011 | P1 | stale schema expectedRowVersion 更新/删除 | 返回 409，不静默覆盖 | PENDING-CONFIRM |
| TC-DD-012 | P1 | metadata value 与 schema type 不匹配 | 字段级拒绝，其他值不受影响 | PENDING-CONFIRM |
| ID | P | 测试场景/步骤 | 预期结果 | 本轮结果 |
| --------- | --- | ----------------------------------------- | ----------------------------------------------------- | ------------------------------- |
| TC-DD-001 | P0 | 打开 Ready 文档详情 | 标题、内容、来源、状态正常加载，无错误 toast | FAIL，内容成功但 3 条 404 toast |
| TC-DD-002 | P0 | 详情页不展示未授权原始内容 | viewer 仅读且内容遵循 workspace 隔离 | NOT-RUN |
| TC-DD-003 | P1 | 点击 Metadata “编辑” | 打开编辑器或明确提示不支持，按钮可恢复 | FAIL，见 KF-BUG-007 |
| TC-DD-004 | P1 | 查看 revisions 列表 | 按时间倒序，active revision 明确标识 | PENDING-CONFIRM，需自有文档 |
| TC-DD-005 | P1 | 切换不同 revision | 内容、chunk 和 outline 与修订一致，无版本竞态 | PENDING-CONFIRM |
| TC-DD-006 | P1 | 查看 revision chunks | 分页/游标无重复丢失，chunk 内容与解析结果一致 | PENDING-CONFIRM |
| TC-DD-007 | P1 | 打开单个 chunk 详情 | 显示标识、位置、内容和 metadata，新版不提供编辑假入口 | PENDING-CONFIRM |
| TC-DD-008 | P1 | 查看 outline | 层级顺序与原文档匹配，空 outline 有空状态 | PENDING-CONFIRM |
| TC-DD-009 | P1 | schema 名称 1/255/256 字及重名 | 允许 1–255，拒绝 256/重名/内建名 | PENDING-CONFIRM |
| TC-DD-010 | P1 | schema type 为 string/number/time | 每种类型保存和文档值校验正确 | PENDING-CONFIRM |
| TC-DD-011 | P1 | stale schema expectedRowVersion 更新/删除 | 返回 409，不静默覆盖 | PENDING-CONFIRM |
| TC-DD-012 | P1 | metadata value 与 schema type 不匹配 | 字段级拒绝，其他值不受影响 | PENDING-CONFIRM |
## G. 概览与可观测性
| ID | P | 测试场景/步骤 | 预期结果 | 本轮结果 |
|---|---|---|---|---|
| TC-OV-001 | P0 | 新建空间打开 Overview | 显示添加第一个数据源 onboarding，指标为— | PASS |
| TC-OV-002 | P0 | 有数据空间查看 24h/30d 指标 | 时间范围切换后查询数、回答率和对比值一致 | PASS，24h 0，30d 11/100% |
| TC-OV-003 | P1 | 需要关注列表分页 | 前后翻页稳定，不重复丢失 | PASS，2 页 |
| TC-OV-004 | P1 | 打开最近活动抽屉 | Today/30d 和活动事件显示正常 | PASS |
| TC-OV-005 | P1 | 最近活动按 operator 筛选 | 只显示对应 actor/System 事件 | PASS |
| TC-OV-006 | P1 | 资产概况文档/实体/关系/覆盖数 | 与后端 inventory 一致 | PASS，4/398/380/104 |
| TC-OV-007 | P1 | Documents 列表包含 failed 文档时核对 Overview “文档” | 标签说明是 total 还是 ready，各页口径一致 | AMBIGUOUS，Overview=4，列表/卡片=7 |
| TC-OV-008 | P1 | 新上传文档完成后不刷新查看指标 | 按设计实时/轮询更新，不长期过期 | PENDING-CONFIRM |
| TC-OV-009 | P1 | 删除文档/source/space 后核对 stats | durable job 完成后计数无残留 | PENDING-CONFIRM |
| ID | P | 测试场景/步骤 | 预期结果 | 本轮结果 |
| --------- | --- | ---------------------------------------------------- | ----------------------------------------- | ---------------------------------- |
| TC-OV-001 | P0 | 新建空间打开 Overview | 显示添加第一个数据源 onboarding，指标为— | PASS |
| TC-OV-002 | P0 | 有数据空间查看 24h/30d 指标 | 时间范围切换后查询数、回答率和对比值一致 | PASS，24h 0，30d 11/100% |
| TC-OV-003 | P1 | 需要关注列表分页 | 前后翻页稳定，不重复丢失 | PASS，2 页 |
| TC-OV-004 | P1 | 打开最近活动抽屉 | Today/30d 和活动事件显示正常 | PASS |
| TC-OV-005 | P1 | 最近活动按 operator 筛选 | 只显示对应 actor/System 事件 | PASS |
| TC-OV-006 | P1 | 资产概况文档/实体/关系/覆盖数 | 与后端 inventory 一致 | PASS，4/398/380/104 |
| TC-OV-007 | P1 | Documents 列表包含 failed 文档时核对 Overview “文档” | 标签说明是 total 还是 ready，各页口径一致 | AMBIGUOUS，Overview=4，列表/卡片=7 |
| TC-OV-008 | P1 | 新上传文档完成后不刷新查看指标 | 按设计实时/轮询更新，不长期过期 | PENDING-CONFIRM |
| TC-OV-009 | P1 | 删除文档/source/space 后核对 stats | durable job 完成后计数无残留 | PENDING-CONFIRM |
## H. Fast / Deep / Research 检索
| ID | P | 测试场景/输入 | 预期结果 | 本轮结果 |
|---|---|---|---|---|
| TC-RE-001 | P0 | 空库打开 Retrieval | 显示输入框、三种模式和空记录状态 | PASS |
| TC-RE-002 | P0 | 问题留空或仅空格 | Start 禁用 | PASS |
| TC-RE-003 | P0 | 问题精确 2000 字 | UI 允许，后端 query 长度约束不冲突 | PARTIAL，已核对 maxLength=2000 |
| TC-RE-004 | P0 | 问题 2001 字 | UI 拦截/字段错误，不静默截断 | NOT-RUN |
| TC-RE-005 | P0 | 单次 Fast Start | 只产生 1 个 admission、1 个 SSE 任务、1 条记录 | PASS，QA 空库 813 ms 返回 1 条记录、0 分段 |
| TC-RE-006 | P0 | 单次 Fast Retry | 只生成 1 个新 attempt，与原 trace 关联 | FAIL，生成 2 条，KF-BUG-001 |
| TC-RE-007 | P0 | 单次 Deep Start | 只产生 1 个任务和 1 条记录 | FAIL，生成 2 条，KF-BUG-001 |
| TC-RE-008 | P0 | 单次 Research Start | 只产生 1 个 research task，阶段流式更新 | FAIL/PARTIAL，既有库可启动；QA 空库单击后 27+ 秒无任务、阶段或错误，见 KF-BUG-019 |
| TC-RE-009 | P0 | Fast 对唯一 marker 检索 | 答案包含 marker，citation 定位到正确 chunk | PENDING-CONFIRM，需上传并有额度 |
| TC-RE-010 | P0 | Deep 对同一 marker 检索 | 深度检索只生成一个结果，引用可回溯 | PENDING-CONFIRM |
| TC-RE-011 | P0 | Research 对多文档问题 | 计划→检索→分析→结果完整，证据与冲突可查 | PENDING-CONFIRM |
| TC-RE-012 | P0 | 无结果查询 | 明确“无充分证据”，不编造引用 | PASS，QA 空库 Fast/Deep 明确“未召回分段”，0 引用 |
| TC-RE-013 | P0 | Fast/Deep 正常查询 | 流式完成且无错误，记录状态与答案一致 | PARTIAL，QA 空库正常 0 结果；既有库受模型额度阻塞 |
| TC-RE-014 | P1 | Research 无召回 | 阶段和最终错误一致，可重试 | FAIL/PARTIAL，QA 空库静默回到 idle；既有库显示检索失败/未召回 |
| TC-RE-015 | P1 | 有历史记录时加载 Retrieval | 不再显示“暂无测试记录” | FAIL，见 KF-BUG-010 |
| TC-RE-016 | P1 | SSE 进行中断网、恢复网络 | 续接原 trace，不重复计费/任务 | NOT-RUN |
| TC-RE-017 | P1 | 进行中取消查询 | 服务端停止，记录为 canceled，不持续消耗额度 | NOT-RUN |
| TC-RE-018 | P1 | activeDocumentIds 100/101 | 允许 100，拒绝 101，UI 显示限制 | NOT-RUN |
| TC-RE-019 | P1 | query images 1/4/5，重复 UUID | 最多 4，重复被去重或拒绝，5 张拒绝 | NOT-RUN |
| TC-RE-020 | P1 | 图片 10 MB 边界、总 32 MB 边界、伪装 MIME | 仅 gif/jpeg/png/webp，严格限制单张/总大小 | NOT-RUN |
| TC-RE-021 | P1 | 引用点击/键盘激活 | 定位正确文档、revision 和 chunk，焦点可返回 | PENDING-CONFIRM |
| TC-RE-022 | P1 | Auto 模式通过 App/Workflow Knowledge Retrieval v2 运行 | 按 Settings 自动选 Fast/Deep/Research，运行和发布一致 | NOT-RUN |
| TC-RE-023 | P1 | 用废弃 `/queries` 路由 | UI 不调用该路由；服务返回明确 503/deprecated | STATIC-VERIFIED |
| ID | P | 测试场景/输入 | 预期结果 | 本轮结果 |
| --------- | --- | -------------------------------------------------------------------- | ------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| TC-RE-001 | P0 | 空库打开 Retrieval | 显示输入框、三种模式和空记录状态 | PASS |
| TC-RE-002 | P0 | 问题留空或仅空格 | Start 禁用 | PASS |
| TC-RE-003 | P0 | 问题精确 2000 字 | UI 允许，后端 query 长度约束不冲突 | PARTIAL，已核对 maxLength=2000 |
| TC-RE-004 | P0 | 问题 2001 字 | UI 拦截/字段错误，不静默截断 | NOT-RUN |
| TC-RE-005 | P0 | 单次 Fast Start | 只产生 1 个 admission、1 个 SSE 任务、1 条记录 | PASS，QA 空库 813 ms 返回 1 条记录、0 分段 |
| TC-RE-006 | P0 | 单次 Fast Retry | 只生成 1 个新 attempt，与原 trace 关联 | FAIL，生成 2 条，KF-BUG-001 |
| TC-RE-007 | P0 | 单次 Deep Start | 只产生 1 个任务和 1 条记录 | FAIL，生成 2 条，KF-BUG-001 |
| TC-RE-008 | P0 | 单次 Research Start | 只产生 1 个 research task，阶段流式更新 | FAIL/PARTIAL，既有库可启动；QA 空库单击后 27+ 秒无任务、阶段或错误，见 KF-BUG-019 |
| TC-RE-009 | P0 | Fast 对唯一 marker 检索 | 答案包含 marker，citation 定位到正确 chunk | PENDING-CONFIRM，需上传并有额度 |
| TC-RE-010 | P0 | Deep 对同一 marker 检索 | 深度检索只生成一个结果，引用可回溯 | PENDING-CONFIRM |
| TC-RE-011 | P0 | Research 对多文档问题 | 计划→检索→分析→结果完整，证据与冲突可查 | PENDING-CONFIRM |
| TC-RE-012 | P0 | 无结果查询 | 明确“无充分证据”，不编造引用 | PASS，QA 空库 Fast/Deep 明确“未召回分段”，0 引用 |
| TC-RE-013 | P0 | Fast/Deep 正常查询 | 流式完成且无错误，记录状态与答案一致 | PARTIAL，QA 空库正常 0 结果；既有库受模型额度阻塞 |
| TC-RE-014 | P1 | Research 无召回 | 阶段和最终错误一致，可重试 | FAIL/PARTIAL，QA 空库静默回到 idle；既有库显示检索失败/未召回 |
| TC-RE-015 | P1 | 有历史记录时加载 Retrieval | 不再显示“暂无测试记录” | FAIL，见 KF-BUG-010 |
| TC-RE-016 | P1 | SSE 进行中断网、恢复网络 | 续接原 trace，不重复计费/任务 | NOT-RUN |
| TC-RE-017 | P1 | 进行中取消查询 | 服务端停止，记录为 canceled，不持续消耗额度 | NOT-RUN |
| TC-RE-018 | P1 | activeDocumentIds 100/101 | 允许 100，拒绝 101，UI 显示限制 | NOT-RUN |
| TC-RE-019 | P1 | query images 1/4/5，重复 UUID | 最多 4，重复被去重或拒绝，5 张拒绝 | NOT-RUN |
| TC-RE-020 | P1 | 图片 10 MB 边界、总 32 MB 边界、伪装 MIME | 仅 gif/jpeg/png/webp，严格限制单张/总大小 | NOT-RUN |
| TC-RE-021 | P1 | 引用点击/键盘激活 | 定位正确文档、revision 和 chunk，焦点可返回 | PENDING-CONFIRM |
| TC-RE-022 | P1 | 省略 mode，通过 App/Workflow Knowledge Retrieval v2 跟随空间配置运行 | 使用各空间 Settings；草稿、发布 Web 与 Service API 一致 | 初测 FAIL/ENV-BLOCKED；配置、保存与发布通过，但所有运行入口均误报未绑定。KF-BUG-021 / WTA-1953 已完成代码修复和专项回归，待部署后验证真实草稿、Web 与 Service 正向结果；字面 `auto` 按合同应拒绝 |
| TC-RE-023 | P1 | 用废弃 `/queries` 路由 | UI 不调用该路由；服务返回明确 503/deprecated | STATIC-VERIFIED |
## I. Quality：参考问题、问题案例与 Replay
| ID | P | 测试场景/输入 | 预期结果 | 本轮结果 |
|---|---|---|---|---|
| TC-QA-001 | P0 | 空空间打开 Quality | 参考问题 0、问题案例 0，空状态正确 | PASS |
| TC-QA-002 | P0 | 切换参考问题/问题案例 | tab 选中和 `?tab=bad-cases` 路由一致 | PASS |
| TC-QA-003 | P0 | 创建问题与备注留空 | 在字段下显示必填错误，不创建记录 | PASS |
| TC-QA-004 | P0 | 触发必填错误后输入合法问题/备注 | 错误和红色边框立即清除 | FAIL，见 KF-BUG-008 |
| TC-QA-005 | P0 | 合法问题+备注，不选证据直接保存 | 创建 1 条 draft，列表计数+1 | PASS |
| TC-QA-006 | P0 | 编辑已有 draft 备注并保存 | 列表内容和更新时间同步 | PASS |
| TC-QA-007 | P1 | 勾选一条参考问题 | 显示“已选 1”、删除入口和清除选择 | PASS |
| TC-QA-008 | P1 | 有效证据文本后点“查找证据” | 返回候选 chunk 或明确无匹配，不报未知错误 | FAIL/ENV，当前为“未知错误” |
| TC-QA-009 | P0 | 导入合法 CSV（question/evidence/tags） | 显示行级预览和导入结果，未匹配证据保存草稿 | FAIL，2 行预览正确；提交后仅显示“未知错误”，刷新仍为 1 条、无部分成功 |
| TC-QA-010 | P0 | CSV 使用中文表头、quoted commas/tags | 正确解析，不错列/乱码 | PARTIAL，英文表头与 quoted tags 正确预览；中文表头未执行 |
| TC-QA-011 | P0 | CSV 500/501 行 | 允许 500，拒绝 501，告知上限 | NOT-RUN，基础 2 行导入已失败 |
| TC-QA-012 | P0 | CSV 精确 1 MiB/1 MiB+1 | 允许边界，超限拒绝且无部分落库 | NOT-RUN，基础 2 行导入已失败 |
| TC-QA-013 | P1 | CSV 包含合法与非法行 | 行级结果清晰，可重试失败行，不重复成功行 | NOT-RUN，基础 2 行导入已失败 |
| TC-QA-014 | P1 | 执行 replay run | 重测每个问题，显示通过/失败/无证据和可追溯 trace | PENDING-CONFIRM |
| TC-QA-015 | P1 | replay 进行中断网/刷新 | 状态可恢复，不重复执行同一问题 | NOT-RUN |
| TC-QA-016 | P1 | 问题案例从真实查询转入 | 保留 query/trace/evidence 关联，列表计数及时更新 | NOT-RUN |
| TC-QA-017 | P1 | 删除单个/批量参考问题 | 仅删除选中项，重复确认不多删 | PENDING-CONFIRM |
| ID | P | 测试场景/输入 | 预期结果 | 本轮结果 |
| --------- | --- | -------------------------------------- | ------------------------------------------------ | --------------------------------------------------------------------- |
| TC-QA-001 | P0 | 空空间打开 Quality | 参考问题 0、问题案例 0，空状态正确 | PASS |
| TC-QA-002 | P0 | 切换参考问题/问题案例 | tab 选中和 `?tab=bad-cases` 路由一致 | PASS |
| TC-QA-003 | P0 | 创建问题与备注留空 | 在字段下显示必填错误，不创建记录 | PASS |
| TC-QA-004 | P0 | 触发必填错误后输入合法问题/备注 | 错误和红色边框立即清除 | FAIL，见 KF-BUG-008 |
| TC-QA-005 | P0 | 合法问题+备注，不选证据直接保存 | 创建 1 条 draft，列表计数+1 | PASS |
| TC-QA-006 | P0 | 编辑已有 draft 备注并保存 | 列表内容和更新时间同步 | PASS |
| TC-QA-007 | P1 | 勾选一条参考问题 | 显示“已选 1”、删除入口和清除选择 | PASS |
| TC-QA-008 | P1 | 有效证据文本后点“查找证据” | 返回候选 chunk 或明确无匹配，不报未知错误 | FAIL/ENV，当前为“未知错误” |
| TC-QA-009 | P0 | 导入合法 CSV（question/evidence/tags） | 显示行级预览和导入结果，未匹配证据保存草稿 | FAIL，2 行预览正确；提交后仅显示“未知错误”，刷新仍为 1 条、无部分成功 |
| TC-QA-010 | P0 | CSV 使用中文表头、quoted commas/tags | 正确解析，不错列/乱码 | PARTIAL，英文表头与 quoted tags 正确预览；中文表头未执行 |
| TC-QA-011 | P0 | CSV 500/501 行 | 允许 500，拒绝 501，告知上限 | NOT-RUN，基础 2 行导入已失败 |
| TC-QA-012 | P0 | CSV 精确 1 MiB/1 MiB+1 | 允许边界，超限拒绝且无部分落库 | NOT-RUN，基础 2 行导入已失败 |
| TC-QA-013 | P1 | CSV 包含合法与非法行 | 行级结果清晰，可重试失败行，不重复成功行 | NOT-RUN，基础 2 行导入已失败 |
| TC-QA-014 | P1 | 执行 replay run | 重测每个问题，显示通过/失败/无证据和可追溯 trace | PENDING-CONFIRM |
| TC-QA-015 | P1 | replay 进行中断网/刷新 | 状态可恢复，不重复执行同一问题 | NOT-RUN |
| TC-QA-016 | P1 | 问题案例从真实查询转入 | 保留 query/trace/evidence 关联，列表计数及时更新 | NOT-RUN |
| TC-QA-017 | P1 | 删除单个/批量参考问题 | 仅删除选中项，重复确认不多删 | PENDING-CONFIRM |
## J. Settings：基础信息、可见性与检索参数
| ID | P | 测试场景/输入 | 预期结果 | 本轮结果 |
|---|---|---|---|---|
| TC-ST-001 | P0 | 打开 Settings | 基础信息、API、模型、检索和危险操作加载正常 | PASS |
| TC-ST-002 | P0 | 名称留空/仅空格 | 显示必填错误，Save 禁用 | PASS |
| TC-ST-003 | P0 | 名称精确 40 字保存 | 保存成功，侧边栏/列表同步 | PASS，后已恢复 |
| TC-ST-004 | P0 | 名称 41 字 | 前端拦截和字段提示 | FAIL，创建页已证实 |
| TC-ST-005 | P0 | 描述精确 2000 字 | 保存成功 | PASS，后已恢复 |
| TC-ST-006 | P0 | 描述 2001 字 | 前端拦截，显示字段错误 | FAIL，见 KF-BUG-003 |
| TC-ST-007 | P0 | 合法名称/描述保存后刷新 | 持久值正确，Save 回到禁用 | PASS |
| TC-ST-008 | P1 | 改动后 Cancel | 恢复服务端值，不发 PATCH | PASS，可见性试改 |
| TC-ST-009 | P0 | 可见性 only_me/all/partial 下拉 | 三种选项齐全，与隐藏值一致 | PASS |
| TC-ST-010 | P0 | partial 不选任何成员 | 显示至少一人，禁止保存 | PASS |
| TC-ST-011 | P1 | partial 添加/移除成员并保存 | 成员权限和 auth epoch 正确更新 | NOT-RUN，缺多用户 |
| TC-ST-012 | P1 | API Access 开关 on/off | 立即保存或明确告知自动保存，侧边栏同步 | PASS，已恢复 off |
| TC-ST-013 | P0 | 系统推理模型下拉 | 只显示可用模型，缺失/失效时可解释 | PARTIAL，当前 gpt-5.6 |
| TC-ST-014 | P0 | Embedding 模型下拉 | 只显示可用 embedding，Fast/Deep 不允许缺失 | PARTIAL，当前 text-embedding-3-large |
| TC-ST-015 | P0 | 同时修改 embedding 与 retrieval settings | 产品要求拆分操作，返回明确 422 而非部分保存 | NOT-RUN |
| TC-ST-016 | P0 | embedding migration queued/running/succeeded/failed/canceled | 进度、checkpoint 和恢复入口清晰，激活前不破坏旧索引 | NOT-RUN |
| TC-ST-017 | P0 | 启用 Rerank 但不选模型 | 禁止保存并提示必选模型 | NOT-RUN |
| TC-ST-018 | P0 | Rerank 关闭时尝试启用 Fast/Deep Score threshold | threshold 禁用，规则清晰 | PASS，当前禁用 |
| TC-ST-019 | P0 | Retrieval mode Fast→Deep→Fast | 每次只保存一次，选中状态持久 | PASS，已恢复 Fast |
| TC-ST-020 | P0 | Retrieval mode Research | 模式保存并使 Retrieval 按钮语义变为开始研究 | PASS，在 Retrieval 已验证 |
| TC-ST-021 | P0 | Top K = 0 | 拦截或明确 clamp 到 1，显示值与保存值一致 | PASS，显示和 slider 均为 1 |
| TC-ST-022 | P0 | Top K = 1/10 | 允许边界值，持久后一致 | PASS |
| TC-ST-023 | P0 | Top K = 11 | 拦截或明确 clamp 到 10，显示值与保存值一致 | PASS，显示和 slider 均为 10 |
| TC-ST-024 | P0 | threshold = -0.01/0/1/1.01 | 只允许 0–1，保存值与显示一致 | NOT-RUN，rerank 未配置 |
| TC-ST-025 | P0 | 两标签页使用相同 expectedRevision 并发保存 | 第二次 409，给出刷新/合并引导，不静默覆盖 | NOT-RUN |
| TC-ST-026 | P1 | Save 返回 422/409/503 | 区分字段错误、冲突和服务不可用，不统一报网络 | FAIL，422 被误报网络 |
| TC-ST-027 | P0 | 点击删除空间 | 必须二次确认，完成后立即从列表隐藏 | PENDING-CONFIRM |
| ID | P | 测试场景/输入 | 预期结果 | 本轮结果 |
| --------- | --- | ------------------------------------------------------------ | --------------------------------------------------- | ------------------------------------ |
| TC-ST-001 | P0 | 打开 Settings | 基础信息、API、模型、检索和危险操作加载正常 | PASS |
| TC-ST-002 | P0 | 名称留空/仅空格 | 显示必填错误，Save 禁用 | PASS |
| TC-ST-003 | P0 | 名称精确 40 字保存 | 保存成功，侧边栏/列表同步 | PASS，后已恢复 |
| TC-ST-004 | P0 | 名称 41 字 | 前端拦截和字段提示 | FAIL，创建页已证实 |
| TC-ST-005 | P0 | 描述精确 2000 字 | 保存成功 | PASS，后已恢复 |
| TC-ST-006 | P0 | 描述 2001 字 | 前端拦截，显示字段错误 | FAIL，见 KF-BUG-003 |
| TC-ST-007 | P0 | 合法名称/描述保存后刷新 | 持久值正确，Save 回到禁用 | PASS |
| TC-ST-008 | P1 | 改动后 Cancel | 恢复服务端值，不发 PATCH | PASS，可见性试改 |
| TC-ST-009 | P0 | 可见性 only_me/all/partial 下拉 | 三种选项齐全，与隐藏值一致 | PASS |
| TC-ST-010 | P0 | partial 不选任何成员 | 显示至少一人，禁止保存 | PASS |
| TC-ST-011 | P1 | partial 添加/移除成员并保存 | 成员权限和 auth epoch 正确更新 | NOT-RUN，缺多用户 |
| TC-ST-012 | P1 | API Access 开关 on/off | 立即保存或明确告知自动保存，侧边栏同步 | PASS，已恢复 off |
| TC-ST-013 | P0 | 系统推理模型下拉 | 只显示可用模型，缺失/失效时可解释 | PARTIAL，当前 gpt-5.6 |
| TC-ST-014 | P0 | Embedding 模型下拉 | 只显示可用 embedding，Fast/Deep 不允许缺失 | PARTIAL，当前 text-embedding-3-large |
| TC-ST-015 | P0 | 同时修改 embedding 与 retrieval settings | 产品要求拆分操作，返回明确 422 而非部分保存 | NOT-RUN |
| TC-ST-016 | P0 | embedding migration queued/running/succeeded/failed/canceled | 进度、checkpoint 和恢复入口清晰，激活前不破坏旧索引 | NOT-RUN |
| TC-ST-017 | P0 | 启用 Rerank 但不选模型 | 禁止保存并提示必选模型 | NOT-RUN |
| TC-ST-018 | P0 | Rerank 关闭时尝试启用 Fast/Deep Score threshold | threshold 禁用，规则清晰 | PASS，当前禁用 |
| TC-ST-019 | P0 | Retrieval mode Fast→Deep→Fast | 每次只保存一次，选中状态持久 | PASS，已恢复 Fast |
| TC-ST-020 | P0 | Retrieval mode Research | 模式保存并使 Retrieval 按钮语义变为开始研究 | PASS，在 Retrieval 已验证 |
| TC-ST-021 | P0 | Top K = 0 | 拦截或明确 clamp 到 1，显示值与保存值一致 | PASS，显示和 slider 均为 1 |
| TC-ST-022 | P0 | Top K = 1/10 | 允许边界值，持久后一致 | PASS |
| TC-ST-023 | P0 | Top K = 11 | 拦截或明确 clamp 到 10，显示值与保存值一致 | PASS，显示和 slider 均为 10 |
| TC-ST-024 | P0 | threshold = -0.01/0/1/1.01 | 只允许 0–1，保存值与显示一致 | NOT-RUN，rerank 未配置 |
| TC-ST-025 | P0 | 两标签页使用相同 expectedRevision 并发保存 | 第二次 409，给出刷新/合并引导，不静默覆盖 | NOT-RUN |
| TC-ST-026 | P1 | Save 返回 422/409/503 | 区分字段错误、冲突和服务不可用，不统一报网络 | FAIL，422 被误报网络 |
| TC-ST-027 | P0 | 点击删除空间 | 必须二次确认，完成后立即从列表隐藏 | PENDING-CONFIRM |
## K. 权限、成员、API 和应用绑定
| ID | P | 测试场景/角色 | 预期结果 | 本轮结果 |
|---|---|---|---|---|
| TC-AU-001 | P0 | owner 访问列表/详情/上传/设置/成员/API/删除 | 所有功能可用 | PARTIAL，owner 主流程通过 |
| TC-AU-002 | P0 | editor 访问读/编辑/文档写/检索 | 允许；成员/API key/删库按合同禁止 | NOT-RUN |
| TC-AU-003 | P0 | viewer 访问读/检索 | 只读和 query 允许；所有写操作隐藏/禁止 | NOT-RUN |
| TC-AU-004 | P0 | only_me 下非 owner 访问深链 | 与不存在资源统一为 404 | NOT-RUN |
| TC-AU-005 | P0 | all_team_members 的未显式成员 | 以 viewer 访问，不获得编辑权 | NOT-RUN |
| TC-AU-006 | P0 | partial_members 的非选中成员 | 列表不可见，深链 404 | NOT-RUN |
| TC-AU-007 | P0 | RBAC 查询异常 | fail closed，不使用本地角色绕过 | NOT-RUN |
| TC-AU-008 | P0 | 成员被移除/可见性收窄时仍打开详情 | 页面下一次请求立即失效，旧 SSE/token 不能继续 | NOT-RUN |
| TC-AU-009 | P0 | 用旧 API credential 在撤权后访问 | 立即 401/403/404，不等 TTL 过期 | NOT-RUN |
| TC-AU-010 | P0 | External API endpoint 为 `not-a-url` | 只显示一条本地化字段错误，不保存 | FAIL，见 KF-BUG-009 |
| TC-AU-011 | P1 | External API 合法 endpoint/key 创建并测试 | 保存后可编辑/撤销，key 不再明文显示 | NOT-RUN，无可用外部 API |
| TC-AU-012 | P0 | 创建 Service API Key | 只在创建瞬间显示 secret，复制和撤销可用 | PASS，已创建 1 枚临时 key |
| TC-AU-013 | P0 | 撤销 Service API Key 后重试访问 | 立即失效，不会继续签发空间 token | PENDING-CONFIRM |
| TC-AU-014 | P0 | Agent/Agent Chat 绑定 Agent channel | 只允许支持的 app 类型且 space active/channel enabled | NOT-RUN |
| TC-AU-015 | P0 | Workflow/Advanced Chat 绑定 Workflow channel | 最多 10 个 space，第 11 个有明确错误 | NOT-RUN |
| TC-AU-016 | P0 | 解除 app binding 后运行已发布 app | 旧 binding 不再可用，运行给出明确错误 | NOT-RUN |
| TC-AU-017 | P0 | 使用新 Service API Key 请求 `/v1/datasets` | 返回 200 和合法分页 JSON | PASS |
| TC-AU-018 | P0 | 将 Service API Key 修改一位后请求 | 返回 401，不返回数据 | PASS |
| TC-AU-019 | P1 | 合法 key 使用成功后重新打开密钥列表 | 最后使用时间更新 | FAIL，仍显示“从未”，KF-BUG-013 |
| TC-AU-020 | P0 | QA space API Access = off 时用有效 key 请求该 space ID | 返回不可见/404 | PASS，返回 404 |
| TC-AU-021 | P0 | QA space API Access on→刷新→off→刷新 | 即时保存；两次刷新均与服务端一致，最终恢复关闭 | PASS，开启显示“已启用”，最终确认 `aria-checked=false` |
| TC-AU-022 | P0 | 用旧 Dataset Service API Key 调用 KFS admission | 旧 key 不可冒充 KFS scoped credential | PASS，API 域名返回 401 `knowledge_fs_invalid_credential` |
| TC-AU-023 | P0 | API Access 已开启时点击空间侧栏“API 访问” | 显示可用 endpoint、专属 credential 创建/管理或明确下一步 | FAIL，只弹空白“不可用”对话框，见 KF-BUG-018 |
| ID | P | 测试场景/角色 | 预期结果 | 本轮结果 |
| --------- | --- | ------------------------------------------------------ | -------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| TC-AU-001 | P0 | owner 访问列表/详情/上传/设置/成员/API/删除 | 所有功能可用 | PARTIAL，owner 主流程通过 |
| TC-AU-002 | P0 | editor 访问读/编辑/文档写/检索 | 允许；成员/API key/删库按合同禁止 | NOT-RUN |
| TC-AU-003 | P0 | viewer 访问读/检索 | 只读和 query 允许；所有写操作隐藏/禁止 | NOT-RUN |
| TC-AU-004 | P0 | only_me 下非 owner 访问深链 | 与不存在资源统一为 404 | NOT-RUN |
| TC-AU-005 | P0 | all_team_members 的未显式成员 | 以 viewer 访问，不获得编辑权 | NOT-RUN |
| TC-AU-006 | P0 | partial_members 的非选中成员 | 列表不可见，深链 404 | NOT-RUN |
| TC-AU-007 | P0 | RBAC 查询异常 | fail closed，不使用本地角色绕过 | NOT-RUN |
| TC-AU-008 | P0 | 成员被移除/可见性收窄时仍打开详情 | 页面下一次请求立即失效，旧 SSE/token 不能继续 | NOT-RUN |
| TC-AU-009 | P0 | 用旧 API credential 在撤权后访问 | 立即 401/403/404，不等 TTL 过期 | NOT-RUN |
| TC-AU-010 | P0 | External API endpoint 为 `not-a-url` | 只显示一条本地化字段错误，不保存 | FAIL，见 KF-BUG-009 |
| TC-AU-011 | P1 | External API 合法 endpoint/key 创建并测试 | 保存后可编辑/撤销，key 不再明文显示 | NOT-RUN，无可用外部 API |
| TC-AU-012 | P0 | 创建 Service API Key | 只在创建瞬间显示 secret，复制和撤销可用 | PASS，已创建 1 枚临时 key |
| TC-AU-013 | P0 | 撤销 Service API Key 后重试访问 | 立即失效，不会继续签发空间 token | PASS；临时 Workflow App key 删除后同 key 立即返回 401 |
| TC-AU-014 | P0 | Agent/Agent Chat 绑定 Agent channel | 只允许支持的 app 类型且 space active/channel enabled | NOT-RUN |
| TC-AU-015 | P0 | Workflow/Advanced Chat 绑定 Workflow channel | 最多 10 个 space，第 11 个有明确错误 | 初测 PARTIAL/FAIL；真实发布后 binding 精确建立，1/6 空间通过、10/11 由自动化合同覆盖。KF-BUG-021 / WTA-1953 已增加独立 Workflow Access 开关并细分 admission 错误，专项回归通过；尚未部署，真实 channel 正向运行仍为 ENV-BLOCKED |
| TC-AU-016 | P0 | 解除 app binding 后运行已发布 app | 旧 binding 不再可用，运行给出明确错误 | PARTIAL/ENV-BLOCKED；发布图从 `ceshi` 切到 QA 时旧 binding 由 1→0，切回恢复 1；KF-BUG-021 已补齐 binding/channel/space/auth 的可区分错误，但部署前仍无法验证真实旧 capability 撤权 |
| TC-AU-017 | P0 | 使用新 Service API Key 请求 `/v1/datasets` | 返回 200 和合法分页 JSON | PASS |
| TC-AU-018 | P0 | 将 Service API Key 修改一位后请求 | 返回 401，不返回数据 | PASS |
| TC-AU-019 | P1 | 合法 key 使用成功后重新打开密钥列表 | 最后使用时间更新 | FAIL，仍显示“从未”，KF-BUG-013 |
| TC-AU-020 | P0 | QA space API Access = off 时用有效 key 请求该 space ID | 返回不可见/404 | PASS，返回 404 |
| TC-AU-021 | P0 | QA space API Access on→刷新→off→刷新 | 即时保存；两次刷新均与服务端一致，最终恢复关闭 | PASS，开启显示“已启用”，最终确认 `aria-checked=false` |
| TC-AU-022 | P0 | 用旧 Dataset Service API Key 调用 KFS admission | 旧 key 不可冒充 KFS scoped credential | PASS，API 域名返回 401 `knowledge_fs_invalid_credential` |
| TC-AU-023 | P0 | API Access 已开启时点击空间侧栏“API 访问” | 显示可用 endpoint、专属 credential 创建/管理或明确下一步 | FAIL，只弹空白“不可用”对话框，见 KF-BUG-018 |
## L. 恢复性、错误映射与非功能
| ID | P | 测试场景 | 预期结果 | 本轮结果 |
|---|---|---|---|---|
| TC-RS-001 | P0 | API 返回 401 | 刷新身份后仅重放一次，不重复 reindex/query 等 POST | NOT-RUN |
| TC-RS-002 | P0 | API 返回 403/404 | 无权与不存在对外表现一致，不泄露资源 | FAIL-PARTIAL，404 toast 泄露路由 |
| TC-RS-003 | P0 | API 返回 409 revision conflict | 保留编辑，提示刷新/合并，不静默覆盖 | NOT-RUN |
| TC-RS-004 | P0 | API 返回 422 field validation | 错误映射到具体字段和限制 | FAIL，名称/描述均只给通用错误 |
| TC-RS-005 | P1 | API 返回 429 | 显示重试时间，按 Retry-After 控制，不密集重试 | NOT-RUN |
| TC-RS-006 | P1 | API 返回 503 | 区分服务不可用与网络断开，保留可重试数据 | ENV/PARTIAL |
| TC-RS-007 | P1 | 断网后在表单点 Save，恢复后 Retry | 不丢输入，仅提交一次 | NOT-RUN |
| TC-RS-008 | P1 | 长任务刷新/关闭再进入 | 根据 durable job ID 恢复进度，不新建任务 | NOT-RUN |
| TC-RS-009 | P1 | 快速连续点击 Start/Retry/Save | 前端防抖+后端幂等，仅一次运行 | FAIL，Retrieval 已复现重复 |
| TC-RS-010 | P1 | 多标签页交错加载列表/详情并返回 | 旧响应不覆盖新路由，焦点和状态正确 | NOT-RUN |
| TC-RS-011 | P1 | 390 px/768 px/1280 px 响应式 | 无内容遮挡、不可达导航和水平滚动陷阱 | PARTIAL，390 px 有导航溢出 |
| TC-RS-012 | P1 | WCAG A/AA 自动扫描新版六个页面 | 无 serious/critical，表单标签和对比度合格 | NOT-RUN，现有 a11y E2E 只扫 legacy |
| TC-RS-013 | P2 | Chrome 缩放 200%、系统大字体 | 无截断、遮挡、无法滚动的对话框 | NOT-RUN |
| ID | P | 测试场景 | 预期结果 | 本轮结果 |
| --------- | --- | --------------------------------- | -------------------------------------------------- | ---------------------------------- |
| TC-RS-001 | P0 | API 返回 401 | 刷新身份后仅重放一次，不重复 reindex/query 等 POST | NOT-RUN |
| TC-RS-002 | P0 | API 返回 403/404 | 无权与不存在对外表现一致，不泄露资源 | FAIL-PARTIAL，404 toast 泄露路由 |
| TC-RS-003 | P0 | API 返回 409 revision conflict | 保留编辑，提示刷新/合并，不静默覆盖 | NOT-RUN |
| TC-RS-004 | P0 | API 返回 422 field validation | 错误映射到具体字段和限制 | FAIL，名称/描述均只给通用错误 |
| TC-RS-005 | P1 | API 返回 429 | 显示重试时间，按 Retry-After 控制，不密集重试 | NOT-RUN |
| TC-RS-006 | P1 | API 返回 503 | 区分服务不可用与网络断开，保留可重试数据 | ENV/PARTIAL |
| TC-RS-007 | P1 | 断网后在表单点 Save，恢复后 Retry | 不丢输入，仅提交一次 | NOT-RUN |
| TC-RS-008 | P1 | 长任务刷新/关闭再进入 | 根据 durable job ID 恢复进度，不新建任务 | NOT-RUN |
| TC-RS-009 | P1 | 快速连续点击 Start/Retry/Save | 前端防抖+后端幂等，仅一次运行 | FAIL，Retrieval 已复现重复 |
| TC-RS-010 | P1 | 多标签页交错加载列表/详情并返回 | 旧响应不覆盖新路由，焦点和状态正确 | NOT-RUN |
| TC-RS-011 | P1 | 390 px/768 px/1280 px 响应式 | 无内容遮挡、不可达导航和水平滚动陷阱 | PARTIAL，390 px 有导航溢出 |
| TC-RS-012 | P1 | WCAG A/AA 自动扫描新版六个页面 | 无 serious/critical，表单标签和对比度合格 | NOT-RUN，现有 a11y E2E 只扫 legacy |
| TC-RS-013 | P2 | Chrome 缩放 200%、系统大字体 | 无截断、遮挡、无法滚动的对话框 | NOT-RUN |
## M. Legacy Dataset / RAG Pipeline 回归高风险用例
> 新版 KnowledgeFS 与旧 Dataset 后端仍并存。以下是为防止切流/兼容回归必须保留的用例，本轮没有在业务数据上执行。
| ID | P | 测试场景 | 预期结果 | 本轮结果 |
|---|---|---|---|---|
| TC-LG-001 | P0 | 旧 segment 创建不传 `attachment_ids` | 正常创建、建向量且返回 2xx；不得“500 但已部分落库” | STATIC-RISK |
| TC-LG-002 | P0 | 旧 metadata rename 重名/冲突 | 明确失败，刷新后真实名称不变 | STATIC-RISK |
| TC-LG-003 | P0 | 旧 metadata delete 不存在 ID | 返回 404/4xx，不吞异常后 204 | STATIC-RISK |
| TC-LG-004 | P0 | 删除仍被 App/Workflow 使用的 dataset | use-check 阻止并指明关联应用，不断链 | STATIC-RISK |
| TC-LG-005 | P1 | hit test topK 0/超大/负数/NaN，score 越界 | 统一严格校验，不进入模型/数据库 | NOT-RUN |
| TC-LG-006 | P1 | segment 空内容、QA 空 answer、disabled 后编辑 | 按状态机拒绝，无向量残留 | NOT-RUN |
| TC-LG-007 | P1 | 上传后快速 pause/resume/retry/delete/archive | 按 indexing/paused/error/archived 状态机仅允许合法操作 | NOT-RUN |
| TC-LG-008 | P1 | Pipeline draft 用 JSON/text/plain/其他 Content-Type | 只接受 application/json 或 text/plain JSON，其他 415 | NOT-RUN |
| TC-LG-009 | P1 | 两标签页保存同一 draft hash | 第二次 DraftWorkflowNotSync，不静默覆盖 | NOT-RUN |
| TC-LG-010 | P1 | 无 draft/缺 knowledge-index node/缺 embedding/不兼容 chunk 发布 | 发布前完整验证，不产生半成品 published version | NOT-RUN |
| TC-LG-011 | P1 | 删除 active workflow/draft，restore draft | 阻止删 active/draft；只能从 published restore | NOT-RUN |
| TC-LG-012 | P1 | DSL import 无效 YAML/依赖 pending/export secret | 失败 400，依赖待确认 202，默认 export 剥离凭据 | NOT-RUN |
| ID | P | 测试场景 | 预期结果 | 本轮结果 |
| --------- | --- | --------------------------------------------------------------- | ------------------------------------------------------ | ----------- |
| TC-LG-001 | P0 | 旧 segment 创建不传 `attachment_ids` | 正常创建、建向量且返回 2xx；不得“500 但已部分落库” | STATIC-RISK |
| TC-LG-002 | P0 | 旧 metadata rename 重名/冲突 | 明确失败，刷新后真实名称不变 | STATIC-RISK |
| TC-LG-003 | P0 | 旧 metadata delete 不存在 ID | 返回 404/4xx，不吞异常后 204 | STATIC-RISK |
| TC-LG-004 | P0 | 删除仍被 App/Workflow 使用的 dataset | use-check 阻止并指明关联应用，不断链 | STATIC-RISK |
| TC-LG-005 | P1 | hit test topK 0/超大/负数/NaN，score 越界 | 统一严格校验，不进入模型/数据库 | NOT-RUN |
| TC-LG-006 | P1 | segment 空内容、QA 空 answer、disabled 后编辑 | 按状态机拒绝，无向量残留 | NOT-RUN |
| TC-LG-007 | P1 | 上传后快速 pause/resume/retry/delete/archive | 按 indexing/paused/error/archived 状态机仅允许合法操作 | NOT-RUN |
| TC-LG-008 | P1 | Pipeline draft 用 JSON/text/plain/其他 Content-Type | 只接受 application/json 或 text/plain JSON，其他 415 | NOT-RUN |
| TC-LG-009 | P1 | 两标签页保存同一 draft hash | 第二次 DraftWorkflowNotSync，不静默覆盖 | NOT-RUN |
| TC-LG-010 | P1 | 无 draft/缺 knowledge-index node/缺 embedding/不兼容 chunk 发布 | 发布前完整验证，不产生半成品 published version | NOT-RUN |
| TC-LG-011 | P1 | 删除 active workflow/draft，restore draft | 阻止删 active/draft；只能从 published restore | NOT-RUN |
| TC-LG-012 | P1 | DSL import 无效 YAML/依赖 pending/export secret | 失败 400，依赖待确认 202，默认 export 剥离凭据 | NOT-RUN |
## N. Workflow Knowledge Retrieval v2 补测
本轮新增独立补测矩阵，共执行 39 个浏览器/核心合同场景：31 个通过或通过负向合同、5 个失败、1 个部分失败、2 个被同一运行缺陷阻断；这些是初测原始结果，继续保留。另有 15 个真实链路断言标记为 `ENV-BLOCKED`，3 个取消/error-strategy/retry 断言标记为规格或实现阻塞，未使用 mock 结果冒充端到端通过。
已确认问题：
1. `KF-BUG-020` / [WTA-1954](https://linear.app/dify/issue/WTA-1954)（High，Done）：初测从节点选择器新增 v2 节点后主编辑区空白并出现未处理 `AbortError`。根因是通用 `WorkflowHistoryStoreInitializer` 在约 500 ms 后接收到新的 history 对象便卸载整棵 Workflow 子树；`AbortError` 是卸载后查询取消的结果。代码已修复，更宽的 Workflow 组合回归 9 个 spec、27 个测试通过，待部署后真实 Chrome 复测。
2. `KF-BUG-021` / [WTA-1953](https://linear.app/dify/issue/WTA-1953)（High，Done）：初测时 binding 已建立，但 channel/permissions 未就绪的所有运行表面统一显示未绑定。代码已增加独立 `workflow_enabled` 开关，细分 binding/channel/space/auth admission 状态，并以稳定 marker 映射为 24 个 locale 的本地化消息；020/021 最终 Web 组合 7 个 spec、70 个测试通过，API 18 个测试通过，待部署后真实正向运行。
3. `KF-BUG-022` / [WTA-1956](https://linear.app/dify/issue/WTA-1956)（High，Backlog）：`created_after` / `created_before` 输入在刷新和 DSL 导出后静默丢失。
4. `KF-BUG-023` / [WTA-1955](https://linear.app/dify/issue/WTA-1955)（Medium，Backlog）：最后一个 node-kind filter 无法取消。
5. `KF-BUG-024` / [WTA-1957](https://linear.app/dify/issue/WTA-1957)（Medium，Backlog）：未解析空间在草稿检查清单中无持久警告，发布时才显示未本地化内部 ID。
以上五个 issue 均属于 Linear 项目 `Make RAG Great Again`、Milestone `测试联调`；020/021 已指派给 `jyong` 并完成，022～024 保持 Backlog。修复后的自动化结果不改写 WF2 原始浏览器 FAIL，也不代表尚未部署的真实 E2E 已通过。
另有一个已静态确认但未按浏览器缺陷编号的合同缺口：`KNOWLEDGE_FS_BASE_URL` 未配置时 composition root 会在 I/O 前 fail closed，但 v2 节点解析 runtime 的位置可能绕过其受控 `RetrievalUnavailable` 映射；详见补测报告 `WF2-CONTRACT-001`。
完整逐项结果、运行表面、自动化证据、测试对象和环境恢复记录见：[Workflow Knowledge Retrieval v2 / KnowledgeFS 功能补测报告](./knowledge-retrieval-v2-functional-test-report.md)。
## 测试执行建议顺序
1. 先解决 KF-BUG-001–005，补充有额度的模型环境。
2. 经用户确认后执行 TC-DO-003–014，等索引 ready。
3. 紧接执行 TC-DD-004–012、TC-RE-009–011、TC-QA-009–017，保证同一批合成语料可串联校验。
4. 使用 owner/editor/viewer 三账号执行 TC-AU-001–009，并在正在运行的 SSE 中撤权。
5. 最后执行删除和清理，核对列表、FS、检索、概览和 App binding 全部无残留。
1. 部署已修复的 KF-BUG-020/021，在真实 Chrome 中先验证添加任意节点后等待超过 history 保存窗口仍不白屏，再通过独立 Workflow Access 开关启用 `workflow_enabled=true`；同时准备 permissions ready、含唯一 marker 的固定空间。
2. 修复 KF-BUG-022，并用刷新、DSL 导出与真实 filtered retrieval 三层验证时间过滤；随后处理 KF-BUG-023/024。
3. 经用户确认后执行 TC-DO-003–014，等索引 ready。
4. 紧接执行 TC-DD-004–012、TC-RE-009–011、TC-QA-009–017 及补测报告 WF2-LIVE-001～015；先完成规格/实现后再执行 WF2-LIVE-016～018。
5. 使用 owner/editor/viewer 三账号执行 TC-AU-001–009，并在正在运行的 SSE 中撤权。
6. 最后执行删除和清理，核对列表、FS、检索、概览和 App binding 全部无残留。

180
test-results/knowledge-fs/2026-08-11/knowledge-fs-functional-test-report.md
View File

@ -1,6 +1,6 @@
# KnowledgeFS 全功能测试报告
配套交付：[详细测试用例](./knowledge-fs-detailed-test-cases.md) · [合成上传数据](./test-data/)
配套交付：[详细测试用例](./knowledge-fs-detailed-test-cases.md) · [Workflow Knowledge Retrieval v2 补测报告](./knowledge-retrieval-v2-functional-test-report.md) · [合成测试数据](./test-data/)
## 1. 测试摘要
@ -9,17 +9,18 @@
- 测试终端：用户已登录的 Google Chrome，桌面视口 + 390×844 移动视口
- 测试角色：当前 workspace 的 owner 用户
- 测试方法：真实浏览器功能测试、边界值、错误处理、状态流转、恢复性、静态代码/现有自动化测试对照
- 用例库：已编制 242 条可执行用例；按当前用例状态统计为 89 `PASS`、33 条含 `FAIL`、4 `ENV`、4 `ENV-BLOCKED`、27 `PENDING-CONFIRM`，其余为部分执行、需多用户/provider/大数据的未执行项或静态风险
- 初始测试状态：Chrome 本地文件权限已修复，合成文件已实际提交到上传/Quality 页面；QA API Access 已完成 off→on→刷新→off→刷新并恢复关闭。初测时所有文档 staging 均失败或悬挂，QA 空间为 0 文档。永久删除、创建 KnowledgeFS 专属凭据与密钥撤销仍等待操作前确认。
- 修复复测状态：19 个已确认缺陷中 18 个已完成代码修复、专项自动化回归及 Linear 状态同步；唯一未关闭的是 KF-BUG-014 / WTA-1928。该项复测时 TXT/Markdown staging 已成功，但测试环境的文档 claim 路由稳定返回 404，需部署当前 API 后完成 `staging → claim 202 → ready` 实链路复测。
- 用例库：主矩阵已编制 242 条可执行用例；本轮另补 39 条 Workflow v2 已执行场景和 18 条真实运行断言。主矩阵原状态统计仍保留为 89 `PASS`、33 条含 `FAIL`、4 `ENV`、4 `ENV-BLOCKED`、27 `PENDING-CONFIRM`；Workflow 补测不混入旧统计，逐项结果见独立报告。
- 初始测试状态：Chrome 本地文件权限已修复，合成文件已实际提交到上传/Quality 页面；QA API Access 已完成 off→on→刷新→off→刷新并恢复关闭。初测时所有文档 staging 均失败或悬挂，QA 空间为 0 文档。
- 修复复测状态：原 19 个已确认缺陷中 18 个已完成代码修复、专项自动化回归及 Linear 状态同步；唯一未关闭的是 KF-BUG-014 / WTA-1928。该项复测时 TXT/Markdown staging 已成功，但测试环境的文档 claim 路由稳定返回 404，需部署当前 API 后完成 `staging → claim 202 → ready` 实链路复测。
- Workflow v2 补测状态：39 个浏览器/核心合同场景已执行；另有 15 个真实运行断言被 Workflow channel、permissions-ready KFS 或已索引语料条件阻塞，3 个被产品规格/实现阻塞（取消信号、error strategy、retry），并确认 1 个 endpoint 未配置时的节点错误映射合同缺口。KF-BUG-020～024 均已创建到 Linear 项目 `Make RAG Great Again` 的 Milestone `测试联调`；KF-BUG-020/021 已完成代码修复和专项自动化回归，待部署后做真实 Chrome 正向链路复测，KF-BUG-022～024 保持 Backlog。
## 2. 结论
初始功能测试表明 KnowledgeFS 新版的页面架构和大部分基础交互可用：新旧版切换、列表筛选、空库创建、空状态、概览指标、文档列表、任务抽屉、Fast/Deep 空库检索、Quality 参考问题创建/编辑、设置保存与 API Access 开关持久化均能正常工作。
经过本轮修复，除 KF-BUG-014 的测试环境部署阻塞外，其余 18 个已确认缺陷均已修复并通过所属层专项回归。下列条目保留初测时的风险与现象，最新修复状态以第 4 节缺陷表和各缺陷复测记录为准。
经过原缺陷修复，除 KF-BUG-014 的测试环境部署阻塞外，KF-BUG-001～019 中其余 18 个均已修复并通过所属层专项回归。随后对 Workflow `knowledge-retrieval-v2` 的专项补测又确认 5 个新问题：新增节点白屏、运行通道不可用、时间过滤静默丢失、最后一个 node kind 无法清除，以及未解析空间缺少草稿期警告。最新状态以第 4 节缺陷表和独立补测报告为准。
但当前不建议直接认定为“可全量发布”。除原有 5 个 P1 级问题外，本轮真实文件/API 集成又暴露出 5 个 P1 级阻断：
当前仍不建议认定为“可全量发布”。以下 1～10 条保留初测时 KF-BUG-001～019 的原始阻断证据，其中除第 6 条对应的 KF-BUG-014 外均已有代码修复；Workflow v2 当前发布门禁另见其后的新增结论：
1. Fast/Deep 检索单次操作会生成重复记录/重复任务，存在重复计费和重复执行风险。
2. 创建名称超长和设置描述超长均缺少前端校验，后端拒绝后界面还给出错误或误导性归因。
@ -32,6 +33,8 @@
9. API Access 开启且刷新持久后，侧栏入口仍只弹空白“不可用”；旧 Dataset Service API Key 调用 KFS admission 得到 401，界面没有可用的 KFS 专属凭据路径。
10. QA 空库 Research 单击后 27+ 秒无任务、阶段、结果或错误，静默回到可重试状态；Fast/Deep 在同一空库均能正确显示 0 分段。
Workflow v2 初测结论仍保留为不可发布：发布会建立并精确同步 binding，但当时的测试部署在 Workflow channel/permissions 未就绪时，草稿完整运行、单节点运行、已发布 Web App、Service API blocking/streaming 都只显示“not bound”，且从选择器新增任意节点约 500 ms 后会使主编辑区白屏。当前代码已修复 KF-BUG-020/021：初始化器不再因新的 history 引用卸载 Workflow 子树；Settings 增加独立 `workflow_enabled` 开关；admission 将 binding、channel、space、authorization 状态细分，并通过稳定 marker 映射为 24 个 locale 的本地化错误。由于修复尚未部署到测试环境，真实 Fast/Deep/Research、引用、filters 和多空间合并仍保持 `ENV-BLOCKED`，不能把自动化回归提升为真实 E2E 通过。
## 3. 测试数据与环境影响
### 3.1 本轮创建的合成数据
@ -45,7 +48,10 @@
- Quality 参考问题：1 条合成草稿，已验证创建和编辑；2 行 CSV 导入失败且刷新后无部分落库
- Firecrawl：1 个已停止的临时抓取草稿，未添加为数据源
- 文件：尝试 3 个小型 TXT/MD、0 B、精确 15 MiB、15 MiB+1、`.exe`；staging/本地校验后仍为 0 文档
- Service API Key：已创建 1 个临时 key，已完成鉴权测试，尚未撤销；完整 secret 未写入报告
- Dataset Service API Key：初测时创建 1 个临时 key 并完成鉴权；其历史清理状态与 Workflow App key 分开记录
- Workflow 测试 App：`KF-WF-V2-LIVE-CESHI-20260811`、`KF-WF-V2-UNRESOLVED-20260811`、`KF-WF-V2-QA-20260811`
- Workflow App API Key：已临时创建用于 blocking/streaming；测试后已删除，同 key 立即返回 401，完整 secret 未写入报告
- Workflow channel：初测部署的运行证据表明该通道关闭或不可用，且 Settings UI 当时无可发现开关；当前代码已增加独立 `workflow_enabled` 控件，但尚未部署复测。QA API Access 按合同仅控制 Service/Agent、保留 Workflow 现值；本轮临时开启后已恢复关闭
QA 空间的 Fast 和 Deep 各执行过一次 0 文档检索并正常返回 0 分段；这些“记录”刷新后不再显示。Research 单次执行没有生成可见记录。
@ -61,61 +67,75 @@ QA 空间的 Fast 和 Deep 各执行过一次 0 文档检索并正常返回 0
## 4. 已确认缺陷
| 编号 | 优先级 | 模块 | 摘要 | 状态 |
|---|---|---|---|---|
| KF-BUG-001 | P1 / Major | Retrieval | Fast/Deep 单次开始或重试生成两条记录/任务 | 已修复；WTA-1914 Done |
| KF-BUG-002 | P1 / Major | Create | 41 字名称可提交，后端拒绝后误报“权限” | 已修复；WTA-1915 Done |
| KF-BUG-003 | P1 / Major | Settings | 2001 字描述可提交，后端拒绝后误报“网络” | 已修复；WTA-1916 Done |
| KF-BUG-004 | P1 / Major | Error handling | 不存在空间的 404 toast 暴露后端 API 路由 | 已修复；WTA-1917 Done |
| KF-BUG-005 | P1 / Major | Website source | 抓取页数显示值与实际提交值静默不一致 | 已修复；WTA-1918 Done |
| KF-BUG-006 | P2 / Major | Document detail | 详情内容已加载时同时出现 3 条相同英文 404 toast | 已修复；WTA-1919 Done |
| KF-BUG-007 | P2 / Major | Metadata | 详情页点击“编辑”后按钮永久禁用，无编辑器和反馈 | 已修复；WTA-1920 Done |
| KF-BUG-008 | P2 / Normal | Quality | 必填错误在输入合法值后不消失，查找证据只报“未知错误” | 已修复；WTA-1921 Done |
| KF-BUG-009 | P2 / Normal | External API | 非法 endpoint 同时弹出两条错误，中英混用 | 已修复；WTA-1922 Done |
| KF-BUG-010 | P3 / Minor | Retrieval | 有大量历史记录时仍显示“暂无测试记录” | 已修复；WTA-1923 Done |
| KF-BUG-011 | P3 / Minor | List | 搜索无结果时列表全空，无“无结果”解释和清除指引 | 已修复；WTA-1924 Done |
| KF-BUG-012 | P3 / Usability | Responsive | 390 px 下顶部功能导航超出视口，“设置”无明显可达性提示 | 已修复；WTA-1925 Done |
| KF-BUG-013 | P2 / Normal | Service API | Key 已成功鉴权调用 200，密钥列表“最后使用”仍持续显示“从未” | 已修复；WTA-1926 Done |
| KF-BUG-014 | P1 / Major | Document upload | 合法 TXT/Markdown staged upload 全部报 `Internal Server Error`，0 文档 | 复测阻塞：staging 已成功，claim 端点 404；WTA-1928 未关闭 |
| KF-BUG-015 | P1 / Major | Upload validation | 0 B 文件被计为有效并启用提交，422 仅显示英文通用错误 | 已修复；WTA-1929 Done |
| KF-BUG-016 | P2 / Major | Upload recovery | 精确 15 MiB 上传 43+ 秒持续“正在上传…”，无超时/失败收敛 | 已修复；WTA-1930 Done |
| KF-BUG-017 | P1 / Major | Quality CSV | 合法 2 行 CSV 预览正确，提交只报“未知错误”且 0 行落库 | 已修复；WTA-1931 Done |
| KF-BUG-018 | P1 / Major | KnowledgeFS API | API Access 已启用但侧栏仅弹空白“不可用”，无 KFS 凭据路径 | 已修复；WTA-1932 Done |
| KF-BUG-019 | P1 / Major | Research | 空库 Research 单次启动后无任务、阶段、结果或错误反馈 | 已修复；WTA-1933 Done |
| 编号 | 优先级 | 模块 | 摘要 | 状态 |
| ---------- | -------------- | ---------------------- | ---------------------------------------------------------------------------- | --------------------------------------------------------- |
| KF-BUG-001 | P1 / Major | Retrieval | Fast/Deep 单次开始或重试生成两条记录/任务 | 已修复；WTA-1914 Done |
| KF-BUG-002 | P1 / Major | Create | 41 字名称可提交，后端拒绝后误报“权限” | 已修复；WTA-1915 Done |
| KF-BUG-003 | P1 / Major | Settings | 2001 字描述可提交，后端拒绝后误报“网络” | 已修复；WTA-1916 Done |
| KF-BUG-004 | P1 / Major | Error handling | 不存在空间的 404 toast 暴露后端 API 路由 | 已修复；WTA-1917 Done |
| KF-BUG-005 | P1 / Major | Website source | 抓取页数显示值与实际提交值静默不一致 | 已修复；WTA-1918 Done |
| KF-BUG-006 | P2 / Major | Document detail | 详情内容已加载时同时出现 3 条相同英文 404 toast | 已修复；WTA-1919 Done |
| KF-BUG-007 | P2 / Major | Metadata | 详情页点击“编辑”后按钮永久禁用，无编辑器和反馈 | 已修复；WTA-1920 Done |
| KF-BUG-008 | P2 / Normal | Quality | 必填错误在输入合法值后不消失，查找证据只报“未知错误” | 已修复；WTA-1921 Done |
| KF-BUG-009 | P2 / Normal | External API | 非法 endpoint 同时弹出两条错误，中英混用 | 已修复；WTA-1922 Done |
| KF-BUG-010 | P3 / Minor | Retrieval | 有大量历史记录时仍显示“暂无测试记录” | 已修复；WTA-1923 Done |
| KF-BUG-011 | P3 / Minor | List | 搜索无结果时列表全空，无“无结果”解释和清除指引 | 已修复；WTA-1924 Done |
| KF-BUG-012 | P3 / Usability | Responsive | 390 px 下顶部功能导航超出视口，“设置”无明显可达性提示 | 已修复；WTA-1925 Done |
| KF-BUG-013 | P2 / Normal | Service API | Key 已成功鉴权调用 200，密钥列表“最后使用”仍持续显示“从未” | 已修复；WTA-1926 Done |
| KF-BUG-014 | P1 / Major | Document upload | 合法 TXT/Markdown staged upload 全部报 `Internal Server Error`，0 文档 | 复测阻塞：staging 已成功，claim 端点 404；WTA-1928 未关闭 |
| KF-BUG-015 | P1 / Major | Upload validation | 0 B 文件被计为有效并启用提交，422 仅显示英文通用错误 | 已修复；WTA-1929 Done |
| KF-BUG-016 | P2 / Major | Upload recovery | 精确 15 MiB 上传 43+ 秒持续“正在上传…”，无超时/失败收敛 | 已修复；WTA-1930 Done |
| KF-BUG-017 | P1 / Major | Quality CSV | 合法 2 行 CSV 预览正确，提交只报“未知错误”且 0 行落库 | 已修复；WTA-1931 Done |
| KF-BUG-018 | P1 / Major | KnowledgeFS API | API Access 已启用但侧栏仅弹空白“不可用”，无 KFS 凭据路径 | 已修复；WTA-1932 Done |
| KF-BUG-019 | P1 / Major | Research | 空库 Research 单次启动后无任务、阶段、结果或错误反馈 | 已修复；WTA-1933 Done |
| KF-BUG-020 | P1 / Major | Workflow v2 UI | 从节点选择器新增 KnowledgeFS 检索后主编辑区空白，未处理 `AbortError` | 已修复；WTA-1954 Done；待部署后真实 Chrome 复测 |
| KF-BUG-021 | P1 / Blocker | Workflow v2 runtime | Settings UI 无 Workflow channel 开关；channel/permissions 失败统一误报未绑定 | 已修复；WTA-1953 Done；待部署后真实运行复测 |
| KF-BUG-022 | P1 / Major | Workflow v2 filters | `created_after` / `created_before` 保存后静默丢失 | 已建单；WTA-1956 Backlog |
| KF-BUG-023 | P2 / Normal | Workflow v2 filters | 最后一个 node kind 无法取消 | 已建单；WTA-1955 Backlog |
| KF-BUG-024 | P2 / Normal | Workflow v2 validation | 未解析空间在草稿无持久警告，发布才显示原始英文与内部 ID | 已建单；WTA-1957 Backlog |
### 4.1 修复验证
- Web：14 个所属功能 spec、507 个测试全部通过；全量 `pnpm type-check` 通过。
- Dify API：5 个相关测试文件、172 个测试全部通过；目标 Ruff 检查通过。
- KnowledgeFS API：Golden Question gateway 回归 5/5 通过；API package TypeScript 检查通过。
- Workflow v2 Web：6 个关联 spec 文件整体 22/22 通过，其中 16 项为 v2 直接断言、6 项为同一 hook spec 的通用节点元数据用例。
- Workflow v2 Dify API：节点、admission、binding、execution、capability、broker、runtime、DTO、operation、controller 与 remote HTTP 共 13 个关联文件，文件整体 340/340 通过；部分 controller/DTO/remote 用例并非 v2 专属。这些仍是 mocked/fake/mock HTTP/进程内合同，不替代真实 KFS 正向链路。
- KF-BUG-020 专项：更宽的 Workflow 组合回归为 9 个 spec、27 个测试通过；回归证明 history 引用变化后 Workflow 子树仍保持挂载。根因是通用 `WorkflowHistoryStoreInitializer` 在约 500 ms 的 history 保存产生新对象后返回空内容并卸载整棵子树，Console `AbortError` 是查询观察者随卸载取消的后果，而非 KnowledgeFS 请求根因。
- KF-BUG-020/021 最终组合：Web 7 个 spec、70 个测试通过，Dify API admission/node 18 个测试通过；全量 Web TypeScript 检查及目标 locale ESLint 通过。覆盖独立 Workflow Access 保存/失败回滚、四类 admission 错误、稳定 marker、运行表面映射与 24 个 locale 本地化。上述结果均为本地分层自动化，尚未替代部署后的真实 Chrome/Web/Service 正向召回。
- 补丁完整性：`git diff --check` 通过；本轮未创建 Git commit。
- Linear：18 个已验证缺陷均更新为 `Done` 并指派给 `jyong`；WTA-1928 保持未关闭并继续归属 Milestone `测试联调`。
- Linear：KF-BUG-020 / WTA-1954 与 KF-BUG-021 / WTA-1953 均已更新为 `Done` 并指派给 `jyong`；KF-BUG-022～024 分别为 WTA-1956、WTA-1955、WTA-1957，状态保持 `Backlog`。五项均归属项目 `Make RAG Great Again`、Milestone `测试联调`；WTA-1928 仍保持未关闭。
### 4.2 Linear Issue 映射
以下缺陷均已创建到 Linear 项目 [Make RAG Great Again](https://linear.app/dify/project/make-rag-great-again-b9f26b73ca33/issues)，Team 为 `WTA`，初始状态为 `Backlog`，Milestone 为 `测试联调`。优先级映射为 P1 → High、P2 → Medium、P3 → Low。
| 缺陷 | Linear Issue | Linear 优先级 |
|---|---|---|
| KF-BUG-001 | [WTA-1914](https://linear.app/dify/issue/WTA-1914) | High |
| KF-BUG-002 | [WTA-1915](https://linear.app/dify/issue/WTA-1915) | High |
| KF-BUG-003 | [WTA-1916](https://linear.app/dify/issue/WTA-1916) | High |
| KF-BUG-004 | [WTA-1917](https://linear.app/dify/issue/WTA-1917) | High |
| KF-BUG-005 | [WTA-1918](https://linear.app/dify/issue/WTA-1918) | High |
| KF-BUG-006 | [WTA-1919](https://linear.app/dify/issue/WTA-1919) | Medium |
| KF-BUG-007 | [WTA-1920](https://linear.app/dify/issue/WTA-1920) | Medium |
| KF-BUG-008 | [WTA-1921](https://linear.app/dify/issue/WTA-1921) | Medium |
| KF-BUG-009 | [WTA-1922](https://linear.app/dify/issue/WTA-1922) | Medium |
| KF-BUG-010 | [WTA-1923](https://linear.app/dify/issue/WTA-1923) | Low |
| KF-BUG-011 | [WTA-1924](https://linear.app/dify/issue/WTA-1924) | Low |
| KF-BUG-012 | [WTA-1925](https://linear.app/dify/issue/WTA-1925) | Low |
| KF-BUG-013 | [WTA-1926](https://linear.app/dify/issue/WTA-1926) | Medium |
| KF-BUG-014 | [WTA-1928](https://linear.app/dify/issue/WTA-1928) | High |
| KF-BUG-015 | [WTA-1929](https://linear.app/dify/issue/WTA-1929) | High |
| KF-BUG-016 | [WTA-1930](https://linear.app/dify/issue/WTA-1930) | Medium |
| KF-BUG-017 | [WTA-1931](https://linear.app/dify/issue/WTA-1931) | High |
| KF-BUG-018 | [WTA-1932](https://linear.app/dify/issue/WTA-1932) | High |
| KF-BUG-019 | [WTA-1933](https://linear.app/dify/issue/WTA-1933) | High |
| 缺陷 | Linear Issue | Linear 优先级 | 状态 |
| ---------- | -------------------------------------------------- | ------------- | ---------------- |
| KF-BUG-001 | [WTA-1914](https://linear.app/dify/issue/WTA-1914) | High | Done |
| KF-BUG-002 | [WTA-1915](https://linear.app/dify/issue/WTA-1915) | High | Done |
| KF-BUG-003 | [WTA-1916](https://linear.app/dify/issue/WTA-1916) | High | Done |
| KF-BUG-004 | [WTA-1917](https://linear.app/dify/issue/WTA-1917) | High | Done |
| KF-BUG-005 | [WTA-1918](https://linear.app/dify/issue/WTA-1918) | High | Done |
| KF-BUG-006 | [WTA-1919](https://linear.app/dify/issue/WTA-1919) | Medium | Done |
| KF-BUG-007 | [WTA-1920](https://linear.app/dify/issue/WTA-1920) | Medium | Done |
| KF-BUG-008 | [WTA-1921](https://linear.app/dify/issue/WTA-1921) | Medium | Done |
| KF-BUG-009 | [WTA-1922](https://linear.app/dify/issue/WTA-1922) | Medium | Done |
| KF-BUG-010 | [WTA-1923](https://linear.app/dify/issue/WTA-1923) | Low | Done |
| KF-BUG-011 | [WTA-1924](https://linear.app/dify/issue/WTA-1924) | Low | Done |
| KF-BUG-012 | [WTA-1925](https://linear.app/dify/issue/WTA-1925) | Low | Done |
| KF-BUG-013 | [WTA-1926](https://linear.app/dify/issue/WTA-1926) | Medium | Done |
| KF-BUG-014 | [WTA-1928](https://linear.app/dify/issue/WTA-1928) | High | 未关闭 |
| KF-BUG-015 | [WTA-1929](https://linear.app/dify/issue/WTA-1929) | High | Done |
| KF-BUG-016 | [WTA-1930](https://linear.app/dify/issue/WTA-1930) | Medium | Done |
| KF-BUG-017 | [WTA-1931](https://linear.app/dify/issue/WTA-1931) | High | Done |
| KF-BUG-018 | [WTA-1932](https://linear.app/dify/issue/WTA-1932) | High | Done |
| KF-BUG-019 | [WTA-1933](https://linear.app/dify/issue/WTA-1933) | High | Done |
| KF-BUG-020 | [WTA-1954](https://linear.app/dify/issue/WTA-1954) | High | Done；待部署实测 |
| KF-BUG-021 | [WTA-1953](https://linear.app/dify/issue/WTA-1953) | High | Done；待部署实测 |
| KF-BUG-022 | [WTA-1956](https://linear.app/dify/issue/WTA-1956) | High | Backlog |
| KF-BUG-023 | [WTA-1955](https://linear.app/dify/issue/WTA-1955) | Medium | Backlog |
| KF-BUG-024 | [WTA-1957](https://linear.app/dify/issue/WTA-1957) | Medium | Backlog |
### KF-BUG-001：Fast/Deep 单次操作重复提交
@ -233,37 +253,38 @@ QA 空间的 Fast 和 Deep 各执行过一次 0 文档检索并正常返回 0
## 5. 环境问题、受限项与待复测风险
| 编号 | 现象 | 当前判定 | 下一步 |
|---|---|---|---|
| ENV-001 | 页面显示模型消息额度为 0；既有 `ceshi` 的 Fast/Deep 均 `Query generation failed` | 更像模型/额度环境阻塞；QA 空库 Fast/Deep 的 0 结果链路可用 | 补充可用模型额度后复测真实答案和引用 |
| ENV-002 | 既有库 Research 流式步骤可见，最终“检索失败/未召回分段” | 链路启动正常，语料/模型不可用；QA 空库另有静默失败缺陷 | 文件上传并建立索引后复测 |
| ENV-003 | Firecrawl 对 `https://example.com` 36+ 秒仍 0 页 | 未能区分 provider/网络/产品超时 | 有 provider 观测日志时复测；本轮 Stop 状态流转正常 |
| ENV-004 | Jina Reader 显示“集成未安装” | 环境能力缺失，非功能缺陷 | 安装并配置凭据后测试 |
| ENV-005 | Chrome 扩展最初拒绝文件选择 | **已解决**：用户开启 file URL 访问后，多文件、Unicode 和 15 MiB 文件均可交给页面 | 无；后续失败已确认发生在应用 staging 层 |
| RISK-001 | 列表搜索实现可能只过滤已加载页 | 代码侧候选风险，当前只有 6 个空间无法实证 | 准备超过一页的数据后搜索末页项 |
| RISK-002 | 旧版 segment 无 `attachment_ids` 可能接口 500 但数据部分落库 | 后端静态审查候选 | 在可清理的 legacy 测试库通过 UI/API 复测 |
| RISK-003 | 旧版 metadata rename/delete 可能吞异常后表面成功 | 后端静态审查候选 | 每次操作后刷新并核对真实 metadata |
| RISK-004 | 删除仍被 App 使用的 legacy dataset 可能未调用 use-check | 后端静态审查候选 | 使用专用 App+dataset 验证防误删 |
| 编号 | 现象 | 当前判定 | 下一步 |
| -------- | -------------------------------------------------------------------------------- | -------------------------------------------------------------------------------- | -------------------------------------------------- |
| ENV-001 | 页面显示模型消息额度为 0；既有 `ceshi` 的 Fast/Deep 均 `Query generation failed` | 更像模型/额度环境阻塞；QA 空库 Fast/Deep 的 0 结果链路可用 | 补充可用模型额度后复测真实答案和引用 |
| ENV-002 | 既有库 Research 流式步骤可见，最终“检索失败/未召回分段” | 链路启动正常，语料/模型不可用；QA 空库另有静默失败缺陷 | 文件上传并建立索引后复测 |
| ENV-003 | Firecrawl 对 `https://example.com` 36+ 秒仍 0 页 | 未能区分 provider/网络/产品超时 | 有 provider 观测日志时复测；本轮 Stop 状态流转正常 |
| ENV-004 | Jina Reader 显示“集成未安装” | 环境能力缺失，非功能缺陷 | 安装并配置凭据后测试 |
| ENV-005 | Chrome 扩展最初拒绝文件选择 | **已解决**：用户开启 file URL 访问后，多文件、Unicode 和 15 MiB 文件均可交给页面 | 无；后续失败已确认发生在应用 staging 层 |
| RISK-001 | 列表搜索实现可能只过滤已加载页 | 代码侧候选风险，当前只有 6 个空间无法实证 | 准备超过一页的数据后搜索末页项 |
| RISK-002 | 旧版 segment 无 `attachment_ids` 可能接口 500 但数据部分落库 | 后端静态审查候选 | 在可清理的 legacy 测试库通过 UI/API 复测 |
| RISK-003 | 旧版 metadata rename/delete 可能吞异常后表面成功 | 后端静态审查候选 | 每次操作后刷新并核对真实 metadata |
| RISK-004 | 删除仍被 App 使用的 legacy dataset 可能未调用 use-check | 后端静态审查候选 | 使用专用 App+dataset 验证防误删 |
## 6. 已执行功能覆盖
下表记录初始真实环境测试结果，用于保留原始证据；修复后的最新状态以第 4 节为准。
| 功能域 | 已实测内容 | 结果 |
|---|---|---|
| 入口/路由 | `/datasets?view=new`、Legacy/New 切换、刷新、列表回显、不存在 ID 深链 | 主流程通过；404 toast 有泄露问题 |
| 列表 | 大小写不敏感搜索、无结果、创建者筛选/搜索/重置、新库排序 | 通过；无结果缺少空状态 |
| 创建 | 空库、名称空白/41/精确40字、描述、only_me、异步加载后进入 Sources | 合法创建通过；超长校验失败 |
| 概览 | 无数据 onboarding、24h/30d 指标、需关注分页、最近活动抽屉与运营者筛选、资产图谱 | 通过 |
| 数据源目录 | Website/Online Documents/Drive，Firecrawl/Jina/WaterCrawl/Notion/Google Docs/Confluence/Drive/OneDrive/S3 入口 | 目录可用；部分集成未安装 |
| Website | URL 格式、抓取选项、最大页数边界、实际 Firecrawl preview、Stop、Retry 入口、草稿离开确认 | Stop 通过；页数校验失败；preview 环境阻塞 |
| 文档列表/上传 | Ready/Failed 筛选、搜索、无结果、任务抽屉、选择/批量操作、行菜单、重命名；真实 TXT/MD/Unicode/0 B/15 MiB/15 MiB+1/`.exe` | 列表主流程通过；合法 staging 失败、空文件校验和大文件恢复异常 |
| 文档详情 | 内容加载、metadata 区、编辑入口 | 内容加载成功，同时有重复 404；metadata 编辑异常 |
| Retrieval | 空白输入、2000 字 UI 上限属性、Fast/Deep/Research，Start、Retry、记录、空库 0 结果、Research 流式阶段 | QA Fast/Deep 空结果通过；既有库重复/额度失败；QA Research 静默 |
| Quality | 空状态、参考问题/问题案例 tab、新建必填校验、创建草稿、编辑、选择、2 行 CSV 预览与提交 | 创建/编辑与 CSV 解析通过；CSV 提交未知错误、校验清除异常 |
| Settings | 名称 40/41、描述 2000/2001、可见权限、partial 零成员、API Access off/on/off 持久化、Fast/Deep、Top K 0/1/10/11、Rerank/threshold 依赖 | API Access 已恢复 off；描述超长错误处理失败 |
| API 入口 | External Knowledge API；Dataset Service API key 创建/正负鉴权；KFS admission Web/API 域名；空间 API Access | Dataset key 200/错误 key 401；KFS admission 对旧 key 返回结构化 401；空间 API 面板不可用；最后使用不更新 |
| 响应式 | 390×844 下上传页、顶部功能导航 | 内容可用；导航超出视口待改进 |
| 功能域 | 已实测内容 | 结果 |
| ------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------- |
| 入口/路由 | `/datasets?view=new`、Legacy/New 切换、刷新、列表回显、不存在 ID 深链 | 主流程通过；404 toast 有泄露问题 |
| 列表 | 大小写不敏感搜索、无结果、创建者筛选/搜索/重置、新库排序 | 通过；无结果缺少空状态 |
| 创建 | 空库、名称空白/41/精确40字、描述、only_me、异步加载后进入 Sources | 合法创建通过；超长校验失败 |
| 概览 | 无数据 onboarding、24h/30d 指标、需关注分页、最近活动抽屉与运营者筛选、资产图谱 | 通过 |
| 数据源目录 | Website/Online Documents/Drive，Firecrawl/Jina/WaterCrawl/Notion/Google Docs/Confluence/Drive/OneDrive/S3 入口 | 目录可用；部分集成未安装 |
| Website | URL 格式、抓取选项、最大页数边界、实际 Firecrawl preview、Stop、Retry 入口、草稿离开确认 | Stop 通过；页数校验失败；preview 环境阻塞 |
| 文档列表/上传 | Ready/Failed 筛选、搜索、无结果、任务抽屉、选择/批量操作、行菜单、重命名；真实 TXT/MD/Unicode/0 B/15 MiB/15 MiB+1/`.exe` | 列表主流程通过；合法 staging 失败、空文件校验和大文件恢复异常 |
| 文档详情 | 内容加载、metadata 区、编辑入口 | 内容加载成功，同时有重复 404；metadata 编辑异常 |
| Retrieval | 空白输入、2000 字 UI 上限属性、Fast/Deep/Research，Start、Retry、记录、空库 0 结果、Research 流式阶段 | QA Fast/Deep 空结果通过；既有库重复/额度失败；QA Research 静默 |
| Quality | 空状态、参考问题/问题案例 tab、新建必填校验、创建草稿、编辑、选择、2 行 CSV 预览与提交 | 创建/编辑与 CSV 解析通过；CSV 提交未知错误、校验清除异常 |
| Settings | 名称 40/41、描述 2000/2001、可见权限、partial 零成员、API Access off/on/off 持久化、Fast/Deep、Top K 0/1/10/11、Rerank/threshold 依赖 | API Access 已恢复 off；描述超长错误处理失败 |
| API 入口 | External Knowledge API；Dataset Service API key 创建/正负鉴权；KFS admission Web/API 域名；空间 API Access | Dataset key 200/错误 key 401；KFS admission 对旧 key 返回结构化 401；空间 API 面板不可用；最后使用不更新 |
| Workflow Knowledge Retrieval v2 | 节点可见、DSL 导入/导出、空间搜索与 1/6 选择、四种 mode 表面、Top N、filters、输出变量、16000/16001 查询、发布/版本/binding、完整/单步/Web/Service blocking/streaming、日志、key 撤销 | 初测配置和控制面大部通过并确认 KF-BUG-020～024；020/021 已完成代码修复和专项回归，022～024 Backlog；真实召回仍待部署及 channel/permissions-ready 环境复测 |
| 响应式 | 390×844 下上传页、顶部功能导航 | 内容可用；导航超出视口待改进 |
## 7. 暂未执行的破坏性/需授权用例
@ -274,6 +295,7 @@ QA 空间的 Fast 和 Deep 各执行过一次 0 文档检索并正常返回 0
3. 基础 Quality CSV 初测可预览但无法导入；KF-BUG-017 的“匹配能力不可用时保存草稿”已完成代码修复和 API 回归。500/501 行、1 MiB 边界、中文表头和部分错误恢复仍需部署后实链路复测。
4. QA API Access on/off 与恢复已完成。KF-BUG-018 已补齐 KnowledgeFS 专属 credential 的创建、列表、撤销及 admission endpoint 说明；部署后仍需在真实环境执行两步 admission+SSE，现有 Dataset Service API Key 按安全边界继续应被 401 拒绝。
5. 永久清理仍需操作前确认：删除 1 条参考问题、1 个已停止 Firecrawl 草稿和整个 QA 空间；撤销临时 Dataset Service API Key。
6. Workflow v2 的 KF-BUG-020/021 修复需先部署，再在 Settings 启用 `workflow_enabled=true`，并提供 permissions ready、Capability v2 可达且含已索引唯一 marker 的空间，才能执行 WF2-LIVE-001～015；WF2-LIVE-016～018 需先定义/实现取消、error strategy 和 retry 支持。当前不能把专项单元/组件测试记作这些真实运行断言的端到端通过。
## 8. 自动化覆盖现状
@ -281,12 +303,16 @@ QA 空间的 Fast 和 Deep 各执行过一次 0 文档检索并正常返回 0
- Dify 后端 KnowledgeFS 相关约 511 个 Python test function，但 `api/tests/integration_tests` 没有真实 KnowledgeFS 集成链路覆盖。
- 独立 `knowledge-fs/` 约 4131 个 TypeScript test declaration，大部分 E2E 仍使用 in-memory/fake/stub。
- 现有 Cucumber 只覆盖旧 Dataset API 和少量 Knowledge Retrieval 节点，没有 `/datasets?view=new` 的真实 Chrome E2E。
- 本轮已执行 6 个 Workflow v2 Web 关联 spec（文件整体 22/22，其中 16 项为 v2 直接断言）和 13 个 Dify API 关联测试文件（文件整体 340/340，部分非 v2 专属）；仍未发现真实 Workflow → App admission/capability → KnowledgeFS `/retrieval-tests` 的跨服务 E2E。
- 结论：当前最大缺口是登录态真实 Chrome + Dify BFF + KnowledgeFS + 对象存储 + 解析/索引 + 模型 + provider 的跨服务链路。
## 9. 发布建议
1. 发布门禁继续阻断唯一未完成的 KF-BUG-014：部署当前 API 后必须通过 TXT/Markdown `staging → claim 202 → ready`。KF-BUG-001–013、015–019 已完成代码修复与所属层回归，仍应随同部署进行关键真实链路复测。
1. KF-BUG-014 仍是全量发布门禁，需通过 TXT/Markdown `staging → claim 202 → ready`。Workflow v2 的 KF-BUG-020/021 已完成代码修复，但发布前仍必须部署后用真实 Chrome 验证新增节点持续可见，并在启用的 Workflow channel 上由 Web/Service 返回唯一 marker 与 citation；KF-BUG-022 的时间过滤静默丢失也应在发布前修复。
2. 为所有 KnowledgeFS API 建立统一的错误码→本地化字段错误映射，不直接显示后端原始 message。
3. 为 query admission/stream 和 UI Start/Retry 增加端到端幂等性用例，以记录 ID、trace ID 和计费事件三重断言“一次操作只有一次执行”。
4. 为新版列表、创建、文件上传、真实索引、Fast/Deep/Research 引用、Quality replay 增加 Playwright/Cucumber 浏览器回归。
5. 在测试环境配置一个有额度的固定模型和一个稳定的合成 provider，避免功能回归长期被“额度为 0”阻塞。
6. 为 Workflow v2 建立登录态 E2E：创建节点并等待超过 history 保存窗口 → 确认编辑器未卸载 → 选择空间 → 启用 Workflow Access → 发布 → Web/Service 执行 → 断言每空间恰好一次 JSON `/retrieval-tests` → 核对 marker/citation → 撤权后旧 capability 立即失败；并覆盖四类 admission marker 的本地化展示。
7. 明确 Workflow v2 是否支持 stop/cancel、fail-branch/default-value 和 retry；若支持，先补 cancellation signal 与节点 allowlist，再执行 WF2-LIVE-016～018；若不支持，应在产品文档和 UI 中明确说明。
8. 修复并回归 `KNOWLEDGE_FS_BASE_URL` 未配置时的节点错误边界：composition root 会 fail closed，但当前 `_service()`/draft runtime 解析可能绕过 v2 的受控错误映射。

223
test-results/knowledge-fs/2026-08-11/knowledge-retrieval-v2-functional-test-report.md Normal file
View File

@ -0,0 +1,223 @@
# Workflow Knowledge Retrieval v2 / KnowledgeFS 功能补测报告
## 1. 结论
本轮已把原报告中 `TC-RE-022`、`TC-AU-015`、`TC-AU-016` 对应的 Workflow `knowledge-retrieval-v2` 未测试范围扩展为独立矩阵，并完成真实 Chrome、已发布 Web App、Workflow Service API blocking/streaming、DSL、发布绑定和自动化合同测试。
已验证可用的部分：节点可见性、有效 DSL 导入/导出、刷新恢复、查询变量绑定、空间搜索与多选、Fast/Deep/Research/跟随空间的配置保存、Top N、绝大多数 metadata filter 的配置持久化、输出变量、空白与 16000/16001 查询边界、未解析空间发布拦截、Workflow 发布版本、绑定精确同步、运行日志，以及 Service API 失败响应合同。真实 mode 与 filter 召回效果未通过，仍属于后文 `ENV-BLOCKED`。
初测环境仍不能判定 Workflow KnowledgeFS retrieval 可用。有效 Workflow 发布成功后，KnowledgeFS Overview 的“关联应用”为 `1`，证明绑定记录已经创建；但当时草稿完整运行、单节点运行、已发布 Web App、Service API blocking 和 Service API streaming 全部稳定失败为：
```text
KnowledgeFS Space <control-space-id> is not bound to this workflow
```
QA 空间的 API Access 临时开启/恢复也已测试；按合同该开关只控制 Service API 与 Agent、会保留原 `workflow_enabled`，因此它不应解除 Workflow 阻塞，也不作为 runtime 缺陷证据。初测部署的 Settings UI 没有可发现的 Workflow channel 开关，Overview 同时显示 `Knowledge-space permissions are not ready`。因此真实 Fast/Deep/Research 召回、引用、真实 filters、多空间合并和 capability 撤权继续标记为 `ENV-BLOCKED`，不能用 mock 单测冒充通过。
本轮新增 5 个已确认缺陷：`KF-BUG-020`～`KF-BUG-024`，均已创建到 Linear 项目 `Make RAG Great Again`、Milestone `测试联调`。KF-BUG-020/021 已完成代码修复、专项自动化回归和 Linear 关闭；KF-BUG-022～024 保持 Backlog。020 修复了通用 Workflow history 初始化器卸载子树的问题；021 增加独立 Workflow Access 控件、细分 admission 原因，并将稳定错误 marker 映射为 24 个 locale 的本地化消息。两项修复尚未部署到测试环境，所以下文保留原始浏览器 FAIL，且仍需真实 Chrome/Web/Service 正向复测。
## 2. 环境与测试对象
- Console：`https://new-rag.dify.dev`
- Web App：`https://new-rag-app.dify.dev`
- Service API：`https://new-rag-api.dify.dev/v1`
- 浏览器：用户已登录的 Google Chrome
- 角色：Workspace Owner
- 有效测试 Workflow：`KF-WF-V2-LIVE-CESHI-20260811`
- App ID：`98bcd2c4-e371-405f-a972-d21bb41b5fa2`
- 未解析空间 Workflow：`KF-WF-V2-UNRESOLVED-20260811`
- App ID：`5c6687c6-4b30-4abf-81e2-efc4d9fa1514`
- UI 新增节点复现 Workflow：`KF-WF-V2-QA-20260811`
- App ID：`fbed98e7-5370-4eca-a2a9-f128ce69a50e`
- 既有空间 `ceshi`：`019fac9f-bfb0-75ee-9af5-252ebafbac1c`
- QA 空间：`019fef0d-732b-73d4-95e6-e943be794403`
- 当前 workspace 仅有 6 个可选空间；线上 10/11 空间边界由组件和后端合同测试补齐。
- 有效 DSL fixture：[kf-wf-v2-live-ceshi.yml](./test-data/kf-wf-v2-live-ceshi.yml)
- 未解析空间 fixture：[kf-wf-v2-unresolved-space.yml](./test-data/kf-wf-v2-unresolved-space.yml)
## 3. 已执行矩阵
| ID | P | 场景 | 期望 | 结果 |
| ------- | --- | ----------------------------------------------------------- | ------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------- |
| WF2-001 | P0 | feature 开启时打开添加节点面板 | 显示“KnowledgeFS 检索” | PASS |
| WF2-002 | P0 | Start 后从节点选择器点击“KnowledgeFS 检索” | 创建节点并打开配置面板 | **初测 FAIL**；主编辑区变为空白，未处理 `AbortError`，见 KF-BUG-020；代码已修复并通过专项回归，待部署后真实 Chrome 复测 |
| WF2-003 | P0 | 打开通过 DSL 已存在的 v2 节点 | 配置面板正常加载 | PASS；6 个空间、当前选择和 settings 摘要正常 |
| WF2-004 | P0 | 导入 Start→v2→End 合法 DSL | 创建 Workflow，保留 v2 节点 | PASS |
| WF2-005 | P0 | 导入后刷新 | 图、空间、模式、Top N 和 End 映射恢复 | PASS |
| WF2-006 | P0 | 导出已保存 DSL | 保留 `control_space_ids`、filters、mode、top_n、result 输出 | PASS |
| WF2-007 | P0 | 导入引用不存在空间的 DSL | 草稿可导入，但明确保留 unresolved warning | **FAIL-PARTIAL**；导入成功，面板和检查清单无持久警告，见 KF-BUG-024 |
| WF2-008 | P0 | 发布未解析空间 Workflow | 发布失败且不创建 published snapshot | PASS；保持“未发布”，明确列出缺失 ID |
| WF2-009 | P0 | 运行未解析空间草稿 | fail closed，不触碰 KFS | PASS；`draft binding could not be enabled` |
| WF2-010 | P0 | 绑定 `Start.query` | 面板显示 string selector，刷新不丢失 | PASS |
| WF2-011 | P1 | 搜索空间并清除搜索 | 过滤正确，键盘可清除并恢复列表 | PASS |
| WF2-012 | P0 | 取消全部空间 | `0/10` 且检查清单阻止发布 | PASS；“KnowledgeFS 空间不能为空” |
| WF2-013 | P0 | 选择 1 个和全部 6 个可见空间 | 计数、checked 状态和节点摘要一致 | PASS；`1/10`、`6/10` |
| WF2-014 | P0 | 空间上限 10/11、去重、顺序 | 10 允许，11 拒绝，重复 ID 去重 | PASS-AUTO；当前线上只有 6 个，未伪造 live 10/11 |
| WF2-015 | P0 | Fast、Deep、Research、跟随空间配置 | 均可保存；跟随配置不写字面 `auto` | PASS；刷新验证 Deep，其他模式即时保存验证 |
| WF2-016 | P0 | DSL 使用字面 `mode: auto` | 合同拒绝 | PASS-AUTO；Auto 语义是省略 mode/`space-default` |
| WF2-017 | P0 | Top N = 0/1/100/101 | 仅 1～100 生效 | PASS；0/101 保留原值 5，1/100 精确显示 |
| WF2-018 | P1 | document type/entity/freshness/language/source/tags filters | 逗号值解析、保存、刷新和 DSL 导出一致 | PASS |
| WF2-019 | P0 | created after/before 输入合法 datetime | 保存、刷新和 DSL 导出保留 | **FAIL**；刷新后为空，DSL 无字段，见 KF-BUG-022 |
| WF2-020 | P1 | 同时选择 section/table node kinds | 多选和 DSL 导出一致 | PASS |
| WF2-021 | P1 | 逐个取消 node kinds，最后取消剩余项 | 最后一项也可清除 | **FAIL**；最后一项永久 checked，见 KF-BUG-023 |
| WF2-022 | P0 | 展开输出变量 | 显示 result 与 metrics 完整合同 | PASS；result/content/title/metadata、metrics/mode/total_ms/degradation_flags |
| WF2-023 | P0 | query 仅空格 | trim 后拒绝且 0 token | PASS；`must not be empty` |
| WF2-024 | P0 | query 精确 16000 字符 | 通过长度校验 | PASS；进入下一步绑定校验 |
| WF2-025 | P0 | query 16001 字符 | 在上游调用前拒绝 | PASS；`at most 16000 characters` |
| WF2-026 | P0 | 未发布草稿完整运行 | debugger/account 自动 upsert 所选 binding 后执行 retrieval | **初测 FAIL**；admission 统一返回未绑定，无法从 UI 区分 join、channel 或 permissions 状态，归入 KF-BUG-021；代码已细分错误并本地化，待部署实测 |
| WF2-027 | P0 | 发布合法 Workflow | 创建 published snapshot 并同步 binding | PASS；UI 操作成功，Overview 关联应用 0→1 |
| WF2-028 | P0 | 从 `ceshi` 切到 QA 后发布 | 新 binding active，旧 binding revoke | PASS；`ceshi` 关联应用 1→0 |
| WF2-029 | P0 | 切回 `ceshi` 再发布 | QA 解绑、`ceshi` 恢复且不重复 | PASS；`ceshi` 关联应用恢复为 1 |
| WF2-030 | P1 | 查看版本历史 | 每次发布产生完整快照 | PASS；10:10、10:25、10:27 三个版本可见 |
| WF2-031 | P0 | QA API Access off→on→运行→off | 保存即时，测试后恢复 | PASS；最终 `未启用` |
| WF2-032 | P0 | 发布后完整草稿运行 | 已绑定 Workflow 可检索或准确说明 channel/permission 问题 | **初测 FAIL**；误报未绑定，见 KF-BUG-021；错误分类代码已修复，真实正向召回待部署复测 |
| WF2-033 | P0 | “运行此步骤” | 与完整运行同一绑定/错误合同 | **初测 FAIL-BLOCKED**；稳定误报未绑定，无法到达 KFS；代码已修复，环境阻塞仍未解除 |
| WF2-034 | P0 | 已发布 Web App 运行 | 返回 evidence 或真实 no-result | **初测 FAIL-BLOCKED**；稳定误报未绑定；代码已修复，待部署后真实 Web App 复测 |
| WF2-035 | P0 | Service API blocking | HTTP 200，`data.status/error/outputs` 合同完整 | PASS-NEGATIVE；`failed`、同一绑定错误、`outputs={}`、2 steps、0 tokens |
| WF2-036 | P0 | Service API streaming | workflow/node terminal SSE 顺序和错误一致 | PASS-NEGATIVE；start succeeded，v2 node failed，workflow failed |
| WF2-037 | P0 | 撤销临时 App API key 后重试 | 立即 401 | PASS；完整 secret 未写入报告 |
| WF2-038 | P1 | 日志列表和详情 | Web/API 运行可查，错误与运行一致 | PASS；5 条失败记录，详情显示绑定错误 |
| WF2-039 | P0 | 自动化合同回归 | UI、节点、绑定、capability、remote HTTP 和 operation 测试全绿 | PASS；Web 6 个关联 spec 整体 22/22，API 13 个关联文件整体 340/340 |
## 4. 当前无法完成但未遗漏的真实运行矩阵
下列项目均已准备步骤和断言。WF2-LIVE-001～015 需要先部署 KF-BUG-021 修复，通过新控件设置 `workflow_enabled=true`，并提供 permissions ready、Capability v2 可达、含唯一 marker 且已索引的空间；在此之前仍标记为 15 个 `ENV-BLOCKED`。WF2-LIVE-016 缺少节点到同步 remote 的 cancellation signal；WF2-LIVE-017～018 则因为产品未给 v2 节点开放 error strategy/retry 配置而无法执行，3 个规格/实现阻塞状态不变，不能误归因为环境问题。
| ID | 场景与验收标准 | 状态 |
| ------------ | ------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------- |
| WF2-LIVE-001 | Fast 返回唯一 marker、最终 score 和正确 citation | ENV-BLOCKED |
| WF2-LIVE-002 | Deep 返回同一 marker 的深度召回证据 | ENV-BLOCKED |
| WF2-LIVE-003 | Research 仍走同步 JSON evidence retrieval，不创建 Console Research task/SSE | ENV-BLOCKED |
| WF2-LIVE-004 | 省略 mode 使用每个 space Settings；多空间可汇总为 mixed | ENV-BLOCKED |
| WF2-LIVE-005 | 合法无结果查询成功返回 `result=[]`，不是 failed | ENV-BLOCKED |
| WF2-LIVE-006 | 多空间按最终 score 全局排序、全局 top_n、同分稳定 | ENV-BLOCKED |
| WF2-LIVE-007 | tags/document/source/language/freshness/node kind/date filters 真正缩小结果 | ENV-BLOCKED |
| WF2-LIVE-008 | citation 保留 document/version/hash/section/page/offset | ENV-BLOCKED |
| WF2-LIVE-009 | metrics 汇总每空间 mode、候选数、耗时和 degradation | ENV-BLOCKED |
| WF2-LIVE-010 | 每个空间恰好一次 JSON `POST /knowledge-spaces/{id}/retrieval-tests` | ENV-BLOCKED |
| WF2-LIVE-011 | 不调用 KFS `/queries`、SSE 或 Research task | ENV-BLOCKED；静态合同/单测已通过 |
| WF2-LIVE-012 | draft、published Web、Service API、Trigger 对同 snapshot 返回等价 evidence | ENV-BLOCKED |
| WF2-LIVE-013 | binding/channel/revision 撤权在下一次 admission 立即 fail closed | ENV-BLOCKED |
| WF2-LIVE-014 | 已签发旧 capability 在 epoch 变化后被真实 KFS 拒绝 | ENV-BLOCKED |
| WF2-LIVE-015 | 4/10 空间真实并发、超时、无重复 capability/HTTP | ENV-BLOCKED；线上仅 6 个空间 |
| WF2-LIVE-016 | Workflow stop/cancel 对在途 retrieval HTTP 的终止语义 | SPEC/IMPLEMENTATION-BLOCKED；当前节点用同步 ThreadPool/remote，未传 cancellation signal，需先定义并实现语义 |
| WF2-LIVE-017 | v2 节点配置 fail-branch/default-value 后，上游失败按策略继续且暴露受控 `error_type/error_message` | NOT-SUPPORTED/SPEC-BLOCKED；当前 UI 的 error-handle node allowlist 不包含 Knowledge Retrieval v2 |
| WF2-LIVE-018 | v2 节点开启 retry 后，暂态失败严格按次数重试且不会重复 capability/计费 | NOT-SUPPORTED/SPEC-BLOCKED；当前 UI 的 retry node allowlist 不包含 Knowledge Retrieval v2 |
### 4.1 已补齐的本地边界与故障合同
以下项目通过实际运行的 13 个 Dify API 关联测试文件验证，文件整体 340/340 通过；其中 controller/DTO/remote 文件同时包含非 v2 的 KnowledgeFS 用例。它们属于分层自动化结果，不能提升为真实 KFS E2E，但可排除未执行的输入、绑定和 HTTP 错误合同遗漏。
| ID | 场景 | 结果 |
| ---------------- | -------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------- |
| WF2-AUTO-001 | space ID trim/去重、1～10 上限、0/11 拒绝；query selector 与 Top N 合同 | PASS-AUTO |
| WF2-AUTO-002 | mode 仅 Fast/Deep/Research/省略；字面 `auto` 拒绝；filters 每类上限和去重 | PASS-AUTO |
| WF2-AUTO-003 | 未绑定、已撤销、错误 app、跨租户、Agent/Workflow channel 关闭时，在 capability/remote I/O 前 fail closed | PASS-AUTO |
| WF2-AUTO-004 | publish binding 创建/重放/重新激活、精确同步、移除空间撤权、目标授权失败整批不变更 | PASS-AUTO |
| WF2-AUTO-005 | debugger/account 自动 upsert 所选 binding；published Web/Service 永不自动补 binding | PASS-AUTO |
| WF2-AUTO-006 | `retrieveEvidence` 精确签发 read capability，并只调用 JSON `POST /knowledge-spaces/{id}/retrieval-tests` | PASS-AUTO |
| WF2-AUTO-007 | HTTP 400/409/413/422 映射 request rejected；404、500、连接失败映射受控错误 | PASS-AUTO |
| WF2-AUTO-008 | 错误 media type、无效 JSON、请求/响应超限、manifest/path/header 不匹配均在边界拒绝并关闭响应 | PASS-AUTO |
| WF2-AUTO-009 | 2xx 响应缺失/畸形 evidence、citation 或 metrics 时 Pydantic 合同拒绝 | PASS-AUTO |
| WF2-AUTO-010 | 多空间全局按 score 合并、同分稳定、全局 Top N、mixed metrics、空结果成功 | PASS-AUTO |
| WF2-AUTO-011 | 多空间并发有界；任一空间 unavailable 时整个节点失败且 `outputs={}`，不泄漏部分结果 | PASS-AUTO |
| WF2-AUTO-012 | Capability v2/cutover 未就绪时在签发前 fail closed | PASS-AUTO |
| WF2-CONTRACT-001 | `KNOWLEDGE_FS_BASE_URL` 未配置时，Workflow v2 对外稳定映射为 RetrievalUnavailable | CONTRACT-GAP；runtime factory 会在 I/O 前失败，但 `_service()`/draft runtime 解析发生在节点内部错误映射之外，不能由现有单测证明公开错误稳定 |
## 5. 新确认缺陷
以下五项均归属 Linear 项目 `Make RAG Great Again`、Milestone `测试联调`。020/021 已完成并指派给 `jyong`；022～024 保持 Backlog。
### KF-BUG-020：从节点选择器新增 KnowledgeFS 检索导致 Workflow 主编辑区空白
- 严重度：P1 / Major
- Linear：[WTA-1954](https://linear.app/dify/issue/WTA-1954)，High，Done
- 复现率：2/2
- 步骤：空白 Workflow → 选择“用户输入”Start → 添加节点 → 点击“KnowledgeFS 检索”。
- 实际：`<main>` 变为空白，侧栏仍在；没有局部错误、Retry 或恢复入口。Console 记录未处理 `AbortError: signal is aborted without reason`。刷新后新增节点未保存。
- 对照：通过 DSL 已存在的 v2 节点可以打开配置面板，说明故障集中在新增节点生命周期。
- 根因：并非 KnowledgeFS 节点、collaboration 或查询本身。通用 `WorkflowHistoryStoreInitializer` 订阅 history，并以对象引用变化作为“初始化异常”条件；新增节点触发的 history 保存约 500 ms 后写入新对象，initializer 随即返回空内容并卸载整棵 Workflow 子树。TanStack Query 的 `AbortError` 来自观察者随组件卸载取消，是故障后果。
- 修复验证：initializer 只在首次 history 注入完成前阻止渲染，后续 history 引用变化不再卸载子树；更宽的 Workflow 组合回归 9 个 spec、27 个测试通过。当前尚未部署，因此未把本地自动化记为真实 Chrome 复测通过。
### KF-BUG-021：Settings UI 缺少 Workflow channel 开关，channel/permissions 失败被统一误报为未绑定
- 严重度：P1 / Blocker
- Linear：[WTA-1953](https://linear.app/dify/issue/WTA-1953)，High，Done；assignee `jyong`
- 证据：发布后 `ceshi` Overview 的关联应用为 1；换空间发布后精确变 0，再切回恢复 1，证明 binding sync 生效。
- 实际：未发布 debugger/account 草稿会经过自动 upsert 路径，发布图也已有真实 binding；但完整草稿、单步、Web App、Service blocking、Service streaming 都只返回相同“not bound”，无法区分 channel disabled、permissions not ready 与 join 缺失。
- 影响：初测部署的产品 UI 没有可发现的方式把 Workflow channel 从默认关闭改为开启，Workflow v2 因而无法完成真实召回；统一“not bound”还会把 channel/permission 未就绪误导为 binding sync 失败。QA API Access 仅控制 Service/Agent，按合同不应承担开启 Workflow 的作用。
- 修复：Settings 增加独立 Workflow Access 开关并保存 `workflow_enabled`，同时保持 API/Agent/MCP 值；失败时回滚完整 access draft，Retry 仍提交原意图。后端 admission 将 binding 未启用、Workflow channel 关闭、space 不可用、authorization 未就绪分为四类，并在节点错误中携带稳定 marker；前端在 Workflow 运行、聊天、Web App/text-generation 等表面映射为 24 个 locale 的本地化消息，未知错误保持原样。
- 修复验证：020/021 最终 Web 组合 7 个 spec、70 个测试通过；Dify API admission/node 18 个测试通过；全量 Web TypeScript 检查及目标 locale ESLint 通过。真实 Workflow 正向召回仍待部署后验证。
### KF-BUG-022：created after/before 过滤器保存后静默丢失
- 严重度：P1 / Major
- Linear：[WTA-1956](https://linear.app/dify/issue/WTA-1956)，High，Backlog
- 步骤：输入 `2026-01-01T00:00` 和 `2026-12-31T23:59`，等待自动保存并刷新。
- 实际：输入立即可见；刷新后两个字段为空，导出 DSL 也没有 `created_after/created_before`。其他 filter 同批正常保存。
- 影响：用户以为时间范围生效，实际检索未应用，可能返回超出预期的数据。
### KF-BUG-023：最后一个 node kind filter 无法取消选择
- 严重度：P2 / Normal
- Linear：[WTA-1955](https://linear.app/dify/issue/WTA-1955)，Medium，Backlog
- 步骤：选择 `section` 与 `table`，再逐个取消。
- 实际：可以从两项减少为一项，但最后一项重复鼠标点击、键盘 Space、刷新后再点击都保持 checked。
- 影响：用户无法恢复为“不限制节点类型”，只能重建/修改 DSL。
### KF-BUG-024：未解析 KnowledgeFS 空间在草稿中无持久警告，发布才暴露原始英文错误
- 严重度：P2 / Normal
- Linear：[WTA-1957](https://linear.app/dify/issue/WTA-1957)，Medium，Backlog
- 实际：DSL 导入成功，空间显示为原始 UUID 和 `— · Top K — · 重排 —`，检查清单仍为 0；直到发布才显示英文 `KnowledgeFS Spaces are missing or inactive...`。
- 影响：导入/迁移后的不可用引用难以及早发现，发布反馈未本地化且直接暴露内部 control-space ID。
## 6. 自动化回归
### Web
```text
Test Files 6 passed (6)
Tests 22 passed (22)
```
其中 16 项为 v2 直接断言：v2 目录 5 个 spec 共 15 项，加节点元数据 hook 中 1 项 feature-gate 断言；同一 hook spec 的其余 6 项是通用节点元数据用例。覆盖节点注册/feature gate、默认值、card、panel、config helpers、use-config；均使用 mocked query/provider 和 happy-dom，不证明真实新增节点生命周期、发布 binding 或 KFS upstream。
### Dify API
```text
265 passed, 3 warnings in 25.87s
75 passed in 18.88s
```
前一组覆盖 v2 node、publish binding event、admission、app binding management、app execution/capability、broker、DTO、product operations、runtime 与 controller；后一组覆盖 product remote HTTP 的网络、状态码、media type、JSON、大小和资源关闭合同。它们验证 10/11 空间、`auto` 拒绝、多空间排序/并发、空结果、绑定原子同步、JSON `/retrieval-tests` transport；capability/remote 仍为 fake、mock HTTP 或进程内边界。
### KF-BUG-020/021 修复专项
```text
KF-BUG-020 broader Web 9 spec / 27 tests passed
020/021 final Web 7 spec / 70 tests passed
020/021 final API 18 tests passed
Web type-check passed
Target locale lint passed
```
020 的回归覆盖首次 history 初始化与后续 history 新引用，证明子树不再因正常保存而卸载。021 的回归覆盖独立开关保存、失败回滚/重试、四类 admission 错误、稳定 marker 和所有用户运行表面的本地化映射。它们是代码层修复证据，不改变 WF2-002、026、032～034 的原始浏览器结果，也不解除 15 个 `ENV-BLOCKED` 和 3 个规格/实现阻塞。
## 7. 清理与环境恢复
- QA 空间 API Access 已恢复为 `未启用`。
- 临时 Workflow App API key 已删除；删除后同 key 请求返回 HTTP 401。
- `ceshi` 最终关联应用恢复为 1，测试 Workflow 最终重新发布为只引用 `ceshi`。
- 未删除任何既有知识库、文档、数据源或检索记录。
- 保留 3 个名称明确的合成 Workflow，便于研发直接复现；未解析空间 Workflow 保持未发布。
- 工作区模型消息额度仍显示 0；但本轮 Workflow 的 `not bound` 发生在 Dify 侧 app admission 阶段、早于 KFS remote/retrieval/model 执行，因此模型额度不是这些失败的成因。
## 8. 发布门禁建议
1. KF-BUG-020/021 已完成代码修复；发布前先部署，再用真实 Chrome 验证新增任意节点后等待超过 history 保存窗口仍不白屏，并用新的 Workflow Access 开关完成草稿、单步、Web App、Service blocking/streaming 正向召回。
2. KF-BUG-022 仍是发布风险；修复后必须用刷新、导出 DSL 和真实 filtered retrieval 三重验证，而不是只断言输入框。
3. 在部署后分别制造 missing binding、channel disabled、permissions not ready、space inactive，确认所有运行表面都展示对应的本地化错误且不泄露内部信息。
4. 建立登录态 Playwright/Cucumber E2E：创建 Workflow → 添加 v2 → 选择空间 → 发布 → Web/Service 运行 → 断言 marker/citation → 撤权后立即失败。
5. KFS upstream 断言必须明确为 JSON `retrieveEvidence`；Dify Service API 可以使用 SSE 包装 Workflow 事件，但这不是 KFS `/queries` SSE。
6. 补齐 `KNOWLEDGE_FS_BASE_URL` 缺失时的节点级错误映射回归，确保所有运行表面得到受控 unavailable，而不是未捕获异常或 generic 500。

75
test-results/knowledge-fs/2026-08-11/test-data/kf-wf-v2-live-ceshi.yml Normal file
View File

@ -0,0 +1,75 @@
app:
description: Knowledge Retrieval v2 live QA workflow using the existing ceshi KnowledgeFS space.
icon: 📗
icon_background: '#E4E7FF'
mode: workflow
name: KF-WF-V2-LIVE-CESHI-20260811
use_icon_as_answer_icon: false
dependencies: []
kind: app
version: 0.3.1
workflow:
conversation_variables: []
environment_variables: []
features: {}
graph:
edges:
- data:
sourceType: start
targetType: knowledge-retrieval-v2
id: start-source-retrieval-target
source: start
sourceHandle: source
target: retrieval-v2
targetHandle: target
type: custom
- data:
sourceType: knowledge-retrieval-v2
targetType: end
id: retrieval-source-end-target
source: retrieval-v2
sourceHandle: source
target: end
targetHandle: target
type: custom
nodes:
- data:
desc: Synthetic query used only for Knowledge Retrieval v2 functional testing.
title: Start
type: start
variables:
- label: query
required: true
type: text-input
variable: query
id: start
type: custom
- data:
control_space_ids:
- 019fac9f-bfb0-75ee-9af5-252ebafbac1c
desc: Existing ceshi KnowledgeFS space; no destructive changes.
mode: fast
query_variable_selector:
- start
- query
title: KnowledgeFS Retrieval v2
top_n: 5
type: knowledge-retrieval-v2
id: retrieval-v2
type: custom
- data:
desc: ''
outputs:
- value_selector:
- retrieval-v2
- result
value_type: array[object]
variable: evidence
title: End
type: end
id: end
type: custom
viewport:
x: 0
y: 0
zoom: 1

74
test-results/knowledge-fs/2026-08-11/test-data/kf-wf-v2-unresolved-space.yml Normal file
View File

@ -0,0 +1,74 @@
app:
description: Knowledge Retrieval v2 publish validation with an unresolved synthetic space.
icon: 📗
icon_background: '#E4E7FF'
mode: workflow
name: KF-WF-V2-UNRESOLVED-20260811
use_icon_as_answer_icon: false
dependencies: []
kind: app
version: 0.3.1
workflow:
conversation_variables: []
environment_variables: []
features: {}
graph:
edges:
- data:
sourceType: start
targetType: knowledge-retrieval-v2
id: start-source-retrieval-target
source: start
sourceHandle: source
target: retrieval-v2
targetHandle: target
type: custom
- data:
sourceType: knowledge-retrieval-v2
targetType: end
id: retrieval-source-end-target
source: retrieval-v2
sourceHandle: source
target: end
targetHandle: target
type: custom
nodes:
- data:
desc: ''
title: Start
type: start
variables:
- label: query
required: true
type: text-input
variable: query
id: start
type: custom
- data:
control_space_ids:
- 00000000-0000-0000-0000-000000000000
desc: Synthetic unresolved KnowledgeFS control space; no real data is touched.
query_variable_selector:
- start
- query
title: KnowledgeFS Retrieval v2
top_n: 5
type: knowledge-retrieval-v2
id: retrieval-v2
type: custom
- data:
desc: ''
outputs:
- value_selector:
- retrieval-v2
- result
value_type: array[object]
variable: evidence
title: End
type: end
id: end
type: custom
viewport:
x: 0
y: 0
zoom: 1