# 常见问题

## 在线模式一直连不上

可能是运行 DSH 的机器无法访问社区服务器。包括福建在内的部分地区有连接不稳定反馈；
具体取决于网络、运营商和代理配置，不代表所有用户都会遇到。

1. 确认 DSH 所在机器的网络可用，必要时让 **DSH 进程**使用代理；浏览器代理不一定覆盖 Host。
2. 参考 [`INSTALL.md`](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 从已安装插件更新；没有更新按钮时卸载插件后重新安装，保留数据目录。
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.1.6.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)。