douyin-favorites-to-knowledge

把你授权的抖音收藏同步到本地 Markdown 或 Obsidian 知识库，支持首次设置、增量同步、登录恢复和 JSON 导入，方便做笔记和后续分析。用在想把收藏内容长期保存、做检索或接入本地转录/模型分析时。流程以用户交互登录为前提，不绕过登录或访问他人账号，注重隐私与可审计。

# 抖音收藏转本地知识库

优先使用单入口流程。不要先向用户解释 schema、模式、provider 或 adapter。

## 首次使用

确认仓库已经安装后运行：

```bash
douyin-favorites-knowledge setup
```

让用户选择 Markdown 或 Obsidian 知识库目录。`setup` 生成默认轻量配置并打开抖音官方页面登录。不要要求用户复制 Cookie。

如果 Agent 在非交互环境执行，明确指定目录：

```bash
douyin-favorites-knowledge setup --knowledge-dir "用户确认的目录" --skip-login
```

随后让用户在自己的终端运行 `douyin-favorites-knowledge login` 完成网页登录。不要替用户猜测知识库目录。

## 日常同步

```bash
douyin-favorites-knowledge sync
```

`sync` 展示新增收藏并等待用户确认，然后完成审核、批准和原子入库。用户取消时不写知识库或账本。

只有用户明确要求无人值守自动同步时，才使用：

```bash
douyin-favorites-knowledge sync --yes --no-login-prompt
```

`--yes` 是批准全部新增的显式授权。不要私自创建 cron 或系统定时任务。

## 故障处理

先运行：

```bash
douyin-favorites-knowledge check-config
d