前言¶
在使用 DeepSeek Harness (DSH) 进行开发时，同时运行多个会话会导致上下文切换频繁，难以集中精力处理当前任务。DSH Beacon 旨在解决这一痛点，为并发会话提供一个集中的注意力管理空间。
插件简介¶
DSH Beacon 是一个 DeepSeek Harness 可安装的插件包，专注于对并发会话进行监控与交接。它由 JingzeChen 维护，采用 MIT 许可证。该插件集成了确定性活动投影、注意力排序、有界生成的简报、/brief 命令、可拖拽的活动信标、全局工作台以及单会话上下文视图。
核心功能¶
DSH Beacon 提供以下核心能力：
- 确定性活动投影：对会话活动进行可预测的投影展示。
- 注意力排序：对需要关注的任务进行优先级排序。
- 有界生成的简报：生成大小受控的会话简报。
/brief命令：通过命令行触发简报生成。- 可拖拽活动信标：提供全局的活动入口点，支持拖拽布局。
- 全局工作台：列出未归档的顶层会话。
- 单会话上下文视图：展示特定会话的上下文状态。
安装与启用¶
在使用该插件前，请确保已安装兼容的 DeepSeek Harness 版本。Beacon 需要配合 Cordis 4.0.2、Node.js ^22.19.0 或 >=24.0.0 以及 React ^18.2.0 运行。
安装步骤如下：
- 添加插件到 Web 配置文件：
dsh plugin --profile web add @jingzechen/dsh-beacon
- 导出配置以确认插件已生效：
dsh --profile web --dump-config
- 启动 Web 客户端：
dsh --profile web
如需更新或移除插件，可使用以下命令：
dsh plugin --profile web update @jingzechen/dsh-beacon
dsh plugin --profile web remove @jingzechen/dsh-beacon
配置与使用¶
插件通过 cordis.patch.yml 提供保守的默认配置。如果需要修改配置，可以覆盖 dsh-beacon 行。由于 DSH 的补丁行会替换配置而非深度合并，修改时需重新声明所有必填字段。
在 sessionBriefLlm 配置中，如果同时指定 provider 和 model，可以将生成的简报固定到特定路由；如果两者均省略，则使用会话记录的最新可用路由。
注意事项¶
在使用过程中，请注意以下事实与限制：
- 版本兼容性：DeepSeek Harness 包版本必须满足
>=0.1.2-alpha.6 <0.1.3，且包含SessionEventIntent和session-briefLLM 用途。 - 文件访问：Beacon 不直接读取任意工作区文件，也不添加文件系统工具。
- 权限与交互：Beacon 不添加批量审批、自动回答或第二授权通道。审批和问答响应使用现有的 DSH 交互对象。
- 浏览器本地存储：Pin、Snooze、Bookmark 等偏好设置仅保存在当前浏览器中，清除网站数据后重置，不会同步到其他设备。
- Picture-in-Picture：独立预览窗口（Document Picture-in-Picture）需要显式点击才能打开。
- Token 成本：Brief 生成消耗 Token 并可能产生提供商费用。
总结¶
DSH Beacon 为 DSH 用户提供了管理并发会话所需的核心工作台功能。通过全局视图和简报机制，它可以显著降低多会话环境下的认知负荷。安装前请检查源码与许可证，并确保环境版本符合要求。
