메뉴
与用户共同阅读 Neeko 代码，逐层讲解 Tauri 应用架构与跨端数据流。支持三域分层模式（Rust 后端 / React 前端 / 跨端桥接）和调用链追踪模式（含跨端追踪）。主动发现 dead code、设计偏差、类型不一致、迁移遗漏，但不修改代码。Use when user wants to walkthrough code, understand architecture, trace call chains, review a module's structure, or says "过代码" / "walkthrough" / "walk me through" / "zoom out".
Codex 또는 Claude로 설치 이 Prompt를 복사해 Codex, Claude 또는 다른 어시스턴트에 붙여 넣으면 Skill 페이지를 검토하고 설치를 진행할 수 있습니다.
SOC 직업 분류 기준
| name | code-walkthrough |
| description | 与用户共同阅读 Neeko 代码，逐层讲解 Tauri 应用架构与跨端数据流。支持三域分层模式（Rust 后端 / React 前端 / 跨端桥接）和调用链追踪模式（含跨端追踪）。主动发现 dead code、设计偏差、类型不一致、迁移遗漏，但不修改代码。Use when user wants to walkthrough code, understand architecture, trace call chains, review a module's structure, or says "过代码" / "walkthrough" / "walk me through" / "zoom out". |
与用户共同阅读 Neeko 代码，逐文件讲解 Tauri 应用架构、跨端数据流与设计决策。纯讲解 + 审查，不修改代码。
Neeko 是基于 Tauri 2 + React 18 的桌面应用。代码分为三个域：
┌─────────────────────────────────────────────────────────────────┐
│ React 前端 (src/) │
│ components/ → hooks/ → store/ ← contexts/ ← types.ts │
└───────────────────────────┬─────────────────────────────────────┘
│ @tauri-apps/api/core.invoke()
│ Tauri Events (listen/emit)
┌───────────────────────────┴─────────────────────────────────────┐
│ Rust 后端 (src-tauri/src/) │
│ commands/ → managers → models/ + storage.rs + git/ + skill/ │
└─────────────────────────────────────────────────────────────────┘
核心数据流：
hooks 调用 invoke("command_name", args) → Tauri IPC → commands/<domain>.rs → managersapp.emit("event-name", payload) → 前端 listen() → hooks/store 更新src-tauri/src/models/ ↔ src/types.ts（serde 序列化）从数据模型开始，按三个域逐层向上阅读。
适用场景：新接手模块、架构改造后全貌理解、PRD 实现 review。
域与层级：
域 1: Rust 后端（src-tauri/src/）
├── Layer 1: 数据模型（models/） -- 共享契约层，Rust ↔ TS 类型同步
├── Layer 2: 存储层（storage.rs） -- JSON 持久化
├── Layer 3: Manager（terminal.rs, project.rs, agent.rs 等） -- 业务逻辑核心
├── Layer 4: 命令层（commands/） -- Tauri IPC 入口，参数校验 + 错误转换
└── Layer 5: 应用组装（app.rs, app_state.rs） -- 依赖注入 + 命令注册
域 2: 跨端桥接
├── Layer 6: 类型契约（models/ ↔ types.ts） -- 结构体/接口对齐
└── Layer 7: IPC 通道（invoke/events） -- 命令名 + 事件名映射
域 3: React 前端（src/）
├── Layer 8: 类型定义（types.ts） -- TypeScript 接口
├── Layer 9: 状态管理（store/, contexts/） -- 全局状态 + 领域动作
├── Layer 10: 自定义 Hooks（hooks/） -- 业务逻辑封装 + invoke 调用
└── Layer 11: UI 组件（components/） -- 渲染 + 用户交互
每层只选 1-2 个代表性文件深入，不求全覆盖。用户可以随时跳过某层或深入某层。
从一个入口点出发，沿调用链逐函数深入。支持跨端追踪。
适用场景：排查问题、理解某个具体流程、验证数据流正确性。
流程：
invoke() 调用时，自动跳转到对应的 Rust 命令；遇到 listen() 时，标注事件来源根据用户输入判断模式和范围：
| 用户输入 | 处理方式 |
|---|---|
| 指定目录/模块名（如 "终端管理"、"git 模块"） | 模式 A，扫描目录结构确定层级 |
| 指定文件/类型名（如 "TerminalManager"） | 先用 grep/find 推导上下游，用户选择模式 |
| 指定入口函数（如 "从 create_terminal_session 开始"） | 模式 B，沿调用链追踪 |
| 指定端（如 "看看后端"、"前端怎么实现的"） | 模式 A，聚焦单域 |
| 模糊描述（如 "过一下这块代码"） | 用 ask_user_question 确认范围和模式 |
范围推导：当用户只给了起点时：
find / grep 找到相关文件在逐文件阅读之前，先建立模块全景认知。 不知道全貌就不知道该看什么、以什么顺序看。
用 find / grep / ls 扫描目标模块的所有相关文件，识别：
用项目的领域词汇绘制全景地图：
呈现格式（以终端管理模块为例）：
终端管理模块全景（12 个文件）
├── src-tauri/src/models/terminal.rs ← 数据模型层
│ └── TerminalSession, TerminalStatus 定义终端会话结构
│
├── src-tauri/src/terminal.rs ← Manager 层
│ └── TerminalManager 本地 PTY 生命周期管理
│ ├── create_session() 创建 PTY 进程
│ ├── write_to_terminal() 写入输入
│ └── close_session() 关闭并清理
│
├── src-tauri/src/commands/terminal.rs ← 命令层
│ └── create_terminal_session Tauri IPC 入口
│ └── 调用 TerminalManager.create_session()
│
├── src-tauri/src/app_state.rs:25 ← 状态组装
│ └── terminal_manager: TerminalManager 注入到 AppStateWrapper
│
│ ─── 跨端桥接 ───
│
├── src/types.ts:42 ← TypeScript 类型
│ └── TerminalSession 与 Rust 模型对齐
│
├── src/components/terminal/TerminalView.tsx ← UI 组件
│ └── xterm.js 渲染 + listen("terminal-output-{id}")
│
├── src/components/terminal/terminalCache.ts ← 终端实例缓存
│ └── Map<string, Terminal> 避免重复创建
│
└── src/hooks/useAppContainer.ts:120 ← 容器 Hook
└── createTerminal() → invoke("create_terminal_session")
数据流：TerminalView → useAppContainer → invoke → commands/terminal → TerminalManager → PTY
事件流：PTY → TerminalManager → emit("terminal-output-{id}") → listen → TerminalView
关键要求：
展示全景地图后，向用户确认：
用户确认后进入 Phase 3。
对阅读清单中的每个文件，执行以下步骤：
用 read 工具完整读取目标文件。如果文件超过 200 行，分段读取但保持讲解连贯。
每个文件讲解以下内容（按需，不求全覆盖）：
结构梳理：
跨端关注点（Rust 后端文件）：
commands/mod.rs 中注册AppError）跨端关注点（React 前端文件）：
invoke 调用）listen 调用）关键设计：
具体引用：
文件路径:行号 格式引用阅读过程中主动检查以下问题：
| 检查项 | 说明 | 适用端 |
|---|---|---|
| Dead code | 没有调用方的函数/方法/类型 | 双端 |
| 设计偏差 | 实现与文档/PRD 描述不一致 | 双端 |
| 类型不一致 | Rust 结构体与 TypeScript 接口字段不匹配 | 跨端 |
| 命令注册遗漏 | 命令函数存在但未加入注册宏 | Rust |
| 事件名不匹配 | emit 的事件名与 listen 的事件名不一致 | 跨端 |
| 错误序列化 | AppError 变体缺少 Serialize derive 或消息丢失 | Rust |
| 边界缺失 | 缺少 nil 检查、空值处理、错误传播 | 双端 |
| 锁死锁风险 | 跨 await 持有 Mutex、嵌套锁 | Rust |
| 层级违规 | 上层依赖下层的反向依赖、跨层直接访问 | 双端 |
| 重复逻辑 | 多处存在相似代码应提取为共享函数 | 双端 |
发现问题时：
每个文件讲完后：
在逐文件阅读过程中，用户可以随时要求回到全局视角（如说 "zoom out"、"往上拉一层"、"给我个全景"），或者在以下时机自动触发：
执行方式：用最新的已读状态重新绘制 Phase 2 的模块地图（✅ 标记已读文件），问用户："要继续逐文件深入，还是先看看其他层？"
每过完一个域层级后，做一个简要总结：
所有文件过完后，输出完整总结：
## 代码地图
### 分层结构
[按域和层级列出所有文件及其职责]
### 数据流
[从入口到出口的完整调用链，标注文件:行号]
- 前端 → 后端：invoke("command") 链路
- 后端 → 前端：emit("event") 链路
### 类型契约
[Rust 模型与 TypeScript 接口的对应关系]
### 设计决策
[key 设计决策及其权衡]
### 发现的问题
[按严重程度排列的问题列表]
- 类型不一致: [Rust 类型:行号 ↔ TS 接口:行号]
- Dead code: [文件:行号]
- 设计偏差: [描述]
- 迁移遗漏: [描述]
### 待确认项
[阅读过程中未解决的开放问题]
文件路径:行号