把“它坏了”整理成能继续排查的报告

Resource details

适合向维护者提问、整理自己的程序故障和提交问题单。它不远程操作电脑、不执行命令，也不承诺仅凭描述找出根因。

Before you start

Platforms

跨平台

Content updated

2026-10-22

• 准备你自己选择的 AI 对话工具；可用功能与费用取决于该工具。
• 准备复现步骤、必要的脱敏报错和已尝试结果，使用自己的 AI 工具整理。

Common pitfalls

• 替换方括号后再发送；提示词不能自动存储长期记忆，也不会替你执行操作。
• 常见原因不等于真实原因；不要让模型补造它未看到的日志或宣称已修好。

Complete resource

请把我的故障描述整理成一份便于继续排查的问题报告，保留事实，标清未知，不急着给出唯一原因。

正在使用的软件或功能：[名称与用途]
环境：[操作系统、语言或软件版本；只填已确认的内容]
预期结果：[正常时应该怎样]
实际结果：[我看到了什么]
复现步骤：[从哪一步开始，依次做了什么]
脱敏报错：[必要的原文；删除密钥、账户、个人文件路径和无关日志]
出现频率与最近变化：[能确认的时间或变更，未知写未知]
已经尝试的办法与结果：[逐条写，不把“试过”当成“修好”]

请输出：简短标题、环境、最小复现步骤、预期与实际差异、已尝试记录、缺少的信息。报错原文只引用必要片段，不补造日志、退出码或文件名。

再给最多三个排查假设，每个都列“依据／还缺的证据／一个优先且低影响的核对动作”。按能够缩小范围的程度排序，不因某原因常见就认定它是根因。

一次只建议最有区分度的下一步；不要让我重复已证明没有新增信息的同一检查。可能改动文件、设置或删除数据的操作，先说明影响和应保留什么，不直接下发危险命令。

你没有实际运行工具时明确说明只分析提供的材料。不要声称已经测试、重启、安装或修复。不要索要密码、验证码、完整私人日志或远程控制凭据；信息不足时只问最关键的两个问题。

How to use it

一份能复现的问题报告，比不断猜原因更能帮助维护者。先记下观察到的事实，再安排能区分假设的下一步。

1. 记录最小故障过程

   复制全文，写出从正常状态到报错的最少步骤，填入已确认的版本，报错先脱敏。

2. 区分证据和猜测

   发送给自己的 AI 工具，检查它有没有补造日志或把某个常见原因直接定成根因。

3. 补一次有区分度的检查

   先理解下一步的影响，再决定是否操作；把结果更新到报告里，避免来回重复无新证据的测试。

以下输入是虚构练习材料，输出样例由本站人工编写，未调用模型实测；仅演示结果结构，不保证生成相同内容或效果。部分输出为节选，实际使用可按模板请求完整结果。

Example input

软件：自己写的清单网页
环境：Windows，浏览器版本暂未记录
预期：点保存后出现新项目
实际：按钮变灰，没有新项目
复现：打开网页→输入“测试项目”→点保存
报错：界面显示“请求超时”
频率：今天两次；最近变化未知
已尝试：刷新后仍可打开页面，但未检查保存接口

Example output

标题：清单保存请求超时，页面仍可打开。
事实：输入后点击保存会变灰，界面出现“请求超时”；刷新不代表保存接口正常。
假设：保存请求未返回。依据是超时提示；仍缺请求状态与服务器回执。
优先核对：在一次受控重试中记录保存请求的状态和耗时，不包含请求中的私人正文。
暂不能确定：网络、后端处理或前端超时逻辑哪一项是根因。
说明：我没有运行你的程序。

Suitable uses

• 提交给维护者的问题报告
• 整理已有排查证据，减少重复操作

Before using it

• 不能凭报告保证定位根因，真实运行环境仍需检查。
• 不要直接执行陌生脚本或把完整日志公开；先理解检查目的。

Authors and sources

Attribution

包子海梦 · AI辅助创作

Complete licence

CC BY 4.0

CC BY 4.0 · Read the complete licence ↗

Verification scope

结构已审阅 · 待模型实测

已审阅模板结构与示例说明；示例由本站编写，尚未逐条调用 DeepSeek 等真实模型验证。

2026-10-23