Amane 是一个影片元数据服务, 核心是数据库中以番号为单位的影片条目. 番号可以手工输入、按模板批量生成、从 RSS 订阅中发现, 也可以由智能体或媒体库扫描提交.
Amane 不是 Emby / Jellyfin 的替代品, 而是它们的元数据补充: 媒体服务器负责媒体文件的管理、播放与串流, Amane 提供多源元数据, 并以 NFO 与图片的形式写到视频旁.
| 多源字段择优 | 内置 25 个影片站点, 按内容类型配置站点顺序, 每个字段可单独调整优先级或排除站点. |
| 完全数据所有权 | 各站点的原始结果、图片与译文都保存在本地 SQLite 与资源目录中; 来源站点下线后数据仍然可用, 重新刮削只请求缺失的站点. |
| 为管理而设计的界面 | 海报墙与多维筛选、对比来源、字段锁定、分类治理、评论与用户标签, 刮削结果可以逐字段审阅与修订. |
| AI Native 设计 | 通过内置智能体使用自然语言检索片库、批量整理标签、发起刮削; 也可让外部智能体经 CLI 操作 Amane. |
| 多种番号来源 | 单个番号、模板批量生成、RSS 订阅、智能体、定时重新刮削, 以及可选的媒体库扫描. |
| 与媒体服务器互补 | 需要时把元数据整理为 NFO、海报、封面、剧照与字幕写到视频旁, Emby / Jellyfin 直接识别. |
| 多端适配 | 桌面版、Docker 与 Android 三种形态; 设置保存后立即生效; 升级时自动迁移数据库, 迁移前自动备份. |
桌面版 (macOS / Windows) 与 Android 客户端见 Releases, Docker 镜像为 ghcr.io/sqzw-x/amane. 安装步骤、使用说明与常见问题见 用户文档.
社区开发的外部工具与插件以 Issue 标签 eco:project 收录. 这些项目由社区维护, 请自行评估其功能与安全性; 除公共 API 外, 本项目不提供支持与保证.
缺陷与功能请求请使用 Issue 模板. 提交 Issue 与 Pull Request 前请阅读 AI_POLICY.md.
just setup # 同步依赖并安装 hooks
just dev # 启动 API (:8000) 与前端开发服务器
just check # lint + typecheck + 测试技术栈: FastAPI · React + Mantine · SQLite · Swift / .NET 桌面壳 · Kotlin Android 壳. 开发入口见 AGENTS.md.