v0.2.6

更新说明

升级重点

• 插件机制做了节点本地 artifact 状态和 host compatibility 优化。升级后请先检查插件/模型供应商状态，对旧插件执行修复、刷新或安装到当前节点；如果插件仍不可用，直接重新安装插件，让本节点重新生成 artifact、checksum、manifest 和兼容性状态。
• 兼容 API 的协议转换链路已完成收口。平台会按 provider policy 完整还原 allowlist 内的客户端输入协议参数，并通过 client_protocol_envelope 传给 provider 插件，用于模拟原客户端请求上下文；例如 Anthropic/Claude Code 场景的 anthropic-version、anthropic-beta、x-claude-code-session-id 和允许的 client identity headers。平台认证、Cookie、CSRF 与 hop-by-hop headers 不会被透传。

主要变化

插件与模型供应商

• 解耦全局插件逻辑安装状态和当前 API 节点本地 artifact 状态，避免 dev、docker 或多 API 实例共用数据库时互相污染本地插件路径。
• 插件/模型供应商支持安装、更新、刷新当前节点 artifact，缺失、过期、checksum 不匹配或加载失败时会显示明确状态并阻止运行旧 artifact。
• 官方插件增加 host compatibility override，旧插件可提示修复或重新安装，降低升级后插件状态不一致带来的排障成本。

MCP 管理与接口工具（还没弄好等下一个版本，左脚踩右脚）

• 新增系统级 MCP 管理能力，补齐 MCP instance、tool 配置、目录组合和可见性 contract。
• MCP Tool 支持接口参数来源和专用 input mapping 组件，可以动态添加、删除和映射参数。
• 管理面板和 API client 同步更新，减少前端自行拼接配置导致的 contract 漂移。

公开 API、协议转换和错误语义

• 兼容 API ingress 会捕获 allowlist 内的客户端协议上下文，经 native/runtime/provider contract 传递给 provider 插件，由 provider policy 重建上游请求。
• ErrorBody 增加 status 字段，并保留真实错误 message，方便兼容 API 和 provider runtime 排障。
• provider 上游错误详情保真返回，避免把 Claude Code / Anthropic 等上游错误泛化成不可定位的 internal error。
• 新增 pat_ 用户 Personal Access Token 能力，支持按用户角色权限调用非应用 API，并补齐 API Docs Bearer 调试路径。

运行日志、归档和可观测性

• 新增正式 run archive v1 contract、完整导出 builder、ZIP 导入、chunk staging、async import job、source -> target run 映射和正式可见性门闸。
• 导入后的运行记录会进入正式运行日志列表，并重建 read model、usage、trace projection 和 conversation message projection。
• Claude Code Agent / subagent trace 分组、LLM 节点下 Agents 折叠、运行对话消息投影和缓存命中率展示做了收口。

平台治理和质量门禁

• 增加 schema hygiene、raw JSONB、log query contract、growth table 和 capacity inspection 工具与报告。
• 补齐 scoped readiness migrations、平台字段基线和相关 quality gate fixture。
• 修复 Vite lazy dependency、React doctor、frontend/backend quality gate 等回归问题。

关联提交与 issue

• Commit range: v0.2.5...v0.2.6，共 95 commits，其中 88 个非 merge commits。
• 未发现这段时间内 merged PR，关联证据主要来自 commit、release tag 和 GitHub issue。
• 重点提交：
  • a5fc60b 插件当前节点 artifact 安装/刷新能力。
  • ee96698 官方插件 host compatibility override。
  • 905d237 系统级 MCP 管理。
  • 00f5d18、2349947、c79d84f MCP 管理面板、API integration 和 input mapping。
  • 62642df、87b4c2d run archive 导入导出与 ZIP 支持。
  • a667ee4、c2657c1 错误响应 status 和 provider upstream error 保真。
  • 01737aa、3f01fe1 Claude Code agent trace 和运行对话消息投影。
  • 6d88031 client_protocol_envelope 协议转换主线提交；该提交已在 v0.2.5 前后落地，关联 issue 在本次发布窗口内收口。
