@lemonppt/cli 0.1.1 → 0.1.2
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.
- package/SKILL.md +40 -6
- package/package.json +5 -5
package/SKILL.md
CHANGED
|
@@ -11,7 +11,19 @@
|
|
|
11
11
|
|
|
12
12
|
## 使用流程
|
|
13
13
|
|
|
14
|
-
用户说"帮我做一份 PPT"
|
|
14
|
+
用户说"帮我做一份 PPT"时，按以下步骤执行：
|
|
15
|
+
|
|
16
|
+
### 0. 收集关键信息（可选但强烈建议）
|
|
17
|
+
|
|
18
|
+
如果用户只给了一句话主题，先追问以下信息，让最终 PPT 更贴合：
|
|
19
|
+
|
|
20
|
+
- **演示目标**（goal）：这场 PPT 希望达成什么？（如融资路演、产品发布、内部汇报）
|
|
21
|
+
- **目标受众**（audience）：听众是谁？（如投资人、客户、内部团队）
|
|
22
|
+
- **核心卖点/关键数据**：有没有必须突出的指标、功能或案例？
|
|
23
|
+
- **页数**：建议 6~20 页
|
|
24
|
+
- **主题风格**：`base`（极简商务）、`dark-tech`（深色科技）、`warm-business`（温暖商务）
|
|
25
|
+
- **语言**：`zh` 或 `en`
|
|
26
|
+
- **API Key**：如果有 OpenAI 兼容 API Key，生成内容会更贴合主题；没有则使用内置 fallback 示例
|
|
15
27
|
|
|
16
28
|
### 1. 生成 goal.json
|
|
17
29
|
|
|
@@ -24,6 +36,12 @@ lemonppt generate "<主题>" --pages <页数> --theme <主题> --language zh --o
|
|
|
24
36
|
- `--language`：`zh` 或 `en`
|
|
25
37
|
- `--api-key`：可选，OpenAI 兼容 API Key；不传则使用内置 fallback 示例
|
|
26
38
|
|
|
39
|
+
**生成前，把收集到的信息组织成更具体的主题描述**。例如：
|
|
40
|
+
|
|
41
|
+
```bash
|
|
42
|
+
lemonppt generate "面向企业客户的 AI 助手产品发布会，强调效率提升 10 倍、支持私有化部署、已有 50 家客户" --pages 8 --theme base --language zh --out ./goal.json
|
|
43
|
+
```
|
|
44
|
+
|
|
27
45
|
### 2. 导出 PPTX / PDF
|
|
28
46
|
|
|
29
47
|
```bash
|
|
@@ -38,6 +56,10 @@ lemonppt export ./goal.json --pptx ./deck.pptx --pdf ./deck.pdf
|
|
|
38
56
|
|
|
39
57
|
如果用户只需要文件，交付 PPTX/PDF；如果用户想在线预览，交付 HTML。
|
|
40
58
|
|
|
59
|
+
**交付时说明内容来源**：
|
|
60
|
+
- 如果使用了 API Key："内容已根据你的主题自动生成，可进一步编辑。"
|
|
61
|
+
- 如果没有 API Key："当前使用内置示例内容生成，结构和版式完整。如需更贴合主题的文案，请提供 OpenAI 兼容 API Key 后重新生成。"
|
|
62
|
+
|
|
41
63
|
## goal.json 格式
|
|
42
64
|
|
|
43
65
|
```json
|
|
@@ -136,15 +158,26 @@ Agent 选页时只需指定 `role`，系统会根据角色自动挑选合适版
|
|
|
136
158
|
|
|
137
159
|
## 常见错误处理
|
|
138
160
|
|
|
139
|
-
1. **没有 API Key**：`lemonppt generate` 会 fallback
|
|
140
|
-
2.
|
|
141
|
-
3.
|
|
142
|
-
4.
|
|
161
|
+
1. **没有 API Key**：`lemonppt generate` 会 fallback 到内置示例内容，仍可生成完整文件。但示例内容可能偏通用，无法紧密贴合你的主题。建议提供 `--api-key` 以获得更专业的文案。
|
|
162
|
+
2. **生成内容偏离主题**：把主题描述写得更具体，补充目标受众、核心卖点、关键数据。例如不要只写 `"AI 助手"`，而是写 `"面向企业客户的 AI 助手产品发布会，强调效率提升 10 倍、支持私有化部署"`。
|
|
163
|
+
3. **页数太少**：建议封面 + 目录 + 3~5 页内容 + 结尾，最少 5 页。
|
|
164
|
+
4. **远程图片在 PPTX 中不显示**：PPTX 导出优先使用本地图片或 base64；远程 URL 会显示占位符。
|
|
165
|
+
5. **生成失败**：检查 JSON 是否合法、`slides.length` 是否等于 `pageCount`。
|
|
143
166
|
|
|
144
167
|
## 完整示例
|
|
145
168
|
|
|
169
|
+
### 示例 1：有 API Key（推荐）
|
|
170
|
+
|
|
171
|
+
```bash
|
|
172
|
+
lemonppt generate "面向企业客户的 AI 助手产品发布会，核心卖点：效率提升 10 倍、支持私有化部署、服务 50+ 标杆客户" --pages 8 --theme base --language zh --api-key $OPENAI_API_KEY --out ./ai-launch.json
|
|
173
|
+
lemonppt render ./ai-launch.json --out ./output
|
|
174
|
+
lemonppt export ./ai-launch.json --pptx ./ai-launch.pptx --pdf ./ai-launch.pdf
|
|
175
|
+
```
|
|
176
|
+
|
|
177
|
+
### 示例 2：无 API Key（结构和版式完整，内容偏通用）
|
|
178
|
+
|
|
146
179
|
```bash
|
|
147
|
-
lemonppt generate "AI 助手产品发布会" --pages 8 --theme
|
|
180
|
+
lemonppt generate "AI 助手产品发布会" --pages 8 --theme base --language zh --out ./ai-launch.json
|
|
148
181
|
lemonppt render ./ai-launch.json --out ./output
|
|
149
182
|
lemonppt export ./ai-launch.json --pptx ./ai-launch.pptx --pdf ./ai-launch.pdf
|
|
150
183
|
```
|
|
@@ -153,4 +186,5 @@ lemonppt export ./ai-launch.json --pptx ./ai-launch.pptx --pdf ./ai-launch.pdf
|
|
|
153
186
|
|
|
154
187
|
- 不要手动指定每个 slide 的 `layout`，优先只写 `role`。
|
|
155
188
|
- `goal.json` 是核心协议，生成后可以直接交给用户修改再导出。
|
|
189
|
+
- 一句话主题生成的内容可能偏通用；如需专业文案，补充目标受众、核心卖点、关键数据，或传入 `--api-key`。
|
|
156
190
|
- 所有命令在 lemonPPT 项目根目录执行；CLI 入口为 `packages/cli/dist/cli.js` 或安装后的 `lemonppt`。
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@lemonppt/cli",
|
|
3
|
-
"version": "0.1.
|
|
3
|
+
"version": "0.1.2",
|
|
4
4
|
"type": "module",
|
|
5
5
|
"main": "./dist/index.js",
|
|
6
6
|
"types": "./dist/index.d.ts",
|
|
@@ -30,10 +30,10 @@
|
|
|
30
30
|
},
|
|
31
31
|
"homepage": "https://github.com/lemonforme/lemonPPT#readme",
|
|
32
32
|
"dependencies": {
|
|
33
|
-
"@lemonppt/agent-prompts": "0.1.
|
|
34
|
-
"@lemonppt/core": "0.1.
|
|
35
|
-
"@lemonppt/
|
|
36
|
-
"@lemonppt/
|
|
33
|
+
"@lemonppt/agent-prompts": "0.1.2",
|
|
34
|
+
"@lemonppt/core": "0.1.2",
|
|
35
|
+
"@lemonppt/renderer": "0.1.2",
|
|
36
|
+
"@lemonppt/themes": "0.1.2"
|
|
37
37
|
},
|
|
38
38
|
"devDependencies": {
|
|
39
39
|
"@types/node": "^20.0.0",
|