@zhin.js/plugin-content-moderation 1.0.0

package/README.md

@@ -0,0 +1,173 @@
+# @zhin.js/plugin-content-moderation
+
+内容安全审查插件 —— 入站 / 出站多源扫描，按可配置 severity→动作表处置。
+
+## 安装
+
+```bash
+npm install @zhin.js/plugin-content-moderation
+```
+
+## 配置
+
+在 `zhin.config.yml` 中添加：
+
+```yaml
+plugins:
+  - "@zhin.js/plugin-content-moderation"
+
+content-moderation:
+  enabled: true
+  onError: open                 # 源失败默认：open | closed
+  maskChar: "*"
+  replyTemplate: "消息含不当内容，已拦截。"
+  masters: []                   # 额外 master userId（兜底）
+  inbound:
+    enabled: true
+    bypassMasters: true
+    whitelist:
+      userIds: []
+      conversationIds: []
+  outbound:
+    enabled: true
+    bypass: false               # true 才跳过出站审查
+  actions:                      # 可整表覆盖；缺省偏严
+    pass: allow
+    low: log
+    medium: redact
+    high: drop
+    critical: [drop, recall]
+  sources:
+    - id: local
+      type: local
+      enabled: true
+      includeBuiltin: true          # 默认 true：合并内置分级词库
+      defaultSeverity: high         # 未标注分级的自定义词默认等级（兼容旧字段 severity）
+      words:
+        - 自定义敏感词                 # → defaultSeverity
+        - word: 擦边广告
+          severity: low
+        - word: 诈骗话术
+          severity: high
+      # wordFiles: ["./data/bad-words.txt"]
+      # 词库文件行：word  /  severity:word  /  word|severity
+    # - id: http-1
+    #   type: http
+    #   url: "https://example.com/moderate"
+    #   onError: closed
+    #   timeoutMs: 5000outbound
+    #   forceUpload: false
+```
+
+
+
+## 动作说明（`actions`）
+
+扫描得到最终 severity 后，查 `actions.<severity>` 得到一个动作或动作列表（可叠加）。  
+不调用 `next()` = 中断中间件链：入站不进入命令/Agent；出站不发给平台。
+
+
+| 动作       | 入站（inbound）                                                                              | 出站（outbound）                                                                                  |
+| -------- | ---------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------- |
+| `allow`  | 放行（调用 `next()`）                                                                          | 放行                                                                                            |
+| `log`    | 打结构化审计日志后**继续**（可与其它动作叠加；非 `pass` 时引擎也会记一条）                                              | 同左                                                                                            |
+| `reply`  | 用 `replyTemplate` 回复发送者；是否继续取决于是否同时有 `drop` / `redact`                                   | **不适用**（忽略并 debug 日志）                                                                         |
+| `redact` | Runtime `Message` 只读，**无法改写原文**；仍 **正常** `next()` **放行**（可与 `reply` 叠加做提示）。若要拦截请用 `drop` | 对 payload **真打码**：命中 span 用 `maskChar` 替换；无 span 则整段打码；违规图段删除；然后 `envelope.replace` 并**继续发送** |
+| `drop`   | 丢弃：不 `next()`，命令/Agent 看不到该消息                                                            | 丢弃：不 `next()`，消息不会发出                                                                          |
+| `recall` | 尝试撤回原消息（`OutboundHost.recall`）；无 message id / 平台不支持 → 降级并 warn                           | 发送前无意义，**忽略**                                                                                 |
+
+
+
+
+### 叠加与中断规则
+
+- 配置写成数组即可叠加，例如 `critical: [drop, recall]`：先按列表执行副作用，再决定是否放行。
+- **中断（不** `next()`**）**：含 `drop`；或入站含 `recall`（且无 `allow`）。
+- **继续**：`allow` / `log` / `reply` / `redact`（入站 redact 不改原文但放行；出站 redact 先 `replace`）。
+
+
+
+### 偏严默认表
+
+
+| severity   | 默认动作             | 实际效果简述                      |
+| ---------- | ---------------- | --------------------------- |
+| `pass`     | `allow`          | 放行                          |
+| `low`      | `log`            | 只记日志，照常处理                   |
+| `medium`   | `redact`         | 入站放行（不改原文）；出站打码后发出          |
+| `high`     | `drop`           | 入站丢弃；出站不发                   |
+| `critical` | `[drop, recall]` | 入站丢弃并尽量撤回；出站不发（`recall` 忽略） |
+
+
+示例：入站 medium 想「提示但仍放行」，可改成：
+
+```yaml
+actions:
+  medium: [redact, reply]
+```
+
+若入站要拦截，请用 `drop`（或 `high` 默认表）。
+
+## 本地词库分级
+
+
+| 等级         | 内置示例（节选）  | 默认动作              |
+| ---------- | --------- | ----------------- |
+| `low`      | 轻度不当用语    | `log`             |
+| `medium`   | 辱骂粗口      | `redact`          |
+| `high`     | 色情/诈骗引流；中国政治敏感（台独/藏独、六四相关、法轮功等） | `drop`            |
+| `critical` | 毒品/极端违法；煽动暴力颠覆 | `drop` + `recall` |
+
+
+命中多词时取**最高** severity。自定义词可覆盖同词更高等级。不需要政治词库时设 `includeBuiltin: false` 并自建 `words` / `wordFiles`。
+
+## 其它行为
+
+
+| 方向  | 扩展点                             | 说明                               |
+| --- | ------------------------------- | -------------------------------- |
+| 入站  | `middlewares` `target: inbound` | master / 白名单可跳过                  |
+| 出站  | `target: outbound`              | 默认仍审；`outbound.bypass: true` 才跳过 |
+
+
+- 多源全跑，取最高 severity。
+- 图片：HTTP 源优先传 URL；不可达或 `forceUpload` 时下载后上传。
+- 审计：仅结构化 logger（无落库）。
+
+
+
+## HTTP 源契约
+
+`POST` JSON（或 multipart）：
+
+```json
+{
+  "text": "...",
+  "images": [{ "url": "https://..." }],
+  "direction": "inbound",
+  "context": {
+    "adapter": "...",
+    "endpoint": "...",
+    "conversationKind": "group",
+    "conversationId": "...",
+    "sender": "..."
+  }
+}
+```
+
+响应：
+
+```json
+{
+  "severity": "medium",
+  "matches": [{ "start": 0, "end": 2 }],
+  "images": [{ "index": 0, "flagged": true }],
+  "reason": "optional"
+}
+```
+
+
+
+## 许可
+
+MIT