• 关联 issue：
  • 插件升级/当前节点 artifact：#1016
  • 协议转换与 provider 错误保真：#1005、#1092、#1110、#1111、#1112、#1113、#1116
  • MCP 管理与接口参数映射：#770、#1043、#1044、#1045、#1046、#1047、#1048、#1049、#1138
  • 运行归档导入导出：#1093、#1094、#1096、#1097、#1098、#1099、#1100、#1101、#1102、#1103、#1104、#1105、#1106、#1107、#1108、#1109
  • PAT、API Docs 和权限面：#1052、#1053、#1054、#1055、#1056、#1057、#1058、#1059、#1060、#1061、#1062
  • schema hygiene / capacity / scoped readiness：#1017、#1018、#1019、#1020、#1021、#1022、#1023、#1024、#1025、#1026、#1027、#1028、#1029、#1030、#1031、#1032、#1033、#1034、#1035、#1036、#1037、#1038、#1039、#1040、#1041、#1050、#1051、#1063、#1064、#1065、#1066、#1067、#1068、#1069、#1070、#1071、#1073、#1074、#1075、#1076、#1077、#1078、#1079、#1080、#1081、#1082、#1083、#1084、#1085、#1086、#1087、#1088

Installation or Upgrade

Linux/macOS:

curl -fsSL https://raw.githubusercontent.com/taichuy/1flowbase/main/scripts/shell/docker-deploy.sh | sh

Windows PowerShell:

irm https://raw.githubusercontent.com/taichuy/1flowbase/main/scripts/powershell/docker-deploy.ps1 | iex

Windows CMD:

powershell -NoProfile -ExecutionPolicy Bypass -Command "irm https://raw.githubusercontent.com/taichuy/1flowbase/main/scripts/powershell/docker-deploy.ps1 | iex"

Docker Images...

v0.2.5

Installation or Upgrade

Linux/macOS:

curl -fsSL https://raw.githubusercontent.com/taichuy/1flowbase/main/scripts/shell/docker-deploy.sh | sh

Windows PowerShell:

irm https://raw.githubusercontent.com/taichuy/1flowbase/main/scripts/powershell/docker-deploy.ps1 | iex

Windows CMD:

powershell -NoProfile -ExecutionPolicy Bypass -Command "irm https://raw.githubusercontent.com/taichuy/1flowbase/main/scripts/powershell/docker-deploy.ps1 | iex"

Docker Images

• ghcr.io/taichuy/1flowbase-web:v0.2.5
• ghcr.io/taichuy/1flowbase-api-server:v0.2.5
• ghcr.io/taichuy/1flowbase-plugin-runner:v0.2.5
• ghcr.io/taichuy/1flowbase-*:latest

Traceability

• Target commit: 0d06e1f
• Workflow run: container images #27862571252
• Source branch: latest

Pull requests, linked issues, commits, and contributors are generated below by GitHub when available.

Full Changelog: v0.2.4...v0.2.5

v0.2.4

Installation or Upgrade

Linux/macOS:

curl -fsSL https://raw.githubusercontent.com/taichuy/1flowbase/main/scripts/shell/docker-deploy.sh | sh

Windows PowerShell:

irm https://raw.githubusercontent.com/taichuy/1flowbase/main/scripts/powershell/docker-deploy.ps1 | iex

Windows CMD:

powershell -NoProfile -ExecutionPolicy Bypass -Command "irm https://raw.githubusercontent.com/taichuy/1flowbase/main/scripts/powershell/docker-deploy.ps1 | iex"

Docker Images

• ghcr.io/taichuy/1flowbase-web:v0.2.4
• ghcr.io/taichuy/1flowbase-api-server:v0.2.4
• ghcr.io/taichuy/1flowbase-plugin-runner:v0.2.4
• ghcr.io/taichuy/1flowbase-*:latest

Traceability

• Target commit: 1dc8c6b
• Workflow run: container images #27858996507
• Source branch: latest

