v0.5.5 —— 保存后设置回弹修复

中文 README · English README · npm · CalibGuard 主仓库

修复：关掉云端复核并保存后，勾选状态又被刷新回"开启"。
桌面端安装：设置 → 添加插件 → 输入 dsh-calibguard（固定版本写 dsh-calibguard@0.5.5）→ 重启 DSH。

问题原因

桥接进程的 status 在模型加载过之后，直接返回首次创建 pipeline 时缓存的 pipeline.cfg，
而不是本次请求下发的共享设置。于是：

1. 「云端复核」取消勾选 → 保存 → 设置确实写进了 calibguard-settings.json；
2. 面板紧接着 refreshStatus() → 桥接返回旧配置（llm.enabled=true）→ 面板又把勾选恢复成"开启"；
3. 后续审计其实会热更新 pipeline 配置，用关闭后的值 —— 所以是显示回弹，不是设置没保存。

本版修复

• bridge status 改为按当前请求 options 实时计算生效配置（pipeline 只用于 loaded/device 等运行时信息），
  保存后刷新立即反映新值；
• 面板 applyStatus 增加兜底：用 /status 里的 settings（已保存共享设置）覆盖回填，避免任何引擎侧缓存导致 UI 回弹；
• 新增回归测试：模型已加载后再改共享设置，status 与后续 audit 都必须采用新值（126 个测试通过）。

安装

方式	操作
桌面端「添加插件」	设置 → 添加插件 → 输 dsh-calibguard（可 @0.5.5）→ 重启 DSH
命令行（npm 包）	dsh plugin --profile <profile> add dsh-calibguard
源码方式	profile 的 cordis.patch.yml 插 file:///<本包>/lib/index.js
发行包	下载 dsh-calibguard-0.5.5.zip（约 1.3 MB，含内置引擎）解压后挂载

v0.5.4 —— 依赖校验与半成品 venv 自动补装

中文 README · English README · npm · CalibGuard 主仓库

修复：安装被中断后 venv 半成品被误判为就绪，导致 No module named 'sklearn' / torch unavailable。
桌面端安装：设置 → 添加插件 → 输入 dsh-calibguard（固定版本写 dsh-calibguard@0.5.4）→ 重启 DSH。

问题原因

首次安装依赖时如果 DSH 被重启/关闭，pip 会留下一个只装了部分包的 .venv。旧版 bootstrap 只检查
python.exe 是否存在，于是把半成品 venv 当成"环境已就绪"，桥接进程一导入 torch / sklearn / openai 就报
ModuleNotFoundError，面板显示引擎就绪但实际不可用。

本版修复

• 安装后实测依赖：setup.mjs 装完会实际 import torch, transformers, sklearn, openai, yaml, numpy，
  全部成功才写 <引擎目录>/.deps-ok.json；失败会明确报错并给出重试命令；
• 启动时校验 + 自动补装：bootstrap 用 .deps-ok.json（且比 requirements 新）判断依赖就绪；
  venv 不完整时自动重跑 setup 补装（面板显示"正在自动补装缺失依赖"），不再把半成品 venv 当作就绪；
• requirements 更新（插件升级）会让旧标记失效，触发一次快速校验/补装；
• /status 在依赖未装全时返回"准备中"而不是去调用会崩的桥接；
• 测试增至 126 个（新增依赖标记/失效场景）。

已经遇到这个问题的机器

升级到 0.5.4 后重启 DSH 会自动补装；也可以手动修复一次：

cd <插件目录>
node setup.mjs --dest "<引擎目录>"    # 默认 ~/.dsh/calibguard-engine；会补装缺失依赖并写 .deps-ok.json

然后重启 DSH。若之前有残留桥接进程，重启会一并清掉。

安装

方式	操作
桌面端「添加插件」	设置 → 添加插件 → 输 dsh-calibguard（可 @0.5.4）→ 重启 DSH
命令行（npm 包）	dsh plugin --profile <profile> add dsh-calibguard
源码方式	profile 的 cordis.patch.yml 插 file:///<本包>/lib/index.js
发行包	下载 dsh-calibguard-0.5.4.zip（约 1.3 MB，含内置引擎）解压后挂载

