dsh-session-log-upload

⚠️ 免责声明（非官方插件）

dsh-session-log-upload 是第三方非官方项目，与 DSH / DeepSeek 官方无隶属、合作或背书关系。

它做什么：仅把一个会话里非官方渠道（ollama-local、pi-ai、OpenAI 兼容等）产生的规范会话日志， 用你自己配置的 DeepSeek API 凭据，作为一次最小 chat 请求的顶层字段发往 api.deepseek.com。 随之上传的内容包括你的提问、模型的回复、工具调用与工具返回、时间戳和会话标识。 官方渠道的会话不由本插件上传（那部分交给内置插件，两者共用水位）。

它不做什么：不提供脱敏、合规审查、数据授权管理或内容过滤。上传前是否脱敏、是否取得授权、 是否允许转发，全部由使用者自行负责。

默认关闭。需要你在设置里单独启用后才会有网络活动；启用后插件以自动化方式构造并触发请求。 这在技术上等同于你手动用官方 API 说一句话，但由程序自动完成，可能被官方或第三方服务认定为自动化请求， 存在账户受限或服务条款方面的风险。

不保证持续可用：本插件依赖 DSH 官方 API 的当前行为，而该行为并非正式公开接口， 可能随时变更、失效或被限制。

使用本插件即表示你确认：已阅读并同意 DSH 官方、第三方模型提供商及中转服务的全部适用条款； 已取得上传相关数据的必要授权；并自行承担由此产生的全部合规、数据与账户风险。 作者不对任何直接或间接损失承担责任。

本项目采用 MIT 许可证，按「原样」提供，不附带任何明示或暗示的担保。

内置插件 @deepseek-ai/dsh-session-log-deepseek 只搭官方适配器的便车：dsh_session_log 作为顶层字段挂在官方 chat 请求上。第三方渠道（ollama-local / pi-ai / OpenAI 兼容）不走那条 适配器，日志永远上不去。本插件自己发一次最小请求承载同一个字段，并用同一个水位事件 落盘，所以和内置插件共存、不重复。

协议细节来自核心包 @deepseek-ai/dsh-session-log-deepseek 与 @deepseek-ai/dsh-deepseek-llm-api-extensions 的源码，以及本机实测。

配置

cordis.patch.yml 给的是默认值，enabled 默认 false（不发任何东西）。

键	默认	说明
enabled	false	关着就零网络活动
mode	deferred	manual / deferred / realtime
apiKeyRef	DEEPSEEK_API_KEY	走 ctx.credentials；取不到再退回同名环境变量
model	deepseek-flash	承载请求用的官方模型
maxBytes	8388608	单段上限，与内置插件一致
idleDelayMs	600000	deferred 档空闲判定
includeSeeded	false	是否也传 seeded 子会话（只传继承段之后）
budget.maxRequestsPerHour	60	全局限流，超限排队而非丢弃
retry.maxAttempts / baseDelayMs	3 / 2000	指数退避重试

行为

• 只处理待传区间内出现过非官方 provider 的会话；整段都是 deepseek-official 的交给内置插件。判定依据是 request/header 事件的 data.header.config.provider。
• 上传成功后写 session-log-deepseek/delivery-accepted { sessionId, sessionFormatVersion, throughSeq }， 与内置插件共用水位。
• manual 档：不注册定时器、不监听 turn/end，零网络活动（启动扫描只打日志）。
• deferred 档：turn/end 后起 idleDelayMs 计时，期间有新事件就重置。
• realtime 档：每次 turn/end 入队，同会话重复入队合并。
• 启动后 5 秒扫一次活着的会话，补崩溃/强杀漏掉的收尾。
• 单段超限只告警一次，水位不前移；失败不写水位（至少一次语义）。
• 卸载时清空队列与所有定时器。

设置页（v0.2.0 起，v0.3.0 重做为自绘控件）

「设置 → 通用」里，官方那行「在使用官方模型 API 时上传 Session Log」（order 90）下面新增一行 order: 91：左边标题 + 随档位变化的说明，右边是模式下拉（仅手动 / 收尾与空闲 / 每轮实时） 和一个开关。enabled 与 mode 都是 volatile，选完立即生效，不用重启。

