DSH HUB
HomePlugin StorePlugin PacksCommunityRankingsResourcesPublish Guide
Plugin source
Back to catalog

starry-start /

starry-start/dsh-relationship-graph

Topic repository only

An plugin for managing interpersonal relationships,AI-generated, primarily for personal use. An AI built-in plugin suite for interpersonal management, customizable to your own environment. This repository was initially created for personal use. If this repository unfortunately infringes on others' rights, I will delete it immediately.

★ 0 Stars0 Forks0 IssuesN/A Community rating0 Confirmed installs
View on GitHub
READMESource: main@1bde832e

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 决定,可按自己的目录结构调整。

安装

  1. 把本仓库放到 profile 的 node_modules/dsh-relationship-graph/(或对应的插件目录)。

  2. 在 profile 的 cordis.patch.yml 里追加:

    - insert:
        - id: relationship-graph
          name: dsh-relationship-graph
          config:
            root: /path/to/relationship-archive
    
  3. 重启 DSH。

保险柜

  • 密钥包裹:随机 32 字节主密钥 K;K 分别用「口令 KEK」和「恢复密钥 KEK」包成两路, 存在 配置/vault-key.json(只存 salt / 密文 / tag)。改密码只重包裹 K,不重加密文件。
  • .ree 容器:AES-256-GCM + scrypt;每个文件自描述(magic REE1 / 版本 / 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

—/ 5

No ratings yet

Manifest verification required

Commit 1bde832e2b19

Community comments

No comments yet. Be the first to write one.

DSH HUB

A community index for DSH plugins. Not an official GitHub or DeepSeek AI product.

CommunityResourcesAPIAbout