更新日志

本页记录轮虫协议参考实现（@rotifer/playground）的完整版本历史和发布日志。

版本总览：Rotifer 共有 7 个历史版本系列，超过 30 次发布。 完整版本列表：v0.1.0（首发）、v0.2.0（竞技场）、v0.3.0（WASM 编译）、v0.4.0（云端）、v0.5.x（P2P + 声誉）、v0.7.x（稳定化）、v0.7.9（信任盾）、v0.8.0（Iron Shell）、v0.8.6（CLI 运行时 Bugfix）、v0.9.0（Open Mesh + 经济基座）、v0.10.0（P2P 可靠性）、v0.10.1（发布管线修复）、v0.10.2（async 基因拦截）、v0.11.0（回滚与卸载）、v0.12.0（调用遥测）、v0.13.0（插件最小权限）、v0.13.1（遥测排除测试运行）、v0.14.0（接入 DeepSeek Harness）、v0.14.1（安装命令修正）、v0.15.0（分数来源记录）、v0.16.0（Arena 审计工具）、v0.17.0（Arena 作废判定落地）、v0.18.0（榜单评估分层）、v0.19.1（官方基因归属恢复）、v0.19.2（unpublish 修复与 L0 门控覆盖）、v0.20.0（Skill 公开源码）、v0.21.0（init 补全与 L0 来源判定修复）、v0.21.1（测试基建修复）、v0.22.0（燃料阶梯与 Hybrid 宿主函数预览）、v0.22.1（Arena watch 与助手可靠性修复）、v0.23.0（匿名使用心跳 + 调用渠道字段）、v0.23.1（心跳未真正发出的修复）、v0.23.2（心跳超时校准）、v0.24.0（当前公开版本——wrap 默认询问是否发布）。以下是每个版本的详细变更记录。

v0.24.0（2026-08-31）— 当前版本（wrap 默认询问是否发布）

• rotifer wrap 现在会主动询问是否发布：基因打包完成后会问”Publish ‘<gene>’ to Rotifer Cloud? [Y/n]“（直接回车即视为同意），三条完成路径——普通、--from-skill、--from-clawhub——均覆盖。以下情况会跳过该询问并附一句说明：没有交互终端或处于 JSON 输出模式、未登录、Native 基因尚未编译、或 Hybrid 基因未配置 network.allowedDomains。

v0.23.2（2026-08-31）— 心跳超时校准

心跳请求默认给 2 秒就放弃，比真实网络里 TLS 握手常见耗时还短，导致真实上报被判超时中止；改为 8 秒（依据 10 次真实请求实测）。

v0.23.1（2026-08-31）— 匿名心跳未真正发出的修复

rotifer run 与 rotifer agent run 成功退出时，尚未发完的心跳上报会被进程退出直接打断，v0.23.0 刚上线时数据库因此长期零流量；现在两条命令都会等上报结束（或超时）再退出。同一修复顺带堵上了”上报端点无响应会让命令挂起不退出”的隐患。

v0.23.0（2026-08-30）— 匿名使用心跳 + 调用渠道字段

• 匿名使用心跳：未登录也会上报一条不含身份信息的心跳（本机是否活跃、走哪个渠道），默认开启，ROTIFER_TELEMETRY=0 可关闭；首次运行会明示提示。
• 调用账本加渠道字段：登录后的调用记录现在区分来自 CLI 还是各 MCP 宿主（Cursor / Claude Code / DSH 等），此前一律记成来源不明。

v0.22.1（2026-08-29）— Arena watch 与助手可靠性修复

• rotifer arena watch 改读分层榜单：此前走的旧路径不识别已作废的分数，作废后的排名仍会继续滚动显示。
• rotifer.dev AI 助手：修复因缓存了未完整生成的回答导致偶发截断，以及一次因配置遗漏导致的约两小时服务中断。

v0.22.0（2026-08-29）— 燃料阶梯与 Hybrid 宿主函数预览

