docs: 脱源清理 — 移除本机绝对路径引用，更新 AGENTS.md 项目结构说明

32a5ed49 · 胡晓雅 · 5078cd77 · 32a5ed49 · 32a5ed49 · 32a5ed49
Commit 32a5ed49 authored Aug 18, 2026 by 胡晓雅
5 changed files
--- a/AGENTS.md
+++ b/AGENTS.md
-# 天星项目KB建设 — Agent 指南
+# 天星项目KB — Agent 指南

-天星科技 SAP S/4HANA Cloud 实施+上线切换+运维项目的知识库。**纯文档 KB，无代码、无 git、无构建/测试/lint**。所有可执行环境经验（Playwright、SAP 自动化、Office 文件读写）见 `C:\Users\Woody\.config\opencode\AGENTS.md`（全局，自动加载），此处只记本库特有事实。
+> **产品版本**：SAP S/4HANA Cloud Public Edition｜**使用方**：BOS 实施顾问

-## 目录结构（9 个一级目录）
+天星先进材料科技 SAP S/4HANA Cloud 项目（2024.05 启动 / 2024.09 上线 / 2026 Q2 交接结束）的**历史归档型项目 KB**。**纯文档 KB，无代码、无构建/测试/lint**；git 仅用于文档版本留痕（origin `git@118.31.18.126:bos-project-kb/tianxing-project-kb.git`，branch `master`），不做代码开发。可执行环境经验（Playwright、SAP 自动化、Office 读写）由 Agent 全局配置自动注入，与本仓库内容无关；本仓库只记录与知识库本身相关的事实。

-| 目录 | 内容 | 处理重点 |
-|------|------|---------|
-| `售前资料/` | 调研、组织架构 | 少量 |
-| `蓝图文档/` | 蓝图最终版、FICO流程图(`.vsd/.vsdx`)、科目表、MM规则、PP/SD会议记录 | Visio 无法直接读 |
-| `配置文档/` | FICO/MM/PP/SD 配置 (`docx/xlsx`) | `天星科技SAP财务配置文档.xlsx` 等 |
-| `开发文档/` | EHR/OA/Printer/VPN/汇联易/银企直连 集成 + ABAP增强示例 | 含 `.xdp/.xsd`(Adobe表单)、`.exe/.zip`、Postman JSON |
-| `操作手册/` | FICO/MM/PP/SD 分模块操作手册 | 正式交付物 |
-| `测试用例/` | 集成测试脚本、银企直连测试 | 多事业部 v1.x |
-| `上线切换/` | 月结、三大报表、期初数据(模板/导入/校验)、切线方案 | 期初迁移最早，附件最杂 |
-| `维护问题/` | **运维问题台账**，按月结组织 | 见下 |
-| `项目计划/` | 启动会、周报、会议纪要、SAP项目组人员 | — |
+## 实际结构（别按文件名猜内容）

-## 关键业务上下文（不查文档会乱）
+| 目录 | 内容 | 何时查 |
+|------|------|-------|
+| `KB_天星/`（12 文件） | **项目专属 KB**（真实值/特例/决策/已知坑/未决），已脱源 | 任何天星问题先查；入口 `KB_00_天星_Navigation_Map.md`（每次对话无条件加载） |
+| `KB_SC/`（107 文件） | SC 操作 KB：官方怎么配/怎么跑 | "某功能怎么一步步操作" → 模块 `KB_*_INDEX.md` → Scope Item ID 文件（如 `KB_SD_BD9`） |
+| `KB_SA/`（28 文件） | SA 选型 KB：支不支持/Scope Item 选型/E2E 架构 | 5 层：FSD → Scope Item → 流程库 → Overview → E2E（入口 `KB_00_Navigation_Map.md`） |
+| `KB方法论/`（4 文件） | BOS 客户项目 KB 建设指引/方法论 | 理解 KB 建法时；通常只读不写 |
+| `issues-ledger/` | **运维问题台账（活跃）**：`issues/ISS-tianxing-*.md` 一个问题一文件，受 `list-config.md` 管理 | 走 bos-issue-ledger skill 维护，git 留痕 |

