From ded66d61ace0bee80f02f7fd56f7de5d24765a72 Mon Sep 17 00:00:00 2001
From: figmar <figmar@apescale.com>
Date: Wed, 2 Sep 2026 00:42:42 +0800
Subject: [PATCH] docs: sidebar suite readme

---
 README.md | 63 ++++++++++++++++++++++++++++++++++++++++++++++++++++++-
 1 file changed, 62 insertions(+), 1 deletion(-)

diff --git a/README.md b/README.md
index 15aa91a..fd04516 100644
--- a/README.md
+++ b/README.md
@@ -1,3 +1,64 @@
 # dsh-sidebar-boost
 
-WorkBuddy/Tutti-style sidebar suite for DeepSeek Harness Desktop: better-sidebar + background-agents + popout-sidebar + session-folders + skill-picker + sidebar-qa + office preview. One-bundle install.
\ No newline at end of file
+WorkBuddy / Tutti 风格的 DeepSeek Harness 侧边栏增强套件（聚合安装包）。
+
+一个 bundle 装齐整套侧边栏增强组合，均围绕 [dsh-better-sidebar](https://github.com/omdsh-dev/DSH-better-sidebar)（VSCode 风格右侧栏工作台：explorer/editor/terminal/git/子代理）构建。
+
+## 包含组件
+
+| 组件 | 作用 | 对应体验 |
+|---|---|---|
+| `dsh-better-sidebar` | 侧边栏工作台本体（文件渲染/编辑、终端、Git、子代理，支持三方 Tab 注册） | 侧边栏地基 |
+| `dsh-background-agents` | 可交互长会话后台代理 + 持久化多 agent 团队房间（消息总线/共享任务板/审批） | Tutti multi-agent |
+| `dsh-popout-sidebar` | 侧边栏弹出为独立窗口 | Tutti 悬浮工作区 |
+| `dsh-session-folders` | 会话文件夹分组 + 拖拽（服务端持久化） | WorkBuddy 工作区 |
+| `dsh-skill-picker` | skill 选择器（搜索式 `/skill` 调用） | WorkBuddy skill 选择 |
+| `dsh-sidebar-qa` | 侧边栏提问（Codex 侧问 / Claude `/btw` 式） | 对话增强 |
+| `@huanlin/dsh-plugin-better-sidebar-plugin-office` | better-sidebar 的 Office 三件套预览（docx/xlsx/pptx） | 文件预览 |
+
+## 安装
+
+### 方式 A：作为聚合 bundle 安装（推荐）
+
+```bash
+dsh plugin --profile desktop add dsh-sidebar-boost
+```
+
+安装后该包的 `cordis.patch.yml` 会把 7 个组件全部插入 profile 组成树。
+每个组件带**去重守卫**：若 profile 已显式声明同名 bundle，则自动跳过，避免重复加载。
+
+### 方式 B：直接逐组件安装
+
+```bash
+dsh plugin --profile desktop add \
+  dsh-better-sidebar \
+  dsh-background-agents \
+  dsh-popout-sidebar \
+  dsh-session-folders \
+  dsh-skill-picker \
+  dsh-sidebar-qa \
+  @huanlin/dsh-plugin-better-sidebar-plugin-office
+```
+
+## 卸载
+
+```bash
+dsh plugin --profile desktop remove dsh-sidebar-boost
+```
+
+> 注意：移除聚合包只移除本包与其 patch；各组件作为独立依赖若被其他 bundle 引用不会被动删除。
+
+## 验证
+
+```bash
+dsh --profile desktop --dump-config | grep -E "id: (better-sidebar|background-agents|popout-sidebar|dsh-session-folders|sidebar-qa|dsh-skill-picker|dsh-better-sidebar-plugin-office)"
+```
+
+## 已知 peer 偏差（pnpm 仅警告）
+
+- `dsh-background-agents` 要求 `schemastery >=3.18.2`、`cordis ^4.0.2`（环境若为 3.18.1/4.0.1 时以警告形式出现，功能不受影响；如遇运行时报错请先升级）
+- 所有组件为 `platform: web` 插件，经 `dsh-web-app` 注入，桌面 profile 同样生效
+
+## License
+
+MIT