From c0441d3a7ebd9825b5ec4a8b8281ae808dde314a Mon Sep 17 00:00:00 2001 From: figmar Date: Mon, 7 Sep 2026 02:02:55 +0800 Subject: [PATCH] =?UTF-8?q?docs:=20README=20=E8=A1=A5=20v1.0.0=20fork=20?= =?UTF-8?q?=E7=89=88=E6=9C=AC=E6=9B=B4=E6=96=B0=E8=AF=B4=E6=98=8E=20(4=20?= =?UTF-8?q?=E4=B8=AA=20apes=20tab=20+=20=E6=95=B0=E6=8D=AE=E6=8E=A5?= =?UTF-8?q?=E5=85=A5)?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- README.md | 19 +++++++++++++++++++ 1 file changed, 19 insertions(+) diff --git a/README.md b/README.md index 454e759..994d4d4 100644 --- a/README.md +++ b/README.md @@ -265,6 +265,25 @@ GitHub topic [`dsh-better-sidebar`](https://github.com/topics/dsh-better-sidebar **支持的 DSH 版本**：支持的 DSH 版本（v0.18.0 正式版）：0.1.2-rc.1+ · 完整发布历史见 [Releases](https://github.com/omdsh-dev/DSH-better-sidebar/releases) +### v1.0.0（fork · apes 信息层） + +> 📌 **fork 独立版本线**：自 upstream `dsh-better-sidebar@v0.18.0`（commit `9e1a034`）fork，新增 `apes:*` 信息层 tab。upstream 历史版本见下方 v0.18.0 段。 + +**🪧 新增 4 个 `apes:*` 信息层 tab**（独立模块 `src/client/apes/`，与 upstream builtin tab 解耦） + +- **`apes:tasks` 任务**：接 `ctx.sessions.list` 的 `jobsBySession` + running sessions —— live 任务列表（label / 运行中·完成·失败 / kind / 耗时 + owner 归属） +- **`apes:agents` 智能体**：接 `subagentsByParent` 目录（降级 `byId`）—— subagent 拓扑（main → 直接 children 的 activity：running / inactive） +- **`apes:apps` 应用**：展示当前工作区 cwd（`scope.cwd` + `byId[current].cwd`；无 DSH host feed，保留说明占位） +- **`apes:profile` 画像**：接 `byId[current]` —— 当前会话画像（title / cwd / running / agent 状态） + +**🔌 数据接入** + +- 数据源 `ctx.sessions.list.getSnapshot()` 经 `useSyncExternalStore` 响应式订阅（snapshot 含 `current` / `byId` / `subagentsByParent` / `jobsBySession`） +- 复用 upstream pure helper（无 UI / Node 依赖）：`subagent-lineage.ts`（`rootAncestor` / `isSideThreadSummary`）+ `subagent-jobs.ts`（`collectTreeJobs` / `orderJobs` / `isJobLive` / `jobDotState`） +- UI 独立内联样式，不耦合 builtin CSS module / `StateDot`（保持 apes 模块隔离，cherry-pick upstream 时只碰 `index.tsx` 一处） + +**🌏 i18n**：4 个视图全部走 `t(key)`，`zh` 默认 + `en` fallback，状态 / 耗时 / 空态均有双语词条 + ### v0.18.0 > 📌 **正式版**（npm `latest`）：本版仅支持 **DSH 0.1.2-rc.1+**（peer 下限 `^0.1.2-rc.1`）；不再支持 0.1.0-rc.8 ~ 0.1.1-rc.2——DSH stable 用户请固定安装 `dsh-better-sidebar@0.17.1`，停留在 0.1.2-alpha.x 的宿主继续用 `dsh-better-sidebar@alpha`（v0.18.0-alpha.0）。