Skip to content

Commit 7a5054a

Browse files
committed
revert README
1 parent 9b283ef commit 7a5054a

4 files changed

Lines changed: 205 additions & 47 deletions

File tree

CONTRIBUTING.md

Lines changed: 22 additions & 31 deletions
Original file line numberDiff line numberDiff line change
@@ -1,27 +1,22 @@
11
# ScriptCat 贡献指南
22

3-
我们非常感谢你为 ScriptCat 做出贡献!本指南旨在帮助你以更规范的方式向 ScriptCat
4-
提交贡献,因此请务必认真阅读。
3+
我们非常感谢你为 ScriptCat 做出贡献!本指南旨在帮助你以更规范的方式向 ScriptCat 提交贡献,因此请务必认真阅读。
54

65
## 提交 Issue
76

8-
在提交 Issue 前,我们建议你先查看
9-
[已有的 Issues](https://github.com/scriptscat/scriptcat/issues),以避免重复提交。
7+
在提交 Issue 前,我们建议你先查看 [已有的 Issues](https://github.com/scriptscat/scriptcat/issues),以避免重复提交。
108

119
### 报告问题、故障与漏洞
1210

13-
ScriptCat 是一个不断发展的项目。如果你在使用过程中发现问题,并且确信这些问题是由
14-
ScriptCat 引起的,欢迎提交 Issue。在提交时,请附带详细的复现步骤和运行环境信息。
11+
ScriptCat 是一个不断发展的项目。如果你在使用过程中发现问题,并且确信这些问题是由 ScriptCat 引起的,欢迎提交 Issue。在提交时,请附带详细的复现步骤和运行环境信息。
1512

1613
### 提出新功能
1714

18-
我们欢迎你在 Issue
19-
中提出新的功能建议。为了让我们更好地理解你的需求,建议你尽可能详细地描述这个功能,并提供你认为可能的解决方案。
15+
我们欢迎你在 Issue 中提出新的功能建议。为了让我们更好地理解你的需求,建议你尽可能详细地描述这个功能,并提供你认为可能的解决方案。
2016

2117
## Pull Request
2218

23-
ScriptCat 使用 [pnpm](https://pnpm.io/) 来管理项目依赖。如果你已经安装了
24-
npm,以下的命令可以帮助你快速配置开发环境:
19+
ScriptCat 使用 [pnpm](https://pnpm.io/) 来管理项目依赖。如果你已经安装了npm,以下的命令可以帮助你快速配置开发环境:
2520

2621
```bash
2722
# 安装 node.js 依赖
@@ -31,16 +26,13 @@ pnpm install
3126
我们推荐使用[代理](https://pnpm.io/npmrc#https-proxy)来解决 pnpm 的网络问题,而不是使用镜像。
3227

3328
```bash
34-
# 设置代理(linux/mac)
35-
export HTTPS_PROXY=http://127.0.0.1:1080
36-
# 设置代理(windows)
37-
set HTTPS_PROXY=http://127.0.0.1:1080
29+
pnpm config set proxy http://127.0.0.1:7890
30+
pnpm config set https-proxy https://127.0.0.1:7890
3831
```
3932

4033
### Commit 规范
4134

42-
我们希望每一个 commit 都能清晰地描述其目的,每个 commit
43-
应尽可能只包含一个修改。我们的 commit message 格式遵循
35+
我们希望每一个 commit 都能清晰地描述其目的,每个 commit 应尽可能只包含一个修改。我们的 commit message 格式遵循
4436
[gitmoji](https://gitmoji.dev/) 规范。例如:
4537

4638
```bash
@@ -62,12 +54,9 @@ git commit -m "✨ add login feature"
6254

6355
## 撰写文档
6456

65-
ScriptCat
66-
的文档在另外的仓库中:[scriptcat.org](https://docs.scriptcat.org),使用
67-
[docusaurus](https://docusaurus.io/)进行撰写,这有一些
68-
[Markdown](https://docusaurus.io/zh-CN/docs/markdown-features)
69-
特性可以帮助你。如果你需要在本地预览修改后的文档,可以使用以下命令安装文档依赖并启动
70-
dev server:
57+
ScriptCat的文档在另外的仓库中:[scriptcat.org](https://docs.scriptcat.org),使用
58+
[docusaurus](https://docusaurus.io/)进行撰写,这有一些 [Markdown](https://docusaurus.io/zh-CN/docs/markdown-features)
59+
特性可以帮助你。如果你需要在本地预览修改后的文档,可以使用以下命令安装文档依赖并启动dev server:
7160

7261
```bash
7362
npm install
@@ -76,27 +65,27 @@ npm start
7665

7766
### 帮助我们翻译
7867

79-
[Crowdin](https://crowdin.com/project/scriptcat) 是一个在线的多语言翻译平台。如果您有兴趣帮助我们翻译 ScriptCat 的相关内容,您可以在 Crowdin 上找到 ScriptCat 项目,并开始进行翻译工作。
68+
[Crowdin](https://crowdin.com/project/scriptcat)
69+
是一个在线的多语言翻译平台。如果您有兴趣帮助我们翻译 ScriptCat 的相关内容,您可以在 Crowdin 上找到 ScriptCat 项目,并开始进行翻译工作。
8070

8171
- `src/locales`[扩展](https://github.com/scriptscat/scriptcat)翻译文件目录
8272
- `public/locales`[脚本站](https://github.com/scriptscat/scriptlist-frontend)的翻译文件目录
8373

8474
#### 扩展开启所见即所得模式
8575

86-
扩展开启所见即所得模式需要使用`npm run i18n`模式进行构建,然后通过控制台设置伪语言`localStorage['language']='ach-UG';`,然后刷新页面。
76+
> 新版本暂未补充
8777
8878
#### 脚本站开启所见即所得模式
8979

9080
脚本站访问:[https://scriptcat.org/ach-UG](https://scriptcat.org/ach-UG) 即可开启所见即所得模式
9181

9282
## 参与开发
9383

94-
ScriptCat 使用 ESLint 来规范代码风格,使用 Jest
95-
来进行单元测试。你可以使用以下命令来运行:
84+
ScriptCat 使用 ESLint 来规范代码风格,使用 Vitest 来进行单元测试。你可以使用以下命令来运行:
9685

9786
```bash
98-
npm test
99-
npm run lint
87+
pnpm test
88+
pnpm run lint
10089
```
10190

10291
ScriptCat 的页面开发使用了以下技术:
@@ -109,17 +98,19 @@ ScriptCat 的页面开发使用了以下技术:
10998
如果你想在本地运行 ScriptCat,可以使用以下命令:
11099

111100
```bash
112-
npm run dev
101+
pnpm run dev
102+
# 请注意,由于未知原因,如果你需要使用隐身窗口,你需要使用下面的命令进行开发
103+
pnpm run dev:noMap
113104
```
114105

115106
如果你想打包扩展,可以使用以下命令:
116107

117108
```bash
118-
npm run pack
109+
pnpm run pack
119110
```
120111

121112
在打包前,请确保在`dist`目录下生成了`scriptcat.pem`文件。
122113

123114
## 注意问题
124115

125-
- `npm run dev`之后需要把`dist/ext`目录里面内容在浏览器扩展里面导入加载,然后开始改代码保存即可,浏览器是实时更新的,但是涉及到`manifest.json``service_worker``offscreen``sandbox`的改动需要重新导入加载
116+
- `pnpm run dev`之后需要把`dist/ext`目录里面内容在浏览器扩展里面导入加载,然后开始改代码保存即可,浏览器是实时更新的,但是涉及到`manifest.json``service_worker``offscreen``sandbox`的改动需要重新加载

README.md

Lines changed: 89 additions & 15 deletions
Original file line numberDiff line numberDiff line change
@@ -1,23 +1,97 @@
1-
# Rspack Project
1+
<h1 align="center">ScriptCat</h1>
22

3-
## Setup
3+
<p align="center">
4+
<img src="./build/assets/logo.png"/>
5+
</p>
46

5-
Install the dependencies:
7+
<p align="center">脚本猫,一个可以执行用户脚本的浏览器扩展,万物皆可脚本化,让你的浏览器可以做更多的事情!</p>
68

7-
```bash
8-
npm install
9-
```
9+
<p align="center">
10+
<a href="https://docs.scriptcat.org/">文档</a> ·
11+
<a href="https://bbs.tampermonkey.net.cn/">社区</a> ·
12+
<a href="https://scriptcat.org/search">脚本站</a>
13+
</p>
1014

11-
## Get Started
15+
<p align="center">
16+
<a href="./README_EN.md">English README</a>
17+
</p>
1218

13-
Start the dev server:
19+
![GitHub stars](https://img.shields.io/github/stars/scriptscat/scriptcat.svg)
20+
[![Build Status](https://github.com/scriptscat/scriptcat/workflows/build/badge.svg?branch=main)](https://github.com/scriptscat/scriptcat)
21+
[![codecov](https://codecov.io/gh/scriptscat/scriptcat/branch/main/graph/badge.svg?token=G1A6ZGDQTY)](https://codecov.io/gh/scriptscat/scriptcat)
22+
![GitHub tag (latest SemVer)](https://img.shields.io/github/tag/scriptscat/scriptcat.svg?label=version)
23+
[![Chrome](https://img.shields.io/badge/chrome-sucess-brightgreen?logo=google%20chrome)](https://chrome.google.com/webstore/detail/scriptcat/ndcooeababalnlpkfedmmbbbgkljhpjf)
24+
[![Edge](https://img.shields.io/badge/edge-sucess-brightgreen?logo=microsoft%20edge)](https://microsoftedge.microsoft.com/addons/detail/scriptcat/liilgpjgabokdklappibcjfablkpcekh)
25+
[![FireFox](https://img.shields.io/badge/firefox-sucess-brightgreen?logo=firefox)](https://addons.mozilla.org/zh-CN/firefox/addon/scriptcat/)
26+
![GitHub All Releases](https://img.shields.io/github/downloads/scriptscat/scriptcat/total)
1427

15-
```bash
16-
npm run dev
17-
```
28+
## 关于脚本猫
1829

19-
Build the app for production:
30+
参考了油猴的设计思路并且支持油猴脚本,实现了一个后台脚本运行的框架,提供了一些特殊的
31+
API,让脚本能够做更多的事情.并且提供了一个优秀的编辑器,让脚本代码编写开发更加舒服流畅.
2032

21-
```bash
22-
npm run build
23-
```
33+
**如果觉得好用,顺手点个 Star 吧 ❤❤❤**
34+
35+
## 特性
36+
37+
- 脚本云同步,更换浏览器/重装,脚本恢复更方便.
38+
- 脚本订阅,创建自己的脚本合集或者让多个脚本配合使用.
39+
- 支持油猴脚本,无缝从其它油猴脚本管理器迁移.
40+
- 后台脚本,可以使你的脚本持续的运行在后台.
41+
- 定时脚本,可以每日定时执行,每天通过脚本定时处理事务.可用于自动签到,定时提醒等功能.
42+
- 丰富的 API,相比于油猴,扩展出了更多强大的 API,可以实现更多的功能.
43+
- 通过沙盒机制确保了用户的安全,用户确定后才会给脚本授予权限.
44+
- 优秀的编辑器,且提供了 API 的自动补全和 ESLint.
45+
- 美观的 UI
46+
47+
...更多丰富功能加入中
48+
49+
## 说明
50+
51+
### 安装脚本
52+
53+
可以从各大用户脚本市场[获取脚本](https://docs.scriptcat.org/docs/use/#%E8%8E%B7%E5%8F%96%E8%84%9A%E6%9C%AC)进行安装,脚本猫所支持的后台脚本专门建立了一个市场:[后台脚本](https://bbs.tampermonkey.net.cn/forum-68-1.html).
54+
55+
安装方式与油猴一样,同时也是兼容绝大部分油猴脚本的,如果遇到未兼容的脚本,你可以通过[issue](https://github.com/scriptscat/scriptcat/issues)反馈给我们.
56+
57+
对于开发者来说,也可以参考这些脚本写出自己的脚本来.
58+
59+
### 开发文档
60+
61+
[开发文档](https://docs.scriptcat.org/docs/dev/)尽力完善中,因为是参考油猴的设计,与油猴脚本相通的地方很多,就算你使用其它油猴管理器,你也可以参考脚本猫的文档来开发!
62+
63+
如果开发文档有什么错误,或者你想进行补全,你可以点击下方的`编辑此页`进行修改.
64+
65+
### 安装扩展
66+
67+
我们已经上架了扩展商店,如果你无法访问商店内容,请在[release](https://github.com/scriptscat/scriptcat/releases)中下载
68+
zip 包手动进行安装
69+
70+
#### 扩展商城
71+
72+
- [Chrome 商店](https://chrome.google.com/webstore/detail/scriptcat/ndcooeababalnlpkfedmmbbbgkljhpjf)
73+
- [Edge 商店](https://microsoftedge.microsoft.com/addons/detail/scriptcat/liilgpjgabokdklappibcjfablkpcekh)
74+
- [FireFox 商店](https://addons.mozilla.org/zh-CN/firefox/addon/scriptcat/)
75+
76+
### 交流
77+
78+
- [Telegram](https://t.me/scriptscat)
79+
- [油猴中文网](https://bbs.tampermonkey.net.cn/)
80+
81+
## License
82+
83+
本项目使用 GPLv3 协议开源, 请遵守协议规定.
84+
85+
[![FOSSA Status](https://app.fossa.com/api/projects/git%2Bgithub.com%2Fscriptscat%2Fscriptcat.svg?type=large)](https://app.fossa.com/projects/git%2Bgithub.com%2Fscriptscat%2Fscriptcat?ref=badge_large)
86+
87+
## 贡献
88+
89+
请参考 [贡献指南](./CONTRIBUTING.md)
90+
91+
### 鸣谢
92+
93+
感谢以下开发者对 ScriptCat 作出的贡献,有你们 ScriptCat 才能变得更好!
94+
95+
<a href="https://github.com/scriptscat/scriptcat/graphs/contributors">
96+
<img src="https://contrib.rocks/image?repo=scriptscat/scriptcat&max=1000" />
97+
</a>

README_EN.md

Lines changed: 93 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,93 @@
1+
<h1 align="center">ScriptCat</h1>
2+
3+
<p align="center">
4+
<img src="./build/assets/logo.png"/>
5+
</p>
6+
7+
<p align="center">ScriptCat, a browser extension that can execute user scripts, everything can be scripted, allowing your browser to do more things!</p>
8+
9+
<p align="center">
10+
<a href="https://docs.scriptcat.org/">Docs</a> ·
11+
<a href="https://bbs.tampermonkey.net.cn/">Community</a> ·
12+
<a href="https://scriptcat.org/search">Script Hub</a> ·
13+
</p>
14+
15+
<p align="center">
16+
<a href="./README.md">中文说明</a>
17+
</p>
18+
19+
![GitHub stars](https://img.shields.io/github/stars/scriptscat/scriptcat.svg)
20+
[![Build Status](https://github.com/scriptscat/scriptcat/workflows/build/badge.svg?branch=main)](https://github.com/scriptscat/scriptcat)
21+
[![codecov](https://codecov.io/gh/scriptscat/scriptcat/branch/main/graph/badge.svg?token=G1A6ZGDQTY)](https://codecov.io/gh/scriptscat/scriptcat)
22+
![GitHub tag (latest SemVer)](https://img.shields.io/github/tag/scriptscat/scriptcat.svg?label=version)
23+
[![Chrome](https://img.shields.io/badge/chrome-sucess-brightgreen?logo=google%20chrome)](https://chrome.google.com/webstore/detail/scriptcat/ndcooeababalnlpkfedmmbbbgkljhpjf)
24+
[![Edge](https://img.shields.io/badge/edge-sucess-brightgreen?logo=microsoft%20edge)](https://microsoftedge.microsoft.com/addons/detail/scriptcat/liilgpjgabokdklappibcjfablkpcekh)
25+
[![FireFox](https://img.shields.io/badge/firefox-sucess-brightgreen?logo=firefox)](https://addons.mozilla.org/zh-CN/firefox/addon/scriptcat/)
26+
![GitHub All Releases](https://img.shields.io/github/downloads/scriptscat/scriptcat/total)
27+
28+
## About
29+
30+
We built a framework for executing background scripts and Greasemonkey/Tampermonkey scripts based on the design ideas of Greasemonkey/Tampermonkey. It also has several unique APIs that enable scripts to do more. Furthermore, we provide a fantastic online editor that makes script code development more pleasant and easy.
31+
32+
**Please Star it if you find it useful. ❤❤❤**
33+
34+
## Features
35+
36+
- Cloud Sync: script recovery is easy when changing or reinstalling browser
37+
- Scripts subscription: creating your own script collections or enabling multiple scripts to work together.
38+
- Compatibility: allowing seamless migration from other userscript managers.
39+
- Background scripts: allowing your scripts to run continuously in the background.
40+
- Scheduled scripts: allowing for daily scheduled tasks. You can use them for automatic check-ins, timed reminders, and more.
41+
- Rich API: more powerful APIs than other managers, which can realize more functions.
42+
- Sandbox mechanism: ensuring user safety, script permissions are granted only with user consent.
43+
- Excellent editor: providing API auto-completion and ESLint.
44+
- Nice UI
45+
46+
...More features are Coming.
47+
48+
## Instructions
49+
50+
### Install script
51+
52+
You can get normal userscripts from [major userscript markets](https://docs.scriptcat.org/docs/use/#%E8%8E%B7%E5%8F%96%E8%84%9A%E6%9C%AC) and background scripts from [Background Scripts](https://bbs.tampermonkey.net.cn/forum-68-1.html) which is supported by ScriptCat.
53+
54+
The installation method is the same as Greasemonkey/Tampermonkey, and it is also compatible with the majority of userscripts. If you encounter any incompatible scripts, you can provide feedback to us through [issues](https://github.com/scriptscat/scriptcat/issues).
55+
56+
### Script development documentation
57+
58+
The [Documentation](https://docs.scriptcat.org/docs/dev/) is trying its best to improve. Because it refers to the design of Greasemonkey/Tampermonkey, there are many similarities with their scripts. Even if you use other script managers, You can also refer to the documentation of ScriptCat to develop!
59+
60+
Suppose there are any errors in the development documentation or you would like to make additions. In that case, you can click the "Edit this page" link below to make changes.
61+
62+
### Install extension
63+
64+
We have published our extension in the Chrome or Firefox store. If you cannot access the store, please download the ZIP package manually from the [release](https://github.com/scriptscat/scriptcat/releases) and install it.
65+
66+
#### Extension store
67+
68+
- [Chrome Store](https://chrome.google.com/webstore/detail/scriptcat/ndcooeababalnlpkfedmmbbbgkljhpjf)
69+
- [Edge Store](https://microsoftedge.microsoft.com/addons/detail/scriptcat/liilgpjgabokdklappibcjfablkpcekh)
70+
- [Firefox Store](https://addons.mozilla.org/zh-CN/firefox/addon/scriptcat/)
71+
72+
### Discussion
73+
74+
- [Telegram](https://t.me/scriptscat)
75+
- [油猴中文网](https://bbs.tampermonkey.net.cn/)
76+
77+
## License
78+
79+
This project is open source under the GPLv3 license. Please comply with the terms and conditions of the license.
80+
81+
[![FOSSA Status](https://app.fossa.com/api/projects/git%2Bgithub.com%2Fscriptscat%2Fscriptcat.svg?type=large)](https://app.fossa.com/projects/git%2Bgithub.com%2Fscriptscat%2Fscriptcat?ref=badge_large)
82+
83+
## Contribution
84+
85+
Please refer to [Contribution Guidelines](./CONTRIBUTING.md)
86+
87+
### Thanks
88+
89+
Thanks to the following developers for contributing to ScriptCat and making ScriptCat even better!
90+
91+
<a href="https://github.com/scriptscat/scriptcat/graphs/contributors">
92+
<img src="https://contrib.rocks/image?repo=scriptscat/scriptcat&max=1000" />
93+
</a>

package.json

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -11,7 +11,7 @@
1111
"coverage": "vitest run --coverage",
1212
"build": "cross-env NODE_ENV=production rspack build",
1313
"dev": "cross-env NODE_ENV=development rspack",
14-
"dev-noMap": "cross-env NODE_ENV=development NO_MAP=true rspack",
14+
"dev:noMap": "cross-env NODE_ENV=development NO_MAP=true rspack",
1515
"pack": "node ./scripts/pack.js",
1616
"format": "prettier --write .",
1717
"lint": "eslint .",

0 commit comments

Comments
 (0)