173d1146dc | ||
---|---|---|
.github | ||
README | ||
build | ||
config | ||
src | ||
static | ||
.babelrc | ||
.editorconfig | ||
.eslintignore | ||
.eslintrc.js | ||
.gitignore | ||
.postcssrc.js | ||
LICENSE | ||
README.md | ||
index.html | ||
package-lock.json | ||
package.json |
README.md
stapxs-qq-lite
简体中文 | English (US)
Stapxs QQ Lite 2.0
这是一个兼容 oicq-http2 的非官方网页版 QQ 客户端
使用 Vue 重新编写的全新版本
本网页应用仅供学习交流使用,请勿用于其他用途
版权争议请提出 issue 协商
快速使用
访问应用 - Github Pages
本仓库开启了 GitHub Pages, 所有向主分支提交的代码将会自动构建并发布。你可以直接访问 这儿 来使用已经构建并部署的页面。
运行服务 - oicq2-http
Stapxs QQ Lite 需要一个 QQ Bot 来支持功能,目前 2.0 版本只支持定制的 oicq-http2 克隆版本,你可以在 这个仓库 下载到它。
在开始运行服务前,请确认你的设备已经安装了 yarn
以用于运行,在终端(cmd、powershell、zsh 等)运行 yarn -v
来确认安装。
如果一切没问题,那么将终端转到 oicq 的目录下,开始运行 Bot 服务。
-
更新依赖
运行
yarn
指令, yarn 将会为仓库进行初始化安装运行所需要的依赖: -
配置设置文件
在 oicq 的目录下有一个示例的设置文件
config.json
,你可以修改它来配置相关设置,你需要保证使用 Websocket 的选项是打开的,并且为了安全性需要设置连接密钥:完成修改后把它放置到用户目录下的
.oicq
文件夹里,Windows 用户应该为:C://User/[name]/.oicq
,Linux 用户则是:/home/[name]/.oicq
,如果文件夹不存在请自行创建。 -
启动服务
准备工作都完成了。下面回到终端,运行指令
yarn start [QQ]
启动服务:如果没什么问题的话, oicq-http2 应该会像上面这样完成启动,就快完成了!
-
连接服务
回到应用页面,输入地址和密钥连接服务,大功告成!
其他提醒
关于不安全连接
- 当使用 https 页面连接 ws 服务(反之相同)的情况下,连接将会失败;这是由于其中某一者是不安全的。在这种情况下,你可以选择将 ws 提升为 wss 或者将 https 降级为 http(不安全)来解决问题,此处不提供解决方案。Stapxs-QQ-Lite#32
更多问题
我能使用其他 QQ Http Bot 吗
-
如果它兼容 OneBot 11 协议, 你可以尝试连接它, 但是由于消息体格式和接口扩展的差异,大部分情况下都不能完全正常使用。
-
以下是已兼容的 Bot:
- oicq http v2:完全兼容
-
以下是计划兼容的 Bot:
- oicq http v1:完全兼容计划
- go-cqhttp:完全兼容计划
使用 Bot 是否有风险
- 如果你使用的是 oicq-http, 可以查看此处了解 使用风险, 如果你尝试使用其他 QQ Bot (参见上一条问题), 请自行参考它的文档。
我遇到了问题
- 如果有什么奇奇怪怪的问题, 欢迎发起 issue 询问! 如果有什么 BUG 和优化建议也可以哦!
构建应用
Stapxs QQ Lite 2.0 是一个基于 Vue 的单页应用,这意味着如果你想自行部署服务需要进行构建,你可以参考下面的 bash 进行构建:
注意,在正式构建前,你需要修改 config/index.js
内 build
下 assetsPublicPath
的值,它代表着最终你会运行在的地址,比如它现在是 https://stapxs.github.io/Stapxs-QQ-Lite-2.0/
;这个参数可以使用 /
直接表示运行在根域名,但是它不可以为空。
# 安装依赖
npm install
# 运行热重载开发模式在本机 8080 端口
npm run dev
# 构建应用
npm run build
* 你可以查看这些文档了解构建流程详情 guide 、 vue-loader 文档。
这是构建的一个例子: