dsh-niuma 0.1.0 → 0.2.0

package/lib/index.js

@@ -2,7 +2,8 @@
  * 牛马加速器（dsh-niuma）—— 宿主半侧。
  *
  * 职责（详见 SPEC.md §5）：
- *   1. 设置：可选注册 settings namespace（schemastery schema），把面板里的修改持久化到 DSH 设置。
+ *   1. 设置：JSON 文件持久化（$DSH_HOME/niuma/config.json，可用 NIUMA_CONFIG_PATH 覆盖）。
+ *      —— 不依赖 DSH 的 settings 服务：desktop 0.2.1-rc.2 里该服务缺席时写接口会永远 400。
  *   2. 路由：通过 ctx.webServer 暴露三条只读/写配置路由，供浏览器半侧 fetch：
  *        GET  /niuma/config    -> { ok, data: { config, defaults, holidaySource } }
  *        POST /niuma/settings  -> 校验并持久化配置（body 上限 64KB）
@@ -10,14 +11,16 @@
  *   3. 鉴权：全部走 connection.requestRejection 守卫（与 DSH 内建路由同一套 Host/Origin 围栏）。
  *
  * 可靠性约束（0.x 插件血泪教训）：
- *   - settings / schemastery 都是**可选依赖**：动态 import 失败时静默降级，
- *     插件仍以 cordis.patch.yml 的 config + core.DEFAULTS 工作，绝不拖垮 DSH 启动。
+ *   - 配置读写只用 node:fs；目录/文件权限 0700/0600，原子写（tmp + rename）。
+ *     任何读失败都退回 cordis.patch.yml 的 config + core.DEFAULTS，绝不拖垮 DSH 启动。
  *   - apply() 内任何异常只写 warn 日志，绝不向上抛。
  *   - 路由注册统一挂在 ctx.effect 上并返回 dispose，卸载时干净摘除。
  *
  * 纯业务口径（工资公式、节假日判定）全在 src/core.mjs，宿主侧只做「存取配置」。
  */
-import { readFileSync } from 'node:fs';
+import { chmodSync, mkdirSync, readFileSync, renameSync, writeFileSync } from 'node:fs';
+import { homedir } from 'node:os';
+import { dirname, join } from 'node:path';
 import { DEFAULTS, normalizeConfig, validateConfig } from '../src/core.mjs';
 import { HOLIDAY_SOURCE } from '../src/holidays.mjs';
 
@@ -35,8 +38,8 @@ export const name = 'niuma';
 
 /**
  * 依赖的宿主服务。
- * 只声明 webServer（插件唯一必需出口）；settings 是可选依赖，用 ctx.inject 探测，
- * 不写进 inject 数组 —— 否则缺 settings 的组合里插件会直接加载不起来。
+ * 只声明 webServer（插件唯一必需出口）。配置持久化走自己的 JSON 文件，
+ * 不依赖 DSH 的 settings 服务（desktop 0.2.1-rc.2 里该服务缺席 → 写接口会永远 400）。
  */
 export const inject = ['webServer'];
 
@@ -44,44 +47,19 @@ const NAMESPACE = name;
 const ROUTE_BASE = `/${NAMESPACE}`;
 /** POST /niuma/settings 的请求体上限（64KB） */
 const MAX_BODY_BYTES = 64 * 1024;
-/** 与 core.mjs 的校验口径保持一致（月薪上限） */
-const SALARY_MAX = 10_000_000;
 
