Notedown（脑袋笔记）

English Version

Notedown 是一款面向知识沉淀场景的浏览器笔记产品：

• 一键把网页保存为可编辑笔记
• 本地优先，离线可读可搜
• 可选同步到 Git 仓库，构建可审计、可自动化的个人知识库

它适用于研发文档收藏、行业信息追踪、学习资料归档、团队知识沉淀等场景。

尽管当前还未决定正式开源，但它免费提供所有用户使用。

---

产品定位

Notedown 的核心目标，是把“稍后读”升级为“可管理的知识资产”：

• 保存时自动抽取正文，减少广告和噪音
• 统一转换为 Markdown，便于编辑、迁移与长期保存
• 支持标签、分类、全文搜索，避免收藏后再也找不到
• 通过 Git 同步实现多端共享与历史追踪

---

核心能力

1. 智能网页收藏

• 点击浏览器扩展图标即可收藏当前页面
• 基于 Readability 提取正文
• 支持“点选网页内容收藏”，可只保存局部内容

2. Markdown 化与二次编辑

• 使用 turndown 将网页内容转换为 Markdown
• 支持在编辑器中继续整理和改写

3. 本地优先与离线可用

• 默认存储在浏览器本地
• 断网仍可阅读、检索和管理已收藏内容

4. 云端同步（Git As A Serverless）

• 支持 Gitee、GitHub、Gitea
• 同步对象是你自己的仓库（建议私有仓库）
• 可手动同步，也可开启自动同步
• 收藏内容时，可以将图片等资源保存到仓库，降低外链失效风险

5. 全文搜索与组织管理

• 支持按标题、正文、标签、分类等维度检索
• 保存时可自动生成标签，降低整理成本

6. 可选 AI 能力

• 支持接入 OpenAI 兼容 Chat Completions 接口
• 可用于润色、摘要、翻译、改写等编辑场景

7. 自动化扩展能力

• 数据落入 Git 后，可由仓库 Webhook 触发后续流程，让数据资产发挥更大价值
• 常见用法：静态站点构建、索引更新、消息通知、审计归档

---

数据结构（同步到 Git 时）

默认命名空间为 notedown，典型结构如下：

notedown/
	notes/<prefix>/<id>.md
	assets/<prefix>/<noteId>/<sha>.<ext>

说明：

• notes：保存文章笔记（Markdown）
• assets：保存图片等资源，降低外链失效风险

---

快速上手

1. 安装扩展并在 Chrome 中加载
2. 点击扩展图标收藏网页，或用点选模式收藏局部内容
3. 在管理界面进行标签、分类与搜索
4. 按需配置 Git 同步（Gitee/GitHub/Gitea）
5. 按需配置 AI（OpenAI 兼容接口）

隐私与安全

• 默认数据本地保存，不强制上传
• 启用同步后，数据写入你配置的 Git 仓库
• 建议使用最小权限 Token，并定期轮换

---

适用场景

• 研发人员沉淀技术资料与问题排查记录
• 运营与产品团队归档竞品、行业信息、公告资料
• 学习者建立个人知识库并长期维护
• 需要可审计内容资产的个人/小团队

---

如果你希望把 Notedown 用作“个人知识库的采集层”，当前版本已经具备可落地的核心能力：采集、整理、检索、同步与自动化衔接。