evolcore 0.0.32 → 0.0.33

package/dist/core/command/skill-slash.js

@@ -0,0 +1,322 @@
+/**
+ * skill-slash.ts — `/skill` 斜杠命令：技能查看与索引刷新
+ *
+ * 权限：
+ *  - 只读（list / show / where）：私聊所有角色可看；群聊仅 admin+ 可看
+ *  - refresh：私聊仅 admin+；群聊一律拒绝
+ *
+ * 本文件刻意**只做只读 + refresh**：写操作（install / remove / enable / disable）
+ * 的权限门禁在 `kits/skills/ec-skill/scripts/skill.mjs` 的 `assertPermission()` 里，
+ * 那套判据（群聊拒绝、agent 级需本 Agent owner、本机级需 daemonowner）依赖运行时上下文，
+ * 在 slash 层重实现一份必然漂移。写操作请走 `ec skill` 或 ec-skill 技能。
+ */
+import fs from 'fs';
+import path from 'path';
+import { agentDir, getPackageRoot, resolveRoot } from '../../paths.js';
+import { resolveAllSkillStates } from '../skill/switch-resolver.js';
+import { readSkillDescription } from '../skill/index-generator.js';
+import { evaluateWhen, loadManifest, resolvePathWithDiag, } from '../../eck/manifest-engine.js';
+import { DEFAULT_MANIFEST_FILE } from '../../eck/kit-renderer.js';
+import { resolveAgentLifecycle } from '../../config/lifecycle.js';
+const USAGE = [
+    '用法:',
+    '  /skill                  技能概览（启用数 / 总数）',
+    '  /skill list [all]       技能列表（默认仅启用；all 显示未启用的）',
+    '  /skill index            查看技能索引加载情况（哪些索引文件被加载、时间、技能数）',
+    '  /skill index builtin    查看内置技能索引正文',
+    '  /skill index local      查看本机技能索引正文',
+    '  /skill show <name>      单个技能详情：来源、状态、生效依据、描述',
+    '  /skill where            打印三级技能根目录',
+    '  /skill refresh          重建当前 Agent 的技能索引',
+    '',
+    '写操作（install / remove / enable / disable）请用 ec skill 或 ec-skill 技能。',
+].join('\n');
+const result = (text) => ({ kind: 'command.result', text });
+const error = (text) => ({ kind: 'command.error', text: `❌ ${text}` });
+/** 只读子命令：私聊所有角色；群聊仅 admin+。 */
+export function canReadSkillSlash(ctx) {
+    return ctx.chatType === 'group' ? ctx.isAdmin : true;
+}
+/** refresh：私聊仅 admin+；群聊一律拒绝。 */
+export function canRefreshSkillSlash(ctx) {
+    return ctx.chatType === 'group' ? false : ctx.isAdmin;
+}
+export function canUseSkillSlash(ctx) {
+    return canReadSkillSlash(ctx);
+}
+/** evolhelp「技能管理」条目。可见范围与 canReadSkillSlash / canRefreshSkillSlash 一致。 */
+export function skillHelpEntries(ctx) {
+    if (!canUseSkillSlash(ctx))
+        return [];
+    const category = '技能管理';
+    const roles = [ctx.role];
+    const out = [
+        { command: '/skill list', description: '已启用的技能列表', category, roles },
+        { command: '/skill list all', description: '全部技能列表（含未启用）', category, roles },
+        { command: '/skill index', description: '技能索引加载情况（文件、时间、技能数）', category, roles },
+        { command: '/skill index builtin', description: '查看内置技能索引正文', category, roles },
+        { command: '/skill index local', description: '查看本机技能索引正文', category, roles },
+        { command: '/skill where', description: '三级技能根目录', category, roles },
+    ];
+    if (canRefreshSkillSlash(ctx)) {
+        out.push({ command: '/skill refresh', description: '重建当前 Agent 的技能索引', category, roles });
+    }
+    out.push({ command: '/skill show', description: '单个技能详情', args: '<name>', category, roles });
+    return out;
+}
+/** 技能三级根目录；与 ec-skill 脚本的 skillRoots() 保持一致。 */
+function skillRoots(selfAid) {
+    return {
+        builtin: path.join(getPackageRoot(), 'kits', 'skills'),
+        local: path.join(resolveRoot(), 'skills'),
+        agent: selfAid ? path.join(agentDir(selfAid), 'skills') : '(未确定 agent)',
+    };
+}
+/** 目录本身是 agent 级 skills/，resolveAllSkillStates 要的是 agent 根目录。 */
+function agentRootFor(selfAid) {
+    return selfAid ? agentDir(selfAid) : undefined;
+}
+function sourceLabel(source) {
+    return source === 'builtin' ? '内置' : '本机';
+}
+function stateLabel(s) {
+    return s.enabled ? '开' : '关';
+}
+function overviewLine(states) {
+    const enabled = states.filter(s => s.enabled).length;
+    return `${states.length} 个技能，${enabled} 个启用`;
+}
+function formatList(states, showAll) {
+    const shown = showAll ? states : states.filter(s => s.enabled);
+    if (shown.length === 0) {
+        return showAll ? '（没有任何技能）' : '（没有启用的技能；用 /skill list all 查看全部）';
+    }
+    const nameW = Math.max(20, ...shown.map(s => s.name.length + 2));
+    const lines = [`${overviewLine(states)}${showAll ? '' : '（仅列启用；/skill list all 查看全部）'}`, ''];
+    for (const s of shown) {
+        const lock = s.locked ? ' [locked]' : '';
+        lines.push(`  ${s.name.padEnd(nameW)}${sourceLabel(s.source).padEnd(6)}${stateLabel(s)}${lock}`);
+    }
+    return lines.join('\n');
+}
+function formatInfo(s) {
+    const desc = readSkillDescription(s.skillDir);
+    const lines = [
+        `技能: ${s.name}`,
+        `来源: ${sourceLabel(s.source)}`,
+        `路径: ${s.skillDir}`,
+        `状态: ${stateLabel(s)}（由 ${s.decidedBy} 决定）`,
+    ];
+    if (s.locked)
+        lines.push('锁定: 内置级 locked，任何级别都关不掉');
+    lines.push('', `描述: ${desc || '(无)'}`);
+    return lines.join('\n');
+}
+function formatWhere(selfAid) {
+    const roots = skillRoots(selfAid);
+    return [
+        '三级技能根目录:',
+        `  内置级: ${roots.builtin}`,
+        `  本机级: ${roots.local}`,
+        `  Agent 级: ${roots.agent}`,
+        '',
+        'Agent 级只放 .switches.json（开关），不放 SKILL.md。',
+    ].join('\n');
+}
+/**
+ * 读**生效的 manifest**（含 ECK override），挑出指向技能索引文件的段，
+ * 再逐段判定实际是否会被注入。
+ *
+ * 为什么不直接扫磁盘：`optional: true` 的文件缺失会被静默跳过，`when` 不满足或
+ * 总闸超限也会让段不加载。只有走 manifest 判定，`/skill index` 才能反映"实际加载"。
+ */
+function inspectSkillIndexes(agentRoot, selfAid, lifecycle) {
+    const manifestFile = DEFAULT_MANIFEST_FILE;
+    const sections = loadManifest(manifestFile);
+    // 只关心指向 <agentRoot>/skills/.index-*.md 的段；override 可能加段或改路径，
+    // 所以按解析后的路径判断，而不是按段 id 匹配。
+    const skillsDir = path.join(agentRoot, 'skills');
+    // lifecycle 与渲染器同源解析：显式非法值按 null（fail-closed），缺省按 active 兼容。
+    const resolvedLifecycle = resolveAgentLifecycle({ lifecycle });
+    const vars = {
+        selfAid,
+        EVOLCORE_HOME: resolveRoot(),
+        AGENT_DIR: agentRoot,
+        ...(resolvedLifecycle === null ? {} : { lifecycle: resolvedLifecycle }),
+    };
+    const out = [];
+    for (const section of sections) {
+        if (section.type !== 'file' || !section.file)
+            continue;
+        // 与 kit-renderer 共用同一个解析器：变量替换 + path.normalize，不做任何空白裁剪。
+        // 变量缺失时 status !== 'ok'，resolved 可能为 null —— 段会被跳过，而不是拼出一个
+        // 看起来合理的错误路径（原先的 stripBlankLines 版本会静默拼错，还吃掉路径里的空格）。
+        const r = resolvePathWithDiag(section.file, vars);
+        if (r.status !== 'ok' || !r.resolved)
+            continue;
+        const resolved = r.resolved;
+        if (!isSkillIndexPath(resolved, skillsDir))
+            continue;
+        const enabled = section.enabled !== false;
+        const whenPassed = evaluateWhen(section.when ?? 'always', vars);
+        const fileExists = fs.existsSync(resolved);
+        let reason;
+        if (!enabled)
+            reason = 'manifest 中该段 enabled: false';
+        else if (!whenPassed)
+            reason = `manifest 的 when 条件不满足（当前 lifecycle=${resolvedLifecycle ?? '值非法'}）`;
+        else if (!fileExists)
+            reason = section.optional ? '文件不存在（optional，静默跳过）' : '文件不存在';
+        const diag = {
+            id: section.id,
+            rawPath: section.file,
+            resolvedPath: resolved,
+            loaded: enabled && whenPassed && fileExists,
+            ...(reason ? { reason } : {}),
+            fileExists,
+        };
+        if (fileExists) {
+            try {
+                const st = fs.statSync(resolved);
+                diag.sizeBytes = st.size;
+                diag.mtimeMs = st.mtimeMs;
+                diag.skillCount = countSkillsInIndex(fs.readFileSync(resolved, 'utf-8'));
+            }
+            catch { /* 读失败保持字段缺省 */ }
+        }
+        out.push(diag);
+    }
+    return out;
+}
+/** 判断解析后的路径是否落在本 agent 的 skills 索引目录里，且文件名形如 .index-*.md */
+function isSkillIndexPath(resolved, skillsDir) {
+    const dir = path.dirname(resolved);
+    if (path.normalize(dir).toLowerCase() !== path.normalize(skillsDir).toLowerCase())
+        return false;
+    return /^\.index-.*\.md$/i.test(path.basename(resolved));
+}
+/**
+ * 从索引正文里数技能条目的数量。
+ *
+ * 索引由 index-generator 生成，段头形如 `本 Agent 已启用 N 个内置技能。`；
+ * 拿不到就退化为数 `- ` 开头的条目行。
+ */
+function countSkillsInIndex(content) {
+    const headerMatch = content.match(/已启用\s*(\d+)\s*个/);
+    if (headerMatch)
+        return Number(headerMatch[1]);
+    const items = content.split('\n').filter(l => /^-\s+\S/.test(l.trim()));
+    return items.length > 0 ? items.length : undefined;
+}
+function formatIndexOverview(sections, selfAid) {
+    if (sections.length === 0) {
+        return '当前生效的 manifest 里没有引用任何技能索引文件。\n'
+            + '（技能索引由 kits/eck_manifest.json 的 skills-builtin / skills-local 段注入）';
+    }
+    const lines = [`技能索引加载情况（agent: ${selfAid}）`, ''];
+    for (const s of sections) {
+        const state = s.loaded ? '已加载' : '未加载';
+        lines.push(`${state}  ${path.basename(s.resolvedPath)}`);
+        lines.push(`  manifest 段: ${s.id}`);
+        if (s.loaded) {
+            lines.push(`  技能数: ${s.skillCount ?? '(解析不到)'}`);
+            lines.push(`  文件时间: ${s.mtimeMs ? new Date(s.mtimeMs).toLocaleString('zh-CN') : '(未知)'}`);
+            lines.push(`  大小: ${s.sizeBytes ?? '?'} 字节`);
+        }
+        else {
+            lines.push(`  原因: ${s.reason ?? '未知'}`);
+        }
+        lines.push(`  路径: ${s.resolvedPath}`);
+        lines.push('');
+    }
+    const loaded = sections.filter(s => s.loaded);
+    const total = loaded.reduce((n, s) => n + (s.skillCount ?? 0), 0);
+    lines.push(`合计：${loaded.length}/${sections.length} 个索引文件被加载，共 ${total} 个技能`);
+    lines.push('查看正文: /skill index builtin  或  /skill index local');
+    return lines.join('\n');
+}
+/** 读某个索引文件正文；kind 由段 id 或路径推断。 */
+function readIndexFile(selfAid, kind, lifecycle) {
+    const root = agentRootFor(selfAid);
+    if (!root)
+        return '❌ 无法确定当前 agent 目录';
+    const file = path.join(root, 'skills', kind === 'builtin' ? '.index-builtin.md' : '.index-local.md');
+    const sections = inspectSkillIndexes(root, selfAid, lifecycle);
+    const section = sections.find(s => path.basename(s.resolvedPath).toLowerCase() === path.basename(file).toLowerCase());
+    if (section && !section.loaded) {
+        return `⚠️ ${path.basename(file)} 当前未加载（${section.reason ?? '未知原因'}）\n`
+            + `路径: ${file}`;
+    }
+    if (!fs.existsSync(file)) {
+        return `（${path.basename(file)} 不存在——该来源当前没有启用任何技能，索引生成时会被删除）`;
+    }
+    const content = fs.readFileSync(file, 'utf-8');
+    const count = countSkillsInIndex(content);
+    const header = `${path.basename(file)}（${count ?? '?'} 个技能，${new Date(fs.statSync(file).mtimeMs).toLocaleString('zh-CN')}）`;
+    return `${header}\n\n${content}`;
+}
+export async function handleSkillSlash(ctx) {
+    const args = ctx.content.trim().split(/\s+/).slice(1);
+    const sub = args[0];
+    if (!sub || sub === 'help') {
+        if (sub === 'help')
+            return result(USAGE);
+        if (!canReadSkillSlash(ctx))
+            return error('群聊中技能列表仅限管理员查看');
+        const root = agentRootFor(ctx.selfAid);
+        if (!root)
+            return error('无法确定当前 agent 目录');
+        return result(`${overviewLine(resolveAllSkillStates(root))}\n\n输入 /skill help 查看全部子命令`);
+    }
+    if (!canReadSkillSlash(ctx))
+        return error('群聊中技能查看仅限管理员');
+    const root = agentRootFor(ctx.selfAid);
+    if (!root)
+        return error('无法确定当前 agent 目录');
+    try {
+        if (sub === 'list') {
+            const showAll = args[1] === 'all';
+            return result(formatList(resolveAllSkillStates(root), showAll));
+        }
+        if (sub === 'show' || sub === 'info') {
+            const name = args[1];
+            if (!name)
+                return error('用法: /skill show <name>');
+            const found = resolveAllSkillStates(root).find(s => s.name === name);
+            if (!found)
+                return error(`技能不存在: ${name}\n用 /skill list all 查看全部技能`);
+            return result(formatInfo(found));
+        }
+        if (sub === 'index') {
+            const kind = args[1];
+            if (kind === 'builtin' || kind === 'local') {
+                return result(readIndexFile(ctx.selfAid, kind, ctx.lifecycle));
+            }
+            if (kind !== undefined) {
+                return error(`未知索引: ${kind}\n用法: /skill index [builtin|local]`);
+            }
+            return result(formatIndexOverview(inspectSkillIndexes(root, ctx.selfAid, ctx.lifecycle), ctx.selfAid));
+        }
+        if (sub === 'where')
+            return result(formatWhere(ctx.selfAid));
+        if (sub === 'refresh') {
+            if (!canRefreshSkillSlash(ctx)) {
+                return error(ctx.chatType === 'group'
+                    ? '群聊中不支持重建技能索引，请私聊或由管理员在终端执行'
+                    : '无权限：重建技能索引仅限管理员');
+            }
+            if (!ctx.selfAid)
+                return error('无法确定当前 agent AID');
+            if (!ctx.refresher)
+                return error('daemon 未注入索引刷新入口');
+            const r = await ctx.refresher(ctx.selfAid);
+            if (!r.ok)
+                return error(`重建技能索引失败：${r.error ?? '未知错误'}`);
+            return result('✅ 已重建当前 Agent 的技能索引');
+        }
+        return error(`未知子命令: ${sub}\n\n${USAGE}`);
+    }
+    catch (e) {
+        return error(e instanceof Error ? e.message : String(e));
+    }
+}

