哪种 .NET 查看器许可证才是您真正需要的？完整指南

当您终于发布了一个干净、版本受控的 API 时，下一个挑战往往是 文档查看器。功能集合通常恰到好处，但许可模式却可能成为隐藏的绊脚石，导致团队、合作伙伴或客户的采用受阻。

在本文中，我们将为 Doconut .NET 文档查看器的三种核心许可选项——Developer、Site 和 SDK——进行解密，并提供一个实用的决策框架，帮助您一次性选择正确的方案。

---

目录

1. 为什么 API 文档的许可证很重要
2. 开发者许可证 – 适合小团队
3. 站点许可证 – 跨门户扩展文档
4. SDK 许可证 – 将查看器嵌入您自己的产品
5. 决策矩阵：快速检查表
6. 最终思考与后续步骤

---

为什么 API 文档的许可证很重要 {#为什么-api-文档的许可证很重要}

• 合规性： 许可证不当会触发审计警报并产生意外费用。
• 性能： 某些方案解锁高级渲染管线（OpenAPI 3.0、Swagger、RAML）和实时协作，让文档保持流畅。
• 可扩展性： 随着组织的成长，费用模型应当能够演进，而不需要对文档流水线进行彻底重构。

选择错误的许可证不仅会推高成本，还可能限制功能——例如跨仓库的 Git 同步、基于角色的编辑或白标品牌，这些在现代 DevOps 工作流中至关重要。

---

开发者许可证 {#开发者许可证}

谁应该考虑它？

• 独立开发者 或 小团队（1‑5 名工程师）在构建内部工具或概念验证。
• 只需要 一个查看器实例 嵌入单个应用。
• 文档与单一代码库紧密耦合的项目。

核心功能

功能	对项目的意义
原生 API 规范渲染	开箱即支持 OpenAPI、Swagger、RAML，具备完整语法高亮。
实时协作编辑	实时共同创作仅限单个项目；适合快速迭代。
无限可搜索文档	为项目中的所有 markdown、HTML 或 YAML 文件建立索引，实现瞬时查找。
Git 同步	一对一仓库同步——推送更改、拉取更新，并保持版本历史与代码一致。

价格概览

• 每位开发者每年 199 美元（固定费用）。
• 无座位或实例额外费用。

何时放弃

如果您预见到：

• 多个文档站点（客户门户、合作伙伴文档），或
• 超出单一仓库的扩展，

开发者许可证很快会成为成本瓶颈。

类比： 这就像一颗单杯咖啡胶囊——完美满足一杯咖啡，但要为繁忙的办公室准备整台机器。

---

站点许可证 {#站点许可证}

谁应该考虑它？

• 企业团队 运营多个内部工具、公共 API 门户或供数百用户访问的知识库。
• 需要 统一品牌 和跨所有文档入口的统一访问控制的公司。

核心功能

功能	受益
无限查看器实例	在任意数量的网站、内联网或 SaaS 门户上部署查看器。
集中许可证管理	仪表盘可在组织范围内分配、撤销和审计许可证。
全团队实时编辑 + RBAC	细粒度角色（作者、审阅者、管理员）强制治理。
多仓库 Git 集成	连接单体仓库或分散的仓库，保持每套文档同步。
优先支持 & SLA	24 小时响应窗口，保证最小停机时间。

价格概览

• 基础套餐： 每年 4,999 美元，最多 20 个站点。
• 额外站点： 每站点每年 250 美元。

何时值得投入

• 您运营一个 公共开发者门户，需要与生产 API 保持同步。
• 内部知识库是 数十个团队的唯一真相来源。
• 手动文档更新的成本超过订阅费用。

类比： 从单车库升级到完整停车场——有足够空间扩展，无需每次都临时停车。

---

SDK 许可证 {#sdk-许可证}

谁应该考虑它？

• 为 商业产品 嵌入 .NET 查看器的供应商（例如桌面 IDE、云控制台、本地平台）。
• 需要 白标化 并拥有完整源码，以定制查看器品牌的团队。

核心功能

功能	解锁内容
完整源码访问	修改渲染管线、UI 组件，或集成专有身份验证。
无限分发	将查看器发送至任意数量的终端用户安装，无需每座位费用。
白标化	移除 Doconut 品牌，应用自定义主题，控制外观与感受。
专属技术客户经理	提供集成指导、性能调优及路线图对齐的直接渠道。

价格概览

• 一次性费用： 12,499 美元，永久使用权。
• 可选维护费： 每年 2,999 美元（包括更新、安全补丁和支持）。

何时是最佳选择

• 您产品的 价值主张 依赖于内嵌文档（例如在 Visual Studio 扩展中内联显示 API 规范）。
• 您需要 无限分发——查看器随每一份软件一起交付。
• 品牌一致性和 源码级定制 是不可妥协的要求。

类比： 为自己的汽车购买发动机块——前期投入大，但您拥有动力系统的全部所有权，想开多远都行。

---

决策矩阵：快速检查表 {#决策矩阵-快速检查表}

问题	推荐许可证	原因
查看器会出现多少个不同的地方？	开发者 → 1‑2 处 站点 → 3+ 处	站点许可证消除实例限制。
是否需要将查看器交付给终端用户？	SDK	无限分发和白标化。
是否需要品牌或源码访问？	SDK	完整源码访问并可移除品牌。
您偏好的费用模型是什么？	开发者 → 按年每座位 站点 → 按年站点整体 SDK → 前期一次性投入	与预算周期保持一致。

技巧： 将此矩阵放入项目简介或 Sprint 计划文档中，可快速确定合适的许可证，免去与销售反复沟通的时间。

---

最终思考与后续步骤 {#最终思考与后续步骤}

选择正确的 .NET 查看器许可证并非 “一刀切” 的决定。它基于三大支柱：

1. 部署范围 – 单个应用 vs. 多门户 vs. 产品集成。
2. 分发需求 – 仅内部使用或随商业产品一起提供。
3. 预算周期 – 持续年度支出 vs. 前期资本投入。

将团队的工作流、增长轨迹和财务约束与上表列出的功能对齐，您即可避免日后昂贵的许可证升级，并保持文档流畅。

准备好锁定合适的许可证了吗？

1. 访问 doconut.com/pricing 并使用交互式选择器。
2. 下载 许可证选择工作表，将决策矩阵的答案映射进去。
3. 如需更深入的了解，安排一次 15 分钟的设计电话，我们的解决方案工程师将现场演示协作编辑、API 规范渲染和 Git 同步功能。

祝文档写作顺利，愿您的 API 如同许可证般得到妥善支持！