从电脑到手机：DeepSeek Harness Windows安装与手机互动教程（避坑完全版）

DeepSeek Harness（简称dsh）是DeepSeek开源的AI Agent运行框架，主打"一切皆插件"的设计理念，可以自由组装出专属的AI助手。它支持通过插件与Android手机互动------你可以把电脑上运行的DSH"搬"到手机上，甚至用对话直接定制手机端的界面。

⚠️ 开篇重要提醒

dsh-mobile插件目前为Alpha测试版本，可能随DSH主程序更新出现兼容性问题，如遇报错可回退DSH版本或等待插件更新。

所有配对和互动仅限家庭/办公可信局域网，切勿将DSH服务直接暴露公网。

插件为社区非官方项目，使用前请知晓风险。

一、准备工作

项目	要求
操作系统	Windows 10/11
网络	能访问GitHub、npm，以及DeepSeek开放平台
DeepSeek账号	已在platform.deepseek.com注册并开通API，准备好API Key（以`sk-`开头）
手机	Android手机，与电脑连接在同一Wi-Fi局域网下

二、在Windows上安装DeepSeek Harness

DSH的安装主要有三种方式，强烈推荐方式三（桌面版）给不想折腾命令行的朋友。

方式一：npx一键启动（最快捷，但需保持终端开启）

1. 安装Node.js（含国内镜像配置）

到nodejs.org下载安装Node.js 22.19.0或更高版本（推荐24.x）。

💡 如果本机已有旧版Node.js ：推荐用nvm-windows管理多版本。
下载安装nvm-windows
管理员身份打开PowerShell，执行：

powershell
复制代码
nvm install 22.19.0
nvm use 22.19.0
（以后可用nvm list查看已安装版本）

安装完成后，打开命令提示符（Win+R输入cmd），先切换国内镜像源（重要！否则下载极慢甚至失败）：

powershell

复制代码

npm config set registry https://registry.npmmirror.com

然后验证版本：

powershell

复制代码

node -v
# 应显示 v22.19.0 或更高
npm -v

2. 一键启动DSH

在命令提示符中直接运行：

powershell

复制代码

npx @deepseek-ai/dsh web

首次运行会自动下载依赖（已换国内源，速度会快很多），稍等片刻，终端会显示：

text

复制代码

dsh web: http://127.0.0.1:3080

浏览器会自动打开http://127.0.0.1:3080，这就是DSH的Web界面。

⚠️ 致命提醒 ：这个终端窗口绝对不能关闭 ，关闭则服务立刻终止。如果关掉了，重新执行上述命令即可。如果需要后台常驻，请直接用下面的方式三（桌面版）。

方式二：从源码安装（适合想深度定制）

如需修改源码或使用最新开发版：

powershell

复制代码

# 1. 克隆源码（国内慢可以用代理）
git clone https://gh-proxy.com/https://github.com/deepseek-ai/deepseek-harness.git
cd deepseek-harness

# 2. 安装pnpm（如果还没有）
npm install -g pnpm

# 3. 安装依赖并构建
pnpm install
pnpm run build

# 4. 启动
pnpm dsh web

方式三：社区桌面版（无需命令行，推荐纯小白）

如果完全不想碰命令行，社区已有打包好的桌面版。

下载指引：

前往GitHub搜索仓库 deepseek-harness-oneclick-pack 或 deepseek-harness-desktop
进入其 Releases 页面，下载最新的 DeepSeek-Harness-Setup.exe 或 .zip 包
解压后双击 DeepSeek Harness.exe 即可运行（支持后台常驻，关闭窗口服务仍在）

三、首次启动配置：API Key和工作区

无论用哪种方式启动，首次进入Web界面后都需要两步配置：

1. 配置API Key

点击左下角的设置（Settings） → 模型（Models），填入你的DeepSeek API Key并保存。

⚠️ API Key在DeepSeek开放平台创建后只显示一次 ，请务必立即复制保存，关闭页面后无法再次查看，只能重新生成。

2. 选择工作区（Workspace）

点击"Choose workspace"，选择一个电脑上的文件夹------这是AI可以访问和操作的文件目录，AI不会碰你电脑的其他地方。必须选择工作区，否则输入框可能不可用。

四、让手机与DSH互动（重点！内附高频踩坑全解）

DSH本身运行在电脑上（地址是127.0.0.1:3080），手机要访问它，需要通过插件实现局域网连接。

方案一：DSH Mobile插件（扫码配对，推荐）

这是一个社区插件，可以让手机通过局域网安全地连接电脑上的DSH，所有会话和工作区实时同步。

安装步骤：

第1步：在DSH中安装插件

保持DSH运行状态，另开一个终端执行：

powershell

复制代码

dsh plugin --profile web add dsh-mobile@alpha

⚠️ 版本兼容提醒 ：dsh-mobile@alpha为测试版，仅适配特定DSH rc版本。如果DSH主程序近期更新后插件报错，可尝试：

回退DSH版本至与插件兼容的旧版

等待插件作者发布新版

查看插件GitHub Issue了解最新适配情况

第2步：安装完成后，必须重启DSH服务！

如果用的是npx方式 ：按Ctrl+C终止终端进程，然后重新执行npx @deepseek-ai/dsh web
如果用的是桌面版：完全退出程序（右键系统托盘图标退出），再重新打开

