Docs · v1.5.2

操作文档

DeepSeek Harness Desktop 把官方 DeepSeek Harness 的本地 Web UI 带到原生桌面：自动启动并管理本地服务、系统托盘、免装 Node.js。当前镜像引擎版本 0.1.1-rc.2。

1 · 安装与启动

Windows 10 及以上（x64）。安装包内置官方引擎与独立 Node 运行时，无需安装 Node.js 或执行任何命令。

API Key 配置：官方设置 ->「模型」板块，在对应 Provider 的编辑卡片中填写（写入 ~/.dsh/.credentials.yaml）。桌面端「账户与用量」自动读取，无需重复配置。

打开官方设置后，导航在官方分区（通用 / 模型 / 插件 / Agent 预设）之后追加 五个桌面分区（自 1.4.0 起「模型与多模态」回归官方板块，桌面端不再设该分区）：

分区	功能
内置服务	服务状态与日志、启动/停止/重启、服务来源（本地更新版 -> 内置 -> 源码 -> 全局 -> npx）、Web 地址、工作区路径、托盘/开机自启等行为开关。
账户与用量	按官方凭据解析 API Key 查询 DeepSeek 账户余额；直接读取引擎会话日志统计全部模型（含第三方 Provider 路由）的 token 消耗。
Skill 加载器	全根目录扫描、遮蔽检测、GitHub 搜索安装、Git / 文件夹 / 压缩包拖拽安装、可视化启停与删除。
MCP 插件	可视化增删改 MCP 服务器（stdio / streamable-http），一键测试连接并列出工具清单；以官方 mcp-client 插件注入，不改动任何官方 profile 文件。
更新与关于	官方引擎一键更新（镜像加速）、桌面版更新检查与应用内下载、备用更新地址切换。

自 1.4.0 起，模型与多模态完全由官方「模型」板块管理，官方引擎已原生支持全部能力：

第三方 Provider：官方「模型」板块「添加自定义提供方」创建 llm-pi-ai 路由；OpenAI 兼容与 Anthropic 原生（anthropic-messages）协议均原生支持，无需本地翻译网关。
多模态：官方引擎逐模型声明输入模态（内置目录含 DeepSeek-V4-Flash-Vision-Exp 等视觉模型）；自定义路由通过 defaultInput 或逐模型 input: [text, image] 声明。/goal、/plan 等命令可直接接收图文输入。
从 1.3.x 升级：旧桌面端 Provider 配置首次启动时自动迁移为官方直连路由（Anthropic 上游自动标注 anthropic-messages、本地网关前缀移除），已保存的密钥继续生效，无需手动搬移；原 providers.json 归档为 .bak。

对话流辅助仍在：输入框 # 唤起 Skill / MCP 速查面板；图片灯箱增强（滚轮缩放、拖拽平移、双击还原、下载）；官方插件列表内联中文注解。

按官方凭据层（进程环境 > ~/.dsh/.credentials.yaml > ~/.dsh/.env）解析 API Key，查询 DeepSeek 官方账户与各第三方路由中 DeepSeek 端点的余额。密钥写入与维护全部在官方「模型」板块完成，本面板只读。

直接读取官方会话日志（~/.dsh/sessions，含 zstd 压缩）统计：今日 / 近 7 日 / 累计三档汇总、逐模型分解（含缓存命中与推理 token）、最近请求明细。覆盖官方「模型」板块中的全部可选模型。首次扫描可能需要几秒。

支持 stdio（本地命令，含环境变量与工作目录）与 streamable-http（远程 URL，含请求头）双传输，超时与断线重连等参数完整可视化。
每个服务器可「测试连接」：真实握手并报告工具数量与清单。
保存写入 ~/.dsh/dsh-desktop/mcp.patch.yml 注入层，服务以 dsh web --patch 启动，不改动任何官方文件；点「重启服务以应用」生效。

官方引擎：优先从本镜像站拉取预构建引擎包（镜像过旧时该请求自动触发镜像站后台同步官方最新版），失败时回退 npm registry；更新安装到用户目录，重启服务即启用。
桌面版：更新检查绑定本站 feed.json，发现新版本可在应用内直接下载安装包。

问题	处理
服务一直「启动中」	npx 首次安装需下载依赖，最长 5 分钟；「内置服务 -> 查看日志」确认进度。
图片附件被拒绝	该模型未声明图片输入。在官方「模型」板块为自定义路由声明 `defaultInput: [text, image]`，或选择官方内置视觉模型。
MCP 工具未出现	先「测试连接」确认握手；确认已启用并以注入层重启；stdio 命令需本机可用。
服务报 sharp 模块错误	引擎包解压不完整（更新中断）。重新执行一次「一键更新官方引擎」。
镜像引擎版本落后官方	镜像站访问 `latest.php` 或超 6 小时未同步会自动后台同步（npmmirror -> npmjs 双回退）；也可在管理后台手动同步。

1.4.0：模型与多模态管理回归官方板块（含旧配置自动迁移）；修复账户余额误报与官方用量读取失败；修复模型模态误标；镜像自动跟进官方版本 + 远程发布 API。
1.3.3：内置引擎升级 0.1.1-rc.2；适配官方 --no-open 启动行为。
1.3.2 / 1.3.1 / 1.3.0：多模态对话流集成、账户与用量板块、Skill/MCP 可视化管理、更新通道绑定镜像站、插件中文注解、图片灯箱增强。