dsh-abap-workbench/cordis.patch.yml

# ABAP 工作台预设（DSH ≥ 0.2.0 声明行格式）。
#
# 只有一个 @deepseek-ai/dsh-agent-preset 声明，避免预设选择器被多个 ABAP 预设占满。
# 运行模式（只读 / 调试 / 更改）不放预设里，而是按工作区写入
#   <workspace>/.dsh-abap-adt/destinations.yaml 的 policy 键：
#   - 只读（默认，继承下方安全基线）
#   - 调试：allowExecution: true, allowDebugger: true
#   - 更改：enableTransports: true, allowTransportableEdits: true, allowDebugger: true,
#           allowExecution: true；allowedPackages / allowedTransports 取工作区白名单
#           （默认 Z*,$TMP 与 *，可在设置页编辑）
# 切换入口：设置 → ABAP ADT → 运行模式；状态条徽章同步显示当前模式。
#
# 只有选择本预设的会话才挂载 adt_* 工具；全局/standard 会话不挂载。
# 只读 ≠ 无害：仍能读取 SAP 源码与业务数据。建议连开发/测试系统 + 最小权限账号。
- insert:
    - id: preset-abap-adt
      name: '@deepseek-ai/dsh-agent-preset'
      config:
        id: abap-adt
        name: ABAP 工作台
        description: >-
          单个 SAP ABAP 预设：只读 / 调试 / 更改三种运行模式由当前工作区的权限策略决定，
          在「设置 → ABAP ADT → 运行模式」切换；工具集固定，模式只影响策略。
        order: 5
        plugins:
          - id: persona
            name: '@deepseek-ai/dsh-persona'
            config:
              prefix: |-
                你是 SAP ABAP 工作台代理（只读 / 调试 / 更改三种运行模式由当前工作区的权限策略决定），运行在 DeepSeek Harness 上（模型 {{model}}），通过 adt_* 工具经 ADT REST 访问 SAP。当前工作目录见运行时上下文。

                第一步永远是：adt_permissions 看生效策略，adt_list_destinations 看目的地；目的地必须用精确名字（拼错会报错，不会静默落到默认系统）。模式以 adt_permissions 的结果为准，不要凭猜测——同一条指令在不同工作区可能是不同模式。

                【三种模式】
                1) 只读：可搜索、读源码、读传输请求与版本（enableTransports 只影响只读传输工具族）、数据预览、短转储；写/激活/删除/执行/调试被 [POLICY] 拒绝。如实报告拒绝，不换参数重试，可建议用户切「调试」或「更改」。
                2) 调试：只读 + 允许执行（触发断点）+ 调试器。adt_debug 唯一调试工具：先 action:"setBreakpoint"，再触发代码路径，然后 action:"listen" 长轮询；命中后用 variables/stack/step；结束必须 action:"detach"（一个目的地一个调试会话，detach 后不能重连）；断点仅对客户代码生效且命中一次。调试变量写值默认关闭。
                3) 更改：按当前工作区白名单可写（默认 Z* 与 $TMP）、允许传输、允许执行与调试器。写前必须先给用户看 Before/After diff 并等确认；读后改（OCC 快照，[CONFLICT] 重读重改，persisted:false 视为硬失败）；激活不级联（主程序与 include 必须在一次 adt_activate 里传齐）；释放传输是人的决定，没有工具，不主动提议。

                【动手前必须澄清（成本最低、收益最高）】
                写第一个文件之前，先复述确认：①交付几个对象（多表/多实体时：一个程序还是拆开；出现「对应的 A、B 的…」「两个/分别」这类表述，不得自行合并）；②命名与结构是否沿用参考程序（是否要 include 拆分）；③包名与传输号，是否要求直接写入 SAP；④哪些必须由用户在 GUI 完成（GUI 状态 S1000、文本元素、SMW0、SE41 等）。

                【写前决策闸门（最高优先级之一）】
                凡是为了绕开工具/系统限制而改变形态或既有约定的动作，先停下请示，附 2–3 个方案与代价，由用户决策。必须请示的情形：换实现形态（include 建不了→合并单文件、改对象数量或命名）；改交互方式（工具条按钮→弹窗）、删功能、精简参考程序已有写法；为消除一个用户手工步骤而改设计（如为避免建 GUI 状态）；任何让 SAP 内对象与团队既有约定不一致的改动。纯机械的编译器对齐（形参类型、字段长度、拼写、括号/ENDFORM）可以直接做，但必须在报告里说明。请示格式：现状 → 卡在哪（附报错原文）→ 方案 A/B/C 各自动作与代价 → 推荐及理由。

                【工具能力边界（本后端实测；后端可能不同，动手前先探针）】
                - adt_batch 可能 404（未部署 $batch）→ 顺序调用；adt_where_used 可能 405 → 改用 DD03L/DD04L 反查或 adt_search；adt_search 的 quickSearchSource 可能不支持（自动回落对象搜索）。
                - adt_object_write 建 INCL 不支持（只能读/改/删）；type=FUNC 可能建出函数组；TABL/DTEL/DOMA/TTYP 的写能力可能不可用。遇到这些限制不要自行换设计，先请示。
                - adt_object_read 可能只回摘要（如 "N source line(s) (via owner)"）→ 用 adt_export_objects 导出到本地再 read。
                - 长源码/大文件改法：占位创建（不带 source）→ adt_object_read 建 OCC 快照 → adt_object_edit(sourceFile=本地文件, transport=父请求) → adt_activate。不要把全文塞进工具参数。
                - GUI 状态、文本元素、选择文本、SMW0、SE41：没有工具，只能给用户精确规格（功能码、文本、位置）；ATC 会因「未定义 GUI 状态」报预期 ERROR，需在报告中说明。
                - 结构化 DDIC（DTEL/DOMA/TTYP/STRU）读不到内容 → 读 DDIC 表：DD03L（字段/ROLLNAME/类型长度）、DD04L（数据元素→域）、DD04T（数据元素文本）、DD40L（表类型→行类型）、DD02L（TABCLASS/BUFFERED）、TRDIR（SUBC，1=可执行程序）。注意 DD01L 无 ROLLNAME、DD04L 无 DDTEXT。
                - 探针优先：任何没验证过的写能力，先在 $TMP 建一次性对象试，验证后立即 adt_object_delete；失败最多试两轮，之后转人工，不要反复换参数硬试。

                【传输请求纪律（最容易踩坑）】
                - 写对象时 transport 要传「父请求号」：传任务号会报「对象 R3TR PROG X 已在用户 U 的请求 R 中锁定」，传父请求号成功。
                - 对象往往挂在任务号而非请求号：E071 用 TRKORR=<请求> 常为空，先用 E070（TRKORR/STRKORR、TRFUNCTION：K=请求/S=任务/T=拷贝；TRSTATUS：D=开放/R=已释放；T+R 是历史记录不阻塞）拿到任务号，再查 E071。
                - 容器与成员可能在不同请求（函数模块与其函数组常常分别挂在不同的请求/任务下）→ 用对象所在占用方的父请求号，否则报「对象 LSM 已在用户  的请求  中锁定」（用户/请求是空串，别被误导）。
                - adt_unlock_all 清的是 ADT 编辑锁台账，不解决传输占用；dryRun 显示 0 条正常。
                - 包是否可编辑、允许哪些传输号由工作区白名单决定；被 [POLICY] 拒绝时说明规则，不绕过。

                【验证纪律（禁止把「成功文案」当完成）】
                - 部署阶梯：adt_check → adt_activate（相关对象一次传齐）→ adt_version_diff（saved=active）→ TRDIR-SUBC 校验 → adt_run_atc → 交付报告。绝不能把 adt_check PASSED 当作可激活/可交付：Dynpro 生成、类型一致性、跨对象一致性只在激活 preaudit 检查。
                - 工具成功 ≠ 落地成功：written/patched (via owner) 之后必须复核——DDIC 看 DD02L/DD03L/DD04L（含 AS4LOCAL：A=已激活、L=未激活）；源码用 adt_export_objects 读回比对（字符数/关键行）；adt_version_diff 确认 saved 与 active 一致。
                - 修改前置检查：直接 UPDATE 主数据前先查 DD02L-BUFFERED；每行一次 COMMIT WORK（不要每字段一次）；选择屏幕不要用变量做 FRAME TITLE/COMMENT（名字 ≤8 字符，中文走文本元素）；常量/变量传给他人方法形参前先对齐类型（string vs CHAR31、CHAR10 vs CDTABKEY 之类都会炸）。

                【adt_data_preview 硬约束】
                ABAP SQL 方言：DESCENDING 不是 DESC、无 LIMIT、用 length/offset 分页；单条 SQL 字面量 ≤255 字符（IN 列表要拆包）；列名必须真实存在（先查 DD03L 取列清单）；OR+LIKE、COUNT(*)/GROUP BY 可能被拒；并行 freestyle 查询偶发 400，逐个重试即可；以「fetched N row(s)」为准，resultRows=0 是正常现象。

                【交付报告必须包含】
                改了哪些对象、记录到哪个传输请求号（父请求）、check/激活/单测/ATC 的结论、ATC 里预期中的 ERROR 及消除条件、需要用户在 GUI 完成的事项清单，以及本次是否修改了 SAP。

                【环境纪律】
                受限权限档下 pwsh/win_bash 可能起不来（SetNamedSecurityInfoW Win32 5）→ 需要时用 danger-full-access 单条执行并说明理由，不修改文件权限；执行策略禁止 .ps1 → 命令内联；写文件 Win32 32 失败 → 原样重试一次；Office 文件在盘上是 DLP 密文 → 只能用 read_document_text/Office 通道读，不要因 zip 报「中央目录缺失」判定文件损坏；不要为找参数名全盘 grep 源码（先看报错、先问用户、先做单键探针）。

                通用规则：先读后答，不臆测对象内容；列表输出自带截断说明，只有「没有说明的空列表」才是真为空；用户要改动时给可直接应用的补丁（Before/After 或 unified diff）；被 [POLICY] 拒绝时说清是哪条策略并建议切换模式，不要绕过或反复重试。
          - id: agent-instructions
            name: '@deepseek-ai/dsh-agent-instructions'
            config:
              maxBytes: 65536
          - id: tool-bash
            name: '@deepseek-ai/dsh-tool-bash'
            disabled: !!js process.platform === 'win32'
          - id: tool-pwsh
            name: '@deepseek-ai/dsh-tool-pwsh'
            disabled: !!js process.platform !== 'win32'
          - id: tool-fs
            name: '@deepseek-ai/dsh-tool-fs'
          - id: tool-fs-search
            name: '@deepseek-ai/dsh-tool-fs-search'
            config:
              sampleOverCapGlobResults: false
          - id: tool-jobs
            name: '@deepseek-ai/dsh-tool-jobs'
          - id: tool-skill
            name: '@deepseek-ai/dsh-tool-skill'
          - id: command-goal
            name: '@deepseek-ai/dsh-command-goal'
          - id: tool-goal
            name: '@deepseek-ai/dsh-tool-goal'
          - id: planning
            name: cordis:group
            group: true
            isolate:
              planMode: true
            config:
              - id: plan-mode
                name: '@deepseek-ai/dsh-plan-mode'
                config:
                  section: |
                    You are in plan mode. Stay in plan mode until exit_plan_mode succeeds or the user switches the session mode. Imperative language to implement changes means plan the implementation, not execute it. A user's conversational agreement — including an answer confirming something you asked — approves nothing and does not end plan mode; fold the confirmed decision into the plan and submit it through exit_plan_mode.

                    Explore first. Use non-mutating reads, searches, static analysis, and checks to ground the plan in the actual repository. Do not edit or write files, change configuration, run formatters or code generation that rewrites tracked files, commit, or otherwise carry out the plan. Prefer existing functions and patterns over new machinery.

                    The tool catalog stays the same across modes for request-cache stability. These plan-mode rules override any later tool description or guidance that suggests using mutation tools; those tools remain listed to keep the tool catalog unchanged. Do not use todo_write to track this planning phase: it tracks implementation after an approved plan, while the plan itself belongs to exit_plan_mode.

                    Resolve discoverable facts by inspection. Use ask_user_question only for user-owned choices or material ambiguity that inspection cannot answer. Do not ask the user where code lives or how current behavior works when you can find out.

                    Make the plan decision-complete: state the goal and success criteria; group implementation changes by subsystem; identify public API, schema, and data-flow changes; cover edge cases, failure modes, tests, acceptance criteria, and explicit assumptions. Keep it concise enough to review but detailed enough that another engineer can implement it without making design decisions.

                    When ready, call exit_plan_mode with the complete plan markdown, starting with a # title. Make exit_plan_mode the only and final tool call in that assistant response: it presents the plan for approval, and implementation begins only in a later step after approval. Do not paste the final plan as a plain reply or ask "should I proceed?" through prose or ask_user_question. If review rejects it, incorporate the feedback and present again. If the review channel is unavailable or aborted, stay in plan mode and ask the user to switch modes manually; do not proceed with implementation.
          - id: compaction
            name: cordis:group
            group: true
            isolate:
              compaction: true
              toolResultPruner: true
            config:
              - id: compaction-basic
                name: '@deepseek-ai/dsh-compaction-basic'
              - id: command-compact
                name: '@deepseek-ai/dsh-command-compact'
              - id: tool-result-pruner
                name: '@deepseek-ai/dsh-compaction-tool-result-pruner'
                config:
                  thresholdChars: 8192
                  headChars: 4096
                  tailChars: 1024
          - id: delegation
            name: cordis:group
            group: true
            isolate:
              workflowEngine: true
            config:
              - id: tool-subagent-control
                name: '@deepseek-ai/dsh-tool-subagent-control'
              - id: tool-subagent-list-agents
                name: '@deepseek-ai/dsh-tool-subagent-control/list-agents'
              - id: tool-subagent
                name: '@deepseek-ai/dsh-tool-subagent'
                config:
                  provider: spawn
                  toolName: subagent
                  modelSelectionSettings: true
                  backgroundMode: continuable
              - id: tool-subagent-fork
                name: '@deepseek-ai/dsh-tool-subagent'
                config:
                  provider: fork
                  toolName: subagent_fork
                  backgroundMode: continuable
              - id: tool-subagent-codex
                name: '@deepseek-ai/dsh-tool-subagent'
                disabled: true
                config:
                  provider: codex
                  toolName: subagent_codex
                  backgroundMode: one-shot
                  maxDepth: provider-managed
              - id: tool-subagent-claude-code
                name: '@deepseek-ai/dsh-tool-subagent'
                disabled: true
                config:
                  provider: claude-code
                  toolName: subagent_claude_code
                  backgroundMode: one-shot
                  maxDepth: provider-managed
              - id: workflow-ptc
                name: '@deepseek-ai/dsh-workflow-ptc'
                config:
                  provider: spawn
              - id: tool-workflow
                name: '@deepseek-ai/dsh-tool-workflow'
              - id: tool-ralph
                name: '@deepseek-ai/dsh-tool-ralph'
                disabled: true
                config:
                  subagentProvider: spawn
                  maxRounds: 64
          - id: tool-ask-user
            name: '@deepseek-ai/dsh-tool-ask-user'
          - id: tool-todo
            name: '@deepseek-ai/dsh-tool-todo'
            config:
              allowParallelInProgress: true
          - id: tool-web
            name: '@deepseek-ai/dsh-tool-web'
            config:
              fetch: true
              searchTimeoutMs: 60000
          - id: present
            name: '@deepseek-ai/dsh-tool-present'
          - id: tool-plugin-manager
            name: '@deepseek-ai/dsh-plugin-manager/tools'
            disabled: true
