hcent 0.1.0

package/dist/main.js

@@ -0,0 +1,43 @@
+import { homedir } from 'node:os';
+import { join } from 'node:path';
+import { loadConfig } from './config/index.js';
+import { createSession } from './session/index.js';
+import { createProviderManager } from './provider/provider-manager.js';
+import { createSessionStore } from './session/session-store.js';
+import { createSkillRegistry } from './skill/index.js';
+import { createCommandPalette } from './skill/command-palette.js';
+import { createToolRegistry } from './tools/index.js';
+import { hasApiKey } from './setup/index.js';
+import { runPiTuiApp } from './tui/index.js';
+export async function run() {
+    const cwd = process.cwd();
+    const config = loadConfig(cwd);
+    const needsSetup = !hasApiKey();
+    const session = createSession('你是一个终端编码助手（hcent）。你可以帮用户分析代码、查找文件、执行操作。');
+    const providerManager = createProviderManager(config);
+    const store = createSessionStore(undefined, [config.apiKey]);
+    const toolRegistry = createToolRegistry();
+    const skillRegistry = createSkillRegistry();
+    const home = homedir();
+    // 用户级 skill（低优先级）
+    await skillRegistry.loadFromDirectory(join(home, '.claude', 'skills'));
+    await skillRegistry.loadFromDirectory(join(home, '.cursor', 'skills'));
+    await skillRegistry.loadFromDirectory(join(home, '.agents', 'skills'));
+    await skillRegistry.loadFromDirectory(join(home, '.hcent', 'skills'));
+    // 项目级 skill（同名覆盖用户级）
+    await skillRegistry.loadFromDirectory(join(cwd, '.agents', 'skills'));
+    await skillRegistry.loadFromDirectory(join(cwd, '.hcent', 'skills'));
+    await skillRegistry.loadFromDirectory(join(cwd, '.cursor', 'skills'));
+    const palette = createCommandPalette(skillRegistry);
+    runPiTuiApp({
+        config,
+        session,
+        providerManager,
+        tools: toolRegistry,
+        store,
+        palette,
+        skillRegistry,
+        needsSetup,
+    });
+}
+//# sourceMappingURL=main.js.map

package/dist/main.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"main.js","sourceRoot":"","sources":["../src/main.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAClC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAC/C,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACnD,OAAO,EAAE,qBAAqB,EAAE,MAAM,gCAAgC,CAAC;AACvE,OAAO,EAAE,kBAAkB,EAAE,MAAM,4BAA4B,CAAC;AAChE,OAAO,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AACvD,OAAO,EAAE,oBAAoB,EAAE,MAAM,4BAA4B,CAAC;AAClE,OAAO,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AACtD,OAAO,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAC7C,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAE7C,MAAM,CAAC,KAAK,UAAU,GAAG;IACvB,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC;IAC1B,MAAM,MAAM,GAAG,UAAU,CAAC,GAAG,CAAC,CAAC;IAC/B,MAAM,UAAU,GAAG,CAAC,SAAS,EAAE,CAAC;IAEhC,MAAM,OAAO,GAAG,aAAa,CAC3B,yCAAyC,CAC1C,CAAC;IAEF,MAAM,eAAe,GAAG,qBAAqB,CAAC,MAAM,CAAC,CAAC;IACtD,MAAM,KAAK,GAAG,kBAAkB,CAAC,SAAS,EAAE,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC;IAC7D,MAAM,YAAY,GAAG,kBAAkB,EAAE,CAAC;IAE1C,MAAM,aAAa,GAAG,mBAAmB,EAAE,CAAC;IAC5C,MAAM,IAAI,GAAG,OAAO,EAAE,CAAC;IACvB,kBAAkB;IAClB,MAAM,aAAa,CAAC,iBAAiB,CAAC,IAAI,CAAC,IAAI,EAAE,SAAS,EAAE,QAAQ,CAAC,CAAC,CAAC;IACvE,MAAM,aAAa,CAAC,iBAAiB,CAAC,IAAI,CAAC,IAAI,EAAE,SAAS,EAAE,QAAQ,CAAC,CAAC,CAAC;IACvE,MAAM,aAAa,CAAC,iBAAiB,CAAC,IAAI,CAAC,IAAI,EAAE,SAAS,EAAE,QAAQ,CAAC,CAAC,CAAC;IACvE,MAAM,aAAa,CAAC,iBAAiB,CAAC,IAAI,CAAC,IAAI,EAAE,QAAQ,EAAE,QAAQ,CAAC,CAAC,CAAC;IACtE,qBAAqB;IACrB,MAAM,aAAa,CAAC,iBAAiB,CAAC,IAAI,CAAC,GAAG,EAAE,SAAS,EAAE,QAAQ,CAAC,CAAC,CAAC;IACtE,MAAM,aAAa,CAAC,iBAAiB,CAAC,IAAI,CAAC,GAAG,EAAE,QAAQ,EAAE,QAAQ,CAAC,CAAC,CAAC;IACrE,MAAM,aAAa,CAAC,iBAAiB,CAAC,IAAI,CAAC,GAAG,EAAE,SAAS,EAAE,QAAQ,CAAC,CAAC,CAAC;IAEtE,MAAM,OAAO,GAAG,oBAAoB,CAAC,aAAa,CAAC,CAAC;IAEpD,WAAW,CAAC;QACV,MAAM;QACN,OAAO;QACP,eAAe;QACf,KAAK,EAAE,YAAY;QACnB,KAAK;QACL,OAAO;QACP,aAAa;QACb,UAAU;KACX,CAAC,CAAC;AACL,CAAC"}

