人设卡伴侣 suis077/dsh-companion

dsh-companion（人设卡）

把角色人设自动注入 DSH 会话的系统提示：新开一个会话，不用再把那一大段人设重新粘贴一遍。

交付清单、回滚步骤、壁纸引擎那条报错的成因，见 DELIVERY.md。

它做什么

- 一张「人设卡」= 名字 + 人设正文 + 解除设定的触发词 + 可选资源绑定
- 通过 DSH 官方 systemPrompt 服务注册一个提示段，不改动 DSH 本体
- 新会话自动生效；每个会话可单独关闭或改用别的卡，互不影响
- 右下角一个浮层面板：选卡、开关、看当前状态
- 卡可绑定角色图 / 音效 / 泡泡图，一键同步进鲸鱼挂件
- 面板显示白饭账本（今日 / 近 7 天 / 累计）与按人设卡的消耗归因
- 跨会话长期记忆：任务之外的闲聊、情绪、性格沉淀会被记下来，新会话开局就"认识"这个人

记忆机制

存 $DSH_HOME/persona-cards/memories/<cardId>.json：

{
"affinity": 34, // 好感度 0-100（角色内部刻度，不是对真实关系的度量） "mood": "刚被装上了记性…", // 当前心情
"traits": ["嘴硬心软", …], // 逐渐长出来的性格
"chapters": [ // 越攒越厚
{ "at": "…", "kind": "emotion", "summary": "…", "feeling": "…" } ] }

记什么：工作之外的闲聊、玩笑、情绪、反复提到的偏好、有分量的节点。
不记什么：任务执行过程（读了哪个文件、跑什么测试）、换个说法重说的旧事。
只存摘要，不存原话 —— 每条 60 字以内，feeling 写当时的感受。

上限：200 条。超了不是丢弃，而是把最旧的折成一条摘要——最早那几次对话通常最能定义这个角色，不该先丢。

不会丢：三层保护

| 层 | 位置 | 防什么 |
| .bak | 记忆文件同目录 | 文件被写坏（每次写入前自动存上一版） |
| 外部快照 | workspace\persona-memory-backups\ | 整个目录被误删 |
| 时间戳多份 | 同上 | 备份本身被覆盖（最多留 30 份） |

备份时机是"变化即备份"，不靠定时器：每次 remember / mood / affinity 写入时，顺手就把快照复制到外部目录。所以它不依赖软件是否开着、也不依赖"过 6 小时"——记忆一变就备份。启动时还会补一次，兜住上次异常退出时没备上的情况。

怎么用：

| 想干什么 | 说法 |
| 让角色记住点什么 | 「记一下：今天他夸了我」 |
| 看看它记得什么 | 「你还记得什么」 |
| 调心情 | 「你现在什么心情」 |
| 调好感（需你明确要求） | 「把好感调高/调低」 |

工具接口：persona_card 的 remember / recall / mood / affinity。

⚠️ 好感度说明：0-100 的数值只是让角色保持连贯的一个装置，不是对任何真实关系的度量，也不要当成权限或承诺。文档和提示里都写明了这一点。

记忆守则：靠一段独立的提示段（persona-card:memory-rules，order 160）约束"什么时候该记"。没有这段守则，模型会把每次读文件都记下来，记忆就变成流水账——那样反而把真正重要的事挤掉了。

怎么用

面板：DSH Web 界面右下角「人设卡」浮窗

- 全局：下拉选一张卡。所有没有单独设置的会话都跟随它
- 本会话：跟随全局 / 已开启 / 已关闭，只影响当前会话 —— 写代码时把它关掉，人设就不会来插嘴

对话里（persona_card 工具）：

| 说法 | 动作 |
| 「把这个会话的人设关掉」 | off |
| 「列出我的人设卡」 | list |
| 「把这段人设存成一张卡」 | create |
| 「把人设卡绑的角色图同步进鲸鱼」 | sync |
| 「这个角色吃了多少白饭」 | usage |

加一张卡：把人设正文丢给我，我存成卡；卡是纯 JSON 文件，也可以自己编辑

与鲸鱼挂件的关系

绑定的资源会被同步进 dsh-whale-widget 的三个目录，用它可以继续在挂件菜单里选：

| 绑定键 | 落到哪 | 文件 |
| roleImage | whale-roles/ + roles.json | <id>.png / .gif |
| pressSound / releaseSound | whale-audio/ + audio.json | <id>.wav |
| bubbleImage | whale-bubble-imgs/ + bubble-imgs.json | <id>.png / .gif |

