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 api
import (
"github.com/gin-gonic/gin"
"github.com/siyuan-note/siyuan/kernel/apicontract"
"github.com/siyuan-note/siyuan/kernel/model"
"github.com/siyuan-note/siyuan/kernel/sql"
"github.com/siyuan-note/siyuan/kernel/treenode"
"github.com/siyuan-note/siyuan/kernel/util"
)
var getBookmarkLabels = contractHandler(apicontract.GetBookmarkLabels, func(c *gin.Context, request apicontract.EmptyRequest) apicontract.Response[[]string] {
if model.IsReadOnlyRoleContext(c) {
return apicontract.Success(model.BookmarkLabelsByPublishAccess(c, model.GetPublishAccess()))
}
return apicontract.Success(model.BookmarkLabels())
})
var batchGetBlockAttrs = contractHandler(apicontract.BatchGetBlockAttrs, func(c *gin.Context, request apicontract.BlockIDsRequest) apicontract.Response[map[string]map[string]string] {
ids := filterBlockIDsByPublishAccess(c, request.IDs, "")
return apicontract.Success(sql.BatchGetBlockAttrs(ids))
})
var getBlockAttrs = contractHandler(apicontract.GetBlockAttrs, func(c *gin.Context, request apicontract.BlockIDRequest) apicontract.Response[map[string]string] {
id := request.ID
if err := util.ValidateID(id); err != nil {
return apicontract.FailureFrom[map[string]string](err)
}
if err := checkBlockPublishAccess(c, id); err != nil {
return apicontract.FailureFrom[map[string]string](err)
}
return apicontract.Success(sql.GetBlockAttrs(id))
})
var setBlockAttrs = contractHandler(apicontract.SetBlockAttrs, func(c *gin.Context, request apicontract.SetBlockAttrsRequest) apicontract.Response[apicontract.Null] {
id := request.ID
if err := util.ValidateID(id); err != nil {
return apicontract.FailureFrom[apicontract.Null](err)
}
attrs := request.Attrs
scroll := attrs["scroll"]
if 1 == len(attrs) && (scroll == nil || *scroll != "") {
// 不记录用户指南滚动位置
if b := treenode.GetBlockTree(id); nil != b && (model.IsUserGuide(b.BoxID)) {
empty := ""
attrs["scroll"] = &empty
}
}
nameValues := map[string]string{}
for name, value := range attrs {
if nil == value { // API `setBlockAttrs` 中如果存在属性值设置为 `null` 时移除该属性 https://github.com/siyuan-note/siyuan/issues/5577
nameValues[name] = ""
} else {
nameValues[name] = *value
}
}
err := model.SetBlockAttrs(id, nameValues)
if err != nil {
return apicontract.Failure[apicontract.Null](-1, err.Error())
}
return apicontract.Success(apicontract.Null{})
})
var batchSetBlockAttrs = contractHandler(apicontract.BatchSetBlockAttrs, func(c *gin.Context, request apicontract.BatchSetBlockAttrsRequest) apicontract.Response[apicontract.Null] {
var blockAttrs []map[string]any
for _, block := range request.BlockAttrs {
if err := util.ValidateID(block.ID); err != nil {
return apicontract.FailureFrom[apicontract.Null](err)
}
attrs := map[string]string{}
for name, value := range block.Attrs {
attrs[name] = ""
if value != nil {
attrs[name] = *value
}
}
blockAttrs = append(blockAttrs, map[string]any{"id": block.ID, "attrs": attrs})
}
if err := model.BatchSetBlockAttrs(blockAttrs); err != nil {
return apicontract.Failure[apicontract.Null](-1, err.Error())
}
return apicontract.Success(apicontract.Null{})
})