Method validateHighlight

src/storage/DataValidator.ts:65–128

* 验证单个高亮 * @param id 高亮ID * @param highlight 高亮数据 * @returns 错误列表

(id: string, highlight: unknown)

     * @returns 错误列表
     */
    static validateHighlight(id: string, highlight: unknown): string[] {
        const errors: string[] = [];

        if (!this.isRecord(highlight)) {
            errors.push(`高亮 ${id}: 数据必须是对象`);
            return errors;
        }

        // 必需字段验证
        if (!highlight.text || typeof highlight.text !== 'string') {
            errors.push(`高亮 ${id}: 缺少有效的text字段`);
        }

        if (typeof highlight.position !== 'number') {
            errors.push(`高亮 ${id}: position必须是数字`);
        }

        if (typeof highlight.created !== 'number') {
            errors.push(`高亮 ${id}: created必须是数字`);
        }

        if (typeof highlight.updated !== 'number') {
            errors.push(`高亮 ${id}: updated必须是数字`);
        }

        // 可选字段验证
        if (highlight.backgroundColor && typeof highlight.backgroundColor !== 'string') {
            errors.push(`高亮 ${id}: backgroundColor必须是字符串`);
        }

        if (highlight.blockId && typeof highlight.blockId !== 'string') {
            errors.push(`高亮 ${id}: blockId必须是字符串`);
        }

        if (highlight.contextBefore && typeof highlight.contextBefore !== 'string') {
            errors.push(`高亮 ${id}: contextBefore必须是字符串`);
        }

        if (highlight.contextAfter && typeof highlight.contextAfter !== 'string') {
            errors.push(`高亮 ${id}: contextAfter必须是字符串`);
        }

        if (highlight.textFingerprint && typeof highlight.textFingerprint !== 'string') {
            errors.push(`高亮 ${id}: textFingerprint必须是字符串`);
        }

        if (highlight.isCloze && typeof highlight.isCloze !== 'boolean') {
            errors.push(`高亮 ${id}: isCloze必须是布尔值`);
        }

        // 验证评论数组
        if (highlight.comments) {
            if (!Array.isArray(highlight.comments)) {
                errors.push(`高亮 ${id}: comments必须是数组`);
            } else {
                highlight.comments.forEach((comment: unknown, index: number) => {
                    const commentErrors = this.validateComment(comment, `${id}.comments[${index}]`);
                    errors.push(...commentErrors);