@dsh-plus/web-cache-headers 0.1.9 → 0.1.10

package/lib/client.js

@@ -226,7 +226,7 @@ window.__ModuleLoader__.load({
 			unsaved: "未保存",
 			loading: "加载中…",
 			unavailable: "配置服务不可用。",
-			readOnly: "当前部署无 settings provider，配置为只读；请编辑 settings.yaml。",
+			readOnly: "当前部署无 settings provider，配置为只读；请在 profile 的 cordis.patch.yml 行级配置。",
 			invalidNumber: "请输入正整数。",
 			collapse: "收起",
 			expand: "展开",
@@ -243,7 +243,7 @@ window.__ModuleLoader__.load({
 			unsaved: "Unsaved",
 			loading: "Loading…",
 			unavailable: "Settings service unavailable.",
-			readOnly: "No settings provider in this deployment; config is read-only. Edit settings.yaml.",
+			readOnly: "No settings provider in this deployment; config is read-only. Configure it at the profile row in cordis.patch.yml.",
 			invalidNumber: "Enter a positive integer.",
 			collapse: "Collapse",
 			expand: "Expand",
@@ -450,8 +450,8 @@ ${extra}
 		//#region src/ns.ts
 		/**
 		* settings 命名空间字面量（纯常量，零依赖）。
-		* 服务端以字面量注册 settings section（用户层配置落 $DSH_HOME/settings.yaml，
-		* 热生效）；与行级 cordis Config 共用同一份 schemastery schema（config.ts）。
+		* 服务端以字面量注册 settings section（用户层配置落 profile 行级覆盖层
+		* cordis.patch.yml，热生效）；与行级 cordis Config 共用同一份 schema。
 		* @module @dsh-plus/web-cache-headers/ns
 		*/
 		const SETTINGS_NS = "dsh-plus-web-cache-headers";

package/lib/index.d.ts

@@ -7,7 +7,7 @@ declare const Config: z<Schemastery.ObjectS<NoInfer<{
 }>>, Schemastery.ObjectT<NoInfer<{
   enabled: z<boolean, boolean, "volatile-defined">;
 }>>, "plain">;
-/** 活动字段形态（0.1.7 loader 解析产物：volatile 字段为活动引用）。 */
+/** 活动字段形态（loader 解析产物：volatile 字段为活动引用）。 */
 type WebCacheHeadersConfigFields = Schemastery.TypeT<typeof Config>;
 /** 平面配置形态（消费面的读取形态，由活动引用解包得到）。 */
 type WebCacheHeadersConfig = UnwrapVolatile<WebCacheHeadersConfigFields>;
@@ -15,8 +15,8 @@ type WebCacheHeadersConfig = UnwrapVolatile<WebCacheHeadersConfigFields>;
 //#region src/ns.d.ts
 /**
  * settings 命名空间字面量（纯常量，零依赖）。
- * 服务端以字面量注册 settings section（用户层配置落 $DSH_HOME/settings.yaml，
- * 热生效）；与行级 cordis Config 共用同一份 schemastery schema（config.ts）。
+ * 服务端以字面量注册 settings section（用户层配置落 profile 行级覆盖层
+ * cordis.patch.yml，热生效）；与行级 cordis Config 共用同一份 schema。
  * @module @dsh-plus/web-cache-headers/ns
  */
 declare const SETTINGS_NS = "dsh-plus-web-cache-headers";
@@ -24,7 +24,7 @@ declare const SETTINGS_NS = "dsh-plus-web-cache-headers";
 //#region src/index.d.ts
 declare const name = "dsh-plus-web-cache-headers";
 /**
- * 装配补丁并接线配置源：0.1.7 起配置为 loader 解析的 volatile 活动字段
+ * 装配补丁并接线配置源：配置为 loader 解析的 volatile 活动字段
  * （用户层 override 并入行级 config，写入原位提交），enabled 翻转即时装/卸
  * 补丁，无需 /reload；插件 dispose（profile 卸载 / live reload）保证卸下。
  * @param ctx - 宿主上下文。

package/lib/index.js

@@ -88,8 +88,8 @@ function uninstallImmutableAssetsPatch() {
 * 插件配置（schemastery）：可调参数一律外部化，不在逻辑里硬编码。
 *
 * 与仓库既有约定一致：Config 由 cordis 行级 config 解析，部署方可在
-* profile 的 cordis.patch.yml 覆盖；同时经 settings namespace 暴露到
-* $DSH_HOME/settings.yaml 用户层，修改热生效（无需 /reload）。
+* profile 的 cordis.patch.yml 覆盖；同时经 settings namespace 暴露到用户层
+* （同一 profile 行级覆盖层），修改热生效（无需 /reload）。
 * @module @dsh-plus/web-cache-headers/config
 */
 const Config = z.object({ enabled: z.boolean().description("总开关（false = 卸下补丁，响应头恢复 dsh 原生行为）；development 环境恒禁用以保护 dev/HMR").default(true).volatile() });
@@ -97,8 +97,8 @@ const Config = z.object({ enabled: z.boolean().description("总开关（false =
 //#region src/ns.ts
 /**
 * settings 命名空间字面量（纯常量，零依赖）。
-* 服务端以字面量注册 settings section（用户层配置落 $DSH_HOME/settings.yaml，
-* 热生效）；与行级 cordis Config 共用同一份 schemastery schema（config.ts）。
+* 服务端以字面量注册 settings section（用户层配置落 profile 行级覆盖层
+* cordis.patch.yml，热生效）；与行级 cordis Config 共用同一份 schema。
 * @module @dsh-plus/web-cache-headers/ns
 */
 const SETTINGS_NS = "dsh-plus-web-cache-headers";
@@ -106,7 +106,7 @@ const SETTINGS_NS = "dsh-plus-web-cache-headers";
 //#region src/index.ts
 const name = "dsh-plus-web-cache-headers";
 /**
-* 装配补丁并接线配置源：0.1.7 起配置为 loader 解析的 volatile 活动字段
+* 装配补丁并接线配置源：配置为 loader 解析的 volatile 活动字段
 * （用户层 override 并入行级 config，写入原位提交），enabled 翻转即时装/卸
 * 补丁，无需 /reload；插件 dispose（profile 卸载 / live reload）保证卸下。
 * @param ctx - 宿主上下文。

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dsh-plus/web-cache-headers",
-  "version": "0.1.9",
+  "version": "0.1.10",
   "description": "dsh-plus service plugin: GUI 静态资源长缓存——为内容哈希的 /assets/* 响应补 `Cache-Control: immutable`（/plugins 官方已自带），消除每次刷新重复传输 ~1.4MB JS/CSS；进程级 writeHead 增量拦截，零路由注册、零 dsh 服务耦合，已有缓存头优先保证未来共存",
   "type": "module",
   "main": "lib/index.js",
@@ -31,7 +31,7 @@
     }
   },
   "dependencies": {
-    "@dsh-plus/shared": "0.1.35"
+    "@dsh-plus/shared": "0.1.36"
   },
   "peerDependencies": {
     "@deepseek-ai/cordis": "^4.0.5-alpha.1",

package/src/config.ts

@@ -2,14 +2,14 @@
  * 插件配置（schemastery）：可调参数一律外部化，不在逻辑里硬编码。
  *
  * 与仓库既有约定一致：Config 由 cordis 行级 config 解析，部署方可在
- * profile 的 cordis.patch.yml 覆盖；同时经 settings namespace 暴露到
- * $DSH_HOME/settings.yaml 用户层，修改热生效（无需 /reload）。
+ * profile 的 cordis.patch.yml 覆盖；同时经 settings namespace 暴露到用户层
+ * （同一 profile 行级覆盖层），修改热生效（无需 /reload）。
  * @module @dsh-plus/web-cache-headers/config
  */
 import z from '@deepseek-ai/schemastery'
 import type { UnwrapVolatile } from '@dsh-plus/shared'
 
-// 0.1.7：`.volatile()` 使条目进入 settings describe 视图（卡片可读写）并让
+// `.volatile()` 使条目进入 settings describe 视图（卡片可读写）并让
 // loader 以活动引用原位提交热更新。
 export const Config = z.object({
   enabled: z
@@ -21,7 +21,7 @@ export const Config = z.object({
     .volatile(),
 })
 
-/** 活动字段形态（0.1.7 loader 解析产物：volatile 字段为活动引用）。 */
+/** 活动字段形态（loader 解析产物：volatile 字段为活动引用）。 */
 export type WebCacheHeadersConfigFields = Schemastery.TypeT<typeof Config>
 /** 平面配置形态（消费面的读取形态，由活动引用解包得到）。 */
 export type WebCacheHeadersConfig = UnwrapVolatile<WebCacheHeadersConfigFields>

package/src/index.ts

@@ -37,7 +37,7 @@ export { SETTINGS_NS } from './ns.ts'
 export type { WebCacheHeadersConfig }
 
 /**
- * 装配补丁并接线配置源：0.1.7 起配置为 loader 解析的 volatile 活动字段
+ * 装配补丁并接线配置源：配置为 loader 解析的 volatile 活动字段
  * （用户层 override 并入行级 config，写入原位提交），enabled 翻转即时装/卸
  * 补丁，无需 /reload；插件 dispose（profile 卸载 / live reload）保证卸下。
  * @param ctx - 宿主上下文。
@@ -64,7 +64,7 @@ export function apply(
     )
   }
 
-  // 活动引用原位提交（替代 0.1.6 setSource/onChange）：每次读现取平面快照，
+  // 活动引用原位提交（替代已删除的 setSource/onChange）：每次读现取平面快照，
   // volatile 提交事件驱动 enabled 翻转装卸。
   const current = (): WebCacheHeadersConfig => unwrapVolatile(config)
   ctx.events.on('loader/volatile-update', () => sync(current().enabled))

package/src/ns.ts

@@ -1,7 +1,7 @@
 /**
  * settings 命名空间字面量（纯常量，零依赖）。
- * 服务端以字面量注册 settings section（用户层配置落 $DSH_HOME/settings.yaml，
- * 热生效）；与行级 cordis Config 共用同一份 schemastery schema（config.ts）。
+ * 服务端以字面量注册 settings section（用户层配置落 profile 行级覆盖层
+ * cordis.patch.yml，热生效）；与行级 cordis Config 共用同一份 schema。
  * @module @dsh-plus/web-cache-headers/ns
  */
 export const SETTINGS_NS = 'dsh-plus-web-cache-headers'