SiYuan 智能体使用指南：让 AI 直接动手管理你的知识库（附配置与排障清单）

SiYuan 智能体使用指南让 AI 直接动手管理你的知识库附配置与排障清单【免费下载链接】siyuanAn open-source, privacy-first, self-hosted knowledge workspace where humans and AI agents work together 开源、隐私优先、自托管的知识工作空间让人与智能体在此协作项目地址: https://gitcode.com/GitHub_Trending/si/siyuan周五晚上要交一份季度复盘素材散在十几个笔记里会议纪要、项目周报、随手记的灵感。手动翻找、复制、拼凑两小时就没了。SiYuan 内置的 AI 智能体正是为这类时刻准备的——你在对话面板里说一句把上个月所有会议记录里的待办汇总成一张表它直接在你的知识库检索、读取、写回全程不离开笔记。SiYuan 智能体的 3 个核心价值直接在笔记里干活它不是你问它答的聊天框而是能创建文档、改写段落、移动块、更新数据库字段的执行者结果落在你的笔记本里不用复制粘贴。数据不出本地SiYuan 是隐私优先的自托管笔记AI 只调用你配置的模型接口笔记本体始终存在你自己的磁盘上。一套能力多端通用智能体的操作基于内核统一的 API电脑端、平板、手机看到的知识库状态一致。从 0 到第一次对话最快上手步骤配置模型打开「设置 → AI」选择服务商填入 API 地址、密钥和模型名称保存即可。对应配置实现见 kernel/conf/ai.go。打开对话面板点击顶部工具栏的 AI 入口右侧滑出智能体会话面板前端代码在 app/src/layout/dock/agent/。发第一句指令试试帮我找到《用户指南》里讲数据安全的段落并总结成三句话。确认它的动作智能体会先用检索类工具定位块再执行修改完成后你可以逐块检查不满意就用历史记录回滚。能力纵深拆开看这 3 块让 AI 直接动手改笔记智能体背后是一组结构化工具创建文档、追加段落、更新块内容、移动文档、设置块属性……它按块为最小单位操作所以改完不会破坏原有引用关系。每个块都有唯一 ID跨文档引用靠 ID 而非路径这也是它敢直接动手的底气。用 MCP 给智能体装上手脚内核里的 MCP 模块kernel/mcp/内置了 34 个工具覆盖检索、文档、块操作、数据库、收藏、模板等场景插件也能通过 MCP 接口注册自己的工具。换句话说智能体能做什么由这个工具清单决定而且可以持续扩展。会话与上下文AI 记得住多少长对话最怕越聊越忘。会话管理kernel/agent/session.go配合上下文压缩kernel/agent/compaction.go会在对话过长时自动整理历史把早期内容压缩成摘要让模型始终握着关键上下文而不爆掉窗口。实战场景库照着做就行场景一会后 5 分钟整理纪要会上用平板快速记流水账不追求格式。会后对智能体说整理这篇文档提取待办、负责人和截止时间生成一个数据库表格。检查生成的表格补漏后把表格保留在原文档顶部流水账折叠或下移。场景二批量归档散落文档对智能体说把『收件箱』下所有文档按内容归类到对应主题笔记本移动后标题加日期前缀。让它在开始前列出移动计划它会用提问工具和你确认归类。执行完成后看左侧文档树验收个别放错的直接拖回去或让它纠正。场景三跨笔记写周报指令示例检索本周所有带 #周报 标签的块和项目 A 相关的更新按『进展 / 风险 / 下周计划』生成文档。它会先用全文检索找候选块再用语义检索兜底找表述不同的内容。生成后只调措辞不重新找素材。个性化空间按你的习惯调 AI 配置换模型设置里随时切换不同服务商和模型名称重度整理任务用强推理模型日常问答用轻量模型。接口地址支持自定义 API 地址可以指向自建网关或中转服务数据链路完全由你控制。多模型共存模型元数据在 kernel/agent/modelmeta.go 与 kernel/agent/models.json 中维护不同上下文长度和工具能力的模型会被区别对待。排障手册现象 → 原因 → 解法现象原因解法发指令后无响应密钥或 API 地址填错、网络不通回到设置核对三项配置检查本机能否访问该接口回复很慢或超时模型侧限流或代理延迟换一个更快的模型必要时给客户端配网络代理说找不到某文档只按标题或全文匹配措辞不同就漏换指令让它用语义检索或指定笔记本缩小范围改动的内容不满意智能体按字面执行了模糊指令用文档历史回滚下次先让它列出计划再执行聊久了开始失忆上下文超出窗口压缩摘要丢失细节新开会话并把任务拆小关键结论让它先写成块选型对比SiYuan 智能体 vs 传统笔记 vs 网页 AI维度SiYuan 智能体传统笔记手动检索整理网页版通用 AI 聊天结果落地位置直接写入本地知识库本地停在网页里需手动复制数据隐私自托管笔记不上传完全本地依赖对方云端的处理策略操作粒度块级带 ID 引用可回滚靠人手只能给文本无法操作你的笔记检索能力全文 语义 数据库过滤关键词搜索依赖你手动粘贴素材使用成本需自备模型接口零零但内容要自己搬演进蓝图接下来会发生什么工具面继续扩大MCP 工具清单从检索、文档扩展到更多数据操作插件也能注册自己的工具智能体手会越来越多。长会话更稳上下文压缩策略会持续打磨季度级的长周期协作不再中途失忆。多模型自适应模型元数据机制让不同能力、不同窗口大小的模型各得其所配置一次就能自动匹配任务。想自己动手看实现可以从 kernel/agent/ 的会话与工具循环读起再看 docs/API.md 了解智能体调用的那套内核接口。【免费下载链接】siyuanAn open-source, privacy-first, self-hosted knowledge workspace where humans and AI agents work together 开源、隐私优先、自托管的知识工作空间让人与智能体在此协作项目地址: https://gitcode.com/GitHub_Trending/si/siyuan创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考