dsh-ppt 0.33.0 → 0.35.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (33) hide show
  1. package/CHANGELOG.md +42 -0
  2. package/README.en.md +8 -10
  3. package/README.md +8 -10
  4. package/docs/USAGE.en.md +44 -35
  5. package/docs/USAGE.md +45 -36
  6. package/docs/VALIDATION.md +8 -0
  7. package/lib/client.js +116 -17
  8. package/lib/ecosystem.js +10 -0
  9. package/lib/execution.js +36 -5
  10. package/lib/tools.js +74 -4
  11. package/lib/types.d.ts +79 -1
  12. package/lib/workbench.js +255 -14
  13. package/package.json +2 -2
  14. package/skills/dsh-ppt/SKILL.md +34 -31
  15. package/skills/dsh-ppt/package.json +1 -1
  16. package/skills/dsh-ppt/references/office-pack.md +124 -0
  17. package/skills/dsh-ppt/references/research-plan.md +93 -62
  18. package/skills/dsh-ppt/scripts/build-deck.mjs +109 -3
  19. package/skills/dsh-ppt/scripts/deck-absorb.mjs +21 -0
  20. package/skills/dsh-ppt/scripts/deck-advanced.mjs +330 -37
  21. package/skills/dsh-ppt/scripts/deck-brand-kit.mjs +257 -0
  22. package/skills/dsh-ppt/scripts/deck-charts-exec.mjs +805 -0
  23. package/skills/dsh-ppt/scripts/deck-chrome.mjs +47 -1
  24. package/skills/dsh-ppt/scripts/deck-compose.mjs +386 -0
  25. package/skills/dsh-ppt/scripts/deck-core.mjs +136 -16
  26. package/skills/dsh-ppt/scripts/deck-delivery.mjs +750 -17
  27. package/skills/dsh-ppt/scripts/deck-evidence.mjs +811 -118
  28. package/skills/dsh-ppt/scripts/deck-export.mjs +652 -0
  29. package/skills/dsh-ppt/scripts/deck-i18n.mjs +170 -0
  30. package/skills/dsh-ppt/scripts/deck-layouts.mjs +72 -8
  31. package/skills/dsh-ppt/scripts/deck-media.mjs +22 -0
  32. package/skills/dsh-ppt/scripts/deck-office.mjs +1455 -14
  33. package/skills/dsh-ppt/scripts/deck-remix.mjs +471 -0
