导入指南
先拿到文件，再回来上传。
这个页面只负责把导出路径讲清楚。无论你是从豆瓣、Letterboxd、IMDb 还是自定义源文件开始，目标都只有一个：拿到可上传的 CSV 或 JSON，然后回到导入页完成导入。
如果你的观影记录主要在豆瓣，可以用下面的书签脚本直接生成 CSV；电脑端也可以安装浏览器扩展，授权后直接同步最新标记或导出完整备份。两种方式都会带回看过、想看和可用的 Top10 数据。
授权豆瓣后，直接同步最新标记或导出完整备份。不用编辑书签脚本：打开扩展的数据工具，点击“同步最新豆瓣数据”或“导出本地完整 CSV 备份”。默认先保存在本地，云端写入需要单独勾选并确认。
不安装插件？使用下面的书签脚本
适合手机，或不方便安装扩展的情况。把脚本保存成书签，打开豆瓣页面后点击运行即可下载 CSV。
- 把下面绿色按钮直接拖进书签栏。
- 打开任意豆瓣页面，点一次这个书签。
- 脚本会询问豆瓣 ID，然后下载 CSV。
- 先随便收藏一个网页，后面拿它改成“豆瓣导出”。
- 编辑这个书签，把网址整段替换成下面的脚本。
- 打开豆瓣个人主页或任意豆瓣页面，点书签运行即可。
先把脚本存成书签，运行时直接点书签。
先找豆瓣 ID豆瓣 ID 是个人主页链接里 `/people/` 后面的那一段，一般是字母、数字和下划线，不是你在页面上显示的昵称。
网页登录了怎么找打开你自己的豆瓣主页，浏览器地址里 `https://m.douban.com/people/你的ID/` 这段里的 `你的ID` 就是要填的值。
网页登录没登录也能找直接去豆瓣 App 里看：侧边栏 -> 设置 -> 资料与账号。里面显示的豆瓣 ID 才是要填的，不是昵称。
浏览器怎么跑把绿色按钮拖进书签栏，或者手动新建书签并把“网址 / URL”整段替换成脚本。然后打开豆瓣页面，点一次书签即可开始抓取。
手机浏览器怎么跑手机上通常没有“拖进书签栏”这一步，所以更稳妥的方式是先收藏任意页面，再进书签编辑页，把 URL 全部替换成脚本。Safari、Chrome 和大多数安卓浏览器都可以这么做。
完成后找文件下载成功后，文件通常会在浏览器默认“下载”目录，文件名类似 `Douban_Export_xxx.csv`。
实在不会？选择一种方式验证账号，提交豆瓣 ID；同步完成后会通知你。只需提供公开豆瓣主页，并授权本站使用其中的公开观影记录。
Letterboxd 直接去官方数据导出页面下载即可，文件也会落在默认下载目录。
打开导出页IMDb 常见做法是从 ratings 列表导出 `ratings.csv`。如果你主要依赖评分，这个文件就够用了。
打开评分页Trakt 更适合走账号连接与后续同步，不一定非要先拿文件。如果你已经用 Trakt，通常直接去设置里完成连接会更省心。
Jellyfin 版本可通过插件源安装并使用设备码绑定；Emby 审核版只保留服务端观看与评分同步，不修改网页文件。网页评分入口另提供 Geek 版。
1. 添加源与安装Jellyfin 在「插件 → 存储库」添加 https://cinepersona.com/jellyfin.json；Emby 审核版暂从 GitHub Release 安装，官方目录审核通过后即可在目录安装。
2. 扫码一键连接Jellyfin 或 Geek 版在任意电影详情页点击「连接 CinePersona」后扫码；Emby 审核版在插件配置页填写 API Key。
如果你的历史主要散落在别的平台，或者你想先把多来源数据统一抓下来再整理，CineRecord 可以作为前置工具。它更适合负责“把别处数据拿出来”，然后再把结果回传到这里导入。
如果你的源数据不是标准导出格式，先让 AI 帮你转换成 CinePersona 标准 CSV。只要最终能拿到一个本地 CSV 文件，就可以正常上传。
你需要准备原始导出文件、原始字段说明，或者任何能说明片名、年份、评分、观看日期的表格内容。
转换后的最低要求至少保留 `title` 和 `year` 两列。其他像 `rating`、`watched_at`、`comment` 都可以按情况补充。
会用来做什么上传的数据会用于生成你的画像、推荐解释、匹配结果，以及必要的站内统计优化。
你需要确认请确认这些导出数据是你有权使用和迁移的；第三方平台本身的数据准确性与可用性不由 CinePersona 保证。
如果以后想删除你可以在账户设置里退出登录、管理账号，或继续发起删号请求；删号后相关个人数据不可恢复。
最后一步
拿到文件就回导入页，不需要再研究别的。
导入页现在只保留上传、识别、授权和提交这几个关键动作。教程已经都放在这里了，回去上传即可。
