MCPane v0.4.0

新增

• 工作区页每个工具下多了「触发提示」。MCP 服务器自带的描述通常只说这个工具"能做什么"，
  而 AI 挑工具时看的是"什么时候该用"——这一句就是补上后者，写完追加在原描述后面，
  原描述一个字不改。比如给网页抓取工具写上「需要实时网页内容时用，优先于内置搜索」，
  AI 就更容易在该用的时候想起它
• 工作区的「使用准则」可以投递到客户端自己的规则文件了（Claude Code 的 CLAUDE.md、
  Codex 与 ZCode 的 AGENTS.md、Gemini CLI 的 GEMINI.md）。此前准则只是随连接下发，
  客户端读不读由它自己决定；投递进规则文件则和你手写的规则同等分量。默认不投递，
  要一个一个勾；只改 MCPane 自己那段标记区块，你写的内容不会被碰，随时可以撤销。
  其中只有 Claude Code 我们实测确认它会读这个文件，其余三家会带一句「未实测该客户端
  是否真的读它」——投递后请自己确认准则有没有生效，我们不想让你以为配好了而其实没有。
  另外准则改了但还没重新投递时，那一行会标「内容已过期」（多个工作区各有各的准则，
  文件里躺着的可能是另一个工作区那份）
• 规则存在应用内部、MCPane 写不进去的客户端（Cursor、VS Code、Cline、Trae、Qoder、
  Claude Desktop、Devin、Qwen Code、CodeBuddy），清单里照样列出来，点「怎么加」
  就有照着做的步骤——去哪儿找这个设置、放哪个文件、要不要额外加点什么，配一个按钮
  把准则文本复制成可以直接粘的样子。没核实过规则位置的几家会直说没核实，
  不给你一条可能是错的路径
• 请求日志的统计多了「按工具」和「按客户端连接」两栏：接进来的工具到底有没有被用、
  哪个客户端调得多哪个调得少，一眼看得出来
• 客户端页接入了国内的 AI 编程客户端：Trae、Qoder、Qwen Code、CodeBuddy、ZCode。
  和其他客户端一样，点「接入」把 MCP Hub 写进它的配置，写入前先看对比、写入后可回滚，
  Token 在这张卡的「凭证」里发放。Trae 认国内版（Trae CN）也认国际版，装了哪个用哪个；
  Trae 与 ZCode 的配置不做环境变量展开，默认的环境变量模式下写的是占位串，
  需要把 Token 手动填进去
• 客户端页可以手动添加 MCPane 还没内置的 MCP 客户端。点右上角「添加客户端」填个名字，
  它就有了自己的卡片：发 Token、单独配访问控制、在日志里按连接查它的调用，
  都和内置客户端一样（token 用量只有 Claude Code 与 Codex 有，那要读它们的会话文件）。
  接入方式是把「使用说明」里的配置片段贴进那个客户端自己的 MCP 配置——它的配置文件
  在你手上，MCPane 不去改。删除客户端会一并吊销它名下已发出的全部 Token
• 项目页与访问控制里，自定义客户端的连接显示它自己的名字，不再统一显示成「custom」
• 请求日志可以点开看参数和返回。密钥类字段会脱敏，超长内容会截断。升级前写下的旧记录只有元数据，点开后会说明这一点
• 工具可以自己补「注解」了。有些 MCP 服务器不申报工具注解，这类工具在 Codex 的
  非交互模式（codex exec）下调不动——Codex 会把它当成需要人工点头的工具，而非交互
  模式没人可点，于是每次都报「用户已取消」。现在这类工具行会标上「无注解」，点行尾的
  「注解」勾选这个工具的行为就能正常调用。实测 Codex 只看「只读」这一项——工具确实
  不改动任何东西的话，勾这一个就够，剩下几项可以不填。
  工作区页和 MCP 服务器页的工具面板都能标；后者还会在顶部提示这个服务器有几个工具
  没申报注解，刚装完服务器就看得见。标一次对所有工作区生效。你标的注解记在你名下、
  和服务器自己申报的分开存；服务器之后要是自己申报了，以它的为准

