部署指南
梁相是 DeepSeek Harness WebUI 插件。需要 Node.js 22.19+(推荐 24),以及已经能打开的 DSH。
每次改插件前,先完全退出 WebUI。 做完再启动,并强制刷新一次页面。web 若不是你的 profile,换成实际名字。
全局装过 DSH 就写 dsh;否则把下面的 dsh 整段换成 npx --yes @deepseek-ai/dsh。
当前版本 v0.8.8-beta。远程安装请写
dsh-liangxiang@beta,不要写@0.8.0。
安装
页面边缘出现「今日梁相」,即表示装好。
npm(推荐)
npx --yes @deepseek-ai/dsh plugin --profile web add dsh-liangxiang@beta
npx --yes @deepseek-ai/dsh web
已全局安装 dsh 时,把开头换成 dsh 即可。不要运行 npm i dsh-liangxiang:那只会装进当前目录的 node_modules,不会进入 DSH。不要钉死某一号。
装好后,案牍会连接社区后端 https://api.liang.today。国内 npm 慢时:npm config set registry https://registry.npmmirror.com
本地安装包
先进入包所在目录,必须写 ./文件名.tgz。少写 ./ 时,pnpm 会把文件名当成 npm 包名去拉并报 404。走 npm 请写 dsh-liangxiang@beta。子命令是 plugin add,不是 web add。
export DSH_HOME="$HOME/.dsh"
cd "$HOME/Desktop/liangxiang"
dsh plugin --profile web add ./dsh-liangxiang-0.8.8-beta.tgz
dsh web
安装包来自 Releases 或桌面分发目录。
源码
独立开发 profile,不改日常 DSH。Windows 请用 Git Bash 或 WSL。
git clone https://github.com/liang-today/dsh-liangxiang.git
cd dsh-liangxiang
pnpm install && pnpm run dev:install && pnpm run dev:web
默认地址 http://127.0.0.1:3080。
DSH Desktop
梁相不单独适配桌面客户端。Desktop 只是换了一套 DSH 家目录和自带的 dsh / pnpm。不设对的 DSH_HOME 时,命令会写进 ~/.dsh,Desktop 不读那里,看起来像「安装成功、界面没变化」。这不是插件代码故障。
先完全退出 DSH Desktop,再在 PowerShell 里:
$env:DSH_HOME = "$env:APPDATA\dsh-desktop\harness"
$env:PATH = "$env:DSH_HOME\.desktop-bin;$env:PATH"
dsh plugin --profile web add dsh-liangxiang@beta
若 dsh 不在 PATH 里,用 Desktop 安装目录里的 @deepseek-ai/dsh 启动器,不要用本机全局的 dsh 或 pnpm 11。Desktop 的 node_modules 按 pnpm 10 的 store 链接,PATH 里若是 pnpm 11 会报 ERR_PNPM_UNEXPECTED_STORE。
装完再打开 Desktop,强制刷新一次。升级、卸载同样先设 $env:DSH_HOME,再 plugin add / plugin remove。
macOS Desktop 若家目录不在 ~/.dsh,先在桌面应用的设置或文档里确认 harness 路径,再 export DSH_HOME=那个路径。
升级
先完全退出 WebUI。升级不会删除香火账本。
@beta 偶尔装不到最新,两个原因都在 pnpm,不在插件:
plugin add只把命令转给 pnpm,pnpm 会把解析到的精确号写进 profile(@beta变成0.8.5-beta);下次再add @beta就报 Already up to date。- pnpm 11 有 24 小时冷静期:发布不足一天的新版本会被跳过,退回上一个够龄版本。
解决方式:让 profile 一直跟踪浮动 beta,并把本包排除出冷静期——0.8.6 起插件启动时自动完成。已经钉死的机器先卸再装一次;想在新版本发布当天就装上,从 GitHub Release 拿 .tgz 装一次即可(启动后同样切回 @beta)。
安装和升级都写 @beta,不要钉某一号。若以前装过本地包或旧精确号,先卸再装:
export DSH_HOME="$HOME/.dsh"
npx --yes @deepseek-ai/dsh plugin --profile web remove dsh-liangxiang
npx --yes @deepseek-ai/dsh plugin --profile web add dsh-liangxiang@beta
npx --yes @deepseek-ai/dsh web
已全局安装 dsh 时,把开头换成 dsh 即可。装完强制刷新。插件启动后会把 profile 依赖改成浮动的 beta,并排除 pnpm 11 对新年份的 24 小时冷静期。若还没启动过带此逻辑的版本,也可自己在 $DSH_HOME/profiles/web/pnpm-workspace.yaml 加上:
minimumReleaseAgeExclude:
- dsh-liangxiang
然后再执行一次 add @beta。
卸载
dsh plugin --profile web remove dsh-liangxiang
源码开发:pnpm run dev:uninstall
卸载只拿走插件,不会删除 ~/.dsh/storages 里的账本,也不会清浏览器偏好。
清空本地数据
这会丢掉本机身份、离线玩法和界面偏好。社区已经收下的票仍留在服务器,不会被这条命令抹掉。
- 完全退出 WebUI。
- 删除本机账本:
rm -f ~/.dsh/storages/liangxiang.json ~/.dsh/storages/liangxiang_local.json
- 重新打开 WebUI,按打开控制台,执行:
localStorage.removeItem('liangxiang:badge-position:v2')
localStorage.removeItem('liangxiang:welcome:v2')
localStorage.removeItem('liangxiang:sound:level')
location.reload()
只想把入口拖回画面,只执行第一行即可。
香火怎么算
按 DeepSeek Harness 的 Input + Output Token 折算。默认每 50,000 Pro 当量凝成一炷。一炷可夯可拉,两边共用。
| 模型 | 权重 | 大约需要 |
|---|---|---|
| V4-Pro | ×1 | 50,000 Token |
| V4-Flash / 其他 | ×0.5 | 100,000 Token |
打开控制台
先让 DeepSeek Harness 网页处于最前,再按快捷键。打开后点 Console / 控制台,再粘贴命令。
| 系统 | Chrome / Edge | Firefox | Safari |
|---|---|---|---|
| macOS | ⌘ ⌥ J | ⌘ ⌥ K | 先打开「开发」菜单,再 ⌘ ⌥ C |
| Windows / Linux | Ctrl Shift J | Ctrl Shift K | — |
Safari 需先到「设置 → 高级」勾选「在菜单栏中显示开发菜单」。F12 在 Windows 上通常也能打开开发者工具。
排障
安装失败
报 ERR_PNPM_FETCH_404
本地包被当成了 npm 名字。先 cd 到包目录,写成 ./dsh-liangxiang-0.8.8-beta.tgz。走 npm 请写 dsh-liangxiang@beta,不要把本地文件名当成包名。
提示没有 dsh 命令
改用 npx --yes @deepseek-ai/dsh,不必先全局安装。
写成了 dsh web add …
web 是启动界面。安装用 plugin add。
npm 下不动
npm view dsh-liangxiang@beta version
能返回版本号再装。否则检查网络、代理,或改用 npmmirror。
打不开或页面是黑的
EADDRINUSE … 3080
旧的 DSH 还占着端口。先打开 http://127.0.0.1:3080/;打不开就结束旧进程再启动。
lsof -nP -iTCP:3080 -sTCP:LISTEN
端口在听,网页却是空的 / 400
多半是跑了一夜的旧进程。停掉后重新 dsh web。
源码脚本在 Windows 跑不起来
换 Git Bash 或 WSL,并确认 node、pnpm 可用。
入口不对
Desktop 里命令成功,界面没有「今日梁相」
插件装进了默认的 ~/.dsh,Desktop 读的是自己的 harness 目录。按 DSH Desktop 设 $env:DSH_HOME 后再装一次。
配置里有插件,页面没有入口
确认安装和启动用了同一个 profile、同一个系统用户。完全退出后重启,再强制刷新。
dsh --profile web --dump-config
入口被拖出画面
打开控制台,执行:
localStorage.removeItem('liangxiang:badge-position:v2')
案牍仍显示旧版本(例如 v0.8.3-beta)
profile 里钉着旧精确号或本地 .tgz。只重复 add @beta 会显示 Already up to date。按升级先 remove 再 add,两条命令都要带 export DSH_HOME="$HOME/.dsh"。然后重启并强制刷新。
连不上社区
显示「无法连接天庭」
浏览器打开 https://api.liang.today/v1/health。能看到状态但插件仍连不上时,检查代理、防火墙和系统时间。连不上不会卡住整个 WebUI,可在案牍改用离线模式。
香火与打梁
香火一直是 0
第一炷需要 50,000 Pro 当量。用量到了会自动更新,不必重装。
仍未解决时,到 插件仓库 开 Issue。写明系统、Node / DSH 版本、profile 名称和已经脱敏的错误。不要附 API key、口令或完整日志。