3文档

开始

术语表

全站统一的用词。文档、官网、产品界面和命令行说明都按这张表写。

产品与角色

用词 说明
NocoBase Core 开发和运行业务系统的开源底座,一组 npm 包
NocoBase Studio 人带领 Agent 团队开发应用的工作台,在商业版中提供
NocoBase Solutions 基于 NocoBase 开发的开源业务应用,例如 NocoCRM、NocoITAM
Agent AI 执行者的统称。一个编码工具加一个模型,例如“Claude · Opus 5.5”。不用“智能体”“代理”“Coding Agent”
编码工具 Claude Code、Codex、OpenCode、Cursor 等
业务 Agent 在应用里、按权限处理业务的 Agent,由 Agents 插件接入。NocoBase 2 中称“AI 员工”
开发 Agent 编写应用代码的 Agent。只在需要和业务 Agent 对比时使用,其余地方直接写 Agent

Core

用词 说明
应用 用 NocoBase 模板创建的一份代码仓库,部署后是一个业务系统。归你所有
模板 创建应用的起点:默认模板、示例模板
插件 注册进应用的 @nocobase/app-plugin-* 包,带来服务端能力、页面、UI 组件、技能或命令
插件清单 应用里登记插件的三个文件:server/plugins.ts、client/plugins.ts、cli/plugins.ts
基础库 应用直接使用、不需要注册的包,例如记录生命周期、数据库
UI 组件库 NocoBase 发布的业务组件,安装时复制进应用源码,之后归应用所有。单个叫“组件”或“区块”
技能 教 Agent 怎样做事的说明(SKILL.md)。随包发布的技能同步到应用的 .agents/skills/
能力 Core 提供的一类功能,按「应用底座」的 13 类划分
系统设置 应用里的管理入口:用户管理、角色与权限、流程管理、应用底座等
应用底座 默认模板自带的页面,显示应用用到的 Core 能力和提供它们的包
记录生命周期 记录的状态保存在它自己的字段里,状态之间的流转在代码里声明。NocoBase 3 的流程都建在它上面
流程参数 管理员在「流程管理」里可以调整的值,例如审批人、金额阈值
权限集 一组页面、操作和数据范围的授权,分配给角色或人。界面上叫“角色”
数据范围 一项操作能作用于哪些记录,例如“本人负责的订单”
迁移 改变数据库结构的代码文件,按顺序执行,执行过的不再修改
config.yml 应用的部署配置:数据库、存储、密钥、后台任务等。不进代码仓库

Studio

用词 说明
任务 Studio 里交付工作的基本单位。不用“工单”“需求单”
任务负责人 对任务结果负责的人,总是人
调度 Agent 全局唯一的系统 Agent,拆分步骤、分派、提问、交付验收,不写代码
执行 Agent Agent 团队里完成具体步骤的 Agent
我的 Agent 你自己用的编码工具,例如 Claude Code、Codex。接入 Studio 后,在「我的会话」里和你讨论需求
Agent 团队 团队启用的全部 Agent
运行环境 运行 nocobase-runner 的机器,分共享和个人两种
我的任务、我的会话 两种跟进工作的入口:按任务、按会话
项目记忆 Agent 在工作中记下的经验,存进代码仓库,由 Agent 自己读写
知识库 人写和上传的资料,Agent 只读
交付报告 调度 Agent 在任务进入待验收时提交
待规划 / 进行中 / 阻塞中 / 待验收 / 已完成 / 已取消 任务的六个固定状态

Studio 的完整用词见 Studio 的 核心概念。

写法

  • 界面上的名称、按钮、菜单用「」括起来,与中文界面一致;路径写成「A › B」。
  • 中文与英文、数字之间加一个空格。
  • 代码里的名称(包名、文件名、命令)用代码格式,只在需要时出现。
NocoBase 3 文档 · 草稿 2026-10-24