@onesclawkolor/onesclaw 0.1.0 → 0.1.1

package/dist/knowledge/tools.js

@@ -0,0 +1,131 @@
+export function createKnowledgeSearchTool(manager) {
+    return {
+        name: 'kb_search',
+        description: '搜索本地知识库中的 ONES 主文档。ONES 相关问题优先使用该工具；返回结果包含相对路径、摘要和 citation。',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                query: {
+                    type: 'string',
+                    description: '检索查询文本，建议使用完整问题或核心关键词',
+                },
+                limit: {
+                    type: 'integer',
+                    description: '返回结果数量，默认使用知识库配置值',
+                },
+            },
+            required: ['query'],
+        },
+        execute: async (args) => {
+            const query = typeof args.query === 'string' ? args.query.trim() : '';
+            if (!query) {
+                return { content: 'query 不能为空', isError: true };
+            }
+            try {
+                const results = await manager.search(query, typeof args.limit === 'number' ? args.limit : undefined);
+                return { content: JSON.stringify(results, null, 2) };
+            }
+            catch (error) {
+                return {
+                    content: `本地知识库搜索失败: ${error instanceof Error ? error.message : String(error)}`,
+                    isError: true,
+                };
+            }
+        },
+    };
+}
+export function createKnowledgeGetDocumentTool(manager) {
+    return {
+        name: 'kb_get_document',
+        description: '读取本地知识库中的单篇文档，可按相对路径读取全文，或通过 section 参数读取指定章节。',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                path: {
+                    type: 'string',
+                    description: '文档相对路径，例如 install-upgrade/foo.md',
+                },
+                section: {
+                    type: 'string',
+                    description: '可选，指定要读取的标题章节文本',
+                },
+            },
+            required: ['path'],
+        },
+        execute: async (args) => {
+            const path = typeof args.path === 'string' ? args.path.trim() : '';
+            if (!path) {
+                return { content: 'path 不能为空', isError: true };
+            }
+            try {
+                const content = await manager.getDocument(path, typeof args.section === 'string' ? args.section.trim() : undefined);
+                return { content };
+            }
+            catch (error) {
+                return {
+                    content: `读取本地知识文档失败: ${error instanceof Error ? error.message : String(error)}`,
+                    isError: true,
+                };
+            }
+        },
+    };
+}
+export function createKnowledgeExtractCommandsTool(manager) {
+    return {
+        name: 'kb_extract_commands',
+        description: '从本地知识文档中提取 fenced code block 命令。返回 path/section/command/citation/kind，适用于 ONES 安装、部署、升级、备份等需要可复制 Linux 命令的场景。',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                path: {
+                    type: 'string',
+                    description: '文档相对路径，例如 install-upgrade/K3S/install-new.md',
+                },
+                section: {
+                    type: 'string',
+                    description: '可选，指定只从某个标题章节下提取命令块',
+                },
+            },
+            required: ['path'],
+        },
+        execute: async (args) => {
+            const path = typeof args.path === 'string' ? args.path.trim() : '';
+            if (!path) {
+                return { content: 'path 不能为空', isError: true };
+            }
+            try {
+                const content = await manager.extractCommands(path, typeof args.section === 'string' ? args.section.trim() : undefined);
+                return { content: JSON.stringify(content, null, 2) };
+            }
+            catch (error) {
+                return {
+                    content: `提取本地知识命令块失败: ${error instanceof Error ? error.message : String(error)}`,
+                    isError: true,
+                };
+            }
+        },
+    };
+}
+export function createKnowledgeStatusTool(manager) {
+    return {
+        name: 'kb_status',
+        description: '返回本地知识库状态，包括 source、manifest、qmd 可用性与索引状态。',
+        inputSchema: {
+            type: 'object',
+            properties: {},
+        },
+        execute: async () => {
+            try {
+                const status = await manager.status();
+                return { content: JSON.stringify(status, null, 2) };
+            }
+            catch (error) {
+                return {
+                    content: `读取本地知识库状态失败: ${error instanceof Error ? error.message : String(error)}`,
+                    isError: true,
+                };
+            }
+        },
+    };
+}
+//# sourceMappingURL=tools.js.map

