259 lines
8.2 KiB
Go
259 lines
8.2 KiB
Go
// Package nsfw 负责"色情图片识别"：本机 Python + NudeNet 起一个本地 HTTP 服务，
|
||
// Go 侧把图片路径发给它，拿到"是否色情"和最高敏感分。
|
||
//
|
||
// 大白话理解：NudeNet 是开源里口碑不错的离线鉴黄模型（python 库，自带模型）。
|
||
// 我们不想让 Go 里掺一堆深度学习依赖，所以让 python 当"外援"：
|
||
// - 扫描开始时拉起一个常驻的 python 小服务（模型只加载一次）；
|
||
// - 探测图片时逐张把路径 POST 给它；
|
||
// - 扫描结束把服务停掉、清理临时脚本。
|
||
//
|
||
// 机器上没有 python 或没装 nudenet 时，Start 会报错，调用方跳过识别、
|
||
// 走默认整理流程——这个功能是纯附加的，不影响其它步骤。
|
||
package nsfw
|
||
|
||
import (
|
||
"bytes"
|
||
"context"
|
||
"encoding/json"
|
||
"fmt"
|
||
"io"
|
||
"net"
|
||
"net/http"
|
||
"os"
|
||
"os/exec"
|
||
"path/filepath"
|
||
"strings"
|
||
"sync"
|
||
"time"
|
||
|
||
_ "embed"
|
||
)
|
||
|
||
// 内嵌的 python 服务脚本：用标准库起 HTTP 服务，负责加载模型、接收路径、返回结果。
|
||
// 不依赖 flask/fastapi，省去额外装包。
|
||
//
|
||
//go:embed server.py
|
||
var serverScript []byte
|
||
|
||
// 敏感类集合：检测到这些部位"暴露"且分数达标才算色情。
|
||
// 默认只取最明确的四类（生殖器/肛/女性乳房），避免把泳装、露背照误判。
|
||
var sensitiveClasses = map[string]bool{
|
||
"FEMALE_GENITALIA_EXPOSED": true,
|
||
"MALE_GENITALIA_EXPOSED": true,
|
||
"ANUS_EXPOSED": true,
|
||
"FEMALE_BREAST_EXPOSED": true,
|
||
}
|
||
|
||
// detectorStartTimeout 等待 python 服务就绪（模型加载）的超时时间。
|
||
// 首次加载模型可能要十几秒，给足余量。
|
||
const detectorStartTimeout = 60 * time.Second
|
||
|
||
// requestTimeout 单张图片检测的超时时间。检测很快（毫秒级），
|
||
// 万一卡住（模型没加载好/图太大）不至于拖死整个扫描。
|
||
const requestTimeout = 30 * time.Second
|
||
|
||
// Detector 封装一个本地 python 服务的客户端。
|
||
// 多个探测协程会并发调 Detect，底层 HTTP 客户端线程安全；
|
||
// 服务端单线程处理，请求自己排队，不用额外加锁。
|
||
type Detector struct {
|
||
url string // 本地服务地址，如 http://127.0.0.1:54321
|
||
threshold float64 // 判定阈值 0~1
|
||
client *http.Client
|
||
cmd *exec.Cmd // python 进程句柄（Stop 时杀掉）
|
||
scriptDir string // 临时脚本所在目录（Stop 时清理）
|
||
mu sync.Mutex // 保护下面的关闭状态
|
||
stopped bool // 已经 Stop 过了
|
||
cancel context.CancelFunc
|
||
done chan struct{} // 进程退出时关闭（Wait 协程负责）
|
||
}
|
||
|
||
// Start 拉起本地 python 检测服务并等它就绪。
|
||
// - pythonPath：python 可执行文件路径；为空时在 PATH 里找 python/python3。
|
||
// - threshold：判定阈值 0~1。
|
||
//
|
||
// 找不到 python、装不了 nudenet、或服务起不来时返回错误（调用方跳过识别即可）。
|
||
func Start(pythonPath string, threshold float64) (*Detector, error) {
|
||
if threshold <= 0 || threshold >= 1 {
|
||
threshold = 0.5 // 阈值传得不合理就用默认
|
||
}
|
||
// 找 python
|
||
py := resolvePython(pythonPath)
|
||
if py == "" {
|
||
return nil, fmt.Errorf("未找到 python，敏感识别不可用")
|
||
}
|
||
|
||
// 先把内嵌的 server.py 写到临时目录
|
||
tmpDir, err := os.MkdirTemp("", "kmp-nsfw-*")
|
||
if err != nil {
|
||
return nil, fmt.Errorf("创建临时目录失败: %v", err)
|
||
}
|
||
scriptPath := filepath.Join(tmpDir, "server.py")
|
||
if err := os.WriteFile(scriptPath, serverScript, 0644); err != nil {
|
||
_ = os.RemoveAll(tmpDir)
|
||
return nil, fmt.Errorf("写入检测脚本失败: %v", err)
|
||
}
|
||
|
||
// 找一个空闲端口
|
||
port, err := freePort()
|
||
if err != nil {
|
||
_ = os.RemoveAll(tmpDir)
|
||
return nil, fmt.Errorf("找空闲端口失败: %v", err)
|
||
}
|
||
|
||
// 拉起服务。标准输出/错误接到程序自身的输出，方便看 python 报错。
|
||
ctx, cancel := context.WithCancel(context.Background())
|
||
cmd := exec.CommandContext(ctx, py, scriptPath, fmt.Sprintf("%d", port))
|
||
cmd.Stdout = os.Stdout
|
||
cmd.Stderr = os.Stderr
|
||
if err := cmd.Start(); err != nil {
|
||
cancel()
|
||
_ = os.RemoveAll(tmpDir)
|
||
return nil, fmt.Errorf("启动检测服务失败: %v", err)
|
||
}
|
||
|
||
done := make(chan struct{})
|
||
d := &Detector{
|
||
url: fmt.Sprintf("http://127.0.0.1:%d", port),
|
||
threshold: threshold,
|
||
client: &http.Client{Timeout: requestTimeout},
|
||
cmd: cmd,
|
||
scriptDir: tmpDir,
|
||
cancel: cancel,
|
||
done: done,
|
||
}
|
||
// 后台等进程退出：ProcessState 要 Wait 之后才有值，这里用 done 通知，
|
||
// 这样 waitReady 能及时发现"python 没装 nudenet 直接退掉"的情况。
|
||
go func() {
|
||
_ = cmd.Wait()
|
||
close(done)
|
||
}()
|
||
|
||
// 等服务就绪（模型加载完成）。就绪前先探测 /health。
|
||
if err := d.waitReady(); err != nil {
|
||
d.Stop()
|
||
return nil, err
|
||
}
|
||
return d, nil
|
||
}
|
||
|
||
// waitReady 轮询本地服务，直到能正常应答。
|
||
func (d *Detector) waitReady() error {
|
||
deadline := time.Now().Add(detectorStartTimeout)
|
||
for time.Now().Before(deadline) {
|
||
// 服务进程提前退了（多半是 python 没装 nudenet）直接报错
|
||
select {
|
||
case <-d.done:
|
||
return fmt.Errorf("检测服务提前退出，请确认已安装 nudenet (pip install nudenet)")
|
||
default:
|
||
}
|
||
req, err := http.NewRequest(http.MethodGet, d.url+"/health", nil)
|
||
if err != nil {
|
||
return err
|
||
}
|
||
resp, err := d.client.Do(req)
|
||
if err == nil {
|
||
_, _ = io.Copy(io.Discard, resp.Body)
|
||
resp.Body.Close()
|
||
if resp.StatusCode == http.StatusOK {
|
||
return nil
|
||
}
|
||
}
|
||
time.Sleep(500 * time.Millisecond)
|
||
}
|
||
return fmt.Errorf("检测服务在 %v 内未就绪", detectorStartTimeout)
|
||
}
|
||
|
||
// Detect 检测一张图片是否色情。返回：
|
||
// - score：命中的敏感类里最高分数（没有命中为 0）
|
||
// - nsfw：是否判定为色情（有敏感类且分数 >= 阈值）
|
||
// - err：检测失败（服务挂了/图读不出等），由调用方兜底按未命中处理
|
||
func (d *Detector) Detect(path string) (score float64, nsfw bool, err error) {
|
||
body, _ := json.Marshal(map[string]interface{}{
|
||
"path": path,
|
||
"threshold": d.threshold,
|
||
})
|
||
resp, err := d.client.Post(d.url+"/detect", "application/json", bytes.NewReader(body))
|
||
if err != nil {
|
||
return 0, false, err
|
||
}
|
||
defer resp.Body.Close()
|
||
data, err := io.ReadAll(resp.Body)
|
||
if err != nil {
|
||
return 0, false, err
|
||
}
|
||
var out struct {
|
||
Ok bool `json:"ok"`
|
||
Error string `json:"error"`
|
||
Nsfw bool `json:"nsfw"`
|
||
Score float64 `json:"score"`
|
||
}
|
||
if err := json.Unmarshal(data, &out); err != nil {
|
||
return 0, false, fmt.Errorf("解析检测结果失败: %v", err)
|
||
}
|
||
if !out.Ok {
|
||
return 0, false, fmt.Errorf("检测服务返回错误: %s", out.Error)
|
||
}
|
||
return out.Score, out.Nsfw, nil
|
||
}
|
||
|
||
// Stop 停掉检测服务并清理临时文件。可以安全地重复调用。
|
||
func (d *Detector) Stop() {
|
||
d.mu.Lock()
|
||
if d.stopped {
|
||
d.mu.Unlock()
|
||
return
|
||
}
|
||
d.stopped = true
|
||
d.mu.Unlock()
|
||
|
||
if d.cancel != nil {
|
||
d.cancel()
|
||
}
|
||
if d.cmd != nil && d.cmd.Process != nil {
|
||
// 进程活着才 kill；kill 失败也无所谓，服务很快就没了
|
||
_ = d.cmd.Process.Kill()
|
||
}
|
||
if d.done != nil {
|
||
// 等 Wait 协程回收进程，避免僵尸进程；进程已死则立刻返回
|
||
<-d.done
|
||
}
|
||
if d.scriptDir != "" {
|
||
_ = os.RemoveAll(d.scriptDir)
|
||
}
|
||
}
|
||
|
||
// resolvePython 在配置值 / PATH 里找可用的 python 解释器。
|
||
// Windows 上常见 python / python3 / py；Linux/mac 常见 python3 / python。
|
||
func resolvePython(configured string) string {
|
||
candidates := []string{}
|
||
if strings.TrimSpace(configured) != "" {
|
||
candidates = append(candidates, strings.TrimSpace(configured))
|
||
}
|
||
if os.Getenv("KM_NSFW_PYTHON") != "" {
|
||
candidates = append(candidates, os.Getenv("KM_NSFW_PYTHON"))
|
||
}
|
||
candidates = append(candidates, "python", "python3", "py")
|
||
for _, c := range candidates {
|
||
if p, err := exec.LookPath(c); err == nil {
|
||
return p
|
||
}
|
||
// 配置给的是绝对路径：直接看文件在不在
|
||
if strings.ContainsAny(c, `\/`) {
|
||
if _, err := os.Stat(c); err == nil {
|
||
return c
|
||
}
|
||
}
|
||
}
|
||
return ""
|
||
}
|
||
|
||
// freePort 找一个当前空闲的 TCP 端口（挑到立刻释放，竞态可接受）。
|
||
func freePort() (int, error) {
|
||
ln, err := net.Listen("tcp", "127.0.0.1:0")
|
||
if err != nil {
|
||
return 0, err
|
||
}
|
||
defer ln.Close()
|
||
return ln.Addr().(*net.TCPAddr).Port, nil
|
||
}
|