- **系统/租户**：`my200660.s4hana.sapcloud.cn`（`MY_HOME_660*`）与 `my200745.s4hana.sapcloud.cn`（`MY_HOME_745*`）两个那 Fiori home JSON 导出，一行一个 JSON（勿当普通 txt 读）。
- **公司代码前缀**：大量目录/文件名以 `1008`、`1108`、`2308` 开头（如 `1008_202410月结/`、`1108_202605.xlsx`、`2308上线202502/`），是不同公司代码/组织单元的区分前缀。
- **月结目录**：`维护问题/2026XX月结/`（202506月结~202605月结）是当前滚动运维点；`1108_YYYYMM.xlsx` 为具体月结文件。
- **`维护问题/天星问题.txt`** 是运行中问题清单（利润中心转移定价、Copa、合并报表等），涉及应同步更新。
- `维护问题/资产负债表/1008,资产负载表10月/` 下 `Ver1`~`Ver7` 表示报表编制反复迭代版本，取最高 Ver。
+**路由**：天星专属 → `KB_天星`；怎么操作 → `KB_SC`；支不支持/选型 → `KB_SA`；均未命中 → help.sap.com。
+**冲突裁决**：`KB_天星`（真实决策）＞ 蓝图（ARC-03/04）＞ SC Base ＞ SA Base。禁止用 LLM 推断填补项目空白。

-## 文件读取注意事项（高频踩坑）
+## 关键约定（容易踩的坑）

- **占绝大多数是 Office 二进制**：xlsx 365 / docx 67 / pptx 10 / pdf 6。读写必须用全局 AGENTS.md 的 Playwright+本地 JS 库三件套（XLSX=SheetJS、DOCX=mammoth/docx、PPTX=手工ZIP+pako/PptxGenJS）。`read`/`grep` 工具对二进制无效。
- **`.xls`（旧格式，37 个）SheetJS 读不了**，需先用 Excel/LibreOffice 转 `.xlsx` 再处理。
- **`.files/` 目录（12 处，共 45 文件）是 `xlsx` 的 HTML 导出残屑**（如 `Balance Sheet.files/`），搜索/读取时忽略；对应用 `.htm` 同源。
- **`.txt` 编码混合**：大部分 UTF-8，但 `开发文档\系统开发增强示例\一些示例代码.txt` 和 `维护问题\清账问题\11.txt` 是 **GBK**，必须先转码再读。
- **PowerShell 输出中文文件名/内容会乱码**：先执行 `[Console]::OutputEncoding=[System.Text.Encoding]::UTF8`（或 `chcp 65001`）。
- **路径含中文+空格**：一律用引号包裹、`-LiteralPath`、反引号转义。
- `.vsd/.vsdx`（Visio 流程图）、`.xdp/.xsd`（Adobe LiveCycle 打印表单）、`.xml`（SAP 迁移 Source data / 期初模板）无法直接解析，需问用户或换工具。
- `开发文档\Printer\**` 是财务凭证/送货单打印模板（`.xdp`），改前确认属于哪个公司代码/单据。
+- **项目已完结归档**，无活跃系统操作；用途 = 历史沉淀/参考复用。回答前先定位问题属 项目KB / SC 操作 / SA 选型 / 超范围 哪类。
+- **脱源纪律**：KB 正文引用原始档案一律用 `ARC-01`~`ARC-10` 编号（登记表 `KB_天星\源档案索引.md`），**不写源目录路径/文件名**。原始档案（售前/蓝图/配置/开发/操作手册/测试/上线切换/维护问题/项目计划 9 类）**不在本仓库**，按编号到外部归档定位；本地找不到原文时不得编造，标"见外部归档"。
+- **组织字段不猜**：真值以 `KB_天星\组织与主数据_真实值.md` 为准，缺口显式标注，未确认值 ❓。Base 样例值（如 1310/TG11）禁止当客户真实值使用。
+- **维护问题**：本仓库只有 `维护问题与已知坑.md` 索引，台账正文在外部归档 `ARC-10`；线上问题走 `issues-ledger/`。
+- **`output/` 路径是历史遗留**：`KB_SC\KB_00_SC_Navigation_Map.md`（及本文件 BOS 区内的内嵌副本）把 INDEX 文件写成 `output/KB_*_INDEX.md`，实际都在 `KB_SC/` 根下。
+- **3 个 KB_SC 文件尾部字节截断**（非法 UTF-8）：`KB_PP_BJ8_*.md`、`KB_PP_BJQ_*.md`、`KB_PS_J12_*.md`，read 到末尾会乱码/报错——源数据缺陷，勿据此改文件。
+- PowerShell 读中文先 `[Console]::OutputEncoding=[System.Text.Encoding]::UTF8`；路径含中文+空格用引号 + `-LiteralPath`。
+- **系统/租户**：`my200660.s4hana.sapcloud.cn`（配置，张总账号）、`my200690`（测试）、`my200745`（Fiori home 导出）。公司代码前缀 `1008`/`1108`/`2308` 区分不同公司/组织单元（如 `1108_202605.xlsx` = 1108 公司 2026 年 5 月月结）。

