# [Bug] DSH 0.1.7 下 @deepseek-ai/dsh-session-reference codec 不兼容导致 session/list 定义撤回，且 npm latest 标签指向旧版本

[TowardsDawn]

环境

• DSH 版本：0.1.7-rc2（升级后出现）
• 操作系统：Windows
• Node.js：v24.19.0
• 全局安装路径：D:\JavaScript\nodejs\node_global
• Profile：web
• 相关包：@deepseek-ai/dsh-session-reference

问题描述

升级 DSH 核心到 0.1.7-rc2 后，运行 dsh web 出现以下问题：

1. @deepseek-ai/dsh-session-reference 的 Typert 注册失败，报错：
   • parameter codec has no create() factory
2. 由于该注册失败，session/list 的严格定义被网关撤回：
   • typert gateway: session/list: its strict definition was withdrawn and SRC fallback is forbidden
3. dsh-task-board 插件轮询会话列表失败，任务板主机会话名册自动发现被禁用。
4. 通过 dsh plugin --profile web add @deepseek-ai/dsh-session-reference@0.1.7-rc2 安装指定版本时，pnpm 报 ERR_PNPM_NO_MATCHING_VERSION，因为 npm 上不存在该版本号。
5. npm 上 latest 标签指向旧版 0.0.1-rc.1，而实际与 DSH 0.1.7 匹配的预发布版本在 next 标签下：0.1.7-rc.2。

复现步骤

1. 将 DSH 升级到 0.1.7-rc2。
2. 确保 profile 中使用了 @deepseek-ai/dsh-session-reference。
3. 运行：
   • dsh web
4. 观察终端输出，出现 typert-loader 注册失败、session/list 定义撤回、dsh-task-board 轮询失败等错误。
5. 尝试安装指定版本：
   • dsh plugin --profile web add @deepseek-ai/dsh-session-reference@0.1.7-rc2
6. 出现 ERR_PNPM_NO_MATCHING_VERSION。

实际行为

终端关键错误：

typert-loader (@deepseek-ai/dsh-typert-loader): AggregateError: typert-loader: 1 typert contributor(s) failed to register:
  - typert-loader: @deepseek-ai/dsh-session-reference invocation "@deepseek-ai/dsh-session-reference#sessionReferenceResolver/candidates" parameter codec has no create() factory
Error: typert-loader: @deepseek-ai/dsh-session-reference invocation "@deepseek-ai/dsh-session-reference#sessionReferenceResolver/candidates" parameter codec has no create() factory
    at requireStrictCodec (.../dsh-typert-loader/lib/index.js:211:48)
    at requireInvocation (.../dsh-typert-loader/lib/index.js:185:3)
    at validateTypertManifest (.../dsh-typert-loader/lib/index.js:116:89)

[dsh-task-board] the host gateway withdrew the session/list definition for this DSH cohort; task board roster auto-discovery is disabled
TypertGatewayError: typert gateway: session/list: its strict definition was withdrawn and SRC fallback is forbidden
  code: 'gateway/definition-unavailable',
  details: { endpoint: 'session/list' }

安装指定版本时：

Error: ERR_PNPM_NO_MATCHING_VERSION
  × adding a new package
  ╰─▶ Failed to resolve dependency tree: No matching version found for @deepseek-ai/dsh-session-reference@0.1.7-rc2
      while fetching it from https://registry.npmjs.org/
  help: The latest release of @deepseek-ai/dsh-session-reference is "0.0.1-rc.1".
        Other releases are:
          * alpha: 0.1.7-alpha.2
          * next: 0.1.7-rc.2

临时解决方案

使用 next 标签安装，而不是手动指定不存在的版本号：

dsh plugin --profile web add @deepseek-ai/dsh-session-reference@next

安装后 @deepseek-ai/dsh-session-reference 会解析到 0.1.7-rc.2，session/list 和 dsh-task-board 的连锁报错消失。

期望行为

1. @deepseek-ai/dsh-session-reference 应与 DSH 核心 0.1.7-rc2 的 Typert 严格 codec 规范兼容，不应在启动时注册失败。
2. npm 上的 latest 标签应指向与当前 DSH 核心匹配的稳定/预发布版本，或至少文档中明确说明需要安装 @next。
3. 当用户尝试安装与核心版本对应的版本号时，应能成功解析，而不是因标签/版本号不一致而失败。

建议

• 检查 @deepseek-ai/dsh-session-reference 的 sessionReferenceResolver/candidates 参数 codec 是否已按新 Typert 规范提供 create() 工厂。
• 确认 monorepo 发布流程中，@deepseek-ai/dsh-session-reference 的 npm latest / next 标签是否与 DSH 核心版本同步。
• 在 DSH 升级时，如果核心版本要求特定版本的 @deepseek-ai/dsh-session-reference，建议在启动日志中给出明确的修复命令，例如：
  • dsh plugin --profile web add @deepseek-ai/dsh-session-reference@next

[PerryLink]

那个校验点在加载器里，而且它要求每个 codec 提供 create()

1. 报错来源

packages/typert/loader/src/index.ts：

throw new Error(`typert-loader: ${pkgName} TYPERT schema "${schema.name as string}" has no create() factory`)   // :112
throw new Error(`typert-loader: ${pkgName} ${subject} has no create() factory`)                                 // :282

⇒ 你贴的 parameter codec has no create() factory 对应 :282 那一支（${subject} 就是 parameter codec）。也就是说：加载器要求每个注册的 codec 暴露 create() 工厂；@deepseek-ai/dsh-session-reference 这一版没有 ⇒ 注册失败 ⇒ 你的第 2 步（session/list 的严格定义被撤回、且禁止 SRC 回退）是这个失败的直接后果。

2. 所以这条的正确归因是"哪一侧需要适配"

请在正文里明确一句：dsh-session-reference 是本仓的包还是你在 profile 里装的包（以及版本）。这决定维护者该改哪边：

• 若是本仓包 ⇒ 那是 0.1.7 线的回归（加载器变严 / 该包未跟上），属本仓修；
• 若是第三方/独立包 ⇒ 是它与 0.1.7 的 codec 契约不兼容（应当按新契约补 create()），而"升级时的兼容性提示"是本仓该补的。

3. 你说的"npm latest 指向旧版本"——这条成立，而且是本轮的通用坑

latest = 0.1.5-rc.3   ← 旧的
next   = 0.1.7-rc.2   ← 真正最新

⇒ 建议在报告里把这一条单独写出来（它不只是你这一个问题的背景，而是所有用户都会踩的坑）：既然 latest 长期滞后，dsh 的安装/升级提示应当直接指向 next，或至少让用户能看出两条线的差别。

4. 一个请求

请把该包失败那几行的完整异常贴出来（含 pkgName 与 subject），并说明 session/list 撤回后实际影响到什么（你说任务板轮询失败、主机会话名册自动发现被禁用——这个影响面写清楚很有价值）。

5. 版本提醒

你在 0.1.7-rc2 = 当前最新（tag dsh-v0.1.7-rc.2），无需先升级。⚠️ 但别用 latest 去重装（它更旧）：

npm i -g @deepseek-ai/dsh@next      # 当前 = 0.1.7-rc.2

一条边界

我确认的是加载器那两处校验与错误文案（足以说明"没有 create() 就注册失败"）。dsh-session-reference 的归属与版本要看你补充——我没有核对该包。

[TowardsDawn]

由于当时DSH出错，因此我使用了deepseek网页端作为辅助进行修复（当时的DSH终端输出已包含在网页端聊天记录内）
https://chat.deepseek.com/share/zicqdmau4nsy49u93v

我印象中的实际影响：DSH能打开，但功能大面积出错（包括：无法正常读取session列表导致webUI显示的会话记录全为空、0.1.7新加入的官方插件列表无法读取等等）

