追因 · 智能代码根因定位台

追因 · 项目介绍

一句话说明

追因是一款本机运行的智能代码根因定位工具。业务人员写下异常现象，系统只读扫描经过授权的 Python 项目，随后给开发一份带文件行号和源码证据的根因候选报告。

项目从哪里开始

业务反馈和代码实现使用的是两套语言。

产品经理听到的内容往往是“用户取消订单后，优惠券仍然不能再次使用”。开发接手以后，需要继续确认请求进了哪个处理器、订单状态在哪里改变、优惠券状态有没有恢复，以及相关测试覆盖了哪条路径。

这一步可能花掉几十分钟，也可能更久。时间主要消耗在搜索范围和建立上下文上。追因的目标是缩短这段起步时间，让开发先看到几个有证据的检查位置。

用户怎样使用

用户启动本地服务时先授权一个代码目录。页面不会接收或修改仓库路径。

进入工作台以后，用户填写异常现象。预期结果和复现步骤可以帮助模型理解业务条件。提交以前，页面要求用户确认源码授权，明确告知本次分析所需的代码片段会进入模型服务。

后端随后读取有限数量的 Python 文件，把带行号的源码和业务描述交给本机已经登录的 Codex。模型返回候选以后，后端继续检查路径、行号和证据。越出授权目录或无法对应到真实源码的内容不会进入最终报告。

用户会得到什么

报告最多展示三个候选位置。每个位置包含具体文件和行号，并附上后端重新提取的源码原文。报告还会解释业务现象怎样经过代码路径形成错误状态，并提供修复建议和验证方式。

第一项候选默认展开，方便开发直接开始阅读。其余候选保持折叠，避免第一次打开报告时信息过多。整份结果可以下载为 Markdown 文件，继续放进工单、评审记录或开发协作工具。

演示案例

项目附带一个订单取消案例。用户使用优惠券完成下单，随后取消订单。订单状态已经变成取消，优惠券状态仍停留在已使用，下一次下单因此失败。

示例代码把请求处理、订单服务、优惠券服务和数据仓储分在多个文件中。这个结构能够展示追因怎样从一段业务描述开始，沿着调用和状态变化寻找优先检查位置。

产品边界

追因当前只扫描 Python 源码。它不会运行目标项目，不会安装依赖，也不会自动修改代码。它提供的是根因候选和排查起点，开发仍需结合日志、测试与真实环境确认结论。

当前版本运行在用户本机，只允许一个分析任务同时进行。源码片段会发送给用户的 Codex 登录所对应的模型服务，因此只能分析用户有权提交的代码。

当前完成度

现有演示版已经具备视频首页、业务工单、明确授权、只读扫描、模型分析、候选报告、真实失败提示和 Markdown 下载。后端测试覆盖扫描范围、证据重建、授权检查和并发限制。

它适合用于确认一件事。业务异常能否经过一套清晰流程，变成开发愿意继续复核的代码线索。下一阶段需要在更多真实缺陷上记录定位质量、任务完成率和开发采用情况，再决定是否扩大语言范围或加入日志分析。