package/lib/bypass.d.ts

@@ -0,0 +1,10 @@
+import type { ModerationConfig } from './types.js';
+export interface BypassInput {
+    readonly sender?: string;
+    readonly conversationId: string;
+    /** Endpoint / plugin-declared masters already resolved by caller. */
+    readonly endpointMasters?: readonly string[];
+}
+export declare function shouldBypassInbound(config: ModerationConfig, input: BypassInput): boolean;
+export declare function shouldBypassOutbound(config: ModerationConfig): boolean;
+//# sourceMappingURL=bypass.d.ts.map

package/lib/bypass.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bypass.d.ts","sourceRoot":"","sources":["../src/bypass.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAEnD,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,qEAAqE;IACrE,QAAQ,CAAC,eAAe,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CAC9C;AAED,wBAAgB,mBAAmB,CACjC,MAAM,EAAE,gBAAgB,EACxB,KAAK,EAAE,WAAW,GACjB,OAAO,CAoBT;AAED,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,gBAAgB,GAAG,OAAO,CAGtE"}

package/lib/bypass.js

@@ -0,0 +1,27 @@
+export function shouldBypassInbound(config, input) {
+    if (!config.enabled || !config.inbound.enabled)
+        return true;
+    const sender = input.sender?.trim();
+    if (sender) {
+        if (config.inbound.whitelist.userIds.includes(sender))
+            return true;
+        if (config.inbound.bypassMasters) {
+            const masters = new Set([
+                ...config.masters,
+                ...(input.endpointMasters ?? []),
+            ].map(String));
+            if (masters.has(sender))
+                return true;
+        }
+    }
+    if (config.inbound.whitelist.conversationIds.includes(input.conversationId)) {
+        return true;
+    }
+    return false;
+}
+export function shouldBypassOutbound(config) {
+    if (!config.enabled || !config.outbound.enabled)
+        return true;
+    return config.outbound.bypass === true;
+}
+//# sourceMappingURL=bypass.js.map

