dsh-NeoHorse-Jev-4B-plugin

dsh-NeoHorse-Jev-4B-plugin

English | 简体中文

DeepSeek Harness（DSH）的原生 Jev 类决策插件：按需接入基元律动 NeoHorse-Jev-4B。

dsh-NeoHorse-Jev-4B-plugin 将 DeepSeek Harness（DSH） 与基元律动（TokenRhythm）的 NeoHorse-Jev-4B 决策模型连接起来，为 Agent 提供技能与文件选择、任务监督、共享发现纠正、工具日志筛选、单次操作审批和历史轨迹阶段导航。12 项功能可在同一个 Jev 设置页分别开启，默认全部关闭。

主模型继续负责规划、生成回答和调用原生工具；插件在 DSH 的技能目录、Agent 生命周期、工具结果与审批等扩展点自动发起已启用的 Jev 判断，再按对应功能应用结果。主模型由 DSH 配置，Jev 连接单独配置。接入基于公开的 Cordis / DSH 插件接口，无需修改宿主源码。

这是独立社区项目，并非 DeepSeek 或 Jev 官方发布。当前属于早期插件，在 DSH Desktop 0.2.0-rc.2 端完成改造与验证；接口和模型判断都不构成正确性保证。

包含哪些功能？

下表描述 main 分支。每项功能都有独立开关，默认全部关闭，安装插件不会自动开启。

功能	作用
技能选择（Skill selection）	在技能目录发布前，对名称和摘要排序；主 Agent 仍通过原生 skill 加载正文。
文件排序（File ranking）	对原生 glob 返回的路径排序，不追加文件扫描或正文读取。
跑偏提醒（Drift monitoring）	在模型步骤之间检查进展，必要时提供一次非阻塞提醒。
完成核查（Completion checks）	对照已有证据检查已展示的最终回答，最多追加一次补充处理。
持续目标监督（Goal supervision）	检查原生目标完成申请，连续多轮没有进展时暂停。
用户约束提醒（Instruction guidance）	读取当前用户要求及适用的 Agent 规则，必要时发送非阻塞提醒。
中途插话分流（Interjection routing）	把运行中的纠正消息送到下一步骤，其他消息留待后续轮次。
共享发现纠正（Shared-finding corrections）	比较已经共享的报告和消息，向受影响的接收者发送纠正。
通用长日志准入（Tool-output filtering）	命令返回后可省略明确不需要的进度或重复提示，并提供原文恢复位置。
测试日志准入（Test-log filtering）	保护失败、摘要、点名和慢测试，再判断普通通过明细是否仍有用。
工作区提权代审批（Workspace approval）	仅在 workspace-write 下参与适用的原生单次提权；非肯定判断回到原人工审批。
阶段导航（Stage navigation）	按需分类已记录的完整模型步骤，将连续阶段与轨迹原文关联。

所有功能共用连接、按 profile 保存的设置、判断记录与操作回执。多数 Agent 功能面向存活的 Web 主会话；向子 Agent 发送纠正，不等于子 Agent 自动拥有其他 Jev 增强。

阶段导航

网页客户端在“轨迹”后提供独立的阶段导航标签页。它读取已记录的轮次，不修改原始 Session。

独立的阶段导航开关默认关闭，同时控制页面可见性：开启后才显示标签，开启本身不调用 Jev；关闭时隐藏页面、取消未完成的分类，并保留已保存结果。用户手动选择已结束轮，或选择本会话尚未分析的已结束轮后，才开始分析。

每次分类覆盖一个完整 DSH 模型 step：已记录的 Think、正文、全部工具调用与配对结果。Jev 从六阶段及 mixed、unknown 中选一个；程序只在同一轮内合并连续相同标签。页面左侧保留多轮目录，右侧定位完整 step 原文，并可核对实际分类输入与回答。标签和 confidence 不表示工具成功或分类正确率。输入、保存与失败处理见包参考。

DSH Desktop 安装（推荐）

本项目的改造与适配在 DSH Desktop（Electron 应用）端完成并验证：DSH peer 固定为 0.2.0-rc.2，runtime/ 已提交预构建产物，安装后不在本机编译源码。Desktop 端是首选安装路径。

1. 打开 DSH Desktop，进入 侧边栏「插件」→「添加插件」。
2. 在 「包名或地址」 粘贴下面的 GitHub 仓库地址，点击 「安装」。Desktop 使用自带的 pnpm 完成依赖安装。
3. 安装完成后点击 「立即启用」；若提示下次启动加载，重启 DSH Desktop。
4. 进入 Jev 页面填写服务地址、模型与凭据引用，再按需开启功能。

https://github.com/himetuki/dsh-NeoHorse-Jev-4B-plugin

• Desktop 的 desktop profile 由 Electron 应用独占管理，命令行 dsh --profile desktop 会被拒绝；请在应用内的插件页安装、启用与移除。
• 本机无需另装 Node 或 pnpm（Desktop 自带运行环境），但需要能访问 GitHub。
• 若此前用本地目录（link:）装过开发版，先移除该条目再按仓库地址安装，避免同名依赖仍指向本地目录。
• 插件启用与功能启用是两层开关：12 项 Jev 功能默认仍为关闭。

本复刻把 DSH peer 固定为 0.2.0-rc.2，并接入基元律动（TokenRhythm）的 NeoHorse-Jev-4B。上游仓库仍固定 0.1.7-rc.2，在 0.2.0-rc.2 宿主上会被兼容性检查拒绝。

Jev 连接配置：服务地址 https://tokenrhythm.studio/v1/systemone，模型 NeoHorse-Jev-4B，凭据引用自选。API Key 通过页面的密钥控件保存，不要写入源码或仓库 URL。

网页端安装（其他 DSH Web 环境）

已经在使用 DSH 0.2.0-rc.2 Web 的用户，同样直接填写上面的 GitHub 仓库地址即可：打开 侧边栏「插件」→「添加插件」，粘贴地址后点击 「安装」，再点 「立即启用」；若提示下次启动后加载，重启当前 DSH profile。仓库自带可直接加载的插件入口和预构建文件，安装不会在你的机器上编译源码，也不要求发布 npm 包；Host 需能运行 pnpm 并访问 GitHub。

从源码安装（开发者）

需要修改代码或自行构建时，再使用以下步骤。已有 DSH Web 的普通用户直接使用上面的 GitHub 地址安装即可。

构建环境

• 推荐 Node.js 24.11 或更高版本；发布构建使用 Node 24.14.1 检查。
• PATH 中可用的 pnpm 11.7.0。
• DeepSeek Harness CLI 0.2.0-rc.2。插件固定使用对应 DSH peer 包和 Cordis 4.0.4，不自动承诺兼容更新版本。
• 在 DSH 中配置好主模型，以及你自己的 Jev 兼容 System One 服务和凭据。

如尚未安装工具：

npm install --global pnpm@11.7.0 @deepseek-ai/dsh@0.2.0-rc.2

构建安装包

从源码构建 .tgz，再使用网页端或官方 CLI 安装。

git clone https://github.com/himetuki/dsh-NeoHorse-Jev-4B-plugin.git
cd dsh-NeoHorse-Jev-4B-plugin
pnpm install --frozen-lockfile --ignore-scripts
pnpm run build
mkdir -p dist
pnpm -C packages/jev pack --pack-destination "$PWD/dist"

使用 CLI 创建独立试用 profile

也可以把上一步生成的安装包绝对路径填入已有 Web 的插件管理器。以下 CLI 方法用于另建试用环境。

初次试用请使用尚未存在的新 profile 名；示例使用 jev。先从 Web 模板初始化，再添加插件：

dsh --profile jev --from-default-profile web --dump-default-config > /dev/null
dsh plugin --profile jev add ./dist/himetuki-dsh-neohorse-jev-4b-plugin-0.1.0.tgz
dsh --profile jev

