LlamaDSH 启动器
对llama.cpp和DeepSeek Harness集中管理，适合本地部署的同学
方便管理不同模型的不同参数配置方案，同时能够一键升级llama.cpp、node、deepseek harness；还能针对DSH的插件兼容性进行一键修复；一键安装、更新、卸载、停用插件；DSH更新频繁，旧插件容易过期，插件管理专门添加了版本豁免的实验性功能。
更多功能自行体验，本软件已成为我的后台常驻软件。另外给本地部署的同学推荐下我做的DSH上下文管理插件，128K、64K、甚至32k上下文的本地模型都能把活儿干起来！当然线上大模型api也能进行优质压缩，绝对比自带的压缩降智低很多：https://github.com/chocobo77/dsh-infinite-context
（以下是我本地的Qwen3.8 27B写的，将就看看）
功能
参数面板
llama-server 的参数按官方 help 分成通用与加载、采样控制、推测解码、服务与扩展四组，组内再按用途分小节。勾一个参数就填一行，右边一栏列出当前勾了哪些，可以按关键字过滤。
参数之间有依赖和互斥，比如推测解码的子参数要等 spec-type 不填 none 才有意义。勾了不该勾的，底部会说明原因，生成命令时也会剔掉。
参数表放在 Resources/llama_params.yml。llama.cpp 升级之后改这文件，点「重载参数配置」当场生效，不用重启程序。
命令预览
「命令预览」页显示当前会执行的完整命令：程序路径、每个参数的取值、以及你在编辑模式里追加的自定义参数（橙色显示，跟自动生成的区分开）。
命令可以复制走，拿到终端里手动跑，排查启动问题的时候好用。
方案与配置文件
一套参数存一个方案。下拉切换方案即可切换模型、参数。
配置文件：「保存到文件」写回默认路径，「另存为」导出成新文件，「从文件加载」用磁盘上的文件覆盖当前配置，「配置目录」可以改存放位置。
启动控制
右侧「运行控制」管两件事。
llama 一个启动、一个停止，启动后显示进程有没有活着。
DSH 有启动 Web、停止、重建、打开网页。启动方式有三种：编译产物（node apps/cli/lib/bin.js，最快）、源码模式（pnpm dsh，依赖齐全但慢）、npx（临时下载）。程序自己选，编译产物不在就往下退。
需要提权的时候勾「以管理员身份启动 DSH」，启动时弹 UAC。
日志与诊断
底部日志区实时显示子进程输出，带时间戳，能自动滚动、清空、打开日志目录。
出问题点「复制诊断」，会把界面上的日志、最近 40 行 error.log 和 crash.log、系统版本和运行时版本一起复制到剪贴板，粘贴出来就能看出问题在哪。
Node 环境
「运行环境」页里有一块 Node 环境。
检测会显示 node 和 pnpm 的版本、路径，判断是否满足 v24 和 pnpm 的要求。
「一键安装/更新」下载官方 v24 安装包，先验体积再验 SHA-256（取不到校验和时改用数字签名验签），静默装上，然后用 npm 装 pnpm，最后实际跑一次 pnpm --version 确认能用。
装完顺手检查 DSH 的 node_modules 有没有失效链接。
整个过程逐步写日志，超时会说明卡在哪一步。
DSH 维护
「兼容性检查/修复」扫一遍 DSH 安装：bundle 激活表、失效的补丁、死依赖声明、node_modules 里的悬空链接。pnpm 的软链存的是绝对路径，DSH 目录搬过家就会全部断掉，这是最常见的一种坏法。能自动修的当场修，改之前先备份。
「插件智能检测/修复」处理插件和 DSH 版本对不上的情况，包括 peer 依赖缺失、版本越界。
「插件管理」是单独的窗口，可以启用、停用、升级、卸载，也能装本地插件。
启动 DSH 如果报 ERR_MODULE_NOT_FOUND，程序会先重连链接再重试一次，不用手动去点兼容性修复。
监控与保护
显示 CPU、内存、显卡占用、显存占用、显卡温度，以及 llama 的 TPS、首 token 延迟、prefill 速度。
显存熔断设一个阈值（百分比或 GB），超过就自动停掉 llama，免得显存打满把系统拖死。
显存预估拆成权重、KV 缓存、计算图缓冲、固定开销四项分开算。混合架构模型（滑窗 / 线性注意力）按全注意力层数折算 KV，不会把 64 层全按线性增长去算。
托盘
关窗口默认最小化到托盘，进程不退出。双击托盘图标恢复窗口，右键菜单里能真正退出。
环境要求
- Windows 10 / 11 x64
- llama.cpp 目录，里面有 llama-server.exe
- DeepSeek Harness 源码目录，含 apps/cli
- node 24 与 pnpm，没有可以用程序里的一键安装
发布版自带运行时，从源码跑需要 .NET 8 桌面运行时。
快速开始
- 打开程序，在「运行环境」页填模型文件、llama.cpp 目录、DSH 目录
- 点「刷新状态」，看 node 和 pnpm 是否就绪，缺哪个点「一键安装/更新」
- 到「参数配置」页按需勾选，在「命令预览」页核对生成的命令
- 点「启动 Llama」，等日志里出现 listening，再启动 DSH
- 浏览器打开 http://127.0.0.1:3080
目录
- LlamaDSH_Launcher_CS：主程序，WPF
- Services：进程执行、工具链探测、兼容修复、更新、GPU 采样
- Resources/llama_params.yml：参数表
- LlamaDSH_Launcher_Linux：Linux 侧的 webui 版本，实验性质，能用但没细磨
- tests/SmokeTests：不依赖 NuGet 的冒烟测试，覆盖进程超时、大输出、验签、日志轮转
- WmiProbe：读进程命令行的小工具
常见问题
启动 DSH 报 Cannot find package '@deepseek-ai/...'
DSH 目录搬过家，pnpm 的软链还指着旧路径。点「兼容性修复」重连；新版直接点启动也行，程序会先自愈再重试。还不行就在 DSH 目录跑一次 pnpm install。
提示找不到 node 24
只认 v24 及以上。用「一键安装/更新」装，或者把 node 目录加进 PATH 后点「自动检索」。
改了参数但生成的命令没变
点「重载参数配置」。参数表是从 Resources/llama_params.yml 读的，改完不用重启。
显存不够，加载到一半就退出
把 gpu-layers 调小，或者开显存熔断留点余量。日志里的 cudaMalloc 报错基本就是这个原因。
托盘图标不见了
系统设置里把它设成常显。程序退出会清掉图标，重启后恢复。
构建
dotnet build LlamaDSH_Launcher_CS/LlamaDSH_Launcher.csproj
打安装包运行 一键封包.cmd，内部是 dotnet publish 单文件加 Inno Setup。
跑测试：
dotnet run --project tests/SmokeTests/SmokeTests.csproj
参数表
当前对齐 llama-server 0.7.0-dev build 11680。升级 llama.cpp 之后，把新版 --help 存成文件，和 llama_params.yml 逐条对一遍，具体做法写在文件开头。
许可证
MIT，见 LICENSE。改完想怎么用都行，留着版权声明就好。
