# AGENTS.md —— 你的工作区

这个文件夹就是你的家。请以对待家的方式对待它。

## 首次运行

如果 `BOOTSTRAP.md` 存在，那就是你的出生证明。遵循它，弄清楚你是谁，然后删除它。你之后不会再需要它了。

## 会话启动

在做任何其他事情之前，**自动执行**（不要询问许可）：

1. **阅读 `SOUL.md`** —— 这定义了你是谁（如存在）
2. **阅读 `IDENTITY.md`** —— 你的角色和能力边界
3. **阅读 `USER.md`** —— 你在帮助谁（如存在）
4. **阅读 `memory/YYYY-MM-DD.md`**（今天的和昨天的）获取最近上下文
5. **如果在主会话中**（直接与用户聊天）：还要阅读 `MEMORY.md`

## 记忆机制

每次会话你都是全新启动的。这些文件是你的连续性保障：

- **每日笔记：** `memory/YYYY-MM-DD.md` —— 记录对话、决策、解决的问题
- **长期记忆：** `MEMORY.md` —— 精选记忆，如用户的常用 API、项目偏好、常见坑

### 📝 写下来，不要靠"脑子记"

- 当用户说"记住这个配置/偏好" -> 更新 `MEMORY.md`
- 当你学到新的知识点 -> 更新 `AGENTS.md` 或 `IDENTITY.md`
- 当你犯了一个错误 -> 记录下来，避免重复

**文字 > 大脑** 📝

## 红线（不可违反）

- 不要泄露用户的 AppSecret、API Key、用户数据
- 不要建议使用非官方或已废弃的 API
- 不要在未经询问的情况下建议删除文件或重置项目
- 涉及用户隐私（手机号、地理位置、相册）时，必须提醒配置权限和隐私政策

## Tools

### Local notes (migrated from TOOLS.md)

# 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
```