• 计算密集型基因不再因固定燃料预算被评测判负：一次运行若仅因燃料耗尽而失败，会自动升到更高预算档重试——墙钟与内存限制不变，实际烧掉的燃料仍如实计入效率项。公开评测账本新增失败原因字段（fuel-exhausted / memory-exceeded / timeout / crash），资源上限与基因缺陷从此分得开；rotifer test 与 Arena 准入走同一套阶梯。被旧常量卡住的 evolve-life 系列已通过准入、以 0.3.0 重新上架。
• Hybrid 宿主函数预览：Hybrid 基因可声明 rotifer.net / rotifer.kv / rotifer.env 能力模块——非标准预览、默认全拒：部署方未授权或表型未声明就不链接任何能力，Native 基因引用它们会被直接拒绝。

v0.21.1（2026-08-24）— 测试基建修复

维护版本，不改变任何使用方式：修复项目的变异测试基建（自 v0.19.2 起一直无法启动），该质量门自此在每次发版时恢复运行。

v0.21.0（2026-08-23）— init 补全与 L0 来源判定修复

• rotifer init 补全推荐模板依赖的基因：推荐首条命令（rotifer hello --template quality-advisor）依赖的 gene-health-scanner 现随五个创世基因一同装入新工作区；此前该命令在所有新建工作区上都会失败。README 演示块已同步为真实命令输出。
• L0 门控按安装渠道判定来源：门控不可用时，仅当云端清单由 install 写入才视为外来基因并拒绝执行；publish 回执（自己上传的记录）放行并警告。此前只要存在清单即拒绝，导致无原生插件的机器上内置创世基因全部无法运行。清单不可读或含混时仍拒绝；run、test、hello 共用同一判定。
• 守护人纸条多语言：开发者档案的守护人纸条支持译文，每条译文钉在其对应的原文上；纸条修改后过期译文自动停用，页面回退到原文。中文页面现已提供中文版本。
• Node 版本要求修正为 >= 22.18：基因为 TypeScript 且 CLI 直接从源码导入执行，需要 Node 内置的类型剥离；此前声明的 >= 20 在该路径上实际不可用。更老 Node 的支持另行跟踪（#270）。

v0.20.0（2026-08-22）— Skill 公开源码

• Skill 源码公开：rotifer-guide、rotifer-agent、rotifer-arena 的源码迁入 skills/ 目录并接入 CI，按 tag 发布；此前源码不对外可读。新增 rotifer-gene：基因开发手册（express 函数、表型 schema、发布前安全审计、保真度迁移）。
• README Status 行跟随发布版本：此前停在 v0.10.1（注册表已是 0.19.2）；校验现纳入发布管线。
• 插件名称统一：Cursor 与其他宿主一致使用 rotifer。

v0.19.2（2026-08-21）— unpublish 修复与 L0 门控全路径覆盖

• rotifer unpublish 修复：自 v0.16.0 起每次调用均报「Published gene version is immutable」——数据库守卫恰好禁止修改该命令唯一要改的列。下架与重新上架现为带所有权校验的授权操作，并记录操作者。
• L0 门控覆盖所有执行路径：此前仅在基因已编译且沙箱开启时生效；未编译基因、--no-sandbox、原生插件静默加载失败三种情况均可绕过。
• 门控不可用不再等同于全部拒绝：门控跑不了时，外部安装的基因仍拒绝，本地基因放行并警告（判定在 v0.21.0 进一步细化）。
• 插件列表命名修正：内置 evolve Skill 与 CodeBuddy 列表不再占用属于其他组件的名称。

v0.19.1（2026-08-20）— 官方基因归属恢复

v0.19.0 含相同变更但未到达 npm（打 tag 后发布管线故障）；v0.19.1 是首个可安装版本。

• 59 个官方基因恢复可管理：rotifer-protocol 档案原绑定的 GitLab 账户被封禁，占注册表 32% 的基因无法重发、下架或编辑。所有权已迁移至可登录账户；对外名称与 /developers/rotifer-protocol 不变，旧档案改名留存备查。档案新增守护人纸条，说明身份运营者及沿革。
• 声誉重算覆盖已清空的创作者：不再持有任何基因的创作者此前会无限期保留最后分数（曾在创作者榜单产生幽灵重复项）。
• 过渡期分数标记为 estimated：适应度输入中仍有两项为过渡常量期间，提交按估算记录，不作为实测呈现。

v0.18.0（2026-08-20）— 榜单评估分层

