让 AI 在 SAP 里交付:用 DSH-SAP-WORKBENCH 把 ABAP 从需求做到测试

让 AI 在 SAP 里交付:用 DSH-SAP-WORKBENCH 把 ABAP 从需求做到测试

我给 AI 出了一道题:

「参考 BCALV_TEST_FULLSCREEN,开发一个员工信息查询的 ALV 报表程序并完成测试。只能使用 DSH-SAP-WORKBENCH 插件中的功能,我要测试一下功能是否完整。」

一天之后,交付物是:1 份需求说明、1 份功能设计书、16 条测试用例、1 份测试报告、3 个已激活的 SAP 对象、24 条断言全绿、报表实跑 200 行中文输出——全部在一个对话里完成,没有打开 SAP GUI,没有手工截图拼文档。

这不是”AI 帮我写了一段 ABAP 代码”,而是 AI 真正进入 SAP 系统:读对象、读源码、建对象、写代码、激活、运行、取证、出文档。

这篇文章把这次实战完整拆开:架构怎么搭的、流水线怎么跑的、踩了哪 6 个坑、以及为什么我认为”证据链”比”代码”更值钱。

整体架构


一、痛点是「摸不到系统」

SAP 顾问日常最耗时的从来不是”想逻辑”,而是在系统里来回搬东西:

  • 查一张表要开 SE16N,看结构要 SE11,读源码要 SE80/SE38,测报表要 SA38,权限问题找 Basis……
  • 写一段 ABAP,改一次、激活一次、跑一次、截图一次,最后再手工拼 FS/TC/测试报告
  • 同一个坑,上一个人踩过,下一个人接着踩——经验留在聊天记录里,不在系统里

大模型能写 ABAP,但它碰不到系统:读不到对象真实源码、激活不了、跑不了、证明不了。于是对话里出现的是”看起来能跑”的代码,交付时还是人肉搬一遍。

所以我做了 DSH-SAP-WORKBENCH——一个 DeepSeek Harness(DSH)的插件,把 SAP 的 ADT 接口封装成 MCP 工具,让模型在同一个对话里完成「查 → 写 → 激活 → 运行 → 验证 → 出文档」。

ℹ️这不是 SAP 官方产品
插件是我自建自用的团队工作台,走标准 ADT(/sap/bc/adt)通道,不绕过、不放大 SAP 权限——你的账号能做什么,它就能做什么。

二、架构:一个插件,33 个工具

整套东西塞在 DSH 的一个插件包里,四层各司其职:

层 职责
host 六个面板(SAP_Config / Soul / User / Skills / MCP / Setting)、本机加密凭据、审计流水
mcp sap-adt-mcp.mjs:33 个工具经 ADT 操作 SAP,是模型真正的”手”
skills 8 类交付文档模板(FS / TS / 测试计划 / 测试用例 / 配置 / 蓝图 / 切换 / 手册)+ 3 件工程纪律
client DSH 侧边栏的工作台界面,多系统切换、连接状态、激活系统

工具按能力分四组:

  • 读(只读):表数据、表字段、对象信息、ABAP 源码、版本历史、引用追踪、包内对象、包元数据
  • 写(v3.0 新增):sap_sync_source(写源码 → 语法检查 → 激活 → 回查)、sap_put_source、sap_activate_object、sap_create_object、sap_syntax_check、sap_delete_object(必须显式 confirm=true)
  • 工作区:sap_workspace_scan / pull / sync——本地 src/<包>/<类型>/<对象>.abap 三层结构,SAP ⇄ 本地双向同步
  • 质量与传输:ATC、ABAP Unit、sap_diff_source、传输创建/释放、sap_run_program(工具报表通道,等价 SE38 F8)

安全上有三条硬约束,不靠”自觉”:

  1. 写操作必须显式调用,全部 stateful 会话、全部进审计;
  2. 语法检查不过不激活——返回 syntax-error 且 activated=false,想”带错上线”都没有路径;
  3. 标准对象拒写——只允许 Z*/Y* 命名空间,防止 AI 改到 SAP 标准程序。

SAP 密码用 AES-256-GCM 加密存在本机 ~/.dsh/sap-workbench/,密钥独立成文件、两者都不进仓库、不上传、不写日志。

三、题目:只准用插件,还要有证据链

