网盘视频在线预览 PRD

版本：v0.2 | 创建日期：2026-07-28
需求来源：混合来源（CRM 需求池、CRM 关联反馈、TAPD Story、现状截图、本地代码）
优先级：P1（TAPD 优先级 High）
文档状态：待确认

需求变更记录

变更日期	变更人	变更内容
--	--	未提供原始需求变更记录。

依赖需求 Story 列表

ID	需求描述	涉及端与开发人员	是否有依赖项	备注
待拆分	网盘接入协同业务团队现有视频预览能力	网盘 Web、统一视频预览能力；开发人员待确认	是	CRM 将本需求标记为“跨团队依赖需求”，依赖团队为“协同业务团队”。该能力会阻塞视频播放和最终验收，需在排期前补齐依赖 Story、接口人及联调计划。

一、需求概述

1.1 客户反馈

客户反馈结论： 两家客户均反馈网盘中的文档、图片可以直接在线预览，但视频只能下载后查看，希望普通视频文件能够在网盘内直接播放。反馈截图分别覆盖公司文件和个人文件列表，文件样例均为 .mp4。

需求编号	反馈客户	客户级别	反馈人	业务场景	示意图
`fb_2025-06-20_056150`	广东力劲塑机智造股份有限公司	重要	丁雨DINGYU	客户的角色是什么：管理员客户的业务场景是什么：上传视频到网盘里后，文件、图片类的可以在线预览，但是视频不支持，希望可以实现在线预览视频的功能。客户的操作步骤是什么：××× 这个场景下遇到的问题是什么：×××
`fb_2025-06-27_056365`	济南利仁科技有限公司	小微	姚杰	网盘内的资料文件类的可以直接在线预览，视频类的需要下载查看，客户需求是视频类的能否也在线预览

依据：2026-07-28 通过 fx-crm MCP 实时读取需求池 2025-06-20-16629 及其 2 条关联反馈；客户业务场景保持 CRM 原文，未改写。

1.2 系统现状

网盘 Web 已有统一的文件预览能力，覆盖公司文件、个人文件和共享文件三类目录。文件列表读取后端返回的 IsCanPreview 判断文件能否进入统一文件预览器；当前视频尚未进入该预览链路。依据：fs/fs/modules/netdisk/netdisk.js:97-125、:1136-1201、:1317-1350。
网盘已明确区分普通文件与大文件，判定口径是后端返回的 FileProperty，不是页面显示的文件大小数值。当前列表中的普通 MP4 与大文件 MP4 均不能预览；实际操作确认，大文件 MP4 点击名称区域没有反应。本期保持大文件现状，不为其新增预览、提示或其他点击反馈。
网盘预览权限与下载权限已分离。用户具备查看权限但不具备下载权限时，文件仍可进入预览器，但预览器隐藏下载能力；本需求应继续复用这一规则。依据：fs/fs/modules/netdisk/netdisk.js:1958-1973。
工作圈已经根据附件的 canPreview 展示“预览”，并保留“下载”和“存至网盘”；企信服务能够识别视频文档，明确将 .mp4 及其他视频 MIME 类型归为视频。CRM 附件侧已有统一媒体播放器，可处理视频播放和转码中、转码超时、文件不存在等状态。依据：fs/fs/modules/feed-list/feed-list-helper.js:584-617，fs-qixin/fs-qixin-api/src/main/java/com/facishare/qixin/api/model/message/content/Document.java:190-204、:229-264，crm/crm2/modules/api/simply/simply.js:2134-2174。
当前代码中没有找到网盘针对视频的专用播放分支或确定的视频格式、编码白名单。现状更接近后端未把普通网盘视频标记为可预览，或统一文件预览器未将网盘视频路由到媒体播放器。具体责任边界需由网盘与协同研发联调确认。
网盘动态页虽然对部分 PDF 展示独立“预览”操作，但普通 MP4 当前没有该入口。本期不调整动态页，也不以动态页现有文件能力推导视频预览范围。

现状截图	证据说明
	来源： CRM 需求池示意图。图中证明：工作圈视频附件已展示“预览”入口。不能证明：无法据此确认格式、大小、编码和权限边界。对本需求的意义：网盘可以复用同一类视频播放体验。
	来源： CRM 需求池示意图。图中证明：工作圈已有站内视频播放界面和基础播放控件。不能证明：无法据此确认底层播放器接口和转码策略。对本需求的意义：本期不新增另一套播放器交互。
	来源： CRM 需求池示意图。图中证明：网盘个人文件中可存储并展示 `.mp4` 文件，但当前操作区未体现视频预览能力。不能证明：截图不能单独证明后端是否已经生成可播放地址。对本需求的意义：预览入口应沿用网盘现有文件预览交互。
	来源： CRM 需求池示意图。图中证明：企信视频附件同时提供“下载”和“预览”。不能证明：无法据此确认网盘可以直接复用相同接口。对本需求的意义：预览是下载之外的补充能力，不能替代或改变下载权限。
	来源： 2026-07-28 产品现状核对截图。图中证明：文件列表同时存在普通 MP4 与带“大文件”标签的 MP4，当前均没有独立预览操作。不能证明：文件大小数值不能代替后端 `FileProperty` 判定。对本需求的意义：本期只让普通 MP4 的名称区域进入预览，大文件保持现状。
	来源： 2026-07-28 产品现状核对截图。图中证明：动态页中部分 PDF 有“预览”，普通 MP4 当前仅有“下载、阅读”。不能证明：不能据此确认视频播放能力已经接入动态页。对本需求的意义：动态页不纳入本期改造。