• 榜单行标注评估层级：verified（沙箱或绑定运行时实测，且有足量独立调用方）、under_evaluation（已实测、使用证据不足，层内排序）、not_evaluated（未实测、已判作废或 estimated 分数）。not_evaluated 行不参与排名、不显示分数。
• R(g) 过滤作废分数：声誉此前不加过滤地读取最新 Arena 记录（权重 0.70），作废分数经声誉、开发者总分与竞技场胜场数回流。榜单与 R(g) 现共用同一判定函数，并由测试钉住两者一致。

v0.17.0（2026-08-19）— Arena 作废判定落地

• 104 条 Arena 记录中 59 条判作废：30 条构件不可执行、27 条无已发布构件、2 条为测试数据。记录保留并标注判定条件与时间，不做删除；构件扫描记录所读字节的 SHA-256，可与发布时哈希核对的 33 条全部吻合。
• 历史分数来源全部归类：早于来源列的 104 条记录按写入路径的数值指纹分类（发布占位值 / 哈希估算 / 沙箱实测 / 手工录入），104 条全部匹配。
• 保真度折扣生效：F(g) = base_fitness × 折扣（native 1.00 / hybrid 0.85 / wrapped 0.70），规范 v2.11 已有要求但此前从未接线；记录存储 base_fitness 与折扣，参数调整后仍可重建。
• Hybrid 基因按 Hybrid 编译：compile 不再强制走 WASM 工具链（Hybrid 在 Node 下运行并注入网络网关）；Wrapped→Native 改写保留，并会明确提示。

v0.16.0（2026-08-19）— Arena 审计工具

• rotifer arena audit：直接运行分数作废判据，全部输入免凭证可读，第三方可复现相同结论；当前只读，作废落地为单独授权步骤。
• rotifer unpublish 命令接入：接入时一并修复静默成功缺陷——行级安全策略下更新零行不报错，下架他人基因曾显示成功；现回读变更行，空结果报错并说明原因。
• 重复计数探针：列出去重窗口内同一调用方对同一基因的连续调用；守卫正常时列表为空，窗口常量与守卫同源。
• 内置基因恢复可编译：50 个中 38 个可构建（此前 17 个）；成因为装饰性 async 入口与表型拆分遗留的枚举值。其余 12 个逐项列明，回归测试钉住豁免清单只减不增。

v0.15.0（2026-08-18）— 分数来源记录

• Arena 分数带测量方式：写入路径声明测量方法、服务端仅证实可验证的部分、每次运行的证据随分数一同公开；记录新增来源与作废列。
• 调用上报幂等：重试的调用不再重复计数（五秒窗口）。
• 测试套件与真实凭证隔离：每个测试文件将 HOME 重定向到一次性目录；此前登录状态下跑全量测试会被 logout 测试删除本机凭证。
• DeepSeek Harness 条目更名：mcp-rotifer 改为 rotifer-mcp，两个条目一次检索即可同时找到。

v0.14.1（2026-08-18）— 安装命令修正

• DeepSeek Harness 改为从仓库安装：原命令引用的 npm 包有意不存在（npm 上的 rotifer 是防冒名的占位包）；README 与生成的配置均注明原因。

v0.14.0（2026-08-18）— 接入 DeepSeek Harness

• 第五个插件宿主：已服务 Cursor、CodeBuddy、OpenClaw、Claude Code 的插件现同源同版本地支持 DeepSeek Harness；插件仅声明挂载宿主自带的 skill provider 与 MCP bridge，不含我方运行时代码，携带与其他宿主一致的十工具 evolve 集。

v0.13.1（2026-08-18）— 遥测排除测试运行

• 测试运行不计入使用量：上报器识别 VITEST、JEST_WORKER_ID、NODE_ENV=test（含被测试拉起的子进程）即静默；CI 有意不在此列——流水线里的调用是真实使用。
• 依赖安全通告修补：捆绑的 HTTP/2 crate 升级至不受 RUSTSEC-2026-0258 影响的版本。
• ClawHub 显示名写入清单：「Rotifer」不再依赖发布时旗标；测试同时守护 id 与显示名。

v0.13.0（2026-08-18）— 插件最小权限

• MCP server 固定版本 + 十工具集：插件不再以浮动版本启动全部 31 个工具（含 publish_gene、login 与沙箱逃逸开关）；内置 Skill 补充说明安装需经确认、工具可达范围、数据流向与升级回退方式。插件同步发布至 ClawHub。
• OpenClaw 端 MCP 注册修复：配置字段原位于宿主不读取的位置，迁至 package.json#openclaw，校验器不再告警。
• 失败运行同样计入上报：process.exit(1) 不再中断上报请求，失败与成功一并记录。

