Excalibur9527/dsh-jev

dsh-jev

Listed on dsh-plugin.org
License: MIT

社区插件，与 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 均无隶属关系。