-## 三层 KB 协同路由
+## 无测试/构建命令

-```
-提问（天星问题）
-  ├── 天星专属（真实值/特例/决策/已知坑/未决） → KB_天星\（最高，常加载导航图）
-  ├── 某功能怎么一步步操作                    → KB_SC\（模块 INDEX → ID 文件）
-  ├── 支不支持/选型/E2E 架构                 → KB_SA\（FSD / 选型指南 / E2E）
-  └── 均未命中 → help.sap.com（SC 检索指南）
-冲突裁决：KB_天星 > 蓝图 > SC Base > SA；天星 KB 只记差异不重写 Base 官方步骤
-```
+改动验证 = 核对 Markdown/ARC 编号/路由一致性；涉及系统操作时用 Playwright 走对应 SAP 流程。

- **`KB_天星\`（12 个文件，2026-08 建档+脱源）**：天星项目层 KB，已脱源改造。入口 `KB_00_天星_Navigation_Map.md`（ALWAYS 加载）。结构：00_项目概况 / 组织与主数据_真实值（含缺口清单）/ 蓝图决策记录 / 操作特例_SD·MM·PP_QM·FI_CO / 集成约定 / 维护问题与已知坑（台账索引）/ 未决问题清单 / **源档案索引**（`ARC-01`~`ARC-10` 归档编号登记表）。
- **脱源纪律**：KB 正文不再引用源文档内部路径，回看原文统一走 `KB_天星\源档案索引.md` 的 ARC 编号；本地仅保留 `KB_SA\` `KB_SC\` `KB_天星\` `AGENTS.md` 即可自洽运转。源文档（`售前资料/蓝图文档/配置文档/开发文档/操作手册/测试用例/上线切换/维护问题/项目计划`）已移出 KB 依赖链，仅按 ARC 编号对外归档定位。
- 上级 `../公司KB库/AGENTS.md` 定义 BOS 标准 KB（SA/SC，产品知识），本库是"项目KB"。冲突时**项目KB(本库) > 蓝图 > SC Base > SA**，模式零问题只从本库检索，禁止用 LLM 推断填补项目空白。
- 组织/主数据真值以 `KB_天星\组织与主数据_真实值.md` 为准，缺口已显式标注（1008/1108/2308 映射、物料段位、编号段等）；未确认值一律 ❓ 标注，禁止猜。
- 无测试/构建命令可跑；改动验证方式 = 重新导出/检查 xlsx、或让 Playwright 走一遍对应 SAP 流程。
+> 自 `<!-- BOS-KB-START -->` 起为 **bos-env-config skill 自动生成区**（SA/SC Base KB 导航 + Agent System Prompt），内容与 `KB_SA\`、`KB_SC\` 内文件重复，部署时会整体覆盖——不要手工修改。
 <!-- BOS-KB-START -->
 ---

@@ -60,7 +42,7 @@

 ### SA KB（Presales Agent）

-**KB 文件目录**：KB_SA/（28 个文件）
+**KB 文件目录**：`KB_SA/`（28 个文件）

 #### SA KB 导航图

@@ -595,7 +577,7 @@ L2C_08 / S2P_09 / I2M_10 / P2F_11 / P2F_12 / A2D_13 / R2R_14（_Process_Architec

 ### SC KB（Solution Consultant Agent）

-**KB 文件目录**：KB_SC/（107 个文件）
+**KB 文件目录**：`KB_SC/`（107 个文件）

 #### SC KB 导航图

@@ -668,7 +650,7 @@ L2C_08 / S2P_09 / I2M_10 / P2F_11 / P2F_12 / A2D_13 / R2R_14（_Process_Architec

 ## 五、上层 KB 引用

- **SA KB**：`C:\Users\hongb\Claude Cowork\101 SAP Cloud ERP 2602\KB_Agent1_Flat`
+- **SA KB**：`KB_SA/`（同项目内，由 bos-env-config skill 部署）
  - `SAP_Scope_Item_Catalog_RAG.md` → `## SCOPE-ITEM: [ID]` 锚点
  - `FSD_01_Finance_HR_Capabilities.md` / `FSD_04_Sales_Capabilities.md` / `FSD_06_Procurement_Capabilities.md` / `FSD_07_SupplyChain_Capabilities.md`
 - **项目 KB**（各项目目录）→ 客户专属决策记录