v0.12.0（2026-08-17）— 调用遥测

• CLI 上报基因执行：rotifer run 与 rotifer agent run 记录云端安装基因的每次执行——协议使用度与反操纵指标的数据来源。本地自建基因永不上报、仅登录时上报、设 ROTIFER_TELEMETRY=0（或 false / off）可完全关闭。
• 空结果不再计为 Arena 通过：成功判定新增「输出满足基因声明的 outputSchema」；违反契约的运行单独提示并说明原因。

v0.11.0（2026-08-17）— 回滚与卸载

• rotifer rollback 与 rotifer uninstall：把基因退回之前的版本，或从工作区移除。
• 调用计数修复：服务端计数因类型不匹配始终静默失败、计数恒为初始值；已修复并附回归测试验证计数确实递增。

v0.10.2（2026-08-14）— async 基因拦截

• 运行时拒绝 async express()：WASM 沙箱无事件循环，async 基因返回空对象而各项信号均显示成功，Arena 亦计为通过；现执行前即拒绝并提示三条出路——改同步 express() 重新编译、--no-sandbox 走 Node、或发布为 Hybrid 基因。编译器自 E0025 守卫起已拦截该写法；早于该守卫发布的构件若报此错，说明其从未产出过真实结果，改同步重编译即可。

v0.10.1（2026-08-11）— 发布管线修复

维护版本，不改变任何使用方式：修复 package-lock.json 未指向新发布平台包、导致从仓库拉代码执行 npm ci 失败的问题；安装与升级 CLI 不受影响。

v0.10.0（2026-08-11）— P2P 可靠性

• 节点记住已知伙伴：重启后自动重拨已认识的伙伴，引导地址仅节点首次运行需要。
• 引导失败不再静默：移除指向不存在主机的默认引导地址，改为显式传入 rotifer network start -b <multiaddr>；当前尚无公共 Rotifer 网络，需自行组网——参见 P2P 局域网演示。
• 节点识别与连接限制：节点间交换 Identify，并限制入站连接数与内存。

P2P 仍默认关闭（enabled: false）：除非明确要求，CLI 不会加入任何网络。

v0.9.0（2026-06-22）— Open Mesh + 经济基座

一个大版本：CLI 开始支持 P2P，v0.9 经济基座同步落地。

• P2P 基因传播（实验性） — CLI 现在能运行真实的 libp2p 节点。rotifer network start / announce / received 让同一局域网内的节点互相发现、传播基因公告。这是 P2P 网络栈第一个可运行的步骤；自动发现和跨公网连接是后续里程碑。
• rotifer doctor — 工具链健康检查命令，在构建前提示缺失或配置错误的依赖。
• 混合保真度（Hybrid Fidelity）基因 — 基因现在可以声明外部依赖、降级行为和仿真规格，描述在环境不可用时如何表现。
• 发布时自动安全徽章 — rotifer publish 现在会自动上传基因的 V(g) 安全扫描徽章（可用 --skip-vg 跳过）。
• 经济体系 + 赛季制 — 声誉动态、自动赛季重置、适应度/权重展示，落地 v0.9 经济基座。
• 登录修复 — CLI 登录回调现在能可靠绑定到白名单本地端口，修复了部分用户遇到的超时。

v0.8.6（2026-04-21）— CLI 运行时 Bugfix + 原生插件分发

修复 4 个 CLI 运行时 Bug，并首次在所有主流平台发布预构建原生二进制包。

• Javy async Gene 修复 — async express() 基因不再崩溃并报 “Pending jobs in the event queue”；编译阶段现在会检测 async 用法并输出清晰错误提示
• 编译缓存修复 — rotifer compile 现在能检测源文件变更并重新编译；此前编辑 index.ts 后仍会静默复用旧 gene.wasm
• irHash 序列化修复 — phenotype.json 中含 irHash 的基因在原生（wasmtime）执行路径上不再失败；hex 字符串与字节数组不兼容的问题已解决
• WASM 沙箱燃料修复 — 默认燃料从 1M 提升至 500M，内存上限至 256 MiB，超时至 60s；Javy/QuickJS 基因在简单工作负载下不再报 “fuel exhausted”
• 原生插件分发 — 预构建 .node 二进制现在通过平台专属包发布（@rotifer/playground-darwin-arm64、-darwin-x64、-linux-x64-gnu、-win32-x64-msvc）；npm install 自动选择正确的二进制——无需本地 Rust 工具链

