AI Curator

by 钟思成
5
4
3
2
1
Score: 50/100

Description

Reviews

No reviews yet.

Stats

0
stars
22
downloads
0
forks
5
days
5
days
5
days
0
total PRs
0
open PRs
0
closed PRs
0
merged PRs
0
total issues
0
open issues
0
closed issues
5
commits

Latest Version

6 days ago

Changelog

AI Curator 1.0.0

Save anything. Read what matters. / 收藏一切,只读值得读的。

AI Curator turns Markdown clippings and bookmarks into a reading inbox, with Read / Skim / Reference / Skip decisions and actionable notes. Your original notes stay untouched.

AI Curator 把 Markdown 文章收藏与书签变成阅读收件箱:判断精读、速览、备查或跳过,并生成可执行的整理笔记,原文不改动。

What's new / 本次发布

  • English and Simplified Chinese interfaces, independently selectable from note output language. 中英文界面,界面与笔记输出语言独立设置。
  • Reliable parallel processing: unique filenames, shared analysis for duplicate saves, and full output-budget reservations. 修复并发同名覆盖、重复分析与预算预留。
  • Correct monthly rollover and visible budget limits; pause/delete checks before starting new paid work. 跨月预算正常重置,预算提示保留,付费请求前检查暂停与删除状态。
  • Serialized index snapshots with temporary/backup recovery and clear storage-failure notices. 串行索引写入、临时与备份恢复,以及存储失败提示。
  • Explicit X expansion opt-in, setup disclosure for full-text recovery, credential redaction and HTTPS for remote endpoints. X 补全明确主动选择,向导披露网络行为,密钥脱敏,远程接口要求 HTTPS。
  • Folder rename/delete handling and on-demand curation without watched folders. 处理文件夹重命名与删除,无监听目录时也可手动整理单篇。
  • Bilingual documentation, maintainer/AI instructions, automated CI and verified install assets. 双语文档、维护与 AI 指南、自动化 CI 和校验过的安装附件。

Install / 安装

Requires Obsidian 1.11.4+. Download ai-curator-1.0.0.zip and extract its ai-curator folder into <vault>/.obsidian/plugins/, reload Obsidian and enable AI Curator. Alternatively add MartinZhong2026/Obsidian-AI-Curator in BRAT.

需要 Obsidian 1.11.4+。下载 ZIP,将其中 ai-curator 文件夹解压到仓库的 .obsidian/plugins/,重新加载并启用。也可用 BRAT 安装。

The three plugin files are also attached separately. SHA256SUMS.txt covers those files and the ZIP. This project is not yet listed in Obsidian's community directory. 同时提供单独三件套与 SHA-256 校验文件。目前尚未进入 Obsidian 社区插件目录。

Verification and limits / 验证与限制

  • 68 automated tests, TypeScript checks, production build, dependency audit, ZIP and SHA-256 verification. 68 项自动化测试、类型检查、生产构建、依赖审计、ZIP 与哈希校验。
  • Real DeepSeek demo runs use only synthetic sample notes; see docs/VERIFICATION-1.0.0.md for actual results. 真实 DeepSeek 演示仅使用虚构样例,实际结果见对应验证记录。
  • Fresh native desktop/theme and iOS/Android device checks were unavailable for this release. Try a test vault first. 本轮未能完成桌面主题与移动真机检查,建议先用测试仓库。
  • Budget controls are estimates, not billing guarantees. Configure prices for unpriced models and use provider-side limits if needed. 预算仅为估算,未知模型需配置价格;严格控费请同时使用服务商限额。
  • Fully offline use requires a local model and both web recovery options disabled. HTTP endpoints are restricted to loopback. 完全离线需本地模型并关闭两项网络补全;HTTP 仅限回环地址。

English guide · 中文说明

README file from

Github

AI Curator for Obsidian

Save anything. Read what matters.

简体中文 · Download 1.0.0 · Feedback

Turn saved articles and bookmarks into a reading inbox you can actually use. AI Curator reads Markdown in folders you choose, recommends Read / Skim / Reference / Skip, and writes concise notes with ideas, caveats and next actions.

Reading inbox with English controls and Chinese notes

Demo screenshot from the earlier beta. Version 1.0.0 also includes a Simplified Chinese interface.

  • Decide what deserves your time. A verdict, reason and locally computed score.
  • Keep useful knowledge. TL;DR, key ideas, practical steps and action checkboxes in English or Chinese.
  • Read in one place. Search, topic filters, read/archive controls, a Bases list and weekly digests.
  • Connect notes locally. Related links use shared topics, tags and tools without another AI call.
  • Keep your workflow. Web Clipper, X bookmark tools and other Markdown exporters; no Python or background service.
  • Keep your originals. Sources are never changed. Your writing below the marker in curated notes survives regeneration.

Install

Requires Obsidian 1.11.4+. Distributed through GitHub and BRAT; not yet listed in Obsidian's community directory.

  1. Download ai-curator-1.0.0.zip from the release.
  2. Extract into <vault>/.obsidian/plugins/. You should get:
    .obsidian/plugins/ai-curator/
    ├── main.js
    ├── manifest.json
    └── styles.css
    
  3. Reload Obsidian and enable AI Curator in Settings → Community plugins.

