# oracle-jump-query Skill Release Standard

Release 1.5.54: 增加命令级客户绑定、401 一次恢复与并发续登协调；配置按字段合并并原子保存，能力支持简版、普通查询和元数据支持纯 JSON。对话只确定一次客户，由助手每次显式携带编号；保留旧用法和每日更新。仅修改 Skill，不变更 Agent、transit-server、HTTP 接口、配置 JSON 字段或审计 action、字段及保存策略，命令数保持 32。发布同步私有主库、无私有历史公共镜像与安装目录，保护本机配置和设备私钥。

Release 1.5.53: 补充商品明细新增时 CLASSNAME 为 nds.schema.AttributeDetailSupportTableImpl 的条码输入约定，以及商品、条码、ASI 三个常用字段和 ASI 读写规则 1100000000（只在新增时可见）。本次仅更新业务文档，不修改 Agent、transit-server、CLI/HTTP 接口、配置或审计 action、字段及保存策略，命令数保持 32。发布时同步私有主库、安装目录和无私有历史公共镜像。

Release 1.5.52: 补充新建 BOS 业务单据表单的 DOCNO 生成器、STATUS/ISACTIVE 翻译器和选项组、字段读写打印规则、默认值、提交人和提交时间，以及表级 MDQSV 默认规则。ISACTIVE 默认 Y，STATUS 默认 1；仅生成方案。本次仅更新业务文档，不修改 Agent、transit-server、CLI/HTTP 接口、配置或审计 action、字段及保存策略，命令数保持 32。发布时同步私有主库、安装目录和无私有历史公共镜像。

Release 1.5.51: CLI 每次启动记录最后使用时间，按本机日期每日首次使用自动抓取 origin/main 并仅快进安装，成功后重新启动当前命令；本机状态与并发锁不提交 Git。保留本机配置，源码修改、暂存修改、分支分叉或配置冲突时暂停安装；失败不阻止业务命令。本次新增本机更新逻辑，不修改 Agent、transit-server、HTTP 接口、登录配置或审计 action、字段及保存策略，命令数保持 32。发布时同步私有主库、安装目录和无私有历史公共镜像。

取号 CODE 定义在 `AD_SEQUENCE` 表；1.5.50 的编号规则分析路径为 `DOCNO -> AD_COLUMN.SEQUENCENAME -> AD_SEQUENCE`。

Release 1.5.50: 明确取单号函数 `Get_SequenceNo('<CODE>', AD_CLIENT_ID)`，默认 `CODE` 取单据 `DOCNO` 字段对应的 `AD_COLUMN.SEQUENCENAME`，客户 ID 使用单据实际值；取号仅生成 SQL 示例，不通过查询通道调用。本次仅更新 Skill 文档，不修改 Agent、transit-server、CLI/HTTP 接口、配置或审计 action、字段及保存策略；命令数保持 32。发布时同步私有主库、安装目录和无私有历史公共镜像。

Release 1.5.49: 补充品小二环境中文条件的 `UNISTR` Unicode 转义规则，并同步修正 BOS 元数据查询说明、README 和操作示例；直接中文字面量返回 0 行时先按 `UNISTR` 形式重试。其他 client 可将 `UNISTR` 作为跨环境复用和避免传输编码转换的通用兜底。本次仅更新 Skill 文档，不修改 Agent、transit-server、CLI/HTTP 接口、配置或审计 action、字段及保存策略；命令数保持 32。发布时同步私有主库、安装目录和无私有历史公共镜像。

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。发布时同步私有主库、安装目录和无私有历史公共镜像。

Release 1.5.45: 以只读生产样本核验并完善 BOS 通用接口知识，覆盖核心四表、`AD_PROCESS` 三段任务、F/D/J 调度、请求封装、后台推送、两级回执处理、入站路由和客户差异核验边界。本次仅更新 Skill 文档，不修改 Agent、transit-server、接口、配置或审计 action；命令数保持 32。

## Git 提交说明

- 提交信息和发布记录使用简洁、准确的中文。
- 按可独立验证的小功能节点分别提交，不混入无关修改。
- Bug 修复通常只说明修复的功能点和结果，不展开代码缺陷细节；排障或防复发所必需的信息除外。
- 每次将 Skill 推送到私有 Git 后，必须同步更新公共镜像，不再另行等待确认。公共镜像只导入当前私有 `main` 的无历史快照；同步前检查敏感文件、管理员令牌回退和测试结果，不得推送私有提交历史。

Release 1.5.44: 将公共镜像同步纳入每次 Skill Git 发布的必做步骤，同时保留无历史快照和敏感信息检查要求。

Release 1.5.43: 统一 Git 提交与发布记录规范，明确使用简洁中文、按小功能节点提交，并精简 Bug 修复说明。提交 `176bd4594779a8489ad25ab828380b2b7ab3354b` 已于 2026-08-27 10:18 +08:00 推送到私有 Gitea，并同步安装目录；`capabilities --json` 验证版本为 `1.5.43`。

Release 1.5.42: added `log_info`, `log_tail`, `log_search`, `log_enable`, and `log_disable`; uses authenticated dedicated transit endpoints and preserves structured log errors. Commit `e90cbc9ce3525970b2f07885d52c4f0172bf9d2f` was pushed to private Gitea at 2026-08-27 09:51 +08:00, pulled into the installed Skill, and verified by `capabilities --json` as 1.5.42. Log content is not stored in Skill config, output archives, or release history.

A published `VERSION` is frozen. Increment it for every later change, update `CHANGELOG.md`, commit and push to Gitea. Skill updates use Git only: pull the commit into the Codex Skill directory with `git pull --ff-only origin main`, then run `capabilities --json`. Do not publish or update this Skill through OSS.

`inspection_report` and `inspection_latest --refresh` must run `sys_function_check` before Agent collection. Missing SYS/current-schema functions stop generation and return the complete SQL bundle. Historical report reads do not run this preflight.

Record version, commit, push time and verification result for every release.

Release 1.5.32: added authenticated `awr_status`, `awr_list`, and byte-for-byte `awr_download` commands. AWR remains disabled until the customer DBA confirms Diagnostics Pack authorization and Agent configuration explicitly enables it. The release commit, push time, and installed-skill verification are recorded in the project release log.

Release 1.5.33: when AWR readiness reports missing function or view permission, resolve the target Agent schema and return the archived DBA SQL with the real account substituted. Never execute the SQL and never emit an unresolved `<AGENT_SCHEMA>` placeholder.

Release 1.5.34: update archived `HENLO_AWR_EXPORT` to v1.1 so null rows do not reach `DBMS_LOB.WRITEAPPEND`, preserve report row boundaries with newlines, and keep deployment strictly manual through the DBA SQL output.

Release 1.5.35: change the Skill default transit endpoint to `https://ts.henlo.net`, update configuration and documentation examples, preserve existing login/session fields while migrating only `transit_url`, validate, commit and push to Gitea, then pull and verify the installed Skill.

Release 1.5.36: remove the hard-coded Agent-update administrator token fallback. `agent_update` must require `ORACLE_JUMP_UPGRADE_ADMIN_TOKEN` or `upgrade_admin_token` and fail locally without issuing a request when neither is configured. This rule is mandatory before publishing the manually approved, no-history public mirror snapshot.

Release 1.5.37: update the Skill and README maintenance instructions to document both the private repository and the public no-history mirror, so a fresh public download points to the correct Git addresses.