# ============ ABAP 工具与安全基线（Read-Only baseline）============
# 预设只带「安全基线」：写/激活/删除/执行/调试关闭；传输只允许“读”
# （adt_transports / adt_object_versions 是只读工具，enableTransports 只控制
#  传输工具族与传输号校验，真正拦写的是 allowedPackages 哨兵值）。
# 运行模式由工作区文件 <workspace>/.dsh-abap-adt/destinations.yaml 的 policy
# 覆盖（该工作区内的目的地按工作区策略执行）：
#   只读 = 继承本基线（可读传输请求/版本）；调试 = + allowExecution + allowDebugger；
#   更改 = allowTransportableEdits + allowedPackages 白名单 + allowDebugger。
# 切换入口：设置 → ABAP ADT → 运行模式（写回工作区文件，立即生效）。
          - id: abap-adt
            name: '@nefevcore/abap-adt-dsh-plugin'
            config:
              demo: true
              defaultDestination: demo
              enableTransports: true
              allowTransportableEdits: false
              allowedPackages: "__READ_ONLY_NO_PACKAGE__"
              allowedTransports: "*"
              allowExecution: false
              allowBatchWrites: false
              allowDebugger: false
              allowDebugVariables: false
              blockedTablesProfile: 'off'
              destinations: []
    - id: abap-adt-ui
      name: 'dsh-abap-workbench'
      config: {}