package/lib/bypass.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bypass.js","sourceRoot":"","sources":["../src/bypass.ts"],"names":[],"mappings":"AASA,MAAM,UAAU,mBAAmB,CACjC,MAAwB,EACxB,KAAkB;IAElB,IAAI,CAAC,MAAM,CAAC,OAAO,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,OAAO;QAAE,OAAO,IAAI,CAAC;IAE5D,MAAM,MAAM,GAAG,KAAK,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC;IACpC,IAAI,MAAM,EAAE,CAAC;QACX,IAAI,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC;YAAE,OAAO,IAAI,CAAC;QACnE,IAAI,MAAM,CAAC,OAAO,CAAC,aAAa,EAAE,CAAC;YACjC,MAAM,OAAO,GAAG,IAAI,GAAG,CAAC;gBACtB,GAAG,MAAM,CAAC,OAAO;gBACjB,GAAG,CAAC,KAAK,CAAC,eAAe,IAAI,EAAE,CAAC;aACjC,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC;YACf,IAAI,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC;gBAAE,OAAO,IAAI,CAAC;QACvC,CAAC;IACH,CAAC;IAED,IAAI,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,eAAe,CAAC,QAAQ,CAAC,KAAK,CAAC,cAAc,CAAC,EAAE,CAAC;QAC5E,OAAO,IAAI,CAAC;IACd,CAAC;IAED,OAAO,KAAK,CAAC;AACf,CAAC;AAED,MAAM,UAAU,oBAAoB,CAAC,MAAwB;IAC3D,IAAI,CAAC,MAAM,CAAC,OAAO,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,OAAO;QAAE,OAAO,IAAI,CAAC;IAC7D,OAAO,MAAM,CAAC,QAAQ,CAAC,MAAM,KAAK,IAAI,CAAC;AACzC,CAAC"}

package/lib/config.d.ts

@@ -0,0 +1,5 @@
+import { type Action, type ModerationConfig, type Severity } from './types.js';
+export declare const DEFAULT_ACTIONS: Readonly<Record<Severity, readonly Action[]>>;
+export declare const DEFAULT_MODERATION_CONFIG: ModerationConfig;
+export declare function resolveModerationConfig(raw: unknown): ModerationConfig;
+//# sourceMappingURL=config.d.ts.map

package/lib/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,MAAM,EAGX,KAAK,gBAAgB,EAErB,KAAK,QAAQ,EAEd,MAAM,YAAY,CAAC;AAEpB,eAAO,MAAM,eAAe,EAAE,QAAQ,CAAC,MAAM,CAAC,QAAQ,EAAE,SAAS,MAAM,EAAE,CAAC,CAMxE,CAAC;AAEH,eAAO,MAAM,yBAAyB,EAAE,gBAoBtC,CAAC;AAEH,wBAAgB,uBAAuB,CAAC,GAAG,EAAE,OAAO,GAAG,gBAAgB,CAsCtE"}

package/lib/config.js

