ScreenLockDetector/QUICKFIX_LOCK_SIGNALS.md

# 锁屏信号问题快速修复指南

## 问题症状

✗ 程序显示"已成功连接到目标系统的服务"  
✗ 但锁屏时 `onSessionLocked()` 没有被调用  
✗ Ubuntu 和 Deepin 系统都有此问题  

## 快速解决方案

### 🚀 一键验证修复

已经重新编译，直接运行验证脚本：

```bash
./verify_fix.sh
```

这个脚本会：
1. 检查编译状态
2. 显示系统环境信息
3. 检测可用的 DBus 服务
4. 启动程序并提示如何测试

### 📋 核心修复内容

#### 修复 1: 动态获取会话路径

**问题**: 原代码使用固定路径 `/org/freedesktop/login1/session/auto`，在大多数系统上不工作

**修复**: 新增方法动态获取实际会话路径

```cpp
QString getCurrentSessionPath() {
    // 从环境变量 XDG_SESSION_ID 获取
    // 或通过 DBus 调用 GetSessionByPID 获取
}
```

#### 修复 2: 广播式信号监听

**问题**: 只监听特定路径的信号

**修复**: 添加空路径监听（监听所有会话）

```cpp
// 监听所有 session 的 Lock/Unlock 信号
QDBusConnection::systemBus().connect(
    "org.freedesktop.login1",
    "",  // 空路径 = 监听所有对象
    "org.freedesktop.login1.Session",
    "Lock",
    this,
    SLOT(onSessionLocked())
);
```

#### 修复 3: 增强调试信息

**问题**: 无法判断问题出在哪个环节

**修复**: 
- 继承 `QDBusContext` 获取信号详情
- 在关键点添加详细日志
- 显示信号的来源路径和接口

## 验证修复是否生效

### 预期的启动日志

```
=================================================
Initializing ScreenLockDetector...
=================================================

--- Connecting to Login Manager (systemd-logind) ---
Session path from XDG_SESSION_ID: /org/freedesktop/login1/session/c1
Current session path: /org/freedesktop/login1/session/c1
Login Manager interface is valid for session: ...
Session Lock signal connected: true      ← ✓ 应该是 true
Session Unlock signal connected: true    ← ✓ 应该是 true

=================================================
ScreenLockDetector initialized successfully
Login Manager connected: true            ← ✓ 至少一个为 true
=================================================
```

### 预期的锁屏日志

当你按 `Super+L` 或 `Ctrl+Alt+L` 锁屏后：

```
##################################################
## LOCK SIGNAL RECEIVED
## Screen is now LOCKED
## DBus Message Details:
##   Service: :1.43
##   Path: /org/freedesktop/login1/session/c1
##   Interface: org.freedesktop.login1.Session
##   Member: Lock
##################################################
```

## 如果还是不工作

### 🔍 调试步骤

#### 步骤 1: 检查实际发送的信号

运行监听脚本：

```bash
./test_lock_signals.sh
```

按提示锁屏/解锁，观察哪些信号被发出。

#### 步骤 2: 手动测试 DBus

在一个终端运行：

```bash
dbus-monitor --system "type='signal',interface='org.freedesktop.login1.Session'"
```

在另一个终端锁屏：

```bash
# GNOME/Ubuntu
gnome-screensaver-command -l

# 或通用方法
loginctl lock-session

# Deepin
dde-lock
```

观察是否有 `Lock` 信号出现。

#### 步骤 3: 检查会话状态

```bash
# 查看会话 ID
echo $XDG_SESSION_ID

# 查看会话详情
loginctl show-session $XDG_SESSION_ID

# 列出所有会话
loginctl list-sessions
```

确保你的会话是活动的，类型是 `x11` 或 `wayland`。

#### 步骤 4: 检查权限

```bash
# 当前用户的组
groups

# 测试是否能访问 systemd-logind
dbus-send --system --print-reply \
    --dest=org.freedesktop.login1 \
    /org/freedesktop/login1 \
    org.freedesktop.DBus.Introspectable.Introspect
```

### 🔧 特定系统的额外步骤

#### Ubuntu / GNOME 系统

如果 systemd-logind 不工作，检查 GNOME ScreenSaver：

```bash
# 检查服务是否存在
dbus-send --session --print-reply \
    --dest=org.gnome.ScreenSaver \
    /org/gnome/ScreenSaver \
    org.freedesktop.DBus.Introspectable.Introspect

# 监听 GNOME 信号
dbus-monitor --session "interface='org.gnome.ScreenSaver'"

# 锁屏
gnome-screensaver-command -l
```

#### Deepin 系统

运行 Deepin 专用调试脚本：

```bash
./debug_deepin_dbus.sh
```

这会显示所有可用的 Deepin 锁屏服务，然后实时监听信号。

