@seamnet/client 0.12.4

package/lib/plugins/scheduler/index.cjs

@@ -0,0 +1,215 @@
+/**
+ * Seam Scheduler Plugin — 心跳 + 定时自注入。
+ *
+ * 契约（Plugin v1）：
+ *   - Actions:
+ *       self_schedule : 创建/更新重复 schedule
+ *       self_cancel   : 取消某个 schedule
+ *       self_list     : 列出所有活跃 schedule
+ *
+ * 内置行为：
+ *   - init 时从 state 恢复已有 schedules
+ *   - 如果没有 id=heartbeat 的 schedule，自动创建默认心跳
+ *   - 心跳内容从 .seam/heartbeat.md 读（每次 fire 重新读，改文件即生效）
+ *
+ * 错误码：
+ *   - SCHEDULER_BAD_PAYLOAD    : 参数缺失
+ *   - SCHEDULER_TOO_MANY       : schedule 数量超限
+ *   - SCHEDULER_NOT_FOUND      : cancel 时 id 不存在
+ */
+
+const fs = require('node:fs');
+const path = require('node:path');
+const { seamError } = require('../../errors.cjs');
+const { validatePayload } = require('../../contracts/actions.cjs');
+
+const MAX_SCHEDULES = 10;
+const MIN_INTERVAL = 60000;       // 1 min
+const MAX_INTERVAL = 86400000;    // 24 h
+const DEFAULT_HEARTBEAT_MS = 600000; // 10 min
+
+function createSchedulerPlugin() {
+  let hub = null;
+  let log = null;
+  let stateScope = null;
+  let seamDir = '';
+  const timers = new Map(); // id → intervalId
+
+  async function init(_hub) {
+    hub = _hub;
+    log = hub.logger('scheduler');
+    stateScope = hub.service('state').scope('scheduler');
+    seamDir = hub.seamDir || process.cwd();
+
+    const saved = stateScope.all();
+    const schedules = saved.schedules || {};
+
+    // 恢复已有 schedules
+    for (const [id, cfg] of Object.entries(schedules)) {
+      if (cfg.active) {
+        startTimer(id, cfg);
+        log.info('schedule_restored', { id, every_ms: cfg.every_ms });
+      }
+    }
+
+    // 心跳模板文件准备好（但不自动启用——AI 自己决定要不要开）
+    ensureHeartbeatFile(path.join(seamDir, 'heartbeat.md'));
+  }
+
+  function readConfigHeartbeatInterval() {
+    try {
+      const cfgPath = path.join(seamDir, 'config.json');
+      if (fs.existsSync(cfgPath)) {
+        const cfg = JSON.parse(fs.readFileSync(cfgPath, 'utf8'));
+        if (cfg.heartbeat?.interval_ms) {
+          return clampInterval(cfg.heartbeat.interval_ms);
+        }
+      }
+    } catch {}
+    return DEFAULT_HEARTBEAT_MS;
+  }
+
+  function ensureHeartbeatFile(filePath) {
+    if (fs.existsSync(filePath)) return;
+    const defaultContent = '[心跳] 心跳。你在做什么？想做什么？';
+    try {
+      fs.writeFileSync(filePath, defaultContent);
+    } catch {}
+  }
+
+  function clampInterval(ms) {
+    return Math.max(MIN_INTERVAL, Math.min(MAX_INTERVAL, parseInt(ms, 10) || DEFAULT_HEARTBEAT_MS));
+  }
+
+  function resolveText(cfg) {
+    if (cfg.text_file) {
+      try {
+        return fs.readFileSync(cfg.text_file, 'utf8').trim();
+      } catch {
+        return `[scheduler] 无法读取 ${cfg.text_file}`;
+      }
+    }
+    return cfg.text || '';
+  }
+
+  function startTimer(id, cfg) {
+    if (timers.has(id)) {
+      clearInterval(timers.get(id));
+    }
+    const intervalId = setInterval(() => {
+      const text = resolveText(cfg);
+      if (text) {
+        hub.inject(text);
+        log.info('schedule_fired', { id, text_len: text.length });
+      }
+    }, cfg.every_ms);
+    timers.set(id, intervalId);
+  }
+
+  function stopTimer(id) {
+    if (timers.has(id)) {
+      clearInterval(timers.get(id));
+      timers.delete(id);
+    }
+  }
+
+  function saveSchedule(id, cfg) {
+    const all = stateScope.get('schedules') || {};
+    all[id] = cfg;
+    stateScope.set('schedules', all);
+  }
+
+  function removeSchedule(id) {
+    const all = stateScope.get('schedules') || {};
+    delete all[id];
+    stateScope.set('schedules', all);
+  }
+
+  function getSchedules() {
+    return stateScope.get('schedules') || {};
+  }
+
+  async function handleRequest(req) {
+    const check = validatePayload(req.action, req);
+    if (!check.ok) {
+      throw seamError({ code: 'SCHEDULER_BAD_PAYLOAD', message: check.error });
+    }
+
+    if (req.action === 'self_schedule') {
+      const id = req.id;
+      const everyMs = clampInterval(req.every_ms);
+      const schedules = getSchedules();
+
+      if (!schedules[id] && Object.keys(schedules).length >= MAX_SCHEDULES) {
+        throw seamError({ code: 'SCHEDULER_TOO_MANY', message: `最多 ${MAX_SCHEDULES} 个 schedule` });
+      }
+
+      const cfg = {
+        every_ms: everyMs,
+        active: true,
+        created_at: schedules[id]?.created_at || new Date().toISOString(),
+        updated_at: new Date().toISOString(),
+      };
+      if (req.text_file) cfg.text_file = req.text_file;
+      else if (req.text) cfg.text = req.text;
+      else if (schedules[id]?.text_file) cfg.text_file = schedules[id].text_file;
+      else if (schedules[id]?.text) cfg.text = schedules[id].text;
+
+      saveSchedule(id, cfg);
+      startTimer(id, cfg);
+      log.info('schedule_set', { id, every_ms: everyMs });
+      return { ok: true, id, every_ms: everyMs };
+    }
+
+    if (req.action === 'self_cancel') {
+      const id = req.id;
+      const schedules = getSchedules();
+      if (!schedules[id]) {
+        throw seamError({ code: 'SCHEDULER_NOT_FOUND', message: `schedule "${id}" not found` });
+      }
+      stopTimer(id);
+      removeSchedule(id);
+      log.info('schedule_cancelled', { id });
+      return { ok: true, cancelled: id };
+    }
+
+    if (req.action === 'self_list') {
+      const schedules = getSchedules();
+      const list = Object.entries(schedules).map(([id, cfg]) => ({
+        id,
+        every_ms: cfg.every_ms,
+        every_human: humanInterval(cfg.every_ms),
+        active: cfg.active,
+        source: cfg.text_file ? `file:${cfg.text_file}` : `text:${(cfg.text || '').slice(0, 50)}`,
+        created_at: cfg.created_at,
+      }));
+      return { ok: true, schedules: list };
+    }
+
+    throw seamError({ code: 'SCHEDULER_UNKNOWN_ACTION', message: `unknown: ${req.action}` });
+  }
+
+  function humanInterval(ms) {
+    if (ms >= 3600000) return `${(ms / 3600000).toFixed(1)}h`;
+    if (ms >= 60000) return `${(ms / 60000).toFixed(0)}m`;
+    return `${(ms / 1000).toFixed(0)}s`;
+  }
+
+  async function destroy() {
+    for (const [id, intervalId] of timers) {
+      clearInterval(intervalId);
+    }
+    timers.clear();
+    if (log) log.info('scheduler_destroyed');
+  }
+
+  return {
+    name: 'scheduler',
+    actions: ['self_schedule', 'self_cancel', 'self_list'],
+    init,
+    handleRequest,
+    destroy,
+  };
+}
+
+module.exports = { createSchedulerPlugin };

