@onesclawkolor/onesclaw 0.1.0 → 0.1.1

package/dist/knowledge/manager.js

@@ -0,0 +1,377 @@
+import { createHash } from 'node:crypto';
+import { mkdir, readdir, readFile, rm, stat, unlink, writeFile } from 'node:fs/promises';
+import { dirname, join, relative } from 'node:path';
+import { getKnowledgeBinDir, ensureKnowledgeDir, getKnowledgeManifestPath, getKnowledgeSourcesDir, normalizeKnowledgeConfig, } from '../config/manager.js';
+import { logger } from '../cli/logger.js';
+import { extractCommandBlocks, extractFirstHeading, extractSection, isMarkdownSourceFile, preprocessMarkdown } from './preprocess.js';
+import { ensureKnowledgeHelperScripts, listKnowledgeHelperScripts } from './helper-scripts.js';
+import { QmdClient } from './qmd.js';
+import { rerankKnowledgeResults } from './rerank.js';
+export class KnowledgeManager {
+    config;
+    qmd;
+    commandBlockCache = new Map();
+    constructor(config, runner) {
+        this.config = normalizeKnowledgeConfig(config ?? undefined);
+        this.qmd = new QmdClient(this.config.qmd, runner);
+    }
+    getPromptContext() {
+        return {
+            enabled: this.config.enabled,
+            sourceNames: this.config.sources.filter((source) => source.enabled).map((source) => source.name),
+            priority: [...this.config.priority],
+        };
+    }
+    async bootstrap(sourcePath, sourceName = 'ones-docs') {
+        const source = this.config.sources.find((item) => item.name === sourceName);
+        if (!source) {
+            throw new Error(`知识源未配置：${sourceName}`);
+        }
+        if (source.source_path !== sourcePath) {
+            throw new Error(`知识源路径不匹配：${source.source_path}`);
+        }
+        return this.syncSource(source);
+    }
+    async syncAll() {
+        const manifests = [];
+        for (const source of this.config.sources.filter((item) => item.enabled)) {
+            manifests.push(await this.syncSource(source));
+        }
+        return manifests;
+    }
+    async autoSyncIfNeeded() {
+        if (!this.config.enabled || !this.config.auto_sync_on_startup) {
+            return;
+        }
+        for (const source of this.config.sources.filter((item) => item.enabled)) {
+            const files = await collectMarkdownFiles(source.source_path);
+            const fingerprint = computeSourceFingerprint(files);
+            const manifest = await this.readManifest(source.name);
+            if (!manifest || manifest.source_fingerprint !== fingerprint) {
+                await this.syncSource(source);
+            }
+        }
+    }
+    async status() {
+        await ensureKnowledgeDir();
+        const helperScripts = await this.listHelperScripts();
+        const sources = await Promise.all(this.config.sources.map(async (source) => ({
+            name: source.name,
+            enabled: source.enabled,
+            source_path: source.source_path,
+            managed_path: source.managed_path,
+            pattern: source.pattern,
+            manifest: await this.readManifest(source.name),
+        })));
+        try {
+            const version = await this.qmd.ensureAvailable();
+            const rawStatus = await this.qmd.status();
+            return {
+                enabled: this.config.enabled,
+                backend: this.config.backend,
+                qmd_command: this.config.qmd.command,
+                qmd_available: true,
+                qmd_version: version,
+                priority: [...this.config.priority],
+                helper_scripts_dir: getKnowledgeBinDir(),
+                helper_scripts: helperScripts,
+                sources,
+                raw_qmd_status: rawStatus,
+            };
+        }
+        catch {
+            return {
+                enabled: this.config.enabled,
+                backend: this.config.backend,
+                qmd_command: this.config.qmd.command,
+                qmd_available: false,
+                qmd_version: null,
+                priority: [...this.config.priority],
+                helper_scripts_dir: getKnowledgeBinDir(),
+                helper_scripts: helperScripts,
+                sources,
+            };
+        }
+    }
+    async search(query, limit) {
+        const enabledSources = this.config.sources.filter((source) => source.enabled);
+        if (!this.config.enabled || enabledSources.length === 0) {
+            return [];
+        }
+        await ensureKnowledgeDir();
+        await this.qmd.ensureAvailable();
+        const rerankStart = Date.now();
+        const { hits, mode } = await this.qmd.search(query, enabledSources, limit ?? this.config.qmd.max_results, 'search');
+        if (hits.length > 0) {
+            const results = this.qmd.toSearchResults(hits, mode);
+            const reranked = await rerankKnowledgeResults(query, results, (relativePath) => this.readManagedDocument(relativePath));
+            logger.debug('knowledge', `knowledge rerank completed in ${Date.now() - rerankStart}ms`, {
+                query,
+                hit_count: hits.length,
+                primary_doc: reranked[0]?.relative_path ?? null,
+                mode,
+            });
+            return reranked;
+        }
+        const fallbackQuery = buildFallbackKnowledgeQuery(query);
+        if (!fallbackQuery || fallbackQuery === query) {
+            return [];
+        }
+        const fallback = await this.qmd.search(fallbackQuery, enabledSources, limit ?? this.config.qmd.max_results, 'search');
+        const fallbackResults = this.qmd.toSearchResults(fallback.hits, fallback.mode);
+        const reranked = await rerankKnowledgeResults(query, fallbackResults, (relativePath) => this.readManagedDocument(relativePath));
+        logger.debug('knowledge', `knowledge fallback rerank completed in ${Date.now() - rerankStart}ms`, {
+            query,
+            fallback_query: fallbackQuery,
+            hit_count: fallback.hits.length,
+            primary_doc: reranked[0]?.relative_path ?? null,
+            mode: fallback.mode,
+        });
+        return reranked;
+    }
+    async getDocument(pathRef, section) {
+        const path = this.normalizeRelativePath(pathRef);
+        const source = await this.findSourceForRelativePath(path);
+        if (!source) {
+            throw new Error(`未找到文档所属知识源: ${path}`);
+        }
+        await ensureKnowledgeDir();
+        await this.qmd.ensureAvailable();
+        const raw = await this.qmd.getDocument(source.name, path);
+        if (!section) {
+            return raw;
+        }
+        const extracted = extractSection(raw, section);
+        if (!extracted) {
+            throw new Error(`文档中未找到章节: ${section}`);
+        }
+        return extracted;
+    }
+    async extractCommands(pathRef, section) {
+        const path = this.normalizeRelativePath(pathRef);
+        const source = await this.findSourceForRelativePath(path);
+        if (!source) {
+            throw new Error(`未找到文档所属知识源: ${path}`);
+        }
+        const cacheKey = await this.getCommandCacheKey(source, path);
+        if (cacheKey && this.commandBlockCache.has(cacheKey)) {
+            logger.debug('knowledge', 'kb_extract_commands cache hit', {
+                relative_path: path,
+                cache_key: cacheKey,
+            });
+            return this.commandBlockCache.get(cacheKey);
+        }
+        const content = await this.getDocument(path, section);
+        const documentTitle = extractFirstHeading(content) ?? path.split('/').pop()?.replace(/\.md$/i, '') ?? path;
+        const commandBlocks = extractCommandBlocks(content);
+        const blocks = commandBlocks.map((block) => {
+            const anchor = block.section ?? documentTitle;
+            return {
+                source_name: source.name,
+                relative_path: path,
+                path,
+                document_title: documentTitle,
+                section: block.section,
+                language: block.language || 'text',
+                code: block.code,
+                command: block.code,
+                summary: `${anchor} 命令块`,
+                citation: `[local-docs] ${path}#${anchor}`,
+                kind: 'raw_doc_command',
+            };
+        });
+        if (cacheKey) {
+            this.commandBlockCache.set(cacheKey, blocks);
+        }
+        return blocks;
+    }
+    async listHelperScripts() {
+        await ensureKnowledgeDir();
+        return listKnowledgeHelperScripts();
+    }
+    normalizeRelativePath(pathRef) {
+        const path = pathRef.trim().replace(/^\/+/, '');
+        if (!path) {
+            throw new Error('path 不能为空');
+        }
+        if (path.split('/').includes('..')) {
+            throw new Error('path 不允许包含 ..');
+        }
+        return path;
+    }
+    async findSourceForRelativePath(relativePath) {
+        for (const source of this.config.sources.filter((item) => item.enabled)) {
+            const candidate = join(source.managed_path, relativePath);
+            try {
+                await stat(candidate);
+                return source;
+            }
+            catch {
+                continue;
+            }
+        }
+        return null;
+    }
+    async readManagedDocument(relativePath) {
+        for (const source of this.config.sources.filter((item) => item.enabled)) {
+            const candidate = join(source.managed_path, relativePath);
+            try {
+                return await readFile(candidate, 'utf-8');
+            }
+            catch {
+                continue;
+            }
+        }
+        return null;
+    }
+    async syncSource(source) {
+        await ensureKnowledgeDir();
+        const version = await this.qmd.ensureAvailable();
+        const files = await collectMarkdownFiles(source.source_path);
+        await mkdir(source.managed_path, { recursive: true });
+        await this.cleanManagedDirectory(source.managed_path, files.map((item) => item.relativePath));
+        for (const file of files) {
+            const raw = await readFile(file.absolutePath, 'utf-8');
+            const processed = preprocessMarkdown(raw);
+            const targetPath = join(source.managed_path, file.relativePath);
+            await mkdir(dirname(targetPath), { recursive: true });
+            await writeFile(targetPath, processed, 'utf-8');
+        }
+        await this.qmd.ensureCollection(source);
+        await this.qmd.update();
+        await this.qmd.embed();
+        await this.qmd.status();
+        const latestSourceMtimeMs = files.reduce((max, item) => Math.max(max, item.mtimeMs), 0);
+        const manifest = {
+            source_name: source.name,
+            source_path: source.source_path,
+            managed_path: source.managed_path,
+            pattern: source.pattern,
+            file_count: files.length,
+            last_synced_at: new Date().toISOString(),
+            latest_source_mtime_ms: latestSourceMtimeMs,
+            source_fingerprint: computeSourceFingerprint(files),
+            qmd_version: version,
+            search_mode: this.config.qmd.search_mode,
+            index_status: 'ready',
+        };
+        await mkdir(getKnowledgeSourcesDir(), { recursive: true });
+        await writeFile(getKnowledgeManifestPath(source.name), JSON.stringify(manifest, null, 2) + '\n', 'utf-8');
+        await ensureKnowledgeHelperScripts();
+        this.commandBlockCache.clear();
+        return manifest;
+    }
+    async getCommandCacheKey(source, relativePath) {
+        try {
+            const fileStat = await stat(join(source.managed_path, relativePath));
+            return `${relativePath}:${fileStat.mtimeMs}`;
+        }
+        catch {
+            return null;
+        }
+    }
+    async cleanManagedDirectory(root, expectedRelativePaths) {
+        const expected = new Set(expectedRelativePaths.map((item) => item.replace(/\\/g, '/')));
+        const current = await collectMarkdownFiles(root, root).catch(() => []);
+        for (const file of current) {
+            if (expected.has(file.relativePath.replace(/\\/g, '/'))) {
+                continue;
+            }
+            await unlink(file.absolutePath).catch(() => undefined);
+        }
+        await removeEmptyDirectories(root);
+    }
+    async readManifest(sourceName) {
+        try {
+            const content = await readFile(getKnowledgeManifestPath(sourceName), 'utf-8');
+            return JSON.parse(content);
+        }
+        catch {
+            return null;
+        }
+    }
+}
+async function collectMarkdownFiles(root, relativeRoot = root) {
+    const entries = await readdir(root, { withFileTypes: true });
+    const results = [];
+    for (const entry of entries) {
+        const absolutePath = join(root, entry.name);
+        if (entry.isDirectory()) {
+            results.push(...(await collectMarkdownFiles(absolutePath, relativeRoot)));
+            continue;
+        }
+        const rel = relative(relativeRoot, absolutePath).replace(/\\/g, '/');
+        if (!isMarkdownSourceFile(rel)) {
+            continue;
+        }
+        const fileStat = await stat(absolutePath);
+        results.push({
+            relativePath: rel,
+            absolutePath,
+            mtimeMs: fileStat.mtimeMs,
+            size: fileStat.size,
+        });
+    }
+    results.sort((left, right) => left.relativePath.localeCompare(right.relativePath));
+    return results;
+}
+async function removeEmptyDirectories(root) {
+    const entries = await readdir(root, { withFileTypes: true }).catch(() => []);
+    for (const entry of entries) {
+        if (!entry.isDirectory()) {
+            continue;
+        }
+        const child = join(root, entry.name);
+        await removeEmptyDirectories(child);
+    }
+    const remaining = await readdir(root, { withFileTypes: true }).catch(() => []);
+    if (remaining.length === 0) {
+        await rm(root, { recursive: false, force: true }).catch(() => undefined);
+    }
+}
+function computeSourceFingerprint(files) {
+    const hash = createHash('sha256');
+    for (const file of files) {
+        hash.update(file.relativePath);
+        hash.update(':');
+        hash.update(String(file.mtimeMs));
+        hash.update(':');
+        hash.update(String(file.size));
+        hash.update('\n');
+    }
+    return hash.digest('hex');
+}
+function buildFallbackKnowledgeQuery(query) {
+    const tokens = new Set();
+    if (/\bones\b|ones\.pro/i.test(query)) {
+        tokens.add('ONES');
+    }
+    if (/k3s/i.test(query)) {
+        tokens.add('K3S');
+    }
+    const keywordExpansions = [
+        [/部署/, ['部署', '安装']],
+        [/安装/, ['安装', '部署']],
+        [/升级/, ['升级']],
+        [/备份/, ['备份']],
+        [/恢复/, ['恢复']],
+        [/授权/, ['授权', '证书']],
+        [/证书/, ['证书', '授权']],
+        [/配置/, ['配置']],
+        [/排障|故障/, ['排障', '故障']],
+        [/环境要求|环境检测|envcheck/i, ['环境要求', '环境检测']],
+    ];
+    for (const [pattern, expansions] of keywordExpansions) {
+        if (!pattern.test(query)) {
+            continue;
+        }
+        for (const expansion of expansions) {
+            tokens.add(expansion);
+        }
+    }
+    if (tokens.size === 0) {
+        return null;
+    }
+    return Array.from(tokens).join(' ');
+}
+//# sourceMappingURL=manager.js.map

