@keyou007/agent-bot 0.1.22 → 0.1.24-alpha.0

package/dist/updates/DailyUpdateMonitor.js

@@ -0,0 +1,261 @@
+import { randomUUID } from "node:crypto";
+import { compareSemver } from "../cli/SelfUpdater.js";
+import { CardRenderer } from "../feishu/CardRenderer.js";
+import { stableVersionSchema } from "./PublishedRelease.js";
+export function scheduleDailyUpdate(now, random = Math.random) {
+    const start = new Date(now);
+    if (start.getHours() >= 17)
+        start.setDate(start.getDate() + 1);
+    start.setHours(10, 0, 0, 0);
+    const end = new Date(start);
+    end.setHours(17, 0, 0, 0);
+    const lower = Math.max(now, start.getTime());
+    const dueAt = lower + Math.floor(Math.min(0.999999999, Math.max(0, random())) * (end.getTime() - lower));
+    return { day: localDay(start.getTime()), dueAt, checked: false };
+}
+function localDay(now) {
+    const date = new Date(now);
+    return `${date.getFullYear()}-${date.getMonth() + 1}-${date.getDate()}`;
+}
+export class DailyUpdateMonitor {
+    options;
+    renderer = new CardRenderer();
+    now;
+    timer;
+    stopped = true;
+    work = Promise.resolve();
+    busy = false;
+    cardWrites = Promise.resolve();
+    lastCardState = new Map();
+    constructor(options) {
+        this.options = options;
+        this.now = options.now ?? Date.now;
+    }
+    async start() {
+        if (!this.stopped)
+            return;
+        this.stopped = false;
+        this.work = this.recover().catch((error) => this.logError(error));
+        await this.work;
+        if (this.stopped)
+            return;
+        this.timer = setInterval(() => this.poll(), 1_000);
+        this.timer.unref();
+        this.poll();
+    }
+    async stop() {
+        this.stopped = true;
+        clearInterval(this.timer);
+        await this.work;
+        await this.cardWrites;
+    }
+    async cancel(action) {
+        if (this.stopped)
+            throw new Error("自动更新已停止。");
+        const notice = this.options.store.getUpdateNotice(String(action.value.version ?? ""));
+        if (!notice || !action.messageId || action.userId !== notice.userOpenId
+            || action.userId !== this.options.userOpenId() || action.value.token !== notice.token
+            || (notice.messageId && notice.messageId !== action.messageId)) {
+            throw new Error("更新卡片已失效或无权操作。");
+        }
+        if (notice.status === "cancelled")
+            return;
+        if ((notice.status !== "countdown" && notice.status !== "announcing")
+            || (notice.deadline !== undefined && this.now() >= notice.deadline)) {
+            throw new Error("取消倒计时已结束，请查看安全重启卡片中的更新状态。");
+        }
+        this.options.store.saveUpdateNotice({ ...notice, messageId: action.messageId, status: "cancelled" });
+        this.options.logger.info({ version: notice.version }, "Cancelled automatic Agent Bot update.");
+        await this.refreshCard(notice.version);
+    }
+    async cancelPreparedUpdate(version) {
+        const notice = this.options.store.getUpdateNotice(version);
+        if (!notice || (notice.status !== "preparing" && notice.status !== "scheduled"))
+            return;
+        this.options.store.saveUpdateNotice({ ...notice, status: "cancelled" });
+        await this.refreshCard(version).catch((error) => this.logError(error));
+    }
+    poll() {
+        if (this.stopped || this.busy)
+            return;
+        this.busy = true;
+        this.work = this.tick().catch((error) => this.logError(error)).finally(() => { this.busy = false; });
+    }
+    async tick() {
+        for (const notice of this.options.store.listPendingUpdateNotices()) {
+            if (this.stopped)
+                return;
+            if (notice.status !== "countdown")
+                continue;
+            if (notice.userOpenId !== this.options.userOpenId()) {
+                this.options.store.saveUpdateNotice({ ...notice, status: "cancelled" });
+                await this.refreshCard(notice.version);
+            }
+            else if (this.now() < notice.deadline) {
+                try {
+                    await this.refreshCard(notice.version);
+                }
+                catch (error) {
+                    await this.fail(notice.version, error);
+                }
+            }
+            else {
+                await this.apply(notice);
+            }
+        }
+        if (this.stopped)
+            return;
+        const now = this.now();
+        let schedule = this.options.store.getUpdateCheckSchedule();
+        if (!schedule || schedule.day !== localDay(now)) {
+            // Keep tomorrow's persisted random slot when starting after the daily window.
+            if (!schedule || schedule.dueAt <= now) {
+                schedule = scheduleDailyUpdate(now, this.options.random);
+                this.options.store.saveUpdateCheckSchedule(schedule);
+                this.options.logger.info({ dueAt: new Date(schedule.dueAt).toISOString() }, "Scheduled daily Agent Bot update check.");
+            }
+        }
+        if (schedule.checked || now < schedule.dueAt)
+            return;
+        const hour = new Date(now).getHours();
+        if (hour < 10 || hour >= 17)
+            return;
+        const owner = this.options.userOpenId();
+        if (!owner || this.options.hasPendingUpdate())
+            return;
+        this.options.store.saveUpdateCheckSchedule({ ...schedule, checked: true });
+        const version = stableVersionSchema.parse(await this.options.readLatest());
+        if (this.stopped || compareSemver(version, this.options.currentVersion) <= 0
+            || this.options.store.getUpdateNotice(version))
+            return;
+        const notes = await this.options.readNotes(version);
+        if (this.stopped || owner !== this.options.userOpenId())
+            return;
+        if (!notes.trim())
+            throw new Error(`Release notes are unavailable for Agent Bot ${version}.`);
+        let supportError;
+        try {
+            await this.options.checkSupport();
+        }
+        catch (error) {
+            supportError = error instanceof Error ? error.message : String(error);
+        }
+        if (this.stopped || owner !== this.options.userOpenId())
+            return;
+        await this.announce({
+            version, currentVersion: this.options.currentVersion, userOpenId: owner,
+            token: randomUUID(), notes, status: supportError ? "failed" : "announcing", error: supportError,
+        });
+    }
+    async announce(notice) {
+        this.options.store.saveUpdateNotice(notice);
+        try {
+            const messageId = await this.options.outbound.sendInteractiveCard(`open_id:${notice.userOpenId}`, this.renderer.renderUpdateNotice(notice, this.now()), notice.token);
+            if (!messageId)
+                throw new Error("Update notification delivery was not confirmed; automatic update stopped.");
+            const current = this.options.store.getUpdateNotice(notice.version);
+            this.options.store.saveUpdateNotice({
+                ...current, messageId, status: current.status === "announcing" ? "countdown" : current.status,
+                deadline: current.status === "announcing" ? this.now() + 60_000 : undefined,
+            });
+            this.options.logger.info({ version: notice.version }, "Delivered private Agent Bot update notice.");
+            if (!this.stopped)
+                await this.refreshCard(notice.version);
+        }
+        catch (error) {
+            await this.fail(notice.version, error);
+        }
+    }
+    async apply(notice) {
+        if (this.stopped)
+            return;
+        const current = this.options.store.getUpdateNotice(notice.version);
+        if (current.status !== "countdown")
+            return;
+        this.options.store.saveUpdateNotice({ ...current, status: "preparing" });
+        try {
+            await this.refreshCard(current.version);
+            if (this.stopped)
+                return;
+            if (this.options.hasPendingUpdate())
+                throw new Error("已有更新或重启正在等待执行，本次自动更新已停止。");
+            await this.options.applyUpdate(current.version);
+            const latest = this.options.store.getUpdateNotice(current.version);
+            if (latest.status !== "cancelled")
+                this.options.store.saveUpdateNotice({ ...latest, status: "scheduled" });
+        }
+        catch (error) {
+            await this.fail(current.version, error);
+            return;
+        }
+        if (!this.stopped)
+            await this.refreshCard(current.version).catch((error) => this.logError(error));
+    }
+    async recover() {
+        for (const notice of this.options.store.listPendingUpdateNotices()) {
+            if (this.stopped)
+                return;
+            let recovered;
+            if (compareSemver(this.options.currentVersion, notice.version) >= 0) {
+                recovered = { ...notice, status: "completed" };
+            }
+            else if (notice.userOpenId !== this.options.userOpenId()) {
+                recovered = { ...notice, status: "cancelled" };
+            }
+            else if (notice.status === "countdown" && notice.messageId) {
+                // Renew the cancellation window on the same card after downtime.
+                recovered = { ...notice, deadline: this.now() + 60_000 };
+            }
+            else if ((notice.status === "scheduled" || notice.status === "preparing") && this.options.pendingVersion() === notice.version) {
+                recovered = { ...notice, status: "scheduled" };
+            }
+            else {
+                recovered = { ...notice, status: "failed", error: "上次自动更新被中断，未自动重试。" };
+            }
+            this.options.store.saveUpdateNotice(recovered);
+            try {
+                await this.refreshCard(recovered.version);
+                if (recovered.status === "countdown" && !this.stopped) {
+                    const current = this.options.store.getUpdateNotice(recovered.version);
+                    if (current.status === "countdown")
+                        this.options.store.saveUpdateNotice({ ...current, deadline: this.now() + 60_000 });
+                }
+            }
+            catch (error) {
+                if (recovered.status === "countdown")
+                    await this.fail(recovered.version, error);
+                else
+                    this.logError(error);
+            }
+        }
+    }
+    async fail(version, error) {
+        const notice = this.options.store.getUpdateNotice(version);
+        if (notice.status !== "cancelled") {
+            this.options.store.saveUpdateNotice({ ...notice, status: "failed", error: error instanceof Error ? error.message : String(error) });
+        }
+        this.logError(error);
+        if (!this.stopped)
+            await this.refreshCard(version).catch((cardError) => this.logError(cardError));
+    }
+    refreshCard(version) {
+        const write = this.cardWrites.then(async () => {
+            if (this.stopped)
+                return;
+            const notice = this.options.store.getUpdateNotice(version);
+            if (!notice.messageId)
+                return;
+            const key = `${notice.status}:${notice.status === "countdown" ? Math.ceil((notice.deadline - this.now()) / 5_000) : ""}`;
+            if (this.lastCardState.get(version) === key)
+                return;
+            await this.options.outbound.updateInteractiveCard(notice.messageId, this.renderer.renderUpdateNotice(notice, this.now()));
+            this.lastCardState.set(version, key);
+        });
+        this.cardWrites = write.catch(() => undefined);
+        return write;
+    }
+    logError(error) {
+        this.options.logger.warn({ error }, "Automatic Agent Bot update did not complete.");
+    }
+}
+//# sourceMappingURL=DailyUpdateMonitor.js.map

