dsh-sidebar-suite 0.2.4 → 0.2.5

package/CHANGELOG.md

@@ -0,0 +1,55 @@
+# 更新日志 / Changelog
+
+> 版本号以 npm registry **实际发布记录**为准（当前：`0.0.0-stage`、`0.1.3`、`0.2.4`、`0.2.5`）。
+> `0.2.0`、`0.2.1`、`0.2.2`、`0.2.3` 是开发过程中的本地迭代号，**从未单独发布**；它们的功能一次性随 `0.2.4` 上线，所以在下面合并记录。
+>
+> Versions mirror the npm registry. `0.2.0`–`0.2.3` were local iteration numbers that were never published on their own; all of their features shipped together in `0.2.4`.
+
+---
+
+## 0.2.5 — 交付补齐 / Delivery polish（2026-11-10）
+
+**没有改任何运行时代码**：`lib/` 下三份脚本与 0.2.4 逐字一致。这一版只补「用户拿不到 / 项目不可维护」的缺口。
+No runtime changes — the three files in `lib/` are byte-for-byte identical to 0.2.4.
+
+- **图文教程随包发布 / Guide ships in the package** — `使用说明.md`（400+ 行中英双语）加入 `package.json` 的 `files`，README 挂了链接。以前它只存在于作者本机，市场用户更新插件也看不到一个字。The 400+ line bilingual guide is now inside the npm tarball, linked from the README.
+- **测试回仓 + CI / Tests in-repo + CI** — 5 套离线回归从临时工作区搬进 `tests/`，去掉硬编码绝对路径，任何机器都能跑；新增 `npm test` 一键入口和 GitHub Actions（push / PR 自动跑语法检查、JSON 解析、5 套回归、`npm pack --dry-run`）。The five offline regression suites now live in `tests/`, are machine-independent, and run on every push.
+- **新文档 / New docs** — 本文件 `CHANGELOG.md`；补 `v0.2.4` / `v0.2.5` 标签与 GitHub Release。
+- **市场卡片素材 / Storefront assets** — 新增 96px 方形 PNG 图标（`assets/icon-180.png`，市场规则拒收 SVG）、`screenshots.json` 与功能示意图，卡片不再回退到作者头像。A GitHub-hosted raster icon and declared screenshots (the listing refuses SVG).
+- **清理 / Cleanup** — 删除本地 `dist/dsh-sidebar-suite-0.1.3.tgz` 旧构建产物（未被 Git 跟踪；npm 上的 0.1.3 历史版本随时可取回）。Removed the stale local 0.1.3 tarball.
+
+---
+
+## 0.2.4 — 左侧栏体验成型 / The sidebar experience（2026-11-10）
+
+第一个包含全部 0.2.x 功能的公开发行版。The first public release containing all 0.2.x work.
+
+### 临时会话 / Temporary session（本地迭代号 0.2.0–0.2.2）
+- 点「**临时**」在左侧栏开一个**真正的 DSH 原生会话**（不再是自绘窗口），可并行多任务；会话窗口、模型、消息能力与新建会话完全一致。A real native DSH session instead of a self-drawn panel.
+- 退出 DSH 时自动删除；也可在详情页改成**每天定时清理**并自设时间（`SCHEDULE_DELETE` / `SCHEDULE_TIME`）。Deleted on quit, or on a user-set daily schedule.
+- 活跃会话按文件修改时间跳过，避免误删正在用的会话；删不掉的会归档隐藏，5 分钟后重试。Active sessions are skipped by mtime; stubborn ones are hidden and retried.
+
+### 兼容性 / Compatibility（0.2.1）
+- 与 `dsh-deepseek-chat` 共存：该插件要求侧栏根节点下只有 1 个顶层 `<button>`，于是把「临时」按钮装进 `data-dsbs-temp-slot`，不再触发「当前侧栏不兼容」。Wrapped the Temp button in a slot so the CHAT adapter still recognises the sidebar.
+
+### 反馈 / Feedback（0.2.3–0.2.4）
+- 详情页「反馈」框：**在 GitHub 提 issue**（预填标题正文）、**插件市场评论区**（`plugin:YONAN1269/dsh-sidebar-suite` 讨论）、**复制反馈内容**三选一；草稿存本地；报告自动带版本、DSH 客户端版本、系统、布局、路由数、最近一次错误。Three channels, draft persistence, automatic environment block.
+
+### 会话列表 / Session list（0.2.4）
+- 会话**默认全部展开**，并隐藏宿主的「展开其余 N 个会话 / 收起」按钮；通过宿主自己的按钮驱动，不改宿主 DOM。`EXPAND_ALL_SESSIONS=off` 可恢复原折叠。Always expanded, driven through the host's own overflow button.
+
+### 定位与文案 / Positioning（0.2.4）
+- 详情页头部简介（`locale/*.json`）、长篇介绍（`DETAIL.md`）、置顶设置卡、README 与 npm 简介统一声明：**这是一款专门针对改进 DSH 左侧栏体验的插件**，并逐条写明**强实用性**与**美观性**（沿用宿主 `--dsw-alias-*` 设计变量、深浅主题自动跟随、零 DOM 重构）。
+
+---
+
+## 0.1.3 — 首个公开发行版 / First public release（2026-11-06）
+
+- 三种左侧栏布局（折叠 / 标签页 / 浮层），侧栏控制栏一键切换。Three switchable sidebar layouts.
+- 插件详情页顶部直接设置**启动时的默认布局**，不用改 YAML、不用重启。Graphical startup-default picker.
+- 中英双语界面与文档、微信收款码、离线不联网。Bilingual UI/docs, offline by design.
+- 已提交插件目录收录 PR（awesome-dsh-plugin #12903，已合并）。Listed in the plugin directory.
+
+## 0.0.0-stage
+
+- 早期占位版本 / Initial placeholder published while scaffolding the package.

