iPollo 业务本体 · AI 原生企业业务底座
English · 下载 · iPolloWork 插件 · 架构 · API / MCP
把业务表、记录关系和文档放在同一个轻量工作台，让人和 AI 使用同一套真实数据。
独立项目，独立运行。 手动管理数据不依赖 iPolloWork；作为 iPolloWork 插件使用时，全部 AI 能力由宿主提供。Onto 不再维护一套模型供应商、模型密钥或 Agent 服务。当前为 v0.1.4 本机开发预览。
| 方式 | 下载 | 用途 |
|---|---|---|
| 独立运行 | 源码包 | 连接 PostgreSQL，运行完整的数据工作台 |
| iPolloWork 插件 | 插件包 | 加入 AI 建表、关联分析和文档更新工作流 |
插件在 iPolloWork 的扩展页面导入。首次使用需独立启动 Onto，并在宿主连接一次项目或单表 MCP；当前源码版本已增加右侧工作台页面，自动显示本机 Onto 并共享当前项目 / 表选择；不会自动启动数据库或注册项目 MCP。0.1.4 支持对话绑定项目，以及 AI 建表、分批写记录和更新文档后的页面跟随；手动编辑时暂停跟随。详见 插件安装。每个发布包均提供 SHA-256 校验文件。
- 项目与业务表：打开即建项目，项目内多表；可选默认库或独立 PostgreSQL 数据库。表格直接编辑、筛选分组、排序、保存视图，字段与表支持拖拽，侧栏与列宽可调。
- 丰富字段：基础类型、选择项、文件引用、关联，以及独立的 API 实时字段。接口统一配置，变量来自每条记录的字段；例如填写股票代码，得到对应公司的行情。
- 真实关系：双向关联共用一份关系边；从一条记录出发逐层展开，线连接具体字段，显示关系名称。同一物理数据库内可跨项目关联。
- 记录与文档融合：右侧详情面板、关系标签页、可共享到多条记录的文档；块编辑、图片、视频、普通表格与引用业务表。Word 下载；PDF 使用正文打印预览另存为 PDF。
- 边工作边可见：对话绑定业务项目，AI 直接分批构建和维护数据；页面跟随已提交结果，编辑时可暂停，多个对话分别记住位置。
- AI 可读写的契约：项目和单表级 API / MCP；结构发现、构建预览、关联查询、版本校验、批量导入和文档更新。AI 与界面共用校验、事务及数据。
- 按需扩展：字段、视图扩展可导入本地 ZIP；内置卡片、业务关系图和简单事件自动化。提供真实股票、汇率、GitHub API 示例，用户主动创建后使用。
- 轻量界面：浅色 / 深色 / 跟随系统，中文 / English，统一图标与可复用组件。
这是一套朝业务本体方向建设的数据底座；当前没有宣称完整实现 Palantir 的企业治理、动作体系或全部 Ontology 能力。
需要 Node.js 22.12+、pnpm 10.14.0、PostgreSQL。先创建一个本项目专用数据库：
pnpm install --frozen-lockfile
cp .env.example .env
# 编辑 .env 中的 DATABASE_URL，指向已创建的专用数据库。
pnpm build
pnpm start打开 **http://127.0.0.1:5711**。前端、API 与 MCP 使用一个 Node 进程；启动时自动迁移本项目的 iw_data 空间。当前仅监听本机回环地址。
开发时使用 pnpm dev：界面在 5710，API 在 5711。不要同时启动开发 API 和独立服务占用相同端口。已有本地目录无须改名；原有数据库空间、API 路径、扩展格式和浏览器偏好键继续兼容。
一个 Node 服务 + PostgreSQL；不强制引入 Redis、消息队列、向量库或图数据库。表格查询不加载文档正文。文档正文单独保存在 PostgreSQL，图片和视频保存在 .data/document-files/，业务表引用保持原数据来源。
项目可连接独立库；同库项目可直接关联，跨物理数据库的直接双向关系尚未实现。项目隔离不等于成员权限隔离。瀚高选项使用 PostgreSQL 兼容协议，具体版本尚未实机验收，也不代表信创认证。当前测试基于 PostgreSQL 15。
备份应包含默认数据库、项目独立数据库、文档媒体目录，以及 .local/database.key（或配置的原始加密密钥）。缺少密钥会无法解密已有连接。环境变量见 .env.example。
当前没有多用户身份认证、行级权限、公开分享托管或生产备份管理。请用于受信任的本机环境。API 字段可按读取获取、在页面打开时刷新并保存最新值；关闭页面后的通用定时同步、历史行情采集、连接器和外置自动化执行仍在后续范围。尚无高并发承诺或完整插件代码沙箱。
pnpm typecheck
pnpm build
pnpm package:plugin
pnpm test:plugin数据库测试必须使用两套专用测试数据库，不要指向业务数据库：
DATABASE_URL=postgresql://localhost/onto_test \
TEST_PROJECT_DATABASE_URL=postgresql://localhost/onto_project_test \
DATA_SECRET_FILE=/tmp/onto-test.key \
DOCUMENT_FILES_DIR=/tmp/onto-test-media pnpm test未配置第二个测试库时，独立库用例会跳过。宿主兼容性验证使用本机 iPolloWork 源码与 Bun：
IPOLLOWORK_SOURCE_ROOT=/path/to/iPolloWork pnpm test:hostGitHub CI 使用隔离的 PostgreSQL 服务执行测试。发布脚本只打包插件声明的资源或经过审查的 Git 索引文件，不携带业务数据、凭据或运行缓存。
src/core/ 字段、关系、查询与扩展契约
src/server/ 存储、事务、文档、API / MCP
src/ui/ 共用界面组件与视图
extensions/ 独立字段、卡片和关系图扩展
plugin/ iPolloWork 工作台页面与 AI 工作流插件
采用与 iPolloWork 相同的授权规则：源码可用协议（Source Available），不是 MIT，也不是 OSI 定义的开放源代码许可证。个人非商业使用、少于三人的内部非商业使用可在条款范围内进行；三人及以上、商业交付、对外托管服务、去品牌等须事先取得书面授权。以 LICENSE 完整条款为准。
本项目名称为 iPollo Onto；第三方组件仍遵循各自许可证。见 NOTICE。产品交互参考 Teable、APITable、Notion；AINO 仅参考字段分类，没有引入这些产品的整套应用内核。