Skip to content

🤖 Open-source, local-first alternative to Grok Bot, OpenAI dots and Claude Duet. Your own AI bots on any model: GPT, Claude, Gemini, Grok, DeepSeek, Kimi, GLM and 70+ more through one Modelflare key. Reach them in the app, WeChat or Feishu; they remember you, work in the background, run commands and use your computer. Pay per use.

10.5 KB
Raw Blame
/**
 * 规则(3d)的纯函数部分:状态、给人看的一行、每种模式的权限和去掉的工具。写库的是任务服务(service.ts,唯一的写入者)。
 *
 * 状态(第一条符合的为准):暂停了(连续失败 3 次、本月预算用完)→ 已暂停;关了 → 已关闭;一次性的跑过了 → 已结束;提醒 → 提醒;
 * 观察中 → 观察中;其余 → 执行中。新的检查直接执行(用户的原话就是授权,和让做的任务一样);观察要用户自己选。状态是"点 + 文字":红 = 连续失败暂停,黄 = 本月预算用完暂停,
 * 绿 = 执行中、提醒,灰 = 观察、关闭、结束。
 * 给人看的文字跟着语言(src/i18n 的 rules.*);跳过、失败的原因存成代码(RUN_ERROR),显示时再翻。
 */
import type { OutboxRow, RuleMode, RuleRow, RunRow } from "../store/db.js";
import { lang as currentLang, tl, type Lang, type MessageKey } from "../i18n/index.js";
import { describe } from "./schedule.js";

/** 连续失败几次自动暂停 */
export const RULE_FAILS_TO_PAUSE = 3;
/** 连续失败几次出现在「需要你」里 */
export const RULE_FAILS_TO_SHOW = 2;
/** 用户选了观察的规则:这一版好好观察了几次(做完了的;失败、跳过的不算)之后,「需要你」里问要不要改为执行 */
export const RULE_SUGGEST_AFTER = 3;
/** 每个机器人最多几条规则 */
export const MAX_RULES = 30;
/** 一次运行最长多久(不算等批准的时间) */
export const RULE_RUN_CAP_MS = 15 * 60_000;
/** 执行时的审批在「需要你」里等多久,过了就拒绝、这次运行失败 */
export const RULE_APPROVAL_TTL_MS = 3600_000;

/**
 * 规则会话去掉的工具(只去掉注册了的;插件按 tools.restrict 的规矩过滤)。观察:能改变什么的都去掉,记忆只留 recall,已授权账号只留读取;
 * 执行:上限是可写工作区(决定 12),电脑操作和生图、生视频不给(设计第 7 节:除非规则上开了,3d 不做这个开关)。
 */
const COMMON_DENY = ["present", "ask_user_question", "task_start", "task_message", "task_list", "rule_create", "rule_update", "background_pause", "generate_image", "generate_video", "media_models", "media_docs"];
export const RULE_DENY: Readonly<Record<"observe" | "act", string[]>> = {
  observe: [...COMMON_DENY, "remember", "forget", "notion_create_page", "notion_update_page"],
  act: COMMON_DENY,
};
/** 按前缀拒绝的工具(MCP 的电脑操作,名字随平台变化,没法列全) */
export const RULE_DENY_PREFIX = ["mcp__computer-use__"];

/** 这次运行用的模式:提醒总是执行;检查照规则的模式(改了原话也不再先观察,产品负责人 2026-11-01) */
export function runMode(rule: Pick<RuleRow, "mode" | "kind">): "observe" | "act" {
  if (rule.kind === "remind") return "act";
  return rule.mode === "act" ? "act" : "observe";
}

/** DSH 的沙箱:观察只读;执行是机器人的预设和可写工作区里取小的(完全权限的机器人也一样,决定 12) */
export function rulePermission(mode: "observe" | "act", botPreset: string): "read-only" | "workspace-write" {
  return mode === "observe" || botPreset === "readonly" ? "read-only" : "workspace-write";
}

export interface RuleState {
  key: "paused" | "off" | "done" | "remind" | "observe" | "act";
  label: string;
  /** 状态点:err 红、warn 黄、ok 绿、空 = 灰 */
  dot: "" | "ok" | "warn" | "err";
}