第一条命令创建 Web profile 后退出，不启动应用。如果直接给新 profile 添加插件，DSH 默认只初始化基础配置，不会自动成为 Web 应用。官方安装器会加载插件的 bundle patch，无需手改宿主源码。

打开 DSH 输出的认证访问地址。在 DSH 中配置主模型，然后进入插件的 Jev 页面。

配置 Jev

1. 填写服务地址：官方推荐 https://tokenrhythm.studio/v1/decision；System One 兼容格式 https://tokenrhythm.studio/v1/systemone 同样可用（本插件按 System One 线格式发送，两者通用）。
2. 填写模型 ID：NeoHorse-Jev-4B。
3. 指定 DSH 凭据引用，保存连接，再通过页面的凭据控件保存 API Key。不要把密钥写入源码或仓库 URL。
4. 检查超时时间与 maxInputTokens（上游输入 token 上限，见"服务方限制"），只开启需要的功能。
5. 在“判断记录”中查看输入、答案、尝试次数，以及实际采纳或执行回执。

主 Agent 的模型连接与 Jev 判断连接分别配置。凭据显示“已配置”不等于连接测试成功；连接测试和已启用的判断会向服务方发送请求。

服务方限制

服务方每次纯文本请求最多接受 16 道题，因此需要更多题的判断（技能与文件排序、测试日志候选）会按顺序拆成每批 16 题发送，再把答案合并为一次完整判断。被拒绝的请求会把服务方的 code、message 与 traceId 保留在失败记录中便于排障，并已移除形似凭据的文本。默认单次尝试超时为 30 秒，因为一次拆分判断可能包含多次调用。

上游还有编码后输入 token 上限，超出会返回 422（JEV_UPSTREAM_REJECTED）。 实测边界约为 12,000 字符的纯文本；本插件因此按估算 token（中日韩字符≈1 token/字，其他≈4 字符/token）在发送前本地拦截超限请求，失败记录会写明估算值与 maxInputTokens 上限，功能本轮跳过而不是把 422 抛给用户。maxInputTokens 默认 2,800，可在 profile 的插件行里调整。各功能的文本预算默认 8,000–10,000 字符（此前为 24,000–48,000，远超上游上限）。

选择功能默认取 5 个技能摘要，最多对 40 个 glob 命中排序，展示 12 条路径。超过上限时直接跳过 Jev，不会悄悄只判断前 40 个。监督功能默认每 6 个完成的模型步骤检查一次跑偏，连续 3 个原生目标轮次无进展则暂停。这些参数可调整，保存参数不会自动开启功能。

通用长日志准入和测试日志准入有独立开关，均默认关闭。命令日志从 6,000 个 Unicode 码点、可识别测试日志从 4,000 个码点开始处理；默认省略概率门槛为 0.8，判断最多等待 4 秒。设置页可调整这些及其他准入预算，保存预算不会开启功能。

长日志按分片判定并合并结论。 一次调用放不下整段日志时，候选会按 maxRequestChars 切成有序分片、逐片判定，任一片被拒绝或等待超时只结束后续分片，已完成分片的省略结论仍然生效；maxChunks（默认 4）限制单次结果最多判定几次，设为 1 即恢复"只发一次、放不下的候选保留不判"的旧行为。

行为与限制

