darktable中标签与星级未同步是因操作路径错误或数据库异常，需按步骤创建标签、批量标记、设置评分、组合筛选，并通过刷新视图修复显示问题。
如果您在darktable中需要对大量照片进行快速分类与优先级排序，但发现标签和星级评分功能使用混乱或无法同步生效，则可能是由于操作路径不准确或数据库状态异常。以下是解决此问题的步骤：
一、创建与应用照片标签
标签是darktable中实现非层级或层级化分类的核心机制，所有标签数据持久化存储于library.db的tags表中，并通过tagged_images表建立图像与标签的多对多映射关系。正确创建和应用标签可确保后续筛选与批量操作可靠执行。
1、在lighttable视图中，使用鼠标左键单击选中一张或多张目标图像。
2、点击右侧元数据面板（Metadata）中的标签输入框，输入新标签名称（如“人像”、“阴天”、“2023_大理”）。
3、按回车键确认，系统将自动在tags表中注册该标签，并在tagged_images表中写入关联记录。
4、若需为已存在标签添加子级结构（如“2023/大理古城”），直接输入含斜杠的完整路径，darktable会依src/common/database.c中定义的触发器自动构建父子关系。
二、批量添加标签至多张图像
批量标签操作可避免逐张重复输入，适用于按事件、场景或质量维度统一归类。该操作直接调用数据库插入语句，绕过XMP sidecar文件写入以提升效率，适用于数千张图像的快速标记。
1、在lighttable视图中，按住Ctrl键并依次点击多张图像，或拖动鼠标框选连续区域。
2、右键所选图像，在弹出菜单中选择“添加标签”（Add tag）。
3、在弹出的标签选择窗口中，勾选已有标签或输入新标签名后回车。
4、确认后，所有选中图像将立即获得该标签，且tagged_images表同步更新，无需手动刷新。
三、设置与修改星级评分
星级评分存储于meta_data表的rating字段，取值范围为0–5，支持整数评级。该字段被lighttable视图的网格布局与筛选器直接读取，是排序与集合过滤的关键依据。
1、在lighttable视图中，确保图像处于选中状态（单张或多张）。
2、按下键盘数字键1至5，对应设置1星至5星评分；按0键清除评分。
3、若需批量修改，先选中全部目标图像，再按对应数字键，所有图像的rating字段将统一更新。
4、评分变更实时写入数据库，无需额外保存操作，关闭darktable后仍保持有效。
四、组合使用标签与星级实现智能筛选
darktable的筛选面板（Filter）基于SQLite查询引擎，支持对tags与meta_data表进行联合检索。通过组合标签与星级条件，可精准定位高优先级素材，例如“已标记‘婚礼’且评分为4星以上”的图像。
1、点击lighttable视图左侧面板顶部的漏斗图标，打开筛选面板。
2、在“标签”筛选器下拉菜单中，选择一个或多个标签（按住Ctrl可多选）。
3、在“评级”筛选器中，点击星级图标设定最小评分阈值（如≥4）。
4、点击“应用筛选”，中央预览区将仅显示同时满足全部条件的照片，缩略图右上角显示匹配的星级与标签标识。
五、修复标签或评分未显示问题
当标签或星级在lighttable视图中不显示，但数据库已确认写入时，通常由界面缓存未刷新或缩略图元数据未加载导致。该问题不影响实际数据完整性，仅影响视觉反馈。
1、按下Ctrl+R强制重载当前视图，触发元数据重新读取。
2、若仍不显示，点击顶部菜单栏“视图”→“刷新缩略图”（Refresh thumbnails）。
3、检查右侧面板“元数据”是否展开，确认标签输入框内是否存在已输入但未回车确认的内容。
4、运行命令行指令darktable --conf cache.enabled=FALSE临时禁用缩略图缓存，验证是否为缓存污染所致。
