With-With/dsh-hindsight-plugins

Plugin插件 Native原生 ⭐ 4 Memory & Knowledge记忆与知识库

Project Overview项目介绍

This is a native plugin built exclusively for DeepSeek Harness (DSH), acting as a management wrapper for the Hindsight external memory system. It adds a graphical settings interface to DSH’s Web GUI, supports automatic detection and installation of the official Hindsight DSH adapter, and includes a toggle for active session syncing. The plugin works out of the box after installation, with no command line operations required for basic use. It only wraps the official Hindsight memory system for coding agents and does not modify the official runtime at all. Users can install it through three methods: one-click install via the DSH Plugin Marketplace, command line install, or manual cloning and registration.

After installation, you must restart the DSH web process and refresh your browser page for the plugin to load. For first-time use, navigate to the “External Memory” tab under the plugins section of the DSH settings page, where the plugin will automatically check if the official Hindsight adapter is installed. If the adapter is missing, a red warning banner will appear with a one-click installation button. Once you have configured your Hindsight server address and tested connectivity, you can toggle the active sync switch to match your preferences. This plugin is designed for DSH users who want persistent external memory for their coding agents.

The plugin only requires Node.js 20 or newer, and has no extra runtime dependencies on the DSH host side. To use it, you only need a running, reachable Hindsight server (either self-hosted or cloud-hosted; this plugin does not include a Hindsight server itself). Known limitations include that configuration changes only apply to new sessions, and any changes to the host-side code require a full restart of the DSH web process. The plugin is open-source under the MIT license, so it is free to use and modify for any purpose.

这是专为DeepSeek Harness(DSH)打造的原生插件,是Hindsight外部记忆系统的管理包装。它提供图形化设置界面,支持官方Hindsight DSH适配器的自动检测与安装,自带主动同步开关,装完即可使用,全程无需操作命令行。本插件仅包装官方Hindsight编码代理记忆系统,不对官方运行时做任何修改,支持三种安装方式:DSH插件市场一键安装、命令行安装、手动克隆挂载。

安装完成后需要重启DSH Web端并刷新页面才能生效。首次使用需要进入设置页的插件分类下的「外部记忆」标签页,插件会自动检测官方适配器的安装状态。如果适配器缺失,会显示红色提示横幅并提供一键安装入口。完成Hindsight服务器地址配置和连通性测试后,即可按需开启或关闭主动同步功能。本插件面向需要为编码代理添加持久化外部记忆的DSH用户。

本插件要求Node.js版本不低于20,DSH宿主端不需要额外运行时依赖,使用时仅需一个可访问的Hindsight服务器(支持自建或云端,本插件不自带服务器)。已知限制包括配置变更仅对新会话生效,宿主端代码修改需要重启DSH Web端才能生效。本插件基于MIT许可证开源,免费可供用户使用和二次开发。

Pre-install check安装前体检Compatibility · Security兼容性 · 安全性 2 warnings2 项注意
  • No license declared - all rights reserved by default; ask the author before commercial use or redistribution未声明开源许可证 —— 默认「保留所有权利」,商用或再分发前先问作者
  • Only 4 stars - very few users, little community feedback星标只有 4,几乎没人在用,遇到问题缺少社区反馈
DSH walks through these 9 checksDSH 会逐条核对这 9 项

Compatibility兼容性

  • DSH, Node, OS and profile requirementsDSH 版本 / Node 版本 / 操作系统 / profile 是否满足要求
  • External dependencies and runtimes (Electron / Python / Docker, ...)外部依赖与运行时(Electron / Python / Docker 等)是否齐备
  • Conflicts with installed plugins: command names, skill / tool names, ports, duplicate MCP registration与已装插件是否冲突:命令名、skill / tool 重名、端口占用、重复 MCP 注册

Security安全性

  • Repo matches the facts registered here; archived or abandoned?仓库是否与页面登记一致,是否归档或长期停更
  • Safety of preinstall / install / postinstall and install.sh / setup.ps1preinstall / install / postinstall 与 install.sh、setup.ps1 是否安全
  • curl|bash, download-then-execute, obfuscation, unrelated domains → stop immediatelycurl|bash、下载即执行、混淆代码、无关域名 → 立刻停止
  • Typosquatting or unmaintained packages among the new dependencies新增依赖里有没有 typosquatting 或无人维护的包
  • Requested permissions vs. what the feature actually needs申请了哪些权限、是否超出功能所需(filesystem / network / shell / clipboard)
  • Any sudo / admin requirement, plus uninstall and rollback是否要求 sudo / 管理员权限,以及卸载与回滚方式

Anything uncertain must be marked unknown with a note on how to confirm it. This site's signal screen is a static snapshot, not a security audit.拿不准的必须标「未知」并说明要我怎么确认。本站的信号筛查是静态快照,不能替代安全审计。