package/dist/knowledge/tools.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tools.js","sourceRoot":"","sources":["../../src/knowledge/tools.ts"],"names":[],"mappings":"AAGA,MAAM,UAAU,yBAAyB,CAAC,OAAyB;IACjE,OAAO;QACL,IAAI,EAAE,WAAW;QACjB,WAAW,EACT,8DAA8D;QAChE,WAAW,EAAE;YACX,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE;gBACV,KAAK,EAAE;oBACL,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,uBAAuB;iBACrC;gBACD,KAAK,EAAE;oBACL,IAAI,EAAE,SAAS;oBACf,WAAW,EAAE,mBAAmB;iBACjC;aACF;YACD,QAAQ,EAAE,CAAC,OAAO,CAAC;SACpB;QACD,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE;YACtB,MAAM,KAAK,GAAG,OAAO,IAAI,CAAC,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YACtE,IAAI,CAAC,KAAK,EAAE,CAAC;gBACX,OAAO,EAAE,OAAO,EAAE,YAAY,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;YAClD,CAAC;YAED,IAAI,CAAC;gBACH,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,MAAM,CAAC,KAAK,EAAE,OAAO,IAAI,CAAC,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC;gBACrG,OAAO,EAAE,OAAO,EAAE,IAAI,CAAC,SAAS,CAAC,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC;YACvD,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,OAAO;oBACL,OAAO,EAAE,cAAc,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE;oBAC/E,OAAO,EAAE,IAAI;iBACd,CAAC;YACJ,CAAC;QACH,CAAC;KACF,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,8BAA8B,CAAC,OAAyB;IACtE,OAAO;QACL,IAAI,EAAE,iBAAiB;QACvB,WAAW,EACT,gDAAgD;QAClD,WAAW,EAAE;YACX,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE;gBACV,IAAI,EAAE;oBACJ,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,kCAAkC;iBAChD;gBACD,OAAO,EAAE;oBACP,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,iBAAiB;iBAC/B;aACF;YACD,QAAQ,EAAE,CAAC,MAAM,CAAC;SACnB;QACD,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE;YACtB,MAAM,IAAI,GAAG,OAAO,IAAI,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YACnE,IAAI,CAAC,IAAI,EAAE,CAAC;gBACV,OAAO,EAAE,OAAO,EAAE,WAAW,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;YACjD,CAAC;YAED,IAAI,CAAC;gBACH,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,WAAW,CACvC,IAAI,EACJ,OAAO,IAAI,CAAC,OAAO,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,SAAS,CACnE,CAAC;gBACF,OAAO,EAAE,OAAO,EAAE,CAAC;YACrB,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,OAAO;oBACL,OAAO,EAAE,eAAe,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE;oBAChF,OAAO,EAAE,IAAI;iBACd,CAAC;YACJ,CAAC;QACH,CAAC;KACF,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,kCAAkC,CAAC,OAAyB;IAC1E,OAAO;QACL,IAAI,EAAE,qBAAqB;QAC3B,WAAW,EACT,+GAA+G;QACjH,WAAW,EAAE;YACX,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE;gBACV,IAAI,EAAE;oBACJ,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,8CAA8C;iBAC5D;gBACD,OAAO,EAAE;oBACP,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,qBAAqB;iBACnC;aACF;YACD,QAAQ,EAAE,CAAC,MAAM,CAAC;SACnB;QACD,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE;YACtB,MAAM,IAAI,GAAG,OAAO,IAAI,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YACnE,IAAI,CAAC,IAAI,EAAE,CAAC;gBACV,OAAO,EAAE,OAAO,EAAE,WAAW,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;YACjD,CAAC;YAED,IAAI,CAAC;gBACH,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,eAAe,CAC3C,IAAI,EACJ,OAAO,IAAI,CAAC,OAAO,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,SAAS,CACnE,CAAC;gBACF,OAAO,EAAE,OAAO,EAAE,IAAI,CAAC,SAAS,CAAC,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC;YACvD,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,OAAO;oBACL,OAAO,EAAE,gBAAgB,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE;oBACjF,OAAO,EAAE,IAAI;iBACd,CAAC;YACJ,CAAC;QACH,CAAC;KACF,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,yBAAyB,CAAC,OAAyB;IACjE,OAAO;QACL,IAAI,EAAE,WAAW;QACjB,WAAW,EAAE,4CAA4C;QACzD,WAAW,EAAE;YACX,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE,EAAE;SACf;QACD,OAAO,EAAE,KAAK,IAAI,EAAE;YAClB,IAAI,CAAC;gBACH,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,MAAM,EAAE,CAAC;gBACtC,OAAO,EAAE,OAAO,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC;YACtD,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,OAAO;oBACL,OAAO,EAAE,gBAAgB,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE;oBACjF,OAAO,EAAE,IAAI;iBACd,CAAC;YACJ,CAAC;QACH,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/knowledge/types.d.ts

