opencode-feishu-plugin 0.1.2 → 0.1.4

package/README.en.md

@@ -388,7 +388,7 @@ Without this relay, any clarifying question would stall the Feishu session forev
 | `recentModelsLimit` | number | `5` | Number of recent models (1–20) |
 | `logLevel` | `debug`\|`info`\|`warn`\|`error` | `info` | Log level (secrets are never logged, only their presence) |
 | `logFile` | string \| boolean | — | `true` writes `<configDir>/plugins/feishu.log`. **Plugin stderr is discarded in service mode — enable this when debugging** |
-| `gatewayLocation` | string | — | Only start the gateway in this location. OpenCode loads global plugins per location (separate VM contexts, so an in-process singleton cannot dedupe). **Set this to your usual working directory**, otherwise you get multiple long connections |
+| `gatewayLocation` | string | — | Only start the gateway in this location **or any of its subdirectories**. `~` is expanded and relative paths / trailing slashes are normalized. **Set this to your usual working directory** to avoid multiple long connections; leave empty to run in every location |
 | `approvalTtlMs` | number | `600000` | Approval token / card TTL |
 | `staleExecutionMs` | number | `300000` | Watchdog threshold: an execution with no event for this long is treated as stuck and auto-interrupted; a queue stuck this long without `execution.started` also triggers a notice. Clamped to 1–60 minutes |
 | `maxResourcesShown` | number | `8` | Max resource lines shown on an approval card |
@@ -440,7 +440,8 @@ otherwise (per session preset) → ask ─────────────
 | `feishu.json` changes ignored | Confirm the path is `<configDir>/plugins/feishu.json`, then `opencode reload` |
 | Plugin never loads (no logs, no error) | npm path: make sure the package name is in the config `plugins` array (`opencode plugin list` shows it). Directory path: make sure `plugins/<name>/index.js` exists (OpenCode ignores `package.json#main`) |
 | Plugin code changes ignored | `opencode reload` only re-runs `setup`; it does **not** re-import the module from the same path. Upgrade with `opencode plugin update opencode-feishu-plugin`, or restart the service |
-| Multiple long connections / duplicate replies | Set `gatewayLocation` to your usual working directory |
+| Multiple long connections / duplicate replies | Set `gatewayLocation` to your usual working directory (subdirectories also match) |
+| **No response at all**, and no "long connection started" / "plugin ready" in the log | Almost always `gatewayLocation` does not match the directory where you actually opened opencode. The plugin emits a `warn` about "no loaded location matched" after ~2s; you can also set `logLevel: "debug"` to see `skipping non-gateway location`. If still stuck, leave `gatewayLocation` empty to rule it out |
 | No approval cards | The session did not originate from Feishu (no mapping); by design the plugin does not take it over |
 | "Invalid credentials" on button tap | Token expired (default 10 min) or the tapper is not allow-listed |
 | Card content truncated | Feishu card limit is ~30KB; the plugin truncates and marks it. Very long sessions drop the oldest blocks from the card (full content stays in the session) |

package/README.md

@@ -243,7 +243,7 @@ agent 调 `question` 等 form 类交互时，插件把它转成飞书卡片：
 | `recentDirsLimit` / `recentModelsLimit` | number | `5` | 表单「最近使用」条数（1–20） |
 | `logLevel` | `debug`\|`info`\|`warn`\|`error` | `info` | 日志级别 |
 | `logFile` | string \| boolean | — | `true` = 写 `<configDir>/plugins/feishu.log`；服务模式建议开启 |
-| `gatewayLocation` | string | — | 只在该 location 启动网关（OpenCode 按 location 多次加载全局插件，建议设为常用工作目录） |
+| `gatewayLocation` | string | — | 只在该 location（或其**子目录**）启动网关；`~` 自动展开、相对路径/尾斜杠会归一化。留空 = 任意 location 生效 |
 | `approvalTtlMs` | number | `600000` | 审批 token / 卡片有效期 |
 | `staleExecutionMs` | number | `300000` | 看门狗阈值（夹取 1–60 分钟） |
 | `maxResourcesShown` | number | `8` | 审批卡最多展示的资源行数 |
@@ -284,7 +284,8 @@ permission.evaluate (插件 hook)               permission.asked (事件流)
 | 改了 `feishu.json` 不生效 | 确认路径，然后 `opencode reload` |
 | 插件完全没被加载 | npm 方式确认包名在 `plugins` 数组；目录方式确认 `plugins/<名>/index.js` 存在 |
 | 改了插件代码不生效 | `opencode reload` 不会重新 import 同路径模块；用 `opencode plugin update` 或重启服务 |
-| 出现多个长连接 / 重复回复 | 设置 `gatewayLocation` 为常用工作目录 |
+| 出现多个长连接 / 重复回复 | 设置 `gatewayLocation` 为常用工作目录（其子目录也会命中） |
+| **完全无响应**，且日志中没有任何「长连接已启动」/「飞书插件已就绪」 | 多半是 `gatewayLocation` 与实际打开 opencode 的目录不匹配。插件会在延迟约 2 秒后用 `warn` 打出「已加载的 location 均未命中」；也可临时设 `logLevel: "debug"` 查看 `跳过非网关 location`。确认无误仍无响应就先**留空** `gatewayLocation` 排除该项 |
 | 审批卡收不到 | 该会话不是从飞书发起的（无映射），插件按设计不接管 |
 | 点按钮提示凭证无效 | token 过期（默认 10 分钟）或点击者不在白名单 |
 | 卡片内容被截断 | 飞书卡片上限约 30KB，超长会话丢弃卡片上最旧块（完整内容仍在会话里） |

package/dist/index.js

@@ -4,11 +4,11 @@ import http from 'http';
 import https from 'https';
 import http2 from 'http2';
 import util from 'util';
-import path, { dirname, isAbsolute, resolve as resolve$1, join, sep, basename } from 'path';
+import path, { dirname, isAbsolute, sep, resolve as resolve$1, join, basename } from 'path';
 import zlib from 'zlib';
 import stream3, { Readable } from 'stream';
 import { EventEmitter } from 'events';
