本仓库收纳 Windows / PowerShell 自动化脚本、本地媒体库服务、Pixiv / Venera 工具、本地管理面板和若干实验性 Web / 移动端项目。仓库不是 monorepo，也没有统一 workspace 管理；各 Node.js、Flutter、Docker 子项目按目录独立安装、启动和验证。
根目录是统一文档入口。正式 README 与 AGENTS 维护在根目录，子项目目录内不再保留跳转式 README。
| 文档 | 内容 | 状态 |
|---|---|---|
| AGENTS.md | Agent / Codex / 开发助手工作规范、提交要求、安全边界和验证建议。 | 当前维护 |
| README_Gallery.md | Gallery 后端、Web 前端、Lite 前端、扫描系统、API 和高风险操作。 | 当前维护 |
| README_Gallery-Flutter.md | Gallery Flutter 客户端配置、API 依赖、轮询扫描状态和测试方式。 | 当前维护 |
| README_pixiVenera.md | pixiVenera Venera 源、Pixiv / Fanbox 代理边界、OAuth PKCE 和 token 安全。 | 当前维护 |
| README_PowerShellTools-WebUI.md | 本地管理面板、只读索引、依赖检查、风险预览、Runner 和审计日志。 | 当前维护 |
| REPORT_Documentation_Update.md | 本轮文档统一更新报告、扫描结果、修改摘要和验证结果。 | 本轮报告 |
| 文档 | 内容 | 状态 |
|---|---|---|
| REPORT_pixiVenera_Gallery.md | pixiVenera 登录重构与 Gallery 审查记录。 | 历史报告 |
| PLAN.md | pixiVenera 登录重构计划。 | 历史计划 |
| PowerShellTools-WebUI-Plan.md | PowerShellTools-WebUI 设计、风险矩阵和实施计划。 | 历史计划 |
| Gallery 项目审查报告.md | Gallery 审查记录。 | 历史报告 |
| Gallery 项目高风险问题修复任务.md | Gallery 高风险问题修复任务记录。 | 历史任务 |
| Gallery 修复报告.md | Gallery 修复记录。 | 历史报告 |
| Gallery 阻塞问题修复报告.md | Gallery 阻塞问题修复记录。 | 历史报告 |
| Gallery 合并前回归复查报告.md | Gallery 合并前回归复查记录。 | 历史报告 |
历史报告保留在根目录，作为决策和验收记录；不要把它们当作当前启动手册或 API 权威来源。
| 区域 | 路径 | 说明 |
|---|---|---|
| PowerShell 自动化 | *.ps1、AutoClicker/、HyperOS/、Scrcpy/、Test-Photos/、WindowsISOs/、XiaomiBackups/ |
文件、照片、视频、Android、Windows 镜像和本机工具自动化脚本。 |
| Gallery 媒体库 | Gallery-Server/、Gallery-WebPage/、Gallery-WebPageLite/、Gallery-Flutter/ |
本地媒体库 API、完整 Web 前端、精简 Web 前端和 Flutter 客户端。 |
| Pixiv / Venera | pixiVenera/、Extractors/、Extractors-Playwright/、gallery-dl/ |
Venera 漫画源、Pixiv / Fanbox 抓取、Playwright 工具和下载后整理脚本。 |
| 本地管理面板 | PowerShellTools-WebUI/ |
仓库索引、依赖检查、服务状态、风险预览、低风险脚本运行和审计。 |
| Web / 服务实验 | WebPages/、docker/、danbooru/、MinecraftFriends/、bilimanga-server/ |
本地 Web 服务、PiGallery2 容器、Danbooru 发布和 API 实验。 |
| 数据与消息处理 | NapCat/、SnowLuma/ |
QQ / NapCat 数据、聊天记录统计和私密输出分析工具。 |
当前 Gallery 拆分为多个独立子项目：
| 子项目 | 入口 | 默认端口 | 说明 |
|---|---|---|---|
Gallery-Server/ |
server.js |
18081 |
Node.js 原生 HTTP API、SQLite 元数据、缩略图、短链和 /ws 扫描状态。 |
Gallery-WebPage/ |
server.js |
8081 |
完整 Web SPA，启动前检查后端 /api/health。 |
Gallery-WebPageLite/ |
server.js |
8081；Playwright 默认 9081 |
精简 Web SPA，包含 Playwright 测试。 |
Gallery-Flutter/ |
lib/main.dart |
无本地服务端口 | Flutter 客户端，默认访问 http://recriven.cn:18081。 |
详细说明见 README_Gallery.md 和 README_Gallery-Flutter.md。
pixiVenera/ 为 Venera 提供 Pixiv 插画、漫画、小说、搜索、收藏和图片代理能力。Node.js 服务端只做无状态 OAuth / API / 图片代理，不保存 token；独立版源可直接在 Venera 内完成 OAuth 与 Pixiv API 调用。详细说明见 README_pixiVenera.md。
PowerShellTools-WebUI/ 是本地管理面板，默认绑定 127.0.0.1:3000。它提供只读索引、依赖检查、风险预览、低风险 Runner 和审计日志，不继承 Gallery 媒体访问权限，也不保存 Pixiv token。详细说明见 README_PowerShellTools-WebUI.md。
脚本分散在根目录和多个业务目录中。运行前必须先确认脚本风险、输入路径、凭据来源和输出位置。danbooru/*.ps1、NapCat/*.ps1、SnowLuma/*.ps1 等目录存在凭据或私密输出约束，默认不要直接运行。
- Windows / PowerShell 是主要运行环境。
- Python 脚本必须使用项目级
.venv，Windows 下先执行.venv\Scripts\Activate.ps1。 - Node.js 子项目各自执行
npm install和npm start，没有全局 install / start 命令。 - Flutter 客户端在
Gallery-Flutter/内执行flutter pub get、flutter run -d windows和flutter test。 - 本地服务验证优先使用
127.0.0.1与curl.exe --noproxy *，避免 VSCode / Codex 环境中的 SOCKS5 代理影响 localhost。
- Gallery 没有内建认证，不应直接暴露公网。
- Gallery 扫描、缩略图生成、全库搜索和
/api/reindex*会读取真实媒体库，可能写入F:\Gallery\.gallery\gallery.db或缩略图缓存。 - pixiVenera 服务端不保存 OAuth token；token 只应存在于 Venera 客户端源数据或源设置中。
- PowerShellTools-WebUI 是本地管理面板，只允许低风险白名单脚本运行。
.env、OAuth body、Basic Auth、Bearer token、完整图片 URL 和私密聊天正文不应进入日志或文档输出。
提交规范以 AGENTS.md 为准：
- Conventional Commits：
type(scope): 中文描述，scope 使用英文模块名。 - 提交必须使用 SSH 签名：
--gpg-sign=~/.ssh/id_ed25519.pub。 - rebase / squash 时使用
--committer-date-is-author-date保留时间戳。 - 提交正文列出所有变动文件，并说明大致修改内容。
- 根目录 README 是导航入口，项目细节放入对应
README_*.md。 - 子目录 README / AGENTS 只有在存在不可合并的目录级规则时才保留；否则应合并到根目录文档体系。
- 当前事实以代码、
package.json、pubspec.yaml、路由实现和测试为准，历史报告仅作为背景。 - 文档使用中文为主，路径、命令、API 和技术名词保留英文原文。
- 新增正式文档优先使用
README_<ProjectName>.md、REPORT_<Topic>.md或PLAN_<Topic>.md命名。