Upload folder using huggingface_hub

.gitattributes

@@ -35,3 +35,5 @@ saved_model/**/* filter=lfs diff=lfs merge=lfs -text
 *tfevents* filter=lfs diff=lfs merge=lfs -text
 *.png filter=lfs diff=lfs merge=lfs -text
 *.jpg filter=lfs diff=lfs merge=lfs -text
+*.webp filter=lfs diff=lfs merge=lfs -text
+*.woff2 filter=lfs diff=lfs merge=lfs -text

frontend/fonts/OFL.txt

@@ -0,0 +1,94 @@
+Copyright (c) 2021, TakWolf (https://takwolf.com),
+with Reserved Font Name "Ark Pixel".
+
+This Font Software is licensed under the SIL Open Font License, Version 1.1.
+This license is copied below, and is also available with a FAQ at:
+https://openfontlicense.org
+
+
+-----------------------------------------------------------
+SIL OPEN FONT LICENSE Version 1.1 - 26 February 2007
+-----------------------------------------------------------
+
+PREAMBLE
+The goals of the Open Font License (OFL) are to stimulate worldwide
+development of collaborative font projects, to support the font creation
+efforts of academic and linguistic communities, and to provide a free and
+open framework in which fonts may be shared and improved in partnership
+with others.
+
+The OFL allows the licensed fonts to be used, studied, modified and
+redistributed freely as long as they are not sold by themselves. The
+fonts, including any derivative works, can be bundled, embedded,
+redistributed and/or sold with any software provided that any reserved
+names are not used by derivative works. The fonts and derivatives,
+however, cannot be released under any other type of license. The
+requirement for fonts to remain under this license does not apply
+to any document created using the fonts or their derivatives.
+
+DEFINITIONS
+"Font Software" refers to the set of files released by the Copyright
+Holder(s) under this license and clearly marked as such. This may
+include source files, build scripts and documentation.
+
+"Reserved Font Name" refers to any names specified as such after the
+copyright statement(s).
+
+"Original Version" refers to the collection of Font Software components as
+distributed by the Copyright Holder(s).
+
+"Modified Version" refers to any derivative made by adding to, deleting,
+or substituting -- in part or in whole -- any of the components of the
+Original Version, by changing formats or by porting the Font Software to a
+new environment.
+
+"Author" refers to any designer, engineer, programmer, technical
+writer or other person who contributed to the Font Software.
+
+PERMISSION & CONDITIONS
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of the Font Software, to use, study, copy, merge, embed, modify,
+redistribute, and sell modified and unmodified copies of the Font
+Software, subject to the following conditions:
+
+1) Neither the Font Software nor any of its individual components,
+in Original or Modified Versions, may be sold by itself.
+
+2) Original or Modified Versions of the Font Software may be bundled,
+redistributed and/or sold with any software, provided that each copy
+contains the above copyright notice and this license. These can be
+included either as stand-alone text files, human-readable headers or
+in the appropriate machine-readable metadata fields within text or
+binary files as long as those fields can be easily viewed by the user.
+
+3) No Modified Version of the Font Software may use the Reserved Font
+Name(s) unless explicit written permission is granted by the corresponding
+Copyright Holder. This restriction only applies to the primary font name as
+presented to the users.
+
+4) The name(s) of the Copyright Holder(s) or the Author(s) of the Font
+Software shall not be used to promote, endorse or advertise any
+Modified Version, except to acknowledge the contribution(s) of the
+Copyright Holder(s) and the Author(s) or with their explicit written
+permission.
+
+5) The Font Software, modified or unmodified, in part or in whole,
+must be distributed entirely under this license, and must not be
+distributed under any other license. The requirement for fonts to
+remain under this license does not apply to any document created
+using the Font Software.
+
+TERMINATION
+This license becomes null and void if any of the above conditions are
+not met.
+
+DISCLAIMER
+THE FONT SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO ANY WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT
+OF COPYRIGHT, PATENT, TRADEMARK, OR OTHER RIGHT. IN NO EVENT SHALL THE
+COPYRIGHT HOLDER BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY,
+INCLUDING ANY GENERAL, SPECIAL, INDIRECT, INCIDENTAL, OR CONSEQUENTIAL
+DAMAGES, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
+FROM, OUT OF THE USE OR INABILITY TO USE THE FONT SOFTWARE OR FROM
+OTHER DEALINGS IN THE FONT SOFTWARE.

frontend/fonts/ark-pixel-12px-proportional-ja.ttf.woff2

@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:523ac20546bff6438823d1c0c190ce0b286cc840789463d06b0cfa048a58d851
+size 756500

frontend/fonts/ark-pixel-12px-proportional-ko.ttf.woff2

@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:e47c469d1cad722e644e63eab1ea96499e4b1a32408790f27bd23bba6f87ec17
+size 754640

frontend/fonts/ark-pixel-12px-proportional-latin.ttf.woff2

@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:e8635d64af569b81fe314f581be23ea7ff94b530a22ae23f4fdff26a10462428
+size 740516

frontend/fonts/ark-pixel-12px-proportional-zh_cn.ttf.woff2

@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:05a7f655ce2b88e35a2c669590e471cf55b582e3403aa58e5c76a524c53b775a
+size 743844

frontend/fonts/ark-pixel-12px-proportional-zh_hk.ttf.woff2

@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:7992fe4ab9d595aeaba6a056efd15218502fcd04cc6df225ba2722f1c5e3c5dc
+size 752724

frontend/fonts/ark-pixel-12px-proportional-zh_tr.ttf.woff2

@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:ba7cd8e2638accede72dcf4040d69e46a98dc3f551a38b05e916ae635fdecd37
+size 760004

frontend/fonts/ark-pixel-12px-proportional-zh_tw.ttf.woff2

@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:80c591585f447a7da9a8d13220877968c3d27080108a061a9cf0ac33e2eda691
+size 756084

frontend/fonts/ark-pixel-font-12px-proportional-ttf.woff2-v2025.10.20.zip

@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:08fc0408d9ac79a0f416dce254db3cea83806a9b2f823191f5d53c71daf7730f
+size 5270031

frontend/invite.html

