Skip to content

重构(knowledge-pipeline): Knowledge / Dashboard 二级导航更名为 Pipeline 全链路对齐 - #482

Closed
ThreeFish-AI wants to merge 1 commit into
feature/1.x.xfrom
ThreeFish-AI/rename-dashboard-to-pipeline
Closed

重构(knowledge-pipeline): Knowledge / Dashboard 二级导航更名为 Pipeline 全链路对齐#482
ThreeFish-AI wants to merge 1 commit into
feature/1.x.xfrom
ThreeFish-AI/rename-dashboard-to-pipeline

Conversation

@ThreeFish-AI

Copy link
Copy Markdown
Owner

背景

Knowledge 模块二级 tab Knowledge Base / Knowledge Graph / Catalog / Wiki / Documents / APIs / Dashboard 中只有 Dashboard 是泛化容器名,与同模块兄弟 (均为领域名词) 命名风格不一致;该页面主轴是 Pipeline Runs 列表 + 指标 + Alerts,命名与功能事实漂移。本 PR 全栈一次性改名为 Pipeline,无 backward-compat alias (遵循 AGENTS.md "Single Source of Truth")。

变更摘要

后端契约

  • schemas.py: DashboardResponsePipelineSummaryResponse
  • api.py: GET /knowledge/dashboard get_dashboard()GET /knowledge/pipeline get_pipeline_summary()

前端调用链

  • features/knowledge/utils/knowledge-api.ts: KnowledgeDashboard 类型 → KnowledgePipelineSummaryfetchDashboard()fetchPipelineSummary();URL /api/knowledge/dashboard/api/knowledge/pipeline
  • features/knowledge/index.ts: re-export 同步

目录搬迁与导航

  • app/api/knowledge/dashboard/pipeline/ (git mv 保留历史)
  • app/knowledge/dashboard/pipeline/ (git mv 保留历史)
  • 删除 app/knowledge/pipelines/page.tsx 旧 redirect 占位
  • KnowledgeNav.tsx NAV_ITEMS: dashboard 项 → pipeline + Pipeline 标签
  • 页面组件 KnowledgeDashboardPageKnowledgePipelinePagetitle="Dashboard"title="Pipeline"

测试与视觉快照

  • tests/unit/knowledge/DashboardPage.test.tsx git mv 为 PipelinePage.test.tsx + 内部 mock / fixture 全量改名
  • KnowledgeNav.test.tsx 路由 + 断言改名
  • tests/helpers/knowledge.ts mock helper 改名
  • E2E smoke.spec.ts: route mock / goto / toHaveScreenshot 文件名 / 局部变量改名
  • 视觉快照 PNG git mv 为新文件名 (截图区域只取 Pipeline Runs panel,文案不变,基线视觉一致)

文档

  • docs/user-guide.md: 路由表 + 章节标题改名;删除已不存在的 /knowledge/pipelines 旧 redirect 行
  • docs/knowledges.md: Knowledge API 描述同步
  • docs/issue.md: 新增 ISSUE-078 档案
  • CHANGELOG.md: 顶部新增改名条目

严格不动

  • Memory /api/memory/dashboard (语义合理)
  • Interface Dashboard tab (Admin/Models 总览)
  • docs/issue.md / CHANGELOG.md 历史条目里的旧路径引用 (档案性质)
  • fetchPipelines / KnowledgePipelinesPayload / PipelineRunRecord / PipelineRunCard 等 runs 维度概念 (正交不变)

验证

  • pnpm typecheck 通过
  • pnpm lint 通过
  • 单元测试 18/18 通过 (PipelinePage.test.tsx 17 例 + KnowledgeNav.test.tsx 1 例)
  • ruff check src/negentropy/knowledge/ 通过
  • 后端 test_api_pipelines.py 5/5 通过
  • 全局 grep 旧标识 0 命中 (除 Memory MemoryDashboardResponse 与 docs 历史档案)

测试计划

  • CI: pnpm typecheck && pnpm lint && pnpm test
  • CI: uv run pytest tests/unit_tests/
  • CI: Playwright E2E smoke -g "Knowledge Pipeline" 视觉基线匹配
  • 手动:浏览器访问 /knowledge/pipeline 应正常渲染;/knowledge/dashboard 返回 404

关联

详见 docs/issue.md ISSUE-078

🤖 Generated with Claude Code, CodeX, Gemini

…全链路对齐;

Knowledge 模块二级 tab "Dashboard" 是泛化容器名,与同模块兄弟 (Knowledge Base /
Knowledge Graph / Catalog / Wiki / Documents / APIs,均为领域名词) 命名风格不一致;
该页面主轴是 Pipeline Runs 列表 + 指标 + Alerts,命名与功能事实漂移。本次全栈
一次性改名,无 backward-compat alias (遵循 AGENTS.md "Single Source of Truth")。

