# headless 实测
docker run --rm weechat/weechat:4.10.1 weechat -a -r '/version' -r '/quit' 2>&1 | grep -v $'\033' | grep -v 'fifo: pipe closed' | grep -v 'Plugins unloaded' | tail -3
# 回显：
# WeeChat 4.10.1 (C) 2003-2026 - https://weechat.org/
# WeeChat 4.10.1 [compiled on Sep  5 2026 08:55:20]

/help version
# 回显：
# WeeChat 4.10.1 [compiled on Sep  5 2026 08:55:20]
#
# Help on command "version" (core):
#
# Usage: /version [full]
#
#  full:  show full build information
#
# Show WeeChat version (full version with build information if "full" is given).

/help weechat
# 回显：列出所有 weechat 核心命令

# 重载所有配置
/reload
# 回显：Configuration reloaded

# 重载指定插件配置
/reload irc
# 回显：irc plugin: configuration reloaded

/reload script
# 回显：script plugin: configuration reloaded

# 列出所有插件及加载状态
/plugin list
# 回显：
# alias        4.10.1   loaded
# buflist      4.10.1   loaded
# exec         4.10.1   loaded
# fifo         4.10.1   loaded
# irc          4.10.1   loaded
# logger       4.10.1   loaded
# relay        4.10.1   loaded
# script       4.10.1   loaded
# ...（略）

# 加载插件
/plugin load relay
# 回显：Plugin "relay" loaded

# 卸载插件（IRC 插件也可卸载，不影响核心）
/plugin unload trigger
# 回显：Plugin "trigger" unloaded

# 重新加载插件
/plugin reload irc

# 正常退出
/quit

# 带消息退出（发送给所有 IRC 连接）
/quit "Going offline, back in 1 hour"
# 回显（IRC 服务器回显）：
# libera: Goodbye! (Going offline, back in 1 hour)

# 检查更新并在线升级（使用会话文件保留配置）
/upgrade
# 回显（节选）：
# Checking new version...
# Downloading WeeChat 4.10.2...
# Reloading plugins...
# WeeChat upgraded to 4.10.2

/clear
# 回显：Current buffer cleared
# 只影响屏幕显示，不删除日志文件内容

# 基础添加（端口默认 6667）
/server add libera irc.libera.chat
# 回显：Server "libera" created

# 带端口 + SSL + 自动连接
/server add libera irc.libera.chat/6697 -ssl -autoconnect
# 回显：Server "libera" created

# 带认证信息
/server add libera irc.libera.chat/6697 -ssl -autoconnect \
  -username myuser -realname "My Real Name" \
  -sasl_username irc_account -sasl_password "secret"

/server list
# 回显：
# libera
# oftc
# matrix
#（每行一个服务器名）

/server del oftc
# 回显：Server "oftc" deleted

/server libera
# 回显：切换到 libera 服务器的 Buffer（显示连接状态）

/connect libera
# 回显（节选）：
# libera: connecting to server irc.libera.chat/6697...
# libera: connection to server successful
# libera: joined channel #weechat

/disconnect libera
# 回显：libera: connection closed

/reconnect libera
# 回显：
# libera: connection closed
# libera: connecting to server irc.libera.chat/6697...
# libera: connection to server successful

# 加入频道（当前服务器）
/join #weechat
# 回显：Joined #weechat on libera (session #1 of #weechat on libera)

# 同时加入多个频道
/join #weechat,#python,#rust
# 回显：（多个 Joined 消息）

# 离开频道
/part
# 回显：Left #weechat

# 带 reason 离开
/part "Off for lunch"
# 回显：Left #weechat (Off for lunch)

# 从所有频道离开（保留连接）
/close

# 切换到下一个 Buffer
/next
# 或 Alt+N（默认快捷键）

# 切换到上一个 Buffer
/prev
# 或 Alt+P（默认快捷键）

# 按编号切换
/buffer 3
# 回显：Switching to buffer #3 (#python on libera)

