release: v1.4.0 — 标签系统、操作日志扩展与文档截图更新

- 每用户标签与彩色打标，图库 OR/AND 筛选与批量打标
- 操作日志记录登录、删除、设置与标签操作
- API 标签/打标接口；README 与文档站截图同步

server/utils/image-query.ts

@@ -1,5 +1,6 @@
 import { getStorageBackendRow } from './storage-backends'
 import { ALLOWED_MIME_TYPES } from './constants'
+import { parseTagIdsParam, type TagFilterInput } from './tags'
 
 export function readBackendIdQuery(
   query: Record<string, unknown>
@@ -26,3 +27,30 @@ export function readUploadSourceQuery(
   if (raw === 'web' || raw === 'api') return raw
   return null
 }
+
+export function readTagFilterQuery(
+  query: Record<string, unknown>
+): TagFilterInput | null | undefined {
+  const untaggedRaw = query.untagged
+  const untaggedOnly = untaggedRaw === '1'
+    || untaggedRaw === 'true'
+    || untaggedRaw === true
+
+  const tagIds = parseTagIdsParam(query.tagIds ?? query.tagId)
+  const tagModeRaw = typeof query.tagMode === 'string' ? query.tagMode.trim().toLowerCase() : ''
+  const tagMode = tagModeRaw === 'and' ? 'and' : 'or'
+
+  if (untaggedOnly && tagIds.length) {
+    return null
+  }
+
+  if (!untaggedOnly && !tagIds.length) {
+    return undefined
+  }
+
+  return {
+    tagIds: tagIds.length ? tagIds : undefined,
+    tagMode,
+    untaggedOnly: untaggedOnly || undefined
+  }
+}