FAQ

常见问题

这里回答反复被问到的问题;找不到的,欢迎在 联系我们 或 Gitee Issue 提问。

Known 是什么?和 Retool / NocoBase 有什么不同?

Known 是插件化的 .NET 10 低代码平台。核心差异在同步包 + 三方合并: 建模变更以差量包下发到开发者本地代码,与手写代码做三方合并、手写 custom 区永不覆盖。 Retool/NocoBase 走运行时托管或整表覆盖重生成,代码逃生通道薄;Known 把"代码归你"作为底线之一。

框架开源、Studio 商业,边界怎么划?

框架 Known 走 Apache-2.0, 永久无功能墙——插件架构、组件库、元模型、同步包协议全开源。 Studio(可视化建模器、订阅计费、团队协作、企业 SSO 与审计)是商业 SaaS,两者分层清晰、代码不共享。 详细条款见 开源与商业授权。

为什么不直接用第三方 UI 框架(Ant Design Blazor / MudBlazor)?

组件库全部自研,覆盖布局、基础、表单、数据展示、反馈、媒体、设备、页面、AI 九大类共 122 个组件, 配 477 个内联 SVG 图标,零外部请求, 继承同一 BaseComponent、参数命名与深浅色主题一体化。这样做工程成本更高, 但换来的是"框架即产品"、无版本漂移、无上游破坏性变更风险,也让同步包能精确描述"哪个组件的哪个属性"。

Blazor WASM 还是 Blazor Server?运行时选哪个?

Studio 应用侧当前以 WASM 为主、后端走 Known.Studio.Web;框架组件本身 Server/WASM 两端通用 (组件不依赖 HttpContext)。营销官网是第三种形态——静态 SSR, AddRazorComponents() 不挂 interactive 渲染模式,纯服务端预渲染 HTML、零 JS 电路。

身份与登录放在哪?为什么不建 auth 子域?

SB-02 定案:身份落在 app.known.org.cn 同进程的 /Account/* endpoints + OIDC, Cookie 域 .known.org.cn 全站 SSO。营销站不落业务 Cookie、也不建 auth.known.org.cn 跳板; 登录入口直链 app.known.org.cn 授权端点。

建模变更怎么落到开发者本地代码?

走"同步包":MANIFEST + 三态文件(Generated / Mixed / Custom)+ 三方合并。 Generated 区完全由 Studio 出码;Custom 区归你手改;Mixed 区合并时按行做三方 diff。 CLI 命令:known-codegen sync apply <package>。冲突时 CLI 停下报错、绝不做静默覆盖。 细节见 同步包机制。

能不能纯用 CLI、完全不打开 Studio?

可以,这是产品的一条底线:CLI 出码永久免费、逃生通道永远不封。 Studio 是可选的可视化加速层;Schema 是纯文本(JSON),版本控制走 Git; Linux 部署指南 里的示例就是纯 CLI + systemd。

Free / Personal / Team / Enterprise 差别在哪?

四档不藏功能、只砍配额:Free 每项目累计 3 次同步包;Personal 单人无限同步包 + 邮箱支持; Team 加同步包审批流 + 审计日志 + 席位配额;Enterprise 加私有部署 + SSO + 定制 SLA。 详见 定价页 与 SLA。

模板市场(/templates)与"网站模板"是一回事吗?

不是。这里的"模板"指 Studio 项目模板:新建 Known 应用时可选的骨架(订单系统、CRM、审批流等), 含 Schema + 组件绑定 + 数据层;不是网站主题或落地页皮肤。 未来支持第三方开发者付费上架,详见 插件式模块架构。

什么时候会有 v1.0 GA?

Batch 0 地基(SB/RT/CG/IN)完成后进入 Batch 1 MVP;Batch 2 公开 Beta;Batch 3 团队版;Batch 4 企业版;Batch 5 生态。 具体切片进度看 路线图,发布流水看 更新日志。 时间线不做承诺,只看 Batch 门槛。

想参与贡献、报 Bug、提建议?

框架侧:Gitee Issue · PR; Studio 产品侧:联系我们; 商业合作 / 私有部署:Enterprise 档。

微信公众号二维码 扫码关注公众号
QQ 交流群二维码 扫码加入 QQ 群