-import fs, { mkdirSync, createWriteStream, readFileSync, statSync, realpathSync } from 'fs';
+import fs, { mkdirSync, createWriteStream, readFileSync, realpathSync, statSync } from 'fs';
 import qs from 'querystring';
 import { homedir } from 'os';
 import { readFile, readdir } from 'fs/promises';
@@ -10936,12 +10936,12 @@ var require_promisify = __commonJS({
     Object.defineProperty(exports, "__esModule", { value: true });
     function promisify(fn3) {
       return function(req, opts) {
-        return new Promise((resolve3, reject) => {
+        return new Promise((resolve4, reject) => {
           fn3.call(this, req, opts, (err2, rtn) => {
             if (err2) {
               reject(err2);
             } else {
-              resolve3(rtn);
+              resolve4(rtn);
             }
           });
         });
@@ -11143,7 +11143,7 @@ var require_parse_proxy_response = __commonJS({
     var debug_1 = __importDefault(require_src());
     var debug = debug_1.default("https-proxy-agent:parse-proxy-response");
     function parseProxyResponse(socket) {
-      return new Promise((resolve3, reject) => {
+      return new Promise((resolve4, reject) => {
         let buffersLength = 0;
         const buffers = [];
         function read() {
@@ -11183,7 +11183,7 @@ var require_parse_proxy_response = __commonJS({
           const firstLine = buffered.toString("ascii", 0, buffered.indexOf("\r\n"));
           const statusCode = +firstLine.split(" ")[1];
           debug("got proxy server response: %o", firstLine);
-          resolve3({
+          resolve4({
             statusCode,
             buffered
           });
@@ -11203,11 +11203,11 @@ var require_agent = __commonJS({
   "node_modules/https-proxy-agent/dist/agent.js"(exports) {
     var __awaiter2 = exports && exports.__awaiter || function(thisArg, _arguments, P, generator) {
       function adopt(value3) {
-        return value3 instanceof P ? value3 : new P(function(resolve3) {
-          resolve3(value3);
+        return value3 instanceof P ? value3 : new P(function(resolve4) {
+          resolve4(value3);
         });
       }
-      return new (P || (P = Promise))(function(resolve3, reject) {
+      return new (P || (P = Promise))(function(resolve4, reject) {
         function fulfilled(value3) {
           try {
             step(generator.next(value3));
@@ -11223,7 +11223,7 @@ var require_agent = __commonJS({
           }
         }
         function step(result3) {
-          result3.done ? resolve3(result3.value) : adopt(result3.value).then(fulfilled, rejected);
+          result3.done ? resolve4(result3.value) : adopt(result3.value).then(fulfilled, rejected);
         }
         step((generator = generator.apply(thisArg, _arguments || [])).next());
       });
@@ -18969,7 +18969,7 @@ var require_aspromise = __commonJS({
       var params = new Array(arguments.length - 1), offset = 0, index2 = 2, pending = true;
       while (index2 < arguments.length)
         params[offset++] = arguments[index2++];
-      return new Promise(function executor(resolve3, reject) {
+      return new Promise(function executor(resolve4, reject) {
         params[offset] = function callback3(err2) {
           if (pending) {
             pending = false;
@@ -18979,7 +18979,7 @@ var require_aspromise = __commonJS({
               var params2 = new Array(arguments.length - 1), offset2 = 0;
               while (offset2 < params2.length)
                 params2[offset2++] = arguments[offset2];
-              resolve3.apply(null, params2);
+              resolve4.apply(null, params2);
             }
           }
         };
@@ -23158,10 +23158,10 @@ var CanceledError = class extends AxiosError_default {
 var CanceledError_default = CanceledError;
 
 // node_modules/axios/lib/core/settle.js
-function settle(resolve3, reject, response2) {
+function settle(resolve4, reject, response2) {
   const validateStatus2 = response2.config.validateStatus;
   if (!response2.status || !validateStatus2 || validateStatus2(response2.status)) {
-    resolve3(response2);
+    resolve4(response2);
   } else {
     reject(new AxiosError_default(
       "Request failed with status code " + response2.status,
@@ -24494,7 +24494,7 @@ function setProxy(options2, configProxy, location, isRedirect, configHttpsAgent,
 }
 var isHttpAdapterSupported = typeof process !== "undefined" && utils_default.kindOf(process) === "process";
 var wrapAsync = (asyncExecutor) => {
-  return new Promise((resolve3, reject) => {
+  return new Promise((resolve4, reject) => {
     let onDone;
     let isDone3;
     const done4 = (value3, isRejected) => {
@@ -24504,7 +24504,7 @@ var wrapAsync = (asyncExecutor) => {
     };
     const _resolve = (value3) => {
       done4(value3);
-      resolve3(value3);
+      resolve4(value3);
     };
     const _reject = (reason) => {
       done4(reason, true);
@@ -24575,7 +24575,7 @@ var http2Transport = {
   }
 };
 var http_default = isHttpAdapterSupported && function httpAdapter(config) {
-  return wrapAsync(async function dispatchHttpRequest(resolve3, reject, onDone) {
+  return wrapAsync(async function dispatchHttpRequest(resolve4, reject, onDone) {
     const own2 = (key) => utils_default.getSafeProp(config, key);
     const transitional2 = own2("transitional") || transitional_default;
     let data = own2("data");
@@ -24712,7 +24712,7 @@ var http_default = isHttpAdapterSupported && function httpAdapter(config) {
       }
       let convertedData;
       if (method !== "GET") {
-        return settle(resolve3, reject, {
+        return settle(resolve4, reject, {
           status: 405,
           statusText: "method not allowed",
           headers: {},
@@ -24734,7 +24734,7 @@ var http_default = isHttpAdapterSupported && function httpAdapter(config) {
       } else if (responseType === "stream") {
         convertedData = stream3.Readable.from(convertedData);
       }
-      return settle(resolve3, reject, {
+      return settle(resolve4, reject, {
         data: convertedData,
         status: 200,
         statusText: "OK",
@@ -25105,7 +25105,7 @@ var http_default = isHttpAdapterSupported && function httpAdapter(config) {
           });
         }
         response2.data = responseStream;
-        settle(resolve3, reject, response2);
+        settle(resolve4, reject, response2);
       } else {
         const responseBuffer = [];
         let totalResponseBytes = 0;
@@ -25156,7 +25156,7 @@ var http_default = isHttpAdapterSupported && function httpAdapter(config) {
           } catch (err2) {
             return reject(AxiosError_default.from(err2, null, config, response2.request, response2));
           }
-          settle(resolve3, reject, response2);
+          settle(resolve4, reject, response2);
         });
       }
       abortEmitter.once("abort", (err2) => {
@@ -25530,7 +25530,7 @@ var resolveConfig_default = resolveConfig;
 // node_modules/axios/lib/adapters/xhr.js
 var isXHRAdapterSupported = typeof XMLHttpRequest !== "undefined";
 var xhr_default = isXHRAdapterSupported && function(config) {
-  return new Promise(function dispatchXhrRequest(resolve3, reject) {
+  return new Promise(function dispatchXhrRequest(resolve4, reject) {
     const _config = resolveConfig_default(config);
     let requestData = _config.data;
     const requestHeaders = AxiosHeaders_default.from(_config.headers).normalize();
@@ -25585,7 +25585,7 @@ var xhr_default = isXHRAdapterSupported && function(config) {
       };
       settle(
         function _resolve(value3) {
-          resolve3(value3);
+          resolve4(value3);
           done4();
         },
         function _reject(err2) {
@@ -26210,8 +26210,8 @@ var factory = (env) => {
         }
       }
       !isStreamResponse && unsubscribe && unsubscribe();
-      return await new Promise((resolve3, reject) => {
-        settle(resolve3, reject, {
+      return await new Promise((resolve4, reject) => {
+        settle(resolve4, reject, {
           data: responseData,
           headers: AxiosHeaders_default.from(response2.headers),
           status: response2.status,
@@ -26690,8 +26690,8 @@ var CancelToken = class _CancelToken {
       throw new TypeError("executor must be a function.");
     }
     let resolvePromise;
-    this.promise = new Promise(function promiseExecutor(resolve3) {
-      resolvePromise = resolve3;
+    this.promise = new Promise(function promiseExecutor(resolve4) {
+      resolvePromise = resolve4;
     });
     const token = this;
     this.promise.then((cancel) => {
@@ -26704,9 +26704,9 @@ var CancelToken = class _CancelToken {
     });
     this.promise.then = (onfulfilled) => {
       let _resolve;
-      const promise3 = new Promise((resolve3) => {
-        token.subscribe(resolve3);
-        _resolve = resolve3;
+      const promise3 = new Promise((resolve4) => {
+        token.subscribe(resolve4);
+        _resolve = resolve4;
       }).then(onfulfilled);
       promise3.cancel = function reject() {
         token.unsubscribe(_resolve);
@@ -26966,11 +26966,11 @@ function __rest(s, e) {
 }
 function __awaiter(thisArg, _arguments, P, generator) {
   function adopt(value3) {
-    return value3 instanceof P ? value3 : new P(function(resolve3) {
-      resolve3(value3);
+    return value3 instanceof P ? value3 : new P(function(resolve4) {
+      resolve4(value3);
     });
   }
-  return new (P || (P = Promise))(function(resolve3, reject) {
+  return new (P || (P = Promise))(function(resolve4, reject) {
     function fulfilled(value3) {
       try {
         step(generator.next(value3));
@@ -26986,7 +26986,7 @@ function __awaiter(thisArg, _arguments, P, generator) {
       }
     }
     function step(result3) {
-      result3.done ? resolve3(result3.value) : adopt(result3.value).then(fulfilled, rejected);
+      result3.done ? resolve4(result3.value) : adopt(result3.value).then(fulfilled, rejected);
     }
     step((generator = generator.apply(thisArg, [])).next());
   });
@@ -27011,11 +27011,11 @@ function __asyncGenerator(thisArg, _arguments, generator) {
     try {
       step(g[n](v));
     } catch (e) {
-      settle2(q[0][3], e);
+      settle3(q[0][3], e);
     }
   }
   function step(r) {
-    r.value instanceof __await ? Promise.resolve(r.value.v).then(fulfill, reject) : settle2(q[0][2], r);
+    r.value instanceof __await ? Promise.resolve(r.value.v).then(fulfill, reject) : settle3(q[0][2], r);
   }
   function fulfill(value3) {
     resume("next", value3);
@@ -27023,7 +27023,7 @@ function __asyncGenerator(thisArg, _arguments, generator) {
   function reject(value3) {
     resume("throw", value3);
   }
-  function settle2(f, v) {
+  function settle3(f, v) {
     if (f(v), q.shift(), q.length) resume(q[0][0], q[0][1]);
   }
 }
@@ -27376,10 +27376,10 @@ var Client$1P = class {
           return {
             writeFile: (filePath) => __awaiter(this, void 0, void 0, function* () {
               checkIsReadable();
-              return new Promise((resolve3, reject) => {
+              return new Promise((resolve4, reject) => {
                 const writableStream = fs.createWriteStream(filePath);
                 writableStream.on("finish", () => {
-                  resolve3(filePath);
+                  resolve4(filePath);
                 });
                 writableStream.on("error", (e) => {
                   reject(e);
@@ -27559,10 +27559,10 @@ var Client$1P = class {
           return {
             writeFile: (filePath) => __awaiter(this, void 0, void 0, function* () {
               checkIsReadable();
-              return new Promise((resolve3, reject) => {
+              return new Promise((resolve4, reject) => {
                 const writableStream = fs.createWriteStream(filePath);
                 writableStream.on("finish", () => {
-                  resolve3(filePath);
+                  resolve4(filePath);
                 });
                 writableStream.on("error", (e) => {
                   reject(e);
@@ -27895,10 +27895,10 @@ var Client$1P = class {
             return {
               writeFile: (filePath) => __awaiter(this, void 0, void 0, function* () {
                 checkIsReadable();
-                return new Promise((resolve3, reject) => {
+                return new Promise((resolve4, reject) => {
                   const writableStream = fs.createWriteStream(filePath);
                   writableStream.on("finish", () => {
-                    resolve3(filePath);
+                    resolve4(filePath);
                   });
                   writableStream.on("error", (e) => {
                     reject(e);
@@ -28080,10 +28080,10 @@ var Client$1P = class {
             return {
               writeFile: (filePath) => __awaiter(this, void 0, void 0, function* () {
                 checkIsReadable();
-                return new Promise((resolve3, reject) => {
+                return new Promise((resolve4, reject) => {
                   const writableStream = fs.createWriteStream(filePath);
                   writableStream.on("finish", () => {
-                    resolve3(filePath);
+                    resolve4(filePath);
                   });
                   writableStream.on("error", (e) => {
                     reject(e);
@@ -36923,10 +36923,10 @@ var Client$1H = class extends Client$1I {
           return {
             writeFile: (filePath) => __awaiter(this, void 0, void 0, function* () {
               checkIsReadable();
-              return new Promise((resolve3, reject) => {
+              return new Promise((resolve4, reject) => {
                 const writableStream = fs.createWriteStream(filePath);
                 writableStream.on("finish", () => {
-                  resolve3(filePath);
+                  resolve4(filePath);
                 });
                 writableStream.on("error", (e) => {
                   reject(e);
@@ -38105,10 +38105,10 @@ var Client$1H = class extends Client$1I {
             return {
               writeFile: (filePath) => __awaiter(this, void 0, void 0, function* () {
                 checkIsReadable();
-                return new Promise((resolve3, reject) => {
+                return new Promise((resolve4, reject) => {
                   const writableStream = fs.createWriteStream(filePath);
                   writableStream.on("finish", () => {
-                    resolve3(filePath);
+                    resolve4(filePath);
                   });
                   writableStream.on("error", (e) => {
                     reject(e);
@@ -40311,10 +40311,10 @@ var Client$1B = class extends Client$1C {
           return {
             writeFile: (filePath) => __awaiter(this, void 0, void 0, function* () {
               checkIsReadable();
-              return new Promise((resolve3, reject) => {
+              return new Promise((resolve4, reject) => {
                 const writableStream = fs.createWriteStream(filePath);
                 writableStream.on("finish", () => {
-                  resolve3(filePath);
+                  resolve4(filePath);
                 });
                 writableStream.on("error", (e) => {
                   reject(e);
@@ -40837,10 +40837,10 @@ var Client$1B = class extends Client$1C {
             return {
               writeFile: (filePath) => __awaiter(this, void 0, void 0, function* () {
                 checkIsReadable();
-                return new Promise((resolve3, reject) => {
+                return new Promise((resolve4, reject) => {
                   const writableStream = fs.createWriteStream(filePath);
                   writableStream.on("finish", () => {
-                    resolve3(filePath);
+                    resolve4(filePath);
                   });
                   writableStream.on("error", (e) => {
                     reject(e);
@@ -44858,10 +44858,10 @@ var Client$1x = class extends Client$1y {
             return {
               writeFile: (filePath) => __awaiter(this, void 0, void 0, function* () {
                 checkIsReadable();
-                return new Promise((resolve3, reject) => {
+                return new Promise((resolve4, reject) => {
                   const writableStream = fs.createWriteStream(filePath);
                   writableStream.on("finish", () => {
-                    resolve3(filePath);
+                    resolve4(filePath);
                   });
                   writableStream.on("error", (e) => {
                     reject(e);
@@ -55831,10 +55831,10 @@ var Client$1l = class extends Client$1m {
           return {
             writeFile: (filePath) => __awaiter(this, void 0, void 0, function* () {
               checkIsReadable();
-              return new Promise((resolve3, reject) => {
+              return new Promise((resolve4, reject) => {
                 const writableStream = fs.createWriteStream(filePath);
                 writableStream.on("finish", () => {
-                  resolve3(filePath);
+                  resolve4(filePath);
                 });
                 writableStream.on("error", (e) => {
                   reject(e);
@@ -58588,10 +58588,10 @@ var Client$1l = class extends Client$1m {
             return {
               writeFile: (filePath) => __awaiter(this, void 0, void 0, function* () {
                 checkIsReadable();
-                return new Promise((resolve3, reject) => {
+                return new Promise((resolve4, reject) => {
                   const writableStream = fs.createWriteStream(filePath);
                   writableStream.on("finish", () => {
-                    resolve3(filePath);
+                    resolve4(filePath);
                   });
                   writableStream.on("error", (e) => {
                     reject(e);
@@ -62027,10 +62027,10 @@ var Client$1l = class extends Client$1m {
             return {
               writeFile: (filePath) => __awaiter(this, void 0, void 0, function* () {
                 checkIsReadable();
-                return new Promise((resolve3, reject) => {
+                return new Promise((resolve4, reject) => {
                   const writableStream = fs.createWriteStream(filePath);
                   writableStream.on("finish", () => {
-                    resolve3(filePath);
+                    resolve4(filePath);
                   });
                   writableStream.on("error", (e) => {
                     reject(e);
@@ -68652,10 +68652,10 @@ var Client$1c = class extends Client$1d {
           return {
             writeFile: (filePath) => __awaiter(this, void 0, void 0, function* () {
               checkIsReadable();
-              return new Promise((resolve3, reject) => {
+              return new Promise((resolve4, reject) => {
                 const writableStream = fs.createWriteStream(filePath);
                 writableStream.on("finish", () => {
-                  resolve3(filePath);
+                  resolve4(filePath);
                 });
                 writableStream.on("error", (e) => {
                   reject(e);
@@ -68904,10 +68904,10 @@ var Client$1c = class extends Client$1d {
           return {
             writeFile: (filePath) => __awaiter(this, void 0, void 0, function* () {
               checkIsReadable();
-              return new Promise((resolve3, reject) => {
+              return new Promise((resolve4, reject) => {
                 const writableStream = fs.createWriteStream(filePath);
                 writableStream.on("finish", () => {
-                  resolve3(filePath);
+                  resolve4(filePath);
                 });
                 writableStream.on("error", (e) => {
                   reject(e);
@@ -69525,10 +69525,10 @@ var Client$1c = class extends Client$1d {
           return {
             writeFile: (filePath) => __awaiter(this, void 0, void 0, function* () {
               checkIsReadable();
-              return new Promise((resolve3, reject) => {
+              return new Promise((resolve4, reject) => {
                 const writableStream = fs.createWriteStream(filePath);
                 writableStream.on("finish", () => {
-                  resolve3(filePath);
+                  resolve4(filePath);
                 });
                 writableStream.on("error", (e) => {
                   reject(e);
@@ -70471,10 +70471,10 @@ var Client$1c = class extends Client$1d {
             return {
               writeFile: (filePath) => __awaiter(this, void 0, void 0, function* () {
                 checkIsReadable();
-                return new Promise((resolve3, reject) => {
+                return new Promise((resolve4, reject) => {
                   const writableStream = fs.createWriteStream(filePath);
                   writableStream.on("finish", () => {
-                    resolve3(filePath);
+                    resolve4(filePath);
                   });
                   writableStream.on("error", (e) => {
                     reject(e);
@@ -70723,10 +70723,10 @@ var Client$1c = class extends Client$1d {
             return {
               writeFile: (filePath) => __awaiter(this, void 0, void 0, function* () {
                 checkIsReadable();
-                return new Promise((resolve3, reject) => {
+                return new Promise((resolve4, reject) => {
                   const writableStream = fs.createWriteStream(filePath);
                   writableStream.on("finish", () => {
-                    resolve3(filePath);
+                    resolve4(filePath);
                   });
                   writableStream.on("error", (e) => {
                     reject(e);
@@ -71350,10 +71350,10 @@ var Client$1c = class extends Client$1d {
             return {
               writeFile: (filePath) => __awaiter(this, void 0, void 0, function* () {
                 checkIsReadable();
-                return new Promise((resolve3, reject) => {
+                return new Promise((resolve4, reject) => {
                   const writableStream = fs.createWriteStream(filePath);
                   writableStream.on("finish", () => {
-                    resolve3(filePath);
+                    resolve4(filePath);
                   });
                   writableStream.on("error", (e) => {
                     reject(e);
@@ -72189,10 +72189,10 @@ var Client$19 = class extends Client$1a {
           return {
             writeFile: (filePath) => __awaiter(this, void 0, void 0, function* () {
               checkIsReadable();
-              return new Promise((resolve3, reject) => {
+              return new Promise((resolve4, reject) => {
                 const writableStream = fs.createWriteStream(filePath);
                 writableStream.on("finish", () => {
-                  resolve3(filePath);
+                  resolve4(filePath);
                 });
                 writableStream.on("error", (e) => {
                   reject(e);
@@ -72325,10 +72325,10 @@ var Client$19 = class extends Client$1a {
             return {
               writeFile: (filePath) => __awaiter(this, void 0, void 0, function* () {
                 checkIsReadable();
-                return new Promise((resolve3, reject) => {
+                return new Promise((resolve4, reject) => {
                   const writableStream = fs.createWriteStream(filePath);
                   writableStream.on("finish", () => {
-                    resolve3(filePath);
+                    resolve4(filePath);
                   });
                   writableStream.on("error", (e) => {
                     reject(e);
@@ -73160,10 +73160,10 @@ var Client$11 = class extends Client$12 {
           return {
             writeFile: (filePath) => __awaiter(this, void 0, void 0, function* () {
               checkIsReadable();
-              return new Promise((resolve3, reject) => {
+              return new Promise((resolve4, reject) => {
                 const writableStream = fs.createWriteStream(filePath);
                 writableStream.on("finish", () => {
-                  resolve3(filePath);
+                  resolve4(filePath);
                 });
                 writableStream.on("error", (e) => {
                   reject(e);
@@ -73558,10 +73558,10 @@ var Client$11 = class extends Client$12 {
           return {
             writeFile: (filePath) => __awaiter(this, void 0, void 0, function* () {
               checkIsReadable();
-              return new Promise((resolve3, reject) => {
+              return new Promise((resolve4, reject) => {
                 const writableStream = fs.createWriteStream(filePath);
                 writableStream.on("finish", () => {
-                  resolve3(filePath);
+                  resolve4(filePath);
                 });
                 writableStream.on("error", (e) => {
                   reject(e);
@@ -74598,10 +74598,10 @@ var Client$11 = class extends Client$12 {
             return {
               writeFile: (filePath) => __awaiter(this, void 0, void 0, function* () {
                 checkIsReadable();
-                return new Promise((resolve3, reject) => {
+                return new Promise((resolve4, reject) => {
                   const writableStream = fs.createWriteStream(filePath);
                   writableStream.on("finish", () => {
-                    resolve3(filePath);
+                    resolve4(filePath);
                   });
                   writableStream.on("error", (e) => {
                     reject(e);
@@ -75000,10 +75000,10 @@ var Client$11 = class extends Client$12 {
             return {
               writeFile: (filePath) => __awaiter(this, void 0, void 0, function* () {
                 checkIsReadable();
-                return new Promise((resolve3, reject) => {
+                return new Promise((resolve4, reject) => {
                   const writableStream = fs.createWriteStream(filePath);
                   writableStream.on("finish", () => {
-                    resolve3(filePath);
+                    resolve4(filePath);
                   });
                   writableStream.on("error", (e) => {
                     reject(e);
@@ -89699,10 +89699,10 @@ var Client$_ = class extends Client$$ {
           return {
             writeFile: (filePath) => __awaiter(this, void 0, void 0, function* () {
               checkIsReadable();
-              return new Promise((resolve3, reject) => {
+              return new Promise((resolve4, reject) => {
                 const writableStream = fs.createWriteStream(filePath);
                 writableStream.on("finish", () => {
-                  resolve3(filePath);
+                  resolve4(filePath);
                 });
                 writableStream.on("error", (e) => {
                   reject(e);
@@ -89937,10 +89937,10 @@ var Client$_ = class extends Client$$ {
           return {
             writeFile: (filePath) => __awaiter(this, void 0, void 0, function* () {
               checkIsReadable();
-              return new Promise((resolve3, reject) => {
+              return new Promise((resolve4, reject) => {
                 const writableStream = fs.createWriteStream(filePath);
                 writableStream.on("finish", () => {
-                  resolve3(filePath);
+                  resolve4(filePath);
                 });
                 writableStream.on("error", (e) => {
                   reject(e);
@@ -90022,10 +90022,10 @@ var Client$_ = class extends Client$$ {
           return {
             writeFile: (filePath) => __awaiter(this, void 0, void 0, function* () {
               checkIsReadable();
-              return new Promise((resolve3, reject) => {
+              return new Promise((resolve4, reject) => {
                 const writableStream = fs.createWriteStream(filePath);
                 writableStream.on("finish", () => {
-                  resolve3(filePath);
+                  resolve4(filePath);
                 });
                 writableStream.on("error", (e) => {
                   reject(e);
@@ -91844,10 +91844,10 @@ var Client$_ = class extends Client$$ {
             return {
               writeFile: (filePath) => __awaiter(this, void 0, void 0, function* () {
                 checkIsReadable();
-                return new Promise((resolve3, reject) => {
+                return new Promise((resolve4, reject) => {
                   const writableStream = fs.createWriteStream(filePath);
                   writableStream.on("finish", () => {
-                    resolve3(filePath);
+                    resolve4(filePath);
                   });
                   writableStream.on("error", (e) => {
                     reject(e);
@@ -92084,10 +92084,10 @@ var Client$_ = class extends Client$$ {
             return {
               writeFile: (filePath) => __awaiter(this, void 0, void 0, function* () {
                 checkIsReadable();
-                return new Promise((resolve3, reject) => {
+                return new Promise((resolve4, reject) => {
                   const writableStream = fs.createWriteStream(filePath);
                   writableStream.on("finish", () => {
-                    resolve3(filePath);
+                    resolve4(filePath);
                   });
                   writableStream.on("error", (e) => {
                     reject(e);
@@ -92169,10 +92169,10 @@ var Client$_ = class extends Client$$ {
             return {
               writeFile: (filePath) => __awaiter(this, void 0, void 0, function* () {
                 checkIsReadable();
-                return new Promise((resolve3, reject) => {
+                return new Promise((resolve4, reject) => {
                   const writableStream = fs.createWriteStream(filePath);
                   writableStream.on("finish", () => {
-                    resolve3(filePath);
+                    resolve4(filePath);
                   });
                   writableStream.on("error", (e) => {
                     reject(e);
@@ -92674,10 +92674,10 @@ var Client$X = class extends Client$Y {
             return {
               writeFile: (filePath) => __awaiter(this, void 0, void 0, function* () {
                 checkIsReadable();
-                return new Promise((resolve3, reject) => {
+                return new Promise((resolve4, reject) => {
                   const writableStream = fs.createWriteStream(filePath);
                   writableStream.on("finish", () => {
-                    resolve3(filePath);
+                    resolve4(filePath);
                   });
                   writableStream.on("error", (e) => {
                     reject(e);
@@ -99848,10 +99848,10 @@ var Client$Q = class extends Client$R {
             return {
               writeFile: (filePath) => __awaiter(this, void 0, void 0, function* () {
                 checkIsReadable();
-                return new Promise((resolve3, reject) => {
+                return new Promise((resolve4, reject) => {
                   const writableStream = fs.createWriteStream(filePath);
                   writableStream.on("finish", () => {
-                    resolve3(filePath);
+                    resolve4(filePath);
                   });
                   writableStream.on("error", (e) => {
                     reject(e);
@@ -114511,10 +114511,10 @@ var Client$4 = class extends Client$5 {
           return {
             writeFile: (filePath) => __awaiter(this, void 0, void 0, function* () {
               checkIsReadable();
-              return new Promise((resolve3, reject) => {
+              return new Promise((resolve4, reject) => {
                 const writableStream = fs.createWriteStream(filePath);
                 writableStream.on("finish", () => {
-                  resolve3(filePath);
+                  resolve4(filePath);
                 });
                 writableStream.on("error", (e) => {
                   reject(e);
@@ -117842,10 +117842,10 @@ var Client$4 = class extends Client$5 {
             return {
               writeFile: (filePath) => __awaiter(this, void 0, void 0, function* () {
                 checkIsReadable();
-                return new Promise((resolve3, reject) => {
+                return new Promise((resolve4, reject) => {
                   const writableStream = fs.createWriteStream(filePath);
                   writableStream.on("finish", () => {
-                    resolve3(filePath);
+                    resolve4(filePath);
                   });
                   writableStream.on("error", (e) => {
                     reject(e);
@@ -121514,7 +121514,7 @@ var WSClient = class {
     if (!wsInstance) {
       return Promise.resolve(false);
     }
-    return new Promise((resolve3) => {
+    return new Promise((resolve4) => {
       let settled = false;
       let timer;
       const settleOnce = (ok) => {
@@ -121523,7 +121523,7 @@ var WSClient = class {
         settled = true;
         if (timer)
           clearTimeout(timer);
-        resolve3(ok);
+        resolve4(ok);
       };
       if (this.handshakeTimeoutMs && this.handshakeTimeoutMs > 0) {
         timer = setTimeout(() => {
@@ -126771,8 +126771,8 @@ var runPromiseExitWith = (context3) => {
   const runFork3 = runForkWith(context3);
   return (effect2, options2) => {
     const fiber3 = runFork3(effect2, options2);
-    return new Promise((resolve3) => {
-      fiber3.addObserver((exit3) => resolve3(exit3));
+    return new Promise((resolve4) => {
+      fiber3.addObserver((exit3) => resolve4(exit3));
     });
   };
 };
@@ -137127,9 +137127,9 @@ function toStandardSchemaV1(self2, options2) {
     if (exit3) {
       return makeStandardResult(exit3);
     }
-    return new Promise((resolve3) => {
+    return new Promise((resolve4) => {
       fiber3.addObserver((exit4) => {
-        resolve3(makeStandardResult(exit4));
+        resolve4(makeStandardResult(exit4));
       });
     });
   };
@@ -144026,7 +144026,7 @@ function resolveConfig2(raw, env = process.env, deps = {}) {
   const cardMaxTables = clamp4(asNumber(merged.cardMaxTables, 4), 1, 5);
   const domain = merged.domain === "lark" ? "lark" : "feishu";
   const logFile = resolveLogFile(merged.logFile, env, deps);
-  const gatewayLocation = asString(merged.gatewayLocation).trim() || void 0;
+  const gatewayLocation = normalizeGatewayLocation(asString(merged.gatewayLocation));
   const signSecretRaw = expandEnv(asString(merged.signSecret), env);
   const signSecret = signSecretRaw && signSecretRaw.length > 0 ? signSecretRaw : deriveSignSecret(appSecret);
   let enabled = true;
@@ -144114,6 +144114,17 @@ function resolveConfigDir(env, explicit) {
   if (fromEnv) return fromEnv;
   return join(homedir(), ".config", "opencode");
 }
+function normalizeGatewayLocation(raw) {
+  const trimmed = raw.trim();
+  if (!trimmed) return void 0;
+  const expanded = trimmed === "~" ? homedir() : trimmed.startsWith("~/") ? join(homedir(), trimmed.slice(2)) : trimmed;
+  const resolved = resolve$1(expanded);
+  try {
+    return realpathSync(resolved);
+  } catch {
+    return resolved;
+  }
+}
 function resolveLogFile(raw, env, deps) {
   if (raw === true) return join(resolveConfigDir(env, deps.configDir), ...LOG_FILE_RELATIVE);
   if (typeof raw !== "string") return void 0;
@@ -144258,6 +144269,56 @@ function releaseProcessGuard() {
   const slot = g[GUARD_SLOT];
   if (slot) slot.active = false;
 }
+var GATEWAY_SEEN_SLOT = /* @__PURE__ */ Symbol.for("opencode-feishu-v2/gateway-seen");
+function trackGatewayLocationSeen(input) {
+  const g = globalThis;
+  let slot = g[GATEWAY_SEEN_SLOT];
+  if (!slot || slot.expected !== input.expected) {
+    if (slot) settle2(slot);
+    slot = { expected: input.expected, seen: [], matched: false, warned: false, onSettled: [], timer: void 0 };
+    g[GATEWAY_SEEN_SLOT] = slot;
+  }
+  const current = slot;
+  if (!current.seen.includes(input.here)) current.seen = [...current.seen, input.here];
+  if (input.matched) {
+    current.matched = true;
+    settle2(current);
+    return;
+  }
+  if (current.matched || current.warned) {
+    runOnSettled(input.onSettled);
+    return;
+  }
+  if (input.onSettled) current.onSettled.push(input.onSettled);
+  if (current.timer) clearTimeout(current.timer);
+  current.timer = setTimeout(() => {
+    const live = g[GATEWAY_SEEN_SLOT];
+    if (live !== current) return;
+    current.timer = void 0;
+    if (current.matched || current.warned) return;
+    current.warned = true;
+    input.warn(
+      `\u5DF2\u914D\u7F6E gatewayLocation="${current.expected}"\uFF0C\u4F46\u5DF2\u52A0\u8F7D\u7684 location \u5747\u672A\u547D\u4E2D\uFF1A[${current.seen.join(", ") || "(\u65E0)"}]\u3002\u98DE\u4E66\u957F\u8FDE\u63A5\u4E0D\u4F1A\u542F\u52A8\uFF08\u673A\u5668\u4EBA\u65E0\u54CD\u5E94\uFF09\u3002\u8BF7\u786E\u8BA4 gatewayLocation \u662F\u5B9E\u9645\u6253\u5F00 opencode \u7684\u76EE\u5F55\u6216\u5176\u7236\u76EE\u5F55\uFF1B\u7559\u7A7A\u5219\u4EFB\u610F location \u751F\u6548\u3002`
+    );
+    runOnSettled(...current.onSettled.splice(0));
+  }, input.delayMs ?? 2e3);
+}
+function settle2(slot) {
+  if (slot.timer) {
+    clearTimeout(slot.timer);
+    slot.timer = void 0;
+  }
+  runOnSettled(...slot.onSettled.splice(0));
+}
+function runOnSettled(...callbacks) {
+  for (const cb of callbacks) {
+    if (!cb) continue;
+    try {
+      cb();
+    } catch {
+    }
+  }
+}
 
 // src/security/allowlist.ts
 var OWNER_STORAGE_KEY = "feishu:v2:owner";
@@ -146606,8 +146667,8 @@ function buildFormCard(form, answers, opts = {}) {
   });
   const hints = [];
   if (opts.notice) hints.push(opts.notice);
-  if (missing2.length > 0 && visible.length > 1) hints.push(`\u8FD8\u9700\u56DE\u7B54\uFF1A${missing2.join("\u3001")}`);
-  else if (missing2.length > 0) hints.push("\u8BF7\u70B9\u51FB\u4E0A\u9762\u7684\u9009\u9879\uFF0C\u6216\u70B9\u300C\u76F4\u63A5\u56DE\u590D\u7B54\u6848\u300D\u540E\u53D1\u8A00\u3002");
+  if (missing2.length > 0 && visible.length > 1) hints.push(`\u8FD8\u9700\u56DE\u7B54\uFF1A${missing2.join("\u3001")}\uFF08\u53EF\u76F4\u63A5\u53D1\u6587\u5B57\u56DE\u7B54\uFF09`);
+  else if (missing2.length > 0) hints.push("\u53EF\u76F4\u63A5\u53D1\u6587\u5B57\u56DE\u7B54\uFF0C\u6216\u70B9\u4E0A\u65B9\u9009\u9879\u3002");
   if (hints.length > 0) elements.push({ tag: "markdown", content: truncateCardContent(hints.join("\n\n")) });
   const header = headerFor(form);
   return {
@@ -146671,20 +146732,29 @@ var FormRelay = class {
       this.deps.log.warn("\u8868\u5355\u5361\u53D1\u9001\u5931\u8D25", { formID: form.id, error: res.error ?? "unknown" });
       return;
     }
-    this.forms.set(form.id, {
+    const firstVisible = form.fields.find((f) => f.hidden !== true);
+    const pending = {
       form,
       sessionID: form.sessionID,
       chatId: link2.chatId,
       messageId: res.messageId,
       ...link2.dir ? { directory: link2.dir } : {},
       answers: {},
-      settled: false
-    });
+      settled: false,
+      // 自动进入「等待文字回答」状态：用户直接发文字即可作为答案，
+      // 无需先点「直接回复答案」按钮。第一个可见字段作为默认答案字段。
+      ...firstVisible ? { awaitingField: firstVisible.key } : {}
+    };
+    this.forms.set(form.id, pending);
+    if (firstVisible) {
+      this.awaiting.set(form.sessionID, form.id);
+    }
     this.deps.log.info("\u8868\u5355\u5361\u5DF2\u53D1\u9001", {
       formID: form.id,
       sessionID: form.sessionID,
       fieldCount: form.fields.length,
-      isQuestion: form.metadata?.kind === "question"
+      isQuestion: form.metadata?.kind === "question",
+      awaitingField: firstVisible?.key
     });
   }
   /**
@@ -146714,8 +146784,13 @@ var FormRelay = class {
     if (parsed.v === void 0) return TOAST("error", "\u65E0\u6CD5\u8BC6\u522B\u7684\u64CD\u4F5C");
     const value3 = field?.type === "multiselect" && !Array.isArray(parsed.v) ? [String(parsed.v)] : parsed.v;
     pending.answers[parsed.k] = value3;
-    pending.awaitingField = void 0;
-    this.awaiting.delete(pending.sessionID);
+    const nextField = pending.form.fields.find((f) => f.hidden !== true && pending.answers[f.key] === void 0);
+    pending.awaitingField = nextField?.key;
+    if (pending.awaitingField) {
+      this.awaiting.set(pending.sessionID, pending.form.id);
+    } else {
+      this.awaiting.delete(pending.sessionID);
+    }
     if (isComplete(pending.form, pending.answers)) {
       pending.settled = true;
       void this.submit(pending);
@@ -150082,13 +150157,13 @@ var SummaryTimeoutError = class extends Error {
   }
 };
 function withTimeout(promise3, ms) {
-  return new Promise((resolve3, reject) => {
+  return new Promise((resolve4, reject) => {
     const timer = setTimeout(() => reject(new SummaryTimeoutError()), Math.max(1, ms));
     timer.unref?.();
     promise3.then(
       (value3) => {
         clearTimeout(timer);
-        resolve3(value3);
+        resolve4(value3);
       },
       (err2) => {
         clearTimeout(timer);
@@ -150220,7 +150295,7 @@ var CompactController = class {
   constructor(deps) {
     this.deps = deps;
     this.now = deps.now ?? (() => Date.now());
-    this.sleep = deps.sleep ?? ((ms) => new Promise((resolve3) => setTimeout(resolve3, ms)));
+    this.sleep = deps.sleep ?? ((ms) => new Promise((resolve4) => setTimeout(resolve4, ms)));
   }
   deps;
   now;
@@ -150561,13 +150636,13 @@ async function quickGenerateWithSession(deps, input) {
   return { route: "http", result: result3 };
 }
 function withAttemptTimeout(promise3, ms) {
-  return new Promise((resolve3, reject) => {
+  return new Promise((resolve4, reject) => {
     const timer = setTimeout(() => reject(new Error("generate-attempt-timeout")), Math.max(1, ms));
     timer.unref?.();
     promise3.then(
       (value3) => {
         clearTimeout(timer);
-        resolve3(value3);
+        resolve4(value3);
       },
       (err2) => {
         clearTimeout(timer);
@@ -150605,11 +150680,20 @@ var index_default = plugin_exports.define({
       hasAppSecret: hasSecret(config.appSecret)
     });
     const here = ctx.location?.directory;
-    if (config.gatewayLocation && here !== config.gatewayLocation) {
-      log2.debug("\u8DF3\u8FC7\u975E\u7F51\u5173 location", { here, expected: config.gatewayLocation });
-      logSink?.close();
-      return async () => {
-      };
+    if (config.gatewayLocation) {
+      const matched = Boolean(here) && isUnder(here, config.gatewayLocation);
+      trackGatewayLocationSeen({
+        here: here ?? "(unknown)",
+        expected: config.gatewayLocation,
+        matched,
+        warn: (message) => log2.warn(message),
+        ...matched ? {} : { onSettled: () => logSink?.close() }
+      });
+      if (!matched) {
+        log2.debug("\u8DF3\u8FC7\u975E\u7F51\u5173 location", { here, expected: config.gatewayLocation });
+        return async () => {
+        };
+      }
     }
     if (!acquireProcessGuard()) {
       log2.debug("\u68C0\u6D4B\u5230\u540C\u8FDB\u7A0B\u91CD\u590D setup\uFF0C\u8DF3\u8FC7\u542F\u52A8\uFF08\u4EC5\u9996\u4E2A\u5B9E\u4F8B\u751F\u6548\uFF09");

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "opencode-feishu-plugin",
-  "version": "0.1.2",
+  "version": "0.1.4",
   "description": "Feishu/Lark plugin for OpenCode V2 — single-user topics as sessions, in-card permission approvals, streaming cards. Minimal permissions, no public endpoint.",
   "type": "module",
   "main": "index.js",