常见问题
关于 DSH Desktop v0.2.17 的配置、未签名构建警告、隐私与更新。
DSH 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 会警告？
GitHub v0.2.17 预览包尚未代码签名/公证。请先核对发布的 SHA-256 校验值，然后在 Windows 上选择 更多信息 → 仍要运行；在 macOS 上右键应用选择 打开。Microsoft Store 包发布后使用 Store 安装流程。
应用会发送遥测或统计数据吗？
会话遥测通过 DSH_TELEMETRY_DISABLED=1 默认关闭；Harness 启动前会消毒 NODE_OPTIONS、npm_config_* 等子进程环境变量。完整安全姿态见安全页面。
应用会自动更新吗？
单独发行的 Windows 版会检查已签名更新，并在安装前征求确认。Microsoft Store 版关闭该更新器，由 Store 管理包交付与更新；macOS 目前仍需手动更新。
支持哪些平台？
Windows 10/11 x64（NSIS 安装包）与 macOS Apple Silicon（DMG）。Linux 仅作为开发环境，不作为发行目标。
与我自己运行 DeepSeek Harness CLI 有什么区别？
桌面发行版增加了受监督的进程生命周期、崩溃检测与自动重启、隔离的 DSH_HOME 数据目录、隐私默认值与零 IPC 的 webview 边界；Harness 本身行为一致。
DSH Desktop 免费吗？
免费。打包层以 MIT 许可发布；内置的 DeepSeek Harness 及其 npm 依赖保留各自的开源许可证，并随安装包一同分发。
如何报告安全问题？
请通过仓库的 GitHub Security Advisory 流程（Security 标签页 → Report a vulnerability）私密披露，或邮件联系维护者。
我的数据存在哪里？可以备份或迁移吗？
数据位于平台应用数据目录下的 harness/ 子目录，与 CLI 的 ~/.dsh 隔离。应用内“诊断信息”按钮会显示精确路径。备份或迁移前请完全退出应用，再复制该目录；不要用符号链接替换它。
插件安装如何工作？
应用内 Cordis 市场会展示被阻止、弃用或不兼容的条目，但这些条目不会产生安装操作。符合条件的 npm 包会重新拉取详情、校验完整性、禁用构建脚本安装并停留在待激活状态，只有你显式激活后才会运行。Store 版还只允许 cordis.run 已审核包，并拒绝本地侧载。
Harness 端口被占用会怎样？
你无需处理。应用以 --port 0 在 127.0.0.1 启动 Harness，由操作系统在启动时分配一个空闲的随机端口。
如何彻底卸载？
Windows：正常卸载后删除应用数据目录中的 harness/ 文件夹。macOS：将应用拖入废纸篓，然后删除 ~/Library/Application Support/com.yeagoo.dsh-desktop/harness。诊断面板会显示你机器上的精确数据路径。
支持 Intel Mac 或 Windows ARM 吗？
GitHub Releases 当前发布 Windows x64 与 macOS Apple Silicon 包；Microsoft Store 提交还包含原生 Windows arm64 MSIX，只有在 Store 认证并发布后才可获取。暂不分发 Intel Mac 版本。
应用崩溃或反复重启，应该检查什么？
使用应用内“复制诊断信息”按钮复制 JSON 快照，并在提交 GitHub issue 时附上。监督器默认在约 40 秒无心跳后重启 Harness，因此反复重启通常意味着 Harness 事件循环被阻塞。