后端契约
- schemas.py: DashboardResponse → PipelineSummaryResponse
- api.py: GET /knowledge/dashboard get_dashboard() →
  GET /knowledge/pipeline get_pipeline_summary()

前端调用链
- features/knowledge/utils/knowledge-api.ts: KnowledgeDashboard 类型 →
  KnowledgePipelineSummary; fetchDashboard() → fetchPipelineSummary();
  URL /api/knowledge/dashboard → /api/knowledge/pipeline
- features/knowledge/index.ts: re-export 同步

目录搬迁与导航
- app/api/knowledge/dashboard/ → pipeline/ (git mv 保留历史)
- app/knowledge/dashboard/ → pipeline/ (git mv 保留历史)
- 删除 app/knowledge/pipelines/page.tsx 旧 redirect 占位
- KnowledgeNav.tsx NAV_ITEMS: dashboard 项 → pipeline + Pipeline 标签
- 页面组件 KnowledgeDashboardPage → KnowledgePipelinePage;
  title="Dashboard" → title="Pipeline",描述同步

测试与视觉快照
- tests/unit/knowledge/DashboardPage.test.tsx git mv 为 PipelinePage.test.tsx +
  内部 KnowledgeDashboardPage / fetchDashboardMock / primeDashboardMock /
  DEFAULT_DASHBOARD 全量改名
- KnowledgeNav.test.tsx 路由 + 断言改名
- tests/helpers/knowledge.ts mock helper 改名
- E2E smoke.spec.ts: route mock / goto / toHaveScreenshot 文件名 / 局部变量改名
- 视觉快照 PNG git mv 为新文件名 (截图区域只取 Pipeline Runs panel,文案不变,
  基线视觉一致)

文档
- docs/user-guide.md: 路由表 + 章节标题改名;删除已不存在的 /knowledge/pipelines
  旧 redirect 行
- docs/knowledges.md: Knowledge API 描述同步
- docs/issue.md: 新增 ISSUE-078 档案
- CHANGELOG.md: 顶部新增改名条目

严格不动
- Memory /api/memory/dashboard (语义合理)
- Interface Dashboard tab (Admin/Models 总览)
- docs/issue.md / CHANGELOG.md 历史条目里的旧路径引用 (档案性质)
- fetchPipelines / KnowledgePipelinesPayload / PipelineRunRecord /
  PipelineRunCard 等 runs 维度概念 (正交不变)

验证
- pnpm typecheck / pnpm lint 通过
- 18/18 单元测试通过 (PipelinePage.test.tsx 17 例 + KnowledgeNav.test.tsx 1 例)
- ruff check 通过;后端 5/5 API 测试通过

详见 docs/issue.md ISSUE-078。

🤖 Generated with [Claude Code](https://github.com/claude), [CodeX](https://openai.com), [Gemini](https://github.com/apps/gemini-code-assist)
Co-Authored-By: Aurelius Huang<threefish.ai@gmail.com>
@ThreeFish-AI
ThreeFish-AI deleted the ThreeFish-AI/rename-dashboard-to-pipeline branch May 10, 2026 04:18
ThreeFish-AI added a commit that referenced this pull request Jul 5, 2026
…-2026-4372 处置) (#1057)

* fix(deps): ts-deepmerge 补丁地板至 8.0.0 修复 GHSA-87mf-gv2c-c62c (#481);

🤖 Generated with [Claude Code](https://github.com/claude), [CodeX](https://openai.com), [Gemini](https://github.com/apps/gemini-code-assist)
Co-Authored-By: Aurelius Huang<threefish.ai@gmail.com>

* fix(negentropy): pydantic-settings 升 2.14.2 + joserfc>=1.6.7 补丁地板修复 #482/#488;

🤖 Generated with [Claude Code](https://github.com/claude), [CodeX](https://openai.com), [Gemini](https://github.com/apps/gemini-code-assist)
Co-Authored-By: Aurelius Huang<threefish.ai@gmail.com>

* fix(cognizes): joserfc/msgpack/python-socketio/python-engineio 补丁地板修复 #483/#486/#487/#490/#491;

🤖 Generated with [Claude Code](https://github.com/claude), [CodeX](https://openai.com), [Gemini](https://github.com/apps/gemini-code-assist)
Co-Authored-By: Aurelius Huang<threefish.ai@gmail.com>

* docs(perceives): ISSUE-092 增补 CVE-2026-4372 威胁模型;transformers 钉 4.x + dismiss #492(marker 5.x 不兼容实测);

🤖 Generated with [Claude Code](https://github.com/claude), [CodeX](https://openai.com), [Gemini](https://github.com/apps/gemini-code-assist)
Co-Authored-By: Aurelius Huang<threefish.ai@gmail.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant