# Plinth 基座 - 企业级 AI 应用框架

**Repository Path**: chen_wei_ji/fde

## Basic Information

- **Project Name**: Plinth 基座 - 企业级 AI 应用框架
- **Description**: 面向企业私有化部署与 FDE 交付，基于 TypeScript + PostgreSQL 构建。集成 AI 对话、知识库、工作流、网盘与云文档，支持插件扩展、自有模型供应商及钉钉、飞书、企业微信接入。
- **Primary Language**: TypeScript
- **License**: Apache-2.0
- **Default Branch**: main
- **Homepage**: https://gitee.com/chen_wei_ji/fde/blob/main/docs/README.md
- **GVP Project**: No

## Statistics

- **Stars**: 14
- **Forks**: 0
- **Created**: 2026-10-15
- **Last Updated**: 2026-10-19

## Categories & Tags

**Categories**: Uncategorized

**Tags**: TypeScript, Postgresql, AI应用, 私有化部署

## README

# Plinth 基座

企业级 AI 应用框架：内核 + 插件 + 连接器 + 多端渠道 + 应用市场。服务商可以用它给客户做私有化交付。纯 TypeScript，生产数据库只有一个 PostgreSQL。公开版提供源码安装与 Docker 自建方式。

网盘、文档、协作、通讯录、管理台不依赖外网。对话、检索、作图、语音要由管理员配置模型后才能用；没配模型时，这些 AI 功能不可用，其余功能照常。

## 快速开始

需要 Node.js 22.12–22.x、pnpm 10.12.0 和 Git。以下命令适用于 macOS / Linux；首次安装需要联网下载依赖。

```bash
git clone https://gitee.com/chen_wei_ji/fde.git plinth
cd plinth
corepack enable
corepack prepare pnpm@10.12.0 --activate
pnpm install --frozen-lockfile
pnpm build:community
pnpm check:community
pnpm demo
```


打开 `http://localhost:3000`，按向导创建管理员。办公平台选「暂不接入」，AI 供应商选「稍后再配」，即可先使用基础功能；也可填入自己的 OpenAI 兼容供应商。社区构建不包含闭源中台组件，不需要注册官方中台。`pnpm demo` 默认不启用模拟模型；未配置模型时不会产生真实 AI 回答。

本地体验使用内嵌 PGlite，数据保存在 `runtime/demo`，停止后重启仍然保留。它只适合开发与评估；正式交付使用 PostgreSQL。**不要把本地体验端口直接暴露到公网。**

[观看本地开站与插件操作演示（WebM）](docs/guide/media/plugin-walkthrough.webm) · [完整安装、Docker 自建与故障排查](docs/guide/安装与本地体验.md) · [开源与中台组件边界](docs/guide/开源与模型服务说明.md) · [验证记录](docs/guide/公开版验证记录.md)

本公开版使用新的插件、协议和持久化命名，需要全新数据库和数据卷。此前版本不能直接覆盖升级，见 [版本切换说明](docs/guide/版本切换说明.md)。


## 使用流程

下面的图来自一套已经开站的环境，用来看页面怎么串起来，不是安装后的空数据。

成员可以提问并按需使用技能，也可以直接打开应用或运行工作流。网盘、云文档与知识库提供工作资料；结果回到原入口，需要处理的事项通过消息或办公渠道提醒。

![基座使用流程：按需选择对话、工作流或应用，使用共享资料并交付结果](docs/guide/diagrams/usage-flow.png)

[查看可缩放流程图](docs/guide/diagrams/usage-flow.svg) · [查看完整架构说明](docs/guide/项目架构.md)

### 1. 提问

成员从工作台首页开口。网盘、知识库和应用里的内容会先检索出来，再交给模型回答。

![工作台首页](docs/guide/shots/home.png)

<details>
<summary>更多场景截图：技能、工作流、应用、网盘与管理台</summary>

### 2. 技能

把一类工作的步骤写成技能。问的时候按需读，不必每次把整份说明塞进对话。

![技能](docs/guide/shots/skills.png)

### 3. 工作流

把几个应用串成一条线：定时跑、有人确认后再继续，或者从现成模板改。

![工作流](docs/guide/shots/workflow.png)

### 4. 应用

做图、视频、会议记录、合同审查、发票识别、文档翻译、智能客服、白板、PPT 都从应用页进入。常驻的钉在侧栏，其余可以自己固定。

![应用](docs/guide/shots/apps.png)

### 5. 网盘

个人、部门、企业三种空间。文件按类型筛选，也能预览、分享，并作为知识库和云文档的来源。

![网盘](docs/guide/shots/drive.png)

### 6. 云文档

在线写文档，文件仍落在网盘里，同事从网盘也能看到。

![云文档](docs/guide/shots/docs.png)

### 7. 做图

用一句话描述画面，选比例和张数后生成。视频、白板走同一类创作入口。

![AI 做图](docs/guide/shots/image.png)

### 8. 消息

备份没做、应用停了、待办要处理，都进消息。未读数挂在侧栏底部。

![消息](docs/guide/shots/messages.png)

### 9. 管理台概览

管理员看应用是否在跑、成员人数、模型是否配好，以及今天有没有人提问。

![管理台概览](docs/guide/shots/admin.png)

### 10. 接入办公平台

钉钉、飞书、企业微信在这里接。通讯录同步、免登和通知都从这一页往下做。

![接入](docs/guide/shots/integrations.png)

</details>

## 架构

基座由前端壳、平台内核和插件组成。工作台面向成员，管理台面向管理员；应用、连接器与办公渠道通过插件扩展，统一使用内核的权限、文件、模型和任务能力。

![基座系统架构：访问入口、平台内核、插件扩展与基础资源](docs/guide/diagrams/system-architecture.png)

生产默认部署运行时与 PostgreSQL 两个容器。监督进程拉起内核，内核通过 MCP / stdio 调用独立插件子进程。PostgreSQL 保存会话、权限、业务状态、文件元信息、索引与任务；文件本体、版本包与备份默认保存在持久数据卷。

[插件调用关系](docs/guide/项目架构.md#插件如何调用平台能力) · [部署与数据存储](docs/guide/项目架构.md#部署与数据存储) · [可缩放架构图](docs/guide/diagrams/system-architecture.svg)

## 开发插件

推荐下载 [v0.1.1 发行工具包](https://gitee.com/chen_wei_ji/fde/releases/tag/v0.1.1)，按 [独立插件教程](docs/guide/插件开发入门.md) 使用其中的 `create-plugin.mjs`，无需克隆框架。已有源码的开发者也可以这样构建工具包：

```bash
# 在基座仓库根目录
pnpm plugin:toolkit
export PLINTH_SOURCE="$PWD"
mkdir -p ../plinth-plugins
cd ../plinth-plugins
node "$PLINTH_SOURCE/packages/cli/dist/cli.js" create-plugin com.example.hello --local-packages "$PLINTH_SOURCE/dist/plugin-toolkit"
cd hello
pnpm install
pnpm check
pnpm typecheck
pnpm test
pnpm run pack
```

插件工程只保存插件自己的源码；SDK 与 CLI 从本地 `.tgz` 安装，没有 `workspace:*` 依赖，不要求复制框架源码。第三方依赖仍需从 npm 下载，工具包不是完整离线安装介质。

[插件开发入门：创建、检查、测试、打包与实机调用](docs/guide/插件开发入门.md) · [参与贡献](CONTRIBUTING.md) · [路线图](ROADMAP.md) · [版本说明](CHANGELOG.md)

## 开发基座

完成依赖安装后，先执行 `pnpm --filter @plinth/core... build`，再执行 `pnpm dev`。内核默认 3000 端口，前端 5173 端口；开发使用 PGlite。没有模型时基础功能照常使用；只有明确需要模拟时才设置 `PLINTH_MODEL_MOCK=1`。

先看 [协作规则](CLAUDE.md)、[文档导航](docs/README.md) 和 [工程结构](docs/standards/工程结构.md)。环境变量见 [.env.example](.env.example)。公开组件注册表域名留空；插件 Schema 随 SDK 分发，不依赖远程 Schema。

## 下载与验证

[v0.1.1 发行版](https://gitee.com/chen_wei_ji/fde/releases/tag/v0.1.1) 同时提供纯社区源码、原始源码和独立插件工具包；使用前核对 SHA256SUMS。纯社区包不包含另行许可的中台组件。[发行与校验](docs/guide/发行与校验.md) · [验证记录](docs/guide/公开版验证记录.md) · [持续集成](https://gitee.com/chen_wei_ji/fde/gitee_go)

## 安全

发现安全问题请按 [SECURITY.md](SECURITY.md) 私下报告，不要写在公开 Issue 里。

## 许可证

开源部分使用 [Apache License 2.0](LICENSE)。可以商用、修改、再分发，也可以给客户部署并收费。分发时保留许可证和 [NOTICE](NOTICE) 里的归属说明。

`packages/core/vendor/platform-client/` 是另行许可的闭源组件，协议在该目录的 LICENSE，不属于 Apache-2.0。去掉或换掉它，不影响其余开源代码的许可。