clover-hackathon 0.1.0

package/dist/utils/cost.js

@@ -0,0 +1,48 @@
+// Token 成本估算（单价按各厂商公开定价，单位：美元 / 1M tokens）
+// 仅用于预算提醒，实际以账单为准；价格可随时在 PRICING 表调整。
+// 常见模型定价（美元 / 百万 token），新模型按需补充
+export const PRICING = {
+    // OpenAI
+    "gpt-4o": { inputPerM: 2.5, outputPerM: 10 },
+    "gpt-4o-mini": { inputPerM: 0.15, outputPerM: 0.6 },
+    "gpt-4.1": { inputPerM: 2, outputPerM: 8 },
+    "gpt-4.1-mini": { inputPerM: 0.4, outputPerM: 1.6 },
+    "o3": { inputPerM: 2, outputPerM: 8 },
+    "o4-mini": { inputPerM: 1.1, outputPerM: 4.4 },
+    // Anthropic
+    "claude-sonnet-4-5": { inputPerM: 3, outputPerM: 15 },
+    "claude-opus-4-1": { inputPerM: 15, outputPerM: 75 },
+    "claude-haiku-4-5": { inputPerM: 1, outputPerM: 5 },
+    // Google
+    "gemini-2.5-pro": { inputPerM: 1.25, outputPerM: 10 },
+    "gemini-2.5-flash": { inputPerM: 0.3, outputPerM: 2.5 },
+    // 本地/兼容接口默认按 0 计
+    "ollama": { inputPerM: 0, outputPerM: 0 },
+};
+/** 未收录模型时按此价格估算（保守偏高） */
+const FALLBACK = { inputPerM: 3, outputPerM: 15 };
+export function estimateCostUsd(usage, model) {
+    const price = PRICING[model] ?? FALLBACK;
+    return (usage.inputTokens * price.inputPerM + usage.outputTokens * price.outputPerM) / 1_000_000;
+}
+export function formatUsd(value) {
+    if (value < 0.01)
+        return "$" + value.toFixed(4);
+    return "$" + value.toFixed(2);
+}
+export function checkBudget(totalUsd, limitUsd) {
+    const ratio = limitUsd > 0 ? totalUsd / limitUsd : 0;
+    return {
+        totalUsd,
+        limitUsd,
+        ratio,
+        nearLimit: limitUsd > 0 && ratio >= 0.8,
+    };
+}
+export function addUsage(a, b) {
+    return {
+        inputTokens: a.inputTokens + b.inputTokens,
+        outputTokens: a.outputTokens + b.outputTokens,
+    };
+}
+//# sourceMappingURL=cost.js.map

