dsh-calorie 0.2.5 → 0.2.7

package/dist/settings.d.ts

@@ -1,16 +1,46 @@
-/** dsh-calorie 设置页（P10 脚手架：设置页住单品包）。
+/** dsh-calorie 设置页元数据（#676：从只读脚手架换成真配置页）。
  *
- * 一次 registerTab，两处呈现：边栏 + 号菜单多一项，DSH 设置页侧边卡片
- * 分区自动多一张小卡片（注册表驱动、无硬编码，开关缺省启用）。
- * 本文件只声明本单品自己的设置行；总管不声明设置（见 boundaries 断言）。
+ * 本文件是**设置页的行表**：一个可配置项一行，写清它在配置文件里的键、中文标题、
+ * 分级（常用 / 高级）、控件种类与人话指引。它是页面渲染的唯一依据。
+ *
+ * **本文件必须零 node 依赖**：`tsconfig.client.json` 把它收进 client 侧编译，
+ * 浏览器产物不许带 node 内建。默认值不住这里，也不从技能包 import——
+ * 取值一律由宿主经技能 CLI 的 `calorie.config.read` 端点现取（见 bridge.ts）。
+ *
+ * 口径：
+ *   · 配置表形状（键与默认值）的**唯一定义地**是技能侧 `packages/skill-calorie/src/config.ts`
+ *     的 `CALORIE_CONFIG_DEFAULTS`（本文件是它在页面上的投影，逐键对齐由
+ *     `test/config-surface-676.test.mjs` 用源码文本锁死）；
+ *   · **空串＝按默认落点**（老落点由技能各取用处算）。所以「空」不是「没配」，
+ *     而是「还走改造前那个位置」，老数据不会看起来丢了——行文案按这个语义写。
  */
 export declare const SETTINGS_OWNER: "dsh-calorie";
 export declare const SETTINGS_SLOT: "ilife:calorie";