⚠️ 不重启，左下角不会出现"移动访问"入口，这是新手最高频的翻车点！

第3步：刷新浏览器页面，左下角会出现"移动访问"入口，点击打开。

第4步：在Android手机上安装配套App

⚠️ App未上架应用商店，需手动安装APK：

在GitHub搜索仓库 saya-ch/dsh-mobile，进入其 Releases 页面

下载最新的 dsh-mobile.apk 文件

在手机设置 → 安全 中，开启"允许安装未知来源应用"（不同品牌路径略有差异，一般在"安装未知应用"中允许文件管理器安装）

打开下载的APK文件完成安装

第5步：扫码配对

在电脑DSH的"移动访问"面板中，点击"生成并复制密钥"或"复制配对链接"，面板会显示二维码
打开手机上的DSH Mobile App，点击"扫码配对"，扫描电脑屏幕上的二维码
配对成功后，手机App会记住这台电脑，下次自动连接

⚠️ Windows防火墙拦截（高频翻车点）！

如果手机扫码后一直连接超时，99%是Windows防火墙拦截了通信端口（3080）。解决方法：
打开控制面板 → Windows Defender 防火墙 → 允许应用或功能通过Windows Defender防火墙

点击**"更改设置"** → "允许其他应用"

浏览找到 C:\Program Files\nodejs\node.exe（或桌面版exe），添加并勾选**"专用"**（即家庭/工作网络）
如果用的是npx方式，也可以直接用管理员身份运行PowerShell执行：

powershell
复制代码
New-NetFirewallRule -DisplayName "DSH 3080" -Direction Inbound -LocalPort 3080 -Protocol TCP -Action Allow
添加后手机再次扫码即可正常连接

🔒 安全提醒

配对后的手机拥有操作电脑DSH的全部权限（读写工作区文件、调用工具等）

严禁在公共Wi-Fi（商场、咖啡馆、机场）进行扫码配对或使用

仅限家庭或公司可信局域网内使用

用完后可在DSH的"移动访问"面板中撤销配对密钥

第6步：开始使用

手机App上就能看到和电脑端完全同步的会话、工作区和工具，可以在沙发上继续电脑上没聊完的AI对话。

第7步（可选）：用对话定制手机界面！

在DSH对话中输入 /mobile 把手机端界面改成深色极简风格，按钮都放大，AI会直接修改手机端的样式文件，几秒内刷新生效。

⚠️ 此功能为Alpha测试特性，偶发样式不生效，可重启DSH Mobile插件重试。

方案二：通过Tailscale跨网络访问（适合不同Wi-Fi）

如果你想出门在外时用手机访问家里电脑的DSH，可以用Tailscale组一个虚拟局域网。

步骤概要：

电脑和手机都安装Tailscale，登录同一账号
电脑上启动DSH时，绑定Tailscale分配给电脑的IP（注意：不是写0.0.0.0）：

powershell
复制代码
```
npx @deepseek-ai/dsh web --trusted-host <Tailscale分配给电脑的IP>
```
例如电脑Tailscale IP是100.100.100.1，则填--trusted-host 100.100.100.1
手机上安装DSH Mobile for Android（支持Tailscale的版本），输入电脑的Tailscale IP加端口3080（如100.100.100.1:3080）即可连接

⚠️ 仍要检查Windows防火墙：Tailscale通信同样会被防火墙拦截，需要用上面第5步的方法放行端口3080

🔒 安全红线 ：仅限Tailscale虚拟局域网内访问，绝对不要把3080端口映射到公网路由器！ 否则任何人都可能访问你的DSH，读取工作区文件。

五、关于"DSH控制手机"能力的说明

目前社区暂无成熟可直接安装的、用于Agent反向控制Android手机（点击/截图/打开App等）的官方插件 。此前网络流传的dsh-android-agent包在npm仓库中并不存在，属于不实信息。相关能力尚处于概念开发阶段，请勿轻信非官方渠道的安装包。

总结：全流程避坑速查表

步骤	操作	难度	⚠️ 关键坑提醒
1	安装Node.js 22.19+	⭐	国内务必`npm config set registry https://registry.npmmirror.com`；旧系统用nvm-windows管理版本
2	启动DSH（npx / 桌面包）	⭐	npx方式不要关闭终端窗口，关了就断；桌面版可后台常驻
3	配置API Key、选择工作区	⭐	API Key只显示一次，立即保存；必须选工作区输入框才可用
4	安装dsh-mobile插件，重启DSH服务	⭐⭐	不重启服务、不刷新网页，左下角不会出现移动访问入口 ------ 新手翻车率100%
5	Android安装APK并扫码配对	⭐⭐	APK需从GitHub Releases手动下载；手机需开启"允许安装未知来源应用"；Windows防火墙会拦截，需手动放行3080端口；仅限家庭可信Wi-Fi
6（可选）	`/mobile`命令自定义手机界面	⭐⭐	Alpha版本偶发样式不生效，重启插件重试
7（可选）	Tailscale异地访问	⭐⭐⭐	用`--trusted-host <Tailscale IP>`，不能写0.0.0.0 ；仍要防火墙放行端口；严禁公网暴露

收尾提醒：DSH Mobile插件目前仍为Alpha测试阶段，如遇兼容性问题请保持耐心，关注插件GitHub仓库的动态更新。祝你在电脑和手机之间玩得开心！