sapbuddy-dsh 0.0.8 → 0.0.10

package/README.md

@@ -2,7 +2,7 @@
 
 [![npm](https://img.shields.io/npm/v/sapbuddy-dsh)](https://www.npmjs.com/package/sapbuddy-dsh) [GitHub](https://github.com/gxx950224/sapbuddy-dsh)
 
-[SapBuddy](https://github.com/gxx950224/sapbuddy) 的 DeepSeek Harness 插件，提供 41 个 SAP ABAP 工具、8 个技能、SapBuddy agent preset 和 SAP 连接设置页。
+[SapBuddy](https://github.com/gxx950224/sapbuddy) 的 DeepSeek Harness 插件，提供 41 个 SAP ABAP 工具、10 个技能、SapBuddy agent preset 和 SAP 连接设置页。
 
 ## 安装
 
@@ -10,13 +10,13 @@
 在 DSH 的插件管理页添加：
 
 ```text
-sapbuddy-dsh@0.0.8
+sapbuddy-dsh@0.0.10
 ```
 
 也可以通过 DSH 命令行安装：
 
 ```bash
-dsh plugin --profile desktop add sapbuddy-dsh@0.0.8
+dsh plugin --profile desktop add sapbuddy-dsh@0.0.10
 ```
 
 更新已安装插件后，完整退出并重新启动 DSH，再新建会话选择 **SapBuddy**。
@@ -34,16 +34,16 @@ dsh plugin --profile desktop add sapbuddy-dsh@0.0.8
 
 ## 连接配置与排查
 
-地址必须写全协议，协议要和端口一致：
+在 **设置 → SAP 连接** 中填写主机地址时，必须带协议，且协议与端口一致：
 
 | 端口 | 协议 | 示例 |
 |---|---|---|
-| ICM HTTP（常见 8000） | `http://` | `http://192.168.111.85:8000` |
-| ICM HTTPS（常见 44300） | `https://` | `https://10.8.202.35:44300` |
+| ICM HTTP（常见 8000） | `http://` | `http://<host>:8000` |
+| ICM HTTPS（常见 44300） | `https://` | `https://<host>:44300` |
 
-把 HTTP 端口写成 `https://`（或反过来）会在 TLS 阶段直接失败。客户端号就是登录用的 `sap-client`，必须与要登录的客户端一致——系统是 300 却填 200 会直接返回 401 认证失败；登录语言不确定时填 `EN`。内部系统若是自签名证书，编辑连接时保持「允许自签名证书」勾选。
+协议写错（例如 HTTP 端口却用 `https://`）会导致 TLS/连接失败。客户端号即登录用的 `sap-client`，必须与目标客户端一致，否则会返回 401。登录语言不确定时建议填 `EN`。内网自签名证书可勾选「允许自签名证书」。
 
-设置页的 **测试** 按钮与真实 SAP 工具走同一套协议/客户端号/语言（早期版本把探活写死成 https 且只发 `X-sap-login-client` 头，会出现"账号密码都对却报 401"或"http 端口永远探测失败"的假阴性）。测试返回 401 时按提示核对客户端号、账号状态与登录语言；403/404 多为 ADT 服务未激活或用户无权限。
+设置页的 **测试** 与真实 SAP 工具使用同一套协议、客户端号与语言。返回 401 时核对客户端号、账号与语言；403/404 多为 ADT 未开通或权限不足。
 
 ## 连接切换与会话自愈
 
@@ -57,7 +57,7 @@ dsh plugin --profile desktop add sapbuddy-dsh@0.0.8
 
 工具涵盖对象搜索与读码、代码导航、语法诊断与激活、ATC 与单元测试、SQL 查询、DDIC、文本池、屏幕文本、消息类、函数模块接口和传输请求。
 
-技能包括 `abap-code-review`、`abap-explain`、`abap-templates`、`abap-wiki`、`clean-abap`、`dev-write`、`sap-abap-skills`、`translate-workflow`。
+技能包括 `abap-code-review`、`abap-explain`、`abap-templates`、`abap-wiki`、`clean-abap`、`dev-write`、`sap-abap-skills`、`translate-workflow`、`sap-fs`（四类 FS：MD + Claude 风 HTML）、`grilling`（经 sap-fs 加载的追问澄清）。
 
 ## 配置和写入保护
 
@@ -74,7 +74,7 @@ dsh plugin --profile desktop add sapbuddy-dsh@0.0.8
 从 GitHub 克隆仓库后，在 `packages/sapbuddy-dsh` 下运行激活回归测试（需要 Node.js 24+，无需连接 SAP）：
 
 ```bash
-npm test                      # = test:activation + test:session + test:store + test:probe + test:route + test:bundle
+npm test                      # = test:activation + test:session + test:store + test:probe + test:route + test:bundle + test:sap-fs
 npm pack --dry-run --ignore-scripts
 ```
 

package/defaults/prompts/SYSTEM.md

@@ -32,7 +32,8 @@ SapBuddy — SAP ABAP AI 全能助手，面向**开发顾问与业务顾问**。
    - **工具硬化**：`create_object_programmatically` 缺包名/描述会被拦截；传 $TMP 需用户单独确认（不进传输请求）；`replace_string` 无未释放请求时自动建请求——这些无需 LLM 自觉，工具强制执行。
 6c. **连接切换后先重确认（强制）**：用户切换/修改 SAP 连接后，**必须先调用 `get_connected_systems` 确认当前连接，再使用其他 SAP 工具**。工具层强制拦截：未确认前其他 SAP 工具一律失败（返回"连接配置已变更，先调用 get_connected_systems"）。看到该拦截错误时，立即调用 `get_connected_systems`，再重试被拦的操作。
 7. **写操作谨慎**：写工具（创建/编辑/激活）需要服务器 `security.readOnly=false`；生产系统只读。
-8. **按技能加载（强制）**：写代码/写 SAP 对象（函数模块/表结构/函数组 include/文本元素等）先遵循 `dev-write` 技能（编码规范、写入规范）；批量翻译（Excel 清单→SAP）先遵循 `translate-workflow` 技能（先 list 后 set、匹配不上报告、**禁止猜 key 写入**）。技能按话题自动加载，做对应任务时**必须遵守**。
+8. **按技能加载（强制）**：写代码/写 SAP 对象（函数模块/表结构/函数组 include/文本元素等）先遵循 `dev-write` 技能（编码规范、写入规范）；批量翻译（Excel 清单→SAP）先遵循 `translate-workflow` 技能（先 list 后 set、匹配不上报告、**禁止猜 key 写入**）。技能按话题自动加载，做对应任务时**必须遵守**；写 FS / 功能设计书时遵循 `sap-fs` 技能（意图不明先问，见铁律 9）。
+9. **FS 意图门禁（强制）**：仅当用户**明确**要写/改 FS、功能设计书、接口/报表/增强**规格文档**（或明确说按 sap-fs 出可交付文档）时，才加载并执行 `sap-fs`。日常问答、配置怎么配、表/事务码解释、程序解释/审查、写 ABAP 代码 → **禁止**触发 sap-fs（写码→`dev-write`；审查→`abap-code-review`；解释逻辑→`abap-explain` / `abap-wiki`）。用户只抛业务描述或方案讨论、**未明确**要出 FS → **先问一句**是否要按 sap-fs 产出 `FS.md` + `FS.html`（接口另附 JSON）；未确认前只澄清/回答，**不**套 FS 模板、不落盘 `output/fs/`。用户确认后才 Skill 加载 `sap-fs`；追问业务决策时再按 sap-fs 流程加载 `grilling`。
 
 ## 防死循环与止损（软约束，靠自觉；能代码强制的已由工具层兜底）
 

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "sapbuddy-dsh",
-  "version": "0.0.8",
-  "description": "SapBuddy —— SAP ABAP AI 全能助手（DeepSeek Harness 插件）：41 个 SAP 工具 + 8 个 ABAP 技能 + SapBuddy preset + 连接设置页。一个包名装完。",
+  "version": "0.0.10",
+  "description": "SapBuddy —— SAP ABAP AI 全能助手（DeepSeek Harness 插件）：41 个 SAP 工具 + 10 个 ABAP 技能 + SapBuddy preset + 连接设置页。一个包名装完。",
   "type": "module",
   "main": "dist/index.js",
   "exports": {
@@ -77,13 +77,14 @@
     "typescript": "^5.6.0"
   },
   "scripts": {
-    "test": "npm run test:activation && npm run test:session && npm run test:store && npm run test:probe && npm run test:route && npm run test:bundle",
+    "test": "npm run test:activation && npm run test:session && npm run test:store && npm run test:probe && npm run test:route && npm run test:bundle && npm run test:sap-fs",
     "test:activation": "node --experimental-vm-modules --test --test-isolation=none test/activation.test.mjs",
     "test:session": "node --experimental-vm-modules --test --test-isolation=none test/session-recovery.test.mjs",
     "test:store": "node --test --test-isolation=none test/connections-store.test.mjs",
     "test:probe": "node --test --test-isolation=none test/connection-probe.test.mjs",
     "test:route": "node --test --test-isolation=none test/connection-test-route.test.mjs",
-    "test:bundle": "node --test --test-isolation=none test/client-bundle.test.mjs"
+    "test:bundle": "node --test --test-isolation=none test/client-bundle.test.mjs",
+    "test:sap-fs": "node --test --test-isolation=none test/sap-fs/loading.test.mjs"
   },
   "publishConfig": {
     "access": "public"

package/skills/grilling/SKILL.md

@@ -0,0 +1,43 @@
+---
+name: grilling
+description: >-
+  Grill the user relentlessly about a plan, decision, or idea. Use when the user
+  wants to stress-test their thinking, or uses any 'grill' trigger phrases
+  (including "grill me"). Also used by sap-fs when clarifying FS business decisions;
+  not the entry skill for FS intent (load via sap-fs after user confirms FS deliverable).
+---
+
+<!--
+Third-party: mattpocock/skills (MIT, Copyright 2026 Matt Pocock)
+Upstream: https://github.com/mattpocock/skills
+  skills/productivity/grilling/SKILL.md
+Pinned blob: df69d9936880cd3314c28858c6c52f48db23b856 (fetched 2026-10-28)
+Adaptation: bundled under sapbuddy-dsh/skills for DSH discovery; description notes sap-fs;
+  "grill me" triggers are covered here directly (no separate grill-me alias).
+-->
+
+Interview the user relentlessly until you reach a shared understanding. Map this as a **design tree**: every decision branches into the decisions that hang off it.
+
+Work the tree in **rounds**. The **frontier** is every decision whose prerequisites are already settled: the questions you can ask _now_ without guessing at answers you haven't heard yet. Ask the whole frontier in one round: number each question and give your recommended answer. Then wait for the user's answers before the next round.
+
+Format a round like so:
+
+```
+❓ **Q1** - **<question title>**: <question body, might be multiple paragraphs, including multiple choices>
+
+➡️ <your recommended answer>
+
+---
+
+❓ **Q2** - **<question title>**: <question body, might be multiple paragraphs, including multiple choices>
+
+➡️ <your recommended answer>
+```
+
+Word each question so "yes" accepts your recommended answer.
+
+Each round the user answers reshapes the tree: settled decisions push the frontier outward and unblock questions that depended on them. Recompute the frontier and ask the next round. A question whose answer depends on another question still open in this round belongs to a _later_ round, not this one.
+
+Finding _facts_ is your job, never the user's. When a frontier question needs a fact from the environment (filesystem, tools, etc.), dispatch a sub-agent to find it; don't ask the user for anything you could look up yourself. Don't block on it: a running exploration is an unsettled prerequisite, so only the questions downstream of it wait for the sub-agent to report; ask the rest of the frontier now. The _decisions_ are the user's: put each to them and wait.
+
+The session is done when the frontier is empty: every branch of the design tree visited, nothing left silently assumed. Do not act on it until the user confirms you have reached a shared understanding.

package/skills/sap-fs/SKILL.md

@@ -0,0 +1,76 @@
+---
+name: sap-fs
+description: >-
+  编写 SAP 功能规格书（FS / 功能设计书）。仅在用户明确要求写/改 FS、功能设计书、
+  接口设计、报表设计、增强设计，或明确说按 sap-fs 出可交付规格文档时触发。
+  日常问答、配置咨询、解释程序、代码审查、写 ABAP 不触发；意图不明时先问是否出 FS。
+  确认后：识别需求类型 → 系统取证 → 用 grilling 追问业务决策 → 按模板生成 FS。
+  触发关键词：写FS、功能规格、功能设计书、接口设计、报表设计、增强设计、出一份FS。
+agent_created: true
+disable: false
+---
+
+# sap-fs — 写 SAP 功能规格书
+
+> 草稿结构（Codex 第一版目录）。模板在 `assets/templates/`，过程规范在 `references/`。
+> 追问逻辑不内嵌：加载 `grilling`。上游许可与钉选说明见 `grilling/SKILL.md` 顶部注释。
+
+## 何时使用
+
+- 用户**明确**要写 / 改 FS、功能设计书、接口 / 报表 / 增强**规格文档**，或明确说按 sap-fs 出可交付文档。
+- 用户确认「要出 FS」之后（见 SYSTEM 铁律 FS 意图门禁）。
+
+不触发：日常问答、配置怎么配、表/事务码解释、程序解释（`abap-explain` / `abap-wiki`）、代码审查（`abap-code-review`）、写 ABAP（`dev-write` / `abap-templates`）。
+意图不明（只抛业务描述 / 方案讨论、未说要出 FS）：**先问一句**是否要按 sap-fs 产出 `FS.md` + `FS.html`（接口另附 JSON）；未确认前不套模板、不落盘 `output/fs/`。
+
+## 资源地图（按需加载，勿一次全读）
+
+| 时机 | 读什么 |
+| --- | --- |
+| 触发后立刻 | 本文件 + `references/fs-contract.md` |
+| 需要连系统 | `references/system-verification.md` |
+| 需要追问 | `references/grilling-integration.md`，并 **Skill 加载 `grilling`**（含 “grill me” 类触发） |
+| 已判定类型 | `references/types/<type>.md` + `assets/templates/fs-base.md` + `assets/templates/<type>.md` |
+| 对齐详略 | `references/example-enhancement.md`（仅增强类样例） |
+| 交付前 | `references/review-checklist.md` |
+| 出归档 HTML / 接口 JSON | `references/archive-html.md` + `assets/templates/fs-archive.html` |
+
+类型文件名：`interface` / `query-report` / `functional-report` / `enhancement`。
+
+## 工作流程
+
+1. **判类型**（混合取主导；ALV 按钮会改业务状态 → 功能报表）。读对应 `types/` 与模板。
+2. **整理已知**：用户已说内容分到需求 / 现状 / 规则，先不提问。
+3. **取证**：按 `system-verification.md` 只查能查的。
+4. **追问**：按 `grilling-integration.md` 加载 `grilling`，只问业务决策。
+5. **生成**：拼装 `fs-base` + 类型专项模板；规则 / 验收 / 待确认 / 附录按 `fs-contract.md`。
+6. **自检**：`review-checklist.md` 通过后再交付。
+
+## 拼装
+
+```
+assets/templates/fs-base.md     # 第1、2、4、5、6、7节 + 附录A
+  + assets/templates/<type>.md  # 第3节
+  + 头部状态行
+= 一份完整 FS
+```
+
+默认落盘目录（用户未指定时）：`output/fs/<需求名>/`（允许的 `output` 子树）；详见下方交付物。
+
+## 交付物（Markdown + HTML，接口另附 JSON）
+
+同一需求目录默认：`output/fs/<需求名>/`
+
+1. `FS.md` — 协作 / AI 主规格。
+2. `FS.html` — 企业归档：套 `assets/templates/fs-archive.html`，规则见 `references/archive-html.md`。
+3. **禁止 logo**（徽标、水印、品牌图都不放）。
+4. **接口类**另出：正文 3.6 样例 JSON + 同目录 `io-request.json` / `io-response.json`（及必要的回调文件）。
+
+先定稿 Markdown，再渲染 HTML / 写出 JSON；自检通过后一并交付路径。
+
+## 硬边界
+
+- 本技能流程**只读 SAP**；FS 确认 ≠ 写入许可。
+- 正文只写事实与决定；训诫与生成纪律留在技能文件，不进 FS。
+- 不虚构表名 / 字段 / 增强点 / 签署与测试结果。
+- HTML 归档不使用任何 logo。

package/skills/sap-fs/assets/templates/enhancement.md

@@ -0,0 +1,52 @@
+<!-- 本片段插入骨架第3节。增强只描述"在哪个时点、改变哪段行为、其余保持原样"。
+     第2节写整体现状；这里只写本次涉及的动作。 -->
+
+## 3. 增强设计
+
+### 3.1 改变的行为
+
+| 动作 | 现状 | 目标 | 保持不变 |
+| --- | --- | --- | --- |
+| <保存 / 过账 / 审批> | <现在怎么处理> | <改变后怎么处理> | <仍须沿用的标准行为> |
+
+**实施方式**：<标准配置能否满足；选增强的理由。未验证的判断标 Q。>
+
+### 3.2 触发点
+
+| 入口 | 时点 | 触发前状态 | 取得的数据 |
+| --- | --- | --- | --- |
+| <事务码 / 接口 / 后台> | <校验阶段 / 保存前 / 提交后> | <订单已保存 / 未保存> | <当前输入值 / 数据库旧值> |
+
+- **覆盖入口**：<前台、后台、接口分别是否覆盖；未确认的标 Q。>
+- **新旧值**：<规则用的是用户当前输入，还是已落库的值；修改后是否重新校验。>
+- **未保存数据**：<字段尚未落库时以什么为准。>
+- **派生值**：<标准逻辑或其它增强是否也会改同一字段；先后关系。>
+
+### 3.3 适用与排除
+
+| 项目 | 定义 |
+| --- | --- |
+| 命中条件 | <组织、单据类型、业务状态、角色> |
+| 排除条件 | <必须绕过增强的场景> |
+| 与其它规则的优先级 | <同时命中时先后；先报哪条> |
+| 不命中时 | <维持原有行为> |
+| 既有校验先失败时 | <是否继续执行本增强；用户最终看到什么> |
+
+### 3.4 处理逻辑
+
+<按顺序写：取数 → 判断 → 结果。引用 R-01 等规则编号，不在这里重复条件。>
+
+### 3.5 重复触发与事务
+
+| 场景 | 期望 |
+| --- | --- |
+| 同一操作多次触发 | <哪些可重复，哪些副作用只能发生一次> |
+| 保存后再次修改 | <哪些字段变化需要重新判断> |
+| 标准动作最终失败 | <本次已产生的变化是否必须一同撤销> |
+| 已调用外部系统 | <外部成功但本地失败的核对与补偿> |
+
+### 3.6 停用与回归
+
+- **停用后**：<恢复原有行为；已保存数据不回滚。>
+- **在途业务**：<处理中的单据、任务、外部请求如何处理。>
+- **回归范围**：<既有增强、标准校验、相关模块（凭证流、库存、财务）需要复测的部分。>

package/skills/sap-fs/assets/templates/fs-archive.html

@@ -0,0 +1,320 @@
+<!DOCTYPE html>
+<html lang="zh-CN">
+<head>
+<meta charset="utf-8" />
+<meta name="viewport" content="width=device-width, initial-scale=1" />
+<title>{{DOC_TITLE}}</title>
+<style>
+  /* Claude Design System tokens (from open-claude-ui cds-theme) — archive sheet, no logo */
+  :root {
+    --brand: #c6613f;
+    --cds-clay: #d97757;
+    --cds-clay-light: #fbf3ef;
+    --cds-gray-0: #fff;
+    --cds-gray-10: #fcfcfb;
+    --cds-gray-20: #f9f9f7;
+    --cds-gray-40: #f3f3f0;
+    --cds-gray-100: #e1e0d9;
+    --cds-gray-200: #c3c2b7;
+    --cds-gray-500: #6d6b67;
+    --cds-gray-600: #52514e;
+    --cds-gray-850: #151515;
+    --cds-text-primary: #151515;
+    --cds-text-secondary: #525252;
+    --cds-text-muted: #8a8a8a;
+    --cds-border: hsla(0, 0%, 8%, 0.10);
+    --cds-border-strong: hsla(0, 0%, 8%, 0.20);
+    --cds-shadow-sm: 0 1px 2px rgba(0,0,0,.05), 0 2px 8px rgba(0,0,0,.08);
+    --cds-shadow-md: 0 2px 4px rgba(0,0,0,.05), 0 6px 16px rgba(0,0,0,.08);
+    --radius-md: 6px;
+    --radius-lg: 8px;
+    --radius-xl: 12px;
+    --radius-2xl: 16px;
+    --font: "Anthropic Sans", "Segoe UI", "PingFang SC", "Microsoft YaHei", "Noto Sans CJK SC", sans-serif;
+    --mono: "Anthropic Mono", ui-monospace, SFMono-Regular, Menlo, Consolas, monospace;
+  }
+  * { box-sizing: border-box; }
+  body {
+    margin: 0;
+    min-height: 100vh;
+    color: var(--cds-text-primary);
+    background: var(--cds-gray-20);
+    font: 15px/1.65 var(--font);
+    -webkit-font-smoothing: antialiased;
+  }
+  .sheet {
+    max-width: 880px;
+    margin: 28px auto 48px;
+    padding: 36px 40px 40px;
+    background: var(--cds-gray-0);
+    border: 1px solid var(--cds-border);
+    border-radius: var(--radius-2xl);
+    box-shadow: var(--cds-shadow-md);
+  }
+  .accent-bar {
+    height: 3px;
+    width: 48px;
+    border-radius: 999px;
+    background: var(--cds-clay);
+    margin-bottom: 18px;
+  }
+  h1 {
+    margin: 0 0 10px;
+    font-size: 1.55rem;
+    font-weight: 600;
+    letter-spacing: -0.02em;
+    line-height: 1.3;
+  }
+  h2 {
+    margin: 32px 0 12px;
+    padding-bottom: 8px;
+    font-size: 1.1rem;
+    font-weight: 600;
+    letter-spacing: -0.01em;
+    border-bottom: 1px solid var(--cds-border);
+  }
+  h3 {
+    margin: 20px 0 8px;
+    font-size: 0.98rem;
+    font-weight: 600;
+    color: var(--cds-text-primary);
+  }
+  h4 {
+    margin: 14px 0 6px;
+    font-size: 0.9rem;
+    font-weight: 600;
+    color: var(--cds-text-secondary);
+  }
+  p, li { margin: 6px 0; color: var(--cds-text-primary); }
+  .lede { color: var(--cds-text-secondary); font-size: 0.92rem; }
+  .status {
+    display: inline-flex;
+    align-items: center;
+    gap: 6px;
+    margin: 4px 0 18px;
+    padding: 4px 10px;
+    border-radius: 999px;
+    background: var(--cds-clay-light);
+    color: var(--brand);
+    border: 1px solid color-mix(in srgb, var(--cds-clay) 28%, transparent);
+    font-size: 0.78rem;
+    font-weight: 500;
+  }
+  .status::before {
+    content: "";
+    width: 6px; height: 6px;
+    border-radius: 50%;
+    background: var(--cds-clay);
+  }
+  .meta {
+    display: grid;
+    grid-template-columns: 7.5rem 1fr;
+    gap: 8px 14px;
+    margin: 0 0 8px;
+    padding: 14px 16px;
+    background: var(--cds-gray-10);
+    border: 1px solid var(--cds-border);
+    border-radius: var(--radius-xl);
+    font-size: 0.88rem;
+  }
+  .meta dt { color: var(--cds-text-muted); font-weight: 500; }
+  .meta dd { margin: 0; color: var(--cds-text-secondary); }
+  table {
+    width: 100%;
+    border-collapse: separate;
+    border-spacing: 0;
+    margin: 12px 0 18px;
+    font-size: 0.86rem;
+    border: 1px solid var(--cds-border);
+    border-radius: var(--radius-xl);
+    overflow: hidden;
+    background: var(--cds-gray-0);
+  }
+  th, td {
+    padding: 9px 11px;
+    text-align: left;
+    vertical-align: top;
+    border-bottom: 1px solid var(--cds-border);
+  }
+  tr:last-child td { border-bottom: none; }
+  th {
+    background: var(--cds-gray-40);
+    color: var(--cds-text-secondary);
+    font-weight: 600;
+  }
+  tbody tr:nth-child(even) td { background: var(--cds-gray-10); }
+  .card {
+    margin: 12px 0;
+    padding: 12px 14px;
+    border: 1px solid var(--cds-border);
+    border-radius: var(--radius-xl);
+    background: var(--cds-gray-10);
+    box-shadow: var(--cds-shadow-sm);
+  }
+  .card > :first-child { margin-top: 0; }
+  pre, code { font-family: var(--mono); font-size: 0.8rem; }
+  code {
+    padding: 1px 5px;
+    border-radius: var(--radius-md);
+    background: var(--cds-gray-40);
+    color: var(--cds-gray-850);
+  }
+  .code-block {
+    position: relative;
+    margin: 10px 0 16px;
+  }
+  pre {
+    margin: 10px 0 16px;
+    padding: 14px 16px;
+    background: #1e1e1d;
+    color: #f5f5f5;
+    border-radius: var(--radius-xl);
+    border: 1px solid var(--cds-gray-850);
+    overflow: auto;
+    white-space: pre-wrap;
+    word-break: break-word;
+  }
+  .code-block pre {
+    margin: 0;
+    padding-top: 40px;
+  }
+  pre code { background: transparent; color: inherit; padding: 0; }
+  .copy-btn {
+    position: absolute;
+    top: 8px;
+    right: 8px;
+    z-index: 1;
+    padding: 4px 10px;
+    font: 500 0.72rem/1.4 var(--font);
+    color: var(--cds-gray-600);
+    background: var(--cds-gray-10);
+    border: 1px solid var(--cds-border-strong);
+    border-radius: var(--radius-md);
+    cursor: pointer;
+    box-shadow: var(--cds-shadow-sm);
+  }
+  .copy-btn:hover {
+    color: var(--brand);
+    border-color: color-mix(in srgb, var(--cds-clay) 45%, var(--cds-border-strong));
+    background: var(--cds-clay-light);
+  }
+  .copy-btn.copied {
+    color: var(--brand);
+    border-color: color-mix(in srgb, var(--cds-clay) 45%, transparent);
+    background: var(--cds-clay-light);
+  }
+  ul { padding-left: 1.2rem; }
+  footer {
+    margin-top: 36px;
+    padding-top: 14px;
+    border-top: 1px solid var(--cds-border);
+    color: var(--cds-text-muted);
+    font-size: 0.75rem;
+  }
+  /* Explicitly no logo / brand mark images */
+  @media print {
+    body { background: #fff; }
+    .sheet {
+      margin: 0; max-width: none;
+      border: none; box-shadow: none; border-radius: 0; padding: 0;
+    }
+    h2, .card, table, pre { break-inside: avoid; }
+  }
+</style>
+</head>
+<body>
+  <article class="sheet">
+    <div class="accent-bar" aria-hidden="true"></div>
+    <header>
+      <h1>{{DOC_TITLE}}</h1>
+      <p class="status">{{STATUS_LINE}}</p>
+      <dl class="meta">
+        <dt>项目 / 模块</dt><dd>{{PROJECT_MODULE}}</dd>
+        <dt>系统与客户端</dt><dd>{{SYSTEM_CLIENT}}</dd>
+        <dt>需求提出人</dt><dd>{{REQUESTER}}</dd>
+        <dt>类型</dt><dd>{{FS_TYPE}}</dd>
+        <dt>更新</dt><dd>{{UPDATED}}</dd>
+      </dl>
+    </header>
+    <div class="body">
+      {{BODY_HTML}}
+    </div>
+    <footer>
+      Generated by SapBuddy
+    </footer>
+  </article>
+  <script>
+  (function () {
+    function getCodeText(pre) {
+      var code = pre.querySelector("code");
+      return (code || pre).textContent;
+    }
+    function wrapPre(pre) {
+      if (pre.closest(".code-block")) return;
+      var wrap = document.createElement("div");
+      wrap.className = "code-block";
+      pre.parentNode.insertBefore(wrap, pre);
+      wrap.appendChild(pre);
+      var btn = document.createElement("button");
+      btn.type = "button";
+      btn.className = "copy-btn";
+      btn.setAttribute("aria-label", "复制代码");
+      btn.textContent = "复制";
+      btn.addEventListener("click", function () {
+        var text = getCodeText(pre);
+        function ok() {
+          btn.textContent = "已复制";
+          btn.classList.add("copied");
+          setTimeout(function () {
+            btn.textContent = "复制";
+            btn.classList.remove("copied");
+          }, 1500);
+        }
+        function fail() {
+          btn.textContent = "失败";
+          setTimeout(function () { btn.textContent = "复制"; }, 1500);
+        }
+        if (navigator.clipboard && navigator.clipboard.writeText) {
+          navigator.clipboard.writeText(text).then(ok).catch(function () {
+            try {
+              var ta = document.createElement("textarea");
+              ta.value = text;
+              ta.setAttribute("readonly", "");
+              ta.style.position = "fixed";
+              ta.style.left = "-9999px";
+              document.body.appendChild(ta);
+              ta.select();
+              document.execCommand("copy");
+              document.body.removeChild(ta);
+              ok();
+            } catch (e) { fail(); }
+          });
+        } else {
+          try {
+            var ta2 = document.createElement("textarea");
+            ta2.value = text;
+            ta2.setAttribute("readonly", "");
+            ta2.style.position = "fixed";
+            ta2.style.left = "-9999px";
+            document.body.appendChild(ta2);
+            ta2.select();
+            document.execCommand("copy");
+            document.body.removeChild(ta2);
+            ok();
+          } catch (e2) { fail(); }
+        }
+      });
+      wrap.appendChild(btn);
+    }
+    function init() {
+      document.querySelectorAll("pre").forEach(wrapPre);
+    }
+    if (document.readyState === "loading") {
+      document.addEventListener("DOMContentLoaded", init);
+    } else {
+      init();
+    }
+  })();
+  </script>
+</body>
+</html>