手把手教你创建一个个人助理 Agent

---
name: contact-manager
description: >
  管理个人通讯录的完整技能。负责对数据文件 `~/aide/my_contacts.csv` 进行增、删、改、查和分析操作。
  当用户提到联系人、电话、邮箱、通讯录、管理联系人、添加联系人、查找联系人、更新联系人、删除联系人等相关操作时触发。
  与 `aide/reminder-manager` 联动：有生日的联系人自动创建农历/公历生日提醒。
version: 1.0.0
platforms: [linux]
metadata:
  hermes:
    tags: [personal, contacts, productivity]
    category: aide
requires: [pandas, lunardate]
---

# 通讯录管理技能

## 描述
本技能定义了艾迪（Aide）作为你的个人管家，管理个人通讯录所需的所有规则与操作方法。
通讯录数据存储在 `~/aide/my_contacts.csv` 文件中，所有操作必须严格遵守本文件的规定。

与 `aide/reminder-manager` 联动：联系人新增或更新生日信息时，自动创建生日提醒。
与 `aide/memo-manager` 联动：删除联系人时，自动清理所有备忘录中该联系人的 `related_contacts` 引用。

## 适用场景
- 用户需要添加新联系人信息
- 用户需要查询已有联系人的详细信息
- 用户需要修改联系人的部分信息
- 用户需要删除或归档某个联系人
- 用户需要分析社交网络，如生日提醒、联系频率等

## 触发关键词
- 添加联系人、新建联系人、保存联系人、记一下、存一下
- 查找、搜索、查询、有哪些、谁、列出
- 修改、更新、更换、变成、改一下
- 删除、删掉、移除、去掉
- 分析、报告、统计、提醒、多久没联系

## 数据文件
- 路径：`~/aide/my_contacts.csv`
- 编码：UTF-8
- 分隔符：逗号 `,`
- 引用符：双引号 `"`
- 首行为列名，顺序固定

## 数据模式（Schema）
| 列名 | 类型 | 说明 | 示例 |
|------|------|------|------|
| `id` | 字符串 | 唯一标识，全表不可重复。使用 `openssl rand -hex 4` 生成 8 位十六进制字符串；若环境不支持则回退使用 `uuidgen` 取前 8 位 | `a3f2b1c0` |
| `name` | 字符串 | 姓名（必填） | 张三 |
| `nickname` | 字符串 | 常用称呼 | 三哥 |
| `phones` | JSON字符串 | 电话号码列表，每项 `{"type":"类型","number":"号码","country":"国家码"}`，type可选 `mobile,home,work,other`。存储为JSON序列化后的字符串 | `[{"type":"mobile","number":"13912345678","country":"+86"}]` |
| `emails` | JSON字符串 | 邮箱列表，每项 `{"type":"类型","addr":"地址"}`，type可选 `work,personal,other`。存储为JSON序列化后的字符串 | `[{"type":"work","addr":"zhangsan@corp.com"}]` |
| `organization` | 字符串 | 公司/单位 | 某科技有限公司 |
| `title` | 字符串 | 职位 | 高级工程师 |
| `relationship` | 枚举字符串 | 关系类型：`family`, `friend`, `colleague`, `client`, `acquaintance` | `friend` |
| `tags` | 逗号分隔 | 自定义标签，用于灵活分组 | `跑步群,读书会,家长群` |
| `notes` | 长文本 | 备注，可记录爱好、相识背景等 | 喜欢喝冰美式，2023年一起爬过华山，配偶叫李花 |
| `birthday` | 日期 | 公历生日，格式 `YYYY-MM-DD` | `1990-05-20` |
| `lunar_birthday` | 字符串 | 农历生日，中文描述 | `正月初一` |
| `last_contact` | 日期 | 最近一次联系日期 `YYYY-MM-DD` | `2025-04-20` |
| `created_at` | 时间戳 | 记录创建时间（ISO 8601） | `2025-04-25T10:30:00` |
| `updated_at` | 时间戳 | 最后更新时间（ISO 8601） | `2025-04-25T14:00:00` |

## 执行流程

### 1. 增加联系人（ADD）
1. 根据用户提供的信息，在脑海中构建新联系人的数据画像。
2. 生成唯一 `id`：在终端中运行 `openssl rand -hex 4`（若不可用则使用 `uuidgen` 并截取前 8 位），作为新联系人的唯一标识。
3. 将给出的信息填入匹配的列名。注意：
   - `phones` 和 `emails` 必须以 JSON 字符串写入。先用 Python 构建字典列表，再用 `json.dumps(list, ensure_ascii=False)` 序列化为字符串，然后写入 CSV。
   - 使用 `csv.DictWriter` 写入，`csv.writer` 会自动处理外层引号包裹。
4. 保留所有用户未提及的其他列单元格为空。
5. 自动设置 `created_at` 和 `updated_at` 为当前 UTC 时间。
6. 插入新行到 CSV 文件。创建文件时先确保目录存在：`os.makedirs(os.path.dirname(path), exist_ok=True)`。
7. 写入后**必须验证**：用 `pandas.read_csv()` 读回数据，检查 `phones` 字段能否被 `json.loads()` 正常解析。如果解析失败，说明引号转义有问题，需要调整写入方式。
8. **联动提醒**：如果联系人有 `birthday` 或 `lunar_birthday`，加载 `aide/reminder-manager` 技能，为该联系人创建一条 `source=contact` 的 `yearly` 生日提醒。
9. 向用户确认新增结果，包括是否自动设置了生日提醒。

### 2. 查询联系人（QUERY）
1. 理解用户的查询意图（是否精确查询某个人，或批量查找某类人）。
2. 精确查询时，使用 `name` 或 `id` 直接过滤。
3. 模糊查询时，在所有文本列中搜索关键词（特别是 `notes`、`organization`、`tags`）。
4. 时间相关查询（生日、最后联系时间）时，使用 `pandas` 进行日期计算。
5. 以简洁的表格或列表形式返回结果。
6. 查询过程不修改源文件。

