mu-zi-lee/Tangentry

选用指南

AI 根据 README 整理 · 2026/10/18 00:36:10

适用场景

适合需要将 B站、YouTube、小红书、抖音、小宇宙播客、RSS 和网页文章集中在一个阅读器中阅读、做笔记和管理的用户。

查看 README 依据

<div align="center"> <img src="src/web/public/favicon.svg" width="88" alt="Tangentry logo" /> # Tangentry **沿着好奇心继续发现 —— 本地优先的多平台内容聚合、阅读与笔记工具** 把 B站、YouTube、小红书、抖音、小宇宙播客、RSS 与网页文章收进同一个阅读器里： 看视频时读字幕、截帧做笔记、一键转录与翻译，所有数据都留在你自己的电脑上。 [](LICENSE)   

使用方式

提供桌面应用（macOS/Windows/Linux）和 Docker 自托管两种方式，桌面版通过安装包运行，Docker 版通过浏览器访问。

查看 README 依据

| 🖥️ **多端运行** | 原生桌面应用（macOS / Windows / Linux）或 Docker 自托管（NAS、家庭服务器），浏览器访问 | ## 🚀 快速开始 ### 方式一：桌面应用（推荐普通用户） 前往 [Releases](https://github.com/mu-zi-lee/Tangentry/releases) 下载对应平台的安装包。发布流程只在推送 `v*` tag（例如 `v0.0.1`）时运行：它会编译桌面包、运行验证并构建 Docker 镜像。 | 平台 | 说明 | | --- | --- | | macOS（Apple Silicon） | 打开 `.dmg` 拖入“应用程序”。若提示“无法验证开发者”，右键 → 打开 | | Windows（x64 / ARM64） | 下载 ZIP 并解压后运行 `Tangentry.exe`。未签名版本会触发 SmartScreen，点击“更多信息 → 仍要运行” | | Linux（x64 / ARM64） | 安装 `.deb`，依赖 `ffmpeg` 与 `libgomp1` 会自动安装 | 桌面版自带运行时；**yt-dlp、Deno 与 Whisper 模型会在首次使用时自动下载并校验**，无需手动安装。 ### 方式二：Docker 自托管 ```bash

部署要求

桌面版自带运行时，首次使用时会自动下载 yt-dlp、Deno 和 Whisper 模型；Docker 自托管需要 Docker 环境；从源码运行需要 Go 1.27+ 和 Node.js 24+。

查看 README 依据

| 🖥️ **多端运行** | 原生桌面应用（macOS / Windows / Linux）或 Docker 自托管（NAS、家庭服务器），浏览器访问 | ## 🚀 快速开始 ### 方式一：桌面应用（推荐普通用户） 前往 [Releases](https://github.com/mu-zi-lee/Tangentry/releases) 下载对应平台的安装包。发布流程只在推送 `v*` tag（例如 `v0.0.1`）时运行：它会编译桌面包、运行验证并构建 Docker 镜像。 | 平台 | 说明 | | --- | --- | | macOS（Apple Silicon） | 打开 `.dmg` 拖入“应用程序”。若提示“无法验证开发者”，右键 → 打开 | | Windows（x64 / ARM64） | 下载 ZIP 并解压后运行 `Tangentry.exe`。未签名版本会触发 SmartScreen，点击“更多信息 → 仍要运行” | | Linux（x64 / ARM64） | 安装 `.deb`，依赖 `ffmpeg` 与 `libgomp1` 会自动安装 | 桌面版自带运行时；**yt-dlp、Deno 与 Whisper 模型会在首次使用时自动下载并校验**，无需手动安装。 ### 方式二：Docker 自托管 ```bash

docker compose logs tangentry | grep password ``` 浏览器打开 <http://localhost:7380>，输入密码即可使用。也可以通过环境变量 `TANGENTRY_PASSWORD` 指定自己的密码。 > [!WARNING] > 服务端模式只有一个共享密码。**暴露到公网前务必在前面加 HTTPS 反向代理**（Caddy / Nginx / Traefik）。 ### 方式三：从源码运行 需要 Go 1.27+、Node.js 24+，以及（可选）`yt-dlp`、`ffmpeg`。 ```bash git clone https://github.com/mu-zi-lee/Tangentry.git cd Tangentry make server # 构建前端 + 服务端二进制 ./build/tangentry-server -data ./data -addr 127.0.0.1:7380 ``` ## 🧭 使用指南 > 第一次使用建议按 **设置 → 添加内容 → 阅读 → 笔记** 的顺序走一遍。 ### 1. 初始设置（左侧导航「设置」）

已知限制

项目处于 0.x 早期阶段，接口和数据结构可能变化；平台接口经常变化可能导致视频解析或下载失败；本机转录速度取决于 CPU/GPU 和模型大小。

查看 README 依据

 [功能](#-功能) · [快速开始](#-快速开始) · [使用指南](#-使用指南) · [配置](#%EF%B8%8F-配置) · [开发](#-开发) · [架构](docs/ARCHITECTURE.md) · [贡献](CONTRIBUTING.md) </div> --- > [!NOTE] > Tangentry 是个人项目，目前处于 **0.x 早期阶段**，接口和数据结构仍可能变化（数据库会自动迁移）。欢迎试用并反馈问题。 https://github.com/user-attachments/assets/79f4a123-2de2-429f-b302-0f1ad761ce26 <p align="center"> <img src="docs/images/discovery.jpg" alt="Tangentry" width="100%" /> </p> ## 📖 目录 - [为什么做 Tangentry](#-为什么做-tangentry) - [截图](#-截图) - [功能](#-功能) - [快速开始](#-快速开始) - [使用指南](#-使用指南)

平台接口经常变化。先在「设置 → 工具」更新 yt-dlp；B站高清晰度和部分内容需要登录。 </details> <details> <summary><b>转录很慢？</b></summary> 本机转录速度取决于 CPU / GPU 与模型大小。可以换更小的模型，或在设置中改用云端转录（Groq 等免费额度通常足够个人使用）。 </details> <details> <summary><b>macOS 提示“已损坏，无法打开”？</b></summary> 未经公证的构建会被 Gatekeeper 拦截，可执行：`xattr -dr com.apple.quarantine /Applications/Tangentry.app` </details> <details> <summary><b>如何迁移到另一台电脑？</b></summary> 关闭应用后复制整个 [数据目录](#%EF%B8%8F-配置) 到新机器对应位置即可。 </details> ## 🗺 路线图 - [ ] 发布签名并公证的 macOS / Windows 安装包 - [ ] 英文界面（i18n） - [ ] 更多平台适配 - [ ] 笔记双向同步到 Obsidian / Logseq