DSH CCSwitch 导入器

将 CCSwitch 的 Codex provider 配置导入 DeepSeek Harness，并在同一个「设置 -> 模型」页面管理每个模型的推理深度。

English README

功能

• 只读扫描 ~/.cc-switch/cc-switch.db，识别自定义 Codex provider；官方和默认 profile 会跳过。
• 将 endpoint、协议、模型 ID 和 API key 导入 DSH 的 llm-pi-ai 设置。
• API key 只在 Host 进程中读取，并通过 DSH credentials 服务保存为 apiKeyEnv 引用；扫描和导入响应不包含 key。
• 从 Codex TOML 顶层 model_reasoning_effort 预填模型推理配置，同时允许之后在 DSH 中修改。
• none 映射为关闭；已知模型使用保守目录；未知模型只生成导入值对应的单个等级；非法值安全关闭并给出警告。
• 重新导入不会覆盖已有的推理等级、route 默认值、headers、容量字段或未出现在 CCSwitch 的额外模型。
• 原生 Models 页面、CCSwitch 导入区和模型推理编辑器共存于同一个 Models 页面。
• CCSwitch 导入区、模型推理面板和每个模型卡片都支持收纳折叠，折叠偏好会保存在当前浏览器。

CCSwitch 是只读导入源。首次导入后，DSH 设置和 credentials 服务成为配置事实来源；不会写回 CCSwitch 数据库。

安装

从 GitHub 安装：

dsh plugin --profile desktop add github:wtiaw/dsh-ccswitch-importer

从本地源码安装：

dsh plugin --profile desktop add ./dsh-ccswitch-importer

安装或更新后刷新 DSH Web 页面，打开 设置 -> 模型。

使用

1. 在 Models 页面打开「CCSwitch 导入」并点击「扫描」。
2. 选择需要导入的 provider，点击「导入选中」。
3. 检查导入结果和 provider 模型列表。
4. 在同页的模型推理区域确认已预填的等级；第三方网关需要自定义 wire value 时直接编辑并保存。
5. 使用各面板标题栏或模型卡片右侧的箭头收纳/展开内容；折叠偏好会自动记住。
6. 在输入框模型选择器中使用保存后的推理等级。

导入会在设置 revision 冲突时停止并恢复本次写入的 credential；已有 credential 会恢复原值。

推理目录

当前保守目录包含：

• GPT-5.6 系列：off: none、low、medium、high、xhigh、max。
• OpenAI o-series（o1、o3、o4-mini 及变体）：off: null、low、medium、high。

目录只是默认值，保存后的 DSH 字段由用户控制。

DSH Community Market 目录

本插件按 目录适配器指南（路径 A：标准来源） 提供可接入 DSH Community Market 的标准目录。仓库内包含：

• scripts/build-catalog.mjs —— 从 package.json 元数据生成 catalog-source manifest 与 /v1/plugins 条目页；
• scripts/deploy-catalog.sh —— 一键部署到 Cloudflare Pages（含 JSON Content-Type 重写规则）；
• test/catalog.test.mjs —— 用官方 Schema 校验生成结果并断言元数据一致；
• docs/catalog.md —— 部署方式、Content-Type 要求与来源登记说明。

同时，本插件仓库已添加 GitHub topic dsh-plugin，会被 dshfind 目录来源按 topic 自动收录。

生成与部署：

DSH_CATALOG_ORIGIN=https://catalog.example.com npm run build:catalog

安全边界与限制

• Host 路由只接受 loopback、same-origin 请求；API key 不进入浏览器、日志、摘要或错误文本。
• 读取需要 Node.js 22.19 或更高版本，以支持只读 SQLite API。
• 插件只处理 CCSwitch 的自定义 Codex provider 和当前数据库字段；不会探测第三方 API 的真实推理能力。
• 未知模型和不合法等级默认关闭，避免向网关发送未确认的 reasoning 参数。

开发与验证

要求 Node.js 22.19 或更高版本：

npm install
npm test
npm run pack:check

npm run build 生成 DSH Host bundle 和带有 window.__ModuleLoader__.load 注册的 Client bundle。发布包只包含 dist、patch、README 和许可证，不包含源码与测试。