# 安装与卸载

本插件是一个本地 DSH bundle，**不需要构建，也没有运行时 npm 依赖**。推荐优先使用 DSH Desktop 的插件管理；如果当前版本没有“从本地目录安装”入口，按下面的手动方式链接到 `desktop` profile。

测试环境：**DeepSeek Harness Desktop 0.2.1-rc.3 / Windows**。桌面版需要自带右侧栏与 Electron `webview`。

## 准备

把仓库放在一个稳定路径，例如：

```text
C:\Users\<you>\plugins\dsh-deepseek-web-dock
```

或：

```text
/Users/<you>/plugins/dsh-deepseek-web-dock
```

确认目录中直接存在：

```text
index.js
client.js
cordis.patch.yml
package.json
```

## 方式 A：插件管理

1. 打开 DSH Desktop → 设置 → 插件。
2. 选择“从本地目录安装”或等价的安装入口。
3. 选择仓库根目录（包含 `package.json` 的那一层）。
4. 等待安装完成，然后完全退出并重新启动 DSH Desktop。

安装器会把依赖写入 profile 的 `package.json` / lockfile，并创建 `node_modules` 链接。

## 方式 B：手动链接

`DSH_HOME` 默认是：

```text
Windows: %USERPROFILE%\.dsh
macOS/Linux: ~/.dsh
```

profile 目录为：

```text
<DSH_HOME>/profiles/desktop
```

### 1. 创建 node_modules 链接

Windows（目录联接，不需要管理员权限）：

```powershell
$target = "C:\path\to\dsh-deepseek-web-dock"
$link = "$env:USERPROFILE\.dsh\profiles\desktop\node_modules\@local\dsh-deepseek-web"

New-Item -ItemType Directory -Force (Split-Path $link) | Out-Null
New-Item -ItemType Junction -Path $link -Target $target
```

macOS / Linux：

```bash
mkdir -p ~/.dsh/profiles/desktop/node_modules/@local
ln -s /path/to/dsh-deepseek-web-dock \
  ~/.dsh/profiles/desktop/node_modules/@local/dsh-deepseek-web
```

### 2. 注册依赖与 bundle

编辑：

```text
<DSH_HOME>/profiles/desktop/package.json
```

加入依赖：

```json
{
  "dependencies": {
    "@local/dsh-deepseek-web": "link:C:/path/to/dsh-deepseek-web-dock"
  }
}
```

并加入 bundle 列表：

```json
{
  "dsh": {
    "profile": {
      "bundles": [
        "@deepseek-ai/dsh-base",
        "@deepseek-ai/dsh-web-app",
        "@local/dsh-deepseek-web"
      ]
    }
  }
}
```

保留 profile 中原有的其他条目，不要覆盖整个文件。

### 3. 重启

完全退出 DSH Desktop（不是只关到托盘），再重新打开。按钮应出现在左侧「工作区」标题上方。

> 如果之后用 DSH 的插件管理安装/卸载其他插件，包管理器可能会重建 `node_modules`。届时重新安装本插件或重新创建链接即可。

## 验证

- 左侧「工作区」上方出现 **DeepSeek 网页版** 按钮。
- 单击：半屏右侧栏。
- 双击（175 ms 内）：全屏。
- Esc：以原生收起动画关闭。
- 首次打开能在网页里登录 DeepSeek。

如果使用普通浏览器打开 DSH Web，按钮会显示为禁用状态；这是预期行为。

## 卸载

1. 从 profile 的 `dsh.profile.bundles` 移除 `@local/dsh-deepseek-web`。
2. 从 profile 的 `dependencies` 移除对应项。
3. 删除 `node_modules/@local/dsh-deepseek-web` 链接。
4. 完全退出并重启 DSH。

可选：清除网页登录缓存：

```js
localStorage.removeItem('dsh.deepseek-web.auth.v1')
```

在 DSH 的开发者工具中执行即可。该操作只删除插件保存的网页登录恢复信息。

## 常见问题

**按钮没有出现**

- 确认 DSH Desktop 版本支持右侧栏和 `webview`。
- 确认 `dsh.profile.bundles` 包含 `@local/dsh-deepseek-web`。
- 确认 `node_modules/@local/dsh-deepseek-web/package.json` 可读。
- 完全退出并重启 DSH。
- 查看客户端控制台中的插件加载错误。

**Windows 上链接失败**

目录联接（Junction）通常不需要管理员权限；如果路径存在，先删除旧链接再创建。不要删除目标源码目录。

**右侧栏空白**

- 检查网络是否可访问 `https://chat.deepseek.com/`。
- 确认不是浏览器环境。
- 关闭右栏再重新打开，让插件重新申请 guest。

**登录状态未恢复**

重新登录一次。DeepSeek 可能调整了 `userToken` / `__appKit_userInfo` 的结构，插件会在恢复失败时提示。