# 变更记录

本文件记录对外可见的行为变化。格式参考 [Keep a Changelog](https://keepachangelog.com/zh-CN/1.1.0/)，
版本号遵循 [语义化版本](https://semver.org/lang/zh-CN/)。

> **入仓说明**：本仓库于 **2026-10-11** 首次公开。1.0.0–1.0.4 是此前在一台开发机上连续迭代出的四个版本，
> 同一日一次入仓；下面的日期是各版本**当时的完成日**，不是公开日。

---

## [1.0.4] - 2026-10-11

### 修复

- **表格横向溢出**：根因是 1.0.3 给操作列加的 `min-width: 300`，把表格最小宽度顶过卡片容器 →
  尾部横线溢出卡片。改法四处：
  1. 去掉该强制宽度，列宽回归内容自适应（`修改｜禁用｜不可删`仍同排，因为行内 flex 仍是 `nowrap`）；
  2. 表格外套一层 `overflow-x: auto` 兜底——万一再超也只在本卡片内横向滚动；
  3. 服务名 / 行 id 加 `ellipsis` 截断（`max-width: 200`，悬停看全文）；
  4. 文案 `不可删（手写）` → **`不可删`**（悬停解释保留：手写行不能删、可改用禁用）。

## [1.0.3] - 2026-10-10

### 变更

- **操作列强制单行**（1.0.4 已取消其中的强制宽度）。
- **端点 / 命令不在列表显示**（会撑宽首列）——只保留在「修改」表单的 url 提示与悬停 title；
  首列小字恢复为仅「原手写行」。

### 修复

- 修正 1.0.2 挪位编辑引入的**括号配平错误**。

## [1.0.2] - 2026-10-10

### 安全

- **回传浏览器的路径一律符号化**（`$DSH_HOME\…`）：不再出现含用户名的绝对路径，
  `list` / `state` 均适用；单测新增断言「回传载荷不得含绝对主目录路径」。

### 变更

- **表格规整**：删除「端点 / 命令」整列，单元格禁折行。
- 手写行的「不可删」提示移到「禁用/启用」按钮**之后**
  （受管行：`修改 ｜ 禁用 ｜ [撤销覆盖] ｜ 删除`；手写行：`修改 ｜ 禁用 ｜ 不可删 ｜ [撤销覆盖]`）。

## [1.0.1] - 2026-10-10

### 修复

- **状态列误读官方字段**：应读 `fiberPhase`，且 cordis 的 `FiberState` 是**数字枚举** ——
  早先按字符串匹配全部落空，把正常行误报成"挂载 / 重连中"。

### 变更

- 状态口径改大白话：`已启用` / `已启用 · 未发现工具` / `已禁用` / `加载失败` / `未加载` / `配置冲突`；
  工具数收进悬停提示。
- 顶部备注重写为普通用户可读，并**动态显示受管行的写入路径**（`list` 回传 `paths.homePatch`）。

## [1.0.0] - 2026-10-10

### 新增

- **设置 → 侧栏「MCP 客户端」面板**：列出挂在 `@deepseek-ai/dsh-mcp-client` 下的服务器行，
  支持新增 / 改写 / 启停 / 删除。
- **两条互不越界的写回路径**：
  - 受管行（行 id 前缀 `mcpx-`）写**自有层** `$DSH_HOME/cordis.patch.yml`（全量重写、确定性渲染、原子写）；
  - 手写行走**官方通道**（`ctx.configEditor.edit()` / `ctx.pluginManager.setPluginEnabled()`），
    只改凭据族字段与启停，**不改标识与协议、不删除**。
- **三级 id 冲突检测**（活动行 / 受管清单 / 手写层文本弱扫）与 **serverName 保存前查重**。
- **漂移检测与两个逃生口**：自有层被外部改动 → 面板转只读，可「以清单为准重建」或「以文件为准清空清单」。
- **「撤销覆盖」**：把被面板改过的 profile patch 覆盖行还原为 `insert` 行的原值（官方语义：`next === inherited` 时移除覆盖行）。
- 零构建、零运行依赖（宿主半侧只用 `node:*` 与 ctx 服务；浏览器半侧用官方 module-loader 工厂格式）。

### 安全

- **url 永不回传浏览器**：只给 `协议//主机/…`，不含路径、查询串或任何 key 片段，也不透露长度。
- **stdio 的 env 取值永不回传**：只回传键名与"已设置"。
- **凭据族字段留空 = 保留原值**（未改不重写）；要改必须整段重填。
- 清单文件 `servers.json` 与生成物 `cordis.patch.yml` 均按 `0600` 写入。

### 已知限制（明示，不掩饰）

- **状态列不是健康检查**：状态 = 行阶段 + 工具数（`mcp__<serverName>__*` 计数）。
  断线重连期间工具仍会列出、调用才失败（`mcp-client` 的既定行为），因此本面板**不做协议层探活**。
- **手写行不能删、不能改标识与协议**（官方编辑服务的能力边界）；要改请手工编辑 profile patch。
- **手写行的改写落点是 profile patch**：首次追加一条顶层覆盖行、之后原地更新；
  已被覆盖的行再改 `insert` **不生效**，需先点「撤销覆盖」。
- **只覆盖 `streamable-http` / `stdio` 两种传输**；`headers`、`reconnect`、`toolCallTimeoutMs`、
  `maxInstructionBytes` 等字段仍以文件为准。