面向《星际公民》玩家社区的 Windows 舰队协作工具。当前为公开测试版。
星海舰桥把舰队、小队、临时组队房间、好友通讯、个人资料、机库整理和游戏浮层集中在一个桌面应用中。它的两项核心能力是：
- 只读监听用户主动选择的
Game.log，把稀疏的日志信号整理为可读的玩家、飞船、地点和游戏状态； - 使用独立的 Windows 透明窗口绘制游戏浮层，在不修改游戏画面的情况下展示协作信息。
非官方社区项目
星海舰桥由玩家社区独立开发，未获得 Cloud Imperium Games、Roberts Space Industries 或其关联公司的官方授权、许可、认证、认可或背书，也不代表其立场。
This is an unofficial Star Citizen fan project, not affiliated with the Cloud Imperium group of companies. Star Citizen、Squadron 42、Roberts Space Industries、Cloud Imperium 及相关名称、标志、游戏内容和知识产权归各自权利人所有。
《星际公民》官方网站：robertsspaceindustries.com
支持 Windows 10 / 11 x64。
| 下载方式 | 适合场景 |
|---|---|
| 下载在线安装器 | 推荐。安装器体积较小，会自动获取并安装最新版本。 |
| 下载完整安装包 | 适合离线安装，或需要保留完整安装文件时使用。 |
| 查看全部版本 | 查看更新说明、历史版本和 SHA-256 校验文件。 |
0.6.1 的主程序、完整安装器和在线安装器均要求可信 Windows 数字签名与时间戳。
请只从本仓库的 Releases 或 星海舰桥官网 下载，并核对
SHA256SUMS.txt、签名更新清单和 AUTHENTICODE-STATUS.json。如果 Windows 仍显示“未知发布者”，请停止安装并提交反馈。
0.6.1 官方客户端不包含来源或再分发权尚未核实的第三方舰船图片和星系地图。 缺少可用图片时会显示应用自带占位图；详见 第三方媒体说明。
安装与首次使用说明见 开始使用。如果下载或更新失败，请先查看 下载帮助。需要核验精确 Release tag、SHA-256、Windows 签名、SBOM 与构建来源时，请按 Release 核验指南 操作。
| 功能区域 | 当前提供的能力 |
|---|---|
| 舰队 | 查找、创建和切换舰队；维护基础资料、公告、联系方式、招募规则和邀请；管理成员、身份组、权限、小队、舰船资料及管理记录。 |
| 小队与组队房间 | 创建或加入小队与临时房间；使用三级玩法标签、加入方式、申请审核、房间邀请、成员状态和房间聊天组织活动。 |
| 好友与通讯 | 管理好友、好友申请和屏蔽关系；使用好友私信、舰队频道、小队频道与房间聊天；发送舰队、房间和浮层预设卡片。 |
| 个人资料 | 设置公开范围、在线状态、简介、通常游玩时间、活动节奏和游戏定位；展示由用户决定是否公开的机库概览与游戏信息。 |
| 机库与舰船 | 通过内置机库读取器整理官网机库；使用中文舰船名映射、舰船分类、图片和舰队舰船数据库查看已同步舰船。星海舰桥不会要求或保存 RSI 账号密码。 |
| 在线状态与通知 | 在登录后同步允许公开的应用在线、游戏中、暂离、隐身等状态；提供桌面通知、好友与房间提醒及事件共享开关。 |
| 游戏浮层 | 配置模块、预设、布局、事件通知、外观、动效和虚拟准星；使用全屏编辑器调整实际显示位置。 |
| 本地设置与诊断 | 配置日志路径、启动与托盘行为、通知位置、隐私、连续游玩提醒、缓存和本地事件日志；生成诊断信息供排查问题。 |
功能仍处于测试阶段。服务器、网站、游戏版本、日志格式或第三方页面变化都可能造成部分能力暂时不可用。
星海舰桥不会连接游戏进程读取内存，也不会从游戏画面中识别文字。用户需要在“账号与识别”中自动扫描或手动选择：
StarCitizen\LIVE\Game.log
受支持的处理链路如下：
用户选择 Game.log
→ 校验文件名、存在性和可读性
→ 启动时只回看日志尾部，恢复近期状态
→ 约每 100ms 从上次位置继续读取新增行
→ 把匹配到的行归一化为内部事件
→ 用证据权重、优先级和时间衰减推断当前状态
→ 更新应用界面和游戏浮层
→ 登录后仅按用户的同步、隐私和事件共享设置发布允许共享的状态
具体实现：
| 阶段 | 实现方式 |
|---|---|
| 路径校验 | 只接受存在且可读的 Game.log。游戏仍在写入时，应用使用共享读取方式打开文件。 |
| 启动恢复 | 默认只读取日志末尾最多约 2 MB、1500 行，用于恢复近期身份、服务器、飞船和地点证据，不会在每次启动时扫描整份大文件。 |
| 实时追踪 | 监听器保存上次读取位置，约每 100ms 检查一次文件长度，只处理之后追加的完整日志行；日志被截断或轮换时会重新定位。 |
| 事件解析 | 编译后的规则把原始文本归一化为身份、游戏进程、服务器分线、飞船频道或控制信号、地点证据、导航目标、量子事件等内部事件。 |
| 状态推断 | 不会因为任意一行日志就无条件覆盖状态。强证据优先于弱证据，部分状态会随时间降低可信度；导航目标本身不会直接被当作已经抵达。 |
| 展示与同步 | 推断结果首先用于本地界面和浮层。联网状态、飞船、地点和事件是否对外同步，由账号状态与用户设置共同决定。 |
完整的公开算法、事件来源、分数规则和当前边界见 Game.log 识别算法。
- 当前日志中出现的本地游戏身份；
- 游戏是否运行、服务器分线及部分网络状态；
- 飞船频道、驾驶位或控制信号对应的当前飞船；
- 地点库存、明确区域、导航目标和量子航行产生的地点证据；
- 可被可靠样本支持的部分游戏事件；
- 供舰队、小队、房间和浮层使用的本地状态摘要。
“已识别”不代表来自 CIG 的权威实时接口。舰船、地点和事件中有一部分只能通过侧面信号推断。
- 游戏更新可能随时改变日志格式，使既有规则失效；
- 某些行为不会写入日志，或只在特定地点、飞船和流程中出现；
- 日志可能延迟、缺失、重复、乱序、被截断，或者直到稍后才出现关键证据；
- 导航目标不等于实际抵达，量子途中取消、任务点缺少区域确认等情况可能产生不确定结果；
- 飞船离座不一定代表离船，多人船内部活动也可能缺少明确的离船信号；
- 低、中、高可信度是应用的经验分级，不是官方数据，也不是统计学概率；
- 历史回放只用于恢复近期上下文，不能保证还原完整游戏过程；
- 任何舰船、地点、在线状态、死亡或其他事件判断都只应作为协作参考。
请勿仅凭星海舰桥的识别结果做出涉及游戏资产、账号安全、付费交易或其他重要事项的决定。
游戏浮层不是注入到《星际公民》中的模组。星海舰桥在 Windows 桌面上创建独立的无边框透明窗口，再把应用已经拥有的状态绘制到该窗口。
| 环节 | 实现方式 |
|---|---|
| 窗口 | 独立、透明、置顶的 Windows 窗口；正常显示时不激活窗口并保持鼠标穿透，避免抢走游戏输入。 |
| 绘制 | 使用 DirectComposition 组织合成表面，使用 Direct2D 与 DirectWrite 绘制模块、文字、边框、泛光和转场。 |
| 状态 | 主应用生成显示快照，渲染线程只消费快照，不直接访问游戏进程。 |
| 布局 | 浮层编辑器与实际浮层共用布局和外观规则；模块的位置、尺寸、吸附、可见性和预设由用户保存。 |
| 控制 | 通过用户配置的全局热键开启或关闭浮层；可限制为游戏窗口位于前台时使用。 |
星海舰桥的浮层实现不会：
- 向游戏进程注入代码；
- Hook 游戏的渲染管线或游戏输入；
- 读取或修改游戏内存；
- 拦截或改写游戏网络通信；
- 修改《星际公民》客户端文件；
- 模拟操作、瞄准、移动或其他游戏行为。
这些是当前实现的技术边界，不是 CIG、RSI 或反作弊系统作出的许可、安全认证或豁免。
- 独占全屏、Windows 合成策略、显示缩放、多显示器和 HDR 可能影响浮层位置或可见性；
- 显卡驱动、Windows 更新、录屏软件及其他浮层可能产生层级冲突、闪烁、黑屏或渲染失败；
- 全局热键可能与游戏、输入法或其他软件冲突，也可能被安全软件阻止；
- 高强度泛光、动效和大量模块会增加 GPU/CPU 开销，低配置设备可能出现掉帧或延迟；
- 游戏焦点识别可能出现短暂误判，浮层有可能显示在非游戏窗口上；
- 未来的游戏、反作弊或 Windows 安全策略可能使当前实现无法继续使用。
如果出现异常，请先关闭浮层；仍有问题时完全退出星海舰桥，并在重新使用前查看最新版本说明。
Game.log识别在本地开始执行，但应用不是纯离线软件；- 登录、好友、舰队、小队、房间、消息、公开资料和允许共享的实时状态需要连接星海舰桥服务；
- 在线状态、飞船、地点、服务器分线及事件共享可以在设置中分别控制，隐身或离线模式会限制即时状态发布；
- 个人统计只有在用户明确同意后才开始记录；当前数据不应被视为官方生涯记录；
- 可选的地点代码贡献需要单独同意，提交内容用于改进代码与显示名称映射；
- 本地日志和诊断信息可能包含游戏 ID、服务器标识、地点代码、文件路径或其他个人信息；提交 Issue 前请先检查并删除不希望公开的内容；
- 应用不会要求或保存 RSI 账号密码，但内置网页功能及第三方页面仍受对应网站的账号与隐私规则约束。
请在“设置 → 同步与隐私”中确认共享范围。公开资料、舰队成员信息和聊天内容应按你愿意让对应接收者看到的程度填写。
截至本 README 所述版本，星海舰桥维护者没有取得 Cloud Imperium Games 或 Roberts Space Industries 针对本应用的书面许可、合规认证或特别豁免。
CIG/RSI 的用户协议对未获授权的第三方软件、信息收集、客户端文件修改、通信拦截等行为设有限制。星海舰桥主动避免注入、内存读取、通信拦截和客户端修改，但这只能说明当前代码的实现方式，不能推导出下列结论：
- 不能保证 CIG/RSI 当前或未来认可星海舰桥；
- 不能保证游戏、反作弊或安全软件永远不会阻止、误报或限制本应用；
- 不能保证使用本应用不会触发账号调查、限制或其他措施；
- 不能保证未来条款、技术政策或官方接口变化后，现有功能仍然可用或被允许；
- 不能把本 README、开源许可证或非注入设计理解为官方许可。
用户有责任阅读并遵守当时有效的官方规则：
- Roberts Space Industries Terms of Service
- Star Citizen End User License Agreement
- Star Citizen Fankit and Fandom FAQ
如果 CIG/RSI 的规则、反作弊要求或明确通知与本应用发生冲突，应以官方要求为准，并立即停止使用受影响的功能。本节是风险披露，不构成法律意见，也不构成对任何账号结果的保证。
星海舰桥按“现状”和“可用状态”提供，不承诺持续可用、完全准确、无错误、无中断或适合任何特定用途。用户应自行判断应用提供的信息和功能是否适合当前用途，并自行承担安装、配置、运行或无法运行本软件所产生的风险及后果。
在适用法律允许的最大范围内，作者、维护者及贡献者不对下列情况承担责任：
- 游戏内资产、进度、机会或账号访问受到的损失；
- 账号警告、限制、调查、暂停或终止；
- 日志误判、状态延迟、协作失误或基于错误信息采取的行动；
- 数据丢失、隐私泄露、设备故障、性能下降或软件冲突；
- 网络、服务器、Windows、驱动、CIG/RSI 服务或其他第三方服务变化造成的中断；
- 任何间接、附带、特殊、惩罚性或后果性损失。
用户可以随时停止使用并卸载应用。若不接受这些风险，请不要安装、运行或连接星海舰桥。
本声明不排除或限制适用法律不能排除或限制的责任，也不影响开放组件在 Apache License 2.0 下已经授予的权利。完整许可边界见 Apache License 2.0、完整应用与源码许可 与 官方二进制许可。
- 使用问题或功能建议：提交反馈
- 已知问题与处理进度：查看 Issues
- 安全问题：请按 安全说明 私下报告，不要在公开 Issue 中附带个人日志、账号信息、邮箱、令牌或其他隐私数据。
- QQ 测试群：
534268220
更多联系方式和产品说明见 星海舰桥官网。
本仓库同时承担星海舰桥的公开下载、版本说明、问题反馈和桌面客户端源码维护。
当前 Apache-2.0 开放范围包括：
- 可编译、可运行的 Windows 桌面客户端；
- 舰队、房间、好友、个人资料与机库等客户端功能；
- 游戏浮层、布局编辑、事件通知与公开外观框架；
- 只读
Game.log监听、事件解析和状态推断； - 飞船、地点、量子航行和在线状态的公开算法；
- 核心协作数据契约；
- 公开算法的回归测试与说明文档。
托管服务、生产部署配置、商业授权实现，以及“夜影”和 Verdict 等可选商业外观源码不在 Apache-2.0 开放范围内。公开客户端在没有这些私有扩展时仍可独立编译和运行。Releases 中提供的是可直接安装的完整桌面应用，其二进制分发边界见 完整应用与源码许可。
开发者可查看 参与贡献 和 Game.log 识别算法。
需要 .NET 8 SDK：
dotnet build StarBridge.sln
dotnet run --project StarBridge.Core.Tests/StarBridge.Core.Tests.csproj桌面客户端输出位于 StarBridge.Desktop/bin/Debug/net8.0-windows10.0.22621.0/。源码包不会附带来源或再分发权尚未确认的舰船图片和星系地图；缺少这些可选媒体不会阻止客户端编译。
本仓库中明确发布的开放核心源码采用 Apache License 2.0。来源未确认的数据不会因进入仓库而自动采用 Apache-2.0。产品名称、标志、应用图标、商业外观、游戏数据和第三方素材适用各自的权利边界，详见 数据来源与权利、素材与许可边界、第三方媒体说明、TRADEMARKS.md 与 THIRD-PARTY-NOTICES.md。