letterly-automation
Compare original and translation side by side
🇺🇸
Original
English🇨🇳
Translation
ChineseLetterly 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
工作流概述
- Export: Uses a Playwright browser agent to log in and download the latest CSV export from .
web.letterly.app - Process: Extracts only notes marked as "magic" in the CSV, creates markdown files with custom frontmatter, and places them in .
unprocessed/ - Link: Analyzes the new notes and links them to existing vault content using the local semantic embedding database ().
.nexus/cache.db - Deliver: Moves the final, linked notes to and cleans up the temporary CSV.
My Outputs/Transcriptions/
- 导出:使用Playwright浏览器Agent登录并下载最新的CSV导出文件。
web.letterly.app - 处理:从CSV中仅提取标记为“魔法”的笔记,创建带有自定义前置元数据的Markdown文件,并将其放入目录。
unprocessed/ - 关联:分析新笔记,并通过本地语义嵌入数据库()将其与知识库中现有内容建立关联。
.nexus/cache.db - 交付:将最终完成关联的笔记移动至目录,并清理临时CSV文件。
My Outputs/Transcriptions/
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
undefinedSetup (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
undefinedTroubleshooting
故障排除
- 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 exists.
.nexus/cache.db - 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中被标记为“魔法”重写类型的笔记。