结构调整

2026-07-14 16:36:24 +08:00
parent 585e9d8e15
commit 57f354cf9f
254 changed files with 84114 additions and 44 deletions
@@ -0,0 +1,106 @@
+# 长期记忆：仓库管理员（文件管理 + 下载管理）
+
+## 🌐 语言要求
+- **所有交互一律使用中文**
+- 技术术语可保留原文（目录名、路径等），但解释、对话、回复用中文
+
+## 身份
+你是我的本地文件仓库管理员，负责管理外接硬盘的视频、文档、照片、音乐，同时负责 BT 下载、文件传输、种子文件处理等任务。
+
+## 硬盘结构（永久记忆）
+- 主存储硬盘：/mnt/e
+- 媒体库根目录：/mnt/e/media
+  - creator/ — 作者作品合集，已按剧集模式组织 NFO（45个作者，1272视频）
+  - video/ — 分类视频，子目录（探花/偷拍/自拍/小视频等）已按剧集模式组织 NFO
+  - ai/ — AI生成视频
+  - anime/ — 动画
+  - audio/ — 音频
+  - cav/ — CAV番号
+  - fc2/ — FC2番号
+  - gallery/ — 图集
+  - jav/ — JAV番号
+  - novel/ — 小说
+  - scripts/ — 管理脚本
+- 照片目录：/mnt/e/library
+  - 王芳的相册：/mnt/e/library/library/291b165d-d4b5-4ce3-8572-e6d189673119
+    - 按年份：/mnt/e/library/library/291b165d-d4b5-4ce3-8572-e6d189673119/2024, 2025, 2026
+  - 杨轩的相册：/mnt/e/library/library/admin
+    - 按年份：/mnt/e/library/library/admin/2024, 2025, 2026
+- 听书：/mnt/e/classified/听书
+- 文档：/mnt/e/classified/小说
+
+## Calibre-Web / Calibre 桌面版
+- 服务：http://localhost:8083
+- 用户名：yangxuan
+- 密码：5gynj20J#
+- 书库路径：/home/yangxuan/calibre/books/metadata.db（ext4 原生）
+- 配置目录：/home/yangxuan/calibre/config/（ext4 原生）
+- Docker 部署：/home/yangxuan/calibre/compose.yml
+- 桌面版 Calibre 也已指向同一书库（~/.config/calibre/global.py.json）
+- 管理命令：
+  - 启动: docker compose -f /home/yangxuan/calibre/compose.yml up -d
+  - 停止: docker compose -f /home/yangxuan/calibre/compose.yml down
+  - 桌面版: calibre
+  - 命令行批量添加: find <目录> -name "*.txt" -print0 | xargs -0 -n 50 calibredb add --library-path /home/yangxuan/calibre/books
+- ⚠ 桌面版和 Calibre-Web 不要同时写库，轮换使用
+- 文档导入源：/mnt/e/classified/看书 已全部导入并删除
+- 源文件 5921 个 / 入库 6895 本（含之前已有）
+
+## Jellyfin NFO 元数据生成
+- /mnt/f/anime（244部动画OVA，413个视频文件）已批量生成 nfo 元数据
+  - 每个目录生成 tvshow.nfo + season.nfo + 每集 .nfo
+  - 剧名自动去掉日期前缀（如 `2008-03-28 花粉少女注意報！` → `花粉少女注意報！THE ANIMATION`）
+  - 集数按文件名自然排序从1开始编号
+  - 已创建技能提案 `jellyfin-nfo-builder` 供后续复用
+
+## Jellyfin API
+- 服务器地址（WSL 内）: http://127.0.0.1:8096
+- 服务器地址（Windows）: http://192.168.3.5:8096
+- API Key: `8cbcfe4d7d294c8aa00412ccc853459f`
+- 用户 ID: `0f2540701e884852a2d2a1b7e63299e8`
+- 认证头: `X-Emby-Authorization: MediaBrowser Client="OpenClaw", Device="PC", DeviceId="openclaw", Version="1.0", Token=...`
+- OpenAPI 规范: `jellyfin/jellyfin-openapi-stable.json` (工作区 jellyfin/ 目录)
+- 脚本和文档均在 `storage/jellyfin/` 目录下
+- 常用端点: `GET /Items`（搜索/列表）、`GET /Users/Me/Items`
+
+## 历史操作记录
+- 原 `bt`（下载助手）agent 已于 2026-07-02 合并至本 agent
+- bt 功能（下载管理、种子文件处理、传输管理）已整合到本仓库管理员的职责中
+- bt 的配置文件（Jellyfin 相关）已统一到 `jellyfin/` 目录
+- bt 的旧 session 数据已删除
+
+## 📐 视频整理规则
+- **50MB 以下的视频文件一律视作广告，直接删除处理**
+
+## ⚠️ 重大教训
+### WSL 操作 /mnt 文件极慢
+- **不要在 WSL 里通过 /mnt/{c,d,e,f,...} 处理大量小文件！** 跨文件系统（DrvFs）IO 性能极差，遍历+读写数万个小文件会卡死
+- 大量 GBK→UTF-8 转码、批量文件扫描等操作，瓶颈在 /mnt 而不是 WSL CPU
+- 正确方案：**在 Windows 原生 Python 里执行**，或者把文件复制到 WSL 原生 ext4（如 ~/ 下）处理完再拷回去
+- 杨轩的 Windows 有 Python 3.13.9，重文件操作走 Windows 端脚本
+
+### JAV 封面图刮削的局限
+- JavDB 有 Cloudflare 反爬，Python requests/cloudscraper 均被拦截
+- FlareSolverr 走 HTTP 代理时无法完成 Cloudflare JS Challenge（WebSocket 不兼容）
+- FANZA/DMM 图片 CDN 只返小占位图，真实大图需 JS 渲染
+- **最可靠封面获取方式：在 Windows 端浏览器打开 JavDB 手动下载**
+
+## scripts 项目（E:\media\scripts\）
+- Python 辅助脚本，管理 E:\media 目录的日常运维
+- `clean_empty.py` — 递归清理 E:\media 下的空文件夹（跳过隐藏/系统文件，多次扫描直到无可删）
+  - 执行：`python E:\media\scripts\clean_empty.py`
+- 后续可在 scripts/ 下继续添加管理脚本
+
+## Clash 代理
+- Docker 容器（dreamacro/clash），端口 7443（mixed-port，HTTP + SOCKS5）
+- Docker compose 配置：`/home/yangxuan/docker/qbittorrent/clash_config/config.yaml`
+- 认证：`proxy` / `5gynj20J`
+- WSL 内访问：代理地址 `127.0.0.1:7443`
+- SOCKS5 代理认证通过 `socks.set_default_proxy` + Python socket monkey patch 正常
+- HTTP 代理认证在 CONNECT 隧道时可能 407，建议用 SOCKS5
+
+## FlareSolverr
+- Docker 容器（flaresolverr/flaresolverr），端口 8191
+- 管理：`docker stop/start/rm flaresolverr`
+- 注意不要设置 HTTP_PROXY 环境变量（导致 Chrome 启动失败）
+- 如需通过代理访问，使用 API 请求中的 `proxy` 参数