### 3. 更新联系人（UPDATE）
1. 根据用户提供的条件（如 `name` 或 `id`）精准定位需要更新的行。
2. 更新指定的字段数据。如果涉及 `phones` 或 `emails` 等JSON字段，需先解析、修改、再重新序列化。
3. 批量操作时注意合并标签（去重追加），而非覆盖。
4. 每次信息变更后，必须将 `updated_at` 字段刷新为当前时间。
5. **联动提醒**：如果本次更新新增或修改了 `birthday` / `lunar_birthday`，加载 `aide/reminder-manager` 技能，创建或更新对应的生日提醒。
   - **⚠️ 关键边界情况**：如果联系人原本只有 `birthday`（公历），系统已自动创建了公历日期的 yearly 提醒。此时用户新增 `lunar_birthday`（农历），**不能简单新创建一个提醒**，而是需要：
     1. 先查询 `~/aide/reminders.csv` 中 `source=contact` + `source_id={该联系人id}` 的已有提醒。
     2. 将已有提醒的 `remind_at` 更新为正确的农历换算日期，`message` 更新为包含农历信息（如"农历生日（X月XX日）"）。
     3. 同步更新对应 cronjob 的 `schedule` 和 `prompt`（用 `cronjob(action='update')`）。
   - 简而言之：同一个联系人的生日提醒**只有一个**，后来的生日信息（农历优先）应当更新已有提醒，而不是创建第二个。
6. 若用户告知"联系过某人"，应更新 `last_contact` 并在 `notes` 中追加简要记录。
7. 汇报更新结果。

### 4. 归档/删除联系人（ARCHIVE/DELETE）
1. 优先建议使用"归档"功能。若表中尚无 `archived` 列，可询问用户是否添加该列（值 0/1）。
2. 若用户坚持要求彻底删除，必须二次确认，并列出受影响的行。
3. **联动提醒**：删除联系人后，加载 `aide/reminder-manager` 技能，删除或停用对应的生日提醒（通过 `source=contact` + `source_id` 查询）。
4. **联动备忘录清理**：删除联系人后，加载 `aide/memo-manager`，扫描 `~/aide/my_memos.csv` 中所有 `related_contacts` 字段，将该联系人的 `id` 从 JSON 数组中移除。如果移除后数组为空，写空字符串。更新受影响行的 `updated_at`。
5. 确认后，从CSV文件中移除对应行。
6. 操作后汇报变更结果，包括备忘录清理情况。

### 5. 分析与建议（ANALYZE）
1. 分析联系频率、关系分布、近期生日提醒等。
2. 通过 Python 进行数据统计，结果以文本形式（如 ASCII 表格）呈现。
3. 主动提示长期未联系的人、即将到来的农历/公历生日。
4. 可调用 `aide/reminder-manager` 查询已设置的生日提醒列表，一并汇报。

## 常见陷阱
- **JSON序列化**：`phones` 和 `emails` 存储为 JSON 数组字符串。写入时使用 `json.dumps(obj, ensure_ascii=False)` 生成字符串，写入 CSV 时使用 Python 标准库 `csv` 的 `quoting=csv.QUOTE_ALL` 确保引号正确转义。读取时用 `json.loads()` 还原。
- **联动提醒**：创建联系人生日提醒时，使用 `lunardate` 库将农历生日换算为当年公历日期。如果联系人只有农历生日，备注说明每年提醒日期会随农历变动。
- **路径处理**：`~/aide/my_contacts.csv` 使用 `os.path.expanduser('~/aide/my_contacts.csv')`。注意：不同环境下 `~` 展开结果可能不同。首次操作时应打印实际路径让用户确认。
- **批量操作**：不要覆盖原有的 `tags`，而是去重合并。
- **日期格式**：所有日期和日期时间字段需严格遵循 ISO 8601 标准 (`YYYY-MM-DD` 或 `YYYY-MM-DDTHH:MM:SS`)。

## 验证方法
- 添加联系人后，通过查询该联系人的名字或ID，确认信息已正确写入。
- **JSON可读性验证**：写入后执行 `python -c "import pandas as pd, json; df=pd.read_csv('~/aide/my_contacts.csv'); print(json.loads(df.iloc[0]['phones']))"` 确认 JSON 字段可被正确解析。
- **联动验证**：添加有生日的联系人后，确认 `~/aide/reminders.csv` 中有对应的 `source=contact` 记录。
- 更新联系人后，通过查看 `updated_at` 字段确认时间已刷新。
- 批量操作后，随机抽查几行数据以确保合并逻辑正确。

## 安全红线
- 数据永不出本地，不得将通讯录内容上传到任何外部服务。
- 批量删除、导出全表等敏感操作必须额外确认。
- 所有修改前后必须有清晰的确认和汇报。

---
name: memo-manager
description: >
  管理个人备忘录的完整技能。负责对数据文件 `~/aide/my_memos.csv` 进行增、删、改、查和分析操作。
  当用户提到备忘、备忘录、记一下、笔记、待办、灵感、想法、草稿等相关操作时触发。
  与 `aide/contact-manager` 联动：备忘录可通过 `related_contacts` 字段关联到通讯录中的联系人。
  与 `aide/reminder-manager` 联动：待办事项（todo）设置了截止日期时自动创建微信提醒。
version: 2.1.0
platforms: [linux]
metadata:
  hermes:
    tags: [personal, memos, productivity]
    category: aide
requires: [pandas]
---

# 备忘录管理技能

## 描述
本技能定义了艾迪（Aide）作为你的私人管家，管理个人备忘录所需的所有规则与操作方法。
备忘录数据存储在 `~/aide/my_memos.csv` 文件中，所有操作必须严格遵守本文件的规定。

与 `aide/contact-manager` 联动：备忘录通过 `related_contacts` 字段与通讯录中的联系人建立关联。
与 `aide/reminder-manager` 联动：新增或更新 `todo` 类型且有 `due_date` 的备忘录时，自动创建微信提醒。

## 适用场景
- 用户需要快速记录灵感、想法、待办事项
- 用户需要查询、筛选或搜索已有备忘录
- 用户需要修改、更新或完成某个备忘录
- 用户需要归档或删除备忘录
- 用户需要按联系人查看相关备忘录
- 用户需要分析备忘录（按分类统计、优先级排序、待办提醒等）

## 触发关键词
- 记一下、记一笔、备忘、备忘录、笔记
- 待办、待做、要做、别忘了
- 想法、灵感、想到一个
- 查一下备忘录、我的记录、有哪些
- 完成、做完了、删掉这条

## 数据文件
- 路径：`~/aide/my_memos.csv`
- 编码：UTF-8
- 分隔符：逗号 `,`
- 引用符：双引号 `"`
- 首行为列名，顺序固定