v0.5.3 —— 常规参数设置可收起

中文 README · English README · npm · CalibGuard 主仓库

面板整理：常规参数设置区也可以收起了。
桌面端安装：设置 → 添加插件 → 输入 dsh-calibguard（固定版本写 dsh-calibguard@0.5.3）→ 重启 DSH。

本版变化

• 常规参数设置区默认收起：标题行摘要显示「阈值 0.15/0.85 · 云端复核 开（deepseek-chat）」等关键状态，
  点开后再修改阈值 / 云端复核 / Base URL / 模型 / 送审内容 / 投递方式 / 灰区范围，点「保存」生效；
• 底部「高级 / 其他设置」保持折叠：其他 DSH 插件扫描、本插件更新检查、文件位置；
• README/EN 同步说明（含低算力显卡不再提示重装的措辞）；
• 测试仍为 124 个。

安装

方式	操作
桌面端「添加插件」	设置 → 添加插件 → 输 dsh-calibguard（可 @0.5.3）→ 重启 DSH
命令行（npm 包）	dsh plugin --profile <profile> add dsh-calibguard
源码方式	profile 的 cordis.patch.yml 插 file:///<本包>/lib/index.js
发行包	下载 dsh-calibguard-0.5.3.zip（约 1.3 MB，含内置引擎）解压后挂载

v0.5.2 —— GPU 提示修复 + 主仓库规范链接

中文 README · English README · npm · CalibGuard 主仓库

低算力显卡不再反复提示重装；主仓库规范链接统一为 P-436/CalibGuard。
桌面端安装：设置 → 添加插件 → 输入 dsh-calibguard（固定版本写 dsh-calibguard@0.5.2）→ 重启 DSH。

本版修复（含 v0.5.1）

• GPU 提示：只有「显卡算力 ≥ 7.5（如 RTX 2060）且 torch 是 CPU 版」才显示重装卡片；
  GTX 1060 5GB（算力 6.1，低于 cu128 要求）强制 CPU 是预期行为，不再反复提示重装，
  设备行只显示一行"该显卡算力低于 CUDA 加速要求，CPU 版 torch 已是最优，无需重装"；
• 保存流程核查：参数与 API Key 分两步保存（参数先落盘，Key 失败单独提示）；DSH 凭据库不可写时
  自动回退本机凭据文件；新增面板完整保存负载的回归测试；
• 主仓库/搜索链接：所有文档统一为 P-436/CalibGuard
  （旧 P-436/CG 自动跳转）；插件 README 开头明确"本仓库只是 DSH 插件，不是 CalibGuard 主仓库"；
  npm 包 homepage 指向主仓库；
• 测试增至 124 个；README/EN/docs 同步。

安装

方式	操作
桌面端「添加插件」	设置 → 添加插件 → 输 dsh-calibguard（可 @0.5.2）→ 重启 DSH
命令行（npm 包）	dsh plugin --profile <profile> add dsh-calibguard
源码方式	profile 的 cordis.patch.yml 插 file:///<本包>/lib/index.js
发行包	下载 dsh-calibguard-0.5.2.zip（约 1.3 MB，含内置引擎）解压后挂载

质量

• node --test：124 个测试；发布包不含 test/、scripts/、__pycache__

v0.5.1 —— GPU 提示修复 + 链接规范（已被 v0.5.2 取代）

该版本与 v0.5.2 内容相同（v0.5.2 仅把 npm homepage 指向 CalibGuard 主仓库）。
安装/更新请使用 v0.5.2：dsh-calibguard@0.5.2。

• 低算力显卡（GTX 1060 5GB / 算力 6.1）不再反复提示重装 GPU 版 torch；
• README/engine/主仓库链接统一为 P-436/CalibGuard；
• 补充保存流程回归测试（124 个测试）。

v0.5.0 —— 扫描频率合并 + 自更新弹窗提示

中文 README · English README · npm

扫描频率合并 + 新版本弹窗提示（绝不静默升级）+ 高级设置折叠。
桌面端安装：设置 → 添加插件 → 输入 dsh-calibguard（固定版本写 dsh-calibguard@0.5.0）→ 重启 DSH。

本版变化

