NocoBase 动态元数据与无头数据库引擎
@nocobase/dsh-driver · v1.0.4
面向智能体业务持久化构建的无头数据库中间件。深度集成 NocoBase 开源元数据引擎，支持模型根据自然语言自动化设计表结构、生成动态 CRUD 接口与实施企业级细粒度权限控制。
无头数据库NocoBase数据建模REST API
GitHub Stars
32 K+
+12.4% this month
月度调用量
135 K+
Monthly registry pulls
Reach 影响力
98.3/ 100
Top Tier Ecosystem
运行环境
Cordis v3+
Node 18+ / Bun / Deno
安装与配置
支持 CLI 一键执行、包管理器以及 Cordis 总线编排
bash
manager:
$ pnpm add @nocobase/dsh-driver架构解析
「NocoBase Engine」让智能体具备全自动的数据库架构师能力。在构建全栈应用或处理复杂业务流时，智能体不仅要编写应用层代码，还需要设计底层关系型数据库并维护数据字典。
本插件通过标准化总线连接 NocoBase 的无头内核，提供声明式的数据建模工具。智能体无需手写脆弱的 SQL 脚本，即可动态创建集合（Collections）、建立外键关联、配置字段校验规则并暴露即用型 REST/GraphQL 接口，为自治系统提供坚固可靠的数据底座。
架构设计原则与约束
01
强类型契约隔离
基于 TypeScript 编译期深度推断，跨插件总线调用享受严格类型校验与零偏差提示。
02
毫秒级热插拔调度
支持微内核动态注册与安全平滑卸载，无需重启主宿主进程即可完成逻辑热替换。
03
确定性有限状态机
内置严谨的多阶段任务生命周期控制，防止复杂长时迭代推理场景中会话状态丢失。
04
零动态构建底层依赖
采用纯原生跨平台运行时环境设计，在 Node.js、Bun 及 Deno 容器中极速冷启动。
核心特性
01
无锁动态表结构设计：支持运行时随时扩展字段、修改关联关系而无需停机维护
02
开箱即用 REST/GraphQL：表结构定义完成瞬间即可通过标准 HTTP 接口调用
03
严格类型与业务级校验：自动施加正则表达式、唯一约束与默认值等安全防护
04
内置 RBAC 权限控制体系：支持细粒度到字段级的角色访问控制与审计日志
核心机制
01
数据需求语义推导
根据业务逻辑自动推导实体表、主外键关联与复合索引策略。
02
元数据动态迁移
调用 NocoBase 元数据引擎无锁创建数据集合，完成即时表结构同步。
03
REST 接口自动合成
自动挂载对应数据表的增删改查过滤 API 接口及 Swagger 契约。
04
数据操作与校验
执行安全参数格式化，防止 SQL 注入并确保业务约束完整性。
配置参数参考 (YAML / JSON)
| 参数名 | 类型 | 默认值 | 说明 |
|---|---|---|---|
| apiEndpoint | string | http://localhost:13000/api | 连接的 NocoBase 服务端 API 地址 |
| autoSyncSchema | boolean | true | 是否在模型决策后自动执行元数据迁移 |
| defaultDatabase | string | postgres | 底层连接的数据库类型 (postgres / mysql / sqlite) |
应用场景
企业级生产智能体运行时
依托微内核生命周期与容错状态机，保障企业复杂 Agent 全天候稳定执行不崩溃。
基准测试标准化评测运行
深度原生集成 SWE-bench 标准流程，自动化抓取代码变更并产出规范复现指标。
全自主代码工程重构演进
精准拆解模型思考流与具体操作，跨多文件自主排查并高质量完成大型模块重构。
跨系统多工具流协同自动化
在多进程沙箱间安全并发调度事件，打通研发上下游系统实现端到端自动化流转。
最佳实践
01
权限沙箱隔离机制
严格限定子进程系统调用与外部网络范围，在生产环境中建议结合 Docker 独立容器执行。
02
配置指数退避重试
针对上游模型接口限流与偶发网络抖动，建议开启自适应退避重试并设定最大执行上限。
03
长时任务状态快照
利用内核事件总线快照功能实时固化会话节点，发生不可抗意外时支持秒级断点恢复。
04
全量结构化链路追踪
开启全量 Trace 日志输出，将大模型思考过程与具体工具入参返回值集中汇聚至监控。
常见问题
Q1:长时间执行任务超时如何正确配置？
可在配置文件中调大 timeout 阈值，并通过生命周期钩子定期向总线派发心跳信号。针对长耗时推理与工具调用，建议配合持久化会话快照机制，在任务暂停或重启后无缝恢复执行上下文，避免会话被内核提前回收。
Q2:如何捕获并流式解析模型思考过程？
框架原生提供流式回调机制，会话状态机自动拦截并剥离大模型的 <think> 思考标签。开发者只需监听 onThink 事件即可实时获取推理增量，结合前端流式渲染呈现动效，并支持将完整推导链沉淀至审计日志。
Q3:多个插件依赖冲突时如何按需加载？
Cordis 微内核基于有向无环图进行拓扑排序并解析依赖树。当插件间存在同名服务或版本冲突时，可通过命名空间隔离机制按需挂载；结合上下文注入与惰性初始化技术，仅在工具唤起时动态加载资源，保障系统稳定。
Q4:生产环境中如何实施权限与沙箱隔离？
推荐结合容器沙箱与细粒度权限管控，严密禁止插件越权访问敏感文件与未授权外部网络。可通过微内核提供的权限白名单机制严格限制系统调用，并将工具执行环境置于隔离容器内，彻底阻断潜在的代码注入与提权安全风险。
相关生态插件推荐
为你推荐同分类及高度协同的 Cordis 扩展
storage61 K+
Weknora 知识图谱与混合检索 RAG 引擎
融合知识图谱（Knowledge Graph）与向量稠密检索的企业级混合 RAG 方案。支持长文本实体关系动态抽脂、多跳推理关联与多源异构文档分块，从根本上解决大模型问答幻觉。
View details
storage69 K+
PicGo 视觉资产托管与对象存储管道
打通智能体产物与主流云端对象存储的无缝资产分发管道。支持 AWS S3、Cloudflare R2、阿里云 OSS、腾讯云 COS 等数十种存储介质，具备哈希防重、CDN 预热与安全签名能力。
View details
storage67 K+
MemOS 持久记忆与跨会话情境图谱存储器
为智能体赋予类人长期情境记忆的持久化存储架构。采用三层记忆模型（工作记忆、情节记忆与语义图谱），支持经验知识跨会话继承、重要度自动加权与遗忘曲线管理。
View details