dsh-sidebar-suite 0.1.3 → 0.2.5

package/locale/en.json

@@ -1,7 +1,7 @@
 {
   "meta": {
     "title": "侧栏布局大师 · Sidebar Suite",
-    "description": "三种布局把挤成一团的左侧栏理顺：一键切换、零改动宿主结构，默认布局就在本页顶部设置。｜Three layouts, one click, zero DOM rewrites — set the startup default right at the top of this page.",
+    "description": "一款专门针对改进 DSH 左侧栏体验的插件：三种布局一键切换、会话默认全展开、临时会话用完即删、设置与反馈都在本页，强实用性；界面沿用宿主原生配色、圆角与间距，只加属性不重构宿主结构，克制又好看。｜A plugin dedicated to a better DSH sidebar: one-click layouts, always-expanded sessions, disposable temp sessions and in-page settings/feedback — seriously practical; native colours, radii and spacing with zero host-DOM rewrites — restrained and good-looking.",
     "detail": "DETAIL.md"
   }
 }

package/locale/zh.json

@@ -1,7 +1,7 @@
 {
   "meta": {
     "title": "侧栏布局大师 · Sidebar Suite",
-    "description": "三种布局把挤成一团的左侧栏理顺：一键切换、零改动宿主结构，默认布局就在本页顶部设置。｜Three layouts, one click, zero DOM rewrites — set the startup default right at the top of this page.",
+    "description": "一款专门针对改进 DSH 左侧栏体验的插件：三种布局一键切换、会话默认全展开、临时会话用完即删、设置与反馈都在本页，强实用性；界面沿用宿主原生配色、圆角与间距，只加属性不重构宿主结构，克制又好看。｜A plugin dedicated to a better DSH sidebar: one-click layouts, always-expanded sessions, disposable temp sessions and in-page settings/feedback — seriously practical; native colours, radii and spacing with zero host-DOM rewrites — restrained and good-looking.",
     "detail": "DETAIL.md"
   }
 }

package/package.json

@@ -1,60 +1,72 @@
-{
-  "name": "dsh-sidebar-suite",
-  "version": "0.1.3",
-  "license": "MIT",
-  "author": "Yonan",
-  "repository": {
-    "type": "git",
-    "url": "git+https://github.com/YONAN1269/dsh-sidebar-suite.git"
-  },
-  "homepage": "https://github.com/YONAN1269/dsh-sidebar-suite#readme",
-  "bugs": {
-    "url": "https://github.com/YONAN1269/dsh-sidebar-suite/issues"
-  },
-  "publishConfig": {
-    "access": "public"
-  },
-  "description": "让左侧栏不再抢地盘：三种布局、一键切换、零改动宿主结构，默认布局在插件详情页顶部直接设置。｜Tame the DSH sidebar: three layouts, one click, zero DOM rewrites — set your startup default right at the top of the plugin page.",
-  "keywords": [
-    "dsh-plugin",
-    "dsh",
-    "deepseek-harness",
-    "sidebar",
-    "layout",
-    "plugin"
-  ],
-  "type": "module",
-  "main": "lib/index.js",
-  "exports": {
-    ".": "./lib/index.js",
-    "./client": "./lib/client.js",
-    "./package.json": "./package.json",
-    "./locale/*.json": "./locale/*.json",
-    "./icon": "./icon.svg",
-    "./DETAIL.md": "./DETAIL.md",
-    "./assets/*": "./assets/*"
-  },
-  "files": [
-    "lib/index.js",
-    "lib/client.js",
-    "cordis.patch.yml",
-    "locale/*.json",
-    "icon.svg",
-    "README.md",
-    "DETAIL.md",
-    "LICENSE",
-    "assets/*.jpg",
-    "assets/*.png"
-  ],
-  "dsh": {
-    "bundle": {
-      "patch": "./cordis.patch.yml"
-    },
-    "client": {
-      "platform": "web",
-      "inject": [
-        "@deepseek-ai/dsh-client-ui-sidebar"
-      ]
-    }
-  }
-}
+{
+  "name": "dsh-sidebar-suite",
+  "version": "0.2.5",
+  "license": "MIT",
+  "author": "Yonan",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/YONAN1269/dsh-sidebar-suite.git"
+  },
+  "homepage": "https://github.com/YONAN1269/dsh-sidebar-suite#readme",
+  "bugs": {
+    "url": "https://github.com/YONAN1269/dsh-sidebar-suite/issues"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "description": "一款专门针对改进 DSH 左侧栏体验的插件：三种布局一键切换、默认布局在详情页顶部直接设、会话列表默认全展开、「临时会话」开原生会话且退出 / 每天定时自动删除、详情页三种反馈入口 —— 强实用性；界面沿用宿主原生配色、圆角与间距，只加属性与一条控制栏、不重构宿主结构 —— 克制美观。｜A plugin dedicated to the DSH sidebar experience: one-click layouts, always-expanded sessions, disposable native temp sessions and in-page settings/feedback — seriously practical; native colours, radii and spacing with zero host-DOM rewrites — restrained and good-looking.",
+  "keywords": [
+    "dsh-plugin",
+    "dsh",
+    "deepseek-harness",
+    "sidebar",
+    "layout",
+    "temp-session",
+    "privacy",
+    "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",
+    "./client": "./lib/client.js",
+    "./package.json": "./package.json",
+    "./locale/*.json": "./locale/*.json",
+    "./icon": "./icon.svg",
+    "./DETAIL.md": "./DETAIL.md",
+    "./assets/*": "./assets/*"
+  },
+  "files": [
+    "lib/index.js",
+    "lib/client.js",
+    "lib/temp-session-host.mjs",
+    "temp-session-config.txt",
+    "cordis.patch.yml",
+    "locale/*.json",
+    "icon.svg",
+    "README.md",
+    "DETAIL.md",
+    "使用说明.md",
+    "CHANGELOG.md",
+    "screenshots.json",
+    "LICENSE",
+    "assets/*.jpg",
+    "assets/*.png",
+    "assets/screenshots/*.png"
+  ],
+  "dsh": {
+    "bundle": {
+      "patch": "./cordis.patch.yml"
+    },
+    "client": {
+      "platform": "web",
+      "inject": [
+        "@deepseek-ai/dsh-client-ui-sidebar"
+      ]
+    }
+  }
+}