v0.8.5（2026-04-08）— 生态对齐

首个让 CLI、MCP Server、VS Code 扩展、文档和安装片段统一呈现同一版本号的发布。

• 统一安装体验：npm install -g @rotifer/playground、npx @rotifer/mcp-server 和 VS Code 扩展均指向同一 v0.8.5 版本面——工具间不再有版本不一致
• Skill→Gene 迁移路径文档化：rotifer wrap --from-clawhub 工作流和 Skill 迁移指南现已纳入公开文档
• CLI 更新通知：CLI 现在会在有新版本时提示用户升级
• IDE 分发清理：插件族和市场元数据在 VS Code Marketplace 和 Open VSX 之间保持一致版本

v0.8.0（2026-02-17）— Iron Shell

安全加固、P2P Protocol RFC、Epoch 自动化、AI 文档助手，30+ 项交付物。

• Supabase 深度安全审计：覆盖 Hybrid Gene 网关、WASM 上传、Edge Function、Reputation RPC、Badge Worker、V(g) 扫描器、Gene Registry、MCP 调用统计等全部攻击面
• WASM 沙箱逃逸测试：15+ 项安全测试——内存越界、无限循环、Host Function 滥用、资源耗尽、畸形 IR
• P2P Protocol RFC：完整设计文档——传输层（QUIC/libp2p）、发现（mDNS + Kademlia DHT）、GossipSub 消息、Sybil/Eclipse 防护、Cloud Binding 协作
• 安全 Checklist 机制：可复用的版本级安全检查清单模板，集成 CI 和发布流程
• Epoch 自动化：pg_cron 每日声誉计算 + 每月衰减，幂等 compute_all_reputations() RPC
• ContributionMetrics 数据模型：反操纵就绪的贡献度量（gene_invocation_log、gene_contribution_metrics）
• LLM-Native Gene 标准：Prompt Gene + Guard Gene Phenotype 定义（ADR-084）
• Evolution API Level 1.5：Gene 推荐 + Arena 可观测性 REST 端点
• AI 文档助手：rotifer.dev 上的 RAG 驱动对话组件，含频率限制、内容过滤、缓存和分析
• WebMCP Phase 1：10→14 个 Agent-ready 市场工具，含 auth + confirm 对话框
• 基础设施韧性：GitLab→GitHub CI 迁移、Forgejo 迁移准备、Cloudflare Pages 部署管线

v0.7.10（2026-03-24）

安全加固、WebMCP 扩展、中国市场就绪。

• Schema 兼容性检查：Seq 管线的静态类型检查——验证输出→输入 schema 对齐，提供 PASS / UNCHECKED / FAIL 诊断
• Try Fallback 错误传播：Try 操作符现在将结构化 {error, original_input} 传递给回退基因，而非裸输入
• WebMCP Phase 1：10→14 个工具——4 个新增写入型（L3）工具：set_gene_visibility、request_arena_evaluation、create_gene、update_gene_metadata，需 auth + confirm 对话框
• 路径穿越防护：rotifer init 现在拒绝包含 ../ 序列的项目名
• 中国网络指南：中文入门文档，含 cnpm 镜像安装和 Supabase 延迟说明
• CI 管线加固：修复部署配置、Node 20 兼容性、网络依赖测试容错

v0.7.9（2026-03-20）

协议成熟度的重要里程碑，信任基础设施。

• 安全徽章管线：自动化验证门控 V(g)，为基因生成可视化安全徽章
• 云端竞技场：全球适应度排名与实时竞争
• Agent 蓝图：导出/导入完整的 Agent 配置（基因组 + 竞技场状态）
• MCP Server：@rotifer/mcp-server 实现 IDE 集成（Cursor、VS Code、Windsurf 等）
• 网络命令：rotifer network announce、network discover、network pull 支持 P2P 基因共享
• 声誉系统：按生态阶段加权的信任排序 R(g)，作为适应度 F(g) 的补充维度（时间衰减计划于 v0.9）

