-
当前大部分导航页类开源项目的可定制度都不高，个人想要关注的信息又过于分散，因此决定自己写一个可以由用户高度定制的导航页，并整合自己所需要的信息和功能。
-
前端使用Vue.js，后端使用Python，MariaDB+Redis提供数据存储。前端框架使用Element UI，后端框架使用Flask，后端ORM使用Peewee。
-
🐞 如果有任何BUG/需求/建议，欢迎提Issues！
-
⭐ 欢迎star！尽量保证每天都有提交！
- 多用户登录
- 搜索引擎（仅为入口，支持配置多搜索引擎）
- 灵活方便的异步脚本统一驱动和管理平台
- 接口层级的权限控制（用户、角色、权限的新增与关联）
- 网盘和图床（支持生成链接分享）
- 易于操作的小组件编辑器
- 小组件-天气（未登录用户识别ip位置，登录后用户还可以添加自定义位置，支持天气异常时推送微信或发送邮件）
- 小组件-书签
- 小组件-AppStore价格监控（支持设置触发阈值后推送微信或发送邮件）
- 小组件-黄金价格（支持设置触发阈值后推送微信或发送邮件）
- 小组件-便签（支持定时发送便签内容到微信或邮箱）
- 小组件-翻译
- 小组件-必应壁纸
- 小组件-股票（支持设置触发阈值后推送微信或发送邮件）
- 小组件-基金（支持设置触发阈值后推送微信或发送邮件）
- 小组件-新闻
- 简介优雅的展示方式：没有广告、没有信息流、只有你需要的功能和信息
- 灵活的组件配置：用不到某个组件？不满意默认的排序方式？使用组件编辑器轻松组织你的主页组件！
- 组件内容随心定制：几乎所有的组件都可以自由修改内容，显示的天气、展示的书签、关注的App Store应用、跟踪的股票或基金、黄金价格提醒的阈值...统统可以自由修改！
- 功能丰富的后端：当前类似的导航页项目大部分都仅有前端，或只有负责爬取数据的后端，本项目有功能丰富的后端，数据均会被保存在库中，相对于无前端可以实现更多的功能，With great backend comes great ability!
-
dev分支为开发中分支，运行可能会有问题，建议使用master分支进行部署测试
-
首先需要本地安装MySQL（测试时使用的是MariaDB）和Redis
-
申请SeverChan的key用于推送提醒到微信；和风天气的key用于获取天气信息；默认发送邮箱和口令，参考QQ邮箱的口令获取方式
-
在具备环境后，使用python3运行根目录下的start.py并根据提示进行操作
| 目录 | 内容 |
|---|---|
| /backend | 后端代码 |
| /backend/run.py | 后端入口文件 |
| /frontend | 前端代码 |
| /dist | 前端编译的产物 |
| /upload | 存储用户上传的文件 |
| /wallpapers | 存储爬取的必应壁纸 |
入口：主页
功能：输入内容后跳转到搜索网址，进入页面焦点自动置于搜索框内，输入文字可以带出提示（使用的百度的接口）增加引擎的话是在数据库中增加数据(search_engines)
入口：登陆后左上角hover用户名-控制台
功能：提供在console表中注册的前端组件入口，方便日后权限控制或进行排序等操作，如需增加前端模块，除了编写前端业务外，还需要在console表中增加一条记录
入口： 登陆后左上角hover用户名-控制台-脚本运行平台。
功能： 用于后台程序的统一驱动。前端表单均由配置产生，无需接触前端代码，通过填写配置生成的表单来提交脚本至后端运行脚本，并展示运行结果，而且具有定时运行脚本、对以前运行的任务进行回放、记录运行耗时、记录运行日志、定制运行记录表格等人性化功能
注意：
- 为了使作为html展示的运行结果正确展示空格数量，输出的所有空格都会被替换为" "，如果需要在输出中真正输出空格，则脚本输出的空格必须使用"# "来代替空格，如：自己组装html标签并增加样式的时候，标签中就必须有空格，所以需要使用"<table# border="1">"代替"<table border="1">"
- 定时任务需要配置"\backend\app\script\schedule_monitor.sh"为定时运行，因为系统默认可以配置的最短的定时运行间隔为五分钟，所以此定时任务的运行步长最好设置为五分钟
模块：
- 首页：左侧为脚本所属栏目，右侧为栏目下的脚本，一个脚本为一个tab，通过右上角的"+"可以增加所选栏目的脚本
- 按钮区域：右上角的五个按钮依次为：回放我上一次运行的参数（回填到表单中）、展示我上一次运行的日志、展示最近50条运行记录、配置定时运行、编辑脚本和删除按钮（此系统中所有删除和更新操作都为逻辑删除）
- 定时任务：最小颗粒度为五分钟，实际上更小也可以，但是没有试过，如果调小颗粒度，则需要减小定时任务扫库脚本的运行步长。定时任务驱动的脚本，在列表中会在运行人后方加上"(定时)"字样
- 运行列表：默认展示运行人、操作、运行开始时间、耗时、运行ID五列，其中操作列包含两个按钮：日志和回放。"日志"按钮点击可以展示日志，"回放"按钮悬浮可以展示参数，点击可以将所选运行记录的参数回填至当前表单上。运行列表可以通过配置组件的"是否在列表展示"选项来自定义列，但不建议设置过多。
-
编辑脚本：
初始选项：
- 脚本名称：展示在tab上
- 起始文件夹：配置在此处的文件夹会使用cd命令打开
- 起始脚本：配置在此处的脚本会作为初始命令
- 组合方式：提供两种组合方式-"顺序"和"替换"："顺序"将起始脚本和参数顺序组合提交；"替换"则类似Jenkins的处理方式，如，当配置为"python3 %参数%"的时候，系统会将"%参数%"替换为"参数"组件内填写或选择的值，当"参数"填写为"Awesome.py"的时候，最终生成的命令将是"python3 Awesome.py"
组件选项：
- 组件名称：前端展示的label
- 组件类型：提供四种类型-输入框、选择器、日期选择器和日期范围选择器，根据用户配置展示为相应的组件
- 默认值：组件默认值
- 是否只读：前端是否只读
- 占位文字：前端展示的placeHolder
- 备注：备注将以组件后一个icon的方式展现，鼠标悬浮即可展示
- 是否有额外按钮：配置为是时，组件后方会展示一个按钮，运行按钮可以运行小型脚本，适用于动态提醒用户参数，如下方图片所示。有两种数据的展示模式，一种是脚本内直接使用
print()来打印需要输出的文字；此外，通过一定的数据格式，可以选择器组件的选项进行初始化，见下方实例：
import json d = { 'code': 200, # 状态码，非必填，无实际作用 'data': { 'msg': 'hello\nworld qwe\nqewqweewqwe', # 展示的文本，非必须，会被解析为html，使用"\n"换行 'value': '123', # 非必须，当传递value时，会将组件内的值替换成传回的值 'options': [ # 非必须，当传递options时，会将选择器组件内的选项替换成传回的选项 { 'label': '234', # 标签，用于选择器组件展示的值 'value': '234' # 值，用于选择器组件选择时实际代表和传递的值 }, ] } } print(json.dumps(d))
- 是否在列表展示：配置为是时，在运行列表中会以单独一列的方式呈现运行时提交的参数，但是，如果将太多的组件都设置为"在列表展示"，会带来前端性能的影响，所以建议不要设置太多个
- 是否显示：配置为否时前端不展示
入口：登陆后左上角hover用户名-控制台-账户和权限
功能：使用"用户-角色-权限"模型编写的接口层级的权限控制系统，接口使用一个装饰器即可以对权限进行控制。默认用户请求接口时，请求IP必须与登录时使用的IP一致，这是一种较为严格的策略，在"/backend/app/privilege/privilege_control.py:24"可以关闭
模块：
-
用户设置：新增用户、禁用用户、删除用户、修改用户角色、修改用户密码
-
角色对应权限设置：新增角色、禁用角色、删除角色、修改角色名称、修改角色对应权限
-
权限设置：新增权限、禁用权限、删除权限、修改权限
入口：登陆后左上角hover用户名-控制台-修改主页组件
功能： 拖拽来修改主页显示的方式。组件的父级定义为"组件集"，当有且只有一个组件集的时候，页面不展示组件集标题，仅展示它所包含的组件，当有两个及两个以上的组件集时，展示组件集及其所包含的组件
按钮：使用左右拖拽的方式来编辑组件集的顺序，使用组件集右侧圆形加号按钮来添加组件集，使用每个组件集内部的编辑按钮来修改组件集的名称，使用每个组件集内部的删除按钮来删除组件集；组件集内的组件使用上下拖拽的方式来编辑顺序，使用每个组件集内的方形加号按钮来添加组件，使用组件右侧的删除按钮来删除组件。组件详情不支持修改，可以手动改库(widget)来对其进行修改
入口：登陆后左上角hover用户名-网盘/图床
网盘：
-
一个简易的网盘功能，并支持通过下载链接分享，文件上传不限制大小，下载不限制速度，但是大文件上传时需要多等一会直到loading结束。文件存储于根目录的upload文件夹，并建立名称为日期的子文件夹。
-
按钮：界面上方为上传文件按钮，可以点击并选择文件或者通过拖拽文件至浏览器来上传文件；下方文件列表的按钮有：1.下载按钮-点击会下载文件；2.分享按钮(未分享时出现)-点击后会生成分享链接，分享给其他人后，其他人粘贴至浏览器即可触发该文件的下载，分享链接经过加密和压缩，真实下载链接会被压缩为短链接，方便使用，且链接带有鉴权token，保证基本的安全性；3.复制分享链接按钮(分享后出现)-点击后复制分享链接至剪贴板；4.取消分享按钮(分享后出现)-将分享链接置为失效并取消分享；5.删除按钮-将文件逻辑删除；6.修改文件名按钮，可以对文件名进行修改
图床：
- 上传图片并生成链接
- 按钮：预览&下载、复制图片链接、删除按钮
如不登录则展示IP所在地的天气信息(受限于第三方API，IP位置为国外时，支持不好)，登录后可以进行自定义，展示范围为IP+自定义位置的信息。此外，当请求数据时，为了保障速度，首先会使用缓存，缓存数据有效期为3小时（在\backend\app\weather\weather_function.py:16修改），如果没有有效缓存，则会请求外部API以获取数据并存为缓存
按钮：新增-登录后新增城市；排序-可拖动对自定义的城市进行排序或删除；推送-推送有三种异常天气可选，分别为雨雪天气、温度骤升/骤降、空气质量，且需要推送到位置和展示的位置是独立的，可以分别设置
登陆后可以自定义，不登录时展示的书签是在数据库中修改（bookmarks.user_id==0）
按钮：新增-登陆后新增书签；设置-登陆后拖动排序、删除或修改书签的图标
查找苹果软件商店的应用并监控其价格，当小于设定的阈值时，提醒用户。
记录便签，并可以定时推送便签内容到微信/邮件。由于不想把功能做的太复杂，提交的推送是不允许撤销的，但可以多次设置，即：设置的推送可以随意加但不能减。此外，便签还可以通过"时间机器"回滚至之前的版本，适用于误删等情况。
按钮：鼠标hover省略号，可以弹出三个按钮：编辑和删除-对选中的便签进行编辑或删除，提交后将所有便签保存为一个新版本；提醒-点击后弹出编辑提醒对话框，可以通过微信/邮件的方式提醒便签内容，最小颗粒度为五分钟。下方的圆形按钮分别为新增按钮和时间机器按钮，功能不再赘述
使用translators实现，使用的是阿里的服务，当在左侧输入区输入文字后，一段间隔后，会根据上方选择的语言进行翻译。
系统使用「脚本运行平台」驱动脚本来每天爬取一张必应壁纸，小组件上则滚动展示7天内的壁纸，点击图片可以下载原图。
监控黄金价格，并且可以设定阈值，当价格超过阈值时发送提醒。需要在"脚本运行平台"中配置定时任务，爬虫在爬取数据的时候会跳过国内黄金不开盘的时间。
爬取沪深股市、港股、美股股票数据，并可以设置超过阈值后提醒功能。
爬取基金数据，并可以设置超过阈值后提醒功能。
聚合20几个网站的信息，通过定时任务每小时采集一次，并可以通过点击标题来进行手动刷新，部分内容截图如下。
注意：截至2020年11月，百度、微博、煎蛋、搜狗明确禁止个人用户爬取任何信息，请在运行项目时严格删除相关代码。
由于网站规则可能变动，请在运行项目时依次检查本项目使用的数据源，当robots协议禁止个人用户爬取时，删除相关代码！
遵守robots协议，遵守爬虫道德，建立更好的互联网环境。
💖本项目的开发依赖的大量的优秀开源项目以及网站服务：
使用缓存数据和限制频次等方法对代码进行了优化，以避免爬取数据对网站造成较大的压力。
所获得数据仅供学习参考使用，如有侵权，请立即联系删除。
🥳如果本项目对你有启发或帮助，不妨支持一下开发者
