nx-sk 0.30.0 → 0.31.0

package/CHANGELOG.md

@@ -2,6 +2,34 @@
 
 本文件格式参考 [Keep a Changelog](https://keepachangelog.com/)，中文正文。
 
+## 0.31.0 (2026-11-10)
+
+**`shortcut` 字段详情面板按参考实现 `shortcut-library` 一比一复刻（分组目录 / 表格 / ANSI 104 键 / 热力全屏 / 组合键录入同构），补齐 TOML 导入；并修复 store 首次读取不落盘导致的保存 404。**
+
+### Added
+
+- **详情面板**：侧栏分组增删改与条数、组合键/条件/说明表格与冲突标记、行悬浮联动键盘高亮与 tooltip、
+  键位悬浮/长按/双击弹层、可拖拽侧栏宽度与键盘预览高度、全屏热力键盘（缩放/平移/图例）。
+  `side/center/fullpage` 三态沿用 `peek` 外壳，默认 fullpage。
+- **组合键录入弹层**：修饰键累积、Backspace 撤销、Esc 取消、Enter 确认，支持可选激活条件。
+- **TOML 导入**：顶栏「导入」提供粘贴/文件两页，解析预览、格式说明与错误汇总；同名分组追加、新分组创建。
+- **回归测试**：store 文件不存在时首次读取即落盘、重复读取 id 稳定。
+
+### Changed
+
+- `shortcut` 字段折叠条只报组数/条数（`N 组 · M 条`），详细内容进面板。
+- 键盘预览默认高度 200px、键单位 44px，与参考实现一致；空间不足时按参考设计滚动。
+- 删除旧本地键盘图 `shortcutKeys.ts` 与 `styles.css` 中对应的面板样式。
+
+### Fixed
+
+- store 文件不存在时只在内存播种，每次请求重新生成随机 id，前端保存 PATCH 旧 id 返回 404。
+
+### 说明
+
+- 参考实现中由宿主注入的登录与保存模式设置未移植：nx-sk 没有账号体系与服务端保存模式，面板其余部分
+  与参考逐行对齐。三态窄宽下的取舍与验证边界已写入 `docs/behavior-parity.md`。
+
 ## 0.30.0 (2026-11-10)
 
 **`peek` 头部换成 Notion「打开方式」菜单（像素对照、键盘可达），补 `#/<栏目>?entry=<id>` 深链与默认视图；补齐 `#5` 遗留的列表计数与全屏空白。**

package/dist/core/store.js

@@ -207,6 +207,8 @@ export function corruptNote() {
 export function migrationNote() {
     return cacheMigrationNote;
 }
+// 首次读取时播种的并发门闩：两个请求同时发现文件不存在时，只播一次、写一次。
+let seedPromise = null;
 export async function loadStore(explicitPath) {
     const p = explicitPath || storeFile();
     try {
@@ -258,7 +260,27 @@ export async function loadStore(explicitPath) {
         cacheMtime = corrupt ? -1 : st.mtimeMs;
         return cache;
     }
-    catch {
+    catch (e) {
+        // 文件不存在：播种后**立即落盘一次**。只在内存里播种会让每个请求都重新生成
+        // 一套随机 id（`e_...`），前端拿着上一次的 id 保存就会 404（真实走查事故）。
+        if (e?.code === 'ENOENT') {
+            if (seedPromise)
+                return seedPromise;
+            seedPromise = (async () => {
+                const seeded = emptyStore(true);
+                cache = seeded;
+                cachePath = p;
+                cacheMtime = -1;
+                try {
+                    await saveStore(seeded, p);
+                }
+                catch {
+                    // 只读目录等写失败：保留内存态，至少本次进程内 id 稳定。
+                }
+                return cache ?? seeded;
+            })().finally(() => { seedPromise = null; });
+            return seedPromise;
+        }
         cache = emptyStore(true);
         cachePath = p;
         cacheMtime = -1;

package/dist/web/public/assets/{files-DMmY-Twb.js → files-NCGYp_FO.js}

@@ -1 +1 @@
-import{a as l}from"./index-CQF6tWPx.js";let n=null,o=0;const u=1500;function c(t=!1){return!t&&n&&Date.now()-o<u||(o=Date.now(),n=l("/api/files").then(e=>e).catch(e=>{throw n=null,e})),n}function d(){return n=null,c(!0)}function h(t,e){const a=Array.isArray(t)?t:[],r=(Array.isArray(e)?e:[]).filter(Boolean);if(!r.length)return a;const s=new Set(r.map(i=>i.id));return[...r,...a.filter(i=>!s.has(i.id))]}function m(t){return new Promise((e,a)=>{const r=new FileReader;r.onload=()=>e(r.result),r.onerror=()=>a(new Error("读取文件失败")),r.readAsDataURL(t)})}export{m as f,c as l,h as m,d as r};
+import{a as l}from"./index-Ct1xynLM.js";let n=null,o=0;const u=1500;function c(t=!1){return!t&&n&&Date.now()-o<u||(o=Date.now(),n=l("/api/files").then(e=>e).catch(e=>{throw n=null,e})),n}function d(){return n=null,c(!0)}function h(t,e){const a=Array.isArray(t)?t:[],r=(Array.isArray(e)?e:[]).filter(Boolean);if(!r.length)return a;const s=new Set(r.map(i=>i.id));return[...r,...a.filter(i=>!s.has(i.id))]}function m(t){return new Promise((e,a)=>{const r=new FileReader;r.onload=()=>e(r.result),r.onerror=()=>a(new Error("读取文件失败")),r.readAsDataURL(t)})}export{m as f,c as l,h as m,d as r};