67 lines
2.6 KiB
Markdown
67 lines
2.6 KiB
Markdown
# apes--sidebar
|
||
|
||
WorkBuddy / Tutti 风格的右侧边栏增强插件（基于 [dsh-better-sidebar](https://github.com/omdsh-dev/DSH-better-sidebar) 的 `ctx.betterSidebar` 服务）。**显示名可配置**：默认 `apes--sidebar`，预设 `feyOS`，或任意自定义。
|
||
|
||
在 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 apes--sidebar
|
||
```
|
||
|
||
装完**硬刷新**（Cmd/Ctrl+Shift+R）即可在侧边栏 + 菜单看到新 Tab。
|
||
|
||
## 配置（设置页「侧边卡片」→ apes--sidebar）
|
||
|
||
| 键 | 默认 | 说明 |
|
||
|---|---|---|
|
||
| `displayName` | `apes--sidebar` | 显示名：预设 `feyOS`，或自定义任意名字（Profile Tab 标题与卡片名跟随） |
|
||
| `enableTasks` | `true` | 显示 Tasks Tab |
|
||
| `enableAgents` | `true` | 显示 Agents Tab |
|
||
| `enableProfile` | `true` | 显示 Profile Tab |
|
||
| `showTime` / `showUngrouped` | — | Tasks 子设置 |
|
||
|
||
持久化在 `prefs.pluginSettings['apes--sidebar']`。
|
||
|
||
## 卸载
|
||
|
||
```bash
|
||
dsh plugin --profile desktop remove apes--sidebar
|
||
```
|
||
|
||
## 验证
|
||
|
||
```bash
|
||
dsh --profile desktop --dump-config | grep apes-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 组成树挂载（含双挂载守卫）
|
||
|
||
## 关联
|
||
|
||
- 前身：dsh-wb-sidebar（v0.2.0）→ 更名为本插件（v0.3.0）
|
||
- 聚合安装包：figmar/dsh-sidebar-boost（含基础侧边栏 + 多个增强插件）
|
||
|
||
## License
|
||
|
||
MIT
|