# ai-workspace-copilot

**Repository Path**: ahrli/ai-workspace-copilot

## Basic Information

- **Project Name**: ai-workspace-copilot
- **Description**: 一个将 DeepSeek、元宝、通义千问等 AI 网页接入本地文件工作区的桌面编程助手，支持文件浏览、内容编辑、上下文注入与 Diff 审阅应用。
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 7
- **Forks**: 0
- **Created**: 2026-08-12
- **Last Updated**: 2026-09-02

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# AI Workspace Copilot

一个将 AI 网页接入本地文件工作区的 Windows 桌面编程助手。它把文件浏览、代码与常用 Office 文档编辑、上下文注入和 Diff 审阅放进同一个工作台，减少在编辑器、文件管理器和浏览器之间切换的成本。

> 当前版本内嵌的是 **DeepSeek 网页**。元宝、通义千问等服务尚未接入，计划在后续版本中支持。

![本地工作区与 DeepSeek 协作示意](docs/images/workspace-ai-assistant.png)

## 功能

- 打开本地文件夹，以树状目录浏览项目；支持按文件名搜索、新建文件/文件夹和在资源管理器中定位。
- 在多标签工作区阅读和编辑代码、文本文件；支持自动保存与手动保存。
- 预览并编辑 `.docx`、`.pptx`、`.xlsx` 文件。PPTX 在安装 Microsoft PowerPoint 时会优先使用其渲染结果，否则使用内置的简略预览。
- 选择代码或文档中的文字，一键连同文件路径发送到内嵌的 DeepSeek 对话页。
- 在文件树中多选文件，将文件内容作为上下文加入对话。
- 通过 **Gen code** 为 AI 追加统一的代码修改指令；将 AI 返回的 Diff 放入审阅窗口，比较后可选择应用部分或全部改动。
- 三栏布局可拖动调整宽度，DeepSeek 登录状态会在本机保留。

> Office 文档功能面向内容查看和轻量编辑，不追求与专业 Office 软件相同的排版或全部格式兼容性。

## 快速开始：从 Release 下载

适合只想直接使用的 Windows 用户，不需要安装 Node.js。

1. 进入 [Releases 页面](https://gitee.com/ahrli/ai-workspace-copilot/releases)，下载最新版本的 Windows 压缩包。
2. 将压缩包解压到任意本地目录；不要在压缩包内直接运行程序。
3. 进入解压后的目录，双击 `DeepSeek Desktop.exe` 启动。
4. 第一次使用时，在右侧 DeepSeek 页面登录自己的账号。
5. 点击左上角 **打开文件夹**，选择需要协作的本地项目目录。

> 若 Windows 弹出安全提示，请确认下载来源为本项目的 Gitee Release 后再选择运行。

## 使用指南

### 1. 打开与管理工作区

点击 **打开文件夹** 选择项目根目录。左侧会显示文件树：

- 用搜索框筛选文件名。
- 右键文件或文件夹，可新建、删除、在资源管理器中显示，或将选中的文件加入对话。
- 按住 `Ctrl` / `Cmd` 可多选文件；按住 `Shift` 可连续选择。

### 2. 编辑文件与 Office 文档

单击文件即可在中间区域打开标签页。代码和文本支持自动保存；也可点击 **Save** 或使用 `Ctrl + S` 保存。

`.docx`、`.pptx`、`.xlsx` 会进入文档预览模式。可以查看内容并对支持编辑的内容进行轻量修改，然后通过 **Save** 或 `Ctrl + S` 写回原文件。编辑重要文档前建议先自行备份。

### 3. 向 DeepSeek 提供上下文

右侧是内嵌的 DeepSeek 网页。先完成登录，再按下面任一种方式发送上下文：

- 在中间编辑器选中一段代码或文本，点击 **发送选中代码到 DeepSeek**。
- 在左侧文件树选择一个或多个文件，右键选择加入聊天。
- 点击 **Add Project Tree to Chat**，把项目目录结构发送给 AI，帮助它了解项目组织。

发送内容会附带文件路径或文件名。请避免将密码、Token、私钥或其他敏感信息发送给任何 AI 服务。

### 4. 审阅并应用 AI 给出的 Diff

当你要求 DeepSeek 修改代码时：

1. 点击 **Gen code**，它会向对话输入框追加约定的 Diff 输出指令；可通过 **Setting** 调整该指令。
2. 在 DeepSeek 中手动发送该请求，并等待它以 `diff` 代码块完成回复。
3. 点击 **Review DeepSeek Diff**；应用会读取最新回复中的 Diff，并显示原始内容与建议修改的并排对比。
4. 检查每一项改动后，选择 **Apply Selected** 或 **Apply All Changes**。
5. 保存文件，并运行项目自身的测试或构建命令验证改动。

![Diff 审阅示意](docs/images/diff-review.png)

## 本地开发与打包

### 环境

- Windows 10 / 11
- Node.js 20 或更高版本
- npm

### 开发运行

```powershell
npm install
npm start
```

也可以双击 `start.bat`。

### 构建 Windows 应用

```powershell
npm run package:win
```

或者双击 `package-release.bat`。产物位于 `release-fixed\win-unpacked\DeepSeek Desktop.exe`；打包前请关闭此前运行的该程序，否则 Windows 会因文件被占用而导致打包失败。

`release-fixed/` 是本地构建目录，已被 Git 忽略，不会进入源代码仓库。

## 路线图

- [ ] 支持切换和接入更多 AI 网页服务：元宝、通义千问等。
- [ ] 提供更完善的 Release 打包与发布流程。
- [ ] 扩展更多常用文档格式的预览能力。
- [ ] 持续改进 Office 内容编辑与格式兼容性。

## 说明

本项目是本地桌面工作区工具，与 DeepSeek 或其他 AI 服务提供方并无官方隶属关系。使用第三方 AI 服务时，请遵守相应服务的使用条款和隐私政策。