RECOVERY.zh-CN.md - DeepSeek-Reasonix

RECOVERY.zh-CN.md

1	# 恢复与诊断（v1.20+）
2
3	Reasonix 不再提供产品化的 `reasonix-guard` 恢复壳。崩溃记录、pending 更新状态
4	和配置问题不会在下次启动时强制进入全局安全模式。
5
6	## 请使用这些命令
7
8	```text
9	reasonix doctor
10	reasonix doctor repair
11	reasonix crash report # 视构建是否包含而定
12	```
13
14	- doctor：检查配置、桌面派生状态与常见安装问题，不加载 Electron 壳。
15	- doctor repair：在用户明确选择后做安全修复。
16	- 崩溃上报仍为用户授权后发送，且不会改变下次启动模式。
17
18	## 会话无法继续发送
19
20	`transcript gate ... at message N` 中的 `N` 是模型请求中的消息索引，
21	不是用户消息编号。请保留完整错误内容用于诊断。
22
23	- 无效工具参数会根据保存的执行记录恢复。无法安全还原的调用会作为历史记录
24	交给模型；原始参数、已有结果和聊天记录保留，恢复过程不会重新执行工具。
25	- 以前轮次的本地图片缺失或损坏时，会标记不可用并继续发送文字和其余可用图片。
26	如果回答需要缺失图片，模型会收到要求补传的提示。本轮图片失败时，请补传后重试。
27	- 可选扩展提供的无效请求会被跳过；必需扩展或明确的拦截仍会暂停，并提示检查原因。
28	- 上下文整理共享五分钟生成预算，包含排队和分块处理，心跳不会延长期限。
29	摘要失败后保留最近已提交的上下文，不追加有损截断；仍无法安全发送时结束
30	当前尝试并返回可恢复错误。可使用 `/compact` 重试、缩短最新消息，或选择
31	支持更长上下文的模型。聊天原文保持可读。
32	- 保存失败时，请保留当前会话并尽可能导出备份，检查磁盘空间及写入权限。
33	未确认保存成功前，程序不会继续发起模型请求或执行工具。
34
35	这些恢复操作不要求删除聊天记录或手工修改会话文件。恢复缓存会按需重建。
36
37	## 安装布局（v1.20+）
38
39	Windows / Linux 使用版本目录：
40
41	```text
42	InstallRoot/
43	reasonix-launcher[.exe]
44	Reasonix.exe # Windows 便携/开始菜单别名
45	reasonix[-cli.exe]
46	current.json
47	versions/<version>/
48	reasonix-desktop[.exe]
49	reasonix-cli[.exe]
50	reasonix-update-helper[.exe]
51	```
52
53	薄启动器只读取 `current.json` 并启动当前 Desktop，不会自动选旧版本或进入
54	安全模式。
55
56	## 从 1.18–1.19.x 升级
57
58	若旧客户端卡在 pending update 或安全模式循环：
59
60	1. 从官方下载页获取最新签名安装包。
61	2. 直接覆盖当前安装（Windows：双击安装；macOS：替换 `Reasonix.app`）。不要先卸载：
62	保留原安装根目录，兼容迁移程序才能证明遗留事务属于哪个安装。
63	3. 启动 Reasonix 一次，确认“设置 > 更新”显示的版本正确，再尝试下一次应用内更新。
64	4. 兼容载荷中可能仍带有名为 `reasonix-guard` 的一次性迁移程序，它只把旧平铺
65	布局写成 `current.json` 后自删除，并非旧 Guard 产品。
66
67	正式恢复路径不要求手工删除 `pending-update.json`、锁文件或 AppData。
68
69	## 应用内更新卡住
70
71	若「设置 → 更新」或顶部横幅提示上次更新尚未完成（含 `pending update already exists`、
72	`awaiting startup health`、`handoff backup` 等错误）：
73
74	1. 在横幅或设置里点「放弃上次更新」，再点「重试」。
75	2. 若没有该按钮或操作失败：完全退出 Reasonix 后重新启动一次（让启动路径提交或清理试用事务），再试应用内更新。
76	3. 若仍失败：从官方下载页获取最新签名安装包，直接覆盖安装当前版本，不要先卸载。
77	4. macOS 还需在「系统设置 → 隐私与安全性 → App 管理」中允许 Reasonix；若
78	`Reasonix.app.reasonix-update-backup` 因 TCC 无法删除，请改走官方安装包覆盖路径。
79
80	如果 Windows 安装器显示 `Reasonix layout activation failed`，请展开安装详情并复制
81	`Reasonix layout activator output:` 下方的内容。当前安装器会保留 activator 的具体错误，
82	不再只显示 exit code 1。
83
84	## macOS
85
86	macOS 仍由 LaunchServices 直接启动 Electron App 包；更新原子替换签名 `.app`，无
87	Guard 进程。
88
89	替换后的窗口真正显示后，Reasonix 只会提交启动前捕获的精确 pending 事务。对于缺少
90	备份摘要、或备份已经丢失的旧事务，只有在确认当前运行程序确实属于目标 App 包后才会
91	自动退出该事务；仍存在但身份未知的备份和原事务会被归档保留，不会删除，也不会被当作
92	可信来源自动回滚。
93

93 lines MARKDOWN