# Obsidian Inbox Ingest

> 收集箱入库 · 往一个页面手动粘链接（文章 / YouTube / 抖音 / 小红书 / B站 / 书），自动抓原文或转写成文字，生成知识卡进知识库

- **Type:** Skill
- **Install:** `agentstack add skill-qianquandong-real-agent-workflows-obsidian-inbox-ingest`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [qianquandong](https://agentstack.voostack.com/s/qianquandong)
- **Installs:** 0
- **Category:** [AI & ML](https://agentstack.voostack.com/c/ai-and-ml)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [qianquandong](https://github.com/qianquandong)
- **Source:** https://github.com/qianquandong/real-agent-workflows/tree/main/obsidian-inbox-ingest
- **Website:** https://realagentusecases.com

## Install

```sh
agentstack add skill-qianquandong-real-agent-workflows-obsidian-inbox-ingest
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

你在用户的电脑上处理他的「收集箱」：一个 markdown 页面，用户白天往里粘链接，你负责把每条链接变成文字、入知识库。

> 使用前替换占位符：``、``（如 `收集箱.md`）、``（入库目标相对路径）、``（知识卡分类用，例如：AI / 健身 / 美食 / 内容创作 / 商业）。

## 收集箱页面的格式

`` 里有三个小节，用户只管往第一节粘：

```markdown
## 待处理
https://example.com/some-article
https://www.youtube.com/watch?v=xxxx // 重点看他讲定价的部分

## 已处理

## ⚠️ 处理失败
```

一行一个链接，行尾可选 `// 备注`（用户为什么存这条、想重点看什么）。

失败记录放在「⚠️ 处理失败」节，格式为 `❌ retry=1 日期 URL | 失败原因`。`retry=1` 表示下次自动再试一次；第二次仍失败就改成 `retry=2`，以后不再自动重试。

## 安全边界

- 下载视频或音频前，先为本次任务新建独立临时目录。只删除这个目录里由本次任务创建的文件，绝不按宽泛路径或通配符清理用户文件。
- 只关闭本次任务打开的浏览器标签页，不碰用户原本打开的页面。

## 步骤

读「## 待处理」区的每一行，以及「## ⚠️ 处理失败」里所有 `retry=1` 的记录，按链接类型处理：

1. **文章**：抓正文转 markdown（有 `defuddle` 用 `defuddle parse  --md`，没有就 WebFetch）。抓不到就标记失败，**绝不编造内容**。
2. **视频**（YouTube / 抖音 / B站）：`yt-dlp` 下载到本次任务的临时目录，再用 Whisper 转写成文字。下载被拦时的备选：浏览器打开页面取视频直链再下载。**处理结束后只删除本次任务临时目录里的视频/音频文件**——只留文字稿。
3. **小红书图文**：浏览器打开，读取文案、作者、高赞评论，逐图转录图内文字并各配一句画面描述。
4. **书**：链接抓不到全文很正常——抓到简介、目录、评价即可，知识卡的置信度标低，**别编造书的内容**。

每条转好后：

5. **生成知识卡**：按 `` 判定领域，写进 `//`，文件名 `YYYY-MM-DD_来源_标题.md`。正文四段：为什么收藏（有 `//` 备注就在这里回应它）/ 一句话摘要 / 原文或转写全文 / 候选结论（提得出就列 1-3 条，提不出留空）。入库前先搜库去重：已有同主题卡就更新旧卡，别新建。

6. **更新状态**：
   - 成功：从原小节删掉，写进「已处理」，格式 `✅ 日期 [标题](URL) → 知识卡文件名`。
   - 首次失败：从「待处理」挪进「⚠️ 处理失败」，格式 `❌ retry=1 日期 URL | 失败原因`，下次任务自动再试一次。
   - `retry=1` 再次失败：原地改成 `❌ retry=2 日期 URL | 最新失败原因`，以后不再自动重试，留给用户处理。
   - `retry=1` 重试成功：从失败节删除，写进「已处理」。

## 收尾

- 只关闭本次任务打开的浏览器标签页。
- 一句话汇报：本次入库 N 条、失败 M 条，失败的逐条列出原因。
- 铁律：有来源才写、一卡一个主结论、事实和推测分开、绝不编造。

## 怎么触发

两种都行：手动（粘完链接后对 agent 说一句「清收集箱」），或挂成每晚定时任务（作者的跑法：白天随手粘，晚上自动清空）。搭配「首页驾驶舱」用的话，收集箱和早报勾选是互补的两个入口：早报勾选收「推给你的」，收集箱收「你自己刷到的」。

## Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [qianquandong](https://github.com/qianquandong)
- **Source:** [qianquandong/real-agent-workflows](https://github.com/qianquandong/real-agent-workflows)
- **License:** MIT
- **Homepage:** https://realagentusecases.com

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/skill-qianquandong-real-agent-workflows-obsidian-inbox-ingest
- Seller: https://agentstack.voostack.com/s/qianquandong
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.