@onesclawkolor/onesclaw 0.1.0 → 0.1.1

package/dist/knowledge/qmd.js

@@ -0,0 +1,236 @@
+import { spawn } from 'node:child_process';
+import { getKnowledgeQmdCacheDir, getKnowledgeQmdConfigDir, } from '../config/manager.js';
+import { logger } from '../cli/logger.js';
+export class DefaultCommandRunner {
+    run(command, args, options = {}) {
+        return new Promise((resolve, reject) => {
+            const child = spawn(command, args, {
+                env: options.env,
+                cwd: options.cwd,
+                stdio: ['ignore', 'pipe', 'pipe'],
+            });
+            let stdout = '';
+            let stderr = '';
+            let finished = false;
+            let timer = null;
+            let timedOut = false;
+            const finalize = (result) => {
+                if (finished) {
+                    return;
+                }
+                finished = true;
+                if (timer) {
+                    clearTimeout(timer);
+                }
+                resolve(result);
+            };
+            child.stdout.on('data', (chunk) => {
+                stdout += String(chunk);
+            });
+            child.stderr.on('data', (chunk) => {
+                stderr += String(chunk);
+            });
+            child.on('error', reject);
+            child.on('close', (exitCode) => {
+                finalize({ exitCode, stdout, stderr, timedOut });
+            });
+            if (options.timeoutMs && options.timeoutMs > 0) {
+                timer = setTimeout(() => {
+                    timedOut = true;
+                    child.kill('SIGKILL');
+                }, options.timeoutMs);
+            }
+        });
+    }
+}
+export class QmdError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = 'QmdError';
+    }
+}
+function buildQmdEnv(baseEnv = process.env) {
+    return {
+        ...baseEnv,
+        XDG_CONFIG_HOME: getKnowledgeQmdConfigDir(),
+        XDG_CACHE_HOME: getKnowledgeQmdCacheDir(),
+    };
+}
+function normalizeCollectionPath(fileRef) {
+    const match = fileRef.match(/^qmd:\/\/([^/]+)\/(.+)$/);
+    if (!match) {
+        return null;
+    }
+    return {
+        sourceName: match[1],
+        relativePath: match[2],
+    };
+}
+export class QmdClient {
+    config;
+    runner;
+    availableVersionPromise = null;
+    constructor(config, runner = new DefaultCommandRunner()) {
+        this.config = config;
+        this.runner = runner;
+    }
+    async run(args, timeoutMs) {
+        const result = await this.runner.run(this.config.command, args, {
+            env: buildQmdEnv(),
+            timeoutMs,
+        });
+        return result;
+    }
+    async ensureAvailable() {
+        if (!this.availableVersionPromise) {
+            this.availableVersionPromise = (async () => {
+                const start = Date.now();
+                const result = await this.run(['--version'], 5000);
+                logger.debug('knowledge', `qmd --version completed in ${Date.now() - start}ms`);
+                if (result.timedOut || result.exitCode !== 0) {
+                    throw new QmdError(`qmd 不可用，请先安装并确保命令可执行。stderr: ${result.stderr || '(empty)'}`);
+                }
+                const version = `${result.stdout} ${result.stderr}`.match(/qmd\s+([^\s]+)/i)?.[1] ?? null;
+                if (!version) {
+                    throw new QmdError('无法解析 qmd 版本输出');
+                }
+                return version;
+            })().catch((error) => {
+                this.availableVersionPromise = null;
+                throw error;
+            });
+        }
+        return this.availableVersionPromise;
+    }
+    async ensureCollection(source) {
+        const existing = await this.run(['collection', 'show', source.name], 5000);
+        if (existing.exitCode === 0) {
+            const pathMatch = existing.stdout.match(/Path:\s+(.+)/);
+            const patternMatch = existing.stdout.match(/Pattern:\s+(.+)/);
+            const currentPath = pathMatch?.[1]?.trim();
+            const currentPattern = patternMatch?.[1]?.trim();
+            if (currentPath === source.managed_path && currentPattern === source.pattern) {
+                return;
+            }
+            await this.run(['collection', 'remove', source.name], 10000);
+        }
+        const created = await this.run(['collection', 'add', source.managed_path, '--name', source.name, '--mask', source.pattern], 60000);
+        if (created.exitCode !== 0) {
+            throw new QmdError(created.stderr || created.stdout || 'qmd collection add 失败');
+        }
+    }
+    async update() {
+        const result = await this.run(['update'], 120000);
+        if (result.exitCode !== 0) {
+            throw new QmdError(result.stderr || result.stdout || 'qmd update 失败');
+        }
+    }
+    async embed() {
+        const result = await this.run(['embed'], 240000);
+        if (result.exitCode !== 0) {
+            throw new QmdError(result.stderr || result.stdout || 'qmd embed 失败');
+        }
+    }
+    async status() {
+        const result = await this.run(['status'], 10000);
+        if (result.exitCode !== 0) {
+            throw new QmdError(result.stderr || result.stdout || 'qmd status 失败');
+        }
+        return result.stdout.trim();
+    }
+    async search(query, sources, limit, preferredMode) {
+        const requestedMode = preferredMode ?? this.config.search_mode;
+        const primary = await this.searchWithMode(requestedMode, query, sources, limit, this.config.timeout_ms);
+        if (!primary.isError) {
+            return { hits: primary.hits, mode: requestedMode, fallbackUsed: false };
+        }
+        if (requestedMode === 'query') {
+            const fallback = await this.searchWithMode('search', query, sources, limit, Math.min(this.config.timeout_ms, 5000));
+            if (!fallback.isError) {
+                return { hits: fallback.hits, mode: 'search', fallbackUsed: true };
+            }
+        }
+        throw new QmdError(primary.errorMessage || 'qmd 搜索失败');
+    }
+    async searchWithMode(mode, query, sources, limit, timeoutMs) {
+        const args = [mode, query, '-n', String(limit), '--json'];
+        for (const source of sources) {
+            args.push('-c', source.name);
+        }
+        const start = Date.now();
+        const result = await this.run(args, timeoutMs);
+        logger.debug('knowledge', `qmd ${mode} completed in ${Date.now() - start}ms`, {
+            mode,
+            query,
+            limit,
+            collections: sources.map((source) => source.name),
+            timed_out: result.timedOut,
+            exit_code: result.exitCode,
+        });
+        if (result.timedOut) {
+            return { isError: true, hits: [], errorMessage: `qmd ${mode} 超时（>${timeoutMs}ms）` };
+        }
+        if (result.exitCode !== 0) {
+            return {
+                isError: true,
+                hits: [],
+                errorMessage: result.stderr || result.stdout || `qmd ${mode} 执行失败`,
+            };
+        }
+        try {
+            const parsed = JSON.parse(result.stdout);
+            const hits = parsed
+                .map((item) => ({
+                file: typeof item.file === 'string' ? item.file : '',
+                title: typeof item.title === 'string' ? item.title : '',
+                snippet: typeof item.snippet === 'string' ? item.snippet : '',
+                score: typeof item.score === 'number' ? item.score : 0,
+            }))
+                .filter((item) => item.file);
+            return { isError: false, hits };
+        }
+        catch (error) {
+            return {
+                isError: true,
+                hits: [],
+                errorMessage: `qmd ${mode} 输出不是合法 JSON: ${error instanceof Error ? error.message : String(error)}`,
+            };
+        }
+    }
+    async getDocument(sourceName, relativePath) {
+        const start = Date.now();
+        const result = await this.run(['get', `qmd://${sourceName}/${relativePath}`], 10000);
+        logger.debug('knowledge', `qmd get completed in ${Date.now() - start}ms`, {
+            source_name: sourceName,
+            relative_path: relativePath,
+            exit_code: result.exitCode,
+            timed_out: result.timedOut,
+        });
+        if (result.exitCode !== 0) {
+            throw new QmdError(result.stderr || result.stdout || 'qmd get 失败');
+        }
+        return result.stdout;
+    }
+    toSearchResults(hits, retrievalMode) {
+        return hits
+            .map((hit) => {
+            const parsed = normalizeCollectionPath(hit.file);
+            if (!parsed) {
+                return null;
+            }
+            const sectionTitle = hit.title?.trim() || '未命名章节';
+            return {
+                source_name: parsed.sourceName,
+                file: hit.file,
+                relative_path: parsed.relativePath,
+                title: sectionTitle,
+                snippet: hit.snippet,
+                score: hit.score,
+                citation: `[local-docs] ${parsed.relativePath}#${sectionTitle}`,
+                retrieval_mode: retrievalMode,
+            };
+        })
+            .filter((item) => item !== null);
+    }
+}
+//# sourceMappingURL=qmd.js.map

