README file from
GithubBamboo Darts（竹叶飞刃）
AI 提炼原子笔记，过滤信息垃圾，把阅读转化为可检索的知识节点。
中文
什么是原子笔记？
原子笔记（Atomic Note）是 Obsidian 核心理念之一——每条笔记只记录一个知识点，短小精悍、独立可读、可复用。
本插件帮你把长文、网页、选中文本，用 AI 一键提炼成规范的原子笔记，自动去重后存入你的知识库。
功能特性
- ✅ 多种输入方式：支持 URL、选中文本、剪贴板三种输入
- ✅ 质量门控：自动检测内容长度、广告、重复内容
- ✅ AI 提炼：调用 DeepSeek API，提炼符合五条标准的原子笔记
- ✅ 同批去重：自动去除本次提炼中的重复笔记
- ✅ 知识库去重：与已有笔记比对，避免重复存储
- ✅ 灵活存储：自定义目标文件夹、文件名模板
原子笔记五条标准
- 一条笔记只说一件事 —— 聚焦单一知识点
- 独立可读 —— 不依赖上下文，单独看能懂
- 有信息密度 —— 不是定义，是有洞见的陈述
- 可行动或可引用 —— 要么是能用的方法，要么是能引用的观点/数据
- 用自己的话写 —— 不是原文复制，是经过理解后的表达
处理流程
插件采用六阶段流水线处理，从原始输入到最终保存，每一步都有质量把关：
| 阶段 | 名称 | 说明 |
|---|---|---|
| Phase 1 | 读取内容 | 从文本、URL 或剪贴板获取原始内容 |
| Phase 2 | 质量门控 | 5 层规则前置过滤低质/噪声内容（硬拦截 + 软警告） |
| Phase 3 | AI 提炼 | 调用 DeepSeek 将内容拆解为原子笔记 |
| Phase 4 | 同批去重 | 检测同批次中高度相似的笔记并合并 |
| Phase 5 | 事实核查 | 逐条比对原文，标记有据 / 存疑 / 无据 |
| Phase 6 | 笔记复查 | AI 二次评分，过滤低价值笔记 |
最终输出经过质量筛选的原子笔记，可预览确认或自动保存至指定文件夹。
使用方法
命令面板
Bamboo Darts: 从选中文本提炼原子笔记Bamboo Darts: 从 URL 提炼原子笔记Bamboo Darts: 从剪贴板提炼原子笔记
右键菜单
在编辑器中选中文本后右键，点击"提炼原子笔记"
Ribbon 图标
点击左侧边栏的 ⚛️（atom）图标
配置说明
在 Obsidian 设置 → Bamboo Darts 中配置：
| 配置项 | 说明 | 默认值 |
|---|---|---|
| API Key | 你的 DeepSeek API Key（必需） | — |
| API URL | DeepSeek API 地址 | https://api.deepseek.com/v1/chat/completions |
| 模型 | 使用的 DeepSeek 模型 | deepseek-chat |
| 最大 Token 数 | AI 输出的最大 Token 数 | 2000 |
| 目标文件夹 | 原子笔记保存的文件夹 | Atomic Notes |
| 文件名模板 | 支持变量 {{title}}, {{date}}, {{time}}, {{timestamp}} |
{{title}} |
| 自动保存 | 启用后，提炼完成后自动保存（不显示结果弹窗） | 关闭 |
安装方法
方法 1：社区插件市场（待上架）
在 Obsidian 设置 → 社区插件中搜索 Bamboo Darts 安装。
方法 2：BRAT 安装
- 安装 BRAT 插件
- 在 BRAT 设置中添加仓库：
miaoziguan/obsidian-Bamboo-Darts
方法 3：手动安装
- 下载本插件的最新 Release
- 解压到你的 Obsidian vault 的
.obsidian/plugins/目录 - 在 Obsidian 设置 → 社区插件 → 已安装插件中启用
截图
插件界面包括：命令面板（Command Palette）、提炼结果弹窗（Result Modal）、设置页面（Settings Tab）。
技术栈
- TypeScript
- esbuild（构建工具）
- DeepSeek API（AI 提炼）
- Obsidian API（插件接口）
常见问题
Q：是否需要付费 API？
A：需要 DeepSeek API Key，DeepSeek 有免费额度，具体请参考 DeepSeek 官网。
Q：支持离线使用吗？
A：不支持，本插件依赖 DeepSeek API 进行内容提炼。
Q：笔记保存到哪里？
A：默认保存到 Atomic Notes 文件夹，可在设置中自定义。
更新日志
许可证
MIT
English
What is an Atomic Note?
Atomic Notes are a core concept in Obsidian—each note captures exactly one knowledge point: concise, self-contained, and reusable.
This plugin helps you transform long articles, web pages, or selected text into well-structured atomic notes using AI, with automatic deduplication before saving to your vault.
Features
- ✅ Multiple input methods: URL, selected text, or clipboard
- ✅ Quality gate: Automatically checks content length, detects ads and duplicates
- ✅ AI extraction: Calls DeepSeek API to extract atomic notes following five quality standards
- ✅ In-batch deduplication: Removes duplicates within the current extraction batch
- ✅ Vault deduplication: Compares with existing notes to avoid storage duplication
- ✅ Flexible storage: Customize target folder and file name template
Five Standards for Atomic Notes
- One note, one idea —— Focus on a single knowledge point
- Self-contained —— Readable without additional context
- Information-dense —— Not a definition; a statement with insight
- Actionable or citable —— Either a usable method or a quotable insight/data point
- Written in your own words —— Not a copy-paste from the source
Processing Pipeline
The plugin uses a 6-stage pipeline, with quality checks at each step:
| Phase | Name | Description |
|---|---|---|
| Phase 1 | Read Content | Fetch raw content from text, URL, or clipboard |
| Phase 2 | Quality Gate | 5-layer rules filter low-quality/noisy content (hard block + soft warning) |
| Phase 3 | AI Extraction | Call DeepSeek API to decompose content into atomic notes |
| Phase 4 | Batch Deduplication | Detect & merge highly similar notes within the same batch |
| Phase 5 | Fact Check | Cross-reference each note against source text; mark as supported / questionable / unsupported |
| Phase 6 | Note Review | AI re-scores notes, filters out low-value output |
Final output: quality-filtered atomic notes, ready for preview or auto-save.
How to Use
Command Palette
Bamboo Darts: Extract atomic notes from selected textBamboo Darts: Extract atomic notes from URLBamboo Darts: Extract atomic notes from clipboard
Context Menu
Right-click on selected text in the editor, then click "Extract atomic notes"
Ribbon Icon
Click the ⚛️ (atom) icon in the left sidebar
Configuration
Configure in Obsidian Settings → Bamboo Darts:
| Setting | Description | Default |
|---|---|---|
| API Key | Your DeepSeek API Key (required) | — |
| API URL | DeepSeek API endpoint | https://api.deepseek.com/v1/chat/completions |
| Model | DeepSeek model to use | deepseek-chat |
| Max Tokens | Maximum tokens for AI output | 2000 |
| Target Folder | Folder for saving atomic notes | Atomic Notes |
| File Name Template | Supports {{title}}, {{date}}, {{time}}, {{timestamp}} |
{{title}} |
| Auto Save | When enabled, automatically saves after extraction (no result modal) | Off |
Installation
Method 1: Community Plugin (Coming Soon)
Search for Bamboo Darts in Obsidian Settings → Community Plugins.
Method 2: BRAT
- Install the BRAT plugin
- Add this repository in BRAT settings:
miaoziguan/obsidian-Bamboo-Darts
Method 3: Manual Installation
- Download the latest release from the Releases page
- Extract to
.obsidian/plugins/in your vault - Enable the plugin in Obsidian Settings → Community Plugins → Installed Plugins
FAQ
Q: Is a paid API required?
A: A DeepSeek API Key is required. DeepSeek offers free credits—see the DeepSeek website for details.
Q: Does it work offline?
A: No, this plugin relies on the DeepSeek API for content extraction.
Q: Where are notes saved?
A: Notes are saved to the Atomic Notes folder by default; you can customize this in settings.
Changelog
See CHANGELOG or the Releases page.
License
MIT