feishu-codex-console 1.0.0-beta.6

package/dist/device-card.js

@@ -0,0 +1,460 @@
+import { renderAccountQuotaSummary } from "./account-quota-card.js";
+export function renderDeviceCard(snapshot) {
+    const presentation = statePresentation(snapshot.availability.state);
+    const elements = [
+        availabilityPanel(snapshot),
+        remoteReadyPanel(snapshot),
+        healthMetrics(snapshot),
+        ...(snapshot.accountQuota
+            ? [
+                renderAccountQuotaSummary(snapshot.accountQuota, "dq", snapshot.availability.canInteract
+                    ? {
+                        bridge: "feishu-codex-v4",
+                        action: "device_quota",
+                    }
+                    : undefined),
+            ]
+            : []),
+        currentProjectPanel(snapshot),
+    ];
+    if (snapshot.feedback) {
+        elements.push({
+            tag: "column_set",
+            element_id: "feedback_panel",
+            flex_mode: "none",
+            columns: [
+                {
+                    tag: "column",
+                    width: "weighted",
+                    weight: 1,
+                    background_style: "blue-50",
+                    padding: "10px 12px 10px 12px",
+                    elements: [
+                        {
+                            tag: "markdown",
+                            element_id: "device_feedback",
+                            text_size: "notation",
+                            content: `<font color='blue'>${safe(snapshot.feedback)}</font>`,
+                        },
+                    ],
+                },
+            ],
+        });
+    }
+    elements.push(safetyNote(snapshot));
+    if (!snapshot.availability.canInteract) {
+        elements.push(connectionNotice(snapshot));
+    }
+    else if (snapshot.availability.canExecute) {
+        elements.push(primaryActions(), workspaceActions());
+    }
+    else {
+        elements.push(recoveryActions(snapshot));
+    }
+    if (snapshot.availability.canInteract) {
+        const remote = remoteActions(snapshot);
+        if (remote)
+            elements.push(remote);
+    }
+    return {
+        schema: "2.0",
+        config: {
+            update_multi: true,
+            width_mode: "default",
+            enable_forward: false,
+            summary: {
+                content: `本地 Codex 控制台 · ${truncatePlain(snapshot.deviceName, 40)} · ${presentation.label}`,
+            },
+            style: {
+                text_size: {
+                    device_title: { default: "heading-4", pc: "heading-4", mobile: "normal" },
+                    device_caption: { default: "notation", pc: "notation", mobile: "notation" },
+                },
+            },
+        },
+        header: {
+            title: { tag: "plain_text", content: "本地 Codex 控制台" },
+            subtitle: {
+                tag: "plain_text",
+                content: `${truncatePlain(snapshot.deviceName, 32)} · ${truncatePlain(snapshot.project.name, 36)}`,
+            },
+            template: presentation.template,
+            icon: { tag: "standard_icon", token: "myai_colorful" },
+            text_tag_list: [
+                {
+                    tag: "text_tag",
+                    text: { tag: "plain_text", content: presentation.tag },
+                    color: presentation.color,
+                },
+                {
+                    tag: "text_tag",
+                    text: {
+                        tag: "plain_text",
+                        content: !snapshot.remoteReady.supported
+                            ? "唤醒不支持"
+                            : snapshot.remoteReady.active
+                                ? "持续唤醒"
+                                : "按需唤醒",
+                    },
+                    color: snapshot.remoteReady.active ? "blue" : "neutral",
+                },
+            ],
+        },
+        body: {
+            direction: "vertical",
+            padding: "12px 12px 20px 12px",
+            vertical_spacing: "12px",
+            elements,
+        },
+    };
+}
+function availabilityPanel(snapshot) {
+    const presentation = statePresentation(snapshot.availability.state);
+    const lastSuccess = snapshot.availability.lastSuccessfulTaskAt
+        ? formatTime(snapshot.availability.lastSuccessfulTaskAt)
+        : "暂无成功任务";
+    return {
+        tag: "column_set",
+        element_id: "device_state_panel",
+        flex_mode: "none",
+        columns: [
+            {
+                tag: "column",
+                width: "weighted",
+                weight: 1,
+                background_style: presentation.background,
+                padding: "12px 12px 12px 12px",
+                vertical_spacing: "4px",
+                elements: [
+                    {
+                        tag: "markdown",
+                        element_id: "device_state_title",
+                        text_size: "device_title",
+                        content: `**<font color='${presentation.textColor}'>${safe(snapshot.availability.title)}</font>**`,
+                    },
+                    {
+                        tag: "markdown",
+                        element_id: "device_state_detail",
+                        text_size: "device_caption",
+                        content: safe(snapshot.availability.detail),
+                    },
+                    {
+                        tag: "markdown",
+                        element_id: "device_state_next",
+                        text_size: "device_caption",
+                        content: `<font color='grey'>${safe(snapshot.availability.nextAction)}\n状态采样 ${safe(formatTime(snapshot.availability.sampledAt))} · 本人最后成功 ${safe(lastSuccess)}</font>`,
+                    },
+                ],
+            },
+        ],
+    };
+}
+function remoteReadyPanel(snapshot) {
+    const status = !snapshot.remoteReady.supported
+        ? "当前系统不支持远程就绪"
+        : snapshot.remoteReady.active
+            ? "远程就绪已开启"
+            : snapshot.remoteReady.enabled
+                ? "远程就绪启动失败"
+                : "远程就绪未开启";
+    const color = snapshot.remoteReady.active
+        ? "green"
+        : snapshot.remoteReady.enabled
+            ? "red"
+            : "grey";
+    const background = snapshot.remoteReady.active
+        ? "blue-50"
+        : snapshot.remoteReady.enabled
+            ? "red-50"
+            : "grey-50";
+    const detail = !snapshot.remoteReady.supported
+        ? "Remote Ready 目前仅支持 macOS；仍需自行保证电源、网络和系统唤醒"
+        : snapshot.remoteReady.lastError
+            ? safe(truncate(snapshot.remoteReady.lastError, 240))
+            : snapshot.remoteReady.active
+                ? "桥接服务运行期间，macOS 不会因空闲自动睡眠"
+                : "开启后可降低人在外面时本机因空闲而离线的概率";
+    return {
+        tag: "column_set",
+        element_id: "remote_ready_panel",
+        flex_mode: "none",
+        columns: [
+            {
+                tag: "column",
+                width: "weighted",
+                weight: 1,
+                background_style: background,
+                padding: "12px 12px 12px 12px",
+                vertical_spacing: "4px",
+                elements: [
+                    {
+                        tag: "markdown",
+                        element_id: "remote_ready_status",
+                        text_size: "device_title",
+                        content: `**<font color='${color}'>${status}</font>**`,
+                    },
+                    {
+                        tag: "markdown",
+                        element_id: "remote_ready_detail",
+                        text_size: "device_caption",
+                        content: `<font color='grey'>${safe(snapshot.powerLabel)} · ${detail}</font>`,
+                    },
+                ],
+            },
+        ],
+    };
+}
+function healthMetrics(snapshot) {
+    const codexLabel = snapshot.codex.state === "online"
+        ? "在线"
+        : snapshot.codex.state === "error"
+            ? "异常"
+            : "待命";
+    const taskLabel = snapshot.activeTask
+        ? `运行 1 · 等待 ${snapshot.queuedForConversation}`
+        : snapshot.queuedForConversation > 0
+            ? `等待 ${snapshot.queuedForConversation}`
+            : "空闲";
+    const listenerLabel = statePresentation(snapshot.availability.state).metric;
+    return {
+        tag: "column_set",
+        element_id: "health_metrics",
+        flex_mode: "none",
+        horizontal_spacing: "8px",
+        columns: [
+            metricColumn("codex_metric", codexLabel, "Codex 引擎"),
+            metricColumn("task_metric", taskLabel, "当前聊天"),
+            metricColumn("listen_metric", listenerLabel, "飞书连接"),
+        ],
+    };
+}
+function metricColumn(elementId, value, label) {
+    return {
+        tag: "column",
+        width: "weighted",
+        weight: 1,
+        background_style: "grey-50",
+        padding: "10px 4px 10px 4px",
+        vertical_spacing: "2px",
+        elements: [
+            {
+                tag: "markdown",
+                element_id: `${elementId}_value`,
+                text_align: "center",
+                content: `**${safe(truncatePlain(value, 24))}**`,
+            },
+            {
+                tag: "markdown",
+                element_id: `${elementId}_label`,
+                text_align: "center",
+                text_size: "device_caption",
+                content: `<font color='grey'>${label}</font>`,
+            },
+        ],
+    };
+}
+function currentProjectPanel(snapshot) {
+    const taskLine = snapshot.activeTask
+        ? `任务 ${safe(snapshot.activeTask)} 正在执行`
+        : `全局 ${snapshot.activeTasks} 个运行中 · ${snapshot.queuedTasks} 个排队中`;
+    return {
+        tag: "column_set",
+        element_id: "device_project_panel",
+        flex_mode: "none",
+        columns: [
+            {
+                tag: "column",
+                width: "weighted",
+                weight: 1,
+                background_style: "grey-50",
+                padding: "12px 12px 12px 12px",
+                vertical_spacing: "4px",
+                elements: [
+                    {
+                        tag: "markdown",
+                        element_id: "device_project_label",
+                        text_size: "device_caption",
+                        content: "<font color='grey'>当前项目</font>",
+                    },
+                    {
+                        tag: "markdown",
+                        element_id: "device_project_name",
+                        content: `**${safe(snapshot.project.name)}**  ${snapshot.project.isGitRepository ? "<text_tag color='blue'>Git</text_tag>" : "<text_tag color='neutral'>文件夹</text_tag>"}`,
+                    },
+                    {
+                        tag: "markdown",
+                        element_id: "device_project_path",
+                        text_size: "device_caption",
+                        content: `<font color='grey'>${safe(snapshot.project.displayPath)}\n${taskLine} · 已保存 ${snapshot.threadCount} 个会话\n${safe(snapshot.osLabel)} · 已运行 ${safe(snapshot.uptimeLabel)}</font>`,
+                    },
+                ],
+            },
+        ],
+    };
+}
+function safetyNote(snapshot) {
+    const network = snapshot.networkEnabled ? "网络已开启" : "网络已关闭";
+    return {
+        tag: "markdown",
+        element_id: "device_safety_note",
+        text_size: "device_caption",
+        content: `<font color='grey'>${safe(snapshot.sandboxLabel)} · ${network} · 提交、推送、部署和 PR 仍需单独确认。合盖后 macOS 仍可能休眠。</font>`,
+    };
+}
+function primaryActions() {
+    return {
+        tag: "column_set",
+        element_id: "primary_actions",
+        flex_mode: "none",
+        horizontal_spacing: "8px",
+        columns: [
+            actionColumn("device_refresh", "刷新状态", "primary_filled", "device_refresh"),
+            actionColumn("device_projects", "切换项目", "default", "device_projects"),
+            actionColumn("device_new_session", "新会话", "default", "device_new_session", {
+                title: "开启新会话？",
+                text: "会清除当前聊天保存的 Codex 上下文，并停止未完成任务。",
+            }),
+        ],
+    };
+}
+function workspaceActions() {
+    return {
+        tag: "column_set",
+        element_id: "workspace_actions",
+        flex_mode: "none",
+        horizontal_spacing: "8px",
+        columns: [
+            actionColumn("device_settings", "模型设置", "default", "device_settings"),
+            actionColumn("device_sessions", "历史会话", "default", "device_sessions"),
+            actionColumn("device_tasks", "任务中心", "default", "device_tasks"),
+        ],
+    };
+}
+function recoveryActions(snapshot) {
+    const columns = [
+        actionColumn("device_refresh", "重新检查", "primary_filled", "device_refresh"),
+    ];
+    if (snapshot.availability.state === "error") {
+        columns.push(actionColumn("device_reconnect", "重连 Codex", "default", "device_reconnect"));
+    }
+    else {
+        columns.push(actionColumn("device_tasks", "查看任务", "default", "device_tasks"));
+    }
+    return {
+        tag: "column_set",
+        element_id: "recovery_actions",
+        flex_mode: "none",
+        horizontal_spacing: "8px",
+        columns,
+    };
+}
+function connectionNotice(snapshot) {
+    return {
+        tag: "markdown",
+        element_id: "connection_notice",
+        text_size: "device_caption",
+        content: `<font color='grey'>控制按钮已暂时隐藏，避免把无法送达的操作显示成可执行。${safe(snapshot.availability.nextAction)}</font>`,
+    };
+}
+function remoteActions(snapshot) {
+    const remoteAction = snapshot.remoteReady.active
+        ? "remote_ready_disable"
+        : "remote_ready_enable";
+    const remoteLabel = snapshot.remoteReady.active ? "关闭远程就绪" : "开启远程就绪";
+    const columns = [];
+    if (snapshot.remoteReady.supported) {
+        columns.push(actionColumn("remote_ready_toggle", remoteLabel, snapshot.remoteReady.active ? "default" : "primary_filled", remoteAction, snapshot.remoteReady.active
+            ? undefined
+            : {
+                title: "开启远程就绪？",
+                text: "桥接服务运行期间会阻止 macOS 因空闲自动睡眠，电池耗电可能增加。",
+            }));
+    }
+    if (snapshot.activeTask) {
+        columns.push(actionColumn("device_stop", "停止当前任务", "default", "device_stop", {
+            title: "停止当前任务？",
+            text: "已经完成的文件修改不会自动撤销。",
+        }));
+    }
+    return columns.length === 0 ? null : {
+        tag: "column_set",
+        element_id: "remote_actions",
+        flex_mode: "none",
+        horizontal_spacing: "8px",
+        columns,
+    };
+}
+function actionColumn(elementId, label, type, action, confirm) {
+    const button = {
+        tag: "button",
+        element_id: elementId,
+        text: { tag: "plain_text", content: label },
+        type,
+        width: "fill",
+        behaviors: [
+            {
+                type: "callback",
+                value: { bridge: "feishu-codex-v4", action },
+            },
+        ],
+    };
+    if (confirm) {
+        button.confirm = {
+            title: { tag: "plain_text", content: confirm.title },
+            text: { tag: "plain_text", content: confirm.text },
+        };
+    }
+    return {
+        tag: "column",
+        width: "weighted",
+        weight: 1,
+        elements: [button],
+    };
+}
+function statePresentation(state) {
+    switch (state) {
+        case "online":
+            return { label: "在线", tag: "可以执行", metric: "已连接", template: "blue", color: "green", textColor: "green", background: "blue-50" };
+        case "degraded":
+            return { label: "部分可用", tag: "部分可用", metric: "部分连接", template: "orange", color: "orange", textColor: "orange", background: "orange-50" };
+        case "error":
+            return { label: "异常", tag: "需要修复", metric: "连接正常", template: "red", color: "red", textColor: "red", background: "red-50" };
+        case "maintenance":
+            return { label: "维护中", tag: "暂停任务", metric: "维护中", template: "grey", color: "neutral", textColor: "grey", background: "grey-50" };
+        case "offline":
+            return { label: "离线", tag: "设备离线", metric: "已离线", template: "grey", color: "neutral", textColor: "grey", background: "grey-50" };
+        case "connecting":
+            return { label: "连接中", tag: "正在连接", metric: "连接中", template: "orange", color: "orange", textColor: "orange", background: "orange-50" };
+    }
+}
+function formatTime(value) {
+    const date = new Date(value);
+    if (!Number.isFinite(date.getTime()))
+        return "时间未知";
+    return date.toLocaleString("zh-CN", {
+        month: "2-digit",
+        day: "2-digit",
+        hour: "2-digit",
+        minute: "2-digit",
+        hour12: false,
+    });
+}
+function safe(value) {
+    return value
+        .replaceAll("&", "＆")
+        .replaceAll("<", "＜")
+        .replaceAll(">", "＞")
+        .replaceAll("*", "＊")
+        .replaceAll("_", "＿")
+        .replaceAll("`", "｀")
+        .replaceAll("[", "［")
+        .replaceAll("]", "］");
+}
+function truncate(value, maxLength) {
+    if (value.length <= maxLength)
+        return value;
+    return `${value.slice(0, Math.max(0, maxLength - 1))}…`;
+}
+function truncatePlain(value, maxLength) {
+    return truncate(value.replaceAll("<", "＜").replaceAll(">", "＞"), maxLength);
+}