package/dist/knowledge/qmd.js.map

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

package/dist/knowledge/rerank.d.ts

@@ -0,0 +1,14 @@
+import type { KnowledgeSearchResult } from './types.js';
+export type KnowledgeQueryIntent = 'generic_deploy_install' | 'ha_deploy' | 'env_requirements' | 'upgrade' | 'backup_restore' | 'db_external' | 'general';
+export type KnowledgeDocumentRole = 'single_install_new' | 'single_install_legacy' | 'ha_install' | 'overview_flow' | 'env_doc' | 'db_external' | 'upgrade_doc' | 'other';
+export interface KnowledgeCommandSignals {
+    codeBlockCount: number;
+    shellLikeCommandLines: number;
+    hasQuickstart: boolean;
+    hasInstallerShell: boolean;
+    hasDeployOnes: boolean;
+}
+export declare function classifyKnowledgeQueryIntent(query: string): KnowledgeQueryIntent;
+export declare function classifyKnowledgeDocumentRole(relativePath: string, title: string): KnowledgeDocumentRole;
+export declare function computeKnowledgeCommandSignals(markdown: string): KnowledgeCommandSignals;
+export declare function rerankKnowledgeResults(query: string, results: KnowledgeSearchResult[], loadDocument: (relativePath: string) => Promise<string | null>, maxCandidates?: number): Promise<KnowledgeSearchResult[]>;

