clover-hackathon 0.1.0

package/dist/cli/index.js

@@ -0,0 +1,205 @@
+// CLI 入口：注册所有 clover 子命令
+import { Command } from "commander";
+import { cmdInit, cmdNew, cmdArchiveList, cmdConfig, cmdModels, cmdSessions, cmdStatus, cmdCheck, cmdTemplate, cmdAnalyze, cmdIdeate, cmdEvaluate, cmdPlan, cmdPitch, cmdReview, cmdStart } from "./commands.js";
+export async function runCli() {
+    const program = new Command();
+    program
+        .name("clover")
+        .description("🍀 Clover — 专为黑客松比赛设计的命令行 AI Agent")
+        .version("0.1.0");
+    program
+        .command("init")
+        .description("在当前目录初始化比赛项目")
+        .action(async () => {
+        try {
+            await cmdInit();
+        }
+        catch (err) {
+            console.error("✖ " + (err instanceof Error ? err.message : err));
+            process.exitCode = 1;
+        }
+    });
+    program
+        .command("new <name>")
+        .description("创建新比赛档案目录")
+        .action(async (name) => {
+        try {
+            await cmdNew(name);
+        }
+        catch (err) {
+            console.error("✖ " + (err instanceof Error ? err.message : err));
+            process.exitCode = 1;
+        }
+    });
+    program
+        .command("archive")
+        .description("历史比赛档案")
+        .argument("[list]", "子命令，目前仅支持 list")
+        .action(async () => {
+        try {
+            await cmdArchiveList();
+        }
+        catch (err) {
+            console.error("✖ " + (err instanceof Error ? err.message : err));
+            process.exitCode = 1;
+        }
+    });
+    program
+        .command("config")
+        .description("配置向导：模型、API Key、语言、预算、竞速模式")
+        .action(async () => {
+        try {
+            await cmdConfig();
+        }
+        catch (err) {
+            console.error("✖ " + (err instanceof Error ? err.message : err));
+            process.exitCode = 1;
+        }
+    });
+    program
+        .command("models")
+        .description("查看模型配置")
+        .action(() => {
+        try {
+            cmdModels();
+        }
+        catch (err) {
+            console.error("✖ " + (err instanceof Error ? err.message : err));
+            process.exitCode = 1;
+        }
+    });
+    program
+        .command("status")
+        .description("比赛状态：倒计时/预算/模式")
+        .action(() => {
+        try {
+            cmdStatus();
+        }
+        catch (err) {
+            console.error("✖ " + (err instanceof Error ? err.message : err));
+            process.exitCode = 1;
+        }
+    });
+    program
+        .command("analyze [source]")
+        .description("解析赛题（文件路径 / URL / 直接粘贴文本）")
+        .action(async (source) => {
+        try {
+            await cmdAnalyze(source);
+        }
+        catch (err) {
+            console.error("✖ " + (err instanceof Error ? err.message : err));
+            process.exitCode = 1;
+        }
+    });
+    program
+        .command("ideate")
+        .description("基于赛题生成项目点子")
+        .action(async () => {
+        try {
+            await cmdIdeate();
+        }
+        catch (err) {
+            console.error("✖ " + (err instanceof Error ? err.message : err));
+            process.exitCode = 1;
+        }
+    });
+    program
+        .command("evaluate [idea]")
+        .description("点子评估：合理性 + 市场分析（蓝海/红海）")
+        .action(async (idea) => {
+        try {
+            await cmdEvaluate(idea);
+        }
+        catch (err) {
+            console.error("✖ " + (err instanceof Error ? err.message : err));
+            process.exitCode = 1;
+        }
+    });
+    program
+        .command("plan")
+        .description("MVP 规划")
+        .action(async () => {
+        try {
+            await cmdPlan();
+        }
+        catch (err) {
+            console.error("✖ " + (err instanceof Error ? err.message : err));
+            process.exitCode = 1;
+        }
+    });
+    program
+        .command("pitch")
+        .description("生成 Pitch 演讲稿")
+        .action(async () => {
+        try {
+            await cmdPitch();
+        }
+        catch (err) {
+            console.error("✖ " + (err instanceof Error ? err.message : err));
+            process.exitCode = 1;
+        }
+    });
+    program
+        .command("template <type>")
+        .description("生成模板文档：readme / pitch / submission / timeline")
+        .action((type) => {
+        try {
+            cmdTemplate(type);
+        }
+        catch (err) {
+            console.error("✖ " + (err instanceof Error ? err.message : err));
+            process.exitCode = 1;
+        }
+    });
+    program
+        .command("check")
+        .description("提交前检查清单")
+        .action(async () => {
+        try {
+            await cmdCheck();
+        }
+        catch (err) {
+            console.error("✖ " + (err instanceof Error ? err.message : err));
+            process.exitCode = 1;
+        }
+    });
+    program
+        .command("review")
+        .description("赛后复盘报告")
+        .action(async () => {
+        try {
+            await cmdReview();
+        }
+        catch (err) {
+            console.error("✖ " + (err instanceof Error ? err.message : err));
+            process.exitCode = 1;
+        }
+    });
+    program
+        .command("sessions [id]")
+        .description("查看历史会话（无参=列表，带ID=详情）")
+        .action((id) => {
+        try {
+            cmdSessions(id);
+        }
+        catch (err) {
+            console.error("✖ " + (err instanceof Error ? err.message : err));
+            process.exitCode = 1;
+        }
+    });
+    program
+        .command("start")
+        .description("进入 Clover 对话模式")
+        .action(async () => {
+        try {
+            await cmdStart();
+        }
+        catch (err) {
+            console.error("✖ " + (err instanceof Error ? err.message : err));
+            process.exitCode = 1;
+        }
+    });
+    program.parseAsync(process.argv);
+}
+//# sourceMappingURL=index.js.map