package/dist/updates/DailyUpdateMonitor.js.map

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

package/dist/updates/PublishedRelease.js

@@ -0,0 +1,43 @@
+import { z } from "zod";
+import { AGENT_BOT_PACKAGE_NAME } from "../cli/SelfUpdater.js";
+export const stableVersionSchema = z.string().regex(/^(0|[1-9]\d*)\.(0|[1-9]\d*)\.(0|[1-9]\d*)$/u);
+export async function readLatestStableVersion() {
+    const text = await fetchText(`https://registry.npmjs.org/${encodeURIComponent(AGENT_BOT_PACKAGE_NAME)}/latest`, 256_000);
+    return z.object({ version: stableVersionSchema }).parse(JSON.parse(text)).version;
+}
+export async function readReleaseNotes(version) {
+    stableVersionSchema.parse(version);
+    const changelog = await fetchText(`https://raw.githubusercontent.com/keyou/agent-bot/v${version}/CHANGELOG.md`, 2_000_000);
+    return extractReleaseNotes(changelog, version);
+}
+export function extractReleaseNotes(changelog, version) {
+    const sections = changelog.split(/^## /mu).slice(1);
+    const section = sections.find((value) => value.split(/\r?\n/u, 1)[0]?.startsWith(`[${version}]`));
+    const notes = section?.includes("\n") ? section.slice(section.indexOf("\n") + 1).trim() : undefined;
+    if (!notes)
+        throw new Error(`Release notes are unavailable for Agent Bot ${version}.`);
+    return notes.length > 4_000 ? `${notes.slice(0, 3_900)}\n\n[完整更新日志](https://github.com/keyou/agent-bot/releases/tag/v${version})` : notes;
+}
+async function fetchText(url, maxBytes) {
+    const response = await fetch(url, { signal: AbortSignal.timeout(15_000) });
+    if (!response.ok || !response.body)
+        throw new Error(`Release request failed: HTTP ${response.status}.`);
+    const reader = response.body.getReader();
+    const chunks = [];
+    let size = 0;
+    try {
+        while (true) {
+            const { done, value } = await reader.read();
+            if (done)
+                return Buffer.concat(chunks).toString("utf8");
+            size += value.byteLength;
+            if (size > maxBytes)
+                throw new Error("Release response exceeds the size limit.");
+            chunks.push(value);
+        }
+    }
+    finally {
+        await reader.cancel();
+    }
+}
+//# sourceMappingURL=PublishedRelease.js.map

package/dist/updates/PublishedRelease.js.map

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

package/dist/updates/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/updates/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/updates/types.ts"],"names":[],"mappings":""}

package/docs/technical-reference.md

@@ -54,6 +54,10 @@ Configuration path precedence:
 
 The default `.env` is always loaded from the Agent Bot home. YAML values in the form `${NAME}` are expanded from the process environment after `.env` loading.
 
+When the Worker constructs its runtimes at startup, each recognized Codex App Server Agent also reads `.env` from its own Codex home. The home is selected from `agents.<name>.env.CODEX_HOME`, then the Worker environment's `CODEX_HOME`, then `~/.codex`. Home-relative paths are expanded and relative paths resolve against the Profile directory, matching the child working directory. The resolved home is passed to the Codex process; a `CODEX_HOME` assignment inside that `.env` cannot redirect it.
+
+Codex environment values have the lowest priority: explicit Agent `env` values win over the Worker environment (including the Profile `.env`), which wins over Codex `.env`. Empty explicit values remain explicit. The existing main/explicit-Profile environment precedence is unchanged. The same resolved values are available to Agent Bot's Provider `/models` authentication and the Codex child. This does not mutate `process.env`, affect YAML expansion, or load Codex credentials into other Agents. Reserved Agent Bot and Feishu variables are still filtered before spawning the child. Missing files are ignored; unreadable files produce a warning containing only the path and error code. Values are loaded once per Worker startup; safely restart after changes.
+
 Relative `storage.sqlitePath` and `logging.path` values resolve against the directory containing the loaded configuration file. `defaults.cwd` resolves against the process startup directory.
 
 ## Initialization

package/docs/technical-reference.zh.md

@@ -54,6 +54,10 @@ CLI 通过 Node.js 国际化能力读取系统 Locale。以 `zh` 开头的 Local
 
 默认 `.env` 始终从 Agent Bot 用户目录加载。加载 `.env` 后，YAML 中的 `${NAME}` 会使用进程环境变量展开。
 
+Worker 启动并创建运行时时，还会为识别为 Codex 的 App Server Agent 读取各自 Codex 目录中的 `.env`。目录依次取 `agents.<name>.env.CODEX_HOME`、Worker 环境中的 `CODEX_HOME`、`~/.codex`。支持展开 `~`，相对路径按 Profile 目录解析，与子进程工作目录一致。解析后的目录会传给 Codex 进程，文件内的 `CODEX_HOME` 赋值不能改变该目录。
+
+Codex `.env` 优先级最低：Agent 显式 `env` 优先于 Worker 环境（含 Profile `.env`），Worker 环境优先于 Codex `.env`；显式空值也不会被覆盖。主 Profile 与显式 Profile 原有的环境变量优先级不变。Agent Bot 查询 Provider `/models` 的鉴权和 Codex 子进程共用这些值，但不会修改 `process.env`、影响 YAML 变量展开或把 Codex 凭据加载到其他 Agent。启动子进程前仍会过滤 Agent Bot 和飞书保留变量。文件不存在时忽略，无法读取时只记录路径和错误码。每次 Worker 启动读取一次，修改后需安全重启。
+
 相对形式的 `storage.sqlitePath` 和 `logging.path` 按配置文件所在目录解析；`defaults.cwd` 按进程启动目录解析。
 
 ## 初始化

package/npm-shrinkwrap.json

@@ -1,12 +1,12 @@
 {
   "name": "@keyou007/agent-bot",
-  "version": "0.1.22",
+  "version": "0.1.24-alpha.0",
   "lockfileVersion": 3,
   "requires": true,
   "packages": {
     "": {
       "name": "@keyou007/agent-bot",
-      "version": "0.1.22",
+      "version": "0.1.24-alpha.0",
       "license": "GPL-3.0-only",
       "dependencies": {
         "@agentclientprotocol/sdk": "1.2.1",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@keyou007/agent-bot",
-  "version": "0.1.22",
+  "version": "0.1.24-alpha.0",
   "type": "module",
   "description": "Use Codex, TraeX, and compatible coding agents from Lark/Feishu.",
   "license": "GPL-3.0-only",

package/skills/agent-bot/SKILL.md

@@ -96,6 +96,15 @@ agentbot task forkgroup [title]
 
 Choose `new` or `newgroup` for fresh context. Choose `fork` or `forkgroup` when the new task must retain conversation history through the latest completed Turn. Forking must not interrupt an active source turn.
 
+For lightweight context transfer, including between different Agents:
+
+```powershell
+agentbot task clone [title] [--agent <name>]
+agentbot task clonegroup [title] [--agent <name>]
+```
+
+These commands export only user Prompts and final answers through the latest completed Turn to a local text file, then start a fresh task with instructions to read it, acknowledge, and wait. They do not copy tools, reasoning, images, or native session files, and never interrupt the source task. Without `--agent`, they use the conversation's default Agent, not necessarily the source Agent. Provider, model, and reasoning use the target Agent's saved defaults; project shape and permissions come from the source. `clone` switches the current conversation after import starts; `clonegroup` leaves it unchanged and creates a separate group. Both support `--json` and explicit `--task` targeting. Feishu equivalents are `/clone` and `/clonegroup` (`/cg`). ACP sources use only dialogue already saved by Agent Bot. The context file remains beside the Profile SQLite file under `context-transfers`; keep it available for the cloned task.
+
 Feishu `/sessions [keyword]` lists and searches tasks across projects and all Providers, not just the App Server's current Provider. Switching Provider does not hide existing tasks; listing still uses paged metadata and the latest Turn summary only.
 
 Fork creation stores source-task and branch-Turn references without synchronizing the full local Turn list. The Feishu Turn card reuses local records and loads only the summary pages needed for the requested page, not the entire history. `task turns` loads the first page if necessary and returns available local records. This does not change the Agent's inherited context. Retry listing Turns after a temporary history-read failure; unsupported summary pagination never falls back to downloading full history.
@@ -158,6 +167,8 @@ agentbot server stop
 
 `update` is only for npm-installed Agent Bot packages. It verifies the new package, sends a safe-restart card, waits for active tasks, and restarts immediately when the service is already idle. It automatically restores the prior version if activation fails. It refuses source checkouts and `npm link` installations.
 
+The Feishu service also checks stable npm `latest` once daily at a persisted random time between 10:00 and 17:00 (server local time). A new version sends the owner a private release-notes card with 60 seconds to cancel. If not cancelled, preparation runs in the background and activation waits for tasks, final deliveries, and the quiet inbound window before restarting. Each version is notified once per Profile; cancellation survives restarts. An interrupted countdown resumes with a fresh minute on the same card. No private recipient, unconfirmed notification delivery, or missing release notes means no automatic installation. Source/npm-link protections still apply. Set `updates.enabled: false` in the Profile config and safely restart to disable checks. Do not bypass the countdown or idle gate.
+
 Autostart is Profile-specific. Use `server autostart enable` for login startup, `server autostart enable --linger` on Linux only when the user explicitly requests startup before login, and `server autostart disable` to remove registration without stopping the current Server. Disabling Agent Bot autostart must not disable Linux user lingering because other services may use it.
 
 Use safe restart by default. Prefer `agentbot task restart` when hosted so the current task is resolved automatically. Use `--immediate` or `task restart --force` only when the user explicitly accepts interruption.

package/src/cli/controlProtocol.ts

@@ -43,6 +43,7 @@ export type ControlRequest =
       projectless?: boolean;
     }
   | { action: "task_fork"; localSessionId: string }
+  | { action: "task_clone" | "task_clone_group"; localSessionId: string; title?: string; agentName?: string }
   | {
       action: "task_switch";
       localSessionId: string;
@@ -102,6 +103,14 @@ export interface TaskGroupControlData {
   task: SessionRecord;
 }
 
+export interface TaskCloneControlData {
+  sourceLocalSessionId: string;
+  contextFile: string;
+  turnCount: number;
+  task: SessionRecord;
+  group?: TaskGroupControlData["group"];
+}
+
 export interface TaskDismissControlData {
   localSessionId: string;
   remoteSessionId: string;

package/src/cli/help.ts

@@ -30,6 +30,8 @@ export function renderCliHelp(version: string, language: CliLanguage = cliLangua
   task newgroup [任务] [标题]       创建新群；支持 --agent、--dir、--nodir
   task fork [任务]                  从任务最近完成的 Turn 创建分支
   task forkgroup [任务] [标题]      从任务 Fork 新群
+  task clone [任务] [标题]          用对话文件创建新任务；支持 --agent
+  task clonegroup [任务] [标题]     用对话文件创建新群；支持 --agent
   task switch [任务] [目标任务]     切换会话任务；--previous 切回上一任务
   task queue [任务] <提示词>        将提示词排队；nosteer 是别名
   task agent [任务] [名称]          查看或设置该会话的新任务默认 Agent
@@ -123,6 +125,8 @@ Task commands:
   task newgroup [task] [title]      Create a group; supports --agent, --dir, --nodir
   task fork [task]                  Fork the task's latest completed Turn
   task forkgroup [task] [title]     Fork a task into a new group
+  task clone [task] [title]         Create a task from a conversation file; supports --agent
+  task clonegroup [task] [title]    Create a group from a conversation file; supports --agent
   task switch [task] [target]       Switch the conversation task; --previous selects the prior task
   task queue [task] <prompt>        Queue a Prompt; nosteer is an alias
   task agent [task] [name]          Show or set the conversation's default Agent for new tasks

package/src/cli/taskGroupOptions.ts

@@ -113,8 +113,38 @@ export function parseTaskForkGroupOptions(
   };
 }
 
+export function parseTaskCloneOptions(
+  input: string[],
+  action: "clone" | "clonegroup",
+  language: CliLanguage = cliLanguage,
+): TaskForkGroupOptions & { agentName?: string } {
+  const positionals: string[] = [];
+  let agentName: string | undefined;
+  let json = false;
+  for (let index = 0; index < input.length; index += 1) {
+    const argument = input[index]!;
+    if (argument === "--json") {
+      json = true;
+    } else if (argument === "--agent") {
+      if (agentName !== undefined) throw optionError(action, "--agent", language);
+      const name = input[++index];
+      if (!name?.trim() || name.startsWith("--")) throw new Error(cliText(
+        `task ${action} requires an Agent name after --agent.`,
+        `task ${action} 需要在 --agent 后指定 Agent 名称。`, language,
+      ));
+      agentName = name.trim();
+    } else {
+      if (argument.startsWith("--")) throw unsupportedOption(action, argument, language);
+      positionals.push(argument);
+    }
+  }
+  const [reference, ...title] = positionals;
+  requireTaskReference(action, reference, language);
+  return { reference, title: title.join(" ").trim() || undefined, agentName, json };
+}
+
 function requireTaskReference(
-  action: "new" | "newgroup" | "forkgroup",
+  action: "new" | "newgroup" | "forkgroup" | "clone" | "clonegroup",
   reference: string | undefined,
   language: CliLanguage,
 ): asserts reference is string {
@@ -127,7 +157,7 @@ function requireTaskReference(
 }
 
 function optionError(
-  action: "new" | "newgroup",
+  action: "new" | "newgroup" | "clone" | "clonegroup",
   option: "--agent" | "--dir" | "--nodir",
   language: CliLanguage,
 ): Error {
@@ -147,7 +177,7 @@ function conflictingProjectOptions(action: "new" | "newgroup", language: CliLang
 }
 
 function unsupportedOption(
-  action: "new" | "newgroup" | "forkgroup",
+  action: "new" | "newgroup" | "forkgroup" | "clone" | "clonegroup",
   option: string,
   language: CliLanguage,
 ): Error {

package/src/cli.ts

@@ -8,6 +8,7 @@ import {
   controlEndpoint,
   type ControlResponse,
   type TaskAgentControlData,
+  type TaskCloneControlData,
   type TaskDirectoryControlData,
   type TaskDismissControlData,
   type TaskForkControlData,
@@ -108,6 +109,7 @@ import {
 import { isThreadContextKey } from "./feishu/contextKey.js";
 import { refreshedSystemEnvironment } from "./supervision/systemEnvironment.js";
 import {
+  parseTaskCloneOptions,
   parseTaskForkGroupOptions,
   parseTaskNewOptions,
   parseTaskNewGroupOptions,
@@ -1593,6 +1595,25 @@ async function taskCommand(input: string[]): Promise<void> {
       await serverCommand(["restart", "--task", target.session.localSessionId, ...translated]);
       return;
     }
+    if (action === "clone" || action === "clonegroup") {
+      const target = resolveTaskCommandTarget(allSessions, rest, action);
+      const options = parseTaskCloneOptions([target.session.localSessionId, ...target.args], action);
+      if (action === "clonegroup") requireCliGroupUser(config.feishu.userOpenId);
+      const response = await sendControlRequest(controlEndpoint(config.storage.sqlitePath), {
+        action: action === "clonegroup" ? "task_clone_group" : "task_clone",
+        localSessionId: target.session.localSessionId,
+        ...(options.title ? { title: options.title } : {}),
+        ...(options.agentName ? { agentName: options.agentName } : {}),
+      }, 120_000);
+      if (!response.ok) throw new Error(response.message ?? cliText("Failed to clone the task.", "克隆任务失败。"));
+      const result = response.data as TaskCloneControlData;
+      if (options.json) printJson(result);
+      else process.stdout.write(cliText(
+        `Cloned task: ${result.task.title ?? result.task.localSessionId}\nAgent: ${result.task.agentName}\nContext: ${result.contextFile} (${result.turnCount} turns)\n${result.group ? `Group: ${result.group.name}\n` : ""}`,
+        `克隆任务：${result.task.title ?? result.task.localSessionId}\nAgent：${result.task.agentName}\n上下文：${result.contextFile}（${result.turnCount} 轮）\n${result.group ? `群：${result.group.name}\n` : ""}`,
+      ));
+      return;
+    }
     if (action === "newgroup") {
       const target = resolveTaskCommandTarget(allSessions, rest, action);
       const options = parseTaskNewGroupOptions([target.session.localSessionId, ...target.args]);

package/src/codex/CodexProcessManager.ts

@@ -2,6 +2,7 @@ import type { ChildProcessWithoutNullStreams } from "node:child_process";
 import os from "node:os";
 import path from "node:path";
 import readline from "node:readline";
+import { config as loadDotEnv } from "dotenv";
 import type { Logger } from "pino";
 import { AppServerConnection } from "./AppServerConnection.js";
 import type { AppServerClient, AppServerClientProvider } from "./CodexRuntime.js";
@@ -12,6 +13,7 @@ import {
 import type { AgentProcessInfo } from "../runtime/types.js";
 import { spawnStdioCommand } from "../utils/spawnCommand.js";
 import { assertSupportedCodexVersion } from "./CodexVersion.js";
+import { resolveUserPath } from "../config/paths.js";
 
 export class CodexProcessManager implements AppServerClientProvider {
   private static readonly RELEASE_TIMEOUT_MS = 5_000;
@@ -20,6 +22,7 @@ export class CodexProcessManager implements AppServerClientProvider {
   private version?: string;
   private agentFamily?: "codex" | "traex";
   private initializing?: Promise<AppServerClient>;
+  private readonly codexEnvironment: Record<string, string> = {};
   private readonly disconnectListeners = new Set<(error: Error) => void>();
 
   constructor(
@@ -28,7 +31,17 @@ export class CodexProcessManager implements AppServerClientProvider {
     private readonly env: Record<string, string>,
     private readonly logger: Logger,
     private readonly environmentContext: () => AgentEnvironmentContext = () => ({}),
-  ) {}
+  ) {
+    if (this.getAgentFamily() !== "codex") return;
+    const envPath = path.join(this.getCodexHome(), ".env");
+    const result = loadDotEnv({ path: envPath, processEnv: this.codexEnvironment, quiet: true });
+    if (result.error && (result.error as NodeJS.ErrnoException).code !== "ENOENT") {
+      this.logger.warn(
+        { path: envPath, code: (result.error as NodeJS.ErrnoException).code },
+        "Could not load the Codex environment file; using configured and inherited values.",
+      );
+    }
+  }
 
   async getClient(): Promise<AppServerClient> {
     if (this.initializing) return this.initializing;
@@ -45,10 +58,12 @@ export class CodexProcessManager implements AppServerClientProvider {
   private async startClient(): Promise<AppServerClient> {
     this.version = undefined;
     const environmentContext = this.environmentContext();
+    const agentEnvironment = { ...this.env };
+    if (this.getAgentFamily() === "codex") agentEnvironment.CODEX_HOME = this.getCodexHome();
     const child = spawnStdioCommand(
       this.command,
       this.args,
-      agentBotEnvironment(process.env, this.env, environmentContext),
+      agentBotEnvironment({ ...this.codexEnvironment, ...process.env }, agentEnvironment, environmentContext),
       environmentContext.profilePath ?? os.homedir(),
     );
     this.child = child;
@@ -108,11 +123,13 @@ export class CodexProcessManager implements AppServerClientProvider {
   }
 
   getCodexHome(): string {
-    return this.env.CODEX_HOME ?? process.env.CODEX_HOME ?? path.join(os.homedir(), ".codex");
+    const home = this.env.CODEX_HOME?.trim() || process.env.CODEX_HOME?.trim() || path.join(os.homedir(), ".codex");
+    return resolveUserPath(home, this.environmentContext().profilePath ?? os.homedir());
   }
 
   getEnvironmentVariable(name: string): string | undefined {
-    return this.env[name] ?? process.env[name];
+    if (name === "CODEX_HOME" && this.getAgentFamily() === "codex") return this.getCodexHome();
+    return this.env[name] ?? process.env[name] ?? this.codexEnvironment[name];
   }
 
   close(): void {