1.3 竞品现状

本需求未开展外部竞品调研。需求池明确要求参考公司内部工作圈、企信的视频预览能力，因此本期以内部体验一致性为依据，不使用内部产品能力冒充竞品结论。

竞品	竞品分类	竞品现状	来源
不涉及	--	本期未形成外部竞品结论	--

1.4 产品价值

视频是培训、产品演示、现场记录和问题复现的常见资料。支持网盘内直接播放后，用户无需先下载文件、切换本地播放器再查看内容；同时继续沿用现有网盘权限，避免因补充预览能力而扩大文件下载范围。

1.5 需求目标

对网盘 PC Web 文件列表中的普通 MP4，用户点击文件名称即可进入视频预览台并播放。
视频预览继续沿用网盘现有文件可见权限与下载权限，不因可预览而新增下载、转发或分享权限。
FileProperty=1 的大文件、网盘动态页、宫格视图、搜索结果和移动端保持现状，不纳入本期视频预览改造。

二、产品方案

2.1 整体产品方案

本期只补充网盘 PC Web 文件列表中的普通 MP4 预览入口，不新建网盘专属播放器，也不改变网盘的下载、转发、分享等文件操作。普通 MP4 满足预览条件时，用户点击文件名称进入统一视频预览台；其余页面、区域和文件类型保持现状。

核心决策表

决策	主规则	例外	影响对象
适用文件	普通 MP4 进入预览能力	`FileProperty=1` 的大文件保持现状	公司、个人、共享文件列表
预览入口	点击视频文件整行进入预览台	图标及行内其他区域不触发预览	PC Web 列表视图
播放能力	复用统一视频播放器和已有转码状态	不支持或转码失败时不进入空白播放器	视频查看用户
权限	文件查看权限决定能否预览，下载继续沿用现有权限结果	无下载权限时不提供下载能力	普通成员、管理员
页面边界	只改文件列表	动态、宫格、搜索结果和移动端均不改	现有其他入口

2.2 具体方案说明

2.2.1 预览范围与判定

后端继续向网盘文件列表返回统一的可预览标识。符合本期条件的普通 MP4 返回 IsCanPreview=true，前端不额外维护另一套可预览白名单。
文件必须同时满足：
- 用户对文件具有查看权限；
- 文件为普通文件，即 FileProperty=0；
- 文件格式为 .mp4，且编码命中统一视频预览能力支持范围；
- 文件实体和播放资源仍然有效。
本期只承诺 .mp4，不扩展 .mov、.mkv、.m4v、.webm 等其他视频格式。MP4 的编码和浏览器兼容范围以统一视频预览能力的正式约束为准。
FileProperty=1 的大文件 MP4 保持现状：名称区域不进入可点击状态，点击不打开播放器，也不新增提示。是否为大文件只认后端 FileProperty，不在本需求中新增数值化大小阈值。

2.2.2 入口与播放交互

入口仅位于 PC Web 文件列表的“文件名”列，点击热区仅为视频文件名称文本。
普通 MP4 满足预览条件时，文件名称显示为可点击状态；点击后进入统一视频预览台。
不将文件类型图标或整行设为视频预览热区。复选框、大小、创建人、创建时间、操作、状态、文件路径及行内空白区域均不触发视频预览。
打开视频后调用统一视频播放器，至少提供播放/暂停、进度拖动、音量、全屏和关闭能力。播放器样式和行为以工作圈/企信现有组件为准。
关闭播放器后返回原网盘目录，并保持原列表位置与查询条件。
网盘动态页、宫格视图、搜索结果和移动端不新增视频预览入口，保持现状。
原“下载、转发、分享”等入口及排序不因本需求调整。

2.2.3 权限规则

只有原本可以看到并打开该文件的用户才能请求视频播放资源；预览不得绕过公司文件、个人文件、共享文件和文件夹的既有权限。
视频能否预览与能否下载分别根据现有系统结果判定，不新增独立权限配置项。用户可以查看但不能下载时，仍可进入播放器，但不得获得下载能力。
用户有下载权限时，现有操作区继续保留下载能力；预览失败不改变用户原有下载权限。
文件权限在播放前发生变化时，应以本次请求的最新鉴权结果为准；鉴权失败时不返回可播放地址。

2.2.5 存量数据兼容

方案目标是新上传视频和上线前已存在的普通视频使用同一套预览规则，不修改文件名称、目录、权限或下载记录。
若统一视频能力可以在用户打开时按文件路径生成播放地址，则存量普通视频直接生效，不做批量数据迁移。
若存量视频必须预先转码或补充媒体元数据，则上线前必须明确处理范围、失败重试和灰度策略；未完成处理的文件按“处理中/暂不支持预览”展示，不得假装可播放。
大文件和已删除文件不进入存量处理范围；存量大文件继续保持当前不可预览状态。

