# 深度文档

**Repository Path**: deepin20/DeepDoc

## Basic Information

- **Project Name**: 深度文档
- **Description**: DeepDoc – 深度文档：DeepSeek 桌面客户端，支持聊天、Markdown 渲染，一键导出标准公文 Word 文档。专为 **Deepin 25** 不可变系统优化，也兼容其他 Linux 发行版。
- **Primary Language**: Python
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-08-07
- **Last Updated**: 2026-08-28

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# DeepDoc – 深度文档

DeepSeek 桌面客户端，支持聊天、Markdown 渲染，一键导出标准公文 Word 文档。  
专为 **Deepin 25** 不可变系统优化，也兼容其他 Linux 发行版。

[![Python 3.8+](https://img.shields.io/badge/python-3.8+-blue.svg)](https://www.python.org/)
[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
[![Deepin 25](https://img.shields.io/badge/Deepin-25-0078D7?logo=deepin&logoColor=white)](https://www.deepin.org/)

---

## 📸 界面预览

（此处可放置截图，例如主窗口、设置对话框、导出面板等）

---

## ✨ 功能特性

- **💬 AI 对话**：基于 DeepSeek API，支持流式输出、联网搜索（可选）。
- **📄 Markdown 渲染**：聊天消息支持标题、列表、代码块、表格、粗体/斜体等。
- **📁 会话管理**：新建/切换/重命名/删除会话，自动生成标题，支持搜索过滤。
- **📤 一键导出 Word**：会话内容可导出为符合公文规范的 `.docx` 文档，支持三种模板（标准报告、代码风格、学术格式），可导出整个会话或当前单条回复。
- **🔐 安全存储**：API Key 使用系统密钥环（keyring）加密存储，并本地加密备份。
- **🎨 深色/浅色主题**：支持一键切换，适配不同使用环境。
- **🖥️ 系统托盘**：后台运行，双击托盘显示窗口。
- **🌐 中文输入**：已适配 fcitx5，开箱即用（Deepin 25 完美支持）。

---

## 📦 安装方式

### 方式一：使用 Debian 包（推荐 Deepin 25）

1. **下载 `.deb` 包**（或自行构建）。
2. **安装**：
   ```bash
   sudo dpkg -i deepdoc_1.3.0_all.deb
   ```
   安装过程会自动：
   - 将源码复制到 `/opt/deepdoc`
   - 创建 Python 虚拟环境 `/opt/deepdoc/venv` 并安装所有依赖
   - 创建系统级启动命令 `deepdoc`
   - 添加桌面快捷方式

3. **启动**：在终端输入 `deepdoc` 或从应用菜单点击图标。

### 方式二：从源码运行（适用于开发/测试）

```bash
git clone https://github.com/yourname/deepdoc.git
cd deepdoc
# 安装依赖（推荐使用虚拟环境）
pip install -r requirements.txt
# 运行
./run.sh   # 自动设置输入法环境变量
```

---

## 🚀 首次使用配置

1. 启动 DeepDoc 后，点击右上角 **⚙️ 设置**。
2. 填入您的 **DeepSeek API Key**（可从 [DeepSeek 平台](https://platform.deepseek.com/) 获取）。
3. 选择模型（默认 `deepseek-chat`），开启/关闭联网搜索，切换主题。
4. 保存设置，即可开始对话。

---

## 🧑‍💻 使用指南

### 基本操作
- **新建会话**：点击左侧「新建会话」按钮，输入名称。
- **发送消息**：在底部输入框中输入内容，按 `Enter` 发送（`Shift+Enter` 换行）。
- **切换会话**：点击左侧列表中的任一会话。
- **重命名/删除**：在会话列表上右键单击。
- **导出文档**：点击输入栏的「📄 导出▼」，选择范围和模板，点击「立即导出」。

### 联网搜索
- 点击输入栏的「🌐 智能搜索」按钮（开启后高亮），后续消息将启用联网搜索（需 API 支持）。

---

## 🛠️ 开发与构建

### 构建 Debian 包
项目提供了自动打包脚本 `build-deb.sh`，一键生成适用于 Deepin 25 的 `.deb` 包：
```bash
chmod +x build-deb.sh
./build-deb.sh
```
生成的 `.deb` 位于上级目录。

### 项目结构
```
deepdoc/
├── deepdoc/           # 源码主目录
│   ├── api/           # DeepSeek API 客户端
│   ├── export/        # Word 导出模块
│   ├── session/       # 会话数据库管理
│   ├── widgets/       # PyQt5 界面组件
│   ├── utils/         # 工具函数
│   ├── assets/        # 图标、样式、翻译
│   ├── app.py         # 主窗口
│   ├── config.py      # 配置管理（支持密钥环加密）
│   └── main.py        # 程序入口
├── data/              # 运行时数据（配置、日志、数据库）
├── debian/            # Debian 打包配置
├── tests/             # 单元测试
├── requirements.txt   # Python 依赖
├── run.sh             # 启动脚本（含输入法修复）
├── build-deb.sh       # 自动打包脚本
└── deepdoc.desktop    # 桌面快捷方式模板
```

---

## ❓ 常见问题 (FAQ)

**Q：启动后无法输入中文？**  
A：DeepDoc 的 `run.sh` 已自动设置输入法环境变量。若手动启动，请确保 `QT_IM_MODULE=fcitx5` 且已安装 `fcitx5-frontend-qt5`。

**Q：如何更新 DeepDoc？**  
A：重新构建并安装新版 `.deb` 即可（用户数据保留）。

**Q：导出的 Word 文档样式不对？**  
A：请检查导出的模板选择（标准报告、代码风格、学术格式），不同模板的字体、行距不同。

**Q：API Key 无效或 401 错误？**  
A：确认密钥正确且无多余空格，检查模型名称是否与账户权限匹配。

---

## 🤝 贡献

欢迎提交 Issue 和 Pull Request。请确保代码风格符合 PEP 8，并为新增功能编写测试。

---

## 📄 许可证

本项目采用 [MIT 许可证](LICENSE)。

---

## 🙏 致谢

- [DeepSeek](https://deepseek.com/) – 提供强大的大语言模型 API
- [PyQt5](https://www.riverbankcomputing.com/software/pyqt/) – 优秀的 Qt 绑定
- [python-docx](https://python-docx.readthedocs.io/) – Word 文档生成库

---

**立即开始您的 AI 文档之旅吧！** 🚀