dsh-relationship-graph
DSH / DSHM 插件:会话头部「关系图谱」视图 + 档案保险柜。
- 图谱:力导向 SVG 关系图(手写物理,不依赖 d3),支持拖拽、缩放、按关系圈/子分类筛选与开关、 搜索、星标、点节点看详情卡、点边看关系、左右可收起的面板。
- 保险柜:打开图谱前先过查看密码,再过保险柜密码;敏感档案在磁盘上以
.ree密文保存, 解锁后才还原成明文,上锁后恢复密文。
纯 JS / SVG + node:crypto,无原生依赖(不带 .node)。
目录约定
插件读取一个「档案根目录」(config.root),约定结构:
<root>/
├── 数据/关系图.json # 图谱拓扑(nodes / edges / config.circles / stats / generated_at)
├── 数据/人物卡.json # 详情卡数据
├── 数据/schema.md、记录协议.md 等文档(保持明文)
├── 配置/关系圈.json、关系类型.json、星标.json # 图谱配置(保持明文)
├── 人物档案/、共处事件/、他处和他评/、人情往来/、归档/ # 敏感:上锁时整体加密
├── 索引.md # 敏感
└── 数据/关系图.json、人物卡.json、待确认.md、变更日志.md # 敏感
- 图谱只读
数据/关系图.json与数据/人物卡.json两份派生文件,不解析任何.md。 - 保险柜加密范围由
vault_engine.mjs顶部的SENSITIVE_ROOTS/SENSITIVE_FILES决定,可按自己的目录结构调整。
安装
把本仓库放到 profile 的
node_modules/dsh-relationship-graph/(或对应的插件目录)。在 profile 的
cordis.patch.yml里追加:- insert: - id: relationship-graph name: dsh-relationship-graph config: root: /path/to/relationship-archive重启 DSH。
保险柜
- 密钥包裹:随机 32 字节主密钥
K;K分别用「口令 KEK」和「恢复密钥 KEK」包成两路, 存在配置/vault-key.json(只存 salt / 密文 / tag)。改密码只重包裹 K,不重加密文件。 .ree容器:AES-256-GCM + scrypt;每个文件自描述(magicREE1/ 版本 / KDF 参数 / salt / IV / tag / 明文 sha256,AAD 覆盖头部),单文件可独立解密。文件名 =sha256(相对路径)[:16] + ".ree", 不泄露原始文件名。- 状态机:
locked / unlocking / unlocked / locking / needs-lock;每文件原子写(tmp→fsync→rename); 解锁中断→删残缺明文回locked,上锁中断→保留明文标needs-lock(重锁完成,不丢编辑)。 - 备份:上锁前把
.ree快照 +配置/vault-key.json+ 图谱配置写到备份/vault/<时间戳>/, 只留最近 N 份完整备份(清单最后写,残缺备份自动清掉)。 - 导出明文:搬迁用,导出到档案目录之外的目录,导完请自行删除。
HTTP 路由(仅本机回环)
GET /api/dsh-relationship-graph/data(需查看 token + 已解锁)、/view-status、/view-setup、
/view-login、/view-change、/view-recover、/vault-status、/vault-init、/vault-unlock、
/vault-lock、/vault-change、/vault-recover、/export、/selftest。
给 AI 的工具
relationship_vault:只允许 status 与 lock(上锁免密)。解锁必须由用户在界面输入密码。
安全边界(诚实版)
- 只连本机回环 HTTP;不联网、不上报;不做导出/分享按钮(导出是本地明文目录)。
- 静态加密 + 时间窗:解锁期间明文在磁盘上,任何能读文件的进程都能读;上锁后恢复密文。
- 六位口令只是初始值,建议 12 位以上;恢复密钥(32 字节)是真正的兜底。
配置/vault-key.json丢失后.ree无法恢复(恢复密钥也包在里面),请单独离线备份。- 不做自动上锁,靠手动上锁。
- 隐私提醒:数据进入模型上下文后即离开本机;请按自己的威胁模型决定是否让 AI 参与。
开发 / 自测
GET /api/dsh-relationship-graph/selftest:在临时目录完成「初始化→上锁→导出→解锁→改密→恢复→再上锁」 的往返验证并逐字节比对,不触碰真实档案。vault_core.mjs可脱离插件单跑:node vault_core.mjs selftest(纯node:crypto)。
License
MIT
No comments yet. Be the first to write one.