DeepSeek Harness 插件

gordan-code/dsh-jev-advisor

Star 数 ★ 3 下载量(近 30 天) 1,974 分类 UI 增强 收录于 2026-10-05 npm dsh-jev-advisor

为 DSH 选择题提供面向用户的 TypeSafe Jev 第二意见,默认按需询问、可选自动获取,展示推荐、概率和置信度,支持分歧提示、复制建议、一键采纳、按 profile 保存卡片布局、临时决策偏好、可选发送前预览与常见凭证遮盖,并提供本地健康检查和脱敏诊断复制。

安装

# npm 包(预构建)

dsh plugin --profile web add dsh-jev-advisor

# GitHub 源码(首次需按提示配置 allowBuilds 构建授权后重试)

dsh plugin --profile web add github:gordan-code/dsh-jev-advisor

装任何插件都等于在你的机器上跑第三方代码,权限和你本人一样大——能读你的文件、用你的凭据、访问网络,工具审批管不到它。GitHub 来源的插件还会在安装时执行构建脚本——pnpm 默认拦截,所以安装可能停在 ERR_PNPM_GIT_DEP_PREPARE_NOT_ALLOWED 或 ERR_PNPM_IGNORED_BUILDS;dsh 会打印出需要添加的确切键名,把它加进该 profile 的 pnpm-workspace.yaml 的 allowBuilds 下,重跑一次即可装上。放行构建本身就是一次信任判断:请只安装可信来源,并尽量锁定 commit(github:owner/repo#sha)。

README

English | 中文

给你一份 Jev 第二意见,而不是给 agent 增加一个工具。

dsh-jev-advisor 为 DeepSeek Harness 添加浮动建议卡片, 辅助你回答选择题、批准或拒绝工具执行,以及审查计划。建议由 TypeSafe Jev 提供; 只有你点击采纳,才会向 DSH 提交决定。

问题旁的建议卡片

快速开始

dsh plugin --profile <your-profile> add github:gordan-code/dsh-jev-advisor
  1. 打开设置 → Jev,填入 TypeSafe API Key 并保存。
  2. 出现受支持的待答交互时,点击询问 Jev。
  3. 查看建议后采纳,或继续使用 DSH 原有控件作答。

默认按需询问,升级时未明确开启自动模式的用户也适用。 如需自动请求,打开设置 → Jev → 自动获取 Jev 建议并保存。 同时开启发送前要求确认时,两种模式都先显示本地预览,只有点击确认发送才调用 Jev。

功能

交互类型 建议与操作
单选题 展示推荐、选项概率、置信度和分歧提示;可复制建议或一键采纳。
多选题 逐项评估,概率 ≥ 0.5 的选项组成推荐集合。
工具审批 建议允许本次执行或拒绝执行,并展示风险评分:0 低、1 中、2 高。采纳只作用于本次调用。
计划审查 评估已有选项,展示计划完整度:0 需要修改、1 基本可行但有缺口、2 完备可行。仅含一道计划审查题时,若 Jev 选择“以上都不是”且 DSH 提供相应操作,可采纳为要求修改计划。
  • 多视角取舍对比(可选):在同一次 Jev 请求中,附加 1–5 个视角进行比较。 默认依据交互类型和题目关键词匹配,例如工具审批侧重安全与任务推进,计划审查侧重完备、少改和速度。 可在卡片上增删或输入自定义视角,也可在设置中保存默认视角。视角对比适用于单选题,不扩展多选题的逐项评估。
  • 临时决策偏好:为当前交互填写“优先稳定”等要求。首次询问前保存不会调用 Jev; 已开始评估后应用修改,会重新评估,确认模式下则重新生成本地预览。
  • 限时提问保持:宿主支持时,发起评估会请求暂停倒计时,聚焦卡片会保持问题; 宿主报告倒计时运行中时,还可点击暂停倒计时。这是尽力保护,不保证问题一定不会过期。
  • 查看与布局:展开请求/响应 JSON,左右停靠、折叠或关闭卡片。停靠和折叠状态按 DSH profile 保存。
  • 本地诊断:查看版本与生效设置,复制脱敏诊断,不调用 Jev。

卡片不替换 DSH 原有交互界面,不修改 agent 提示词,也不强制执行权限策略。 概率和评分只是模型判断,不是安全保证;最终决定由你作出。

安装、更新与卸载

只选择一种安装来源。 重复挂载同一个包可能导致 loader entry 和路由冲突。

从 GitHub 安装

dsh plugin --profile <your-profile> add github:gordan-code/dsh-jev-advisor

仓库已包含构建产物 lib/,安装时无需本地构建。

从 npm 安装

dsh plugin --profile <your-profile> add dsh-jev-advisor
# 固定已发布版本:
dsh plugin --profile <your-profile> add dsh-jev-advisor@<published-version>

npm 安装的是已发布版本,可能与当前源码不同;仅凭包版本号不能确定 Git 修订。

从本地源码安装

node scripts/build.mjs
dsh plugin --profile <your-profile> add /absolute/path/to/dsh-jev-advisor

修改 src/ 后需重新构建,本地链接不会自动构建。

更新或卸载

dsh plugin --profile <your-profile> remove dsh-jev-advisor
# 更新时,从选定来源重新安装:
dsh plugin --profile <your-profile> add github:gordan-code/dsh-jev-advisor

按 DSH 提示重新加载或重启,再刷新客户端。如果提示宿主桥接过期,需要重启宿主并刷新页面。 本地重建后建议强制刷新(Ctrl+Shift+R),避免浏览器继续使用 immutable 缓存中的旧包。

设置

入口:设置 → Jev。修改后需保存;API Key 输入框留空会保留已存密钥。

设置 默认值 说明
API Key 空 来自 https://console.typesafe.ai/keys。以明文保存在 profile 的 Cordis patch 中,设置读取不会回传密钥。
接口地址 https://api.typesafe.ai/v1/systemone 评估端点。
模型 jev-latest Jev 模型或别名。
启用 Jev 建议 开 总开关。
自动获取 Jev 建议 关 autoAdvise=false。开启后为受支持的交互自动发起建议流程,仍遵守确认设置;实际发送可能产生 API 用量。
把最近的对话作为 state 一起发送 开 附带会话记录尾部作为上下文。
发送前要求确认 关 先在本地预览待发送请求。
发送前遮盖常见凭证 开 尽力替换发送文本中的常见凭证模式。
默认开启单次请求「多视角取舍对比」 关 默认启用视角对比;卡片可单独调整当前交互。
默认对比视角 空 填写 1–5 个名称,以逗号分隔;留空按问题匹配。仅填写名称不会自动开启对比。
上下文消息条数 12 发送最近多少条会话消息。
超时(毫秒) 30000 整次评估超时,包含响应读取与重试退避。

卡片上的视角修改和临时偏好只用于当前交互;设置页的默认值会持久保存。 仅编辑视角名称不会发送请求,需要按卡片提示保存或应用。

测试连接使用已保存的配置发送一次小型 Jev 评估,可能产生 API 用量。

本地健康检查不调用 Jev。展示插件与已安装 DSH 的版本、兼容声明、是否配置 Key,以及获取模式/隐私开关。 缺失信息显示未知;匹配声明不代表所有功能均已验证。 复制脱敏诊断只含白名单信息,不含密钥、端点、用户路径、题目文本或完整配置。

隐私、费用与采纳保护

  • 宿主会向配置的端点发送题目、选项、可选会话上下文,以及显式偏好或已启用的对比视角。 工具审批还会附带审批元数据,以及从会话中找到的工具参数。 关闭会话上下文不等于移除这些决策输入。
  • 凭证遮盖识别常见 token/password 赋值、Bearer token、sk-… 密钥、私钥块和 URL 凭证, 不能发现所有秘密或个人信息。敏感内容请发送前预览。请求/响应 JSON 可能包含会话内容, 不要把它当作脱敏诊断分享。
  • 确认使用精确的本地请求快照,有效期两分钟;请求身份或评估设置变化后失效。准备预览本身不调用 Jev。
  • 完整评估 JSON 上限为 64 KiB UTF-8。优先缩减上下文;决策输入本身超限时本地拒绝,不静默截断。
  • 一次 HTTP 请求可包含多项评估。视角对比可能增加 API 用量,一次请求不等于一道固定费用的题目。 卡片仅在 Jev 返回用量时展示实际 token 数据。
  • 同一宿主中的相同并发评估共用上游调用。取消不能撤销已处理的工作,也不保证免单或退款。 重开已完成结果会复用;按需模式重开已取消请求后,仍需点击询问 Jev。
  • 答案绑定当前会话、交互与请求;异常、不完整或过期结果不能采纳,双击不会重复提交同一交互。
  • 普通单选题选择“以上都不是”时需手动作答,前述计划审查的要求修改计划为例外。 多题批次需每题都有有效答案才能整体采纳,不会替未回答问题补空答案。
  • 宿主的四条路由(status、test、prepare、advise)要求回环连接与浏览器同源请求。 这些检查不能隔离同一系统用户下的恶意进程;请使用可信 profile,并保护明文密钥文件。

兼容性与限制

  • 唯一的 DSH 版本声明是无上限下限:"engines.dsh": ">=0.2.0-rc.2"。没有上限、也没有 @deepseek-ai/dsh* peer,宿主升级后既不会拒绝加载,市场页也能显示明确的「兼容」, 而不是「未声明(unknown)」——后者正是什么都不写的结果。验证基线是 0.2.1-rc.3, 此后所有更新的宿主版本都落在该范围内。只有未来宿主真的改动公开交互 API 时才需要加上限。 各项功能仍依赖宿主提供的公开交互 API。
  • 优先跟随主会话的待答交互;主会话没有待答交互时,才回退到其他受支持交互。历史或已关闭交互不参与评估。
  • 不支持纯自由文本题;包含不支持题目的混合批次,不能整体采纳。
  • 卡片使用 shell.overlay 和 settings.section。避让侧栏需手动切换停靠位置或折叠。
  • 上下文最多约 24,000 字符,还可能因字节预算继续缩减;仅对 429、529 响应最多重试两次。

常见问题

现象 检查方式
卡片不出现 确认存在受支持的待答交互、建议已启用,且客户端包与宿主路由已加载。
没有发起请求 按需模式需点击“询问 Jev”,确认模式还需点击“确认发送”。
未配置 Key/401 在设置 → Jev 保存有效的 TypeSafe Key。
422 检查本地请求;报告错误码与字节数,不要分享密钥或会话正文。
429/529 限流或服务繁忙;两次自动重试结束后,可稍后手动重试。
宿主桥接过期/仍显示旧界面 重启宿主并强制刷新页面,核对已安装来源与版本。
返回其他请求的建议 重启并刷新;仍复现时仅提供比较标志,不提供请求内容。
duplicate loader entry 移除重复安装或重复 bundle 条目。

开发

npm ci
npm run build
npm test
npm run check:pack
npx playwright install chromium
npm run test:browser
npm run test:host
npm run test:install
npm run quality
npm pack --dry-run

lib/ 随仓库提交。npm test 检查它与 src/ 一致; check:pack 检查发布入口、客户端包和 cordis.patch.yml。

宿主/安装测试需要固定版本的真实 DSH CLI。PowerShell 示例:

$env:DSH_TEST_CLI = "<cli-directory>/node_modules/@deepseek-ai/dsh/lib/bin.js"
npm run quality

quality 依次执行构建、基础测试、Chromium、打包检查、隔离宿主和 tarball 安装测试。 缺少前置条件会失败,不会跳过。测试使用 mock 和临时 profile,不使用真实 Jev Key 或用户 profile。 Chromium fixture 不等同于完整 Desktop UI 测试。CI 还覆盖 Node 20/22/24 和固定的三个 DSH 运行时质量矩阵。

宿主通过 ctx.sessions 和回环 JSON 路由工作;浏览器使用公开 Cordis 服务 (ctx.slots、ctx.locale、ctx.configForms、ctx.uiSession),不导入其他插件私有实现。

许可

MIT。Jev 是 TypeSafe AI 的产品。本项目与 TypeSafe AI、DeepSeek 无隶属或背书关系。

内容来自项目 README(GitHub)↗

链接

同类插件

查看整个分类 →

社区评论

评论公开保存在 GitHub Discussions。加载评论会连接 GitHub 和 Giscus;发表内容需要 GitHub 账号。