bb31f0a2c4
Two issues found from container logs: 1. Discourse returns 403 'BAD CSRF' when POST /session.json lacks a valid CSRF token. Fix: fetch CSRF token from /session/csrf.json (or meta tag), then send it as X-CSRF-Token header + authenticity_token body field + X-Requested-With header. 2. The error data can be a list (e.g. ['BAD CSRF']) not a dict. Fix: isinstance check before calling .get() on data. Also remove debug logging now that the root cause is identified.
astrbot_plugin_linuxdo - LinuxDo 链接预览插件 🚀
自动检测聊天消息中的 linux.do 链接，绕过 Cloudflare Turnstile 防护，
截图并提取内容摘要发送预览。
✨ 功能
- 🔗 自动检测 — 聊天中出现
linux.do链接立即触发 - 🛡️ 绕过 Cloudflare — 使用 Scrapling 的 StealthySession 自动解 Turnstile
- 📸 智能截图 — 自适应卡片渲染，完整楼主内容，无空白/截断
- 📝 内容摘要 — 通过 Discourse JSON API 提取完整楼主内容（无截断）
- 🔒 账户登录 — 可选配置账号密码，访问受限分类、私信等非公开内容
- ⚡ 异步非阻塞 — Scrapling 在独立线程池运行，不阻塞 AstrBot 主循环
- 💾 缓存机制 — 30 分钟内相同链接直接返回缓存截图
- 🧹 缓存管理 —
/linuxdo_stats查看统计，/linuxdo_clean清理缓存
📦 安装
1. 安装插件
将 astrbot_plugin_linuxdo 目录放入 AstrBot 的 data/plugins/ 目录。
2. 安装依赖
# 进入 AstrBot 环境
cd AstrBot
# 安装 Scrapling（含浏览器）
pip install scrapling[fetchers]
scrapling install
# 或者使用 pipx（推荐）
pipx install scrapling[fetchers]
scrapling install
3. 重载插件
在 AstrBot WebUI 插件管理中找到 LinuxDo Preview，点击重载。
📖 使用方法
自动触发： 在聊天中发送或粘贴任何 linux.do 链接即可，例如：
https://linux.do/t/topic/1378383
插件自动：
- 回复
🔍 正在获取 linux.do 预览… - 后台使用 Scrapling 绕过 Cloudflare
- 发送 截图 + 标题 + 内容摘要
管理指令：
| 指令 | 说明 |
|---|---|
/linuxdo_stats |
查看统计（请求数/缓存命中/错误/缓存大小） |
/linuxdo_clean |
清理所有缓存截图 |
🔧 技术原理
┌─────────────┐ 检测链接 ┌──────────────┐
│ 用户消息 │ ──────────→ │ Plugin Core │
│ linux.do/xx │ │ 事件监听器 │
└─────────────┘ └──────┬───────┘
│
run_in_executor()
│
┌───────▼────────┐
│ Thread Pool │
│ (max_workers=2)│
└───────┬────────┘
│
┌───────────────┼───────────────┐
▼ ▼ ▼
┌──────────────┐ ┌──────────┐ ┌──────────────┐
│ Stealthy │ │ 截图保存 │ │ 提取标题&正文 │
│ Session │ │ .png │ │ │
│ (solves CF) │ │ │ │ │
└──────────────┘ └──────────┘ └──────────────┘
│ │ │
└───────────────┼───────────────┘
▼
┌──────────────────┐
│ 返回主线程 │
│ yield 图片+文字 │
└──────────────────┘
⚙️ 配置
通过 _conf_schema.json 支持以下配置：
| 配置项 | 说明 | 默认值 |
|---|---|---|
cache_ttl |
缓存有效期（秒），设为 0 关闭缓存 | 1800 |
max_content_length |
内容摘要最大长度（字符） | 400 |
screenshot_timeout |
截图超时（秒） | 15 |
screenshot_full_page |
全页截图模式（true=完整帖子，false=仅视口） | true |
use_api_render |
使用 API + 自定义 HTML 渲染（推荐） | true |
linuxdo_session_cookie |
LinuxDo 会话 Cookie，用于访问受限内容 | （空） |
linuxdo_username |
LinuxDo 用户名，自动登录获取 Cookie | （空） |
linuxdo_password |
LinuxDo 密码，配合用户名自动登录 | （空） |
🔑 访问受限内容（可选）
默认以匿名身份访问 linux.do。如需查看受限分类、私信等非公开内容，有两种方式：
方式一：自动登录（推荐）
- 在 AstrBot WebUI 插件配置中填写
linuxdo_username和linuxdo_password - 插件自动通过 Playwright 登录并获取会话 Cookie
- 登录失败时自动降级为匿名访问
方式二：手动复制 Cookie
- 在浏览器中登录 linux.do
- 打开 DevTools（F12）→ Application → Cookies → linux.do
- 复制
_forum_sessioncookie 的 Value - 在 AstrBot WebUI 插件配置中粘贴到
linuxdo_session_cookie
注意：Cookie 有效期约 2 周，过期后需重新获取。自动登录模式下插件会自动刷新。
⚠️ 注意事项
- 首次使用需要安装 Scrapling 和浏览器：
pip install scrapling[fetchers] && scrapling install - Cloudflare 绕过每次约 20-40 秒，请耐心等待
- 截图保存路径：
data/plugin_data/astrbot_plugin_linuxdo/screenshots/ - 截图缓存 30 分钟自动过期，也可手动
/linuxdo_clean
📄 许可证
MIT