|
|
||
|---|---|---|
| .github/workflows | ||
| .vscode | ||
| conf | ||
| docs | ||
| public | ||
| src | ||
| .dockerignore | ||
| .env | ||
| .gitignore | ||
| Dockerfile | ||
| index.html | ||
| jsconfig.json | ||
| LICENSE | ||
| package.json | ||
| pnpm-lock.yaml | ||
| README.md | ||
| vercel.json | ||
| vite.config.js | ||
Luxirty Search
一个搜索引擎，基于 Google，屏蔽内容农场，无广告，无跟踪，干净，简洁，快。
如果想添加到浏览器中，搜索语法是 search.luxirty.com/search?q=
特性&功能
- 内置内容农场屏蔽，包括csdn、华x云、百度云智能、腾讯云开发者等seo网站，以及一些 stackoverflow 中文翻译站。
Note
你可以在 /docs/block_list.txt中查看完整的屏蔽名单。
-
点击
For Program一键拉高 GitHub、Stackoverflow、v2ex、cnblog 权重，免去手打 site: 的麻烦。 -
一键搜索 v2ex 、 Raddit
-
内置广告屏蔽、跟踪链接移除。
与 uBlackList, Hit by Hidden 等工具的区别
这些工具在前端屏蔽搜索结果，也就是等到内容农场已经出现在搜索结果中，再将其删除或隐藏。
而 Luxirty Search 通过配置 Annotations 让 Google 直接屏蔽垃圾网站，服务器在执行搜索时就已经将网站排除，可以理解为内置多条 '-site:domain.com' 。
Contribute
欢迎 pr 和 issue。
本项目并不复杂，只需要基础的前端知识 (css + js) 即可看懂本项目。
下面是几个较简单的切入点，可以尝试从这里入手。
优化样式
本项目最大的作用其实是美化 cse 那个上古默认样式，我进行了基础的调整、暗黑适配、移动端适配，但肉眼可见的还有很多问题 Orz。
分享黑名单或优化名单
理论上而言，利用 GitHub Action 来自动生成 Annotations 文件是最好的做法，但我还没写(逃，所以目前直接写在 issue 里。
你可以分享这些域名：
- 黑名单域名：这些域名会直接被屏蔽
- 代码相关的高质量来源：这些域名被视作优质来源，当点击“For Program”标签时优先级会被提高。
- 当然，如果你认为有必要添加新的标签也可以提出来。
当前的缺陷
-
对不同尺寸的屏幕适配不完整
-
暗黑模式下还有部分元素过亮或者过暗
未来计划
-
根据标题进行二次拦截
-
加入自动翻页（这个还不知道怎么实现）
经验分享
如果你在你的博客中介绍了本项目，欢迎将链接分享到issue，如果内容对其它使用本项目的用户有帮助(较为详细的介绍/部署教程/或其它任意有帮助的内容),我们会将您的文章链接添加到readme中。
原理
Luxirty Search 基于 Google 的可编程自定义搜索引擎(Google cse)，允许通过 Annotations 自定义屏蔽网站及搜索范围等，同时使用 Refinement Labels 提高 Github 等优质来源的权重。
用人话来说，就是内置了屏蔽哪些网站、优先搜索哪些网站。
已知缺陷
这些缺陷是 Google CSE 或其它限制导致的，可能得不到解决。
- 设置为默认引擎时，搜索栏无法自动补全（网页中有自动补全）
- 无法根据时间筛选结果
- 缺乏同义词替换，虽然 Google CSE 基于 Google，但 Google 官网的搜索引擎运用了多种技术来优化搜索结果，最显著的一点是同义词搜索，当使用的术语有所区别时，Google官网会使用意思相近的同义词进行搜索，而 Google CSE 不会，这会导致某些情况下的结果明显少于官网。
部署
本质上而言，这是一个简单的 vue3 + vite 项目，因此你应该可以方便地将它部署到任何你喜欢的托管网站，例如 GitHub Pages、netfliy、Cloudflare Pages、vercel之类的。
当然你也可以将其部署在自己的服务器上。
无论你喜欢哪种方式，都只需要查看 vite 部署教程: https://cn.vitejs.dev/guide/static-deploy
(可选)如果你想使用自己的cse，只需设置环境变量 VITE_GOOGLE_CSE_CX ，从这里创建你的 cse 并获取 cx： https://programmablesearchengine.google.com/about/
注意：
- 如果你使用自己创建的 cse，那么的部署看起来会有区别，页面上的“For Program”等标签是通过 cse 的 “优化” 功能配置的。你需要先添加域名，然后添加对应标签，并在标签中选中想提升的域名。
- 你还需要修改 opensearch.xml 中的域名，详细请看 https://github.com/KoriIku/luxirty-search/issues/14
一键部署(推荐)
Deploy with Vercel
(搜索页404的问题已修复)
Deploy to Netlify
Docker 运行 （感谢 @shadowofmoo）
docker run --rm -p 80:80 ghcr.io/koriiku/luxirty-search
开发
参考资料
唯一要看的参考资料：https://developers.google.com/custom-search/docs/element
在本地调试
pnpm install
Compile and Hot-Reload for Development
pnpm dev
Compile and Minify for Production
pnpm build
更新记录
- 加快了启动速度
- 添加了移除搜索结果中的跟踪链接 data-ct*
- 移除了文字阴影