XIVCHAT NEXT · WINDOWS 客户端

安装和使用

先安装客户端和插件

打开 下载页面，二选一：

• 安装版（推荐）：下载 XIVChatNext-win-Setup.exe 双击运行。程序只为当前用户安装到 %LOCALAPPDATA%\XIVChatNext，不需要管理员权限，会创建桌面和开始菜单快捷方式，之后可以在客户端里直接更新。安装包没有代码签名，Windows 可能弹出 SmartScreen 提示，点“更多信息 → 仍要运行”即可。卸载在“设置 → 应用”里进行，%LOCALAPPDATA%\XIVChatDesktop 中的聊天记录和配置会保留。
• 免安装版：下载 XIVChatNext-Desktop-…-win-x64.zip，解压到一个新文件夹后运行 XIVChat Desktop.exe。不要只拿出 EXE，旁边的文件和文件夹（包括 runtime）都要保留。免安装版不会自动更新。

客户端已带有所需的 .NET 和 Windows App SDK。物品、地图等网页卡片还需要 Microsoft Edge WebView2 Runtime。

在 Dalamud 设置 → 实验性功能 → 自定义插件仓库中，添加下面的地址，再安装 XIVChatNext Server：

https://raw.githubusercontent.com/AinaSnow/FFXIV-Dalamud-Plugins/main/pluginmaster.json

登录游戏角色，在插件设置中启用连接。客户端和插件请使用同一次发布的版本。

第一次连接

客户端第一次启动时，会引导你选择语言、连接方式和通知，以后可以从设置里重新打开。客户端支持简体中文、英文和跟随系统；插件新配置默认英文，语言可以单独设置。

**客户端和游戏在同一台电脑上：**地址填 127.0.0.1，默认端口填 14777。如果改过插件端口，这里也要改成一样的。

**客户端在另一台局域网电脑上：**插件 1.7.17 起，先在插件“连接”设置中开启“允许局域网设备连接”（旧版本的配置升级后自动保持开启），再填写游戏电脑的局域网地址，端口与插件一致。两台电脑需要能够互相访问。

第一次连接时，对照客户端和插件显示的设备指纹。确认一致后，在两边允许连接并保存信任。

**无法直接访问游戏电脑：**可以选择“自建中继”，粘贴你生成的邀请，再按提示核对指纹并完成配对。中继需要自己部署，具体见 中继使用说明。

以后点击左上角 Logo，就能连接上次成功使用的地址。中继连接意外断开后会自动重试；点击主动断开后停止重试。正常重启不需要重新配对，重新打开客户端也不会自动发消息或替你登录游戏。

平时怎么用

聊天可以打开为独立小窗，窗口位置可以保存并在下次恢复。主窗口和小窗使用同一段会话，断线后草稿会保留。查看其他角色的历史记录，不会切换当前发消息的角色。

点击消息里的物品或坐标可以看详情。装备对比需要游戏提供相应数据。在客户端请求截图，收到后可以预览、保存或复制。游戏和插件运行时，所有已信任的客户端都可以请求截图；插件 1.8.0 起可以在插件“消息”页关闭。

点击发送按钮左侧的笑脸可以打开“游戏符号”，主窗口和小窗都能用。选中的符号会插入到光标位置，或替换选中的文字，之后仍需要你自己发送。面板收录当前字体能显示的 165 个游戏专用字符和《》，范围参考 Lodestone 符号清单，游戏里最终怎么显示取决于游戏版本。

备注名和主播模式（客户端 1.4.0）

右键点击好友或会话可以设置备注名，最多 64 个字符，清空后恢复角色名。备注名按连接和当前角色分别保存，没聊过天的好友也能设置。它与原有的长文本备注分开保存，不会改变实际收件人。好友和会话搜索可以输入备注名或真实姓名。

主窗口顶部可以开关主播模式。在设置里选择隐藏自己、其他玩家或两者都隐藏，也能设置自己的显示名称。被隐藏的玩家使用固定化名，服务器和头像一并隐藏，化名优先于备注名。主窗口、小窗、历史、收藏、事件、通知、已知完整姓名、复制聊天和 TXT/RTF 导出使用同一规则。重启后会记住开关状态。

国服战斗记录里的“发动了”“附加效果”等角色位置也会隐藏；无法确认身份的战斗对象显示为“匿名玩家”，个别怪物名称也可能被匿名。带跨服图标的名字和服务器会一起隐藏，感情动作的发起者和目标也会处理。普通聊天里的类似句子不会被当成战斗记录。

切换隐私设置会清理本应用之前发出的通知，并取消正在进行的导出。已经复制或保存到外部的内容无法撤回。游戏截图不会自动打码，未知昵称、图片、搜索框和正在输入的文字也不会自动隐藏。本地数据库仍保留原始记录。开启时不能编辑备注名、备注或头像绑定，分享前请检查实际画面。

更新检查（客户端 1.4.1）

启动后会在后台检查 GitHub 上的公开版本。发现新版时，主窗口显示可关闭的提示，点击后进入“设置 → 更新”，可以查看更新说明或打开下载。这一页也能手动检查，或者关闭启动检查。检查只比较正式发布的客户端版本，不发送聊天或角色信息，失败也不影响聊天。安装版点“下载并更新”后才开始下载，下载完成后客户端会正常退出，并自动以新版本重新启动。免安装版则在浏览器中打开下载，客户端不会替换自己。