package/dist/utils/cost.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cost.js","sourceRoot":"","sources":["../../src/utils/cost.ts"],"names":[],"mappings":"AAAA,2CAA2C;AAC3C,sCAAsC;AAStC,gCAAgC;AAChC,MAAM,CAAC,MAAM,OAAO,GAA+B;IACjD,SAAS;IACT,QAAQ,EAAE,EAAE,SAAS,EAAE,GAAG,EAAE,UAAU,EAAE,EAAE,EAAE;IAC5C,aAAa,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,UAAU,EAAE,GAAG,EAAE;IACnD,SAAS,EAAE,EAAE,SAAS,EAAE,CAAC,EAAE,UAAU,EAAE,CAAC,EAAE;IAC1C,cAAc,EAAE,EAAE,SAAS,EAAE,GAAG,EAAE,UAAU,EAAE,GAAG,EAAE;IACnD,IAAI,EAAE,EAAE,SAAS,EAAE,CAAC,EAAE,UAAU,EAAE,CAAC,EAAE;IACrC,SAAS,EAAE,EAAE,SAAS,EAAE,GAAG,EAAE,UAAU,EAAE,GAAG,EAAE;IAC9C,YAAY;IACZ,mBAAmB,EAAE,EAAE,SAAS,EAAE,CAAC,EAAE,UAAU,EAAE,EAAE,EAAE;IACrD,iBAAiB,EAAE,EAAE,SAAS,EAAE,EAAE,EAAE,UAAU,EAAE,EAAE,EAAE;IACpD,kBAAkB,EAAE,EAAE,SAAS,EAAE,CAAC,EAAE,UAAU,EAAE,CAAC,EAAE;IACnD,SAAS;IACT,gBAAgB,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,UAAU,EAAE,EAAE,EAAE;IACrD,kBAAkB,EAAE,EAAE,SAAS,EAAE,GAAG,EAAE,UAAU,EAAE,GAAG,EAAE;IACvD,iBAAiB;IACjB,QAAQ,EAAE,EAAE,SAAS,EAAE,CAAC,EAAE,UAAU,EAAE,CAAC,EAAE;CAC1C,CAAC;AAEF,yBAAyB;AACzB,MAAM,QAAQ,GAAe,EAAE,SAAS,EAAE,CAAC,EAAE,UAAU,EAAE,EAAE,EAAE,CAAC;AAE9D,MAAM,UAAU,eAAe,CAAC,KAAgB,EAAE,KAAa;IAC7D,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,IAAI,QAAQ,CAAC;IACzC,OAAO,CAAC,KAAK,CAAC,WAAW,GAAG,KAAK,CAAC,SAAS,GAAG,KAAK,CAAC,YAAY,GAAG,KAAK,CAAC,UAAU,CAAC,GAAG,SAAS,CAAC;AACnG,CAAC;AAED,MAAM,UAAU,SAAS,CAAC,KAAa;IACrC,IAAI,KAAK,GAAG,IAAI;QAAE,OAAO,GAAG,GAAG,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;IAChD,OAAO,GAAG,GAAG,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;AAChC,CAAC;AASD,MAAM,UAAU,WAAW,CAAC,QAAgB,EAAE,QAAgB;IAC5D,MAAM,KAAK,GAAG,QAAQ,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,GAAG,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC;IACrD,OAAO;QACL,QAAQ;QACR,QAAQ;QACR,KAAK;QACL,SAAS,EAAE,QAAQ,GAAG,CAAC,IAAI,KAAK,IAAI,GAAG;KACxC,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,QAAQ,CAAC,CAAY,EAAE,CAAY;IACjD,OAAO;QACL,WAAW,EAAE,CAAC,CAAC,WAAW,GAAG,CAAC,CAAC,WAAW;QAC1C,YAAY,EAAE,CAAC,CAAC,YAAY,GAAG,CAAC,CAAC,YAAY;KAC9C,CAAC;AACJ,CAAC"}

package/dist/utils/input.d.ts

@@ -0,0 +1,4 @@
+/** 读取一行输入；空输入时返回 fallback */
+export declare function askInput(question: string, fallback?: string): Promise<string>;
+/** 读取 y/n 确认，默认拒绝 */
+export declare function askYesNo(question: string): Promise<boolean>;

package/dist/utils/input.js

@@ -0,0 +1,37 @@
+// 统一输入：单个 readline 接口 + 行队列 + 等待者模式
+// 兼容交互式终端与管道快速输入；全局只建一个 readline，避免多模块抢 stdin 互相吞行。
+import readline from "node:readline";
+let sharedRl = null;
+const lineQueue = [];
+const lineWaiters = [];
+function initRl() {
+    if (sharedRl)
+        return;
+    sharedRl = readline.createInterface({ input: process.stdin, output: process.stdout });
+    sharedRl.on("line", (line) => {
+        const waiter = lineWaiters.shift();
+        if (waiter)
+            waiter(line);
+        else
+            lineQueue.push(line);
+    });
+}
+/** 读取一行输入；空输入时返回 fallback */
+export function askInput(question, fallback = "") {
+    initRl();
+    process.stdout.write(question + (fallback ? " (默认 " + fallback + ") " : " "));
+    return new Promise((resolve) => {
+        const deliver = (line) => resolve(line.trim() || fallback);
+        const queued = lineQueue.shift();
+        if (queued !== undefined)
+            deliver(queued);
+        else
+            lineWaiters.push(deliver);
+    });
+}
+/** 读取 y/n 确认，默认拒绝 */
+export async function askYesNo(question) {
+    const answer = (await askInput(question + " (y/n) ", "n")).trim().toLowerCase();
+    return answer === "y" || answer === "yes";
+}
+//# sourceMappingURL=input.js.map

