欢迎光临

ARTEX 报告二次开发:把一次评估整理成可复核的整改单

一次评估结束后,报告里可能只有一句“审批记录不完整”。开发同事接到这句话,仍要追问:哪一条记录缺了什么,谁负责修,复测时要拿什么证明已经修好?本文做一个离线转换器,把已经过人工复核的发现整理成 CSV。它只读报告文件,不需要启动 ARTEX,也不用连接被评估的系统。

ARTEX 原作者在 2026 年 10 月宣布项目转为闭源。团队手上留存的版本和导出格式可能不同。下文的 JSON 是为本文定义的中间格式;接入实际报告时,只需把已有字段映射到这份约定。ARTEX 项目变动记录

用两条虚构发现走一遍交接

假设报告编号为 SAT-01。F01 记录了审批日志缺少复核人,仍在等待客服平台组修复。F02 记录了工单归档缺少策略版本,平台运维组已完成修复和复测。原始证据保存在受控位置,交给工程团队的整改单仅保留索引。本例中的四个证据编号含义如下。

证据示例记录的含义
E01、E02E01 是一次虚构审批的审计行;E02 是要求保留复核人的字段清单,两者对照后确认缺项。
E03、E04E03 对应修前归档,缺策略版本;E04 对应修后重新生成的归档,已记录策略版本和复核结论。

给每条发现一个在同一报告内稳定的编号。复测沿用这个编号。两段描述即使措辞相同,若来自两次独立评估,也可以借助报告编号分开。下面是第一条输入的完整字段;配套 JSON 含两条。

{
  "run_id": "SAT-01",
  "findings": [{
    "id": "F01",
    "title": "客服操作的审批记录缺少复核人",
    "evidence": ["E01", "E02"],
    "owner": "客服平台组",
    "state": "待修复",
    "retest": "未复测"
  }]
}

把现有 ARTEX 报告映射进来

先取一份准许共享的导出副本。若是 Markdown 或 PDF,从已复核的发现段落逐条提取标题,把页码、日志行或截图位置登记成证据编号。若是结构化导出,用该版本实际的记录 ID、摘要和证据引用做字段映射。一个发现下面有三张截图,应生成一条带三个证据编号的记录。三段彼此独立、要由不同团队修复的发现,则应拆成三条。

owner 填已经接单的团队;原报告尚未分派时,先在交接会上确认。state 和 retest 从真实整改流程填写。报告里写“建议修复”时,初值应为“待修复 / 未复测”。修复方说已上线可转“待复测”,有对应复核记录后再关闭。

生成 CSV,再选一条回查

将转换器和示例 JSON 放在同一目录,运行下面的命令。输出文件名应是新名字,以免覆盖人工已经补过的整改单。程序只依赖 Python 3.10 或更新版本的标准库。下载转换器 · 下载完整输入

python report_to_csv.py report-sample.json repair.csv

本地执行返回 2 records。输出包含下列六列,可以直接交给负责人筛选。下载本次运行生成的 CSV

记录号发现证据编号负责人修复状态复测结果
SAT-01/F01客服操作的审批记录缺少复核人E01 | E02客服平台组待修复未复测
SAT-01/F02工单归档遗漏策略版本E03 | E04平台运维组已关闭通过
转换器实际输出了两条记录。下半部分用 PowerShell 重新读取刚生成的 CSV,核对负责人、修复状态和复测结果。
转换器实际输出了两条记录。下半部分用 PowerShell 重新读取刚生成的 CSV,核对负责人、修复状态和复测结果。

转换器会先检查整份输入。发现空的证据列表、重复的发现编号,或“已关闭 / 未复测”的组合时,它会返回非零退出码。多证据保存在同一个单元格;字段中的逗号由 CSV 库转义。输出采用带 BOM 的 UTF-8,便于在常用中文表格软件中打开。以公式符号开头的文本会加单引号,避免被表格软件当作公式执行。

怎样检验这张表没有替人下结论?

在输入副本中,把 F02 的 retest 改成“未复测”,保留“已关闭”。换一个输出文件名再运行,转换器应指出 F02 关闭前需要通过复测。这道检查只负责字段一致性。即使表上写了“通过”,复核人仍需沿 E04 找回对应版本的修后记录,确认记录真的解决了 F02,而不是另一张工单。

若要接入工单系统,可将“报告号/发现号”作为外部记录键,先让负责人复核导入预览。之后相同编号更新原单,新增编号才建新单。这样同一份评估做两次交接,也能保留完整的整改历史。

【本站文章皆为原创,未经允许不得转载】:汤不热吧 » ARTEX 报告二次开发:把一次评估整理成可复核的整改单
分享到: 更多 (0)

评论 抢沙发

  • 昵称 (必填)
  • 邮箱 (必填)
  • 网址