私人信息：WeeChat 快速入门指南

WeeChat 快速入门指南

WeeChat（Wee Enhanced Environment for Chat）是个快速的轻量级 IRC 客户端，可以在多种操作系统中运行。所有的东西都能用键盘完成，而且可以自定义，具有高度可定制和可扩展的脚本，兼容 RFCs 1459，2810，2811，2812 和 2813。作者：Sébastien Helleu。项目地址

• WeeChat 快速入门指南
• 1. 启动 WeeChat
• 2. 在线帮助 / 选项
• 3. 核心 vs 插件
• 4. 添加一个IRC服务器
• 5. 设置自定义的IRC服务器选项
• 6. 连接到IRC服务器和自动加入频道
• 7. 参加频道 / 退出
• 8. IRC私人信息
• 9. 缓冲区 / 窗口管理
• 10. 按键设置
• 11. 插件 / 脚本
• 12. 更多文档

---

1. 启动 WeeChat

对于X（但不是强制的）推荐的终端模拟器是rxvt-unicode: 它有良好的UTF-8支持，而且默认键盘绑定没有问题。
从你的shell运行：

$ weechat

2. 在线帮助 / 选项

WeeChat对所有命令都有帮助文档，只需输入以下命令：

/help

对于特定命令的帮助，请输入以下命令：

/help command

设置选项，请输入以下命令：

/set config.section.option value

config 是设定名称（weechat的核心，或者一个插件的名字），section 是该设定的部分 option 是选项名。
WeeChat会立即使用新值（在配置更改后，不需要重新启动WeeChat）。
你可以在开始或结束时使用 /set 选项带有部分名称和通配符“ * ”的选项 ，以显示包括所有包含字母的选项。例如：
- 显示所有选项（WeeChat和插件）：

/set

• 显示WeeChat选项：

/set weechat.*

• 显示IRC插件选项：

/set irc.*

你可以显示一个选项的帮助 / 帮助，例如：

/help weechat.look.highlight

当WeeChat结束时，所有的设置都被保存（或者使用/save命令强制执行选项的写入）。

3. 核心 vs 插件

WeeChat “核心” 仅用于在屏幕上显示数据并与用户交互，这意味着没有插件的WeeChat核心是无用的。（忠实的用户：IRC是核心为≤0.2.6，虽然只是版本的一部分）
所有的网络协议，比如IRC，都是在独立的插件中提供的。
使用/plugin命令来列出加载的插件，你应该可以看到列表中的 “irc” 和其他插件。

4. 添加一个IRC服务器

你可以使用/server命令添加IRC服务器，例如：

/server add freenode chat.freenode.net

如果想不起来怎么使用，请使用帮助：

/help server

5. 设置自定义的IRC服务器选项

WeeChat使用所有服务器的默认值（“后置方式”），如果你不为服务器选项指定一个特定的值。这些默认设定为 “irc.server_default.*”。
如果有服务器选项被定义（不为空），则使用它，否则，WeeChat使用默认值（”irc.server_default.xxx”）。
例如，存在默认的nicks（基于你的 un*x 登录），你可以用下面的命令来覆盖freenode服务器用的设定：

/set irc.server.freenode.nicks "mynick,mynick2,mynick3,mynick4,mynick5"

设置用户和真实姓名：

/set irc.server.freenode.username "My user name"/set irc.server.freenode.realname "My real name"

在启动时启用自动连接到服务器：

/set irc.server.freenode.autoconnect on

使用SSL连接：

/set irc.server.freenode.addresses "chat.freenode.net/7000"/set irc.server.freenode.ssl on

如果在服务器上可以使用SASL，你可以用它进行认证（在加入通道前就会被识别出来）

/set irc.server.freenode.sasl_username "mynick"/set irc.server.freenode.sasl_password "xxxxxxx"

要在连接到服务器后运行命令，使用nickserv进行身份验证(如果你不使用SASL进行身份验证的话)：

/set irc.server.freenode.command "/msg nickserv identify xxxxxxx"