package/dist/device-health.js

@@ -0,0 +1,94 @@
+export function deriveDeviceAvailability({ consumers, codex, api, sampledAt = new Date().toISOString(), serviceHeartbeatAt, heartbeatTimeoutMs = 45_000, lastSuccessfulTaskAt, maintenance = false, }) {
+    const common = {
+        sampledAt,
+        ...(lastSuccessfulTaskAt ? { lastSuccessfulTaskAt } : {}),
+    };
+    if (maintenance) {
+        return {
+            state: "maintenance",
+            title: "设备正在维护",
+            detail: "服务在线，但暂不接受新的 Codex 任务。",
+            nextAction: "维护结束后刷新状态。",
+            canExecute: false,
+            canInteract: true,
+            ...common,
+        };
+    }
+    if (serviceHeartbeatAt) {
+        const sampled = Date.parse(sampledAt);
+        const heartbeat = Date.parse(serviceHeartbeatAt);
+        if (!Number.isFinite(heartbeat) || sampled - heartbeat > heartbeatTimeoutMs) {
+            return {
+                state: "offline",
+                title: "本地设备已离线",
+                detail: "服务健康心跳已经过期，当前卡片不能证明设备仍可执行任务。",
+                nextAction: "检查电脑电源、网络和后台服务；恢复后重新发送“状态”。",
+                canExecute: false,
+                canInteract: false,
+                ...common,
+            };
+        }
+    }
+    const messages = consumers.find((consumer) => consumer.eventKey === "im.message.receive_v1");
+    const cards = consumers.find((consumer) => consumer.eventKey === "card.action.trigger");
+    if (!messages?.ready) {
+        return {
+            state: "connecting",
+            title: "飞书连接正在恢复",
+            detail: "消息事件尚未就绪，此时发送的新任务可能无法被本机接收。",
+            nextAction: "等待连接恢复后重新发送“状态”。",
+            canExecute: false,
+            canInteract: false,
+            ...common,
+        };
+    }
+    if (!cards?.ready) {
+        return {
+            state: "degraded",
+            title: "设备部分可用",
+            detail: "文字消息可用，但卡片按钮连接正在恢复。",
+            nextAction: "可以直接发送文字任务；需要按钮操作时稍后刷新状态。",
+            canExecute: true,
+            canInteract: false,
+            ...common,
+        };
+    }
+    if (api?.state === "degraded") {
+        return {
+            state: "degraded",
+            title: "飞书发送链路正在恢复",
+            detail: `消息接收正常，但最近 ${api.consecutiveFailures} 次飞书 API 请求失败；可靠文本回复会继续重试。`,
+            nextAction: "任务仍可发送；若长时间没有回复，请检查网络后刷新状态。",
+            canExecute: true,
+            canInteract: true,
+            ...common,
+        };
+    }
+    if (codex.lastError && !codex.ready) {
+        return {
+            state: "error",
+            title: "Codex 引擎异常",
+            detail: truncate(codex.lastError, 240),
+            nextAction: "点击“重连 Codex”验证登录和本地引擎。",
+            canExecute: false,
+            canInteract: true,
+            ...common,
+        };
+    }
+    return {
+        state: "online",
+        title: "可以开始任务",
+        detail: codex.ready
+            ? "飞书消息、卡片和 Codex 引擎均已连接。"
+            : "飞书连接正常；Codex 引擎将在首个任务时按需启动。",
+        nextAction: "直接发送完整任务，或先切换项目与模型。",
+        canExecute: true,
+        canInteract: true,
+        ...common,
+    };
+}
+function truncate(value, maxLength) {
+    if (value.length <= maxLength)
+        return value;
+    return `${value.slice(0, Math.max(0, maxLength - 1))}…`;
+}