dsh-session-reference的发布者不是@deepseek-ai吗？应该是本仓的包。@deepseek-ai/session-reference

该问题我目前已暂时性解决，解决方法是使用dsh plugin --profile web add @deepseek-ai/dsh-session-reference@next直接装上这个包

[huangsijun17]

补充一条不同于原报告的触发路径：用户没有显式安装任何核心包，但第三方插件会把旧版核心包"传染"进 profile，产生完全相同的 codec has no create() factory → session/list 定义撤回 → 会话列表空白。

环境

项	值
@deepseek-ai/dsh	0.1.7-rc.2（npm 全局，next 线）
平台	Windows 11 x64，Node v22.20.0，profile = web
包管理器	pnpm 11.5.1（profile 为 nodeLinker: hoisted，autoInstallPeers: false）
触发源	第三方插件 dsh-set-model@0.1.0（npm latest，唯一版本）

现象（与主帖一致）

typert-loader (@deepseek-ai/dsh-typert-loader): AggregateError: typert-loader: 1 typert contributor(s) failed to register:
  - typert-loader: @deepseek-ai/dsh-llm invocation "@deepseek-ai/dsh-llm#llm/discoverModels" parameter codec has no create() factory
    at requireStrictCodec (.../dsh-typert-loader/lib/index.js:211:48)

dsh-task-board: the host gateway withdrew the session/list definition for this DSH cohort; task board roster auto-discovery is disabled
  TypertGatewayError: typert gateway: session/list: its strict definition was withdrawn and SRC fallback is forbidden
  code: 'gateway/definition-unavailable', details: { endpoint: 'session/list' }

image-offload (@deepseek-ai/dsh-compaction-image-offload): TypeError: ctx.sessions.registerMessageProjection is not a function

实际影响面（呼应主帖里"session/list 撤回后影响到什么"的追问）：

• Web 侧栏会话列表整块空白。数据本身完好：storages/workspace.json 有 29 个 workspace（路径全部有效），sessions/ 下有 325 个会话文件，session_projcache/ 有 286 条投影。
• 修复后实测 POST /api/session/list 返回 292 条 items（sessionId / updatedAt / blank / running）——即列表数据一直可用，只是 endpoint 定义被撤回了。
• dsh-task-board 会话名册自动发现禁用。
• image-offload 的消息投影注册失败。
• 不止会话列表：凡消费 session/list 的功能（含插件列表相关读取）一并失效。

与主帖的差异：传染路径 vs 显式安装

主帖的路径是 dsh plugin add 被 latest 标签带到旧版（0.0.1-rc.1）。
本条是：第三方插件把宿主核心包声明为 dependencies 而非 peerDependencies，pnpm 因此把它们 hoist 进 profile：

// dsh-set-model@0.1.0 的 package.json —— peerDependencies 完全未声明
"dependencies": {
  "@deepseek-ai/cordis":      "4.0.2",
  "@deepseek-ai/dsh-agent":   "0.1.2-rc.1",   // ← 硬依赖旧版
  "@deepseek-ai/dsh-llm":     "0.1.2-rc.1",   // ← 报错就出在它身上
  "@deepseek-ai/dsh-session": "0.1.2-rc.1",
  "@deepseek-ai/dsh-tools":   "0.1.2-rc.1",
  "@deepseek-ai/schemastery": "3.18.2",
  "zod": "^3.24.2"
}

连带带入 9 个包（dsh-agent / dsh-brand / dsh-llm / dsh-session / dsh-timeout / dsh-tools / dsh-typert-protocol / dsh-util-crypto / dsh-util-values），全部 0.1.2-rc.1。

其中的机制是：

1. profile 目录的模块解析优先级高于宿主注入的运行时包；
2. typert-loader 以 ctx.baseUrl（= profile 目录）为锚点解析插件包；
3. 于是加载到旧版 dsh-llm，其 typert manifest 用的是旧 codec 契约。