初始需求就一句”开发员工信息查询 ALV 报表,并完成测试”。我追加了一条约束:

「按照开发的习惯,你需要证明你的证据链是完整的。是否有 FS 文档、TC 文档、源代码、测试结果报告?你光是给我说任务完成是没有说服力的。」

这就把任务从”写代码”变成了”交付一个可审计的工程结果“。最终范围:

  • 需求:按人员编号 / 人事范围 / 员工组 / 组织单位 / 姓名五维筛选,按指定日期取”当天在职”,展示个人数据 + 人事分配数据,组织代码解码为中文文本,ALV 网格展示
  • 技术对象:ZRP_EMP_QUERY(报表)+ ZCL_EMP_QUERY(逻辑类)+ ZRP_EMP_QUERY_CHK(自检程序,可随时回归)
  • 执行通道:全程插件工具,不借道 SAP GUI、不直连 ADT

四、先纠正一个认知:需求 ≠ 任务要求

这是这次我觉得最有价值的细节之一。

AI 第一版把”参考 BCALV_TEST_FULLSCREEN 学习”、”必须完成测试”、”只能使用插件”这些都写成了需求条目。我把它按下去了:

  • 需求(R-xx)只有 1 条:员工信息查询报表
  • 任务要求与约束(C-xx)是另一类:参考哪个样例、用哪套工具、怎么交付、要什么证据

为什么较真?因为混淆两者会让验收标准漂移。”参考某个样例”是手段,换一个样例需求也该成立;”必须测试”是质量要求,不产生功能点。混在一起写,最后必然出现”因为没照某个样例写所以不通过”这类扯不清的验收。

修正后文档结构变成:

1
2
3
4
RQ(1 条需求 + 6 条约束)
└─ FS(11 个功能点 F-01~F-11,字段映射、取值域、证据表)
└─ TC(16 条用例:13 自动 + 3 人工,追溯矩阵)
└─ TR(执行结果、缺陷史、阻塞清单、证据索引)

需求决定做什么,约束决定怎么做。这条线一旦清晰,AI 的产出质量会立刻不同——它不再”猜你想看什么”,而是照着可验收的口径交付。

💡给 AI 下任务的小技巧
一句话需求 + 一份”验收方式”(看什么、比什么、跑到什么算过),比写十段背景描述都管用。约束要单独列,别和需求混写。

五、六步流水线

六步流水线

第 1 步:先让 AI 读 SAP

第一步不是写代码,而是读系统:

  • sap_object_info 确认参考程序存在、包、负责人
  • sap_get_source 分页把 BCALV_TEST_FULLSCREEN 读完(5773 行),提取 ALV 报表的骨架:选择屏、字段目录、排序表、布局、事件、展示调用
  • sap_read_table 摸取值域(性别代码、组织文本表),并顺手做环境探针

这一步决定了后面少走多少弯路。AI 最大的优势不是写得多快,而是能把标准程序”读透”再动手——人类顾问往往会跳过这段。

第 2 步:需求 → 设计(FS)

按 sap-doc-fs 技能产出功能设计书:11 个功能点、字段映射表、取值域与编码规则、权限需求、非目标、待确认清单。11 个功能点里有两项是”为了可测试/可运维”专门加的:

  • 无 GUI 降级:检测不到 GUI 时输出列表而不是调 ALV(否则必然转储)
  • 行数上限(默认 200):防止前端被大结果集拖垮

第 3 步:用例先行(TC)

16 条用例,13 条自动可执行、3 条明确标”必须 GUI 人工”:

用例 覆盖 执行方式
TC-EMP-01~13 解码 / 年龄 / 截断 / 字段目录 / 排序 / 过滤 / 空结果 / 日期窗口 / 文本解码 / 主键唯一 / 端到端 / 负向护栏 自动(探针 + 自检程序)
TC-EMP-M01~M03 ALV 视觉交互 / P_ORGIN 权限口径 / F4 弹窗 人工(GUI)→ 阻塞
⚠️诚实比全绿重要
这个执行通道没有 GUI,就没有屏幕能力。ALV 长什么样、F4 弹不弹、不同权限用户看到什么——这些必须标阻塞,不能”自动测试跑通了”就宣布全过。

第 4 步:编码 → 落地(sync)

