@dinoxx/dinox-cli 1.0.19 → 1.0.21

package/dist/utils/noteContentEngine.js

@@ -0,0 +1,740 @@
+import { generateId } from './id.js';
+export class NoteContentEditError extends Error {
+    code;
+    details;
+    constructor(code, message, details) {
+        super(message);
+        this.code = code;
+        this.details = details;
+        this.name = 'NoteContentEditError';
+    }
+}
+export const NOTE_CONTENT_EDIT_OPERATION_TYPES = ['insertBlocksAfter', 'insertBlocksBefore', 'replaceBlocks', 'deleteBlocks', 'replaceText', 'updateBlockAttrs', 'replaceContainerContent'];
+const INLINE = new Set(['text', 'hardBreak', 'mention', 'emoji', 'bidlink', 'hashtag', 'location', 'time', 'inlineMath']);
+const ATOMIC = new Set(['image', 'video', 'audio', 'file', 'bookmark', 'iframe', 'mermaid', 'mindgraph', 'blockMath', 'math']);
+const CONTAINER = new Set(['table', 'pdfAnnotation', 'audiosegment']);
+const ANCHOR_KEYS = ['anchorKey', 'data-toc-id', 'id', 'uniqueId'];
+const HASH_IGNORED_ATTRS = new Set(['anchorKey', 'data-toc-id', '_hash']);
+const EMPTY_DOC = { type: 'doc', content: [{ type: 'paragraph', content: [] }] };
+const SAFE_ATTRS = {
+    paragraph: ['anchorKey', 'id', 'uniqueId'], heading: ['anchorKey', 'id', 'uniqueId', 'level'], bulletList: ['anchorKey', 'id', 'uniqueId'], orderedList: ['anchorKey', 'id', 'uniqueId'], taskList: ['anchorKey', 'id', 'uniqueId'], blockquote: ['anchorKey', 'id', 'uniqueId'], codeBlock: ['anchorKey', 'id', 'uniqueId', 'language', 'lang'], horizontalRule: ['anchorKey', 'id', 'uniqueId'], table: ['anchorKey', 'id', 'uniqueId'], image: ['anchorKey', 'id', 'uniqueId', 'src', 'resourceId', 'storageKey', 'alt', 'title', 'caption', 'showCaption'], video: ['anchorKey', 'id', 'uniqueId', 'src', 'resourceId', 'storageKey', 'poster', 'title', 'autoplay', 'loop', 'muted', 'playsInline'], audio: ['anchorKey', 'id', 'uniqueId', 'src', 'resourceId', 'storageKey', 'title', 'preload'], file: ['anchorKey', 'id', 'uniqueId', 'src', 'resourceId', 'storageKey', 'name', 'type', 'mimeType', 'size'], mermaid: ['anchorKey', 'id', 'uniqueId', 'code'], mindgraph: ['anchorKey', 'id', 'uniqueId', 'markdown'],
+};
+const PATCHABLE_ATTRS = { image: ['alt', 'title', 'caption', 'showCaption'], video: ['title', 'poster', 'autoplay', 'loop', 'muted', 'playsInline'], audio: ['title', 'preload'], mermaid: ['code'], mindgraph: ['markdown'] };
+export function normalizeTiptapDocument(value) {
+    const sanitized = sanitizeNode(coerceDocument(parseMaybeJson(value)));
+    if (!node(sanitized) || sanitized.type !== 'doc')
+        return clone(EMPTY_DOC);
+    return Array.isArray(sanitized.content) && sanitized.content.length ? sanitized : clone(EMPTY_DOC);
+}
+export function buildNoteEditContext(input) {
+    const document = normalizeTiptapDocument(input.document ?? input.contentJson);
+    const blocks = topNodes(document).map((block, index) => {
+        const anchorId = anchor(block) ?? `pos-${index}`;
+        const text = plainText(block).trim();
+        return { anchorId, hasStableAnchor: Boolean(anchor(block)), nodeIndex: index, nodeRange: `${index}:${index + 1}`, type: block.type, editMode: mode(block.type), level: num(block.attrs?.level), text, textPreview: text.slice(0, 1_000), textHash: hashString(text), nodeHash: hashNode(block), charCount: text.length, attrs: safeAttrs(block) };
+    });
+    const totalCharCount = blocks.reduce((sum, block) => sum + block.charCount, 0);
+    return { noteId: input.noteId, title: input.title ?? '', contentHash: hashStable(document), updatedAt: input.updatedAt ?? null, version: input.version ?? null, document, blocks, chunks: chunks(blocks), totalCharCount, estimatedTokens: Math.ceil(totalCharCount / 2.5) };
+}
+export function applyNoteEditPatch(input) {
+    const before = buildNoteEditContext(input);
+    validatePatch(input.patch, before.contentHash, input.updatedAt, input.version);
+    const blocks = clone(topNodes(before.document));
+    const resolved = input.patch.operations.map((operation, order) => ({ ...resolveOperation(operation, before.blocks), operation, order }));
+    assertNoRangeConflicts(resolved);
+    for (const item of [...resolved].sort((a, b) => b.startIndex - a.startIndex || b.order - a.order))
+        applyResolved(blocks, item);
+    const document = withStableAnchors(normalizeTiptapDocument({ ...before.document, content: blocks.length ? blocks : [{ type: 'paragraph', content: [] }] }), input.createAnchorId);
+    const projection = projectNoteContent(document);
+    const after = buildNoteEditContext({ ...input, document: projection.document });
+    return { noteId: input.noteId, changed: before.contentHash !== projection.contentHash, before, after, projection, appliedOperations: resolved.length, operationResults: resolved.map((item) => ({ operationIndex: item.order, type: item.operation.op, success: true, target: describeTarget(item.operation.target), nodeRange: `${item.startIndex}:${item.endIndex}`, error: null })).sort((a, b) => a.operationIndex - b.operationIndex) };
+}
+export function projectNoteContent(document) {
+    const sanitized = normalizeTiptapDocument(document);
+    const metadata = metadataFrom(sanitized);
+    return { document: sanitized, content_json: stableStringify(sanitized), content_text: contentText(plainText(sanitized)), content_md: markdown(sanitized), images: JSON.stringify(metadata.images), bid_links: JSON.stringify(metadata.bidLinks), contentHash: hashStable(sanitized) };
+}
+export function topNodes(document) {
+    return Array.isArray(document.content) ? document.content.filter(node) : [];
+}
+export function parseNodeRangeString(spec, total) {
+    const [a, b] = String(spec ?? '').split(':');
+    let start = a?.trim() ? Number(a) : 0;
+    let end = b?.trim() ? Number(b) : total;
+    if (!Number.isFinite(start) || start < 0)
+        start = 0;
+    if (!Number.isFinite(end) || end < 0)
+        end = total;
+    if (end < start)
+        [start, end] = [end, start];
+    return { start: Math.max(0, Math.min(total, Math.floor(start))), end: Math.max(0, Math.min(total, Math.floor(end))) };
+}
+export function serializeAnchoredMarkdown(nodes, blocks, startIndex = 0) {
+    return nodes.map((block, offset) => {
+        const index = startIndex + offset;
+        const descriptor = blocks[index];
+        const attrs = safeAttrs(block);
+        const header = [`block=${escapeComment(descriptor?.anchorId ?? anchor(block) ?? `pos-${index}`)}`, `index=${index}`, `type=${escapeComment(block.type)}`, `mode=${escapeComment(descriptor?.editMode ?? mode(block.type))}`, descriptor?.textHash ? `hash=${descriptor.textHash}` : '', descriptor?.nodeHash ? `nodeHash=${descriptor.nodeHash}` : '', descriptor?.hasStableAnchor === false ? 'unstableAnchor=true' : '', attrs ? `attrs=${escapeComment(JSON.stringify(attrs))}` : ''].filter(Boolean).join(' ');
+        return `<!-- ${header} -->\n${markdown({ type: 'doc', content: [block] }) || `[${block.type}]`}`;
+    }).join('\n\n').trim();
+}
+export function serializeAnchoredShorthand(nodes, blocks, startIndex = 0) {
+    return nodes.map((block, offset) => {
+        const index = startIndex + offset;
+        const descriptor = blocks[index];
+        const editMode = descriptor?.editMode ?? mode(block.type);
+        const attrs = compactAttrs(safeAttrs(block), block.type);
+        const header = [`@${index}`, `a=${token(descriptor?.anchorId ?? anchor(block) ?? `pos-${index}`)}`, `t=${token(block.type)}`, `m=${token(editMode)}`, descriptor?.textHash ? `h=${token(descriptor.textHash)}` : '', descriptor?.nodeHash ? `nh=${token(descriptor.nodeHash)}` : '', descriptor?.hasStableAnchor === false ? 'unstable=1' : '', attrs ? `attrs=${token(JSON.stringify(attrs))}` : ''].filter(Boolean).join(' ');
+        const body = editMode === 'text' ? markdown({ type: 'doc', content: [block] }) : `[${editMode}:${block.type}] protected block`;
+        return [header, body].filter(Boolean).join('\n');
+    }).join('\n\n').trim();
+}
+export function blockTextHash(blocks, start, end) {
+    return start + 1 === end ? blocks[start]?.textHash ?? '' : hashString(blocks.slice(start, end).map((block) => block.text).join('\n\n').trim());
+}
+export function blockNodeHash(blocks, start, end) {
+    return start + 1 === end ? blocks[start]?.nodeHash ?? '' : hashStable(blocks.slice(start, end).map((block) => block.nodeHash));
+}
+export function getNoteContentReadInstructions() {
+    return 'dinox-shorthand is the preferred read format. Each header has @index, a=anchorId, t=node type, m=edit mode, h=text hash, nh=node hash. For noteContentEdit, pass preferredTarget when possible. Use replaceText only for short exact substitutions; use replaceBlocks for long rewrites. Treat atomicBlock/container/unsupported as protected.';
+}
+export function getNoteContentSchemaSummary() {
+    return { version: 'dinox-note-ai-schema-2026-05-v1', readFormat: 'dinox-shorthand', editProtocol: 'structured-operations', operations: [...NOTE_CONTENT_EDIT_OPERATION_TYPES] };
+}
+function parseMaybeJson(value, depth = 0) {
+    if (typeof value !== 'string')
+        return value;
+    const trimmed = value.trim();
+    if (!trimmed || trimmed === 'null' || trimmed === 'undefined')
+        return null;
+    try {
+        const parsed = JSON.parse(trimmed);
+        return typeof parsed === 'string' && depth < 2 ? parseMaybeJson(parsed, depth + 1) : parsed;
+    }
+    catch {
+        return value;
+    }
+}
+function coerceDocument(value) {
+    if (Array.isArray(value))
+        return { type: 'doc', content: value.filter(node) };
+    if (!node(value))
+        return clone(EMPTY_DOC);
+    if (value.type === 'doc')
+        return clone(value);
+    return INLINE.has(value.type) ? { type: 'doc', content: [{ type: 'paragraph', content: [clone(value)] }] } : { type: 'doc', content: [clone(value)] };
+}
+function sanitizeNode(value) {
+    if (!node(value) || !value.type)
+        return null;
+    if (value.type === 'text') {
+        const text = typeof value.text === 'string' ? value.text : '';
+        return text ? withoutContent({ ...value, type: 'text', text, marks: marks(value.marks) }) : null;
+    }
+    if (value.type === 'doc')
+        return normalizeRoot(value);
+    if (value.type === 'paragraph')
+        return normalizeParagraph(value);
+    if (value.type === 'listItem' || value.type === 'taskItem')
+        return normalizeListItem(value);
+    const next = withoutContent(value);
+    if (Array.isArray(value.content))
+        next.content = flatten(value.content);
+    return next;
+}
+function normalizeRoot(value) {
+    const content = [];
+    let inline = [];
+    const flush = () => { if (inline.length)
+        content.push({ type: 'paragraph', content: inline }); inline = []; };
+    for (const child of flatten(value.content))
+        INLINE.has(child.type) ? inline.push(child) : (flush(), content.push(child));
+    flush();
+    return { type: 'doc', ...(value.attrs ? { attrs: value.attrs } : {}), content };
+}
+function normalizeParagraph(value) {
+    const content = [];
+    let inline = [];
+    let usedAttrs = false;
+    const flush = () => { if (!inline.length)
+        return; content.push({ type: 'paragraph', ...(value.attrs && !usedAttrs ? { attrs: value.attrs } : {}), content: inline }); usedAttrs = true; inline = []; };
+    for (const child of flatten(value.content))
+        INLINE.has(child.type) ? inline.push(child) : (flush(), content.push(child));
+    flush();
+    return content.length ? content : [{ type: 'paragraph', ...(value.attrs ? { attrs: value.attrs } : {}), content: [] }];
+}
+function normalizeListItem(value) {
+    const next = withoutContent(value);
+    const content = flatten(value.content);
+    next.content = content[0]?.type === 'paragraph' ? content : [{ type: 'paragraph', content: [] }, ...content];
+    return next;
+}
+function flatten(content) {
+    return Array.isArray(content) ? content.flatMap((child) => {
+        const current = sanitizeNode(child);
+        return !current ? [] : Array.isArray(current) ? current : [current];
+    }) : [];
+}
+function validatePatch(patch, contentHash, updatedAt, version) {
+    if (!patch?.base?.contentHash)
+        throw err('invalid_plan', 'AI 编辑补丁缺少 base.contentHash，请先读取笔记内容');
+    if (!Array.isArray(patch.operations) || patch.operations.length === 0)
+        throw err('invalid_plan', 'AI 编辑补丁至少需要一个操作');
+    if (patch.operations.length > 50)
+        throw err('invalid_plan', 'AI 编辑补丁一次最多允许 50 个操作');
+    if (patch.base.contentHash !== contentHash)
+        throw err('content_conflict', '笔记内容已变化，请重新读取后再编辑');
+    if (patch.base.updatedAt && patch.base.updatedAt !== (updatedAt ?? null))
+        throw err('content_conflict', '笔记更新时间已变化，请重新读取后再编辑');
+    if (typeof patch.base.version === 'number' && patch.base.version !== (version ?? null))
+        throw err('content_conflict', '笔记版本已变化，请重新读取后再编辑');
+    for (const operation of patch.operations) {
+        if (!NOTE_CONTENT_EDIT_OPERATION_TYPES.includes(operation?.op))
+            throw err('invalid_plan', `不支持的 AI 编辑操作: ${String(operation?.op ?? '')}`);
+        if (!operation.target)
+            throw err('invalid_plan', `${operation.op} 缺少 target`);
+        if (['insertBlocksAfter', 'insertBlocksBefore', 'replaceBlocks', 'replaceContainerContent'].includes(operation.op) && (!('blocks' in operation) || !operation.blocks?.length))
+            throw err('invalid_plan', `${operation.op} 需要 blocks`);
+        if (operation.op === 'replaceText' && (!operation.matchText || typeof operation.replacementText !== 'string'))
+            throw err('invalid_plan', 'replaceText 需要 matchText 和 replacementText');
+    }
+}
+function resolveOperation(operation, blocks) {
+    const range = resolveTarget(operation.target, blocks);
+    validateTarget(operation, blocks, range.startIndex, range.endIndex);
+    validateProtected(operation, blocks.slice(range.startIndex, range.endIndex));
+    return range;
+}
+function resolveTarget(target, blocks) {
+    const anchors = target.anchorIds?.length ? target.anchorIds : target.anchorId ? [target.anchorId] : [];
+    if (anchors.length) {
+        const indexes = anchors.map((id) => blocks.find((block) => block.anchorId === id)?.nodeIndex);
+        if (indexes.every((index) => typeof index === 'number')) {
+            const sorted = indexes.sort((a, b) => a - b);
+            const range = { startIndex: sorted[0] ?? 0, endIndex: (sorted.at(-1) ?? 0) + 1 };
+            if (targetMatches(target, blocks, range.startIndex, range.endIndex))
+                return range;
+        }
+    }
+    if (target.nodeRange?.trim()) {
+        const parsed = parseNodeRangeString(target.nodeRange, blocks.length);
+        if (parsed.start !== parsed.end && targetMatches(target, blocks, parsed.start, parsed.end))
+            return { startIndex: parsed.start, endIndex: parsed.end };
+    }
+    if (typeof target.nodeIndex === 'number') {
+        const index = Math.floor(target.nodeIndex);
+        if (index < 0 || index >= blocks.length)
+            throw err('target_not_found', '目标 nodeIndex 超出范围');
+        if (targetMatches(target, blocks, index, index + 1))
+            return { startIndex: index, endIndex: index + 1 };
+    }
+    const hashMatch = uniqueHash(blocks, target.expectedNodeHash, 'node') ?? uniqueHash(blocks, target.expectedTextHash, 'text');
+    if (hashMatch)
+        return hashMatch;
+    if (target.textMatch?.trim()) {
+        const needle = target.textMatch.toLowerCase().trim();
+        const matches = blocks.filter((block) => block.text.toLowerCase().includes(needle));
+        if (matches.length > 1)
+            throw err('target_not_found', '目标文本匹配多个块，请使用 nodeRange 或 hash 重新定位');
+        if (matches[0] && targetMatches(target, blocks, matches[0].nodeIndex, matches[0].nodeIndex + 1))
+            return { startIndex: matches[0].nodeIndex, endIndex: matches[0].nodeIndex + 1 };
+    }
+    throw err('target_not_found', anchors.length ? '目标 anchorId 不存在，且无法通过 nodeRange/hash/textMatch 唯一恢复' : '无法解析 AI 编辑目标');
+}
+function validateTarget(operation, blocks, start, end) {
+    if (operation.target.expectedNodeHash && operation.target.expectedNodeHash !== blockNodeHash(blocks, start, end))
+        throw err('target_conflict', '目标节点 hash 不匹配，请重新读取后再编辑');
+    if (!operation.target.expectedNodeHash && operation.target.expectedTextHash && operation.target.expectedTextHash !== blockTextHash(blocks, start, end))
+        throw err('target_conflict', '目标文本 hash 不匹配，请重新读取后再编辑');
+    if (operation.target.expectedTextSnippet && !blocks.slice(start, end).map((block) => block.text).join('\n\n').includes(operation.target.expectedTextSnippet))
+        throw err('target_conflict', '目标文本片段不匹配，请重新读取后再编辑');
+    if (operation.op === 'replaceText' && end - start !== 1)
+        throw err('invalid_plan', 'replaceText 只能作用于单个块；多块结构调整请使用 replaceBlocks');
+    if ((operation.op === 'updateBlockAttrs' || operation.op === 'replaceContainerContent') && end - start !== 1)
+        throw err('invalid_plan', `${operation.op} 只能作用于单个块`);
+}
+function validateProtected(operation, targetBlocks) {
+    if (!targetBlocks.length)
+        return;
+    if (operation.op === 'updateBlockAttrs') {
+        if (!PATCHABLE_ATTRS[targetBlocks[0].type]?.length)
+            throw err('invalid_plan', '目标节点不支持属性更新');
+        return;
+    }
+    if (operation.op === 'replaceText' && targetBlocks.some((block) => block.editMode !== 'text'))
+        throw err('invalid_plan', '非文本/受保护节点不能使用 replaceText；请使用安全的结构化块操作');
+    const protectedBlocks = targetBlocks.filter((block) => block.editMode !== 'text');
+    if (protectedBlocks.length && operation.op === 'deleteBlocks' && !operation.allowProtectedDelete)
+        throw err('invalid_plan', '目标包含原子/容器节点；删除时必须显式设置 allowProtectedDelete');
+    if (protectedBlocks.length && operation.op === 'replaceBlocks' && !operation.allowProtectedReplace)
+        throw err('invalid_plan', '目标包含原子/容器节点；替换时必须显式设置 allowProtectedReplace');
+}
+function applyResolved(blocks, item) {
+    const { operation, startIndex, endIndex } = item;
+    if (operation.op === 'insertBlocksAfter')
+        blocks.splice(endIndex, 0, ...specs(operation.blocks));
+    if (operation.op === 'insertBlocksBefore')
+        blocks.splice(startIndex, 0, ...specs(operation.blocks));
+    if (operation.op === 'replaceBlocks')
+        blocks.splice(startIndex, endIndex - startIndex, ...specs(operation.blocks));
+    if (operation.op === 'deleteBlocks')
+        blocks.splice(startIndex, endIndex - startIndex);
+    if (operation.op === 'replaceText')
+        blocks[startIndex] = replaceText(blocks[startIndex], operation);
+    if (operation.op === 'updateBlockAttrs')
+        blocks[startIndex] = { ...blocks[startIndex], attrs: { ...(blocks[startIndex].attrs ?? {}), ...patchAttrs(blocks[startIndex].type, operation.attrs) } };
+    if (operation.op === 'replaceContainerContent')
+        blocks[startIndex] = { ...blocks[startIndex], content: specs(operation.blocks) };
+}
+function specs(values) {
+    if (!Array.isArray(values) || values.length === 0)
+        throw err('invalid_content', '块编辑操作需要 blocks');
+    if (values.length > 100)
+        throw err('invalid_content', '单个操作最多允许 100 个块');
+    return values.map((value) => normalizeTiptapDocument({ type: 'doc', content: [spec(value)] }).content?.[0] ?? { type: 'paragraph', content: [] });
+}
+function spec(value) {
+    if (value.type === 'paragraph')
+        return { type: 'paragraph', content: inline(value) };
+    if (value.type === 'heading')
+        return { type: 'heading', attrs: { level: headingLevel(value.level) }, content: inline(value) };
+    if (value.type === 'blockquote')
+        return { type: 'blockquote', content: [{ type: 'paragraph', content: inline(value) }] };
+    if (value.type === 'bulletList' || value.type === 'orderedList')
+        return { type: value.type, content: listItems(value.items).map((item) => ({ type: 'listItem', content: [{ type: 'paragraph', content: textInline(item) }] })) };
+    if (value.type === 'taskList')
+        return { type: 'taskList', content: taskItems(value.items).map((item) => ({ type: 'taskItem', attrs: { id: generateId(), checked: item.checked }, content: [{ type: 'paragraph', content: textInline(item.text) }] })) };
+    if (value.type === 'codeBlock')
+        return { type: 'codeBlock', attrs: attr({ language: lang(value.language) }), content: textInline(text(value.text, 'codeBlock.text', true)) };
+    if (value.type === 'horizontalRule')
+        return { type: 'horizontalRule' };
+    if (value.type === 'image')
+        return { type: 'image', attrs: attr({ src: optUrl(value.src, 'image.src'), alt: opt(value.alt, 'image.alt', 500), title: opt(value.title, 'image.title', 500), resourceId: opt(value.resourceId, 'image.resourceId', 500), storageKey: opt(value.storageKey, 'image.storageKey', 1_000), caption: opt(value.caption, 'image.caption', 50_000), showCaption: bool(value.showCaption) }) };
+    if (value.type === 'video' || value.type === 'audio')
+        return { type: value.type, attrs: attr({ src: optUrl(value.src, `${value.type}.src`), title: opt(value.title, `${value.type}.title`, 500), poster: optUrl(value.poster, 'video.poster'), preload: opt(value.preload, 'audio.preload', 40), resourceId: opt(value.resourceId, `${value.type}.resourceId`, 500), storageKey: opt(value.storageKey, `${value.type}.storageKey`, 1_000), autoplay: bool(value.autoplay), loop: bool(value.loop), muted: bool(value.muted), playsInline: bool(value.playsInline) }) };
+    if (value.type === 'file')
+        return { type: 'file', attrs: attr({ id: opt(value.id, 'file.id', 500) ?? generateId(), src: optUrl(value.src, 'file.src'), name: opt(value.name, 'file.name', 500) ?? '未命名文件', type: opt(value.mimeType, 'file.mimeType', 200) ?? 'application/octet-stream', size: number(value.size, 'file.size'), resourceId: opt(value.resourceId, 'file.resourceId', 500), storageKey: opt(value.storageKey, 'file.storageKey', 1_000) }) };
+    if (value.type === 'table')
+        return tableSpec(value.rows);
+    if (value.type === 'mermaid')
+        return { type: 'mermaid', attrs: { code: text(value.code, 'mermaid.code', true) } };
+    if (value.type === 'mindgraph')
+        return { type: 'mindgraph', attrs: { markdown: text(value.markdown, 'mindgraph.markdown', true) } };
+    throw err('invalid_content', '不支持的块类型');
+}
+function markdown(document) {
+    return topNodes(document).map((block) => blockMarkdown(block, 0)).filter(Boolean).join('\n\n').trim();
+}
+function blockMarkdown(block, depth) {
+    const body = inlineMarkdown(block.content ?? []);
+    if (block.type === 'paragraph')
+        return body;
+    if (block.type === 'heading')
+        return `${'#'.repeat(headingLevel(block.attrs?.level))} ${body}`.trim();
+    if (block.type === 'blockquote')
+        return topNodes({ type: 'doc', content: block.content ?? [] }).map((child) => blockMarkdown(child, depth)).join('\n').split('\n').map((line) => `> ${line}`).join('\n');
+    if (block.type === 'codeBlock')
+        return `\`\`\`${str(block.attrs?.language) || str(block.attrs?.lang)}\n${plainText(block)}\n\`\`\``;
+    if (block.type === 'bulletList' || block.type === 'orderedList')
+        return listMarkdown(block, depth, block.type === 'bulletList' ? '-' : '1.');
+    if (block.type === 'taskList')
+        return taskMarkdown(block, depth);
+    if (block.type === 'horizontalRule')
+        return '---';
+    if (block.type === 'table')
+        return tableMarkdown(block);
+    if (block.type === 'image')
+        return imageMarkdown(block);
+    if (block.type === 'mermaid')
+        return fenced('mermaid', str(block.attrs?.code));
+    if (block.type === 'mindgraph')
+        return fenced('mindgraph', str(block.attrs?.markdown));
+    if (ATOMIC.has(block.type))
+        return placeholder(block.type, block, semantic(block));
+    return body || topNodes({ type: 'doc', content: block.content ?? [] }).map((child) => blockMarkdown(child, depth)).join('\n\n');
+}
+function inlineMarkdown(nodes) {
+    return nodes.map((item) => {
+        if (item.type === 'text')
+            return markedText(item);
+        if (item.type === 'hardBreak')
+            return '\n';
+        if (item.type === 'hashtag')
+            return `#${str(item.attrs?.fullPath) || str(item.attrs?.path) || str(item.attrs?.label) || str(item.attrs?.id)}`;
+        if (item.type === 'bidlink')
+            return str(item.attrs?.label) && str(item.attrs?.id) ? `[[${str(item.attrs?.label)}|${str(item.attrs?.id)}]]` : str(item.attrs?.label) || `[[${str(item.attrs?.id)}]]`;
+        if (item.type === 'inlineMath')
+            return `$${plainText(item) || str(item.attrs?.text) || str(item.attrs?.latex) || str(item.attrs?.code)}$`;
+        return semantic(item) || plainText(item);
+    }).join('');
+}
+function plainText(value) {
+    if (!value)
+        return '';
+    if (Array.isArray(value))
+        return value.map(plainText).filter(Boolean).join('\n');
+    if (value.type === 'text')
+        return str(value.text);
+    if (value.type === 'hardBreak')
+        return '\n';
+    const label = semantic(value);
+    if (label)
+        return label;
+    const joiner = value.type === 'paragraph' || value.type === 'heading' || value.type === 'codeBlock' ? '' : INLINE.has(value.type) ? '' : '\n';
+    return (value.content ?? []).map(plainText).filter(Boolean).join(joiner);
+}
+function contentText(value) {
+    return value.replace(/\r\n/g, '\n').split('\n').map((line) => line.trim()).filter(Boolean).filter((line) => !/^\[[^\]]+\]:\s*(?:<)?https?:\/\/\S+/i.test(line)).filter((line) => !/^(https?:\/\/|www\.)\S+$/i.test(line)).join(' ').replace(/\[\^[^\]]+\]/g, '').replace(/\[(\d{1,4})\]/g, '').replace(/\bhttps?:\/\/\S+/gi, '').replace(/\bwww\.\S+/gi, '').replace(/\s{2,}/g, ' ').trim().slice(0, 300);
+}
+function tableSpec(rows) {
+    if (!Array.isArray(rows) || !rows.length || rows.length > 200)
+        throw err('invalid_content', 'table.rows 数量无效');
+    const width = Math.max(...rows.map((row) => Array.isArray(row.cells) ? row.cells.length : 0));
+    if (!width || width > 50)
+        throw err('invalid_content', 'table.rows.cells 数量无效');
+    return { type: 'table', content: rows.map((row, rowIndex) => ({ type: 'tableRow', content: Array.from({ length: width }, (_, cellIndex) => ({ type: row.header === true || rowIndex === 0 ? 'tableHeader' : 'tableCell', content: [{ type: 'paragraph', content: textInline(text(row.cells[cellIndex] ?? '', 'table.cell')) }] })) })) };
+}
+function tableMarkdown(block) {
+    const rows = (block.content ?? []).filter((row) => row.type === 'tableRow').map((row) => row.content ?? []);
+    if (!rows.length)
+        return '';
+    const width = Math.max(...rows.map((row) => row.length));
+    const line = (cells) => `| ${Array.from({ length: width }, (_, index) => (cells[index]?.content ?? []).map((child) => blockMarkdown(child, 0)).join('<br>').replace(/\|/g, '\\|')).join(' | ')} |`;
+    return [line(rows[0] ?? []), `| ${Array.from({ length: width }, () => '---').join(' | ')} |`, ...rows.slice(1).map(line)].join('\n');
+}
+function listMarkdown(block, depth, marker) {
+    return (block.content ?? []).map((item) => {
+        const [first, ...rest] = item.content ?? [];
+        return [`${'  '.repeat(depth)}${marker} ${first ? blockMarkdown(first, depth + 1).replace(/\n/g, '\n  ') : ''}`, rest.map((child) => blockMarkdown(child, depth + 1)).filter(Boolean).join('\n')].filter(Boolean).join('\n');
+    }).join('\n');
+}
+function taskMarkdown(block, depth) {
+    return (block.content ?? []).map((item) => {
+        const [first, ...rest] = item.content ?? [];
+        return [`${'  '.repeat(depth)}- [${item.attrs?.checked === true ? 'x' : ' '}] ${first ? blockMarkdown(first, depth + 1).replace(/\n/g, '\n  ') : ''}`, rest.map((child) => blockMarkdown(child, depth + 1)).filter(Boolean).join('\n')].filter(Boolean).join('\n');
+    }).join('\n');
+}
+function imageMarkdown(block) {
+    const src = mediaSrc(block);
+    const alt = str(block.attrs?.alt) || str(block.attrs?.title) || inlineMarkdown(block.content ?? []);
+    const caption = str(block.attrs?.caption) || inlineMarkdown(block.content ?? []);
+    return [src ? `![${alt}](${src})` : placeholder('image', block), caption && caption !== alt ? caption : ''].filter(Boolean).join('\n');
+}
+function validateUrl(value, field) {
+    if (/^(https?:\/\/|file:\/\/|data:image\/|\/)/i.test(value))
+        return value;
+    throw err('invalid_content', `${field} 必须是安全 URL`);
+}
+function uniqueHash(blocks, hash, kind) {
+    if (!hash)
+        return null;
+    const matches = blocks.filter((block) => (kind === 'node' ? block.nodeHash : block.textHash) === hash);
+    if (matches.length > 1)
+        throw err('target_not_found', '目标 hash 匹配多个块，请使用 nodeRange 或 anchorId 重新定位');
+    return matches[0] ? { startIndex: matches[0].nodeIndex, endIndex: matches[0].nodeIndex + 1 } : null;
+}
+function targetMatches(target, blocks, start, end) {
+    return (!target.expectedNodeHash || target.expectedNodeHash === blockNodeHash(blocks, start, end)) && (!target.expectedTextHash || target.expectedTextHash === blockTextHash(blocks, start, end)) && (!target.expectedTextSnippet || blocks.slice(start, end).map((block) => block.text).join('\n\n').includes(target.expectedTextSnippet));
+}
+function assertNoRangeConflicts(items) {
+    const destructive = items.filter((item) => !['insertBlocksAfter', 'insertBlocksBefore'].includes(item.operation.op)).sort((a, b) => a.startIndex - b.startIndex);
+    for (let index = 1; index < destructive.length; index += 1)
+        if (destructive[index].startIndex < destructive[index - 1].endIndex)
+            throw err('invalid_plan', 'AI 编辑补丁包含重叠的破坏性操作');
+}
+function replaceText(block, operation) {
+    let changed = false;
+    const visit = (item) => {
+        if (changed && !operation.replaceAll)
+            return item;
+        if (item.type === 'text' && typeof item.text === 'string' && item.text.includes(operation.matchText)) {
+            changed = true;
+            return { ...item, text: operation.replaceAll ? item.text.split(operation.matchText).join(operation.replacementText) : item.text.replace(operation.matchText, operation.replacementText) };
+        }
+        return item.content ? { ...item, content: item.content.map(visit) } : item;
+    };
+    const next = visit(clone(block));
+    if (!changed)
+        throw err('target_conflict', '未能在目标块中找到待替换文本');
+    return next;
+}
+function inline(value) {
+    return value.inline?.length ? value.inline.map(inlineSpec) : textInline(text(value.text ?? '', `${value.type}.text`));
+}
+function inlineSpec(value) {
+    if (value.type === 'text')
+        return { type: 'text', text: text(value.text, 'inline.text', true) };
+    if (value.type === 'hardBreak')
+        return { type: 'hardBreak' };
+    if (value.type === 'inlineMath')
+        return { type: 'inlineMath', attrs: { text: text(value.text, 'inlineMath.text', true) } };
+    if (value.type === 'bidlink')
+        return { type: 'bidlink', attrs: attr({ id: text(value.id, 'bidlink.id'), label: opt(value.label, 'bidlink.label', 500), href: opt(value.href, 'bidlink.href', 1_000), type: opt(value.linkType, 'bidlink.linkType', 100) }) };
+    return { type: 'hashtag', attrs: attr({ id: opt(value.id, 'hashtag.id', 500), label: opt(value.label, 'hashtag.label', 500), path: opt(value.path, 'hashtag.path', 1_000), fullPath: opt(value.fullPath, 'hashtag.fullPath', 1_000) }) };
+}
+function textInline(value) {
+    return value ? value.split('\n').flatMap((part, index, parts) => [...(part ? [{ type: 'text', text: part }] : []), ...(index < parts.length - 1 ? [{ type: 'hardBreak' }] : [])]) : [];
+}
+function listItems(values) {
+    if (!Array.isArray(values) || !values.length || values.length > 200)
+        throw err('invalid_content', '列表块 items 数量无效');
+    return values.map((item, index) => text(item, `items[${index}]`));
+}
+function taskItems(values) {
+    if (!Array.isArray(values) || !values.length || values.length > 200)
+        throw err('invalid_content', '任务列表块 items 数量无效');
+    return values.map((item, index) => typeof item === 'string' ? { text: text(item, `items[${index}]`), checked: false } : { text: text(item?.text, `items[${index}].text`), checked: item?.checked === true });
+}
+function text(value, field, preserve = false) {
+    if (typeof value !== 'string')
+        throw err('invalid_content', `${field} 必须是字符串`);
+    const normalized = value.replace(/\r\n/g, '\n');
+    if (normalized.length > 50_000)
+        throw err('invalid_content', `${field} 超过 50000 字符限制`);
+    return preserve ? normalized : normalized.trim();
+}
+function opt(value, field, max) {
+    if (value == null)
+        return undefined;
+    if (typeof value !== 'string')
+        throw err('invalid_content', `${field} 必须是字符串`);
+    const normalized = value.replace(/\r\n/g, '\n').trim();
+    if (normalized.length > max)
+        throw err('invalid_content', `${field} 超过 ${max} 字符限制`);
+    return normalized || undefined;
+}
+function optUrl(value, field) {
+    const normalized = opt(value, field, 4_000);
+    return normalized ? validateUrl(normalized, field) : undefined;
+}
+function number(value, field) {
+    if (value == null)
+        return undefined;
+    const parsed = Number(value);
+    if (!Number.isFinite(parsed))
+        throw err('invalid_content', `${field} 必须是数字`);
+    return parsed;
+}
+function headingLevel(value) {
+    const parsed = Number(value);
+    if (!Number.isInteger(parsed) || parsed < 1 || parsed > 6)
+        throw err('invalid_content', 'heading.level 必须是 1 到 6 的整数');
+    return parsed;
+}
+function lang(value) {
+    return typeof value === 'string' ? value.trim().replace(/[^\w.+-]/g, '').slice(0, 40) || undefined : undefined;
+}
+function bool(value) {
+    return typeof value === 'boolean' ? value : undefined;
+}
+function patchAttrs(type, attrs) {
+    return Object.fromEntries((PATCHABLE_ATTRS[type] ?? []).flatMap((key) => Object.hasOwn(attrs, key) ? [[key, safe(attrs[key])]] : []).filter(([, value]) => value !== undefined));
+}
+function safeAttrs(block) {
+    const attrs = block.attrs ?? {};
+    const result = Object.fromEntries((SAFE_ATTRS[block.type] ?? ['anchorKey', 'id', 'uniqueId']).flatMap((key) => Object.hasOwn(attrs, key) ? [[key, safe(attrs[key])]] : []).filter(([, value]) => value !== undefined));
+    return Object.keys(result).length ? result : undefined;
+}
+function safe(value) {
+    if (value == null)
+        return undefined;
+    if (typeof value === 'boolean')
+        return value;
+    if (typeof value === 'number')
+        return Number.isFinite(value) ? value : undefined;
+    if (typeof value !== 'string')
+        return undefined;
+    const normalized = value.replace(/\s+/g, ' ').trim();
+    return normalized ? normalized.slice(0, 2_000) : undefined;
+}
+function markedText(item) {
+    let value = str(item.text);
+    for (const mark of Array.isArray(item.marks) ? item.marks : []) {
+        if (mark.type === 'bold')
+            value = `**${value}**`;
+        if (mark.type === 'italic')
+            value = `*${value}*`;
+        if (mark.type === 'strike')
+            value = `~~${value}~~`;
+        if (mark.type === 'code')
+            value = `\`${value.replace(/`/g, '\\`')}\``;
+        const attrs = mark.attrs;
+        if (mark.type === 'link' && str(attrs?.href))
+            value = `[${value}](${str(attrs?.href)})`;
+    }
+    return value;
+}
+function semantic(item) {
+    if (item.type === 'hashtag')
+        return str(item.attrs?.fullPath) || str(item.attrs?.path) || str(item.attrs?.label) || str(item.attrs?.id);
+    if (item.type === 'bidlink')
+        return str(item.attrs?.label) || str(item.attrs?.id);
+    if (item.type === 'image')
+        return str(item.attrs?.caption) || str(item.attrs?.alt) || str(item.attrs?.title) || inlineMarkdown(item.content ?? []);
+    if (item.type === 'video' || item.type === 'audio')
+        return str(item.attrs?.title) || mediaSrc(item);
+    if (item.type === 'file')
+        return str(item.attrs?.name) || mediaSrc(item);
+    if (item.type === 'mermaid')
+        return str(item.attrs?.code);
+    if (item.type === 'mindgraph')
+        return str(item.attrs?.markdown);
+    return '';
+}
+function metadataFrom(document) {
+    const images = new Set();
+    const bidLinks = new Map();
+    const visit = (item) => {
+        if ((item.type === 'image' || item.type === 'video') && /^https?:\/\//i.test(mediaSrc(item)))
+            images.add(stripUrl(mediaSrc(item)));
+        if (item.type === 'bidlink' && str(item.attrs?.id)) {
+            const id = str(item.attrs?.id);
+            const type = str(item.attrs?.type) || 'reference';
+            bidLinks.set(`${id}::${type}`, { id, type: type === 'note' ? 'reference' : type });
+        }
+        for (const child of item.content ?? [])
+            visit(child);
+    };
+    visit(document);
+    return { images: Array.from(images), bidLinks: Array.from(bidLinks.values()) };
+}
+function mode(type) {
+    return ATOMIC.has(type) ? 'atomicBlock' : CONTAINER.has(type) ? 'container' : INLINE.has(type) ? 'inlineAtom' : SAFE_ATTRS[type] || ['listItem', 'taskItem', 'tableRow', 'tableCell', 'tableHeader'].includes(type) ? 'text' : 'unsupported';
+}
+function withStableAnchors(document, createAnchorId) {
+    if (!createAnchorId)
+        return document;
+    let changed = false;
+    const content = topNodes(document).map((block, index) => {
+        if (anchor(block))
+            return block;
+        const anchorId = createAnchorId(block, index).trim();
+        if (!anchorId)
+            return block;
+        changed = true;
+        return { ...block, attrs: { ...(block.attrs ?? {}), anchorKey: anchorId } };
+    });
+    return changed ? { ...document, content } : document;
+}
+function chunks(blocks) {
+    return blocks.map((block, index) => ({ index, nodeRange: block.nodeRange, anchorIds: [block.anchorId], textPreview: block.textPreview, charCount: block.charCount, estimatedTokens: Math.ceil(block.charCount / 2.5) }));
+}
+function hashNode(item) {
+    const value = { type: item.type };
+    const attrs = item.attrs ? Object.fromEntries(Object.entries(item.attrs).filter(([key]) => !HASH_IGNORED_ATTRS.has(key))) : {};
+    if (Object.keys(attrs).length)
+        value.attrs = attrs;
+    if (typeof item.text === 'string')
+        value.text = item.text;
+    if (item.marks?.length)
+        value.marks = item.marks;
+    if (item.content?.length)
+        value.content = item.content.map(hashNodeValue);
+    return hashStable(value);
+}
+function hashNodeValue(item) {
+    const value = { type: item.type };
+    const attrs = item.attrs ? Object.fromEntries(Object.entries(item.attrs).filter(([key]) => !HASH_IGNORED_ATTRS.has(key))) : {};
+    if (Object.keys(attrs).length)
+        value.attrs = attrs;
+    if (typeof item.text === 'string')
+        value.text = item.text;
+    if (item.marks?.length)
+        value.marks = item.marks;
+    if (item.content?.length)
+        value.content = item.content.map(hashNodeValue);
+    return value;
+}
+function hashStable(value) {
+    return hashString(stableStringify(value));
+}
+function hashString(value) {
+    let hash = 0x811c9dc5;
+    for (let index = 0; index < value.length; index += 1) {
+        hash ^= value.charCodeAt(index);
+        hash = Math.imul(hash, 0x01000193);
+    }
+    return (hash >>> 0).toString(36);
+}
+function stableStringify(value) {
+    return JSON.stringify(sortJson(value ?? null));
+}
+function sortJson(value) {
+    if (value == null || typeof value !== 'object')
+        return value;
+    if (Array.isArray(value))
+        return value.map(sortJson);
+    return Object.fromEntries(Object.keys(value).sort().map((key) => [key, sortJson(value[key])]));
+}
+function anchor(item) {
+    for (const key of ANCHOR_KEYS)
+        if (str(item?.attrs?.[key]))
+            return str(item?.attrs?.[key]);
+    return null;
+}
+function node(value) {
+    return Boolean(value && typeof value === 'object' && !Array.isArray(value) && typeof value.type === 'string');
+}
+function clone(value) {
+    return JSON.parse(JSON.stringify(value));
+}
+function withoutContent(value) {
+    const next = clone(value);
+    delete next.content;
+    return next;
+}
+function marks(value) {
+    if (!Array.isArray(value))
+        return undefined;
+    const normalized = value.filter((mark) => Boolean(mark && typeof mark === 'object' && !Array.isArray(mark) && typeof mark.type === 'string'));
+    return normalized.length ? normalized : undefined;
+}
+function attr(values) {
+    return Object.fromEntries(Object.entries(values).filter(([, value]) => value !== undefined && value !== null && value !== ''));
+}
+function num(value) {
+    return typeof value === 'number' && Number.isFinite(value) ? value : null;
+}
+function str(value) {
+    return typeof value === 'string' ? value.trim() : '';
+}
+function mediaSrc(item) {
+    const raw = item.attrs?.src;
+    return typeof raw === 'string' ? raw.trim() : raw && typeof raw === 'object' && !Array.isArray(raw) && typeof raw.url === 'string' ? String(raw.url).trim() : '';
+}
+function placeholder(type, item, label = '') {
+    const attrs = [['id', str(item.attrs?.id)], ['resourceId', str(item.attrs?.resourceId)], ['url', str(item.attrs?.url) || str(item.attrs?.src)], ['title', str(item.attrs?.title) || str(item.attrs?.name)]].filter(([, value]) => value).map(([key, value]) => `${key}="${String(value).replace(/"/g, '\\"').slice(0, 240)}"`).join(' ');
+    return `[${type}${attrs ? ` ${attrs}` : ''}]${label ? ` ${label}` : ''}`;
+}
+function fenced(language, value) {
+    return value ? `\`\`\`${language}\n${value}\n\`\`\`` : `[${language}]`;
+}
+function compactAttrs(attrs, type) {
+    if (!attrs)
+        return undefined;
+    const result = Object.fromEntries(Object.entries(attrs).filter(([key]) => key !== 'anchorKey' && (mode(type) !== 'text' || !['id', 'uniqueId'].includes(key))));
+    return Object.keys(result).length ? result : undefined;
+}
+function token(value) {
+    return /^[A-Za-z0-9_.:/@-]+$/.test(value) ? value : JSON.stringify(value);
+}
+function escapeComment(value) {
+    return value.replace(/-->/g, '--&gt;').replace(/\s+/g, ' ').trim();
+}
+function describeTarget(target) {
+    return target.anchorId ?? target.anchorIds?.join(',') ?? target.nodeRange ?? (typeof target.nodeIndex === 'number' ? String(target.nodeIndex) : target.expectedNodeHash ?? target.expectedTextHash ?? target.textMatch ?? 'unknown');
+}
+function stripUrl(value) {
+    try {
+        const url = new URL(value);
+        url.search = '';
+        url.hash = '';
+        return url.toString();
+    }
+    catch {
+        return value;
+    }
+}
+function err(code, message, details) {
+    return new NoteContentEditError(code, message, details);
+}