• 提醒是建议。 跑偏和约束提醒不会阻塞、取消工具，也不会强制主模型遵守。
• 完成核查只审查证据。 它不会独立运行测试，也不构成完成保证。
• 审批只针对一次操作。 不改变会话沙箱模式，不覆盖宿主固定检查。有效 approve 可返回 allowed-once，unauthorized 或 unknown 回原人工审批；技术故障保留人工 Retry/Cancel。
• 共享纠正有明确范围。 它只处理已经共享的报告和消息，不读取所有 Agent 的内部探索；自动投递限当前存活的主 Agent 及其活跃、可继续的直接子 Agent。同一发现以不同形式上报时，仍可能产生重复纠正。
• 判断成功不等于执行成功。 日志分别记录判断、采纳、许可发放和实际操作结果。
• 判定失败不打扰用户。 判定服务不可达、超时、凭据无效或回答不可用时，插件不会弹「重试/取消」让人决定：该功能这一轮自动跳过（不投递纠正、不提醒、不排序、交回原生审批），会话继续。失败只记入判断记录（状态 failed），不阻断主流程。
• 日志准入保留原文入口。 它只在工具执行后调整符合条件的模型可见文本；DSH 即时 spill、工具输出上限和之后的上下文压缩仍生效。
• 验证有范围。 确定性测试证明集成流程，不证明普遍语义准确率。

开启的功能会将相关任务上下文或操作内容发送到配置的判断服务。精确判断输入和回答保存在 profile 的本地插件记录中，主模型可见影响使用正常 DSH Session 记录。运行资料和凭据应保留为私有数据；公开源码历史不包含个人 QA 截图和原始会话抓取。

更新与移除

已有 profile 更新时，重新构建、打包，运行 dsh plugin --profile jev add <新安装包路径>，再重启该 profile。不要对已有 profile 重新执行 --from-default-profile。相同版本号的不同构建使用新的安装包文件名，验收更新时核对实际安装内容。

单项功能可在 Jev 页面关闭。移除整个包时，以当前 CLI 的 dsh plugin --help 为准。替换实验分支安装包可能移除该分支特有功能，替换前保留 profile 备份。

与上游插件互斥

本插件与上游 @dsh-jev/plugin 是同一个插件的两个版本，同一个 profile 只能安装其中一个：

• 同一 DSH 版本上两者装不上对方：上游固定 0.1.7-rc.2，本复刻固定 0.2.0-rc.2，不匹配时会被 DSH 的兼容性检查直接拒绝。
• 两边的行 id（jev、jev-selection 等）和服务、页面命名空间（ctx.jev、远程 jev、客户端 jev.plugin / jev.stage）相同。即使绕过版本检查同时安装，DSH 也只是静默追加重复行（实测 9 行会变成 18 行，没有专用报错），随后在服务注册阶段冲突。
• 因此切换来源前先移除另一个插件，再安装新的；包名不同，插件管理器不会把两者当成同一个包。

开发

项目名称为 dsh-NeoHorse-Jev-4B-plugin；包标识为 @himetuki/dsh-neohorse-jev-4b-plugin，DSH 的插件列表与安装命令都用这个名字。

仓库根目录是 GitHub 安装入口，packages/jev 保留开发源码；pnpm run build 会同步生成 runtime/，发布源码改动时应一并提交这些生成文件。

pnpm run typecheck
pnpm run build
pnpm exec vitest run packages/jev/tests/host.test.ts packages/jev/tests/wire.test.ts

按改动运行相关测试。没有明确授权时，不开启真实服务实验或使用他人的凭据。开发夹具和测试不会进入可安装 tarball。

• 包参考与消费者 API
• 工作区审批集成测试

DSH 接入点

模块	DSH 扩展点	源码
技能与文件选择	agent/pre-step、tools/execute、tools/post-execute	selection.ts
监督与约束提醒	session/event、agent/pre-step、agent/turn-stopping、tools/pre-execute	supervision.ts、instructions.ts
消息分流与共享纠正	原生 Agent inbox、agent/pre-step、tools/result、子 Agent 消息	interjection.ts、shared-findings.ts
工具输出与测试日志筛选	tools/post-execute	output-admission.ts
单次提权审批	tools/execute、approval/request	workspace-approval.ts

许可证与致谢

MIT，见 LICENSE。安装包携带的第三方许可见 THIRD_PARTY_NOTICES.md。

功能研究受到 Mu 启发。本项目通过公开扩展点实现 DSH 插件，不分发修改版 DeepSeek Harness、Mu 或 Cua runtime。DeepSeek Harness、Typert 工具和 Zod 保留各自声明。