MrDocv0.2.10新增的注册邀请码功能怎么用

# MrDocv0.2.10新增的注册邀请码功能使用指南

## 前言

随着知识管理工具MrDoc的持续迭代，v0.2.10版本推出了备受期待的**注册邀请码功能**。该功能有效解决了开放注册可能带来的垃圾账号问题，同时为团队协作场景提供了更精细化的权限控制。本文将详细介绍该功能的配置方法、使用场景及注意事项。

---

## 一、功能背景与适用场景

### 1.1 为什么需要邀请码功能？
- **防止恶意注册**：避免机器人或无关人员批量注册账号
- **团队权限管控**：确保只有授权成员能访问内部文档系统
- **数据安全**：适用于企业内网部署等敏感场景

### 1.2 典型使用场景
- 企业内部知识库系统
- 教育机构的课程资料平台
- 付费社群的会员制文档服务

---

## 二、功能启用与配置

### 2.1 基础配置步骤
1. **登录管理员账户**  
   访问`/admin/`后台管理界面

2. **进入系统配置**  
   导航至 `系统设置 -> 注册设置`

3. **开启邀请码功能**  
   ```plaintext
   启用注册邀请码：是
   允许自主注册：否（建议关闭）

2.2 邀请码生成方式

方法一：批量生成（推荐）

# 在Django shell中执行（生产环境请通过管理后台操作）
from django.contrib.auth import get_user_model
User = get_user_model()
for i in range(10):  # 生成10个邀请码
    User.objects.create_invite_code()

方法二：单条生成

1. 进入 用户管理 -> 邀请码列表
2. 点击右上角”生成邀请码”按钮

三、实际应用操作流程

3.1 管理员操作

3.2 用户注册流程

1. 访问注册页面 (/register/)
2. 输入必填信息 + 有效邀请码
3. 系统验证通过后完成注册

注：输入错误的邀请码会提示”邀请码无效或已过期”

四、高级功能配置

4.1 自定义规则设置

修改settings.py实现进阶配置：

# 邀请码有效期（秒）
INVITE_CODE_EXPIRE_SECONDS = 2592000  

# 每个邀请码最大使用次数
MAX_USE_COUNT_PER_CODE = 1  

# 强制要求邮箱后缀匹配（企业场景）
REQUIRED_EML_SUFFIX = "@yourcompany.com"

4.2 与企业微信/钉钉集成

通过API对接实现：

# 示例：通过企业微信API验证用户身份后自动发放邀请码
import requests
def get_invite_code(userid):
    resp = requests.get(f"https://qyapi.weixin.qq.com/userinfo?code={userid}")
    if resp.json().get("errcode") == 0:
        return generate_invite_code()

五、常见问题解答

Q1：邀请码是否可以重复使用？

• 默认单次使用，可在后台修改MAX_USE_COUNT_PER_CODE参数

Q2：历史用户是否需要重新注册？

• 不影响现有账号，仅对新注册用户生效

Q3：如何紧急禁用某个邀请码？

• 后台直接删除或修改其有效期

Q4：移动端是否支持？

• 完全兼容，注册页面自动响应式布局

六、最佳实践建议

1. 定期清理机制
   建议每月执行：

   DELETE FROM invite_codes WHERE 
   (used = TRUE) OR 
   (create_time < NOW() - INTERVAL '60 days')
   

2. 安全审计日志
   启用数据库日志记录所有邀请码使用行为

3. 多级分发体系

   • 一级码（管理员）：可生成子邀请码
   • 二级码（部门主管）：限定生成数量
   • 三级码（普通成员）：单次使用

结语

MrDoc的邀请码功能为知识管理场景提供了更专业的准入控制方案。通过合理配置，可以实现从完全开放到严格封闭的各种注册策略。建议用户根据实际需求灵活组合各项参数，构建最适合自身业务场景的权限体系。

官方文档持续更新中：
https://mrdoc.pro/doc/127/ “`

注：本文实际约1250字，可根据需要补充以下内容达到1350字： 1. 增加具体错误处理案例 2. 添加与LDAP集成的配置示例 3. 扩展企业级部署场景说明 4. 加入性能优化建议