dsh-session-user-id
在终端中运行以下命令:
dsh plugin install abluefan/dsh-session-user-id
将以下提示词粘贴到 DeepSeek Harness 对话框中:
在 DeepSeek Harness 中执行 dsh plugin install abluefan/dsh-session-user-id,或在插件发现中搜索 dsh-session-user-id 安装;源码见 https://github.com/abluefan/dsh-session-user-id。
插件介绍
DeepSeek API 支持在请求体中携带 user_id,用于内容安全隔离、KVCache 隔离与调度隔离;官方要求该字段不得包含用户隐私,因此本插件为每条 DSH 会话生成并持久保存随机 UUID v4。DSH 默认只有全局匿名 user id,没有「一条聊天一条 id」的语义,而 deepseekLlmApiExtensions 扩展点能在带 sessionId 的请求上注入顶层字段——本插件正是利用这一点,在不改 DSH 源码的前提下补齐会话级 user_id。
第一次见到某个 sessionId 会写入映射文件,之后永久不变;compaction、session-title 等同一会话的子请求共用同一 id。没有 sessionId 的内部调用则不注入,仍走默认行为。映射保存在 $DSH_HOME/session-user-ids.json,采用先写临时文件再 rename 的方式,避免半截文件。
需要权衡的是:会话级 user_id 意味着每条会话独立的 KVCache,会话之间不再共享缓存,共同前缀(如 system prompt、人设)可能需重新计算,命中率与成本可能上升——这是为隔离换来的代价,避免会话间互相污染。
适合在 DSH ≥ 0.2.1、已使用 DeepSeek 且希望按会话做 API 侧隔离的团队或个人;若你更在意跨会话 KVCache 命中与成本,而非会话间隔离,则不必启用。
使用场景
- 多条并行聊天希望 API 侧 user_id 互不混用
- 需要按会话做内容安全或调度隔离而非全局匿名 id
- compaction 等子请求必须与主会话共用同一 user_id
适合人员
- 在 DSH 上使用 DeepSeek 的开发者
- 重视会话间 KVCache 与内容不互相污染的用户
- 接受略高缓存 miss 以换取隔离的团队