Spaces:

Jackken
/

hermes-bot

Running

Z User commited on 9 days ago

Commit

290db07

1 Parent(s): da88712

add /deploy route - deployment overview page

- entry.py: add /deploy GET route serving deploy.html
- Dockerfile: COPY deploy.html to container
- deploy.html: full deployment overview with architecture, changelog,
masked .env/config.yaml preview, FAQ, SOUL.md summary

Files changed (3) hide show

Dockerfile +1 -0
deploy.html +287 -0
entry.py +5 -0

Dockerfile CHANGED Viewed

@@ -34,6 +34,7 @@ COPY SOUL.md /root/.hermes/SOUL.md
 COPY .env /root/.hermes/.env
 COPY entry.py /app/entry.py
 COPY dashboard.html /app/dashboard.html
 COPY plugins/pollinations/ /root/.hermes/plugins/image_gen/pollinations/
 RUN chmod 600 /root/.hermes/.env

 COPY .env /root/.hermes/.env
 COPY entry.py /app/entry.py
 COPY dashboard.html /app/dashboard.html
+COPY deploy.html /app/deploy.html
 COPY plugins/pollinations/ /root/.hermes/plugins/image_gen/pollinations/
 RUN chmod 600 /root/.hermes/.env

deploy.html ADDED Viewed

	@@ -0,0 +1,287 @@