-export interface SettingRow {
+/** 配置文件主体名：落点 `~/.ilife/calorie.yaml`（`ILIFE_CONFIG_DIR` 可整体接管）。 */
+export declare const CONFIG_STEM: "calorie";
+/** 分级：常用项直接画在页面上，其余进默认收起的「高级」组（#675 冻结口径）。 */
+export type ConfigTier = 'common' | 'advanced';
+/** 控件种类：只有这三种（与受限 YAML 子集的字符串／数字／布尔一一对应，没有数组）。 */
+export type ConfigControl = 'text' | 'number' | 'switch';
+export interface ConfigItem {
+    /** 配置文件里的键路径，一层嵌套用 `.` 连接，例 `xunji.stateDir`。 */
     readonly key: string;
+    /** 页面上那一行的中文标题。 */
     readonly title: string;
-    readonly control: 'switch' | 'text' | 'number';
+    readonly tier: ConfigTier;
+    readonly control: ConfigControl;
+    /** 一行人话：这一项管什么、留空会怎样。 */
+    readonly hint: string;
 }
-/** 脚手架期唯一设置行：总开关（缺省启用，与官方关闭语义对齐）。 */
-export declare const SETTING_ROWS: readonly SettingRow[];
+/** 设置页的行表，顺序即页面顺序。 */
+export declare const CONFIG_ITEMS: readonly ConfigItem[];
+/** 常用项行数（页面上直接画出来的那些）。 */
+export declare const COMMON_ITEM_COUNT: number;
+/** 高级组标题与副文案。 */
+export declare const ADVANCED_GROUP_TITLE: "\u9AD8\u7EA7";
+export declare const ADVANCED_GROUP_NOTE: "\u4E0D\u5E38\u6539\u3002\u7559\u7A7A\uFF1D\u6309\u9ED8\u8BA4\u843D\u70B9\uFF08\u6539\u9020\u524D\u90A3\u4E2A\u4F4D\u7F6E\uFF09\uFF0C\u4E0D\u786E\u5B9A\u5C31\u522B\u52A8\u3002";
+/** 按 `a.b` 路径从配置取值里读（缺层或类型不符一律回 undefined）。 */
+export declare function readPath(values: Record<string, unknown>, key: string): unknown;
+/** 按 `a.b` 路径把值写进配置取值（中间层缺就建一层空组；已存在非组即覆盖成组）。 */
+export declare function writePath(values: Record<string, unknown>, key: string, value: unknown): void;
 //# sourceMappingURL=settings.d.ts.map

package/dist/settings.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"settings.d.ts","sourceRoot":"","sources":["../src/settings.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,eAAO,MAAM,cAAc,EAAG,aAAsB,CAAC;AACrD,eAAO,MAAM,aAAa,EAAG,eAAwB,CAAC;AAEtD,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,OAAO,EAAE,QAAQ,GAAG,MAAM,GAAG,QAAQ,CAAC;CAChD;AAED,qCAAqC;AACrC,eAAO,MAAM,YAAY,EAAE,SAAS,UAAU,EAE7C,CAAC"}
+{"version":3,"file":"settings.d.ts","sourceRoot":"","sources":["../src/settings.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AACH,eAAO,MAAM,cAAc,EAAG,aAAsB,CAAC;AACrD,eAAO,MAAM,aAAa,EAAG,eAAwB,CAAC;AAEtD,oEAAoE;AACpE,eAAO,MAAM,WAAW,EAAG,SAAkB,CAAC;AAE9C,8CAA8C;AAC9C,MAAM,MAAM,UAAU,GAAG,QAAQ,GAAG,UAAU,CAAC;AAE/C,kDAAkD;AAClD,MAAM,MAAM,aAAa,GAAG,MAAM,GAAG,QAAQ,GAAG,QAAQ,CAAC;AAEzD,MAAM,WAAW,UAAU;IACzB,iDAAiD;IACjD,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,mBAAmB;IACnB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAC;IAC1B,QAAQ,CAAC,OAAO,EAAE,aAAa,CAAC;IAChC,yBAAyB;IACzB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB;AAqGD,sBAAsB;AACtB,eAAO,MAAM,YAAY,EAAE,SAAS,UAAU,EAA6B,CAAC;AAE5E,0BAA0B;AAC1B,eAAO,MAAM,iBAAiB,QAAgB,CAAC;AAE/C,iBAAiB;AACjB,eAAO,MAAM,oBAAoB,EAAG,cAAa,CAAC;AAClD,eAAO,MAAM,mBAAmB,EAAG,gLAAwC,CAAC;AAE5E,+CAA+C;AAC/C,wBAAgB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAQ9E;AAED,iDAAiD;AACjD,wBAAgB,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,IAAI,CAU5F"}

package/dist/settings.js

@@ -1,13 +1,149 @@
-/** dsh-calorie 设置页（P10 脚手架：设置页住单品包）。
+/** dsh-calorie 设置页元数据（#676：从只读脚手架换成真配置页）。
  *
- * 一次 registerTab，两处呈现：边栏 + 号菜单多一项，DSH 设置页侧边卡片
- * 分区自动多一张小卡片（注册表驱动、无硬编码，开关缺省启用）。
- * 本文件只声明本单品自己的设置行；总管不声明设置（见 boundaries 断言）。
+ * 本文件是**设置页的行表**：一个可配置项一行，写清它在配置文件里的键、中文标题、
+ * 分级（常用 / 高级）、控件种类与人话指引。它是页面渲染的唯一依据。
+ *
+ * **本文件必须零 node 依赖**：`tsconfig.client.json` 把它收进 client 侧编译，
+ * 浏览器产物不许带 node 内建。默认值不住这里，也不从技能包 import——
+ * 取值一律由宿主经技能 CLI 的 `calorie.config.read` 端点现取（见 bridge.ts）。
+ *
+ * 口径：
+ *   · 配置表形状（键与默认值）的**唯一定义地**是技能侧 `packages/skill-calorie/src/config.ts`
+ *     的 `CALORIE_CONFIG_DEFAULTS`（本文件是它在页面上的投影，逐键对齐由
+ *     `test/config-surface-676.test.mjs` 用源码文本锁死）；
+ *   · **空串＝按默认落点**（老落点由技能各取用处算）。所以「空」不是「没配」，
+ *     而是「还走改造前那个位置」，老数据不会看起来丢了——行文案按这个语义写。
  */
 export const SETTINGS_OWNER = 'dsh-calorie';
 export const SETTINGS_SLOT = 'ilife:calorie';
-/** 脚手架期唯一设置行：总开关（缺省启用，与官方关闭语义对齐）。 */
-export const SETTING_ROWS = [
-    { key: 'enabled', title: '卡路里面板启用', control: 'switch' },
+/** 配置文件主体名：落点 `~/.ilife/calorie.yaml`（`ILIFE_CONFIG_DIR` 可整体接管）。 */
+export const CONFIG_STEM = 'calorie';
+/** 常用项：用户裁决三点的五项——改了就影响「库与产物落在哪、训记认不认你」，放页面上。 */
+const COMMON = [
+    {
+        key: 'db.dir',
+        title: '数据目录',
+        tier: 'common',
+        control: 'text',
+        hint: '库文件与各类产物的根目录。留空＝按默认落点（配置目录下的 data/），也就是改造前那个位置。',
+    },
+    {
+        key: 'db.name',
+        title: '库文件名',
+        tier: 'common',
+        control: 'text',
+        hint: '数据目录下的数据库文件名。改它等于换一个库，老数据留在旧文件里不会跟过来。',
+    },
+    {
+        key: 'html.dir',
+        title: 'HTML 产物目录名',
+        tier: 'common',
+        control: 'text',
+        hint: '数据目录下放交付页面的子目录名。改它之后新页面落新地方，旧页面留在原处。',
+    },
+    {
+        key: 'photos.dir',
+        title: '照片目录',
+        tier: 'common',
+        control: 'text',
+        hint: '身材照的存放目录，绝对路径。留空＝未配：读照片不报错，出 GIF 与写照片会被拦下。',
+    },
+    {
+        key: 'xunji.key',
+        title: '训记 KEY',
+        tier: 'common',
+        control: 'text',
+        hint: '训记用的凭据。留空＝没配，推送与回写会被拦下；它同时是敏感值，别贴给别人。',
+    },
+];
+/** 高级项：默认收起（13 项减常用 5 项＝8 项）。改错了多半只是自己撞上麻烦，不确定就别动。 */
+const ADVANCED = [
+    {
+        key: 'photos.gifs',
+        title: '照片 GIF 子目录',
+        tier: 'advanced',
+        control: 'text',
+        hint: '照片目录下放 GIF 的子目录名。',
+    },
+    {
+        key: 'xunji.stateDir',
+        title: '训记状态文件目录',
+        tier: 'advanced',
+        control: 'text',
+        hint: '限频记账点与同步游标放哪。留空＝家目录下的 .mavis，也就是改造前那个位置。',
+    },
+    {
+        key: 'xunji.catalog',
+        title: '训记动作库路径',
+        tier: 'advanced',
+        control: 'text',
+        hint: '动作名判定用哪份库。留空＝用包内预置的那份，也就是改造前那个位置。',
+    },
+    {
+        key: 'xunji.backfillDays',
+        title: '回写默认天数',
+        tier: 'advanced',
+        control: 'number',
+        hint: '从训记拉实绩时不带天数参数时的窗口，整数天。',
+    },
+    {
+        key: 'land.scheduleCli',
+        title: '跨技能出口 · 作息',
+        tier: 'advanced',
+        control: 'text',
+        hint: '「落地训练」调作息那一步的入口文件。留空＝按包布局算（改造前那个位置）。',
+    },
+    {
+        key: 'land.memoCli',
+        title: '跨技能出口 · 备忘',
+        tier: 'advanced',
+        control: 'text',
+        hint: '「落地训练」调备忘那一步的入口文件，同上。',
+    },
+    {
+        key: 'land.xunjiSeconds',
+        title: '训记调用限时（秒）',
+        tier: 'advanced',
+        control: 'number',
+        hint: '外部调训记超过这个秒数即 exit 4。机器慢就调大。',
+    },
+    {
+        key: 'land.landSeconds',
+        title: '落地调用限时（秒）',
+        tier: 'advanced',
+        control: 'number',
+        hint: '落地训练那几步超过这个秒数即 exit 4，同上。',
+    },
 ];
+/** 设置页的行表，顺序即页面顺序。 */
+export const CONFIG_ITEMS = [...COMMON, ...ADVANCED];
+/** 常用项行数（页面上直接画出来的那些）。 */
+export const COMMON_ITEM_COUNT = COMMON.length;
+/** 高级组标题与副文案。 */
+export const ADVANCED_GROUP_TITLE = '高级';
+export const ADVANCED_GROUP_NOTE = '不常改。留空＝按默认落点（改造前那个位置），不确定就别动。';
+/** 按 `a.b` 路径从配置取值里读（缺层或类型不符一律回 undefined）。 */
+export function readPath(values, key) {
+    const parts = key.split('.');
+    let cur = values;
+    for (const part of parts) {
+        if (typeof cur !== 'object' || cur === null || Array.isArray(cur))
+            return undefined;
+        cur = cur[part];
+    }
+    return cur;
+}
+/** 按 `a.b` 路径把值写进配置取值（中间层缺就建一层空组；已存在非组即覆盖成组）。 */
+export function writePath(values, key, value) {
+    const parts = key.split('.');
+    let cur = values;
+    for (let i = 0; i < parts.length - 1; i++) {
+        const part = parts[i];
+        const next = cur[part];
+        if (typeof next !== 'object' || next === null || Array.isArray(next))
+            cur[part] = {};
+        cur = cur[part];
+    }
+    cur[parts[parts.length - 1]] = value;
+}
 //# sourceMappingURL=settings.js.map

package/dist/settings.js.map

@@ -1 +1 @@
-{"version":3,"file":"settings.js","sourceRoot":"","sources":["../src/settings.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,MAAM,CAAC,MAAM,cAAc,GAAG,aAAsB,CAAC;AACrD,MAAM,CAAC,MAAM,aAAa,GAAG,eAAwB,CAAC;AAQtD,qCAAqC;AACrC,MAAM,CAAC,MAAM,YAAY,GAA0B;IACjD,EAAE,GAAG,EAAE,SAAS,EAAE,KAAK,EAAE,SAAS,EAAE,OAAO,EAAE,QAAQ,EAAE;CACxD,CAAC"}
+{"version":3,"file":"settings.js","sourceRoot":"","sources":["../src/settings.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-calorie",
-  "version": "0.2.5",
+  "version": "0.2.7",
   "description": "爱生活单品插件 P10 脚手架：卡路里（ilife:calorie order 75），硬依赖总管 dsh-life-pack",
   "type": "module",
   "main": "./dist/index.js",
@@ -25,8 +25,8 @@
     "node": ">=22.13"
   },
   "dependencies": {
-    "dsh-life-pack": "^0.2.0",
-    "skill-calorie": "0.2.4"
+    "dsh-life-pack": "^0.2.6",
+    "skill-calorie": "0.2.6"
   },
   "dsh": {
     "bundle": {