A 命令速查与本地课程构建

在现有板子上查看状态

cd /root/02project/01xianyumonitor
git status --short
git rev-parse --short HEAD
systemctl is-active xianyu-monitor-web xianyu-monitor-worker
systemctl show xianyu-monitor-worker -p ExecStart -p WorkingDirectory
ss -ltnp | grep ':8080'
tmux attach -t xianyu-monitor
journalctl -u xianyu-monitor-worker --since '10 minutes ago' --no-pager

检查配置、采集与离线识别

以下文件路径是示意，先创建私密目录。截图、OCR 结果及诊断即使有脱敏功能，也应在检查后才对外共享。

install -d -m 0700 /root/xvm-private
XVM_ENV_FILE=/etc/xianyu-monitor/monitor.env \
 /root/miniconda3/envs/xianyu-monitor/bin/xianyu-monitor check-config
XVM_ENV_FILE=/etc/xianyu-monitor/monitor.env \
 /root/miniconda3/envs/xianyu-monitor/bin/xianyu-monitor capture-once \
 --out /root/xvm-private/frame.png
XVM_ENV_FILE=/etc/xianyu-monitor/monitor.env \
 /root/miniconda3/envs/xianyu-monitor/bin/xianyu-monitor analyze-image \
 /root/xvm-private/frame.png --profile /root/xvm-private/profile.json --pane

capture-once 不点击；analyze-image 不发送，但可能输出识别原文；benchmark 只输出耗时和一致性。smtp-test 默认检查连接，smtp-test --send 会真正发送邮件。import-rules、load-calibration 和 migrate 会修改数据库，执行前先理解作用。

命令参数以冻结 cli.py 的 build_parser 为准，不存在的 --account 或 --compare-det 不应写进当前启动脚本。

本地 Sphinx 文档环境

Set-Location 'C:\02media\04mycoding\py310sphinx_knowledge'
& 'C:\01soft\12conda\envs\py310sphinx_knowledge_base\python.exe' -m sphinx `
  -b html --keep-going docs/source docs/build/html
& 'C:\01soft\12conda\envs\py310sphinx_knowledge_base\python.exe' -m http.server `
  8269 --bind 127.0.0.1 --directory docs/build/html

访问 /courses/xianyu_visual_monitor_from_zero/index.html。第二条是前台静态预览命令，按 Ctrl+C 停止；它不会部署板子服务，也不会启动闲鱼自动回复。

源码通过 literalinclude 引入冻结文件，导航通过 toctree 管理，相关机制见 Sphinx directives。文件改变后重新构建，不能直接编辑生成的 HTML 当作课程源文档。