常见的 Deepin 服务名：
- `com.deepin.dde.lockFront`
- `org.deepin.dde.lockFront`
- `com.deepin.ScreenSaver`

#### Wayland 会话

Wayland 可能有不同的行为：

```bash
# 检查会话类型
echo $XDG_SESSION_TYPE

# 如果是 wayland，可能需要使用不同的方法
# 某些 Wayland 合成器使用自己的锁屏协议
```

## 常见问题解答

### Q: 为什么连接显示成功但收不到信号？

**A**: 可能原因：
1. **路径不对**: 连接到了错误的会话路径
2. **时机问题**: 信号在连接之前就发送了
3. **权限问题**: 没有权限监听 system bus 信号
4. **桌面环境**: 使用了非标准的锁屏机制

**解决**: 使用 `test_lock_signals.sh` 查看实际信号

### Q: 在虚拟机中测试有问题吗？

**A**: 可能会有。确保：
- ✓ 使用完整的桌面环境（不是最小化安装）
- ✓ 通过图形界面登录（不是 SSH）
- ✓ 虚拟机有足够的资源
- ✓ 安装了 Guest Additions / Tools

### Q: 日志显示 "connected: true" 但还是没反应？

**A**: 这说明连接成功了，但信号可能：
1. 使用了不同的信号名（如 `Locked` vs `Lock`）
2. 从不同的路径发出
3. 带有额外的参数

运行 `dbus-monitor` 直接查看：

```bash
# 监听所有 session bus 信号
dbus-monitor --session "type='signal'" | grep -i lock

# 监听所有 system bus 信号
dbus-monitor --system "type='signal'" | grep -i lock
```

### Q: Deepin 系统上完全不工作？

**A**: Deepin 不同版本的接口差异很大：

1. 找到正确的服务名：
   ```bash
   dbus-send --session --print-reply \
       --dest=org.freedesktop.DBus \
       /org/freedesktop/DBus \
       org.freedesktop.DBus.ListNames | grep -i deepin
   ```

2. 查看服务接口：
   ```bash
   dbus-send --session --print-reply \
       --dest=com.deepin.dde.lockFront \
       /com/deepin/dde/lockFront \
       org.freedesktop.DBus.Introspectable.Introspect
   ```

3. 修改 `screenlockdetector.cpp` 中 `connectToDeepinDDE()` 的服务列表

## 技术细节

### 为什么需要空路径监听？

DBus 信号连接时指定路径会限制只接收该对象的信号。使用空路径 `""` 表示监听该接口的所有对象的信号。

```cpp
// 只监听特定会话
connect("service", "/path/to/session1", "interface", "signal", ...)

// 监听所有会话（推荐）
connect("service", "", "interface", "signal", ...)
```

### QDBusContext 的作用

继承 `QDBusContext` 后，在 slot 函数中可以调用 `message()` 获取触发信号的详细信息：

```cpp
QDBusMessage msg = QDBusContext::message();
qDebug() << "Signal from:" << msg.service() << msg.path();
```

这对调试非常有用。

### systemd-logind Session 接口

标准接口应该有这些信号：
- `Lock` - 会话锁定
- `Unlock` - 会话解锁
- `PauseDevice` - 设备暂停
- `ResumeDevice` - 设备恢复

和这些属性：
- `LockedHint` - 布尔值，指示会话是否锁定
- `Active` - 会话是否活动
- `Type` - 会话类型（x11, wayland, tty 等）

## 获取帮助

如果以上方法都不行，请提供以下信息：

1. **系统信息**:
   ```bash
   cat /etc/os-release
   echo "Desktop: $XDG_CURRENT_DESKTOP"
   echo "Session: $XDG_SESSION_TYPE"
   ```

2. **会话信息**:
   ```bash
   loginctl show-session $XDG_SESSION_ID
   ```

3. **程序输出**: 运行 `./run.sh` 的完整输出

4. **信号监听结果**: 运行 `./test_lock_signals.sh` 的输出

5. **手动测试结果**: 
   ```bash
   dbus-monitor --system "type='signal'" | grep -i lock
   # 然后锁屏，记录输出
   ```

## 相关文档

- 📖 详细修复说明: `LOCK_SIGNAL_FIX.md`
- 🔧 Deepin 支持: `DEEPIN_SUPPORT.md`
- 🏗️ 架构文档: `ARCHITECTURE.md`
- 📝 项目概览: `PROJECT_OVERVIEW.md`

## 总结

核心修复点：
1. ✅ 动态获取会话路径（不硬编码 "auto"）
2. ✅ 空路径监听（接收所有会话信号）
3. ✅ 详细调试日志（便于诊断）
4. ✅ 多重连接策略（提高兼容性）

大多数情况下，这些修复应该能解决问题。如果还有问题，使用提供的调试工具找出系统实际使用的信号机制。