dsh-offwork 1.0.0 → 1.0.1

package/clock.js

@@ -5,37 +5,48 @@ export function calculate(settings, timestamp = Date.now()) {
   if (!Number.isFinite(now)) throw new RangeError('Invalid timestamp');
   const DAY = 86400000;
   const formatter = new Intl.DateTimeFormat('en-CA', {
-    timeZone: settings.timezone, year: 'numeric', month: '2-digit', day: '2-digit',
-    hour: '2-digit', minute: '2-digit', second: '2-digit', hourCycle: 'h23',
+    timeZone: settings.timezone,
+    year: 'numeric',
+    month: '2-digit',
+    day: '2-digit',
+    hour: '2-digit',
+    minute: '2-digit',
+    second: '2-digit',
+    hourCycle: 'h23',
   });
-  const civil = time => {
-    const p = Object.fromEntries(formatter.formatToParts(time).map(p => [p.type, p.value]));
+  const civil = (time) => {
+    const p = Object.fromEntries(formatter.formatToParts(time).map((p) => [p.type, p.value]));
     return Date.UTC(+p.year, +p.month - 1, +p.day, +p.hour, +p.minute, +p.second);
   };
   // Convert a timezone-local civil time to an absolute instant. At DST overlaps use
   // the earlier occurrence; at gaps move forward by the gap (Temporal-compatible).
-  const instant = local => {
-    const offsets = [...new Set([-DAY, 0, DAY].map(delta => civil(local + delta) - (local + delta)))];
-    const candidates = offsets.map(offset => local - offset);
-    const exact = candidates.filter(time => civil(time) === local);
+  const instant = (local) => {
+    const offsets = [
+      ...new Set([-DAY, 0, DAY].map((delta) => civil(local + delta) - (local + delta))),
+    ];
+    const candidates = offsets.map((offset) => local - offset);
+    const exact = candidates.filter((time) => civil(time) === local);
     if (exact.length) return Math.min(...exact);
-    const after = candidates.filter(time => civil(time) >= local);
+    const after = candidates.filter((time) => civil(time) >= local);
     return Math.min(...(after.length ? after : candidates));
   };
-  const minute = text => {
+  const minute = (text) => {
     if (typeof text !== 'string' || !/^(?:[01]\d|2[0-3]):[0-5]\d$/.test(text)) {
       throw new RangeError('Shift times must be HH:mm');
     }
     const [h, m] = text.split(':').map(Number);
     return h * 60 + m;
   };
-  const start = minute(settings.start), end = minute(settings.end);
+  const start = minute(settings.start),
+    end = minute(settings.end);
   if (start === end) throw new RangeError('Shift must not be empty');
   const overnight = end < start;
   const duration = (end - start + 1440) % 1440;
-  let breakOffset = 0, breakDuration = 0;
+  let breakOffset = 0,
+    breakDuration = 0;
   if (settings.breakStart != null || settings.breakEnd != null) {
-    const bs = minute(settings.breakStart), be = minute(settings.breakEnd);
+    const bs = minute(settings.breakStart),
+      be = minute(settings.breakEnd);
     if (bs !== be) {
       breakOffset = (bs - start + 1440) % 1440;
       breakDuration = (be - bs + 1440) % 1440;
@@ -47,7 +58,7 @@ export function calculate(settings, timestamp = Date.now()) {
   const localNow = civil(now);
   const today = Math.floor(localNow / DAY) * DAY;
   const minuteNow = (localNow - today) / 60000;
-  const workday = day => settings.weekdays.includes(new Date(day).getUTCDay());
+  const workday = (day) => settings.weekdays.includes(new Date(day).getUTCDay());
   let shiftDay = today;
   if (overnight && minuteNow < start) {
     // Retain yesterday's finished work shift until the next shift starts. If
@@ -58,46 +69,82 @@ export function calculate(settings, timestamp = Date.now()) {
   const shiftStart = instant(shiftDay + start * 60000);
   const shiftEnd = instant(shiftDay + (start + duration) * 60000);
   const breakStart = breakDuration ? instant(shiftDay + (start + breakOffset) * 60000) : null;
-  const breakEnd = breakDuration ? instant(shiftDay + (start + breakOffset + breakDuration) * 60000) : null;
+  const breakEnd = breakDuration
+    ? instant(shiftDay + (start + breakOffset + breakDuration) * 60000)
+    : null;
   const breakMs = breakDuration ? breakEnd - breakStart : 0;
   const totalMs = shiftEnd - shiftStart - breakMs;
   if (totalMs <= 0 || breakMs < 0) throw new RangeError('Shift has no paid duration');
   const clampedNow = Math.max(shiftStart, Math.min(now, shiftEnd));
-  const elapsedMs = isWorkday ? Math.max(0, Math.min(totalMs,
-    clampedNow - shiftStart - (breakDuration ? Math.max(0, Math.min(clampedNow, breakEnd) - breakStart) : 0))) : 0;
-  const status = !isWorkday ? 'rest' : now < shiftStart ? 'before' : now >= shiftEnd ? 'done'
-    : breakDuration && now >= breakStart && now < breakEnd ? 'lunch' : 'working';
+  const elapsedMs = isWorkday
+    ? Math.max(
+        0,
+        Math.min(
+          totalMs,
+          clampedNow -
+            shiftStart -
+            (breakDuration ? Math.max(0, Math.min(clampedNow, breakEnd) - breakStart) : 0),
+        ),
+      )
+    : 0;
+  const status = !isWorkday
+    ? 'rest'
+    : now < shiftStart
+      ? 'before'
+      : now >= shiftEnd
+        ? 'done'
+        : breakDuration && now >= breakStart && now < breakEnd
+          ? 'lunch'
+          : 'working';
   // Decimal inputs become exact rational numbers before truncation. Never use
   // floor((salary / days * progress) * 100): binary rounding loses whole cents.
-  const rational = number => {
-    if (typeof number !== 'number' || !Number.isFinite(number) || number < 0) throw new RangeError('Invalid salary');
+  const rational = (number) => {
+    if (typeof number !== 'number' || !Number.isFinite(number) || number < 0)
+      throw new RangeError('Invalid salary');
     const [mantissa, exponent = '0'] = String(number).toLowerCase().split('e');
     const [integer, fraction = ''] = mantissa.split('.');
     const scale = fraction.length - Number(exponent);
-    return scale >= 0 ? [BigInt(integer + fraction), 10n ** BigInt(scale)]
+    return scale >= 0
+      ? [BigInt(integer + fraction), 10n ** BigInt(scale)]
       : [BigInt(integer + fraction) * 10n ** BigInt(-scale), 1n];
   };
   const payMode = settings.payMode === 'daily' ? 'daily' : 'monthly';
-  let [numerator, denominator] = rational(payMode === 'daily' ? settings.dailySalary : settings.monthlySalary);
+  let [numerator, denominator] = rational(
+    payMode === 'daily' ? settings.dailySalary : settings.monthlySalary,
+  );
   if (payMode === 'monthly') {
     const [daysN, daysD] = rational(settings.workdaysPerMonth);
     if (daysN === 0n) throw new RangeError('Workdays per month must be positive');
     numerator *= daysD;
     denominator *= daysN;
   }
-  const dailyCents = Number(numerator * 100n / denominator);
-  const earnedCents = Math.min(dailyCents, Number(numerator * 100n * BigInt(Math.floor(elapsedMs)) /
-    (denominator * BigInt(totalMs))));
-  const hourlyCents = Number(numerator * 100n * 3600000n / (denominator * BigInt(totalMs)));
-  const dateString = day => new Date(day).toISOString().slice(0, 10);
+  const dailyCents = Number((numerator * 100n) / denominator);
+  const earnedCents = Math.min(
+    dailyCents,
+    Number((numerator * 100n * BigInt(Math.floor(elapsedMs))) / (denominator * BigInt(totalMs))),
+  );
+  const hourlyCents = Number((numerator * 100n * 3600000n) / (denominator * BigInt(totalMs)));
+  const dateString = (day) => new Date(day).toISOString().slice(0, 10);
   return {
-    status, remaining: isWorkday ? Math.max(0, Math.ceil((shiftEnd - now) / 1000)) : 0,
+    status,
+    remaining: isWorkday ? Math.max(0, Math.ceil((shiftEnd - now) / 1000)) : 0,
     startRemaining: status === 'before' ? Math.max(0, Math.ceil((shiftStart - now) / 1000)) : 0,
     progress: elapsedMs / totalMs,
-    earned: earnedCents / 100, daily: dailyCents / 100, hourly: hourlyCents / 100,
-    date: dateString(today), shiftDate: dateString(shiftDay),
-    earnedCents, dailyCents, payMode, isWorkday, overnight,
-    shiftStart, shiftEnd, breakStart, breakEnd,
-    elapsed: elapsedMs / 1000, total: totalMs / 1000,
+    earned: earnedCents / 100,
+    daily: dailyCents / 100,
+    hourly: hourlyCents / 100,
+    date: dateString(today),
+    shiftDate: dateString(shiftDay),
+    earnedCents,
+    dailyCents,
+    payMode,
+    isWorkday,
+    overnight,
+    shiftStart,
+    shiftEnd,
+    breakStart,
+    breakEnd,
+    elapsed: elapsedMs / 1000,
+    total: totalMs / 1000,
   };
 }

package/index.js

@@ -20,8 +20,11 @@ export const DEFAULT_SETTINGS = Object.freeze({
 
 const dataFile = new URL('./data.json', import.meta.url);
 const keys = Object.keys(DEFAULT_SETTINGS);
-const isObject = value => value !== null && typeof value === 'object' && !Array.isArray(value);
-const fail = error => ({ ok: false, error: error instanceof Error ? error.message : String(error) });
+const isObject = (value) => value !== null && typeof value === 'object' && !Array.isArray(value);
+const fail = (error) => ({
+  ok: false,
+  error: error instanceof Error ? error.message : String(error),
+});
 
 function validatePatch(value) {
   if (!isObject(value)) throw new Error('settings 必须是 JSON 对象。');
@@ -38,16 +41,28 @@ export function validateSettings(value) {
   if (value.payMode !== 'monthly' && value.payMode !== 'daily') {
     throw new Error('payMode 必须是 monthly 或 daily。');
   }
-  if (typeof value.dailySalary !== 'number' || !Number.isFinite(value.dailySalary) || value.dailySalary < 0) {
+  if (
+    typeof value.dailySalary !== 'number' ||
+    !Number.isFinite(value.dailySalary) ||
+    value.dailySalary < 0
+  ) {
     throw new Error('dailySalary 必须是大于等于 0 的有限数字。');
   }
-  if (typeof value.monthlySalary !== 'number' || !Number.isFinite(value.monthlySalary) || value.monthlySalary < 0) {
+  if (
+    typeof value.monthlySalary !== 'number' ||
+    !Number.isFinite(value.monthlySalary) ||
+    value.monthlySalary < 0
+  ) {
     throw new Error('monthlySalary 必须是大于等于 0 的有限数字。');
   }
-  if (typeof value.workdaysPerMonth !== 'number' || !Number.isFinite(value.workdaysPerMonth) || value.workdaysPerMonth <= 0) {
+  if (
+    typeof value.workdaysPerMonth !== 'number' ||
+    !Number.isFinite(value.workdaysPerMonth) ||
+    value.workdaysPerMonth <= 0
+  ) {
     throw new Error('workdaysPerMonth 必须是大于 0 的有限数字。');
   }
-  const minutes = key => {
+  const minutes = (key) => {
     if (typeof value[key] !== 'string' || !/^(?:[01]\d|2[0-3]):[0-5]\d$/.test(value[key])) {
       throw new Error(`${key} 必须是 24 小时制 HH:mm。`);
     }
@@ -59,7 +74,7 @@ export function validateSettings(value) {
   const breakStart = minutes('breakStart');
   const breakEnd = minutes('breakEnd');
   if (end === start) throw new Error('start 和 end 不能相同。');
-  const relative = minute => (minute - start + 1440) % 1440;
+  const relative = (minute) => (minute - start + 1440) % 1440;
   const duration = relative(end);
   if (breakStart !== breakEnd) {
     const from = relative(breakStart);
@@ -69,16 +84,26 @@ export function validateSettings(value) {
     }
     if (to - from >= duration) throw new Error('午休不能占满整个班次。');
   }
-  if (!Array.isArray(value.weekdays) || value.weekdays.length === 0 ||
-      value.weekdays.some(day => !Number.isInteger(day) || day < 0 || day > 6) ||
-      new Set(value.weekdays).size !== value.weekdays.length) {
+  if (
+    !Array.isArray(value.weekdays) ||
+    value.weekdays.length === 0 ||
+    value.weekdays.some((day) => !Number.isInteger(day) || day < 0 || day > 6) ||
+    new Set(value.weekdays).size !== value.weekdays.length
+  ) {
     throw new Error('weekdays 必须是非空、不重复的 0–6 整数数组（0 为周日）。');
   }
-  if (typeof value.timezone !== 'string' || value.timezone.length === 0 || value.timezone.trim() !== value.timezone) {
+  if (
+    typeof value.timezone !== 'string' ||
+    value.timezone.length === 0 ||
+    value.timezone.trim() !== value.timezone
+  ) {
+    throw new Error('timezone 必须是有效时区名称。');
+  }
+  try {
+    new Intl.DateTimeFormat('en', { timeZone: value.timezone });
+  } catch {
     throw new Error('timezone 必须是有效时区名称。');
   }
-  try { new Intl.DateTimeFormat('en', { timeZone: value.timezone }); }
-  catch { throw new Error('timezone 必须是有效时区名称。'); }
   return { ...value, weekdays: [...value.weekdays] };
 }
 
@@ -89,18 +114,26 @@ export function createOperations(dataFileArg = dataFile) {
   let queue = Promise.resolve();
   async function read() {
     let text;
-    try { text = await readFile(target, 'utf8'); }
-    catch (error) {
-      if (error.code === 'ENOENT') return { settings: validateSettings(DEFAULT_SETTINGS), configured: false };
+    try {
+      text = await readFile(target, 'utf8');
+    } catch (error) {
+      if (error.code === 'ENOENT')
+        return { settings: validateSettings(DEFAULT_SETTINGS), configured: false };
       throw new Error('无法读取本机配置。');
     }
     try {
       const stored = JSON.parse(text);
       validatePatch(stored);
       // Only the newly introduced fields are optional in legacy files.
-      const settings = validateSettings({ payMode: DEFAULT_SETTINGS.payMode, dailySalary: DEFAULT_SETTINGS.dailySalary, ...stored });
+      const settings = validateSettings({
+        payMode: DEFAULT_SETTINGS.payMode,
+        dailySalary: DEFAULT_SETTINGS.dailySalary,
+        ...stored,
+      });
       return { settings, configured: true };
-    } catch { throw new Error('本机配置损坏或无效；请检查插件目录 data.json。'); }
+    } catch {
+      throw new Error('本机配置损坏或无效；请检查插件目录 data.json。');
+    }
   }
   async function write(settings) {
     const temp = join(dirname(target), `.data-${randomUUID()}.tmp`);
@@ -125,74 +158,117 @@ export function createOperations(dataFileArg = dataFile) {
         const settings = validateSettings({ ...current.settings, ...patch });
         await write(settings);
         return { ok: true, settings, configured: true };
-      } catch (error) { return fail(error); }
+      } catch (error) {
+        return fail(error);
+      }
     });
-    queue = operation.then(() => {}, () => {});
+    queue = operation.then(
+      () => {},
+      () => {},
+    );
     return operation;
   };
 }
 
 const settingsSchema = {
-  type: 'object', additionalProperties: false,
+  type: 'object',
+  additionalProperties: false,
   description: '要合并保存的配置字段。时间使用 HH:mm。',
   properties: {
-    payMode: { type: 'string', enum: ['monthly', 'daily'], description: '计薪方式，默认 monthly（月薪）；daily 为日薪。' },
+    payMode: {
+      type: 'string',
+      enum: ['monthly', 'daily'],
+      description: '计薪方式，默认 monthly（月薪）；daily 为日薪。',
+    },
     dailySalary: { type: 'number', description: '日薪，有限数字且 >= 0，默认 400。' },
     monthlySalary: { type: 'number', description: '月薪，有限数字且 >= 0。' },
     workdaysPerMonth: { type: 'number', description: '每月工作日数，有限数字且 > 0。' },
     start: { type: 'string', description: '上班时间 HH:mm。' },
     end: { type: 'string', description: '下班时间 HH:mm；早于上班表示次日，不能与上班相同。' },
     breakStart: { type: 'string', description: '休息开始 HH:mm。' },
-    breakEnd: { type: 'string', description: '休息结束 HH:mm；与开始相同即关闭，否则按班次顺序在班次内，且不能占满班次。' },
-    weekdays: { type: 'array', items: { type: 'integer', enum: [0, 1, 2, 3, 4, 5, 6] }, description: '非空、不重复；0 为周日，1 为周一。' },
+    breakEnd: {
+      type: 'string',
+      description: '休息结束 HH:mm；与开始相同即关闭，否则按班次顺序在班次内，且不能占满班次。',
+    },
+    weekdays: {
+      type: 'array',
+      items: { type: 'integer', enum: [0, 1, 2, 3, 4, 5, 6] },
+      description: '非空、不重复；0 为周日，1 为周一。',
+    },
     timezone: { type: 'string', description: '有效时区，例如 Asia/Shanghai。' },
   },
 };
 
 export function apply(ctx) {
   const operate = createOperations();
-  ctx.effect(() => ctx.commands.register({
-    name: 'offwork-clock',
-    description: '读取或保存本机下班时钟配置：get 或 set JSON。',
-    input: { hint: 'get | set {"monthlySalary":10000}' },
-    recordInput: false,
-    async handler({ rawInput }) {
-      let result;
-      try {
-        const match = /^(get|set)(?:\s+([\s\S]*))?$/.exec(rawInput.trim());
-        if (!match) throw new Error('用法：/offwork-clock get 或 /offwork-clock set JSON');
-        const [, action, json] = match;
-        if (action === 'get' && json !== undefined) throw new Error('get 不接受参数。');
-        if (action === 'set' && !json?.trim()) throw new Error('set 需要 JSON 配置对象。');
-        result = await operate(action, action === 'set' ? JSON.parse(json) : undefined);
-      } catch (error) { result = fail(error); }
-      return { kind: result.ok ? 'success' : 'error', text: JSON.stringify(result) };
-    },
-  }));
-  ctx.effect(() => ctx.tools.register({
-    name: 'offwork_clock',
-    description: '读取或更新本机下班时钟的工资与班次配置。get 返回配置及 configured（是否已有保存文件）；set 合并保存。工资仅存本机，但调用及结果会进入会话记录。',
-    parameters: {
-      type: 'object', additionalProperties: false, required: ['action'],
-      properties: {
-        action: { type: 'string', enum: ['get', 'set'], description: 'get 读取；set 更新。' },
-        settings: settingsSchema,
+  ctx.effect(() =>
+    ctx.commands.register({
+      name: 'offwork-clock',
+      description: '读取或保存本机下班时钟配置：get 或 set JSON。',
+      input: { hint: 'get | set {"monthlySalary":10000}' },
+      recordInput: false,
+      async handler({ rawInput }) {
+        let result;
+        try {
+          const match = /^(get|set)(?:\s+([\s\S]*))?$/.exec(rawInput.trim());
+          if (!match) throw new Error('用法：/offwork-clock get 或 /offwork-clock set JSON');
+          const [, action, json] = match;
+          if (action === 'get' && json !== undefined) throw new Error('get 不接受参数。');
+          if (action === 'set' && !json?.trim()) throw new Error('set 需要 JSON 配置对象。');
+          result = await operate(action, action === 'set' ? JSON.parse(json) : undefined);
+        } catch (error) {
+          result = fail(error);
+        }
+        return { kind: result.ok ? 'success' : 'error', text: JSON.stringify(result) };
       },
-    },
-    output: {
-      schema: {
-        oneOf: [
-          { type: 'object', additionalProperties: false, required: ['ok', 'settings', 'configured'], properties: { ok: { type: 'boolean', const: true }, settings: { ...settingsSchema, required: keys }, configured: { type: 'boolean' } } },
-          { type: 'object', additionalProperties: false, required: ['ok', 'error'], properties: { ok: { type: 'boolean', const: false }, error: { type: 'string' } } },
-        ],
+    }),
+  );
+  ctx.effect(() =>
+    ctx.tools.register({
+      name: 'offwork_clock',
+      description:
+        '读取或更新下班时钟的工资与班次配置。get 返回配置及 configured（是否已有保存文件）；set 合并保存。配置保存在运行 Harness 的机器上，调用及结果会进入会话记录。',
+      parameters: {
+        type: 'object',
+        additionalProperties: false,
+        required: ['action'],
+        properties: {
+          action: { type: 'string', enum: ['get', 'set'], description: 'get 读取；set 更新。' },
+          settings: settingsSchema,
+        },
       },
-      render: (_args, value) => [{ type: 'text', text: JSON.stringify(value) }],
-    },
-    async execute(args) {
-      if (!isObject(args) || Object.keys(args).some(key => key !== 'action' && key !== 'settings')) {
-        return fail('参数必须是仅含 action 和可选 settings 的对象。');
-      }
-      return operate(args.action, args.settings);
-    },
-  }));
+      output: {
+        schema: {
+          oneOf: [
+            {
+              type: 'object',
+              additionalProperties: false,
+              required: ['ok', 'settings', 'configured'],
+              properties: {
+                ok: { type: 'boolean', const: true },
+                settings: { ...settingsSchema, required: keys },
+                configured: { type: 'boolean' },
+              },
+            },
+            {
+              type: 'object',
+              additionalProperties: false,
+              required: ['ok', 'error'],
+              properties: { ok: { type: 'boolean', const: false }, error: { type: 'string' } },
+            },
+          ],
+        },
+        render: (_args, value) => [{ type: 'text', text: JSON.stringify(value) }],
+      },
+      async execute(args) {
+        if (
+          !isObject(args) ||
+          Object.keys(args).some((key) => key !== 'action' && key !== 'settings')
+        ) {
+          return fail('参数必须是仅含 action 和可选 settings 的对象。');
+        }
+        return operate(args.action, args.settings);
+      },
+    }),
+  );
 }

package/locale/en.json

@@ -1 +1,6 @@
-{"meta":{"title":"Offwork Clock","description":"A draggable countdown to clock-out with live estimated earnings and salary settings."}}
+{
+  "meta": {
+    "title": "Offwork Clock",
+    "description": "A draggable countdown to clock-out with live estimated earnings and salary settings."
+  }
+}

package/locale/zh.json

@@ -1 +1,6 @@
-{"meta":{"title":"下班计时器","description":"可拖动的下班倒计时与工资悬浮窗，支持月薪/日薪、夜班、工作日、可选休息扣除、金额隐藏与位置记忆。"}}
+{
+  "meta": {
+    "title": "下班计时器",
+    "description": "可拖动的下班倒计时与工资悬浮窗，支持月薪/日薪、夜班、工作日、可选休息扣除、金额隐藏与位置记忆。"
+  }
+}

package/package.json

@@ -1,13 +1,18 @@
 {
   "name": "dsh-offwork",
-  "version": "1.0.0",
+  "version": "1.0.1",
   "description": "下班倒计时与实时工资悬浮窗：可拖动、可调透明度、工资可隐藏。A draggable countdown and salary overlay for DeepSeek Harness.",
   "type": "module",
   "license": "MIT",
   "author": "now",
-  "repository": { "type": "git", "url": "git+https://github.com/SnowBeatRain/dsh-offwork.git" },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/SnowBeatRain/dsh-offwork.git"
+  },
   "homepage": "https://github.com/SnowBeatRain/dsh-offwork#readme",
-  "bugs": { "url": "https://github.com/SnowBeatRain/dsh-offwork/issues" },
+  "bugs": {
+    "url": "https://github.com/SnowBeatRain/dsh-offwork/issues"
+  },
   "keywords": [
     "deepseek-harness",
     "dsh-plugin",
@@ -38,13 +43,18 @@
     "icon.svg",
     "LICENSE",
     "README.md",
+    "CHANGELOG.md",
     "tests/*.mjs",
-    "tools/build.mjs"
+    "tools/*.mjs"
   ],
   "scripts": {
     "build": "node tools/build.mjs",
+    "format": "prettier --write . && npm run build",
+    "format:check": "prettier --check .",
     "test": "node tools/build.mjs --check && node --test tests/*.mjs",
-    "prepublishOnly": "npm run build && npm test"
+    "check:package": "node tools/check-package.mjs",
+    "check": "npm run format:check && npm test && npm run check:package",
+    "prepublishOnly": "npm run build && npm run check"
   },
   "dsh": {
     "bundle": {
@@ -58,5 +68,8 @@
         "@deepseek-ai/dsh-api-remotes"
       ]
     }
+  },
+  "devDependencies": {
+    "prettier": "3.9.10"
   }
 }