使用说明（帮助）¶

本说明基于当前版本功能（详见 docs/CHANGELOG.md 与 README.md），会随着软件更新逐步完善。

启动与通用说明¶

启动 DarkEye 后若界面闪一下属于正常现象：需要加载 OpenGL 环境，目前无法完全消除。
所有数据默认只保存在本地：
公库在 resources/public
私库在 resources/private
详细的数据结构与安全说明可参考 docs/security.md

首页¶

首页展示已收藏的作品卡片，目前主要按制作商排序：
在 1.1.1 版本以后，列表支持更多排序方式，包括：
- 按番号排序
- 按片商排序
后续如增加更多排序条件，会在这里一并体现。
点击作品卡片可以进入详细信息界面，查看封面、基本信息、标签、出演者等。

三、管理模块¶

管理模块负责对作品、标签、制作商等基础数据进行维护，并提供批量操作与导出。

1. 添加 / 修改作品¶

入口：管理 -> 添加/修改作品
主要功能：
手动添加新作品：填入番号、标题、制作商、女优、男优、标签等信息。
修改已存在作品：修正爬虫信息、补充缺失字段。
爬虫辅助修改信息
修改变色提醒

2. 作品标签管理¶

入口：管理 -> 作品标签管理
主要功能：
添加、修改、删除标签(删除标签需要这个标签不存在于任何的作品中)。
给标签设置说明，用于后续筛选和分析。
未来会逐步配合“tag 计算器 / 高级过滤”功能增强（见 README.md 中 roadmap）。

3. 番号制作商管理¶

入口：管理 -> 番号制作商管理
主要功能：
维护制作商 / 厂牌列表。
对自动识别不准的制作商进行手动补全或修正。
对无法从爬虫中直接获得制作商信息的番号进行补录。

4. 批量操作¶

入口：管理 -> 批量操作
当前常用能力：
查找本地视频并录入添加：
- 前提：在 设置 -> 视频 中添加了本地视频所在路径。
- 功能：扫描本地视频文件，并尝试根据文件名中的番号，自动在数据库中创建/关联作品。
- 注意：
- 会配合爬虫慢慢启动爬取信息，默认约 20s 一次请求，速度较慢。
- 当前识别准确度有限，可能需要手动修正。
其他批量操作（如批量更新字段、批量打标签等）会在后续版本中逐步增强。

5. 汇总查询表¶

入口：管理 -> 汇总查询表
主要用途：
对作品数据进行汇总查看与筛选。
提供导出功能，目前主要用于导出为 .csv 等格式，方便在 Excel / 其他工具中继续分析。

6. 综合管理¶

用于集中查看与维护多类数据（作品 / 演员 / 标签等）。
后续版本会继续补充更多高级管理视图（例如：更复杂的过滤、批量编辑等）。

7. 回收站¶

删除作品、标签等数据后会进入回收站。
可以在这里进行：
恢复误删的数据。
彻底删除不再需要的记录。

作品筛选过滤/书架¶

这两个页面的筛选过滤是一样的，唯一的区别就是显示的方式不一样，一个是瀑布流的平铺，一个是dvd拟物。 - [x] tag过滤，只支持与过滤与搜索tag - [x] 番号过滤，文本过滤 - [x] 女优过滤，文本过滤 - [x] 标题包含，文本过滤 - [x] 简短故事包含，文本过滤 - [x] 导演，文本过滤 - [x] 男优，文本过滤 - [x] 片商，文本过滤

统计¶

信息面板¶

[x] 数据库信息显示，包括作品总数、女优总数、男优总数、tag总数、近30天新增作品、收藏作品总数、收藏女优总数
[x] 过去30/180/365天最喜欢的女优
[x] 收藏作品中未观看去化周期
[x] 撸管/晨勃/做爱热力图显示，多年份

统计¶

图表的绘制对四大统计范围，公共数据库，收藏库，撸过，撸过加权 - [x] 作品拍摄时女优年龄分布直方图，带分布曲线与90%分布线 - [x] 作品发行年份分布直方图 - [x] 女优出道年份分布直方图 - [x] 女优身高分布直方图 - [x] 女优身材腰臀比气泡图，由于前中后期实际上女优身材是有变化的，胖了或者瘦了，这个就图一乐看看 - [x] 女优罩杯分布饼图，由于女优会填充胸部，这个也不准，图一乐 - [x] 导演统计柱状图 - [x] 制作商统计柱状图 - [x] Tag词云生成

[x] 女优身材3D分布图，这个没什么用，后面删掉
[x] 最喜欢的女优柱状图
[x] 作品增长曲线图
[x] 女优出道年龄直方图
[ ] 撸管年回忆录

