專案變更總覽（你要做什麼）
✅ 新增檔案

src/aiClient.js：集中管理 OpenAI Client（之後各天都共用）。

src/promptPresets.js：常用提示詞模板（語氣、長度、格式控制）。

src/day2_text_generation.js：Day 2 主程式，參數化文字生成。

index.js：指令列入口，可選要跑哪個 day（今天預設跑 Day 2）。

♻️ 修改檔案

package.json：加入方便的 npm run day2 指令。

🗑️ 需要刪除 / 改名（擇一）

你昨天若只留有 index.js（Day 1 測試檔）：

建議改名成 src/day1_hello.js 保留紀錄；

或者你不想留：就刪除舊的 index.js（因為今天會放新的 index.js）。

若選擇保留 Day1：把昨天 index.js 檔名改為 src/day1_hello.js 即可，內容不用改。

新增／修改的程式碼

1. src/aiClient.js（新增）
   集中管理 OpenAI Client，之後每天都能重用。

// src/aiClient.js
import OpenAI from "openai";
import dotenv from "dotenv";

dotenv.config();

if (!process.env.OPENAI_API_KEY) {
throw new Error("OPENAI_API_KEY 未設定，請在 .env 加上你的金鑰。");
}

export const openai = new OpenAI({
apiKey: process.env.OPENAI_API_KEY,
});
2) src/promptPresets.js（新增）
整理可重用的 Prompt 模板與控制規則。

// src/promptPresets.js

// 長度控制說明
const LENGTH_HINT = {
short: "請控制在 80~120 字之內。",
medium: "請控制在 200~300 字之內。",
long: "請控制在 500~800 字之內，分段清楚。",
};

// 語氣控制說明
const TONE_HINT = {
friendly: "語氣親切、鼓勵式、貼近讀者。",
professional: "語氣專業、精煉，避免口語化。",
persuasive: "語氣具說服力，強調價值與行動。",
};

// 輸出格式控制
const FORMAT_HINT = {
plain: "以一般段落輸出，不需要條列。",
bullets: "請用條列式（- 開頭）輸出重點，最多 5 點。",
markdown: "請使用 Markdown 標題與小節清楚呈現。",
};

// 可選的主題預設
export const PRESETS = {
blog: ({ topic, tone, length, format }) => 你是一位資深技術部落客，請針對「${topic}」寫一段短文。 ${TONE_HINT[tone] ?? ""} ${LENGTH_HINT[length] ?? ""} ${FORMAT_HINT[format] ?? ""} 請避免虛構數據，聚焦實務價值。,
diary: ({ topic, tone, length, format }) => 你是一位工程師，正在撰寫今日學習日誌，主題：「${topic}」。 ${TONE_HINT[tone] ?? ""} ${LENGTH_HINT[length] ?? ""} ${FORMAT_HINT[format] ?? ""} 請包含：今天做了什麼、遇到的問題、下一步計畫。,
product: ({ topic, tone, length, format }) => 你是產品行銷，請為「${topic}」撰寫產品簡介。 ${TONE_HINT[tone] ?? ""} ${LENGTH_HINT[length] ?? ""} ${FORMAT_HINT[format] ?? ""} 請包含：目標用戶、核心賣點、使用情境、CTA。,
};

export const defaultParams = {
tone: "friendly", // friendly | professional | persuasive
length: "medium", // short | medium | long
format: "markdown", // plain | bullets | markdown
preset: "blog", // blog | diary | product
};
3) src/day2_text_generation.js（新增）
Day 2 主程式：把參數轉成可控輸出。

// src/day2_text_generation.js
import { openai } from "./aiClient.js";
import { PRESETS, defaultParams } from "./promptPresets.js";

/**

• 產生文字
• @param {Object} opts
• @param {string} opts.topic - 文章主題
• @param {string} [opts.preset] - 使用哪個模板（blog/diary/product）
• @param {string} [opts.tone] - 語氣（friendly/professional/persuasive）
• @param {string} [opts.length] - 長度（short/medium/long）
• @param {string} [opts.format] - 輸出格式（plain/bullets/markdown）
• @param {number} [opts.temperature] - 0~2，越高越有創意
• @param {number} [opts.max_tokens] - 生成的最大 token 數
  */
  export async function generateText(opts = {}) {
  const {
  topic = "今天的學習",
  preset = defaultParams.preset,
  tone = defaultParams.tone,
  length = defaultParams.length,
  format = defaultParams.format,
  temperature = 0.7,
  max_tokens = 600,
  } = opts;

const builder = PRESETS[preset];
if (!builder) throw new Error(未知的 preset：${preset});

const userPrompt = builder({ topic, tone, length, format });

const response = await openai.chat.completions.create({
model: "gpt-4o-mini",
temperature,
max_tokens,
messages: [
{
role: "system",
content:
"你是嚴謹可靠的中文寫作助手，輸出需具可讀性與實用性，避免編造事實。",
},
{ role: "user", content: userPrompt },
],
});

return response.choices?.[0]?.message?.content?.trim() ?? "";
}
4) index.js（新增/覆蓋）
提供 CLI 參數（之後也能當作 Node 腳本被 Next.js API 呼叫）。

// index.js
import { generateText } from "./src/day2_text_generation.js";

// 解析簡易 CLI 參數
// 範例：node index.js --topic "RAG 入門" --preset blog --tone professional --length short --format markdown --temp 0.6
const args = Object.fromEntries(
process.argv.slice(2).reduce((acc, cur, i, arr) => {
if (cur.startsWith("--")) {
const key = cur.replace(/^--/, "");
const val = arr[i + 1] && !arr[i + 1].startsWith("--") ? arr[i + 1] : true;
acc.push([key, val]);
}
return acc;
}, [])
);

async function main() {
const content = await generateText({
topic: args.topic || "生成式 AI 實戰挑戰 Day 2",
preset: args.preset || "blog",
tone: args.tone || "friendly",
length: args.length || "medium",
format: args.format || "markdown",
temperature: args.temp ? Number(args.temp) : 0.7,
max_tokens: args.max_tokens ? Number(args.max_tokens) : 600,
});

console.log("\n=== 生成內容 ===\n");
console.log(content);
}

main().catch((e) => {
console.error("發生錯誤：", e.message);
process.exit(1);
});
5) package.json（修改）
加入快捷指令（保留你原本的內容，只需新增 scripts）。

{
"scripts": {
"day2": "node index.js --topic "RAG 入門" --preset blog --tone professional --length short --format markdown --temp 0.6"
}
}
你也可以隨時換參數，例如：

npm run day2 -- --topic "用 LLM 做學習日誌" --preset diary --tone friendly --length medium --format bullets --temp 0.7
如何執行（測試）

推薦先把 Day1 改名保存（可選）

mv index.js src/day1_hello.js

node index.js --topic "用 LLM 生產部落格文章的注意事項" --preset blog --tone professional --length medium --format markdown --temp 0.5
你會得到一段 可控長度、語氣、格式 的 Markdown 文章。
（temp 越低越穩定，越高越有創意；max_tokens 可避免生成過多。）