package/dist/utils/input.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"input.js","sourceRoot":"","sources":["../../src/utils/input.ts"],"names":[],"mappings":"AAAA,oCAAoC;AACpC,oDAAoD;AAEpD,OAAO,QAAQ,MAAM,eAAe,CAAC;AAErC,IAAI,QAAQ,GAA8B,IAAI,CAAC;AAC/C,MAAM,SAAS,GAAa,EAAE,CAAC;AAC/B,MAAM,WAAW,GAAkC,EAAE,CAAC;AAEtD,SAAS,MAAM;IACb,IAAI,QAAQ;QAAE,OAAO;IACrB,QAAQ,GAAG,QAAQ,CAAC,eAAe,CAAC,EAAE,KAAK,EAAE,OAAO,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;IACtF,QAAQ,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,EAAE;QAC3B,MAAM,MAAM,GAAG,WAAW,CAAC,KAAK,EAAE,CAAC;QACnC,IAAI,MAAM;YAAE,MAAM,CAAC,IAAI,CAAC,CAAC;;YACpB,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC5B,CAAC,CAAC,CAAC;AACL,CAAC;AAED,6BAA6B;AAC7B,MAAM,UAAU,QAAQ,CAAC,QAAgB,EAAE,QAAQ,GAAG,EAAE;IACtD,MAAM,EAAE,CAAC;IACT,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,QAAQ,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC,OAAO,GAAG,QAAQ,GAAG,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;IAC9E,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE;QAC7B,MAAM,OAAO,GAAG,CAAC,IAAY,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,QAAQ,CAAC,CAAC;QACnE,MAAM,MAAM,GAAG,SAAS,CAAC,KAAK,EAAE,CAAC;QACjC,IAAI,MAAM,KAAK,SAAS;YAAE,OAAO,CAAC,MAAM,CAAC,CAAC;;YACrC,WAAW,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IACjC,CAAC,CAAC,CAAC;AACL,CAAC;AAED,qBAAqB;AACrB,MAAM,CAAC,KAAK,UAAU,QAAQ,CAAC,QAAgB;IAC7C,MAAM,MAAM,GAAG,CAAC,MAAM,QAAQ,CAAC,QAAQ,GAAG,SAAS,EAAE,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IAChF,OAAO,MAAM,KAAK,GAAG,IAAI,MAAM,KAAK,KAAK,CAAC;AAC5C,CAAC"}

package/dist/utils/logger.d.ts

@@ -0,0 +1,6 @@
+export declare function info(text: string): void;
+export declare function note(text: string): void;
+export declare function warn(text: string): void;
+export declare function error(text: string): void;
+export declare function ask(text: string): void;
+export declare function banner(text: string): void;

package/dist/utils/logger.js

@@ -0,0 +1,33 @@
+// 极简终端日志（无第三方依赖）
+const COLORS = {
+    reset: "\x1b[0m",
+    dim: "\x1b[2m",
+    green: "\x1b[32m",
+    yellow: "\x1b[33m",
+    red: "\x1b[31m",
+    cyan: "\x1b[36m",
+};
+function color(text, code) {
+    if (process.env.NO_COLOR)
+        return text;
+    return code + text + COLORS.reset;
+}
+export function info(text) {
+    console.log(color(text, COLORS.green));
+}
+export function note(text) {
+    console.log(color(text, COLORS.dim));
+}
+export function warn(text) {
+    console.log(color("⚠ " + text, COLORS.yellow));
+}
+export function error(text) {
+    console.error(color("✖ " + text, COLORS.red));
+}
+export function ask(text) {
+    console.log(color("? " + text, COLORS.cyan));
+}
+export function banner(text) {
+    console.log(color("🍀 " + text, COLORS.cyan));
+}
+//# sourceMappingURL=logger.js.map

