前言¶
在 DeepSeek Harness（DSH）里做多轮、多会话的智能体开发时，原生侧栏往往只能看到当前会话的有限信息。任务是否在推进、上一次助手回复写了什么、要从哪条历史会话接着做，常常需要逐个打开对话核对。下面介绍社区维护的客户端插件 DSH Sidebar History（liush2yuxjtu/dsh-sidebar-history），它利用 DSH 官方的 projection 与侧栏插槽 API，在侧栏中聚合未归档会话的 TODO 进度、最新保存的助手回复预览，并支持可搜索的历史卡片，且不修改上游 DSH 本体。
这是什么¶
DSH Sidebar History 是 MIT 许可的独立侧栏插件，维护者为 liush2yuxjtu。分类为客户端插件；当前资料中的仓库版本为 0.2.3，与 SkillHub 目录上的简介一致：任务进度、最新回复预览、可搜索的聊天历史。
插件通过 DSH 会话摘要中的 sidebarHistory projection 呈现数据，由宿主控制侧栏外壳、折叠与移动端抽屉；插件负责历史卡片视口渲染与搜索交互。
核心功能¶
历史卡片与任务进度¶
每张紧凑卡片展示：标题、更新日期、已完成/总任务数、最多三条任务项，以及最多两行的助手回复预览。进行中与待办任务优先于已完成项展示。
任务状态仅来自 todo/write；新的 turn/start 会清除上一轮任务，与 DSH 自带 TODO 生命周期一致。Earlier reply 表示保留了更早一轮的文本回复；No task list this turn 并不表示之前的工作已全部完成。当前轮的生成中、原生停止或失败状态会单独描述；仅工具调用或空消息时，侧栏仍尽量保留最近一条有用的文本回复。被打断的消息、推理过程、工具结果和未提交的尝试不会进入预览。
回复预览与可访问性¶
Markdown 预览在只读模式下按 DSH 使用的 GFM 语法渲染粗体、强调、删除线、代码等；列表与表格压缩为可读文本，链接显示标签、图片显示 alt。预览不跳转、不加载远程图片、不解析原始 HTML；完整渲染需在会话内打开。卡片会向无障碍 API 暴露任务计数、单项状态、回复文本与轮次上下文。
搜索、归档与键盘操作¶
搜索结合缓存的标题、回复与 DSH 官方内容搜索。远程搜索失败时保留本地匹配、标记结果不完整并提供 Retry search；结果上限会有截断提示。仅远程命中项及其滚动位置在导航往返后仍可恢复。支持 Up、Down、Home、End、Enter 键盘导航。
已归档会话默认隐藏。卡片底部 Workspaces & archives 可打开 DSH 工作区浏览器与会话操作；History cards 返回同一搜索、滚动位置与聚焦会话。
语言¶
侧栏支持英语、简体中文、繁体中文、日语、西班牙语，跟随 DSH 语言设置。
安装与启用¶
环境要求（以 README 为准）：
- Node.js
>=24.9.0 - 已存在的 DSH Web 安装
- 声明的 DSH 版本范围：
>=0.2.2-rc.1 <0.3.0；资料中写明已验证目标为 DSH0.2.2-rc.1（上游 commitfcc0ad462172522aaf5c93a7b2e01f6b9f0b0159），该范围内的其他版本未独立验证
从源码构建本地 tarball 并安装到 web profile：
git clone https://github.com/liush2yuxjtu/dsh-sidebar-history.git
cd dsh-sidebar-history
npm pack
dsh plugin --profile web add "$PWD/dsh-sidebar-history-0.2.3.tgz"
打开 DSH Web 后，历史侧栏会为未归档会话显示卡片。若使用其他 Web profile，将命令中的 web 替换即可；--profile 须写在 add 之前。亦可透过 DSH 插件管理器安装 tarball。更完整的发布说明见 DSH 上游安装指南。
包内附带预构建的浏览器模块；维护者修改 src/client.mjs 与 src/markdown-preview.mjs 后执行 npm run build:client。DSH 在运行时解析依赖，勿再安装第二套 React。DSH API 仍属预稳定阶段，升级前请自行核对兼容性。
典型用法¶
1、安装并打开 DSH Web，在侧栏进入 History cards，浏览各会话卡片上的 已完成/总数 与任务摘要。
2、需要接着未完成工作时，根据卡片上的 TODO 与两行回复预览定位会话，Enter 或点击进入对应对话，无需逐个打开列表。
3、在侧栏搜索框输入关键词；若远程搜索失败，使用 Retry search；结果过多时注意截断提示。
4、要管理工作区或归档，使用卡片区域底部的 Workspaces & archives；回到历史列表用 History cards，可恢复此前的搜索与滚动状态。
README 中的演示场景（如订单检查任务从 0/3 推进到 2/3 且保留模型保存的回复）说明了侧栏与真实 API 会话的联动方式；现场录像与校验报告见仓库 演示页 与 docs/verification.md。
适用场景与注意¶
适合：长期在 DSH Web 中维护多条智能体会话、依赖 todo/write 跟踪步骤、希望在侧栏快速扫一眼进度与最近回复的开发者。
权限与信任：插件以当前 DSH 进程的权限运行；安装前应阅读源码与 MIT 许可证，确认行为符合你的环境策略。插件不修改上游 DSH，但会读取并展示会话摘要中的 projection 与搜索相关数据。
遥测与隐私（可选）：维护者可用 npm run telemetry:collect 在授权前提下收集仓库统计（本地报告）。侧栏页脚的 Usage statistics 默认关闭，仅在用户明确同意后向 Supabase 发送固定动作事件，并尊重 Do Not Track / Global Privacy Control；资料强调不会上传聊天、TODO 文本、搜索词、会话 ID 等（详见 README「Telemetry and privacy」一节）。
DSH 社区插件目录托管于 SkillHub，与 DeepSeek / 幻方无官方从属关系；生态理念是「一切皆插件」，本插件是其中的客户端侧栏增强项。
