基于 AstrBot 框架的追番管理插件。通过 QQ 机器人管理 Bangumi 追番列表、同步观看进度、LLM 驱动的观感访谈、自动生成 Obsidian 兼容的 Markdown 观感记录。

• 番剧搜索 — /search 芙莉莲 搜索 Bangumi 条目
• 条目详情 — /bgm 400602 查看 Bangumi 条目详情卡
• 追番管理 — /sub add|list|remove 管理追番列表，可用 /sub schedule 管理提醒排期
• 进度同步 — 发送"芙莉莲15看完"自动同步观看进度到 Bangumi
• 更新提醒 — 根据 Tenrai/MAL 播出排期按北京时间推送“预计更新第 N 集”QQ 通知；完结后自动停用
• 观感访谈 — 同步进度后 LLM 自动发起多轮访谈对话
• Markdown 记录 — 访谈内容自动保存为 Obsidian 兼容的 Markdown 文件
• Web 笔记查看 — 浏览器访问只读笔记页面（端口 58080）
• Web 笔记编辑 — 独立的文件管理器 + Markdown 编辑器（端口 58081）

配置 Bangumi Access Token（从 https://next.bgm.tv/demo/access-token 获取）

插件启动后提供两个 Web 端口：

查看器展示渲染后的 HTML 页面；编辑器提供侧边栏文件树，支持新建/删除/编辑 Markdown 文件，Ctrl+S 保存。

端口号可在插件配置中修改（web_viewer_port / web_editor_port），设为 0 可禁用。

发送 番剧名 + 集数 + 看完/看到/追到 即可自动同步进度，例如：

• 芙莉莲15看完
• 葬送的芙莉莲看到第10集

无需部署到 AstrBot 即可在本地预览 Web 界面：

# 安装 Web 依赖
pip install aiohttp pyyaml markdown

# 启动开发服务器（自动创建示例数据）
python tools/dev_server.py

# 自动重载模式（修改代码后自动重启）
pip install watchfiles
python tools/dev_server.py --reload

启动后访问：

• http://localhost:58080 — 查看器预览
• http://localhost:58081 — 编辑器预览

• docs/architecture.md — 系统架构
• docs/development-plan.md — 开发阶段
• docs/modules.md — 模块划分
• docs/database.md — 数据库设计
• docs/bangumi-api.md — Bangumi API 封装
• docs/data-flow.md — 数据流设计
• docs/markdown-storage.md — Markdown 存储
• docs/qqbot-astrbot.md — QQ 机器人配置
• docs/adr/ — 架构决策记录

• Python 3.12+
• httpx, aiosqlite, aiohttp
• markdown, PyYAML
• AstrBot >= 4.16