Obsidian Inbox Pipeline

将任意来源（AI 资讯、经济雷达、旅游日报、RSS、文章）自动采集、 结构化写入 Obsidian inbox 的完整流水线。支持 Telegram / 飞书推送 和 cron 定时执行。一套配置，永久自动沉淀知识。

Security Scan

功能与代码整体一致，但 registry 元数据 声明与实际运行时需求不符（未列出必需的环境变量/凭证），脚本会执行同一工作区中其他 skill 脚本并可向外部服务（Telegram / 飞书）发送内容 — 在信任代码和提供凭证前请谨慎审查并在隔离环境中测试。

Purpose & Capability

Skill 名称/描述（将外部信息采集并写入 Obsidian inbox，支持 Telegram/飞书/cron）与包含的脚本（capture.py, query.py, review.py, scripts/daily_pipeline.sh）在功能上匹配。但 registry metadata 声明“未要求环境变量/凭证”，与 SKILL.md 和代码中明确需要的 OBSIDIAN_VAULT_PATH、TELEGRAM_BOT_TOKEN、TELEGRAM_CHAT_ID、FEISHU_APP_ID/FEISHU_APP_SECRET 等不一致。缺少这类声明会降低可见性，应被视为不一致而非功能性错误。

Instruction Scope

SKILL.md 与脚本指引范围总体与描述一致（写入 vault、重建索引、搜索、生成报告、可选推送）。需要注意：scripts/daily_pipeline.sh 会尝试执行工作区外的其他 skill 脚本（SKILL_DIR/../${RADAR_TYPE}/main.py 或 format_push.py）并读取其输出，这等于在运行时执行任意来自同一工作区的代码；脚本也会与外部网络交互（Telegram 与飞书 API）。指令未要求读取用户 shell history 或系统凭据之外的文件，但会按提供的 vault 路径读写文件系统。

Install Mechanism

无安装 spec（instruction-only + 内含脚本文件）。没有远程下载或解压步骤，源码包含在 skill 包内 — 这降低了通过 install 阶段引入未知二进制的风险。

Credentials

代码和 SKILL.md 期望多个环境变量（OBSIDIAN_VAULT_PATH 必需；TELEGRAM_*、FEISHU_* 为可选但用于推送）。Registry metadata 列为“无所需环境变量”，这是不一致且具潜在危险性的遗漏。这些变量包含敏感凭证（bot token / app secret）；在不信任来源的情况下不应放入共享或版本控制的 .env。

Persistence & Privilege

Skill 没有设置 always:true，也不试图修改其他 skills 的配置或系统范围设置。唯一需要注意的行为是 daily_pipeline.sh 会 invoke（执行）其他 skill 的 main.py/format_push.py，如果这些文件存在则会被执行 — 这是功能上的集成点但扩大了执行面。

What to consider before installing

要点与建议： - 代码功能与描述一致，但 registry metadata 没有列出实际需要的环境变量/凭证（OBSIDIAN_VAULT_PATH、TELEGRAM_*/FEISHU_*），这是一个可见性/治理问题。 - 在提供任何令牌/密钥前，手动审查 capture.py、daily_pipeline.sh、scripts 中的内联 Python 推送逻辑，确认推送目标（仅 Telegram / 飞书）与用途一致。 - daily_pipeline.sh 会尝试执行相对路径 ../<radar_type>/main.py 或 format_push.py；如果工作区内存在这类脚本，它们将被运行。只在你信任这些其他 skill 的情况下允许定时运行。否则先在隔离环境或使用 --dry-run 测试。 - 不要把凭证提交到版本控制；把 .env 加入 .gitignore（SKILL.md 已提醒）。优先通过临时/限定权限的 bot/app 凭证进行测试，避免使用长期高权限密钥。 - 首次运行时：以 dry-run 模式或在含测试 vault 的容器中运行，确认文件写入路径正确并监控网络请求（比如通过防火墙/代理或查看 /tmp 中的中间文件）。 - 若你依赖第三方 radar skills，一并审查这些 radar 的 main/format_push 实现，因为 pipeline 将执行它们并可能扩大信任边界。

打通外部信息源与 Obsidian 知识库的自动化流水线。安装后配置好环境变量，即可持续将资讯日报、文章、帖子等结构化沉淀到 Obsidian，无需手动整理。

核心脚本

脚本	功能	关键参数
capture.py	写入单条笔记到 inbox	--type, --title, --source, --tags, --content
query.py	搜索知识库（index + 正文）	--query, --type, --tags, --limit
review.py	生成 inbox 整理报告	--dry-run（预览）
scripts/daily_pipeline.sh	三合一流水线参考	radar 类型、名称、分类、来源

快速开始

1. 安装依赖

# 克隆 skill 到本地
clawhub install obsidian-inbox-pipeline

# 复制环境变量模板
cp references/.env.example .env
# 编辑 .env，填入真实路径和凭证