## 数据模式（Schema）
| 列名 | 类型 | 说明 | 示例 |
|------|------|------|------|
| `id` | 字符串 | 唯一标识，全表不可重复。使用 `openssl rand -hex 4` 生成8位十六进制字符串 | `a3f2b1c0` |
| `title` | 字符串 | 标题（必填），简明扼要概括内容 | 下周三交季度报告 |
| `content` | 长文本 | 正文内容，自由书写 | 财务部要求周三前提交Q2季度报告 |
| `category` | 枚举字符串 | 分类：`note`(普通备忘), `todo`(待办), `idea`(灵感), `draft`(草稿) | `todo` |
| `tags` | 逗号分隔 | 自定义标签，用于灵活分组 | `工作,季度报告` |
| `priority` | 整数 | 优先级：`1`(高), `2`(中), `3`(低) | `1` |
| `status` | 枚举字符串 | 状态：`active`(进行中), `completed`(已完成), `archived`(已归档) | `active` |
| `due_date` | 日期 | 截止日期，仅 `todo` 类可用，格式 `YYYY-MM-DD` | `2026-05-06` |
| `remind_at` | 时间戳 | 自定义提醒时间（可选），仅 `todo` 类使用。设此字段后，提醒时间不再使用默认规则（到期前一天20:00），而是以此字段为准。ISO 8601 格式，存储 UTC 时间。 | `2026-05-05T12:00:00` |
| `location` | 字符串 | 地点（可选），与备忘内容相关的地理位置。有则记录，无则留空。 | `南京南站咖啡店` |
| `related_contacts` | JSON字符串 | 关联的通讯录联系人ID列表。存储为JSON数组字符串 | `["333dddc3","4ed04402"]` |
| `created_at` | 时间戳 | 记录创建时间（ISO 8601） | `2026-04-25T10:30:00` |
| `updated_at` | 时间戳 | 最后更新时间（ISO 8601） | `2026-04-25T14:00:00` |

### `related_contacts` 字段详解
- **作用**：建立备忘录与通讯录中联系人的双向关联
- **类型**：JSON 数组字符串，元素为通讯录中联系人的 `id`
- **自动填充**：用户描述中提到人名时，自动在通讯录中查找匹配，填入对应 `id`
- **允许多个**：一条备忘录可关联多个联系人
- **允许为空**：不涉及特定联系人时留空
- **与 contact-manager 配合**：
  - 新增备忘时 → 自动匹配人名 → 填入 `related_contacts`
  - 查询时 → 按联系人查询所有相关备忘
  - 删除联系人时 → 联动清理该联系人关联的所有备忘中的 `id`

## 执行流程

### 1. 增加备忘录（ADD）
1. 根据用户的描述，判断最合适的 `category`：
   - 提到"要做"、"别忘了"、"周五前"等 → `todo`
   - 提到"突然想到"、"灵感"、"有个主意" → `idea`
   - 提到"记一下"、"写下来"、"摘抄"等 → `note`
   - 用户明确说"草稿"、"初稿" → `draft`
2. 生成唯一 `id`：在终端中运行 `openssl rand -hex 4`。
3. **自动关联联系人**：扫描用户的描述中是否提及人名。如果发现，加载 `~/aide/my_contacts.csv` 用 `name` 或 `nickname` 匹配，匹配到的 `id` 填入 `related_contacts` 的 JSON 数组。如果匹配不到，将人名原文记录到 `content` 而非 `related_contacts`。
4. 让用户为备忘录起一个简短标题（若用户未提供，根据内容自动提炼）。
5. 填入用户提供的所有信息，未提及的字段留空。
6. 自动设置 `status = "active"`、`created_at` 和 `updated_at` 为当前 UTC 时间。
7. 追加新行到 CSV 文件。
8. **联动提醒**：如果 `category = todo` 且 `due_date` 不为空，加载 `aide/reminder-manager` 技能，创建一条 `source=memo` 的 `once` 提醒。提醒时间的优先级规则：
   - 如果用户提供了 `remind_at` 字段，**使用 `remind_at` 作为提醒时间**（用户自定义精确时间）
   - 如果 `remind_at` 为空，默认使用到期前一天 20:00（北京时间），若到期时间很紧迫则提前30分钟
9. 向用户确认新增结果，包括分类、优先级、是否关联了联系人、是否自动设置了提醒。

### 2. 查询备忘录（QUERY）
1. 理解用户的查询意图。支持以下方式：
   - 按 `id` 或 `title` 精确查询
   - 按 `category` 筛选（如"查看所有待办"）
   - 按 `status` 筛选（如"已完成的事"）
   - 按 `tags` 模糊搜索
   - 按 `priority` 排序
   - 全文搜索 `content`
   - **← 新增 →** 按联系人查询：用户提到某个联系人的名字时，先在通讯录中查出对方的 `id`，再在 `related_contacts` 中匹配。示例："查一下张蒙有什么事" → 查 `related_contacts` 包含 `333dddc3` 的所有行
2. 时间相关查询（到期提醒、创建日期范围）时，使用 `pandas` 进行日期计算。
3. 以简洁的列表形式返回结果，说明分类、优先级、关联联系人（从通讯录中反查姓名显示）和截止日期（如有）。
4. 查询过程不修改源文件。

### 3. 更新备忘录（UPDATE）
1. 根据用户提供的条件（`id` 或 `title`）精准定位需要更新的行。
2. 更新指定的字段。支持场景：
   - 修改标题或内容
   - 变更分类或标签（合并去重）
   - 调整优先级
   - 标记完成（`status = "completed"`）
   - 设置或修改截止日期
   - **← 新增 →** 增加或移除关联的联系人 `id`
3. 每次变更后，必须更新 `updated_at`。
4. **联动提醒**：
   - 如果标记为 `completed` 或 `archived`，加载 `aide/reminder-manager`，停用对应的提醒。
   - 如果新增或修改了 `due_date`，创建或更新对应的提醒。
5. 汇报更新结果。

### 4. 归档/删除备忘录（ARCHIVE/DELETE）
1. 优先建议"归档"（设置 `status = "archived"`），数据保留但不出现在活跃列表中。
2. 若用户坚持彻底删除，必须二次确认，列出受影响的行。
3. **联动提醒**：删除前加载 `aide/reminder-manager`，删除或停用对应的提醒（通过 `source=memo` + `source_id` 查询）。
4. 确认后从 CSV 文件中移除对应行。
5. 操作后汇报变更结果。

### 5. 分析与提醒（ANALYZE）
1. 主动检查即将到期的待办事项（`status = "active"` 且 `due_date` 临近或已过期）。
2. 统计各分类的数量分布。
3. 按优先级排序，提示用户优先处理高优先级事项。
4. **← 新增 →** 按联系人聚合统计备忘数量，提示哪些联系人最近有相关备忘
5. 可调用 `aide/reminder-manager` 查询已设置的待办提醒列表，一并汇报。
6. 在适当时候（如对话自然衔接时）主动提醒。