@@ -0,0 +1,257 @@
1
+ /**
2
+ * deck-brand-kit.mjs —— 企业级品牌宪章锁(.dsh-ppt/brand-kit.json)、保密水印与 SLOP-14 合规门禁。
3
+ *
4
+ * 零外部运行时依赖,复用了 deck-store.mjs 的原子写盘保护:
5
+ * 1. 支持通过 `saveWorkspaceBrandKit` 或 `ppt_absorb({ ..., saveBrandKit: true })` 将企业母版规范永久锁定;
6
+ * 2. 自动注入锁定色板、字体、页脚、保密水印(如 "CONFIDENTIAL · 内部资料")与官方固定封底;
7
+ * 3. `SLOP-14` 合规静态审计:自动扫描全篇标题/要点/卡片/表格/备注中的企业禁用词(`forbidden-brand-term`)与主色漂移(`brand-palette-drift`)。
8
+ */
9
+
10
+ import { existsSync, readFileSync } from 'node:fs'
11
+ import { join, resolve } from 'node:path'
12
+ import { stripInlineMarkdown } from './deck-layouts.mjs'
13
+ import { writeWorkspaceJson } from './deck-store.mjs'
14
+
15
+ const BRAND_KIT_REL_PATH = join('.dsh-ppt', 'brand-kit.json')
16
+ const MAX_FORBIDDEN_TERMS = 40
17
+ const HEX_RE = /^#[0-9A-Fa-f]{6}$/
18
+
19
+ function cleanStr(value, maxLen = 160) {
20
+ return String(value ?? '').replace(/\s+/g, ' ').trim().slice(0, maxLen)
21
+ }
22
+
23
+ function cleanHex(value, field) {
24
+ if (value === undefined || value === null || value === '') return undefined
25
+ const s = String(value).trim()
26
+ if (!HEX_RE.test(s)) throw new Error(`dsh-ppt:brandKit.brand.${field} 需为 #RRGGBB 格式颜色:${s}`)
27
+ return s.toUpperCase()
28
+ }
29
+
30
+ export function normalizeBrandKit(raw) {
31
+ if (!raw || typeof raw !== 'object' || Array.isArray(raw)) {
32
+ throw new Error('dsh-ppt:brandKit 必须是对象')
33
+ }
34
+ const name = cleanStr(raw.name || raw.orgName || 'Corporate Brand Kit', 80)
35
+ const enforce = raw.enforce !== false
36
+ const theme = raw.theme ? cleanStr(raw.theme, 40) : undefined
37
+ const watermark = raw.watermark ? cleanStr(raw.watermark, 48) : undefined
38
+
39
+ const rawBrand = (raw.brand && typeof raw.brand === 'object' && !Array.isArray(raw.brand)) ? raw.brand : {}
40
+ const brand = {}
41
+ for (const ck of ['primaryColor', 'secondaryColor', 'backgroundColor', 'textColor', 'coverBg']) {
42
+ const h = cleanHex(rawBrand[ck], ck)
43
+ if (h) brand[ck] = h
44
+ }
45
+ for (const sk of ['name', 'fontFamily', 'headingFont', 'coverMode', 'footer', 'chromeStyle', 'cardMaterial', 'iconMode', 'taste', 'logo']) {
46
+ if (typeof rawBrand[sk] === 'string' && rawBrand[sk].trim()) {
47
+ brand[sk] = sk === 'logo' ? rawBrand[sk].trim() : cleanStr(rawBrand[sk], 160)
48
+ }
49
+ }
50
+ if (watermark) brand.watermark = watermark
51
+
52
+ const rawTerms = Array.isArray(raw.forbiddenTerms) ? raw.forbiddenTerms : []
53
+ const forbiddenTerms = [...new Set(
54
+ rawTerms
55
+ .map((t) => cleanStr(t, 48))
56
+ .filter((t) => t.length >= 2),
57
+ )].slice(0, MAX_FORBIDDEN_TERMS)
58
+
59
+ const normalizeSourceList = (arr) => [...new Set(
60
+ (Array.isArray(arr) ? arr : [])
61
+ .map((s) => cleanStr(s, 96).replace(/^https?:\/\//i, '').replace(/\/.*$/, '').toLowerCase())
62
+ .filter((s) => s.length >= 2),
63
+ )].slice(0, MAX_FORBIDDEN_TERMS)
64
+
65
+ const preferredSources = normalizeSourceList(raw.preferredSources)
66
+ const blockedDomains = normalizeSourceList(raw.blockedDomains)
67
+
68
+ let mandatoryClosing
69
+ if (raw.mandatoryClosing && typeof raw.mandatoryClosing === 'object' && !Array.isArray(raw.mandatoryClosing)) {
70
+ const mcTitle = cleanStr(raw.mandatoryClosing.title, 120)
71
+ const mcSub = cleanStr(raw.mandatoryClosing.subtitle, 200)
72
+ const mcKicker = cleanStr(raw.mandatoryClosing.kicker, 48)
73
+ if (mcTitle) {
74
+ mandatoryClosing = {
75
+ title: mcTitle,
76
+ ...(mcSub ? { subtitle: mcSub } : {}),
77
+ ...(mcKicker ? { kicker: mcKicker } : {}),
78
+ }
79
+ }
80
+ }
81
+
82
+ return {
83
+ schemaVersion: 1,
84
+ name,
85
+ enforce,
86
+ ...(theme ? { theme } : {}),
87
+ ...(Object.keys(brand).length > 0 ? { brand } : {}),
88
+ ...(watermark ? { watermark } : {}),
89
+ ...(forbiddenTerms.length > 0 ? { forbiddenTerms } : {}),
90
+ ...(preferredSources.length > 0 ? { preferredSources } : {}),
91
+ ...(blockedDomains.length > 0 ? { blockedDomains } : {}),
92
+ ...(mandatoryClosing ? { mandatoryClosing } : {}),
93
+ updatedAt: raw.updatedAt || new Date().toISOString(),
94
+ }
95
+ }
96
+
97
+ export function brandKitPathFor(cwd = '.') {
98
+ return join(resolve(cwd || '.'), BRAND_KIT_REL_PATH)
99
+ }
100
+
101
+ export function loadWorkspaceBrandKit(cwd = '.') {
102
+ const file = brandKitPathFor(cwd)
103
+ if (!existsSync(file)) return null
104
+ try {
105
+ const parsed = JSON.parse(readFileSync(file, 'utf8'))
106
+ return normalizeBrandKit(parsed)
107
+ } catch {
108
+ return null
109
+ }
110
+ }
111
+
112
+ export function saveWorkspaceBrandKit(cwd = '.', rawKit = {}) {
113
+ const file = brandKitPathFor(cwd)
114
+ const kit = normalizeBrandKit(rawKit)
115
+ writeWorkspaceJson(file, kit)
116
+ return { ok: true, path: file, brandKit: kit }
117
+ }
118
+
119
+ export function buildBrandKitFromAbsorbed(absorbed, options = {}) {
120
+ if (!absorbed || typeof absorbed !== 'object') {
121
+ throw new Error('dsh-ppt:缺少吸收结果,无法生成企业品牌宪章')
122
+ }
123
+ const sb = absorbed.sanitizedBrand || {}
124
+ return normalizeBrandKit({
125
+ name: options.name || sb.name || 'Corporate Brand Kit',
126
+ enforce: options.enforce !== false,
127
+ theme: absorbed.recommendedTheme || 'consulting',
128
+ brand: {
129
+ ...sb,
130
+ ...(absorbed.recommendedChrome && !sb.chromeStyle ? { chromeStyle: absorbed.recommendedChrome } : {}),
131
+ ...(options.footer ? { footer: options.footer } : {}),
132
+ },
133
+ ...(options.watermark ? { watermark: options.watermark } : {}),
134
+ ...(Array.isArray(options.forbiddenTerms) ? { forbiddenTerms: options.forbiddenTerms } : {}),
135
+ ...(Array.isArray(options.preferredSources) ? { preferredSources: options.preferredSources } : {}),
136
+ ...(Array.isArray(options.blockedDomains) ? { blockedDomains: options.blockedDomains } : {}),
137
+ ...(options.mandatoryClosing ? { mandatoryClosing: options.mandatoryClosing } : {}),
138
+ })
139
+ }
140
+
141
+ /**
142
+ * 将企业品牌宪章应用到建稿配置与幻灯片:
143
+ * - 品牌字段与水印合并(`enforce: true` 时锁定企业主色、字体、页脚与水印);
144
+ * - 若配置了 `mandatoryClosing` 且文稿末尾缺少封底或仅为空洞致谢页,自动补齐官方封底。
145
+ */
146
+ export function applyBrandKitToSlidesAndBrand(slides, brandInput, kit) {
147
+ if (!kit) return { slides, brandInput }
148
+ const kitBrand = kit.brand && typeof kit.brand === 'object' ? { ...kit.brand } : {}
149
+ if (kit.watermark && !kitBrand.watermark) kitBrand.watermark = kit.watermark
150
+
151
+ let nextBrand = brandInput
152
+ if (brandInput !== null) {
153
+ nextBrand = kit.enforce
154
+ ? { ...(brandInput || {}), ...kitBrand }
155
+ : { ...kitBrand, ...(brandInput || {}) }
156
+ }
157
+
158
+ let nextSlides = Array.isArray(slides) ? slides : []
159
+ if (kit.mandatoryClosing && nextSlides.length > 0) {
160
+ const last = nextSlides[nextSlides.length - 1]
161
+ const isBare = last?.layout === 'closing' && /^(?:谢谢|感谢(?:聆听|观看)?|thanks?|thank\s*you|q\s*&\s*a)[!!。.\s]*$/i.test(String(last.title || '').trim())
162
+ if (last?.layout !== 'closing') {
163
+ nextSlides = [
164
+ ...nextSlides,
165
+ {
166
+ layout: 'closing',
167
+ kicker: kit.mandatoryClosing.kicker || kit.name,
168
+ title: kit.mandatoryClosing.title,
169
+ ...(kit.mandatoryClosing.subtitle ? { subtitle: kit.mandatoryClosing.subtitle } : {}),
170
+ },
171
+ ]
172
+ } else if (isBare) {
173
+ nextSlides = [
174
+ ...nextSlides.slice(0, -1),
175
+ {
176
+ ...last,
177
+ kicker: last.kicker || kit.mandatoryClosing.kicker || kit.name,
178
+ title: kit.mandatoryClosing.title,
179
+ subtitle: last.subtitle || kit.mandatoryClosing.subtitle || '',
180
+ },
181
+ ]
182
+ }
183
+ }
184
+
185
+ return { slides: nextSlides, brandInput: nextBrand }
186
+ }
187
+
188
+ function collectSlidePlainText(slide) {
189
+ const parts = [
190
+ slide?.kicker,
191
+ slide?.title,
192
+ slide?.subtitle,
193
+ slide?.text,
194
+ slide?.takeaway,
195
+ slide?.source,
196
+ slide?.notes,
197
+ ...(Array.isArray(slide?.bullets) ? slide.bullets : []),
198
+ ]
199
+ if (Array.isArray(slide?.items)) {
200
+ for (const it of slide.items) {
201
+ if (!it || typeof it !== 'object') continue
202
+ parts.push(it.tag, it.title, it.value, it.delta, it.text)
203
+ if (Array.isArray(it.bullets)) parts.push(...it.bullets)
204
+ }
205
+ }
206
+ if (Array.isArray(slide?.rows)) {
207
+ for (const r of slide.rows) {
208
+ if (Array.isArray(r)) parts.push(...r)
209
+ }
210
+ }
211
+ return parts.filter((v) => v !== undefined && v !== null).map((v) => stripInlineMarkdown(String(v))).join(' ')
212
+ }
213
+
214
+ /**
215
+ * SLOP-14 企业品牌宪章与合规禁用词静态门禁(零误报)。
216
+ */
217
+ export function auditBrandCompliance(manifest, explicitKit = null) {
218
+ const issues = []
219
+ const kit = explicitKit || manifest?.brandKit || null
220
+ const slides = Array.isArray(manifest?.slides) ? manifest.slides : []
221
+ if (!kit || slides.length === 0) return issues
222
+
223
+ const forbidden = Array.isArray(kit.forbiddenTerms) ? kit.forbiddenTerms.filter((t) => typeof t === 'string' && t.trim().length >= 2) : []
224
+ if (forbidden.length > 0) {
225
+ slides.forEach((slide, i) => {
226
+ const hay = collectSlidePlainText(slide)
227
+ if (!hay) return
228
+ const hayLower = hay.toLowerCase()
229
+ const hits = forbidden.filter((term) => hayLower.includes(term.toLowerCase()))
230
+ if (hits.length > 0) {
231
+ issues.push({
232
+ slide: i + 1,
233
+ slideId: slide?.id,
234
+ severity: 'warning',
235
+ code: 'forbidden-brand-term',
236
+ message: `页面命中企业合规禁用词:${hits.map((h) => `「${h}」`).join('、')}(SLOP-14)`,
237
+ suggestion: '请替换为符合企业法务/品牌宪章的审慎表述(如将绝对化用语改为带口径范围的客观描述)',
238
+ })
239
+ }
240
+ })
241
+ }
242
+
243
+ if (kit.enforce && kit.brand?.primaryColor && manifest?.brand?.primaryColor) {
244
+ if (String(manifest.brand.primaryColor).toUpperCase() !== String(kit.brand.primaryColor).toUpperCase()) {
245
+ issues.push({
246
+ slide: 1,
247
+ slideId: slides[0]?.id,
248
+ severity: 'warning',
249
+ code: 'brand-palette-drift',
250
+ message: `当前主色 ${manifest.brand.primaryColor} 偏离企业品牌宪章锁定主色 ${kit.brand.primaryColor}(SLOP-14)`,
251
+ suggestion: `请将 brand.primaryColor 恢复为 ${kit.brand.primaryColor} 或显式关闭品牌宪章锁`,
252
+ })
253
+ }
254
+ }
255
+
256
+ return issues
257
+ }