Pull requests, linked issues, commits, and contributors are generated below by GitHub when available.

Full Changelog: v0.2.3...v0.2.4

v0.2.3

Installation or Upgrade

Linux/macOS:

curl -fsSL https://raw.githubusercontent.com/taichuy/1flowbase/main/scripts/shell/docker-deploy.sh | sh

Windows PowerShell:

irm https://raw.githubusercontent.com/taichuy/1flowbase/main/scripts/powershell/docker-deploy.ps1 | iex

Windows CMD:

powershell -NoProfile -ExecutionPolicy Bypass -Command "irm https://raw.githubusercontent.com/taichuy/1flowbase/main/scripts/powershell/docker-deploy.ps1 | iex"

Docker Images

• ghcr.io/taichuy/1flowbase-web:v0.2.3
• ghcr.io/taichuy/1flowbase-api-server:v0.2.3
• ghcr.io/taichuy/1flowbase-plugin-runner:v0.2.3
• ghcr.io/taichuy/1flowbase-*:latest

Traceability

• Target commit: b231ac3
• Workflow run: container images #27676743432
• Source branch: latest

Pull requests, linked issues, commits, and contributors are generated below by GitHub when available.

Full Changelog: v0.2.2...v0.2.3

v0.2.2

Installation or Upgrade

Linux/macOS:

curl -fsSL https://raw.githubusercontent.com/taichuy/1flowbase/main/scripts/shell/docker-deploy.sh | sh

Windows PowerShell:

irm https://raw.githubusercontent.com/taichuy/1flowbase/main/scripts/powershell/docker-deploy.ps1 | iex

Windows CMD:

powershell -NoProfile -ExecutionPolicy Bypass -Command "irm https://raw.githubusercontent.com/taichuy/1flowbase/main/scripts/powershell/docker-deploy.ps1 | iex"

Docker Images

• ghcr.io/taichuy/1flowbase-web:v0.2.2
• ghcr.io/taichuy/1flowbase-api-server:v0.2.2
• ghcr.io/taichuy/1flowbase-plugin-runner:v0.2.2
• ghcr.io/taichuy/1flowbase-*:latest

Traceability

• Target commit: 1f021df
• Workflow run: container images #27530709364
• Source branch: latest

Pull requests, linked issues, commits, and contributors are generated below by GitHub when available.

Full Changelog: v0.2.1...v0.2.2

v0.2.1

Installation or Upgrade

Linux/macOS:

curl -fsSL https://raw.githubusercontent.com/taichuy/1flowbase/main/scripts/shell/docker-deploy.sh | sh

Windows PowerShell:

irm https://raw.githubusercontent.com/taichuy/1flowbase/main/scripts/powershell/docker-deploy.ps1 | iex

Windows CMD:

powershell -NoProfile -ExecutionPolicy Bypass -Command "irm https://raw.githubusercontent.com/taichuy/1flowbase/main/scripts/powershell/docker-deploy.ps1 | iex"

Docker Images

• ghcr.io/taichuy/1flowbase-web:v0.2.1
• ghcr.io/taichuy/1flowbase-api-server:v0.2.1
• ghcr.io/taichuy/1flowbase-plugin-runner:v0.2.1
• ghcr.io/taichuy/1flowbase-*:latest

Traceability

• Target commit: 8039570
• Workflow run: container images #27469467831
• Source branch: latest

Pull requests, linked issues, commits, and contributors are generated below by GitHub when available.

Full Changelog: v0.2.0...v0.2.1

v0.2.0

Installation or Upgrade

Linux/macOS:

curl -fsSL https://raw.githubusercontent.com/taichuy/1flowbase/main/scripts/shell/docker-deploy.sh | sh

Windows PowerShell:

irm https://raw.githubusercontent.com/taichuy/1flowbase/main/scripts/powershell/docker-deploy.ps1 | iex

Windows CMD:

powershell -NoProfile -ExecutionPolicy Bypass -Command "irm https://raw.githubusercontent.com/taichuy/1flowbase/main/scripts/powershell/docker-deploy.ps1 | iex"