package/dist/utils/logger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.js","sourceRoot":"","sources":["../../src/utils/logger.ts"],"names":[],"mappings":"AAAA,iBAAiB;AAEjB,MAAM,MAAM,GAAG;IACb,KAAK,EAAE,SAAS;IAChB,GAAG,EAAE,SAAS;IACd,KAAK,EAAE,UAAU;IACjB,MAAM,EAAE,UAAU;IAClB,GAAG,EAAE,UAAU;IACf,IAAI,EAAE,UAAU;CACR,CAAC;AAEX,SAAS,KAAK,CAAC,IAAY,EAAE,IAAY;IACvC,IAAI,OAAO,CAAC,GAAG,CAAC,QAAQ;QAAE,OAAO,IAAI,CAAC;IACtC,OAAO,IAAI,GAAG,IAAI,GAAG,MAAM,CAAC,KAAK,CAAC;AACpC,CAAC;AAED,MAAM,UAAU,IAAI,CAAC,IAAY;IAC/B,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;AACzC,CAAC;AAED,MAAM,UAAU,IAAI,CAAC,IAAY;IAC/B,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,EAAE,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC;AACvC,CAAC;AAED,MAAM,UAAU,IAAI,CAAC,IAAY;IAC/B,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,GAAG,IAAI,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC;AACjD,CAAC;AAED,MAAM,UAAU,KAAK,CAAC,IAAY;IAChC,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,GAAG,IAAI,EAAE,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC;AAChD,CAAC;AAED,MAAM,UAAU,GAAG,CAAC,IAAY;IAC9B,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,GAAG,IAAI,EAAE,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC;AAC/C,CAAC;AAED,MAAM,UAAU,MAAM,CAAC,IAAY;IACjC,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,KAAK,GAAG,IAAI,EAAE,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC;AAChD,CAAC"}

package/dist/utils/pet.d.ts

@@ -0,0 +1,9 @@
+export interface PetArt {
+    name: string;
+    caption: string;
+    lines: string[];
+}
+export declare const PETS: PetArt[];
+export declare function randomPet(): PetArt;
+export declare function findPet(name: string): PetArt | undefined;
+export declare function renderPet(pet: PetArt): string;

package/dist/utils/pet.js

@@ -0,0 +1,74 @@
+// 三叶草小宠物：颜文字风吉祥物（圆脸 + 豆豆眼 + ω 嘴）
+// 每场会话随机一个姿态出场，陪用户跑完整场黑客松。
+export const PETS = [
+    {
+        name: "idle",
+        caption: "Clover 在等你发号施令 🍀",
+        lines: [
+            "   /\\_/\\",
+            "  ( ◕   ◕ )",
+            "   > ω <",
+            "   U   U",
+        ],
+    },
+    {
+        name: "happy",
+        caption: "检查全过！今天也是幸运三叶草 ✨",
+        lines: [
+            "   /\\_/\\   *",
+            "  ( ⌣   ⌣ )",
+            "   > ω <",
+            "   U   U",
+        ],
+    },
+    {
+        name: "sleepy",
+        caption: "zZ… 别急，Clover 随时待命",
+        lines: [
+            "   /\\_/\\",
+            "  ( ⌒   ⌒ )  z",
+            "   > ω <",
+            "   U   U",
+        ],
+    },
+    {
+        name: "busy",
+        caption: "Clover 正在干活，稍等…",
+        lines: [
+            "   /\\_/\\",
+            "  ( ◉   ◉ )",
+            "   > ω <   %",
+            "   U   U",
+        ],
+    },
+    {
+        name: "sad",
+        caption: "啊哦，出了点小问题，再试一次？",
+        lines: [
+            "   /\\_/\\",
+            "  ( ;   ; )",
+            "   > ⌢ <",
+            "   U   U",
+        ],
+    },
+    {
+        name: "think",
+        caption: "Clover 正在思考…",
+        lines: [
+            "   /\\_/\\",
+            "  ( o   o )  ?",
+            "   > · <",
+            "   U   U",
+        ],
+    },
+];
+export function randomPet() {
+    return PETS[Math.floor(Math.random() * PETS.length)] ?? PETS[0];
+}
+export function findPet(name) {
+    return PETS.find((p) => p.name === name);
+}
+export function renderPet(pet) {
+    return pet.lines.join("\n");
+}
+//# sourceMappingURL=pet.js.map

