# TOOLS.md —— 本地记录

技能文件（Skills）定义的是工具**如何工作**。而这个文件是为**你的具体情况**准备的——那些你个人环境独有的信息。

## 项目目录

### mdcx - 视频元数据刮削工具
- **路径：** `/home/yangxuan/Projects/PycharmProjects/mdcx`
- **用途：** 用于抓取JAV视频元数据（海报、演员、简介、标签等），自动填充.nfo文件
- **配置：** `config.json` 在项目根目录
- **代理：** 默认使用 `http://127.0.0.1:7890`（SOCKS5），外部搜索可改用 `http://proxy:5gynj20J@api.climbcube.cn:7443`
- **源文件结构：** `media_path: ./media`, `JAV_output` 在项目根目录
- **启动：** `python main.py`（建议在WSL内运行）

## jellyfin/ 目录

从原 `下载助手` 合并而来的 Jellyfin 相关参考文档、脚本和统计数据。

- `jellyfin-config.md` — API 配置（服务器地址、Key、认证方式）
- `jellyfin-search-api.md` — API 使用参考（搜索、筛选、分页）
- `jellyfin-dedup-howto.md` — 重复电影检测指南
- `jellyfin-dedup.py` — 重复电影检测脚本
- `jellyfin_actor_stats.py` — 演员作品统计脚本
- `jellyfin_actor_stats.json` — 演员统计原始数据
- `jellyfin_actor_stats.md` — 演员统计报告
- `jellyfin-openapi-stable.json` — OpenAPI 规范文件

## 示例

```markdown
### 摄像头

- living-room → 主要区域，180° 广角
- front-door → 入口，动态触发

### SSH

- home-server → 192.168.1.100，用户：admin

### TTS

- 首选语音："Nova"（温暖，略带英音）
- 默认扬声器：厨房 HomePod
```
