前言¶
DeepSeek Harness (DSH) 采用插件化架构，默认的控制台界面通常较为基础。对于需要频繁查看 TRACE、JOBS 状态或管理多会话的开发者而言，缺乏可视化的交互层会增加操作成本。dsh-phosphor 提供了一个全屏的基于终端的用户界面 (TUI)，将 React 和 Ink 技术应用于 Cordis bundle 插件，解决了 DSH 交互层可视化的需求。
是什么¶
dsh-phosphor 是一个为 DeepSeek Harness 设计的全屏、矩阵风格 TUI 前端。它作为一个 Cordis bundle 插件运行，旨在为 DSH 提供沉浸式的交互体验。该项目由 yaotongsb 维护，采用 MIT 许可证。
核心功能¶
该插件主要提供以下能力：
- 全屏 TUI 界面：提供沉浸式的终端操作体验。
- 多主题支持：内置
matrix和terminal两种主题，可通过命令或配置切换。 - 侧边栏面板：支持 TRACE（追踪）、JOBS（任务）、FILES（文件）三个侧边栏面板，用于查看 Agent 状态和上下文。
- 命令系统：
/help：查看帮助。/model：模型选择器，支持输入过滤。/new：创建新会话（快捷键Ctrl+N）。/resume：会话恢复选择器。/attach <path>：为下一条消息附加图片（仅支持 png/jpeg/webp/gif）。/settings：运行时设置面板。/theme matrix|terminal：切换主题。
- 配置项：支持通过
cordis.patch.yml配置theme、matrixRain（数字雨背景）、scanlines（扫描线）、panelMode等参数。
安装与启用¶
目前该插件仅限源码分发，不支持通过 dsh plugin add github:... 命令安装。你需要将 DeepSeek Harness 的源码检出与该插件位于同一父目录。
- 准备环境：确保安装了 Node.js (>= 22.19 或 >= 24) 和 pnpm。
- 检出并构建 DSH：
git clone https://github.com/deepseek-ai/deepseek-harness.git
cd deepseek-harness && git checkout b150a551b8 && pnpm install && pnpm run build
- 检出插件：
git clone https://github.com/yaotongsb/dsh-phosphor.git
cd dsh-phosphor && pnpm install && pnpm build
- 注册插件：
从 deepseek-harness 目录运行以下命令，确保相对路径正确：
cd ../deepseek-harness
pnpm dsh plugin --profile tui add ../dsh-phosphor
典型用法¶
启动插件后，可以通过以下方式进行操作：
- 切换主题：输入
/theme matrix或/theme terminal。 - 新建会话：输入
/new或按下Ctrl+N。 - 恢复会话：输入
/resume，通过键盘选择并回车。 - 附加图片：输入
/attach <图片路径>（需配合支持视觉的模型使用）。 - 查看面板：在输入为空时，按下
Alt+T(TRACE),Alt+J(JOBS),Alt+F(FILES) 打开对应侧边栏。
适用场景与注意¶
- 源码依赖：必须手动检出 deepseek-harness 源码，插件通过相对链接解析依赖，两者需位于同一父目录。
- 版本锁定：严格锁定在
dsh v0.1.1-rc.2。升级 DSH 主程序可能会导致插件功能异常或崩溃，直到插件发布正式版本。 - 开发环境：插件在 Windows Terminal 下开发与测试，其他终端兼容性未知。
- 图像渲染：终端环境不支持渲染图片，附件仅显示占位符（
▣ name (W×H)）。 - 性能限制：非常长的会话恢复速度较慢，且插件会根据系统负载自动调整背景动画帧率。
- 归档功能：V1 版本中不支持反归档操作。
短结尾¶
dsh-phosphor 为 DSH 提供了一个可视化的交互层，适合习惯终端操作并需要丰富状态监控的开发者。由于目前处于源码分发阶段且依赖特定版本，使用前需仔细核对环境配置。
