letterly-automation

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

Letterly Automation

Letterly 自动化处理

This skill provides a complete workflow for importing and processing your voice transcriptions from Letterly into your Obsidian vault.
本Skill提供了一套完整的工作流,可将你在Letterly中的语音转录内容导入并处理至Obsidian知识库中。

Workflow Summary

工作流概述

  1. Export: Uses a Playwright browser agent to log in and download the latest CSV export from
    web.letterly.app
    .
  2. Process: Extracts only notes marked as "magic" in the CSV, creates markdown files with custom frontmatter, and places them in
    unprocessed/
    .
  3. Link: Analyzes the new notes and links them to existing vault content using the local semantic embedding database (
    .nexus/cache.db
    ).
  4. Deliver: Moves the final, linked notes to
    My Outputs/Transcriptions/
    and cleans up the temporary CSV.
  1. 导出:使用Playwright浏览器Agent登录
    web.letterly.app
    并下载最新的CSV导出文件。
  2. 处理:从CSV中仅提取标记为“魔法”的笔记,创建带有自定义前置元数据的Markdown文件,并将其放入
    unprocessed/
    目录。
  3. 关联:分析新笔记,并通过本地语义嵌入数据库(
    .nexus/cache.db
    )将其与知识库中现有内容建立关联。
  4. 交付:将最终完成关联的笔记移动至
    My Outputs/Transcriptions/
    目录,并清理临时CSV文件。

Usage

使用方法

To trigger the full workflow, simply tell the model: "Process new Letterly transcriptions" or "Sync my Letterly magic notes".
要触发完整工作流,只需告知模型: “处理新的Letterly转录内容” 或 “同步我的Letterly魔法笔记”。

Manual Execution

手动执行

If you need to run it manually from the terminal:
bash
undefined
若需从终端手动运行:
bash
undefined

Setup (First time only)

Setup (First time only)

uv venv .venv --python 3.12 uv pip install -r scripts/requirements.txt .venv/bin/playwright install chromium
uv venv .venv --python 3.12 uv pip install -r scripts/requirements.txt .venv/bin/playwright install chromium

Run

Run

.venv/bin/python scripts/workflow.py
undefined
.venv/bin/python scripts/workflow.py
undefined

Troubleshooting

故障排除

  • Login Timeout: If the script times out waiting for login, ensure you have the browser window visible and log in within the 120-second window.
  • Database Missing: Ensure you are running this from your Obsidian vault root where
    .nexus/cache.db
    exists.
  • No Magic Notes: The script only imports notes that have been processed with the "Magic" rewrite type in Letterly.
  • 登录超时:如果脚本在等待登录时超时,请确保浏览器窗口可见,并在120秒内完成登录。
  • 数据库缺失:请确保你在Obsidian知识库根目录下运行该脚本,该目录下需存在
    .nexus/cache.db
    文件。
  • 无魔法笔记:脚本仅导入在Letterly中被标记为“魔法”重写类型的笔记。