chore: release v1.16.1

Author: iwangbowen

docs/changelog/index.md

@@ -4,6 +4,15 @@
 
 ---
 
+## v1.16.1 - 2026-07-26
+
+### Fixed
+
+- **详情页归档目录时区错位**：归档目录（`detailPathRule` 的年 / 年月 / 年月日 / 日期串规则）此前用裸 dayjs 按**操作系统本地时区**计算，而后台展示的发布时间走 `APP_TIME_ZONE`（`APP_TIME_ZONE` → `TZ` → `Asia/Shanghai` 兜底）。部署机时区与 `APP_TIME_ZONE` 不一致时（例如容器内 `TZ` 未设置、OS 为 UTC），跨年/跨月边界发布的内容会落进与后台显示不符的目录。现统一走 `APP_TIME_ZONE`，与 `formatDateTime()` 同源
+- **归档目录用例随时区漂移**：`cms-urls.test.ts` 的日期夹具改用 `APP_TIME_ZONE` 正午构造，避开任意 runner 时区的日界，使断言与 CI/本地时区无关（该用例此前在 UTC runner 上暴露了上述真实缺陷）
+
+---
+
 ## v1.16.0 - 2026-07-26
 
 以 [ChestnutCMS](https://github.com/liweiyi/ChestnutCMS) 为参照做了一轮完整的功能对标与架构瘦身：补齐 12 项经消费方核实的真实缺口，同时**移除发布通道**这一从 ChestnutCMS 直译、在响应式 React SSR 架构下已成负债的机制。

package-lock.json

@@ -1,6 +1,6 @@
 {
 	"name": "zenith-admin",
-	"version": "1.16.0",
+	"version": "1.16.1",
 	"private": true,
 	"workspaces": [
 		"packages/*"

package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zenith/analytics-sdk",
-  "version": "1.16.0",
+  "version": "1.16.1",
   "private": true,
   "type": "module",
   "sideEffects": false,

packages/analytics-sdk/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zenith/electron",
-  "version": "1.16.0",
+  "version": "1.16.1",
   "private": true,
   "description": "Zenith Admin Electron Client",
   "author": "Zenith Admin",

packages/electron/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@zenith/server",
-	"version": "1.16.0",
+	"version": "1.16.1",
 	"private": true,
 	"type": "module",
 	"scripts": {

packages/server/package.json

@@ -1,8 +1,16 @@
 import { describe, expect, it } from 'vitest';
-import { formatDateTime } from '../../lib/datetime';
+import dayjs from 'dayjs';
+import timezone from 'dayjs/plugin/timezone';
+import utc from 'dayjs/plugin/utc';
+import { APP_TIME_ZONE, formatDateTime } from '../../lib/datetime';
 import { contentArchiveDir, contentUrl } from './cms-urls';
 
-const AT = new Date(2026, 6, 5); // 2026-07-05（月/日单位数，用于验证补零差异）
+dayjs.extend(utc);
+dayjs.extend(timezone);
+
+// 固定在 APP_TIME_ZONE 的正午构造，避开任何 runner 时区的日界，使字面断言与 TZ 无关
+// （用 new Date(2026, 6, 5) 会随 OS 时区漂移，CI 与本地结果不一致）
+const AT = dayjs.tz('2026-07-05 12:00:00', 'YYYY-MM-DD HH:mm:ss', APP_TIME_ZONE).toDate();
 
 function content(overrides: Partial<Parameters<typeof contentUrl>[2]> = {}) {
   return { id: 42, slug: null, publishedAt: AT, createdAt: AT, ...overrides };
@@ -36,8 +44,8 @@ describe('contentArchiveDir', () => {
     expect(contentArchiveDir('year', content({ publishedAt: null, createdAt: null }))).toBe('');
   });
 
-  it('取值口径与 formatDateTime 展示一致（同为 dayjs 本地时区）', () => {
-    // 存的是 UTC 2023-12-31T16:00Z，在 UTC+8 下展示为 2024-01-01，归档目录须同为 2024
+  it('取值口径与 formatDateTime 展示一致（同为 APP_TIME_ZONE，而非 OS 本地时区）', () => {
+    // APP_TIME_ZONE 默认 Asia/Shanghai，部署机 TZ 未设置时裸 dayjs 会按 UTC 算，两者差一年
     const utcBoundary = new Date('2023-12-31T16:00:00.000Z');
     const displayedYear = Number(formatDateTime(utcBoundary).slice(0, 4));
     expect(contentArchiveDir('year', content({ publishedAt: utcBoundary }))).toBe(`${displayedYear}/`);
@@ -69,7 +77,7 @@ describe('contentUrl 与归档规则', () => {
     expect(contentUrl('', channel, c, 3)).toBe('/topic/2026/special_3.html');
   });
 
-  it('baseUrl 前缀参与拼接（预览 / 通道子树场景）', () => {
+  it('baseUrl 前缀参与拼接（预览场景）', () => {
     expect(contentUrl('/__cms/main', channel, content())).toBe('/__cms/main/news/2026/42.html');
   });
 

packages/server/src/services/cms/cms-urls.test.ts

@@ -6,8 +6,14 @@
  * 现有 `from './cms-render.service'` 的导入无需改动。
  */
 import dayjs from 'dayjs';
+import timezone from 'dayjs/plugin/timezone';
+import utc from 'dayjs/plugin/utc';
 import { cmsCustomPagePath } from '@zenith/shared';
 import type { CmsChannelDetailPathRule } from '@zenith/shared';
+import { APP_TIME_ZONE } from '../../lib/datetime';
+
+dayjs.extend(utc);
+dayjs.extend(timezone);
 
 /** 搭建页 URL / 静态产物路径：设了 path 用它，否则回落 p/{slug}/ */
 export { cmsCustomPagePath as customPagePath } from '@zenith/shared';
@@ -64,16 +70,17 @@ function pad2(n: number): string {
 /**
  * 归档目录片段（含结尾 `/`；不归档返回空串）。
  *
- * 日期取值口径与全站展示一致：走 dayjs 本地时区，和 `formatDateTime()` 呈现的发布时间同源，
- * 因此运营在后台看到「发布时间 2024-01-01」时，产物就落在 `2024/` 下，不会出现错位一天的困惑。
+ * 日期取值口径必须与全站展示一致 —— 走 `APP_TIME_ZONE`（与 `formatDateTime()` 同源），
+ * 而**不是** OS 本地时区：`APP_TIME_ZONE` 有 `Asia/Shanghai` 兜底，部署机时区不同时
+ * 裸 dayjs 会和后台显示的发布时间差一年/一月，产出与运营预期不符的产物路径。
  * 未发布时回退创建时间；两者都缺失则退化为不归档，保证任何数据状态下都能算出稳定路径。
  */
 export function contentArchiveDir(rule: CmsChannelDetailPathRule, content: CmsUrlContent): string {
   if (rule === 'none') return '';
   if (rule === 'idHash') return `${Math.abs(content.id) % 10}/`;
   const at = content.publishedAt ?? content.createdAt;
   if (!at) return '';
-  const d = dayjs(at);
+  const d = dayjs(at).tz(APP_TIME_ZONE);
   if (!d.isValid()) return '';
   const y = d.year();
   const m = d.month() + 1;

packages/server/src/services/cms/cms-urls.ts

@@ -1,6 +1,6 @@
 {
 	"name": "@zenith/shared",
-	"version": "1.16.0",
+	"version": "1.16.1",
 	"private": true,
 	"type": "module",
 	"sideEffects": false,

packages/shared/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@zenith/web",
-	"version": "1.16.0",
+	"version": "1.16.1",
 	"private": true,
 	"type": "module",
 	"scripts": {