团队协作工作流

👥 使用 Obsidian 进行团队知识管理和协作的完整指南。

概述

Obsidian 的本地优先架构非常适合团队协作，本文介绍几种常见的团队协作模式。

🔄 同步方案对比

方案	优点	缺点	适用场景
Obsidian Sync	官方支持、稳定、端到端加密	付费	小团队、对安全要求高
Git + GitHub	版本控制、免费、协作友好	需要技术背景	技术团队
Syncthing	免费、P2P、跨平台	需要配置、无历史版本	小型团队
共享网络盘	简单、企业已有	冲突风险高	文件型协作
云盘同步	简单、常用	冲突处理差	非实时协作

📁 团队仓库结构

命名规范

类型	规范	示例
会议记录	`YYYY-MM-DD 会议主题`	`2024-01-15 产品评审会`
项目文档	`项目名-文档类型`	`Alpha-技术方案`
知识笔记	`主题-分类`	`API设计规范-开发`
模板	`template-类型`	`template-meeting`

🔀 Git 协作工作流

初始化仓库

bash

# 创建团队仓库
mkdir team-vault
cd team-vault
git init

# 创建 .gitignore
cat > .gitignore << 'EOF'
# Obsidian
.obsidian/workspace.json
.obsidian/workspace-mobile.json
.obsidian/plugins/*/
!.obsidian/plugins/manifest.json
.trash/

# 系统文件
.DS_Store
Thumbs.db

# 临时文件
*.tmp
*.temp
EOF

# 创建初始结构
mkdir -p 00-inbox 01-projects 02-knowledge 03-meetings 04-templates 05-archives 99-meta

# 首次提交
git add .
git commit -m "初始化团队知识库"

# 推送到远程
git remote add origin git@github.com:team/vault.git
git push -u origin main

团队成员工作流

bash

# 1. 每日开始工作
git pull origin main

# 2. 创建今日工作分支（可选）
git checkout -b feature/$(date +%Y-%m-%d)

# 3. 工作中...
# 编辑笔记、添加内容

# 4. 定期提交
git add .
git commit -m "docs: 添加产品评审会议记录"

# 5. 每日结束
git pull origin main
git push origin main

冲突处理

当出现冲突时：

bash

# 1. 查看冲突文件
git status

# 2. 打开冲突文件，Obsidian 会显示冲突标记
# <<<<<<< HEAD
# 你的更改
# =======
# 他人的更改
# >>>>>>> branch-name

# 3. 手动解决冲突后
git add .
git commit -m "resolve: 合并冲突"

使用 Obsidian Git 插件

配置自动化：

json

{
  "vaultBackupInterval": 30,
  "autoCommitMessage": "auto: 定期备份",
  "commitOnSave": true,
  "pullInterval": 10
}

👥 团队角色与权限

角色定义

角色	权限	职责
管理员	完全控制	仓库管理、成员管理、结构维护
编辑者	读写	创建、编辑、删除笔记
贡献者	有限写入	提交内容、参与讨论
读者	只读	查看、搜索、导出

权限配置（Git 方案）

使用 GitHub/GitLab 的权限管理：

私有仓库：限制可见性
分支保护：主分支需要 PR 审核
CODEOWNERS：指定目录负责人

gitignore

# .github/CODEOWNERS
/01-projects/* @project-leads
/02-knowledge/tech/* @tech-team
/02-knowledge/design/* @design-team

📋 协作流程规范

会议记录流程

mermaid

graph LR
    A[创建会议记录] --> B[填写基本信息]
    B --> C[记录讨论内容]
    C --> D[提取行动项]
    D --> E[分配责任人]
    E --> F[同步到项目]
    F --> G[定期跟进]

会议记录模板：

markdown

---
title: "{{date}} 会议记录"
type: meeting
date: {{date}}
attendees: []
project: 
recorder: 
tags: [meeting]
---

# 会议信息

- **时间**：{{date}} {{time}}
- **地点**：
- **参会人员**：张三、李四、王五
- **记录人**：

# 议程

1. 
2. 

# 讨论内容

## 议题一：


### 结论

### 行动项

| 任务 | 负责人 | 截止日期 |
|------|--------|----------|
|  | @ |  |

## 议题二：


# 待办事项

- [ ] 任务1 @张三
- [ ] 任务2 @李四

# 下次会议

- **时间**：
- **议题**：

知识贡献流程

发现知识 → 记录在 Inbox
整理沉淀 → 移动到对应分类
审核优化 → 团队评审
发布共享 → 正式入知识库

项目文档协作

项目生命周期：
┌─────────┐    ┌─────────┐    ┌─────────┐    ┌─────────┐
│  规划   │ → │  执行   │ → │  评审   │ → │  归档   │
└─────────┘    └─────────┘    └─────────┘    └─────────┘
     ↓              ↓              ↓              ↓
  项目提案      进度更新      复盘总结      知识沉淀

📊 团队仪表板

使用 Dataview 创建团队视图

dataview

TABLE 
  choice(status = "todo", "⏳", 
  choice(status = "doing", "🔄", 
  choice(status = "done", "✅", "❓"))) AS "状态",
  title AS "任务",
  assigned AS "负责人",
  due AS "截止日期"
FROM "tasks"
WHERE !completed
SORT due ASC

团队任务看板

markdown

## 📋 团队任务看板

### 🔴 紧急
```dataview
LIST
FROM "tasks"
WHERE priority = "urgent" AND !completed

🟡 进行中

dataview

LIST
FROM "tasks"
WHERE status = "doing"

✅ 本周完成

dataview

LIST
FROM "tasks"
WHERE completed AND completed-date >= date(today) - dur(7 days)


---

## 🔄 日常工作流

### 每日工作流

早晨:

git pull（同步最新内容）
查看今日待办
查看团队动态

工作中:

创建/编辑笔记
定期 git commit
添加评论和讨论

下班前:

完成今日任务
git push（推送更改）
更新团队动态


### 每周工作流

周初:

团队同步会议
确定本周目标
分配任务

周末:

检查本周进度
更新项目状态
清理收件箱
知识沉淀


---

## 💬 协作沟通

### 评论与讨论

使用 Callout 标记讨论：

```markdown
> [!discussion] 讨论话题
> 
> **张三**: 我觉得这个方案可以优化...
> 
> **李四**: 同意，建议改成...
> 
> **张三**: 好的，我来更新。

提及与通知

markdown

# 使用 @ 提及团队成员
@张三 请帮忙审核这个文档

# 使用链接关联
相关文档：[[产品需求文档]]

状态更新

markdown

---
status: in-review
updated: 2024-01-15
updated-by: "[[张三]]"
---

> [!update] 状态更新
> - 2024-01-15: 初稿完成 @张三
> - 2024-01-16: 等待审核 @李四

🔧 推荐插件配置

团队协作必备插件

插件	用途	配置建议
Obsidian Git	版本同步	启用自动提交、定时拉取
Templater	模板自动化	创建团队模板文件夹
Dataview	数据视图	创建团队仪表板
Tasks	任务管理	统一任务格式
Kanban	看板视图	项目进度追踪
Recent Files	快速访问	查看最近更新

团队共享配置

创建 .obsidian 目录下的共享配置：

json

// app.json - 团队统一设置
{
  "defaultViewMode": "preview",
  "livePreview": true,
  "spellcheck": true,
  "spellcheckLanguages": ["zh-CN", "en-US"]
}

⚠️ 常见问题

同步冲突

问题：多人同时编辑同一文件

解决方案：

使用 Git 分支隔离工作
大文件拆分为多个小文件
建立编辑锁定机制（在文件头部标记）

权限管理

问题：如何控制敏感信息访问

解决方案：

使用独立仓库隔离敏感内容
Git 子模块管理不同权限内容
加密插件保护敏感笔记

成员退出

问题：成员离开如何处理

解决方案：

更新 CODEOWNERS
转移负责人任务
归档其贡献的笔记
保留贡献记录

团队协作工作流

概述

🔄 同步方案对比

📁 团队仓库结构

推荐结构

命名规范

🔀 Git 协作工作流

初始化仓库

团队成员工作流

冲突处理

使用 Obsidian Git 插件

👥 团队角色与权限

角色定义

权限配置（Git 方案）

📋 协作流程规范

会议记录流程

知识贡献流程

项目文档协作

📊 团队仪表板

使用 Dataview 创建团队视图

团队任务看板

🟡 进行中

✅ 本周完成

提及与通知

状态更新

🔧 推荐插件配置

团队协作必备插件

团队共享配置

⚠️ 常见问题

同步冲突

权限管理

成员退出

🔗 相关阅读

团队协作工作流 ​

概述 ​

🔄 同步方案对比 ​

📁 团队仓库结构 ​

推荐结构 ​

命名规范 ​

🔀 Git 协作工作流 ​

初始化仓库 ​

团队成员工作流 ​

冲突处理 ​

使用 Obsidian Git 插件 ​

👥 团队角色与权限 ​

角色定义 ​

权限配置（Git 方案） ​

📋 协作流程规范 ​

会议记录流程 ​

知识贡献流程 ​

项目文档协作 ​

📊 团队仪表板 ​

使用 Dataview 创建团队视图 ​

团队任务看板 ​

🟡 进行中 ​

✅ 本周完成 ​

提及与通知 ​

状态更新 ​

🔧 推荐插件配置 ​

团队协作必备插件 ​

团队共享配置 ​

⚠️ 常见问题 ​

同步冲突 ​

权限管理 ​

成员退出 ​

🔗 相关阅读 ​

团队协作工作流

概述

🔄 同步方案对比

📁 团队仓库结构

推荐结构

命名规范

🔀 Git 协作工作流

初始化仓库

团队成员工作流

冲突处理

使用 Obsidian Git 插件

👥 团队角色与权限

角色定义

权限配置（Git 方案）

📋 协作流程规范

会议记录流程

知识贡献流程

项目文档协作

📊 团队仪表板

使用 Dataview 创建团队视图

团队任务看板

🟡 进行中

✅ 本周完成

提及与通知

状态更新

🔧 推荐插件配置

团队协作必备插件

团队共享配置

⚠️ 常见问题

同步冲突

权限管理

成员退出

🔗 相关阅读