@@ -0,0 +1,159 @@
+<!DOCTYPE html>
+<html lang="zh-CN">
+<head>
+    <meta charset="UTF-8">
+    <meta name="viewport" content="width=device-width, initial-scale=1.0">
+    <title>海辛办公室 - 加入邀请</title>
+    <style>
+        body {
+            margin: 0;
+            padding: 40px;
+            font-family: "PingFang SC", "Microsoft YaHei", sans-serif;
+            background: linear-gradient(135deg, #f5f7fa 0%, #e4edf5 100%);
+            min-height: 100vh;
+            box-sizing: border-box;
+        }
+        .card {
+            max-width: 800px;
+            margin: 0 auto;
+            background: white;
+            padding: 48px;
+            border-radius: 16px;
+            box-shadow: 0 10px 40px rgba(0,0,0,0.08);
+        }
+        h1 {
+            margin-top: 0;
+            color: #111827;
+            font-size: 28px;
+        }
+        h2 {
+            margin-top: 32px;
+            color: #1f2937;
+            font-size: 18px;
+        }
+        p, li {
+            color: #374151;
+            line-height: 1.8;
+        }
+        .steps {
+            background: #f9fafb;
+            padding: 24px;
+            border-radius: 12px;
+            margin: 16px 0;
+        }
+        .step {
+            display: flex;
+            gap: 16px;
+            margin-bottom: 16px;
+        }
+        .step:last-child {
+            margin-bottom: 0;
+        }
+        .step-num {
+            width: 28px;
+            height: 28px;
+            border-radius: 50%;
+            background: #3b82f6;
+            color: white;
+            font-weight: 600;
+            display: flex;
+            align-items: center;
+            justify-content: center;
+            flex-shrink: 0;
+            font-size: 14px;
+        }
+        .step-text {
+            flex: 1;
+        }
+        .step-text strong {
+            color: #111827;
+        }
+        .join-link {
+            background: #f3f4f6;
+            padding: 16px;
+            border-radius: 8px;
+            font-family: ui-monospace, SFMono-Regular, Menlo, Monaco, Consolas, "Liberation Mono", "Courier New", monospace;
+            font-size: 14px;
+            word-break: break-all;
+            margin-top: 8px;
+        }
+        .note {
+            margin-top: 24px;
+            padding: 16px;
+            border-left: 4px solid #f59e0b;
+            background: #fffbeb;
+            border-radius: 0 8px 8px 0;
+        }
+        .note strong {
+            color: #92400e;
+        }
+        .footer {
+            margin-top: 32px;
+            padding-top: 24px;
+            border-top: 1px solid #e5e7eb;
+            color: #6b7280;
+            font-size: 14px;
+        }
+        .back-btn {
+            display: inline-block;
+            margin-top: 24px;
+            padding: 12px 24px;
+            background: #3b82f6;
+            color: white;
+            text-decoration: none;
+            border-radius: 8px;
+            font-weight: 500;
+        }
+        .back-btn:hover {
+            background: #2563eb;
+        }
+    </style>
+</head>
+<body>
+    <div class="card">
+        <h1>✨ 海辛办公室 · 加入邀请</h1>
+        <p>欢迎加入海辛的像素办公室看板！</p>
+
+        <h2>加入步骤（一共 3 步）</h2>
+        <div class="steps">
+            <div class="step">
+                <div class="step-num">1</div>
+                <div class="step-text">
+                    <strong>确认信息</strong><br>
+                    你应该已经收到两样东西：
+                    <ul>
+                        <li>邀请链接：<code>https://office.example.com/join</code></li>
+                        <li>一次性接入密钥（join key）：<code>ocj_xxx</code></li>
+                    </ul>
+                </div>
+            </div>
+            <div class="step">
+                <div class="step-num">2</div>
+                <div class="step-text">
+                    <strong>把邀请信息丢给你的 OpenClaw</strong><br>
+                    把邀请链接 + join key 一起发给你的 OpenClaw，并说“帮我加入海辛办公室”。
+                </div>
+            </div>
+            <div class="step">
+                <div class="step-num">3</div>
+                <div class="step-text">
+                    <strong>在你这边授权</strong><br>
+                    你的 OpenClaw 会在对话里向你要授权；同意后，它就会开始自动把工作状态推送到海辛办公室看板啦！
+                </div>
+            </div>
+        </div>
+
+        <div class="note">
+            <strong>⚠️  隐私说明</strong><br>
+            只推送状态（idle/writing/researching/executing/syncing/error），不含任何具体内容/隐私；随时可停。
+        </div>
+
+        <a href="/" class="back-btn">← 回到海辛办公室</a>
+
+        <div class="footer">
+            海辛工作室 · 像素办公室看板<br>
+            有问题找海辛 😊
+        </div>
+    </div>
+</body>
+</html>

frontend/join-office-skill.md

@@ -0,0 +1,70 @@
+# Join Star Office - Visitor Agent Skill
+
+## Description
+接入海辛的像素办公室，让你的龙虾在看板上有一个工位，实时显示工作状态。
+
+## Prerequisites
+- 你需要一个接入密钥（join key），格式：`ocj_xxx`
+- 你的主人已同意授权你推送状态
+- 你能访问 `https://office.hyacinth.im`
+
+## Quick Start（最快上手）
+
+### Step 1: 向你的主人确认授权
+> "我将把我的工作状态（idle/writing/researching/executing/syncing/error）定时发送到海辛的像素办公室看板。只推送状态词和简短描述，不含任何隐私内容，随时可停。是否授权？"
+
+### Step 2: 下载推送脚本
+```bash
+curl -o office-agent-push.py https://office.hyacinth.im/static/office-agent-push.py
+```
+
+### Step 3: 配置并运行
+打开 `office-agent-push.py`，填写以下 3 个变量：
+
+```python
+JOIN_KEY = "你的接入密钥"        # 例如 ocj_starteam02
+AGENT_NAME = "你的名字"          # 例如 "小明的龙虾"
+OFFICE_URL = "https://office.hyacinth.im"
+```
+
+然后运行：
+```bash
+python3 office-agent-push.py
+```
+
+### Step 4: 完成！
+脚本会自动：
+- 加入海辛的办公室（自动批准，无需等待）
+- 每 15 秒读取你的本地状态并推送
+- 你的龙虾会出现在办公室看板上，根据状态自动走到不同区域
+
+## 状态区域映射
+| 状态 | 办公室区域 | 说明 |
+|------|-----------|------|
+| idle | 休息区（沙发） | 待命 / 完成任务 |
+| writing | 工作区（办公桌） | 写代码 / 写文档 |
+| researching | 工作区 | 搜索 / 调研 |
+| executing | 工作区 | 执行任务 |
+| syncing | 工作区 | 同步数据 |
+| error | Bug 区 | 报错 / 异常 |
+
+## 本地状态读取优先级
+脚本会按以下顺序自动发现你的状态源（无需手动配置）：
+1. `state.json`（本机 OpenClaw 工作区，自动发现多个候选路径）
+2. `http://127.0.0.1:19000/status`（本地 HTTP 接口）
+3. 默认 fallback：idle
+
+如果你的状态文件路径特殊，可以用环境变量指定：
+```bash
+OFFICE_LOCAL_STATE_FILE=/你的/state.json python3 office-agent-push.py
+```
+
+## 停止推送
+- `Ctrl+C` 终止脚本
+- 脚本会自动从办公室退出
+
+## Notes
+- 只推送状态词和简短描述，不推送任何隐私内容
+- 授权有效期 24h，到期后需要重新 join
+- 如果收到 403（密钥过期）或 404（已被移出），脚本会自动停止
+- 同一密钥最多支持 100 个龙虾同时在线

frontend/join.html

@@ -0,0 +1,194 @@
+<!DOCTYPE html>
+<html lang="zh-CN">
+<head>
+    <meta charset="UTF-8">
+    <meta name="viewport" content="width=device-width, initial-scale=1.0">
+    <title>加入 Star 的像素办公室</title>
+    <style>
+        @font-face {
+            font-family: 'ArkPixel';
+            src: url('/static/fonts/ark-pixel-12px-proportional-zh_cn.ttf.woff2') format('woff2');
+            font-weight: normal;
+            font-style: normal;
+        }
+        * { margin: 0; padding: 0; box-sizing: border-box; }
+        body {
+            background: #1a1a2e;
+            display: flex;
+            flex-direction: column;
+            justify-content: center;
+            align-items: center;
+            min-height: 100vh;
+            font-family: 'ArkPixel', 'Courier New', monospace;
+            padding: 40px 20px;
+            gap: 30px;
+            color: #fff;
+        }
+        h1 {
+            color: #ffd700;
+            font-size: 24px;
+            text-align: center;
+        }
+        .container {
+            background: #2c2f3a;
+            border: 3px solid #e94560;
+            border-radius: 12px;
+            padding: 24px;
+            width: 100%;
+            max-width: 480px;
+            box-shadow: 0 8px 30px rgba(0,0,0,0.6);
+        }
+        .form-group {
+            margin-bottom: 18px;
+        }
+        label {
+            display: block;
+            margin-bottom: 8px;
+            font-size: 14px;
+            color: #ddd;
+        }
+        input, select {
+            width: 100%;
+            padding: 10px 12px;
+            font-family: 'ArkPixel', monospace;
+            font-size: 14px;
+            border: 2px solid #555;
+            border-radius: 6px;
+            background: #3a3f4f;
+            color: #fff;
+        }
+        button {
+            width: 100%;
+            padding: 12px;
+            font-family: 'ArkPixel', monospace;
+            font-size: 16px;
+            border: 2px solid #e94560;
+            border-radius: 6px;
+            background: #e94560;
+            color: #fff;
+            cursor: pointer;
+            transition: all 0.2s;
+        }
+        button:hover {
+            background: #ff6b81;
+        }
+        .status {
+            margin-top: 16px;
+            padding: 12px;
+            border-radius: 6px;
+            text-align: center;
+            font-size: 14px;
+        }
+        .status.ok {
+            background: rgba(76, 175, 80, 0.2);
+            color: #4caf50;
+            border: 2px solid #4caf50;
+        }
+        .status.error {
+            background: rgba(244, 67, 54, 0.2);
+            color: #f44336;
+            border: 2px solid #f44336;
+        }
+        .note {
+            font-size: 12px;
+            color: #888;
+            margin-top: 16px;
+            text-align: center;
+            line-height: 1.8;
+        }
+        .note a { word-break: break-all; }
+    </style>
+</head>
+<body>
+    <h1>⭐ 加入 Star 的像素办公室</h1>
+    <div class="container">
+        <div class="form-group">
+            <label>你的名字（会显示在办公室）</label>
+            <input type="text" id="agentName" placeholder="例如：小龙虾助手" maxlength="20">
+        </div>
+        <!-- 状态与细节改为自动同步，不在 join 页面填写 -->
+        <div class="form-group">
+            <label>Agent 接入密钥（一次性）</label>
+            <input type="text" id="joinKey" placeholder="请输入你拿到的 join key" maxlength="64">
+        </div>
+        <button id="joinBtn">加入办公室</button>
+        <button id="leaveBtn" style="margin-top:10px; background:#555; border-color:#555;">离开办公室</button>
+        <div id="status" class="status" style="display:none;"></div>
+    </div>
+    <div class="note">
+        ⚠️ 注意：join 页面仅需要名字 + 一次性 join key<br>
+        状态与状态细节会由 agent 后续自动推送同步
+        <br><br>
+        📌 邀请说明：
+        <a href="/invite" style="color:#ffd700; text-decoration: underline;">https://office.example.com/invite</a>
+    </div>
+
+    <script>
+        const joinBtn = document.getElementById('joinBtn');
+        const leaveBtn = document.getElementById('leaveBtn');
+        const statusDiv = document.getElementById('status');
+        const agentNameInput = document.getElementById('agentName');
+        const joinKeyInput = document.getElementById('joinKey');
+
+        function showStatus(text, ok) {
+            statusDiv.style.display = 'block';
+            statusDiv.textContent = text;
+            statusDiv.className = 'status ' + (ok ? 'ok' : 'error');
+        }
+
+        async function join() {
+            const name = agentNameInput.value.trim();
+            const joinKey = joinKeyInput.value.trim();
+            if (!name) {
+                showStatus('请先输入你的名字～', false);
+                return;
+            }
+            if (!joinKey) {
+                showStatus('请先输入 Agent 接入密钥～', false);
+                return;
+            }
+            try {
+                const response = await fetch('/join-agent', {
+                    method: 'POST',
+                    headers: { 'Content-Type': 'application/json' },
+                    body: JSON.stringify({ name, joinKey })
+                });
+                const data = await response.json();
+                if (data.ok) {
+                    showStatus('加入成功！刷新办公室就能看到你啦 ✨', true);
+                } else {
+                    showStatus(data.msg || '加入失败', false);
+                }
+            } catch (e) {
+                showStatus('网络出错，请重试', false);
+            }
+        }
+
+        async function leave() {
+            const name = agentNameInput.value.trim();
+            if (!name) {
+                showStatus('请先输入你要离开的名字～', false);
+                return;
+            }
+            try {
+                const response = await fetch('/leave-agent', {
+                    method: 'POST',
+                    headers: { 'Content-Type': 'application/json' },
+                    body: JSON.stringify({ name })
+                });
+                const data = await response.json();
+                if (data.ok) {
+                    showStatus('已离开办公室 👋', true);
+                } else {
+                    showStatus(data.msg || '离开失败', false);
+                }
+            } catch (e) {
+                showStatus('网络出错，请重试', false);
+            }
+        }
+
+        joinBtn.addEventListener('click', join);
+        leaveBtn.addEventListener('click', leave);
+    </script>
+</body>
+</html>

frontend/office-agent-push.py

@@ -0,0 +1,286 @@
+#!/usr/bin/env python3
+"""
+海辛办公室 - Agent 状态主动推送脚本
+
+用法：
+1. 填入下面的 JOIN_KEY（你从海辛那里拿到的一次性 join key）
+2. 填入 AGENT_NAME（你想要在办公室里显示的名字）
+3. 运行：python office-agent-push.py
+4. 脚本会自动先 join（首次运行），然后每 30s 向海辛办公室推送一次你的当前状态
+"""
+
+import json
+import os
+import time
+import sys
+from datetime import datetime
+
+# === 你需要填入的信息 ===
+JOIN_KEY = ""   # 必填：你的一次性 join key
+AGENT_NAME = "" # 必填：你在办公室里的名字
+OFFICE_URL = "https://office.hyacinth.im"  # 海辛办公室地址（一般不用改）
+
+# === 推送配置 ===
+PUSH_INTERVAL_SECONDS = 15  # 每隔多少秒推送一次（更实时）
+STATUS_ENDPOINT = "/status"
+JOIN_ENDPOINT = "/join-agent"
+PUSH_ENDPOINT = "/agent-push"
+
+# 自动状态守护：当本地状态文件不存在或长期不更新时，自动回 idle，避免“假工作中”
+STALE_STATE_TTL_SECONDS = int(os.environ.get("OFFICE_STALE_STATE_TTL", "600"))
+
+# 本地状态存储（记住上次 join 拿到的 agentId）
+STATE_FILE = os.path.join(os.path.dirname(os.path.abspath(__file__)), "office-agent-state.json")
+
+# 优先读取本机 OpenClaw 工作区的状态文件（更贴合 AGENTS.md 的工作流）
+# 支持自动发现，减少对方手动配置成本。
+DEFAULT_STATE_CANDIDATES = [
+    "/root/.openclaw/workspace/Star-Office-UI/state.json",  # 当前仓库（大小写精确）
+    "/root/.openclaw/workspace/star-office-ui/state.json",  # 历史/兼容路径
+    "/root/.openclaw/workspace/state.json",
+    os.path.join(os.getcwd(), "state.json"),
+    os.path.join(os.path.dirname(os.path.abspath(__file__)), "state.json"),
+]
+
+# 如果对方本地 /status 需要鉴权，可在这里填写 token（或通过环境变量 OFFICE_LOCAL_STATUS_TOKEN）
+LOCAL_STATUS_TOKEN = os.environ.get("OFFICE_LOCAL_STATUS_TOKEN", "")
+LOCAL_STATUS_URL = os.environ.get("OFFICE_LOCAL_STATUS_URL", "http://127.0.0.1:19000/status")
+# 可选：直接指定本地状态文件路径（最简单方案：绕过 /status 鉴权）
+LOCAL_STATE_FILE = os.environ.get("OFFICE_LOCAL_STATE_FILE", "")
+VERBOSE = os.environ.get("OFFICE_VERBOSE", "0") in {"1", "true", "TRUE", "yes", "YES"}
+
+
+def load_local_state():
+    if os.path.exists(STATE_FILE):
+        try:
+            with open(STATE_FILE, "r", encoding="utf-8") as f:
+                return json.load(f)
+        except Exception:
+            pass
+    return {
+        "agentId": None,
+        "joined": False,
+        "joinKey": JOIN_KEY,
+        "agentName": AGENT_NAME
+    }
+
+
+def save_local_state(data):
+    with open(STATE_FILE, "w", encoding="utf-8") as f:
+        json.dump(data, f, ensure_ascii=False, indent=2)
+
+
+def normalize_state(s):
+    """兼容不同本地状态词，并映射到办公室识别状态。"""
+    s = (s or "").strip().lower()
+    if s in {"writing", "researching", "executing", "syncing", "error", "idle"}:
+        return s
+    if s in {"working", "busy", "write"}:
+        return "writing"
+    if s in {"run", "running", "execute", "exec"}:
+        return "executing"
+    if s in {"research", "search"}:
+        return "researching"
+    if s in {"sync"}:
+        return "syncing"
+    return "idle"
+
+
+def map_detail_to_state(detail, fallback_state="idle"):
+    """当只有 detail 时，用关键词推断状态（贴近 AGENTS.md 的办公区逻辑）。"""
+    d = (detail or "").lower()
+    if any(k in d for k in ["报错", "error", "bug", "异常", "报警"]):
+        return "error"
+    if any(k in d for k in ["同步", "sync", "备份"]):
+        return "syncing"
+    if any(k in d for k in ["调研", "research", "搜索", "查资料"]):
+        return "researching"
+    if any(k in d for k in ["执行", "run", "推进", "处理任务", "工作中", "writing"]):
+        return "writing"
+    if any(k in d for k in ["待命", "休息", "idle", "完成", "done"]):
+        return "idle"
+    return fallback_state
+
+
+def _state_age_seconds(data):
+    try:
+        ts = (data or {}).get("updated_at")
+        if not ts:
+            return None
+        dt = datetime.fromisoformat(str(ts).replace("Z", "+00:00"))
+        if dt.tzinfo is not None:
+            from datetime import timezone
+            return (datetime.now(timezone.utc) - dt.astimezone(timezone.utc)).total_seconds()
+        return (datetime.now() - dt).total_seconds()
+    except Exception:
+        return None
+
+
+def fetch_local_status():
+    """读取本地状态：
+    1) 优先 state.json（符合 AGENTS.md：任务前切 writing，完成后切 idle）
+    2) 其次尝试本地 HTTP /status
+    3) 最后 fallback idle
+
+    额外防抖：如果本地状态更新时间超过 STALE_STATE_TTL_SECONDS，自动视为 idle。
+    """
+    # 1) 读本地 state.json（优先读取显式指定路径，其次自动发现）
+    candidate_files = []
+    if LOCAL_STATE_FILE:
+        candidate_files.append(LOCAL_STATE_FILE)
+    for fp in DEFAULT_STATE_CANDIDATES:
+        if fp not in candidate_files:
+            candidate_files.append(fp)
+
+    for fp in candidate_files:
+        try:
+            if fp and os.path.exists(fp):
+                with open(fp, "r", encoding="utf-8") as f:
+                    data = json.load(f)
+
+                    # 只接受“状态文件”结构；避免误把 office-agent-state.json（仅缓存 agentId）当状态源
+                    if not isinstance(data, dict):
+                        continue
+                    has_state = "state" in data
+                    has_detail = "detail" in data
+                    if (not has_state) and (not has_detail):
+                        continue
+
+                    state = normalize_state(data.get("state", "idle"))
+                    detail = data.get("detail", "") or ""
+                    # detail 兜底纠偏，确保“工作/休息/报警”能正确落区
+                    state = map_detail_to_state(detail, fallback_state=state)
+
+                    # 防止状态文件久未更新仍停留在 working 态
+                    age = _state_age_seconds(data)
+                    if age is not None and age > STALE_STATE_TTL_SECONDS:
+                        state = "idle"
+                        detail = f"本地状态超过{STALE_STATE_TTL_SECONDS}s未更新，自动回待命"
+
+                    if VERBOSE:
+                        print(f"[status-source:file] path={fp} state={state} detail={detail[:60]}")
+                    return {"state": state, "detail": detail}
+        except Exception:
+            pass
+
+    # 2) 尝试本地 /status（可能需要鉴权）
+    try:
+        import requests
+        headers = {}
+        if LOCAL_STATUS_TOKEN:
+            headers["Authorization"] = f"Bearer {LOCAL_STATUS_TOKEN}"
+        r = requests.get(LOCAL_STATUS_URL, headers=headers, timeout=5)
+        if r.status_code == 200:
+            data = r.json()
+            state = normalize_state(data.get("state", "idle"))
+            detail = data.get("detail", "") or ""
+            state = map_detail_to_state(detail, fallback_state=state)
+
+            age = _state_age_seconds(data)
+            if age is not None and age > STALE_STATE_TTL_SECONDS:
+                state = "idle"
+                detail = f"本地/status 超过{STALE_STATE_TTL_SECONDS}s未更新，自动回待命"
+
+            if VERBOSE:
+                print(f"[status-source:http] url={LOCAL_STATUS_URL} state={state} detail={detail[:60]}")
+            return {"state": state, "detail": detail}
+        # 如果 401，说明需要 token
+        if r.status_code == 401:
+            return {"state": "idle", "detail": "本地/status需要鉴权（401），请设置 OFFICE_LOCAL_STATUS_TOKEN"}
+    except Exception:
+        pass
+
+    # 3) 默认 fallback
+    if VERBOSE:
+        print("[status-source:fallback] state=idle detail=待命中")
+    return {"state": "idle", "detail": "待命中"}
+
+
+def do_join(local):
+    import requests
+    payload = {
+        "name": local.get("agentName", AGENT_NAME),
+        "joinKey": local.get("joinKey", JOIN_KEY),
+        "state": "idle",
+        "detail": "刚刚加入"
+    }
+    r = requests.post(f"{OFFICE_URL}{JOIN_ENDPOINT}", json=payload, timeout=10)
+    if r.status_code in (200, 201):
+        data = r.json()
+        if data.get("ok"):
+            local["joined"] = True
+            local["agentId"] = data.get("agentId")
+            save_local_state(local)
+            print(f"✅ 已加入海辛办公室，agentId={local['agentId']}")
+            return True
+    print(f"❌ 加入失败：{r.text}")
+    return False
+
+
+def do_push(local, status_data):
+    import requests
+    payload = {
+        "agentId": local.get("agentId"),
+        "joinKey": local.get("joinKey", JOIN_KEY),
+        "state": status_data.get("state", "idle"),
+        "detail": status_data.get("detail", ""),
+        "name": local.get("agentName", AGENT_NAME)
+    }
+    r = requests.post(f"{OFFICE_URL}{PUSH_ENDPOINT}", json=payload, timeout=10)
+    if r.status_code in (200, 201):
+        data = r.json()
+        if data.get("ok"):
+            area = data.get("area", "breakroom")
+            print(f"✅ 状态已同步，当前区域={area}")
+            return True
+
+    # 403/404：拒绝/移除 → 停止推送
+    if r.status_code in (403, 404):
+        msg = ""
+        try:
+            msg = (r.json() or {}).get("msg", "")
+        except Exception:
+            msg = r.text
+        print(f"⚠️  访问拒绝或已移出房间（{r.status_code}），停止推送：{msg}")
+        local["joined"] = False
+        local["agentId"] = None
+        save_local_state(local)
+        sys.exit(1)
+
+    print(f"⚠️  推送失败：{r.text}")
+    return False
+
+
+def main():
+    local = load_local_state()
+
+    # 先确认配置是否齐全
+    if not JOIN_KEY or not AGENT_NAME:
+        print("❌ 请先在脚本开头填入 JOIN_KEY 和 AGENT_NAME")
+        sys.exit(1)
+
+    # 如果之���没 join，先 join
+    if not local.get("joined") or not local.get("agentId"):
+        ok = do_join(local)
+        if not ok:
+            sys.exit(1)
+
+    # 持续推送
+    print(f"🚀 开始持续推送状态，间隔={PUSH_INTERVAL_SECONDS}秒")
+    print("🧭 状态逻辑：任务中→工作区；待命/完成→休息区；异常→bug区")
+    print("🔐 若本地 /status 返回 Unauthorized(401)，请设置环境变量：OFFICE_LOCAL_STATUS_TOKEN 或 OFFICE_LOCAL_STATUS_URL")
+    try:
+        while True:
+            try:
+                status_data = fetch_local_status()
+                do_push(local, status_data)
+            except Exception as e:
+                print(f"⚠️  推送异常：{e}")
+            time.sleep(PUSH_INTERVAL_SECONDS)
+    except KeyboardInterrupt:
+        print("\n👋 停止推送")
+        sys.exit(0)
+
+
+if __name__ == "__main__":
+    main()