# Logging and diagnostics

Good diagnostic information shortens support time. Never include passwords, tokens, private keys, or sensitive clipboard content in logs, screenshots, or forum posts.

## What to collect

| Category | Include |
|---|---|
| Platform | OS, OS version, device model, desktop/mobile platform |
| Octoclip | app version, install source, license state, sync mode |
| Reproduction | shortest steps that reproduce the issue |
| Layer | whether the clip was captured locally, transferred, and pasted/inserted |
| Network | same LAN or cross-network, VPN/proxy, guest Wi-Fi, firewall/router isolation |
| Content type | text, image, file, URL, SMS/OTP, rich text |

## Minimal reproduction template

```text
Platform A:
Platform B:
Octoclip versions:
Sync mode: Nearby / Cloud / unclear
License state: inactive / active / unclear
Test content type:
Steps:
Expected:
Actual:
Does the source device record the clip locally? yes/no
Does the target device receive the clip? yes/no
Can the target device paste/use the clip? yes/no
```

## Diagnostic order

1. Capture: did the source device record the clip?
2. Transfer: did the target device receive the clip?
3. Paste/use: can the target insert or paste the clip into the destination app?

Do not debug all layers at once. Identify the failed layer first.