✨ Feature(aidp): refactor knowledge base list and creation pages

[cj2026-bit]

Problem

1. The AIDP knowledge base page used a two-column layout: the knowledge base list on the left and the selected base's files on the right. The overview had no card view, no column setting and no usage guide, so the list was hard to scan and file management was buried in the same screen.
2. Creation happened in a modal that exposed only name, description, permission, captioning and chunk tokens. The AIDP create contract accepts a chunking mode, retrieval parameters, an embedding model choice, a full knowledge graph configuration and a safety guard, none of which the UI could submit.
3. The document download and delete entries disappeared from the AIDP file list during the v2.6.1 merge: the backend endpoints, the frontend service methods and both locales were intact, but nothing called them any more.

Fix

Overview (AIDP only)

• Split the page into an overview and a full-page file view that replace each other inside the existing AIDP component. Entering a knowledge base clears the previous base documents and its upload watch; returning restores the search text, page, view mode and column setting.
• Added a collapsible guide with the three documented steps, and an overview that defaults to cards and can switch to a table over the same server-paginated result set.
• The table exposes a column visibility setting (name and actions always visible, restore defaults). Search stays the single existing name search; no column filters were added.
• Display metadata is never fabricated: the personal/enterprise type comes from the AIDP is_private field, capacity only from a valid current_cap, the creator only from a real display name, and the backend now marks whether a document count is a confirmed statistic. Unknown values render as an em dash.

Creation page

• New route /knowledges/create renders a dedicated two-step page. The first step groups basic information, permission and user groups, the safety guard, the knowledge graph, chunking, vector generation and retrieval; the second step optionally uploads files.
• The next step only validates locally. The knowledge base is created once at the final submission and files are uploaded only after a successful create, so a failed upload never recreates it.
• New fields are submitted end to end: chunk_mode (0 smart splitting / 1 legal clauses), a 256-4096 chunk token range, an overlap ratio converted to floor(tokens * percent / 100) integer tokens, similarity, knowledge base Top K, the embedding model, the graph model from the llm category, the multimodal model from the vlm category, the full graph configuration and the safety guard. Disabling a capability omits its hidden configuration instead of resubmitting it.
• The backend validates the structured graph configuration, serializes it into the documented graph_config string, and rejects an overlap above half the chunk size.

Safety guard

• sensitive_intercept_enalbe is submitted as integer 1/0 on create, forwarded explicitly when disabled on update (the metadata whitelist would otherwise drop the 0), and read back in the edit dialog. A response that omits the field is shown as unknown, never as a confirmed disabled state.

Restored file operations

• The file table has an actions column again: download for read access and delete with confirmation for edit access, both hidden for read-only or unavailable knowledge bases.

Scope

• The ES knowledge base path is untouched: no ES component, service, endpoint or locale entry was modified.

Verification

• Backend: pytest test/ext_components/aidp/ — 597 passed.
• Frontend: tsc --noEmit reports zero errors in the changed AIDP sources, types and locales (run against the same dependency versions as the main checkout).
• Formal test assets: requirement, feature and 26 D1-D5 cases added; python test/tools/validate_test_assets.py --phase design --generate-excel passes.
• Local end-to-end against the AIDP mock in full deployment mode:
  • Overview renders the guide, the card view, the table view with all eight columns, card counts and capacity placeholders; the file view opens, lists documents with the restored download/delete actions, and returning keeps the table view.
  • The creation page renders both steps with the documented defaults (1024 tokens, 12.5% overlap, smart splitting) and its validation blocks the next step while the name or the group selection is invalid.
  • Create API: the upstream payload carries chunk_mode, a serialized graph_config string whose no_think_mode is inverse to the thinking switch, llm_model_name, integer sensitive_intercept_enalbe, and keeps every legacy field and default.
  • Graph disabled: the payload omits graph_config and llm_model_name while still submitting the explicit 0 safety guard.
  • Update API: metadata_status: updated for the safety guard change.
  • Model queries return per category (llm, vlm, embedding).
• Two browser-only defects were found and fixed during this verification: the new locale entries used single-brace placeholders, which i18next does not interpolate (cards rendered 文件 {count}); they now use {{count}}.

Not covered: the upstream safety guard contract is still under development on the AIDP side, so a real create/update/readback of that field can only be verified after it ships — the mock accepts the field but does not store it. Browser automation could not exercise the column settings popover, the search input and the upload step (the available in-app browser exposes no reliable locator or mouse API for Ant Design portaled widgets); those paths were reviewed in code and the surrounding flows were verified end to end.

[codecov]

Codecov Report

❌ Patch coverage is 86.57718% with 20 lines in your changes missing coverage. Please review.

Files with missing lines	Patch %	Lines
...ckend/ext_components/aidp/services/aidp_service.py	81.48%	11 Missing and 4 partials ⚠️
backend/ext_components/aidp/apps/aidp_mgmt_app.py	92.64%	2 Missing and 3 partials ⚠️

📢 Thoughts on this report? Let us know!