星际航行驾驶舱 Arukasaeled/dsh-cosmic-travel

cosmic-travel — DSH 星际航行插件

把 DeepSeek Harness（DSH）桌面端变成一艘可驾驶的星际飞船：第一人称 3D 驾驶舱、真实飞行物理、程序化生成的宇宙扇区（星系 / 星云 / 行星 / 小行星带）、以及五阶段虫洞跃迁。DSH 原生的会话、模型、对话能力全部接入驾驶舱的实体设备——操纵杆切换推理档位、左舷台切换航线、中央主控台就是 DSH 的聊天界面。

驾驶舱前向视野

虫洞跃迁

安装（一键）

前置：已安装 DSH 桌面端；本机装有 Node.js 20+（仅用于构建，DSH 运行期不需要）。

git clone https://github.com/arukas0623-ai/dsh-cosmic-travel.git
cd cosmic-travel
.\install.ps1

脚本会自动：构建 plugin.js → 探测 DSH 安装目录 → 关闭运行中的 DSH → 安装 → 提示启动。

- 指定安装目录：.\install.ps1 -DshInstall ""
- 不想自动关闭 DSH：.\install.ps1 -NoStop（复制后需自行重启 DSH）

手动安装（不想跑脚本）：

1. node tools/build-plugin.mjs 生成 plugin.js
2. 把 manifest.json + plugin.js 两个文件复制到 \resources\plugins\cosmic-travel\
3. 重启 DSH

plugin.js 构建时已内联全部纹理与音频资产（约 40MB），运行期零磁盘依赖、零第三方依赖。

卸载：.\uninstall.ps1，或直接删除 \resources\plugins\cosmic-travel\。

安装到官方 dsh web

命令行 Web profile 不读取 Electron 的 resources/plugins 目录，而是加载 npm 包声明的 Cordis 客户端入口：

dsh plugin --profile web add https://github.com/arukas0623-ai/dsh-cosmic-travel.git
dsh web

package.json 使用嵌套的 dsh.client 声明并固定 platform: "web"；Three.js、纹理和音频已内联，因此没有额外 inject 或 external。lib/client.js 必须在启动前已经构建并随 GitHub 包存在：从源码更新后先运行 node tools/build-plugin.mjs，再启动 dsh web。Web 端通过 Cordis 生命周期自动清理驾驶舱，桌面端继续使用 manifest.json + plugin.js。

操作指南

进入 / 退出

| 按键 | 动作 |
| （Tab 上方的 ·/~ 键） | 从 DSH 主界面进入驾驶舱 |
| Esc | 退出驾驶舱（回到 DSH 普通界面） |
| R | 复位驾驶员视线（转头后按 R 回正） |

飞行控制（驾驶舱内，输入框未聚焦时）

| 按键 | 动作 |
| W / S | 前进推力 / 后退 |
| A / D | 左偏航 / 右偏航 |
| Q / E | 左滚转 / 右滚转 |
| ↑ / ↓（方向键） | 机头上抬 / 下压 |
| PageUp / PageDown | 垂直上升 / 下降 |
| Shift（左或右） | 加力 Boost（长按） |
| Space | 刹车 |
| G | 触发虫洞跃迁（CHARGE → ENGAGE → 隧道 → 深空跃迁 → 跃出） |

鼠标

| 操作 | 动作 |
| 按住拖拽 | 驾驶员自由视角（观察方向，不影响航向） |
| 单击（位移 已知状态（2026-08-25）：unit-step6-scene 中 IR-VIS 阴影验收测试对应当前进行中的驾驶舱阴影/掠射光实现，在实现完成前会显示 1 个失败；不影响插件安装与运行。

- 资产再生成：node assets/tools/gen-manifest.mjs、node tools/gen-warp-assets.mjs
- 视觉 QA 截图：node tools/shot-cockpit-qa.mjs（需 DSH 开启 CDP）

目录结构

manifest.json # DSH 插件清单（entry: plugin.js） plugin.js # 构建产物（git 忽略，install 时生成） host/ # 宿主层：bootstrap、Three.js 场景、驾驶舱内饰、渲染 src/ # 无头核心：wire 协议、领域状态机、飞行积分器、音频运行时 assets/ # 美术/音频源资产 + 资产清单（构建时内联进 plugin.js） tools/ # 构建 / 测试 / QA 工具链 tests/ # node:test 单元测试 docs/ # 架构文档（STARSHIP_ARCHITECTURE.md 等） vendor/ # three.js 等内嵌依赖（构建期使用）

架构一览

三层隔离（详见 docs/STARSHIP_ARCHITECTURE.md）：

1. 无头核心（src/）：TransportClient（唯一 wire 通道）→ 事件归一化 → 纯领域状态机（reducer + event store），零 UI 依赖，全部可 headless 测试。
2. 空间层（host/）：Three.js 驾驶舱。3D 网格 → 热点 → 设备 Intent → 能力门控 → CommandAdapter → 真实 DSH。mesh 永远不直接发 RPC。
3. 资产层（assets/）：确定性种子生成的星系/星云/虫洞纹理 + 程序化音频包，构建期内联。

渲染故障自治：空间层任何异常只禁用 3D 视图，DSH 核心功能不受影响。

许可

MIT。three.js（vendor/）遵循其原始 MIT 许可。