From 58857d6ecd1f53f139a9476241766d42584b6cad Mon Sep 17 00:00:00 2001 From: figmar Date: Wed, 2 Sep 2026 08:15:54 +0800 Subject: [PATCH] docs: v0.4.0 readme --- README.md | 33 ++++++++++----------------------- 1 file changed, 10 insertions(+), 23 deletions(-) diff --git a/README.md b/README.md index cce0a13..6c13742 100644 --- a/README.md +++ b/README.md @@ -2,12 +2,13 @@ WorkBuddy / Tutti 风格的右侧边栏增强插件(基于 [dsh-better-sidebar](https://github.com/omdsh-dev/DSH-better-sidebar) 的 `ctx.betterSidebar` 服务)。**显示名可配置**:默认 `apes--sidebar`,预设 `feyOS`,或任意自定义。 -在 better-sidebar 的右侧工作台里新增 3 个**可配置** Tab: +在 better-sidebar 的右侧工作台里新增 4 个**可配置** Tab: | Tab | id | 对应参照 | 配置开关 | |---|---|---|---| -| **Tasks**(任务导航) | `wb:tasks` | WorkBuddy 左侧任务列表:按工作区+时间分组、搜索、运行中徽标、一键打开/新建会话 | `enableTasks`(默认开) | +| **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`(默认开) | ## 安装 @@ -24,13 +25,10 @@ dsh plugin --profile desktop add apes--sidebar | 键 | 默认 | 说明 | |---|---|---| -| `displayName` | `apes--sidebar` | 显示名:预设 `feyOS`,或自定义任意名字(Profile Tab 标题与卡片名跟随) | -| `enableTasks` | `true` | 显示 Tasks Tab | -| `enableAgents` | `true` | 显示 Agents Tab | -| `enableProfile` | `true` | 显示 Profile Tab | +| `displayName` | `apes--sidebar` | 显示名:预设 `feyOS`,或自定义任意名字 | +| `enableTasks` / `enableAgents` / `enableApps` / `enableProfile` | `true` | 各 Tab 显隐开关 | | `showTime` / `showUngrouped` | — | Tasks 子设置 | - -持久化在 `prefs.pluginSettings['apes--sidebar']`。 +| `appsList` | 内置三件套 | 应用中心自定义条目(可选) | ## 卸载 @@ -38,29 +36,18 @@ dsh plugin --profile desktop add apes--sidebar 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`(该服务不存在);团队房间能力暂不可用,界面显示说明。 +- **不要与 `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` 格式),注册 3 个可配置 Tab +- `lib/client.js` — client bundle(`__ModuleLoader__.load` 格式),注册 4 个可配置 Tab - `cordis.patch.yml` — profile 组成树挂载(含双挂载守卫) -## 关联 - -- 前身:dsh-wb-sidebar(v0.2.0)→ 更名为本插件(v0.3.0) -- 聚合安装包:figmar/dsh-sidebar-boost(含基础侧边栏 + 多个增强插件) - ## License MIT