常见问题
关于 DeepSeek Harness Desktop v0.2.1 的配置、未签名构建警告、隐私与更新。
DeepSeek Harness Desktop 是什么？
它是官方 DeepSeek Harness 的社区桌面打包层：Tauri 2 壳 + Rust 监督 sidecar + 内置 Node.js 运行时，将未修改的 Harness Web UI 以原生 Windows / macOS 应用形式运行。
需要自己安装 Node.js 或在终端执行命令吗？
不需要。固定版本的 Node.js 运行时内置于应用，监督器会自动启动 Harness；系统里的 Node 环境（如果有）不会被使用。
这是 DeepSeek 官方产品吗？
不是。本项目由 web-casa 社区维护；其中的 DeepSeek Harness 包本身是官方原版且未做修改，本项目只做 pin 版本与打包。
为什么 Windows SmartScreen 或 macOS Gatekeeper 会警告？
当前 v0.2.1 预览版尚未代码签名/公证。请先核对发布的 SHA-256 校验值，然后在 Windows 上选择 更多信息 → 仍要运行；在 macOS 上右键应用选择 打开。
应用会发送遥测或统计数据吗？
会话遥测通过 DSH_TELEMETRY_DISABLED=1 默认关闭；Harness 启动前会消毒 NODE_OPTIONS、npm_config_* 等子进程环境变量。完整安全姿态见安全页面。
应用会自动更新吗？
暂不支持。自动更新将与代码签名/公证一起接入。目前请从 GitHub Releases 下载新版本并核对校验值。
支持哪些平台？
Windows 10/11 x64（NSIS 安装包）与 macOS Apple Silicon（DMG）。Linux 仅作为开发环境，不作为发行目标。
与我自己运行 DeepSeek Harness CLI 有什么区别？
桌面发行版增加了受监督的进程生命周期、崩溃检测与自动重启、隔离的 DSH_HOME 数据目录、隐私默认值与零 IPC 的 webview 边界；Harness 本身行为一致。
DeepSeek Harness Desktop 免费吗？
免费。打包层以 MIT 许可发布；内置的 DeepSeek Harness 及其 npm 依赖保留各自的开源许可证，并随安装包一同分发。
如何报告安全问题？
请通过仓库的 GitHub Security Advisory 流程（Security 标签页 → Report a vulnerability）私密披露，或邮件联系维护者。
我的数据存在哪里？可以备份或迁移吗？
数据位于平台应用数据目录下的 harness/ 子目录，与 CLI 的 ~/.dsh 隔离。应用内“诊断信息”按钮会显示精确路径。备份或迁移前请完全退出应用，再复制该目录；不要用符号链接替换它。
为什么插件安装还不可用？
桌面打包版内置了固定版本的 pnpm 运行时，但经该内置工具链安装插件尚未打通。这是已知边界，将与自动更新一起规划接入。
Harness 端口被占用会怎样？
你无需处理。应用以 --port 0 在 127.0.0.1 启动 Harness，由操作系统在启动时分配一个空闲的随机端口。
如何彻底卸载？
Windows：正常卸载后删除应用数据目录中的 harness/ 文件夹。macOS：将应用拖入废纸篓，然后删除 ~/Library/Application Support/com.yeagoo.dsh-desktop/harness。诊断面板会显示你机器上的精确数据路径。
支持 Intel Mac 或 Windows ARM 吗？
当前版本只发布 Windows x64 与 macOS Apple Silicon 安装包，暂未分发 Intel Mac 与 Windows ARM 构建；请关注发布页的新目标平台。
应用崩溃或反复重启，应该检查什么？
使用应用内“复制诊断信息”按钮复制 JSON 快照，并在提交 GitHub issue 时附上。监督器默认在约 40 秒无心跳后重启 Harness，因此反复重启通常意味着 Harness 事件循环被阻塞。