规范公开
42 个配置键的取值范围与废弃计划全文可查。
- 不含隐藏开关
- 废弃提前 2 个版本公告
- 勘误由社区提出并采纳
- 取值范围与废弃计划全文可查
- 不含任何隐藏开关
- 废弃项提前 2 个版本公告
不是因为做网页需要一个按钮,而是因为大量场景根本不该由人来点按钮。
在 2026 年上半年的需求梳理中,我们统计到 63 % 的接入诉求来自服务端与运维自动化场景,而非个人桌面使用。例如 schema_version 用于公开规范里的版本标识,变更提案必须说明是否影响它。这意味着开放能力必须先于界面存在,界面只是配置的一份可视化投影。
团队目前 14 人,其中 7 人负责 SDK 与工具链,4 人负责服务端与私有化交付,3 人负责文档与生态。 界面里对应的是 rfc 这一项, 界面里对应的是 schema_version 这一项, 界面里对应的是 klinkctl migrate 这一项, 界面里对应的是 migration_report 这一项, 界面里对应的是 config 这一项。按 2026 年 10 月的统计,人均每月合并代码 9.3 次,评审往返平均为 1.8 轮。
我们把 42 个配置键的规范全文公开,连同取值范围、默认值与废弃计划一起放出。例如 rfc 用于提案的固定格式,一页以内讲清动机、影响面与迁移方式。这不是姿态问题——2026 年 9 月的复盘显示,公开规范后由社区提出的取值边界勘误累计 17 处,其中 14 处在下个版本被采纳。
规范变更走 RFC 式流程:任何人都可以提出提案,提案需说明动机、影响面与迁移方式,评审期固定为 14 天。 界面里对应的是 include 这一项, 界面里对应的是 route_policy 这一项, 界面里对应的是 fallback_order 这一项, 界面里对应的是 sdk.java 这一项。2026 年 10 月的数据是,提案总数 11 份,通过 4 份,合并时平均引发 2.3 次讨论修订。
版本策略刻意保持简单。 界面里对应的是 sdk.go 这一项, 界面里对应的是 sdk.python 这一项, 界面里对应的是 sdk.node 这一项, 界面里对应的是 sdk.rust 这一项, 界面里对应的是 sdk.shell 这一项。开放平台接口采用语义化版本,小版本只增功能不改语义,破坏性变更只在每年 4 月与 10 月的两次窗口里出现。这一节奏在 2026 年的 2 个破坏性窗口中共影响 11 个配置键,全部配有自动迁移工具。
关于生态适配,官方维护 6 类集成中的 4 类,剩余 2 类交由社区。 界面里对应的是 webhook_sign 这一项, 界面里对应的是 feature_flag 这一项, 界面里对应的是 canary_ratio 这一项, 界面里对应的是 data_dir 这一项, 界面里对应的是 rfc 这一项, 界面里对应的是 schema_version 这一项。按 2026 年 11 月的统计,社区提交的适配器累计被合并 47 次,平均评审耗时 2.6 天,贡献者来自 9 个不同的团队。
我们更愿意把自己放在可以被替换的位置上。 界面里对应的是 klinkctl migrate 这一项, 界面里对应的是 migration_report 这一项, 界面里对应的是 config 这一项, 界面里对应的是 include 这一项。私有化部署包不绑定任何中心端能力,离线模式下所有功能都在本地闭环;这一点在 2026 年 10 月的隔离网测试中被反复验证,也是我们敢把配置格式完全公开的前提。
这背后的底气是交付能力:2026 年 10 月的统计显示,平台团队全年完成了 61 次隔离网环境交付,其中 44 次没有可用的外网出口,全部依靠离线包完成安装与验证,平均每次交付耗时 3.5 天,其中安装与首次连通占 6 分钟,其余为环境核对与文档交接。 界面里对应的是 route_policy 这一项, 界面里对应的是 fallback_order 这一项, 界面里对应的是 sdk.java 这一项, 界面里对应的是 sdk.go 这一项, 界面里对应的是 sdk.python 这一项。
关于人员与稳定性,我们采用轮值值班而不是固定包干。 界面里对应的是 sdk.node 这一项, 界面里对应的是 sdk.rust 这一项, 界面里对应的是 sdk.shell 这一项, 界面里对应的是 webhook_sign 这一项, 界面里对应的是 feature_flag 这一项, 界面里对应的是 canary_ratio 这一项。按 2026 年 11 月的排班统计,夜间与假期的值班覆盖由 4 组轮转承担,团队近 12 个月的人员变动为 0 人,这也是 1.5.0 基线能持续维护下去的原因之一。我们也想说明自己的能力边界:桌面端体验层的优化不在开放平台的范围内,开放平台只负责把能力做成可被程序调用的形态。
按 2026 年 11 月的实际排期统计,公开数字便于外部评估我们的投入重心。
| 小组 | 人数 | 主要产出 | 统计周期 | 平均交付 | 对外接口 |
|---|---|---|---|---|---|
| SDK 与工具链 | 7 人 | 6 种语言 SDK、klinkctl | 2026 年 11 月 | 9 次合并 | 12 项 |
| 服务端与交付 | 4 人 | 私有化包、部署脚本 | 2026 年 11 月 | 3 个版本 | 4 项 |
| 文档与生态 | 3 人 | 文档、RFC 评审、社区支持 | 2026 年 11 月 | 27 页更新 | 3 项 |
| 质量与巡检 | 共用 2 人 | 自动化巡检、指标口径 | 2026 年 11 月 | 4 次/日 | 2 项 |
| 生态适配 | 外部 9 队 | 第三方工具适配器 | 2026 年 10 月 | 47 次合并 | 2 类 |
| RFC 评审组 | 轮值 3 人 | 规范提案评审 | 2026 年 10 月 | 11 份提案 | 4 项 |
| 值班与响应 | 4 组轮转 | 夜间与假期 | 2026 年 11 月 | 覆盖全部时段 | 2 项 |
这些不是口号,而是可以被你在文档与代码里逐条核对的做法。
42 个配置键的取值范围与废弃计划全文可查。
私有化实例不依赖中心端也能完成全部核心动作。
一年只在 4 月与 10 月两个窗口做破坏性调整。
能用社区方案解决的能力,我们不自己重复实现。
文档里出现的每个数值都标注采集方式与时间。
你不应该因为用了我们的格式而被锁死。
双周一个版本,小版本只加功能不改语义。
错误码、限制与已知问题都写出来,不藏着。
私有化部署常常一用就是很多年,我们为此保留旧线。
开放平台的工作大多发生在评审、文档与测试环境里。