• 扫描频率合并成一个下拉（pluginScanMode）：不扫描 / 插件列表更新时（默认）/ 每周 / 每月 / 每季度 / 每半年；
  旧设置里的 scanPluginsOnUpdate + pluginScanInterval 会自动迁移；
• 本插件更新检查（selfUpdateCheck）：关闭 / 每次启动（默认）/ 每天 / 每周；
  • 发现新版本时只在面板顶部弹提示，显示当前/最新版本 + 升级方式（桌面端「设置 → 添加插件」、CLI 命令、Release/npm 链接）；
  • 不会自动升级；可点「跳过此版本」或「以后不再询问」（持久化到 $DSH_HOME/calibguard-self-update.json）；
  • 折叠区还有「立即检测」按钮；
• 面板整理：其他插件扫描、自更新检查、文件位置等不常用设置收进底部 「高级 / 其他设置」折叠区（默认收起）；
• 新增 POST /api/calibguard/self-update（check/dismiss）；/status 增加 selfUpdate 快照；
• 测试增至 122 个；README/EN/docs 同步。

安装

方式	操作
桌面端「添加插件」	设置 → 添加插件 → 输 dsh-calibguard（可 @0.5.0）→ 重启 DSH
命令行（npm 包）	dsh plugin --profile <profile> add dsh-calibguard
源码方式	profile 的 cordis.patch.yml 插 file:///<本包>/lib/index.js
发行包	下载 dsh-calibguard-0.5.0.zip（约 1.3 MB，含内置引擎）解压后挂载

质量

• node --test：122 个测试；发布包不含 test/、scripts/、__pycache__

v0.4.0 —— 其他 DSH 插件扫描（自动体检）

中文 README · English README · npm

新功能：其他 DSH 插件体检。 安装/更新别的 DSH 插件时，CalibGuard 会自动扫描并提醒；
也可设为周期巡检或关闭。桌面端安装：设置 → 添加插件 → 输入 dsh-calibguard（固定版本写 dsh-calibguard@0.4.0）→ 重启 DSH。

本版新增