The release includes separate plugin files and SHA256SUMS.txt. Keep your usual vault backup.

BRAT alternative: install BRAT from Obsidian's community plugins, run Add a beta plugin for testing, enter MartinZhong2026/Obsidian-AI-Curator, and enable AI Curator. That BRAT command can install this stable release too.

First two minutes

  1. Choose source folders such as Clippings or your X bookmark folder. Existing notes wait for approval.
  2. Connect a provider. DeepSeek is preselected; paste your own key and use Test, or choose another provider.
  3. Choose languages and interests. The interface follows Obsidian by default. Interface language offers English and 简体中文; the note output language is independent. Your optional profile helps assess relevance.
  4. Review network options. Full-text recovery is on by default and contacts the original website. X expansion uses third-party FxTwitter and is off until you enable it.
  5. Choose the backlog: newest 10, all existing saves, or new saves only.

Open the ✦ ribbon icon for the inbox. New saves settle before processing, usually within a minute while Obsidian is open. Turning off automatic curation leaves Process queue now available.

Notes and verdicts

Notes include a verdict and reason, TL;DR, summary, key ideas, how-to steps, caveats, actions, mentioned tools and related notes, with a link back to the saved source. See English examples and Chinese examples: real model outputs on synthetic demo material. Results vary between runs.

Scores use relevance (30%), depth (20%), actionability (20%), evidence (15%) and originality (15%). Popularity metrics do not affect scores. Incomplete saves are labeled and capped at 55/100. AI judgments can be wrong; check the original when accuracy matters.

AI Curator/
├── Notes/             curated Markdown: verdict, score, topic, tags, status
├── Digests/           reading digests, created on request
└── Reading list.base  Read next, Unread, All curated and Reference views

Providers and spending

Provider Setup
DeepSeek Default; bring your API key
Anthropic Claude Official SDK; key and an available model
OpenAI, Gemini, OpenRouter Key and model name; use Load models
Ollama, LM Studio A running local server and model
Custom OpenAI-compatible /chat/completions endpoint

Remote endpoints require HTTPS. HTTP is allowed only on localhost, 127.0.0.1 and [::1], even for local presets. On mobile, localhost means the phone; a desktop model needs a reachable HTTPS endpoint.

Default limits: US$3 estimated monthly budget, 100 items/day. Concurrent calls reserve the requested output allowance; duplicate saves share an analysis. Costs depend on tokens and provider prices. For models without a built-in price, enter input/output prices for meaningful budget tracking.

This is not a hard billing cap. Unknown prices, billed failures, tokenization differences and provider price changes affect actual charges. Set a provider-side spending limit when needed. Connection tests are not included in the curation counter.

Fully offline use requires a local model and both full-text recovery and X expansion disabled.

Privacy and control

  • Only chosen folders and notes you explicitly curate are analyzed. Output is excluded.
  • The selected AI provider receives note text and metadata, optional profile, and existing topic/tag names; text may include recovered web content.
  • Keys use Obsidian SecretStorage. Settings keep a secret identifier; provider errors redact the configured key.
  • Queue state and analysis results stay in plugin storage, with recovery copies. Originals are never changed.
  • No telemetry, analytics or AI Curator account. A one-time optional star invitation only opens GitHub when clicked.
  • Saved content is untrusted data. Model output is validated; its instructions are never executed.

See the complete privacy and network disclosure.

Commands

Open reading inbox · Process queue now · Pause or resume automatic curation · Curate the current note · Create weekly reading digest · Refresh related links in curated notes · Retry failed items · Open setup guide

Digests and related-link refreshes do not call AI. Single-note curation works outside watched folders. Reload after switching interface language to update command names.

Troubleshooting and limits

  • Nothing happens: inspect Queue, key/model, pause state and limits; new files wait a few seconds.
  • 401/402/403: fix the key, balance or access, then resume. Temporary errors back off.
  • No content: image-only notes are skipped. Enable recovery for teasers and curate again.
  • Changed source: re-curate from the menu. A sync tool completing a teaser can trigger reanalysis.
  • Write failure: check disk space and permissions. Refresh curated notes retries writing analyzed items without another AI call.
  • Obsidian must remain open. Images, PDFs and videos are not analyzed.
  • Related links use local heuristics; no cross-article AI synthesis.
  • Desktop/mobile APIs are targeted. Fresh native desktop/theme and iOS/Android device checks were unavailable for 1.0.0; try a test vault first.

Contribute

English and Chinese contributions are welcome. Read CONTRIBUTING.md and AGENTS.md.

npm ci
npm test             # unit, engine, persistence and bilingual tests; Node 24+
npm run build        # type check and browser-compatible production bundle
npm run package      # build, tests, ZIP and SHA-256 verification
npm audit
npm run demo:install # install into the synthetic demo vault

The optional real API demo in RELEASING.md uses your key and incurs charges. Changelog · MIT license.