Hua1Q1nG/dsh-hindsight-local-optimize

dsh-hindsight-local-optimize

为 DeepSeek Harness（DSH 桌面端）的 @vectorize-io/hindsight-coding-agents 插件补上「本地记忆」完整生命周期与体验的优化插件。

本插件不修改官方插件的业务逻辑，而是作为旁路补丁：接管守护进程的启动/停止、自动绑定 DSH 生命周期、隐藏终端黑框、支持把档案柜装到其它盘。

背景：解决了什么问题

官方 hindsight-coding-agents 在 DSH 桌面端有两个缺口：

1. 本地守护进程不会自动启动
官方 DSH 版插件只把记忆地址指向本机 127.0.0.1:9077，但从不主动拉起 hindsight-embed（hindsight-api）守护进程——自动冷启动只实现在 Claude Code / Cursor / Copilot 等 CLI 工具里。结果是：选「本地保存」后，DSH 去连 9077 端口但那里没人值班，记忆功能等于没生效。

2. 会弹出黑框
守护进程的宿主 uv.exe 在 Windows 11 上会用 WindowsTerminal 弹出一个终端黑框，且常驻不消失。

本插件补齐这两点，并提供一键开关、开机自启、退出随停。

功能

- ✅ 一键开关：侧边栏「本地记忆」按钮，实时状态灯（未运行 / 启动中 / 运行中 / 失败）。
- ✅ 开机自启：DSH 启动时自动在后台拉起守护进程（带重试，约 40 秒内就绪，不阻塞 DSH）。
- ✅ 退出随停：独立「看门狗」进程监控 DSH 主进程，DSH 退出时立即杀掉守护进程、释放内存。
- ✅ 隐藏黑框：自动给官方启动器 daemon-start.js 打「隐藏窗口」补丁（自愈），并后台隐藏 uv.exe 的终端窗口。
- ✅ 装到其它盘：守护进程（uv 缓存）与模型（HuggingFace 缓存）可安装到任意盘。

架构

dsh-hindsight-local-optimize/
├── lib/
│   ├── index.js          # 宿主半边：路由、启停、凭证读取、官方启动器补丁、看门狗
│   ├── client.js         # 客户端半边：侧边栏开关按钮
│   ├── hide-window.ps1   # 隐藏 uv.exe 终端黑框（Win32 ShowWindow）
│   └── watchdog.mjs      # 看门狗：独立进程，DSH 退出时杀守护进程
├── package.json          # 双面插件声明（dsh.bundle.patch + dsh.client）
├── cordis.patch.yml      # 挂载补丁
└── README.md

工作原理（关键点）

- 启动链路：插件读宿主凭证服务取 DEEPSEEK_API_KEY（Key 不出宿主进程）→ 注入 HINDSIGHT_API_LLM_* 环境变量 → 后台 spawn node daemon-start.js --harness dsh 拉起守护进程。
- 退出链路：因为守护进程是「孤儿进程」，且 DSH 退出时承载插件的进程会被 Windows 强杀、退出钩子不可靠，所以插件额外 spawn 一个独立看门狗进程，每 2 秒探测 DSH 主进程；一旦发现 DSH 退出，立即 taskkill 守护进程并自身退出。
- 黑框处理：启动前给官方 daemon-start.js 内部 spawn uvx 补 windowsHide: true（自愈：官方更新覆盖后下次自动重打），再用 hide-window.ps1 枚举并隐藏标题含 uv.exe 的窗口。

安装

前置条件

- 已通过 DSH 插件市场安装官方 @vectorize-io/hindsight-coding-agents（本插件依赖它的 daemon-start.js）。
- 本机已安装 uv（uvx 在 PATH），用于运行 hindsight-embed。
- 已在 DSH 凭证里配置 DEEPSEEK_API_KEY（本地记忆抽取需要一个大模型，官方支持 DeepSeek）。

安装本插件

1. 把本仓库克隆或复制到 DSH 的全局插件目录：

/profiles/node_modules/dsh-hindsight-local/

2. 在 /profiles/web/cordis.patch.yml 末尾追加一行挂载：

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

3. 完全退出并重新打开 DSH 桌面端。

使用方法

安装并重启 DSH 后：

1. 自动启动：DSH 启动后约 40 秒，左下角「本地记忆」按钮会自动变成「运行中」（无需手动操作）。
2. 手动开关：点击左下角「本地记忆」按钮，可随时手动启动 / 停止守护进程。
3. 退出随停：直接关闭 DSH，守护进程会被看门狗自动杀掉、内存立即释放。

配置参数

插件自身的配置在 /storages/dsh-hindsight-local/config.json：

{
"installDir": "X:\\hindsight",   // 守护进程与模型的安装目录；X 代表任意盘符，留空则用系统默认位置
"autoStart": true                // 是否开机自动启动
}

- installDir：非空时，插件会把 UV_CACHE_DIR 指向 /uv-cache、HF_HOME 指向 /hf-models，让档案柜和两个小模型装到指定盘。
- autoStart：true = DSH 启动时自动拉起守护进程；false = 只靠手动开关。

Hindsight 记忆本身的配置仍在 ~/.hindsight/coding-agent.json（插件启动时会自动写入 serverMode: "daemon"）。

注意事项
- 资源占用：本地守护进程常驻约 0.8–1 GB 内存；首次安装约 3 GB 磁盘（主要是 torch 依赖 + 两个小模型）。关闭开关或退出 DSH 后内存即释放。
- 首次冷启动慢：第一次启动要下载 hindsight-embed 包和模型，约 1–3 分钟；之后缓存命中，40 秒内就绪。
- 黑框是隐藏不是消除：uv.exe 的终端窗口被 ShowWindow(SW_HIDE) 隐藏，进程仍在后台；彻底不弹需等 uv 上游支持。别手动点黑框的 × 关闭它，那会杀掉守护进程。
- 官方更新：官方插件更新覆盖 daemon-start.js 后，本插件的窗口补丁会在下次启动时自动重打。
- 密钥安全：DEEPSEEK_API_KEY 始终通过 DSH 宿主凭证服务读取，不落盘、不出宿主进程，请勿在代码或配置里硬编码密钥。

许可证

MIT