package/dist/cli/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/cli/index.ts"],"names":[],"mappings":"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"}

package/dist/core/agent.d.ts

@@ -0,0 +1,27 @@
+import type { ModelProvider } from "../models/provider.js";
+import type { ImageBlock, SessionRecord } from "../types.js";
+/** 命令审批器：执行 run_command 前需要用户确认 */
+export interface CommandApprover {
+    approve(command: string): Promise<boolean>;
+}
+export interface AgentOptions {
+    provider: ModelProvider;
+    session: SessionRecord;
+    budgetUsd: number;
+    permissions?: CommandApprover;
+}
+export declare class Agent {
+    private readonly options;
+    private readonly messages;
+    constructor(options: AgentOptions);
+    /** 发送一轮对话：模型可多次调用工具，直至给出最终回答 */
+    turn(userInput: string, images?: ImageBlock[]): Promise<string>;
+    private account;
+    private executeTool;
+    /** 总用量统计 */
+    usage(): {
+        costUsd: number;
+        inputTokens: number;
+        outputTokens: number;
+    };
+}

package/dist/core/agent.js

@@ -0,0 +1,108 @@
+// Agent 主循环：M2 已接入工具调用（读写文件、执行命令）与权限确认
+import { appendMessage, saveSession } from "./session.js";
+import { checkBudget, formatUsd } from "../utils/cost.js";
+import { note, warn } from "../utils/logger.js";
+import { findTool, TOOLS } from "./tools.js";
+const SYSTEM_PROMPT = [
+    "你是 Clover，一个专为黑客松比赛设计的 AI 搭档。",
+    "你会帮助用户：解析赛题、生成与评估点子、规划 MVP、管理时间、检查提交材料、准备 Pitch。",
+    "你可以在项目目录里读写文件、执行终端命令，真正动手完成开发任务。",
+    "默认使用中文交流（除非用户要求其他语言）。回答要简洁、可执行、紧扣黑客松时间有限的特点。",
+].join("\n");
+const MAX_TOOL_ROUNDS = 10;
+export class Agent {
+    options;
+    messages;
+    constructor(options) {
+        this.options = options;
+        this.messages = [
+            { role: "system", content: SYSTEM_PROMPT },
+            ...options.session.messages,
+        ];
+    }
+    /** 发送一轮对话：模型可多次调用工具，直至给出最终回答 */
+    async turn(userInput, images) {
+        const { provider, session, budgetUsd, permissions } = this.options;
+        const userMessage = { role: "user", content: userInput };
+        if (images && images.length > 0)
+            userMessage.images = images;
+        appendMessage(session, userMessage);
+        this.messages.push(userMessage);
+        let finalText = "";
+        let turnCost = 0;
+        for (let round = 0; round < MAX_TOOL_ROUNDS; round++) {
+            const result = await provider.chat(this.messages, { tools: TOOLS });
+            turnCost += result.estimatedCostUsd;
+            this.account(session, result);
+            const assistantMessage = { role: "assistant", content: result.content };
+            if (result.toolCalls && result.toolCalls.length > 0) {
+                assistantMessage.toolCalls = result.toolCalls;
+            }
+            appendMessage(session, assistantMessage);
+            this.messages.push(assistantMessage);
+            if (!assistantMessage.toolCalls || assistantMessage.toolCalls.length === 0) {
+                finalText = result.content;
+                break;
+            }
+            for (const call of assistantMessage.toolCalls) {
+                const toolResult = await this.executeTool(call, permissions);
+                note("🔧 " + call.name + " → " + summarize(toolResult));
+                const toolMessage = {
+                    role: "tool",
+                    toolCallId: call.id,
+                    name: call.name,
+                    content: toolResult.ok ? toolResult.output : "ERROR: " + toolResult.output,
+                };
+                appendMessage(session, toolMessage);
+                this.messages.push(toolMessage);
+            }
+        }
+        if (!finalText) {
+            warn("工具调用超过 " + MAX_TOOL_ROUNDS + " 轮，已停止");
+            finalText = "（工具调用过多已停止，请重新描述你的目标）";
+        }
+        saveSession(session);
+        const status = checkBudget(session.totalCostUsd, budgetUsd);
+        note("本次: " + formatUsd(turnCost) + " · 累计: " + formatUsd(session.totalCostUsd));
+        if (status.nearLimit) {
+            warn("已接近预算上限（" + formatUsd(budgetUsd) + "），请留意成本");
+        }
+        return finalText;
+    }
+    account(session, result) {
+        session.totalInputTokens += result.usage.inputTokens;
+        session.totalOutputTokens += result.usage.outputTokens;
+        session.totalCostUsd += result.estimatedCostUsd;
+    }
+    async executeTool(call, permissions) {
+        const tool = findTool(call.name);
+        if (!tool)
+            return { ok: false, output: "未知工具: " + call.name };
+        // 各家参数可能是对象/数字等，统一字符串化后传给工具
+        const args = {};
+        for (const [key, value] of Object.entries(call.args ?? {})) {
+            args[key] = value == null ? undefined : typeof value === "string" ? value : JSON.stringify(value);
+        }
+        if (tool.name === "run_command" && permissions) {
+            const approved = await permissions.approve(args.command ?? "");
+            if (!approved) {
+                return { ok: false, output: "用户拒绝了命令执行" };
+            }
+        }
+        return tool.run(args);
+    }
+    /** 总用量统计 */
+    usage() {
+        const u = {
+            inputTokens: this.options.session.totalInputTokens,
+            outputTokens: this.options.session.totalOutputTokens,
+        };
+        return { ...u, costUsd: this.options.session.totalCostUsd };
+    }
+}
+function summarize(toolResult) {
+    const first = toolResult.output.split("\n")[0]?.trim() || (toolResult.ok ? "完成" : "失败");
+    const short = first.length > 60 ? first.slice(0, 60) + "…" : first;
+    return toolResult.ok ? short : "失败: " + short;
+}
+//# sourceMappingURL=agent.js.map

