figmar
5f6018a9ec
- package.json name、cordis.patch.yml id/name、lib/index.js 导出、client.js 插件 id/设置命名空间/显示名默认值，全部统一为单连字符 apes-sidebar - 双连字符写法在 npm 包名和 loader 解析中易与单连字符混淆，统一后更规范
54 lines
2.4 KiB
Markdown
54 lines
2.4 KiB
Markdown
# apes-sidebar
|
||
|
||
WorkBuddy / Tutti 风格的右侧边栏增强插件（基于 [dsh-better-sidebar](https://github.com/omdsh-dev/DSH-better-sidebar) 的 `ctx.betterSidebar` 服务）。**显示名可配置**：默认 `apes-sidebar`，预设 `feyOS`，或任意自定义。
|
||
|
||
在 better-sidebar 的右侧工作台里新增 4 个**可配置** Tab：
|
||
|
||
| Tab | id | 对应参照 | 配置开关 |
|
||
|---|---|---|---|
|
||
| **Tasks**（任务导航） | `wb:tasks` | WorkBuddy 任务列表：工作区+时间分组、搜索、运行中徽标 + **「运行中任务」区（子代理拓扑、实时计数角标）** | `enableTasks`（默认开） |
|
||
| **Agents**（Agent 总览） | `wb:agents` | Tutti multi-agent：子代理/后台 agent 列表、运行状态、一键跳转 | `enableAgents`（默认开） |
|
||
| **Apps**（应用中心） | `wb:apps` | Tutti App Center：Design/PPT/Video 应用网格，点击在会话视图打开 | `enableApps`（默认开） |
|
||
| **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`，或自定义任意名字 |
|
||
| `enableTasks` / `enableAgents` / `enableApps` / `enableProfile` | `true` | 各 Tab 显隐开关 |
|
||
| `showTime` / `showUngrouped` | — | Tasks 子设置 |
|
||
| `appsList` | 内置三件套 | 应用中心自定义条目（可选） |
|
||
|
||
## 卸载
|
||
|
||
```bash
|
||
dsh plugin --profile desktop remove apes-sidebar
|
||
```
|
||
|
||
## 兼容性注意
|
||
|
||
- **不要与 `dsh-background-agents` 0.7.1 同 profile**：与基座 `storage` loader 条目 id 冲突会导致启动崩溃。
|
||
- Apps Tab 通过 `conversation.view` 视图 id 调起 Design/PPT/Video；若视图切换 API 不可用则优雅降级（提示在会话顶栏切换）。
|
||
- Agents Tab 不依赖 `remote.commands`（该服务不存在）。
|
||
|
||
## 结构
|
||
|
||
- `lib/index.js` — host 侧最小入口（Node）
|
||
- `lib/client.js` — client bundle（`__ModuleLoader__.load` 格式），注册 4 个可配置 Tab
|
||
- `cordis.patch.yml` — profile 组成树挂载（含双挂载守卫）
|
||
|
||
## License
|
||
|
||
MIT
|