dsh-auto-review-jev
Jev Review 是当前会话的工具执行前审查模式。启用插件后,在权限菜单选择 Jev Review,或运行 /permission jev-review。仅开启插件不会切换已有会话;新会话默认权限保持原设置。
安装要求
版本 0.2.1 面向 DSH ^0.2.2-rc.1、Node >=24.9.0,精确验收版本为 0.2.2-rc.1。需要配套 DSH 宿主扩展:permission-presets 的具名审查注册、官方 Auto 的共享证据导出、子代理继承和权限 UI 确认。官方原版尚未开放全部接口;缺失时明确报告 JEV_HOST_EXTENSION_REQUIRED。见 兼容、安装与回滚说明及配套补丁。沿用 GitHub Releases 的版本化 tarball 发布渠道。
执行行为
- 当前会话选中后使用 danger-full-access + ask,每个原生工具和 PTC 内部工具都先由 Jev 判断,外层 run_code 遵循官方 Auto 的排除规则。
- 普通项目读写、测试和构建属于 low;medium 的外部写入、删除既有对象、生产操作或权限修改需要当前用户或核验的直接父代理明确授权;high 的敏感信息外发不由模型自动批准。
- low 的风险置信度达到阈值且模型选择 allow 即可自动执行,不再要求额外授权置信度;medium 同时要求风险和授权置信度达到阈值。风险不清或 low+deny 的矛盾判断仍转人工。每次调用仍由 Jev 审查,不使用工具名称白名单。
- 模型拒绝或低置信度时,主会话交给原生审批链;approval=never 的子代理直接拒绝。人工只接到一次请求。端点、身份或协议错误阻止执行。
- Jev 允许后仍保留后续工具钩子的限制;执行前检查权限和审查配置是否变化。切换模式取消正在执行的 Jev 会话活动,避免旧程序继续使用原访问范围。
- 停用或卸载先取消并等待相关审查及代理活动,再回退到 workspace-write + ask。缺失集成的已存 Jev 会话在恢复时同样安全回退。
设置与数据
设置页按“审查服务、访问凭据、审查策略、日志记录”分区,统一标签与输入框对齐;代理、超时、格式、预算和重试收在“高级设置”。支持浅色、深色和窄屏布局。配套宿主在正常关闭时保留会话的 Jev 选择;热停用、卸载仍安全回退。
在插件设置页配置 reviewer.protocol=systemone、baseURL、proxyURL、model、密钥来源、超时和 systemone.confidenceThreshold。默认端点为 https://api.typesafe.ai/v1,模型 jev-latest,阈值 0.8。认证沿用 apiKey、apiKeyEnv、apiKeyFile 的优先级;不要在聊天或提交中放密钥。
0.2.0-jev.6 支持 D3 在线接口:baseURL=https://app.vllm-sr.ai/v1、model=vllm-sr/d3-ultra、systemone.stateFormat=json-string、maxLen=0。TypeSafe 保持默认 object。格式转换不改变证据,字节预算包含 JSON 字符串的二次转义。当前免费 D3 API 仅供非商业研究评测,会记录请求并可能用于训练;不能发送敏感、保密数据或凭证。见 兼容说明。模型替换仍使用 jev-review 权限入口。
审查发送工作目录、项目约束、具有核验来源角色的过滤历史、工具说明、schema 和完整参数至配置端点。采用官方 Auto 同一快照算法,再通过 Jev 证据预算适配服务端上下文限制;项目文件和工具结果不能自行授权。模型和网络有额外费用与时延;实际 Jev 服务版本可能随 jev-latest 改变。reviewer.proxyURL 可指定仅供 Jev 请求使用的 HTTP(S) 代理;留空时沿用宿主网络,不改变 DSH 其他请求的路由。
systemone.maxRequestBytes 默认 24000,计入完整请求的 UTF-8 字节数。请求超出预算时完整保留授权、约束、检查点、项目说明和待执行参数,优先保留近期完整事实,并跳过装不下的事实;省略情况明确告知模型。省略事实不能提供授权或证明清理对象由本会话创建。核心证据本身超限时在网络请求前阻断,不静默截断命令。maxLen 仅为自部署后端的 max_len 参数,不能提升 TypeSafe 的上下文上限。
reviewer.transport.maxAttempts 默认 3,retryDelayMs 默认 300;只对已识别的短暂连接错误及 HTTP 408/429/502/503/504/529 重试,等待依次增加并尊重 Retry-After。所有尝试共用 reviewer.timeoutMs,取消会立即停止等待,不换代理、不回落直连、不重试工具本体。认证失败、451、上下文超限、证据错误、协议错误和证书错误不重试。持续断网仍阻止执行;本模式依赖有效的 Jev 网络路径。
旧 policy、allowRules、breaker 和事实探查字段仅为读取旧配置保留,不参与 Jev Review。旧全局 approval/request 回答器不再安装;/auto-review 和 /approve 不作为新模式的控制入口。模型置信度缺失、越界、未知选项及 high+allow 都不能放行。
审计默认追加到 ~/.dsh/auto-review-audit.jsonl,旧记录保留。新记录以 policyVersion=dsh-auto-v2-jev-v7 标记,区分审查开始、重试、模型裁决、人工审批和工具结果。每次审查使用独立 reviewId,即使不同步骤复用 callId 也不会混淆。记录包含安全错误码、耗时、尝试次数、置信度、选项概率和证据预算,不保存原始输入、原始错误响应或密钥。人工批准与工具执行成功不能算作模型自动批准。
新版快照的待审调用本身属于历史事实,但它及其匹配 schema 始终完整保留。模型仍可能对长上下文返回“低风险但拒绝”的矛盾判断,此时转人工;不会为通过测试降低阈值或放宽一致性检查。
构建与验证
npm run build 写入实际加载的 lib;npm run typecheck 检查真实宿主依赖。npm test 验证严格 Jev 响应解析。npm run test:integration 使用真实 Loader、AgentLoop 和工具执行器,仅模拟模型端点;见 验证边界。
迁移与回滚
见 兼容、迁移与回滚说明。旧版插件与新版宿主的证据接口不同,回滚应恢复匹配的宿主与插件;也可停用 Jev,在新版宿主继续使用工作区内修改。保留现有凭据来源与审计记录。
No comments yet. Be the first to write one.