女优¶

[x] 过滤与排序系统
[x] 展示系统，左键点击头像是跳到详情页，右键点击头像是跳到编辑页

女优编辑页¶

[x] 基础信息的编辑，多艺名的编辑，多艺名的排序现在的问题是不能显示重复使用艺名，比如河北彩花的艺名变成河北彩伽后又变成河北彩花。
[ ] 自定义补充说明+联系
[ ] 更改提示
[x] 爬虫直接更新
[x] 跳转minnao-av
[x] 浏览器插件更新

女优详情页¶

[x] 女优信息卡片功能
[x] 显示女优作品

男优¶

[x] 过滤与排序系统
[x] 展示系统，左键点击头像是跳到详情页，右键点击头像是跳到编辑页

男优编辑页¶

[ ] 基础信息的编辑

关系图¶

[x] 支持1w节点60帧率的力导向图模拟
[ ] 文字msdf预计算优化，现在文字需要延迟出现，汉字越多，出现的时间越晚
[ ] 手感优化，换积分器
[x] 点击跳转
[x] 悬浮显示图片与文字
[x] 悬浮与邻居高亮
[x] 渐变过度
[x] 各种可调的菜单
[ ] 菜单的属性持久化

暗黑界¶

里面可以看，但是不要编辑，后面为UGC公共知识库准备的

设置¶

[x] 主题设置，包括亮色与暗色主题，这个可以换主色，其他色主题
[x] 绿色模式
[x] 视频，添加本地的av的地址的文件夹地址，这个要随着版本迁移
[ ] 数据库相关设置
[x] 备份还原公共私有数据库，数据库清理碎片，图片一致性检查
[x] 重建私有库与公有库的连接
[x] 导出片商到json,从json导入片商

采集与浏览器插件¶

目前主要有三种方式采集/收藏作品数据：

浏览器插件采集（推荐）
安装 Firefox 插件（详见 README.md 中“插件安装”章节）。
启动软件后，打开 javdb / javlibrary / javtxt 等网站。
在页面中点击插件提供的“收藏/收录”按钮开始采集。
采集时会弹出 Firefox 窗口：
- 访问 javlibrary 第一次需要手动过一次 Cloudflare 盾，大约能维持约 20 分钟。
从本地视频反向识别
在 设置 -> 视频 中配置本地视频目录。
打开 管理 -> 批量操作 -> 查找本地视频并录入添加。
程序会：
- 扫描本地视频文件。
- 按文件名推断番号。
- 将结果加入爬虫列表，定时（约 20s 一次）尝试自动爬取信息。
提示：目前识别与匹配仍然比较不准，建议后续在管理界面中进行人工核对与修正。
手动添加番号
任何时候都可以使用快捷键 W 直接打开“快速添加作品”窗口。
手动输入番号与关键信息，适合针对性补录或特殊需求。

女优数据采集与更新¶

女优信息自动化采集目前准确度有限：
右键点击女优栏进入编辑界面，可以点击“爬虫”按钮尝试自动更新。
此方式仅适用于无同名女优的情况。
对于重名女优，建议通过浏览器插件手动选择正确的条目再更新。

浏览器插件¶

[ ] 端口冲突切换的问题没有解决，包括浏览器插件端与软件服务端
[x] 在javlib,javdb,javtxt上沉浸式采集
[ ] 未来添加更多网站
[ ] 女优的序号的采集，不过现在没有提示，同时应该是直采信息，应该是优先弄的

备份与迁移（版本更新相关）¶

软件升级或更换版本时，建议先做好备份，避免数据丢失。当前有两种方式：

手动迁移（旧版本 / 无迁移工具时）
直接复制旧版本中的：
- resources/public
- resources/private
覆盖到新版本的同名目录，即可沿用原有数据库。
使用内置备份/还原工具（新版本推荐方式）
在软件中使用：
- “备份私库” / “备份公库” 功能，将数据库导出到你选择的位置。
在新版本中：
- 使用“还原”功能，选择之前备份生成的 meta.json 和对应的 .db 文件。
- 完成还原后重启软件。
说明：目前仍无法做到完全无感迁移，部分情况下可能会有小问题，遇到异常可手动检查 resources/public / resources/private 中的数据文件。

更多关于数据库结构、安全与隐私的说明，请参考 Security。

六、快捷键¶

快捷键	功能说明
`C`	在女优界面或详细女优界面进行局部截图
`Shift+C`	对整个软件界面进行截图
`M`	快速添加自慰记录
`W`	快速添加作品 / 番号
`A`	快速添加晨勃记录
`L`	快速添加做爱记录

后续若增加新的快捷键，会在这里同步更新。