联合开发

各机关、企业、事业单位、社会团体的文书、会计等门类档案的整理方法都是有标准的，流程与规则全国一致，差别只在专业档案的管理略有不同。正因为底层的标准是通用的，这一层完全不必重复开发——通过联合开发，可以把成熟能力直接复用，事半功倍。

不少专业软件公司在承接档案管理软件的开发任务后，由于缺少档案业务积累，往往事倍功半：真正难的不是写代码，而是把 8 号令、DA/T 22-2015、GB/T 9705-2008 这些规则准确地落成系统逻辑。这种情况下，与其从零摸索，不如直接调用元泰在文书、会计等门类档案上已经打磨成熟的功能，再在通用专业档案管理功能的基础上，对档号格式、目录格式稍作调整，即可完成整套档案软件的开发。

我公司开发的元泰数字档案室软件（数字方舟）、元泰数字档案整理软件—魔方、元泰档案知识库（启典）在文书、会计等许多档案门类的管理上，已经实现了完全符合国家标准的功能；专业档案管理部分也具备很强的再开发与集成能力。

和由元泰公司按用户订单独立完成的订制开发不同，联合开发的主角是全国各地的专业软件公司。元泰提供档案专业能力与技术底座，合作方主导产品形态与客户交付。三种合作方式的整体比较可参见合作开发综述。

一、合作方能拿到什么：以启典开放 API 为样板

要说清楚联合开发能拿到什么，最直观的例子是启典知识库已经对外开放的一整套标准 API。它把元泰多年积累的档案专业判断能力，封装成一个个可被任何程序调用的接口——合作方的软件不需要重写这些规则，只要发一个 HTTP 请求就能拿到结论。

1. 六类可直接调用的能力

能力	对应接口	为你的产品解决什么
保管期限判定	/retention、/retention/batch	对照 8 号令与本单位保管期限表，自动给出永久、30 年、10 年等判定结果，并同时返回判定依据与置信度，可批量处理整份目录
年度判定	/year、/year/batch	按签发日期、闭幕年、办结年、归档年度的优先级自动归类所属年度，跨年度会议与跨年办理文件的老大难问题一并解决
公文元数据提取	/extract	从双层 PDF 中直接提取题名、责任者、成文日期、发文字号，免除人工录入
档案排列与档号生成	/arrange、/arrange/preview、/arrange/adjust	按 DA/T 22-2015「时间结合事由」规则完成排列，自动编制件号并生成标准档号，支持人工确认与顺序微调
档案知识问答	/ask	面向档案员的专业问答，答案附带检索到的原文出处，便于溯源核对
授权与计量管理	/machine/code、/license/status、/license/activate	让合作方把授权开通、剩余次数查询、授权码激活直接嵌进自有软件，实现自主计费与运维

2. 完整接口一览

接口路径	方法	功能	输入形式
/health	GET	健康检查，返回运行状态与当前模型模式	无需鉴权
/ask	POST	档案知识问答	JSON
/retention	POST	单条保管期限判定	JSON
/retention/batch	POST	批量保管期限判定	Excel 表单上传
/extract	POST	双层 PDF 元数据提取	PDF 表单上传
/year	POST	单条年度判定	JSON
/year/batch	POST	批量年度判定	Excel 表单上传
/arrange	POST	档案排列并生成件号、档号	Excel 表单上传
/arrange/preview	POST	预览排列结果，不生成件号	Excel 表单上传
/arrange/adjust	POST	调整顺序后重新生成件号	表单字段（JSON 串）
/machine/code	GET	获取本机机器码	无需参数
/license/status	GET	查询授权状态与剩余次数	无需参数
/license/activate	POST	激活授权码并累加次数	JSON

以上接口的详细参数、字段说明与错误码，可参阅启典开放 API；底层实现原理见启典知识库技术架构说明。

二、技术上怎么接：几乎不挑平台

这套接口的设计初衷就是让别人好用，因此在技术选型上没有附加任何限制：

• 标准协议：HTTP + JSON（文件上传类接口采用 multipart/form-data），任何编程语言、任何操作系统都可调用；
• 自带在线文档：服务启动后访问 /docs 即可看到完整的 Swagger UI 接口文档，另有 /redoc 版本，参数与示例一应俱全；
• 安全鉴权：通过 X-Api-Key 请求头校验身份，密钥由双方约定配置，可按需要开启或关闭；
• 双重运行模式：既支持调用云端大模型，也支持切换为本机大模型完全离线运行，满足涉密内网、数据不出单位的部署要求；
• 并发与批量：服务端支持异步并发，批量目录建议按每批不超过 500 条分段提交；
• 前端直连：已开放跨域访问，浏览器端 JavaScript 与各类前端框架可直接请求，无需自建代理层；
• 清晰的失败语义：400 表示请求格式有误、401 表示鉴权失败、500 表示服务端异常，便于快速定位。

