Skip to content

An open-source, privacy-first, self-hosted knowledge workspace where humans and AI agents work together 开源、隐私优先、自托管的知识工作空间,让人与智能体在此协作

2.0 KB
Raw Blame
// SiYuan - https://github.com/siyuan-note/siyuan
// Copyright (c) 2020-present, b3log.org
// SPDX-License-Identifier: AGPL-3.0-or-later

package model

import (
	"fmt"

	"github.com/siyuan-note/siyuan/kernel/treenode"
)

// PerformBlockOperation 在事务串行区内校验并执行外部块操作,返回实际执行结果。
func PerformBlockOperation(operation *Operation) (transactions []*Transaction, err error) {
	flushLock.Lock()
	isFlushing.Store(true)
	defer func() {
		isFlushing.Store(false)
		flushLock.Unlock()
	}()

	// 先处理已入队的修改,确保目标校验和执行使用一致的文档状态。
	for _, queued := range takeQueuedTransactions() {
		flushTx(queued)
	}

	switch operation.Action {
	case "appendInsert", "insert":
		if operation.Action == "appendInsert" || operation.PreviousID == "" && operation.NextID == "" {
			if err = treenode.CheckContainerParent(operation.ParentID); err != nil {
				return nil, err
			}
		}
	case "delete":
		// 外部删除请求必须命中现存节点,编辑器内部仍可使用幂等删除。
		tree, loadErr := LoadTreeByBlockID(operation.ID)
		if loadErr != nil {
			return nil, loadErr
		}
		node := treenode.GetNodeInTree(tree, operation.ID)
		if node == nil {
			return nil, fmt.Errorf("block not found [%s]", operation.ID)
		}
		if node == tree.Root {
			return nil, fmt.Errorf("document cannot be deleted as a block [%s]", operation.ID)
		}
	default:
		return nil, fmt.Errorf("unsupported block operation [%s]", operation.Action)
	}

	tx := &Transaction{DoOperations: []*Operation{operation}, fromAPI: true}
	if err = performTxSyncLocked(tx); err != nil {
		return nil, err
	}
	return []*Transaction{tx}, nil
}

// PerformBlockTransactions 为外部批量块写入启用收集事件,并返回实际提交错误。
func PerformBlockTransactions(transactions []*Transaction) error {
	for _, tx := range transactions {
		tx.fromAPI = true
		if err := PerformTxSync(tx); err != nil {
			return err
		}
	}
	return nil
}