# 常见问题 ## 自行编译后梁子或水草不显示 源码构建请使用 `pnpm run build`,该命令既编译代码,也把四张图片复制到`lib`。 只运行编译器不等于完成构建。检查`lib/main-nan.webp`、`lib/main-grass.webp`、 `lib/main-fish.webp`和`lib/market-whale.webp`是否齐全,并确认运行的是刚构建的安装副本。 2.0.1修复候选补充编译后从源码目录读取这些固定图片的兜底;正常npm包仍优先使用包内资源。 这是一个已复现的构建缺图情形,不能仅凭破图截图认定为Windows系统问题。 可在DSH“添加插件”中使用`dsh-liangxiang@2.0.0`,与当前公开的完整安装包做对照。 不要为排查图片删除个人Profile、身份或账本。 ## 在线模式一直连不上 1. 检查网络连接。 2. 仍无法连接时,按[代理设置](INSTALL.md#在线连接与代理)启用 TUN,或在 DSH 主目录 `.env` 配置 HTTP 代理,保存后完全退出并重启 DSH。 3. 连接恢复后插件会自动重连;不需要反复切模式、重装或清空账本。 “今日梁案(本地)”表示显式选择了离线玩法;“无法连接天庭”表示在线服务暂不可用。 网络故障不会自动切到离线。两种模式分别记账,不合并香火或档案。 管理员可分别检查公开健康端点与后端日志,区分外网路径、服务状态和身份故障; 仅服务器本机回环请求成功,不能证明用户能访问。不要通过关闭认证、扩大后端监听或放宽保护来排障。 ## 找不到插件市场 / 搜不到插件 直接打开 **插件 → 添加插件**,输入完整包名 **`dsh-liangxiang`** 后安装;不要用简称搜索。 此流程无需开启自定义市场或添加索引。已有市场入口时,同样使用完整包名。 步骤见 [`INSTALL.md`](INSTALL.md#desktop应用内安装) 与 [官网安装指南](https://liang.today/guide/#desktop)。 不要求另装旧 `dshmarket`。第三方市场应使用明确兼容当前 DSH 的版本,不能靠重装梁相修复市场自身的接口错误。 ## Desktop 安装后没有入口 确认安装在当前 Desktop 的 **插件 → 已安装** 中且已启用,按应用提示刷新或重启。 Desktop 的 `desktop` Profile 独占;普通 CLI 的 `web` 安装不会进入桌面应用。 不要用手动改 `DSH_HOME` 的旧办法混写 Desktop 数据。 命令行用户应确认安装与启动使用同一个 Profile。页面边缘出现“今日梁相”即加载成功。 ## 升级后仍是旧版本 在 **梁相案牍 → 当前版本** 核对。Desktop 用户在 **插件 → 已安装** 卸载梁相,再重新安装新版;保留 DSH 数据目录。 Cmd / Web 退出后执行: ```bash npx --yes @deepseek-ai/dsh plugin --profile web add dsh-liangxiang@latest npx --yes @deepseek-ai/dsh web ``` 普通卸载不删除香火账本。候选源码不是 npm `latest`,不要用开发候选号判断正式市场是否滞后。 如果服务刚重启而旧页面加载失败,先重新加载页面并按 DSH 提示完成认证,不必删除数据。 ## 日终上香点不动 / 没有执行 正常状态显示 **已开启 / 已关闭**,保存时显示 **保存中…**;**暂不可用**表示 Host 设置或连接尚未就绪。 点击整格切换;右键夯/拉只保存默认方向,不投票,也不自动开启开关。悬停可看时刻、方向与运行条件。 DSH Host 必须运行;浏览器可以关闭。在线采用服务端业务时区的 23:59,临近收盘停止新尝试。 手动上香优先,剩余香火、服务端限额、睡眠或断网都可能影响实际数量;不承诺清空余额,也不跨日补投昨天。 实现边界见 [`DAY_END_INCENSE.md`](DAY_END_INCENSE.md)。 ## 香火不增加 / 记账不可用 - 默认 50,000 Pro 当量一炷;Pro 路由 ×1,Flash、其他与未知 ×0.5,见 [`INCENSE_POLICY.md`](INCENSE_POLICY.md)。 - 仅结算实际最终用量;对话未产生足够用量时,进度增长但尚未凝香是正常行为。 - 在线以服务器业务日为准,改浏览器时钟不能解决日切问题。 - “记账不可用”需检查 DSH 版本、用量接口与 Host 日志;当前兼容触点见 [`COMPATIBILITY.md`](COMPATIBILITY.md)。 - 显示异常时可用 **梁相案牍 → 显示异常? → 核对香火**,它会丢弃未确认的本地观察后重读服务端,需确认。 ## 梁位没变化 / 打梁失败 零票显示 `--`;有票的梁位来自同版权威快照,自己的成功投票会立即更新。 香火不足、旧梁案、限流、网络或身份故障都可能拒绝操作,先看界面反馈。 客户端网络重试复用同一 request ID,避免重复扣香;不要手工改 ID 重放已成功的请求。 ## 本地包安装报 404 / 找不到 dsh 相对 tarball 路径加 `./`,否则可能被当成 npm 包名: ```bash npx --yes @deepseek-ai/dsh plugin --profile web add ./dsh-liangxiang-1.2.0.tgz ``` 无需全局命令,`npx --yes @deepseek-ai/dsh` 可代替 `dsh`。Desktop 用户使用应用内安装。 ## 开发 Profile 或会话缓存报错 先核对当前支持的 DSH 版本与 [`COMPATIBILITY.md`](COMPATIBILITY.md),升级隔离开发 Profile 后重启。 DSH 的会话投影缓存是衍生数据,不能通过删除权威会话日志或梁相账本来“修复”。 重复安装内置 Web App 依赖可能破坏 DSH 模块实例;用 `scripts/assert-profile-modules.mjs` 诊断, 保留 bundles 声明,按开发安装脚本恢复正确模块图。`dev:repair-cache` 只提供无损说明,不搬走会话或账本。 ## 提交问题时提供什么 提供系统、DSH/梁相版本、复现步骤和脱敏错误。Host 诊断日志为 `$DSH_HOME/logs/liangxiang.log`; 不要公开完整日志、API key、签名、安装身份、会话内容或本机个人目录。生产运维另见 [`121-vps-deploy.md`](121-vps-deploy.md)。