# DeepSeekHarness桌面版

**Repository Path**: xingganfengxing/deepseekharness

## Basic Information

- **Project Name**: DeepSeekHarness桌面版
- **Description**: DeepSeek Harness 桌面版 —— 免安装 Node.js 的本地 AI 编程助手，开箱即用：内置视觉引擎、文件索引、自动化调度等 5 个插件，附电影式启动动画
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 1
- **Created**: 2026-08-23
- **Last Updated**: 2026-08-23

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# DeepSeek Harness 桌面版

> 本地服务 + Electron 桌面壳的完整 AI 编程助手。安装后双击即用，无需 Node.js、无需命令行，功能与网页端完全一致。

## ✨ 特性

- **开箱即用**：内置 5 个插件，首次启动自动加载，无需手动安装
  - 👁️ **modlens 视觉引擎** — 让纯文本的 DeepSeek 模型「看图」：粘贴图片即读，或切换 `(modlens vision)` 模型后支持拖拽上传
  - 📂 **dsh-at-file** — 工作区文件路径索引
  - 🧩 **dsh-better-sidebar** — 增强侧边栏（内置代码编辑器与终端）
  - ⏰ **dsh-automation** — 自动化任务调度
  - 🎨 **dsh-genui** — 交互式 UI 组件生成
- 🎬 **电影式启动动画**：加载 → 点击进入 → 粒子线上下拉开带出主界面
- 🛡️ **安全隔离**：每位系统用户独立数据目录，遥测默认关闭
- 🔄 **崩溃自愈**：本地服务异常自动重启

## 📦 安装

**系统要求**：Windows 10/11 x64

**安装包分卷下载**（Gitee 单文件上限 100MB，安装包拆为 2 个分卷）：

| 文件 | 说明 |
| :-- | :-- |
| `DeepSeek-Harness-Setup-0.1.0.exe.part1` | 分卷 1（约 90 MB） |
| `DeepSeek-Harness-Setup-0.1.0.exe.part2` | 分卷 2（约 82 MB） |

**合并方法（任选其一）**：

```
# Windows 命令行（cmd）
copy /b DeepSeek-Harness-Setup-0.1.0.exe.part1 + DeepSeek-Harness-Setup-0.1.0.exe.part2 DeepSeek-Harness-Setup-0.1.0.exe

# PowerShell
Get-Content -Path .\*.part1, .\*.part2 -Encoding Byte -AsByteStream | Set-Content -Path .\DeepSeek-Harness-Setup-0.1.0.exe -Encoding Byte -AsByteStream
```

合并后双击 `DeepSeek-Harness-Setup-0.1.0.exe` 按向导安装（可自定义目录）。覆盖安装旧版不会丢失任何数据（会话、API Key、插件设置均保留）。

## 🚀 快速开始

1. 启动应用，等待启动动画结束进入主界面
2. 进入「设置 → 模型 / API 凭据」，填入 **DeepSeek API Key**（在 [platform.deepseek.com](https://platform.deepseek.com) 创建）
3. 直接对话即可

### 🖼️ 图片上传

| 操作 | 默认模型 | `(modlens vision)` 模型 |
| :-- | :-- | :-- |
| 粘贴图片（Ctrl+V） | ✅ 可用，modlens 自动读图 | ✅ 可用，缩略图保留 |
| 拖拽 / 选择文件上传 | ❌ 提示「当前模型不支持图片」 | ✅ 可用，缩略图保留 |

- 想**拖拽上传图片**：先在模型选择器切到 `(modlens vision)` 条目（如「DeepSeek-V4-Flash (modlens vision)」），选择会被记住
- 不想切换模型：用 **Ctrl+V 粘贴** 发图，任何模型下都可用
- modlens 视觉引擎 Key（千问等）需自行配置：编辑 `C:\Users\<用户名>\.modlens\config.json`（详情见使用手册）

## 📄 使用手册

详见 [DeepSeek-Harness-桌面版使用说明.docx](./DeepSeek-Harness-桌面版使用说明.docx)

## ⚠️ 注意

- 首次使用需自行配置 DeepSeek API Key，Key 仅保存在本机（`%APPDATA%\deepseek-harness-desktop\dsh-home\.credentials.yaml`），不随应用分发
- modlens 视觉引擎的 Key 也由用户自行配置；未配置时有免费回退通道（antigravity-cli）

## 📝 更新日志

**0.1.0（2026-08-15）**

- 首个正式版本
- 内置 5 个插件（modlens 视觉、文件索引、增强侧边栏、自动化调度、UI 生成）
- 电影式启动动画
- 详细使用手册