技能介绍

要解决的具体问题

知识工作者常面临三个痛点：笔记散落在 Markdown 编辑器、白板工具和数据库之间，难以形成结构化知识网络；团队自托管部署 AFFiNE 时，内容创建、更新和关联维护依赖手动操作；当需要围绕知识库执行批量内容工作流（如批量更新文档状态、同步数据库条目、维护跨文档链接）时，缺乏可编程的自动化接口。

技能如何工作

该技能围绕 AFFiNE 工作空间的三个核心组件展开：文档、白板和轻量级数据库。它的核心能力包括：

笔记整理与结构化：将原始笔记按主题分类，建立文档与数据库条目的对应关系
链接知识维护：自动检测文档间的引用关系，维护 [[双链]] 格式的关联图谱
内容工作流自动化：通过脚本触发文档创建、更新和删除，同步操作数据库记录
自托管部署集成：适配 AFFiNE 的 Docker 部署方案，支持通过 Node-API 调用 Rust 编译的插件接口

关键步骤示例：

初始化 AFFiNE 工作空间，指定文档存储路径和数据库连接配置
使用 @user_3c6cb52e/affine-knowledge-base-collaborative-workspace-platform 技能加载现有知识库结构
编写自动化脚本，通过技能提供的接口执行批量内容操作
定期检查链接完整性，修复失效的跨文档引用

适用边界与注意点

该技能需要配合自托管的 AFFiNE 实例使用，依赖 napi-rs 框架编译 Rust 编写的 Node.js 插件。它不适用于纯云端 SaaS 场景，也不处理 AFFiNE 原生 UI 的交互操作。团队需要具备基本的容器化部署经验，并确保 Node.js 版本不低于 18.16.1。对于需要实时协作或复杂权限管理的场景，建议结合 AFFiNE 内置的协作功能使用。