## CSV 读写规范
- 写入时使用 `quoting=csv.QUOTE_ALL` 确保 JSON 和其他特殊字符被正确转义
- 读取时使用 `pandas.read_csv()` 或 Python `csv` 标准库
- `content` 和 `related_contacts` 字段可能包含特殊字符，必须确保引号包裹正确
- 路径使用 `os.path.expanduser('~/aide/my_memos.csv')`

## 常见陷阱
- **标题提炼**：用户可能说"记一下xxxx"很长一句话，需要你主动提炼标题，并让用户确认。
- **分类误判**：如果用户没有明确说分类，不要猜测，主动问一句："这个归为待办还是普通备忘？"
- **联动提醒时机**：只有 `todo` + 有 `due_date` 才自动创建提醒。`note`、`idea`、`draft` 不创建提醒。
- **人物匹配**：只在 `related_contacts` 中存通讯录中确认匹配到的 `id`，`name` 和 `nickname` 都匹配不到的不要硬填。多音字、昵称模糊匹配时可询问用户确认。
- **related_contacts 写入**：使用 `json.dumps(list, ensure_ascii=False)` 序列化后写入，CSV 的 `quoting=QUOTE_ALL` 会自动处理外层引号。读取时用 `json.loads()` 还原，空串时返回空列表。
- **联系人删除联动**：当通讯录中某个联系人被删除时，需要扫描所有备忘录，将该联系人的 `id` 从 `related_contacts` 的 JSON 数组中移除。如果移除后数组为空，写 `""`（空字符串），不要写 `"[]"`。
- **空 content**：允许 `content` 为空，`title` 必须有值。
- **日期格式**：所有日期和日期时间字段需严格遵循 ISO 8601 标准。
- **路径处理**：使用 `os.path.expanduser('~/aide/my_memos.csv')` 处理波浪号路径。

## 验证方法
- 添加备忘录后，通过查询确认信息已正确写入。
- **人物关联验证**：添加提及联系人的备忘后，确认 `related_contacts` 字段包含正确的 `id`，且可被 `json.loads()` 解析。
- **联动验证**：添加 `todo` + `due_date` 的备忘录后，确认 `~/aide/reminders.csv` 中有对应的 `source=memo` 记录。
- **交叉查询验证**：新增按联系人查询功能后，验证"张三的备忘"能查到所有关联张三的备忘。
- 标记完成后，检查 `status` 和 `updated_at` 已更新，且对应的提醒已停用。
- 删除前必须列出受影响的行并等待用户确认。

## 安全红线
- 数据永不出本地，不得将备忘录内容上传到任何外部服务。
- 批量删除必须额外确认。

---
name: reminder-manager
description: >
  统一的日程提醒管理技能。负责从通讯录（生日提醒）和备忘录（待办提醒）自动或手动创建、
  查询、修改、取消提醒，并通过微信渠道按时发送通知。所有提醒的原始数据仍存储在通讯录和
  备忘录中，本模块仅管理"何时提醒、如何提醒"的调度信息。
version: 1.1.0
platforms: [linux]
metadata:
  hermes:
    tags: [personal, reminder, scheduling, productivity]
    category: aide
requires: [pandas, lunardate]
---

# 日程提醒管理技能

## 描述
本技能是艾迪（Aide）作为私人管家的"闹钟系统"。它不存储用户的人或事，而是存储"什么时候该提醒什么"的调度信息。与通讯录（`contact-manager`）和备忘录（`memo-manager`）联动，形成完整的数据闭环。

## 提醒渠道

- **默认渠道**：微信（`send_message` 工具）
- **可选渠道**：QQ 邮件（`qq-email` 技能），用户在创建提醒时说"同时邮件提醒"时启用
- **双渠道提醒**：在 cron job 创建时，将 `qq-email` 技能附加到 job 的 `skills` 参数中，prompt 内同时包含微信发送和邮件发送的指令

## 数据文件
- 路径：`~/aide/reminders.csv`
- 编码：UTF-8
- 分隔符：逗号 `,`
- 引用符：双引号 `"`
- 首行为列名，顺序固定

## 数据模式（Schema）
| 列名 | 类型 | 说明 | 示例 |
|------|------|------|------|
| `id` | 字符串 | 唯一标识，`openssl rand -hex 4` 生成8位十六进制 | `b3e1f0a2` |
| `title` | 字符串 | 提醒标题，简明扼要 | 李娟生日 |
| `source` | 枚举字符串 | 来源：`contact`(通讯录生日), `memo`(备忘录待办), `manual`(手动添加) | `contact` |
| `source_id` | 字符串 | 来源记录的 ID，用于追查原始数据 | 李娟的 contact_id |
| `remind_at` | 时间戳 | 下次提醒时间（UTC），精确到分钟 | `2026-04-25T23:20:00` |
| `repeat` | 枚举字符串 | 重复规则：`once`(一次), `yearly`(每年), `monthly`(每月), `weekly`(每周) | `yearly` |
| `message` | 长文本 | 提醒内容模板，发送时直接使用 | 今天是李娟的生日，别忘了祝她生日快乐！🎂 |
| `channel` | 字符串 | 发送渠道，目前仅支持 `weixin` | `weixin` |
| `enabled` | 整数 | 是否启用：`1`(启用), `0`(停用) | `1` |
| `created_at` | 时间戳 | 创建时间（ISO 8601） | `2026-04-25T10:30:00` |
| `updated_at` | 时间戳 | 最后更新时间（ISO 8601） | `2026-04-25T14:00:00` |

## 联动规则（重要）

### 与通讯录的联动
1. 当 `contact-manager` 添加或更新一个联系人时，如果该联系人有 `birthday` 或 `lunar_birthday` 字段，应自动调此模块创建 `yearly` 提醒。
2. 农历生日需通过 lunardate 库换算为当年公历日期，再设置提醒时间在生日当天北京时间 08:00（提前一天或当天均可，默认当天08:00）。
3. 联系人被删除或生日字段被清空时，对应的提醒也应同步停用或删除。
4. 提醒标题格式：`{姓名}生日`，消息模板：`今天是{姓名}的生日，别忘了祝Ta生日快乐！🎂`