调用示例（Python）

import requests

BASE = "http://127.0.0.1:8000"          # 部署在贵方内网时的地址
HEADERS = {"X-Api-Key": "YOUR_API_KEY"}  # 由元泰发放的接口密钥

# 单条保管期限判定
r = requests.post(f"{BASE}/retention",
                  json={"title": "关于印发2024年度工作计划的通知"},
                  headers=HEADERS)
print(r.json())
# 返回：{"period": "10年", "note": "依据：…", "method": "rule", "confidence": "high"}

同样的调用，用 Excel VBA 宏、Java（OkHttp）、PHP（cURL）、C#、Node.js 均无差别。若贵方软件是 .NET 或 Java 技术栈，我们可以直接提供对应语言的完整示例代码。

三、联合开发的三种落地形态

形态	适合什么情况	合作方式	你的投入
能力授权（API 调用）	已有系统不想重做，只想补上档案专业能力	提供接口、密钥与技术文档，元泰负责能力维护与规则更新	最小，改动集中在调用层
功能嵌入（OEM / 白标）	希望档案功能出现在自己产品中，但保留自家品牌与界面	把判定、排列、提取等模块嵌入合作方产品，界面与品牌由合作方定义	中等，需做界面与流程整合
联合承接项目	共同投标或交付某个单位的档案信息化项目	元泰提供通用门类能力与标准合规保障，合作方负责专业部分与客户交付	视项目而定，风险共担

三种形态并不互斥，实际合作中往往是「先用测试接口跑通样例数据，验证效果后再谈深度集成」。接口的参数说明与错误码详见启典开放 API；授权方式与费用标准见档案软件报价。

四、对接流程：五步上线

1. 需求沟通：明确要接入哪些能力、面向哪些档案门类、运行环境是内网还是云端；
2. 开通测试环境：提供测试服务地址与接口密钥，配好在线接口文档；
3. 样例联调：用贵方真实的样例数据（可脱敏）跑通调用，核对返回结果是否符合业务预期；
4. 联合验收：约定准确率、响应时间、异常兜底策略，完成验收；
5. 上线与持续支持：移交正式密钥，后续规则更新由元泰统一维护，合作方无需返工。

五、哪些团队适合与我们联合

• 承接了档案管理软件订单、但缺少档案业务积累的专业软件公司；
• 希望为产品增加归档、鉴定能力的 OA 与协同办公厂商；
• 承建数字档案馆（室）的系统集成商；
• 从事档案整理、扫描加工的服务型企业，需要把加工成果自动化入库；
• 需要可服务化调用的档案专业能力的高校与科研机构。

六、常见问题

档案数据会不会离开我们单位？

不会。接口可以与知识库一同部署在贵方的档案室电脑或单位内网服务器上，启用本地运行模式后完全离线处理，数据不出办公室。这是很多涉密单位与内网客户的通行部署方式。

元泰会不会抢我们的客户？

不会。联合开发中，客户界面、品牌与交付关系都属于合作方，元泰只提供技术底座与规则维护，不接触终端客户，也不在合作产品上露出元泰品牌（除非双方另有约定）。

判定准确率如何，出错了怎么办？

保管期限判定采用规则优先、大模型兜底的策略，每条结果都返回判定依据与方法来源，置信度分高、中、低三档。低置信度的结果会明确标注，便于贵方界面引导人工复核，而不是让错误静默发生。

支持国产化环境吗？

支持。整套服务基于 Python 技术栈，可部署在国产操作系统与国产数据库环境中；如需信创一体机形态，可参考信创档案一体机方案。

对接周期和费用是怎样的？

仅做接口级别的接入，通常在数日内即可跑通测试；涉及功能嵌入或项目联合交付的，按具体范围商定。费用随调用形态与合作深度而定，详见档案软件报价，也可直接与我们联系沟通。

七、联系我们

如果您正在评估档案功能的自建成本，或手上已有项目需要档案专业能力的支撑，欢迎与我们聊聊。我们可以先提供测试接口与样例数据，让您亲自验证效果，再决定是否深入合作。

联系电话：13488578800　联系人：周经理　联系邮箱：qingong_0602@qq.com