思源笔记
开源、隐私优先、自托管的知识工作空间，让您与AI智能体在此协作文档、数据库与笔记。
证据显示：README 强调隐私优先、数据本地存储，提供访问认证码（accessAuthCode）和 Docker 权限控制（PUID/PGID），但未提供详细的权限最小化设计或用户确认机制。数据流透明度有限，未明确说明数据如何被处理或传输。敏感数据处理方面，提及数据仓库密钥和加密，但细节不足。依赖安全方面，有 go.mod 和 package.json，但未提供漏洞扫描或依赖审计证据。外部影响方面，有网络服务和导出功能，但未说明其影响范围。回滚方面，有数据仓库重置和快照功能，但未明确回滚机制。来源归属方面，有开源许可证和贡献者列表，但未提供详细的来源追溯。因此，各标准评分较低，因为证据不足或仅部分满足。
证据显示：README 和 CI 工作流提供了构建和发布流程，但未提供测试结果或错误处理细节。自一致性方面，文档和代码结构基本一致，但未验证。依赖可用性方面，列出了多个依赖项目，但未提供依赖的可用性保证。失败消息方面，未提供具体的错误处理或用户提示。因此，评分中等偏低。
证据显示：README 描述了多种使用场景（桌面、移动、Docker），并提供了 CLI 和 API，但未明确能力边界。受众和场景方面，覆盖了个人知识管理，但未明确目标用户。触发精度方面，未提供具体的触发机制。环境适配方面，支持多种平台和部署方式，但未提供详细的配置说明。因此，评分中等。
证据显示：README 结构清晰，提供了安装、使用、FAQ 等，但未提供完整的 API 文档或已知限制。信息架构方面，文档组织良好。安装说明方面，提供了多种安装方式。命名稳定性方面，项目名称和版本号一致。示例和 FAQ 方面，提供了示例和常见问题。已知限制方面，在 Docker 部分提到了限制，但未全面。许可证方面，明确为 AGPL-3.0。版本和变更日志方面，有 CHANGELOG.md 和版本号。维护责任方面，有贡献指南和社区。因此，评分中等。
证据显示：README 描述了丰富的功能，但未提供性能或成本数据。输出可用性方面，提供了多种导出格式。边际价值方面，作为开源项目，提供了免费功能。成本效益方面，未提供具体成本分析。因此，评分中等。
证据显示：README 中的声明未提供具体证据或引用。可追溯性方面，未提供来源链接。交叉验证方面，未提供多个来源。事实与推断分离方面，未明确区分。因此，评分较低。
- 该仓库是一个知识管理应用，而非专门的 AI Agent 框架，评估时需注意其 Agent 能力有限。
- 发布者身份未经验证，应视为未知，不要基于品牌推断安全性。
- 静态审查无法验证实际运行行为，所有评分基于文档和代码结构，置信度低。
这个 Agent 能做什么，适合哪些场景？
思源笔记是一个开源（AGPL-3.0）、隐私优先的个人知识管理系统，支持块级引用和Markdown所见即所得编辑。数据默认存储在本地工作空间文件夹中，提供端到端加密的数据仓库和可选的云端同步（会员特权）。它包含完整的桌面（Electron）和移动端应用，可通过Docker自托管，并提供一个命令行界面（CLI）用于直接操作工作空间数据，无需运行服务器。思源笔记生态系统包括插件API（petal）、社区市场（bazaar）、Chrome剪藏扩展以及Android/iOS/鸿蒙应用。核心编辑器引擎是Lute，数据仓库由dejavu处理，特性包括块级链接、数据库视图、闪卡间隔重复、AI写作（通过OpenAI API）和OCR。
思源笔记将内容以JSON格式（.sy文件）存储在本地工作空间的数据文件夹中，包含资产、模板、插件和笔记文件夹。核心内核程序（SiYuan-Kernel）作为HTTP服务器运行，提供API和WebSocket接口。内置CLI通过siyuan命令（如siyuan notebook list、siyuan search、siyuan export）直接读取和写入数据。编辑器支持块级引用、双向链接、SQL查询嵌入、Markdown所见即所得，并可导出为Markdown、PDF、Word和HTML。它提供AI写作和基于OpenAI API的问答聊天，以及Tesseract OCR。部署方式包括桌面安装包、Docker镜像（b3log/siyuan）和命令行模式。
- 个人知识管理者希望完全掌控笔记数据，将其存储在本地并通过加密仓库同步，不依赖第三方云服务。
- 需要自托管知识库的团队，可通过Docker部署在内网服务器，并使用NGINX反向代理隐藏端口。
- 研究人员需要细粒度的块级引用和双向链接，以构建复杂的知识图谱。
- 使用数据库视图跟踪项目任务或文献条目的用户，并在同一笔记中嵌入SQL查询。
- 语言学习者使用闪卡间隔重复功能复习内容。
- 需要离线或本地优先工具的作者，可以导出为Markdown或Word，并支持剪藏网页内容。
这个 Agent 有哪些优点和局限？
- 支持细粒度块级引用和双向链接，适合构建复杂知识网络。
- 本地优先、隐私保护，数据存储在本地，可选端到端加密同步。
- 可自托管，提供Docker镜像，支持完全掌控数据。
- 内置数据库视图、闪卡间隔重复、AI写作和OCR，功能丰富。
- 不支持第三方同步盘，因为可能损坏数据；同步需成为付费会员。
- 会员特权（如云同步、部分导出功能）需要付费。
- Docker版本不支持桌面/移动应用连接，仅限浏览器使用，且不支持导出PDF/Word/HTML和导入Markdown。
- 需要自行配置反向代理和权限管理（如PUID/PGID），对非技术用户有一定门槛。
如何安装或部署这个 Agent？
安装方式多样化：
- 桌面应用：从官网（b3log.org/siyuan）或GitHub Releases下载安装包，或通过Microsoft Store（Windows）、App Store（iOS）、Google Play/F-Droid（Android）安装。
- Docker自托管：使用镜像b3log/siyuan，运行docker run -d -v /siyuan/workspace:/siyuan/workspace -p 6806:6806 -e PUID=1001 -e PGID=1002 b3log/siyuan serve --workspace=/siyuan/workspace/ --accessAuthCode=xxx。确保工作区文件夹所有权与PUID/PGID匹配。
- 命令行工具：二进制位于<install-dir>/resources/kernel/SiYuan-Kernel，在Windows安装后自动加入PATH；macOS和Linux需手动创建符号链接。
如何使用这个 Agent？
安装后，启动桌面应用或通过docker run启动Docker容器。在浏览器中访问http://localhost:6806（Docker）或打开桌面客户端。首次启动设置工作空间路径和锁屏密码。使用编辑器创建笔记，支持Markdown快捷键和块操作。CLI可用：siyuan notebook list -w ~/SiYuan列出笔记本，siyuan search "keyword" -w ~/SiYuan -f json进行全文搜索，siyuan export md --id <block-id> -w ~/SiYuan导出文档。同步和加密功能需在设置中配置数据仓库密钥。
这个 Agent 与同类方案有什么区别？
思源笔记与Obsidian、Notion等工具在块级引用和知识管理领域竞争，但未在README中明确提及具体竞争对手。