package/dist/knowledge/manager.js.map

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

package/dist/knowledge/preprocess.d.ts

@@ -0,0 +1,10 @@
+export interface MarkdownCommandBlock {
+    section: string | null;
+    language: string;
+    code: string;
+}
+export declare function isMarkdownSourceFile(filePath: string): boolean;
+export declare function preprocessMarkdown(raw: string): string;
+export declare function extractFirstHeading(markdown: string): string | null;
+export declare function extractSection(markdown: string, section: string): string | null;
+export declare function extractCommandBlocks(markdown: string): MarkdownCommandBlock[];

package/dist/knowledge/preprocess.js

@@ -0,0 +1,93 @@
+import matter from 'gray-matter';
+const IMAGE_ONLY_LINE_RE = /^\s*!\[[^\]]*\]\([^)]*\)\s*$/;
+const HEADING_RE = /^(#{1,6})\s+(.+?)\s*$/;
+const FENCE_RE = /^```([^`]*)\s*$/;
+export function isMarkdownSourceFile(filePath) {
+    const lower = filePath.toLowerCase();
+    return lower.endsWith('.md') && !lower.endsWith('.bak');
+}
+export function preprocessMarkdown(raw) {
+    const parsed = matter(raw);
+    const filteredLines = parsed.content
+        .split(/\r?\n/)
+        .filter((line) => !IMAGE_ONLY_LINE_RE.test(line));
+    return filteredLines.join('\n').trim() + '\n';
+}
+export function extractFirstHeading(markdown) {
+    for (const line of markdown.split(/\r?\n/)) {
+        const match = line.match(HEADING_RE);
+        if (match) {
+            return match[2].trim();
+        }
+    }
+    return null;
+}
+export function extractSection(markdown, section) {
+    const lines = markdown.split(/\r?\n/);
+    const normalizedNeedle = section.trim().toLowerCase();
+    let start = -1;
+    let startLevel = 0;
+    for (let index = 0; index < lines.length; index++) {
+        const match = lines[index].match(HEADING_RE);
+        if (!match) {
+            continue;
+        }
+        if (match[2].trim().toLowerCase() === normalizedNeedle) {
+            start = index;
+            startLevel = match[1].length;
+            break;
+        }
+    }
+    if (start === -1) {
+        return null;
+    }
+    let end = lines.length;
+    for (let index = start + 1; index < lines.length; index++) {
+        const match = lines[index].match(HEADING_RE);
+        if (match && match[1].length <= startLevel) {
+            end = index;
+            break;
+        }
+    }
+    return lines.slice(start, end).join('\n').trim() + '\n';
+}
+export function extractCommandBlocks(markdown) {
+    const lines = markdown.split(/\r?\n/);
+    const headingStack = [];
+    const blocks = [];
+    let inFence = false;
+    let fenceLanguage = '';
+    let fenceLines = [];
+    for (const line of lines) {
+        if (!inFence) {
+            const headingMatch = line.match(HEADING_RE);
+            if (headingMatch) {
+                const level = headingMatch[1].length;
+                headingStack.length = level - 1;
+                headingStack[level - 1] = headingMatch[2].trim();
+                continue;
+            }
+            const fenceMatch = line.match(FENCE_RE);
+            if (fenceMatch) {
+                inFence = true;
+                fenceLanguage = fenceMatch[1].trim();
+                fenceLines = [];
+            }
+            continue;
+        }
+        if (line.match(FENCE_RE)) {
+            blocks.push({
+                section: headingStack.length > 0 ? headingStack[headingStack.length - 1] : null,
+                language: fenceLanguage,
+                code: fenceLines.join('\n').trim(),
+            });
+            inFence = false;
+            fenceLanguage = '';
+            fenceLines = [];
+            continue;
+        }
+        fenceLines.push(line);
+    }
+    return blocks.filter((block) => block.code.length > 0);
+}
+//# sourceMappingURL=preprocess.js.map

