# 更新记录 Changelog

本文件使用 [Keep a Changelog](https://keepachangelog.com/zh-CN/1.1.0/) 风格编写，版本号遵循[语义化版本](https://semver.org/lang/zh-CN/)。

## [Unreleased]

### 界面

- **卡片操作按钮重构** — 市场卡片操作区调整：
  - **README 按钮只保留图标**（去掉文字，悬停提示 README）；
  - **发布页按钮改为主页**：优先打开插件官网（homepage），无官网则回退到仓库/包页面，带小房子图标；
  - 两个按钮左对齐（README 图标 + 主页）；
  - **安装键改为拆分下拉**：主按钮直接安装，右侧小箭头展开菜单（安装 / 通过指令安装）；点「通过指令安装」从 host 拉取 CLI 安装指令（`dsh plugin --profile <name> add <spec>`，npm 名优先），在**独立窗口**中以**等宽字体**显示，窗口**最右侧有快捷复制按钮**（复制成功显示 ✓）。
- **SSR 修复** — `useHubPresent` 的 `useSyncExternalStore` 补上 `getServerSnapshot`，修复服务端渲染（render test / 首屏）抛 "Missing getServerSnapshot" 的问题。

### 优化

- **源连接提速** — GitHub 目录搜索页数从 5 页减到 3 页（300 个仓库足以覆盖全部 dsh 插件候选，第 4/5 页几乎全是顺带打标的无关仓库）；npm 双 registry 改为「任一成功即返回」（默认源与镜像内容一致，慢镜像不再拖慢整体）；配合已有的 GitHub/npm/awesome 三族并行竞速，目录拉取耗时进一步下降。
- **安装/更新真实进度条** — 新增 host Remote `installProgress`：pnpm 运行期间 host 实时解析输出（`Progress: resolved/downloaded/added` → 下载安装阶段百分比，构建脚本 → 构建阶段，`Done in` → 收尾），client 每 800ms 轮询并更新底部进度条，显示**真实阶段文案 + 百分比 + 已耗时**，替换之前的假扫动动画。安装、更新、卸载都接入。
- **安装失败提示增强** — pnpm 的 `allowBuilds` 门控（阻止插件安装脚本）是常见失败原因：现在检测到该模式会给出明确中文指引（在 profile 的 pnpm-workspace.yaml 把包加入 allowBuilds 后重试，或改用已发布的 npm 包），而不是笼统的 "pnpm add failed"。
- **风险不强制停止** — 安全审计发现高危风险时不再静默拦截：弹出风险明细，用户点「我已知晓」后以 `allowRisky` 继续安装（旧版 DSH 运行时风险同理）。审计产物下载失败时降级为跳过审计继续（fail-open），避免网络抖动导致安装失败。

### 兼容性

- **DSH 0.1.2-alpha.1 兼容修复** — DSH Desktop 升级到 2.0.4（内置运行时 0.1.2-alpha.1）后，`@deepseek-ai/dsh-client-runtime` 已拆分为 `dsh-client-connection`（运行时入口）+ `dsh-client-store`（`defineStore`）。两个市场插件的 `dsh.client.inject` 从 `dsh-client-runtime` 改为 `dsh-client-connection`；client bundle 的 `defineStore` 依赖改用 `@deepseek-ai/dsh-client-store`（由 Web shell 静态模块提供，无需 inject）。新增 `scripts/test-alpha1-compat.mjs` 固化审计：inject 包可解析、client require 全部命中 seed/图、4 个 keyed slot 与运行时声明一致、`settings.section` / `sidebar.footer.action` / `shell.overlay` 与 `ctx.remote.$mount` API 保留。

### 新增

- **插件分类筛选（多选）** — 市场视图新增「分类」按钮行：点击按钮即可按分类筛选，支持**多选组合**（再次点击取消选中），「全部」一键清除。分类取自 awesome-dsh-plugin 目录的 `### 分类` 标题；无分类的条目归入「其他」。筛选仅作用于市场平铺视图，分类分组的 awesome 视图保持原样。
- **pnpm 进度解析测试** — 新增 `scripts/test-pnpm-progress.mjs`，断言 `Progress:` 行的 resolved/downloaded/added → 百分比映射、构建阶段、完成阶段。

## [1.5.2] - 2026-09-02

### 界面

- **市场页底部进度条改版** —— Kidai Hub 中纪代市场的进度条**固定在内容列底部**（绝对定位钉在面板底边），**无单独底色**、直接透出面板背景；内容区（插件网格）在进度条上方滚动，**不与进度条重叠**。
- **不再拦截点击** —— 进度条容器加 `pointer-events:none`，即使进度条未显示，内容区底部插件操作按键（启用 / 停用、卸载等）也能正常点击。
- **Kidai Hub 样式注入修复** —— Hub 的 `<style>` 注入改为「内容不一致即刷新」，避免软刷新后旧 CSS 残留导致样式不生效。

### 稳定性

- 保持与 DSH 0.1.2-alpha.1 / rc.8 运行时的兼容。

## [1.5.1] - 2026-09-02

### 界面

- **市场页底部进度条改版** — Kidai Hub 中纪代市场的进度条从内容流中改为**钉住面板底边**（`position:absolute; bottom:0`），仅在右侧内容列内横向铺开、不越过左侧边栏，去掉卡片底色、直接透出面板背景。安装 / 更新等长任务进行时始终固定在窗口底部显示。

## [1.3.5] - 2026-08-20

### 变更

- **孤儿卡片改为两行紧凑布局** — 「已安装」页下方未挂载插件区块的卡片调整为**两行**：第一行图标 + 插件名 + 「未挂载」徽标 + 操作按钮（启用/删除）横向并排，第二行完整显示原因文本（可换行）；宽度与正常卡片一致（280px 网格），高度大幅压缩、无多余空白。窄视图行样式不变。
- **CSS 热更新修复** — 修复 HMR 重建后页面仍使用旧 `<style>` 的问题：每次加载时若已注入的样式与最新 CSS 不一致则直接更新内容，样式改动即时生效，无需重启或清缓存。

### 新增

- **孤儿区块结构测试** — 新增 `scripts/test-orphan-section.mjs`，断言孤儿区块独立容器、标题、宽/窄网格、徽标、启用/删除操作及两行布局样式，防止后续改动破坏布局。

### 兼容性

- **keyed-slot 自动修补扩展至 rc.8 全部 4 个** — 修补范围从仅 `settings.plugin.item` 扩展到 `settings.plugin.item`、`conversation.chat.node`、`conversation.chat.commandview`、`tool.view.cordis`，旧插件在 rc.8 下注册这些 slot 而缺 `key` 时会被自动注入（与 1.3.4 兼容性说明一致，作为正式支持固化）。

## [1.3.4] - 2026-08-20

### 兼容性

- **DSH rc.8 兼容确认**：核对 npm 上 `@deepseek-ai/dsh*` 的 rc.8 发布（2026-08-19），`dsh-typert-protocol` 与 `dsh-api-gateway` 的 rc.7→rc.8 代码完全一致（Remote/SRC 协议零变化），`sidebar.footer.action` slot 保留；KPMH 的 5 个 client 注入包均有 rc.8。**无需代码调整即可在 rc.8 运行**。
- **keyed-slot 修补扩展**：自动修补范围从仅 `settings.plugin.item` 扩展到 rc.8 的全部 4 个 keyed slot（`settings.plugin.item`、`conversation.chat.node`、`conversation.chat.commandview`、`tool.view.cordis`），旧插件在 rc.8 下注册这些 slot 而缺 `key` 时会被自动注入。

### 文档

- README 补充「部署环境支持」章节：确认 **Desktop 应用**与**独立 Web 部署**（`dsh --profile web`）均可完整使用全部功能；Web 部署需通过 `dsh` 命令启动（自带 `--expose-internals`），唯一差异是「立即重启」按钮在无 Electron 环境下降级为手动重启提示。

### 新增

- **孤儿插件管理（未挂载文件）** — 扫描"文件存在但未挂载"的插件（`scanOrphanPlugins`），以灰色行并入「已安装」列表，支持：
  - **启用**（`mountOrphan`）：把已声明依赖但被禁用/未挂载的插件重新挂载——加回 `dsh.profile.bundles` 并清除 HOME 用户补丁层中的 `disabled` 行；
  - **删除**（`removeOrphanFiles`）：删除未声明依赖的残留文件（node_modules 目录 + vendor 副本 + `@local` junction），不修改依赖清单；已声明依赖的自动转完整卸载。
- **入口校验硬化** — 安装与孤儿挂载都会校验插件能解析出**真实入口文件**（`main` / `exports["."]` / Node 默认 `index.js`）。声明 `dsh.bundle.patch` 但没有任何可加载入口的包（例如伪装成插件的部署脚本仓库）会在安装/挂载时被拒绝，杜绝"整个插件树启动失败"（misakanet 故障模式）。
- **GitHub 不可达时自动走 tarball 下载** — 探测 `github.com` 可达性（5 秒），不可达时普通 GitHub 仓库安装自动改用 tarball 下载链（codeload → ghproxy → ghfast → gh-proxy），避免 `pnpm` 的 git 协议在不可达网络上挂起数分钟。
- **`workspace:` 依赖子包识别** — monorepo 内部包（依赖 `workspace:` 协议）无法脱离仓库构建时给出明确中文提示（建议安装已发布的 npm 版本），而非笼统的构建失败。
- **子包构建失败清理** — 构建失败后删除半成品 `.kidai-vendor` 副本，不残留孤儿目录。

### 修复

- **卸载 `@local/*` 链接插件** — 之前卸载 tavern 这类以 `@local/<包名>` 作为加载器名的插件会报"未在依赖清单中,无法卸载"。现在自动归一化为真实包名执行 `pnpm remove`，并清理 `@local` junction。
- **卸载后的悬空 junction 残留** — `pnpm remove` 删除真实目录后，`@local` junction 变为悬空（`existsSync` 对悬空 junction 返回 false 导致清理被跳过）。现在直接用 `rmSync(force)` 清理，按普通包名卸载时也会清理 `@local/<短名>` junction。
- **patch 行清理覆盖加载器 entry id** — 卸载时通过 `ctx.loader.entries()` 反查加载器 entry id（如 tavern 的 patch 行 id 为 `tavern`，既不是真实包名也不是 `@local` 名），确保对应 patch 行被正确移除。

### 变更

- 旧版运行时（rc.6）插件的运行时兼容检查从"直接拒绝"改为**风险确认流程**：无 `allowRisky` 时返回 `riskConfirmRequired` 并弹窗说明；用户点「我已知晓」后放行，自动应用 keyed-slot 修补并安装，成功消息附带风险提示。
- `@local/<包名>` 引用不再要求用户手动创建 junction — 安装时自动创建。

## [1.2.0] - 2026-08-18

### 新增

- 侧边栏启动器（`sidebar.footer.action`）+ 独立全屏 Hub 页面（`shell.overlay`）双页签界面（插件市场 / 已安装）。
- 多源目录：GitHub `topic:dsh-plugin` 搜索、npm 搜索、awesome-dsh-plugin 精选列表，5 分钟内存缓存 + 离线落盘缓存。
- 搜索 / 排序 / 每插件卡片 / 发布页跳转。
- 一键本地安装（`pnpm add` + `dsh.profile.bundles` 收敛）、启用 / 禁用、打开本地目录、检查更新、单插件更新、README 查看。
- 静态安全审计（`auditPackage`，高危拦截）。
- 顶部「立即重启」两步确认。

## [1.1.0] - 2026-08-18

### 新增

- 首个正式发布：Host + Client 双端插件框架、Remote 方法骨架、目录抓取基础链路。