CY-01 · Cindy
01 / 18
Cindy 的文档与软件结构
从需求找到适用规则，再沿实际接口进入客户端实现。
- 辨别索引、权威规则、研究与源码事实。
- 理解多端、Electron 与 Agent 核心的边界。
- 追踪输入、事件、持久化和配置归属。
CY-01 · Cindy
02 / 18
Cindy 逻辑架构
CY-01 · Cindy
03 / 18
仓库与版本
HEAD
5888d140db4f58af
77f154f745ac2a047cb5da69
核验：2026-10-10
范围：客户端只读分析- 采集时工作区状态为空。
- 副本和哈希用于离线回查。
- 没有启动 Cindy 或验证外部服务。
CY-01 · Cindy
04 / 18
文档分类及权威性
| 类型 | 回答什么 | 证据边界 |
|---|---|---|
| 权威规则 | 适用模块应遵守什么 | 不证明旧代码全部符合 |
| 技术设计与参考 | 方案设想与落地 | 继续确认实现 |
| 研究与历史 | 某次问题的证据 | 保留原条件 |
| 索引与地图 | 去哪里继续查 | 不升级成接口合同 |
CY-01 · Cindy
05 / 18
需求到文档的阅读路线
01
需求：手机发起只读资产清单检查。
02
列出控制、目录、工具、状态与持久记录。
03
读远程适配、进程边界和核心行为规则。
04
查 Mobile、白名单、Desktop 入口与事件链。
CY-01 · Cindy
06 / 18
多端与共享模块
| 模块 | 确认职责 | 不能推断 |
|---|---|---|
| Desktop / Electron | UI、宿主与本地执行 | 所有逻辑都放 Main |
| Mobile / Expo | 控制与会话展示 | 本地执行完整 Agent 核心 |
| maker-core | Agent、Session、事件 | 零依赖或浏览器直接可运行 |
| device-link | 跨设备客户端与准入 | 服务端鉴权已审计 |
CY-01 · Cindy
07 / 18
Desktop 执行边界
界面与桥接
- Renderer：展示、交互和纯计算。
- preload：按用途命名的能力桥接。
- UI 缓存不是持久事实。
宿主与副作用
- Main：持久化与系统能力。
- 产生副作用前核对参数与归属。
- 方法名称清楚不代表输入天然可信。
CY-01 · Cindy
08 / 18
Agent 核心与适配层
01
BaseAgent 声明能力与 startSession 接口。
02
Maker 组织执行器、存储与会话参数。
03
执行句柄建立 Session，消费适配后的事件。
04
供应商行为仍有差异，不能仅凭统一名称推定相同。
CY-01 · Cindy
09 / 18
状态与持久数据
| 状态或数据 | 归属 | 需分开的结论 |
|---|---|---|
| 输入队列 | 接受、排队、派发 | 受理不是执行完成 |
| Session | 执行与事件 | 原生轮次不是产品终态 |
| 持久消息 | 宿主存储 | 广播不等于 flush |
| UI 投影 | Renderer 缓存 | 展示可重建，不代替事实 |
CY-01 · Cindy
10 / 18
配置及模块职责
effectiveEnabled =
userOverride ?? defaultEnabled
false = 有效自定义
恢复默认 = 删除 override- 默认值与用户选择分别保存。
- 未自定义跟随新默认，已自定义保留选择。
- 读取合同不证明所有消费者已一致。
CY-01 · Cindy
11 / 18
一次任务调用链
01
makerChatStore → preload.input.enqueue。
02
Main 输入协调器 → sendToAgentAccepted。
03
建立或恢复 Session → Session.send。
04
事件管道处理展示、终态、快照和用量。
CY-01 · Cindy
12 / 18
文档与代码对应表
| 规则或需求 | 实现入口 | 本次范围 |
|---|---|---|
| 输入进入执行 | preload、register、发送事务 | 静态调用关系 |
| 核心可复用 | BaseAgent、Maker、Session | 接口与包依赖 |
| 远程准入 | device-link allowlist | 客户端设计 |
| 插件实时可见 | ghostVisibility | 当前状态分支 |
CY-01 · Cindy
13 / 18
设计与实现差异
包依赖措辞
- device-link 文案仍称零依赖。
- 实际依赖协议包。
- 宿主注入 WebSocket 与零依赖不同。
插件状态判序
- 旧文档部分判序缺少 retirement。
- 当前源码有 GHOST_RETIRED 分支。
- 登记差异，原始副本不改写。
CY-01 · Cindy
14 / 18
可迁移的项目导读方法
- 根规则说明边界，索引帮助找适用合同。
- 地图做导航，包清单和源码确认事实。
- 需求、规则、接口与证据放在同一表中。
- 未知服务端只画外部边界，不猜内部步骤。
CY-01 · Cindy
15 / 18
阅读路线练习
- 为远程清单读取写执行位置和适用规则。
- 列出入口、参数、返回与未验证项。
- 标出控制端路径与被控端路径的区别。
- 追调用而非仅列目录，提交一条完整证据路线。
CY-01 · Cindy
16 / 18
结构图验收
- 每个关键节点能回到版本内文件。
- 手机控制与桌面执行明确分开。
- 解释受理、工具结果、持久化和目标完成。
- 源码阅读不支持任职身份或人机贡献比例。
CY-01 · Cindy
17 / 18
文档与软件结构思维导图
CY-01 · Cindy
18 / 18