托盘和全局快捷键（客户端 1.5.0）

在“设置 → 窗口”中开启“关闭主窗口时保留在通知区域（托盘）”，关闭主窗口后程序继续运行。单击托盘图标显示或隐藏窗口，右键可退出；鼠标悬停可以看到未读私聊数。

开启“使用全局快捷键”（默认 Ctrl+Alt+X），点一下快捷键框再按组合键就能修改。按下后显示窗口并聚焦输入框，窗口已在最前时再按一次会隐藏。快捷键在游戏中同样生效，请避开游戏里正在使用的按键；如果已被其他程序占用，设置页会提示。两项默认关闭。

复制多条消息（客户端 1.6.2）

平时选择文字只能在一条消息内。需要跨消息复制时，打开自由复制（会话或频道标题栏的复制图标，小窗菜单里也有“自由复制”）。聊天会改为纯文本显示，每条已加载的消息一行（时间 [频道] 发送者: 内容），可以任意拖选或 Ctrl+A 全选，再按 Ctrl+C 复制。新消息在关闭自由复制后显示。开启主播模式时这里同样隐藏名字；切换主播模式会自动关闭自由复制。

导出聊天记录

可以从会话或频道标题栏右侧的导出按钮、“设置 → 历史 → 导出聊天记录…”，或者 Logo 旁边的 “XIVChat Next ▾” 菜单打开导出窗口。导出的是你当前正在看的内容：打开的会话、频道、历史搜索结果或收藏。可以按关键词和时间缩小范围，选择是否带时间，预览最后 100 行后再保存。

在保存对话框里选择格式：文本 (.txt)、Markdown (.md) 或 RTF (.rtf)。每种格式中，每条消息都是 时间 [频道] 发送者: 内容，频道按界面语言显示。通讯贝和跨界通讯贝的消息还会带上贝的名字，例如 [跨界通讯贝 [1] · 贝名]；插件 1.8.0 起会随每条消息记录贝名，更早的消息只显示频道。Markdown 会加上标题、按日期分组，并对聊天内容做转义，保证原样显示。开启主播模式时，导出内容和屏幕上一样隐藏名字，也不显示贝名。

翻译和 AI 总结（客户端 1.6.0）

可选功能，默认关闭。在“设置 → 翻译与 AI”中开启“启用翻译和 AI 总结”，选好服务后保存。不会自动发送任何内容；开启主播模式时，发送前会像导出一样隐藏名字。密钥按你的 Windows 账户加密保存，之后不会再显示；密钥框留空则保持已保存的密钥。

翻译可以选择：

在消息上右键，或选中其中的文字后右键，选择“翻译”，译文显示在原文下方，只会发送这一条消息。“翻译和总结使用的语言”选择目标语言，“跟随界面语言”则与客户端一致。“测试翻译”会用一句简短的话检查服务是否可用。

AI 总结使用 AI 服务：Claude（填写自己的 Anthropic API Key，默认模型 claude-opus-5-5），或 OpenAI 兼容服务或本机模型（以 /v1 结尾的服务地址、模型名称，需要时填写 Key；只有本机或局域网地址允许 http://，例如 Ollama 或局域网里的模型服务）。只想看总结、不想导出时，点会话或频道标题栏的“AI 总结”按钮（主菜单和小窗菜单里也有），默认范围是最近一天，可调整时间或关键词，点“生成总结”后直接在窗口里查看或复制，不会保存文件。导出窗口里的“AI 总结”按钮则总结当前导出范围。勾选“导出 Markdown 时附带 AI 总结”并保存为 .md，总结会放在文件开头，并注明可能有误。范围太大时会直接提示缩小范围，不会悄悄截断。收费服务由你自己的账号计费。

数据存在哪里

历史、收藏、备注和窗口布局都保存在运行客户端的电脑上，中继不提供云同步。

• 配置：%APPDATA%\XIVChat for Windows
• 聊天记录等数据：%LOCALAPPDATA%\XIVChatDesktop

这些目录含有聊天记录和连接信息，请不要公开上传。本设备密钥和中继凭据只能由保存它的 Windows 用户读取，直接复制到另一台电脑或另一个用户下无法使用，需要重新确认信任或重新配对。

怎么升级

安装版在“设置 → 更新”中直接更新。免安装版请先正常退出客户端，备份上面的两个目录，再把新版解压到新的文件夹，不要混用旧版 DLL。插件通过 Dalamud 更新，客户端和插件请使用同一次发布的版本。保留旧安装包，方便回退。

• 客户端 1.4.0 会把历史数据库从 v5 升到 v6，升级前自动生成 *.before-v6-*.bak 备份。不要用旧客户端打开 v6 数据库。
• 客户端 1.5.0 首次启动时会把本设备私钥改为加密保存，1.4.x 客户端读不了迁移后的配置。

回退时，把旧客户端和升级前备份的配置、数据库一起恢复。恢复备份会失去备份之后新增的本地记录，所以先另外保存一份当前数据。

收发新消息、刷新好友和获取截图，都需要游戏运行、角色在线、插件正常加载。客户端不能让角色保持在线，也不能在游戏关闭后代发消息。游戏或 Dalamud 更新后，可能需要更新插件。