package/dist/provider/index.d.ts

@@ -0,0 +1,23 @@
+import type { AppConfig } from '../config/index.js';
+import type { Message, ToolCall } from '../session/index.js';
+import type { ToolSchema } from '../tools/index.js';
+export interface ProviderRequest {
+    messages: Message[];
+    tools: ToolSchema[];
+    signal: AbortSignal;
+}
+export interface ProviderDelta {
+    contentDelta?: string;
+    toolCalls?: ToolCall[];
+}
+export interface Provider {
+    readonly model: string;
+    stream(req: ProviderRequest): AsyncIterable<ProviderDelta>;
+}
+export declare function createOpenAICompatibleProvider(config: AppConfig): Provider;
+export interface MockResponse {
+    contentDelta?: string;
+    toolCalls?: ToolCall[];
+    delayMs?: number;
+}
+export declare function createMockProvider(model: string, responses: MockResponse[]): Provider;

package/dist/provider/index.js

@@ -0,0 +1,124 @@
+import OpenAI from 'openai';
+// ── 消息 & 工具格式转换 ──
+function buildMessagesForAPI(messages) {
+    return messages.map((m) => {
+        const entry = { role: m.role, content: m.content };
+        if (m.toolCalls && m.toolCalls.length > 0) {
+            entry.tool_calls = m.toolCalls.map((tc) => ({
+                id: tc.id,
+                type: 'function',
+                function: { name: tc.name, arguments: JSON.stringify(tc.arguments) },
+            }));
+        }
+        if (m.toolCallId) {
+            entry.tool_call_id = m.toolCallId;
+        }
+        return entry;
+    });
+}
+function buildToolsForAPI(tools) {
+    if (tools.length === 0)
+        return undefined;
+    return tools.map((t) => ({
+        type: 'function',
+        function: {
+            name: t.name,
+            description: t.description,
+            parameters: t.parameters,
+        },
+    }));
+}
+function buildToolCalls(accumulator) {
+    const calls = [];
+    for (const [, tc] of accumulator) {
+        if (!tc.id || !tc.name)
+            continue;
+        let parsedArgs = {};
+        try {
+            parsedArgs = JSON.parse(tc.args || '{}');
+        }
+        catch {
+            parsedArgs = {};
+        }
+        calls.push({ id: tc.id, name: tc.name, arguments: parsedArgs });
+    }
+    return calls;
+}
+// ── OpenAI 兼容 Provider（OpenAI SDK 驱动，DeepSeek 等）──
+function accumulateStreamToolCalls(tcAccumulator, toolCalls) {
+    for (const tc of toolCalls) {
+        const acc = tcAccumulator.get(tc.index) ?? { args: '' };
+        if (tc.id)
+            acc.id = tc.id;
+        if (tc.function?.name)
+            acc.name = tc.function.name;
+        if (tc.function?.arguments)
+            acc.args += tc.function.arguments;
+        tcAccumulator.set(tc.index, acc);
+    }
+}
+async function* streamCompletionChunks(client, config, req) {
+    const stream = await client.chat.completions.create({
+        model: config.model,
+        messages: buildMessagesForAPI(req.messages),
+        tools: buildToolsForAPI(req.tools),
+        stream: true,
+    }, { signal: req.signal });
+    for await (const chunk of stream) {
+        yield chunk;
+    }
+}
+export function createOpenAICompatibleProvider(config) {
+    const client = new OpenAI({
+        baseURL: config.baseUrl,
+        apiKey: config.apiKey || 'sk-placeholder',
+        timeout: config.timeoutMs,
+        maxRetries: config.maxRetries,
+    });
+    return {
+        model: config.model,
+        async *stream(req) {
+            const tcAccumulator = new Map();
+            for await (const chunk of streamCompletionChunks(client, config, req)) {
+                const delta = chunk.choices[0]?.delta;
+                if (!delta)
+                    continue;
+                if (delta.content) {
+                    yield { contentDelta: delta.content };
+                }
+                if (delta.tool_calls) {
+                    accumulateStreamToolCalls(tcAccumulator, delta.tool_calls);
+                }
+            }
+            const toolCalls = buildToolCalls(tcAccumulator);
+            if (toolCalls.length > 0) {
+                yield { toolCalls };
+            }
+        },
+    };
+}
+export function createMockProvider(model, responses) {
+    let callIndex = -1;
+    return {
+        model,
+        async *stream(_req) {
+            callIndex++;
+            const r = responses[callIndex];
+            if (!r)
+                return;
+            if (r.delayMs) {
+                await new Promise((resolve) => setTimeout(resolve, r.delayMs));
+            }
+            if (r.contentDelta) {
+                // 模拟流式逐字输出
+                for (let i = 0; i < r.contentDelta.length; i++) {
+                    yield { contentDelta: r.contentDelta[i] };
+                }
+            }
+            if (r.toolCalls) {
+                yield { toolCalls: r.toolCalls };
+            }
+        },
+    };
+}
+//# sourceMappingURL=index.js.map