用户完全无感——他没有安装过任何 @deepseek-ai/<core> 包，只装了业务插件；报错文案也完全指向宿主自己的包。

codec 契约差异（供交叉验证）

// @deepseek-ai/dsh-llm@0.1.2-rc.1（旧）—— 键名 schema
codec: { mode: 'strict', typeSymbol: '@deepseek-ai/dsh-llm#llm/discoverModels:settingsNs',
         schema: _deepseek_ai_dsh_llm_llm_discoverModels_parameter_0$schema }

// @deepseek-ai/dsh-llm@0.1.7-rc.2（新）—— 键名 create，loader 硬要求
codec: { mode: 'strict', typeSymbol: '@deepseek-ai/dsh-llm#llm/discoverModels:settingsNs',
         create: _deepseek_ai_dsh_llm_llm_discoverModels_parameter_0$schema }

（grep -c "create:" lib/typert.host.js：旧版 0，新版 5）

一分钟自查：profile 内是否有旧版核心包

# 列出 profile 内所有 @deepseek-ai 包及版本
node -e "const fs=require('fs'),p=require('path');const home=process.env.DSH_HOME||p.join(process.env.USERPROFILE,'.dsh');const d=p.join(home,'profiles','web','node_modules','@deepseek-ai');for(const n of fs.readdirSync(d)){try{console.log(n,JSON.parse(fs.readFileSync(p.join(d,n,'package.json'),'utf8')).version)}catch(e){}}"

# 对照宿主版本
node -e "console.log(require('@deepseek-ai/dsh/package.json').version)"

只要 profile 内出现与宿主版本不一致的 @deepseek-ai/dsh-* 包，就是本症状的根因。

临时修复

在 profile 的 pnpm-workspace.yaml 加 overrides，强制这些包跟随宿主版本：

overrides:
  '@deepseek-ai/dsh-agent': 0.1.7-rc.2
  '@deepseek-ai/dsh-brand': 0.1.7-rc.2
  '@deepseek-ai/dsh-llm': 0.1.7-rc.2
  '@deepseek-ai/dsh-session': 0.1.7-rc.2
  '@deepseek-ai/dsh-timeout': 0.1.7-rc.2
  '@deepseek-ai/dsh-tools': 0.1.7-rc.2
  '@deepseek-ai/dsh-typert-protocol': 0.1.7-rc.2
  '@deepseek-ai/dsh-util-crypto': 0.1.7-rc.2
  '@deepseek-ai/dsh-util-values': 0.1.7-rc.2

pnpm install 后：启动报错归零，session/list 正常返回。

注意：这是止血，不是根治——每次升级 DSH 都要同步改这里的版本号。

建议（回应 PerryLink 对归因的追问）

这条路径下"该改哪边"是三方关系，其中宿主侧可补的防线我认为优先级最高：

1. 核心包解析隔离（建议优先）：@deepseek-ai/* 核心包始终从宿主安装路径解析，忽略 profile 内的同名副本；或解析到与宿主版本不一致的核心包时 fail loudly（明确提示"profile 内含旧版核心包 X@v，期望 v，由 Y 引入"）。当前行为是静默采用旧版，再由 loader 用与版本无关的文案报错。
2. 诊断补强：typert 注册失败时输出"该包实际解析自的路径 + 版本"。现在只给包名和字段名，用户按报错查本仓源码会得出"本仓 codec 有 bug"的结论——@deepseek-ai/dsh-llm typert codec incomplete + web profile 缺 service-provider bundle #7748 就是这样的误判，而它实际是旧版包被加载。
3. 安装/装载期校验：dsh plugin add 或 profile 装载时，检测 node_modules/@deepseek-ai/ 下核心包版本与宿主不一致的情况，给出与现有告警风格一致的可操作提示。

已就触发源插件（把宿主包声明为 dependencies）在对应仓库单独报告。 john-walks-slow/dsh-set-model#1