package/dist/knowledge/rerank.js

@@ -0,0 +1,256 @@
+import { basename } from 'node:path';
+import { extractCommandBlocks } from './preprocess.js';
+const MAX_RERANK_CANDIDATES = 8;
+const COMMAND_BOOST_BASE = 0.08;
+const COMMAND_BOOST_STEP = 0.03;
+const COMMAND_BOOST_CAP = 0.12;
+const INSTALL_CHAIN_BOOST = 0.08;
+const SHELL_COMMAND_HINT_RE = /\b(?:bash|sh|curl|wget|kubectl|helm|make|docker|systemctl|service|mysql|psql|python|node|go|tar|cp|mv|rm|mkdir|chmod|chown|vi|vim|sed|awk|grep|find|export|source|openssl|k3s|quickstart\.sh|ones-ai-k8s\.sh|deploy-ones\.sh)\b/i;
+const ASSIGNMENT_PREFIX_RE = /^(?:[A-Z_][A-Z0-9_]*=(?:'[^']*'|"[^"]*"|\S+)\s+)+/;
+const SCRIPT_LINE_RE = /^(?:\.\/|\/)?[\w.-]+\.sh(?:\s+.*)?$/i;
+const QUERY_BOOST_RULES = [
+    { query: /oceanbase/i, target: /oceanbase/i, boost: 0.28 },
+    { query: /goldendb/i, target: /goldendb/i, boost: 0.28 },
+    { query: /mysql/i, target: /mysql/i, boost: 0.28 },
+    { query: /envcheck/i, target: /envcheck|环境检测/i, boost: 0.24 },
+    { query: /环境要求|资源要求/i, target: /环境要求|requirements/i, boost: 0.2 },
+    { query: /升级/i, target: /升级|upgrade/i, boost: 0.2 },
+    { query: /备份/i, target: /备份|backup/i, boost: 0.2 },
+    { query: /恢复/i, target: /恢复|recovery/i, boost: 0.2 },
+];
+const ROLE_WEIGHTS = {
+    generic_deploy_install: {
+        single_install_new: 0.5,
+        single_install_legacy: 0.35,
+        ha_install: 0.2,
+        overview_flow: 0.1,
+        env_doc: 0,
+        db_external: -0.2,
+        upgrade_doc: -0.1,
+        other: 0,
+    },
+    ha_deploy: {
+        single_install_new: 0.25,
+        single_install_legacy: 0.2,
+        ha_install: 0.5,
+        overview_flow: 0.1,
+        env_doc: 0.05,
+        db_external: -0.2,
+        upgrade_doc: -0.1,
+        other: 0,
+    },
+    env_requirements: {
+        single_install_new: 0.08,
+        single_install_legacy: 0.06,
+        ha_install: 0.04,
+        overview_flow: 0.32,
+        env_doc: 0.45,
+        db_external: -0.1,
+        upgrade_doc: -0.05,
+        other: 0,
+    },
+    upgrade: {
+        single_install_new: 0.12,
+        single_install_legacy: 0.1,
+        ha_install: 0.08,
+        overview_flow: 0.05,
+        env_doc: 0.04,
+        db_external: -0.05,
+        upgrade_doc: 0.5,
+        other: 0,
+    },
+    backup_restore: {
+        single_install_new: 0,
+        single_install_legacy: 0,
+        ha_install: 0,
+        overview_flow: 0,
+        env_doc: 0,
+        db_external: 0,
+        upgrade_doc: 0,
+        other: 0,
+    },
+    db_external: {
+        single_install_new: 0.15,
+        single_install_legacy: 0.12,
+        ha_install: 0.05,
+        overview_flow: 0.05,
+        env_doc: 0.05,
+        db_external: 0.5,
+        upgrade_doc: -0.1,
+        other: 0,
+    },
+    general: {
+        single_install_new: 0,
+        single_install_legacy: 0,
+        ha_install: 0,
+        overview_flow: 0,
+        env_doc: 0,
+        db_external: 0,
+        upgrade_doc: 0,
+        other: 0,
+    },
+};
+export function classifyKnowledgeQueryIntent(query) {
+    const normalized = query.trim();
+    const lower = normalized.toLowerCase();
+    if (/oceanbase|goldendb|mysql\s*外置|数据库外置/i.test(normalized)) {
+        return 'db_external';
+    }
+    if (/集群|高可用|\bha\b/i.test(normalized)) {
+        return 'ha_deploy';
+    }
+    if (/环境要求|环境检测|资源要求|envcheck/i.test(normalized)) {
+        return 'env_requirements';
+    }
+    if (/升级/.test(normalized)) {
+        return 'upgrade';
+    }
+    if (/备份|恢复/.test(normalized)) {
+        return 'backup_restore';
+    }
+    if (/(部署|安装)/.test(normalized) && /ones|私有部署|packages\.ones\.cn/i.test(lower)) {
+        return 'generic_deploy_install';
+    }
+    return 'general';
+}
+export function classifyKnowledgeDocumentRole(relativePath, title) {
+    const normalizedPath = relativePath.replace(/\\/g, '/').toLowerCase();
+    const file = basename(normalizedPath);
+    const normalizedTitle = title.trim().toLowerCase();
+    if (normalizedPath.includes('databases/') || normalizedTitle.includes('外置')) {
+        return 'db_external';
+    }
+    if (normalizedPath.includes('install-upgrade/upgrade/')) {
+        return 'upgrade_doc';
+    }
+    if (file === 'install-new.md' || (normalizedTitle.includes('单机安装') && normalizedTitle.includes('新'))) {
+        return 'single_install_new';
+    }
+    if (file === 'install-ha.md' || normalizedTitle.includes('集群安装') || normalizedTitle.includes('高可用') || /\bha\b/.test(normalizedTitle)) {
+        return 'ha_install';
+    }
+    if (file === 'install.md' || normalizedTitle.includes('单机安装')) {
+        return 'single_install_legacy';
+    }
+    if (file === 'deployment-flow.md' || normalizedTitle.includes('部署说明') || normalizedTitle.includes('部署流程')) {
+        return 'overview_flow';
+    }
+    if (normalizedPath.includes('environmental-requirements/')) {
+        return 'env_doc';
+    }
+    return 'other';
+}
+export function computeKnowledgeCommandSignals(markdown) {
+    const blocks = extractCommandBlocks(markdown);
+    let shellLikeCommandLines = 0;
+    let hasQuickstart = false;
+    let hasInstallerShell = false;
+    let hasDeployOnes = false;
+    for (const block of blocks) {
+        const blockText = block.code;
+        if (/quickstart\.sh/i.test(blockText)) {
+            hasQuickstart = true;
+        }
+        if (/ones-ai-k8s\.sh/i.test(blockText)) {
+            hasInstallerShell = true;
+        }
+        if (/deploy-ones\.sh/i.test(blockText)) {
+            hasDeployOnes = true;
+        }
+        for (const line of blockText.split(/\r?\n/)) {
+            if (isShellLikeCommandLine(line)) {
+                shellLikeCommandLines += 1;
+            }
+        }
+    }
+    return {
+        codeBlockCount: blocks.length,
+        shellLikeCommandLines,
+        hasQuickstart,
+        hasInstallerShell,
+        hasDeployOnes,
+    };
+}
+export async function rerankKnowledgeResults(query, results, loadDocument, maxCandidates = MAX_RERANK_CANDIDATES) {
+    const intent = classifyKnowledgeQueryIntent(query);
+    if (intent === 'general' || results.length <= 1) {
+        return results;
+    }
+    const candidates = results.slice(0, Math.min(maxCandidates, results.length));
+    const ranked = await Promise.all(candidates.map(async (result, index) => {
+        const markdown = await loadDocument(result.relative_path).catch(() => null);
+        const signals = markdown ? computeKnowledgeCommandSignals(markdown) : emptySignals();
+        const role = classifyKnowledgeDocumentRole(result.relative_path, result.title);
+        const adjustedScore = result.score +
+            roleWeight(intent, role) +
+            computeCommandBoost(signals) +
+            computeQuerySpecificBoost(query, result.relative_path, result.title);
+        return {
+            result,
+            originalIndex: index,
+            adjustedScore,
+            role,
+            signals,
+        };
+    }));
+    ranked.sort((left, right) => {
+        if (right.adjustedScore !== left.adjustedScore) {
+            return right.adjustedScore - left.adjustedScore;
+        }
+        if (right.result.score !== left.result.score) {
+            return right.result.score - left.result.score;
+        }
+        return left.originalIndex - right.originalIndex;
+    });
+    return ranked.map((candidate) => candidate.result).concat(results.slice(candidates.length));
+}
+function roleWeight(intent, role) {
+    const weights = ROLE_WEIGHTS[intent] ?? ROLE_WEIGHTS.general;
+    let weight = weights[role] ?? 0;
+    if (intent === 'backup_restore' && (role === 'other' || role === 'overview_flow')) {
+        weight += 0;
+    }
+    return weight;
+}
+function computeCommandBoost(signals) {
+    let boost = 0;
+    if (signals.codeBlockCount > 0) {
+        boost += COMMAND_BOOST_BASE;
+    }
+    boost += Math.min(Math.floor(signals.shellLikeCommandLines / 10) * COMMAND_BOOST_STEP, COMMAND_BOOST_CAP);
+    if (signals.hasQuickstart || signals.hasInstallerShell || signals.hasDeployOnes) {
+        boost += INSTALL_CHAIN_BOOST;
+    }
+    return boost;
+}
+function isShellLikeCommandLine(line) {
+    const trimmed = line.trim();
+    if (!trimmed || trimmed.startsWith('#')) {
+        return false;
+    }
+    const withoutAssignments = trimmed.replace(ASSIGNMENT_PREFIX_RE, '');
+    return SHELL_COMMAND_HINT_RE.test(withoutAssignments) || SCRIPT_LINE_RE.test(withoutAssignments);
+}
+function emptySignals() {
+    return {
+        codeBlockCount: 0,
+        shellLikeCommandLines: 0,
+        hasQuickstart: false,
+        hasInstallerShell: false,
+        hasDeployOnes: false,
+    };
+}
+function computeQuerySpecificBoost(query, relativePath, title) {
+    const haystack = `${relativePath} ${title}`.toLowerCase();
+    let boost = 0;
+    for (const rule of QUERY_BOOST_RULES) {
+        if (!rule.query.test(query)) {
+            continue;
+        }
+        if (rule.target.test(haystack)) {
+            boost += rule.boost;
+        }
+    }
+    return boost;
+}
+//# sourceMappingURL=rerank.js.map

package/dist/knowledge/rerank.js.map

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

package/dist/knowledge/tools.d.ts

@@ -0,0 +1,6 @@
+import type { Tool } from '../tools/types.js';
+import { KnowledgeManager } from './manager.js';
+export declare function createKnowledgeSearchTool(manager: KnowledgeManager): Tool;
+export declare function createKnowledgeGetDocumentTool(manager: KnowledgeManager): Tool;
+export declare function createKnowledgeExtractCommandsTool(manager: KnowledgeManager): Tool;
+export declare function createKnowledgeStatusTool(manager: KnowledgeManager): Tool;