@@ -0,0 +1,96 @@
+export type KnowledgeBackend = 'qmd';
+export type KnowledgeSearchMode = 'query' | 'search';
+export type KnowledgePriority = 'local_docs' | 'ones_wiki' | 'context7';
+export interface KnowledgeSourceConfig {
+    name: string;
+    source_path: string;
+    managed_path: string;
+    pattern: string;
+    enabled: boolean;
+}
+export interface KnowledgeQmdConfig {
+    command: string;
+    search_mode: KnowledgeSearchMode;
+    max_results: number;
+    timeout_ms: number;
+}
+export interface KnowledgeConfig {
+    enabled: boolean;
+    backend: KnowledgeBackend;
+    sources: KnowledgeSourceConfig[];
+    priority: KnowledgePriority[];
+    qmd: KnowledgeQmdConfig;
+    auto_sync_on_startup: boolean;
+}
+export interface SourceManifest {
+    source_name: string;
+    source_path: string;
+    managed_path: string;
+    pattern: string;
+    file_count: number;
+    last_synced_at: string;
+    latest_source_mtime_ms: number;
+    source_fingerprint: string;
+    qmd_version: string;
+    search_mode: KnowledgeSearchMode;
+    index_status: 'ready' | 'missing_qmd' | 'syncing' | 'error';
+}
+export interface KnowledgeSearchResult {
+    source_name: string;
+    file: string;
+    relative_path: string;
+    title: string;
+    snippet: string;
+    score: number;
+    citation: string;
+    retrieval_mode: KnowledgeSearchMode;
+}
+export interface KnowledgeCommandBlock {
+    source_name: string;
+    relative_path: string;
+    path: string;
+    document_title: string;
+    section: string | null;
+    language: string;
+    code: string;
+    command: string;
+    summary: string;
+    citation: string;
+    kind: 'raw_doc_command' | 'generated_helper_script';
+}
+export interface KnowledgeHelperScript {
+    name: string;
+    path: string;
+    description: string;
+    example_invocation: string;
+}
+export interface KnowledgeStatus {
+    enabled: boolean;
+    backend: KnowledgeBackend;
+    qmd_command: string;
+    qmd_available: boolean;
+    qmd_version: string | null;
+    priority: KnowledgePriority[];
+    helper_scripts_dir: string;
+    helper_scripts: KnowledgeHelperScript[];
+    sources: Array<{
+        name: string;
+        enabled: boolean;
+        source_path: string;
+        managed_path: string;
+        pattern: string;
+        manifest: SourceManifest | null;
+    }>;
+    raw_qmd_status?: string;
+}
+export interface KnowledgePromptContext {
+    enabled: boolean;
+    sourceNames: string[];
+    priority: KnowledgePriority[];
+}
+export interface QmdSearchHit {
+    file: string;
+    title: string;
+    snippet: string;
+    score: number;
+}

package/dist/knowledge/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/knowledge/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/knowledge/types.ts"],"names":[],"mappings":""}

package/dist/prompts/system.js

@@ -7,14 +7,14 @@ export function buildSystemPrompt(context) {
         buildRoleSection(),
         buildUserSection(context.userInfo),
         buildSkillsSection(context.skills),
-        buildKnowledgeSection(),
+        buildKnowledgeSection(context.knowledge),
+        buildOnesQuestionSection(),
         buildMCPToolsSection(context.mcpTools),
         buildSafetySection(),
         buildGuidelinesSection(),
     ];
     return sections.join('\n\n');
 }
