前言¶
在 DSH 里做智能体应用，常见做法是单插件堆能力：模型、工具、界面各写各的，数据和业务规则散落在会话上下文里，换一个场景就要重新接一遍。Beelli X 社区中台（dsh-beellix-plugin）走另一条路：以 Harness 为执行底座，用「中台连接 + 场景插件 + 数据契约」把模型配置、插件管理和场景导航收拢到同一套插件体系里，让个人或本地业务可以从单个场景起步，再按依赖与数据关系组合成应用系统。
下面介绍它是什么、能做什么、如何安装，以及使用时需要留意的边界。
这是什么¶
Beelli X 中台插件 社区版（GitHub：Beellix-dev/dsh-beellix-plugin）是由 Beellix-dev 维护的 DSH 工作流类插件，当前版本 0.1.1，许可证 MIT。定位是 Harness-Based Agentic Data Engineering：基于 DSH 的开源连接中台，通过统一插件与数据契约，把场景应用、工具和公共能力接到 Harness 执行底座上。
插件在 DSH 宿主内以中台形式运行：中台负责安装与配置登记，DSH 原生 Loader 与执行机制负责加载和会话内调用；各业务插件保留自己的服务与数据归属。官网 beellix.com 承担作品发现与发行协作；本仓库负责把生态能力接入 DSH，并在用户环境里组织应用与数据连接。
体系怎么拆¶
Beelli X 围绕三块相互配合的部分构建：
- 通用执行：由 DSH 提供智能体运行、会话、上下文、工具、技能、子代理及执行控制。
- 中台连接：管理插件、模型配置、资源接入和场景组织，维护依赖、配置与公共契约；通过原生 Loader Include 接入运行。
- 场景复用：把面向业务目标的应用封装为可安装、可配置、可组合的场景插件。
插件模型分三类，职责在 README 中写得很清楚：
| 类型 | 职责 |
|---|---|
| 基础插件 | 共享服务、数据连接、存储等公共能力；核心部分主要由 Beelli X 维护 |
| 场景插件 | 面向业务目标的应用，是生态共创与应用组装的主要单位 |
| 工具插件 | 输入、输出与操作边界明确的可复用执行能力 |
场景还有二级分类（经营管理、专业作业、内容创作、分析研究），便于在目录里按工作性质检索；实际能力仍以各插件清单与接口声明为准。
核心功能（资料已核实部分）¶
插件与模型管理¶
中台提供插件管理、模型配置、资源接入和场景组织能力。插件模型配置按插件声明逐项展示：标题、必配／选配、默认策略和可选型号均来自插件本身；中台复用 DSH 主模型卡片与控件，按声明的操作类型显示对应图标。声明几项就显示几项；服务密钥可共享，不按连接重新合并配置项。
模型方案支持由插件声明业务方案分组。知识库等能力可将底层能力归入「入库处理」和「检索与重排」两个入口，连接配置与原生模型选择保留。可选 MinerU 作为文档解析服务，启用后适用文档直接走其 API（界面不将其标为自动备用模型）。
「发现」与目录¶
安装启用后，DSH 内 发现 与官网公开插件目录联动，支持搜索、分类、详情和确认安装；连接失败时可重试。SkillHub 目录页：https://www.skillhub.cn/plugins/Beellix-dev/dsh-beellix-plugin。
数据互通与应用组装¶
数据互通强调归属明确、对象可关联、操作有契约、结果可积累：业务记录由对应服务维护，跨应用引用保留标识与来源；读写与业务动作走公开接口。Harness 运行上下文与持久化业务数据分开管理。
应用系统由场景插件及所需基础插件、工具、模型与外部服务组成。装配时需明确应用组成、能力依赖、数据关系、业务衔接和运行配置；可用应用套件记录可复用的装配方案。
数据工具 beellix_data¶
beellix_data 区分 catalog、describe 与读写参数，并兼容模型适配器对未使用可选字段填入 null。写入能力由已启用的业务插件声明；目录入库只沿资源契约使用工作区相对路径并经过原生确认。没有写入能力时停止，不探测本地端口、HTTP 或安装目录。
中台自身更新¶
从官方 GitHub 仓库安装的中台，可在首页 检查更新，有变化后 立即更新，校验完成后保存工作并 重启生效。同为 0.1.1 时也能识别内容更新，无需先卸载。该机制沿 DSH 桌面公开 CLI 与原生锁维护当前包，不改业务资料或其他插件；与业务插件的官网更新服务是分开的。
安装与启用¶
在 DSH 中打开 插件 → 添加插件，填写仓库地址（资料原文如下，请勿自行改写成 CLI 子命令）：
https://github.com/Beellix-dev/dsh-beellix-plugin
安装并启用后，会自动初始化安全的新资料目录。接着从 更多 → Beelli X 中台 查看目录状态、选择已有资料目录、配置模型，并按需安装其他 Beelli X 生态插件。
环境与兼容范围见仓库 快速开始 与 验证说明。package.json 中声明的宿主要求为：Node.js ≥ 22，DSH ≥ 0.2.1-rc.2 且 < 0.3.0。
典型用法（按文档路径）¶
- 完成上述安装后，在中台内配置模型与资料目录。
- 通过 发现 浏览官网目录，按分类或搜索定位场景／基础／工具插件，确认后安装。
- 从单个场景接入自己的数据与能力；需要组合多个场景时，按 应用组装 思路梳理依赖与数据契约（详细步骤见 产品说明、功能说明、模型与配置）。
若要参与生态开发，人工开发、开发助手与 DSH 创造模式共用同一套 插件开发标准 与 开发指南。
适用场景与注意¶
适合谁：已经在用 DSH 做智能体或本地业务自动化，希望用插件化中台统一管理模型、子插件与场景导航，并愿意按数据契约做多场景协作的开发者或小团队。
权限与安全：插件在 当前 DSH 进程权限 下运行。安装前应阅读源码与 MIT 许可证，并查看 数据与隐私、安全报告入口。社区插件目录（如 SkillHub）是独立站点，与 DeepSeek／幻方无官方从属关系，公网服务可用性与本地安装后的运行需分别验收。
生态背景：DSH 侧的理念是「一切皆插件」；Beelli X 中台本身是入口插件，真正业务能力来自后续安装的基础、场景与工具插件。
结尾¶
Beelli X 社区中台把 DSH 原生执行与中台侧的插件、模型、目录发现和数据契约接在一起，适合从单场景起步、再按依赖组装本地 AI 应用的工作流。更多细节以仓库文档为准。
