# config.yaml
media:
  provider: s3  # s3 | github | local
  
  # 凭证配置
  credentials:
    # 方式 1：环境变量（推荐）
    aws_access_key_env: AWS_ACCESS_KEY_ID
    aws_secret_key_env: AWS_SECRET_ACCESS_KEY
    # 方式 2：配置文件（不推荐，敏感信息）
    # aws_access_key: "AKIA..."
    # aws_secret_key: "..."
  
  s3:
    bucket: your-bucket
    region: us-east-1
    prefix: synapse/           # 存储前缀
    # 最终路径：s3://your-bucket/synapse/{resource_id}/{filename}
  
  github:
    repo: user/media
    branch: main
    token_env: GITHUB_TOKEN    # GitHub Personal Access Token
  
  local:
    path: ~/synapse-media      # 本地存储路径（.gitignore 隔离）
    base_url: file://~/synapse-media


### 8.5 TUI 集成（预留）

在编辑模式下：
- Ctrl+V`：检测剪贴板图片 → 自动调用 `syn media paste → 插入链接

---

## 9. 自动化工作流

### 9.1 本地自动化（优先）

对于生成类任务，优先使用**本地 Hook**，无需等待网络：


# 本地执行，立即生成并打开
syn review daily      # → 生成今日回顾，直接打开编辑
syn review weekly     # → 生成周报，直接打开编辑
syn review monthly    # → 生成月报，直接打开编辑
syn standup           # → 生成站会报告

# LLM 辅助生成（可选）
syn review daily --llm     # → 使用 LLM 生成摘要
syn review weekly --llm    # → 使用 LLM 生成周报
syn review monthly --llm   # → 使用 LLM 生成月报


#### 9.1.1 Review 资源类型与存储

Review 生成的资源是 note 类型，存储在配置的 review Area/Category 下：


personal/
└── 90/                    # Area 90: 回顾与复盘
    ├── 001/               # Category 001: 每日回顾
    │   ├── 90.001.0001-note-2024-01-15-daily-review.md
    │   └── 90.001.0002-note-2024-01-16-daily-review.md
    ├── 002/               # Category 002: 每周回顾
    │   └── 90.002.0001-note-2024-W03-weekly-review.md
    ├── 003/               # Category 003: 每月回顾
    │   └── 90.003.0001-note-2024-01-monthly-review.md
    └── 004/               # Category 004: 站会报告
        └── 90.004.0001-note-2024-01-15-standup.md


**Frontmatter 示例**：

---
jd_number: "90.001.0015"
type: note
namespace: personal
title: "2024-01-15 每日回顾"
tags: [review, daily]
created: 2024-01-15T18:00:00Z
modified: 2024-01-15T18:30:00Z
review_type: daily          # daily | weekly | monthly | standup
review_period: "2024-01-15"
llm_generated: false        # 是否使用 LLM 生成
---


**本地 Hook 配置**：

# config.yaml
hooks:
  review_daily:
    command: "python ~/.synapse/hooks/daily_review.py"
    auto_open: true   # 生成后自动打开编辑器
  review_weekly:
    command: "python ~/.synapse/hooks/weekly_review.py"
    auto_open: true
  review_monthly:
    command: "python ~/.synapse/hooks/monthly_review.py"
    auto_open: true
  standup:
    command: "python ~/.synapse/hooks/standup.py"
    auto_open: true

review:
  area: "90"              # Review 存储的 Area
  daily_category: "001"   # syn review daily
  weekly_category: "002"  # syn review weekly
  monthly_category: "003" # syn review monthly
  standup_category: "004" # syn standup
  llm:
    enabled: true
    prompt_template: "~/.synapse/prompts/review.md"


### 9.2 GitHub Actions 模板（远程）

用于**跨设备通知**和**长期归档**：

| 模板 | 触发 | 功能 |
|------|------|------|
| daily-standup | 工作日 9:00 | 昨日完成、今日计划、阻塞问题 |
| weekly-review | 周五 18:00 | 周报生成 |
| due-reminder | 每天 8:00 | 到期/逾期提醒 |
| inbox-reminder | 工作日 17:00 | Inbox 清理提醒 |
| monthly-retro | 每月 1 日 | 月度复盘归档 |
| graph-sync | push 触发 | 图谱同步 |

**设计理念**：
- **本地 Hook**：生成类（review, standup）→ 即时响应，无网络依赖
- **GitHub Actions**：通知类、归档类 → 跨设备、定时触发

---

## 10. 知识图谱（优先级低，预留设计）

> ⚠️ 本章节为预留设计，待后续迭代完善。初始版本不实现图谱功能。

### 10.1 预留接口


syn graph                    # 启动图谱视图（TUI）
syn graph export             # 导出图谱数据
syn graph sync               # 同步到 Nebula Graph（如配置）


### 10.2 数据模型（预留）

**节点类型**：Resource, Namespace, Tag, Person, TimePoint, Chunk

**边类型**：RELATED_TO, BELONGS_TO, CREATED_BY, ASSIGNED_TO, TAGGED_WITH, BLOCKED_BY 等

### 10.3 GraphRAG 集成（预留）

- 使用 Nebula Graph 存储知识图谱
- 支持 LLM 驱动的图谱查询和推理
- 自动发现资源间的隐含关系

---

## 11. 邮件集成（优先级低，预留设计）

> ⚠️ 本章节为预留设计，待后续迭代完善。初始版本仅支持手动创建邮件资源。

### 11.1 手动创建（初始版本支持）


syn new email --subject "项目进度汇报"


- 支持剪贴板粘贴邮件内容
- 自动解析标题和正文
- 发件人/收件人需手动填写

### 11.2 API 集成（预留）
 
 
Back to Top