前言¶

DeepSeek Harness（DSH）的插件生态强调“一切皆插件”。在使用官方 @vectorize-io/hindsight-coding-agents 插件时，桌面端存在两个具体问题：一是守护进程不会随 DSH 自动启动，需要手动在 CLI 中处理；二是启动时会弹出黑色的终端窗口。

本插件作为旁路补丁，接管守护进程的启动与停止，自动绑定 DSH 的生命周期。它解决了守护进程冷启动延迟、黑框干扰以及安装路径受限的问题，使本地记忆功能在桌面端具备完整的可用性。

核心功能¶

一键开关与状态指示
在 DSH 侧边栏提供“本地记忆”按钮，实时显示守护进程状态（未运行 / 启动中 / 运行中 / 失败）。
自动启动与退出随停
插件会在 DSH 启动后约 40 秒内自动拉起守护进程，不阻塞主界面。同时，它通过一个独立的“看门狗”进程监控 DSH 主进程，一旦检测到 DSH 退出，立即杀掉守护进程并释放内存。
隐藏终端黑框
插件会自动给官方的 daemon-start.js 打上“隐藏窗口”的补丁（支持自愈，官方更新后自动重打），并后台隐藏 uv.exe 的终端窗口。
安装到其它盘
通过配置参数，可将守护进程（uv 缓存）与模型缓存安装到任意盘符，避免占用 C 盘空间。

    <DSH_HOME>/profiles/node_modules/dsh-hindsight-local/

    - insert:
        - id: hindsight-local
          name: 'dsh-hindsight-local'

安装并重启 DSH 后，守护进程会自动进入待命状态。

插件自身的配置文件位于 <DSH_HOME>/storages/dsh-hindsight-local/config.json：

{
  "installDir": "X:\\hindsight",
  "autoStart": true
}

installDir：指定守护进程与模型的安装目录。留空则使用系统默认位置；指定后，UV_CACHE_DIR 和 HF_HOME 会指向该目录下的子文件夹，从而将数据安装到任意盘符。
autoStart：布尔值。设为 true 时，DSH 启动时自动拉起守护进程；设为 false 时，仅依赖手动开关。

资源占用：本地守护进程常驻内存约 0.8–1 GB，首次安装磁盘占用约 3 GB（主要包含 torch 依赖及模型文件）。关闭开关或退出 DSH 后内存会释放。
冷启动时间：首次启动需下载依赖和模型，耗时约 1–3 分钟；后续缓存命中，约 40 秒内就绪。
黑框机制：黑框是通过 ShowWindow(SW_HIDE) 隐藏的，进程仍在后台运行。不要手动点击黑框的关闭按钮，否则会杀掉守护进程。
官方更新：官方插件更新可能会覆盖 daemon-start.js，本插件的窗口补丁会在下次启动时自动重打。
密钥安全：DEEPSEEK_API_KEY 仅通过 DSH 宿主的凭证服务读取，不写入本地文件，也不会暴露在插件进程之外。

该插件通过旁路补丁的方式，完善了 hindsight-coding-agents 在 DSH 桌面端的本地记忆生命周期管理。它提供了自动启动、退出清理、窗口隐藏以及安装路径配置等实用功能，适合需要稳定使用本地记忆功能的开发者。