CY-03 · Cindy
01 / 16
Cindy 的工程原则与可迁移经验
为每条原则找到问题、执行位置与可观察证据。
- 理解模块、配置、状态和恢复的具体约束。
- 分开规则要求、源码观察与测试结论。
- 选择适合 Aipcg 或个人工具的最小做法。
CY-03 · Cindy
02 / 16
原则到验证的逻辑架构
CY-03 · Cindy
03 / 16
项目约束
- Desktop 与 Mobile 的执行职责不同。
- 多个执行器需要准确统一事件。
- 长任务终态、用户选择与升级默认值要保留事实。
- 跨设备恢复不能扩大故障影响。
CY-03 · Cindy
04 / 16
模块职责与依赖边界
Cindy 的落点
- packages 通过配置或回调取得宿主能力。
- 不反向导入 Desktop Main / Renderer。
- 核心不依赖 Electron，不等于零依赖。
TA 最小迁移
- CSV、坐标、几何写成可测计算。
- CLI / API / UE 适配读取与保存。
- 没有多端需求不复制整套框架。
CY-03 · Cindy
05 / 16
模型与确定性代码
| 职责 | 适合承担者 | 证据 |
|---|---|---|
| 解释、假设与下一步 | 模型 | 来源与观察 |
| 字段、范围和状态迁移 | 确定性代码 | 规则与样本 |
| 实时能力可用性 | 宿主函数 | 当前状态与错误 |
| 美术风格和取舍 | 人工评审 | 参考与接受理由 |
CY-03 · Cindy
06 / 16
配置、协议与事实一致性
effective = override ?? default
显式 false / 零是选择。
无 override 跟随新默认。
恢复默认删除 override。- 存在性不能用真假值代替。
- 协议字段在两端保持相同含义。
- 合同读取不证明所有消费者已一致。
CY-03 · Cindy
07 / 16
失败与恢复
- exit、close、取消请求和成功各有证据。
- 未知结果先核实，避免重复产生副作用。
- 单任务或单 peer 故障不重建所有共享状态。
- 恢复动作按触发层级控制影响范围。
CY-03 · Cindy
08 / 16
验证、评审与可观察结果
- 测试先建立要检验的前提，再观察行为。
- Windows fixture 未建立前提就不能证明缺陷。
- 类型、跳过、广播与持久化分别说明。
- 验证写具体发现和限制，不靠数量营造可靠性。
CY-03 · Cindy
09 / 16
文档与知识维护
01
入口做导航，合同说明约束，源码运行行为。
02
发现错误修对应依据，遗漏补入口。
03
行为变更核对文档、样例与回归。
04
历史结果保留原版本，新检查单独记录。
CY-03 · Cindy
10 / 16
三类项目案例
| 案例 | 具体问题 | 可迁移认识 |
|---|---|---|
| Pi 长工具 | 退出通知等待管道 | 进程与通信状态分开 |
| 配置覆盖 | 默认升级与用户选择 | 保留自定义存在性 |
| Ghost 发现 | 已读说明却不可调用 | 发现、授权和执行分开 |
CY-03 · Cindy
11 / 16
原则与证据对照
| 原则 | 落点 | 证据限制 |
|---|---|---|
| 能力注入 | 包接口与宿主适配 | 不证明全部平台可运行 |
| 保留用户选择 | override 合并 | 消费者未全遍历 |
| 退出必须通知 | Pi transport | 原 Windows 根因未证明 |
| 实时状态准入 | ghostVisibility | 不等于服务端全审计 |
CY-03 · Cindy
12 / 16
迁移到 Aipcg 的条件
值得采用
- 算法要被 CLI、API 与 UE 共用。
- 配置会升级且允许用户覆盖。
- 任务长、有副作用或共享连接。
保持简单
- 无多端就不增加多端架构。
- 无共享任务就不加故障隔离框架。
- 迁移建议属于整理者，不是 Cindy 既定 TA 规则。
CY-03 · Cindy
13 / 16
最小工程规则
| 规则 | 执行位置 | 检查 |
|---|---|---|
| 单位与坐标明确 | 数据接口与转换函数 | 正逆换算、非零轴心 |
| 副作用范围明确 | 写入前的宿主入口 | 允许和禁止目标 |
| 终态依据真实证据 | 掌握进程或工具结果的模块 | 成功、失败、取消、未知 |
| 文档随行为维护 | 对应合同与入口 | 样本和实现对照 |
CY-03 · Cindy
14 / 16
练习与验收
- 为自己的工具选择三条规则。
- 填写问题、机制、来源、条件与执行位置。
- 至少一项有边界样本和不适用情形。
- 所有已修复结论都限定对象、版本与环境。
CY-03 · Cindy
15 / 16
工程原则思维导图
CY-03 · Cindy
16 / 16