package/dist/provider/index.js.map

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

package/dist/provider/provider-manager.d.ts

@@ -0,0 +1,9 @@
+import type { AppConfig, ModelConfig } from '../config/index.js';
+import { type Provider } from './index.js';
+export interface ProviderManager {
+    readonly current: Provider;
+    readonly activeModelConfig: ModelConfig;
+    switch(name: string): void;
+    listModels(): ModelConfig[];
+}
+export declare function createProviderManager(config: AppConfig): ProviderManager;

package/dist/provider/provider-manager.js

@@ -0,0 +1,43 @@
+import { createOpenAICompatibleProvider } from './index.js';
+export function createProviderManager(config) {
+    let activeConfig = findModel(config, config.activeModel);
+    let provider = createProvider(activeConfig);
+    function findModel(cfg, name) {
+        const found = cfg.models.find((m) => m.name === name);
+        if (!found)
+            throw new Error(`模型 ${name} 不存在`);
+        return found;
+    }
+    function createProvider(mc) {
+        const providerConfig = {
+            ...config,
+            model: mc.model,
+            baseUrl: mc.baseUrl,
+            apiKey: mc.apiKey,
+            timeoutMs: mc.timeoutMs ?? config.timeoutMs,
+            maxRetries: mc.maxRetries ?? config.maxRetries,
+        };
+        switch (config.provider) {
+            case 'openai-compatible':
+            case 'deepseek':
+            default:
+                return createOpenAICompatibleProvider(providerConfig);
+        }
+    }
+    return {
+        get current() {
+            return provider;
+        },
+        get activeModelConfig() {
+            return activeConfig;
+        },
+        switch(name) {
+            activeConfig = findModel(config, name);
+            provider = createProvider(activeConfig);
+        },
+        listModels() {
+            return config.models.map((m) => ({ ...m, apiKey: m.apiKey ? '***' : '' }));
+        },
+    };
+}
+//# sourceMappingURL=provider-manager.js.map

