ObsidianHub

中文 | English

一个面向个人用户的自托管 Obsidian Server：支持远程访问、同步增强、多设备工作态同步、Git 版本管理与多 agent 受控编辑。

ObsidianHub 的目标不是替代 Obsidian，而是为个人 Obsidian vault 增加一层：

• 可远程访问
• 可通过 Web 管理
• 可被 AI / agent 受控操作
• 可回滚、可审计、可恢复
• 可在多设备之间同步当前工作状态
• 可用 Git 管理更稳定的版本节点

它更像是：

• 个人知识库的 API 化服务器层
• Obsidian 的远程操作系统 / 控制平面
• 面向自动化与 AI 的安全访问入口
• 把“实时工作流”和“版本历史”分层处理的个人知识基础设施

当 Obsidian 的使用场景延伸到下面这些需求时，原生体验会开始吃力：

• 人不在本机，也想安全访问自己的 vault
• 希望通过浏览器查看、搜索、编辑笔记
• 希望多个设备间尽快同步当前改动
• 希望多个远程 agent 能安全、受控地读写知识库
• 希望自动化能力更强，但不想让 agent 直接拿文件系统乱改
• 希望所有修改都可追踪、可回滚、可恢复
• 希望版本历史清晰，但不想每改几个字就生成 Git commit

解决“我不在本机，也能安全访问 Obsidian 数据”的问题：

• Web 文件浏览
• Markdown 预览
• 搜索
• 附件访问
• 基础编辑
• 上传 / 下载

解决“多个设备、多个进程、多个 agent 同时碰 vault 时，不把数据搞坏，并尽快看到最新工作状态”的问题：

• 当前工作态同步
• 文件变更检测
• 原子写入
• 修改时间校验
• 简单锁机制
• 冲突副本保留
• Sync API
• 基础同步状态提示

解决“如何保留值得留下的历史节点，而不让提交历史碎成噪音”的问题：

• checkpoint commit
• 手动版本保存
• agent 批处理后的结构化提交
• 历史查看
• 差异比较
• 回滚
• 可选远程 Git 备份（如 GitHub）

解决“远程 agent 可以受控地操作 vault，而不是像 SSH 一样乱改文件”的问题：

• agent token
• 路径范围限制
• 只读 / 读写权限
• 操作集限制
• 速率限制
• 操作日志
• 面向 note 的 API

• 单 vault 挂载
• Web 初始化页
• 管理员账号创建
• Agent API（list_files / read_note / write_note / append_note / search / move_note / create_note / list_tags / update_frontmatter）
• 安全写入机制
• 手动 / 自动快照
• 单文件 / 整体 vault 回滚
• Git 优先的版本管理路线
• 轻量 Obsidian 插件原型
• Sync API 作为工作态同步入口

• 多租户
• 团队共享
• 复杂 RBAC
• 文件级 ACL
• 重型实时协作编辑
• CRDT / OT
• 在线插件市场
• Notion 风格块编辑器

这个项目的权限设计重点不是“多人用户组”，而是“多个 agent 身份”。

每个 agent 可以拥有：

• 名称
• token
• 可访问路径范围
• 只读 / 读写权限
• 可执行操作集
• 速率限制
• 操作日志

• 产品需求文档（中文）
• MVP 定义（中文）
• 技术架构（中文）
• 技术栈建议（中文）
• 客户端连接方案（中文）
• 同步与版本管理（中文）
• 开发协作执行方案（中文）
• 开发协作规则（中文）
• Product Requirements (English)
• MVP Definition (English)
• Architecture (English)
• Tech Stack (English)
• Client Connection (English)
• Sync and Versioning (English)
• Development Collaboration Protocol (English)

这个项目非常适合 Docker 交付。

第一版建议优先单容器，后续复杂度上来后再拆分服务。

• 明确产品定位
• 完成 PRD
• 完成技术方案
• 搭建仓库基础结构

• 初始化配置流程
• Vault Access Layer
• 基础 Agent API
• Sync API
• Git checkpoint 能力
• 快照 / 回滚能力
• 轻量插件原型

• 搜索与索引
• Agent 权限模型
• Web 管理台增强
• 冲突检测与日志
• 可选 Git remote 备份

• 兼容能力（如 WebDAV / 导入导出）
• 客户端 CLI 执行通道（如条件成熟）
• 更完善的 agent workflow
• 部署与发布优化

当前仓库处于项目初始化阶段，近期优先事项：

1. 收敛产品哲学：实时工作态 vs Git 版本层
2. 明确 MVP 技术栈与客户端连接方向
3. 搭建最小项目骨架
4. 优先设计 Vault Access Layer、Sync API 与 Git checkpoint 机制 API 与 Git checkpoint 机制