package/dist/utils/pet.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pet.js","sourceRoot":"","sources":["../../src/utils/pet.ts"],"names":[],"mappings":"AAAA,iCAAiC;AACjC,2BAA2B;AAQ3B,MAAM,CAAC,MAAM,IAAI,GAAa;IAC5B;QACE,IAAI,EAAE,MAAM;QACZ,OAAO,EAAE,mBAAmB;QAC5B,KAAK,EAAE;YACL,YAAY;YACZ,aAAa;YACb,UAAU;YACV,UAAU;SACX;KACF;IACD;QACE,IAAI,EAAE,OAAO;QACb,OAAO,EAAE,kBAAkB;QAC3B,KAAK,EAAE;YACL,gBAAgB;YAChB,aAAa;YACb,UAAU;YACV,UAAU;SACX;KACF;IACD;QACE,IAAI,EAAE,QAAQ;QACd,OAAO,EAAE,oBAAoB;QAC7B,KAAK,EAAE;YACL,YAAY;YACZ,gBAAgB;YAChB,UAAU;YACV,UAAU;SACX;KACF;IACD;QACE,IAAI,EAAE,MAAM;QACZ,OAAO,EAAE,iBAAiB;QAC1B,KAAK,EAAE;YACL,YAAY;YACZ,aAAa;YACb,cAAc;YACd,UAAU;SACX;KACF;IACD;QACE,IAAI,EAAE,KAAK;QACX,OAAO,EAAE,iBAAiB;QAC1B,KAAK,EAAE;YACL,YAAY;YACZ,aAAa;YACb,UAAU;YACV,UAAU;SACX;KACF;IACD;QACE,IAAI,EAAE,OAAO;QACb,OAAO,EAAE,cAAc;QACvB,KAAK,EAAE;YACL,YAAY;YACZ,gBAAgB;YAChB,UAAU;YACV,UAAU;SACX;KACF;CACF,CAAC;AAEF,MAAM,UAAU,SAAS;IACvB,OAAO,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,EAAE,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC,CAAC,CAAC;AAClE,CAAC;AAED,MAAM,UAAU,OAAO,CAAC,IAAY;IAClC,OAAO,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,IAAI,CAAC,CAAC;AAC3C,CAAC;AAED,MAAM,UAAU,SAAS,CAAC,GAAW;IACnC,OAAO,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC9B,CAAC"}

package/package.json

@@ -0,0 +1,53 @@
+{
+  "name": "clover-hackathon",
+  "version": "0.1.0",
+  "description": "Clover（三叶草）— 专为黑客松比赛设计的命令行 AI Agent",
+  "keywords": [
+    "hackathon",
+    "agent",
+    "cli",
+    "ai",
+    "clover"
+  ],
+  "license": "MIT",
+  "type": "module",
+  "bin": {
+    "clover": "dist/index.js"
+  },
+  "files": [
+    "dist",
+    "src/templates",
+    "README.md",
+    "LICENSE"
+  ],
+  "engines": {
+    "node": ">=20"
+  },
+  "scripts": {
+    "dev": "tsx src/index.ts",
+    "build": "tsc -p tsconfig.json",
+    "typecheck": "tsc --noEmit",
+    "start": "node dist/index.js",
+    "test": "node --test",
+    "prepublishOnly": "npm run typecheck && npm run build"
+  },
+  "dependencies": {
+    "commander": "^12.1.0",
+    "dotenv": "^16.4.5",
+    "zod": "^3.23.8"
+  },
+  "devDependencies": {
+    "@types/node": "^22.5.0",
+    "tsx": "^4.19.0",
+    "typescript": "^5.6.0"
+  },
+  "author": "QundaiCai314",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/QundaiCai314/clover-hack.git"
+  },
+  "homepage": "https://github.com/QundaiCai314/clover-hack",
+  "bugs": {
+    "url": "https://github.com/QundaiCai314/clover-hack/issues"
+  }
+}