选项命令中的许多命令可以被分号；分隔。
如果你想在配置文件中保护你的密码，你可以使用安全数据。
首先设置一个密码：

/secure passphrase this is my secret passphrase

然后使用freenode密码添加安全数据：

/secure set freenode_password xxxxxxx

然后，您可以使用${sec.data.freenode_password}代替在上面提到的IRC选项中的密码，例如：

/set irc.server.freenode.sasl_password "${sec.data.freenode_password}"

在连接到服务器时自动连接一些频道：

/set irc.server.freenode.autojoin "#channel1,#channel2"

你可以使用Tab键和Shift+Tab来完成部分补全的名称和值（对于长单词，比如选项的名称）。
删除服务器选项的值，并使用默认值。 例如使用默认的nicks（irc.server_default.nicks）：

/set irc.server.freenode.nicks null

其他选项：你可以使用以下命令设置其他选项(“xxx”是选项名)：

/set irc.server.freenode.xxx value

6. 连接到IRC服务器和自动加入频道

/connect freenode

此命令可用于创建和连接新服务器，而无需使用/server命令（ 输入指令/help connect查看帮助）
默认情况下, 服务器缓冲区与WeeChat 核心 缓冲区合并。要在核心缓冲区和服务器缓冲区之间切换, 可以使用 Ctrl+x。
可以禁用服务器缓冲区的自动合并，以拥有独立的服务器缓冲区：

/set irc.look.server_buffer independent

7. 参加频道 / 退出

加入一个频道：

/join #channel

部分通道（保持缓冲区开放）：

/part [quit message]

关闭服务器、通道或私有缓冲区（/close等同于/buffer close）：

/close

当从服务器断开时，所有的通道和私有缓冲器被关闭。
通过在服务器缓冲器中执行，断开服务器

/disconnect

8. IRC私人信息

打开一个缓冲区并向另一个用户发送消息（nick foo）

/query foo this is a message

关闭私有缓存区

/close

9. 缓冲区 / 窗口管理

缓冲区是与插件相关的一个部件，包括号码、类别和姓名。缓冲区包含屏幕上显示的数据。
窗口是用来显示缓冲区的。默认情况下，一个窗口只显示一个缓冲区。如果你分屏，可以看到与多个窗口相关联的缓冲区。
用于管理缓冲区和窗口的指令：

/buffer/window

例如，将屏幕垂直分割为一个小窗口（1/3宽度）和一个大窗口（2/3），使用命令：

/window splitv 33

删除分割：

/window merge

10. 按键设置

weechat默认设定有很多快捷键。这些在文档中被记载，有几个重要的快捷键：
- Alt+← / Alt+→ or F5 / F6：switch to previous/next buffer
- F7 / F8：switch to previous/next window (when screen is split)
- F9 / F10：滚动标题栏
- F11 / F12：滚动nicklist
- Tab：在输入栏里进行与shell相同的文本补充
- PgUp / PgDn：在当前缓冲区中滚动文本
- Alt+a：移动到活动缓冲区（在hotlist中）
根据你的键盘或你的需要，可以通过/key命令来改变快捷键的分配。 A useful key is Alt+k to find key codes。
例如，to bind Alt+! to command/bufferclose：

/key bind (press alt-k) (press alt-!) /buffer close

你会有一个命令行：

/key bind meta-! /buffer close

解除键分配的情况：

/key unbind meta-!

11. 插件 / 脚本

在一些像Debian一样的发行版上，插件可以通过一个单独的包（如weechat-plugins）来获得。当发现插件时，插件会自动加载（请查看有关加载 / 卸载插件或脚本的WeeChat文档）。
许多外部脚本（来自贡献者）可以用于WeeChat，您可以使用/script命令从存储库下载和安装脚本，例如：

/script install go.py

使用/help script 查看更多信息
如果你要参照脚本列表，请从WeeChat来执行/script命令或者访问：https://weechat.org/scripts

12. 更多文档

现在，你可以使用WeeChat并阅读FAQ文档，以了解其他问题：https://weechat.org/doc
享受使用WeeChat！