# 按频道名切换
/buffer #weechat
# 回显：Switching to buffer #weechat on libera

# 列出所有 Buffer
/buffer list
# 回显（节选）：
# 1: irc.libera.server
# 2: irc.libera.#weechat
# 3: irc.libera.#python
# 4: irc.oftc.server

# 搜索并跳转到含关键词的 Buffer
/buffer find matrix
# 回显：Switching to buffer #4 (matrix.server)

# 水平分屏（上/下）
/split
# 回显：Split horizontally

# 垂直分屏（左/右）
/splitv
# 回显：Split vertically

# 关闭分割
/merge
# 回显：Merge buffer

# 动态过滤（只显示含关键词的行）
/filter libev
# 回显：Filter set on buffer (display lines containing: "libev")

# 清除过滤
/filter

# 增量文本搜索（类似 less 中的 / 搜索）
/search /server
# 回显：Found at line 42: /server add libera irc.libera.chat
# n 下一个，N 上一个

# 搜索所有 Buffer
/grep weechat
# 回显（跨 Buffer 搜索结果）：
# Buffer #weechat: "WeeChat 4.10.1 ..."
# Buffer #python: "pip install weechat-matrix"

# 关闭当前 Buffer
/close
# 回显：Buffer #weechat closed

# 关闭指定编号 Buffer
/close 3

# 列出已安装脚本
/script list
# 回显：
# Scripts:
#   go.py       1.5      Go IRC bot
#   notify.py   3.2      Desktop notifications
#   awaylog.py  2.0      Log away messages

# 搜索脚本
/script search matrix
# 回显：
# Available scripts (matching "matrix"):
#   matrix_python.py  2.3  Matrix bridge for Weechat
#   matrix_client.pl  1.1  Matrix client in Perl

# 安装脚本
/script install go.py
# 回显：
# Downloading script "go.py" (version 1.5)...
# Script "go.py" installed

# 更新所有脚本
/script update
# 回显：
# Checking for updates...
# go.py: 1.5 -> 1.6 (updating)
# notify.py: 3.2 -> 3.4 (updating)
# Scripts updated.

# 卸载脚本
/script remove go.py
# 回显：Script "go.py" removed

# 启用/禁用脚本
/script toggle notify.py
# 回显：Script "notify.py" disabled (toggle again to enable)

# 查看脚本详情
/script show go.py
# 回显：
# Script "go.py":
#   Author: flashcode
#   Version: 1.5
#   Description: Go IRC bot with plugin API
#   URL: https://weechat.org/scripts/source/go.py.html

# 列出所有别名
/alias
# 回显（节选）：
# Alias  Command
# ----------------------------
# afk    away I'm away from keyboard
# back   back
# j      join
# p      part
# q      quit
# ...（略）

# 创建别名
/alias add lf "exec ls -la"
# 回显：Alias "lf" added
# 使用：/lf → 执行 exec ls -la

# 修改现有别名
/alias add jf "exec journalctl -u weechat.service -f"
# 回显：Alias "jf" added (replaces default "j")

# 删除别名
/alias del lf
# 回显：Alias "lf" deleted

# 查看别名详情
/alias show j
# 回显：Alias "j" = "join" (default)

# 列出所有可修改参数（可交互式筛选）
/fset
# 打开交互式界面，支持正则过滤、批量修改

# 预设过滤器直接修改
/fset irc.server.*.ssl on
# 回显（批量修改）：
# irc.server.libera.ssl: off -> on
# irc.server.oftc.ssl: off -> on
# Option "irc.server.libera.ssl" set to "on"

# headless 实测
docker run --rm weechat/weechat:4.10.1 weechat -a -r '/exec uname -a' -r '/quit' 2>&1 | grep -v $'\033' | tail -5
# 回显（节选）：
# exec: starting "uname -a" in background
# exec: output of command "uname -a":
# Linux 91a8f4b5c3d4 6.1.0-27-amd64 ...

