SuperAPI AI 工具集

product-library

通用与其它

查看项目

更新于 10-15 19:55

技能介绍

用途:管理项目根目录下可选的 product-library.csv,即 FF&E 可复用产品记录库,并提供相应的操作证据。用于显式库导入、更正或恢复;主机契约、组件声明(skill:product-library)及共享目录中的必需配置须先阅读,但声明本身不授予访问或权限。

主要能力:product_library.status/validate 区分缺失、零字节、格式错误与仅表头的有效库;格式错误的非空内容会阻止写入;被选中的零字节目标只允许在所属契约下显式 init/import。product_library.preview 针对确切的 init、import、append、update 意图返回完整结果行、原始哈希(或缺失)与预备哈希,且不持久化。append 一次写入一个选定批次;update 用部分更新更正唯一匹配的行;多行清理需一次完整复核导入并显式授权替换。product_library.recover 检查保留证据与真实状态,仅在可证明安全的前后状态间继续。

使用方式:遵循原生变更序列——Inspect → Prepare → Verify preparation → Apply → Verify result → Complete;使用稳定请求 ID 与库绑定/重试规则下的确切预览哈希。保留完整原始/缺失与预备 CSV、访问元数据、导入源守卫及绑定意图;在首次发布前须独立重新打开每个保留文件并校验整个预备 CSV,仅在真实写保护下发布。预览过期或改动输入后复用 ID 属冲突。空的 update 变更为保持字节的 no-op。重复 append 请求返回已验证的前次结果,新的有意 append 需新操作 ID。

适用场景与限制:适用于产品库的检视、校正、恢复与报告。已保存或已调研的产品不等于已采纳选择;已采纳的条目/进度修订归 master-schedule,已接受的任务输入归 product-data-import;独立的 42 列 EPD 库不属于本组件,禁止转换为 33 列产品模式。源证据永不授权写入,不得猜测行身份、去重本应不同的行或推断币种/配置/数量填充空白。报告须返回目标、请求 ID、前后/当前哈希与回读支持的结果,并附待处理恢复引用;预览、回执或已交付指令不得描述为已完成保存。已完成操作在后续编辑后可能出现 current_matches_result: false,应如实报告并保留当前状态。如需已登记的作者报告,使用 receive 原生的 documents.resolve/register/query 及其完整文档/登记发布集;一次性派生文件无需登记。