@@ -0,0 +1,184 @@
+import { isAction, } from './types.js';
+export const DEFAULT_ACTIONS = Object.freeze({
+    pass: Object.freeze(['allow']),
+    low: Object.freeze(['log']),
+    medium: Object.freeze(['redact']),
+    high: Object.freeze(['drop']),
+    critical: Object.freeze(['drop', 'recall']),
+});
+export const DEFAULT_MODERATION_CONFIG = Object.freeze({
+    enabled: true,
+    onError: 'open',
+    maskChar: '*',
+    replyTemplate: '消息含不当内容，已拦截。',
+    masters: Object.freeze([]),
+    inbound: Object.freeze({
+        enabled: true,
+        bypassMasters: true,
+        whitelist: Object.freeze({
+            userIds: Object.freeze([]),
+            conversationIds: Object.freeze([]),
+        }),
+    }),
+    outbound: Object.freeze({
+        enabled: true,
+        bypass: false,
+    }),
+    actions: DEFAULT_ACTIONS,
+    sources: Object.freeze([]),
+});
+export function resolveModerationConfig(raw) {
+    const input = raw && typeof raw === 'object' ? raw : {};
+    const inboundRaw = asRecord(input.inbound);
+    const outboundRaw = asRecord(input.outbound);
+    const whitelistRaw = asRecord(inboundRaw.whitelist);
+    const onError = parseOnError(input.onError, DEFAULT_MODERATION_CONFIG.onError);
+    const maskChar = typeof input.maskChar === 'string' && input.maskChar.length > 0
+        ? input.maskChar.slice(0, 4)
+        : DEFAULT_MODERATION_CONFIG.maskChar;
+    const replyTemplate = typeof input.replyTemplate === 'string' && input.replyTemplate.length > 0
+        ? input.replyTemplate
+        : DEFAULT_MODERATION_CONFIG.replyTemplate;
+    return Object.freeze({
+        enabled: input.enabled !== false,
+        onError,
+        maskChar,
+        replyTemplate,
+        masters: freezeStrings(input.masters),
+        inbound: Object.freeze({
+            enabled: inboundRaw.enabled !== false,
+            bypassMasters: inboundRaw.bypassMasters !== false,
+            whitelist: Object.freeze({
+                userIds: freezeStrings(whitelistRaw.userIds),
+                conversationIds: freezeStrings(whitelistRaw.conversationIds),
+            }),
+        }),
+        outbound: Object.freeze({
+            enabled: outboundRaw.enabled !== false,
+            bypass: outboundRaw.bypass === true,
+        }),
+        actions: resolveActions(input.actions),
+        sources: Object.freeze((Array.isArray(input.sources) ? input.sources : [])
+            .map((item) => parseSource(item, onError))
+            .filter((item) => item != null)),
+    });
+}
+function resolveActions(raw) {
+    const input = asRecord(raw);
+    return Object.freeze({
+        pass: resolveActionList(input.pass, DEFAULT_ACTIONS.pass),
+        low: resolveActionList(input.low, DEFAULT_ACTIONS.low),
+        medium: resolveActionList(input.medium, DEFAULT_ACTIONS.medium),
+        high: resolveActionList(input.high, DEFAULT_ACTIONS.high),
+        critical: resolveActionList(input.critical, DEFAULT_ACTIONS.critical),
+    });
+}
+function resolveActionList(raw, fallback) {
+    if (typeof raw === 'string' && isAction(raw))
+        return Object.freeze([raw]);
+    if (Array.isArray(raw)) {
+        const actions = raw.filter(isAction);
+        if (actions.length > 0)
+            return Object.freeze([...actions]);
+    }
+    return fallback;
+}
+function parseSource(raw, globalOnError) {
+    if (!raw || typeof raw !== 'object')
+        return null;
+    const input = raw;
+    const id = typeof input.id === 'string' ? input.id.trim() : '';
+    if (!id)
+        return null;
+    const enabled = input.enabled !== false;
+    const onError = parseOnError(input.onError, globalOnError);
+    if (input.type === 'local') {
+        const defaultSeverity = parseHitSeverity(input.defaultSeverity ?? input.severity);
+        const local = Object.freeze({
+            id,
+            type: 'local',
+            enabled,
+            onError,
+            words: freezeLexiconWords(input.words, defaultSeverity),
+            wordFiles: freezeStrings(input.wordFiles),
+            includeBuiltin: input.includeBuiltin !== false,
+            defaultSeverity,
+        });
+        return local;
+    }
+    if (input.type === 'http') {
+        const url = typeof input.url === 'string' ? input.url.trim() : '';
+        if (!url)
+            return null;
+        const headersRaw = asRecord(input.headers);
+        const headers = {};
+        for (const [key, value] of Object.entries(headersRaw)) {
+            if (typeof value === 'string')
+                headers[key] = value;
+        }
+        const timeoutMs = clampNumber(input.timeoutMs, 5_000, 500, 60_000);
+        const http = Object.freeze({
+            id,
+            type: 'http',
+            enabled,
+            onError,
+            url,
+            headers: Object.freeze(headers),
+            timeoutMs,
+            forceUpload: input.forceUpload === true,
+        });
+        return http;
+    }
+    return null;
+}
+function parseHitSeverity(raw) {
+    if (raw === 'low' || raw === 'medium' || raw === 'high' || raw === 'critical')
+        return raw;
+    return 'high';
+}
+function parseOnError(raw, fallback) {
+    return raw === 'open' || raw === 'closed' ? raw : fallback;
+}
+function asRecord(value) {
+    return value && typeof value === 'object' && !Array.isArray(value)
+        ? value
+        : {};
+}
+function freezeStrings(value) {
+    if (!Array.isArray(value))
+        return Object.freeze([]);
+    return Object.freeze(value.filter((item) => typeof item === 'string' && item.length > 0));
+}
+function freezeLexiconWords(value, defaultSeverity) {
+    if (!Array.isArray(value))
+        return Object.freeze([]);
+    const out = [];
+    for (const item of value) {
+        if (typeof item === 'string') {
+            const word = item.trim();
+            if (word)
+                out.push(Object.freeze({ word, severity: defaultSeverity }));
+            continue;
+        }
+        if (!item || typeof item !== 'object')
+            continue;
+        const record = item;
+        const word = typeof record.word === 'string'
+            ? record.word.trim()
+            : typeof record.text === 'string'
+                ? record.text.trim()
+                : '';
+        if (!word)
+            continue;
+        out.push(Object.freeze({
+            word,
+            severity: parseHitSeverity(record.severity ?? defaultSeverity),
+        }));
+    }
+    return Object.freeze(out);
+}
+function clampNumber(value, fallback, min, max) {
+    const n = typeof value === 'number' && Number.isFinite(value) ? value : fallback;
+    return Math.min(max, Math.max(min, Math.trunc(n)));
+}
+//# sourceMappingURL=config.js.map

