An open-source, privacy-first, self-hosted knowledge workspace where humans and AI agents work together 开源、隐私优先、自托管的知识工作空间,让人与智能体在此协作
TypeScript agentic-aiai-agentknowledge-baselocal-firstmarkdownmcpmindmapnote-takingself-hostedsiyuanworkspace
// 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
}