flnxi-Wu/docs/新手用户上手指引.md

新手用户上手指引

更新时间：2026-05-13

这份指引面向首次使用 FLNXI 素材库 的普通成员，帮助他们完成登录、个人资料、素材上传、浏览、下载和分享。管理员可在培训/迎新时引用。

1. 获取账号并首次登录

1. 打开管理员提供的登录地址，例如 https://materials.example.com/login。
2. 输入账号密码，或使用钉钉扫码登录（如果当前环境已开启）。
3. 首次登录后，如果系统提示修改默认密码，请按提示设置新密码。
4. 进入“个人中心 / 个人资料”，补齐真实姓名、部门、手机号等信息，方便素材归属和团队协作。

2. 理解素材归属

每份素材会记录两类身份信息：

• createdByUserId：最初上传者，用于追溯责任人。
• ownerType + ownerId：当前归属，可以是个人或团队。

“我的素材”接口当前会返回两类素材：

• 我上传的素材
• 当前归属到我的素材

所以素材被管理员移交后，列表变化属于正常现象，不代表原始上传记录丢失。

3. 上传与预览

1. 点击“上传素材”。
2. 选择合适的上传模板。
3. 填写品牌、系列、SKU、材质、场景等元数据。
4. 上传源文件。
5. 上传完成后，在首页卡片或详情弹窗中查看预览、下载和互动状态。

视频素材会进入转码流程。当前状态含义：

状态	含义
pending	等待转码
processing	正在处理
done	已生成预览，可播放
failed	转码失败，可联系管理员或重试

当前视频处理能力包含 540P 预览、短片预览和封面生成。具体是否启用、处理速度如何，取决于部署机器和 ffmpeg 环境。

4. 收藏、点赞、下载和分享

• 收藏/点赞：可在素材卡片或详情里操作。
• 下载：是否显示下载按钮取决于当前权限和素材状态。
• 下载记录：系统会写入 material_download_logs，方便后续审计。
• 分享链接：可用于外部预览，默认 7 天有效，可由有权限的用户撤销。管理员可以在后台关闭公开分享；关闭后不能新建外部分享链接，已有链接也会停止公开访问。当前公开分享页定位为预览，不直接开放源文件下载。

5. 所有权移交

所有权移交是管理员后台能力，不是普通新手必须掌握的操作。

典型场景：

• 成员离职
• 项目组调整
• 素材从个人归属转为团队归属

管理员在后台执行移交后，系统会更新当前归属并记录 lastTransferredAt。原始上传者信息仍会保留。

6. 常见问题

场景	处理方式
登录后提示账号不可用	联系管理员检查账号是否启用
首次登录要求改密码	按页面提示完成修改
上传后长时间等待转码	刷新后再看；仍异常则联系管理员检查转码队列和 ffmpeg
我的素材为空	可能暂无上传、素材已移交、或当前账号归属变化，联系管理员核对
下载按钮不可见	可能没有下载权限，或素材仍在处理中
分享链接打不开	可能链接已过期、已撤销，或管理员关闭了公开分享
分享给外部前不确定是否合规	先用测试素材验证分享页行为，再决定是否对外发送

7. 建议的新手任务

1. 登录并补齐个人资料。
2. 上传一份测试素材，填写必要元数据。
3. 在首页搜索刚上传的素材。
4. 收藏或点赞一份素材。
5. 下载一份自己有权限下载的素材。
6. 生成一次分享链接，并确认分享页展示是否符合团队要求。

完成这些步骤后，普通用户就能掌握素材库的核心使用流程。后台模板、用户、部门、许可证和系统设置由管理员处理。