package/lib/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"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"}

package/lib/engine.d.ts

@@ -0,0 +1,40 @@
+import { type Logger } from '@zhin.js/logger';
+import { type ExtractedContent } from './extract.js';
+import type { ModerationProvider } from './providers/types.js';
+import { type Action, type Direction, type MergedResult, type ModerationConfig, type ProviderResult, type ScanInput, type Severity } from './types.js';
+export interface ApplyHooks {
+    readonly reply?: (content: string) => Promise<void>;
+    readonly recall?: () => Promise<boolean>;
+    readonly replacePayload?: (payload: unknown) => void;
+    readonly getPayload?: () => unknown;
+}
+export interface ApplyResult {
+    readonly continue: boolean;
+    readonly severity: Severity;
+    readonly actions: readonly Action[];
+    readonly merged: MergedResult;
+    readonly redactedPayload?: unknown;
+}
+export declare class ModerationEngine {
+    #private;
+    constructor(options?: {
+        readonly logger?: Logger;
+        readonly cwd?: string;
+        readonly fetch?: typeof fetch;
+    });
+    get config(): ModerationConfig;
+    configure(raw: unknown): void;
+    /** Test helper: inject providers without going through config sources. */
+    setProvidersForTest(providers: readonly ModerationProvider[]): void;
+    scan(input: ScanInput): Promise<MergedResult>;
+    apply(options: {
+        readonly direction: Direction;
+        readonly extracted: ExtractedContent;
+        readonly scanInput: ScanInput;
+        readonly hooks: ApplyHooks;
+    }): Promise<ApplyResult>;
+}
+export declare function mergeResults(results: readonly ProviderResult[]): MergedResult;
+export declare function getModerationEngine(): ModerationEngine;
+export declare function resetModerationEngine(): void;
+//# sourceMappingURL=engine.d.ts.map