代码写在本地三层工作区,一次 sap_workspace_sync 完成四件事:

1
写源码 → 语法检查 → 激活 → 回查 version=active

语法检查不过就停在那一步,不会激活半成品。这次前四轮同步各拦下 5 条语法错误(下面「坑」里细说),第五轮 3/3 激活。

第 5 步:跑起来,拿真证据

sap_run_program 是那个”让模型能真正执行”的工具(等价 SE38 F8 默认选择):

  • 跑自检程序 ZRP_EMP_QUERY_CHK:24/24 断言 PASS(首轮 21 过 3 失败,修完复跑全绿)
  • 跑报表本体:200 行中文输出,组织单位/职位/人事范围/员工组全部解码正确

这里的关键设计是:自检程序测的类,和报表运行的类是同一个类(ZCL_EMP_QUERY)。否则”测试通过”只是测试通过,和交付物无关。

第 6 步:证据链收口

  • sap_diff_source:本地工作区 ↔ SAP 对象源码 0 差异
  • sap_audit_tail:整条链路的写/激活操作都有审计流水
  • sap_delete_object:探针对象删掉并复核不可读(清理也要留证)
  • RQ → FS → TC → TR 四件套互相引用,每个结论后面都挂证据编号

六、真正的难关:六个坑

坑 1(最贵):SELECT 出来 0 行,问题不在 SQL

现象:人员清单永远 0 行,组织文本全空。SQL 没错、数据也有。

根因:用整表结构接收部分列。ABAP 在”目标内表列数少于结构字段数”时按位置填充,HRP1001 的首字段是 MANDT,于是 OBJID 被塞进 MANDT、真正的 OBJID 恒为 0。

SELECT 结构错位

1
2
3
4
5
6
7
8
9
10
" ❌ 错:整表结构接收 3 列 → 按位置填充,首字段吃掉第一列
DATA lt_rel TYPE STANDARD TABLE OF hrp1001.
SELECT objid sclas sobid FROM hrp1001 INTO TABLE lt_rel WHERE ...

" ✅ 对:与查询列同型的小结构
TYPES: BEGIN OF ty_s_rel,
objid TYPE hrp1001-objid,
sclas TYPE hrp1001-sclas,
sobid TYPE hrp1001-sobid,
END OF ty_s_rel.

这个坑直接导致 3 条自动用例首轮失败、1 个致命缺陷。修复后被写进插件技能「ABAP 开发纪律」,下次同类查询会先被提醒。

坑 2:HR 透明表不能直读

SELECT ... FROM pa0001 / pa0002 一跑就是 HTTP 500 转储——HR 透明表会触发 HR 权限检查路径。BAPI_EMPLOYEE_GETLIST 也一样。

正解走 HR_READ_INFOTYPE(内部处理权限,返回 sy-subrc),人员清单来源改用 HRP1001 组织关系:

1
2
3
4
5
CALL FUNCTION 'HR_READ_INFOTYPE'
EXPORTING pernr = iv_pernr infty = '0001'
begda = iv_date endda = iv_date
TABLES infty_tab = lt_0001
EXCEPTIONS infty_not_found = 1 others = 2.

坑 3:没有 GUI 还去调 ALV,必然转储

REUSE_ALV_GRID_DISPLAY_LVC 在没有 GUI 的执行通道里直接 500。这不是 bug,是硬护栏。所以报表里先判 GUI_IS_AVAILABLE:有 GUI 走 ALV,没有就降级成列表输出——既保住了自动测试,也保住了人工使用的体验。

坑 4:ABAP Unit 端点”发现测试但一条也不跑”

本系统 ADT 的 ABAP Unit 端点能列出 10 个测试方法,但 tests=0——不执行 LOCAL 测试类。这意味着看起来有测试框架,实际拿不到证据。

应对:改用自检程序(ZRP_EMP_QUERY_CHK)做断言,sap_run_program 实跑,输出 24 条 PASS/FAIL。可复跑、可回归、可留证。

坑 5:ATC 端点 404

本系统没提供 ADT 的 ATC 服务。插件没有假装成功,而是明确返回”该服务不存在,请走 SATC(GUI)”。能力边界说清楚,比给一个假绿更专业。

坑 6:语法代差与 Open SQL 方言