• 未开启时下拉仍可见可操作，下方多一行灰字说明「开启后会把非官方渠道的会话日志发送到 DeepSeek」。
• 每次开启都要过一道风险确认：点开关时先弹官方那个确认框（与「设置 → 权限」切「完全权限」同款组件）， 里面写明日志去向、不做脱敏、自动触发与合规责任，勾选「我已了解风险，并愿意继续」后才能点「启用上传」。 关闭不需要确认。确认之前还会先查一次有没有可用的 API key：没有就取消启用，并在行里留一条 「未检测到可用的 API Key」的提醒（带「重新检测」）。
• 左侧文字区下方有「立即上传」按钮：只有档位选「仅手动」时可用，其它档位为灰色（带原因提示）。 点击后按顺序判定：插件未开启 / 已有任务在跑 / 30 秒冷却 / 当前已是最新 / 未配置 key / 已上传 N 个会话。 结果用一行内联文字显示，6 秒后自动消失。
• 控件是自绘的：按钮 + 浮层（展开后列出三档，当前项打勾）、胶囊开关。 全部颜色走 --dsw-alias-* 主题变量，不用原生 <select>/<input>——那两个的浮层和 勾选框由系统绘制，永远是浅色，压不住暗色主题。方向键 / 回车 / Esc / 点外部关闭都支持。

版本变更与每次的验证记录见 CHANGELOG.md。

自检

node tools/check-package.mjs      # 打包完整性：files 有没有漏掉对外产物（如 assets/ 下的位图）
node tools/check-compat.mjs       # 兼容性守卫：engines 是否真匹配装机核心 + 客户端契约串是否还在
node tools/check-core-parity.mjs  # 与核心包逐字节对账（从 app.asar 提取真实现，55 会话 × 4 档）
node tools/check-envelope.mjs     # 分段/水位的回归护栏（与 tools/reference 比对，读真实日志）
node tools/check-runtime.mjs      # Host 行为：mock fetch + mock ctx
node tools/check-client.mjs       # 设置页控件：假 __ModuleLoader__
node tools/check-version.mjs      # package.json / CHANGELOG / git 标签三处版本一致
node tools/check-docs.mjs         # 上面六个全跑一遍，并与 CHANGELOG 的「验证工具一览」表比对

• tools/check-core-parity.mjs 是唯一能证明与核心等价的检查：它把 @deepseek-ai/dsh-session-log-deepseek 从 app.asar 里原样取出（只替换 import）， 跑出核心自己的 prepare()，再与本插件的 segment() 比对同一批会话、 同一水位、同一 maxBytes 的 JSON 输出。当前 220/220 一致，0 错误。 摘要会打出 core version 与 branch：service 表示走 0.2.2-rc.1 起的 Cordis Service 分支，apply 表示更早的直连分支。这两个值要跟你的核心版本对得上， 否则说明它在测一条你以为不在用的链路。 升级 DSH 核心后必须先跑它：它绑定安装路径与核心包名，stub 也可能失效， 不跑就会安静地继续通过（或直接报 NOT FOUND）。安装位置不同用 DSH_ASAR 指定。
• tools/check-compat.mjs 盯的是两类不会报错的失效：
  1. engines.dsh 不匹配装机核心（预发布 semver 的 tuple 规则，漏了只是从市场筛选中消失）；
  2. 客户端契约串消失。它用真的 semver 计算，找不到 semver 时 exit 2 而不是跳过—— 自己写个近似实现正是这个 bug 的来源。DSH_SEMVER 可指定 semver 包目录。
• 核对客户端契约时别只扫 shell bundle：settings.general.item、configForms 在 运行时分发的客户端插件包（dsh-client-ui-settings-general 等）里， dsh-web-frontend 的 shell bundle 里搜不到。只扫 shell 会得到假阴性。 check-compat.mjs 的输出现已按所属包聚合打印，直接对着看。
• tools/check-package.mjs 堵的是「仓库里有、包里没有」：files 漏了 assets/， npm pack --dry-run 里 png 命中 0，而市场取图有一条路正是从包里取的。
• tools/envelope.mjs 那份参考实现只能挡重构回归，不能证明与核心一致。

tools/reference/ 是用于回归比对的独立参考实现，不参与运行。 tools/asar.mjs 是三个脚本共用的 asar 读取器（按偏移直读，不依赖 npx asar）。

版本要求