package/lib/plugins/wechat/README.md

@@ -0,0 +1,54 @@
+# WeChat Plugin
+
+微信 iLink Bot API 适配器。
+
+## Actions
+
+| action | 参数 | 说明 |
+|---|---|---|
+| `wechat_send` | `{text}` | 向绑定的微信用户发消息（需 context_token 已刷新） |
+| `wechat_login` | `{fromUserId?}` | 启动扫码登录流程（二维码会通过 IM 发给 fromUserId） |
+| `wechat_status` | `{}` | 返回 `{bound, status, user}` |
+
+## 触发机制
+
+IM 收到"绑定微信"文本 → `im.onMessage` 回调检测 → 自动启动 `startLogin(fromUserId)`。
+
+## 消息注入前缀
+
+- `📱 [微信]` — 微信消息注入终端
+
+## 错误码
+
+- `WECHAT_MISSING_IM_DEP` — init 时 hub.get('im') 为空
+- `WECHAT_QR_FAILED` — 获取二维码失败
+- `WECHAT_QR_EXPIRED` — 扫码超时（5 分钟）
+- `WECHAT_SESSION_FROZEN` — bot 被风控（-14）
+- `WECHAT_NOT_BOUND` — 未绑定或 context_token 为空
+- `WECHAT_UNKNOWN_ACTION` — 未知 action
+
+## 依赖
+
+- `im` 插件：发二维码图片、订阅 IM 消息触发
+- npm 包：`qrcode`（生成二维码图片）
+
+## 状态持久化
+
+`.seam/wechat-binding.json`：
+```json
+{
+  "bot_token": "...",
+  "ilink_user_id": "...",
+  "context_token": "...",
+  "updates_buf": "...",
+  "status": "active | pending_first_message | frozen"
+}
+```
+
+文件权限 0600（避免同机其他用户读取）。
+
+## 已知问题
+
+- `context_token` 在每次收到用户消息时刷新——如果长时间没收到消息，发消息可能失败（需要用户主动发一条新的）
+- `-14` 风控会让状态变 frozen 并暂停 1 小时自动恢复
+- 跨天后 binding 可能失效——需要重新扫码