• 自动扫描其他 DSH 插件：
  • 监听当前 profile 的 dsh.profile.bundles，新装/升级插件后 1 分钟内扫描并提醒（已删除的忽略）；
  • 永远跳过自己（dsh-calibguard 自带模型/词表，自身就是高敏感大包），默认也跳过 @deepseek-ai/* 官方核心包；
  • 默认每个插件最多扫 100 个文件（面板可调 1–500），按插件汇总拦截/转人工/可疑/放行；
  • 风险项写宿主日志：[calibguard] 插件提醒：xxx@1.2.3 → 拦截 …；
  • 结果保存在 $DSH_HOME/calibguard-plugin-scan.json；
• 可配置（插件配置或面板，面板与 AI 共用）：
  • scanPluginsOnUpdate（默认 true）：插件列表更新时扫描；
  • pluginScanInterval（默认 monthly）：off / weekly / monthly / quarterly / halfyearly；
  • pluginScanMaxFiles（默认 100）：单插件文件上限；
• 面板新增「其他 DSH 插件扫描」卡片：开关 / 周期 / 文件上限、「立即扫描全部」/「只扫新装/更新」、最近结果列表；
• 新增 POST /api/calibguard/scan-plugins；/status 返回 pluginScan 快照；
• 测试增至 116 个；README/EN/docs 同步。

安装

方式	操作
桌面端「添加插件」	设置 → 添加插件 → 输 dsh-calibguard（可 @0.4.0）→ 重启 DSH
命令行（npm 包）	dsh plugin --profile <profile> add dsh-calibguard
源码方式	profile 的 cordis.patch.yml 插 file:///<本包>/lib/index.js
发行包	下载 dsh-calibguard-0.4.0.zip（约 1.3 MB，含内置引擎）解压后挂载

质量

• node --test：116 个测试；发布包不含 test/、scripts/、__pycache__

v0.3.8 —— calibguard_configure 工具（AI 改设置，不读写 Key）

中文 README · English README · npm

新工具 calibguard_configure：用户不知道怎么改设置时，直接让 AI 改。
桌面端安装：设置 → 添加插件 → 输入 dsh-calibguard（固定版本写 dsh-calibguard@0.3.8）→ 重启 DSH。

本版新增

• calibguard_configure 工具：AI 可直接读写共享设置（与面板同一份、立刻生效）：
  • 可改：灰区阈值、云端复核开关、Base URL / 模型名、送审内容源、投递方式、截断/滑窗参数、目录上限、凭据名；
  • reset: true 等价面板「重置」；单个键传 null 表示恢复默认；
• 安全（重点）：该工具不能读取、也不能写入 API Key：
  • 返回值只包含设置白名单，永远不含任何凭据值；
  • 参数里出现 api_key / token / secret 等字段会直接报错；
  • 系统提示词明确告诉模型：需要配 Key 时让用户在面板填，不要在对话里要 Key；
• 系统提示词、README/EN/docs 同步；测试增至 110 个。

安装

方式	操作
桌面端「添加插件」	设置 → 添加插件 → 输 dsh-calibguard（可 @0.3.8）→ 重启 DSH
命令行（npm 包）	dsh plugin --profile <profile> add dsh-calibguard
源码方式	profile 的 cordis.patch.yml 插 file:///<本包>/lib/index.js
发行包	下载 dsh-calibguard-0.3.8.zip（约 1.3 MB，含内置引擎）解压后挂载

质量

• node --test：110 个测试；发布包不含 test/、scripts/、__pycache__

v0.3.7 —— README 引擎来源修正

中文 README · English README · npm

文档修正版（功能同 v0.3.6）：README 里「引擎来源」的旧表述已改正——
原来写的是"本仓库不复制、不修改引擎"，与实际不符；现在明确说明：

• 运行所需的引擎核心（calibguard/、audit_service.py、词表与校准参数）已复制到本仓库 engine/
  （只复制、不改逻辑，同步方法见 engine/README.md）；
• 模型权重（475 MB）由本仓库 Release 资产分发；
• 运行时通过常驻 Python 子进程调用引擎。

桌面端安装：设置 → 添加插件 → 输入 dsh-calibguard（固定版本写 dsh-calibguard@0.3.7）→ 重启 DSH。

安装

方式	操作
桌面端「添加插件」	设置 → 添加插件 → 输 dsh-calibguard（可 @0.3.7）→ 重启 DSH
命令行（npm 包）	dsh plugin --profile <profile> add dsh-calibguard
源码方式	profile 的 cordis.patch.yml 插 file:///<本包>/lib/index.js
发行包	下载 dsh-calibguard-0.3.7.zip（约 1.3 MB，含内置引擎）解压后挂载

质量

• node --test：105 个测试；发布包不含 test/、scripts/、__pycache__

v0.3.6 —— 凭据回退 + 安装自动刷新

中文 README · English README · npm

凭据更好配、装完自动刷新。 桌面端：设置 → 添加插件 → 输入 dsh-calibguard（固定版本写 dsh-calibguard@0.3.6）→ 重启 DSH。

本版修复

• API Key 面板默认值：凭据名预填 DEEPSEEK_API_KEY；Key 已存在时输入框直接显示
  「已配置（留空表示不修改）」；
• "当前环境不支持写入 DSH 凭据库" 不再卡住：某些 DSH 版本的 ctx.credentials 没有 set，
  现在会自动回退写入本机文件 ~/.dsh/calibguard-credentials.json（0600，仅本机、值不进共享设置），
  面板会明确显示存到了哪里；后续审计会自动从凭据库 → 环境变量 → 本地文件依次解析；
• 自动刷新状态：首次环境准备期间面板每 4 秒自动刷新（装完不用手动点「刷新状态」）；
  GPU torch 重装完成后同样自动刷新并提示；
• 测试增至 105 个；README/EN/docs 同步。

安装

方式	操作
桌面端「添加插件」	设置 → 添加插件 → 输 dsh-calibguard（可 @0.3.6）→ 重启 DSH
命令行（npm 包）	dsh plugin --profile <profile> add dsh-calibguard
源码方式	profile 的 cordis.patch.yml 插 file:///<本包>/lib/index.js
发行包	下载 dsh-calibguard-0.3.6.zip（约 1.3 MB，含内置引擎）解压后挂载

质量

• node --test：105 个测试；发布包不含 test/、scripts/、__pycache__