PixFilter

PixFilter 是一个 Pixiv 浏览器增强筛选工具。你在网页中创建标签规则，浏览器插件在 Pixiv 列表页执行 OR / AND / NOT 筛选；作品仍然回到 Pixiv 查看。

Windows 普通用户安装

1. 下载

普通用户不要点击 Code → Download ZIP（那是开发者源码）。请直接下载最新版安装程序：

下载 PixFilter-Setup.exe

也可以进入 GitHub Releases 查看全部版本。

不需要安装 Node.js、npm、Git 或 PostgreSQL。

当前安装包尚未购买 Windows 代码签名证书。如果 Windows SmartScreen 显示“未知发布者”，请确认文件来自本项目的 GitHub Release，再选择“更多信息 → 仍要运行”。

2. 安装并启动

双击 PixFilter-Setup.exe 完成安装。安装器会：

• 安装 PixFilter 本地网站和后端服务；
• 安装自带的 Node.js 运行时；
• 创建桌面与开始菜单快捷方式；
• 启动本地服务；
• 在默认浏览器打开 http://localhost:3000。

以后只需双击桌面的 PixFilter。 ***localhost:3000 仅在 PixFilter 服务运行期间可访问，关闭 PixFilter 后本地页面会暂时不可用。

3. 安装 Chrome 插件

当前插件尚未发布到 Chrome Web Store，因此只需执行一次：

1. 在 Chrome 打开 chrome://extensions。

2. 打开右上角“开发者模式”。

3. 点击“加载已解压的扩展程序”。

4. 选择这个文件夹：

   %LOCALAPPDATA%\Programs\PixFilter\extension

注意：要选择 extension 文件夹本身；其中根目录直接包含 manifest.json。

4. 使用

1. 从桌面启动 PixFilter。
2. 在网站中进入本地筛选空间，创建或编辑筛选规则。
3. 打开 Pixiv 搜索结果或标签列表页面。
4. 点击右下角“PixFilter 分析当前列表”。
5. 选择规则，插件会保留匹配作品，并只隐藏明确不匹配的作品。

数据与安全

• PixFilter 不读取或保存 Pixiv 密码。
• 本地规则与运行数据保存在 %LOCALAPPDATA%\PixFilter。
• 安装文件位于 %LOCALAPPDATA%\Programs\PixFilter。
• 本地服务只监听 127.0.0.1，默认端口为 3000。
• 卸载程序不会主动删除你的规则数据，避免误删；如需彻底清除，可在卸载后手动删除 %LOCALAPPDATA%\PixFilter。

常见问题

如果浏览器没有自动打开，请双击桌面 PixFilter，或手动访问 http://localhost:3000。

如果端口 3000 被占用，可编辑安装目录中的 config\pixfilter.env，修改 PIXFILTER_PORT。修改端口后，也要在插件设置页填写相同的网站 URL。

开发、测试和打包说明见 DEVELOPMENT.md。