2.2.6 影响范围与验收

验收场景	前置条件	预期结果
公司文件普通 MP4	`FileProperty=0`、用户可见、播放资源有效	点击文件名称进入预览台并正常播放
个人文件普通 MP4	`FileProperty=0`、播放资源有效	点击文件名称进入预览台并正常播放
共享文件普通 MP4	`FileProperty=0`、用户对文件可见	点击文件名称可预览，且不扩大下载、转发和分享权限
无下载权限预览	用户可见但不可下载	可以播放，不获得下载能力
大文件 MP4	`FileProperty=1`	文件名称区域保持现状，点击无预览响应
动态、宫格、搜索和移动端	任意视频	视频预览入口和点击行为保持现状
存量普通 MP4	上线前已上传、文件和播放资源有效	与新上传普通 MP4 使用相同名称入口和预览台
转码中、失败或文件不存在	统一视频服务返回对应状态	沿用播放器已有状态，不出现黑屏、空白层或无限加载

三、规范检查项

3.1 业务文案多语言 Key

本期不新增网盘入口文案，大文件也不新增提示。播放器内部状态文案复用统一视频播放器已有多语言 Key；如研发确认存在无法复用的状态，再另行补充。

3.2 需求埋点

无。本期未提出新增产品埋点要求。

3.3 沙盒/更改集能力

模块	功能点	是否支持沙盒	是否支持更改集	说明
网盘	视频在线预览	不涉及	不涉及	本需求不新增客户可配置元数据。

3.4 PaaS 国际化兼容检查

ID	多语接入事项	是否需要	注意事项
1	接入翻译工作台	否	本期不新增入口文案，播放器文案复用现有多语言能力
2	CRM提醒	否	不新增提醒
3	企信消息提醒	否	不新增消息
4	修改记录	否	不修改业务数据
5	审计日志	否	在线预览不新增业务操作日志
6	支持快捷翻译能力	否	无输入框
7	支持数据多语能力	否	不新增实例数据
8	预置配置多语	否	不新增预置配置
9	预置示例数据多语	否	不新增示例数据

3.5 新对象/新字段 BI 分析申请

对象/字段	是否已做流程支持申请	是否已做 BI 分析申请	内容
无	不涉及	不涉及	本需求不新增对象和字段。

3.6 操作日志说明

本需求不修改业务数据，不新增网盘业务操作日志。播放器访问日志、鉴权日志、转码状态日志和埋点属于技术可观测性，用于定位播放失败，不作为用户可见的业务操作日志。

3.7 需求风险点检测

ID	风险分组	风险类型	有无该风险	涉及风险的功能点	影响的企业数	是否报备	响应策略
1	对现逻辑有影响的风险点	交互体验有变化	有	普通 MP4 的文件名称变为可点击	使用网盘视频的企业，数量待统计	待确认	灰度验证名称热区、非名称区域和大文件仍保持原行为
2	对现逻辑有影响的风险点	功能有减少	无	不减少原下载、转发、分享能力	--	否	回归原有操作入口和权限
3	对现逻辑有影响的风险点	功能逻辑的调整	有	`IsCanPreview` 判定增加视频类型	使用网盘视频的企业，数量待统计	待确认	单一后端判定口径，避免前后端白名单不一致
4	新能力风险点	逻辑不完善	有	格式、编码、存量转码规则尚未确认	使用网盘视频的企业，数量待统计	是	排期前关闭待确认事项 1-3
5	新能力风险点	有性能压力	有	视频流量、转码任务和并发播放	使用网盘视频的企业，数量待统计	是	灰度监控转码耗时、成功率、播放失败率和带宽；超阈值时暂停扩大范围

3.8 上线策略

3.8.1 收费标准

[X] 不收费
[ ] 收费

本需求属于现有网盘与视频预览能力补全，当前需求池未提出新增收费或资源包。

3.8.2 上线节奏

[X] 全网
[ ] 灰度

灰度发布的原因	视频转码、带宽、存量文件兼容和跨团队联调存在风险，需要先验证真实网盘文件。
预计全网时机	灰度期间核心播放与权限用例通过，且播放成功率、转码耗时和带宽指标达到协同团队门槛后；具体日期待确认。
期间分几次灰度	建议 2 次，最终以项目排期为准。
各灰度批次的时间节点及灰度的客户范围	第一批：内部企业及需求反馈客户中的可配合客户，验证普通`.mp4`、无下载权限、存量文件和异常状态；第二批：扩大企业范围验证并发与格式兼容；时间节点待确认。

需求池标记“独立上线，不随主版本”，实际灰度变量、客户范围和放量责任人需在依赖 Story 建立后补齐。

3.8.3 适用版本

资源名称	标准版	专业版	旗舰版	无限版	扩展资源包
网盘普通视频在线预览	待确认	待确认	待确认	待确认	不涉及

当前需求池未给出版本授权差异。正式上线前需确认网盘在各版本的既有可用范围；本需求不应单独扩大原本无网盘权限的版本。