Or use CLI install (for developers)或使用命令行安装(适合开发者)

CLI Install命令行安装

dsh plugin --profile web add git+https://github.com/With-With/dsh-hindsight-plugins.git

把 With-With/dsh-hindsight-plugins 加入你的 DSH 配置(web profile)即可启用。

READMEREADME

dsh-hindsight-plugins

DeepSeek Harness GitHub Stars License Version 类型 平台

DSH(DeepSeek Harness)的 Hindsight 外部记忆管家:设置页图形界面 + 官方适配器自动检测与自动安装 + 主动同步开关,装完即用,全程无需命令行。

🧠 底层使用官方 Hindsight 记忆系统 (Coding Agents 集成)。 本插件是它的包装与管家,不修改官方运行时。


⚡ 一键安装(复制即用)

喂给 AI 的一句话(AI 具备命令执行能力即可,无需解释):

安装 DSH 插件 dsh-hindsight-plugins(Hindsight 外部记忆管家):克隆 https://github.com/With-With/dsh-hindsight-plugins 到 ~/.dsh/profiles/web/node_modules/dsh-hindsight-plugins,在 ~/.dsh/cordis.patch.yml 追加 - insert: 条目(id: hindsight-plugins,name: dsh-hindsight-plugins,config.autoInstall: true),然后重启 dsh web 并刷新页面。

或者直接复制命令执行:

平台 命令
Windows (PowerShell) git clone https://github.com/With-With/dsh-hindsight-plugins.git "$env:USERPROFILE\.dsh\profiles\web\node_modules\dsh-hindsight-plugins"
macOS / Linux git clone https://github.com/With-With/dsh-hindsight-plugins.git ~/.dsh/profiles/web/node_modules/dsh-hindsight-plugins

克隆后还需注册 patch 条目(见下文 📦 安装本插件)并重启 DSH。也可以在 DSH插件市场 中一键安装(自动完成克隆 + 注册)。


✨ 功能特性

  • 自动检测与自动安装:插件启动时检查官方 DSH 适配器(npx @vectorize-io/hindsight-coding-agents install dsh)是否已安装挂载;缺失时自动非交互执行官方安装器(地址依次取自:现有 coding-agent.json -> 本插件 sidecar 的内网地址 -> 插件配置 defaultApiUrl)。也可在界面点「一键安装官方适配器」,安装日志实时滚动
  • 重复注册检测与一键收敛:精确审计所有补丁层的 id: hindsight 注册数(0 = 缺失 / 1 = 健康 / ≥2 = 重复)。重复会导致 dsh web 启动失败(duplicate loader entry id)--此时界面显示琥珀色警告与「一键收敛」按钮:保留 profile bundle 注册、移除官方安装器写入的 home 补丁行(改动前自动备份)。收敛只在用户点击或安装完成后执行,绝不明动
  • 设置页 GUI:设置 -> 插件 -> 「外部记忆」标签页
    • 状态卡:当前路由 + 写入范围(首行)、当前内/外网地址、Hindsight 服务端版本号(GET /version 官方同款端点)、Coding Agents 版本号、安装状态(绿/红)
    • 「管理」弹窗:编辑内网地址 / 外网地址 / 当前路由(内网|外网),逐地址「测试」连通性,保存设置
  • 双路由管理:内网/外网两套地址 + 一键切换;写入固定走 harnesses.dsh.apiUrl 分节(仅 DSH 生效),不影响 Codex 等其他客户端
  • 主动同步开关(默认关闭):区分两种同步方式
    • 不主动同步(默认):不自动写入会话记录;对话中明确要求记住的内容("把这个存进记忆")依然正常入库--被动同步不受影响
    • 主动同步(开关开启):AI 每轮答完后自动写入 Hindsight(官方 retainSessions 机制,服务端折叠去重,不浪费提取)
    • 映射官方 harnesses.dsh.retainSessions(显式 true/false),对新会话生效;插件首次启动会把缺失的键迁移为显式 false
  • 安全写入:原子写 + 改动前自动备份 coding-agent.json(*.hindsight-settings-backup),保留全部未知字段
  • 未安装警示:适配器缺失时红色横幅 + 一键安装按钮 + 安装命令 + 官方文档链接 + 「?」帮助
  • 零构建零依赖:宿主半边仅用 Node 内建模块(≥ 20),npm / 市场克隆 / 目录复制任何方式均可运行

Showing the opening section of the README — the full document lives in the repository以上为 README 开头摘要,完整文档在仓库内 · View the full README on GitHub →在 GitHub 查看完整 README →

← 上一个 Prev dsh-token-saver 下一个 Next dsh-on-imessage →