--- a/KB_SC/KB_00_SC_Navigation_Map.md
+++ b/KB_SC/KB_00_SC_Navigation_Map.md
@@ -67,7 +67,7 @@

 ## 五、上层 KB 引用

- **SA KB**：`C:\Users\hongb\Claude Cowork\101 SAP Cloud ERP 2602\KB_Agent1_Flat`
+- **SA KB**：`KB_SA/`（同项目内，由 bos-env-config skill 部署）
  - `SAP_Scope_Item_Catalog_RAG.md` → `## SCOPE-ITEM: [ID]` 锚点
  - `FSD_01_Finance_HR_Capabilities.md` / `FSD_04_Sales_Capabilities.md` / `FSD_06_Procurement_Capabilities.md` / `FSD_07_SupplyChain_Capabilities.md`
 - **项目 KB**（各项目目录）→ 客户专属决策记录

--- a/KB_SC/KB_CONFIG_FI.md
+++ b/KB_SC/KB_CONFIG_FI.md
@@ -46,7 +46,7 @@ Manage Your Solution (F1241) → Configure Your Solution
 ## 引用标准
 - 所有 SSCUI ID 来自 SSCUI_List_EN_XX.xlsm
 - Finance 区域完整配置清单 1956 项，本文件仅列出核心项
- 完整 List 参见 `C:\Users\hongb\Claude Cowork\101 SAP Cloud ERP 2602\S4C\Library\Configuration\SSCUI_List_EN_XX.xlsm`
+- 完整 List 参见外部工具 SSCUI_List_EN_XX.xlsm（非本仓库内容，SSCUI ID 可在 SAP Help Portal 交叉核对）

 ---


--- a/KB_SC/KB_SD_BKP_附录.md
+++ b/KB_SC/KB_SD_BKP_附录.md
 # KB_SD_BKP_附录 — Customer Returns 全 Scenario 展开

 > BKP 主文件覆盖 Scenario 1 主线（Credit Memo 退款）。本附录展开 Option B（Replacement）/ Option C（Send Back）/ Scenario 2（客户现场检验）/ Scenario 3（退给供应商）。
-> **BPD 路径**：[BKP_S4CLD2602_BPD_EN_CN.docx](C:\Users\hongb\Claude Cowork\101 SAP Cloud ERP 2602\S4C\Library\TestScripts\BKP_S4CLD2602_BPD_EN_CN.docx)
+> **BPD 路径**：BKP_S4CLD2602_BPD_EN_CN.docx（SAP Best Practices 官方 TestScript，按 ID 在 me.sap.com Process Navigator / help.sap.com 检索）

 ---


--- a/KB_SC/KB_SD_I9I_附录.md
+++ b/KB_SC/KB_SD_I9I_附录.md
 # KB_SD_I9I_附录 — Sales Contract Management 全 5 Scenario

 > I9I 是 5-Scenario 复合流程。主文件只覆盖 Scenario 1（基础 Quantity/Value 合同）。本附录展开 Scenario 2-5 + Print Form 步骤。
-> **BPD 路径**：[I9I_S4CLD2602_BPD_EN_CN.docx](C:\Users\hongb\Claude Cowork\101 SAP Cloud ERP 2602\S4C\Library\TestScripts\I9I_S4CLD2602_BPD_EN_CN.docx)
+> **BPD 路径**：I9I_S4CLD2602_BPD_EN_CN.docx（SAP Best Practices 官方 TestScript，按 ID 在 me.sap.com Process Navigator / help.sap.com 检索）

 ---