这是合并，不是接管：只增删改本插件自己生成的 id（前缀 dshp_），挂件自己的条目一律不碰；索引读不出来时拒绝写入而不是猜着覆盖 —— 因为挂件解析失败的索引会静默退回默认值，看起来就像"我的角色全没了"。

关于「这个角色花了多少白饭」

先分清两本账（这是重点）

一次对话可能走两种完全不同的付费方式，单位都不一样：

| 账本 | 什么时候走它 | 单位 | 怎么算 |
| 积分账 | provider 是 workbuddy / workbuddy-global | 积分 | tokens ÷ 1,000,000 × 模型倍率 |
| 金额账 | provider 是 deepseek | 人民币 | 官方价目表（缓存命中 / 未命中 / 输出三档，含峰谷价） |

插件按 source.provider 逐轮判定走哪本账。 这是会话日志里的权威字段，不是猜测：

{"assistant/message": { "message": { "source": { "kind": "model",
"provider": "workbuddy", "model": "deepseek-v4.1-flash" } } } }

两本账永不相加 —— 加起来会得到一个没有单位的数。
统计范围是「自本次启动累计」，跨对话汇总，不是单个对话的。按对话算的话，每开一个新对话都会显示 0，看起来像坏了。当前对话自己的份额以小字附在下面，仅当它确实是子集时才显示。这个累计值是内存态，重启软件就归零，这正是「这次开软件之后用了多少」想要的行为。

积分公式是实证出来的，不是猜的：dsh-connect-workbuddy 的 README 自述一次约 25k token 的探测「报 credit 0.02」；用 glm-5.3 的倍率 0.79 反推，25000 ÷ 1e6 × 0.79 = 0.0198 ≈ 0.02 ✓，而按每千 token 算是 19.8（差 1000 倍）。所以是每百万。

倍率从哪来：优先用本插件 config.creditMultipliers 里的手填值；否则查 workbuddy 的实时只读接口 /plugins/dsh-connect-workbuddy/usage（60 秒缓存，只走本机 loopback）。
⚠️ 不要信 profile 里那份 lastCatalog，它显示的倍率会过期。本机实测：配置里写 deepseek-v4.1-flash 为 0（看起来免费），实时接口报 0.11。

倍率未知时不会当作 0，那会把「不知道」伪装成「免费」。此时积分总额会标成不完整（面板里带 *），并说明原因。

挂件那份账本要怎么看

挂件的 $DSH_HOME/.dshw-usage.json 只读，绝不写（它在持续写该文件）。

必须先说清一件事：挂件只读 source.model、不看 source.provider（已核对它的源码），然后按 DeepSeek 人民币价目表给每一轮贴价格。所以：

积分服务的轮次，在挂件眼里也会被贴上人民币标签，那些 ¥ 不是你真实的扣费。

本机实测的后果：一次全是 workbuddy 的会话，挂件逐轮估出 ¥320 量级，而真实花费是 约 8.9 积分、人民币 ¥0。这也解释了为什么它的「逐日余额下降」（¥0.11）和「逐轮估价」（¥1.70）看起来差很多，两个数连日期都不重叠，本就不该比。

挂件账本里还有两个口径，插件两个都摆出来、不合并：

| 口径 | 含义 |
| 账本口径 | 只累计观测到的「余额下降」。充值/赠金会压住它，与挂件界面显示一致 |
| 逐轮口径 | 每轮消耗之和（挂件按 DeepSeek 价估的），会被清理（90 天 / 2 万条） |

按人设卡归因

账本没有卡归属字段（已核对：无 cardId / persona / sessionId）。插件的做法是自己观测：每次注入人设时记一条生效时间线，再把逐轮消耗按时间戳归到当时生效的卡上。插件没运行期间的消耗一律算「未归因」，不摊到卡上充数，覆盖率会如实告诉你。

注意：这个归因建立在挂件那套人民币估价上，所以标的是 ¥，不是积分。

本机实测数字（2026-10-16 那次会话）

| 项 | 数字 |
| 模型步骤 | 341 步，全部 provider: workbuddy |
| token 总数 | 80,123,246 |
| 倍率 | deepseek-v4.1-flash × 0.11（实时查询） |
| 积分消耗 | 约 8.9 积分（完整，无未知倍率） |
| Token 直接扣费 | ¥0.00（0 步） |
| 占账号余额 | 8.9 / 6699.62 ≈ 0.13% |

