UI DESIGN LAB
  • 首页
  • 社区
  • 资源库
  • 知识库
  • 文档
EN登录

文档文章

平台与维护
网站概述功能开发与版本更新记录关于协作
Template 库
Prompt 看板Style 看板
Agent 工作流
Agent 深度解析项目创作页与 Agent 工作流Agent 输出链路Prompt Agent EvalsDesign System PanelsKnowledge Base GuideDeepSeek Agent 故障复盘
UI DESIGN LAB文档中心

公开阅读 Markdown 文档,管理员可进入编辑页维护。

Knowledge Base Guide

Knowledge Base Guide

说明独立知识库、社区审核和 Agent RAG 接入规则。

返回文档中心

章节预览

Product BoundaryKnowledge Entry ShapeRAG FlowGeneration RuleAdmin WorkflowConfiguration

Knowledge Base Guide

The real community knowledge base lives at /knowledge. Docs keeps this guide only so product, engineering, and admin users can understand how knowledge entries flow into Agent generation.

Product Boundary

  • /knowledge stores community-submitted design principles, page patterns, accessibility guidance, and Agent directives.
  • /docs stores platform documentation, operating notes, and usage guidance.
  • Draft, review, private, rejected, and archived knowledge never enters public Agent generation context.
  • Only published public knowledge can be retrieved by RAG.

Knowledge Entry Shape

Each knowledge entry has:

  • Title, slug, category, tags, status, visibility, author, quality score, and published timestamp.
  • A versioned body with bilingual summary, principle, apply/avoid scenarios, Agent directive, and retrieval queries.
  • Published chunks used for full-text and embedding retrieval.
  • RAG event logs that record which chunks were used by which workflow stage.

RAG Flow

  1. A user starts a workflow from the creation page.
  2. The workflow loads selected Skills.
  3. Sable also acts as the knowledge retrieval manager.
  4. The retrieval query is built from the user brief, requirement summary, selected Skills, page type, and asset summaries.
  5. If embedding is configured, pgvector retrieves top matching published chunks.
  6. If embedding is unavailable or fails, the system falls back to full-text and keyword scoring.
  7. The workflow keeps 4-8 compact hits with title, summary, principle, Agent directive, and source ID.
  8. Cleo, Isolde, Sable, and Orson read those constraints during planning and QA.

Generation Rule

Knowledge is not page copy. Agents must transform retrieved principles into layout, component, interaction, accessibility, and responsive constraints. The visible page should never quote agent_directive verbatim unless the user explicitly asks to build a knowledge/detail surface.

Admin Workflow

  • Community users save drafts and submit review.
  • Admins publish, reject, archive, or rebuild chunks.
  • Publishing syncs the current version into knowledge_chunks.
  • Rebuilding chunks refreshes retrieval material and optionally embeddings.

Configuration

Embedding is optional for the first version.

  • EMBEDDING_API_KEY
  • EMBEDDING_BASE_URL
  • EMBEDDING_MODEL

When these are missing, published knowledge remains searchable through the fallback retrieval path.