package/src/templates/pitch.md

@@ -0,0 +1,30 @@
+# {{name}} — 3 分钟 Pitch 稿
+
+## 开场钩子（15 秒）
+
+<!-- 一句话抓住注意力：数据冲击 / 反常识 / 故事 -->
+
+## 问题与痛点（30 秒）
+
+<!-- 谁、在什么场景、遇到了什么痛 -->
+
+## 解决方案与 Demo 亮点（90 秒）
+
+<!-- 讲清核心机制，按演示顺序列出 2-3 个亮点 -->
+
+## 市场与独特价值（30 秒）
+
+<!-- 市场规模一句话 + 与竞品的差异 -->
+
+## 收尾 Call to Action（15 秒）
+
+<!-- 希望评委记住什么、后续计划 -->
+
+## 评委可能问的 5 个问题
+
+1. 
+2. 
+3. 
+4. 
+5. 
+

package/src/templates/readme.md

@@ -0,0 +1,36 @@
+# {{name}}
+
+> 黑客松参赛项目
+
+## 一句话简介
+
+<!-- 用一句话说明这个项目解决什么问题 -->
+
+## 演示
+
+<!-- 贴 demo 视频/GIF 链接，或本地 demo.mp4 -->
+
+## 技术栈
+
+- 
+
+## 快速开始
+
+```bash
+# 安装依赖
+# 启动项目
+```
+
+## 功能亮点
+
+- 
+
+## 灵感来源
+
+<!-- 为什么做这个、解决谁的什么问题 -->
+
+## 链接
+
+- 比赛：[{{url}}]({{url}})
+- 提交截止：{{deadline}}
+

package/src/templates/submission.md

@@ -0,0 +1,40 @@
+# {{name}} — 提交说明
+
+## 项目名称
+
+{{name}}
+
+## 项目简介
+
+<!-- 150 字以内，说清楚做什么、给谁用、为什么特别 -->
+
+## 赛道/主题
+
+<!-- 参赛赛道或主题 -->
+
+## 技术栈
+
+<!-- 语言/框架/服务 -->
+
+## 演示方式
+
+- Demo 视频：<!-- 链接 -->
+- 在线体验：<!-- 链接（如有） -->
+- 本地运行：<!-- 启动步骤 -->
+
+## 亮点
+
+1. 
+2. 
+3. 
+
+## 团队与分工
+
+<!-- 单人：个人简介即可 -->
+
+## 开源地址
+
+<!-- GitHub 仓库链接 -->
+
+> 比赛链接：{{url}} · 截止：{{deadline}}
+

package/src/templates/timeline.md

@@ -0,0 +1,28 @@
+# {{name}} — 时间线规划（共 {{duration}} 小时）
+
+## 阶段 1：热身与赛题（第 0-2 小时）
+
+- [ ] 解析赛题、整理评分标准
+- [ ] 生成 5 个点子并评估
+- [ ] 选定点子，输出 MVP 计划
+
+## 阶段 2：MVP 核心（第 2-12 小时）
+
+- [ ] 搭好项目骨架与 CI
+- [ ] 完成 P0 功能 1
+- [ ] 完成 P0 功能 2
+
+## 阶段 3：打磨（第 12-36 小时）
+
+- [ ] 完成 P1 功能
+- [ ] 修 bug、补边界情况
+- [ ] 性能/体验优化
+
+## 阶段 4：演示准备（最后 6 小时）
+
+- [ ] 录制 demo 视频
+- [ ] 写 README 与提交说明
+- [ ] 排练 Pitch
+- [ ] 提交检查清单全过一遍
+- [ ] 提交！🍀
+