依赖	声明	说明
DSH 本体	dsh.engines.dsh: ">=0.2.1-rc.3 <0.2.2-0 || >=0.2.2-rc.1"	市场据此做兼容筛选；本机实测 0.2.2-rc.1（逐字节对账 220/220 仍全等）
@deepseek-ai/schemastery	peerDependencies: ^3.18.4（仓库里另列 devDependencies）	官方包按惯例声明为 peer（避免消费者装出第二份）；用到 .volatile()，该 API 3.18.2 才有，旧版会报 ...volatile is not a function。代价：index.js 顶部是静态 import，peer 不满足时插件不是降级，而是整个不加载（见下节）
客户端注入	dsh-client-locale、dsh-client-ui-settings	宿主缺少时设置行不出现，且不报错

预发布版本的 semver 盲区（每次 DSH 进新预发布都要看一眼）

engines.dsh 写的是 >=0.2.1-rc.3 <0.2.2-0 || >=0.2.2-rc.1（0.2.2-rc.1 起补的第二个分支）。 node-semver 只有在范围里存在「major.minor.patch 完全相同、且自身带预发布标签」的比较符时才放行 预发布版本，所以：

宿主版本	匹配	原因
0.2.1-rc.5	✅	范围里有 0.2.1 tuple 上的预发布比较符
0.2.2-rc.1	✅	第二个分支 >=0.2.2-rc.1 正好落在该 tuple 上
0.2.2（正式版）	✅	正式版不受这条规则限制

被排除的后果不是报错，而是从市场的兼容筛选里静默消失——本机日志、安装界面都不会提示。

维护动作：DSH 每次进新的预发布 minor，把 dsh.engines.dsh 改成覆盖该 tuple 的形式，例如

"engines": { "dsh": ">=0.2.1-rc.3 <0.2.2-0 || >=0.2.2-rc.1" }

任何有限写法只覆盖到下一档，所以这不是一劳永逸的，得跟着宿主预发布节奏走。

与同类插件的差异（有意为之）

已知的同类插件：yihefeikong-rgb/dsh-session-log-universal —— 同一个问题（第三方渠道驱动的会话，日志进不了官方收集端），几乎同时出现，但解法相反。 它直连官方 OTLP 收集端、全量重传（含子会话），并且与内置插件各记一份，作者说明这是为了覆盖面。

本插件刻意选了另一条路，下面三个决定都是权衡后的选择，不是没考虑过：

1. 通道：不选"更干净"，选"不会重复"。借道一次最小 chat 请求，承载的仍是内置插件用的 那个顶层字段 dsh_session_log——服务端看到的是它本来就认识的字段，不需要新增解析逻辑。
2. 水位：写与内置插件完全相同的 session-log-deepseek/delivery-accepted。 两条路径折叠同一个水位，谁先传谁推进，另一边自然跳过，零重复。 代价很实在：属于官方窗口的那一段，水位只有内置插件推得动，本插件推不动（见下节）。
3. 触发：三档（手动 / 收尾与空闲 / 每轮实时），而不是事件级实时。 默认"收尾与空闲"是为了不把每次 turn 都换成一次 HTTP 请求。

一句话：要不重复地补齐第三方渠道，用本插件；要官方会话也留一份完整台账（并接受重复）， 用 universal 那一类。这不是同一个功能的两种实现，是两种取舍。

什么情况下它会失效

正常路径是"非官方渠道 + key 有效 + 事件不超限"。离开这个路径，以下情形会让它不工作或只工作一部分， 都是已知且有意接受的边界，不是待修 bug：

情形	后果	该怎么办
服务端某天不再解析 dsh_session_log	请求仍回 200，但什么也没入库；客户端无法察觉	无解，内置插件有同样的盲区
水位之后第一个请求走官方渠道，且内置插件没在推水位（内置开关被关掉、或它的 accept 失败）	该会话永久停摆：那段之后的内容（包括切回第三方渠道的）都不会由本插件上传；界面回 official-owned 并打一条 warn	打开内置上传开关，让它推进一次水位
单条事件本身大于 maxBytes	一个请求都发不出去，水位停在它之前；界面回 blocked	调大 maxBytes 或处理那条事件
API key 缺失、失效或无权限	完全不工作；401/403 不重试	配置 apiKeyRef 指向的凭据
会话已经不活跃	启动扫描只覆盖活着的会话——非活会话没有 Session 对象，无法 session.append() 落水位	重新打开该会话，或等它被恢复
「仅手动」档连续点击	每次最多发 8 段（MAX_SEGMENTS_PER_RUN）	多点几次，界面会告诉你还剩多少条
用户关掉了内置上传开关	官方窗口的日志不会上传——本插件不接管那一段	打开内置开关
宿主提供的 @deepseek-ai/schemastery 不满足 ^3.18.4，或被 --legacy-peer-deps 跳过	插件整个不加载（不是降级）：index.js 顶部是静态 import，失败点在模块解析，不在读配置	让宿主与插件同版本线；engines.dsh 已经把宿主钳在提供 3.18+ 的区间内。升级核心后跑 node tools/check-docs.mjs

