扩展 SDK 总览

它们解决什么问题

平台预装的能力覆盖大多数通用场景。但你自家专属的 ERP / 文档格式 / IM 通道 / 内部 API 平台不可能预装——这就是 SDK 的用处。

四个 SDK，每一个对应一类扩展点：

SDK	让你扩展的是	典型例子
parser-sdk	"怎么把文件读懂、切块"	解析自家 G-code 工艺文件、专利 ChemDraw、私有 IDL
tool-sdk	"AI 多一件武器"	接自家 ERP 查库存、调内部 API 算 BOM
source-sdk	"数据从哪儿来"	自动从你家飞书空间/SharePoint/Notion/SVN 拉数据入库
channel-sdk	"AI 在哪个对话窗口出现"	接钉钉、Slack、自研 IM、客户专属工单系统

四个 SDK 共享一个底层 plugin-sdk-core —— manifest 格式、CLI 框架、租户隔离、审计日志这些公共部分一次写好，四个 SDK 都用同一套。你不用学四遍。

安装包怎么拿

SDK 不在公开 PyPI

平台扩展 SDK 是面向客户的私有包，不在公开 pypi 镜像。需要安装包请发邮件到：

info@nox-lumen.com

注明：

公司 / 团队名
想做哪类扩展（parser / tool / source / channel）
大致用例

我们会发安装方式 + 凭据 + 对应的 quick-start 工程模板给你。

快速判断我该用哪个 SDK

Rendering diagram…

共同的开发流程

不管你写哪一个 SDK，套路是一样的：

# 1. 安装（拿到内部包后）
pip install ragbase-parser-sdk      # 或 tool-sdk / source-sdk / channel-sdk
 
# 2. 用 CLI 起一个工程模板
ragbase-cli init parser my-parser   # parser / tool / source / channel
cd my-parser
 
# 3. 编辑业务逻辑（每个 SDK 文档里有具体例子）
vi src/my_parser/main.py
 
# 4. 本地试跑（每个 SDK 都自带本地试跑命令）
ragbase-cli parse-test --input sample.docx
 
# 5. 验证 + 打包
ragbase-cli skill validate
ragbase-cli skill build
 
# 6. 推到平台 marketplace 或私部环境
ragbase-cli skill push

每一步背后的细节、约束、调试技巧，看具体 SDK 的页。

行业里"什么时候真要写 SDK"

行业	你大概率要写哪一个
汽车研发	parser-sdk（自家 ARXML 子集、Vector 工具产物）；source-sdk（持续从 DOORS Next 同步）
智能制造	parser-sdk（CAD / G-code）；tool-sdk（接 MES / ERP）；channel-sdk（接产线工单系统）
办公自动化	source-sdk（接内部文档系统）；channel-sdk（接自研 IM）