{# app_url：Jinja 宏，不依赖 Python 往 context 注入；前缀来自中间件 request.state.web_url_prefix（WEB_URL_PREFIX）或 ASGI root_path #} {% macro app_url(path) -%} {%- set _p = path if path.startswith('/') else '/' ~ path -%} {%- set pre = (request.state.web_url_prefix | default('', true)) | trim -%} {%- if not pre -%} {%- set pre = request.scope.get('root_path', '') | trim -%} {%- endif -%} {{- pre ~ _p if pre else _p -}} {%- endmacro %} Telegram Scraper 控制台 {% if need_auth_banner %}
{% endif %} {% if error %}
{% endif %}

Telegram Scraper 控制台

数据概览 · 本地 SQLite 聚合（与是否在线无关）

{% if connected %} 已连接 {% else %} 未连接 {% endif %} {% if job_running %} 任务运行中 {% else %} 任务空闲 {% endif %} {% if continuous_running %} 持续抓取中 {% else %} 持续抓取关 {% endif %}

单次任务：{% if job_running %}{{ job_name }}{% else %}无{% endif %} · 已运行 {% if job_running %}{{ job_uptime }}{% else %}-{% endif %} · 持续心跳 {{ continuous_uptime if continuous_running else '-' }}

{% if console_authed %}
{% endif %}
区间内消息
—
按消息日期
招聘类估算
—
关键词 OR 匹配
累计消息（全库）
—
所有频道 .db
监控 / 数据频道
—
state 监控数 · 有库文件夹数

每日新增消息

区间内按天汇总（所有已抓取入库的频道）

每日「招聘类」消息（估算）

正文包含任一关键词即计入（非 NLP 分类）

各频道区间内消息量

横轴为消息条数，纵轴为频道显示名（来自 state 中的标题 / @用户名）

控制台密码验证

须验证通过后才能打开「连接 / 常规操作 / 频道管理 / 环境配置 / 运行日志」等面板。请在服务器环境变量中设置 WEB_CONSOLE_PASSWORD（未设置时使用程序内置默认值）。务必设置随机长字符串 WEB_CONSOLE_SESSION_SECRET 用于会话签名，勿泄露。

连接与持续抓取

{% if error %} {% endif %}

初始化可能较慢（网络、扫码登录等）。结果会显示在下方灰色框内，无需只看浏览器网络里的 303； 无头登录请开 TELEGRAM_HEADLESS_QR=1 并在运行日志中打开二维码链接。

常规操作

「频道管理」弹窗中可查看已监控列表与勾选添加。 移除/任务范围里的 1,2 与已监控列表从上到下序号一致。

频道（加入 / 移出监控）

添加：@用户名、-100…、https://t.me/xxx。 不支持仅靠群内显示标题。

移除：all；1,2；-100…；@用户名 / t.me（须已在监控中）。

任务（抓取 / 导出 / 补媒体）

范围：all、1,3、-100… 或已在监控的 @ / 链接。

频道管理

已监控（[序号] 对应移除/任务范围里的编号；仅展示名称）

{% if monitored %} {% for ch in monitored %}
[{{ loop.index }}] {{ ch.display_name | default('未命名频道') }} · 进度消息 ID {{ ch.last_message_id }}
{% endfor %} {% else %}
暂无
{% endif %}

账号可见频道：勾选后加入监控。标题包含配置项「账号列表隐藏」中任一子串的会话不会出现在此列表（默认隐藏含「远程-到岗-技术招聘」的群，避免选到自有招聘群）。

{% if account_channels %} {% else %}
{% if not console_authed %}请先通过右上角验证（输入密码）后刷新本页以加载账号频道列表。{% else %}请先连接 Telegram 后刷新本页加载列表{% endif %}
{% endif %}

环境配置（写入 .env）

保存后建议断开并重新连接 Telegram。

{% for f in fields %} {% if f.key in binary_env_keys %}
{{ f.label }}
{% else %}
{% endif %} {% endfor %}

运行日志（最近 1200 行）

{% if logs %}{{ logs }}{% else %}（验证通过前不展示日志内容；验证后刷新或等待自动刷新。）{% endif %}