Files
cbb-refresh-verify-795/SOP.md

94 lines
9.2 KiB
Markdown
Raw Permalink Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# CBB 检查、校验、管理与残留释放操作规程
适用测试版本:0.2.4b3。测试版发布不代表现场验收,不自动关闭工单。以下为当前规程,下方旧上传校验检查表保留为历史参考。
## 当前操作与队列
选择中心库 `.lmc`,核对 CBB 名称、分区及完整 PRJ/PCB 工程。写操作和人工修复前由操作员保存可用一致备份;应用不自动备份整个中心库,隔离验证/暂存副本不代替人工备份。
普通校验完成原生打开、身份确认、Project Integration、保存和关闭后,必须由权威状态 READY/raw=1 确认成功。ICDB 检查仅尝试打开并检查本次错误,不自动 Repair、Restore 或选择版本,CHECKED 不等于 READY。排队期间变成 READY 的工程在执行前跳过。
原生任务串行排队,检查每项结束后让出机会;缓存筛选保持可用。失败项确认释放后继续独立项目;未释放会话转后台观察,只保留相关库的写入限制,独立库可继续。“停止检查”只取消检查,“取消当前任务并停止队列”取消当前批次后续动作;正在保存/关闭的调用只等待返回。普通等待 5 秒,可能正在写入时最多再等到 120 秒后交后台,这不是结束进程的期限。
保存已返回成功、关闭失败、资源仍占用可以同时出现。查看本轮保存/关闭标记和独立释放结果,不能因进程退出就认定工程已保存。管理更新若已经移除、尚未重新导入就取消,按“需恢复”核对,不自动补做下一次导入。重启发现未完成任务时只核对身份和资源,不自动重放。
权威状态桥不可用时保留未知/不可用;legacy 读取只观察已打开且库身份匹配的 Library Manager。没有匹配窗口、存在模态提示或树不可读时返回 UNKNOWN,不自动启动或应答窗口。
新增拒绝同名冲突;更新先原生移除再导入,失败可能需要人工备份恢复;移除后重新读取目录确认。版本回退由操作员在原生界面选择,核对工程内容后单独校验。
新增和替换不调用 ASCII/CSV/EDIF 导出器;原生成功回执、重新读库、目标工程关联、顶层块及 Layout 确认后记录上传完成,不等同于 READY 或原理图语义等价。顶层块允许来源名或本次 CBB 注册名,保留原生命名变换记录;其他名称仍拒绝。其余文件差异单独保留清单并提示核对,不因 PRJ 规范化或历史记录差异阻止后续条目。可在批次开始前取消“上传后自动校验”。来源旧库路径可在暂存副本中改为所选目标库,来源原件不改;无效来源按行报告,已释放的失败不阻止后续条目。
## 历史记录、操作结果与报告
管理写入无法取得占用确认、或恢复安装前选择跳过时,记录 `SKIPPED`(已跳过 / 未执行);取消记录 `CANCELLED`。这两者不等于实际上传或恢复失败。文件核对失败仍记录“需要恢复”并禁止自动重放该目标;后续独立 CBB 在会话释放及自身写前检查通过后可继续。
校验和管理遇到历史释放记录时,先复核实际进程、地址、独占文件及导出副本。确认释放后归档记录再继续,不以历史 JSON 本身判定真实占用;同目标未完成写入仍需核对,不自动重放。释放证明在管理首次原生调用前写入检查点,并在结果中保留。
管理操作生成目标工程、库配置和共享依赖的写前/写后主要文件清单及新增、删除、修改差分;不增加自动全库备份,也不声称检查了其他 CBB 内容。报告不可用与原生操作失败分别记录;本任务已释放时可继续独立项。
## 默认释放与单独确认的强制客户端操作
1. 停止新任务,预览当前库的工程、程序、PID 和历史记录。默认“确认释放”仅正常关闭作用域及当前身份已确认的客户端。未保存更改由操作员选择保存、放弃或保留;未知提示保持现场。
2. 数据库服务器可能服务同库其他用户。本工具不允许强制结束服务器,命令行指向本库也不构成独占授权;由库管理员核对用户和服务器状态。
3. “强制结束客户端”是另行确认的异常处理,只允许属于当前 Windows 用户和会话、已确认作用域和精确进程身份的 Expedition PCB、Library Manager、viewdraw、iCDB Project Backup 客户端。后台导入器、脚本宿主和归属未知的进程同样不在强制名单。
4. 警告明确告知客户端中其他已打开工程可能一并退出、未保存更改会丢失、写入中的工程可能需要恢复。执行前持久保存库外 `consent.json`,包含目标库、名单、创建身份和排除项;写入失败不执行。派发处核对快照身份和原预览范围,最终句柄处核对创建时间、完整映像、用户 SID、Windows 会话和原生活动;变化时拒绝。
5. 预览和执行前检查进度与本轮 Output。本工具登记的 Save/Close/原生调用尚未确认返回,或 Backup/Restore/Repair 进行中、状态无法确认时,不放行普通“强制结束客户端”。可查看后台窗口的标题、输出和所在桌面;仅当当前窗口唯一存在已识别的 Cancel/取消按钮时,提供单独确认的原生取消。核对身份、用户会话和按钮快照后发送请求,再重新检查实际结果;没有识别到按钮时不猜菜单参数,不抢占前台。
6. 每项动作前后持久记录实际结果,异常保留已完成/未执行项。若最终记录保存失败但独立库释放证明已确认,界面明确提示记录失败并接受释放事实,不伪造新的占用。
7. 客户端退出仅证明进程结束,不表示修复成功或 READY。服务器仍活跃或库状态未知时保留 PARTIAL、检查点和映射。只有完整的独立释放证明才解除匹配的历史记录;空进程列表本身不是释放证明。
## 失败、证据和回退
保留原生错误、操作员、Mentor 版本、库/工程身份和证据目录;原生日志上传前脱敏。不得删除原生地址/锁文件或修改 LMC 伪造状态。强制客户端退出不可撤销;工程恢复依靠人工一致备份或原生历史版本,不自动回退共享库或重放写操作。
程序回退须先关闭当前客户端,再运行此前候选包;它不恢复丢失更改或被中断的原生事务。工程恢复另行在隔离副本验证,保留前后证据并重新校验。Windows 10、共享库跨机器并发和现场服务器失联恢复仍待验收,fake 测试和文件头损坏试验不代替现场验收。
## 已知限制与证据位置
A/B 输入的独立 EDIF 导出曾返回 `0xC0000005`,尚未定位;普通导入已不依赖该导出,导入是否完成以本次原生操作与复读证据判定。Windows 10、跨机器共享库和现场失联故障副本仍待验收;跨机释放依赖 SMB 共享模式语义,目前没有跨机实测。自动 ICDB Repair 保持关闭,共享数据库地址残留或晚到弹窗按现场状态继续核对。
代码合并不表示现场验收完成。文档中的本机路径、日志、截图、测试 XML 和候选包未入库;仓库仅保留验证摘要,原始材料需在验收机器查看或另行归档。
## 历史上传校验检查表
## 1. 输入与证据
本项目的 Skyworth 示例根目录是 `F:\Sync Tool Skyworth\Work Maps\Skyworth_CBB_Lib\CBB`。工程清单用于绑定 CBB 源工程和中心库条目;本工具不执行 PCB 同步,也不要求 PCB 文件作为校验输入。
每次作业至少记录:
- DxDesigner/Expedition 精确版本和构建号;
- 原理图工程路径、中心库文件和当前 CBB 标识;
- 上传后、Verify 每一步和最终的中心库状态;
- Verify 对话框的原生结果或错误号;
- 中心库条目标志和错误状态;
- 操作员、时间和截图/日志证据路径。
状态文件采用 UTF-8 JSON,状态只能是 `red`、`yellow`、`green` 或 `unknown`。
## 2. 状态和动作
| 状态键 | 校验动作 | 终态条件 |
| --- | --- | --- |
| `library_item_present` | 确认上传条目存在且名称/来源匹配 | `green` |
| `verify_result` | 对条目执行原生 `Verify` 并完成对话框 | `green` |
| `cbb_status_flag` | 确认 CBB 条目标志为绿色 | `green` |
| `error_state` | 检查没有 ERROR、Cell Name 或未处理警告 | `green` |
动作优先级按表中顺序执行。每次动作后必须重新读取条目和对话框状态;不能使用上一次读取的旧状态继续点击。
## 3. 通过条件
只有以下条件全部满足,报告才是 `PASS`:
- 四项中心库校验状态均为绿色;
- Verify 有对应的动作结果和完成时间;
- CBB 名称、源工程和中心库条目身份一致;
- 未发现 ERROR、Cell Name 或未处理警告;
- 证据文件完整且可读取。
任意状态为 `unknown`、错误、超时、路径不一致或证据缺失,报告为 `BLOCKED`。
## 4. 与上传/替换的先后关系
中心库上传由 `cbb-upload-795` 完成;上传成功后再运行本工具做 Verify 校验。若还包含普通器件替换或 PCB 同步,必须使用各自工具和独立证据目录,不能共享状态文件。