# 从 GitHub 网页创建并上传

不需要安装 Git。按下面步骤可以在浏览器里创建空仓库并上传整个插件。

## 1. 创建空仓库

1. 打开 <https://github.com/new>。
2. 仓库名建议：`dsh-deepseek-web-dock`。
3. 选择 Public 或 Private。
4. **不要**勾选 “Add a README file”“Add .gitignore”“Choose a license”；这些文件我们已经准备好了。
5. 点击 **Create repository**。

## 2. 解压上传包

把 `dsh-deepseek-web-dock-v1.0.2.zip` 解压，得到：

```text
dsh-deepseek-web-dock/
├── .github/
│   └── workflows/
│       └── check.yml
├── .gitattributes
├── .gitignore
├── CHANGELOG.md
├── GITHUB_WEB_UPLOAD.md
├── LICENSE
├── README.md
├── README.en.md
├── SECURITY.md
├── client.js
├── cordis.patch.yml
├── docs/
│   ├── ARCHITECTURE.md
│   └── INSTALL.md
├── icon.svg
├── index.js
├── package.json
└── scripts/
    └── check.mjs
```

## 3. 上传

1. 在新仓库或现有仓库首页点击 **Add file → Upload files**。
2. 打开解压后的 `dsh-deepseek-web-dock` 文件夹。
3. 选中**文件夹里面的内容**（包括 `.github`、`.gitignore`、`docs`、`scripts` 等），拖到 GitHub 上传区域。
   - 不要拖外层 `dsh-deepseek-web-dock` 文件夹本身，否则仓库里会多一层子目录。
   - 如果文件选择器不显示 `.github`，在 Windows 资源管理器里开启“显示隐藏的项目”，或使用 `Ctrl+A` 全选后拖拽。
4. 在 Commit changes 中填写：

   ```text
   fix: release v1.0.2
   ```

   首次创建仓库也可以写 `feat: initial release`。

5. 选择直接提交到 `main`，点击 **Commit changes**。

> 更新已有仓库时，直接用这个包覆盖同名文件即可；本次没有删除文件。提交后 Actions 会重新运行检查。

## 4. 上传后检查

- 仓库根目录应直接看到 `README.md`、`client.js`、`package.json`。
- **Actions** 标签页应自动运行 `check` workflow，显示绿色通过。
- 在仓库右侧 **About** 填写描述和 topics：

  ```text
  dsh  dsh-plugin  deepseek  deepseek-harness  electron  sidebar  webview
  ```

- 打开 README，确认图片、链接和中文显示正常。

## 常见问题

**上传后多了一层目录**

说明拖入的是外层文件夹。删除多出的目录，重新上传文件夹里面的内容。

**`.github` 或 `.gitignore` 没上传**

Windows 文件选择器可能隐藏了点文件。开启“显示隐藏的项目”后重新选择；也可以在 GitHub 网页手动创建这两个文件，内容直接在仓库中查看。

**Actions 没有运行**

检查 `.github/workflows/check.yml` 是否在仓库根目录，而不是在子目录里。

**文件太多/太大**

本仓库共 17 个文件，远低于 GitHub 网页上传限制；不需要上传 `node_modules`。

## 不要上传

- 本机 `.dsh` profile
- `node_modules`
- 登录 token、`.env`、私钥
- 包含私人会话的截图
- `.git` 目录（网页上传不需要）