DSH Plugins
返回列表
🤖

dsh-session-user-id

模型推理 更新于 2026.10.25

在终端中运行以下命令:

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 以换取隔离的团队