dsh-ppt 0.1.0 → 0.2.0

package/CHANGELOG.md

@@ -1,5 +1,11 @@
 # Changelog
 
+## 0.2.0
+
+- 新增 `defaultTheme` / `defaultLang` 配置，作为 `ppt_create` 未显式传参时的默认值。
+- 配置校验：`defaultLang` 仅接受 `zh` / `en` / `bilingual`。
+- 更新测试覆盖与双语文档。
+
 ## 0.1.0
 
 - 首发：`dsh-ppt` 技能 + 工具插件。

package/README.en.md

@@ -95,9 +95,11 @@ No required configuration. Optional:
   config:
     outputDir: E:\decks   # optional; defaults to the session working directory
     maxSlides: 40         # optional; default 60 (3–120)
+    defaultTheme: data    # optional; used when ppt_create has no theme
+    defaultLang: en       # optional; used when ppt_create has no lang (zh/en/bilingual)
 ```
 
-The `DSH_PPT_OUTPUT_DIR` env var can also set the default output directory; the `ppt_create` `outputDir` argument has the highest priority.
+The `DSH_PPT_OUTPUT_DIR` env var can also set the default output directory; the `ppt_create` `outputDir`/`theme`/`lang` arguments have the highest priority.
 
 ## Bilingual support
 

package/README.md

@@ -99,9 +99,11 @@ node <skill-dir>/scripts/build-deck.mjs \
   config:
     outputDir: E:\decks   # 可选；默认会话工作目录
     maxSlides: 40         # 可选；默认 60（3–120）
+    defaultTheme: data    # 可选；ppt_create 未指定 theme 时使用
+    defaultLang: zh       # 可选；ppt_create 未指定 lang 时使用（zh/en/bilingual）
 ```
 
-也可用环境变量 `DSH_PPT_OUTPUT_DIR` 指定默认输出目录；`ppt_create` 的 `outputDir` 参数优先级最高。
+也可用环境变量 `DSH_PPT_OUTPUT_DIR` 指定默认输出目录；`ppt_create` 的 `outputDir`/`theme`/`lang` 参数优先级最高。
 
 ## 中英双语
 

package/cordis.patch.yml

@@ -10,6 +10,8 @@
 #     config:
 #       outputDir: E:\decks        # 可选：默认写入会话工作目录
 #       maxSlides: 40              # 可选：单次生成幻灯片上限，默认 60
+#       defaultTheme: data         # 可选：默认视觉主题
+#       defaultLang: zh            # 可选：默认界面语言 zh/en/bilingual
 #
 - insert:
     - id: dsh-ppt

package/lib/config.d.ts

@@ -4,6 +4,8 @@ export declare const DEFAULT_MAX_SLIDES = 60;
 export interface ResolvedPptConfig {
     outputDir: string;
     maxSlides: number;
+    defaultTheme: string;
+    defaultLang: string;
 }
 /** 解析并校验插件行配置。本插件无必填项，空配置永远可用。 */
 export declare function resolvePptConfig(config: PptConfig | undefined | null): ResolvedPptConfig;

package/lib/config.js

@@ -5,9 +5,16 @@ export function resolvePptConfig(config) {
     const raw = config ?? {};
     const outputDir = (typeof raw.outputDir === 'string' ? raw.outputDir : '').trim()
         || (process.env[PPT_OUTPUT_DIR_ENV] ?? '').trim();
+    const defaultTheme = (typeof raw.defaultTheme === 'string' ? raw.defaultTheme : '').trim();
+    const defaultLang = (typeof raw.defaultLang === 'string' ? raw.defaultLang : '').trim();
+    if (defaultLang !== '' && defaultLang !== 'zh' && defaultLang !== 'en' && defaultLang !== 'bilingual') {
+        throw new Error('defaultLang 只支持 zh / en / bilingual。');
+    }
     return {
         outputDir,
         maxSlides: clampInt(raw.maxSlides, DEFAULT_MAX_SLIDES, 3, 120),
+        defaultTheme,
+        defaultLang,
     };
 }
 export function clampInt(value, fallback, min, max) {

package/lib/index.js

@@ -181,8 +181,8 @@ export function apply(ctx, config = {}) {
                 title: args.title.trim(),
                 content: typeof args.content === 'string' ? args.content : '',
                 slides: hasSlides ? args.slides : undefined,
-                theme: typeof args.theme === 'string' && args.theme.trim() !== '' ? args.theme.trim() : undefined,
-                lang: typeof args.lang === 'string' && args.lang.trim() !== '' ? args.lang.trim() : undefined,
+                theme: typeof args.theme === 'string' && args.theme.trim() !== '' ? args.theme.trim() : (resolved.defaultTheme || undefined),
+                lang: typeof args.lang === 'string' && args.lang.trim() !== '' ? args.lang.trim() : (resolved.defaultLang || undefined),
                 outputDir: typeof args.outputDir === 'string' && args.outputDir.trim() !== '' ? args.outputDir.trim() : (resolved.outputDir || undefined),
                 fileName: typeof args.fileName === 'string' && args.fileName.trim() !== '' ? args.fileName.trim() : undefined,
                 maxSlides: resolved.maxSlides,

package/lib/types.d.ts

@@ -15,6 +15,10 @@ export interface PptConfig {
     outputDir?: string;
     /** 单次生成幻灯片上限，默认 60（3–120）。 */
     maxSlides?: number;
+    /** 默认视觉主题 id，调用 ppt_create 时可用 theme 覆盖。 */
+    defaultTheme?: string;
+    /** 默认播放器界面语言，调用 ppt_create 时可用 lang 覆盖。 */
+    defaultLang?: string;
 }
 export interface PptCreateArgs {
     title: string;

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "dsh-ppt",
-  "version": "0.1.0",
-  "description": "DSH 演示文稿技能 + 工具插件：一句话或一篇 Markdown 文档 → 完整演示文稿（独立 HTML 网页放映 + 可编辑 PPTX 导出），内置 5 套视觉主题，中英双语，SKILL.md 双格式跨 harness。",
+  "version": "0.2.0",
+  "description": "DSH 演示文稿技能 + 工具插件：一句话或一篇 Markdown 文档 → 完整演示文稿（独立 HTML 网页放映 + 可编辑 PPTX 导出），内置 5 套视觉主题，可配置默认主题/语言，中英双语，SKILL.md 双格式跨 harness。",
   "type": "module",
   "main": "lib/index.js",
   "types": "lib/index.d.ts",