Menú
功能归档规范。在归档功能版本、更新功能网、创建存档快照时激活，确保节点编号正确、网络图完整。
Instalar con Codex o Claude Copia este prompt, pégalo en Codex, Claude u otro asistente, y deja que revise la página de la skill y la instale por ti.
Basado en la clasificación ocupacional SOC
GitHub Release 发布操作规范。在需要发布版本、上传安装包到 GitHub Release 时激活，确保使用正确的命令和流程。
确认/删除等交互弹框统一使用 showTolyPopPicker 底部弹出样式。在需要弹出确认框、删除确认、操作选择时激活，确保交互风格一致。
后端服务启动与数据库操作规范。在需要启动后端服务、运行 API 测试、执行数据库迁移或遇到连接错误时激活，确保使用正确的命令和流程。
使用 tolyui_mediax 实现媒体预览。适用于图片九宫格展示、全屏预览、手势缩放、视频播放、Hero 动画等场景。
Flutter Widget/Page 组件代码评审技能。在需要审查组件代码质量、发现设计问题时激活，确保输出结构化的问题清单和改进建议。
Flutter Widget/Page 组件重构执行技能。在需要对组件执行拆分、提取、简化时激活，确保按正确手法重构并验证通过。
| name | feature-archiver |
| description | 功能归档规范。在归档功能版本、更新功能网、创建存档快照时激活，确保节点编号正确、网络图完整。 |
| metadata | {"model":"manual","last_modified":"Tue, 13 May 2026 00:00:00 GMT"} |
你是功能网络的归档者和维护者。你的职责是让全局功能网永远保持最新，让每一次变更都有迹可循。
功能需求整理师（Feature Analyst）负责分析功能、分配编号、产出 analysis.md。你负责把这些分析结果归档到全局功能网中：更新节点编号表、更新网络图、维护局域网络、记录存档快照。
docs/features/archiver/
├── index.md # 全局：节点编号表 + 网络图 + 存档记录表
├── modules/
│ ├── auth/
│ │ ├── server.md # 认证域后端
│ │ └── client.md # 认证域前端
│ ├── ws/
│ │ ├── server.md
│ │ └── client.md
│ ├── conversation/
│ │ ├── server.md
│ │ └── client.md
│ ├── message/
│ │ ├── server.md
│ │ └── client.md
│ └── ... # 新增功能域时创建
└── trace/
├── v0.7.0_2026-03-29.md # 各存档点快照
└── ...
当有新功能完成时：
{层级}-{序号}，I=基础设施, D=领域, F=前端基础, P=前端业务）每个功能域一个文件夹，前后端各一个文件（server.md / client.md）。用三焦距方法梳理该域的工序，让人不读源码就能理解模块的骨骼、血液和神经。
如果某个域只有后端（如 storage），只写 server.md。只有前端的同理。
# {域名} — {端}局域网络
涉及节点：{编号范围}
---
## 一、远景：模块与依赖
> 骨骼怎么连？不打开源码，只看配置文件和目录结构就能回答。
### 涉及模块
| 模块 | 位置 | 职责（一句话） |
|------|------|--------------|
| ... | 路径 | ... |
### 依赖关系
mermaid graph 展示模块间的依赖方向。标注：
- 实线 = 直接依赖（import / Cargo.toml / pubspec.yaml）
- 虚线 = 跨端通信（proto / HTTP / WS）
- 箭头方向 = 依赖方向（A → B 表示 A 依赖 B）
如果发现不合理的依赖（平级互依赖、跨层依赖），用 ⚠️ 标注并说明。
### 节点详情
| 编号 | 功能节点 | 模块 | 职责 |
|------|---------|------|------|
| ... | ... | ... | ... |
---
## 二、中景：数据通道与事件流
> 血液怎么流？找 Repository（HTTP 入口）、找 Stream（WS 入口）、找 emit（状态出口）。
### 数据通道
列出该域涉及的数据通道，每条通道说明协议、方向、特点。
| 通道 | 协议 | 方向 | 特点 | 例子 |
|------|------|------|------|------|
| ... | HTTP/WS/内存 | 客户端主动/服务端推送/内部 | ... | ... |
### 关键事件流
用 mermaid sequenceDiagram 画出核心场景的数据流转全貌。
重点标注：数据从哪来 → 经过什么处理 → 到哪去。
每个场景一张图，不要合并。
### 边界接口
分类列出该域对外暴露和消费的接口：
**Protobuf 协议**（如有）
| 结构 | 文件 | 生产节点 | 消费节点 |
|------|------|---------|---------|
**HTTP 接口**
| 接口 | 提供节点 | 消费节点 |
|------|---------|---------|
**Rust trait / Dart 抽象**（如有）
| 接口 | 定义节点 | 实现节点 | 作用 |
|------|---------|---------|------|
---
## 三、近景：生命周期与订阅
> 神经怎么传导？找 listen 和 cancel，看它们是不是成对的。
### 核心对象生命周期
| 对象 | 创建时机 | 销毁时机 | 生命跨度 |
|------|---------|---------|---------|
| ... | ... | ... | 应用级/页面级/会话级 |
### 订阅关系
列出谁在监听谁，以及取消订阅的时机。用表格呈现：
| 订阅者 | 监听目标 | 订阅时机 | 取消时机 | 是否成对 |
|--------|---------|---------|---------|---------|
如果发现 listen 没有对应的 cancel，用 ⚠️ 标注。
---
## 四、版本演进
| 版本 | 变更 |
|------|------|
| ... | ... |
不是每个域都需要三个焦距都写满。如果某个域没有 WS 通道（比如认证域），中景可以简化。如果某个域没有 Stream 订阅（比如纯后端模块），近景可以省略。按实际情况裁剪，不要硬凑。
每次项目存档（git tag）时，创建一个独立的快照文件：
文件命名：{存档版本}_{日期}.md（存档版本用 git tag，如 v0.10.0）
内容：
im/core/v0.0.6_file_system），方便回溯到具体的 analysis/design/tasks 文件用户说"归档功能网"或"更新功能网"时：
index.md：节点编号表 + 网络图 + 存档记录modules/{域名}/server.md 和/或 modules/{域名}/client.md：按三焦距格式梳理trace/{存档版本}_{日期}.md：存档快照