### 与备忘录的联动
1. 当 `memo-manager` 添加或更新一条 `category = todo` 且 `due_date` 不为空的备忘录时，应自动调此模块创建 `once` 提醒。
2. 提醒时间的优先级规则：
   - **优先**：使用备忘录的 `remind_at` 字段（用户自定义精确时间）
   - **默认**：如果 `remind_at` 为空，使用到期前一天 20:00（北京时间），或到期当天提前20-30分钟（根据内容判断）
3. 备忘录被标记为 `completed` 或 `archived` 时，对应的提醒应停用。
4. 备忘录被删除时，对应的提醒应删除。
5. 提醒标题格式：`备忘录：{title}`，消息模板使用备忘录的 `content` 或 `title`。

### 手动添加（含多渠道）

1. 用户可以直接提需求，如"下周五下午3点提醒我开会"，识别后创建 `source = manual` 的提醒。
2. 用户可以说"取消那个提醒"，通过标题或ID查询后停用/删除。
3. **双渠道提醒**：如果用户说"同时邮件提醒"或"也发邮件提醒我"，则在创建 cron job 时：
   - 设置 `skills=["aide/qq-email"]` 让 cron 可访问邮件发送能力
   - prompt 内包含两步：先 `send_message` 微信推送，再调用 qq-email 发邮件到 trevanzhang@qq.com
   - 使用 `deliver: "local"`（不要用 `deliver: "weixin:..."`），由 prompt 内的 LLM 自主控制两个渠道

## 执行流程

### 1. 创建提醒（CREATE）
1. 确定 `source`、`source_id`、`title`、`repeat`、`remind_at`（UTC时间）。
2. 生成唯一 `id`：`openssl rand -hex 4`。
3. 检查是否已有相同 `source` + `source_id` 的提醒（避免重复创建）。
4. 写入 `reminders.csv`。
5. 调用 cronjob 模块设置定时任务（若使用 `cronjob` 工具）。注意：`yearly` 重复的提醒只需每年重新调度一次。

### 2. 查询提醒（QUERY）
1. 支持按 `source`、`title`、`enabled` 状态、即将到期等条件查询。
2. 返回时需额外标注：距离下次提醒还有多久（人性化描述，如"3天后"、"明天"）。
3. 查询不修改源文件。

### 3. 修改提醒（UPDATE）
1. 通过 `id` 或 `title` 定位。
2. 可修改 `remind_at`、`message`、`repeat`、`enabled`。
3. 若修改了时间，需同步更新对应的 cronjob。
4. 更新 `updated_at`。

### 4. 停用/删除提醒（DISABLE/DELETE）
1. 停用（`enabled = 0`）：提醒不再触发，数据保留。
2. 删除：彻底移除行，同时删除对应的 cronjob。
3. 删除前必须二次确认。

### 5. 触发提醒（TRIGGER）
当 cronjob 触发时，本模块执行以下操作：
1. 读取 `reminders.csv` 找到对应的提醒记录。
2. 组装消息内容（模板替换 `{姓名}` 等占位符）。
3. 通过 `send_message` 发送到指定 `channel`。
4. **双渠道生日提醒**：对于已配置邮件渠道的生日提醒（如家庭成员），cron job 的 prompt 应：
   - 先通过 `send_message` 发送微信消息
   - 再调用 qq-email 技能发送邮件到 trevanzhang@qq.com
   - cron job 创建时需加 `skills=["aide/qq-email"]` 并设 `deliver: "local"`
5. 对于 `once` 类型的提醒：标记为 `enabled = 0` 或删除行。
6. 对于 `yearly` 类型的提醒：计算下一年日期，更新 `remind_at`，重新创建 cronjob。

## 与 cronjob 工具的协作
- 本模块不直接实现定时逻辑，而是调用系统 `cronjob` 工具来调度。
- 创建提醒时：调用 `cronjob(action='create', schedule=remind_at, prompt=..., repeat=1)`。
- 取消提醒时：先用 `cronjob(action='list')` 查询已创建的 cronjob（按名称匹配），再 `cronjob(action='remove', job_id=...)` 删除。
- `cronjob` 工具的 `schedule` 参数接收 ISO 8601 时间戳。系统时区为 UTC，因此所有时间必须传入 UTC 时间。
- **yearly 提醒的生命周期**：
  1. 创建时，用 `cronjob(action='create', schedule=..., repeat=1)` 设一次性的 cronjob。
  2. 触发后，cronjob 自动销毁。
  3. 提醒触发逻辑（TRIGGER 流程）中，需要计算下一年的日期，更新 `reminders.csv` 中的 `remind_at`，并重新创建下一年的 cronjob。
  4. 对于**农历生日**（`lunar_birthday`）：下一年农历同一天对应的公历日期会变化，必须用 `lunardate` 库每年的11月21日重新换算，不能简单加一年。示例：2026年农历十一月廿一 → 2026-12-29，2027年需重新计算。
- **时区关键结论**：cronjob 系统位于 UTC 时区（`TZ=Etc/UTC`）。北京时间（UTC+8）的 `HH:MM` 需要换算：`北京时间 HH:MM = UTC (HH-8):MM`。如果结果为负，则日期减一天。示例：北京时间 2026-04-26 07:20 = UTC 2026-04-25 23:20，应传入 `2026-04-25T23:20:00`（不带后缀 Z，或带 Z 均可）。

## 常见陷阱
- **时区一致性**：所有 `remind_at` 存储为 UTC 时间，与系统时区一致。但在与用户沟通时，始终使用北京时间（UTC+8）。
- **重复创建**：联动时务必先查询是否已有 `source` + `source_id` 的提醒记录，避免重复。
- **⚠️ patch 工具无法处理 CSV 引用字段**：`reminders.csv` 使用 CSV 引用符（quoted fields），例如消息字段 `"🍎 该吃水果啦！..."` 会包含引号内的逗号。Hermes 的 `patch` 工具在遇到 CSV 文件的引号转义时会报 `Escape-drift detected` 错误。因此：
  - ❌ 不要用 `patch` 工具修改 `reminders.csv`
  - ✅ 必须用 `terminal` + Python `csv` 模块操作，如：`python3 -c "import csv; ..."`，使用 `csv.reader`/`csv.writer` 或 `csv.DictReader`/`csv.DictWriter`
  - ✅ 写入时使用 `csv.writer(f, quoting=csv.QUOTE_ALL)` 保持与现有文件一致的引用风格