package/lib/engine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"engine.d.ts","sourceRoot":"","sources":["../src/engine.ts"],"names":[],"mappings":"AAAA,OAAO,EAA4B,KAAK,MAAM,EAAE,MAAM,iBAAiB,CAAC;AAExE,OAAO,EAAgB,KAAK,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAGnE,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAC/D,OAAO,EAEL,KAAK,MAAM,EACX,KAAK,SAAS,EACd,KAAK,YAAY,EACjB,KAAK,gBAAgB,EACrB,KAAK,cAAc,EACnB,KAAK,SAAS,EACd,KAAK,QAAQ,EACd,MAAM,YAAY,CAAC;AAEpB,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACpD,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,OAAO,CAAC,OAAO,CAAC,CAAC;IACzC,QAAQ,CAAC,cAAc,CAAC,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,IAAI,CAAC;IACrD,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,OAAO,CAAC;CACrC;AAED,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;IAC3B,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAC;IAC5B,QAAQ,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,CAAC;IACpC,QAAQ,CAAC,MAAM,EAAE,YAAY,CAAC;IAC9B,QAAQ,CAAC,eAAe,CAAC,EAAE,OAAO,CAAC;CACpC;AAED,qBAAa,gBAAgB;;gBAOf,OAAO,GAAE;QACnB,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;QACzB,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC;QACtB,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,KAAK,CAAC;KAC1B;IAMN,IAAI,MAAM,IAAI,gBAAgB,CAE7B;IAED,SAAS,CAAC,GAAG,EAAE,OAAO,GAAG,IAAI;IAQ7B,0EAA0E;IAC1E,mBAAmB,CAAC,SAAS,EAAE,SAAS,kBAAkB,EAAE,GAAG,IAAI;IAI7D,IAAI,CAAC,KAAK,EAAE,SAAS,GAAG,OAAO,CAAC,YAAY,CAAC;IA4B7C,KAAK,CAAC,OAAO,EAAE;QACnB,QAAQ,CAAC,SAAS,EAAE,SAAS,CAAC;QAC9B,QAAQ,CAAC,SAAS,EAAE,gBAAgB,CAAC;QACrC,QAAQ,CAAC,SAAS,EAAE,SAAS,CAAC;QAC9B,QAAQ,CAAC,KAAK,EAAE,UAAU,CAAC;KAC5B,GAAG,OAAO,CAAC,WAAW,CAAC;CA+EzB;AAED,wBAAgB,YAAY,CAAC,OAAO,EAAE,SAAS,cAAc,EAAE,GAAG,YAAY,CAmB7E;AAaD,wBAAgB,mBAAmB,IAAI,gBAAgB,CAGtD;AAED,wBAAgB,qBAAqB,IAAI,IAAI,CAE5C"}

package/lib/engine.js

