orangeshinee/dsh-mem0

Project Overview项目介绍

dsh-mem0 is a native plugin built exclusively for DeepSeek Harness (DSH) that connects DSH agents to a user-hosted mem0 memory service. It can be installed directly from GitHub using the DSH CLI command dsh plugin --profile web add github:orangeshinee/dsh-mem0, or installed via npm after it is published, or linked locally for development. It adds a dedicated configuration card in DSH’s settings panel under the plugin section, no additional sidebar UI is included with this plugin. It supports hot swapping, so users do not need to modify any core DSH source code to install and use it.

This plugin is intended for DSH users who want to add persistent long-term memory to their DSH agents. Before installing the plugin, users must first deploy the latest open-source mem0 API service on their own infrastructure, and generate a valid API key from the mem0 dashboard. After installation, users fill out the configuration form with the mem0 base URL, authentication type, API key, and default user and agent IDs to enable the plugin. The agent can then call any of the 8 available memory tools to search, add, update, delete and manage stored memories, with search results returning relevance scores for better filtering.

This plugin is released under the open-source MIT license, and all required runtime dependencies are listed as hard dependencies in the package manifest. When you run the DSH plugin install command, these dependencies will be installed automatically alongside the plugin. All configuration is persisted via DSH’s built-in settings provider, and changes to core settings like base URL and API key take effect immediately without needing to restart DSH. The API key is marked as a secret and never passed to the browser frontend, so user credentials stay secure. If you modify plugin source code you must rebuild the package for changes to take effect.

这是一个专为 DeepSeek Harness(DSH)开发的原生插件,用于让 DSH 宿主 Agent 读写用户自行部署的 mem0 开源记忆服务。插件提供了 8 类记忆操作工具,包括新增、搜索、读取、更新、删除单条或批量记忆、查看变更历史、清空全部记忆和检查服务状态。支持热插拔,可直接通过 DSH 插件命令从 GitHub 安装,无需修改 DSH 源码,在设置面板的插件配置页提供配置卡片。

该插件面向需要为 DSH Agent 添加长期自主记忆能力的用户,用户需要先自行部署新版 mem0 API 服务,获得 API Key 后在 DSH 插件配置页填写 mem0 服务地址、认证类型、默认用户和 Agent ID 即可启用。使用时,Agent 可直接调用对应工具完成记忆的增删改查,搜索时会返回匹配记忆的相关性分数方便 Agent 筛选使用。

插件遵循 MIT 许可开源,运行依赖已预设为包的硬依赖,执行 DSH 插件安装命令时会自动安装。配置信息通过 DSH 设置模块持久化,修改地址、密钥和默认标识后无需重启 DSH 即可生效。API Key 会被标记为密钥,不会传入浏览器端,保障安全性。开发时修改源码后需要重新构建,仅修改前端配置页代码刷新即可生效。

Pre-install check安装前体检Compatibility · Security兼容性 · 安全性 1 warning1 项注意
  • Only 2 stars - very few users, little community feedback星标只有 2,几乎没人在用,遇到问题缺少社区反馈
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 desktop add dsh-mem0

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

READMEREADME

dsh-mem0

中文 | English

自托管 mem0 记忆读写的 dsh(DeepSeek Harness)插件:宿主 Agent 通过 mem0_* 工具直接读写你自己的 mem0 REST 服务(新版 OSS 构建,mem0/mem0-api-server, 带 dashboard,X-API-Key 认证,端点无 /v1 前缀)。

热插拔:通过 dsh plugin add link:<本目录> 挂载,不改 dsh 源码。无侧边栏 UI,但带一个 浏览器端配置页:设置 → 插件 → dsh-mem0 行 → 「配置」,可编辑下面的配置项。

工具

工具 端点 说明
mem0_add POST /memories 写入记忆(字符串或消息数组;默认按 defaultUserId / defaultAgentId 归类)
mem0_search POST /search 语义搜索,带相关性分数
mem0_get GET /memories / GET /memories/{id} 读取列表(按标识符过滤)或单条
mem0_update PUT /memories/{id} 更新记忆文本 / metadata / 过期时间
mem0_delete DELETE /memories/{id} / DELETE /memories 删除单条;批量删除需 confirm: "DELETE ALL" + admin
mem0_history GET /memories/{id}/history 单条记忆的变更历史
mem0_reset POST /reset 清空全部(需 confirm: "RESET" + admin)
mem0_status GET /auth/setup-status + GET /configure 健康检查 / 认证状态 / 配置(不输出 apiKey)

安装

先确认你用的是哪个 profile —— 装错 profile 插件完全不会加载,且没有任何报错。 桌面版 GUI 跑的是 desktop:

# 桌面版(Electron GUI):看进程命令行里的 profiles 路径确认
dsh plugin --profile desktop add link:/path/to/dsh-mem0

# 或者 CLI/web 版
dsh plugin --profile web add link:/path/to/dsh-mem0

各安装方式:

# 方式一:直接从 GitHub 安装(无需发布,推荐给使用者)
dsh plugin --profile desktop add github:orangeshinee/dsh-mem0

# 方式一(指定版本):对应 GitHub Releases 的 v* 标签,CI 自动打包
dsh plugin --profile desktop add github:orangeshinee/dsh-mem0#v0.2.1

# 方式二:npm 发布后安装(维护者先 npm publish 一次)
npm publish   # 维护者操作
dsh plugin --profile desktop add dsh-mem0

# 方式三:本地开发(link 方式)
dsh plugin --profile desktop add link:$(pwd)

# 装完重启 dsh 生效

宿主端配了 0.2 的 settings 服务时,还需把运行时依赖装进同一个 profile(dsh plugin add 会随包安装 dependencies,但 profile 里若缺 harness 侧的 dsh-settings 需补齐): dsh plugin --profile desktop add '@deepseek-ai/dsh-settings@^0.2.0-rc.2'。

发布

打 v* 标签即触发 CI(.github/workflows/release.yml)自动构建并发布 GitHub Release: pnpm build → 四项离线冒烟 → npm pack 产物(dsh-mem0-<version>.tgz)挂到 Release, 并自动生成 changelog。

git tag v0.2.1 && git push origin v0.2.1

标签版本必须与 package.json 的 version 一致(不一致 CI 会失败);若仓库设置了 NPM_TOKEN secret,还会同步 npm publish 到 npm(未设置则跳过,不影响 Release)。

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-plan-board 下一个 Next dsh-noteboard →