DC Traveler CLI Cookiekira
Use this command to install DC Traveler CLI:
winget install --id=Cookiekira.DCTravelerCli -e Command-line tool for the FF14 China cross-region travel workflow.
Loading...
README
DC Traveler CLI
DC Traveler CLI 是一个用于 FF14 国服超域传送的命令行工具。它会帮助你完成登录会话获取、角色发现、目标服务器选择、提交订单和状态跟踪，但最终提交传送订单前仍需要你明确确认。
功能
- 一条命令完成常规超域传送流程。
- 支持保存登录会话，后续运行优先复用。
- 支持通过盛趣官方页面进入 WeGame 登录。
- 自动扫描可直接传送的角色，并显示可搜索的角色列表。
- 支持选择旅行中的角色：先返回原服，再刷新角色和目标数据后继续传送。
- 提供单独的返回原服命令。
- 使用方向键选择，Enter 确认；列表中可以直接输入关键词筛选。
安装
Windows 用户推荐使用 winget 安装：
winget install --id Cookiekira.DCTravelerCli -e
安装后重新打开终端，运行：
DCTravelerCli --help
如果 winget 暂未收录最新版本，或者你需要 Linux/macOS 版本，可以从 GitHub Releases 下载适合系统的压缩包：
- Windows x64:
DCTravelerCli-v1.0.1-win-x64.zip - Windows x64 AOT:
DCTravelerCli-v1.0.1-win-x64-aot.zip - Linux x64:
DCTravelerCli-v1.0.1-linux-x64.tar.gz - macOS arm64:
DCTravelerCli-v1.0.1-osx-arm64.tar.gz
解压后直接打开，或者在终端运行：
.\DCTravelerCli.exe --help
Linux 或 macOS:
chmod +x ./DCTravelerCli
./DCTravelerCli --help
注意：Linux 版本在未经实机测试，如果你在 Linux 上遇到问题，请在仓库中提交 issue 并附上你的环境和重现步骤。
快速开始
运行默认传送流程：
DCTravelerCli
使用 WeGame 登录入口：
DCTravelerCli --wegame
只刷新登录会话：
DCTravelerCli login
只返回旅行中的角色：
DCTravelerCli return
跳过 CLI 自己的提交前确认：
DCTravelerCli --yes
常用选项
--wegame 通过盛趣官方跳转页进入 WeGame 登录
--yes 跳过 CLI 提交前确认
--verbose 显示诊断细节
--keep-browser-open 流程结束后保留浏览器窗口
--browser-path 手动指定 Chromium 浏览器路径
--default-browser-profile 使用默认浏览器 profile
--profile-dir 指定专用浏览器 profile 目录
--debug-port 指定浏览器 DevTools 调试端口
--login-timeout 等待登录成功的秒数
--discovery-concurrency N 角色发现并发数，范围 1 到 16
工作方式
DC Traveler CLI 使用系统中已经安装的 Chromium 系浏览器完成登录，然后提取官网会话 cookie。登录完成后，传送流程通过 .NET HTTP 客户端调用官方接口，不依赖浏览器页面脚本或浏览器自动化。
保存的会话用于后续运行。Windows 上会话数据使用当前用户 DPAPI 保护。
注意事项与声明
- 本工具是非官方社区工具，与 Square Enix、盛趣游戏、WeGame 或最终幻想 XIV 官方没有隶属关系。
- 本工具的操作范围限于官方超域传送页面使用的流程和接口；一切角色状态、订单状态和操作结果以官方网站显示为准。
- 官方页面、登录流程或 API 发生变化时，传送或返回可能失败。遇到异常时，请优先登录官方超域传送网站手动确认和处理。
- 浏览器登录、WeGame 登录或自动登录可能会在叨鱼 App 或账号安全记录中产生新的登录记录，这是登录流程带来的正常现象。
- 本工具不会把你的账号凭据或会话上传到第三方服务器。会话数据只保存在你的本机，用于后续复用；请只在可信设备和安全网络环境下使用。
- 使用本工具即表示你理解并接受相关风险，并授权它在本机访问你的官方登录会话来完成你确认的操作。
Credits
- 接口信息来自 ottercorp/DcTraveler
许可证
本项目使用 MIT 许可证，见 LICENSE。
本地开发
需要 .NET 10 SDK。
dotnet restore DCTravelerCli.slnx --locked-mode
dotnet test DCTravelerCli.slnx
dotnet run -- --help