Personal Understanding

MCP文档知识

提供方 未标注

文档知识 未标注 未标注 社区 / 第三方 Claude DesktopClaudeCursorVS Code

为AI代理提供证据链记忆:逐字优先(不可变的SHA-256哈希捕获)、可审计、防伪造。本地优先技能 + MCP服务器,适用于Claude Code、Codex及任何MCP客户端。 浏览适用于 Claude、Cursor、VS Code 等 AI 智能体的 Personal Understanding MCP...

一句话选型结论

按资料字段整理

Personal Understanding 属于文档知识类 MCP 服务器,传输方式未标注,鉴权方式未标注,可直接接入 Claude Desktop、Claude、Cursor 等,没有现成安装命令,需按官方文档接入。接入前先确认权限范围;涉及写入、删除或付款的操作,建议先在测试环境验证。

分类文档知识 传输方式未标注 鉴权未标注 部署方式未标注
GitHub 星标 未标注 仓库热度,无公开仓库时显示未标注
工具数 未标注 暴露给模型的工具数量
资源 / 提示词 0 / 0 资源与提示词模板数量
维护方 社区 / 第三方 核验等级 仅资料核对

工具与能力

文档知识
数量来自来源目录的标注,具体工具清单以官方文档为准
工具数量未标注暴露给模型可调用的工具个数
资源数量0可读取的资源条目
提示词数量0内置提示词模板数量

能力标签

支持客户端

适用场景

记忆

安装与配置

未标注 未标注
上游未给出传输方式
  1. 1
    准备运行环境

    按官方文档确认运行环境(常见为 Node.js 或 Python),装好后再执行安装命令。

  2. 2
    安装服务

    复制上面的安装命令执行;命令里带占位符的位置,换成自己的密钥或路径。

  3. 3
    写入客户端配置

    在客户端的 MCP 配置里填好启动命令和参数,保存后完全退出客户端再打开,让新配置生效。

  4. 4
    验证是否可用

    连接成功后随便调一个只读工具,确认能返回结果,再接入正式流程。

典型使用场景

3 类
按分类与标签整理的常见用法,具体以官方文档为准
文档检索问答

在你的文档库里按问题找答案。

知识库读写

把新资料写进知识库,随用随取。

内容整理

把零散资料归纳成结构化笔记。

选择建议

选之前先看这几条
按条目字段给出的判断,不替你决定用不用

值得选的地方

  • 已适配 Claude Desktop、Claude、Cursor,换客户端不用重新研究配置。

先想清楚的地方

  • 没有现成安装命令,需要按官方文档自己填启动命令和参数。
  • 资料没标注工具数量,实际能力要装好后确认。
  • 版本更新与行为细节以官方仓库为准。

更适合

  • 需要在文档知识场景里让模型直接调用外部能力的人。
  • 已经在用 Claude Desktop、Claude 的用户,接入路径最短。
  • 想先快速试一下、能接受在本地或自有环境跑服务的人。

不太适合

  • 需要厂商级 SLA 和技术支持的生产环境。

同类对比

6 个同类
同分类里挑最接近的几条,字段以各自详情页为准
MCP 服务器工具数传输方式部署方式安装命令最后核验
Personal Understanding当前 未标注 未标注 未标注 无 未标注
dify 未标注 stdio · 本地进程 本地部署 有 2026-04-11
open-webui 未标注 stdio · 本地进程 本地部署 有 2026-04-11
JeecgBoot 未标注 stdio · 本地进程 本地部署 有 2026-04-11
Cherry Studio 未标注 未标注 未标注 无 2026-05-17
mempalace 未标注 stdio · 本地进程 本地部署 有 2026-04-11

服务器档案

文档知识
字段来自项目仓库与公开索引,中文说明由本站标注
提供方未标注上游标注的维护方 未标注
分类文档知识本站按上游分类展示
连接方式未标注上游未给出传输方式
鉴权方式未标注远程服务建议用最小权限凭据
维护方社区 / 第三方核验等级 仅资料核对
包名 / 运行时未标注 · 未标注本地安装时用到的包标识与运行时
部署类型未标注上游给出的部署形态
最近核验未标注上游最后核验时间

详细介绍

8.8 KB
来自项目仓库与上游目录的原文,未做删改

Personal Understanding

一个带原话溯洄的模拟人脑联想、发散、聚合、逆向等的 agent 记忆系统。

agent 记忆 personal memory AI 记忆系统 MCP server local-first verbatim capture 原话溯洄 联想检索 Personalized PageRank 时间线记忆 可审计记忆 anti-hallucination memory personal knowledge management LLM agent memory claude skill codex skill


它是什么

给 AI 助手用的个人记忆系统:装在 Claude / Codex / Pi 这类客户端里,让它跨会话地「记得你这个人」。