变更

• 开了「工具动态发现」的工作区，如果工具总数不多（80 个以内），客户端现在会直接拿到
  完整的工具列表，不再需要先搜索再调用。少绕两步，AI 更容易真的把工具用起来；
  工具多到一次装不下时才会切回按需检索。想固定用某一种，仍可在客户端凭证里
  单独指定「平铺」或「网关」
• 开机自启改为默认开启。装完或升级后第一次打开 MCPane，会写入系统登录项，登录后在托盘常驻、不弹窗口。不想要的话仍可在设置里关掉，关掉之后不会再被自动打开
• 请求日志页重排。工具名不再和服务器名重复一遍，成功的调用只留一个安静的对勾，
  失败的直接标出错误类别；耗时排在这批调用尾部的会用琥珀色标出来，一眼看得出哪几次慢。
  统计窗口、成功率与分组统计收进同一张卡，时间窗切换器也跟页面其他地方长得一样了
• 调用详情里的参数和返回改成带语法高亮的 JSON，键名、字符串、数字各有颜色，
  两段上下排开，长的返回不再挤在半边窗口里
• 请求日志的每一行现在看得出能点开：行尾常驻一个箭头，不用把鼠标移上去才知道。
  失败的调用在行首标一道红杠，扫一眼左边就能把出错的挑出来；跨天的日志按
  「今天 / 昨天 / 具体日期」分段，每段写明当天调用了多少次、失败几次，
  不用再靠时分秒去猜哪条是前天的。列表上方的条数后面也跟上了失败数。
  键盘也能用：Tab 进表格后上下键换行、回车打开详情，关掉详情焦点回到刚才那一行
• 所有弹窗关掉后，焦点都回到打开它的那个按钮，不再掉回页首

修复

• 日志里一次工具调用不再记成两条。用「网关」方式暴露工具的客户端，每调一次工具都会
  留下两条几乎一样的记录——一条 mcpane__tool_execute，一条真正被调用的工具，
  时刻相同、耗时只差一两毫秒，统计里的请求数与平均耗时也跟着虚高。现在只记真正被
  调用的那一条；调用被拒（工具被禁用、名字打错、访问控制拦下）照旧留痕
• 客户端页里 Claude Code 与 Claude Desktop 不再是两个一模一样的图标。两者共用
  Anthropic 的同一个标，此前只能靠卡片标题分辨，现在图标右下角分别带上终端与显示器的小角标
• 打开某条请求的详情不会再让日志页整个白掉。连接来自未识别的客户端（或那条连接
  已被删除）时，图标查不到图会导致整页渲染失败
• macOS 登录项现在显示 MCPane 的图标和名字，而不再是一个没有应用图标的可执行文件
• 客户端版本号不再显示成「已安装 v?」。用 nvm、volta、bun 等装的 Claude Code
  与 Codex，从 Dock/Finder 启动 MCPane 时读不到版本，概览页只能显示一个问号；
  现在概览页、客户端页与设置页「本地环境」都能正确显示版本号和安装路径。
  万一确实读不出版本，也只写「已安装」，不再摆一个像是出了故障的问号
• Windows 上客户端的安装与版本不再看走眼。更新 MCPane 后重启，你自己装的
  Claude Code、Codex 曾会集体显示「未安装」，非得从开始菜单完整重启一次才回来；
  用 winget 或官方独立安装器装的客户端此前也一直认不出。现在检测看的是
  和终端一样的完整 PATH，官方安装位置也一并扫
• 某个客户端的命令卡住，不再拖住整个本地环境检查。此前只要有一个 CLI
  --version 不返回（装坏的 Node 版本、抢锁的 npm），本地环境面板就会一直转圈；
  现在单个客户端最多探 10 秒，超时的那个标为跑不起来，其余照常显示
• 「装了好几份」的提示补全了 PATH 上的那一份，以及 pip 用户级安装的 Hermes
• Windows 更新不再中途失败。此前安装到一半可能弹出
  「Error opening file for writing: ...\mcpane-hub.exe」，只能中止或忽略——
  后台服务进程没被关干净、占着要被覆盖的文件。现在更新前会先停掉它，
  安装程序也会自行确认文件可写，更新一次装到底