Docker Images

• ghcr.io/taichuy/1flowbase-web:v0.2.0
• ghcr.io/taichuy/1flowbase-api-server:v0.2.0
• ghcr.io/taichuy/1flowbase-plugin-runner:v0.2.0
• ghcr.io/taichuy/1flowbase-*:latest

Traceability

• Target commit: 58eaf86
• Workflow run: container images #27459223588
• Source branch: latest

Pull requests, linked issues, commits, and contributors are generated below by GitHub when available.

Full Changelog: v0.1.12...v0.2.0

v0.1.12

Installation or Upgrade

Linux/macOS:

curl -fsSL https://raw.githubusercontent.com/taichuy/1flowbase/main/scripts/shell/docker-deploy.sh | sh

Windows PowerShell:

irm https://raw.githubusercontent.com/taichuy/1flowbase/main/scripts/powershell/docker-deploy.ps1 | iex

Windows CMD:

powershell -NoProfile -ExecutionPolicy Bypass -Command "irm https://raw.githubusercontent.com/taichuy/1flowbase/main/scripts/powershell/docker-deploy.ps1 | iex"

Docker Images

• ghcr.io/taichuy/1flowbase-web:v0.1.12
• ghcr.io/taichuy/1flowbase-api-server:v0.1.12
• ghcr.io/taichuy/1flowbase-plugin-runner:v0.1.12
• ghcr.io/taichuy/1flowbase-*:latest

Traceability

• Target commit: c726e4f
• Workflow run: container images #27425155429
• Source branch: latest

Pull requests, linked issues, commits, and contributors are generated below by GitHub when available.

Full Changelog: v0.1.11...v0.1.12

v0.1.11

Installation or Upgrade

Linux/macOS:

curl -fsSL https://raw.githubusercontent.com/taichuy/1flowbase/main/scripts/shell/docker-deploy.sh | sh

Windows PowerShell:

irm https://raw.githubusercontent.com/taichuy/1flowbase/main/scripts/powershell/docker-deploy.ps1 | iex

Windows CMD:

powershell -NoProfile -ExecutionPolicy Bypass -Command "irm https://raw.githubusercontent.com/taichuy/1flowbase/main/scripts/powershell/docker-deploy.ps1 | iex"

Docker Images

• ghcr.io/taichuy/1flowbase-web:v0.1.11
• ghcr.io/taichuy/1flowbase-api-server:v0.1.11
• ghcr.io/taichuy/1flowbase-plugin-runner:v0.1.11
• ghcr.io/taichuy/1flowbase-*:latest

Traceability

• Target commit: d168224
• Workflow run: container images #27323739730
• Source branch: latest

Pull requests, linked issues, commits, and contributors are generated below by GitHub when available.

Full Changelog: v0.1.10...v0.1.11

v0.1.10

Installation or Upgrade

Linux/macOS:

curl -fsSL https://raw.githubusercontent.com/taichuy/1flowbase/main/scripts/shell/docker-deploy.sh | sh

Windows PowerShell:

irm https://raw.githubusercontent.com/taichuy/1flowbase/main/scripts/powershell/docker-deploy.ps1 | iex

Windows CMD:

powershell -NoProfile -ExecutionPolicy Bypass -Command "irm https://raw.githubusercontent.com/taichuy/1flowbase/main/scripts/powershell/docker-deploy.ps1 | iex"

Docker Images

• ghcr.io/taichuy/1flowbase-web:v0.1.10
• ghcr.io/taichuy/1flowbase-api-server:v0.1.10
• ghcr.io/taichuy/1flowbase-plugin-runner:v0.1.10
• ghcr.io/taichuy/1flowbase-*:latest

Traceability

• Target commit: 045a22a
• Workflow run: container images #27250700008
• Source branch: latest

Pull requests, linked issues, commits, and contributors are generated below by GitHub when available.

Full Changelog: v0.1.9...v0.1.10