8.1 KiB
CBB 检查、校验、管理与残留释放操作规程
适用开发版本:0.2.4b2。未完成现场验收,不自动发布或关闭工单。以下为当前规程,下方旧上传校验检查表保留为历史参考。
当前操作与队列
选择中心库 .lmc,核对 CBB 名称、分区及完整 PRJ/PCB 工程。写操作和人工修复前由操作员保存可用一致备份;应用不自动备份整个中心库,隔离验证/暂存副本不代替人工备份。
普通校验完成原生打开、身份确认、Project Integration、保存和关闭后,必须由权威状态 READY/raw=1 确认成功。ICDB 检查仅尝试打开并检查本次错误,不自动 Repair、Restore 或选择版本,CHECKED 不等于 READY。排队期间变成 READY 的工程在执行前跳过。
原生任务串行排队,检查每项结束后让出机会;缓存筛选保持可用。失败项确认释放后继续独立项目;未释放会话转后台观察,只保留相关库的写入限制,独立库可继续。“停止检查”只取消检查,“取消当前任务并停止队列”取消当前批次后续动作;正在保存/关闭的调用只等待返回。普通等待 5 秒,可能正在写入时最多再等到 120 秒后交后台,这不是结束进程的期限。
保存已返回成功、关闭失败、资源仍占用可以同时出现。查看本轮保存/关闭标记和独立释放结果,不能因进程退出就认定工程已保存。管理更新若已经移除、尚未重新导入就取消,按“需恢复”核对,不自动补做下一次导入。重启发现未完成任务时只核对身份和资源,不自动重放。
权威状态桥不可用时保留未知/不可用;legacy 读取只观察已打开且库身份匹配的 Library Manager。没有匹配窗口、存在模态提示或树不可读时返回 UNKNOWN,不自动启动或应答窗口。
新增拒绝同名冲突;更新先原生移除再导入,失败可能需要人工备份恢复;移除后重新读取目录确认。版本回退由操作员在原生界面选择,核对工程内容后单独校验。
历史记录、操作结果与报告
校验和管理遇到历史释放记录时,先复核实际进程、地址、独占文件及导出副本。确认释放后归档记录再继续,不以历史 JSON 本身判定真实占用;同目标未完成写入仍需核对,不自动重放。释放证明在管理首次原生调用前写入检查点,并在结果中保留。
管理操作生成目标工程、库配置和共享依赖的写前/写后主要文件清单及新增、删除、修改差分;不增加自动全库备份,也不声称检查了其他 CBB 内容。报告不可用与原生操作失败分别记录;本任务已释放时可继续独立项。
默认释放与单独确认的强制客户端操作
- 停止新任务,预览当前库的工程、程序、PID 和历史记录。默认“确认释放”仅正常关闭作用域及当前身份已确认的客户端。未保存更改由操作员选择保存、放弃或保留;未知提示保持现场。
- 数据库服务器可能服务同库其他用户。本工具不允许强制结束服务器,命令行指向本库也不构成独占授权;由库管理员核对用户和服务器状态。
- “强制结束客户端”是另行确认的异常处理,只允许属于当前 Windows 用户和会话、已确认作用域和精确进程身份的 Expedition PCB、Library Manager、viewdraw、iCDB Project Backup 客户端。后台导入器、脚本宿主和归属未知的进程同样不在强制名单。
- 警告明确告知客户端中其他已打开工程可能一并退出、未保存更改会丢失、写入中的工程可能需要恢复。执行前持久保存库外
consent.json,包含目标库、名单、创建身份和排除项;写入失败不执行。派发处核对快照身份和原预览范围,最终句柄处核对创建时间、完整映像、用户 SID、Windows 会话和原生活动;变化时拒绝。 - 预览和执行前检查进度与本轮 Output。本工具登记的 Save/Close/原生调用尚未确认返回,或 Backup/Restore/Repair 进行中、状态无法确认时,不放行普通“强制结束客户端”。可查看后台窗口的标题、输出和所在桌面;仅当当前窗口唯一存在已识别的 Cancel/取消按钮时,提供单独确认的原生取消。核对身份、用户会话和按钮快照后发送请求,再重新检查实际结果;没有识别到按钮时不猜菜单参数,不抢占前台。
- 每项动作前后持久记录实际结果,异常保留已完成/未执行项。若最终记录保存失败但独立库释放证明已确认,界面明确提示记录失败并接受释放事实,不伪造新的占用。
- 客户端退出仅证明进程结束,不表示修复成功或 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 同步,必须使用各自工具和独立证据目录,不能共享状态文件。