VCPr0j3k7/dsh-desktop-settings ↗★ 0

dsh-desktop-settings

为DSH桌面版补充翻译、代理等缺失设置 适合DSH桌面版用户,用于配置DeepL翻译、GitHub加速及清理缓存。

套件
dsh-desktop-settings
相容性
待驗證
版本
0.1.0
授權
MIT
最近更新
2026年9月25日

安裝

$npx -p @deepseek-ai/dsh dsh plugin --profile web add github:VCPr0j3k7/dsh-desktop-settings

配置文件

所有设置统一写入 /dsh-extras.json,与插件市场(dsh-plugin-market)共用 同一份文件:写入方是本插件,读取方还包括需要翻译与下载的市场模块。采用文件而不是插件间 HTTP 调用,是因为文件不存在「另一个插件没装 / 还没启动」的时序问题。

字段默认值说明
appName"DeepSeek Harness"显示名
githubProxy.enabledfalse是否启用 GitHub 加速代理
githubProxy.baseUrl""代理地址,形如 http://1.2.3.4:8080
githubToken""可选的 GitHub API 令牌
translate.enabledtrue是否启用 README 翻译
translate.endpointhttps://api-free.deepl.com/v2/translateDeepL 端点
translate.apiKey""DeepL API Key
translate.targetLang"ZH"目标语言代码(DeepL 使用大写)
translate.characterCount0本地累计的已翻译字符数
translate.maxCharacters4000单个 README 最多翻译的字符数

配置读取不做缓存:文件只有几百字节,每次重读的成本可以忽略,换来的是「改完立刻生效」。 未知字段会原样保留,缺失字段回落到默认值。

首次运行时,若 /dsh-extras.json 尚不存在,会尝试从 %APPDATA%/DSH-Desktop/config.json(或 DSH Desktop、dsh-desktop)迁移一次 translate 与 githubProxy,使此前填写过的密钥与代理地址可以继续使用。

跨 DSH_HOME 的配置探测与导入

GET /settings/inspect-homes 与 POST /settings/import-from 对应「从另一个 DSH 数据目录 沿用配置」这一能力。它的前提是外壳划出完全隔离的数据目录,而官方桌面版不隔离 ~/.dsh, 只存在一个家目录,因此该能力不适用。两条路由会返回可读的原因说明,而不是 404 —— 这样在 有人手工构造请求时能直接得到解释。

host/services/settings-ops.mjs 中保留了该能力的完整实现,供需要隔离语义的环境使用。