# desktop

**Repository Path**: fhyabbs/desktop

## Basic Information

- **Project Name**: desktop
- **Description**: 锁屏软件 自动监控锁屏
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-07-03
- **Last Updated**: 2026-07-05

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# ParentGuard

Windows 桌面 + 云后端的家长游戏监控软件。

## 当前状态 (2026-07-04)

MVP 全流程已打通：客户端 + 后端 + 家长后台。处于内测发布前夜。安装包需要宿主环境安装 Inno Setup 6 后执行一键构建（见 [M6.1](#m6-打磨)）。

| 里程碑 | 状态 | 说明 |
|--------|------|------|
| M0 基础设施 | ✅ 完成 | git, CI, docker-compose, Python 项目骨架 |
| M1 后端骨架 + 协议 | ✅ 完成 | FastAPI + SQLAlchemy + JWT auth + 设备管理 + 家长登录 |
| M2 客户端 | ✅ 完成 | .NET 8 WPF 客户端：MonitorLoop + 锁屏 + 心跳 + 看门狗命名管道 |
| M3 AI 接入 | ✅ 完成 | QwenVLMax + DeepSeekVL2 + ModelRouter + checkin AI 集成 |
| M4 白名单 + 反馈 | ✅ 完成 | 客户端白名单同步 + 误判反馈 + 邮件通知 + 家长后台审阅 |
| M5 防卸载 + 看门狗 | ✅ 完成 | 开机启动 HKCU + 计划任务回退 + Watchdog 进程复活 + 心跳管道 |
| M6 打磨 | ✅ 完成 | Inno Setup 安装脚本 + SMTP 邮件通知 + Events/AISettings 页 + 本 README/Release Notes |

**测试统计:**

| 子项目 | 通过 | 跳过 | 总耗时 |
|--------|------|------|--------|
| `server/` | 37 | 2 | ~100s |
| `client/` (ParentGuard.Shared.Tests) | 33 | 0 | < 1s |
| `admin-web/` | vite build 通过 | — | ~1.5s |

## 子项目

- `client/` —— 孩子电脑 Windows 客户端（.NET 8 + WPF + Watchdog）
- `server/` —— 云后端 FastAPI (Python 3.12 + Postgres + Redis)
- `admin-web/` —— 家长管理后台 React 18 + Vite 5 + Tailwind 3
- `docs/superpowers/specs/` —— 设计 spec
- `docs/superpowers/plans/` —— 6 周 MVP 实施规划 (~52 tasks)
- `docs/superpowers/RELEASE-NOTES.md` —— 版本发布说明
- `.superpowers/sdd/` —— 各里程碑完成报告

## 启动开发环境

```bash
./scripts/dev-up.sh                # 起 postgres/redis
cd server  && bash scripts/run.sh   # 后端 :8000
cd admin-web && bash scripts/run.sh # 前台 :5173
cd client && bash scripts/run-client.sh  # 客户端（被监控电脑）
```

## 快速测试

```bash
bash server/scripts/test.sh        # 后端 pytest
bash client/scripts/test.sh        # 客户端 dotnet test
bash admin-web/scripts/build.sh    # 前端 vite build
```

## 构建发布产物

```bash
# 仅在已安装 Inno Setup 6 的 Windows 主机执行
cd client && bash scripts/build-release.sh
# 产物: client/dist/ParentGuard-Setup-0.1.0.exe
```

## M6 打磨

| 子任务 | 状态 | 提交 | 说明 |
|--------|------|------|------|
| M6.1 Inno Setup 安装包 | ✅ | `1e196d3` | `client/installer/setup.iss` + `client/scripts/build-release.sh` 一键发布 |
| M6.2 邮件通知 | ✅ | `ce71cdf` | `app/core/emailer.py` SMTP 发送，未配置时安全跳过 + 4 测试 |
| M6.3 测试覆盖 + Events/AISettings 页 | ✅ | `fa650b1` | 9 个 admin 接口测试 + 既有 Events/AISettings 页对接 `/admin/events` 与 `/admin/ai/config` |
| M6.4 README + Release Notes | ✅ | — | 本文件 + `docs/superpowers/RELEASE-NOTES.md` |

## 端到端验证

`D:\tmp\m4-e2e.ps1` + `D:\tmp\seed-e2e.py` 提供完整 E2E 冒烟：注册家长 → 客户端注册设备 → 触发锁屏 → 提交误判反馈 → 家长后台审阅 → 解除白名单。

详细设计参见 `docs/superpowers/specs/2026-07-03-game-screen-lock-design.md`。
实施规划参见 `docs/superpowers/plans/2026-07-03-game-screen-lock.md`。
发布说明参见 `docs/superpowers/RELEASE-NOTES.md`。