deepseek-harness/packages/client/ui-sidebar/README.zh.md

@deepseek-ai/dsh-client-ui-sidebar

English | 中文

侧边栏插件：真实 Host Workspace 按稳定的 Host 顺序排列；每个 Workspace 按自身顺序包含其 sessionIds，并以 parentId 嵌套；不属于任何 Workspace 的 Session 显示在末尾的 Ungrouped 分区。搜索、状态点以及折叠到布局拥有的 56px 轨道，都只属于呈现层。契约：slot 系统标准。

New Session 会启动运行时的页面局部前端 Session Intent；真实 Workspace 的「+」会启动一项以该 Workspace 为目标的 Intent。Workspace 标题栏的「+」打开 ui-workspace 的共享选择器，选择结果同样以一个前端 Session 为目标。Workspace Intent 不会出现在侧边栏中。

SidebarRootComponentProps 组合布局 owner share、全局 useSessions 和 useWorkspaces hook、已声明的 sidebar.workspace 与 sidebar.settings 子 slot，以及注入的 startSession、open 和侧边栏切换回调。这里没有插件 store：deriveGroups 消费对象层快照与组件局部的展开／搜索状态。

页脚承载 sidebar.settings：侧边栏只渲染固定在底部的布局 slot，并共享其栏状态（wide）；ui-settings 在此注册触发行和设置面板。

/client 导出表层只包含插件主体（apply／inject）及契约类型：SidebarRoot、行组件和树派生均属于内部实现（slot 注册通过闭包引用它们；测试直接导入 src 路径）。

模型体验

无。侧边栏渲染浏览器会话列表；这里没有任何内容进入模型请求。

KV Cache 影响

无；该包既不组装也不发送提供方请求。

已知限制与暂缓事项

• 状态点只有两种实时数据状态（running/none）：done/error/amber 数据源随 P-II 审批与通知到来；四色原语已经接线。
• 分组选单只提供按 Workspace 分组：Update/Status 分组策略只有图稿而没有规范，暂缓实现。
• 「New task completed」未读标记是本地查看状态：完成时间 > 上次查看时间这一事实永远不会到达主机。