package/dist/core/agent.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent.js","sourceRoot":"","sources":["../../src/core/agent.ts"],"names":[],"mappings":"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"}

package/dist/core/permissions.d.ts

@@ -0,0 +1,9 @@
+import type { CloverConfig } from "../types.js";
+export declare class PermissionManager {
+    private readonly config;
+    private allowed;
+    constructor(config: CloverConfig);
+    /** 检查命令是否可执行：竞速模式 + 已批准前缀 → 自动放行；否则询问用户 */
+    approve(command: string): Promise<boolean>;
+    listAllowed(): string[];
+}

package/dist/core/permissions.js

@@ -0,0 +1,45 @@
+// 命令权限：默认需确认；竞速模式自动放行；已批准前缀不再询问
+// 批准规则持久化在项目 .clover/allowed-commands.json
+import fs from "node:fs";
+import path from "node:path";
+import { askYesNo } from "../utils/input.js";
+const ALLOWED_FILE = path.join(".clover", "allowed-commands.json");
+function loadAllowed() {
+    if (!fs.existsSync(ALLOWED_FILE))
+        return [];
+    try {
+        return JSON.parse(fs.readFileSync(ALLOWED_FILE, "utf8"));
+    }
+    catch {
+        return [];
+    }
+}
+function saveAllowed(prefixes) {
+    fs.mkdirSync(path.dirname(ALLOWED_FILE), { recursive: true });
+    fs.writeFileSync(ALLOWED_FILE, JSON.stringify(prefixes, null, 2), "utf8");
+}
+export class PermissionManager {
+    config;
+    allowed = loadAllowed();
+    constructor(config) {
+        this.config = config;
+    }
+    /** 检查命令是否可执行：竞速模式 + 已批准前缀 → 自动放行；否则询问用户 */
+    async approve(command) {
+        if (this.config.speedMode)
+            return true;
+        const head = command.trim().split(/\s+/)[0] ?? "";
+        if (this.allowed.includes(head))
+            return true;
+        const ok = await askYesNo("允许执行命令？ " + command.slice(0, 120));
+        if (ok && head) {
+            this.allowed.push(head);
+            saveAllowed(this.allowed);
+        }
+        return ok;
+    }
+    listAllowed() {
+        return [...this.allowed];
+    }
+}
+//# sourceMappingURL=permissions.js.map

