HuanLinOTO/dsh-plugin-ya-workspace-sidebar

ya-workspace-sidebar

npm version

cover

DSH Web 工作区侧栏替代插件。顶部以虚拟滚动展示全局最近会话（完整列表，不限于 5 条），与下方 Workspace → Session 二级菜单之间有一条可拖拽分隔条（也支持方向键微调、双击复位），面包屑导航与选中工作区的会话按本地日历日期分组（今天/昨天/更早）；搜索、添加工作区、重命名、删除、Fork 与归档继续使用 DSH 原生 Host 能力。会话行支持右键菜单（与 … 按钮菜单一致）：置顶（本地，置顶行浮于日期分组之上）、重命名、标记未读（本地蓝点，打开会话自动清除）、在资源管理器中打开工作目录、复制路径 / 任务路径 / 日志路径 / 会话 ID。任务路径与日志路径仅文件型（jsonl）持久化部署可用；sqlite 型部署（如 @morlay/better-session）对应菜单项自动禁用。工作区行不设悬停按钮，右键直接弹出菜单（新建会话 / 在资源管理器中打开 / 复制路径 / 重命名 / 删除）；标题超宽时以渐隐（mask 渐变）截断、不显示省略号，路径保持左对齐省略号硬截断。

运行

插件采用 bundle 形式，cordis.patch.yml 会禁用官方 ui-workspace 并插入 @huanlin/dsh-plugin-ya-workspace-sidebar。DSH v0.1.2-alpha.1 起，官方 ui-sidebar / ui-conversation / ui-agent-preset 及目录选择器组合包会注入 ctx.uiWorkspace 服务，本插件 client entry 通过 src/client/navigation.ts 自供该服务的替身（含复用/新建会话导航、current/recent 回退、归档清理与启动自动选择策略），否则这些条目会永久 pending 导致 WebUI 启动死锁。安装：

从 npm 安装（推荐）：
dsh plugin --profile web add @huanlin/dsh-plugin-ya-workspace-sidebar

本地开发（热更新）：
dsh plugin --profile web add "link:D:/Projects/deepseek-harness/ya-workspace-sidebar"

修改源码后重新运行 pnpm run build，再重启 dsh web 并硬刷新浏览器。

开发

pnpm install
pnpm run typecheck
pnpm test
pnpm run build

dsh/ 仅作为类型和行为参考，插件不会修改 DSH checkout。浏览器产物预构建到 lib/client.js，因此仓库发布时必须提交 lib/。

检查

pnpm run typecheck
pnpm test
pnpm run build

构建后确认 lib/index.js、lib/client.js 和 lib/types/ 存在，并确认 lib/client.js 使用 window.__ModuleLoader__.load() 包装。

本包自 v0.1.2-rc.1 起不再发布 ./invariant 导出：本插件贡献的均为 client-only slot 条目，无独立可分歧的观察，按新 invariant 规则省略其源码与接线。