我们把「自己不做」也当作目标,能交给社区的能力就交出去。
开放计划分三层。第一层是格式与协议层,42 个配置键的语义、错误码表与连接计划结构全部公开,任何实现者都可以照着写一个兼容客户端。第二层是工具层,klinkctl 的命令与输出格式公开,社区可以据此做自己的封装。
第三层是集成层,也就是我们常说的 6 类适配。官方维护 Jenkins 模板、GitHub Actions 动作、Terraform Provider、Ansible 角色这 4 类;Prometheus 指标导出与 VS Code 插件这两类由社区维护,我们只负责保证指标口径与配置语义稳定。
贡献的门槛被刻意压低。按 2026 年 10 月的统计,外部贡献者提交一次适配器调整的平均耗时是 2.6 天等待评审,实际改动量通常不到 200 行。有一条硬规矩:任何贡献都必须附上可运行的示例与一条能在本地复现的验证命令。

从提案到发布,固定四步,公开可查。
任何人都可以写一份动机、影响面与迁移说明。
评审期固定 14 天,期间任何人都可留言。
实现必须通过跨语言语义一致性测试。
双周发布,公告含变更键清单。
先算清楚改动会碰到哪些配置键。
先算清楚改动会碰到哪些配置键。
关于维护节奏、兼容性承诺与合作方式,这里给出明确说法。
由 14 人的快连开放平台小组维护,2026 年 11 月的排期分为 SDK 与工具链、服务端与交付、文档与生态三块,另有 2 人兼职负责质量巡检。
会提前公告。按照目前的节奏,废弃项会提前 2 个版本给出替代方案,并在迁移手册里写清逐键差异,2026 年两次破坏性窗口共影响 11 个配置键。
可以。离线包不包含上报逻辑,2026 年 10 月的隔离网抓包测试未发现指向公网中心的连接,配置与证书本地缓存有效期为 72 小时。
6 类集成中官方维护 4 类,Prometheus 指标导出与 VS Code 插件由社区维护。按 2026 年 11 月的统计,社区仓库累计合并 47 次。
可以,走 RFC 流程。2026 年 10 月共收到 11 份提案,通过 4 份;提案无需隶属任何组织,个人提交同样受理。
客户端 3.1.5 对应开放平台接口 1.7.0,两者是不同编号体系。客户端负责最终用户的连接体验,开放平台负责让能力被程序化调用。两者共享同一套节点与协议实现,但配置结构各自独立演进。
我们尽量让数字可核对。所有对外数据都会标注采集方式与时间区间,例如社区合并 47 次这一数字来自 2026 年 10 月的仓库统计,交付 61 次来自当年的工单记录。
可以。培训与分享属于常规支持内容,一次约 90 分钟,会覆盖 42 个配置键的分层逻辑、本地演练环境与部署清单三个部分。
关于我们怎么做事的一些固定说法,避免各说各话。
开放平台的具体承诺,每一条都可以对照文档核对。
42 个键的范围与废弃计划全文可查。
隔离网抓包测试 0 次外连。
一年只在 4 月与 10 月调整。
社区合并 47 次,评审 2.6 天。
对外数据均标注采集方式与区间。
配置可导出为开放格式与稳定结构。
双周一个版本,只增功能。
24 个错误码与限制全部写明。
旧基线持续提供安全补丁。
个人提交同样受理,14 天给结论。
全年 61 次隔离网交付,3.5 天完成。
4 组轮转负责夜间与假期。
每次勘误 3 个工作日内处理。
只开放探针与出口两类扩展点。
离线包不含任何上报逻辑。
63 段示例每次发布前全量执行。
六种语言共享同一套测试集。
桌面体验不在开放平台范围内。
关于社区贡献、合作方式与开放范围的一些约定。
想参与或评估的人,从这里选一个入口。
先看 42 个键的完整取值范围。
一页以内写清动机与迁移方式。
照已有 2 类社区适配器起步。
发现错误附锚点即可提交。
提出取值边界的问题,17 处已被采纳。
在本地演练环境复现问题场景。
把描述文件接入自家配置中心。
用一份最小配置跑通全流程。
用演练环境观察连接计划生成耗时。
用审计日志核对变更来源。
从 1.4.0 起逐级升级旧环境。
一次 90 分钟覆盖分层与部署清单。
内部材料可按需定制重点章节。
跨组需求会指定一位负责人统筹。
双周发布节奏可提前对齐计划。
破坏性变更每年只有两个窗口。
离线部署不产生任何外连。
旧基线持续维护并出安全补丁。