docs: readme v0.2.0

2026-09-02 07:22:19 +08:00
parent 74dc12a1df
commit 9eadf2a2e2
1 changed files with 55 additions and 1 deletions
@@ -1,3 +1,57 @@
 # dsh-wb-sidebar

-WorkBuddy/Tutti-style right sidebar enhancement for DeepSeek Harness: Tasks / Agents / Profile tabs, all configurable. Built on dsh-better-sidebar.
+WorkBuddy / Tutti 风格的右侧边栏增强插件（基于 [dsh-better-sidebar](https://github.com/omdsh-dev/DSH-better-sidebar) 的 `ctx.betterSidebar` 服务）。
+
+在 better-sidebar 的右侧工作台里新增 3 个**可配置** Tab：
+
+| Tab | id | 对应参照 | 配置开关 |
+|---|---|---|---|
+| **Tasks**（任务导航） | `wb:tasks` | WorkBuddy 左侧任务列表：按工作区+时间分组、搜索、运行中徽标、一键打开/新建会话 | `enableTasks`（默认开） |
+| **Agents**（Agent 总览） | `wb:agents` | Tutti multi-agent：子代理/后台 agent 列表、运行状态、一键跳转 | `enableAgents`（默认开） |
+| **Profile**（底部用户区） | `wb:profile` | WorkBuddy 底部：模型信息 + 设置/帮助入口 | `enableProfile`（默认开） |
+
+## 安装
+
+前置：已装 `dsh-better-sidebar`（≥0.16）。
+
+```bash
+dsh plugin --profile desktop add dsh-wb-sidebar
+```
+
+装完**硬刷新**（Cmd/Ctrl+Shift+R）即可在侧边栏 + 菜单看到新 Tab。
+
+## 配置
+
+设置页「侧边卡片」→ dsh-wb-sidebar → 三个开关分别控制三个 Tab 的显隐（持久化在 `prefs.pluginSettings['dsh-wb-sidebar']`）。Tasks 还有 `showTime` / `showUngrouped` 子开关。
+
+## 卸载
+
+```bash
+dsh plugin --profile desktop remove dsh-wb-sidebar
+```
+
+## 验证
+
+```bash
+dsh --profile desktop --dump-config | grep wb-sidebar   # host 挂载
+# 唯一性（崩溃检查）：dump-config 的 id 不应有重复
+```
+
+## 兼容性注意
+
+- **不要与 `dsh-background-agents` 0.7.1 同 profile**：它与基座 `@deepseek-ai/dsh-base` 的 `storage` loader 条目 id 冲突（`duplicate loader entry id "storage"`），会导致 desktop profile 启动崩溃。Agent 总览不依赖它，独立可用。
+- Agents Tab 不依赖 `remote.commands`（该服务不存在）；团队房间能力暂不可用，界面显示说明。
+
+## 结构
+
+- `lib/index.js` — host 侧最小入口（Node）
+- `lib/client.js` — client bundle（`__ModuleLoader__.load` 格式），注册 3 个可配置 Tab
+- `cordis.patch.yml` — profile 组成树挂载（含双挂载守卫）
+
+## 关联
+
+- 聚合安装包：figmar/dsh-sidebar-boost（含基础侧边栏 + 多个增强插件）
+
+## License
+
+MIT