Skip to content

Repository files navigation

秒懂 · 快速学习智能体

一个可隐藏/唤起的轻量学习浮窗。输入名词或公开网址后,它会在必要时追问具体含义,再给出快速总结、三个核心概念和最短上手步骤。总结后可以继续询问用法、示例、误区或其他问题。

功能

  • 精准名词直接生成快速总结;未知名词会尝试从中文维基百科获取有来源的入门资料。
  • 模糊名词先澄清含义,再按所选方向学习。
  • 公开网页提取标题、摘要、章节与正文要点。
  • 围绕当前主题继续询问用法、示例和误区;百科主题优先依据已取得的来源摘录回答。
  • 使用闪卡复习关键概念,并通过一道即时反馈的小测验巩固理解。
  • ¥29/份 的首批定制学习包验证真实付费意愿,提交只登记意向,不会自动扣款。
  • 浮窗可以隐藏为右下角入口并随时恢复。

运行

npm start

打开 http://127.0.0.1:4173

网页分析只允许公开的 HTTP/HTTPS 地址,并限制抓取时间和正文大小。未知名词查询会将该名词发送给中文维基百科;返回的百科摘要带原文链接和 CC BY-SA 4.0 标识。查询超时、失败或没有可靠结果时会回退到本地学习模板。

质量检查

npm run ci

该命令执行语法检查和真实服务冒烟测试,与 GitHub Actions 使用的检查一致。所有功能更新通过 Pull Request 合并;风险分级、Review 要求和发布流程见 CONTRIBUTING.md。安全问题报告方式见 SECURITY.md

是否需要客户端

  • 只在网页内显示、隐藏:不需要客户端,当前版本已经支持。
  • 只想在浏览器所有页面中唤起:适合做浏览器扩展。
  • 希望跨应用悬浮、置顶、托盘常驻或用全局快捷键唤起:需要桌面客户端,建议使用 Tauri 封装当前界面。

当前轻量版的内置主题、澄清和追问使用本地知识与规则,未知名词通过中文维基百科补充公开资料,不需要模型密钥。若要对任意陌生领域进行更深入的自由问答,可以在 /api/analyze/api/ask 后接模型服务。

Railway 部署

仓库内的 railway.json 使用 Railpack 构建、npm start 启动和 /health 健康检查。部署时设置 HOST=0.0.0.0QUICKLEARN_DATA_DIR=/data,并把私有持久化 Volume 挂载到 /data;公网监听缺少持久化目录变量时健康检查和商业 API 会返回 503。完整配置、验证、备份和回滚步骤见 docs/RAILWAY.md

首批付费验证

成功分析后会显示定制学习包入口,商品为学习路线、10 张闪卡、5 道带解释的测验和一个实战任务,早期验证价为 ¥29/份。用户提交主题、目标和联系方式后,由运营者在 24 小时内人工确认范围与付款方式;系统本身不会收款。

购买意向默认保存在未纳入 Git 的 .data/paid-pack-interests.jsonl,也可以通过 QUICKLEARN_LEAD_FILE 指定私有持久化路径。记录只包含编号、商品版本、价格、主题、目标、联系方式和提交时间,不保存 IP、User-Agent、网页正文、来源摘录或完整分析上下文。运营者应限制文件访问,仅为履约联系使用,并在意向失效或用户要求时删除对应记录。

HTTP 服务只公开界面所需的三个静态文件,不允许通过 URL 读取 .data、服务端源码或 Git 元数据。正式部署仍应把 QUICKLEARN_LEAD_FILEQUICKLEARN_EVENT_FILE 指向有备份且不在公开目录中的私有持久化卷。

商品展示与表单打开事件保存在 .data/paid-pack-events.jsonl,每条只有事件名和时间,不使用 Cookie 或身份标识。查看漏斗和待跟进意向:

npm run commercial:report

确认实际到账后,使用意向编号记录首笔收入,再查看更新后的转化漏斗:

npm run commercial:mark-paid -- QL-XXXXXXXX
npm run commercial:report

付款记录默认写入 .data/paid-pack-sales.jsonl,只包含意向编号、商品版本、金额和到账时间,不重复保存联系方式。

首批用户获取、人工收款、交付和验证阈值见 docs/FIRST-SALE.md

About

轻量的快速学习智能体:网址与名词分析、歧义澄清和连续问答。

Resources

Contributing

Security policy

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Used by

Contributors

Languages