package/dist/knowledge/preprocess.js.map

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

package/dist/knowledge/qmd.d.ts

@@ -0,0 +1,53 @@
+import type { KnowledgeQmdConfig, KnowledgeSearchMode, KnowledgeSourceConfig, QmdSearchHit } from './types.js';
+export interface CommandRunnerResult {
+    exitCode: number | null;
+    stdout: string;
+    stderr: string;
+    timedOut: boolean;
+}
+export interface CommandRunner {
+    run(command: string, args: string[], options?: {
+        env?: NodeJS.ProcessEnv;
+        cwd?: string;
+        timeoutMs?: number;
+    }): Promise<CommandRunnerResult>;
+}
+export declare class DefaultCommandRunner implements CommandRunner {
+    run(command: string, args: string[], options?: {
+        env?: NodeJS.ProcessEnv;
+        cwd?: string;
+        timeoutMs?: number;
+    }): Promise<CommandRunnerResult>;
+}
+export declare class QmdError extends Error {
+    constructor(message: string);
+}
+export declare class QmdClient {
+    private readonly config;
+    private readonly runner;
+    private availableVersionPromise;
+    constructor(config: KnowledgeQmdConfig, runner?: CommandRunner);
+    private run;
+    ensureAvailable(): Promise<string>;
+    ensureCollection(source: KnowledgeSourceConfig): Promise<void>;
+    update(): Promise<void>;
+    embed(): Promise<void>;
+    status(): Promise<string>;
+    search(query: string, sources: KnowledgeSourceConfig[], limit: number, preferredMode?: KnowledgeSearchMode): Promise<{
+        hits: QmdSearchHit[];
+        mode: KnowledgeSearchMode;
+        fallbackUsed: boolean;
+    }>;
+    private searchWithMode;
+    getDocument(sourceName: string, relativePath: string): Promise<string>;
+    toSearchResults(hits: QmdSearchHit[], retrievalMode: KnowledgeSearchMode): Array<{
+        source_name: string;
+        file: string;
+        relative_path: string;
+        title: string;
+        snippet: string;
+        score: number;
+        citation: string;
+        retrieval_mode: KnowledgeSearchMode;
+    }>;
+}