Skip to content

armgit / peach

Public Imported from GitHub
0

Peach: Local-first video metadata scraper and media manager.

6.8 KB
Raw Blame

kind: howto

管理标签

在标签页选择「本地」或「在线」,点击标题旁的铅笔图标进入管理模式;再次点击同一图标返回浏览。

两种模式共用页头搜索栏和标签筛选栏;管理模式可在筛选栏切换「使用中 / 已隐藏」,并按分类、标签云或字母表浏览。管理模式中的搜索支持名称和别名。

本地与在线标签都可点击星形按钮收藏或取消收藏。「我的收藏」的标签分类包含两种收藏;在线标签标明词表,点击后打开关注页的对应标签筛选。在线收藏随改名和合并归类更新。

重命名

在管理模式点击标签内的铅笔图标,输入名称,点击「预览影响范围」。确认资源数量和名称后,点击「重命名标签」。浏览模式保留收藏按钮;编辑入口仅在管理模式显示。

标签 ID 保持稳定,旧名称保留为别名。作品标注、来源词映射、收藏名称及单条资源的隐藏选择同步迁移;后续采集识别旧名时归到这条标签。名称已属于另一条标签时,使用合并操作。

合并

在管理模式选中至少两个标签,点击「合并」,选择保留的标签。预览显示资源数量和重叠关联数量,确认后执行。

同一资源只显示一次标签,来源关系和旧名称随保留的标签保存;保留标签的全局隐藏状态作为合并结果。合并不能直接撤销,写入前自动创建 SQLite 备份。

「整理重复标签」仅在存在重复项时显示,范围限于登记的同义词、显示名称及字符宽度等确定规则。含义相近的标签由使用者选择是否合并。

隐藏和恢复

选中标签后点击「隐藏」,预览范围并确认。隐藏选择覆盖已有资源和后续采集,来源证据继续保留。切到「已隐藏」,选中标签并点击「恢复」,可恢复浏览与筛选入口。单条资源上的隐藏选择独立保留。

在线内容的手动标签

标签浏览与标签管理默认每页显示 100 个标签,可切换为 50、100 或 200 个。分页只读取并显示当前页;管理中的选择跨页保留,搜索、分类、状态或视图变化时清空选择并回到首页。关注管理的标签页签提供独立搜索。

本地与在线详情共用标签行。点击「添加标签」的加号,搜索已有标签或输入名称新建;标签右侧的铅笔用于修改名称,叉号从当前内容隐藏标签。名称修改会预览影响范围,确认后作用于同一标签的全部内容,旧名称保留为别名。

手动标签和单条隐藏选择按来源与内容编号保存在本机用户设置中,来源更新时保留,来源 metadata 保留原词。一个作品有多个版本时,卡片和筛选项显示各版本的手动标签;详情中的添加和删除作用于当前版本,操作成功后可撤销。

按在线标签屏蔽内容

在「关注管理」的「标签管理」页签选择标签并点击「屏蔽内容」;标签页的在线管理模式也可使用。预览影响范围并确认后,带任一所选标签的内容及其其它版本会从关注列表、创作者在线作品和筛选项中隐藏;后续更新沿用这份选择。

在管理模式切到「已屏蔽内容」,选择标签并点击「恢复内容」,可解除屏蔽。标签更名和别名沿用同一身份;合并后的标签保留任一成员的内容屏蔽选择。直接打开内容详情仍可查看和管理标签。

「隐藏标签」控制标签的显示和筛选入口;「屏蔽内容」控制作品是否出现在浏览列表。两种选择独立保存。

接口与维护

在线标签的改名、合并和隐藏保存在本机用户设置,来源记录继续保留原词。标签页、关注页卡片、详情和筛选共用这份归类;旧名称仍可用于筛选,后续来源更新沿用已有成员的归类。在线合并只接受相同来源类型的标签,目标标签的隐藏状态作为结果;不同类型保持独立。隐藏标签可在管理模式的「已隐藏」中恢复。

GET /api/tag-management 返回标签 ID、名称、分类、别名、资源数量、隐藏状态和重复组。POST /api/tag-management/preview 只读预览;POST /api/tag-management 收到预览的 token 才执行写入。数据变化后计划失效,须重新预览。接口沿用登录验证和 ledger 写入角色门槛。

GET /api/tag-management 不带 limit 时返回完整的 items 和 duplicate_groups;带 limit 时启用分页,支持以下参数:

参数 含义
scope local 或 online,默认 local
limit / offset 每页条数和起始位置;条数限制为 1 至 600,格式无效时使用 20;起始位置至少为 0,格式无效时使用 0
q 搜索名称和别名,统一字符宽度、空白和大小写
category 分类键;空值或 all 表示全部分类
state active、hidden 或 blocked,默认 active;屏蔽状态优先于隐藏状态
view cloud 按资源数量倒序,alphabet 按归一化名称排序;默认 cloud,同值时按名称和标签身份稳定排序

分页响应包含当前页 items、筛选后的 total、has_more、实际 limit 和 offset。categories 是当前搜索和状态下的分类计数,不随选中的分类缩小;duplicate_groups 保留本地完整重复组,在线为空列表。搜索、状态、分类和排序均先于分页,超出末页时 items 为空且保留 total。完整词表复用查询缓存,按本地与在线分别保存;账本版本变化或写入触发缓存失效后重新读取。

浏览接口 GET /api/index?kind=tags 与 GET /api/follow/tags?types=all 返回 total,分别表示搜索及分类筛选后、搜索及来源类型筛选后的完整标签数。

写入会检查外键变化并拒绝本次操作新增的关联违规;已有的历史引用记录保持独立。

在线词表的读取参数和操作请求使用 scope=online;在线标签 ID 是稳定的来源词键,本地标签 ID 是实体 ID。

在线管理支持 block/unblock 操作,返回的标签包含 blocked 状态。POST /api/follow/tag 接受 id、operation=add|remove|restore 和 tag,返回当前条目及其作品组;remove 保存单条隐藏选择,restore 用于撤销来源标签的隐藏。接口沿用登录、同源和 ledger 写入角色门槛。标签名为 1 至 80 个字符,不含逗号或控制字符;每条内容最多 100 个手动标签。普通内容响应包含 custom_tags 和 blocked_tags,来源 metadata 保持原词。

维护脚本 scripts/repair_duplicate_tags.py 默认生成复核 CSV;真实写入须同时提供 --apply 与 --backup。脚本与页面复用同一套判据和写入逻辑。备份与真实库操作约定见运行与配置。