适配版本：HarmonyOS 5.0.0 或以上
阅读目标：构建一个支持多人角色分级的笔记权限体系，实现“只读、可评注、可编辑、拥有者”权限区分与动态分配机制，满足内容协作安全、职责清晰、权限灵活调整的协作需求。

---

🧱 一、权限角色模型设计

type NoteRole = 'owner' | 'editor' | 'commenter' | 'viewer'

interface NoteCollaborator {
  userId: string
  userName: string
  role: NoteRole
  joinedAt: number
}

📌 每个笔记可绑定多个协作者，每个协作者有独立的权限角色。

---

🔐 二、权限功能对照表

权限类型	浏览内容	评论	编辑内容	修改结构	添加协作者
viewer	✅	❌	❌	❌	❌
commenter	✅	✅	❌	❌	❌
editor	✅	✅	✅	✅	❌
owner	✅	✅	✅	✅	✅

---

🛂 三、分配协作者接口设计

function addCollaborator(noteId: string, userId: string, role: NoteRole) {
  const list = getCollaboratorList(noteId)
  list.push({ userId, role, joinedAt: Date.now() })
  kvStore.put(`collaborators_${noteId}`, JSON.stringify(list))
}

可支持邀请链接 → 自动注册为 viewer / commenter

---

🎛 四、编辑与评论控制逻辑（前端限制）

function canEdit(userId: string, noteId: string): boolean {
  const role = getUserRoleInNote(userId, noteId)
  return role === 'editor' || role === 'owner'
}

function canComment(userId: string, noteId: string): boolean {
  const role = getUserRoleInNote(userId, noteId)
  return role === 'commenter' || role === 'editor' || role === 'owner'
}

📌 不同操作功能（如编辑器、评论按钮）根据权限展示或禁用

---

🧩 五、协作者管理面板 UI 设计

• 当前协作者列表（头像 + 昵称 + 角色）
• [修改角色] 下拉框（owner 可操作）
• [移除协作者] 按钮（owner 专属）
• [生成分享链接] 设置角色类型（默认 viewer）

---

🔄 六、动态权限调整机制

function updateRole(noteId: string, userId: string, newRole: NoteRole) {
  const list = getCollaboratorList(noteId)
  const index = list.findIndex(u => u.userId === userId)
  if (index !== -1) {
    list[index].role = newRole
    kvStore.put(`collaborators_${noteId}`, JSON.stringify(list))
  }
}

📌 可实时生效，自动广播权限变化（触发 UI 刷新）

---

📥 七、退出协作与所有权转移（可选）

• 协作者退出协作
• owner 可将所有权转让他人
• owner 退出后需先指派继任者

---

✅ 八、小结

功能模块	实现说明
协作权限分级体系	支持四种角色 viewer / commenter / editor / owner
前端权限控制逻辑	按角色控制 UI 功能展示，杜绝越权操作
协作者动态管理	支持新增、修改、删除协作者与权限，支持邀请链接
权限变更机制	支持在线修改权限并广播同步，实现灵活协同组织与内容保护

---

📘 下一篇预告

第23篇｜富文本笔记草稿/发布双态机制：编辑草稿保护 + 正式版本发布 + 历史发布记录设计