Troubleshooting

Troubleshooting

"Unable to start Python" / bridge fails to start

The configured interpreter could not launch the bridge.

1. Check Python command in settings points to a Python 3.11+ that has Playwright: python -c "import playwright; print('ok')"
2. If you use conda, put the full path to the env's python(.exe) in the setting.
3. Try starting the bridge manually and read the error: python csdn_bridge.py --host 127.0.0.1 --port 8765 (script is in the plugin folder).

Bridge started but "Playwright not installed"

The interpreter launched, but lacks Playwright:

python -m pip install playwright==1.62.0
python -m playwright install chromium

Make sure you install into the same interpreter you configured in settings.

"Old bridge version detected, please toggle..."

An older bridge process is still listening on the port. Close it and toggle Enable bridge service off, then on:

# find the process listening on 8765 and stop it, e.g. on Windows:
netstat -ano | findstr :8765
taskkill /PID <pid> /F

"Bridge script not found" / release script failed

The plugin writes csdn_bridge.py into its own folder on first run. If that failed (read-only folder, sync tool lock):

• Restart Obsidian once (the write is retried on plugin load);
• or copy csdn_bridge.py from the repository into <vault>/.obsidian/plugins/csdn-draft-publisher/ yourself.

Login expired / drafts list empty

Logins can expire on CSDN's side. Open Settings → CSDN accounts → Login for the affected account and sign in again in the browser window. If it still misbehaves, use Clear login state for that account, then log in fresh.

Port 8765 already in use (by something else)

Either stop the other process, or change the port by editing the Bridge URL setting (e.g. http://127.0.0.1:8901) and start the bridge manually with the same --port when running it yourself.

Windows note: some port ranges are reserved by Hyper-V and cannot be bound ("access forbidden" errors when starting servers). 8765 itself is fine, but if you move the port pick one outside netsh interface ipv4 show excludedportrange protocol=tcp.

Sync works but images are missing

The plugin intentionally does not upload local images. Use CSDN's own image upload in the editor afterwards, or reference hosted image URLs.

Nothing helps

1. Toggle the plugin off and on, then Obsidian full reload (Ctrl+P → Reload app without saving).
2. Check the issue tracker — if new, file a bug with the template (sanitized logs!).