@nocobase/plugin-ai 2.1.0-alpha.26 → 2.1.0-alpha.27

package/dist/ai/docs/nocobase/ai/opencode/index.md

@@ -0,0 +1,106 @@
+---
+title: "OpenCode + NocoBase: Open Source, Free, Vendor-Unlocked NocoBase Building"
+description: "Connect the open-source AI coding assistant OpenCode to NocoBase, freely choose models, and use natural language to operate your business system."
+keywords: "OpenCode,NocoBase,AI Agent,open source,multi-model,Skills,CLI,natural language"
+sidebar: false
+---
+
+:::warning Content Under Development
+
+This page is still being written. Some sections may be incomplete or subject to change.
+
+:::
+
+# OpenCode + NocoBase: Open Source, Free, Vendor-Unlocked NocoBase Building
+
+[OpenCode](https://github.com/opencode-ai/opencode) is an open-source terminal AI Agent — supporting 75+ models (Claude, GPT, Gemini, DeepSeek, etc.), not locked to any vendor, letting you freely choose the best model for your needs. After connecting it to NocoBase, you can use natural language to create data tables, build pages, configure workflows, while maintaining full control over model selection and costs.
+
+<!-- Screenshot needed: OpenCode operating NocoBase in terminal -->
+
+## What Is OpenCode
+
+OpenCode is developed by Anomaly Innovations (GitHub 140k+ Stars), positioned as "a vendor-unlocked terminal AI Agent." Written in Go, it provides a beautiful TUI interface. Core features:
+
+- **75+ model support** — Claude, GPT, Gemini, DeepSeek, local models, and more — freely switch between them
+- **Zero vendor lock-in** — Bring your own API Key, pay by actual usage, no extra subscriptions needed
+- **Multi-Agent architecture** — Built-in Build, Plan, Review, Debug, and Docs Agent roles
+- **Privacy-first** — Doesn't store code or context, all data stays local
+
+OpenCode also supports integration with VS Code, JetBrains, Zed, Neovim, and other editors, as well as a standalone desktop application.
+
+## Why Choose OpenCode
+
+If you're deciding which AI Agent to use for operating NocoBase, here are the scenarios where OpenCode fits best:
+
+- **Don't want to be locked to a single model** — Use Claude today, switch to GPT tomorrow, try DeepSeek the day after — one tool handles it all
+- **Care about cost control** — Bring your own API Key and pay per usage; supports using existing ChatGPT Plus subscriptions
+- **Have privacy requirements** — Code and context don't go through third parties; supports local models
+- **Like high customizability** — YAML configuration for custom Agent behavior, meeting team-specific needs
+
+## How It Connects
+
+OpenCode works with NocoBase in the following way:
+
+```
+You (Terminal / VS Code / JetBrains / ...)
+  |
+  └─→ OpenCode
+        |
+        ├── NocoBase Skills (enables Agent to understand NocoBase configuration system)
+        |
+        └── NocoBase CLI (executes create, modify, deploy, and other operations)
+              |
+              └─→ NocoBase Service (your business system)
+```
+
+- **NocoBase Skills** — Domain knowledge packages that tell OpenCode how to operate NocoBase
+- **NocoBase CLI** — Command-line tool that actually executes data modeling, page building, and other operations
+- **NocoBase Service** — Your running NocoBase instance
+
+## Prerequisites
+
+Before starting, make sure you have the following environment ready:
+
+- OpenCode installed ([installation guide](https://opencode.ai/docs/))
+- Node.js >= 22 (for running NocoBase CLI and Skills)
+- If you already have a NocoBase instance, **AI capabilities are evolving rapidly and only the latest beta version provides the full experience. Minimum version >= 2.1.0-beta.20, latest version strongly recommended.**
+
+## Quick Start
+
+### One-Click AI Installation
+
+Copy the prompt below to OpenCode, and it will automatically complete NocoBase CLI installation, initialization, and environment configuration:
+
+```
+Help me install NocoBase CLI and complete initialization: https://docs.nocobase.com/ai/ai-quick-start.md (please read the linked content directly)
+```
+
+### Manual Installation
+
+```bash
+npm install -g @nocobase/cli@beta
+nb init --ui
+```
+
+The browser will automatically open a visual configuration page, guiding you to install NocoBase Skills, configure the database, and start the application. For detailed steps, see [Quick Start](../quick-start.md).
+
+After installation is complete, run `nb env list` to confirm the environment status:
+
+```bash
+nb env list
+```
+
+Confirm the output shows the configured environment and its running status.
+
+## FAQ
+
+<!-- TODO: Compile 5-8 common questions. For example: How to configure API Keys for different models, how to switch models, how to use local models, what to do if Skills installation fails, etc. -->
+
+## Related Links
+
+- [NocoBase CLI](../quick-start.md) — Command-line tool for installing and managing NocoBase
+- [NocoBase Skills](../../ai-builder/index.md#nocobase-skills) — Domain knowledge packages installable into AI Agents
+- [AI Building Quick Start](../../ai-builder/index.md) — Build NocoBase applications from scratch with AI
+- [OpenCode Official Documentation](https://opencode.ai/docs/) — OpenCode complete user guide
+- [Claude Code + NocoBase](../claude-code/index.md) — Anthropic's official AI coding assistant
+- [Codex + NocoBase](../codex/index.md) — OpenAI's official AI coding assistant

package/dist/ai/docs/nocobase/ai/quick-start.mdx

@@ -0,0 +1,175 @@
+---
+title: "AI Agent Integration Guide"
+description: "Install NocoBase CLI, connect to or install a NocoBase application, and let AI Agents start operating your business system."
+keywords: "NocoBase CLI,AI Agent,integration,connect,installation,Skills,quick start"
+sidebar: false
+---
+
+# AI Agent Integration Guide
+
+NocoBase fully supports AI Agent collaboration — you can use natural language to complete data modeling, page building, workflow orchestration, permission configuration, and even custom plugin development. Whether you use Claude Code, Codex, Cursor, or other AI tools, you can work with NocoBase through these two foundational components:
+
+1. **[NocoBase CLI](../api/cli/index.md)** — A command-line tool for initializing, connecting to, and managing NocoBase applications in your local workspace. It helps you prepare NocoBase applications, save CLI env configurations, and provides daily management commands such as start, stop, view logs, upgrade, and clean up — enabling AI Agents to connect and use NocoBase.
+
+CLI supports two common initialization methods:
+
+- Connect to an existing NocoBase application so that AI Agents can use it directly.
+- Install a new NocoBase application via Docker, npm, or Git, and save it as a CLI env.
+
+2. **[NocoBase Skills](https://github.com/nocobase/skills)** — Domain knowledge packages that enable AI Agents to understand NocoBase's configuration system and development conventions. They cover data modeling, UI configuration, workflow management, permission configuration, plugin development, and more. NocoBase CLI automatically installs Skills during initialization (`nb init`), so no manual installation is needed.
+
+Once you install CLI and complete initialization, your AI Agent can directly operate your NocoBase application.
+
+## Prerequisites
+
+Before getting started, make sure the following environment requirements are met:
+
+- Node.js >= 22
+- Yarn 1.x
+- We recommend using AI Agents powered by leading large models such as Claude or GPT. Results depend heavily on the model used — for the best experience, choose the latest flagship model available.
+
+import { Tab, Tabs } from '@rspress/core/theme';
+
+## Install a New NocoBase and Connect AI Agent
+
+> If you already have a running NocoBase instance, you can skip to the next section: [Connect AI Agent to an Existing NocoBase](#connect-ai-agent-to-an-existing-nocobase).
+
+If you don't have a NocoBase application yet, you can use CLI to install and initialize a new NocoBase application, then connect AI Agent to it.
+
+<Tabs>
+<Tab label="Manual Installation and Connection" value="manual-install">
+
+#### Step 1: Install CLI
+
+```bash
+npm install -g @nocobase/cli@beta
+nb --version // Confirm successful installation
+```
+
+#### Step 2: Initialize
+
+```bash
+nb init --ui
+```
+
+:::tip Configuration file storage
+
+Configuration files and application data are stored in your home directory by default. See [NB_CLI_ROOT environment variable](../api/cli/index.md#environment-variables) for details.
+
+:::
+
+The browser will automatically open a visual configuration page, guiding you through 5 steps:
+
+1. **Start Configuration** — Set the application name (also used as the CLI environment name), select "Fresh Installation"
+2. **Create Application** — Choose the installation method (Docker / npm / Git), set port and other basic configurations
+3. **Download Application Files** — Select source and version, download NocoBase source code or image
+4. **Configure Database** — Use the built-in database or configure an external database (PostgreSQL, MySQL, MariaDB)
+5. **Create Admin Account** — Set the admin email and password
+
+![nocobase cli visual wizard](https://static-docs.nocobase.com/2026-04-29-15-55-19.png)
+
+After installation is complete, open your browser and visit `http://localhost:13000` (default port), then log in with the admin account you just set up.
+
+(If you prefer working in the command line, you can also run `nb init` to enter the interactive wizard, or `nb init --env=app -y` to use default configuration with one command.)
+
+#### Step 3: Let AI Agent Start Working
+
+Start a new or restart the AI Agent session, and you can let the AI Agent start operating NocoBase. CLI configuration is stored in a global directory (default `~/.nocobase/`), accessible from any directory.
+
+</Tab>
+<Tab label="Install and Connect with AI Agent" value="ai-install">
+
+Copy the prompt below to your AI assistant (Claude Code, Codex, Cursor, Trae, etc.), and it will complete CLI installation and guide you through initializing a new NocoBase:
+
+```
+Help me install NocoBase CLI and complete initialization: https://docs.nocobase.com/ai/ai-quick-start.md (please read the linked content directly)
+```
+
+After configuration is complete, restart your AI Agent session and you can start operating NocoBase.
+
+</Tab>
+</Tabs>
+
+## Connect AI Agent to an Existing NocoBase
+
+If you already have a running NocoBase instance, you can connect AI Agent to it directly. **Since AI capabilities are evolving rapidly, only the latest beta version provides the full experience. The minimum required version is 2.1.0-beta.20 — we strongly recommend updating to the latest.**
+
+<Tabs>
+<Tab label="Manual Connection" value="manual-connect">
+
+#### Step 1: Install CLI
+
+```bash
+npm install -g @nocobase/cli@beta
+nb --version // Confirm successful installation
+```
+
+#### Step 2: Initialize and Connect
+
+```bash
+nb init --ui
+```
+
+:::tip Configuration file storage
+
+Configuration files are stored in your home directory by default. See [NB_CLI_ROOT environment variable](../api/cli/index.md#environment-variables) for details.
+
+:::
+
+The browser will automatically open a visual configuration page. In the first step "Start Configuration", select "Connect to Existing Application", then:
+
+1. **Enter API Address** — Input the API address of your existing NocoBase instance (e.g., `http://localhost:13000/api`)
+2. **Select Authentication Method** — Choose an [authentication method](../ai-builder/security) (OAuth is recommended for quick setup)
+
+![nocobase cli visual wizard](https://static-docs.nocobase.com/2026-04-29-15-55-55.png)
+
+No need to configure installation method, database, or admin account — the wizard will skip those steps.
+
+#### Step 3: Let AI Agent Start Working
+
+Start a new or restart the AI Agent session, and you can let the AI Agent start operating NocoBase. CLI configuration is stored in a global directory (default `~/.nocobase/`), accessible from any directory.
+
+</Tab>
+<Tab label="Connect with AI Agent" value="ai-connect">
+
+Copy the prompt below to your AI assistant. It will complete CLI installation and guide you through connecting to your existing NocoBase instance. Select "Connect to Existing Application" in the first step of the visual wizard:
+
+```
+Help me install NocoBase CLI and complete initialization: https://docs.nocobase.com/ai/ai-quick-start.md (please read the linked content directly)
+```
+
+After configuration is complete, restart your AI Agent session and you can start operating NocoBase.
+
+</Tab>
+</Tabs>
+
+## What's Next
+
+### Manage Application Environments
+
+If you need to manage existing NocoBase instances (such as test or production environments), or switch between multiple environments, see [Environment Management](../ai-builder/env-bootstrap) — covering environment checks, adding environments, upgrades, and troubleshooting.
+
+### Start AI Building
+
+Describe your requirements in natural language, and AI helps you complete data modeling, page building, and workflow orchestration — replace manual configuration with conversation. See [AI Building Quick Start](../ai-builder/index.md#replace-manual-configuration-with-conversation).
+
+### Continue with AI Plugin Development
+
+If you need to develop custom plugins, AI can help too — from scaffolding generation to component code and business logic, covering the full plugin development process. See [AI Plugin Development](../ai-dev/index.md#from-a-single-sentence-to-a-complete-plugin).
+
+### Use AI Employees
+
+Collaborate with AI employees directly in the NocoBase interface — data analysis, report generation, translation, decision support, without leaving your business system. See [AI Employees](../ai-employees/index.md).
+
+### NocoBase CLI Command Reference
+
+If you already have a NocoBase application running, or have successfully completed initialization and want to continue developing, debugging, or managing your application, see [NocoBase CLI Command Reference](../api/cli/index.md) for full parameter documentation of all `nb` commands.
+
+## Related Links
+
+- [AI Building](../ai-builder/index.md) — Build NocoBase applications from scratch with AI
+- [AI Plugin Development](../ai-dev/index.md) — Develop NocoBase plugins with AI assistance
+- [AI Employees](../ai-employees/index.md) — Collaborate with AI in the business interface
+- [Environment Management](../ai-builder/env-bootstrap) — Environment checks, adding environments, upgrades, and troubleshooting
+- [NocoBase CLI Command Reference](../api/cli/index.md) — Full parameter documentation for all commands
+- [Installation Methods and Version Comparison](../get-started/quickstart) — Different installation methods and version channels for NocoBase

package/dist/ai/docs/nocobase/ai/workbuddy/index.md

@@ -0,0 +1,119 @@
+---
+title: "Go Hands-Free with WorkBuddy Driving NocoBase"
+description: "Remotely control NocoBase through Tencent's WorkBuddy, supporting WeCom, Lark, DingTalk, and other multi-platform access."
+keywords: "WorkBuddy,NocoBase,AI Agent,Tencent,WeCom,Lark,DingTalk,remote control"
+sidebar: false
+---
+
+:::warning Content Under Development
+
+This page is still being written. Some sections may be incomplete or subject to change.
+
+:::
+
+# Go Hands-Free with WorkBuddy Driving NocoBase
+
+[WorkBuddy](https://www.codebuddy.cn) is a full-scenario workplace AI agent by Tencent — describe your needs in one sentence, and it autonomously plans steps and executes them. After connecting it to NocoBase, you can remotely control your business system through WeCom, Lark, DingTalk, and other platforms, completing daily management tasks without opening a browser.
+
+<!-- Screenshot needed: WorkBuddy operating NocoBase in a WeCom conversation -->
+
+## What Is WorkBuddy
+
+WorkBuddy is Tencent's "full-scenario workplace AI agent desktop workstation." Unlike ordinary AI conversational tools, WorkBuddy automatically breaks down, plans, and executes tasks when it receives them, ultimately delivering a verifiable result — without requiring your step-by-step guidance.
+
+Core features:
+
+- **Autonomous planning and execution** — Automatically breaks tasks into steps, executes them one by one, and delivers complete results
+- **Multi-platform access** — Supports WeCom, Lark, DingTalk, QQ, and other mainstream Chinese enterprise platforms
+- **20+ built-in skills** — Document generation, data analysis, PPT creation, email editing, and more — ready to use out of the box
+- **Local file operations** — Can read and process local files you authorize
+
+In short, traditional AI tools give you suggestions and leave you to do the work; WorkBuddy does the work for you.
+
+| Traditional AI Chat              | WorkBuddy                                 |
+| -------------------------------- | ----------------------------------------- |
+| Can only chat, gives suggestions | Can actually execute tasks                |
+| Requires manual file operations  | Automatically operates local files        |
+| Single-step simple tasks         | Multi-step complex tasks, auto-decomposed |
+| Outputs text replies             | Delivers verifiable results               |
+
+## Why Choose WorkBuddy
+
+If you're deciding which AI Agent to use for operating NocoBase, here are the scenarios where WorkBuddy fits best:
+
+- **Team uses WeCom / Lark / DingTalk** — WorkBuddy supports the broadest range of Chinese enterprise platforms, with the widest coverage
+- **Need mobile control of NocoBase** — Manage your system anytime from anywhere, without device restrictions
+- **Want out-of-the-box experience** — Made by Tencent, with 20+ built-in skills and a low configuration barrier
+- **Focus on task automation** — WorkBuddy excels at automatically decomposing and executing multi-step tasks, suitable for daily operations and management
+
+## How It Connects
+
+WorkBuddy works with NocoBase in the following way:
+
+```
+You (WeCom / Lark / DingTalk / ...)
+  |
+  └─→ WorkBuddy
+        |
+        ├── NocoBase Skills (enables Agent to understand NocoBase configuration system)
+        |
+        └── NocoBase CLI (executes create, modify, deploy, and other operations)
+              |
+              └─→ NocoBase Service (your business system)
+```
+
+You send instructions from any supported platform, WorkBuddy completes NocoBase operations on the backend through Skills and CLI, and results are pushed back to your chat window in real time.
+
+## Prerequisites
+
+Before starting, make sure you have the following environment ready:
+
+- WorkBuddy account ([registration portal](https://www.codebuddy.cn))
+- Node.js >= 22 (for running NocoBase CLI and Skills)
+- If you already have a NocoBase instance, **AI capabilities are evolving rapidly and only the latest beta version provides the full experience. Minimum version >= 2.1.0-beta.20, latest version strongly recommended.**
+
+:::warning Note
+
+WorkBuddy is currently under rapid iteration, and some features may change. It is recommended to follow the [WorkBuddy official documentation](https://www.codebuddy.cn/docs/workbuddy/Overview) for the latest information.
+
+:::
+
+## Quick Start
+
+### One-Click AI Installation
+
+Copy the prompt below to WorkBuddy, and it will automatically complete NocoBase CLI installation, initialization, and environment configuration:
+
+```
+Help me install NocoBase CLI and complete initialization: https://docs.nocobase.com/ai/ai-quick-start.md (please read the linked content directly)
+```
+
+### Manual Installation
+
+```bash
+npm install -g @nocobase/cli@beta
+nb init --ui
+```
+
+The browser will automatically open a visual configuration page, guiding you to install NocoBase Skills, configure the database, and start the application. For detailed steps, see [Quick Start](../quick-start.md).
+
+After installation is complete, run `nb env list` to confirm the environment status:
+
+```bash
+nb env list
+```
+
+Confirm the output shows the configured environment and its running status.
+
+## FAQ
+
+<!-- TODO: Compile 5-8 common questions. For example: What platforms does WorkBuddy support, how much free quota is available, how to handle operation failures, can multiple people share one WorkBuddy to control the same NocoBase instance, etc. -->
+
+## Related Links
+
+- [NocoBase CLI](../quick-start.md) — Command-line tool for installing and managing NocoBase
+- [NocoBase Skills](../../ai-builder/index.md#nocobase-skills) — Domain knowledge packages installable into AI Agents
+- [AI Building Quick Start](../../ai-builder/index.md) — Build NocoBase applications from scratch with AI
+- [WorkBuddy Official Documentation](https://www.codebuddy.cn/docs/workbuddy/Overview) — WorkBuddy complete user guide
+- [OpenClaw + NocoBase](../openclaw/index.md) — The world's most popular open-source AI Agent, one-click Lark deployment
+- [Hermes Agent + NocoBase](../hermes-agent/index.md) — Automatically distills skills, understanding your business system better over time

package/dist/ai/docs/nocobase/ai-builder/acl.md

@@ -0,0 +1,92 @@
+---
+title: "ACL Configuration"
+description: "The ACL Configuration Skill manages NocoBase roles, permission policies, user bindings, and ACL risk assessments through natural language."
+keywords: "AI Builder,ACL configuration,ACL,roles,permissions,user bindings,risk assessment"
+---
+
+# ACL Configuration
+
+:::tip Prerequisites
+
+Before reading this page, make sure you have installed the NocoBase CLI and completed initialization as described in [AI Builder Quick Start](./index.md).
+
+:::
+
+## Introduction
+
+The ACL Configuration Skill manages NocoBase roles, permission policies, user bindings, and ACL risk assessments through natural language — you describe the business objective, and it selects the commands and parameters.
+
+
+## Capabilities
+
+- Create new roles
+- Switch global role modes (independent mode / union mode)
+- Batch configure action permissions and data scopes for data tables
+- Unbind users from roles
+- Generate risk assessment reports at the role, user, and system levels
+
+## Prompt Examples
+
+### Scenario A: Batch binding users
+:::tip Prerequisites
+The current environment must have a Member role and multiple users
+:::
+
+```
+Help me bind the Member role to these new users: James, Emma, Michael
+```
+
+![Batch binding users](https://static-docs.nocobase.com/20260422202343.png)
+
+### Scenario B: Batch configuring page permissions
+:::tip Prerequisites
+The current environment must have a Member role and multiple pages
+:::
+```
+Help me configure permissions for the Member role on these pages: Product, Order, Stock
+```
+
+![Batch configuring page permissions](https://static-docs.nocobase.com/20260422202949.png)
+
+### Scenario C: Batch configuring multi-table permissions
+:::tip Prerequisites
+The current environment must have a Member role and multiple data tables
+:::
+
+```
+Add independent read-only permissions on these data tables for the Member role: order, product, stock
+```
+
+![Batch configuring independent table permissions](https://static-docs.nocobase.com/20260422205341.png)
+
+![Batch configuring independent table permissions 2](https://static-docs.nocobase.com/20260422205430.png)
+
+### Scenario D: Multi-role multi-table permission configuration
+:::tip Prerequisites
+The current environment must have multiple roles and multiple data tables
+:::
+
+```
+Add independent read-write permissions on these data tables for the Member and Sales roles: order, product, stock
+```
+
+![Multi-role multi-table configuration](https://static-docs.nocobase.com/20260422213524.png)
+
+### Scenario E: Risk assessment
+
+```
+Assess the permission risks of the Member role
+```
+
+This will output a risk score, impact scope description, and improvement recommendations.
+
+## FAQ
+
+**What should I do if permissions are configured but not taking effect?**
+
+First check whether the global role mode is correct — if a user has multiple roles simultaneously, the behavior difference between union mode and independent mode is significant. You can check the current mode to confirm the issue.
+
+## Related Links
+
+- [AI Builder Overview](./index.md) — Overview and installation guide for all AI Builder Skills
+- [NocoBase CLI](../ai/quick-start.md) — Command-line tool for installing and managing NocoBase

package/dist/ai/docs/nocobase/ai-builder/data-modeling.md

@@ -0,0 +1,95 @@
+---
+title: "Data Modeling"
+description: "The Data Modeling Skill enables creating and managing NocoBase data tables through natural language, including creating tables, adding fields, and setting up relationships."
+keywords: "AI Builder,data modeling,data tables,fields,relationships,collections"
+---
+
+# Data Modeling
+
+:::tip Prerequisites
+
+Before reading this page, make sure you have installed the NocoBase CLI and completed initialization as described in [AI Builder Quick Start](./index.md).
+
+:::
+
+## Introduction
+
+The Data Modeling Skill enables creating and managing NocoBase data tables through natural language — creating tables, adding fields, setting up relationships, and more.
+
+Before use, make sure the target data source has been configured in "Data Source Management."
+
+
+## Capabilities
+
+- Create, modify, and delete data tables, supporting general tables, tree tables, file tables, calendar tables, SQL tables, view tables, and inheritance tables
+- Add, modify, and delete fields, including all NocoBase built-in field types (including relationship fields) and plugin-extended field types
+
+## Prompt Examples
+
+### Scenario A: Creating a data table
+
+```
+Please create a file table for managing contracts
+```
+
+The Skill will guide the AI to analyze the fields needed for the data table and their corresponding NocoBase field types, then create a file-type data table and add the appropriate fields in the system.
+
+![Creating a data table](https://static-docs.nocobase.com/202604162103369.png)
+
+### Scenario B: Adding fields
+
+```
+Please add a status field to the users table to indicate whether the user is active, with three statuses: Active, Leaving, and Left
+```
+
+The Skill will guide the AI to retrieve the users table metadata and determine that an employment status field corresponds to a "Dropdown (single select)" field type in NocoBase, then add the field to the users table and configure the enum values.
+
+![Adding fields](https://static-docs.nocobase.com/202604162112692.png)
+
+### Scenario C: Initializing a data model
+
+```
+I'm building a CRM, please help me design and build the data model
+```
+
+The Skill will create data tables, add fields, and configure relationships in the system based on the data model designed by the AI.
+
+![Initializing a data model](https://static-docs.nocobase.com/202604162126729.png)
+
+![Initializing a data model result](https://static-docs.nocobase.com/202604162201867.png)
+
+### Scenario D: Adding a feature module
+
+```
+I'd like to add an order management data model to the existing CRM system
+```
+
+The Skill will guide the AI to retrieve the current system's data model and design the new feature's data modeling based on it, then automatically create data tables, add fields, and configure relationships.
+
+![Adding a feature module](https://static-docs.nocobase.com/202604162203006.png)
+
+![Adding a feature module result](https://static-docs.nocobase.com/202604162203893.png)
+
+## FAQ
+
+**Are system fields created automatically when creating a table?**
+
+Yes. System fields like `id`, `createdAt`, `createdBy`, `updatedAt`, and `updatedBy` are automatically generated by the server and do not need to be specified manually.
+
+**How do I fix an incorrectly configured relationship?**
+
+It's recommended to first check the current relationship field's foreign key and inverse field, then decide whether to modify or delete and recreate it. The Skill will read back and verify the relationship status on both ends after any changes.
+
+**How do I create a data table based on a plugin-extended table type?**
+
+The corresponding plugin must be enabled. If it's not enabled, the AI will typically attempt to enable the plugin. If the AI doesn't succeed, please enable the plugin manually.
+
+**How do I add a field based on a plugin-extended field type?**
+
+Same as above.
+
+## Related Links
+
+- [AI Builder Overview](./index.md) — Overview and installation guide for all AI Builder Skills
+- [UI Configuration](./ui-builder) — Use AI to build pages and blocks after creating data tables
+- [Solutions](./dsl-reconciler) — Batch-build entire business systems from YAML

package/dist/ai/docs/nocobase/ai-builder/dsl-reconciler.md

@@ -0,0 +1,90 @@
+---
+title: "Solutions"
+description: "The Solutions Skill batch-builds NocoBase applications from YAML configuration files."
+keywords: "AI Builder,solutions,application building,YAML,batch table creation,dashboard"
+---
+
+# Solutions
+
+:::tip Prerequisites
+
+Before reading this page, make sure you have installed the NocoBase CLI and completed initialization as described in [AI Builder Quick Start](./index.md).
+
+:::
+
+:::warning Note
+
+The Solutions feature is currently in testing with limited stability, available for early access only.
+
+:::
+
+## Introduction
+
+The Solutions Skill batch-builds NocoBase applications from YAML configuration files — creating data tables, configuring pages, and generating dashboards and charts all at once.
+
+Ideal for scenarios that require quickly building complete business systems, such as CRM, ticket management, inventory management, and more.
+
+
+## Capabilities
+
+Can do:
+
+- Design complete application solutions based on requirement descriptions, including data tables, pages, and dashboards
+- Batch-create data tables and pages via `structure.yaml`
+- Configure popups and forms via `enhance.yaml`
+- Automatically generate dashboards with KPI cards and charts
+- Incremental updates — always uses `--force` mode without destroying existing data
+
+Cannot do:
+
+- Not suitable for field-level fine-tuning (the [Data Modeling Skill](./data-modeling) is more appropriate)
+- Cannot perform data migration or data import
+- Cannot configure permissions or workflows (requires other Skills)
+
+## Prompt Examples
+
+### Scenario A: Building a complete system
+
+```
+Help me use nocobase-dsl-reconciler skill to build a ticket management system with a dashboard, ticket list, user management, and SLA configuration
+```
+
+The Skill will first output a design plan — listing all data tables and page structures — then execute the build in rounds after confirmation.
+
+![Design plan](https://static-docs.nocobase.com/20260420100420.png)
+
+![Build result](https://static-docs.nocobase.com/20260420100450.png)
+
+### Scenario B: Modifying an existing module
+
+```
+Help me use nocobase-dsl-reconciler skill to add a "Priority" dropdown field to the ticket table with options P0 through P3
+```
+
+Modify `structure.yaml` and update with `--force`.
+
+### Scenario C: Customizing charts
+
+```
+Help me use nocobase-dsl-reconciler skill to change "New Tickets This Week" to "New Tickets This Month" on the dashboard
+```
+
+![Customizing charts](https://static-docs.nocobase.com/20260420100517.png)
+
+Edit the corresponding SQL file, changing the time range from `'7 days'` to `'1 month'`, then run `--verify-sql` to validate.
+
+## FAQ
+
+**What should I do if SQL verification fails?**
+
+NocoBase uses PostgreSQL. Column names must use camelCase and be quoted with double quotes (e.g., `"createdAt"`). Date functions should use `NOW() - '7 days'::interval` instead of SQLite syntax. Running `--verify-sql` can catch these issues before deployment.
+
+**What if I want to fine-tune a specific field after building?**
+
+Use the Solutions Skill for the initial full build, then use the [Data Modeling Skill](./data-modeling) or [UI Configuration Skill](./ui-builder) for subsequent fine-tuning — they're more flexible for individual adjustments.
+
+## Related Links
+
+- [AI Builder Overview](./index.md) — Overview and installation guide for all AI Builder Skills
+- [Data Modeling](./data-modeling) — Use the Data Modeling Skill for field-level fine-tuning
+- [UI Configuration](./ui-builder) — Fine-tune pages and block layouts after building