b64bfeba8c
- Add login feature to feature list (🔑 账户登录) - Add use_api_render, linuxdo_username, linuxdo_password to config table - Add 🔑 账户登录（可选） section with setup instructions and security note - Update technology diagram to reflect API render pipeline
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_username |
LinuxDo 用户名，配置后自动登录 | （空） |
linuxdo_password |
LinuxDo 密码，⚠️ 明文存储 | （空） |
🔑 账户登录（可选）
默认以匿名身份访问 linux.do。如需查看受限分类、私信等非公开内容：
- 在 AstrBot WebUI 插件配置中填写
linuxdo_username和linuxdo_password - 插件会在每次请求时自动通过 Playwright 提交登录表单
- 登录成功后，同一会话内所有 API 调用均带认证态
- 登录失败（凭据错误、风控）时自动降级为匿名访问，不影响正常使用
安全提示：密码以明文存储在配置文件中，建议使用专用低权限账户。
⚠️ 注意事项
- 首次使用需要安装 Scrapling 和浏览器：
pip install scrapling[fetchers] && scrapling install - Cloudflare 绕过每次约 20-40 秒，请耐心等待
- 截图保存路径：
data/plugin_data/astrbot_plugin_linuxdo/screenshots/ - 截图缓存 30 分钟自动过期，也可手动
/linuxdo_clean
📄 许可证
MIT