• 卸载 MCPane 时会一并结束后台服务进程，不再留下占用端口的残留进程
• Windows 上强制结束 MCPane（或应用崩溃）后，会一并结束后台服务以及它
  拉起的 MCP Server，不再留下占着端口的残留进程
• Windows 上后台服务还在跑时，偶发的控制面瞬断不再被当成「已死」而强杀重启
• 从 Microsoft Store 或 MSIX 安装的 Claude Desktop，设置页不再显示成未安装
• Windows 退出或更新时，后台服务会先按正常流程停掉（收尾 MCP 会话和数据库），等不及才强制结束。此前只能直接杀掉进程
• 关掉后台服务后，设置页不再多等一秒才显示已停止
• 从开始菜单启动时，也能找到用 pnpm 装到用户目录里的命令

MCPane v0.3.2

新增

• 首次提供 Linux 版本（AppImage，x86_64）

修复

• 恢复 Windows 版发布。上一版 0.3.1 因打包问题只发布了 macOS，Windows 用户
  升级到本版即可一并获得 0.3.1 的全部修复（Dock/Finder 启动后服务器状态与
  客户端安装状态显示错误、下游重连失败误伤既有连接、操作失败无明确提示）
• macOS 用户由 0.3.1 升级至本版没有功能变化

MCPane v0.3.1

修复

• 通过 Dock 或 Finder 启动 MCPane 时，依赖系统命令（如 npx）的 MCP 服务器可能长期停留在「启动中」，客户端页亦可能将已安装客户端误报为「未安装」。现已修正启动环境与安装探测逻辑，状态显示与实际安装、运行情况一致。
• 下游 MCP 服务器重连失败时，不再错误中断仍可用的既有连接，避免工具列表在短暂重连失败后意外全部不可用。
• 连接异常、云同步以及桌面端操作失败时，界面将返回明确错误原因，而不再以空状态或无反馈的加载中断结束，便于定位问题。

MCPane v0.2.1

变更

• Windows：托盘图标左键改为直接打开主窗口，与系统惯例一致
  （此前左键右键都是弹菜单）

修复

以下均为 Windows 平台修复，macOS 不受影响。

• 只改一个配置项，整份文件的换行符却会被改写——用 Git 管理 dotfiles 的话，
  会看到 settings.json / config.toml 全文变成变更。现在保持文件原有
  行尾不动，界面里的写入预览也如实显示真正会落盘的内容
• 用记事本或 PowerShell 保存过的配置文件无法接入，报
  「expected value at line 1 column 1」；现在可以正常读写
• 「一键配置」对从 Microsoft Store 安装的 Claude Desktop 不生效：界面显示
  已接入，实际写去了应用读不到的位置；现在按实际安装方式定位
• 发放 Token、撤销、删除连接、切换工作区等操作弹出「控制面响应解析失败」，
  但操作其实已经生效，容易误以为失败而重复执行；现在如实报告成功
• 用 ChatGPT 账号登录过 Codex 的话，切换供应商必然失败并报一串凭据错误；
  现在正常
• 探测客户端、启动 MCP Server、云同步时会闪一下黑色命令行窗口；已消除
• 关闭或重连 MCP Server 后，相关进程残留在后台占着端口和文件，
  只能去任务管理器手动结束；现在会随操作一起完全退出
• 系统里装有 Microsoft Store 的同名占位程序时可能被误识别，
  启动客户端时弹出的是商店页面；现已跳过这类占位程序
• 中文系统下部分客户端的版本号显示为空；已修复

安全

• Windows：收紧本机控制通道与含凭据文件（配置、快照、auth.json）的
  访问权限至仅本人与系统可用，与 macOS 版一致。共享电脑和远程桌面
  场景下多一道防线

MCPane v0.2.0

新增

• Windows 版首发（x64，需 Windows 10 1803 及以上）。
  这是第一个 Windows 版本，遇到问题欢迎提 Issue

