v0.11.0

Author: URenko

README.en.md

@@ -14,7 +14,7 @@ Because the main users of this project are in mainland China, you may encounter
 
 ## Usage
 ### If you don't know what Python is
-Download Windows executable program from [here](https://github.com/URenko/Accesser/releases/download/v0.10.3/accesser.exe) and run it. The first time you use it, you will be asked to install a certificate, just select yes.
+Download Windows executable program from [here](https://github.com/URenko/Accesser/releases/download/v0.11.0/accesser.exe) and run it. The first time you use it, you will be asked to install a certificate, just select yes.
 ### If Python 3.10* or later is already installed
 ```
 pip3 install -U "accesser[doh,doq]"
@@ -32,7 +32,16 @@ In addition, for Windows, by default (without specifying `--notimportca`) the ce
 *You can use, for example, [pyenv](https://github.com/pyenv/pyenv) to install the required version of Python (Python 3.11+ is recommended).
 
 ## Configuration
-After starting Accesser once, `config.toml` and `rules.toml` will be generated in the **working directory**. See the comments therein. After saving, reopen the program.
+After launching Accesser once, the following files and directories will be created in the **working directory**:
+
+* `config.toml`: Basic settings
+* `rules.toml`: Advanced rules. It will be automatically updated if unmodified. (delete it to restore auto-updates)
+* `rules/` directory: Place your custom advanced rules here
+
+See the inline comments for details; after saving your edits, restart the application. You can also refer to the [`custom.toml.sample`](accesser/custom.toml.sample) for examples of how to configure advanced rules.
+
+You may additionally place PAC files in the **working directory** to define specific routing rules (the default PAC is available here: [https://github.com/URenko/Accesser/blob/master/accesser/pac](https://github.com/URenko/Accesser/blob/master/accesser/pac)).
+
 
 ## Advanced Usage 1: Use with other proxy software such as v2ray
 Accesser is a local HTTP proxy with a default proxy address of `http://localhost:7654`, which can be used in combination with other proxy software as long as the network traffic can be exported as HTTP proxy.

README.md

@@ -11,7 +11,7 @@
 
 ## 使用
 ### 如果不知道什么是Python
-从[这里](https://github.com/URenko/Accesser/releases/download/v0.10.3/accesser.exe)下载Windows一键程序，运行既可（建议关闭其他代理软件），首次使用会要求安装证书，选是即可。
+从[这里](https://github.com/URenko/Accesser/releases/download/v0.11.0/accesser.exe)下载Windows一键程序，运行既可（建议关闭其他代理软件），首次使用会要求安装证书，选是即可。
 ### 如果已经安装了Python 3.10*或更高版本
 ```
 pip3 install -U "accesser[doh,doq]"
@@ -29,7 +29,16 @@ accesser
 *可以使用例如[pyenv](https://github.com/pyenv/pyenv)来安装所需的Python版本（推荐Python 3.11+）。
 
 ## 设置
-启动一次Accesser后，会在 **工作目录** 下生成`config.toml`，具体含义见其中注释，保存后重新打开程序。同时也会生成目录 `rules`，用于存放规则文件。规则的配置方式请参见 [`custom.toml.sample`](accesser/custom.toml.sample)
+启动一次Accesser后，会在 **工作目录** 下生成如下文件和目录：
+
+- `config.toml`：一些基础设置
+- `rules.toml`: 进阶规则，在不曾被修改过的情况下会自动更新（删除它可恢复自动更新）
+- `rules`目录: 可存放自定义进阶规则
+
+具体含义见其中注释，保存后重新打开程序。
+进阶规则的配置方式也可参见 [`custom.toml.sample`](accesser/custom.toml.sample)。
+
+**工作目录** 下也可放置 pac 文件制定具体的路由规则（默认 pac 见 https://github.com/URenko/Accesser/blob/master/accesser/pac ）。
 
 ## 进阶1: 与v2ray等其他代理软件一起使用
 Accesser是一个本地HTTP代理，默认代理地址为`http://localhost:7654`，只要网络流量能从其他代理软件以HTTP代理导出就能联合使用。

accesser/__init__.py

@@ -16,7 +16,7 @@
 # You should have received a copy of the GNU General Public License
 # along with this program.  If not, see <http://www.gnu.org/licenses/>.
 
-__version__ = '0.10.3'
+__version__ = '0.11.0'
 
 import os, sys
 import json

accesser/custom.toml.sample

@@ -1,7 +1,7 @@
 # 这是Accesser的规则（除路由规则）文件。
 # This is the rule (except routing rules) file of Accesser.
-# 将 toml 格式的规则文件放置在工作目录下的 rules 目录可向 Accesser 添加规则。规则优先级为 `config.toml` > `rules/*.toml` > 安装目录下的 `rules.toml`
-# You can add rules to the Accesser by placing a toml-formatted rules file in the rules directory under the working directory. Rules with priority of 'config.toml' > 'rules/*.toml' > 'rules.toml' in the installation directory
+# 将 toml 格式的规则文件放置在工作目录下的 rules 目录可向 Accesser 添加规则。规则优先级为 `config.toml` > `rules/*.toml` > 工作目录下的 `rules.toml`
+# You can add rules to the Accesser by placing a toml-formatted rules file in the rules directory under the working directory. Rules with priority of 'config.toml' > 'rules/*.toml' > 'rules.toml' in the working directory
 
 [DNS]
 

accesser/rules.toml

@@ -1,9 +1,9 @@
-# 请不要直接修改此文件。你可以通过将配置文件复制到工作目录下的 rules 文件夹中以达到向 Accesser 添加规则的目的。
-# Please do not edit the file directly. You can copy the rules configuration file to the rules directory under working directory to add rules to Accesser.
 # 这是Accesser的规则（除路由规则）文件。
 # This is the rule (except routing rules) file of Accesser.
-# 在未曾被修改过的情况下，它会自动随Accesser更新。
-# If it has not been modified, it will be automatically updated with Accesser.
+# 该文件在不曾被修改过的情况下会自动更新。因而不建议一般用户直接修改。
+# This file will be automatically updated if it hasn’t been modified. Therefore, ordinary users are not advised to modify it directly.
+# 你也可以通过将配置文件复制到工作目录下的 rules 文件夹中以达到向 Accesser 添加规则的目的。
+# You can also copy the rules configuration file to the rules directory under working directory to add rules to Accesser.
 
 [DNS]
 

pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "accesser"
-version = "0.10.3"
+version = "0.11.0"
 authors = [
   { name="URenko" },
 ]