- **⚠️ 过期日期检查**：创建 `yearly` 农历生日提醒时，用 lunardate 算出当年公历日期后，必须与当前日期比较。如果已过（比如今天是4月28日，而生日是4月26日），应调度到下一年的日期，而不是已经过去的日期。示例：李佳玉农历三月初十 → 2026-04-26（已过）→ 应改为 2027-04-16。
- **cronjob 生命周期**：`once` 提醒触发后会自动销毁，无需手动清理；`yearly` 需在触发后重新调度。
- **路径处理**：使用 `os.path.expanduser('~/aide/reminders.csv')`。
- **⚠️ execute_code 与 terminal 的 cron 不一致**：`execute_code` 环境调用的 `cronjob` 工具写入的是当前 profile 的 `jobs.json`。如果 cron 调度器（gateway 的 ticker）读取的是另一个 profile 的 `jobs.json`，则 job 不会触发。务必确认两者指向同一个 `HERMES_HOME`。

## 双渠道生日提醒的 cronjob 创建模式

当需要为家庭成员设置微信 + 邮件双渠道生日提醒时，遵循以下模式：

### cronjob 参数
- `skills=["aide/qq-email"]` — 附加邮件发送技能
- `deliver: "local"` — 不要用 `deliver: "weixin:..."`，否则微信会发两次（cron 框架一次，LLM 一次）
- `name` — 格式如 `{姓名}生日`
- `schedule` — 北京时间 08:00 对应的 UTC 时间（即当天 UTC 00:00）

### prompt 模板

### 批量重建流程
1. 先用 `cronjob(action='list')` 查出所有旧生日提醒的 job_id
2. 逐一 `cronjob(action='remove', job_id=...)` 删除
3. 用 lunardate 计算每个农历生日当年对应的公历日期
4. 逐一创建新的 cronjob，加上 `skills` 和 `deliver: "local"`
- 添加生日提醒后，确认 `reminders.csv` 中有对应记录，且 cronjob 已创建。
- 标记待办为完成后，确认对应提醒已停用。
- 手动触发 cronjob 测试，确认微信能收到消息。

## 故障排查指南

### 1. 用户说"没收到提醒" — 排查步骤

1. **检查 cronjob 是否创建成功**
   - 用 `cronjob(action='list')` 查看所有已创建的 job。
   - 确认 job 的 `deliver` 字段为 `weixin:o9cq804IKhdotAgKry-w_6dOgMSg@im.wechat`（即微信用户ID）。
   - 确认 `enabled=true` 且 `state="scheduled"`。

2. **确认 jobs.json 被写入正确位置**
   - **⚠️ 关键陷阱**：cronjob 工具（包括 `execute_code` 内调用的 `cronjob` 工具）会将 job 写入当前 profile 的 `jobs.json`，即 `~/.hermes/profiles/{profile}/cron/jobs.json`。
   - 调度器（gateway 的 cron ticker）读取的是同一 profile 下的 `jobs.json`，所以正常情况下应该一致。
   - 验证命令：`cd ~/.hermes/profiles/{profile} && HERMES_HOME=$PWD python3 -c "import sys; sys.path.insert(0, '/home/trevan/.hermes/hermes-agent'); from cron.jobs import JOBS_FILE; print(JOBS_FILE, 'exists:', JOBS_FILE.exists())"`
   - 注意：**默认（无 profile）gateway 和 `--profile aide` gateway 是两个独立进程**，各自有独立的 `HERMES_HOME` 和 `jobs.json`。确认 cronjob 创建在哪个 profile 下，就由哪个 gateway 的 ticker 负责执行。
   - 用 `ps aux | grep "hermes.*gateway"` 确认只有一个 aide profile 的 gateway 进程在运行。

3. **检查 cron ticker 是否在运行**
   - 用 `ps aux | grep "hermes.*gateway"` 查看 gateway 进程是否在运行。
   - 确认 ticker 日志：`grep "Cron ticker started" ~/.hermes/profiles/{profile}/logs/agent.log`
   - ⚠️ **注意**：ticker 以 `verbose=False` 模式调用 `tick()`，因此不会输出 "No jobs due" 等日志。要验证 ticker 是否实际工作，可以：
     a. 创建一个 2 分钟后到期的测试 job：`cronjob(action='create', name='测试', schedule='2m', ...)`
     b. 等待 2 分钟，检查 `~/.hermes/profiles/{profile}/cron/output/` 目录是否有新的输出文件

4. **手动触发一次 tick 排查问题**
   - 如果自动 tick 疑似不工作，手动执行：
     ```bash
     cd ~/.hermes/profiles/{profile}
     HERMES_HOME=$PWD python3 -c "
     import sys
     sys.path.insert(0, '/home/trevan/.hermes/hermes-agent')
     from cron.scheduler import tick
     tick(verbose=True)
     "
     ```
   - 观察输出中的 job 执行数量。
   - 快速检查 due jobs（无需运行 LLM）：
     ```bash
     cd ~/.hermes/profiles/{profile}
     HERMES_HOME=$PWD python3 -c "
     import sys; sys.path.insert(0, '/home/trevan/.hermes/hermes-agent')
     from cron.jobs import get_due_jobs, load_jobs
     due = get_due_jobs()
     print(f'Due: {len(due)}')
     data = load_jobs()
     for j in data['jobs']:
         print(f'  {j["name"]:20s} next={j.get("next_run_at","?")} last={j.get("last_run_at","None")}')
     "
     ```

5. **检查微信发送是否成功**
   - `grep "delivery error\|Weixin send failed\|send failed to\|Weixin send failed to" ~/.hermes/profiles/{profile}/logs/agent.log`
   - 常见错误码：
     - **`ret=-2` / `iLink sendmessage error`**：有两种可能，需先判断范围：
       - **局部性（仅 cron 发不出）**：如果**本微信会话能正常收发**（用户发消息你能回复），但 cron delivery 报 `ret=-2` → 是 cron 环境的异步上下文问题（`_deliver_result` 用 `ThreadPoolExecutor.submit(asyncio.run(...))` 创建新 event loop，但微信 iLink 的 `aiohttp.ClientSession` 在主 event loop 里创建，导致跨 loop 冲突）。此时重启 gateway 通常可解决。
       - **全局性（什么都发不出）**：如果**本微信会话也收不到消息**（你的回复用户看不到），同时日志全是 `ret=-2` → 是**微信 iLink 服务端 session 过期**，需要重新扫码登录。此时单纯重启 gateway 无效。
       - **诊断方法**：在当前会话中用 `send_message(action='send', target='weixin:...', message='test')` 给自己发一条测试消息。如果失败，说明是全局性问题（服务端 session 过期）。
     - **`Timeout context manager should be used inside a task`**：微信适配器在错误 event loop 中运行，常见于 cron delivery 的 ThreadPoolExecutor fallback 路径。重启 gateway 通常可解决。
     - **微信发送正常（无日志/空响应）**：如果 `agent.log` 中没有任何 "delivery error" 日志，但 cron 执行了（有 output 文件）而用户仍收不到 → 检查微信 iLink 是否返回了空 JSON `{}`。这比 `ret=-2` 更难排查，可能涉及 `context_token` 或 `aiohttp session` 初始化问题。

