CANDIDATE SOP候选流程,不污染正式知识。
候选只来自达到频次和严重度门槛的问题簇;接受与拒绝仅保存于当前演示会话。
pending_review
SSO 成员无法自动加入团队的处理草案
dify · session sandbox多个客户报告通过 SSO 登录后,成员未按预期自动加入指定团队,且问题集中在同一时间段内。
- 核查受影响客户的 SSO 身份提供方(IdP)中是否已正确配置团队属性映射,并确认属性名称与协作 SaaS 要求一致。
- 检查协作 SaaS 端的 SSO 同步日志,确认是否收到 IdP 发送的团队属性,并记录任何报错或跳过记录。
- 对比正常与异常成员的 SAML 断言或 OIDC 声明,确认缺失或错误的团队属性字段。
- 若确认配置无误但同步仍失败,将相关日志和对比结果提交至后端团队进一步排查,并建议客户暂时手动添加成员。
禁止动作不得把待确认原因表述为已证实根因;不得自动写入正式 SOP
T0191T0192T0193
pending_review
订阅席位增加后账户可用数量未同步核查 SOP
dify · session sandbox多个客户反馈已完成的订阅席位增加操作未反映在账户可用数量中,且问题簇趋势稳定、严重度高,需由 QA 统一排查。
- 从证据工单中提取受影响账户 ID 与操作时间,确认席位增加操作是否在后台记录中显示为成功。
- 检查账户同步日志与缓存刷新记录,核实是否存在延迟或失败,并记录异常时间点。
- 对比订单系统与账户系统的席位数量,确认数据不一致的具体差异与影响范围。
- 将核查结果与初步原因分析记录在对应工单中,若确认为系统缺陷则建议升级至开发团队。
禁止动作不得把待确认原因表述为已证实根因;不得自动写入正式 SOP
T0181T0182T0183
pending_review
项目协作SaaS高严重度问题簇处理SOP草案
dify · session sandbox当系统检测到涉及8个成员、趋势稳定但严重度为高的项目协作问题时,适用本草案。
- 核查T0171、T0172、T0173工单,确认问题现象与影响范围。
- 分析问题簇共性,评估是否由系统缺陷或操作不当引起。
- 与产品运营团队沟通,收集更多上下文信息。
- 记录初步分析结果,并建议升级至产品运营负责人进行深入调查。
禁止动作不得把待确认原因表述为已证实根因;不得自动写入正式 SOP
T0171T0172T0173
pending_review
项目协作 SaaS 高频操作卡顿与超时问题处理草案
dify · session sandbox当多个用户反馈在项目协作SaaS中执行高频操作(如任务拖拽、列表滚动、评论加载)时出现明显卡顿、响应延迟或请求超时,且问题稳定复现时适用。
- 核查受影响用户的操作环境,包括浏览器版本、网络状况及设备性能,确认是否为本地因素导致。
- 在测试环境中模拟用户描述的高频操作场景,监控前端性能指标与后端API响应时间,尝试复现卡顿或超时。
- 检查相关服务的服务器资源使用率、数据库慢查询及日志,排查是否存在资源瓶颈或异常报错。
- 若确认问题存在,将详细复现步骤、性能数据及初步排查结论记录在案,并建议产品与研发团队评估优化方案。
- 若问题影响核心业务流程,根据严重度升级机制通知值班负责人,并同步受影响用户临时缓解措施(如减少同屏数据量)。
禁止动作不得把待确认原因表述为已证实根因;不得自动写入正式 SOP
T0161T0162T0163
pending_review
客户成功团队高风险问题簇核查与升级草案
dify · session sandbox当多个客户工单反映相似问题且被系统判定为高风险、责任方为客户成功团队时,适用本草案以统一核查与沟通口径。
- 汇总T0151、T0152、T0153的客户描述与关键交互记录,确认问题现象是否一致。
- 对照产品预期行为,初步判断问题属于配置错误、使用误解还是潜在缺陷。
- 联系相关客户,收集补充信息并解释当前排查进展,避免承诺不可逆操作。
- 将分析结果与建议升级路径同步至内部评审,由指定负责人决定是否纳入正式知识库。
禁止动作不得把待确认原因表述为已证实根因;不得自动写入正式 SOP
T0151T0152T0153
pending_review
任务提醒负责人过滤设置引导缺失处理草案
dify · session sandbox多名用户反馈无法找到或理解任务提醒中的负责人过滤设置,导致任务管理混乱,且现有文档或产品内引导可能不足。
- 核查用户反馈中涉及的任务提醒界面,确认负责人过滤选项的入口位置与交互是否清晰可见。
- 检查帮助中心或产品内提示是否包含负责人过滤设置的说明,评估其可发现性与易懂性。
- 联系提出反馈的用户(如T0141、T0142、T0143),收集其操作路径与期望,确认是否存在共性理解障碍。
- 将界面混淆点与文档缺失情况记录在案,并建议产品团队优化引导或补充针对性帮助内容。
禁止动作不得把待确认原因表述为已证实根因;不得自动写入正式 SOP
T0141T0142T0143
pending_review
导出CSV文件中文乱码问题处理SOP
dify · session sandbox用户反馈从平台导出的CSV文件在Excel等软件中打开时,中文字段显示为乱码,且问题可稳定复现。
- 确认用户使用的软件及版本(如Excel版本),并请用户提供乱码截图及原始CSV文件样本。
- 使用文本编辑器(如Notepad++)检查CSV文件实际编码格式,确认是否为UTF-8或UTF-8 BOM。
- 若编码非UTF-8,向用户解释乱码原因,并指导用户使用软件的数据导入功能(而非直接打开)并指定UTF-8编码。
- 若编码为UTF-8,记录用户软件环境信息,并将案例升级至技术团队排查导出模块的编码兼容性。
- 在工单中记录排查过程和结论,并告知用户后续可能的修复计划或临时解决方案。
禁止动作不得把待确认原因表述为已证实根因;不得自动写入正式 SOP
T0131T0132T0133
pending_review
文档预览渲染失败或格式兼容性问题处理草案
dify · session sandbox多个客户反馈文档预览无法正常显示、渲染异常或提示格式不支持,且问题集中在特定文件类型或近期上传的文档时适用。
- 核查受影响工单中客户提供的文件格式、大小及上传时间,确认是否存在共性特征。
- 在测试环境使用同类型文件复现预览问题,记录渲染错误信息或兼容性报错。
- 若可复现,将样本文件与日志提交给研发排查;若不可复现,联系客户获取更多原始文件信息。
- 向客户解释可能为预览服务兼容性问题,提供临时替代方案(如下载后本地查看),并同步处理进展。
- 问题确认后,建议产品与研发评估是否需更新预览组件或增加格式支持列表。
禁止动作不得把待确认原因表述为已证实根因;不得自动写入正式 SOP
T0121T0122T0123
pending_review
已归档项目未在归档列表中显示的处理草案
dify · session sandbox多个客户反馈已执行归档操作的项目未出现在归档列表中,且问题稳定复现,影响项目查找与核对。
- 核实受影响项目在数据库中的归档标记字段是否为已归档状态,并检查归档操作日志是否记录成功。
- 检查归档列表查询逻辑,确认过滤条件是否正确包含已归档项目,并排查索引是否覆盖相关字段。
- 在测试环境复现归档操作与列表查询流程,验证问题是否与特定项目属性或操作路径相关。
- 若确认查询或索引缺陷,记录具体技术原因并提交修复需求;若归档未持久化,排查写入链路。
- 汇总受影响客户及项目清单,通知客户成功团队进行主动沟通与进展同步。
禁止动作不得把待确认原因表述为已证实根因;不得自动写入正式 SOP
T0111T0112T0113
pending_review
任务依赖保存失败处理草案
dify · session sandbox用户反馈在项目协作中设置任务依赖关系时保存失败,且问题可稳定复现,影响项目进度。
- 核实用户操作步骤与复现环境,确认是否为特定项目或任务组合触发。
- 检查后端日志中与依赖保存相关的错误信息,初步定位校验逻辑或数据库约束冲突。
- 向用户解释可能原因,提供临时替代方案(如手动调整任务顺序),并告知预计修复时间。
- 记录问题详情与影响范围,若涉及多个客户或高频发生,建议升级至产品与研发团队。
禁止动作不得把待确认原因表述为已证实根因;不得自动写入正式 SOP
T0101T0102T0103
pending_review
文件上传进度停滞问题排查与用户沟通 SOP
dify · session sandbox用户反馈文件上传进度长时间停滞,可能由网络波动或服务端处理超时引起,需工程团队介入排查。
- 核查用户上传文件大小、网络环境及上传时间点,确认是否存在客户端网络中断或带宽不足的迹象。
- 检查服务端上传接口日志,分析对应请求是否存在处理超时、内存溢出或存储写入延迟等异常。
- 向用户解释初步排查结果,说明可能因网络波动或服务端瞬时负载导致进度停滞,并提供重试建议。
- 若问题持续复现,记录受影响用户、文件特征及服务端日志片段,提交工程团队进行深度分析。
- 在问题明确前,建议用户避免在网络高峰时段上传大文件,并保持客户端版本为最新。
禁止动作不得把待确认原因表述为已证实根因;不得自动写入正式 SOP
T0091T0092T0093
pending_review
页面加载缓慢问题排查与响应草案
dify · session sandbox当多个用户反馈页面加载缓慢或操作卡顿,且问题集中在特定功能模块时,适用本草案进行初步排查。
- 核查受影响用户的环境信息,包括浏览器版本、网络状况及操作时间点,确认是否为局部环境问题。
- 检查前端相关页面的资源加载日志与性能指标,确认是否存在大体积资源、未压缩文件或渲染阻塞。
- 调取对应后端接口的响应时间与错误率监控数据,排查是否存在慢查询、高并发或服务降级情况。
- 若初步信息无法定位,建议在预发环境复现问题并抓取性能快照,将结果记录在对应工单中。
- 汇总排查结果,若确认为后端或基础设施瓶颈,建议升级至相关值班组进行深度处理。
禁止动作不得把待确认原因表述为已证实根因;不得自动写入正式 SOP
T0081T0082T0083
pending_review
API Token 权限未生效问题排查与客户沟通草案
dify · session sandbox多个客户反馈已配置的 API Token 权限或授权范围未按预期生效,导致接口调用失败或返回403错误。
- 核查受影响 Token 的创建时间、关联项目及所申请的权限范围,确认配置记录与客户描述是否一致。
- 在测试环境使用相同参数调用相关 API,复现问题并记录完整的请求与响应,以验证是否为服务端生效延迟或配置同步异常。
- 若可复现,检查内部权限同步服务的状态与日志,确认是否存在同步失败或延迟;若不可复现,则与客户核对调用方式及 Token 使用是否正确。
- 向客户解释初步排查结果,说明可能的原因(如权限同步延迟),提供临时规避方案(如重新生成 Token 并等待同步完成),并记录客户反馈。
- 若问题持续且影响业务,将案例升级至后端或平台工程团队,附上测试记录与客户环境信息,并持续跟进直至解决。
禁止动作不得把待确认原因表述为已证实根因;不得自动写入正式 SOP
T0071T0072T0073
pending_review
Webhook 超时问题排查与升级 SOP
dify · session sandbox多个工单反馈 Webhook 调用超时,影响业务集成,且后端已判定为高严重度、需工程团队介入时适用。
- 核查受影响 Webhook 端点最近 24 小时的响应时间与超时率,确认是否集中在特定接口或时间段。
- 检查服务端日志,定位超时请求的完整链路,记录错误码、耗时分布及关联服务状态。
- 排查网络链路稳定性,包括 DNS 解析、防火墙规则及出口 IP 是否被限流或阻断。
- 若确认服务端或网络问题,整理排查结果并建议升级至工程值班处理,同步通知客户当前进展。
禁止动作不得把待确认原因表述为已证实根因;不得自动写入正式 SOP
T0061T0062T0063
pending_review
导入数据出现重复记录的核查与处理草案
dify · session sandbox多个项目反馈导入后出现重复数据,且初步判断可能与去重逻辑或文件解析有关,适用于需要统一排查和响应的场景。
- 在测试环境用问题文件复现导入过程,观察去重逻辑是否触发,并记录解析步骤中的行读取次数。
- 检查导入日志和后台任务执行记录,确认是否存在重复读取或多次触发导入的情况。
- 统计受影响的项目和数据量,评估对报表和后续流程的影响范围,并形成影响说明。
- 向受影响用户说明初步排查结果、当前影响范围以及后续修复计划,建议其暂缓基于重复数据的操作。
- 若确认属于代码缺陷,将详细复现步骤和日志提交研发修复,并建议纳入回归测试用例。
禁止动作不得把待确认原因表述为已证实根因;不得自动写入正式 SOP
T0051T0052T0053
pending_review
CSV 导入字段映射异常核查与处理草案
dify · session sandbox用户反馈 CSV 导入后数据列对应关系异常,且问题集中在同一导入功能模块,影响数据准确性。
- 核查受影响工单中用户提供的原始 CSV 文件与导入后的数据列对应关系,确认是否存在字段错位或映射错误。
- 在测试环境使用相同 CSV 文件复现导入过程,观察字段映射行为是否与预期一致,并记录差异。
- 若确认映射逻辑异常,将问题现象、复现步骤及影响范围记录至缺陷管理系统,并通知开发团队评估修复优先级。
- 向受影响用户说明问题正在排查中,建议暂缓使用该导入功能,待修复通知后再重新导入。
- 若发现数据已因映射错误被污染,评估是否需要协助用户进行数据校正,并升级至 QA 负责人协调处理。
禁止动作不得把待确认原因表述为已证实根因;不得自动写入正式 SOP
T0041T0042T0043
pending_review
访客权限配置错误导致任务列表未授权访问处理草案
dify · session sandbox多个客户报告访客或外部协作者可看到非授权任务列表,且初步排查指向项目可见范围或访客角色权限配置异常。
- 核查受影响项目的访客角色权限与可见范围设置,确认是否存在配置错误或默认策略过于宽松。
- 检查近期权限变更记录与相关操作日志,定位配置修改时间与操作人。
- 与客户沟通确认其预期权限模型,并解释当前配置与预期之间的差异。
- 向客户提供修正可见范围与访客权限的操作指引,并建议其验证修复效果。
- 若发现产品侧默认配置存在缺陷,记录问题并提交至研发评估修复。
禁止动作不得把待确认原因表述为已证实根因;不得自动写入正式 SOP
T0031T0032T0033
pending_review
成员权限变更后访问被拒的核查与恢复草案
dify · session sandbox多名成员在权限变更后仍无法访问项目资源,且问题持续存在,影响正常协作。
- 确认受影响成员账号及具体被拒绝的资源路径,并检查权限变更操作记录与生效时间。
- 核查系统是否存在权限缓存延迟,必要时手动刷新缓存或引导成员重新登录以触发权限重载。
- 若权限仍未生效,检查是否存在冲突策略或审批流程未完成,并记录具体阻断原因。
- 将排查结果与临时恢复建议同步给成员,并评估是否需要升级至后端团队进一步处理。
禁止动作不得把待确认原因表述为已证实根因;不得自动写入正式 SOP
T0021T0022T0023
pending_review
邮件提醒延迟或未送达的排查与沟通草案
dify · session sandbox多个用户反馈未收到或延迟收到项目协作相关的邮件提醒,且后端已初步判断为邮件服务队列积压或发送通道延迟。
- 核查受影响时间段内的邮件服务监控指标,确认是否存在队列积压、发送延迟或通道异常。
- 检查邮件服务日志,定位是否存在特定邮件模板、域名或接收方邮件服务商的投递失败或延迟记录。
- 在内部状态页或公告渠道发布已知问题说明,告知用户我们正在核查邮件提醒延迟问题,并建议检查垃圾邮件箱。
- 收集并记录受影响用户提供的具体邮件类型、期望接收时间和实际接收时间,用于后续根因分析。
- 若确认问题持续超过预设阈值,按升级流程通知工程值班人员介入处理,并准备后续用户通知。
禁止动作不得把待确认原因表述为已证实根因;不得自动写入正式 SOP
T0011T0012T0013
pending_review
客户未收到到期提醒的排查与配置核查 SOP
dify · session sandbox多名客户反馈未收到续费或到期提醒,且后台显示通知规则可能未正确触发。
- 核查受影响客户的通知规则配置,确认到期提醒是否已启用、触发条件和接收人是否正确。
- 检查消息发送日志,确认系统是否尝试发送提醒及失败原因(如通道异常、黑名单等)。
- 若配置有误,记录具体错误点并协助客户修正;若配置正确但未触发,收集案例提交技术排查。
- 汇总受影响客户列表及初步原因,通知客户成功经理并建议主动联系客户解释情况。
禁止动作不得把待确认原因表述为已证实根因;不得自动写入正式 SOP
T0001T0002T0003