package/dist/provider/provider-manager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider-manager.js","sourceRoot":"","sources":["../../src/provider/provider-manager.ts"],"names":[],"mappings":"AACA,OAAO,EAAiB,8BAA8B,EAAE,MAAM,YAAY,CAAC;AAS3E,MAAM,UAAU,qBAAqB,CAAC,MAAiB;IACrD,IAAI,YAAY,GAAG,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC,WAAW,CAAC,CAAC;IACzD,IAAI,QAAQ,GAAG,cAAc,CAAC,YAAY,CAAC,CAAC;IAE5C,SAAS,SAAS,CAAC,GAAc,EAAE,IAAY;QAC7C,MAAM,KAAK,GAAG,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,IAAI,CAAC,CAAC;QACtD,IAAI,CAAC,KAAK;YAAE,MAAM,IAAI,KAAK,CAAC,MAAM,IAAI,MAAM,CAAC,CAAC;QAC9C,OAAO,KAAK,CAAC;IACf,CAAC;IAED,SAAS,cAAc,CAAC,EAAe;QACrC,MAAM,cAAc,GAAc;YAChC,GAAG,MAAM;YACT,KAAK,EAAE,EAAE,CAAC,KAAK;YACf,OAAO,EAAE,EAAE,CAAC,OAAO;YACnB,MAAM,EAAE,EAAE,CAAC,MAAM;YACjB,SAAS,EAAE,EAAE,CAAC,SAAS,IAAI,MAAM,CAAC,SAAS;YAC3C,UAAU,EAAE,EAAE,CAAC,UAAU,IAAI,MAAM,CAAC,UAAU;SAC/C,CAAC;QACF,QAAQ,MAAM,CAAC,QAAQ,EAAE,CAAC;YACxB,KAAK,mBAAmB,CAAC;YACzB,KAAK,UAAU,CAAC;YAChB;gBACE,OAAO,8BAA8B,CAAC,cAAc,CAAC,CAAC;QAC1D,CAAC;IACH,CAAC;IAED,OAAO;QACL,IAAI,OAAO;YACT,OAAO,QAAQ,CAAC;QAClB,CAAC;QACD,IAAI,iBAAiB;YACnB,OAAO,YAAY,CAAC;QACtB,CAAC;QACD,MAAM,CAAC,IAAY;YACjB,YAAY,GAAG,SAAS,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;YACvC,QAAQ,GAAG,cAAc,CAAC,YAAY,CAAC,CAAC;QAC1C,CAAC;QACD,UAAU;YACR,OAAO,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC;QAC7E,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/session/index.d.ts

@@ -0,0 +1,39 @@
+export type Role = 'system' | 'user' | 'assistant' | 'tool';
+export interface ToolCall {
+    id: string;
+    name: string;
+    arguments: Record<string, unknown>;
+}
+export type MessageKind = 'normal' | 'permission_reject' | 'error' | 'summary' | 'skill' | 'base';
+export interface Message {
+    role: Role;
+    content: string;
+    toolCalls?: ToolCall[];
+    toolCallId?: string;
+    kind?: MessageKind;
+    ts: string;
+}
+export declare function createMessage(params: {
+    role: Role;
+    content: string;
+    toolCalls?: ToolCall[];
+    toolCallId?: string;
+    kind?: MessageKind;
+}): Message;
+export interface SkillMeta {
+    name: string;
+    filePath: string;
+    description: string;
+}
+export interface Session {
+    readonly id: string;
+    messages: Message[];
+    readonly activeSkills: SkillMeta[];
+    append(m: Message): void;
+    clear(): void;
+    snapshot(): Message[];
+    addSkill(name: string, filePath: string, description: string, pointerContent: string): void;
+    removeSkill(name: string): void;
+    clearSkills(): void;
+}
+export declare function createSession(systemPrompt?: string): Session;

