v1.6.0 — 发布自动化与插件市场审计

v1.6.0（2026-09）— 发布自动化与插件市场审计

• 一键发版：新增 scripts/release.py（--dry-run 预览 / --bump 升版 / commit+tag+push+
  GitHub Release），并新增 scripts/check_release.py 作为版本一致性门禁（CI 每次 push 运行）。
• 插件市场审计：新增 scripts/audit_plugin_repo.py，检查市场制品是否含缓存/编译产物/
  超大文件，并校验内置插件与市场同名插件的元数据同步；支持 --check/--strict 门禁。
• 市场打包规范：build_packages.py 默认排除 tests/、缓存与隐藏目录。
• 维护者文档：新增 docs/RELEASING.md（发版闭环）与 docs/PLUGIN_REPO.md（市场规范），
  并登记进文档中枢；docs/README.md 增加发版指南入口。
• 测试：新增 tests/test_release_automation.py、tests/test_plugin_repo_audit.py、
  tests/test_version.py 版本门禁（共 17 项）。
• CI 增加 Release consistency 步骤（python scripts/check_release.py）。

v1.5.0 — 发布闭环与质量修复

v1.5.0（2026-09）— 发布闭环与质量修复

• 版本一致性门禁：新增版本一致性测试，语义提交含 vX.Y.Z 时校验
  app.__version__、CHANGELOG 标题与本地 tag 三者同步，防止「代码已发但版本未发」。
• AI 共享 client 超时修复：共享 HTTP client 的缓存键纳入超时，避免 60s 会话 client
  被 120s 的图像/语音/TTS 调用复用导致长任务提前超时；无事件循环时也能正确关闭旧 client。
• Agent 记忆语义恢复：AgentRunner.max_memory_turns 重新生效（此前固定为 20），
  移除失效的 _MAX_MEMORY_PER_SESSION 常量。
• 插件重载回滚修复：新插件加载失败回滚到旧实例时，重启旧插件的后台任务，
  保证回滚后插件功能完整。
• 进程沙箱协程治理：跟踪插件子进程能力调用任务，stop() 时统一取消与回收，
  消除未跟踪协程泄漏。
• 市场插件测试 lint 统一：修复 calc/order/reminder 插件测试的导入排序与未使用导入，
  ruff check plugin-repo/plugins 全绿。
• 市场制品排除测试：build_packages.py 打包时排除 tests/ 目录，发行包更精简
  （order_ledger.zip 体积下降，内容仅保留运行时文件）。
• 重新构建全部市场插件包并刷新 registry.json，--check 校验通过。

v1.4.0 — 插件开发体验升级（OFbot 重写问题修复）

背景

依据 docs/OFBOT2_PLUGIN_ISSUES.md 的 13 项实测问题，对插件开发体验做系统性升级，分三阶段落地。

阶段一（P1）：声明与配置体验

• 指令冲突检测与解决：plugin conflicts 全量扫描；加载期不再因冲突失败——后加载插件冲突命令自动注册为 <插件名>.<命令>（如 /order_ledger.分账），system 插件命令保留，conflicts 支持 rename/skip 显式覆盖；Web「插件」页冲突徽标 + GET /api/v1/plugins/conflicts
• 权限角色映射 permission_roles：权限点只授予指定角色，默认行为向后兼容
• 配置驱动定时任务：任务参数支持 ${a.b.c} 模板，保存配置重载即生效；ctx.register_managed_task 让运行时任务进入 Web「定时任务」页
• config_schema 强校验：保存前补默认值并按 JSON Schema 校验，失败返回字段级错误；配置表单支持递归渲染嵌套对象

阶段二（P2）：数据与参数

• records list() 新增 filters（gte / lte / contains / in）与 sort_by
• ctx.register_models 随 init_db(extra_models=...) 真正建表
• 命令参数新增 type: "rest" 贪婪字符串（剩余参数合并）

阶段三（P3）：运行与测试工具

• 文本转图 ctx.text_image()（Pillow）+ OneBot 群文件上传 upload_group_file
• 命令/任务/监听 handler 声明 ctx 参数即自动注入 PluginContext
• 定时任务 target 支持按群列表门控（["group:a", "group:b"]）
• 重载时模型/任务声明变化给出明确告警
• 新增 app.testing.FakeBotHarness 插件端到端夹具与 CLI plugin e2e
• 命令级 max_arg_length 覆盖全局参数长度限制

插件

• 新增 order_ledger 插件（OFbot 重写：通用订单管理与记账/分账，适用于代打/代购/拼单等任意订单场景），内置并收录插件市场（general 分类）；与市场 stats/commission 插件共存时命令自动命名空间化，不冲突不加载失败
• 全量 303 项测试通过、order_ledger 端到端 12 条指令通过、ruff 与 compileall 全绿

v1.0.5

v1.0.5（2026-08）— 工程与文档收尾

• 测试补齐：roles 路由 Web 流程、plugin_state 读写、capability_setup 内置能力注册、example_ai 声明式加载。
• scripts/benchmark.py 接入 CI（仅输出报告，不设硬性门槛）。
• docs/API.md 重新生成，路径数对齐实际（171 路径 / 184 操作）。
• scripts/dev.ps1 门禁与 CI 对齐（compileall/ruff 纳入 ofbot2 包）。
• docs/PRESETS.md 重写：明确 15 个示例已转正为官方插件，examples 仅作脚手架。
• plugins/example_ai 改写为声明式（features + handlers.py），保持 /ask 行为。

v1.0.0

v1.0.0（2026-08）— 首个正式发布

首个公开发行版本：版本号重整（3.x 阶段归入预发布演进），支持 pip install ofbot2 与 python -m ofbot2，仓库公开、CI 全绿、i18n 覆盖全部后台页面、15 个示例插件转正为官方插件。

核心能力一览：

• 多协议多账号并存：OneBot v11/v12、Red、Satori、Mirai、QQ 官方机器人，连接独立启停、按群绑定账号路由出站。
• 监听环境作用域：逐群/私聊三态功能开关、权限覆盖、黑名单、静默模式，与群内 /功能启用|禁用 命令同源生效。
• 声明式插件模型：plugin.json 声明 features / commands / rules / session / tasks / listeners，handler 点分符号加载期校验，配套 plugin check / dev / test 工作流。
• 通用能力组件：记录中心、状态机、聚合、导出、审计、文件、备份；Agent 工具循环与流程引擎可组合业务。
• 一体化 Web 后台：22 个管理域（连接 / 作用域 / 角色 / 插件 / 插件市场 / 流程 / AI / 任务 / 审计 / 备份…），服务端渲染 + 原生 JS。
• 可观测与安全：trace_id 链路贯穿、Prometheus 指标、审计日志、告警模板、登录锁定与 CSRF、命令三级限流、插件安装安全审计（静态检查 + SHA-256 校验）。
• 插件生态：官方插件 25 个（含本版本由示例转正的 15 个），插件市场支持 URL / 本地双数据源。

3.x 阶段（v3.0.0–v3.6.0）为预发布演进，详细条目见下方历史段落。