让 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/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)
安全上有三条硬约束,不靠”自觉”:
- 写操作必须显式调用,全部
stateful会话、全部进审计; - 语法检查不过不激活——返回
syntax-error且activated=false,想”带错上线”都没有路径; - 标准对象拒写——只允许
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 | RQ(1 条需求 + 6 条约束) |
需求决定做什么,约束决定怎么做。这条线一旦清晰,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)→ 阻塞 |
第 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。

1 | " ❌ 错:整表结构接收 3 列 → 按位置填充,首字段吃掉第一列 |
这个坑直接导致 3 条自动用例首轮失败、1 个致命缺陷。修复后被写进插件技能「ABAP 开发纪律」,下次同类查询会先被提醒。
坑 2:HR 透明表不能直读
SELECT ... FROM pa0001 / pa0002 一跑就是 HTTP 500 转储——HR 透明表会触发 HR 权限检查路径。BAPI_EMPLOYEE_GETLIST 也一样。
正解走 HR_READ_INFOTYPE(内部处理权限,返回 sy-subrc),人员清单来源改用 HRP1001 组织关系:
1 | CALL FUNCTION 'HR_READ_INFOTYPE' |
坑 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 不会写”,而是特定内核版本的真实语法边界。价值在于:每修完一类,就把约束写进插件技能,下次生成代码前先避让。
七、交付证据(不是自述,是可核对的)
| 项 | 结果 | 证据来源 |
|---|---|---|
| 对象激活 | 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)。改变的是:
- 取数、写码、激活、运行、取证在同一个上下文里,不换工具、不粘来粘去,错误当场暴露;
- 文档不是事后补的:FS/TC/TR 由技能模板产出,且必须引用真实证据编号,编不出来;
- 知识会沉淀:每踩一个坑,根因写进技能「ABAP 开发纪律」,下次生成前自动避让——经验从聊天记录搬进系统;
- 交付可复核:任何结论都能追到工具调用和输出,”任务完成”必须拿出跑通的证据。
对顾问来说,时间从”操作”转向”设计与验收”;对 AI 来说,工具面就是能力边界——给它 33 个能读能写能跑的工具,它才可能真正交付;只给它聊天窗口,它只能猜。
十、下一步
- 把这次的 6 个坑补进
sap-abap-dev-discipline技能的自检清单(已部分完成) - 传输链路补一条”从
$TMP到指定包 + 请求号”的标准流程 - 让 FS/TC 生成时强制带”证据占位符”,交付前必须回填真实证据
- 把权限口径验证做成可复用的探针脚本(需要 Basis 配双用户)
一句话总结:这次不是”AI 写了个 ABAP 报表”,而是”AI 在 SAP 里走完了一条可审计的交付链”——而这条链上的每个结论,都有证据。
如果你也在做类似的事(ADT / MCP / 智能体工具化),欢迎交流。下一篇我会拆插件本身:33 个工具怎么设计的、写通道的安全护栏怎么做的、离线分发包怎么让没有 Gitea 账号的同事一条命令装好。
ZRP_EMP_QUERY + 逻辑类 ZCL_EMP_QUERY + 自检程序 ZRP_EMP_QUERY_CHK;开发包 $TMP,仅验证能力,未涉及客户系统与生产传输。