opencode-tarkov-theme

以《逃离塔科夫》为灵感的 OpenCode 终端 UI 插件：事件提示音、Scav 语音、随机状态文案、Beta 警告横幅、Altyn 桌宠和背景音乐。

非官方社区插件，与 Battlestate Games、OpenCode 官方均无关联。 移植自 dsh-theme-tarkov。

功能

功能	说明
提示音	会话完成、等待确认、失败/中断、工具调用失败时播放；工具失败每次都响，不按回合折叠
Scav 语音	内置 361 条语音；点击桌宠或 /tarkov-pet 随机播放
状态行文案	运行时把状态行换成塔科夫风台词，每完成一步换一句
Beta 横幅	首页和会话输入框上方显示 ESCAPE FROM TARKOV // OPENCODE 警示条
Altyn 桌宠	侧栏底部 ASCII Altyn；支持左键说话、右键打开设置、可选图片模式
背景音乐	从插件内 assets/music/ 循环播放，可与提示音分别调节音量
设置面板	/tarkov 打开，所有开关和音量都在这里

环境要求

• OpenCode V2（@opencode/plugin >= 2.0.0；开发时使用 2.1.2）
• 支持鼠标事件的终端（桌宠点击、右键菜单需要）
• 图片模式额外要求终端支持 Kitty / iTerm2 / Sixel 图片协议；不支持时保持关闭即可

安装

方式一：下载后手动安装（推荐）

1. 下载本仓库的 ZIP，或克隆到本地
2. 把整个目录放到 OpenCode 的全局插件目录：

~/.config/opencode/plugins/tarkov-theme/

Windows 对应：

%USERPROFILE%\.config\opencode\plugins\tarkov-theme\

3. 重启 OpenCode

OpenCode 会自动发现 plugins/ 下的插件目录，不需要修改 opencode.jsonc。

方式二：git clone

git clone https://github.com/Lannder358/opencode-tarkov-theme.git \
  ~/.config/opencode/plugins/tarkov-theme

方式三：npm（发布后可用）

opencode plugin add opencode-tarkov-theme

使用

命令

命令	作用
/tarkov	打开设置面板
/tarkov-pet	Altyn 随机说一句 Scav 语音
/tarkov-bgm	选择或停止背景音乐

也可以按 Ctrl+P 打开命令面板，搜索 “Tarkov”。

桌宠

• 左键点击：播放随机 Scav 语音
• 右键点击：打开 /tarkov 设置
• 台词会随着对话步骤随机变化

设置项

设置	说明
提示音	所有事件音效的总开关
状态行随机文案	运行时状态行的塔科夫台词
Beta 警告横幅	首页和会话页的警示条
Altyn 桌宠	侧栏桌宠开关
桌宠图片模式	使用 altyn.png 代替 ASCII；需要终端图片协议
提示音与语音音量	提示音和 Scav 语音共用的滑块
背景音乐音量	BGM 独立滑块
背景音乐	选择/停止曲目
试听提示音	分别试听四类音效

音量滑块操作：←/→ 调整 1%，Shift+←/→ 调整 5%，Enter 保存，Esc 取消。

资源目录

所有资源都在插件自己的 assets/ 下，插件目录可以直接打包分享：

assets/
├── sfx/                 # 四个提示音，替换同名文件即可
├── music/               # 背景音乐（mp3 / m4a / ogg / wav / flac）
├── pet/
│   ├── altyn.png        # 桌宠原图（图片模式）
│   └── voice/           # 361 条 Scav 语音
└── status/
    └── texts.zh.txt     # 状态行文案池，一行一句，# 开头为注释

添加或删除音乐后需要重开 OpenCode（曲目列表在启动时缓存）。

仓库默认不包含背景音乐（.gitignore 忽略 assets/music/*），避免分发受版权保护的音频。自行放入即可。

平台支持

• Windows：常驻 PowerShell + WinRT MediaPlayer 播放 m4a/mp3，无窗口、无需 ffmpeg
• macOS：使用 afplay
• Linux：自动探测 ffplay、mpv 或 cvlc，都没有时静默不播放

OGG/FLAC 在 Windows 上可能没有解码器支持，建议使用 m4a、mp3 或 wav。

与 DSH 原版的差异

原版（DSH Web UI）	本插件（OpenCode TUI）
网页 Beta 横幅	终端文本横幅
半透明动态视频背景	无（TUI 没有 DOM/视频层）
右下角 BGM 浮窗	后台循环播放 + 命令控制
可拖拽 Altyn 桌宠	侧栏 ASCII 桌宠（可选图片模式）
设置页卡片	/tarkov 对话框
状态行随机文案	挂在 prompt.footer.status

技术栈

分类	技术	用途
语言	TypeScript 5.9（strict）	全部源码与类型约束
运行时	Bun（OpenCode 内置）、Node.js API	直接执行 TS/TSX；文件、进程、路径
插件框架	OpenCode V2 Plugin API	Plugin.define、服务端 + TUI 双入口、生命周期
TUI 渲染	OpenTUI 0.6	slot 布局、文本/图片渲染、鼠标事件、主题 token
响应式 UI	SolidJS 1.9	createSignal、Show、slot 的细粒度更新
音频（Windows）	PowerShell + WinRT MediaPlayer（Media Foundation）	m4a/mp3 播放、音量、循环，无需 ffmpeg
音频（macOS）	afplay + sh 循环 + 进程组	播放与停止
音频（Linux）	ffplay / mpv / cvlc	后端探测与播放
进程通信	node:child_process + stdin/stdout	常驻播放器、base64 路径协议、进程组清理
图像处理	OpenTUI NativeImage / RGBA	PNG 解码、alpha 合成主题背景
状态与持久化	OpenCode storage + Solid store	设置持久化、跨实例同步
事件系统	OpenCode TUI event stream	完成/失败/权限/工具失败/步骤事件
交互	keymap layer、dialog、鼠标事件	slash 命令、音量滑块、桌宠左右键
工程化	tsc --noEmit、Git、GitHub Release	类型检查、版本管理、分发

代码导读

文件	职责	关键点
index.ts	服务端插件入口	只声明插件 ID；实际逻辑在 TUI 半区
tui.tsx	UI 与交互	slot 注册、事件订阅、Solid signals、keymap、dialog、鼠标
src/audio.ts	音频	跨平台后端、常驻 PowerShell、音量/循环、进程清理
src/assets.ts	资源	import.meta.url 定位、文案解析、音频扫描与缓存

项目结构

.
├── index.ts          # 服务端插件入口（空实现）
├── tui.tsx           # TUI 插件入口：音效、slot、桌宠、命令
├── src/
│   ├── assets.ts     # 资源路径、文案/语音/音乐加载
│   └── audio.ts      # 跨平台音频播放（音效 + BGM）
├── assets/           # 音效、图片、语音、文案、音乐
├── package.json
├── tsconfig.json
└── README.md

开发

npm install
npm run check   # tsc --noEmit

本地调试时，把本目录链接或复制到 ~/.config/opencode/plugins/tarkov-theme/，修改 tui.tsx 或 src/ 后 OpenCode 会热重载；修改 index.ts 后需要：

opencode service restart

版权与许可

• 代码：MIT
• 音效、Altyn 图片、Scav 语音、状态文案取自 ZHIGENGNIAO258/dsh-theme-tarkov（MIT）
• 内置音频的版权归原作者/素材权利人所有；本仓库仅用于个人学习与娱乐，请勿用于商业分发
• 《逃离塔科夫》及相关素材版权归 Battlestate Games 所有