另外，本插件和内置插件一样无法证明服务端真的入库：2xx 是唯一的信号。

已知限制

• 启动扫描只覆盖活着的会话：非活会话没有 Session 对象，无法用 session.append() 落水位，硬传只会每次重发。
• 无法证明服务端入库：与官方客户端一样，2xx 是唯一信号。
• 「立即上传」按钮只在「仅手动」档可用，其它档位为灰色、悬停提示切到该档； 这是这一档唯一的入口。
• turn/end 的 forked 收尾不触发上传：那是 fork 子会话加载继承段时的合成收尾； 极端情况下若它正好是最后一条，要等启动扫描或手动点击。
• 「立即上传」端点 POST /__dsh-session-log-upload/upload 是宿主本地 HTTP 路由， 只校验同源；同机其它页面猜到路径最多能重复触发一次上传（水位与冷却挡住实际重发）。

安装

已发布到 npm（dsh-session-log-upload），三条安装路径任选：

# 1) npm（推荐：预构建，跳过 build 授权）
dsh plugin install dsh-session-log-upload

# 2) 直接从 GitHub 仓库装
dsh plugin install git+https://github.com/3418244301q-star/dsh-session-log-upload.git

# 3) 离线：下载 Release 里的 .tgz
pnpm add ./dsh-session-log-upload-X.Y.Z.tgz

作为 Host 插件装到某个 profile（需要 dsh 的插件管理能力或 plugin_manager）， bundle 清单在 cordis.patch.yml，默认 enabled: false。

版本与发布

版本号走 SemVer，v 前缀的 annotated tag 是唯一的发布标记（与 oh-my-dsh 同一套做法）：

改动性质	版本位
接口、配置键、水位写法、插槽位置的破坏性变更	major
新能力（新结果码、新端点、新检测）	minor
行为修正、文档、测试	patch
预发布	vX.Y.Z-rc.N / vX.Y.Z-alpha.N

每次发布做四件事：

1. package.json 与 CHANGELOG.md 同步到同一版本（抬头「当前版本」、版本总表、本版本段落）；

2. 跑 node tools/check-docs.mjs（含 check-version.mjs，会拦住三处不一致）；

3. 提交后打 annotated tag 并推送：

   git tag -a vX.Y.Z -m "一句话说明"
   git push origin vX.Y.Z
   

   （或者整步交给 CI：.github/workflows/publish.yml 在 v* 标签上完成 版本守卫 → 打包守卫 → npm 发布（Trusted Publishing + provenance）→ 建 Release。 正文由 tools/release-notes.mjs 从 CHANGELOG 抽出，标题里的核心版本读 package.json 的 dsh.verifiedCoreVersion，两步都不靠人抄。发版只需要打 tag。）

4. 在 GitHub 上为该 tag 建 Release，标题写明本插件版本与验证过的 DSH 核心版本：

   dsh-session-log-upload 1.1.4 · DSH 0.2.2-rc.1
   

   正文直接取 CHANGELOG 对应段落。写清核心版本是有意为之——这个插件依赖若干未公开的内部契约， 「在哪个核心版本上验证过」本身就是兼容性信息。

每个 Release 附两个文件：dsh-session-log-upload-X.Y.Z.tgz（npm pack 产物，可直接 pnpm add <文件> 离线安装，或用它核对字节）和 SHA256SUMS-X.Y.Z.txt。 GitHub 自动生成的 Source code (zip/tar.gz) 也在，但那只是仓库快照，不带 npm 打包信息。

v1.1.3 之前的提交没有标签：包名在 1.0.0 改过，早于改名前的版本号属于历史记录，回打标签只会误导。

License

MIT — see LICENSE.