package/README.md

@@ -9,6 +9,9 @@
 详情页长文档见 [DETAIL.md](DETAIL.md)（中英双语 / bilingual, 含收款码 / includes the payment QR）。
 The full detail document is [DETAIL.md](DETAIL.md).
 
+**一步步照着用**：[使用说明.md](使用说明.md) —— 安装、三种布局、临时会话、配置文件逐行说明、常见故障与反馈，中英双语随包附带（0.2.5 起）。
+**Step-by-step guide**: [使用说明.md](使用说明.md) — install, layouts, temp sessions, every config line, troubleshooting and feedback; shipped inside the npm package since 0.2.5.
+
 ## 这是一款什么插件 / What this plugin is
 
 **这是一款专门针对改进 DSH 左侧栏体验的插件。** 不碰会话内容、不换模型、不做独立面板、不接云端服务 —— 只把左侧栏「找得到、切得快、看着顺」这一件事做透。

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-sidebar-suite",
-  "version": "0.2.4",
+  "version": "0.2.5",
   "license": "MIT",
   "author": "Yonan",
   "repository": {
@@ -26,6 +26,10 @@
     "plugin"
   ],
   "type": "module",
+  "scripts": {
+    "test": "node tests/test_020.mjs && node tests/test_022.mjs && node tests/test_023.mjs && node tests/test_024.mjs && node tests/test_025.mjs",
+    "check": "node --check lib/index.js && node --check lib/client.js && node --check lib/temp-session-host.mjs && npm pack --dry-run"
+  },
   "main": "lib/index.js",
   "exports": {
     ".": "./lib/index.js",
@@ -46,9 +50,13 @@
     "icon.svg",
     "README.md",
     "DETAIL.md",
+    "使用说明.md",
+    "CHANGELOG.md",
+    "screenshots.json",
     "LICENSE",
     "assets/*.jpg",
-    "assets/*.png"
+    "assets/*.png",
+    "assets/screenshots/*.png"
   ],
   "dsh": {
     "bundle": {

package/screenshots.json

@@ -0,0 +1,5 @@
+[
+  "assets/screenshots/screenshot-1.png",
+  "assets/screenshots/screenshot-2.png",
+  "assets/screenshots/screenshot-3.png"
+]

package//344/275/277/347/224/250/350/257/264/346/230/216.md

@@ -0,0 +1,418 @@
+# dsh-sidebar-suite 使用说明
+
+**适用版本：v0.2.4**（最后更新 2026-11-10）
+
+**这是一款专门针对改进 DSH 左侧栏体验的插件** —— 只管左侧栏，不碰会话内容、不换模型；设计上既要「强实用性」（少点几下、少滚几屏），也要「美观性」（沿用 DSH 原生观感，不另起一套皮肤）。
+
+落到手上就是两件事：
+
+1. **管侧栏布局** —— 左侧栏里「扩展面板」和「工作区」原本抢同一块地方，插件给你三种摆法，随时切；会话列表默认全部展开，不用再点「展开其余」。
+2. **加一个「临时」按钮** —— 点一下在侧栏开一个**真正的会话**，聊完退出 DSH 自动删掉（也可以设成每天定时删）。
+
+下面按「你实际要动手的地方」写。**所有需要改的文件，都给了完整路径 + 行号 + 原文**，照抄就行。
+
+---
+
+## 一、先记住三条铁律
+
+### 1. 改完必须「彻底退出」DSH，不是关窗口
+
+插件的客户端代码**不会热重载**。关掉窗口只是收到托盘，插件还是旧的。
+
+正确做法：
+
+1. 看屏幕右下角托盘 → 找到 DSH 图标 → 右键 → **退出 / Quit**
+2. `Ctrl+Shift+Esc` 打开任务管理器 → 「详细信息」里确认 **没有** `DeepSeek Harness` 进程
+3. 重新双击 DSH 图标打开
+
+第 2 步别省。托盘退出偶发残留，只要进程还在，你看的还是旧代码。
+
+### 2. 只改配置文件里的「等号右边」
+
+配置文件是纯文本，用 Windows 记事本打开即可。**等号左边的名字、`#` 开头的说明行，都不要动**。
+
+### 3. 别在 profile 里重复挂载插件
+
+插件自带 `cordis.patch.yml`，装好就自动挂上了。**不要**再往 `C:\Users\12691\.dsh\profiles\desktop\cordis.patch.yml` 里手写一行 `- id: dsh-sidebar-suite`，否则会加载两次、侧栏出现两条控制栏。
+
+---
+
+## 二、文件都在哪
+
+| 用途 | 完整路径 |
+| --- | --- |
+| 插件源码（改代码/看文档都在这） | `C:\Users\12691\OneDrive\文档\deepseek-harness\default-workspace\dsh-sidebar-suite` |
+| **插件配置（最常改）** | 上面目录下的 `temp-session-config.txt` |
+| profile 里的安装位置（软链，改源码即生效） | `C:\Users\12691\.dsh\profiles\desktop\node_modules\dsh-sidebar-suite` |
+| DSH 启动配置（改默认布局、cookie 寿命） | `C:\Users\12691\.dsh\profiles\desktop\cordis.patch.yml` |
+| 桌面一键修复脚本 | `C:\Users\12691\OneDrive\桌面\DSH启动失败-一键修复.bat` |
+
+因为 profile 里是**软链**（`link:`），所以改 `OneDrive` 那份源码，重启 DSH 就是新的，**不需要重新安装**。
+
+---
+
+## 三、侧栏布局
+
+### 3.1 三种摆法
+
+| 模式 | 名字 | 长什么样 | 适合 |
+| --- | --- | --- | --- |
+| `a` | 折叠 | 两组各自可以收起/展开 | 只用一个，另一组收起来 |
+| `b` | 标签页（**出厂默认**） | 两组共用一栏，点标签互斥切换 | 侧栏窄、想省地方 |
+| `c` | 浮层 | 工作区常驻，扩展面板浮在上面 | 经常两个都要看 |
+
+### 3.2 临时切一下（只影响这次）
+
+侧栏顶部有一排很小的文字按钮：
+
+```
+折叠 · 标签页 · 浮层 │ 显示工作区 / 展开扩展 · 换布局
+```
+
+- 点 `折叠 / 标签页 / 浮层` = 切换布局。**只对本次会话有效**，下次启动回到默认值。
+- 中间那条竖线后面的按钮 = 在当前布局下切换「看哪一组」。
+- `换布局` = 按顺序轮换三种。**侧栏宽度小于 300px 时会自动隐藏**（放不下）。
+
+> 故意不做记忆：临时切换不写盘、不写 localStorage，避免你在窄屏随手一点把默认布局改坏了。
+
+### 3.3 改「启动时的默认布局」（两路，选一条）
+
+**路线 A（推荐，不用改文件、不用重启）**
+
+打开 DSH → 插件 → `dsh-sidebar-suite` → 详情页**最上面**有三张布局卡片。点你想用的那个，立刻成为新的启动默认。
+
+（插件用官方的 `configForms` 配置服务写入，属于正规改法。）
+
+**路线 B（改文件）**
+
+- 文件：`C:\Users\12691\.dsh\profiles\desktop\cordis.patch.yml`
+- 第 **721** 行，原文：
+
+```yaml
+    mode: b
+```
+
+- 改成 `mode: a` 或 `mode: c`
+- 保存 → 彻底退出 DSH → 重开
+
+顺手看下第 **717–725** 行，这一块现在长这样（**只改第 721 行**，其它别动）：
+
+```yaml
+717  - id: dsh-sidebar-suite
+718    disabled: false
+719    name: dsh-sidebar-suite
+720    config:
+721      mode: b          # ← 只改这一行：a = 折叠, b = 标签页, c = 浮层
+722      showQuickSwitch: false
+723      tab: ws
+724      foldExt: true
+725      foldWs: true
+```
+
+（`showQuickSwitch: false` 就是「换布局」那个按钮不显示；想让它出现就改成 `true`。）
+
+---
+
+## 四、临时会话（重点）
+
+### 4.1 它到底是什么
+
+点「**临时**」= **在左侧栏里开一个真正的 DSH 会话**。
+
+- 就在侧栏，和别的会话并排，**可以切走做别的事再切回来**（多任务）
+- 用 **DSH 原生会话窗口**：原生消息流、原生输入框、原生的工具调用/文件读写/命令执行
+- 模型就是你当前在 DSH 里选的那个，插件**不自己调模型**
+- 行首带一个「**临时**」小标签，一眼能认出来
+- **退出 DSH 时删掉**
+
+### 4.2 怎么用
+
+1. 看侧栏顶部「新会话」按钮 —— 它右边挨着一个「**临时**」按钮
+2. 点「临时」→ 侧栏立刻多出一个会话，并弹出提示「临时会话已就绪」
+3. 直接聊，跟普通会话没区别
+
+> 按钮和「新会话」并排（默认 `pair`）。觉得挤，见 5.3 改成单独一行。
+
+### 4.3 什么时候删、怎么保证删干净
+
+**两种删除时机，可以只开一个，也可以都开**（在详情页里设，见 5.1）：
+
+- **退出 DSH 时删除**（默认开）
+- **每天定时清理**（默认关，时间可自选，例如每天 `03:00`）—— DSH 一直开着也不会越积越多
+
+DSH **没有公开的「删除会话」接口**（官方界面的「归档」只是从列表里藏起来，文件还在磁盘上）。所以删除是插件自己做的，**三道保险**：
+
+1. **退出时**：进程退出事件里同步删掉会话目录
+2. **下次启动时**：再扫一遍上次的记录，把没删干净的补删 —— 即使用任务管理器**强杀** DSH，下次打开也会清掉
+3. **删不掉时**：文件被占用就先归档隐藏，下次启动再删
+
+被删的会话在 DSH 的搜索索引里也会一起消失（索引按磁盘上实际存在的会话重建，不会留幽灵）。
+
+### 4.4 一条必须知道的边界
+
+**退出之前，这个会话和普通会话一样是写在磁盘上的。**
+
+位置：`C:\Users\12691\.dsh\sessions\<项目编码>\<会话ID>\`
+
+为什么必须这样：要用原生窗口、还要能中途切走再切回，它就只能是真会话。如果要求「连磁盘都不许写」，那就只能是不在侧栏、不能多任务的纯内存方案 —— 和你要的正好相反。
+
+### 4.5 想让它别删
+
+配置第 38 行 `DELETE_ON_EXIT=off`（见下一节）。关掉后不删除，临时会话就等于普通会话。
+
+---
+
+## 五、配置文件逐项说明
+
+**文件：** `C:\Users\12691\OneDrive\文档\deepseek-harness\default-workspace\dsh-sidebar-suite\temp-session-config.txt`
+
+用记事本打开，**只改等号右边**，保存后**彻底退出 DSH 再重开**。
+
+| 行号 | 原文 | 可填的值 | 作用 |
+| --- | --- | --- | --- |
+| **12** | `SHOW_TEMP_BUTTON=on` | `on` / `off` | 要不要显示「临时」按钮 |
+| **19** | `TEMP_IN_CHAT_MODE=hide` | `hide` / `show` | 装了 `dsh-deepseek-chat` 时，处于 CHAT 官网模式要不要显示按钮 |
+| **27** | `TEMP_BUTTON_STYLE=pair` | `pair` / `own` | `pair` = 和「新会话」并排；`own` = 单独占一整行，完全不改「新会话」 |
+| **34** | `EXPAND_ALL_SESSIONS=on` | `on` / `off` | `on` = 会话列表全部展开、隐藏「展开其余 N 个会话」；`off` = 恢复 DSH 原来的折叠 |
+| **38** | `DELETE_ON_EXIT=on` | `on` / `off` | **退出 DSH 时**删不删 |
+| **44** | `SCHEDULE_DELETE=off` | `on` / `off` | **每天定时清理**要不要开 |
+| **49** | `SCHEDULE_TIME=03:00` | `HH:MM`（如 `03:00`、`23:30`） | 定时清理的时间点，24 小时制、本机时间 |
+| **53** | `MAX_KEPT=20` | 1–200 | 最多同时留几个临时会话，超了先删最早的 |
+
+> 这一整节都可以不动手改文件 —— 详情页有图形化开关，见 5.1。两种改法写的是**同一份文件**，不会打架。
+
+### 5.1 删除时机：在详情页里设（推荐，不用改文件）
+
+打开 DSH → 插件 → `dsh-sidebar-suite` → 详情页最上面那张卡，往下看会有一块「**临时会话自动删除**」：
+
+```
+临时会话自动删除
+决定临时会话什么时候被清掉。写入插件设置文件，改完立即生效，不用重启。
+
+退出 DSH 时删除        [开] / [关]
+每天定时清理，时间      [开] / [关]     [ 03:00 ]
+正在使用的那个会话会跳过，5 分钟后再试一次。
+```
+
+两个开关**互相独立**，可以随便组合：
+
+| 你的用法 | 建议设置 |
+| --- | --- |
+| 每天用完就退出 DSH | 「退出时删除」= **开**；定时 = 关（默认就这样） |
+| DSH 一开好几天不关 | 「退出时删除」随意；「每天定时清理」= **开**，时间设凌晨 `03:00` |
+| 两个都想要 | 都开。退出时清一次，没退出的话到点再清一次 |
+
+**时间怎么填**：点那个时间框，选小时和分钟即可（24 小时制，本机时间）。填 `03:00` 就是每天凌晨 3 点，`23:30` 就是晚上 11 点半。
+
+**正在用的会话不会被误删**：定时清理会跳过最近 3 分钟内有动静的会话（打开着的会话一直在写记录），5 分钟后再试一次。所以万一你凌晨 3 点还开着临时会话聊天，它不会当场消失。
+
+**改完立即生效**，不用重启 DSH（这条和改文件不一样）。保存成功的标志是下面出现一行「已保存」，两秒后自己消失。
+
+### 5.2 三个最常用的改法
+
+**① 嫌两个按钮挤 → 让「临时」单独占一行**
+
+- 第 **27** 行：`TEMP_BUTTON_STYLE=pair` 改成 `TEMP_BUTTON_STYLE=own`
+- 保存 → 彻底退出 DSH → 重开
+- 效果：「临时」变成自己一整行，**「新会话」的宽度和高度一个像素都不动**
+
+**② 不想让临时会话自动删**
+
+- 第 **38** 行：`DELETE_ON_EXIT=on` 改成 `DELETE_ON_EXIT=off`
+
+**③ 想多开几个临时会话**
+
+- 第 **53** 行：`MAX_KEPT=20` 改成比如 `MAX_KEPT=50`（上限 200）
+
+### 5.3 为什么偶尔看不到「临时」按钮
+
+按概率从高到低：
+
+1. **侧栏被折叠成窄条**（宽度约小于 170px）—— 放不下，按钮和「临时」标签都会自动收起。把侧栏拉宽就回来。
+2. **`dsh-deepseek-chat` 处于 CHAT 官网模式** —— 默认（`hide`）让位给官网侧栏，切回 HARNESS 自动出现。
+3. 第 12 行被改成了 `off`。
+
+### 5.4 提示「创建临时会话失败」
+
+弹窗会跟着写具体原因。如果是「当前 DSH 版本没有暴露会话导航服务」，说明 DSH 版本太旧（插件依赖 `uiWorkspace` 这个会话导航服务）。其它原因，先彻底退出重开一次；还不行，把弹窗文字截图反馈。
+
+### 5.5 会话列表不再折叠（0.2.4 新增）
+
+DSH 原本每个工作区只先显示 **5 个会话**，剩下的会折成一行「**展开其余 4 个会话**」这样的按钮。装了本插件后默认就不用管它了：
+
+- 每次侧栏刷新，插件会**按宿主自己的按钮**把每个工作区一路展开到全部显示（不是改宿主 DOM，也不是假造列表）。
+- 「展开其余 N 个会话」／展开后的「收起」按钮**整块隐藏**，页面上不会再出现。
+- 新建会话、切工作区、DSH 重开后会自动重新展开，不用手动点。
+
+想恢复 DSH 原来的折叠：
+
+1. 文件：`C:\Users\12691\OneDrive\文档\deepseek-harness\default-workspace\dsh-sidebar-suite\temp-session-config.txt`
+2. 第 **34** 行，原文：`EXPAND_ALL_SESSIONS=on`
+3. 改成 `EXPAND_ALL_SESSIONS=off`，保存
+4. **托盘图标彻底退出 DSH**（任务管理器确认没有 DeepSeek Harness 进程），再重新打开 —— 客户端代码不会热重载
+
+依据（在 `D:\program\harness\resources\app.asar` 里核对过）：`@deepseek-ai/dsh-client-ui-workspace/lib/client.js` 里 `"sessions.expand": "展开其余 {n} 个会话"`，按钮是 `<button data-row-key="overflow:<分组>">`，点一次水位线 +5，全部显示后 `aria-expanded` 变成 `true`、文字变成「收起」。
+
+---
+
+## 六、和 dsh-deepseek-chat（CHAT / HARNESS 切换）共存
+
+那个插件在 **CHAT 官网模式**下会把侧栏和主区域换成 DeepSeek 官网网页，并且自己在侧栏顶部加一行 CHAT/HARNESS 切换。两个插件都想用侧栏顶上那一行，就会抢位置。
+
+**已经踩过并修好的坑（0.2.0 → 0.2.1）**：它接管侧栏前会先「认」结构，要求**侧栏根节点下正好只有 1 个 `<button>`**。0.2.0 把「临时」按钮直接插在根节点下，变成 2 个，它就弹「当前侧栏不兼容：顶部新会话仍使用 HARNESS」，并且不再接管新会话按钮。0.2.1 把「临时」按钮装进自己的一层 `<div>` 里，根节点下仍是 1 个 `<button>`，提示消失、切换正常。
+
+如果日后还有别的插件来数按钮，按三档走：
+
+| 档 | 做法 | 适合 |
+| --- | --- | --- |
+| 1（默认，推荐） | **自动让开**：检测到 CHAT 模式就隐藏「临时」按钮，并把缩窄「新会话」的样式全部失效，那一行完整还给官网侧栏；切回 HARNESS 自动恢复 | 两个都要用 |
+| 2 | 第 27 行改 `TEMP_BUTTON_STYLE=own`，「临时」单独一行，**零侵入** | 还是挤 |
+| 3 | 插件管理里直接把 `dsh-deepseek-chat` 关掉 | 基本不用 CHAT 官网模式 |
+
+还要明白一件事：**CHAT 官网模式和 HARNESS 是两条链路**（一个是 DeepSeek 网页账号，一个是 DSH 本地会话）。临时会话是 DSH 会话，所以在 CHAT 模式下它本来就该让位 —— 这不是故障。
+
+---
+
+## 七、常见问题
+
+### Q1. DSH 打不开，窗口标题是「DeepSeek Harness 无法使用」
+
+**这是 DSH 自己的问题，跟本插件无关。**（2026-11-10 排查确认）
+
+原因：桌面版每次启动都换一个随机端口，鉴权服务按「host:端口」签发一条 `dsh-auth-*` cookie，默认寿命 30 天且**从不清理**。攒到约 **71 条**时，欢迎页请求头超过 Node 的 16 KB 上限 → 宿主返回 **HTTP 431** → Electron 报 `desktop welcome: Web authentication failed`。
+
+**自救（30 秒）：**
+
+1. 托盘彻底退出 DSH，任务管理器确认进程没了
+2. 双击桌面的 `DSH启动失败-一键修复.bat`
+3. 它会把 cookie 库**移到备份目录**（不是删除）：`C:\Users\12691\.dsh\backups\cookie-rescue-<日期时间>\`
+4. 脚本提示 OK 后，正常双击 DSH 打开（会自动生成一个空的新库，登录状态和会话都不受影响）
+
+**防复发（已经做了）：** profile 里把 cookie 寿命压到了 7 天。
+
+- 文件：`C:\Users\12691\.dsh\profiles\desktop\cordis.patch.yml`
+- 第 **743–746** 行：
+
+```yaml
+- id: connection
+  name: "@deepseek-ai/dsh-client-connection"
+  config:
+    cookieMaxAgeDays: 7
+```
+
+- 想更紧改第 **746** 行的 `7` 为 `1`，想放宽改成 `14`
+- 保存 → 彻底退出 DSH → 重开
+
+### Q2. 弹出「当前侧栏不兼容：顶部新会话仍使用 HARNESS」
+
+0.2.0 的老毛病，**0.2.1 已修**。先确认版本（插件详情页能看到版本号），是 0.2.1 就彻底退出重开一次。如果还在弹，把第 27 行改成 `own` 再重开（见 5.2 ①）。
+
+### Q3. 找不到「临时」按钮
+
+看 5.2：窄栏收起 → CHAT 模式让位 → 配置关了，按顺序排查。
+
+### Q4. 点了「临时」，侧栏没反应
+
+1. 等 1–2 秒，创建要调宿主的会话服务
+2. 看有没有弹红色提示，里面写着原因
+3. 彻底退出 DSH 再重开（不是关窗口）
+
+### Q5. 布局切了，下次开机又变回去
+
+正常。侧栏上切换**只对本次会话有效**，这是故意的。要改默认请用 3.3 的路线 A 或 B。
+
+---
+
+## 八、改坏了怎么回退
+
+历次改动前的完整备份都在这：
+
+```
+C:\Users\12691\.dsh\backups\20261110-sidebar-suite-before-0.1.5\
+C:\Users\12691\.dsh\backups\20261110-sidebar-suite-before-0.1.6\
+C:\Users\12691\.dsh\backups\20261110-sidebar-suite-before-0.1.7\
+C:\Users\12691\.dsh\backups\20261110-cookie-pileup\      ← 含 Cookies.bak 和 cordis.patch.yml.bak
+```
+
+只想回退配置的话，最省事的是把 `temp-session-config.txt` 里改过的行改回上表的默认值，再彻底退出重开。
+
+---
+
+## 九、反馈（有 bug，或者想加功能）
+
+插件详情页最下面有一块「**反馈 · Feedback**」，就是你遇到问题时该去的地方：
+
+1. 打开 **插件 → dsh-sidebar-suite → 详情页**
+2. 滚到最下面，在「反馈」的输入框里写一句（比如「点临时之后侧栏没反应」）
+3. 点下面三个按钮之一
+
+| 按钮 | 会发生什么 | 反馈落到哪 |
+| --- | --- | --- |
+| **复制反馈内容** | 把「你写的描述 + 环境信息」拼成一段文字放进剪贴板，你粘到微信 / QQ / 邮件都行 | **只进剪贴板，不会自动发送** |
+| **在 GitHub 提 issue** | 用系统默认浏览器打开一个**已经填好标题和正文**的新 issue 页面，检查一下点「Submit」 | `https://github.com/YONAN1269/dsh-sidebar-suite/issues` |
+| **插件市场评论区** | 打开 `dsh-market` 给这个插件规定的那条讨论（卡片上的「评论」就是它） | `https://github.com/awesome-dsh-plugin/awesome-dsh-plugin/discussions?discussions_q=%22plugin%3AYONAN1269%2Fdsh-sidebar-suite%22` |
+
+前两个按钮都会自动带上这些，省掉「你是什么环境」这一轮扯皮：
+
+- 插件版本（读的是 `package.json`，不会和你实际跑的对不上）
+- DSH 桌面客户端版本、Node / Electron 版本
+- 操作系统与位数
+- 当前默认布局
+- 临时按钮模式、临时会话数量、后端路由条数
+- 最近一次清理的结果和最近一次错误
+
+另外两点：
+
+- **草稿会留在本地**：输入框里写的东西存在浏览器本地（`localStorage` 的 `dsh-sidebar-suite:feedback-draft`），关了页面再回来还在。
+- **不用 GitHub 也行**：如果浏览器打不开 GitHub，点「复制反馈内容」，粘到任何能联系到作者的地方。
+- 创建临时会话失败时，右下角的红色提示末尾会写「可在插件详情页反馈」，指的就是这块。
+
+想直接开网页：问题去 [Issues](https://github.com/YONAN1269/dsh-sidebar-suite/issues/new/choose)，聊用法去 [Discussions](https://github.com/YONAN1269/dsh-sidebar-suite/discussions)。
+
+### 9.1 作者（你）在哪儿接收反馈
+
+| 用户点了什么 | 去哪里看 | 会不会自动通知你 |
+| --- | --- | --- |
+| 在 GitHub 提 issue | [本仓库 Issues](https://github.com/YONAN1269/dsh-sidebar-suite/issues) | **会**（前提：账号没关掉自动 watch）。GitHub 官方文档原文：「By default, you also automatically watch all repositories that you create and are owned by your personal account.」 |
+| 插件市场评论区 | [目录仓库的 Discussions](https://github.com/awesome-dsh-plugin/awesome-dsh-plugin/discussions?discussions_q=%22plugin%3AYONAN1269%2Fdsh-sidebar-suite%22)（标题带 `plugin:YONAN1269/dsh-sidebar-suite`） | **不会自动** —— 它在别人的仓库里，你要 watch 那个仓库或那条讨论才有通知 |
+| 复制反馈内容 | 没有固定位置 | **不会**，用户得主动粘给你 |
+
+**统一收件箱**：`https://github.com/notifications`（所有被 watch 的仓库、被 @ 的消息都在这里）。
+
+**确认自己能收到（按 GitHub 官方文档 "Configuring notifications" 的步骤）**：
+
+1. 浏览器打开 `https://github.com/YONAN1269/dsh-sidebar-suite`
+2. 页面**右上角的 `Watch` 下拉菜单**，选 `All Activity`；只想收 issue 就选 `Custom` → 勾 `Issues`（和 `Discussions`，如果开了）
+3. 同一个账号的通知邮箱在 `https://github.com/settings/notifications` 里确认（需要登录，我这边看不到登录后的界面，以上按钮名称来自 GitHub 官方文档）
+4. 以后看 `https://github.com/notifications` 即可
+
+**关于「有没有官方 / 市场规定的入口」**：DSH 宿主本身没有给第三方插件规定反馈字段（核对过 `D:\program\harness\resources\app.asar` 里的插件管理详情页，它不读 `package.json` 的 `bugs`，也没有反馈按钮）；`bugs.url` 是 npm 的标准字段，npm 包页和命令行工具会用，DSH 详情页不显示。真正由**插件市场**规定的是 `dsh-market` 的「评论」：每个插件一条 GitHub Discussion，放在公开目录仓库 `awesome-dsh-plugin/awesome-dsh-plugin`，用 `plugin:<owner/repo>` 当唯一标题关键词；giscus 官方说明「If a matching discussion cannot be found, the giscus bot will automatically create a discussion the first time someone leaves a comment or reaction.」。所以 0.2.4 把这个入口直接做进了详情页，不再自造第四个地方。
+
+**如果市场评论区打开是空的**：显示「There are no matching discussions.」说明还没人留过言。回 DSH 的插件市场 → 找到 `dsh-sidebar-suite` 卡片 → 点「评论」，第一条留言会自动把讨论建起来；之后详情页那个按钮就能直接打开了。
+
+---
+
+## 十、速查卡
+
+| 我想…… | 去哪 |
+| --- | --- |
+| **有问题、想加功能** | 详情页最下面的「**反馈**」框（见第九节） |
+| **想看用户反馈到哪了** | [本仓库 Issues](https://github.com/YONAN1269/dsh-sidebar-suite/issues) / [github.com/notifications](https://github.com/notifications)；市场评论见 9.1 |
+| **在插件市场里留言** | 详情页「反馈」框的「**插件市场评论区**」按钮 |
+| **会话不想再点「展开其余」** | 默认已经全部展开；想恢复折叠见 5.5 |
+| 换布局（这次） | 侧栏顶部点 `折叠 / 标签页 / 浮层` |
+| 换布局（以后每次） | 插件 → dsh-sidebar-suite → 详情页最上面三张卡片 |
+| **设临时会话什么时候自动删** | 详情页「**临时会话自动删除**」那块的两个开关（见 5.1） |
+| **让它每天凌晨 3 点清一次** | 同上：开「每天定时清理」，时间选 `03:00` |
+| 让「临时」按钮单独一行 | `temp-session-config.txt` 第 **27** 行改 `own` |
+| 关掉「临时」按钮 | 同上第 **12** 行改 `off` |
+| 临时会话别自动删 | 同上第 **38** 行改 `off`（定时清理也记得关第 **44** 行） |
+| 恢复 DSH 原来的会话折叠 | 同上第 **34** 行 `EXPAND_ALL_SESSIONS=on` 改 `off` |
+| DSH 打不开（无法使用） | 桌面 `DSH启动失败-一键修复.bat` |
+| 让改文件生效 | 托盘退出 → 任务管理器确认无进程 → 重开 |
+
+---
+
+作者：Yonan · MIT · 仓库 `https://github.com/YONAN1269/dsh-sidebar-suite`
+
+如果你在插件详情页看到收款码：**完全自愿，无任何回报承诺**。