export function ruleState(rule: RuleRow, live = false, l: Lang = currentLang()): RuleState {
  const s = (key: RuleState["key"], label: MessageKey, dot: RuleState["dot"]): RuleState => ({ key, label: tl(l, label), dot });
  if (rule.pausedReason) return s("paused", "rules.statePaused", rule.pausedReason === "budget" ? "warn" : "err");
  if (rule.mode === "off") return s("off", "rules.stateOff", "");
  if (!live && !rule.nextRunAt && rule.trigger.kind === "schedule") return s("done", "rules.stateDone", "");
  if (rule.kind === "remind") return s("remind", "rules.stateRemind", "ok");
  if (runMode(rule) === "observe") return s("observe", "rules.stateObserve", "");
  return s("act", "rules.stateAct", "ok");
}

/** 规则在界面上的样子 */
export interface RuleView {
  id: string;
  botId: string;
  conversationId: string;
  channel: string;
  title: string;
  instruction: string;
  message: string;
  kind: RuleRow["kind"];
  trigger: RuleRow["trigger"];
  /** 时间表的话:每天 08:00;事件触发的是来源 */
  when: string;
  mode: RuleMode;
  state: RuleState;
  nextRunAt: number;
  /** 最近一次:时间、结果、一行 */
  last?: { at: number; outcome: string; line: string };
  failures: number;
  /** 暂停的原因:failures / budget;空 = 没暂停 */
  pausedReason: string;
  /** 本月估算花了多少、每月的预算、每次的预算(美元) */
  monthUsd: number;
  monthBudgetUsd: number;
  runBudgetUsd: number;
  folder: string;
  version: number;
  createdAt: number;
  updatedAt: number;
  /** 正在跑(或排队)的那一次 */
  live?: { runId: string; state: string; since: number };
}

export function whenOf(rule: Pick<RuleRow, "trigger">, withZone = false, l: Lang = currentLang()): string {
  return rule.trigger.kind === "schedule" ? describe(rule.trigger.schedule, withZone, l) : tl(l, "rules.event", { source: rule.trigger.source });
}

/** 跳过、失败的原因:存进 runs.error 的代码(显示时按语言翻,见 errorText) */
export const RUN_ERROR = {
  appOff: "app_off",
  busy: "busy",
  overlap: "overlap",
  restart: "restart",
  paused: "paused",
  timeout: "timeout",
  approvalTimeout: "approval_timeout",
  noReport: "no_report",
  modelErrors: "model_errors",
  agentFailed: "agent_failed",
  agentUnavailable: "agent_unavailable",
  /** 3e:超出单次预算、本月预算用完、机器人的预算留给聊天 */
  runBudget: "run_budget",
  monthBudget: "month_budget",
  reserve: "reserve",
} as const;

/** 原因 → 词条:规则自己的,和任务共用的那几种(tasks.*,和任务失败时的说法一样) */
const WHY: Record<string, MessageKey> = {
  app_off: "rules.whyAppOff",
  busy: "rules.whyBusy",
  overlap: "rules.whyOverlap",
  restart: "rules.whyRestart",
  paused: "rules.whyPaused",
  timeout: "rules.whyTimeout",
  approval_timeout: "rules.whyApprovalTimeout",
  no_report: "tasks.noResult",
  model_errors: "tasks.modelKeptFailing",
  agent_failed: "tasks.agentDidntStart",
  agent_unavailable: "tasks.agentUnavailable",
  run_budget: "rules.whyRunBudget",
  month_budget: "rules.whyMonthBudget",
  reserve: "rules.whyReserve",
};

/** 存下来的原因给人看:认得的翻成当前语言,其余(模型自己说的)原样 */
export function errorText(error: string, l: Lang = currentLang()): string {
  const key = WHY[error];
  return key ? tl(l, key) : error;
}

/** 观察时要批准、被自动拒绝的事:在 runs.would 里一行一个,带这个前缀(显示时翻成「需要批准:…」) */
export const WOULD_APPROVAL = "approval: ";

