guanjihuan/Notes
1
1
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

update

Browse Source
This commit is contained in:
guanjihuan
2026-09-21 02:30:48 +08:00
parent a1089efd18
commit 7a3769670b
50 changed files with 3375 additions and 783 deletions
Download Patch File Download Diff File Expand all files Collapse all files

42
src/save-toast.js
View File

@@ -26,23 +26,39 @@
* 根据调用方 silent 标志 + IIFE 返回结果决定是否弹 toast。
*
* 决策矩阵：
* - silent=false + ok=true（无 STALE / NO_CHANGES 标记） → 「已保存」(success, 2500ms)
* - silent=false + reason='STALE'（无论 ok） → 「文件已切换，未保存到磁盘」(warning)
* Phase 2 audit 修复 (P1 #3)：STALE 不再等同「写盘失败」。飞行期用户切
* 走时 writeFile 已 resolve，data 可能已落 targetPath。ok=true 让关窗路径
* 能正确退出；用户视角的反馈（manual Ctrl+S silent=false）应该总是 STALE
* 提示（因为 editor 已不在 targetPath 上），文案保持中性「文件已切换，未
* 保存到磁盘」—— 如果用户想知道数据到底有没有存，去看 A 文件本身。
* - silent=false + reason='NO_CHANGES' → 「已是最新」(info, 1500ms)
* - silent=false + ok=true（无 STALE / NO_CHANGES / NO_FILE / DELEGATED 标记）
* → 「已保存」(success, 2500ms)
* - silent=false + reason='STALE' + ok=true → 「已保存」(success, 2500ms)
* - silent=false + reason='STALE' + ok=false → 「文件已切换，未保存到磁盘」(warning)
* 上述三条 STALE 行为是 Round 13 fix (M20) 与早期 Phase 2 audit 修复对比下的
* 最终方案：
* - Phase 2 audit (P1 #3)：原代码无条件 `{ok:false, reason:'STALE'}`，但
* writeFile 在 STALE 检查前已 resolve —— 数据其实已落 targetPath
* （result.ok=true）。关窗路径（onSaveRequest silent=true →
* reportSaveResult → main.js confirmDiscardIfDirty）会把 ok=false 误判
* 为「保存失败」并弹原生对话框挡住用户退出。修复：按 writeFile 实际结果
* 区分 ok=true/false 让关窗路径能正确退出。
* - Round 13 fix (M20)：扩展 Phase 2 修复到 toast 反馈侧 —— STALE+ok=true
* 「data 已落盘」弹 success（「已保存」），false 才弹 STALE 文案「让用户
* 知道没存上 + 为什么」。早期文案一律「文件已切换，未保存到磁盘」会把
* 「data 已落盘」误导成「没存」（用户去 A 目录看明明文件已更新）。
* - Phase 2 + Round 13 之所以分两步：ok 字段负责「关窗是否拦截」（程序能
* 力），toast 文案负责「用户感知」（界面语义）。两边解耦后用户既能成功退
* 出，又拿到跟实际盘面一致的反馈。
* - silent=false + reason='NO_CHANGES' → 「已是最新」(info, 1500ms)
* fix(audit 2026-08)：auto-save 静默写盘后 state.isDirty=false，用户手动
* 点保存按钮落入 !state.isDirty 早退路径，旧逻辑静默 return 让用户觉得
* 「按钮坏了 / 没保存上」—— 实际文件已最新。给一个简短 info 让点击有反馈。
* auto-save silent=true 路径不影响（silent 早退）。
* - silent=false + reason='NO_FILE' → 「没有打开文件」(info, 1500ms)
* - silent=false + reason='NO_FILE' → 「没有打开文件」(info, 1500ms)
* fix(audit Round 7 S-3)：旧版与 NO_CHANGES 共用「已是最新」文案，但语义
* 错位 ——「已是最新」暗示「有文件且未改动」，用户视角「什么都没打开，
* 按 Ctrl+S 当然没东西存」需要准确的「没有打开文件」。auto-save silent
* 路径不影响。
* - silent=false + reason='DELEGATED' → 不弹（inner 已弹过）
* audit fix (Round 8 S-1)：force_overwrite 把写盘委托给递归 inner save()，
* inner 自己已经按 silent=false 弹过「已保存」或具体错误 toast。outer 只负责
* 把 ok 透传给调用方（关窗 / save_and_open 依赖它），不能再弹第二个 toast。
* - silent=true → 啥都不弹（auto-save / 关窗 silent=true 静默场景）
* - 其它失败 reason（CONFLICT_* / FILE_NOT_FOUND / PATH_NOT_ALLOWED / SYMLINK_NOT_ALLOWED
* / WRITE_FAILED / IPC_ERROR）→ 错误 toast 已在 IIFE 各分支按 result.error 弹过，
@@ -57,6 +73,14 @@ export function decideSaveToast(silent, result, showToast) {
if (silent) return;
if (!result) return;
if (result.reason === 'STALE') {
// 决策见 JSDoc 决策矩阵。STALE 必须按 ok 分流：ok=true 走 success 让用户
// 知道「data 已落盘」；ok=false 走 warning 明确告知「data 没存上 + 为什么」。
// 不能「STALE 一律走 warning」（误导 data 已落盘的情况），也不能
// 「STALE 一律走 success」（掩盖真实失败）。
if (result.ok) {
showToast('已保存', 'success', 2500);
return;
}
showToast('文件已切换，未保存到磁盘', 'warning', 2500);
return;
}