外观
产品概述
ATKONOFFICE 是一款面向集成方的私有化在线文档编辑中间件：在现有 Web 应用里「加依赖 + 接自有存储 + 少量配置」，终端用户装一个 Windows 客户端，即可从网页一键打开 Word / Excel / PPT 进行真编辑——编辑引擎复用本机已安装的 Office 组件（MS Office / WPS Office），文档字节始终留在企业自有基础设施内，不出域。
ATKONOFFICE 不是托管型 SaaS：不托管文档、不做中转、不留存任何业务数据。
解决什么问题
许多团队面临同一个矛盾：一方面想在自有系统里直接编辑 Office 文档（而不是下载—改—再上传）；另一方面出于数据安全、合规、数据主权要求，又不能把文档交给第三方在线文档 SaaS。ATKONOFFICE 正为这对矛盾而生——既提供与桌面办公一致的真编辑体验，又让数据牢牢留在企业手里。
| 方案 | 数据位置 | 编辑保真度 | 代价 |
|---|---|---|---|
| 在线文档 SaaS | 第三方云 | 高 | 数据出域、合规风险 |
| 纯前端 JS 编辑器 | 集成方系统 | 有限（复杂排版易走样） | 保真不足 |
| ATKONOFFICE | 集成方系统 | 高（本机引擎真编辑） | 需装客户端 |
三部分如何协作
从集成方视角，ATKONOFFICE 由三部分组成，需要对接的只有前两者：
| 组成 | 运行位置 | 对接内容 |
|---|---|---|
浏览器端 SDK（@atkonoffice/sdk） | 集成方业务网页 | 加一个 npm 包，用它拉起编辑、订阅事件 |
服务端 SDK（cn.atkon:atkonoffice-sdk） | 集成方 Spring Boot 后端 | 加依赖、接存储、少量配置 |
| 桌面客户端 | 终端用户电脑 | 引导用户一次性安装 |
一次完整的「打开—编辑—保存」：
用户在业务页点"编辑"
│ ① 浏览器端 SDK open() → 业务后端签发 atkonoffice:// 拉起链（密钥不下发浏览器）
▼
桌面客户端被拉起 → 加载宿主页 → 内嵌本机 Office 组件
│ ② 经集成方解析器取文档字节，真编辑
▼
保存 → 编辑结果 POST 回业务后端 → 经自有存储落盘
│ ③ 业务页收到 documentSaved 通知，继续后续业务
▼
闭环成立核心能力一览
| 能力 | 说明 | 详见 |
|---|---|---|
| 在线真编辑 | 复用本机已安装的 Office 组件（MS Office / WPS Office），保真排版、所见即所得 | 通用控制 |
| 打开—编辑—保存闭环 | 一键保存回集成方系统 | 开始 |
| 只读打开 | 审阅、留痕、防误改 | 通用控制 |
| 新建空白文档 | 从零撰写 Word / Excel / PPT | 通用控制 |
| 多产物保存 | 一次保存产出原格式 + PDF（三类文档均可导出 PDF），原子上传 | 通用控制 |
| 生命周期事件 | 打开 / 保存前 / 保存后回流业务系统 | 通用控制 |
| 界面定制 | 隐藏功能区、自定义按钮、窗口外观 | 通用控制 |
| Word 模板填充 | 合同 / 公文「一开即见已填草稿」 | Word |
| Word 文档比对 | 两版并排、自动高亮差异、可回流 | Word |
| 自有存储 | 数据库 / 对象存储 / 文件系统皆可 | 本页下方 |
支持的文档类型
| 类型 | 典型用途 | 当前能力 |
|---|---|---|
| Word | 公文、合同、报告、通知、笔录 | 编辑 / 只读 / 修订 / 批注 / 模板填充 / 比对 |
| Excel | 报表、台账、数据表、统计单 | 编辑 / 只读 / 提交表单 |
| PPT | 汇报、培训、方案演示 | 编辑 / 只读 |
打开和保存后的文件类型与原文档一致，支持主流办公格式及其同类格式。
终端环境要求
- 操作系统：Windows 桌面环境；
- 客户端：一次性安装 ATKONOFFICE 桌面客户端（轻量安装包，支持静默批量分发）；
- 编辑引擎：复用本机已安装的 Office 组件（MS Office / WPS Office），客户端不捆绑、也不改动既有安装。
数据不出域
这是 ATKONOFFICE 的立身之本：文档字节，自始至终只在企业自有基础设施内流动。
文档存储（自有） ◀────────────┐
│ ① 取出字节 │ ④ 保存落盘
▼ │
业务后端（服务端 SDK） ───────┘
│ ② 下发字节 ▲
▼ │ ③ 编辑结果回传
终端用户电脑（桌面客户端 + 本机 Office 组件）全过程只在业务后端与终端用户电脑两个企业自有端点之间流动，ATKONOFFICE 的组件只是「管道与容器」，不沉淀数据：
- 文档托管：不提供——文档存在集成方自有存储里，厂商看不到；
- 签名密钥：拉起链在业务后端签发，密钥永不下发浏览器；
- 下载凭据：一次性、短时效；
- 网络隔离：支持完全内网部署，不依赖公网回连。
典型场景
- 政务公文：起草 / 审阅 / 签批在内网完成，留痕可回流；
- 合同定稿：多轮修订 + 两版比对对照，内容不上第三方平台；
- 报表填报：预置格式模板，只读或受控编辑，防公式被破坏；
- 知识库 / 教学材料：在线维护、保存回自有存储，数据不出内网。
以上为能力示意，具体编排由业务系统决定。