package/dist/session/index.js

@@ -0,0 +1,69 @@
+import { randomUUID } from 'node:crypto';
+// ── 工厂函数 ──
+function now() {
+    return new Date().toISOString();
+}
+export function createMessage(params) {
+    return {
+        role: params.role,
+        content: params.content,
+        toolCalls: params.toolCalls,
+        toolCallId: params.toolCallId,
+        kind: params.kind,
+        ts: now(),
+    };
+}
+export function createSession(systemPrompt) {
+    const id = randomUUID();
+    const messages = [];
+    const activeSkills = [];
+    if (systemPrompt) {
+        messages.push(createMessage({ role: 'system', content: systemPrompt, kind: 'base' }));
+    }
+    return {
+        id,
+        messages,
+        get activeSkills() {
+            return activeSkills;
+        },
+        append(m) {
+            messages.push(m);
+        },
+        clear() {
+            const systemMessages = messages.filter((m) => m.role === 'system');
+            messages.length = 0;
+            messages.push(...systemMessages);
+        },
+        snapshot() {
+            return structuredClone(messages);
+        },
+        addSkill(name, filePath, description, pointerContent) {
+            if (activeSkills.some((s) => s.name === name))
+                return;
+            activeSkills.push({ name, filePath, description });
+            messages.push(createMessage({ role: 'system', content: pointerContent, kind: 'skill' }));
+        },
+        removeSkill(name) {
+            const idx = activeSkills.findIndex((s) => s.name === name);
+            if (idx === -1)
+                return;
+            activeSkills.splice(idx, 1);
+            for (let i = messages.length - 1; i >= 0; i--) {
+                const m = messages[i];
+                if (m.role === 'system' && m.kind === 'skill' && m.content.includes(`**${name}**`)) {
+                    messages.splice(i, 1);
+                    break;
+                }
+            }
+        },
+        clearSkills() {
+            activeSkills.length = 0;
+            for (let i = messages.length - 1; i >= 0; i--) {
+                if (messages[i].role === 'system' && messages[i].kind === 'skill') {
+                    messages.splice(i, 1);
+                }
+            }
+        },
+    };
+}
+//# sourceMappingURL=index.js.map

package/dist/session/index.js.map

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

package/dist/session/session-store.d.ts

@@ -0,0 +1,19 @@
+import { type Session, type Message } from './index.js';
+export interface SessionMeta {
+    id: string;
+    title: string;
+    createdAt: string;
+    updatedAt: string;
+    messageCount: number;
+    lastModel: string;
+}
+export interface SessionStore {
+    save(session: Session, model: string): Promise<void>;
+    load(id: string): Promise<{
+        messages: Message[];
+        meta: SessionMeta;
+    } | null>;
+    list(): Promise<SessionMeta[]>;
+    delete(id: string): Promise<boolean>;
+}
+export declare function createSessionStore(dir?: string, apiKeys?: string[]): SessionStore;

package/dist/session/session-store.js

