实战指南

把业务建模写成一份 JSON Schema，Known 在运行时直接把它渲染成列表、表单与增删改查——字段支持枚举下拉、外键下拉、一对多子表，页面可按 blocks 区块树所见即所发、并按 menu 驱动导航，还能按 layout 切换控制台 / 标签 / 上下 / 两栏 / 栅格五种布局；你要写的代码只剩后端的自定义业务逻辑（生命周期钩子）。

默认场景用运行时按 Schema 直接渲染即可、无需生成代码；当你想把实体/服务/页面当普通手写代码接管演进时，用 known build 把一份 JSON Schema 出成与手写完全同构的可增删改查代码。

从 AppLayout 到 AdminLayout / RailLayout / ShellLayout / Sidebar / TopBar / Container 的常见组合、外壳切换与断点策略。

Form + FormGroup + Validator 的字段校验、异步远程校验与错误呈现。

Table + PagingCriteria + PagingResult：服务端分页、列排序、条件筛选与批量操作的标准写法。

在应用里接入 Known 身份：Cookie SSO 面向人、Bearer 面向机器，两路互不越界。

用 Config.AddTopAction 一次声明，在 AdminLayout / TopBar 右上角挂出自定义按钮，支持命令、外链与锚定下拉面板，并可按角色显隐。

用 AppLayout 搭移动端母版，[AppMenu] 声明式注入底部 Tab，登录后按设备自动落到 /app。

dotnet publish → tar.gz → systemd + Nginx 完整链路；无 CI 也能一键上线。

侧栏的「开发中心」分组就是 Config.AddKnown 预声明的一个普通菜单分组，页面用 [Menu(Group = "development")] 直接挂进去；框架内置语言管理 / 在线用户 / 跟踪日志，宿主注入自定义项同样走 [Menu]。

Known 提供一份可从文档站直接下载的 Agent Skill，让 Claude / QoderWork 等编码智能体按框架约定写出能编译的 Known 代码。

known-ai 是一个只在 127.0.0.1 监听的本地小模型侧车（sidecar），用你自己机器的 CPU 推理，把业务描述变成运行时 Schema JSON。它不出码、不联网上传、产物就是文档里那份 schema.json，所以能免费给你用。

Known 在顶栏内置了一个智能体抽屉（AgentDrawer）——消息气泡、技能条、上下文条、发送框（附件 + 模型 + 语音）都在壳子里，宿主只需要登记一个实现 IAgentService 的服务，就能把一个真正能问的助手放进任何用 AdminLayout 的应用。