package/dist/core/command/slash-gate.js

@@ -43,7 +43,7 @@ export function probeSessionActivity(evidence, probes) {
     return evaluateSessionActivity(collected);
 }
 // 支持的命令列表
-const commands = ['/new', '/pwd', '/help', '/evolhelp', '/status', '/restart', '/reload', '/model', '/effort', '/baseagent', '/slist', '/session', '/rename', '/stop', '/pause', '/compact', '/renew', '/repair', '/fork', '/del', '/perm', '/file', '/check', '/rewind', '/activity', '/observable', '/chatmode', '/mention', '/ask', '/resume', '/aid', '/rpc', '/storage', '/agent', '/trigger', '/upgrade', '/pair', '/memory'];
+const commands = ['/new', '/pwd', '/help', '/evolhelp', '/status', '/restart', '/reload', '/model', '/effort', '/baseagent', '/slist', '/session', '/rename', '/stop', '/pause', '/compact', '/renew', '/repair', '/fork', '/del', '/perm', '/file', '/check', '/rewind', '/activity', '/observable', '/chatmode', '/mention', '/loop', '/ask', '/resume', '/aid', '/rpc', '/storage', '/agent', '/trigger', '/upgrade', '/pair', '/memory', '/skill', '/thread'];
 const deprecatedCommands = ['/clear'];
 commands.push('/diag');
 const exactBoundaryCommands = new Set(['/pause', '/resume', '/stop', '/pair', '/diag']);