+<!DOCTYPE html>
+<html lang="zh-CN">
+<head>
+<meta charset="utf-8">
+<meta name="viewport" content="width=device-width,initial-scale=1">
+<title>Hermes Bot · HF Spaces 部署总览</title>
+<style>
+*{margin:0;padding:0;box-sizing:border-box}
+body{font-family:-apple-system,BlinkMacSystemFont,"Segoe UI",Roboto,sans-serif;background:#0a0a0a;color:#e0e0e0;min-height:100vh;display:flex;flex-direction:column;align-items:center;justify-content:center;padding:24px}
+.container{max-width:720px;width:100%}
+.logo{text-align:center;margin-bottom:36px}
+.logo h1{font-size:2.4rem;font-weight:700;background:linear-gradient(135deg,#ff6b35,#ffa500);-webkit-background-clip:text;-webkit-text-fill-color:transparent;letter-spacing:-0.5px}
+.logo p{color:#666;margin-top:8px;font-size:0.95rem}
+.logo .ver{display:inline-block;margin-top:6px;padding:2px 10px;border-radius:20px;background:#111;border:1px solid #222;color:#ff6b35;font-size:0.75rem;font-weight:600}
+.card{background:#111;border:1px solid #222;border-radius:16px;padding:28px 32px;margin-bottom:20px}
+.card h2{font-size:1.05rem;color:#ff6b35;margin-bottom:14px;display:flex;align-items:center;gap:8px}
+.card h2 span{font-size:1.2rem}
+.card pre{background:#0a0a0a;border:1px solid #1a1a1a;border-radius:10px;padding:14px 16px;overflow-x:auto;font-size:0.8rem;line-height:1.7;color:#b0b0b0;font-family:"SF Mono",Monaco,"Cascadia Code",monospace}
+.cmd{color:#ff6b35}.cmt{color:#444}.ok{color:#00d4aa}.fix{color:#ff9900}.new{color:#88ccff}.hl{color:#ffc864}.rm{color:#ff6b6b}
+.warn{background:#1a1208;border:1px solid #332a10;border-radius:12px;padding:18px 22px;margin-bottom:20px;display:flex;gap:12px;align-items:flex-start}
+.warn .icon{font-size:1.3rem;flex-shrink:0;margin-top:2px}
+.warn .text{font-size:0.88rem;line-height:1.6}
+.warn .text strong{color:#ff9900}
+.arch{background:#0d1117;border:1px solid #21262d;border-radius:12px;padding:18px 22px;margin-bottom:20px}
+.arch h3{font-size:0.9rem;color:#58a6ff;margin-bottom:12px}
+.arch pre{font-size:0.78rem;line-height:1.6;color:#8b949e;font-family:"SF Mono",Monaco,"Cascadia Code",monospace}
+.steps{list-style:none;counter-reset:step}
+.steps li{counter-increment:step;padding:10px 0 10px 44px;position:relative;font-size:0.92rem;line-height:1.6;color:#999;border-bottom:1px solid #1a1a1a}
+.steps li:last-child{border-bottom:none}
+.steps li::before{content:counter(step);position:absolute;left:0;top:8px;width:30px;height:30px;background:#111;border:1px solid #222;border-radius:50%;display:flex;align-items:center;justify-content:center;font-size:0.8rem;color:#ff6b35;font-weight:600}
+.steps li strong{color:#e0e0e0}
+.tag{display:inline-block;padding:1px 7px;border-radius:4px;font-size:0.7rem;font-weight:600;margin-left:4px;vertical-align:middle}
+.tag-new{background:#2a1a00;color:#ff6b35}.tag-ok{background:#0a2a1a;color:#00d4aa}.tag-fix{background:#2a1a00;color:#ff9900}.tag-rm{background:#2a0a0a;color:#ff6b6b}
+.badge{display:inline-block;padding:3px 10px;border-radius:6px;font-size:0.72rem;font-weight:600;margin-bottom:14px}
+.footer{text-align:center;margin-top:12px;color:#333;font-size:0.78rem}
+.cost{text-align:center;padding:16px;margin-bottom:20px;border-radius:12px;background:linear-gradient(135deg,#1a0a00,#2a1a0a);border:1px solid #3a2a1a}
+.cost .big{font-size:1.8rem;font-weight:700;color:#ff6b35}
+.cost .sub{font-size:0.82rem;color:#666;margin-top:4px}
+a{color:#ffc864;text-decoration:none}
+a:hover{text-decoration:underline}
+.section{display:flex;gap:12px;margin-bottom:20px}
+.section>div{flex:1}
+.stat{text-align:center;padding:20px 12px;border-radius:12px;background:#111;border:1px solid #222}
+.stat .label{color:#555;font-size:0.75rem;text-transform:uppercase;letter-spacing:0.5px;margin-bottom:6px}
+.stat .value{font-size:1.5rem;font-weight:700}
+.stat .value.orange{color:#ff6b35}
+.stat .value.green{color:#00d4aa}
+.stat .value.blue{color:#58a6ff}
+.stat .value.purple{color:#d2a8ff}
+.stat .note{color:#444;font-size:0.72rem;margin-top:4px}
+</style>
+</head>
+<body>
+<div class="container">
+  <div class="logo">
+    <h1>Hermes Bot</h1>
+    <p>HuggingFace Spaces · 飞书 AI Agent · 7x24 在线</p>
+    <span class="ver">v3.0 HF Spaces · 2026.04</span>
+  </div>
+  <div class="cost">
+    <div class="big">Free (免费)</div>
+    <div class="sub">HuggingFace Spaces 免费 CPU 实例 · OpenRouter 免费模型 · 零成本运行</div>
+  </div>
+  <div class="section">
+    <div class="stat">
+      <div class="label">主模型</div>
+      <div class="value orange">Gemma 4 31B</div>
+      <div class="note">google/gemma-4-31b-it</div>
+    </div>
+    <div class="stat">
+      <div class="label">备用模型</div>
+      <div class="value blue">Qwen3 Coder</div>
+      <div class="note">qwen/qwen3-coder</div>
+    </div>
+    <div class="stat">
+      <div class="label">记忆系统</div>
+      <div class="value purple">Holographic</div>
+      <div class="note">SQLite + FTS5</div>
+    </div>
+    <div class="stat">
+      <div class="label">图片生成</div>
+      <div class="value green">Pollinations</div>
+      <div class="note">Flux · 免费</div>
+    </div>
+  </div>
+  <div class="warn">
+    <div class="icon">&#128274;</div>
+    <div class="text">
+      <strong>API 密钥已脱敏</strong> — 共计 5 个敏感值在预览中全部打码。<br>
+      完整版仅存储在 HF Space 容器内（.env），不对外暴露。
+    </div>
+  </div>
+  <div class="card">
+    <h2><span>&#127959;</span> 部署架构 <span class="tag tag-new">HF Spaces</span></h2>
+    <div class="arch">
+      <pre><span class="hl">HuggingFace Spaces (Docker SDK)</span>
+├── <span class="hl">Space: Jackken/hermes-bot</span>
+│   ├── <span class="hl">Dockerfile</span>                     ← Python 3.12-slim 基础镜像
+│   ├── <span class="hl">entry.py</span>                       ← 入口：Dashboard(:7860) + Gateway 子进程
+│   ├── <span class="hl">dashboard.html</span>                  ← 实时监控面板（SSE 日志流）
+│   ├── <span class="hl">start.sh</span>                       ← 启动脚本
+│   │
+│   ├── <span class="hl">config.yaml</span>                    ← 模型/平台/记忆/插件配置
+│   ├── <span class="hl">SOUL.md</span>                        ← 人格定义（12 章节 · 全中文）
+│   ├── <span class="hl">.env</span>                           ← API 密钥（chmod 600）
+│   │
+│   └── <span class="hl">plugins/pollinations/</span>           ← 图片生成插件（免费·无需 Key）
+│       ├── plugin.yaml
+│       └── __init__.py                ← PollinationsImageGenProvider
+│
+├── <span class="hl">Persistent Storage (/data)</span>         ← HF 持久化存储（重启不丢）
+│   ├── sessions/                    ← 会话数据（每 24h 自动清理上下文）
+│   ├── memories/                    ← Holographic 长期记忆（SQLite + FTS5）
+│   ├── uploads/                     ← 用户上传文件缓存
+│   └── logs/                        ← Gateway 运行日志
+│
+└── <span class="hl">Free CPU Instance</span>                ← 2 vCPU · 16GB RAM · 50GB 存储
+<span class="hl">OpenRouter</span>                          ← 大模型 API（免费模型）
+├── google/gemma-4-31b-it           ← 主模型（推理 + 工具调用）
+└── qwen/qwen3-coder                ← 备用模型（主模型失败自动切换）
+<span class="hl">Pollinations.ai</span>                     ← 免费图片生成
+└── Flux 模型                       ← landscape / square / portrait
+<span class="hl">飞书</span>                                ← WebSocket 长连接
+└── App: Hermes                    ← 7x24 在线 · 流式回复 · 工具透明</pre>
+    </div>
+  </div>
+  <div class="card">
+    <h2><span>&#128296;</span> 修复与变更 <span class="tag tag-new">v3.0</span></h2>
+    <pre><span class="new">&#9733; 新增</span> <span class="hl">Pollinations.ai 图片生成</span>
+   插件框架实现 ImageGenProvider，Flux 模型免费生成图片
+   plugins.enabled 显式启用 image_gen/pollinations
+   SOUL.md 添加图片生成使用指南 + MEDIA 标签发送
+<span class="new">&#9733; 新增</span> <span class="hl">Firecrawl 网页抓取</span>
+   FIRECRAWL_API_KEY 注入 .env，headless 浏览器 + stealth 反爬
+   用于 JS 渲染页面抓取（微信公众号除外）
+<span class="new">&#9733; 新增</span> <span class="hl">中文字体支持</span>
+   Dockerfile 下载 NotoSansSC-Regular.otf + Bold.otf (~16MB)
+   解决 PDF/图片中文渲染乱码问题
+<span class="new">&#9733; 新增</span> <span class="hl">微信公众号文章处理策略</span>
+   SOUL.md 五级降级链：Firecrawl → Jina Reader → 搜狗 → 转载搜索 → 用户截图
+   禁止直接 curl mp.weixin.qq.com（验证码拦截）
+<span class="fix">&#10003; 修复</span> <span class="hl">飞书文件发送机制</span>
+   SOUL.md 从错误的"手动调 send_document"改为 MEDIA:&lt;path&gt; 标签机制
+   网关自动扫描标签 → adapter.send_document() 上传
+<span class="rm">&#10007; 移除</span> <span class="hl">MemPalace 记忆系统</span>
+   chromadb + onnxruntime 吃 1-2GB 内存 → OOM 风险
+   改用 Holographic（SQLite + FTS5），内存占用几乎为零
+   .env / Dockerfile / config.yaml / entry.py 同步清理
+<span class="ok">&#8730; 正常</span> <span class="hl">Holographic 记忆</span>
+   持久化存储 /data/hermes/memories/，重启/reset 均不丢失
+   auto_extract: true 自动提取关键信息存入记忆
+<span class="ok">&#8730; 正常</span> <span class="hl">上下文压缩</span>
+   50 条消息触发，压缩至 20 条，保护最近 20 条不压缩
+<span class="ok">&#8730; 正常</span> <span class="hl">全部 5 个 API 密钥</span>
+   *** 已脱敏 *** · 仅容器内可见</pre>
+  </div>
+  <div class="card">
+    <h2><span>&#128196;</span> 脱敏预览 (.env)</h2>
+    <pre><span class="hl">OPENROUTER_API_KEY</span> = <span class="cmt">"***MASKED***"</span>   <span class="cmt"># OpenRouter 大模型接口</span>
+<span class="hl">OPENAI_API_KEY</span>     = <span class="cmt">"***MASKED***"</span>   <span class="cmt"># 同 OpenRouter Key</span>
+<span class="hl">OPENAI_BASE_URL</span>    = <span class="ok">"https://openrouter.ai/api/v1"</span>
+<span class="hl">FEISHU_APP_ID</span>      = <span class="cmt">"***MASKED***"</span>   <span class="cmt"># 飞书应用 App ID</span>
+<span class="hl">FEISHU_APP_SECRET</span>  = <span class="cmt">"***MASKED***"</span>   <span class="cmt"># 飞书应用 App Secret</span>
+<span class="hl">FIRECRAWL_API_KEY</span>  = <span class="cmt">"***MASKED***"</span>   <span class="cmt"># Firecrawl 网页抓取</span>
+<span class="hl">GATEWAY_ALLOW_ALL_USERS</span> = <span class="ok">true</span>
+<span class="hl">HERMES_ACCEPT_HOOKS</span> = <span class="ok">1</span>
+<span class="cmt"># 共计 5 个密钥已脱敏 · config.yaml: model = google/gemma-4-31b-it</span></pre>
+  </div>
+  <div class="card">
+    <h2><span>&#128203;</span> 脱敏预览 (config.yaml)</h2>
+    <pre><span class="hl">model</span>: <span class="ok">google/gemma-4-31b-it</span>              <span class="cmt"># 主模型</span>
+<span class="hl">provider</span>: <span class="ok">openrouter</span>
+<span class="hl">fallback_model</span>:
+  <span class="hl">provider</span>: <span class="ok">openrouter</span>
+  <span class="hl">model</span>: <span class="ok">qwen/qwen3-coder</span>                 <span class="cmt"># 备用模型</span>
+<span class="hl">max_turns</span>: <span class="ok">90</span>                             <span class="cmt"># 单轮最大工具调用轮数</span>
+<span class="hl">platforms</span>.feishu:
+  <span class="hl">enabled</span>: <span class="ok">true</span>
+  <span class="hl">connection_mode</span>: <span class="ok">websocket</span>            <span class="cmt"># 长连接</span>
+<span class="hl">memory</span>:
+  <span class="hl">provider</span>: <span class="ok">holographic</span>                   <span class="cmt"># 持久记忆</span>
+  <span class="hl">auto_extract</span>: <span class="ok">true</span>
+<span class="hl">compress</span>:
+  <span class="hl">enabled</span>: <span class="ok">true</span>                          <span class="cmt"># 长对话自动压缩</span>
+  <span class="hl">threshold</span>: <span class="ok">50</span>                           <span class="cmt"># 50条触发</span>
+  <span class="hl">target_ratio</span>: <span class="ok">20</span>                       <span class="cmt"># 压缩至20条</span>
+<span class="hl">image_gen</span>:
+  <span class="hl">provider</span>: <span class="ok">pollinations</span>                  <span class="cmt"># 免费图片生成</span>
+<span class="hl">plugins</span>:
+  <span class="hl">enabled</span>: <span class="ok">[image_gen/pollinations]</span>
+<span class="hl">no_mcp</span>: <span class="ok">true</span>                            <span class="cmt"># 禁用 MCP 节省内存</span>
+<span class="hl">terminal</span>:
+  <span class="hl">backend</span>: <span class="ok">local</span>
+  <span class="hl">timeout</span>: <span class="ok">180</span>
+<span class="hl">timezone</span>: <span class="ok">Asia/Shanghai</span></pre>
+  </div>
+  <div class="card">
+    <h2><span>&#127919;</span> 部署管理</h2>
+    <pre><span class="cmt"># Space 地址</span>
+<span class="hl">https://huggingface.co/spaces/Jackken/hermes-bot</span>
+<span class="cmt"># 本地克隆（修改配置后 git push 自动重建）</span>
+<span class="cmd">git</span> clone https://huggingface.co/spaces/Jackken/hermes-bot
+<span class="cmd">cd</span> hermes-bot
+<span class="cmt"># 修改 SOUL.md / config.yaml / .env 后...</span>
+<span class="cmd">git</span> add -A && <span class="cmd">git</span> commit -m "update" && <span class="cmd">git</span> push
+<span class="cmt"># 监控面板（实时日志 + 会话 + 重启）</span>
+<span class="hl">https://jackken-hermes-bot.hf.space/</span>
+<span class="cmt"># 手动重启 Space（Factory Rebuild 会清空持久化存储！）</span>
+<span class="hl">在 Space 页面点击 "Factory Rebuild" 按钮</span></pre>
+  </div>
+  <div class="card">
+    <h2><span>&#128161;</span> 常见问题</h2>
+    <pre><span class="cmt">Q: 免费实例会休眠吗？</span>
+<span class="ok">A:</span> HF 免费 CPU 实例在 48 小时无请求后休眠，下次请求自动唤醒（1-2 分钟）
+   飞书 WebSocket 长连接会保持活跃，通常不会休眠
+<span class="cmt">Q: 内存够用吗？</span>
+<span class="ok">A:</span> 16GB RAM 当前使用约 84%。已移除 MemPalace（省 1-2GB）。
+   如果频繁 OOM：减少 max_turns / 禁用浏览器工具 / 清理日志
+<span class="cmt">Q: Factory Rebuild 会丢数据吗？</span>
+<span class="ok">A:</span> 是的！Rebuild 会清空 /data 持久化存储（记忆/会话/日志全丢）。
+   正常 git push 只重建容器不丢数据，尽量用 git push 而非 Rebuild
+<span class="cmt">Q: 如何修改人格/记忆？</span>
+<span class="ok">A:</span> SOUL.md 控制人格（12 章节），克隆仓库编辑后 git push
+   记忆系统自动运行，也可在飞书中发 /reset 清理上下文（记忆不丢）
+<span class="cmt">Q: 图片生成失败怎么办？</span>
+<span class="ok">A:</span> 检查 config.yaml 中 plugins.enabled 是否包含 image_gen/pollinations
+   Pollinations.ai 偶尔不稳定，生成需 10-20 秒，耐心等待
+<span class="cmt">Q: 微信公众号文章抓不到？</span>
+<span class="ok">A:</span> 微信反爬极强（验证码），Firecrawl/Jina/curl 均无法突破
+   使用 SOUL.md 五级降级链：Firecrawl → Jina → 搜狗 → 搜索转载 → 截图</pre>
+  </div>
+  <div class="card">
+    <h2><span>&#128268;</span> SOUL.md 人格概览</h2>
+    <pre><span class="cmt"># 12 章节完整人格定义</span>
+<span class="hl">一</span>、记忆系统（Holographic）          <span class="cmt"># SQLite + FTS5 持久记忆</span>
+<span class="hl">二</span>、任务分类与响应策略              <span class="cmt"># 8 种消息类型自动判断</span>
+<span class="hl">三</span>、工具编排策略                    <span class="cmt"># 4 条常用工具链</span>
+<span class="hl">四</span>、错误恢复机制                    <span class="cmt"># 8 种失败场景恢复链</span>
+<span class="hl">五</span>、回复格式标准                    <span class="cmt"># 飞书 Markdown + 篇幅控制</span>
+<span class="hl">六</span>、上下文感知                      <span class="cmt"># 时间 + 对话 + 跨会话</span>
+<span class="hl">七</span>、主动行为                        <span class="cmt"># 4 种主动触发场景</span>
+<span class="hl">八</span>、飞书特化                        <span class="cmt"># MEDIA 标签 / 文档 / 卡片</span>
+<span class="hl">九</span>、图片生成                        <span class="cmt"># Pollinations.ai + MEDIA 发送</span>
+<span class="hl">十</span>、独有能力清单                    <span class="cmt"># 14 项飞书独有能力</span>
+<span class="hl">十一</span>、边界与诚实                     <span class="cmt"># 不编造 / 不越界</span>
+<span class="hl">十二</span>、效率原则                       <span class="cmt"># 最少工具调用 / 并行执行</span></pre>
+  </div>
+  <div class="footer">
+    Hermes Bot · HuggingFace Spaces · 飞书 AI Agent<br>
+    Nous Research hermes-agent · OpenRouter · Pollinations.ai · Firecrawl
+  </div>
+</div>
+</body>
+</html>

entry.py CHANGED Viewed

@@ -37,6 +37,7 @@ LOG_FILE = os.path.join(LOG_DIR, "gateway.log")
 CONFIG_FILE = os.path.join(HERMES_HOME, "config.yaml")
 ENV_FILE = os.path.join(HERMES_HOME, ".env")
 DASHBOARD_HTML = "/app/dashboard.html"
 # ---------------------------------------------------------------------------
 # Logging
@@ -271,6 +272,10 @@ class DashboardHandler(BaseHTTPRequestHandler):
         if parsed.path in ("/", "/index.html"):
             return self._send_html(DASHBOARD_HTML)
         # SSE log stream
         if parsed.path == "/api/logs/stream":
             return self._handle_sse()

 CONFIG_FILE = os.path.join(HERMES_HOME, "config.yaml")
 ENV_FILE = os.path.join(HERMES_HOME, ".env")
 DASHBOARD_HTML = "/app/dashboard.html"
+DEPLOY_HTML = "/app/deploy.html"
 # ---------------------------------------------------------------------------
 # Logging
         if parsed.path in ("/", "/index.html"):
             return self._send_html(DASHBOARD_HTML)
+        # Deploy overview
+        if parsed.path == "/deploy":
+            return self._send_html(DEPLOY_HTML)
         # SSE log stream
         if parsed.path == "/api/logs/stream":
             return self._handle_sse()