-// ─── Section 1: 角色定义 ───
 function buildRoleSection() {
     return `你是 ONESCLAW，ONES 企业内部 AI 助手。你的职责是帮助 ONES 团队成员完成日常工作，包括：
 - 运维自动化（ONES 安装、升级、备份、巡检等）
@@ -22,16 +22,14 @@ function buildRoleSection() {
 - 知识检索（企业内部 Wiki 和外部文档查询）
 - ONES 协作（任务管理、项目协作、Wiki、工时记录）
 
-默认使用中文交流，跟随用户的语言偏好。回答应简洁专业，直接解决问题。`;
+默认使用中文交流，跟随用户的语言偏好。回答应直接、可执行、少解释。`;
 }
-// ─── Section 2: 用户身份 ───
 function buildUserSection(userInfo) {
     if (!userInfo) {
         return '当前用户：未登录';
     }
     return `当前用户：${userInfo.name}（${userInfo.email}）`;
 }
-// ─── Section 3: 技能索引 ───
 function buildSkillsSection(skills) {
     if (skills.length === 0) {
         return '## 可用技能\n\n暂无可用技能。';
@@ -42,28 +40,41 @@ function buildSkillsSection(skills) {
 
 | 技能 | 域 | 说明 |
 |------|-----|------|`;
-    const rows = skills.map((s) => `| ${s.name} | ${s.domain} | ${s.description} |`);
+    const rows = skills.map((skill) => `| ${skill.name} | ${skill.domain} | ${skill.description} |`);
     return [header, ...rows].join('\n');
 }
-// ─── Section 4: 知识检索指引 ───
-function buildKnowledgeSection() {
+function buildKnowledgeSection(knowledge) {
+    const localKbEnabled = Boolean(knowledge?.enabled) && Array.isArray(knowledge?.sourceNames) && knowledge.sourceNames.length > 0;
+    const priority = Array.isArray(knowledge?.priority) && knowledge.priority.length > 0
+        ? knowledge.priority.join(' > ')
+        : 'local_docs > ones_wiki > context7';
     return `## 知识检索
 
 当用户提出需要查阅文档或知识的问题时，按以下策略选择数据源：
 
+### 本地主知识库（优先级最高）
+${localKbEnabled ? `当前已启用本地知识库，source：${knowledge.sourceNames.join('、')}。` : '当前本地知识库未配置或未启用。'}
+优先使用 kb_search 检索本地托管 Markdown 文档；如需要命令块，先用 kb_extract_commands；如需要全文或具体章节，再使用 kb_get_document。
+适用场景：ONES 安装部署、升级维护、环境要求、故障排查、产品/运维手册等公司主文档。
+- ONES 命令型问题默认先查本地知识库
+- 命中本地知识库时，以本地文档为主事实源回答
+- 命中本地知识库后，不要默认继续查 Context7
+- 若本地知识与 Wiki / Context7 冲突，以本地知识库为准
+
 ### 内部知识（ONES 企业 Wiki）
-使用 ones__search_for_references_in_wiki 工具搜索企业内部 Wiki 知识库。
+当本地知识库未命中或信息不足时，使用 ones__search_for_references_in_wiki 工具搜索企业内部 Wiki 知识库。
 适用场景：公司内部流程、团队规范、项目文档、产品知识等。
 - 可选参数 spaceID：限定搜索范围到特定 Wiki 空间。如需指定空间，先调用 ones__get_space_list 获取空间列表。
 - 如果搜索结果摘要不够详细，可调用 ones__get_page_details 获取完整页面内容。
 
 ### ONES 运维实施手册
-使用 context7__query-docs 工具，libraryId 为 "/websites/opsdoc_ones_cn"。
-适用场景：ONES 安装部署、升级维护、故障排查、运维操作等。
+在 ONES 文档概览、解释、比较类问题中，可优先使用 context7__query-docs 工具，libraryId 为 "/websites/opsdoc_ones_cn" 做快速召回。
+在 ONES 安装部署、升级维护、巡检、环境检测等命令型问题中，Context7 只能做补充概念来源，不能替代本地知识库中的最终命令来源。
+适用场景：ONES 运维文档概览、部署方式说明、运维操作背景说明等。
 无需先调用 resolve-library-id，直接使用此固定 ID。
 
 ### ONES 开发者平台文档
-使用 context7__query-docs 工具，libraryId 为 "/websites/developer_ones_cn"。
+在 ONES 插件开发、OpenAPI、SDK、开发者指南类问题中，可优先使用 context7__query-docs 工具，libraryId 为 "/websites/developer_ones_cn"。
 适用场景：ONES 插件开发、OpenAPI 接口、开发者指南等。
 无需先调用 resolve-library-id，直接使用此固定 ID。
 
@@ -71,19 +82,38 @@ function buildKnowledgeSection() {
 对于第三方库和框架文档，按两步操作：
 1. 先调用 context7__resolve-library-id 获取库的 Context7 ID
 2. 再调用 context7__query-docs 查询具体文档内容
-适用场景：React、Node.js、Python 等通用编程库的文档查询。`;
+适用场景：React、Node.js、Python 等通用编程库的文档查询。
+
+知识路由优先级：${priority}`;
+}
+function buildOnesQuestionSection() {
+    return `## ONES 问答契约
+
+当用户问题与 ONES 安装、部署、升级、运维、授权、证书、配置、排障、环境要求相关时：
+- 这是命令型问题，最终命令必须以本地知识库 Markdown grounding 为准。
+- 不要输出文档里不存在的脚本名或工具名，例如 ones-cli、install.sh、envcheck.sh。
+- 如果用户已经进入安装、升级、巡检等具体执行问题，优先给可复制命令，不要先写长背景。
+- 更细的 7 段输出结构和 docs-only 约束，由本轮 route prompt 进一步收紧。
+
+当用户问题与 ONES 架构概览、部署方式比较、能力介绍、原理说明相关时：
+- 可优先使用 Context7 或 ONES Wiki 给出简洁概览。
+- 这类问题不强制输出代码块，也不强制使用 7 段重型命令回答。
+- 如果用户进一步追问具体安装、升级、巡检命令，再切换到本地知识库命令型回答。
+
+当用户问题与 ONES 实时工单、任务状态、负责人、缺陷状态相关时：
+- 默认优先使用 ONES MCP（ones__ 前缀工具），不要优先查本地知识库。
+- 返回结果保持短、结构化、可复制，不要混入长解释。`;
 }
-// ─── Section 5: MCP 工具使用 ───
 function buildMCPToolsSection(mcpTools) {
     if (mcpTools.length === 0) {
         return '## 平台工具\n\n暂无可用的 MCP 工具。';
     }
-    // 按 server 前缀分组
     const grouped = new Map();
     for (const tool of mcpTools) {
         const sepIdx = tool.indexOf('__');
-        if (sepIdx === -1)
+        if (sepIdx === -1) {
             continue;
+        }
         const server = tool.substring(0, sepIdx);
         const name = tool.substring(sepIdx + 2);
         if (!grouped.has(server)) {
@@ -100,15 +130,11 @@ function buildMCPToolsSection(mcpTools) {
             sections.push(buildContext7ToolsSection(tools));
         }
         else {
-            // 其他 MCP server
             sections.push(`### ${server}\n可用工具：${tools.join('、')}`);
         }
     }
     return sections.join('\n\n');
 }