@@ -0,0 +1,109 @@
+import { readFileSync, writeFileSync, readdirSync, mkdirSync, unlinkSync } from 'node:fs';
+import { join } from 'node:path';
+import { homedir } from 'node:os';
+function defaultDir() {
+    return join(homedir(), '.config', 'hcent', 'sessions');
+}
+function extractTitle(messages) {
+    const firstUser = messages.find((m) => m.role === 'user');
+    if (!firstUser)
+        return '（无标题）';
+    const text = firstUser.content.slice(0, 50);
+    return text.length < firstUser.content.length ? text + '…' : text;
+}
+function redactApiKey(messages, apiKeys) {
+    if (apiKeys.length === 0)
+        return messages;
+    return messages.map((m) => {
+        let content = m.content;
+        for (const key of apiKeys) {
+            if (key)
+                content = content.replaceAll(key, '***');
+        }
+        return content === m.content ? m : { ...m, content };
+    });
+}
+export function createSessionStore(dir, apiKeys) {
+    const storeDir = dir ?? defaultDir();
+    function ensureDir() {
+        try {
+            mkdirSync(storeDir, { recursive: true });
+        }
+        catch {
+            // already exists
+        }
+    }
+    function filePath(id) {
+        return join(storeDir, `${id}.json`);
+    }
+    return {
+        async save(session, model) {
+            try {
+                ensureDir();
+                const now = new Date().toISOString();
+                const existing = readMeta(filePath(session.id));
+                const meta = {
+                    id: session.id,
+                    title: extractTitle(session.messages),
+                    createdAt: existing?.createdAt ?? now,
+                    updatedAt: now,
+                    messageCount: session.messages.length,
+                    lastModel: model,
+                };
+                const safeMessages = redactApiKey(session.messages, apiKeys ?? []);
+                writeFileSync(filePath(session.id), JSON.stringify({ meta, messages: safeMessages }, null, 2), 'utf-8');
+            }
+            catch (err) {
+                console.warn('保存会话失败:', err instanceof Error ? err.message : String(err));
+            }
+        },
+        async load(id) {
+            try {
+                const raw = readFileSync(filePath(id), 'utf-8');
+                const data = JSON.parse(raw);
+                if (!data.meta || !data.messages)
+                    return null;
+                return { messages: data.messages, meta: data.meta };
+            }
+            catch {
+                return null;
+            }
+        },
+        async list() {
+            try {
+                ensureDir();
+                const files = readdirSync(storeDir).filter((f) => f.endsWith('.json'));
+                const metas = [];
+                for (const file of files) {
+                    const meta = readMeta(join(storeDir, file));
+                    if (meta)
+                        metas.push(meta);
+                }
+                return metas.sort((a, b) => b.updatedAt.localeCompare(a.updatedAt));
+            }
+            catch {
+                return [];
+            }
+        },
+        async delete(id) {
+            try {
+                unlinkSync(filePath(id));
+                return true;
+            }
+            catch {
+                return false;
+            }
+        },
+    };
+}
+function readMeta(path) {
+    try {
+        const raw = readFileSync(path, 'utf-8');
+        const data = JSON.parse(raw);
+        return data.meta ?? null;
+    }
+    catch {
+        return null;
+    }
+}
+//# sourceMappingURL=session-store.js.map

package/dist/session/session-store.js.map

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

package/dist/setup/index.d.ts

@@ -0,0 +1,11 @@
+export declare const DEFAULT_BASE_URL = "https://api.deepseek.com";
+export declare const DEFAULT_MODEL = "deepseek-v4-pro";
+/** 检查是否有任何形式可用的 apiKey（环境变量 / 用户全局配置 / 项目级配置） */
+export declare function hasApiKey(): boolean;
+/** 返回用户全局配置路径 */
+export declare function userConfigPath(): string;
+/** 引导提示文本（供 TUI 在输入栏上方渲染） */
+export declare function setupGuideLines(): string[];
+/** 将 API Key 写入用户全局配置文件 */
+export declare function writeUserConfig(apiKey: string, baseUrl?: string): void;
+export declare function runSetup(): Promise<void>;

package/dist/setup/index.js

