dsh-jev

社区插件，与 DeepSeek AI 无隶属关系，也不是官方项目。

给 DeepSeek Harness 用的 JEV 情绪 / 意图判定插件。

每一轮对话，插件会把用户最新一条消息发给 typesafe.ai 的 systemone(jev) 接口， 按你配置的问题集合拿到判定结果（情绪、紧急度、分流部门……），再把结果作为一条带来源标记的运行时上下文 注入本步请求，让模型据此调整语气与优先级。所有参数都在 GUI 的 设置 → JEV 情绪分析 里配置。

用户消息 ──► agent/pre-step ──► jev /v1/systemone ──► 判定结果(fragment)
                                                   └──► 追加一条 user 消息（source.kind='plugin'）──► 模型

安装

# 从 GitHub 装（推荐；会写进 profile 的 dependencies 与 dsh.profile.bundles）
dsh plugin --profile web add github:Excalibur9527/dsh-jev

# 本地目录（开发态）
dsh plugin --profile web add /path/to/dsh-jev

# 手动 link 装法（等价于上面 pnpm 的结果，仅供调试）
ln -sfn /path/to/dsh-jev ~/.dsh/profiles/web/node_modules/dsh-jev
# 再改 ~/.dsh/profiles/web/package.json：
#   dependencies:        "dsh-jev": "link:/path/to/dsh-jev"   # 必须绝对路径
#   dsh.profile.bundles: 追加 "dsh-jev"

装完必须重启 dsh web 宿主进程：profile 的层栈在启动时组装，运行中的 loader 不会自动接入新插件。

link 安装时插件目录在 profile 之外，裸包名（@deepseek-ai/dsh-llm 等）解析不到， 需要先跑一次 node scripts/link-deps.mjs 把依赖软链到本插件自己的 node_modules。

设置页

重启后在 设置 → JEV 情绪分析 里配置：

字段	默认值	说明
启用 JEV 判定	开	关掉后完全不再调用接口
把判定结果注入模型上下文	开	关掉后仍然调用并记录，但不往请求里塞内容
API Key	空	存在 ~/.dsh/settings.yaml 的 dsh-jev.apiKey，schema 标了 role('secret')，不会经浏览器的 RPC 回传；没配时回落到环境变量 TYPESAFE_API_KEY
接口地址	https://api.typesafe.ai/v1/systemone	自建/代理时改这里
模型	jev-latest	接口的 model 字段
超时（毫秒）	8000	超时即跳过本轮注入，不阻塞对话
最大输入字符	4000	超出部分截断后再发
附加给模型的行为提示	见默认值	跟在判定结果后面一起注入
判定问题 questions	部门/情绪/紧急度三条	支持 noul（是/否）、score（评分，criteria 每行一档）、choice（单选，criteria 每行 键=说明）

设置页还有：运行测试（用当前配置真打一次接口，展示渲染结果与原始 JSON）、最近调用（时间/耗时/结果/最近错误）。

权限与信任

项目	说明
模块规范	导出 apply(ctx, config)，inject 声明 agents；dsh.bundle.patch 给 bundle 补丁，dsh.client 提供浏览器半边
出网	只有 POST https://api.typesafe.ai/v1/systemone。用户每轮最新一条消息的正文会发给这个第三方服务——这是插件的核心功能；介意就别用，或把设置页里的「接口地址」指向自建代理
读取	用户最新一条消息、~/.dsh/settings.yaml 中 dsh-jev 段的配置
写入	只写 settings.yaml 的 dsh-jev 段（你在设置页点保存时）；不动其它文件
密钥	apiKey 标 role('secret') 存在 settings.yaml；RPC 返回前显式删除，不会回传浏览器
监听端口	不监听任何端口。只注册一条包私有 RPC 通道 /dsh-jev，authority: 'loopback'，本机页面才能读写
对话影响	每轮最多注入一条 user 消息（source.kind='plugin'）；无 key / 报错 / 超时一律原样放行，不阻塞对话
兼容性	DSH 0.1.1-rc.2 实测通过；Node ≥ 22（用 fetch、AbortSignal.any）；profile：web（注入 + 设置页）、headless/TUI（注入可用，设置页需 Web GUI）
许可证	MIT
测试	node --test test/host.test.mjs test/client.test.mjs — 17 个用例，含一次真实接口往返

工作方式与取舍

• 只在有新用户消息的那一步调用：agent/pre-step 的 batch 里出现 source.kind === 'user' 的消息时才调； 工具步、插件自己注入的上下文都不会再触发。
• 不打断对话：没配 key、接口 4xx/5xx、超时、网络错，统统只记一条 warn 并原样放行。
• 不会自激：注入消息的 source.kind === 'plugin'，下一轮的特征判断会跳过它。
• 相同输入 5 分钟内复用结果，避免重试或多步重复计费（设置页的「运行测试」不走缓存）。
• 判定长度计入上下文，压缩前会一直留在历史里；不想要就关掉「注入模型上下文」。

开发

node scripts/try.mjs                            # 手动试跑几段样例（走设置页「运行测试」同一条通道）
node scripts/try.mjs "你这破接口又挂了！"        # 或指定要判定的文本
node scripts/link-deps.mjs                      # 软链宿主依赖（link 安装时必须）
node --check lib/index.js && node --check client/client.js
TYPESAFE_API_KEY=xxx node --test test/host.test.mjs test/client.test.mjs

• lib/index.js —— 宿主半边：agent/pre-step 注入、settings 命名空间、/dsh-jev 的包私有 RPC。
• client/client.js —— 浏览器半边：手写的 CJS 工厂包（window.__ModuleLoader__.load）， 注册进 settings.section 槽位，不需要打包器。
• test/ —— 宿主用假 cordis ctx 驱动真实的 apply()（含真接口调用）；客户端用最小 React 桩真实渲染组件。
• scripts/try.mjs —— 命令行试跑：Key 取 TYPESAFE_API_KEY 或 settings.yaml 里存的那个。

已知限制

• 判定结果只作为自然语言上下文注入，不改变任何工具的必填字段（比如 tool 的参数不会被自动填）。
• 分数型问题返回的是连续值（例如 1.42），注入文本里的档位说明取最接近的整数档。
• 只在 Web profile 验证过；headless/TUI 里注入照常工作，但设置页需要 Web GUI。
• 设置页通道注册成 { authority: 'loopback' }（与 dsh-pocket 一致，也和 DSH 自己对 settings 平面的限制一致）： 只有从本机 loopback 打开的页面能读写设置，经局域网/隧道打开时会明确报错而不是静默失败。
• 通道注册依赖 connection 与 webServer 两个服务；宿主不再同时提供它们时，注入照常工作， 只有设置页不可用，并在宿主日志里留一条 warn。

收录信息

• GitHub topic：dsh-plugin
• 收录详情页（收录后生效）：https://dsh-plugin.org/plugins/excalibur9527/dsh-jev —— 该站路由大小写敏感且要求全小写，别写成 Excalibur9527
• 安装命令：dsh plugin --profile web add github:Excalibur9527/dsh-jev
• 支持 profile：web（完整功能）；headless / TUI（判定注入可用，设置页需 Web GUI）
• 许可证：MIT
• 依赖的第三方服务：typesafe.ai systemone（需要你自己的 API Key）
• 本插件为社区作品，与 DeepSeek AI 及 typesafe.ai 均无隶属关系。