# 基础执行
/exec uname -a
# 回显：
# exec: starting "uname -a" in background
# exec: output of command "uname -a":
# Linux hostname 5.15.0 #1 SMP x86_64 GNU/Linux

# 执行并等待完成（同步模式）
/exec -sh -o date
# 回显：2026-10-27 07:31:47 UTC

# 将执行结果输出到指定 Buffer
/exec -sb mybuffer -o "curl -s ifconfig.me"
# 回显（在 mybuffer 中）：203.0.113.5

# 查看正在执行的命令
/exec list
# 回显：
# PID  Command              Status
# 1234 journalctl -f        running
# 1235 tail -f /var/log/syslog  running

# 终止正在执行的命令
/exec kill 1234
# 回显：Process 1234 killed

# 列出所有触发器
/trigger list
# 回显：
# Triggers:
#   away_check     1.0  Check away status every 5 min
#   highlight      2.1  Highlight nick mentions
#   auto_rejoin    1.2  Auto rejoin on kick

# 创建触发器（事件 → 动作）
/trigger add my_highlight message_pv "" "/exec paplay /usr/share/sounds/freedesktop/stereo/bell.oga"
# 回显：Trigger "my_highlight" added
# 含义：当收到私聊消息时，播放声音通知

# 触发器匹配 IRC 服务器指定频道关键词
/trigger add dev_matches irc_special,irc_privmsg "irc.channel == '#dev' && nick == 'flashcode'" "/exec notify-send 'Weechat' 'flashcode said: ${message}'"
# 回显：Trigger "dev_matches" added

# 禁用/启用触发器
/trigger toggle my_highlight
# 回显：Trigger "my_highlight" disabled

# 删除触发器
/trigger del my_highlight
# 回显：Trigger "my_highlight" deleted

# 查看 fifo 管道状态
/fifo
# 回显：
# FIFO pipe: /tmp/weechat-12345/fifo
#   (path can be changed with weechat.fifo option)

# 通过 fifo 从外部发送命令
echo "/join #linux" > /tmp/weechat-12345/fifo
# 回显（Weechat 内）：Joined #linux

# 创建新的 fifo（如管道文件被删除）
/fifo enable
# 回显：FIFO pipe enabled at /tmp/weechat-12345/fifo

# 向频道用户发送文件（需要对方已 DCC 接受）
# 在对 Buffer 中输入：
/dcc send username /path/to/file.zip
# 回显：
# DCC SEND file.zip (12345678 bytes) to username: request sent

# 接收对方发送的文件（Weechat 自动接受或提示确认）
# 默认保存到 ~/.weechat/xfer/
# 修改保存目录：
/set xfer.file.download_path "/home/user/Downloads/irc"

# 查看传输列表
/xfer list
# 回显：
# Transfers:
#   send  file.zip       7.8 MB  sending  (1.2 MB/s)
#   get   script.tar.gz  3.4 MB  complete

# 查看完整帮助（所有命令/参数）
/helpall > /tmp/weechat-all-commands.txt
# 生成所有帮助文档到文本文件

# 查看插件详细信息（含命令列表）
/plugin list full
# 回显：每个插件的详细命令/参数列表

# 开启调试日志
/logger debug
# 回显：Debug logging enabled → 输出到 ~/.weechat/debug.log
# 关闭：/logger debug

# 查看当前连接的 relay 客户端
/relay list
# 回显：
# Relay "main" on port 9000 (SSL: no, clients: 2/16)
#   client 1: IP=192.168.1.105, interface=glowing-bear
#   client 2: IP=192.168.1.200, interface=weechat-android

# 查看当前会话可用的所有命令
/help

# 批量关闭匹配的 Buffer（示例：关闭所有 oftc 服务器 Buffer）
/foreach buffer "" "" "/close"
# 配合 /fset 或 trigger 实现复杂批量逻辑

# 示例：trigger 中使用变量
/trigger add test_ping message_channel "irc.channel == '#team'" "/exec ping -c 1 ${server}"