为 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
- 打开设置 → Jev,填入 TypeSafe API Key 并保存。
- 出现受支持的待答交互时,点击询问 Jev。
- 查看建议后采纳,或继续使用 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 无隶属或背书关系。
链接
同类插件
zhu1090093659/dsh-web#packages/dsh-task-board★ 10525
侧边栏多列任务看板:卡片交给真实 DSH 智能体会话执行,支持 cron 定时(Host 侧到点执行,关浏览器也生效)。
zhu1090093659/dsh-web#packages/dsh-web-all★ 10525
DSH Web UI 插件与皮肤合集:任务看板、git 图、右侧面板、远程移动端 UI、桌宠、实时 token 统计与皮肤中心。
ccch1mneyyy/dsh-TUI★ 7952
Claude Code 风格全屏终端 UI:像素鲸鱼顶栏、实时工作状态行、思考流式展开。
MeteorNOX/DeepSeek-Balance-Whale-Widget★ 7336
右下角常驻的小鲸鱼挂件:余额、今日已用与每轮对话消耗(含峰谷价),余额预警与今日预算的泡泡内容都可编辑;泡泡点击序列模块化自定义,支持并列加权 A/B、随机台词与随机图片;内置 30+ 厂商模板(OpenAI / OpenRouter / Kimi / 硅基流动 / 方舟 / 智谱 / MiniMax 等),按模型查余额与订阅额度;另有任务结束音效、导入音频、自定义角色与资源管理。数据全在本机,无遥测。
omdsh-dev/DSH-better-sidebar★ 5234
侧边栏完整工作台:内置文件渲染编辑、终端、Git 与子代理,支持三方插件注册新 Tab。
omdsh-dev/dsh-genui★ 1024
助手回复内渲染交互式 UI 组件:布局、图表、表单、测验、mermaid、3D 场景与回传事件循环。
社区评论
评论公开保存在 GitHub Discussions。加载评论会连接 GitHub 和 Giscus;发表内容需要 GitHub 账号。