和主流做法(每句话先摘要、先向量化,原话加工完就丢)相反,它把顺序倒过来:先把你说的话一字不改存下来,理解只是原话的派生物。派生物记错了可以重算、可以纠正,原话永远在位可以核对——这是「原话溯洄」的意思。至于「联想、发散、聚合、逆向」,是它在回忆时模拟人脑的四种找法,下面功能地图逐个讲。

一条消息的一生```text

你的消息 → ① 预检分类:是个人内容吗?(技术问答直接跳过,不碰档案)
→ ② 原话捕获:完整消息逐字节落盘 + SHA-256,永不可改
→ ③ 派生:拆出事件、人物、情境卡、待回访;模型猜测进独立假设层
→ ④ 闭环:每条捕获显式关闭,过不了硬闸门就不算「已记住」
→ ⑤ 日后回想:survey 看地图 → probe 发散 → deep 回原话,外加一条联想通道


①–④ 的机制:docs/how-it-works.md 第一到三节;⑤ 在第四到八节。

## 功能地图

按「记、存、想、养」四组。每条给一句「为什么」,细节全部链到详文。

### 记:进来的时候

- **两档闸门**——个人内容走全流程;纯技术、吃什么、一次性购物完全不碰档案。分类器漏判由模型兜底,宁可多收不漏收。(为什么:漏收 = 原话永久丢失;机制)
- **原话不可变捕获**——完整消息逐字节落盘,带 SHA-256、时间戳、会话标识;纠正只新增不覆盖;图片音频保原件,OCR 只是派生。(为什么:摘要先行 = 原话加工后无法审计;机制)
- **派生闭环 + 硬闸门**——存下原话不算完:必须拆出记录并显式闭环,孤立捕获过不了回答前的 session_check。(为什么:「相信我,存好了」在真实生活里不够格——2.5.0 重复建档事故;机制)
- **足迹纪律**——游戏攻略、在读在看这类轻足迹:先定向查重,恰好一条微型记录,零新增体面关闭。(为什么:防止把单次咨询堆成档案噪声;机制)

### 存:档案怎么组织

- **时间主干**——每条记录带发生日/精度/依据/阶段/前后邻居;禁止把录入当天冒充发生日。(为什么:「你现在处于某阶段」的断言要先对日期再讲故事;细则)
- **实体档案 + 情境卡**——人、学校、地点、作品、游戏、概念九类实体页 + 「学校 × 足球」式交叉情境卡;事实只存一份,卡片只是投影。(为什么:实体正文写可变状态会变成永不更新的僵尸信息;细则)
- **事实五层**——原话事实 / 你的评价 / 你的解释 / 模型假设 / 无法确认,永远分层摆放;模型猜测恒为 `candidate`,至少两条证据才立项,永不转正。(为什么:防止 AI 把自己的推测当你的事实记;细则)
- **待回访**——「等几天看结果」这类开放闭环带到期日入档,到期主动带上下文回访。(为什么:沉默不是答复,换话题不等于已解决;细则)

### 想:怎么回忆起来

- **survey → probe → deep 三层渐进**——先看 48K 紧凑路由地图定向,再沿实体/情境/时间邻居发散,最后回原话核验;每步预算封顶,不把全库灌给模型。(为什么:灌全库 = 模型被无关记忆淹没;机制)
- **联想通道(发散)**——个性化 PageRank 沿档案图扩散,带出词面零重叠但确实相关的候选(「打击感」→「巫师3 骑马手感」);是候选池不是结论,模型判断成立才引用。(为什么:「书荒了整本来嚼嚼」这类话三个词面通道全灭过——2.6.0 事故;机制)
- **聚合读法(侦探拼图)**——「我该怎么办」拆成情绪线/利益线/人物线分头查,再拼起来;回答分档案事实/模式观察/模型推断三层。(为什么:宽泛问题单一查询必漏;机制)
- **逆向冷回溯**——想不起关键词时,从人物/地点/时间任何线索顺实体发散、沿时间邻居走、按时间窗浏览认领;禁止宣布「查不到」。(为什么:「查不到」三个字在记忆系统里等于撒谎——只是没找到,不是不存在;机制)

### 养:档案的自我维护

- **反馈回路**——被纠正/确认才记录,note 必须引用当时原话作证据;沉默、换话题不算信号。(为什么:防止模型给自己的作业打分;细则)
- **季度权重复盘**——180 天未再确认的导入权重降为 0:保留、可检索、退出活跃地图,永不删除。(为什么:档案只增不减,权重会漂移;细则)
- **语义审查 + 三态校验**——定期扫「摘要冒充原话」「假设悄悄转正」「归属张冠李戴」;结构校验输出 clean/warnings/failed。(机制)
- **快照备份与范围恢复**——「跑了 7 天且校验通过」才切快照;恢复分 code/data/all 三级,dry-run 默认。(为什么:这份档案真实丢过一次数据;细则)
- **可视化审计面板**——本地静态页,能沿 事件→实体→情境→原话 完整链路逐层点开核查。(机制)

## 上手

让智能体跑这一条命令即可装好(路径按你客户端的 skills 目录调整):```bash
git clone https://github.com/caix84476-netizen/personal-understanding.git \
    ~/.claude/skills/personal-understanding && \
