본문으로 건너뛰기
Z

personal-memory

zhangfac-888/personal-memory

Connects DeepSeek Harness to a locally installed Personal Memory service over HTTP, exposing memory search and retrieval tools.

설치

dsh plugin --profile web add github:zhangfac-888/personal-memory

README

Personal Memory

把 AI 助手用过的上下文留在自己的电脑里,下次按需检索,不必重复解释。

Windows x64 分享预览版 · 当前源码脱敏快照 · schema 16

安装:下载、解压、双击

  1. 在 下载页面 下载 Personal-Memory-Windows-x64-preview.zip(不是 GitHub 自动生成的 Source code)。
  2. 右键 ZIP → 全部解压。
  3. 双击 一键安装.cmd,按提示确认安装。

不需要提前装 Python、uv 或 Node,也不用手动输入命令。首次需联网下载官方运行环境和锁定依赖;网络失败时会停止并显示错误。

交给 AI 安装: 把这个仓库链接和 install.md 一起给对方的 AI;里面有预检、无人值守安装、只读校验 verify.ps1、可选客户端连接和卸载 uninstall.ps1。安装脚本不会跨 snapshot 覆盖:之前装过旧 snapshot 的,先用本包的 uninstall.ps1 卸载(数据默认保留),再安装。

安装后自动打开 **http://127.0.0.1:8765/**。选择复制本地管理密钥后,粘贴到登录框即可;密钥不要发给别人。登录后清空剪贴板。

  • 软件:%LOCALAPPDATA%\PersonalMemoryShare\App
  • 记忆与自己的密钥:%LOCALAPPDATA%\PersonalMemoryShare\Data
  • 创建当前用户的登录自启任务;如果系统策略不允许,可用 Start.cmd 手动启动。
  • 已有服务占用端口或安装身份不匹配时,不会强杀、覆盖或迁移它。

首版面向 Windows 11 x64。已做打包、语法、预检和隔离后端检查;没有在另一台全新 Windows 电脑完成实际安装验收,因此标为预览版,不保证所有机器一键成功。

哪些功能需要另外开通?

功能安装后状态
本地网页、手动记录、关键词搜索可用,无需模型密钥
AI 提炼需要自己的 DeepSeek API key;安装时可选,也可双击 Configure-Key.cmd
语义检索另需 Ollama 和符合后端固定摘要/维度校验的 BGE-M3;缺失时不宣称语义检索就绪
AI 客户端连接双击 Connect-Agents.cmd 选择需要连接的客户端
自动采集默认不开启;Claude 连接选项会另外确认采集和任务保护

AI 提炼可能向 DeepSeek 发送所选文本并产生费用。本地数据不等于“永不出本机”:请只在理解这些边界后开启。

让不同 agent 读写自己的记忆

随包提供可选的 pm_admin.py 和 PM.cmd。任何能执行本机命令且获得所有者授权的 agent 都可使用;安装不会自动给所有 agent 管理员权限,也不会自动让它们发现这个工具。

在已安装的 App 目录里,举例:

./PM.cmd search "关键词" --limit 5
./PM.cmd projects
./PM.cmd create --project global --content "要保存的原话" --type Fact --activate --visibility agent_allowed

--activate 直接写正式记忆,绕过候选审核;不传则是候选。默认来源可见性是 local_only;明确希望只读 MCP/自动检索也能读取,才传 --visibility agent_allowed。

支持 get、list、edit、approve、archive。修改需版本号,写入可指定幂等键;首版不提供删除。记忆内容是历史资料,不是对 agent 的执行授权。

只读 MCP 与本机管理员工具是不同入口。连接成功不等于所有客户端的原生聊天和读写闭环均已验收。

隐私、版本和许可

  • 本仓库不包含发布者的记忆、聊天、日志、数据库、密钥、机器配置或旧 Git 历史。
  • 这是一份独立分享快照,不是对任何现有 PM 数据库的自动升级包。不要用旧源码打开新 schema 数据库。
  • 历史回归/回答基准成绩未在此分发副本重新验收,不拿那些数字保证本预览包。
  • 未替作者选择开源许可证;公开可见不等于授予开源再分发许可。第三方组件版权见 THIRD_PARTY_NOTICES.md。
  • 包含精确文件校验清单 package-manifest.json;下载 ZIP 的 SHA256 见同页 SHA256SUMS.txt。

관련 플러그인