前言¶
DeepSeek Harness (DSH) 采用插件化架构，社区开发者常需要为特定场景扩展功能。dsh-context-badge 是一个本地优先的插件，专注于解决 DSH 会话中的上下文记录与任务追踪问题。它不依赖远程同步或模型调用，通过浏览器本地存储和可选的 macOS 伴侣应用，为开发者提供轻量级的状态管理能力。
核心功能¶
-
界面集成
在 DSH 编写器的 Dock 栏增加一个小型的上下文徽章。 -
本地存储
利用浏览器localStorage为每个 DSH 会话或工作区保存笔记和待办事项，支持自动版本迁移。 -
信息展示
在徽章中显示当前 DSH 会话名称、工作区基名、对话轮数/步数以及 Token 摘要（如可用）。 -
上下文管理
支持在“会话上下文”和“工作区上下文”之间切换，查看保存状态，清除已完成的待办事项，并回顾最近更新的 8 个上下文。 -
自动摘要
自动保留每个会话的前 5 条加载的用户或引导消息，并从中推导出本地用途行，无需调用模型或进行远程同步。 -
macOS 伴侣应用
提供可选的菜单栏/始终置顶应用，仅跟踪前台应用名称和窗口标题，并记录最近 8 个前台上下文。
安装与启用¶
在插件的仓库根目录下执行以下命令即可安装：
dsh plugin add ./
对于本地开发配置，可以通过编辑 DSH 的插件配置文件进行链接，然后重启 DSH 网页服务。插件的 Bundle ID 为 dsh-context-badge。
使用示例¶
安装完成后，插件会自动在 DSH 界面中生效。如果需要使用 macOS 伴侣应用，请确保系统环境满足要求（macOS 13+ 和 Swift 5.9+）。
运行伴侣应用：
npm run run:macos
安装伴侣应用开机自启：
npm run install:macos
注意事项¶
- 数据隔离：插件不涉及截图、按键记录、网络请求、模型调用或远程同步，所有数据存储在本地。
- 伴侣应用存储路径：macOS 伴侣应用的数据存储在
~/Library/Application Support/ContextBadge/contexts.json。 - 隐私设置：首次运行伴侣应用时，可能需要在 macOS 的隐私设置中允许其观察窗口元数据。如果无法获取标题，应用仍可使用前台应用名称。
- 功能边界：该插件是一个独立的上下文工具，不会改变 DeepSeek Harness 的模型路由、提示词、权限、计费或代理预设。
总结¶
该插件为 DSH 用户提供了无需联网、不消耗模型 Token 的上下文管理方案，适合需要频繁切换工作区或管理多轮对话任务的场景。更多细节可查看插件目录页或GitHub 仓库。
