agent-user-profile
kaveys/agent-user-profile
把「你是谁」记成一份持久画像——从红线、口味到沟通习惯共十类,每轮任务前先读一遍,偏好不用反复交代。候选事实先进待审队列,确认后才进画像;注入前过相关性闸门,可以要求某一轮不读画像。写入时自动合并近义条目,别家 AI 导出的画像文本能整段搬进来并拆成条目;另带七页签面板、`profile` 命令行与 14 个 MCP 工具,覆盖审阅、修改、置顶、软失效、快照、恢复与加密备份。
安装
dsh plugin --profile web add github:kaveys/agent-user-profileREADME
agent-user-profile
给 AI 装一份「关于你」的说明书。
你大概遇到过这种情况:每开一个新对话,都要从头说一遍——我是学生、我喜欢简洁的界面、别动我的项目文件夹、回答先给结论。 这个插件替你把这些记下来,整理成一张清清楚楚的清单;以后每次对话开始前,AI 自动先读一遍,不用你再提醒。
不想用时,当场说一句「这次别用画像」,它立刻停手,并告诉你「本次未结合画像」。
看 54 秒介绍片(中文配音,讲它是干什么的,不讲代码)· 字幕 · 旁白全文 · English README

它解决的那点麻烦
| 以前 | 用了它之后 |
|---|---|
| 每换一个对话,你得重新交代一遍自己 | 它已经知道了,第一句话就能按你的习惯来 |
| 说过的偏好,过几天它又忘了 | 偏好写进清单,一直在,还能调轻重 |
| 它偶尔用了你不喜欢的风格,你懒得再说 | 清单里写明「界面要简洁、不要花哨动画」,它照着做 |
| 担心 AI 把你的私事到处记 | 只有结论上清单,聊天原文不进硬盘;证件号、密码这类直接拒收 |
它记什么
四类,都是「换个任务也还成立」的事:
| 类别 | 例子 |
|---|---|
| 你是谁 | 本科在读,学的是无人机系统工程;用中文交流 |
| 你喜欢什么 | 界面要简洁有留白;配色偏冷;文案别用感叹号 |
| 你习惯怎么做 | 先给结论再给理由;要有证据;做完要能跑起来 |
| 你绝对不要什么 | 别动我的项目文件夹;别自作主张删东西;上传前必须打码 |
清单上的每一条都能改:改说法、调轻重(高 / 中 / 低)、标成「核心」(面板上叫「设核心」,命令行是 --core)、删掉。删错了,去「备份与重置」点一下就能整批还原。
它不记什么
- 身份证、银行卡、密码、家庭住址——直接拒收,不是打码,是不收。
- 这一次任务的细节:文件名、路径、端口、版本号、报错原文、临时要求——这些换个任务就不成立了,不算你的特征。
- 聊天原文——硬盘上只有一张清单,对话内容只在内存里过一遍。
- 项目内部的事——只在某个项目里成立的偏好,不会混进你的通用画像。
怎么开始
只想先试试(只要有 Node,不用装任何东西)
git clone https://github.com/kaveys/agent-user-profile.git
cd agent-user-profile
node bin/profile.mjs init
node bin/profile.mjs declare --dim taste --fact "用户偏爱克制的深色界面" --confidence 0.9
node bin/profile.mjs declare --dim constraints --fact "对外发布前必须彻底脱敏" --core
node bin/profile.mjs declare --dim communication --fact "先给结论,再给证据"
node bin/profile.mjs build && node bin/profile.mjs show
跑完你会看到一份整理好的清单——就是这个插件平时喂给 AI 的东西。
只记一两条时它会显示「数据不足」:至少 3 条才会开始注入(这是防止它凭一句随口的话就给你下定义)。再加两条就绪。
想看每条对应的 key 和 id(后面 pin / retire / edit 要用):node bin/profile.mjs show --with-keys。
在 DeepSeek Harness 里用
cp -r agent-user-profile ~/.dsh/plugins/dsh-user-profile
node ~/.dsh/plugins/dsh-user-profile/scripts/register.mjs # 注册 + 给每个 profile 建链接
更新到新版本:不要用 cp -r 叠在旧目录上(会变成 dsh-user-profile\agent-user-profile 套娃,跑的还是旧版)。先删旧目录再复制,或用 robocopy <新目录> %USERPROFILE%\.dsh\plugins\dsh-user-profile /MIR /XD .git node_modules;复制完再跑一次 register.mjs。
然后重启一次 DeepSeek Harness。设置里会多出「用户画像」一栏,七个页签:概览、条目、待审、冲突与历史、维度、设置、备份与重置。
第一次用会看到空清单,这是因为它不会凭空编你的事:要等你说话、或者你自己加一条。想快点开始,可以让它「根据我们之前的聊天整理一份」,或者把别的 AI 告诉过你的关于你的信息粘进「备份与重置 → 从别的 AI 搬回来」,它会自动分类、打分、去重。
让别的 AI 工具也能用同一份清单
node mcp/server.mjs
这是一个标准 MCP 服务,任何支持 MCP 的客户端都能接上,读同一份画像(这也是「为什么它不绑死在某个宿主上」的原因)。
会看见什么