2. 配置环境变量

# .env 文件示例
OBSIDIAN_VAULT_PATH=/Users/you/obsidian/MyKnowledge
OBSIDIAN_INBOX_DIR=inbox
TELEGRAM_BOT_TOKEN=123456:ABC-xxx
TELEGRAM_CHAT_ID=987654321
FEISHU_APP_ID=cli_xxx
FEISHU_APP_SECRET=xxx

⚠️ 安全提醒：.env 文件请加入 .gitignore，不要提交到公开仓库。脚本从不硬编码任何凭证。

3. 写入一条笔记（测试）

export OBSIDIAN_VAULT_PATH=/path/to/vault

python3 capture.py \
  --type capture \
  --title "测试笔记" \
  --source "手动测试" \
  --tags "[测试]" \
  --content "这是正文内容，可以是任何文本..."

4. 搜索知识库

export OBSIDIAN_VAULT_PATH=/path/to/vault

# 搜索标题和摘要
python3 query.py --query "OpenClaw" --limit 5

# 只看 knowledge 类型
python3 query.py --query "AI Agent" --type knowledge --limit 5

# 搜索正文内容（需要 obsidian-cli）
python3 query.py --query "OpenClaw" --include-content

5. 生成 Inbox 整理报告

export OBSIDIAN_VAULT_PATH=/path/to/vault

# 预览（不写文件）
python3 review.py --dry-run

# 正式生成（写入 notes/_review/inbox-review-YYYY-MM-DD.md）
python3 review.py

6. 定时自动运行（cron）

# 每天 7:00 自动跑（来源和 cron 触发自行配置）
0 7 * * * cd /path/to/skill && \
  OBSIDIAN_VAULT_PATH=/path/to/vault \
  TELEGRAM_BOT_TOKEN=xxx \
  TELEGRAM_CHAT_ID=xxx \
  bash scripts/daily_pipeline.sh "ai-radar" "AI 资讯雷达" "AI" "🤖" "AI 资讯" \
  >> /var/log/obsidian_pipeline.log 2>&1

流水线架构

外部来源（RSS / API / 爬虫 / 手动）
         │
         ▼
┌─────────────────────┐
│   生成原始 Markdown  │
│   (日报/文章/帖子)    │
└────────┬────────────┘
         │
         ▼
┌─────────────────────┐
│     capture.py      │◄── 写入 Obsidian inbox
│  (结构化模板写入)     │    （type / tags / source / TL;DR）
└────────┬────────────┘
         │
         ▼
┌─────────────────────┐
│  rebuild_index.mjs  │◄── 重建 .ai/index.json
│  (Obsidian 官方脚本)  │    （支持 query.py 搜索）
└────────┬────────────┘
         │
         ▼
┌─────────────────────┐
│  query.py / review  │◄── 知识库检索 / inbox 整理
│                     │
└─────────────────────┘

可选通知渠道（均走环境变量，不硬编码）：
  ├── Telegram Bot（需 TELEGRAM_BOT_TOKEN）
  └── 飞书自建应用（需 FEISHU_APP_ID / FEISHU_APP_SECRET）

frontmatter 标准格式

写入的每条笔记使用统一 frontmatter，便于后续检索和分类：

---
type: capture           # capture | daily-report | knowledge
created: 2026-03-21     # 自动时间戳
tags: [AI, 日报]        # 自定义标签
source: AI 资讯雷达     # 来源
status: inbox           # inbox → knowledge → _archive
---

配合 AI 雷达使用

配合 ai-radar、economy-radar、travel-radar 等 skill 使用时：

# 三合一每日自动运行（配合 cron）
0 7 * * * \
  source /path/to/.env && \
  bash /path/to/obsidian-inbox-pipeline/scripts/daily_pipeline.sh \
    "ai-radar" "AI 资讯雷达" "AI" "🤖" "AI 资讯" && \
  bash /path/to/obsidian-inbox-pipeline/scripts/daily_pipeline.sh \
    "economy-radar" "经济雷达" "经济" "📊" "经济资讯" && \
  bash /path/to/obsidian-inbox-pipeline/scripts/daily_pipeline.sh \
    "travel-radar" "旅游雷达" "旅游" "✈️" "旅游资讯"

故障排查

问题	解决方案
OBSIDIAN_VAULT_PATH 报错	确保环境变量已设置，或安装 obsidian-cli
inbox 写入了但 query 搜不到	运行 node /path/to/vault/scripts/rebuild_index.mjs 重建索引
Telegram 推送失败	确认 Bot Token 和 Chat ID 正确，Bot 已被用户发起过对话
飞书推送失败	检查 app_id / app_secret 权限（需要发消息权限）

依赖

• Python ≥ 3.8
• obsidian-cli（可选，vault 路径自动发现）
• node（可选，索引重建脚本）
• Telegram Bot Token（可选，通知推送）
• 飞书自建应用凭证（可选，通知推送）