@@ -69,6 +69,8 @@ const aliases = {
 const GROUP_READ_ONLY_COMMANDS = new Set(['/model', '/effort', '/perm', '/baseagent']);
 const GROUP_TASK_COMMANDS = new Set([
     '/help', '/evolhelp', '/status', '/check', '/ask', '/pause', '/resume', '/stop', '/compact', '/renew', '/mention', '/memory',
+    // /skill 与 /thread 在群里只放行到 handler：写操作由各自 handler 内部按 admin 判定拒绝
+    '/skill', '/thread', '/loop',
 ]);
 /** Group slash policy applies to every role, including old command-card clicks. */
 export function guardGroupSlashCommand(content, chatType) {
@@ -95,7 +97,7 @@ export function guardGroupSlashCommand(content, chatType) {
     };
 }
 // 命令快速路径前缀（所有命令都不进入消息队列）
-const quickCommandPrefixes = ['/new', '/pwd', '/help', '/evolhelp', '/status', '/restart', '/reload', '/model', '/effort', '/baseagent', '/slist', '/session', '/rename', '/repair', '/fork', '/stop', '/pause', '/clear', '/compact', '/renew', '/del', '/perm', '/file', '/check', '/s ', '/name', '/rewind', '/rw', '/rw ', '/activity', '/observable', '/chatmode', '/mention', '/ask', '/resume', '/base ', '/aid', '/rpc', '/storage', '/agent', '/trigger', '/upgrade', '/pair', '/memory'];
+const quickCommandPrefixes = ['/new', '/pwd', '/help', '/evolhelp', '/status', '/restart', '/reload', '/model', '/effort', '/baseagent', '/slist', '/session', '/rename', '/repair', '/fork', '/stop', '/pause', '/clear', '/compact', '/renew', '/del', '/perm', '/file', '/check', '/s ', '/name', '/rewind', '/rw', '/rw ', '/activity', '/observable', '/chatmode', '/mention', '/loop', '/ask', '/resume', '/base ', '/aid', '/rpc', '/storage', '/agent', '/trigger', '/upgrade', '/pair', '/memory', '/skill', '/thread'];
 quickCommandPrefixes.push('/diag');
 /**
  * 计算两个字符串的 Levenshtein 距离（编辑距离）
@@ -159,9 +161,9 @@ export function guardRoleCommand(content, activeChatType, isAdmin) {
         return undefined;
     // visitor/member 在群聊和私聊中均可访问的只读命令：纯查询形态（带参写操作由各 handler 内部守卫拦截）
     const userGroupCommands = [
-        '/status', '/help', '/evolhelp', '/check', '/chatmode', '/mention',
+        '/status', '/help', '/evolhelp', '/check', '/chatmode', '/mention', '/loop',
         '/model', '/effort', '/baseagent', '/perm', '/activity', '/stop', '/pause',
-        '/resume', '/trigger', '/file', '/ask', '/memory',
+        '/resume', '/trigger', '/file', '/ask', '/memory', '/skill', '/thread',
     ];
     const userCommands = activeChatType === 'group' && !isAdmin
         ? userGroupCommands