package/dist/core/permissions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"permissions.js","sourceRoot":"","sources":["../../src/core/permissions.ts"],"names":[],"mappings":"AAAA,gCAAgC;AAChC,2CAA2C;AAE3C,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,IAAI,MAAM,WAAW,CAAC;AAE7B,OAAO,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAE7C,MAAM,YAAY,GAAG,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,uBAAuB,CAAC,CAAC;AAEnE,SAAS,WAAW;IAClB,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,YAAY,CAAC;QAAE,OAAO,EAAE,CAAC;IAC5C,IAAI,CAAC;QACH,OAAO,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,YAAY,CAAC,YAAY,EAAE,MAAM,CAAC,CAAa,CAAC;IACvE,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,CAAC;IACZ,CAAC;AACH,CAAC;AAED,SAAS,WAAW,CAAC,QAAkB;IACrC,EAAE,CAAC,SAAS,CAAC,IAAI,CAAC,OAAO,CAAC,YAAY,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAC9D,EAAE,CAAC,aAAa,CAAC,YAAY,EAAE,IAAI,CAAC,SAAS,CAAC,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC;AAC5E,CAAC;AAED,MAAM,OAAO,iBAAiB;IAGC;IAFrB,OAAO,GAAG,WAAW,EAAE,CAAC;IAEhC,YAA6B,MAAoB;QAApB,WAAM,GAAN,MAAM,CAAc;IAAG,CAAC;IAErD,2CAA2C;IAC3C,KAAK,CAAC,OAAO,CAAC,OAAe;QAC3B,IAAI,IAAI,CAAC,MAAM,CAAC,SAAS;YAAE,OAAO,IAAI,CAAC;QACvC,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;QAClD,IAAI,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC;YAAE,OAAO,IAAI,CAAC;QAC7C,MAAM,EAAE,GAAG,MAAM,QAAQ,CAAC,UAAU,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC;QAC9D,IAAI,EAAE,IAAI,IAAI,EAAE,CAAC;YACf,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YACxB,WAAW,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QAC5B,CAAC;QACD,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,WAAW;QACT,OAAO,CAAC,GAAG,IAAI,CAAC,OAAO,CAAC,CAAC;IAC3B,CAAC;CACF"}

package/dist/core/session.d.ts

@@ -0,0 +1,7 @@
+import type { ChatMessage, SessionRecord } from "../types.js";
+export declare function createSession(): SessionRecord;
+export declare function saveSession(session: SessionRecord): void;
+export declare function loadSession(id: string): SessionRecord | null;
+export declare function listSessions(): SessionRecord[];
+export declare function latestSession(): SessionRecord | null;
+export declare function appendMessage(session: SessionRecord, message: ChatMessage): void;

package/dist/core/session.js

