nx-sk 0.3.2 → 0.3.3

package/CHANGELOG.md

@@ -4,6 +4,25 @@
 
 ## [Unreleased]
 
+## [0.3.3] - 2026-09-26
+
+### Fixed
+
+- **自定义栏目在 Web 面板整页空白**：栏目的分组元数据有两条读取路径——CLI 从字段
+  **推导**（`groupFields(fields)`），面板按**声明数组**（`section.groups`）渲染。
+  用 `section add --fields '{…"group":"basic"…}'` 建栏目而没同时给 `--groups` 时，
+  `groups` 是空数组：CLI 显示正常、面板的字段表单整组消失，而页面本身不报错，
+  看起来就像「这个栏目不存在」。
+- 修复：新增 `syncSectionGroups()` 把「分组声明 ⊇ 字段引用」钉成**栏目不变量**，
+  规则只写一份，在 `normalizeSection`（store 读写的唯一收口）与 `section add` 的
+  草稿两处调用——**存量数据读一次即自愈**，此后 `--add-field` / 面板加字段引用到
+  未声明的分组也会自动补齐声明。
+
+### Changed
+
+- CHANGELOG 中 0.3.1 那条安全说明不再复述被清除的原文（说明「清理了 PII」的句子
+  本身不该再带上那份 PII）。
+
 ## [0.3.2] - 2026-09-25
 
 ### Fixed
@@ -19,10 +38,10 @@
 
 ### Security
 
-- **清除文档与帮助文本中的真实个人信息**：`赵刘学`→`张三`、`zhaoliuxue`→`zhangsan`，
-  涉及 skill 文档示例（`assets/nx-sk/references/`）、CLI 帮助文本（`help entry`）、
-  面板 toast 提示与单测夹具；提交作者身份统一为 `nx-sk <nx-sk@local>`。
-  已用 `git filter-repo` 重写全部历史并 force-push。
+- **清除文档与帮助文本中的真实个人信息**：真实姓名与邮箱拼音样例统一替换为占位符
+  （姓名→`张三`、邮箱前缀→`zhangsan`），涉及 skill 文档示例（`assets/nx-sk/references/`）、
+  CLI 帮助文本（`help entry`）、面板 toast 提示与单测夹具；提交作者身份统一为
+  `nx-sk <nx-sk@local>`。已用 `git filter-repo` 重写全部历史并 force-push。
 - 0.3.0 因包含上述信息已在 npm 标记 deprecated（unpublish 被 granular token
   2FA 政策拦截，需官网手动删除）。
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "nx-sk",
-  "version": "0.3.2",
+  "version": "0.3.3",
   "description": "nx-sk · 本机个人资源管理器（server-cli-web 骨架）：栏目化存储个人信息与大模型密钥，CLI 与 Web 同源，敏感字段密文落盘。",
   "type": "module",
   "bin": {

package/src/core/fields.js

@@ -294,6 +294,25 @@ export function groupFields(fields) {
   return order.map((id) => ({ id, fields: map.get(id) }));
 }
 
+/**
+ * 分组声明的**唯一补全规则**：字段引用了未声明的分组 → 追加 `{ id, title: id }`。
+ *
+ * 背景（servers 栏目事故）：CLI 的分组渲染从字段**推导**（groupFields），
+ * 面板却读**声明数组**（section.groups）——`--fields` 引用了 `--groups`
+ * 没声明的分组时，两端分叉，面板整个字段表单消失而 CLI 看起来一切正常。
+ * 所以「分组声明 ⊇ 字段引用」必须是不变量，在 normalize（读写唯一收口）
+ * 和 section add 的草稿上调用同一个函数，规则就不可能有第二份。
+ */
+export function syncSectionGroups(groups, fields) {
+  const out = [...(groups || [])];
+  const declared = new Set(out.map((g) => g.id));
+  for (const f of fields || []) {
+    const gid = f.group || 'other';
+    if (!declared.has(gid)) { declared.add(gid); out.push({ id: gid, title: gid }); }
+  }
+  return out;
+}
+
 export function fieldByKey(section, key) {
   return (section?.fields || []).find((x) => x.key === key) || null;
 }

package/src/core/store.js

@@ -4,7 +4,7 @@ import fsp from 'node:fs/promises';
 import { join } from 'node:path';
 import { displayPath, snapshotDir, storeFile } from './paths.js';
 import { ensureDir, pathExists, writeAtomic, writeJsonAtomic } from './fsx.js';
-import { instantiateTemplate, seedSections } from './fields.js';
+import { instantiateTemplate, seedSections, syncSectionGroups } from './fields.js';
 import { nowIso, stamp } from './ids.js';
 
 /** v2：密钥栏目从 8 字段模板改成单字段 KV（名称 → 值）。
@@ -38,7 +38,7 @@ function emptyStore(seed) {
 
 function normalizeSection(raw) {
   if (!raw || typeof raw !== 'object' || !raw.id) return null;
-  return {
+  const out = {
     id: String(raw.id),
     title: String(raw.title || raw.id),
     description: String(raw.description || ''),
@@ -52,6 +52,11 @@ function normalizeSection(raw) {
     createdAt: raw.createdAt || null,
     updatedAt: raw.updatedAt || null,
   };
+  // 「分组声明 ⊇ 字段引用」是栏目不变量：字段引用了没声明的分组，面板的分组表单
+  // 会整组消失（真实事故：servers 栏目 groups 为空，Web 端白屏而 CLI 正常）。
+  // 放在 normalize 收口——每条读写路径都会过这里，存量数据读一次就自愈。
+  out.groups = syncSectionGroups(out.groups, out.fields);
+  return out;
 }
 
 function normalizeEntry(raw) {

package/src/modules/sections/service.js

@@ -3,7 +3,7 @@
 import { loadStore, mutateStore, snapshotStore } from '../../core/store.js';
 import { assertFieldKey, assertSafeId } from '../../core/paths.js';
 import { badInput, blocked, conflict, notFound } from '../../core/errors.js';
-import { FILL_POLICIES, FIELD_TYPES, findSection, groupFields, instantiateTemplate, sectionNames, templateSummaries } from '../../core/fields.js';
+import { FILL_POLICIES, FIELD_TYPES, findSection, groupFields, instantiateTemplate, sectionNames, syncSectionGroups, templateSummaries } from '../../core/fields.js';
 import { dumpSection, formatValue } from '../../core/render.js';
 import { sensitiveViewer } from '../../core/vault.js';
 import { nowIso } from '../../core/ids.js';
@@ -116,6 +116,9 @@ export async function addSection({ id, title, template, description, order, fiel
     const defaultGroup = draft.groups[0]?.id || 'other';
     draft.fields = fields.map((x) => validateFieldDef(x, { allowGroup: defaultGroup }));
   }
+  // 与 normalize 同一条规则：--fields 引用了 --groups 没声明的分组时自动补上，
+  // 否则面板按声明数组渲染会整组消失（CLI 从字段推导所以看不出来）。
+  draft.groups = syncSectionGroups(draft.groups, draft.fields);
   draft.createdAt = nowIso();
   draft.updatedAt = draft.createdAt;