协作功能
概述
虽然 Obsidian 主要是个人知识管理工具,但也支持多种协作方式,适合团队知识共享。
协作方式
方式对比
| 方式 | 实时性 | 适用场景 |
|---|---|---|
| 共享仓库 | 低 | 知识库共享 |
| Obsidian Sync | 中 | 小团队协作 |
| Git 协作 | 低 | 技术团队 |
| 第三方同步 | 中 | 文件共享 |
共享仓库
基本共享
将仓库放在共享位置:
yaml
共享方式:
- 网络驱动器: 局域网共享
- 云盘同步: Dropbox/Google Drive
- 文件服务器: SMB/NFS注意事项
yaml
共享风险:
- 冲突问题: 多人同时编辑
- 锁定机制: 无内置锁定
- 版本控制: 无历史记录最佳实践
- 约定编辑时间段
- 使用命名区分作者
- 定期合并冲突
- 建立更新日志
Obsidian Sync 协作
团队共享
Obsidian Sync 支持多用户访问:
- 创建共享仓库
- 邀请团队成员
- 设置访问权限
权限设置
yaml
权限级别:
- 只读: 仅查看笔记
- 编辑: 可添加修改笔记
- 管理: 可邀请成员协作建议
- 使用选择性同步
- 约定文件夹结构
- 建立命名规范
- 定期同步沟通
Git 协作
初始化协作仓库
bash
# 初始化仓库
cd /path/to/vault
git init
# 创建 .gitignore
cat > .gitignore << EOF
.obsidian/workspace.json
.obsidian/workspace-mobile.json
.trash/
EOF
# 提交初始内容
git add .
git commit -m "Initial commit"
# 推送到远程
git remote add origin git@github.com:team/knowledge-base.git
git push -u origin main团队工作流
yaml
Git 协作流程:
1. 拉取最新更改: git pull
2. 编辑笔记内容
3. 提交更改: git commit
4. 推送到远程: git push
5. 处理冲突: 手动合并Obsidian Git 插件
自动化 Git 操作:
- 安装 Obsidian Git 插件
- 配置自动提交间隔
- 设置自动拉取
yaml
推荐设置:
- 自动备份间隔: 10 分钟
- 自动拉取间隔: 5 分钟
- 提交消息: "Auto backup {{date}}"冲突处理
markdown
<!-- 冲突标记示例 -->
<<<<< HEAD
我的更改
=====
他人的更改
>>>>> branch-name手动合并后删除冲突标记。
实时协作方案
使用第三方服务
| 服务 | 特点 |
|---|---|
| Notion | 实时协作,免费版有限制 |
| Google Docs | 实时编辑,适合文档 |
| Cryptpad | 开源,加密协作 |
实时协作插件
- Self-hosted LiveSync:自建实时同步
- Obsidian Local REST API:API 集成
Self-hosted LiveSync
搭建实时协作服务器:
- 部署 LiveSync 服务器
bash
# Docker 部署
docker run -d \
--name livesync \
-p 5984:5984 \
couchdb:latest- 配置插件连接
yaml
服务器设置:
- URL: http://your-server:5984
- 数据库名: obsidian
- 用户名/密码: 自定义- 团队成员连接同一服务器
协作工作流
知识库共建
yaml
共建流程:
规划:
- 确定知识库结构
- 分配责任区域
- 建立命名规范
执行:
- 各自负责区域更新
- 定期同步会议
- 交叉审核内容
维护:
- 定期清理过期内容
- 更新索引和目录
- 处理反馈问题团队笔记模板
markdown
---
author: {{author}}
created: {{date}}
status: draft/review/published
reviewers:
-
---
# {{title}}
## 概述
## 内容
## 讨论
## 更新记录
| 日期 | 作者 | 更新内容 |
|------|------|----------|
| {{date}} | {{author}} | 初始版本 |审核流程
yaml
审核流程:
1. 作者完成初稿
2. 标记为 draft 状态
3. 提交审核请求
4. 审核者 review
5. 反馈修改意见
6. 作者修改完善
7. 标记为 published权限管理
文件夹权限
通过 .obsidian 配置限制访问:
yaml
# 不推荐直接修改
# 建议使用系统权限或 Git 分支保护系统级权限
使用操作系统权限控制:
bash
# 设置只读权限
chmod -R 755 /path/to/vault/read-only
# 设置写入权限
chmod -R 775 /path/to/vault/contributionsGit 分支保护
yaml
# GitHub 分支保护规则
branches:
- name: main
protection:
required_pull_request_reviews:
required_approving_review_count: 1
required_status_checks:
strict: true沟通集成
嵌入讨论
在笔记中嵌入讨论内容:
markdown
## 讨论区
> @张三: 这个方案可行吗?
> @李四: 我觉得可以,但需要考虑...
---
讨论日期: 2024-01-15链接到沟通工具
markdown
相关讨论:
- [Slack 频道](slack://channel?id=xxx)
- [飞书文档](https://feishu.cn/...)
- [GitHub Issue](https://github.com/...)评论插件
- Obsidian Comments:笔记内评论
- Discussions:讨论功能
团队最佳实践
文件夹结构
团队仓库/
├── 00-团队资源/
│ ├── 规范指南.md
│ └── 模板/
├── 01-项目文档/
│ ├── 项目A/
│ └── 项目B/
├── 02-知识库/
│ ├── 技术/
│ └── 业务/
├── 03-会议记录/
└── 99-归档/命名规范
yaml
命名规范:
文件名:
- 使用日期前缀: 2024-01-15-会议记录.md
- 包含作者标识: 项目报告-张三.md
- 使用版本号: 文档-v1.2.md
标签:
- 统一前缀: #team/项目
- 状态标签: #状态/审核中
- 责任标签: #负责人/张三同步约定
yaml
同步规则:
- 每日开始前拉取更新
- 每日结束前提交更改
- 大改动前先沟通
- 冲突时联系原作者常见问题
如何处理编辑冲突?
- 拉取最新版本
- 手动合并差异
- 测试合并结果
- 提交最终版本
如何追溯修改历史?
使用 Git 查看:
bash
# 查看文件历史
git log --follow path/to/file.md
# 查看某行修改
git blame path/to/file.md如何恢复误删内容?
bash
# 恢复已删除文件
git checkout HEAD~1 -- path/to/file.md
# 查看删除内容
git show HEAD~1:path/to/file.md