@@ -0,0 +1,42 @@
+// 会话持久化：.clover/sessions/<id>.json，支持恢复
+import fs from "node:fs";
+import path from "node:path";
+import crypto from "node:crypto";
+import { readJsonFile, writeJsonFile } from "../utils/config.js";
+const SESSIONS_DIR = path.join(".clover", "sessions");
+export function createSession() {
+    const now = new Date().toISOString();
+    return {
+        id: crypto.randomUUID(),
+        startedAt: now,
+        updatedAt: now,
+        messages: [],
+        totalInputTokens: 0,
+        totalOutputTokens: 0,
+        totalCostUsd: 0,
+    };
+}
+export function saveSession(session) {
+    writeJsonFile(path.join(SESSIONS_DIR, session.id + ".json"), session);
+}
+export function loadSession(id) {
+    return readJsonFile(path.join(SESSIONS_DIR, id + ".json"));
+}
+export function listSessions() {
+    if (!fs.existsSync(SESSIONS_DIR))
+        return [];
+    return fs
+        .readdirSync(SESSIONS_DIR)
+        .filter((f) => f.endsWith(".json"))
+        .map((f) => readJsonFile(path.join(SESSIONS_DIR, f)))
+        .filter((s) => s !== null)
+        .sort((a, b) => b.updatedAt.localeCompare(a.updatedAt));
+}
+export function latestSession() {
+    return listSessions()[0] ?? null;
+}
+export function appendMessage(session, message) {
+    session.messages.push(message);
+    session.updatedAt = new Date().toISOString();
+}
+//# sourceMappingURL=session.js.map

package/dist/core/session.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"session.js","sourceRoot":"","sources":["../../src/core/session.ts"],"names":[],"mappings":"AAAA,wCAAwC;AAExC,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,MAAM,MAAM,aAAa,CAAC;AAEjC,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAEjE,MAAM,YAAY,GAAG,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,UAAU,CAAC,CAAC;AAEtD,MAAM,UAAU,aAAa;IAC3B,MAAM,GAAG,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IACrC,OAAO;QACL,EAAE,EAAE,MAAM,CAAC,UAAU,EAAE;QACvB,SAAS,EAAE,GAAG;QACd,SAAS,EAAE,GAAG;QACd,QAAQ,EAAE,EAAE;QACZ,gBAAgB,EAAE,CAAC;QACnB,iBAAiB,EAAE,CAAC;QACpB,YAAY,EAAE,CAAC;KAChB,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,OAAsB;IAChD,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,YAAY,EAAE,OAAO,CAAC,EAAE,GAAG,OAAO,CAAC,EAAE,OAAO,CAAC,CAAC;AACxE,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,EAAU;IACpC,OAAO,YAAY,CAAgB,IAAI,CAAC,IAAI,CAAC,YAAY,EAAE,EAAE,GAAG,OAAO,CAAC,CAAC,CAAC;AAC5E,CAAC;AAED,MAAM,UAAU,YAAY;IAC1B,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,YAAY,CAAC;QAAE,OAAO,EAAE,CAAC;IAC5C,OAAO,EAAE;SACN,WAAW,CAAC,YAAY,CAAC;SACzB,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;SAClC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,YAAY,CAAgB,IAAI,CAAC,IAAI,CAAC,YAAY,EAAE,CAAC,CAAC,CAAC,CAAC;SACnE,MAAM,CAAC,CAAC,CAAC,EAAsB,EAAE,CAAC,CAAC,KAAK,IAAI,CAAC;SAC7C,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,aAAa,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC;AAC5D,CAAC;AAED,MAAM,UAAU,aAAa;IAC3B,OAAO,YAAY,EAAE,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC;AACnC,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,OAAsB,EAAE,OAAoB;IACxE,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IAC/B,OAAO,CAAC,SAAS,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;AAC/C,CAAC"}

package/dist/core/tools.d.ts

@@ -0,0 +1,7 @@
+import type { ToolDefinition } from "../types.js";
+export declare const TOOLS: ToolDefinition[];
+export declare function findTool(name: string): ToolDefinition | undefined;
+/** 把工具的 parameters 转成 JSON Schema，供各家 API 使用 */
+export declare function toJsonSchema(tool: ToolDefinition): Record<string, unknown>;
+/** 联网搜索，返回最多 maxResults 条：标题 / 链接 / 摘要 */
+export declare function searchWeb(query: string, maxResults?: number): Promise<string>;