同步 Skill 1.5.48 公共快照

AGENTS.md

@@ -1,5 +1,7 @@
 # oracle-jump-query Skill Release Standard
 
+Release 1.5.48: 补充 BOS 新建表最小结构，保留八个基础字段、类型、可空性、`ISACTIVE DEFAULT 'Y' NOT NULL` 和 `ID` 主键；DDL 仅生成供人工确认执行。本次仅更新 Skill 文档，不修改 Agent、transit-server、CLI/HTTP 接口、配置或审计 action、字段及保存策略；命令数保持 32。发布时同步私有主库、安装目录和无私有历史公共镜像。
+
 Release 1.5.47: 补充用户提供表名称时的 BOS 表解析规则：未明确要求绕过 BOS 元数据直接查询物理数据库对象时，先查 `AD_TABLE.NAME`、`DESCRIPTION` 和 `REALTABLE_ID`；虚拟表沿 `REALTABLE_ID` 定位实际表，未注册对象再按数据库表、视图、物化视图顺序查找。本次仅更新 Skill 文档，不修改 Agent、transit-server、CLI/HTTP 接口、配置或审计 action；命令数保持 32。发布时同步私有主库、安装目录和无私有历史公共镜像。
 
 Release 1.5.46: 明确 `PUSH_LOG.HEAD_DATA` 由 BOS 后台 API 合并，Oracle 数据库侧可能看不到该动作；排查时不得因 `H_INTERFACE_DATA_TASK` 未读取该字段就判断请求头缺失，也不得据此修改全局封装任务。本次仅更新 Skill 文档，不修改 Agent、transit-server、接口、配置或审计 action；命令数保持 32。发布时同步私有主库、安装目录和无私有历史公共镜像。

CHANGELOG.md

@@ -1,3 +1,9 @@
+## 1.5.48 (2026-09-03)
+
+- 补充 BOS 新建表的八个基础字段、字段类型、可空性、`ISACTIVE` 默认值和 `ID` 主键模板。
+- 区分建表默认值与新增业务记录赋值规则；DDL 仅生成供人工确认执行，不通过 Skill 查询通道建表或修改 BOS 元数据。
+- 本次仅更新 Skill 业务知识，不修改 Agent、transit-server、CLI/HTTP 接口、配置格式或审计 action、字段及保存策略；命令数保持 32。
+
 ## 1.5.47 (2026-09-02)
 
 - 补充用户提供表名称时的 BOS 表解析规则：默认先从 `AD_TABLE` 确认英文名称 `NAME`、中文显示名称 `DESCRIPTION` 和 `REALTABLE_ID`。

SKILL.md

@@ -5,7 +5,7 @@ description: Oracle 跳板查询技能。通过中转服务查询远程 Oracle
 
 # Oracle 跳板查询
 
-> **版本：v1.5.47** · [更新日志](./CHANGELOG.md)
+> **版本：v1.5.48** · [更新日志](./CHANGELOG.md)
 
 ## 使用原则
 
@@ -22,7 +22,7 @@ description: Oracle 跳板查询技能。通过中转服务查询远程 Oracle
 - [命令、登录与调用方式](./references/commands-and-auth.md)
   登录、client 切换、CLI 命令、HTTP action、故障排查。
 - [生产查询限制与常用业务规则](./references/query-and-business-rules.md)
-  生产查询限制、商品/款号/条码/库存规则、新增业务记录 SQL 生成规则、字段值域映射。
+  生产查询限制、商品/款号/条码/库存规则、BOS 新建表最小结构、新增业务记录 SQL 生成规则、字段值域映射。
 - [BOS 数据字典与系统地图](./references/bos-metadata.md)
   `AD_TABLE`、`AD_COLUMN`、`AD_REFBYTABLE`、`AD_TABLE_TEXT`、BOS 系统菜单和表结构地图、数据权限模型。
 - [通用接口业务逻辑](./references/generic-interface.md)
@@ -116,6 +116,7 @@ AD_SUBSYSTEM
 
 ## 业务规则速记
 