package/screenshots.json

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

package/temp-session-config.txt

@@ -0,0 +1,53 @@
+# 临时会话（0.2.0）· 用记事本改等号右边，保存后「完全退出并重开 DSH」才生效。
+# Temporary session (0.2.0) · edit the values after =, then FULLY QUIT and reopen DSH.
+# 等号左边和 # 开头的行不要动。Do not change the keys or the # lines.
+#
+# 说明：临时会话就是左侧栏里的一个真实 DSH 会话（用原生会话窗口），
+# 退出 DSH 时删除。DELETE_ON_EXIT=off 时不再删除，它就变成普通会话。
+# Notes: a temporary session is a REAL DSH session in the sidebar using the
+# native conversation window, deleted when you quit. DELETE_ON_EXIT=off turns
+# that off, and it becomes an ordinary session.
+
+# 是否在「新会话」按钮旁边显示「临时」按钮 / Show the Temp button beside New Session
+SHOW_TEMP_BUTTON=on
+
+# 装了「dsh-deepseek-chat（CHAT / HARNESS 切换）」时，它在 CHAT 官网模式会接管
+# 侧栏和主区域。hide = CHAT 模式自动隐藏「临时」按钮，切回 HARNESS 再出现（推荐）；
+# show = 两种模式都显示按钮。
+# Coexistence with dsh-deepseek-chat: hide = hide the Temp button while that plugin
+# is in CHAT (official website) mode, show = always show it.
+TEMP_IN_CHAT_MODE=hide
+
+# 「临时」按钮的摆法 / How the Temp button is laid out
+# pair = 和「新会话」并排（默认，会把这行稍微缩窄）
+# own  = 自己单独占一行，完全不改「新会话」的宽度（别的插件把侧栏顶部挤乱时用这个）
+# pair = beside New Session (default, narrows that row slightly)
+# own  = its own full-width row, leaves New Session untouched (use when another
+#        plugin's header row fights the pair layout)
+TEMP_BUTTON_STYLE=pair
+
+# 会话列表是否默认全部展开 / Always show every session in the sidebar
+# on  = 自动展开所有会话，并隐藏「展开其余 N 个会话」按钮（默认）
+# off = 保持 DSH 原来的折叠行为，那个按钮照常显示
+# on  = expand every group and hide the "Show N more sessions" button (default)
+# off = keep DSH's own folding and leave that button visible
+EXPAND_ALL_SESSIONS=on
+
+# 退出 DSH 时删除临时会话 / Delete temporary sessions when DSH quits
+# on  = 退出时删除（默认）；off = 不删除，临时会话就变成普通会话
+DELETE_ON_EXIT=on
+
+# 每天定时清理（和上面那条互不影响，可以同时开）/ Daily cleanup
+# on  = 每天到 SCHEDULE_TIME 时把临时会话删掉（DSH 一直开着也不会越积越多）
+# off = 不定时清理
+# on  = delete every temporary session at SCHEDULE_TIME; off = no daily cleanup
+SCHEDULE_DELETE=off
+
+# 定时清理的时间（24 小时制 HH:MM，本机时间）/ Cleanup time (24h HH:MM, local time)
+# 例：03:00 = 每天凌晨 3 点。正在使用的那个会话会跳过，5 分钟后再试一次。
+# e.g. 03:00. A session that is in use right now is skipped and retried 5 min later.
+SCHEDULE_TIME=03:00
+
+# 最多保留多少个临时会话（超出后自动删掉最早的）
+# How many temporary sessions to keep (the oldest are deleted beyond this)
+MAX_KEPT=20

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`
+
+如果你在插件详情页看到收款码：**完全自愿，无任何回报承诺**。