farming-code 2.2.30 → 2.2.32

package/backend/farming-agent-bootstrap.cjs

@@ -0,0 +1,81 @@
+// Generated by scripts/build-backend-runtime.ts. Do not edit.
+"use strict";
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var farming_agent_bootstrap_exports = {};
+__export(farming_agent_bootstrap_exports, {
+  appendOpenCodeBootstrap: () => appendOpenCodeBootstrap,
+  ensureFarmingAgentBootstrapFile: () => ensureFarmingAgentBootstrapFile,
+  renderFarmingAgentBootstrap: () => renderFarmingAgentBootstrap
+});
+module.exports = __toCommonJS(farming_agent_bootstrap_exports);
+var storageLayout = __toESM(require("./storage-layout.cjs"));
+const fs = require("fs");
+const path = require("path");
+const sourceFile = path.join(__dirname, "farming-agent-bootstrap.zh_cn.md");
+function renderFarmingAgentBootstrap() {
+  return fs.readFileSync(sourceFile, "utf8").trim();
+}
+function ensureFarmingAgentBootstrapFile(configDir) {
+  const target = storageLayout.farmingAgentBootstrapFile(configDir);
+  const content = `${renderFarmingAgentBootstrap()}
+`;
+  try {
+    if (fs.readFileSync(target, "utf8") === content) return target;
+  } catch {
+  }
+  fs.mkdirSync(path.dirname(target), { recursive: true });
+  const temporary = `${target}.${process.pid}.${Date.now()}.tmp`;
+  fs.writeFileSync(temporary, content, { encoding: "utf8", mode: 384 });
+  fs.renameSync(temporary, target);
+  return target;
+}
+function appendOpenCodeBootstrap(env, bootstrapFile) {
+  const next = { ...env };
+  let config = {};
+  if (next.OPENCODE_CONFIG_CONTENT) {
+    try {
+      const parsed = JSON.parse(next.OPENCODE_CONFIG_CONTENT);
+      if (parsed && typeof parsed === "object" && !Array.isArray(parsed)) {
+        config = parsed;
+      }
+    } catch {
+      return next;
+    }
+  }
+  const instructions = Array.isArray(config.instructions) ? config.instructions.filter((value) => typeof value === "string") : [];
+  config.instructions = [.../* @__PURE__ */ new Set([...instructions, bootstrapFile])];
+  next.OPENCODE_CONFIG_CONTENT = JSON.stringify(config);
+  return next;
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  appendOpenCodeBootstrap,
+  ensureFarmingAgentBootstrapFile,
+  renderFarmingAgentBootstrap
+});

package/backend/farming-agent-bootstrap.zh_cn.md

@@ -2,6 +2,10 @@
 
 Farming 可能为当前会话提供系统浏览器、Agent 协作等能力。能力是否可用以 `"$FARMING_CLI_BIN_DIR/farming" capabilities` 的实时结果为准，不要自行假设。必须通过 `"$FARMING_CLI_BIN_DIR/farming"` 调用托管当前 Agent 的 Farming 实例；不要依赖 Shell 的 `PATH`，因为登录 Shell 可能把另一个 Farming 安装解析为 `farming`。下文帮助文本中的 `farming` 均代表这个精确入口。
 
-Farming 将 `agent-browser` 封装为 Farming Browser：Agent 可以通过结构化快照和操作命令更好地查看、调试和操作网页，用户也能在 Farming Viewer 中看到并理解同一个浏览器会话的进展，必要时直接接管。
+Farming 将 `agent-browser` 封装为 Farming Browser：Agent 可以通过结构化快照和操作命令查看、调试和操作网页，用户也能在 Farming Viewer 中看到同一个浏览器会话的进展，必要时直接接管。
 
-当任务涉及打开、查看、调试或操作网页时，先运行 `"$FARMING_CLI_BIN_DIR/farming" capabilities`。Browser 可用时，Farming Browser 是默认浏览器路径：必须优先使用它，先复用当前 Project 的已有 Browser，或按需创建新的 Browser，并把需要用户复查的最终页面留在该 Browser 中。这样会创建 Farming 内可点击、可接管的共享 Browser Resource。不要改用 Provider 自带的通用 Browser、Chrome、Playwright、Puppeteer、Computer Use 或其他仅 Agent 可见的浏览器工具；只有 Farming Browser 不可用、任务明确需要尚未支持的能力，或用户明确指定其他工具时才例外。先用 `"$FARMING_CLI_BIN_DIR/farming" browser list` 发现 Browser；需要标准流程时运行 `"$FARMING_CLI_BIN_DIR/farming" browser help workflow`，只在当前步骤需要时再展开某个帮助主题或具体子命令。
+按完成任务的整体效率、可靠性和可验证性选择工具，不要仅因 Farming Browser 或 Computer 可用而调用它们。如果当前 Agent 自带的能力、环境中已有的 CLI、项目工具或服务专用 Connector/MCP 能更直接、更快或更可靠地完成不依赖交互界面的任务，应优先使用这些能力。当任务本身必须依赖浏览器或完整桌面交互时，若对应能力可用，应优先使用 Farming Browser 或 Computer，让用户与 Agent 关注、操作并按需接管同一个共享资源。用户明确指定工具时遵循用户选择。
+
+当任务确实需要与网页交互、登录或填写表单、检查真实页面视觉/控制台/网络状态、在 Farming Viewer 中留下可复查页面或让用户接管时，先运行 `"$FARMING_CLI_BIN_DIR/farming" capabilities`。Browser 可用时，使用 Farming Browser，先复用当前 Agent 已有的 Browser，或按需创建新的 Agent-owned Browser，并把需要用户复查的最终页面留在该 Browser 中。ACP 会话如果已提供 `browser_*` 结构化工具，使用 `browser_list` / `browser_open` 和对应的细粒度工具；Terminal 或未挂载结构化工具的会话使用同一能力的 `"$FARMING_CLI_BIN_DIR/farming" browser` 命令。进入这个交互路径后，不要改用仅 Agent 可见的通用 Browser、Chrome、Playwright 或 Puppeteer，除非 Farming Browser 不可用、缺少任务所需能力，或用户明确指定其他工具。需要标准 CLI 流程时运行 `"$FARMING_CLI_BIN_DIR/farming" browser help workflow`，只在当前步骤需要时再展开某个帮助主题或具体子命令。
+
+Farming Computer 只用于必须操作完整桌面、系统窗口、浏览器工具栏、权限弹窗或非网页应用，且 CLI、结构化服务工具和 Farming Browser 都无法完成的任务，或者用户明确要求 Computer 时。ACP 会话提供完整的 `computer_*` 细粒度工具；Terminal 使用 `"$FARMING_CLI_BIN_DIR/farming" computer`。先观察再操作，每次操作后重新观察验证；若写操作超时，结果是不确定的，必须先观察，不能盲目重放。用户接管后 Agent 会暂停操作；用户交还控制时，下一次调用必须先观察。Computer 不替代普通网页任务的 Farming Browser，也不替代 CLI 或原生结构化能力。