cd ~/.claude/skills/personal-understanding && \
python scripts/init_archive.py && \
python scripts/install_mcp.py --auto

重启客户端,personal_* 工具上线,正常聊天即可——「我最近……」「记住一下……」「为什么我总是……」,它会自己接住。手动逐步教程(含验证清单、升级、卸载):docs/install.md。

需要 Python 3.10+,仅标准库,零 pip 依赖,Windows / macOS / Linux 都行。也能 pip install personal-understanding 装服务端,但完整的大脑(SKILL.md + 审计面板)建议用上面的 clone。

设计思路

为什么原话优先、为什么硬闸门、为什么诚实比召回率重要、以及每一版修了什么:docs/why-it-works.md。一句话概括:它不是设计出来的框架,是一份天天在用的档案被十几轮实测事故磨出来的——分类器曾把「我堵得慌」锁在档案外、缺日期记录曾被时间衰减无声埋掉、整句口语查询曾被假切片霸榜,每一版修补都在 CHANGELOG 里有现场。

检索与词面层站在前人工作上(逐个的取舍与实测结论):SYNAPSE(ACL 2026 Findings,扩散激活门控)、HippoRAG(NeurIPS 2024,个性化 PageRank 种子权重)、Generative Agents(Stanford,时间衰减)、Qiao & Sun(ACL Y09-2003,自训练词典)、jieba(MIT,中文分词)。

项目结构```text

personal-understanding/
├── SKILL.md # 每轮操作契约:两档闸门、原话保真、派生闭环、三层检索
├── docs/ # how-it-works(机制)· why-it-works(动机)· install(安装)
├── references/ # 14 份字段级政策文件(捕获/检索/时间线/实体/假设/审查/备份……)
├── scripts/ # 全部实现,仅 Python 标准库
│ ├── mcp_server.py # MCP 服务端(11 个 personal_* 工具)
│ ├── preflight_context.py · capture_user_update.py · finalize_capture.py · session_check.py
│ ├── catalog_context.py · retrieve_v2.py # survey / probe / deep
│ ├── ppr.py · lexicon.py # 联想通道 / 词元净化
│ └── validate_memory.py · review_v2.py · salience_review.py · backup_archive.py
├── dashboard/ # 可视化审计面板(纯本地静态页)
├── templates/branches/ # 六大领域分支模板
├── resources/lexicon/ # jieba 词典(vendor,MIT)
├── tests/ # 180+ 回归测试 + 验收卷
└── VERSION / CHANGELOG.md # 版本与实测修补史
```

你的数据归你

全在本地、在这个文件夹里跑。无遥测、无云调用、无第三方 embedding 服务。.gitignore 默认挡住 memory/、sources/、backups/——你给这个目录做版本管理也绝不会误提交私人档案。

许可

MIT © 2026 caix84476-netizen

常见问题

6 问
答案由本站依据条目字段整理,不引用上游原文
Personal Understanding 怎么安装?

资料没有给出安装命令,请到官方仓库或文档按说明接入;这类条目多数是生态应用,或尚未发布可安装包。

Personal Understanding 怎么在 Claude Desktop、Claude、Cursor 里配置?

它的传输方式未标注,在客户端的 MCP 配置里填好启动命令和参数,保存后完全退出客户端再打开,配置才会生效。

Personal Understanding 收费吗?

本站不代收费用,也没有标注具体价格。是否收费取决于服务本身和背后的接口额度,正式使用前按官方说明确认。

Personal Understanding 需要 API Key 吗?

资料没有标注鉴权方式,是否需要密钥取决于服务本身,接入前按官方文档确认。

Personal Understanding 支持哪些客户端?

资料标注支持 Claude Desktop、Claude、Cursor、VS Code、Codex、Zed;其他客户端只要能配置 MCP Server,也能用同样的命令或地址接入。

Personal Understanding 能提供哪些能力?

资料显示能力标签包括 记忆。具体工具清单以官方文档为准。

热门专题

按标签挑服务器
全部专题 →

服务器信息以作者仓库与官方文档为准;分类、传输方式与鉴权方式的中文说明为中文整理,最近核验 未标注。