变更

• 设置页「数据」分区按「本机数据 / 本机备份 / 云同步」重新组织，更好找
• 日志与用量分别显示已积累多少条、覆盖到多早，以及按当前保留期
  会清掉多少；清理按钮直接写明这一下会删多少条
• 自动备份的固定行为（每 24 小时一次、保留最近 10 份）现在直接写在界面上
• 云同步设置收纳为一行卡片，选择 WebDAV / S3 后才展开详细配置
• 界面里的日期时间跟随所选语言显示，中文界面不再出现
  Jun 11、08:41 PM 这类格式
• 清理日志 / 用量、删除备份等破坏性操作统一先弹确认，并写明影响范围

修复

• 云同步选「关闭」后并没有真正关闭：界面显示已关，后台自动同步照常运行，
  重新打开设置又变回原样；现在关闭即生效
• 请求日志的保留期界面写 7 天、实际按 30 天清理，两处不一致；已统一
• 用量数据此前从不自动清理；现在与请求日志一样按保留期清理
• 从云端备份恢复后，已接入的客户端不再断开，本地服务自动恢复衔接
• 云同步上传的内容不再包含明文凭据
• Codex 用量统计虚高约 18%（分叉会话被重复计算）；已修正
• OpenCode / OpenClaw 的供应商切换功能恢复正常
• Grok 断开中转站时恢复你原本设置的默认模型，不再被静默清空
• SOCKS 代理探测一直显示失败（恒红）的问题
• 配置文件是符号链接时（比如用 chezmoi / stow 管理 dotfiles），
  写入不再把链接替换成普通文件，而是写入链接指向的真实文件
• Hub 离线时，工具开关会置灰并提示该去哪里处理，而不是点了没反应

已知限制

• 安装包未经代码签名：macOS 首次打开需在「系统设置 → 隐私与安全性」
  点「仍要打开」；Windows 首次运行需在 SmartScreen 提示里点
  「更多信息 → 仍要运行」。放行一次即可，后续升级由应用内自动更新接管

MCPane v0.1.0

首个公开预览版，发布 macOS（Apple Silicon 与 Intel）。0.x 期间配置结构与
数据格式仍可能调整，升级前建议在设置页导出一次备份。

MCPane 是 Claude Code、Codex 与 MCP 工具的统一控制面，这一版包含：

• 统一 MCP Hub——MCP Server 只配一次，所有客户端共用同一个本地入口
  http://127.0.0.1:24860/mcp，各自独立 Token 与会话。支持 stdio、
  Streamable HTTP、SSE 三类 Server；工具很多时可开启动态发现，
  避免大工具集占满模型上下文
• 八家客户端一键接入——Claude Code、Claude Desktop、Codex、Gemini CLI、
  Grok、OpenCode、OpenClaw、Hermes。按各家原生格式（JSON / JSONC / JSON5 /
  YAML / TOML）读写，你手写的注释、未知字段与键序原样保留
• 供应商管理——官方订阅与第三方中转分开管理、一键切换，
  支持配额查询、节点测速、模型列表拉取
• 精细控制——按 Project / Workspace 逐条启停 Server 与
  Tool / Prompt / Resource，工具与提示词可设别名
• 配置安全——每次写入前自动快照、原子写入，任何一次变更可回滚；
  配置被其他工具改动时会提醒，绝不静默覆盖
• 观测——请求日志（已脱敏）、近 24 小时统计仪表、会话成本估算
• 数据——本地自动备份，可选 WebDAV / S3 云同步
• 桌面体验——简体中文 / English 双语、浅色 / 深色主题、系统托盘常驻、
  开机自启、首次使用分步引导
• 自动更新——应用内检查、下载、安装，更新包经签名校验；
  可在设置页关闭自动检查

已知限制

• 本版仅发布 macOS（Apple Silicon 与 Intel 分别打包），最低 macOS 12.0。
  Windows 版正在准备中
• 安装包未经 Apple 公证，首次打开会被系统拦下，需在
  「系统设置 → 隐私与安全性」中点「仍要打开」