Skip to content

README.md

Latest commit

 

History

History
82 lines (62 loc) · 4.03 KB

README.md

File metadata and controls

82 lines (62 loc) · 4.03 KB

仓库介绍 · 画廊介绍 · pixiVenera 漫画源 · 重构审查报告 · PowerShell-Tools WebUI

PowerShell-Tools WebUI

本目录实现 PowerShellTools-WebUI-Plan.md 的本地管理面板。它是独立的 Node.js 原生 HTTP 应用，不复用 Gallery 的媒体访问权限，也不自动安装 npm、Python、Docker 或 Playwright 依赖。

启动

cd d:\GitHubRecRivenVI\PowerShell-Tools\PowerShellTools-WebUI
node server.js

默认监听 http://127.0.0.1:3000。如端口被占用：

$env:WEBUI_PORT = "3001"
node server.js

已实现范围

  • 仓库只读索引：扫描 .ps1、关键 .py/.js、package.json、docker-compose.yml 和计划/README 文档。
  • 风险识别：标记删除、移动、重命名、系统设置、镜像挂载、ADB/fastboot、网络请求、硬编码凭据、私密输出等风险。
  • 脚本详情页：源码只读预览，命中行脱敏显示。
  • 依赖检查：PowerShell、Node、npm、git、gh、7z、ExifTool、ffmpeg、aria2c、adb/scrcpy、Docker、Edge、项目 .venv 和端口。
  • 低风险 Runner：仅允许白名单中的只读 PowerShell 脚本运行，记录任务 ID、脚本 hash、stdout/stderr、退出码和耗时。
  • 高风险影响预览：不执行脚本，只提取破坏性命中、可能影响路径、dry-run 线索、所需凭据名称和审计要求。
  • 实时日志：/api/jobs/:id/events SSE 推送，默认视图使用脱敏日志。
  • 输出解析：照片 CSV、SnowLuma 统计、Fanbox metadata、HyperOS 数据、Gallery reindex、Windows ISO、Danbooru JSON、AutoClicker 配置。
  • 服务状态：Gallery、pixiVenera、WebPages 的本地直连健康检查。
  • 文档入口：可查看根 README、AGENTS、Gallery/pixiVenera 文档、审查报告和本计划。

VSCode Codex + SOCKS5 代理注意事项

WebUI 启动时会补齐：

NO_PROXY=localhost,127.0.0.1,::1,0.0.0.0,*.local
no_proxy=localhost,127.0.0.1,::1,0.0.0.0,*.local

后端对 Gallery、pixiVenera、WebPages 等本地服务使用 127.0.0.1 和 Node 原生 http 直连检查，不通过 SOCKS5 代理。若健康检查失败但端口实际存在，优先检查 VSCode/Codex 环境中的 NO_PROXY / no_proxy 是否被覆盖。

外网请求目前不由 WebUI 自动执行；未来若接入外网 API，应显式区分“本地服务”和“外网资源”，并在日志中标注。

安全默认值

  • .env 只显示存在性，不读取内容。
  • SnowLuma/output/groups/*/chat-record.md 默认不扫描正文。
  • danbooru/*.ps1、NapCat/*.ps1、SnowLuma/*.ps1、HyperOS/patchboot.ps1、批量删除/移动/重命名脚本默认不可运行。
  • Python 脚本必须等待项目 .venv 存在且策略允许后才能运行。
  • 高风险脚本需要未来审批流、dry-run、影响路径预览和审计日志。
  • Gallery 媒体服务、WebUI 脚本执行、Pixiv 代理、QQ/NapCat 私密输出保持独立信任边界。

API 摘要

API 用途
GET /api/catalog 仓库索引、脚本风险、文档、策略和解析器列表
GET /api/script?path=... 单个脚本详情
GET /api/dependencies 依赖、固定路径、端口检查
GET /api/preview?path=... 脚本影响预览与阻止原因
GET /api/services 本地服务健康检查
GET /api/parsers 解析器列表
GET /api/parser?id=... 输出解析结果
POST /api/jobs 启动低风险白名单脚本
GET /api/jobs/:id/events SSE 实时日志
POST /api/jobs/:id/cancel 取消运行中任务
GET /api/audit 审计事件
GET /api/docs?path=... 允许清单内文档

测试

cd d:\GitHubRecRivenVI\PowerShell-Tools\PowerShellTools-WebUI
node tests/run-tests.js

测试覆盖本地代理绕过配置、脱敏、仓库索引、风险阻止、低风险白名单、服务检查、解析器和核心 API。