# OpsChat-Deepin

**Repository Path**: helloworldpxy/OpsChat-Deepin

## Basic Information

- **Project Name**: OpsChat-Deepin
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: GPL-3.0
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-08-20
- **Last Updated**: 2026-08-20

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# OpsChat For Deepin

> 基于 deepin Skills 开发的智能运维 Agent 桌面集成方案

## 项目简介

OpsChat For Deepin 是 [OpsChat 智能运维 Agent](https://github.com/helloworldpxy/OpsChat) 的 deepin 桌面环境深度集成版本。通过 deepin Skills 开发框架，实现了系统托盘、快捷面板、控制中心、桌面通知、DConfig 配置等原生集成，为 deepin/UOS v25 用户提供无缝的智能运维体验。

### 核心特性

- **系统托盘插件**：实时显示服务状态，一键启停、打开浏览器、查看审计日志
- **快捷面板**：Dock 快捷面板显示 OpsChat 状态和快捷操作
- **控制中心模块**：在系统设置中管理 OpsChat 服务和配置
- **桌面通知**：高危操作审批请求、服务状态变更实时通知
- **DConfig 配置**：遵循 deepin 配置规范，支持系统级配置管理
- **Systemd 服务**：开机自启、崩溃自动重启
- **开机自启动**：登录后自动启动客户端和后台服务
- **单实例管理**：防止多开，确保唯一运行实例
- **自动更新检查**：定期检查 GitHub 新版本
- **崩溃报告**：异常捕获和报告

## 技术栈

| 组件 | 技术方案 |
|------|----------|
| 客户端框架 | DTK6 + Qt6 WebEngine |
| 托盘插件 | PluginsItemInterfaceV2 (dde-tray-loader) |
| 快捷面板 | PluginsItemInterfaceV2 (dde-shell) |
| 控制中心 | DCC Factory (dde-control-center) |
| 配置管理 | DConfig |
| 通知系统 | D-Bus / notify-send |
| 服务管理 | systemd user service |

## 项目结构

```
OpsChat-Deepin/
├── backend/                     # Python 后端集成
│   ├── notifications.py         # 桌面通知模块
│   ├── dconfig.py              # DConfig 配置管理
│   ├── dbus_service.py         # D-Bus 服务接口
│   ├── single_instance.py      # 单实例管理
│   ├── log_viewer.py           # 日志查看器
│   ├── config_backup.py        # 配置备份/恢复
│   ├── multi_server.py         # 多服务器管理
│   ├── theme_manager.py        # 主题管理
│   └── api/config.py           # 配置管理 API
├── desktop-client/              # DTK 客户端
│   ├── CMakeLists.txt          # 主构建配置
│   ├── src/                    # 客户端源码
│   │   ├── main.cpp
│   │   ├── webview.h
│   │   └── webview.cpp
│   ├── tray-plugin/            # 托盘插件
│   │   ├── CMakeLists.txt
│   │   ├── opschat-trayplugin.h
│   │   └── opschat-trayplugin.cpp
│   ├── quick-panel/            # 快捷面板
│   │   ├── CMakeLists.txt
│   │   ├── opschat-quickpanel.h
│   │   └── opschat-quickpanel.cpp
│   ├── control-center/         # 控制中心模块
│   │   ├── CMakeLists.txt
│   │   ├── opschat-ccmodule.h
│   │   └── opschat-ccmodule.cpp
│   ├── effects/                # DTK 窗口特效
│   │   ├── opschat-effects.h
│   │   ├── opschat-effects.cpp
│   │   ├── opschat-shortcut.h
│   │   ├── opschat-shortcut.cpp
│   │   ├── opschat-crashreporter.h
│   │   ├── opschat-crashreporter.cpp
│   │   ├── opschat-updatechecker.h
│   │   └── opschat-updatechecker.cpp
│   ├── systemd/                # systemd 服务
│   │   └── opschat.service
│   ├── autostart/              # 开机自启动
│   │   └── opschat-autostart.desktop
│   ├── dconfig/                # DConfig 元数据
│   │   └── org.opschat.client.json
│   ├── debian/                 # Debian 打包
│   │   ├── control
│   │   ├── rules
│   │   ├── changelog
│   │   ├── compat
│   │   └── install
│   ├── assets/                 # 图标和桌面文件
│   │   ├── opschat.desktop
│   │   └── icons/
│   └── install.sh             # 安装脚本
├── docs/                        # 文档
│   ├── BUILD.md                # 构建文档
│   └── USAGE.md                # 使用文档
├── LICENSE                      # GNU GPL v3
└── README.md                    # 本文件
```

## 快速开始

### 环境要求

- deepin 25 或 UOS V25
- Python 3.10+
- CMake 3.13+
- Qt6 + DTK6 开发库

### 安装

```bash
# 克隆仓库
git clone https://github.com/helloworldpxy/OpsChat-Deepin.git
cd OpsChat-Deepin

# 运行安装脚本
bash desktop-client/install.sh
```

### 使用

1. 启动 OpsChat 后端服务
2. 启动桌面客户端 `opschat-client`
3. 在系统托盘或 Dock 快捷面板中管理服务

## 开发说明

本项目使用了以下 deepin Skills：

- **dtk-development**：DTK 原生应用开发
- **dde-tray-development**：系统托盘插件开发
- **dde-shell-development**：快捷面板插件开发
- **dde-control-center-development**：控制中心模块开发

## 许可证

本项目采用 [GNU General Public License v3.0 (GPL v3)](LICENSE) 许可证。

GPL v3 是自由软件许可证，允许您自由地：

- **使用**：以任何目的使用本软件，包括商业用途
- **复制与分发**：自由复制和分发本软件
- **修改与再分发**：修改本软件并分发修改后的版本，但必须：
  - 保留版权声明和许可证声明
  - 以 GPL v3 协议开源分发，并提供完整的源代码
  - 遵循 GPL v3 全部条款（Copyleft 条款）

详细条款请参阅 [LICENSE](LICENSE) 文件，或访问 <https://www.gnu.org/licenses/gpl-3.0.html>。

## 致谢

- [deepin Skills](https://github.com/linuxdeepin/deepin-skills)
- [OpsChat](https://github.com/helloworldpxy/OpsChat)
- deepin 社区