前言¶
在 DeepSeek Harness 里接 Hindsight 做智能体记忆时，常见情况是：记忆 API 是否健康、Control Plane 能否打开、bank 命名和各类模型参数分散在不同配置文件里，还要在浏览器、终端和编辑器之间来回核对。官方包 @vectorize-io/hindsight-coding-agents 负责 hindsight_* 工具与 MCP，但缺少一块集中可视化的设置入口。社区插件 dsh-hindsight-gui（维护者 KouzakiUmi，MIT 许可）把 Hindsight 的连接、模型、向量后端、安全选项和部分本机服务操作收进 DSH 侧边栏；它不负责记忆读写，也不替代 Hindsight 服务本身的部署。
这是什么¶
dsh-hindsight-gui 是 Hindsight 在 DeepSeek Harness 中的配置与状态界面（settings dashboard），不是记忆引擎。记忆工具由官方集成提供；本插件只做配置展示、保存、健康查询，以及在满足归属校验时对本插件启动的本机 hindsight-api 进行启动或重启。npm 包名与 DSH 插件名均为 dsh-hindsight-gui，当前资料中 package 版本为 1.4.0，客户端平台标注为 web。
五个分类，一处管理¶
设置页按五个 ARIA 标签分区，支持方向键、Home、End 导航；未保存草稿在分类间切换时会保留，轮询不会覆盖正在编辑的内容。
- 概览：服务、归属与「下次启动」预览。
- 记忆与连接：Hindsight API 地址、bank 等连接项。
- 模型：聊天／服务功能模型及向量后端。
- 安全：记忆库视图、审计与按 bank 脱敏。
- 高级：其它选项。
底部保存条提交基础配置；部分管理卡片有各自的保存与确认流程。界面区分四类状态，避免混淆：正在编辑（草稿）、已经保存（写入配置文件）、下次启动预览（基于已保存值解析，不等于外部服务当前配置）、当前运行快照（仅本插件成功启动且确认过的本机服务才有）。
配置写入两个文件，且不是跨文件事务：apiUrl、surveyModel 等在上游 coding-agent.json；服务模型、向量、控制台地址在本插件 dsh-hindsight-gui.json。保存失败、读取失败、409 冲突或非法维度会显式提示；若出现部分保存，应刷新后核对，不要假设两份文件都已写入。
向量后端与连接边界¶
向量卡片按所选后端展示可编辑字段；不选后端表示继承既有服务配置。资料中列出的后端包括 local、openai、onnx、tei，各自「本页可指定」与「需要自行准备」的项见上游 README 表格。切换后端不会自动迁移索引；修改前需核对存量向量数据。serverEnv 为配置文件级高级透传，不是界面控件。
连接目标不同，本机进程管理能力也不同：既有第三方 Hindsight API 可连接与健康查询，但不能被本插件接管或停止；经本插件启动且进程身份与归属记录核验通过的本机 API 才支持重启；远端、HTTPS、IPv6 或非根路径 URL 可连接查询，但不提供本机进程管理。启动服务会查找已安装的 hindsight-api 与对应 Python；本机管理当前适配 Hindsight 0.10.2、单 worker。本插件不安装 Hindsight、不下载模型、不重建向量索引。
安装与启用¶
使用前需自行部署可连接的 Hindsight API（参见 Hindsight 官方文档）；若要用界面上的本机启动按钮，还需自行安装 hindsight-api 可执行文件。
记忆功能与设置界面是两个职责不同的 DSH 包：只需要记忆工具时，GUI 并非官方集成的必需依赖。资料中的安装示例如下（web 仅为示例 Profile，Desktop 应使用目标桌面壳提供的 DSH Desktop CLI，并核对 bundle 列表与 Host 重载方式）：
dsh plugin --profile web add @vectorize-io/hindsight-coding-agents
dsh plugin --profile web add dsh-hindsight-gui
安装不等于启用：按你的部署方式重新加载或重启 Host 与 Client，不要在 Profile 里裸跑 npm/pnpm。
典型用法¶
经过上面的安装步骤后，在侧边栏打开 Hindsight 设置页：
- 填写 Hindsight API 地址（例如
http://127.0.0.1:8888）。 - Control Plane 为可选管理界面，默认示例为
http://127.0.0.1:9999。 - 保存后在页面上查看健康状态与 bank 列表；具体可用功能以实际 Hindsight 版本与环境为准。
除基础连接外，README 还描述了诊断与认证、任务队列、库设置、隐私与成本、模型调试、ZIP 迁移与别名等管理功能；涉及写入、收费、备份或下载的操作使用统一确认对话框，并由 Host 验证一次性令牌与接口能力。这些能力均依赖已连接且权限满足的 Hindsight API，关闭或未知时会禁用相关动作。
适用场景与注意¶
适合谁：已在 DSH 中使用或计划使用 Hindsight 记忆栈、希望用侧边栏集中改连接与模型配置、并需要清晰区分「已保存」与「当前运行」状态的开发者。
能力边界（务必知晓）：
- 本插件不提供
hindsight_*工具，也不部署 Hindsight 服务。 - 保存不等于立即运行：服务端模型、向量、审计等通常在下次受控启动／重启时应用；官方 0.8.1 DSH 适配器对工作区配置有缓存，保存后是否生效需在实际环境中核验。
- 不会任意终止 PID：仅对经启动链或归属记录核验的本插件服务尝试非强制停止；Windows 失败时需手动处理。
- 凭据不会在预览中回传明文，但配置文件不是加密存储；插件以当前 DSH 进程权限运行，安装前应阅读源码与 MIT 许可证，并理解其读写配置与可选的本机服务控制范围。
社区目录 SkillHub 插件页 与 GitHub 仓库相互独立，均非 DeepSeek／幻方官方应用商店；星标与分类以目录页展示为准。
延伸阅读¶
| 资源 | 说明 |
|---|---|
| GitHub：KouzakiUmi/dsh-hindsight-gui | README、Issue、发布与 CI |
| 技术参考 | 配置字段、凭据解析、开发与发布 |
| Hindsight 官方 | 上游记忆系统 |
若出现「API 未运行」「待下次启动应用」「维度未知」「无法重启」等提示，应优先核对 API 地址与健康端点、既有索引与后端模型、以及进程归属与控制通道是否就绪，而不是根据端口占用猜测配置或服务所有权。