/** runs.would 给人看:需要批准的那几行按语言翻,模型写的原样 */
export function wouldText(would: string, l: Lang = currentLang()): string {
  return would
    .split("\n")
    .map((x) => (x.startsWith(WOULD_APPROVAL) ? tl(l, "rules.needsApproval", { what: x.slice(WOULD_APPROVAL.length) }) : x))
    .join("\n");
}

/** DSH 的沙箱 → 给人看的权限 */
export function permissionText(p: string, l: Lang = currentLang()): string {
  return p === "read-only" ? tl(l, "rules.permReadOnly") : p === "workspace-write" ? tl(l, "rules.permWorkspace") : "";
}

const clip = (s: string, n: number) => (s.length > n ? s.slice(0, n - 1) + "…" : s);
const oneLine = (s: string) => s.replace(/\s+/g, " ").trim();

/** 出站队列里那一条的送达状态(合进摘要的看那一条)→ 已发送 / 待发送 / 未送达 */
function sentKey(row: OutboxRow | undefined): "rules.sent" | "rules.unsent" | "rules.pending" {
  if (!row || row.status === "sent" || row.status === "merged") return "rules.sent";
  if (row.status === "held" || row.status === "gone" || row.attempts >= 3) return "rules.unsent";
  return "rules.pending";
}

/**
 * 运行记录的一行(设计第 6 节「Auditing a rule」):
 * 观察:本会发送:“…” / 本会做:… / 本会保持安静;执行:已发送:“…”(待发送、未送达)/ 保持安静;提醒:已提醒:“…”;
 * 失败:…;跳过:电脑没开;中断。
 */
export function runLine(run: RunRow, kind: RuleRow["kind"], carrier?: OutboxRow, l: Lang = currentLang()): string {
  if (run.state === "queued") return tl(l, "tasks.stageQueued");
  if (run.state !== "ended") return tl(l, "rules.running");
  const r = run.report;
  const msg = oneLine(r?.message ?? "");
  const note = oneLine(r?.summary.split("\n")[0] ?? "");
  switch (run.outcome) {
    case "skipped":
      return tl(l, "rules.skipped", { why: errorText(run.error || RUN_ERROR.appOff, l) });
    case "failed":
      return tl(l, "rules.failed", { why: clip(oneLine(r?.message || errorText(run.error || RUN_ERROR.noReport, l)), 120) });
    case "interrupted":
      return tl(l, "rules.interrupted");
    case "stopped":
      return tl(l, "tasks.stageStopped");
    case "budget":
      return run.error ? tl(l, "rules.budgetStopped", { why: errorText(run.error, l) }) : tl(l, "tasks.stageBudget");
    case "done":
      break;
    default:
      return run.outcome;
  }
  const text = clip(msg, 120);
  if (kind === "remind") {
    const key = sentKey(carrier);
    return tl(l, key === "rules.sent" ? "rules.reminded" : key, { text });
  }
  const would = oneLine(wouldText(run.would || r?.would || "", l));
  if (run.mode === "observe") {
    if (msg) return tl(l, "rules.wouldSend", { text });
    if (would) return tl(l, "rules.wouldDo", { text: clip(would, 120) });
    return note ? tl(l, "rules.wouldQuietNote", { note: clip(note, 60) }) : tl(l, "rules.wouldQuiet");
  }
  if (msg) return tl(l, sentKey(carrier), { text });
  return note ? tl(l, "rules.quietNote", { note: clip(note, 60) }) : tl(l, "rules.quiet");
}

/** 运行记录里的一项(界面展开看报告、步骤、版本和权限) */
export interface RuleRunView {
  id: string;
  at: number;
  mode: string;
  cause: string;
  state: string;
  outcome: string;
  line: string;
  summary: string;
  message: string;
  would: string;
  error: string;
  version: number;
  /** 那次的权限:只读 / 可写工作区 */
  permission: string;
  steps: number;
  /** 估算花了多少(美元) */
  costUsd: number;
  startedAt: number;
  endedAt: number;
}