DeepSeek Harness 插件

Luisarg03/dsh-memory-vault#memory-mcp

Star 数 ★ 0 下载量(近 30 天) 1,804 分类 记忆 收录于 2026-08-31 npm @luisarg/memory-mcp

经 MCP stdio 把 Agent 接入持久化 OKF 记忆库:Python 服务端(SQLite FTS5 + Markdown),10 个工具用于检索与写入决策、事实和偏好。

安装

# npm 包(预构建)

dsh plugin --profile web add @luisarg/memory-mcp

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

dsh plugin --profile web add github:Luisarg03/dsh-memory-vault#path:/packages/memory-mcp

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

README

该插件的 README 只有英文版本。

Cordis bundle that connects DeepSeek Harness (DSH) to a persistent OKF memory vault over the Model Context Protocol.

It mounts @deepseek-ai/dsh-mcp-client configured for the vault's Python MCP server (memory-vault-server in this repository) over stdio, exposing the vault's tools (search_memory, store_*, export_memories, get_profile, ping) to the agent.

Install

dsh plugin --profile web add @luisarg/memory-mcp

uv on PATH is recommended but not required: the bundled launcher.mjs runs the server with uv run when uv is present and falls back to a pip-managed venv (python3 -m venv + pip install -r requirements.txt, network on first boot) when it is not.

Skills

The package also ships the two skills that drive its tools, so installing it is enough to get the commands — nothing has to be copied into a skill directory:

Command Source What it does
/brain skills/brain/SKILL.md Reads the vault: topic search, recall by project, the profile, full exports — including the tool traps (entry_type=profile in search_memory always returns 0; tags are OR-matched; searches cap at 50)
/checkpoint skills/checkpoint/SKILL.md Captures the session as decision/fact/learning/convention entries, then commits the vault

They register at DSH's bundled rank (600), the weakest in the local discovery table, so a skill of the same name in a user or project root still wins. Each SKILL.md is the single source of its own name, description and usage guidance: the provider parses its frontmatter with yaml, so the same file also works copied into ~/.agents/skills. Registration goes through ctx.inject(['skills'], …), so a deployment with no skill catalog still gets the vault bootstrap and the MCP client.

Configuration

Variable Purpose Default
DSH_MEMORY_SERVER_DIR directory containing server.py $DSH_HOME/memory-vault-server
DSH_MEMORY_PATH vault directory (forwarded to the server as MEMORY_PATH) ~/.memories

The bundle ships no cwd-dependent paths: the cordis.patch.yml layer resolves both values from the environment. The vault falls back to the OS home (~/.memories, which DSH_HOME does not move); the server to the harness home ($DSH_HOME, or ~/.dsh) — DSH does not chdir, so launching from any directory works.

Development

pnpm install
pnpm build
pnpm test

The bundle manifest (dsh.bundle) makes this package installable through the standard dsh plugin add flow; the patch layer lives in cordis.patch.yml.

内容来自项目 README(GitHub)↗

链接

同类插件

查看整个分类 →

社区评论

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