-/**
- * ONES MCP 工具分类说明
- */
 function buildOnesToolsSection(tools) {
     const categories = [
         { title: '任务管理', pattern: /issue|onesql/, items: [] },
@@ -120,9 +146,9 @@ function buildOnesToolsSection(tools) {
     ];
     for (const tool of tools) {
         let matched = false;
-        for (const cat of categories) {
-            if (cat.title !== '其他' && cat.pattern.test(tool)) {
-                cat.items.push(tool);
+        for (const category of categories) {
+            if (category.title !== '其他' && category.pattern.test(tool)) {
+                category.items.push(tool);
                 matched = true;
                 break;
             }
@@ -132,32 +158,30 @@ function buildOnesToolsSection(tools) {
         }
     }
     const lines = ['### ONES 平台工具'];
-    // 工时特殊说明
-    const hasManHour = categories.some((c) => c.title === '工时管理' && c.items.length > 0);
-    for (const cat of categories) {
-        if (cat.items.length === 0)
+    const hasManHour = categories.some((category) => category.title === '工时管理' && category.items.length > 0);
+    for (const category of categories) {
+        if (category.items.length === 0) {
             continue;
-        lines.push(`\n**${cat.title}**`);
-        for (const item of cat.items) {
-            lines.push(`- ones__${item}`);
         }
-        if (cat.title === '工时管理' && hasManHour) {
-            lines.push('\n> 工时操作前必须先调用 ones__get_manhour_mode 确定模式（simple/summary），再使用对应模式的工具。');
+        const examples = category.items.slice(0, 3).map((item) => `ones__${item}`);
+        lines.push(`- ${category.title}：${category.items.length} 个工具${examples.length > 0 ? `（例如 ${examples.join('、')}）` : ''}`);
+        if (category.title === '工时管理' && hasManHour) {
+            lines.push('  > 工时操作前必须先调用 ones__get_manhour_mode 确定模式（simple/summary），再使用对应模式的工具。');
         }
     }
     return lines.join('\n');
 }
-/**
- * Context7 工具说明
- */
 function buildContext7ToolsSection(tools) {
-    const lines = ['### Context7 文档检索工具'];
-    for (const tool of tools) {
-        lines.push(`- context7__${tool}`);
+    const normalized = new Set(tools);
+    const entries = ['### Context7 文档检索工具'];
+    if (normalized.has('query-docs')) {
+        entries.push('- context7__query-docs：查询固定库或已解析库的文档内容');
     }
-    return lines.join('\n');
+    if (normalized.has('resolve-library-id')) {
+        entries.push('- context7__resolve-library-id：为第三方通用库解析 Context7 library ID');
+    }
+    return entries.join('\n');
 }
-// ─── Section 6: 安全约束 ───
 function buildSafetySection() {
     return `## 安全规则
 
@@ -183,7 +207,6 @@ function buildSafetySection() {
 - 不生成插件业务代码
 - 引导用户参考开发者平台文档自行开发`;
 }
-// ─── Section 7: 行为指南 ───
 function buildGuidelinesSection() {
     return `## 行为指南
 

package/dist/prompts/system.js.map

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

package/dist/tools/registry.d.ts

@@ -15,7 +15,7 @@ export declare class ToolRegistry {
     /**
      * 注册 Native Tools（本地工具）
      */
-    registerNativeTools(): void;
+    registerNativeTools(options?: {}): void;
     /**
      * 加载 Skill 索引
      */
@@ -36,7 +36,7 @@ export declare class ToolRegistry {
     /**
      * 获取所有工具的 Anthropic 格式定义（传给 LLM）
      */
-    getToolDefinitions(): {
+    getToolDefinitions(filter?: any): {
         name: any;
         description: any;
         input_schema: any;

package/dist/tools/registry.js

@@ -9,6 +9,7 @@ import { createLoadSkillTool } from '../skills/loader.js';
 import { createPluginInitTool } from './plugin-init.js';
 import { createSkillsSyncTool } from './skills-sync.js';
 import { createServerListTool, createServerAddTool, createServerRemoveTool } from './server.js';
+import { createKnowledgeExtractCommandsTool, createKnowledgeGetDocumentTool, createKnowledgeSearchTool, createKnowledgeStatusTool, } from '../knowledge/tools.js';
 /**
  * 统一工具注册中心
  * 管理所有可用工具（MCP 工具 + 未来的原生工具）
@@ -26,7 +27,7 @@ export class ToolRegistry {
     /**
      * 注册 Native Tools（本地工具）
      */
-    registerNativeTools() {
+    registerNativeTools(options = {}) {
         this.register(createShellTool());
         this.register(createSSHTool(this.sshPool));
         this.register(createAskUserTool());
@@ -37,6 +38,12 @@ export class ToolRegistry {
         this.register(createServerListTool());
         this.register(createServerAddTool());
         this.register(createServerRemoveTool());
+        if (options.knowledgeManager) {
+            this.register(createKnowledgeSearchTool(options.knowledgeManager));
+            this.register(createKnowledgeExtractCommandsTool(options.knowledgeManager));
+            this.register(createKnowledgeGetDocumentTool(options.knowledgeManager));
+            this.register(createKnowledgeStatusTool(options.knowledgeManager));
+        }
     }
     /**
      * 加载 Skill 索引
@@ -78,8 +85,10 @@ export class ToolRegistry {
     /**
      * 获取所有工具的 Anthropic 格式定义（传给 LLM）
      */
-    getToolDefinitions() {
-        return Array.from(this.tools.values()).map((tool) => ({
+    getToolDefinitions(filter) {
+        return Array.from(this.tools.values())
+            .filter((tool) => (typeof filter === 'function' ? filter(tool.name) : true))
+            .map((tool) => ({
             name: tool.name,
             description: tool.description,
             input_schema: tool.inputSchema,

package/dist/tools/registry.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@onesclawkolor/onesclaw",
-  "version": "0.1.0",
+  "version": "0.1.1",
   "description": "ONES internal AI Agent CLI",
   "type": "module",
   "main": "./dist/index.js",