+- 为 BOS 新建表生成 DDL 时，至少保留 `ID`、`AD_CLIENT_ID`、`AD_ORG_ID`、`OWNERID`、`CREATIONDATE`、`MODIFIERID`、`MODIFIEDDATE`、`ISACTIVE` 八个基础字段及 `ID` 主键；类型、可空性和默认值按 [BOS 新建表最小结构](./references/query-and-business-rules.md#bos-新建表最小结构仅生成-ddl) 模板生成。DDL 只供人工确认执行，不通过 Skill 查询通道执行。
 - 用户提到“通用接口”“接口指令”“接口方”“推送日志”“接收日志”“数据接口任务”“数据队列封装/推送”，或要求分析 `H_INTERFACE`、`H_INSTRUCTION`、`PUSH_LOG`、`INF_LOG`、`AD_PROCESS`、`H_INSTRUCTION_TASK`、`H_INTERFACE_DATA_TASK`、`H_INTERFACE_TASK01`、`BOS_INF_PUSH`、`INF_PUSH_DEAL`、`GET_HYJINF1` 时，先读取 [通用接口业务逻辑](./references/generic-interface.md)。这些对象是常见模型而不是固定契约；不同服务器可能缺表、增表、增减字段、改变值域、请求头合并规则或处理过程，必须先查目标环境再下结论。
 - 商品、款号通常指 `M_PRODUCT`。
 - 条码、SKU 通常指 `M_PRODUCT_ALIAS`；查询条码时首查 `M_PRODUCT_ALIAS.NO`。

VERSION

@@ -1 +1 @@
-1.5.47
+1.5.48

references/query-and-business-rules.md

@@ -72,6 +72,29 @@ WHERE s.C_STORE_ID = :store_id
 ```
 
 
+## BOS 新建表最小结构（仅生成 DDL）
+
+按照 BOS 系统规则，为新建表生成结构 SQL 时，至少包含下面八个基础字段和 `ID` 主键。业务字段在此基础上增加，不要只列业务字段而漏掉基础字段。`TableName` 是表名占位符，生成具体方案时替换为用户确认的表名。
+
+```sql
+CREATE TABLE TableName (
+    ID NUMBER(10) NOT NULL,
+    AD_CLIENT_ID NUMBER(10),
+    AD_ORG_ID NUMBER(10),
+    OWNERID NUMBER(10),
+    CREATIONDATE DATE,
+    MODIFIERID NUMBER(10),
+    MODIFIEDDATE DATE,
+    ISACTIVE CHAR(1) DEFAULT 'Y' NOT NULL,
+    PRIMARY KEY (ID)
+);
+```
+
+- “必须包含字段”不等于“所有字段非空”：本模板只有 `ID` 和 `ISACTIVE` 明确 `NOT NULL`，其余六个字段允许为空。
+- `ID`、`AD_CLIENT_ID`、`AD_ORG_ID`、`OWNERID`、`MODIFIERID` 使用 `NUMBER(10)`；`CREATIONDATE`、`MODIFIEDDATE` 使用 `DATE`；`ISACTIVE` 使用 `CHAR(1)`，默认值为 `'Y'`。
+- 不要把新增业务记录时的 `AD_CLIENT_ID=37`、`AD_ORG_ID=27` 或主键取号规则自动写成建表 `DEFAULT`；本最小模板只为 `ISACTIVE` 指定默认值，日期字段也不自动增加 `DEFAULT SYSDATE`。
+- 这是新建表结构规则，不表示可以自动修改既有表。Skill 仅生成 DDL 并明确“未执行”，由用户或 DBA 确认后人工执行；不通过 `query` / `qperm` 建表，也不隐式写入 BOS 元数据。
+
 ## 新增业务记录 SQL 生成规则
 
 当用户要求分析或生成新增业务表记录的 SQL 示例时，仍然保持只读安全边界：skill 可以生成 SQL 和说明，但不能直接通过查询通道执行 INSERT、UPDATE、DELETE、MERGE、DDL 等写操作。