目录结构

dsh-companion/
├── package.json # bundle 元数据 + dsh.client 前端声明 ├── cordis.patch.yml # 挂载声明（一条 insert） ├── index.js # Host 侧：提示段 + persona_card 工具 + 面板路由 ├── lib/ │ ├── cards.mjs # 人设卡库（原子写入，坏文件不致命） │ ├── sessions.mjs # 每会话覆盖 + 生效规则 │ ├── billing.mjs # 两本账：按 provider 分离积分 / 人民币 │ ├── multiplier.mjs # 积分倍率（配置优先，否则查 workbuddy 实时接口） │ ├── whale.mjs # 鲸鱼挂件资源桥（只合并不覆盖） │ ├── usage.mjs # 挂件账本读取 + 按卡归因 │ ├── memory.mjs # 长期记忆：好感/心情/性格/章节，超限折旧 │ └── http.mjs # 路由信任闸门（照抄 harness 规则，fail-closed） ├── client/client.js # 前端浮层面板（shell.overlay 插槽） └── tools/ # 离线自检脚本，见下

运行时数据

都在 $DSH_HOME（默认 ~/.dsh）：

| 文件 | 用途 |
| persona-cards/<id>.json | 每张人设卡一个文件 |
| persona-cards/index.json | 全局当前选中的卡（activeId） |
| persona-cards/sessions.json | 各会话的覆盖设置（关闭 / 指定卡） |

自检

node tools/check-all.mjs # 全部套件（含需要运行中 DSH 的实时核对）
node tools/check-all.mjs --no-live # 只跑纯离线套件

单跑某一个：

| 脚本 | 验证什么 |
| check-host.mjs | 注册面：一个提示段 / 一个工具 / 一条路由，都可释放 |
| check-cards.mjs | 卡库：原子写入、坏文件跳过、种子不覆盖用户编辑 |
| check-sessions.mjs | 每会话覆盖：两个会话互不影响、缺卡不替换成别的卡 |
| check-routes.mjs | 面板路由 + 信任闸门（含闸门抛错时 fail-closed） |
| check-client.mjs | 前端模块契约与不崩渲染（不含视觉验证） |
| check-whale.mjs | 资源桥：只合并不覆盖、索引坏了拒写、目标路径名正确 |
| check-create.mjs | 建卡与同步：路径校验、id 派生、挂件条目不被破坏 |
| check-usage.mjs | 记账：整数金额不漂移、两个口径独立、归因不虚报 |
| verify-usage.mjs | 与真实账本逐项对账（需挂件记过账） |
| check-billing.mjs | 两本账分离：积分轮次绝不计入人民币账、未知倍率不当作 0 |
| check-multiplier.mjs | 倍率解析：配置优先、只走本机、失败必须是 unknown |
| check-memory.mjs | 记忆存储：坏文件降级、超限折旧、只存摘要、单卡隔离 |
| check-remember.mjs | 记忆动作：remember/recall/mood/affinity 的夹紧与拒绝 |
| verify-billing.mjs | 用真实会话日志核对两本账（需有会话记录） |
| check-live-tools.mjs | persona_card 工具是否真的进了模型可见工具表 |

安装

在 DSH 的 Plugins 页点 Add plugin，填入本仓库的绝对路径（或 git 仓库地址）即可安装；不要手工改 profile 的 package.json 或 cordis.patch.yml。

还原

安装前会备份 profile 配置；把 package.json 与 cordis.patch.yml 覆盖回 $DSH_HOME\profiles\desktop\ 即可回滚。

已知限制

- 改完 Host 代码要重启 DSH 才加载：已安装包里的 JS 只在启动时读一次（官方文档明确如此）。卡片与面板数据不需要重启。
- 面板目前只能选卡和开关，新建卡需在对话里让模型代做。
- 前端只有结构与非崩渲染测试，没有浏览器视觉验证。
- 积分账只统计「本插件运行期间」观测到的会话事件（内存累计），范围是自本次启动、跨对话汇总。要看历史某次会话，用 verify-billing.mjs 直接读会话日志。
- 重启软件后累计归零 —— 这是刻意的（"这次开机用了多少"）。
- 积分倍率若在会话中途被上游改动，已累计的部分不会被回溯重算。

许可证

MIT