收件箱 AI 初筛

为 Obsidian 收件箱中的新笔记生成结构化 AI 初筛建议，帮助判断内容应进入 项目、领域、经验卡片、资料仓库，还是归档。AI 只给建议，分类只有在用户勾选 确认后才会真正移动文件。

本项目由小楼开发。它可以处理 Share to Save、短视频收件箱桥接或任意其他 工具写入的 Markdown 笔记；这些上游工具不包含在本仓库中。

功能

• 监听指定收件箱目录直属的新建或更新 Markdown 笔记。
• 等待上游采集工具完成写入后再调用模型。
• 提炼核心判断、因果机制、适用场景、触发信号、证据和行动建议。
• 在原笔记中写入可审阅、可重复识别的 AI 建议区块。
• 仅在用户勾选“我已确认这个分类”后移动文件。
• 对适合沉淀的内容生成独立经验卡片。
• 支持自定义收件箱、整理目标、归档和经验卡片目录。
• 通过 ai_processed 防止已完成笔记因后续修改而重复调用模型。

工作方式

flowchart LR
    A["新建或更新收件箱笔记"] --> B["等待上游写入稳定"]
    B --> C["调用配置的 AI API"]
    C --> D["写入初筛建议"]
    D --> E{"用户确认？"}
    E -- "否" --> D
    E -- "是" --> F["移动原文或生成经验卡片"]

安装

从 Release 安装

从最新 Release 下载 main.js 和 manifest.json，放入：

<你的 Vault>/.obsidian/plugins/inbox-ai-processor/

然后在 Obsidian 的“第三方插件”设置中启用“收件箱 AI 初筛”。

从源码安装

git clone https://github.com/TC-TCQKJJ/obsidian-inbox-ai-processor.git
cd obsidian-inbox-ai-processor
npm ci
npm run check
npm run build

把生成的 main.js 和 manifest.json 复制到上述插件目录。

设置

1. 填写 DeepSeek API Key。
2. 按自己的 Vault 结构设置收件箱、整理目标、归档和经验卡片目录。
3. 根据上游采集工具的写入速度设置等待秒数。
4. 开启自动处理，或运行命令“AI 初筛当前收件箱笔记”。

默认 API 地址为 https://api.deepseek.com/chat/completions，默认模型为 deepseek-v4-flash。API 地址和模型都可以在设置中修改。

与短视频收件箱桥接 配合时，视频笔记会先创建占位内容，再写入完整转录。插件同时监听创建和修改 事件，因此会在最终转录写入后安排初筛。

隐私与网络披露

• 插件不含遥测、广告或用户追踪。
• 插件只读取所配置收件箱目录直属的 Markdown 文件。
• 为生成建议，笔记正文和提示词会发送到设置中的 API URL。
• API Key 只保存在当前 Vault 的插件配置 data.json 中，不会写入笔记。
• 分类确认后，插件会按配置创建或移动 Markdown 文件。
• 使用第三方 AI 服务前，请确认笔记内容适合发送，并阅读该服务的隐私政策。

更多安全说明见 SECURITY.md。

开发与发布

npm ci
npm run check
npm run build

仓库当前没有自动化单元测试套件；CI 会执行语法检查和生产构建。发布标签必须 与 manifest.json、package.json 中的版本一致，Release 会附带构建证明。

License

MIT