Loe
(Loe )
1
软件名称
墨萃 · InkGist
应用平台
Web / 在线服务 / Chrome & Edge 扩展 / 自建部署
推荐类型
【开发者自荐】
一句简介
极简黑白水墨风的 AI 网页智能速读与全功能多用户云端书签管理平台。
应用简介
平时浏览网页、查阅技术文档或收集优质开源项目时,我们常会随手把链接塞进浏览器收藏夹,但时间一长往往就成了“数字垃圾堆”——只剩冷冰冰的标题,根本记不起当时为何收藏,再想找时也无从下手。
墨萃 (InkGist) 就是为了解决这个问题而做的一个小工具。
它的核心逻辑很简单:把“存链接”变成“沉淀知识卡片”。当你遇到想存的网页时,无需费时通读全文,只需一键发送给墨萃,系统会自动抓取正文并调用大模型输出包含核心功能、要点提炼与行动指引的速读卡片。
核心功能
主流大模型总结提炼:原生接入智谱 AI (glm-4.6v-flash)、DeepSeek (deepseek-chat) 与 Google Gemini (gemini-2.0-flash)。自动抓取网页核心内容,借助大模型快速提炼重点,生成直观易读的速读卡片。
配套浏览器扩展与小书签:
- Chrome / Edge 扩展:直接读取浏览器本地收藏夹,支持按需勾选或一键批量导入墨萃;
- Bookmarklet 小书签:无需安装扩展,只需将小书签拖至浏览器书签栏,在任意网页点击即可快速呼出墨萃并完成该页面的 AI 总结与归档。
高效率云端书签工作台:
- 支持书签卡片长按拖拽归类到指定文件夹;
- 鼠标悬停文件夹即时预览包含的内容;
- 提供 1 列 / 2 列 / 3 列网格自适应切换。
个人私有化部署
项目默认采用本地文件存储,不需要单独安装 MySQL 或 Redis 等外部数据库,只要有一台能跑 Node.js 的电脑或服务器即可轻松搞定:
1. 环境准备与依赖安装
确保本地安装了 Node.js 18+,然后克隆代码并安装依赖:
git clone https://github.com/Loecedas/InkGist.git
cd InkGist
npm install
2. 配置大模型 API Key
复制配置文件:cp .env.example .env
打开 .env 文件,填入你常用的大模型 API Key(如 ZHIPU_API_KEY=your_key 或 DEEPSEEK_API_KEY=your_key)。
3. 编译并启动服务
- 本地体验 / 开发模式:
npm run dev
- 服务器生产环境部署:
npm run build && node .output/server/index.mjs
(若需后台常驻,可搭配 PM2:pm2 start .output/server/index.mjs --name inkgist)
启动后访问 http://localhost:3000 即可使用。
项目同样支持 Cloudflare Workers + D1 边缘零成本部署,详细步骤及浏览器扩展的加载方法欢迎查看项目 部署与使用文档。
官方网站
1 个赞
Loe
(Loe )
4
InkGist 系统版本更新公告
发布日期:2026 年 8 月 30 日
更新类型:体验优化、交互增强与稳定性更新
一、更新概述
本次更新针对多级书签分类管理、移动端触控交互逻辑、深色模式视觉规范以及 AI 核心服务容灾能力进行了系统性重构与升级。旨在进一步提升跨设备操作的一致性与内容呈现的规范度,为用户提供更加高效、可靠的网页智能速读与知识管理体验。
二、功能新增与交互优化
1. 文件夹多级级联与跨设备手势体系
- 触控手势统一规范:针对移动端与触控屏设备,支持对一级文件夹及各层级子分类实施“单击常驻预览、双击快速进入”的手势交互;PC 桌面端保持“鼠标悬停预览、单击直接进入、长按拖拽调序”的原生交互体验。
- 递归子分类内嵌响应式展开:在小尺寸屏幕(≤ 640px)下,预览浮窗内部的子文件夹自动适配为内嵌手风琴式展开结构,提升单手操作流畅度。
2. 分类层级与书签隔离逻辑
- 直属书签精准展示:优化文件夹视图的数据过滤机制,激活父文件夹时仅展示直接归属该文件夹的书签列表,避免子文件夹内容混杂,各级分类统计计数同步保持准确。
- 文件夹归属移动功能:新增分类调整模态面板,支持在防止循环引用的安全校验机制下,将任意文件夹快速归入其他父级目录或移至顶级根目录。
三、问题修复与视觉调优
1. 视口边界钳位与防溢出算法
- 修复小尺寸浮窗越界问题:重构 375px/425px 等移动端视口下的坐标自适应算法,强制引入双向边界安全钳位机制(Viewport Clamping),杜绝悬浮预览卡片超出主体容器或视口边缘的现象。
2. 深色模式(Dark Mode)全场景适配
- 全面重构主题设计变量:修复导出书签模态弹窗(Export Bookmark Modal)中写死亮色样式的缺陷,统一接入系统级 CSS Token 规范。
- 高对比度文本可读性提升:修复拖拽高亮角标与激活态在暗色/纯黑 OLED 背景下的对比度问题,确保文本清晰可读。
3. 书签卡片 Markdown 渲染规范化
- 行内格式完整解析:书签卡片中的“核心功能说明”与“待办行动指南”已完整接入行内 Markdown 解析器,支持粗体、行内代码、超链接的正确渲染,消除原始格式符号外露问题。
四、服务性能与稳定性提升
1. AI 总结服务多模型容灾降级
- 引入高可用调用链:重构服务端大模型调度逻辑,支持在主流模型服务商之间(智谱 AI ➔ DeepSeek ➔ Google Gemini ➔ 自定义大模型)实现网络超时与异常的自动无感切换与降级重试,大幅降低接口调用失败率。
2. 总结生成容量扩充
- Token 限制扩充至 2500:调整大模型输出 Token 配额,彻底解决长篇网页与深度内容在总结生成过程中偶发的内容截断问题。
Qingwa
(青小蛙)
5
Hi 似乎现在同步到 karakeep 是搭建者的么?官方示例中没有设置api的地方呀。
我还碰到一个新的问题,就是重复书签。它好像也会跑一遍总结。
又有一个问题:导出后是否应该有一个「导出后删除书签」功能。因为我觉得目前更像一个中转站,导出后这些链接就可以不用放在书签中了。
Loe
(Loe )
6
是的,现在的api接口是搭建者的,个人部署可以在env里面去添加;重复的书签现在如果点击添加到书签会直接覆盖旧的;后面会持续跟进一些新功能
1 个赞
Loe
(Loe )
8
【InkGist 重大更新】网页离线快照归档 + 自托管平滑更新系统上线,彻底告别文章 404
大家好!墨萃 (InkGist) 今天又推送了一次重要的功能更新:
一、全新:网页全量离线快照归档系统
告别死链与内容失效,不再受反爬、登录墙与折叠拦截限制。
-
一键无损捕获:在首页各输入项中新增「生成快照」按钮与批量快照入口,100% 还原网页的 DOM 排版、内联样式与静态媒体;
-
独立快照画廊库 (/snapshots):提供专有的快照卡片画廊,支持多维度关键词实时搜索、批量清理与本地导出,自适应适配 PC、平板与手机端;
-
纯享离线阅读页 (/snapshot/[id]):生成专属永久离线地址,支持原网页一键跳转、无干扰沉浸阅读;
-
客户端本地持久化:采用浏览器 IndexedDB 承载大容量文本离线存储,辅以后端缓存协同,既不占用服务器数据库负担,又保证随时离线可读;
-
跨端联动接收:新增快照接收通道 (/snapshot/receiver),小书签与配套扩展可直接将第三方页面当前渲染好的 DOM 实时同步至本地快照库。
二、全新:自托管在线平滑更新系统
自建部署不用再频繁手动 SSH 登录运维。
-
版本状态指示器:导航栏右上角新增更新徽章与红点呼吸灯动画,发现新版本即时提醒;
-
内置更新弹窗 (UpdateModal):在 Web 页面内直接查看 Markdown 格式的中英双语版本说明;
-
系统级安全升级:新增 /api/system/version 与 /api/system/update 接口,支持在线检查并拉取最新代码;
-
程序与数据解耦:升级只替换运行代码和静态资产,严格保护已有的书签、快照及本地数据库,升级不丢数据。
三、新增:官方 Docker 支持与自动化打包
- 标准化容器镜像:新增官方
Dockerfile 与 docker-compose.yml,方便 1Panel、宝塔面板或自建服务器一键拉取运行;
- 自动化构建脚本 (
scripts/build-release.js):提供跨平台一键打包归档工具链;
- 配套扩展更新:重新编译并打包发布了新版 Chrome 扩展 (
inkgist-bookmarks-assistant.crx)。
四、交互与安全细节优化
- 操作栏并列重构:首页操作区域重构为「智能速读」与「生成快照」双操作并行,触控与移动端布局更紧凑;
- 快照直达 Toast:生成快照后弹出底部通知,支持一键点击直接打开对应快照;
- 依赖安全加固:引入
dompurify 与 marked,快照渲染与 Markdown 解析具备更健全的 XSS 防御能力;
- 工程瘦身:彻底清理了历史残留的开发调试脚本与无用部署配置。
如何升级 / 体验
Docker 部署(推荐)
docker-compose pull
docker-compose up -d
源码 / Git 部署
git pull origin main
npm install
npm run build
node .output/server/index.mjs
(或者直接进入 Web 界面,点击右上角的更新按钮一键检查并升级)
已知不足与可能出现的问题 (欢迎吐槽与提 Issue)
由于快照归档与在线更新是初次上线的大模块,难免存在一些边界场景下的局限性,在此坦诚列出,也希望大家在使用中多提宝贵建议:
-
快照抓取方面的局限:
- 动态 SPA 与滚动懒加载:对于高度依赖长滚动懒加载(Lazy-load)、或是重度客户端渲染(如复杂动态瀑布流页面),直接在首页粘贴 URL 通过服务端抓取,可能会遗漏尚未加载出的图片。
建议方案:此类网页推荐使用配套的「小书签」或「浏览器扩展」,在自己浏览器里滚动浏览完整后,一键生成快照,抓取效果最佳。
- 第三方图片防盗链 (Hotlinking):快照完整保留了网页 DOM 排版与图文结构,但如果目标网站对图片等静态资源设置了严格的
Referer 防盗链策略,在离线查看时部分图片可能会裂开。(后续版本计划加入图片自动转 Base64 / 本地缓存持久化机制)。
- 跨设备同步:目前快照数据全量保存在当前浏览器的 IndexedDB 本地,保障隐私且零服务器负担,但暂未支持跨浏览器/跨设备自动云同步。
-
在线自动更新的边界情况:
- 权限限制:在线一键更新依赖服务进程对项目目录的写权限以及环境中的 Git/Node 运行时。如果您的部署环境开启了严格的只读容器(Read-only Container)或非 root 权限沙箱,可能会出现更新拉取失败,此时建议采用标准的
docker-compose pull 外部更新。
-
复杂防爬与验证码站点:
- 遇到开启了强力人机验证(如 Cloudflare Turnstile、滑块验证码)或强制必须登录才能查看全文的站点,服务端直连抓取可能会被拦截。
欢迎反馈与交流
一个人的测试场景终究有限,如果您在体验过程中遇到了:
- 抓取排版混乱、格式变形的具体网页案例;
- 某个平台的反爬拦截或防盗链图片失效;
- 部署或更新时遇到的报错信息;
非常欢迎在评论区留言反馈,或者直接前往 GitHub 提 Issue!我会第一时间跟进修复和持续打磨。
前段时间自己撸了一个类似的,可能用油猴脚本直接在客户端侧将内容发上服务器相对简单点,自己折腾反爬需要经常更新,耗费挺多精力的