dsh-ppt 0.1.1 → 0.2.1

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

@@ -1,5 +1,7 @@
 # dsh-ppt
 
+![npm](https://img.shields.io/npm/v/dsh-ppt) ![downloads](https://img.shields.io/npm/dm/dsh-ppt) ![license](https://img.shields.io/github/license/STARDUSTLC666/dsh-ppt) ![stars](https://img.shields.io/github/stars/STARDUSTLC666/dsh-ppt?style=social)
+
 [![Awesome DSH Plugin](https://awesome-dsh-plugin.com/badge.svg)](https://awesome-dsh-plugin.com)
 
 > **One sentence or one document → a complete presentation**: HTML web slideshow + PPTX export, 5 visual themes, bilingual Chinese/English.
@@ -22,6 +24,10 @@ Example:
 >
 > Turn `docs/quarterly-review.md` into a bilingual presentation and export PPTX.
 
+## Compatibility
+
+Verified against `@deepseek-ai/dsh@0.1.2-alpha.2` on 2026-08-31. Built for the cordis patch-bundle plugin model (`cordis.patch.yml` + `dsh.bundle.patch`). No runtime imports of `@deepseek-ai/*` internals.
+
 ## Installation
 
 ```bash
@@ -30,6 +36,15 @@ dsh plugin --profile web add dsh-ppt
 
 After restart, the `ppt_create` / `ppt_themes` tools and the `dsh-ppt` skill are available. The plugin ships with an empty config and **won't crash startup**.
 
+## Uninstall
+
+```bash
+dsh plugin --profile web remove dsh-ppt
+```
+
+Then restart the web service. To clean up fully, also remove the plugin entry from your profile `cordis.patch.yml` if you overrode it.
+
+
 ## Quick start
 
 ### Inside DSH (recommended)
@@ -95,9 +110,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

@@ -26,6 +26,10 @@ DSH（DeepSeek Harness）演示文稿技能 + 工具插件：把一句话、一
 >
 > 把 `docs/季度汇报.md` 做成双语演示文稿，导出 PPTX。
 
+## 兼容性
+
+在 `@deepseek-ai/dsh@0.1.2-alpha.2` 上验证（2026-08-31）。遵循 cordis 组合包补丁模型（`cordis.patch.yml` + `dsh.bundle.patch`），运行时不 import 任何 `@deepseek-ai/*` 内部模块。
+
 ## 安装
 
 ```bash
@@ -99,9 +103,20 @@ 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`/`theme`/`lang` 参数优先级最高。
+
+
+## 卸载
+
+```bash
+dsh plugin --profile web remove dsh-ppt
 ```
 
-也可用环境变量 `DSH_PPT_OUTPUT_DIR` 指定默认输出目录；`ppt_create` 的 `outputDir` 参数优先级最高。
+卸载后重启 Web 服务。如需彻底清理，可再手动删除自己 profile `cordis.patch.yml` 中的对应插件行。
 
 ## 中英双语
 
@@ -140,4 +155,4 @@ MIT。社区插件，与 DeepSeek 官方无关；`@deepseek-ai/*` 为官方保
 
 - [dsh-hyperframes](https://github.com/STARDUSTLC666/dsh-hyperframes) — HTML 视频创作技能（本插件视觉风格来源）
 - [dsh-remotion](https://github.com/STARDUSTLC666/dsh-remotion) — React 编程式视频技能
-- [dsh-email](https://github.com/STARDUSTLC666/dsh-email) — 邮件六件套
+- [dsh-email](https://github.com/STARDUSTLC666/dsh-email) — 邮件六件套

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.1",
-  "description": "DSH 演示文稿技能 + 工具插件：一句话或一篇 Markdown 文档 → 完整演示文稿（独立 HTML 网页放映 + 可编辑 PPTX 导出），内置 5 套视觉主题，中英双语，SKILL.md 双格式跨 harness。",
+  "version": "0.2.1",
+  "description": "DSH 演示文稿技能 + 工具插件：一句话或一篇 Markdown 文档 → 完整演示文稿（独立 HTML 网页放映 + 可编辑 PPTX 导出），内置 5 套视觉主题，可配置默认主题/语言，中英双语，SKILL.md 双格式跨 harness。",
   "type": "module",
   "main": "lib/index.js",
   "types": "lib/index.d.ts",
@@ -27,7 +27,6 @@
   ],
   "scripts": {
     "build": "tsc -p tsconfig.json",
-    "prepare": "tsc -p tsconfig.json",
     "typecheck": "tsc -p tsconfig.json --noEmit",
     "test": "pnpm run build && node --test \"test/*.test.mjs\"",
     "test:core": "node --test \"test/*.test.mjs\"",
@@ -52,7 +51,7 @@
   ],
   "license": "MIT",
   "engines": {
-    "node": ">=20"
+    "node": ">=22"
   },
   "devDependencies": {
     "@types/node": "^24.0.0",

package/skills/dsh-ppt/scripts/deck-core.mjs

@@ -1121,6 +1121,7 @@ function buildZip(entries) {
   let offset = 0
 
   for (const entry of entries) {
+    const entryOffset = offset
     const name = Buffer.from(entry.name, 'utf8')
     const data = Buffer.isBuffer(entry.data) ? entry.data : Buffer.from(String(entry.data), 'utf8')
     const crc = crc32(data)
@@ -1160,7 +1161,7 @@ function buildZip(entries) {
     centralHeader.writeUInt16LE(0, 34)
     centralHeader.writeUInt16LE(0, 36)
     centralHeader.writeUInt32LE(0, 38)
-    centralHeader.writeUInt32LE(0, 42)
+    centralHeader.writeUInt32LE(entryOffset, 42)
     central.push(centralHeader, name)
   }