6. **检查微信 iLink 连接状态**
   - 查看登录凭证：`ls -la ~/.hermes/profiles/{profile}/weixin/login_tokens/`（检查 token 文件）
   - 检查 token 是否有效：token 可能是当日新创建的但仍然可能被服务端静默回收
   - 验证 iLink base_url 连通性：`curl -s -o /dev/null -w "%{http_code}" http://localhost:{port}/health`
   - 日志中搜索 `WeiXin adapter initialized` 确认适配器初始化正常
   - 注意：即使 `gateway setup` 刚扫码成功，token 也可能因为 iLink 服务端问题而无效。`ret=-2` 不一定等于 token 过期，也可能是请求格式/参数问题。

### 2. 双 gateway 进程共存问题
- 当用 `hermes gateway run --replace` 启动新 gateway 时，旧 gateway 可能不会立即退出，导致两个 gateway 同时运行，各自独立运行 cron ticker。
- 每个 gateway 有自己的 `HERMES_HOME` 和 `jobs.json`，两个 ticker 互不干扰。
- 但会造成混乱：新创建的 cron job 写入某个 gateway 的 `jobs.json`，并不一定是调度器读取的那个。
- **绝对判断方法**：用 `ps aux | grep hermes.*gateway` 确认进程数量。应该只有**一个** aide profile 的进程和**零个**默认 profile 的进程。
- 清理方法：`kill <old_pid>` 杀掉旧进程，或 `systemctl --user restart hermes-gateway-aide`。

### 3. iLink 扫码登录恢复流程（全局性 ret=-2 时）
- 确认当前微信会话中也收不到你的消息
- 需要在服务器终端执行重新登录：
  ```bash
  cd ~/.hermes/profiles/aide
  python3 -m hermes_cli.main gateway setup

### 邮件技能的设计哲学

这个技能只有一个收件人——你自己。它不是用来发邮件给别人的，而是用来**给自己留痕**的。生日提醒、待办通知、系统报告——所有需要正式记录的东西，都可以通过邮件发给自己，形成一份可搜索的时间线。

---

### 技能五：人生时间线（lifeline）

```markdown
---
name: lifeline
description: >
  人生时间轴技能。以时间为主线，将备忘录、通讯录等多源个人数据
  串联成完整的个人生活叙事HTML时间线页面。输出到 ~/output/lifeline/index.html。
  当用户提到时间轴、时间线、回顾、人生轨迹、生成传记、那年今天等时触发。
version: 1.0.0
platforms: [linux]
metadata:
  hermes:
    tags: [personal, lifeline, timeline, visualization]
    category: aide
requires: [pandas]
---

# 人生时间线技能

## 描述
本技能定义了艾迪（Aide）如何生成和维护你的"人生时间线"HTML页面。
从备忘录（`~/aide/my_memos.csv`）和通讯录（`~/aide/my_contacts.csv`）中读取数据，
按时间顺序生成一个交互式的纵向时间线 HTML 页面，输出到 `~/output/lifeline/index.html`。

## 适用场景
- 用户说"回顾一下我的生活"、"看看时间线"、"生成时间轴"
- 用户说"整理一下我的备忘录回顾"、"生成个人时间线"
- 备忘录更新后，需要刷新时间线页面
- 用户想以可视化方式浏览自己的记录

## 执行流程

### 1. 生成时间线（GENERATE）
1. 读取 `~/aide/my_memos.csv` 获取所有备忘录记录
2. 读取 `~/aide/my_contacts.csv` 获取通讯录，构建 id -> 姓名的映射
3. 从备忘录的 `related_contacts` 字段（JSON数组）反查关联的联系人姓名
4. 按月份分组，时间正序排列
5. 调用 `python3 ~/output/lifeline/gen_lifeline.py` 生成 HTML
6. 向用户汇报生成结果，告知路径

### 2. 更新后重新生成（REFRESH）
当备忘录有新增、修改或删除后，用户可能说"刷新时间线"：
1. 直接运行脚本：`python3 ~/output/lifeline/gen_lifeline.py`
2. 汇报更新结果

## 数据源
| 数据文件 | 路径 | 用途 |
|---------|------|------|
| 备忘录 | `~/aide/my_memos.csv` | 事件主数据（标题、内容、分类、时间、标签） |
| 通讯录 | `~/aide/my_contacts.csv` | 反查关联联系人姓名 |

## 输出
- `~/output/lifeline/index.html` — 交互式时间线页面
- `~/output/lifeline/gen_lifeline.py` — 生成脚本（可独立运行）

## HTML 页面功能
- 纵向时间轴布局，按月份分组
- 卡片式事件展示（标题、内容预览、分类徽标、优先级、关联人物）
- 分类筛选（全部/笔记/待办/灵感）
- 搜索框实时搜索（标题、内容、人物、标签）
- 长内容展开/收起
- 月份折叠
- 暗色主题、毛玻璃效果

## 验证方法
- 运行脚本后确认 `~/output/lifeline/index.html` 已生成
- 在浏览器中打开，检查所有卡片是否正常显示
- 测试分类筛选按钮和搜索框是否响应
- 检查关联联系人姓名是否正确显示

## 安全红线
- 数据不离开本机，所有数据源来自 `~/aide/` 目录
- 不向任何外部服务传输个人数据

---
name: lifeline-timeline
description: >-
  从备忘录和通讯录数据生成人生时间线 HTML 页面。
  将 ~/aide/my_memos.csv 中的记录按时间顺序排列，关联通讯录中的联系人姓名，
  渲染为可交互的纵向时间轴 HTML 页面，输出到 ~/output/lifeline/index.html。
version: 1.0.2
platforms: [linux]
metadata:
  hermes:
    tags: [personal, lifeline, timeline, visualization, html]
    category: aide
requires: [pandas]
---

# 人生时间线生成技能

## 描述
本技能定义了如何从用户现有的备忘录（CSV）和通讯录（CSV）数据中，生成一份可交互的人生时间线 HTML 页面。核心思路是：备忘录是时间线的叙事主体，通讯录提供"人物"维度，两者通过 `related_contacts` JSON 字段关联。