@@ -0,0 +1,170 @@
+import { formatCompact, getLogger } from '@zhin.js/logger';
+import { resolveModerationConfig } from './config.js';
+import { mergeMatches } from './extract.js';
+import { redactOutboundPayload } from './redact.js';
+import { createProviders } from './providers/registry.js';
+import { maxSeverity, } from './types.js';
+export class ModerationEngine {
+    #logger;
+    #cwd;
+    #fetch;
+    #providers = Object.freeze([]);
+    #config = resolveModerationConfig({});
+    constructor(options = {}) {
+        this.#logger = options.logger ?? getLogger('content-moderation');
+        this.#cwd = options.cwd ?? process.cwd();
+        this.#fetch = options.fetch;
+    }
+    get config() {
+        return this.#config;
+    }
+    configure(raw) {
+        this.#config = resolveModerationConfig(raw);
+        this.#providers = createProviders(this.#config, {
+            cwd: this.#cwd,
+            fetch: this.#fetch,
+        });
+    }
+    /** Test helper: inject providers without going through config sources. */
+    setProvidersForTest(providers) {
+        this.#providers = Object.freeze([...providers]);
+    }
+    async scan(input) {
+        if (this.#providers.length === 0) {
+            return Object.freeze({
+                severity: 'pass',
+                matches: Object.freeze([]),
+                flaggedImageIndexes: Object.freeze([]),
+                sources: Object.freeze([]),
+            });
+        }
+        const results = await Promise.all(this.#providers.map(async (provider) => {
+            try {
+                return await provider.scan(input);
+            }
+            catch (error) {
+                return Object.freeze({
+                    sourceId: provider.id,
+                    severity: 'pass',
+                    error: true,
+                    reason: error instanceof Error ? error.message : String(error),
+                });
+            }
+        }));
+        return mergeResults(results);
+    }
+    async apply(options) {
+        const merged = await this.scan(options.scanInput);
+        const actions = [...this.#config.actions[merged.severity]];
+        const actionSet = new Set(actions);
+        if (merged.severity !== 'pass' || actionSet.has('log')) {
+            this.#logger.info(formatCompact({
+                op: 'moderation',
+                direction: options.direction,
+                severity: merged.severity,
+                actions: actions.join(','),
+                sources: merged.sources.map((s) => `${s.sourceId}:${s.severity}${s.error ? '!' : ''}`).join('|'),
+                conversation: options.scanInput.context.conversationId,
+                sender: options.scanInput.context.sender,
+                reason: merged.reason,
+            }));
+        }
+        if (actionSet.has('log') && merged.severity === 'pass') {
+            // already logged above when log is present
+        }
+        let redactedPayload;
+        if (actionSet.has('redact')) {
+            if (options.direction === 'outbound') {
+                const payload = options.hooks.getPayload?.();
+                redactedPayload = redactOutboundPayload(payload, options.extracted, {
+                    maskChar: this.#config.maskChar,
+                    matches: merged.matches,
+                    flaggedImageIndexes: merged.flaggedImageIndexes,
+                });
+                options.hooks.replacePayload?.(redactedPayload);
+            }
+            // inbound redact：Message 只读，无法改写原文；仍 next() 放行
+        }
+        if (actionSet.has('reply') && options.direction === 'inbound') {
+            try {
+                await options.hooks.reply?.(this.#config.replyTemplate);
+            }
+            catch (error) {
+                this.#logger.warn(formatCompact({
+                    op: 'moderation_reply_failed',
+                    error: error instanceof Error ? error.message : String(error),
+                }));
+            }
+        }
+        else if (actionSet.has('reply') && options.direction === 'outbound') {
+            this.#logger.debug(formatCompact({
+                op: 'moderation_reply_skipped',
+                direction: 'outbound',
+            }));
+        }
+        if (actionSet.has('recall') && options.direction === 'inbound') {
+            try {
+                const ok = await options.hooks.recall?.();
+                if (!ok) {
+                    this.#logger.warn(formatCompact({
+                        op: 'moderation_recall_degraded',
+                        reason: 'unsupported_or_missing_id',
+                    }));
+                }
+            }
+            catch (error) {
+                this.#logger.warn(formatCompact({
+                    op: 'moderation_recall_degraded',
+                    error: error instanceof Error ? error.message : String(error),
+                }));
+            }
+        }
+        const stop = shouldStop(options.direction, actionSet);
+        return Object.freeze({
+            continue: !stop,
+            severity: merged.severity,
+            actions: Object.freeze(actions),
+            merged,
+            ...(redactedPayload !== undefined ? { redactedPayload } : {}),
+        });
+    }
+}
+export function mergeResults(results) {
+    let severity = 'pass';
+    const matches = mergeMatches(...results.map((r) => r.matches));
+    const flagged = new Set();
+    const reasons = [];
+    for (const result of results) {
+        severity = maxSeverity(severity, result.severity);
+        for (const idx of result.flaggedImageIndexes ?? [])
+            flagged.add(idx);
+        if (result.reason)
+            reasons.push(`${result.sourceId}: ${result.reason}`);
+    }
+    return Object.freeze({
+        severity,
+        matches,
+        flaggedImageIndexes: Object.freeze([...flagged].sort((a, b) => a - b)),
+        sources: Object.freeze([...results]),
+        ...(reasons.length ? { reason: reasons.join('; ') } : {}),
+    });
+}
+function shouldStop(direction, actions) {
+    if (actions.has('drop'))
+        return true;
+    // 入站 recall：尽量撤回后不再进入后续处理（无 allow 时中断）
+    if (direction === 'inbound' && actions.has('recall') && !actions.has('allow')) {
+        return true;
+    }
+    return false;
+}
+let sharedEngine = null;
+export function getModerationEngine() {
+    if (!sharedEngine)
+        sharedEngine = new ModerationEngine();
+    return sharedEngine;
+}
+export function resetModerationEngine() {
+    sharedEngine = null;
+}
+//# sourceMappingURL=engine.js.map

package/lib/engine.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"engine.js","sourceRoot":"","sources":["../src/engine.ts"],"names":[],"mappings":"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"}