左边是清单,每条带来源(你说的 / 模型提炼的)和轻重;右边「备份与重置」里有恢复点、脱敏扫描和本地导出。
常见问题
它会不会偷偷把我的事传给云端?
不会主动传。数据只在本机 ~/.dsh/user-profile/。只有你主动点「上传备份」时才会加密传到你自己配置的网盘(WebDAV),默认是关的。
它会不会自己乱记? 有三道门槛:只有你在讲自己时才提炼(翻译、做题、查报错那种纯干活的一轮直接跳过);提炼出的东西先当候选项,重要的自动进清单,不确定的等你点头。
删掉的还能找回来吗? 能。每次删除前自动留一份快照(最多 20 份),面板上一键还原。
有几条我每次都想让它知道?
把那条置顶。置顶的条目排在最前面,而且不受「这轮相关不相关」的筛选影响——哪怕你只是在查一个报错,它也会带上。面板行内点「置顶」,或者命令行 node bin/profile.mjs pin --key <键>(装好之后也可以直接用 dsh-profile pin --key <键>)。
暂时不想让它影响我,但又想留着记录?
用「先放下」(node bin/profile.mjs retire)。条目退出画像、不再进提示,记录和来源都还在,随时「恢复」;它和删除的区别是:删除是抹掉,先放下只是不用了。失效的条目在面板「备份与重置」页能一次全部恢复。
记的东西会过期吗?
会分两种。临时状态可以自己带保质期:node bin/profile.mjs declare --ttl 7d(或 --expires 2026-12-31),到期就退出画像,记录还留着。偏好类的东西不设硬期限,但久到没人再提起会慢慢变淡——不再自动带进对话,条目仍在,面板「备份与重置」页能看到多少条被淡化了。钉住的条目永不淡化。
随口一句会不会盖掉我明确要求过的事?
不会。两条说的是同一件事时,先比可信度:你明确说过的(1.0)不会被模型提炼的一句(0.6)顶掉,只会挂成「待确认」让你裁决。如果你就是想让新的盖掉旧的,node bin/profile.mjs set conflicts.strategy newest 可以退回老规矩。
占多少空间? 一份清单几十 KB,加历史留档也就几百 KB,不含任何图片和聊天记录。
不用 DeepSeek Harness 能用吗? 能。数据层是一个独立的命令行工具,MCP 也能单独跑;DeepSeek Harness 只是它的第一个「宿主」。
给开发者
想改它、或者想知道它为什么这么设计,看这几份:
- DESIGN.md — 设计取舍:为什么画像要分三段、为什么用快照而不是撤销、为什么喊停只生效一轮
- docs/COMPATIBILITY.md — 换了宿主版本哪些功能会降级
- docs/POSITIONING.md — 与同类项目的坐标、以及移植到别的宿主要做什么
- CONTRIBUTING.md — 五条硬规矩 + 提交前要跑的检查
- SUPPORT.md — 装完没反应、画像是空的、想回滚:四条常见问题的处理办法
- CODE_OF_CONDUCT.md — 在这里怎么说话、怎么提意见
- SECURITY.md — 数据落在哪、哪些边界已知、怎么私下反馈
- CHANGELOG.md — 每一版改了什么、为什么
代码结构:bin/profile.mjs 是数据层(一个命令行工具),lib/ 是两个纯函数模块(判定相似与相关),index.js 是宿主侧的采集与注入,client.js 是设置页界面,mcp/server.mjs 是对外接口。全部零依赖、没有构建步骤。
测试与自检(不需要网络,也不需要宿主):
npm test # 全量:语法 + 14 轮排查 + 单元 + 渲染 + 兼容 + 端到端 + 安装体检
npm run test:quick # 改小东西时用:语法 + 单元 + 决定论
npm run test:list # 只列会跑哪些步骤
改代码前想知道每个文件盯什么,看 DESIGN.md;只想手敲单个测试:
node tests/selftest.mjs # 单元级
node tests/audit-10.mjs # 决定论与幂等
node scripts/verify-install.mjs
许可
MIT。数据在你自己的机器上,代码随便改。