docyrus-platform

Docyrus 平台

Docyrus 是一个 AI 原生后端平台即服务（BPaaS），用于构建 B2B Web/移动应用、客户门户、内部工具、AI Agent、聊天机器人和集成，无需从头搭建后端基础设施。此技能是架构地图：介绍各个构建模块、它们如何组合，以及每种操作指南对应哪个专用技能。

核心构建模块

平台由可组合成应用的构建模块组成：

• 应用 — 顶层容器，将数据源、自动化、Agent 和自定义查询归入一个可部署单元。
• 数据源 — 具有类型化架构的结构化记录集合。分为四种类型：简单、高级、外部（已连接的数据库/API）和系统（预构建）。每个数据源——无论内部还是外部——都通过统一的 CRUD 端点公开。
• 字段 — 45+ 种字段类型，用于定义每个数据源的架构：文本、数字、日期、选项、关系、文件、公式、嵌套数据等。
• 枚举 — 可复用的选项集，供选择字段使用（颜色、图标、排序）。
• 自定义查询 — 基于 SQL 的分析模板，支持变量插值、运行时筛选和多数据库目标。
• 自动化 — 事件驱动的工作流：触发器（记录变更、计划任务、Webhook、电子邮件、Web 表单、按钮）→ 操作节点链（电子邮件、通知、记录操作、HTTP、AI、脚本）。

详细的构建模块规范：references/core-building-blocks.md。

各类任务对应的技能

此技能介绍概念。如需执行操作，请使用相应的专用技能：

目标…	使用技能
设计数据源（架构、字段、关系、枚举、访问权限）	docyrus-data-source-design
构建自动化（触发器 + 操作节点图）	docyrus-automation-design
构建自定义 AI Agent + 其子资源	docyrus-agent-design
编写系统基础 Agent（“Docy”）调用的 AI 工具	docyrus-app-ai-tools
设计电子邮件模板	docyrus-email-template-design
设计 HTML/PDF 打印/报告模板	docyrus-print-pdf-template-design
构建可将提交内容收集为记录的公共 Web 表单	docyrus-webform-design
设计数据源记录的创建/编辑/查看表单（网格、分区、条件规则）	docyrus-dynamic-form-design
配置租户 ACL（角色、层级单位、角色规则）	docyrus-acl-design
发现并调用第三方集成/连接器（docyrus connect）	docyrus-integrations-and-connectors
查询/执行数据 CRUD、编写筛选条件/公式、构建查询负载	docyrus-api-dev
编写 DSQL（逻辑 SQL）查询，或使用自然语言执行 dsql ask	docyrus-dsql-query-design
通过终端完成所有操作（身份验证、ds、studio、automation、agent 等）	docyrus-cli-app
在 Docyrus 上构建 React 应用（集合、网格、表单）	docyrus-app-dev-react、docyrus-data-grid-page-design、docyrus-record-detail-form-design

功能领域（概念）

查询与数据操作

统一查询引擎：列选择、50+ 种筛选运算符、聚合、公式、透视、子查询、全文搜索；支持完整 CRUD、批量操作、评论和附件；另提供一个针对 appSlug.dataSourceSlug 表的只读逻辑 SQL 端点（DSQL）。概念概览：references/querying-and-data-operations.md。 → 查询负载和公式：docyrus-api-dev。DSQL（逻辑 SQL、dsql ask）：docyrus-dsql-query-design。通过终端查询：docyrus-cli-app。

AI 功能

AI Agent 构建器支持工具绑定、知识库、MCP 服务、18+ 种模型提供商、Agent 链接、任务调度、持久化记忆、聊天集成和评估指标。概念概览：references/ai-capabilities.md。 → 构建 Agent：docyrus-agent-design。编写 Docy 调用的工具：docyrus-app-ai-tools。

自动化与工作流

事件驱动的自动化引擎：触发器类型和操作节点类型、条件流程、操作链、归档。概念概述：references/automation-and-workflows.md。 → 构建自动化：docyrus-automation-design。

身份验证与多租户

OAuth2 流程（PKCE、Client Credentials、Device Code）、基于范围的权限、租户隔离、基于角色和记录级别的 ACL、React 身份验证辅助工具，以及客户端门户。概念概述：references/auth-and-multi-tenancy.md。 → 配置 ACL：docyrus-acl-design。在应用代码中使用 OAuth：docyrus-api-dev。

集成与事件

用于 HTTP 和 SQL 提供方的连接器框架、Webhook/事件管理、连接器发现、协作文档编辑、应用内消息、通知和电子邮件。概念概述：references/integrations-and-events.md。 → 发现并使用连接器（docyrus connect）：docyrus-integrations-and-connectors。Webhook/消息 CLI：docyrus-cli-app。

平台服务

应用模板、数据导入/导出、报告与分析、部署与版本控制、本地化与导航、审计日志和计费。概念概述：references/platform-services.md。 → 公共数据收集 Web 表单有专属技能：docyrus-webform-design。

开发者工具

自动生成的 OpenAPI 规范、MCP 服务、功能齐全的 CLI、REST API 客户端库、React 身份验证提供方，以及自动生成的集合钩子。概念概述：references/developer-tools.md。 → 完整的 CLI 命令索引：docyrus-cli-app（使用 docyrus <cmd> --help 查看标志）。REST 客户端 + 查询载荷 + 公式：docyrus-api-dev。