DeepSeek Harness 插件

andyfan1094/dsh-codebase-memory

Star 数 ★ 2 分类 开发与运行时 收录于 2026-08-22

把 Codebase Memory MCP 代码知识图谱接入 DSH,并用防抖文件监视器自动保持索引新鲜。MCP 桥接部分仅支持 Windows(监视器跨平台);首次启动会经 npx 自动安装所需 npm CLI。

安装

# Release 预构建包

dsh plugin --profile web add "https://github.com/andyfan1094/dsh-codebase-memory/releases/download/v0.2.1/dsh-codebase-memory-0.2.1.tgz"

# GitHub 源码(首次需按提示配置 allowBuilds 构建授权后重试)

dsh plugin --profile web add github:andyfan1094/dsh-codebase-memory

装任何插件都等于在你的机器上跑第三方代码,权限和你本人一样大——能读你的文件、用你的凭据、访问网络,工具审批管不到它。GitHub 来源的插件还会在安装时执行构建脚本——pnpm 默认拦截,所以安装可能停在 ERR_PNPM_GIT_DEP_PREPARE_NOT_ALLOWEDERR_PNPM_IGNORED_BUILDS;dsh 会打印出需要添加的确切键名,把它加进该 profile 的 pnpm-workspace.yamlallowBuilds 下,重跑一次即可装上。放行构建本身就是一次信任判断:请只安装可信来源,并尽量锁定 commit(github:owner/repo#sha)。

README

本地 DSH bundle,通过官方 @deepseek-ai/dsh-mcp-client 桥接 Codebase Memory MCP,并内置一个文件系统 watcher,让知识图谱随代码变更保持最新。

运行时

  • codebase-memory-mcp@0.10.8
  • Windows AMD64 发布件 SHA-256:b43ad982994c4d829670749e08d3b622a74bb20041fc0a7d02bef6113f81c34d
  • MCP 命名空间:mcp__codebase_memory__*
  • 图谱 UI:http://127.0.0.1:9749

Bundle 注册

本包在 cordis.patch.yml 中注册两个 Cordis bundle:

Bundle id 用途
mcp-codebase-memory 把上游 MCP 服务器桥接进 DSH,原生暴露全部 mcp__codebase_memory__* 工具(search_graph、detect_changes、get_architecture、index_repository 等)。
dsh-codebase-memory-watcher 同一包内的第二个 bundle:为每个项目启动 chokidar watcher,防抖文件变更后通过全局 codebase-memory-mcp CLI 重新执行 index_repository

watcher 不持有 MCP 客户端连接——每次重建都通过 codebase-memory-mcp cli index_repository '{"repo_path":"..."}' 子进程完成,上游索引器在小项目上足够快(dsh-github 30 秒内),可以接受。

Watcher 路由(webServer 可用时自动注册)

方法 + 路径 请求体 / 查询参数 效果
GET /api/dsh-codebase-memory/watcher/list 列出全部持久化 watcher,含 statuslastRunlastDurationMslastError
GET /api/dsh-codebase-memory/watcher/status?id=<id> 返回单个 watcher 的相同载荷
POST /api/dsh-codebase-memory/watcher/start { repoPath, debounceMs?, mode?, ignored?, watchedExtensions? } 启动 watcher(持久化状态,返回新 id
POST /api/dsh-codebase-memory/watcher/stop { id }?id= 停止并标记 stopped(保留状态)
POST /api/dsh-codebase-memory/watcher/rebuild { id } 忽略待处理变更,立即触发一次重建
POST /api/dsh-codebase-memory/watcher/restart 按持久化状态重启所有非 stopped watcher
POST /api/dsh-codebase-memory/watcher/auto-attach 调 MCP 服务器的 list_projects,为尚未覆盖的每个项目启动 watcher
GET /api/dsh-codebase-memory/watcher/cli-info 报告解析到的 codebase-memory-mcp.exe 路径

默认值(可在 cordis.patch.yml 配置)

  • debounceMs5000(5 秒静默期后重建)
  • modemoderate(类型感知 LSP 调用/使用解析;fast 跳过相似度,full 启用相似度并索引全部文件)
  • autoAttachtrue(启动时为 MCP 服务器已知的每个项目自动开 watcher)
  • usePollingfalse(默认原生文件通知;仅当文件系统丢事件时再开轮询,因为它会增加 CPU 与磁盘开销)
  • ignored**/node_modules/****/.git/****/dist/****/build/****/.next/****/.turbo/****/.codebase-memory/****/.pnpm-store/****/target/****/__pycache__/****/.venv/**
  • watchedExtensions.ts.tsx.js.jsx.mjs.cjs.py.go.rs.java.cs.rb.php.vue.svelte

状态持久化

watcher 记录保存在 ~/.dsh/dsh-codebase-memory/watcher.json,在支持的平台上以仅所有者可读的权限写入。插件卸载时只关闭运行中的句柄、不改持久化意图;下次 DSH Web 启动会重建所有未被用户显式停止的 watcher。

截图

dsh-codebase-memory 截图

安装

Releases 下载最新的 dsh-codebase-memory-*.tgz 并加入 profile:

dsh plugin --profile web add D:\downloads\dsh-codebase-memory-0.2.0.tgz

本地开发可改用 checkout 链接安装:

dsh plugin --profile web add link:D:/项目/dsh-codebase-memory

安装后重启 DSH Web 宿主。

卸载

dsh plugin --profile web remove dsh-codebase-memory

全局运行时独立固定版本,可单独卸载:npm uninstall -g codebase-memory-mcp

内容来自项目 README(GitHub)↗

链接

同类插件

查看整个分类 →

社区评论

评论公开保存在 GitHub Discussions。加载评论会连接 GitHub 和 Giscus;发表内容需要 GitHub 账号。