## 适用场景
- 用户问"看看我上周做了什么"→ 生成时间线就是最好的呈现方式
- 用户想回顾近期生活、查询与某人的交集
- 备忘录数据有积累后，生成可视化回顾页

## 关键设计决策

### 时区处理（重要）
- 所有时间存储在 `created_at` 字段中为 UTC 时间
- **生成时必须转换为北京时间 (UTC+8)**，否则时间显示偏差 8 小时
- 转换方式：Python 中定义 `BJT = timezone(timedelta(hours=8))`，用 `astimezone(BJT)` 转换
- 日期分组（`month_key`、`date`）也需基于北京时间，否则日期归属会错位
  - 例如 UTC 00:34 在 BJT 是 08:34 同一天，但若按 UTC 分组会归到前一日
- 使用 pandas 时：`pd.to_datetime(col, utc=True).dt.tz_convert('Asia/Shanghai')`
- 底部 footer 的生成时间也要用 `datetime.now(BJT)`

### 展开/收起的交互模式
- **不要用 onclick 里直接操作 style.display**，容易陷入 DOM 兄弟关系混乱
- 推荐方案：用 CSS class + `classList.toggle()` 控制
  - `.content-full` 默认 `display: none`
  - `.card-content.expanded .content-preview` → `display: none`
  - `.card-content.expanded .content-full` → `display: block`
  - onclick 只需要一行：`this.parentElement.classList.toggle('expanded')` + 切换按钮文字

### 执行环境
- `pandas` 在 Hermes sandbox 的 `execute_code` 中不可用（独立 Python 环境）
- 必须用 `terminal('python3 ...')` 执行，或写入 `.py` 文件后用 `terminal` 运行
- 推荐做法：写入 `~/output/lifeline/gen_lifeline.py`，用 `terminal` 执行
- **⚠️ 注意 python 路径**：Hermes venv 的 `python3` (at `~/hermes/hermes-agent/venv/bin/python3`) **没有 pandas**。
  - 系统自带 Python（`/usr/bin/python3.10`）安装了 pandas，需要用完整路径调用：
    ```
    /usr/bin/python3.10 ~/output/lifeline/gen_lifeline.py
    ```
  - 如果不确定，先用 `which python3 && python3 -c "import pandas; print('ok')"` 测试当前 python 是否有 pandas

## 数据源
| 文件 | 路径 | 用途 |
|------|------|------|
| 备忘录 | `~/aide/my_memos.csv` | 主要数据源，按 `created_at` 排序 |
| 通讯录 | `~/aide/my_contacts.csv` | 联系人 `id` → 真实姓名映射 |
| 输出 | `~/output/lifeline/index.html` | 生成的时间线页面 |
| 脚本 | `~/output/lifeline/gen_lifeline.py` | 可复用的生成脚本 |

## 执行流程

### 1. 数据分析
先摸清数据底牌：
- 备忘录总数、日期范围、分类分布
- 有关联联系人的条数
- 通讯录的 id→name 映射是否完整
- 检查 `related_contacts` 字段是否能成功 JSON parse

### 2. HTML 结构设计
采用"纵向时间轴"布局：

**为什么选 CSV？**

因为它是人类可读、机器可解析、Excel 可打开、Python 可处理的最佳格式。没有数据库，没有 API，没有 Docker——就是一个文件夹加三张表。简单到极致，反而最可靠。

《孙子兵法》说：「凡战者，以正合，以奇胜。」数据架构也是如此——正兵就是 CSV，奇兵才是那些花哨的数据库。对于个人数据管理，CSV 足够。

---

## 第四步：实际运行效果——以读书笔记为例

光说不练假把式。艾迪跑了一段时间之后，备忘录里积累了一些读书笔记。我挑几条读书相关的记录给你看看实际效果：

**记录一：读毛泽东传有感**
> 去往常州的高铁上读完毛泽东传第一卷，教员是神，是真正的大救星。岁数越大，越崇拜伟人！
> 标签：读书、毛泽东传、感悟

**记录二：毛泽东论领导——摘抄**
> 毛主席中共七大结论中的名言：
> "坐在指挥台上，如果什么也看不见，就不能叫领导。坐在指挥台上，只看见地平线上已经出现的大量的普遍的东西，那是平平常常的，也不能算领导。只有当着还没有出现大量的明显的东西的时候，当桅杆顶刚刚露出的时候，就能看出这是要发展成为大量的普遍的东西，并能掌握住它，这才叫领导。"
>
> 感想：抗战爆发以来短短几个月，毛泽东显示了对未来事态的发展总比别人先见一着，对各种错综复杂的新问题都能及时提出明确而切合实际的对策，表现出卓越的领导才能。——这就是领导！
> 标签：读书、毛泽东传、摘抄、领导力

**记录三：读《论持久战》有感——黑暗中的灯塔**
> "《论持久战》给苦难中彷徨无计的中国人点亮了一盏明灯，给抗战的军民以信心，它让大家看到了一条道路，甚至是通向胜利的道路。教员不但指出了胜利最终属于我们，还给出了我们要采取的战略，笼罩在头顶的黑暗被照亮了。"
> ——《毛泽东传》阅读随感
> 标签：读书、毛泽东传、论持久战、感悟

**记录四：向着最坏作准备，争取最好的可能性**
> "向着最坏的一种可能性作准备是完全必要的，但这不是抛弃好的可能性，而正是为着争取好的可能性并使之变为现实性的一个条件。"
> ——《毛泽东传》阅读摘抄
> 标签：读书、毛泽东传、摘抄、辩证法、战略思维

这些笔记在艾迪系统里是怎么运作的？

1. **你说**："记一下，在高铁上读完了毛泽东传第一卷，感触很深。"
2. **艾迪判断**：这是 `note` 类型（普通备忘），自动提炼标题"读毛泽东传有感"。
3. **自动打标签**：从内容中提取关键词 → `读书,毛泽东传,感悟`。
4. **写入 CSV**：追加一行到 `my_memos.csv`，自动生成 ID 和时间戳。
5. **时间线更新**：下次生成人生时间线时，这条记录会出现在对应的月份卡片里。

整个过程你只需要说一句话。

---

## 第五步：手把手——你自己怎么搭

从零开始，梳理一条清晰的操作链路。

> 前提：你已有一台运行 Linux 的 VPS，且已安装 Hermes Agent。若未安装，可执行官方一键脚本：
> ```bash
> curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash
> source ~/.bashrc
> ```

---

### 第1步：创建专属 Profile

```bash
hermes profile create aide