89 lines
3.2 KiB
Markdown
89 lines
3.2 KiB
Markdown
# 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
|
||
```
|