-/* ------------------------------------------------------------------ *
- * 设置 schema（schemastery）：动态 import，失败降级为 null
- * ------------------------------------------------------------------ */
-
-let schemaPromise = null;
-
-/** 构造设置 schema；schemastery 不可用时返回 null（不抛错）。 */
-export async function loadConfigSchema() {
-  try {
-    const { default: z } = await import('@deepseek-ai/schemastery');
-    // 注意：schemastery 的标量没有隐式默认值，字段缺省时会被对象丢掉 → 必须逐个 .default()
-    return z.object({
-      monthlySalary: z.number().min(0).max(SALARY_MAX)
-        .default(DEFAULTS.monthlySalary)
-        .description('实收月薪（元/月，税后到手；>0，上限 10,000,000）'),
-      workStart: z.string().default(DEFAULTS.workStart).description('上班时间（HH:mm）'),
-      workEnd: z.string().default(DEFAULTS.workEnd).description('下班时间（HH:mm，必须晚于上班时间，暂不支持跨夜班）'),
-      lunchEnabled: z.boolean().default(DEFAULTS.lunchEnabled).description('是否启用午休'),
-      lunchStart: z.string().default(DEFAULTS.lunchStart).description('午休开始时间（HH:mm，启用午休时必填）'),
-      lunchEnd: z.string().default(DEFAULTS.lunchEnd).description('午休结束时间（HH:mm，必须晚于午休开始且不晚于下班）'),
-      lunchPaid: z.boolean().default(DEFAULTS.lunchPaid).description('午休是否算工时（算工时则日有效工时更长、时薪更低）'),
-      holidays: z.array(z.string()).default([...DEFAULTS.holidays])
-        .description('法定节假日（YYYY-MM-DD，一行一个）。放假日期不算工作日，日工资会相应变高'),
-      extraWorkdays: z.array(z.string()).default([...DEFAULTS.extraWorkdays])
-        .description('调休上班日（YYYY-MM-DD，一行一个）。周末补班日期算工作日'),
-    });
-  } catch {
-    return null; // 可选依赖缺失：退化为「只读默认值 + 写接口 400」
-  }
-}
-
-/** 单例 schema promise：避免每次 apply 都重新 import。 */
-function configSchema() {
-  if (!schemaPromise) schemaPromise = loadConfigSchema();
-  return schemaPromise;
+/**
+ * 配置文件的解析路径（纯函数，导出供烟测/文档）：
+ *   NIUMA_CONFIG_PATH → $DSH_HOME/niuma/config.json → ~/.dsh/niuma/config.json
+ * 只写自己目录，绝不碰 profile 的 package.json / lockfile。
+ * @param {object} [env]
+ * @returns {string}
+ */
+export function resolveConfigPath(env = process.env) {
+  const override = typeof env?.NIUMA_CONFIG_PATH === 'string' ? env.NIUMA_CONFIG_PATH.trim() : '';
+  if (override) return override;
+  const home = typeof env?.DSH_HOME === 'string' && env.DSH_HOME.trim() ? env.DSH_HOME.trim() : join(homedir(), '.dsh');
+  return join(home, 'niuma', 'config.json');
 }
 
 /* ------------------------------------------------------------------ *
@@ -182,84 +160,41 @@ export async function apply(ctx, config = {}) {
   const baseConfig = config && typeof config === 'object' && !Array.isArray(config) ? config : {};
   const mountedAt = new Date().toISOString();
 
-  // settings 服务可选：register 成功后才会有 scope / settingsService
-  let scope = null;
-  let settingsService = null;
+  /** 配置文件路径：NIUMA_CONFIG_PATH（测试/高级用户）→ $DSH_HOME/niuma/config.json → ~/.dsh/niuma/config.json。 */
+  const configPath = resolveConfigPath(process.env);
 
-  /**
-   * 当前生效配置 = core.DEFAULTS ← 组合配置 ← 用户设置（后者覆盖前者）。
-   * 永远返回补全 + 规范化后的完整配置，视图侧不用再自己 merge。
-   */
-  const currentConfig = () => {
-    let stored = {};
+  /** 读已持久化的配置；文件不存在/坏 JSON 都退回空对象（用默认值继续跑，绝不抛）。 */
+  const readStoredConfig = () => {
     try {
-      const value = scope?.get?.();
-      if (value && typeof value === 'object' && !Array.isArray(value)) stored = value;
+      const raw = readFileSync(configPath, 'utf8');
+      const parsed = JSON.parse(raw);
+      return parsed && typeof parsed === 'object' && !Array.isArray(parsed) ? parsed : {};
     } catch (error) {
-      logger?.warn?.(`niuma: settings read failed: ${error?.message ?? error}`);
+      if (error?.code !== 'ENOENT') logger?.warn?.(`niuma: settings read failed: ${error?.message ?? error}`);
+      return {};
     }
-    return normalizeConfig({ ...DEFAULTS, ...baseConfig, ...stored }).config;
   };
 
-  /** 把校验后的完整配置写回 DSH 设置；返回是否真的持久化成功。 */
-  const persistConfig = async (next) => {
-    if (scope && typeof scope.update === 'function') {
-      await scope.update(next);
-      return true;
-    }
-    if (scope && typeof scope.replace === 'function') {
-      await scope.replace(next);
-      return true;
-    }
-    if (settingsService && typeof settingsService.update === 'function') {
-      await settingsService.update(NAMESPACE, next);
-      return true;
-    }
-    return false;
-  };
+  /**
+   * 当前生效配置 = core.DEFAULTS ← 组合配置 ← 已保存的用户配置（后者覆盖前者）。
+   * 永远返回补全 + 规范化后的完整配置，视图侧不用再自己 merge。
+   */
+  const currentConfig = () => normalizeConfig({ ...DEFAULTS, ...baseConfig, ...readStoredConfig() }).config;
 
-  // ---- 设置注册：schemastery 动态 import + 失败静默降级 ----
-  const registerSettings = (settingsCtx) => {
-    configSchema()
-      .then((Schema) => {
-        if (!Schema) {
-          logger?.warn?.('niuma: schemastery unavailable, settings namespace skipped');
-          return;
-        }
-        try {
-          const registered = settingsCtx.settings?.register?.(NAMESPACE, Schema, { base: baseConfig });
-          if (!registered) return;
-          scope = registered;
-          settingsService = settingsCtx.settings ?? null;
-          try {
-            // watch 只是为了与设置页联动（当前版本没有需要失效的缓存），失败不影响主流程
-            if (typeof settingsCtx.effect === 'function') {
-              settingsCtx.effect(() => scope?.watch?.(() => {}), 'niuma: settings watch');
-            }
-          } catch (error) {
-            logger?.warn?.(`niuma: settings watch failed: ${error?.message ?? error}`);
-          }
-          logger?.info?.('niuma: settings namespace registered');
-        } catch (error) {
-          logger?.warn?.(`niuma: settings namespace unavailable: ${error?.message ?? error}`);
-        }
-      })
-      .catch((error) => {
-        logger?.warn?.(`niuma: settings schema load failed: ${error?.message ?? error}`);
-      });
+  /**
+   * 把校验后的完整配置写到自己的 JSON 文件（原子写）。
+   * 失败抛错（写接口返回 400），绝不静默吞掉。
+   */
+  const persistConfig = async (next) => {
+    const dir = dirname(configPath);
+    mkdirSync(dir, { recursive: true, mode: 0o700 });
+    const tmp = `${configPath}.tmp-${process.pid}`;
+    writeFileSync(tmp, `${JSON.stringify(next, null, 2)}\n`, { mode: 0o600 });
+    renameSync(tmp, configPath);
+    try { chmodSync(configPath, 0o600); } catch { /* 权限收紧失败不影响内容 */ }
+    return true;
   };
 
-  try {
-    if (typeof ctx.inject === 'function') {
-      ctx.inject(['settings'], registerSettings);
-    } else if (ctx.settings) {
-      // 极端情况下没有 ctx.inject（老内核/测试桩）：直接尝试注册一次，失败也静默
-      registerSettings(ctx);
-    }
-  } catch (error) {
-    logger?.warn?.(`niuma: settings injection failed: ${error?.message ?? error}`);
-  }
-
   // ---- 路由守卫：webServer 自身不做鉴权，复用 connection 的 Host/Origin 围栏 ----
   const guarded = (handler) => async (request, response) => {
     let rejection;
@@ -345,18 +280,13 @@ export async function apply(ctx, config = {}) {
       return;
     }
 
-    let persisted = false;
     try {
-      persisted = await persistConfig(next);
+      await persistConfig(next);
     } catch (error) {
       logger?.warn?.(`niuma: settings persist failed: ${error?.stack ?? error}`);
       sendJson(response, 400, { ok: false, error: `写入设置失败：${error?.message ?? error}` });
       return;
     }
-    if (!persisted) {
-      sendJson(response, 400, { ok: false, error: '当前环境不支持写入设置（settings 服务不可用）' });
-      return;
-    }
     sendJson(response, 200, { ok: true, data: { config: next } });
   };
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-niuma",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "description": "牛马加速器 — DSH 工资换算实时计数器：按实收月薪、上下班时间、午休（可设是否算工时）、法定节假日自动折算秒/分/时/日/周/月工资，工资每秒滚动增长。Community salary ticker plugin for DeepSeek Harness.",
   "type": "module",
   "main": "lib/index.js",
@@ -16,7 +16,7 @@
     "lib",
     "src",
     "cordis.patch.yml",
-    "docs/*.png",
+    "docs/preview-light-dark.png",
     "README.md",
     "README.en.md",
     "CHANGELOG.md",
@@ -68,19 +68,14 @@
   },
   "dependencies": {},
   "peerDependencies": {
-    "@deepseek-ai/cordis": "^4.0.2",
-    "@deepseek-ai/schemastery": "^3.18.2"
+    "@deepseek-ai/cordis": "^4.0.2"
   },
   "peerDependenciesMeta": {
     "@deepseek-ai/cordis": {
       "optional": true
-    },
-    "@deepseek-ai/schemastery": {
-      "optional": true
     }
   },
   "devDependencies": {
-    "@deepseek-ai/schemastery": "3.18.4",
     "esbuild": "^0.28.2"
   },
   "scripts": {