把随手存下来的东西,变成以后找得回来、记得起为什么的笔记。
DeepSeek 摘要与标签 · 全文检索 · 定期回顾 · 杂志风网页 · 回收站 · 零第三方依赖
网页版界面
 |
 |
 |
桌面悬浮窗
- 零第三方依赖 — 运行时纯标准库直调 DeepSeek API;可打包成单个
拾遗.exe(PyInstaller 仅构建期工具) - AI 摘要与标签 — ≤30 字摘要 + 2-4 个标签,输出三级兜底、重试细分
- 理由即记忆 — 每条笔记记录「为什么存它」,检索可命中理由
- 杂志风网页与回收站 — 浏览 / 搜索 / 回顾一站式,删除进回收站保留 30 天可恢复,原生 HTML/CSS/JS 无构建
- 桌面悬浮窗 — 贴屏幕右缘的粉色细条,悬停展开,随手存、一键拉起网页版(Windows)
- 定期回顾 — 合并排序推出最久没看过的笔记,回答追加回笔记正文
# 方式一:环境变量
set DEEPSEEK_API_KEY=sk-...
# 方式二:项目根目录建 config.env(已被 gitignore,不会进仓库)
echo DEEPSEEK_API_KEY=sk-... > config.env# 把想存的 .txt / .md 丢进 inbox/,然后:
python ingest.py
# 逐条打印 AI 摘要与标签 → 让你写一句理由(回车跳过,标「(待补)」)
# 写入 notes/,原文件移入 archive/python search.py 关键词 [关键词...]
# 搜 摘要 / 标签 / 理由,大小写不敏感,多词 AND,按保存时间倒序python resurface.py # 推出最久没看过的笔记,问「现在还有用吗?」
python web.py # 浏览器打开 http://127.0.0.1:8000(浏览/搜索/回顾/回收站)
python edge.py [--edge left] # 贴屏幕右缘的粉色细条(仅 Windows)把悬浮窗 + 网页版装进一个绿色软件,双击即用、无需 Python:
packaging/build.bat # 装 PyInstaller(仅构建期)+ 构建
# 产物:packaging/dist/拾遗.exe把 拾遗.exe 拷到任意目录,在其旁放一份 config.env(内容同快速开始);双击启动:悬浮窗常驻屏幕右缘,网页服务内置其中(悬浮窗里点「打开网页版」即可),数据(inbox / notes / archive / trash)自动建在 exe 旁边。悬浮窗底部有「开机自启」开关,再点一次关闭。绿色版:整个文件夹可随意搬走或删除。
未签名的单文件 exe 可能被 Windows Defender 误杀(实测:运行几分钟后进程被终止、文件被隔离)。给 exe 所在目录加排除项即可:
- 开始 → 设置 → 隐私和安全性 → Windows 安全中心 → 病毒和威胁防护
- 「病毒和威胁防护设置」→ 管理设置 → 排除项 → 添加或删除排除项(需管理员确认)
- 添加排除项 → 文件夹 → 选 exe 所在目录(如
D:\拾遗);构建机再排除packaging/dist/,避免重建产物也被隔离 - 已被隔离的副本:病毒和威胁防护 → 保护历史记录 → 还原
开发模式(python edge.py)不受影响。
| 配置项 | 说明 | 默认 |
|---|---|---|
环境变量 DEEPSEEK_API_KEY |
API Key,优先读取 | — |
config.env |
环境变量缺失时读取,项目根目录(已 gitignore) | — |
--port |
web.py 监听端口 | 8000 |
--edge |
edge.py 贴边方向(left / right) |
right |
%%{init: {'theme': 'base', 'themeVariables': {'fontSize': '14px'}}}%%
flowchart LR
A["inbox/<br/>投递 .txt / .md"] --> B["ingest.py<br/>DeepSeek 摘要+标签<br/>交互式理由"]
B --> C[("notes/<br/>笔记库 .md")]
J["edge.py<br/>悬浮窗随手存"] --> C
B -. "原文件" .-> D["archive/"]
C --> E["search.py<br/>关键词检索"]
C --> F["resurface.py<br/>最久没看过优先"]
C --> G["web.py<br/>浏览 / 搜索 / 回顾 / 删除"]
G --> H["trash/<br/>30 天可恢复"]
H -. "恢复" .-> C
H -. "到期" .-> I["永久删除"]
classDef input fill:#3B82F6,stroke:#2563EB,color:#fff,stroke-width:2px
classDef process fill:#10B981,stroke:#059669,color:#fff,stroke-width:2px
classDef store fill:#8B5CF6,stroke:#7C3AED,color:#fff,stroke-width:2px
classDef purge fill:#F43F5E,stroke:#E11D48,color:#fff,stroke-width:2px
class A,J input
class B,E,F,G process
class C,D,H store
class I purge
| 入口 | 职责 | 行数 |
|---|---|---|
| ingest.py | 入库:DeepSeek 摘要+标签 → 交互式理由 → 写 notes/ → 原文件移 archive/ | 115 |
| search.py | 检索:关键词 AND、大小写不敏感、保存时间倒序 | 36 |
| resurface.py | 回顾:推出最久没看过的笔记,回答记回正文 | 51 |
| web.py | 网页版后端:浏览 / 搜索 / 回顾 / 回收站 API,只监听 127.0.0.1 | 182 |
| web/index.html | 网页版前端:杂志风单页,原生 HTML/CSS/JS | 418 |
| edge.py | 桌面悬浮窗:悬停展开、随手存、一键拉起网页版(Windows/tkinter) | 829 |
| app.py | 打包入口:单进程跑网页服务 + 悬浮窗,--serve-only 冷拉起 |
30 |
| common.py | 公共库:API 调用与重试、笔记读写、检索与回顾规则 | 463 |
| 合计 | 7 个 Python 模块 + 1 个页面 | 2124 |
pie showData title 各模块代码行数(共 2124 行)
"edge.py · 悬浮窗" : 829
"common.py · 公共库" : 463
"index.html · 网页前端" : 418
"web.py · 网页后端" : 182
"ingest.py · 入库" : 115
"resurface.py · 回顾" : 51
"search.py · 检索" : 36
"app.py · 打包入口" : 30
全部 JSON、charset=utf-8,只监听 127.0.0.1,共 9 个端点:
| 方法 | 路径 | 说明 |
|---|---|---|
| GET | / |
网页版页面(启动时读入内存) |
| GET | /api/notes?q=关键词 |
笔记列表,多词 AND、大小写不敏感 |
| GET | /api/note?path=… |
单条全文,路径必须落在 notes/ 内(防目录穿越) |
| GET | /api/review |
下一条待回顾笔记(规则同 resurface.py) |
| POST | /api/review |
{"path", "answer"} 回顾回答记回笔记 |
| GET | /api/trash |
回收站列表(先清理过期条目) |
| POST | /api/delete |
{"path"} 笔记移入回收站 |
| POST | /api/restore |
{"name"} 从回收站恢复 |
| POST | /api/purge |
{"name"} 彻底删除回收站条目 |
按 DeepSeek 官方定价(2026-09:输入 ¥1 / 百万 tokens 未命中缓存,输出 ¥2 / 百万 tokens),单条笔记按最坏情况估算:
| 指标 | 数值 |
|---|---|
| 输入上限 | 6000 字 ≈ 6000 tokens(笔记正文存全文,不截断) |
| 输出上限 | max_tokens = 300 |
| 单条成本 | (6000×1 + 300×2) ÷ 10⁶ ≈ ¥0.007 ≈ 0.7 分钱 |
| 存 100 条 | ≈ ¥0.7 |
| 存 1000 条 | ≈ ¥7 |
价格以 DeepSeek 官方定价页 为准。
每条笔记一个 .md,头部为纯文本元数据,正文为原文全文:
---
标题: 原文件名
摘要: ≤30 字
标签: a, b, c
理由: 为什么存它(留空则「(待补)」)
保存时间: 2026-09-12 14:30
上次回顾: 最近一次被 resurface 展示的时间(缺失=从未)
---
<原文全文>
- [2026-09-12 14:31] 每次回顾追加一行:时间 + 回答
正文可以随手修改;头部改坏也不崩(按缺省元数据处理,下次回顾自动重建)。
save_anything/
├── inbox/ # 投递目录:丢 .txt / .md 进来(gitignore 排除)
├── notes/ # 笔记产物:每条一个 .md
├── archive/ # 已处理的原文件
├── trash/ # 回收站:删除的笔记保留 30 天,到期自动永久清理
├── web/ # 网页版前端 index.html
├── docs/img/ # README 截图
├── packaging/ # 打包成 exe:spec / 图标脚本 / 构建脚本
├── ingest.py # 入库
├── search.py # 检索
├── resurface.py # 回顾
├── web.py # 网页版后端
├── edge.py # 桌面悬浮窗
├── app.py # 打包入口(单进程:网页服务 + 悬浮窗)
├── common.py # 公共库
└── decisions.md # 产品与技术决策记录
每个产品判断与技术选型的背景、选项和理由,都记录在 decisions.md,例如:
- 理由允许留空,标「(待补)」——降低记录成本,先收进来再说
- 「看过」= resurface 展示过,不依赖不可靠的文件访问时间
- 零第三方依赖:纯标准库直调 DeepSeek;笔记头部用纯文本格式,不引 YAML
- DeepSeek 输出三级兜底 + 重试细分:瞬时错误重试,确定性错误不重试
- 编码策略:utf-8-sig → gb18030 兜底,控制台三流统一 UTF-8
- 手动触发:无文件监听、无定时任务
- 无数据库:笔记就是
.md文件本身,检索在内存线性扫(个人量级足够) - 只处理 inbox 里的
.txt/.md - 发给 API 只取前 6000 字(笔记正文仍存全文),摘要质量取决于模型
- 悬浮窗仅支持 Windows 主屏
- 回收站清理在 web 启动或打开回收站时触发,无后台定时任务
- 打包版为绿色版:数据在 exe 旁,勿放 Program Files 等只读目录
- 端口 8000 固定;被占用时悬浮窗仍可用,「打开网页版」可能连到占用方服务
- exe 未做代码签名,杀毒软件可能误杀单文件 exe(Windows Defender 排除项步骤见「打包成 .exe」)
- 以 Git Bash / Windows Terminal 为准;cmd + chcp 936 下提示文字可能乱码
- 输入文件自动识别 UTF-8(含 BOM)与 GBK
- 不要用管道把 GBK 编码的文本喂给脚本;交互输入中文请直接在终端打字