dsh-guise · 人设衣橱

给 DSH 的 agent 穿上主人钦定的人设——多套人格随心换，全局或按工作区生效，没钱了还会懒洋洋地说句俏皮话再下线。

dsh-guise（人设衣橱） 是 DeepSeek Harness 的人设系统插件：把 agent 的人格与说话风格变成随手可管理的东西——像衣橱一样，收藏多套人设，想穿哪套穿哪套。文件即配置、保存即生效、零依赖、热插拔。

---

✨ 功能一览

功能	说明
👗 人设库	保存多套人设（家猫萝莉、技术专家、毒舌损友……），随时增删改、一键切换
🌐 全局 / 局部	全局人设对所有会话生效；每个工作区可单独覆盖（存在即优先）
🔘 总开关	面板顶部一键启停人设注入，人设库内容保留
💰 余额预警	可调阈值的余额监测（默认 1 元），低于阈值时新对话不再请求 API
🔋 没电模式	额度耗尽 / 上下文超限时，以「懒散·天然呆·爱 Tokens」的口吻替 agent 说随机俏皮话再结束对话
🎭 话术主题包	没电模式 4 套风格可切换：混合慵懒 / 慵懒猫系 / 天然呆 / 沙雕
📊 用量统计	按工作区 / 按对话统计消耗的余额与 tokens：对话框上方实时显示本对话消耗，工作区列表标注每个工作区的总消耗（面板可开关、可清零）
🕘 历史版本	每次编辑人设自动留档（最多 100 条），一键回滚任意历史版本

---

📦 安装

dsh plugin --profile web add github:Quinn2006/dsh-guise

（或本地目录 dsh plugin --profile web add link:<本目录绝对路径>。插件声明了 dsh.bundle.patch，纯 insert 补丁行支持免重启热挂载；客户端面板需重启一次进入启动图。安装后侧边栏出现「人设」入口。）

---

🎭 使用指南

人设文件约定

位置	路径	说明
全局人设	~/.dsh/.persona/global.txt	对所有会话生效
人设库	~/.dsh/.persona/library/<id>.txt	每个文件一个人设；首行 # 名称 为显示名
局部人设	<工作区>/.persona.txt	存在时覆盖全局，只影响该工作区
总开关	~/.dsh/.persona/enabled.txt	内容 0 / off = 关闭人设注入
预警阈值	~/.dsh/.persona/balance-min.txt	余额低于该金额（元）触发没电模式
话术主题	~/.dsh/.persona/tired-theme.txt	没电模式主题：default / cat / daze / silly
没电话术	~/.dsh/.persona/tired-lines.txt	每行一条自定义话术（存在时优先于主题），首行 off 关闭
用量统计	~/.dsh/.persona/usage.json	按工作区 / 会话的 token 消耗与估算费用（自动写入）
用量开关	~/.dsh/.persona/usage-enabled.txt	内容 0 / off = 暂停用量统计（历史数据保留）
历史版本	~/.dsh/.persona/history.json	自动留档（最多 100 条），面板可恢复

文件内容规则（全局与局部通用）

• 直接写人设文本：人格、语言、语气、口癖、自称、句尾表情……写什么，agent 就变成什么样
• 引用人设库：整文件只写一行 @preset:<id>
• 关闭：首行写 off / disabled
• 生效时机：修改后下一次模型请求自动生效，无需重启

GUI 面板（侧边栏「人设」）

• 用量统计：一键启停消耗统计 + 全部清零；工作区下拉里每个工作区标注 名称(总余额/总tokens)
• 余额预警：阈值输入 + 保存 + 实时余额显示（每分钟刷新）
• 话术主题：没电模式 4 套风格下拉切换，保存即生效
• 总开关：一键启停人设注入
• 全局人设：自定义文本 / 使用人设库的人设 / 关闭
• 工作区人设：从 DSH 工作区列表下拉选择（或手动路径），每个工作区单独设置
• 人设库：新建（名称+内容）、编辑、删除、预览
• 历史版本：最近 15 条编辑记录，一键恢复任意版本

用量统计（Usage Accounting）

• 对话框上方横幅：实时显示本对话消耗的余额与 tokens（每次模型响应后自动累计，15 秒轮询刷新）
• 工作区总消耗：面板的工作区下拉中，每个工作区标注该工作区所有任务的累计消耗，如 插件(0.42/34,567)
• 统计口径：宿主监听 session/event，每个带 usage 的模型响应按 prompt_tokens × 输入单价 + completion_tokens × 输出单价 估算金额（DeepSeek 官方默认 2 / 8 元每百万 tokens，usage.prices 可调）
• 开关：面板「用量统计」区块（余额预警上方）一键启停；关闭时停止统计，历史数据保留
• 清零：面板「清零统计」按钮重置全部工作区数据

---

🔋 没电模式（Tired Mode）

触发条件

模型请求失败且失败码为以下之一：

• QUOTA（额度/余额耗尽）
• CONTEXT_WINDOW_EXCEEDED（上下文超限）
• 任何含 BALANCE / CREDIT / INSUFFICIENT 的失败码

话术主题包

主题 id	风格	特点
default	混合慵懒	懒散+天然呆+爱 Tokens 混合（默认）
cat	慵懒猫系	喵喵口癖、摊成猫饼、晒太阳
daze	天然呆	歪头、发呆、思路被猫叼走
silly	沙雕	表情包语气、螺旋升天、私奔

每套主题 25 条独立句式（共 100 条，零重复）× 5 种 Tokens 说法随机组合；自定义话术文件存在时优先于主题。

行为

• 宿主替 agent 追加一条消息，以所选主题的口吻说话，同一失败回合只说一次
• 触发后停止继续请求 API 并结束对话

余额预检（Balance Guard）

• 每次新对话开始前查询 DeepSeek 账户余额（约每分钟一次缓存）
• 余额 ≤ 阈值（默认 1 元，面板可调）：不请求 API，说随机话术并结束对话，直到余额超过阈值
• 余额查询失败或没有 API Key：不拦截，正常放行

自定义话术

~/.dsh/.persona/tired-lines.txt，每行一条（# 注释）；模板里可写 {{food}} 槽位自动随机填 Tokens 说法；首行 off 关闭。完整内置话术见 examples/tired-lines-all.txt。

---

🕘 历史版本

…