四轮语法错误共 20 条,集中在两类:

  • 版本差异:LVC_S_FCAT-TIP 组件不存在、assert_that 没有 condition 形参、boolc() 不能作 PERFORM 实参、'' 与 D 类型不兼容
  • 方言限制:Open SQL 不支持 IS NOT INITIAL(要写 <> '')

这些都不是”AI 不会写”,而是特定内核版本的真实语法边界。价值在于:每修完一类,就把约束写进插件技能,下次生成代码前先避让。

💡这类坑的正确用法
不要只修代码——把根因写成注释/技能条目。ABAP 这种强版本相关的语言,”经验”就是生产力。

七、交付证据(不是自述,是可核对的)

项 结果 证据来源
对象激活 3/3 active sap_object_info ×3
语法检查 0 错误 sap_syntax_check / sync 回执
自动用例 13/13 通过 自检程序 + 探针
断言级 24/24 PASS sap_run_program ZRP_EMP_QUERY_CHK
端到端 报表实跑 200 行中文输出 sap_run_program ZRP_EMP_QUERY
代码一致性 本地 ↔ SAP 0 差异 sap_diff_source
审计留痕 全链路 sap_audit_tail
清理 探针对象删除并复核不可读 sap_delete_object ×2
人工验收 3 项阻塞(ALV 视觉 / F4 / 权限口径) 如实标阻塞,待 GUI
遗留 5 项待确认(不阻断交付) FS §12 Open Items

我把结论分成两句话,这也是我要求 AI 以后的标准口径:

  • 链路通:create → sync → 激活 → 回查,每一步都有编号、有文件;
  • 验证通:自检程序和报表本体实际执行并产出可核对输出,不是”已实现”三个字。

八、这套方法的边界

别吹过头。这次演示证明了”AI 能在 SAP 里自动完成开发链路”,但也明确了做不到的部分:

做不到 原因 需要谁
ALV 视觉 / 交互 / F4 弹窗验收 执行通道无 GUI 顾问在 SAP GUI 人工验收
多用户权限差异化验证 需要角色配置 Basis + 业务
性能压测 演示数据量小 性能团队
传输发布到 QAS/PRD 生产路径需审批 顾问 + Basis

AI 交付的是”可验证的完成度”,不是”签字”。签字永远是人的事。

九、为什么我觉得”证据链”比代码更值钱

这次真正改变工作方式的不是”AI 会写 ABAP”——这件事两年前就能做到(生成代码贴进 SE38)。改变的是:

  1. 取数、写码、激活、运行、取证在同一个上下文里,不换工具、不粘来粘去,错误当场暴露;
  2. 文档不是事后补的:FS/TC/TR 由技能模板产出,且必须引用真实证据编号,编不出来;
  3. 知识会沉淀:每踩一个坑,根因写进技能「ABAP 开发纪律」,下次生成前自动避让——经验从聊天记录搬进系统;
  4. 交付可复核:任何结论都能追到工具调用和输出,”任务完成”必须拿出跑通的证据。

对顾问来说,时间从”操作”转向”设计与验收”;对 AI 来说,工具面就是能力边界——给它 33 个能读能写能跑的工具,它才可能真正交付;只给它聊天窗口,它只能猜。

十、下一步

  • 把这次的 6 个坑补进 sap-abap-dev-discipline 技能的自检清单(已部分完成)
  • 传输链路补一条”从 $TMP 到指定包 + 请求号”的标准流程
  • 让 FS/TC 生成时强制带”证据占位符”,交付前必须回填真实证据
  • 把权限口径验证做成可复用的探针脚本(需要 Basis 配双用户)

一句话总结:这次不是”AI 写了个 ABAP 报表”,而是”AI 在 SAP 里走完了一条可审计的交付链”——而这条链上的每个结论,都有证据。

如果你也在做类似的事(ADT / MCP / 智能体工具化),欢迎交流。下一篇我会拆插件本身:33 个工具怎么设计的、写通道的安全护栏怎么做的、离线分发包怎么让没有 Gitea 账号的同事一条命令装好。

📌关于本次对象
演示对象:员工信息查询 ALV 报表 ZRP_EMP_QUERY + 逻辑类 ZCL_EMP_QUERY + 自检程序 ZRP_EMP_QUERY_CHK;开发包 $TMP,仅验证能力,未涉及客户系统与生产传输。