@@ -0,0 +1,97 @@
+// 配置引导工具。供 bin 入口和 main/TUI 使用。
+import { existsSync, mkdirSync, writeFileSync, readFileSync } from 'node:fs';
+import { join } from 'node:path';
+import { homedir } from 'node:os';
+import { createInterface } from 'node:readline';
+export const DEFAULT_BASE_URL = 'https://api.deepseek.com';
+export const DEFAULT_MODEL = 'deepseek-v4-pro';
+/** 检查配置文件是否含有 apiKey */
+function configFileHasApiKey(path) {
+    try {
+        const cfg = JSON.parse(readFileSync(path, 'utf-8'));
+        return Boolean(cfg.apiKey) || (cfg.models?.length > 0 && cfg.models[0].apiKey);
+    }
+    catch {
+        return false;
+    }
+}
+/** 检查是否有任何形式可用的 apiKey（环境变量 / 用户全局配置 / 项目级配置） */
+export function hasApiKey() {
+    if (process.env.HCENT_API_KEY)
+        return true;
+    if (configFileHasApiKey(join(homedir(), '.hcent', 'config.json')))
+        return true;
+    return configFileHasApiKey(join(process.cwd(), '.hcent', 'config.json'));
+}
+/** 返回用户全局配置路径 */
+export function userConfigPath() {
+    return join(homedir(), '.hcent', 'config.json');
+}
+/** 引导提示文本（供 TUI 在输入栏上方渲染） */
+export function setupGuideLines() {
+    return [
+        '欢迎使用 hcent！首次运行需要配置 API Key。',
+        '',
+        '请在下方输入 DeepSeek API Key 开始使用：',
+        '',
+        `（配置将保存到 ${userConfigPath()}，之后无需重复输入）`,
+        '',
+        '也可以退出后通过以下方式配置：',
+        `  环境变量: HCENT_API_KEY=your-key`,
+        `  项目配置: .hcent/config.json`,
+        `  命令行向导: hcent --setup`,
+    ];
+}
+/** 将 API Key 写入用户全局配置文件 */
+export function writeUserConfig(apiKey, baseUrl) {
+    const dir = join(homedir(), '.hcent');
+    if (!existsSync(dir))
+        mkdirSync(dir, { recursive: true });
+    const resolvedBaseUrl = baseUrl?.trim() || DEFAULT_BASE_URL;
+    const config = {
+        apiKey: apiKey.trim(),
+        model: DEFAULT_MODEL,
+        baseUrl: resolvedBaseUrl,
+        provider: 'deepseek',
+        maxLoops: 68,
+        timeoutMs: 60_000,
+        maxRetries: 2,
+        models: [
+            {
+                name: DEFAULT_MODEL,
+                model: DEFAULT_MODEL,
+                baseUrl: resolvedBaseUrl,
+                apiKey: apiKey.trim(),
+                maxContextTokens: 65536,
+            },
+        ],
+        activeModel: DEFAULT_MODEL,
+        searchApiKey: '',
+    };
+    writeFileSync(join(dir, 'config.json'), JSON.stringify(config, null, 2), 'utf-8');
+    process.env.HCENT_API_KEY = apiKey.trim();
+}
+// ── 保留 --setup 的 readline 交互式配置（TUI 之外也能用） ──
+function question(rl, prompt) {
+    return new Promise((resolve) => rl.question(prompt, resolve));
+}
+export async function runSetup() {
+    const rl = createInterface({ input: process.stdin, output: process.stdout });
+    console.log('');
+    console.log('╔══════════════════════════════════════╗');
+    console.log('║     hcent 首次配置向导               ║');
+    console.log('╚══════════════════════════════════════╝');
+    console.log('');
+    console.log('将创建用户全局配置文件，所有项目共享。');
+    console.log('');
+    const apiKey = await question(rl, 'API Key: ');
+    const model = await question(rl, `模型标识 (默认 ${DEFAULT_MODEL}): `);
+    const baseUrl = await question(rl, `API Base URL (默认 ${DEFAULT_BASE_URL}): `);
+    rl.close();
+    writeUserConfig(apiKey, baseUrl);
+    console.log('');
+    console.log(`配置已写入: ${userConfigPath()}`);
+    console.log('现在可以运行 hcent 开始使用。');
+    console.log('');
+}
+//# sourceMappingURL=index.js.map

package/dist/setup/index.js.map

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

package/dist/skill/command-palette.d.ts

@@ -0,0 +1,12 @@
+import type { SkillRegistry } from './index.js';
+export interface PaletteEntry {
+    type: 'command' | 'skill';
+    name: string;
+    description: string;
+    keywords: string[];
+}
+export interface CommandPalette {
+    entries(): PaletteEntry[];
+    search(query: string): PaletteEntry[];
+}
+export declare function createCommandPalette(skills: SkillRegistry): CommandPalette;