v0.7.x（2026-03-19 → 2026-03-20）

聚焦稳定性和开发者体验的快速迭代系列。

• v0.7.0 → v0.7.9：逐步改进 CLI 可靠性、错误提示和文档
• 云端绑定稳定化和端点配置
• 竞技场排名算法优化

v0.5.x（2026-02-23 → 2026-02-24）

• 声誉基础：引入 R(g) 声誉评分机制
• P2P 基础：GossipSub 元数据广播、Kademlia DHT 发现
• 水平逻辑传输（HLT）：跨 Agent 基因共享基础设施
• 组合算子：Seq、Par、Cond、Try、Transform 支持多基因流水线

v0.4.0（2026-02-23）

• 云端绑定：基于 Supabase 的云端注册表，支持基因发布与发现
• rotifer login / rotifer publish / rotifer search / rotifer install
• 云端竞技场：rotifer arena submit --cloud 全球竞争
• GitHub OAuth 认证

v0.3.0（2026-02-22）

• 自动 TS→WASM 编译：rotifer compile 通过内置 IR 编译器自动将 TypeScript 基因编译为原生 WASM — 无需单独安装 Rust/WASM 工具链
• Rotifer IR：自定义 WASM 段（rotifer.version、rotifer.phenotype、rotifer.constraints、rotifer.metering）
• WASM 沙箱，支持燃料计量和纪元中断

v0.2.0（2026-02-22）

• 本地竞技场：基于适应度的基因排名系统 F(g)
• rotifer arena submit / rotifer arena list
• L0 宪法约束：安全门控强制执行
• 基因准入测试管线

v0.1.0（2026-02-20）

首次发布 — 核心基因生命周期。

• rotifer init — Agent 工作区脚手架，包含创世基因
• rotifer scan — 函数兼容性检测
• rotifer wrap — 函数到基因的转换，生成 phenotype.json
• rotifer test — 沙箱测试，含 schema 验证
• rotifer compile — Rotifer IR 编译（手动 WASM 输入）
• 内置五个创世基因：genesis-web-search、genesis-web-search-lite、genesis-file-read、genesis-code-format、genesis-l0-constraint

版本策略

轮虫协议遵循语义化版本规范：

• 主版本（1.x）：协议级别的不兼容变更
• 次版本（0.x）：新功能，向后兼容
• 修订版本（0.0.x）：Bug 修复和改进

当前状态：Pre-1.0 — 协议正处于积极开发阶段。次版本之间的 API 可能会发生变化。

路线图

即将到来的里程碑（可能调整）：

版本	重点方向	状态
v0.22.0	评测不再用自家燃料常量判负基因；Hybrid 宿主函数预览	当前
v0.21.x	新工作区能跑通推荐首条命令；L0 门按安装渠道判定来源	已发布
v0.20.0	已发布的 Skill 有了公开源码，并新增第四个	已发布
v0.19.2	撤下一个版本这次真的撤得下来；L0 闸门覆盖每一条执行路径	已发布
v0.19.1	官方基因有了能登录的归属；幽灵声誉分被清理	已发布
v0.18.0	判决走到页面：榜单分层，R(g) 不再计入被扣下的分数	已发布
v0.17.0	判据被执行：59 条记录退出排名、历史记录回填溯源、F(g) 带上保真度折扣	已发布
v0.16.0	Arena 完整性——作废判据成为可运行的代码，内置基因语料重新可编译	已发布
v0.15.0	分数溯源——Arena 记录自己是怎么测出来的	已发布
v0.10.1	发布管线修复（package-lock 同步）	已发布
v0.10.0	P2P 可靠性——节点记住伙伴、消除静默引导失败	已发布
v0.9.0	Open Mesh + 经济基座	已发布
v0.8.6	CLI 运行时 Bug 修复（Javy async、编译缓存、irHash、燃料）+ 全平台预构建原生二进制	已发布
v0.8.5	CLI、MCP Server、VS Code 扩展和文档的版本面统一；Skill→Gene 迁移路径	已发布
v0.9.1	P2P 发现层（mDNS、DHT、公网）	规划中
v1.0	稳定发布 — L0–L3 完整、≥2 Binding、≥100 Gene、安全审计	规划中