dsh-hindsight-plugins

DSH（DeepSeek Harness）的 Hindsight 外部记忆管家：设置页图形界面 + 官方适配器自动检测与自动安装，装完即用，全程无需命令行。

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

✨ 功能特性

• 自动检测与自动安装：插件启动时检查官方 DSH 适配器 （npx @vectorize-io/hindsight-coding-agents install dsh）是否已安装挂载； 缺失时自动非交互执行官方安装器（地址依次取自：现有 coding-agent.json → 本插件 sidecar 的内网地址 → 插件配置 defaultApiUrl）。 也可在界面点「一键安装官方适配器」
• 设置页 GUI：设置 → 插件 → 「外部记忆」标签页
  • 当前状态展示：生效地址 (apiUrl)、DSH 专属覆盖、当前路由、写入范围、 serverMode、官方 runtime 版本、适配器挂载状态
  • 「管理」弹窗：编辑内网地址 / 外网地址 / 当前路由（内网|外网）/ 写入范围（全部客户端|仅 DSH），逐地址「测试」连通性，保存设置
• 双路由管理：内网/外网两套地址 + 一键切换；仅 DSH 模式写入 harnesses.dsh.apiUrl 分节，不影响 Codex 等其他客户端
• 安全写入：原子写 + 改动前自动备份 coding-agent.json （*.hindsight-settings-backup），保留全部未知字段
• 未安装警示：适配器缺失时红色横幅 + 安装命令 + 官方文档链接 + 「?」帮助
• 零构建：浏览器半边以 web2 模块格式手写，Node ≥ 20 即可运行

📦 安装

方式一：DSH 插件市场

在 DSH插件市场 中搜索 「hindsight」一键安装（本仓库带 dsh-plugin topic，市场索引自动收录）。

方式二：命令安装

dsh plugin --profile web add dsh-hindsight-plugins            # npm（发布后）
dsh plugin --profile web add git+https://github.com/a771853580/dsh-hindsight-plugins.git

方式三：手动挂载（无需重启，用户 patch 层有实时监听）

把本包放入 profile 的 node_modules（本包运行时零依赖，目录联接/复制即可）， 然后在任一用户 patch 层（如 ~/.dsh/cordis.patch.yml）追加：

- insert:
    - id: hindsight-plugins
      name: dsh-hindsight-plugins
      config:
        autoInstall: true    # 启动时检测并自动安装官方适配器（默认开启）
        # defaultApiUrl: 'http://192.168.1.100:18888'   # 地址兜底（示例）

刷新浏览器页面，打开 设置 → 插件 → 外部记忆。