evolcore 0.0.32 → 0.0.34

package/dist/core/command/menu-handler.js

@@ -2,7 +2,7 @@ import { memoryHelpEntries } from './memory-slash.js';
 import { getBaseagentSnapshot, loadedBaseagentIds } from '../../agents/baseagent-availability.js';
 import { normalizePeer, writeScope } from '../model/config-scope.js';
 import { formatPeerKey } from '../relation/peer-identity.js';
-import { modelMatches, getCatalog, getBaseagentCatalog, resolveCatalogModel, assertCatalogSelectable, TRANSPORT_EFFORTS } from '../model/model-catalog.js';
+import { modelMatches, getCatalog, getBaseagentCatalog, resolveCatalogModel, assertCatalogSelectable, CONFIGURABLE_EFFORTS, configurableEfforts } from '../model/model-catalog.js';
 import { constrainResolvedModelForRole, filterModelsForRole, validateModelSelectionForRole } from '../model/model-permission.js';
 import { hasModelSwitcher } from '../../agents/runner-types.js';
 import { resolvePaths, getPackageRoot, daemonControlDir } from '../../paths.js';
@@ -45,6 +45,7 @@ import { AGENT_DELEGATION_TOKEN_ENV } from '../auth/agent-delegation.js';
 import { evolMenuResponseTransportMetadata, menuFailure, menuCommandForName, menuSuccess, normalizeMenuError, validateTaskActivityQueryArgs, validateConfigWriteScope, validateMenuRequest, } from './menu-protocol.js';
 import { parseMenuClientProtectedHeaders } from './menu-protocol.js';
 import { TaskActivityStore } from '../task/task-activity-store.js';
+import { DEFAULT_SESSION_LOOP_SECONDS, MAX_SESSION_LOOP_SECONDS, MIN_SESSION_LOOP_SECONDS, refreshSessionLoopTarget, resolveCurrentSessionLoopTarget, sessionLoopPayload, validateIdleSeconds, writeSessionLoopConfig, } from '../session/session-idle-monitor.js';
 import { remoteAccessService, validateAndRenewRemoteAccessToken } from '../auth/remote-access-store.js';
 import { listDiagnosticLogOptions, listRawConfigResources, queryDiagnosticLogs, readRawConfigResource, } from './daemon-diagnostics.js';
 import { roleMenuAction, roleMenuOperation, roleMenuOptions, roleMenuQuery, roleMenuUpdate, } from './role-menu.js';
@@ -63,7 +64,7 @@ import { normalizeTopicLabel, normalizeTopicStatus, resolveTopicArchiveFilter, }
 function getBaseagentVersion(cmd) {
     return cachedCliVersion(cmd);
 }
-const allEfforts = ['none', 'minimal', 'low', 'medium', 'high', 'xhigh', 'max'];
+const allEfforts = CONFIGURABLE_EFFORTS;
 const PERMISSION_MODE_KEYS = PUBLIC_PERMISSION_MODES;
 /** menu file: fetch 文件大小上限（与 /file 和 AUN sendFile 一致） */
 const FILE_FETCH_MAX_SIZE = MAX_AUN_ATTACHMENT_SIZE;
@@ -402,14 +403,14 @@ function tokenizeArgv(line) {
     return out;
 }
 async function getAvailableEfforts(agent, model) {
+    const baseagent = agent?.baseagent || agent?.name;
     const dynamic = await agent.getAvailableEfforts?.(model);
     if (Array.isArray(dynamic))
-        return dynamic;
+        return configurableEfforts(baseagent, dynamic);
     // Keep Menu usable with legacy/embedded runner implementations that do not
     // expose the optional catalog method.  Full runners still take the dynamic
     // path above, so this fallback cannot broaden their advertised capabilities.
-    const baseagent = agent?.baseagent || agent?.name;
-    return (TRANSPORT_EFFORTS[baseagent] ?? []);
+    return configurableEfforts(baseagent);
 }
 function isDaemonControlSubject(subject) {
     return subject.isDaemonOwner === true
@@ -1143,6 +1144,18 @@ function buildMenuAuthSubject(owner, params) {
         fromControlChannel: params.fromControlChannel,
     });
 }
+function agentFullAccessMenuSubject(subject, source) {
+    return {
+        ...subject,
+        agentFullAccessManagement: source === 'control'
+            ? subject.agentFullAccessManagement === true
+            : source === 'menu'
+                && subject.channelType === 'aun'
+                && !subject.fromControlChannel
+                && subject.canApprovePersistentFullAccess === true
+                && subject.processRole === 'daemon-owner',
+    };
+}
 async function authorizeMenuIntent(params) {
     const { intent, identity, session, channel, channelId, userId, fromControlChannel } = params;
     if (!intent)
@@ -1456,12 +1469,7 @@ export function getMenuItems(role, chatType = 'private', scope = 'agent', authSu
                 desc: canUseModel ? '切换当前 Agent 使用的模型版本' : '查看当前 Agent 使用的模型版本',
                 next: canUseModel ? { type: 'select', dynamic: true } : undefined,
             }] : []),
-        ...(canSetEffort ? [{ cmd: '/effort', label: '切换推理强度', desc: '调整模型推理深度，影响响应速度与质量', next: { type: 'select', items: [
-                        { value: 'low', label: 'Low' },
-                        { value: 'medium', label: 'Medium' },
-                        { value: 'high', label: 'High' },
-                        { value: 'max', label: 'Max' },
-                    ] } }] : []),
+        ...(canSetEffort ? [{ cmd: '/effort', label: '切换推理强度', desc: '调整模型推理深度，影响响应速度与质量', next: { type: 'select', dynamic: true } }] : []),
         ...(canSetChatmode ? [{ cmd: '/chatmode', label: '切换会话模式', desc: '控制 Agent 主动性（被动响应或主动推进）', next: { type: 'select', items: [
                         { value: 'interactive', label: '交互模式', desc: '仅在收到消息时响应' },
                         { value: 'proactive', label: '主动模式', desc: 'Agent 可主动推进任务' },
@@ -1723,8 +1731,8 @@ export async function getSubMenuItems(cmd, channel, channelId, userId, args, ove
         if (!selfAid)
             throw { code: 'FORBIDDEN', message: '当前 channel 无绑定 agent' };
         const res = this.agentApplicationService
-            ? await execAgentQuery({ aid: selfAid }, this.agentApplicationService, subject)
-            : await execAgentQuery({ aid: selfAid }, undefined, subject);
+            ? await execAgentQuery({ aid: selfAid }, this.agentApplicationService, agentFullAccessMenuSubject(subject, source))
+            : await execAgentQuery({ aid: selfAid }, undefined, agentFullAccessMenuSubject(subject, source));
         if ('error' in res)
             throw { code: res.code, message: res.error };
         const ag = res.data;
@@ -1966,7 +1974,7 @@ export async function getSubMenuItems(cmd, channel, channelId, userId, args, ove
         }
         catch (error) {
             if (isDaemonControlSubject(subject)) {
-                return ['low', 'medium', 'high', 'auto'].map(e => ({ value: e, label: e === 'auto' ? 'auto (SDK默认)' : e }));
+                return [...configurableEfforts(target.baseagent), 'auto'].map(e => ({ value: e, label: e === 'auto' ? 'auto (SDK默认)' : e }));
             }
             throw error;
         }
@@ -2066,6 +2074,26 @@ export async function execMenuQuery(cmd, channel, channelId, userId, args, expli
         fromControlChannel,
         subject: authSubject,
     });
+    if (cmdBase === '/session' && args?.view === 'loop') {
+        if (Object.keys(args).some(key => key !== 'view' && key !== 'context')) {
+            return { error: 'session.loop query only accepts args.view', code: 'INVALID_ARGUMENT' };
+        }
+        try {
+            const route = { channel, channelId, selfAid: subject.selfAid ?? '', threadId: transportReplyContext?.threadId };
+            const target = await resolveCurrentSessionLoopTarget(this.sessionManager, route);
+            const denied = await authorizeMenuIntent.call(this, {
+                intent: { operation: 'session.loop.current', scope: 'relation', source, args: { sessionId: target.session.id, peer: target.peerKey } },
+                identity, subject: { ...subject, sessionId: target.session.id }, session: target.session, channel, channelId, userId, fromControlChannel, source,
+            });
+            if (denied)
+                return denied;
+            const current = await refreshSessionLoopTarget(this.sessionManager, route, target);
+            return { data: sessionLoopPayload(current) };
+        }
+        catch (error) {
+            return menuResultFailure(error);
+        }
+    }
     const storageRequest = { type: 'menu.query', cmd, args };
     if (isAgentStorageMenuRequest(storageRequest)) {
         try {
@@ -2270,8 +2298,8 @@ export async function execMenuQuery(cmd, channel, channelId, userId, args, expli
         if (fromControlChannel) {
             if (args?.aid) {
                 return this.agentApplicationService
-                    ? await execAgentQuery(args, this.agentApplicationService, subject)
-                    : await execAgentQuery(args, undefined, subject);
+                    ? await execAgentQuery(args, this.agentApplicationService, agentFullAccessMenuSubject(subject, source))
+                    : await execAgentQuery(args, undefined, agentFullAccessMenuSubject(subject, source));
             }
             return this.agentApplicationService
                 ? await execAgentOptions(args, this.agentApplicationService)
@@ -2281,8 +2309,8 @@ export async function execMenuQuery(cmd, channel, channelId, userId, args, expli
         if (!selfAid)
             return { error: '当前 channel 无绑定 agent', code: 'FORBIDDEN' };
         return this.agentApplicationService
-            ? await execAgentQuery({ ...(args ?? {}), aid: selfAid }, this.agentApplicationService, subject)
-            : await execAgentQuery({ ...(args ?? {}), aid: selfAid }, undefined, subject);
+            ? await execAgentQuery({ ...(args ?? {}), aid: selfAid }, this.agentApplicationService, agentFullAccessMenuSubject(subject, source))
+            : await execAgentQuery({ ...(args ?? {}), aid: selfAid }, undefined, agentFullAccessMenuSubject(subject, source));
     }
     // ── /gateway 查询（只读，列出全部作用域的网关配置；apiKey 已掩码） ──
     if (cmdBase === '/gateway') {
@@ -2863,6 +2891,21 @@ export async function execMenuUpdate(cmd, value, channel, channelId, userId, ove
     const cmdBase = cmd.trim().split(' ')[0];
     if (!cmdBase)
         return { error: '缺少命令', code: 'MISSING_CMD' };
+    const isLoopUpdate = cmdBase === '/session' && args?.resource === 'loop';
+    if (isLoopUpdate) {
+        if (typeof value !== 'boolean' || Object.keys(args ?? {}).some(key => key !== 'resource' && key !== 'idleSeconds' && key !== 'context')) {
+            return { error: 'session.loop requires a boolean value and only accepts resource / idleSeconds', code: 'INVALID_ARGUMENT' };
+        }
+        if (!value && Object.hasOwn(args ?? {}, 'idleSeconds')) {
+            return { error: '关闭时不能提供 idleSeconds', code: 'INVALID_ARGUMENT' };
+        }
+        if (Object.hasOwn(args ?? {}, 'idleSeconds') && validateIdleSeconds(args?.idleSeconds) === undefined) {
+            return { error: `idleSeconds 必须是 ${MIN_SESSION_LOOP_SECONDS}-${MAX_SESSION_LOOP_SECONDS} 的整数`, code: 'INVALID_ARGUMENT' };
+        }
+    }
+    else if (typeof value !== 'string') {
+        return { error: 'value 必须是字符串', code: 'INVALID_ARGUMENT' };
+    }
     if (cmdBase === '/perm') {
         return { error: 'permissionMode 只能通过角色策略编辑器修改', code: 'ROLE_POLICY_MANAGED' };
     }
@@ -2888,9 +2931,6 @@ export async function execMenuUpdate(cmd, value, channel, channelId, userId, ove
     }
     if (cmdBase === '/baseagent-models')
         return { error: 'Baseagent catalog only supports menu.query', code: 'NOT_SUPPORTED' };
-    const arg = value.trim();
-    if (!arg)
-        return { error: '缺少 value 参数', code: 'MISSING_VALUE' };
     const identity = overrideIdentity ?? this.sessionManager.resolveIdentity(channel, userId, ...menuIdentityArgs(session));
     const isAdmin = isManagementRole(identity.role);
     const subject = buildMenuAuthSubject(this, {
@@ -2902,6 +2942,31 @@ export async function execMenuUpdate(cmd, value, channel, channelId, userId, ove
         fromControlChannel,
         subject: authSubject,
     });
+    if (isLoopUpdate) {
+        try {
+            const route = { channel, channelId, selfAid: subject.selfAid ?? '', threadId: transportReplyContext?.threadId };
+            const target = await resolveCurrentSessionLoopTarget(this.sessionManager, route);
+            const denied = await authorizeMenuIntent.call(this, {
+                intent: { operation: 'session.loop.update', scope: 'relation', source, args: { sessionId: target.session.id, peer: target.peerKey, value, ...(value ? { idleSeconds: args?.idleSeconds ?? DEFAULT_SESSION_LOOP_SECONDS } : {}) } },
+                identity, subject: { ...subject, sessionId: target.session.id }, session: target.session, channel, channelId, userId, fromControlChannel, source,
+            });
+            if (denied)
+                return denied;
+            const current = await refreshSessionLoopTarget(this.sessionManager, route, target);
+            const config = value === true
+                ? { enabled: true, idleSeconds: args?.idleSeconds ?? DEFAULT_SESSION_LOOP_SECONDS }
+                : { enabled: false };
+            if (config.enabled)
+                this.assertSessionLoopTrigger(current.session);
+            return { data: sessionLoopPayload(writeSessionLoopConfig(this.sessionManager, current, config)) };
+        }
+        catch (error) {
+            return menuResultFailure(error);
+        }
+    }
+    const arg = value.trim();
+    if (!arg)
+        return { error: '缺少 value 参数', code: 'MISSING_VALUE' };
     if (cmdBase === '/role') {
         const authorized = await authorizeRoleMenu(this, {
             kind: 'update', args, value: arg, identity, subject: authSubject, session, channel, channelId,
@@ -3654,7 +3719,7 @@ export async function execMenuAction(cmd, action, args, channel, channelId, user
                 }
             }
         }
-        return await execAgentAction(action, a, userId ?? '', this.eventBus, this.agentApplicationService, subject);
+        return await execAgentAction(action, a, userId ?? '', this.eventBus, this.agentApplicationService, agentFullAccessMenuSubject(subject, source));
     }
     // ── 关系级 /trigger（不走 owners；复用 isAdmin + scoped 逻辑，D4 直调底层） ──
     if (cmdBase === '/trigger') {
@@ -4123,6 +4188,21 @@ export async function execMenuAction(cmd, action, args, channel, channelId, user
                 }
                 catch { }
             }
+            // P1a.5.3: 若为话题会话，同步更新话题索引
+            if (topic.threadId) {
+                try {
+                    const { ThreadService } = await import('../../core/thread/index.js');
+                    const selfAid = topic.selfAID;
+                    const peer = topic.channelId;
+                    if (selfAid && peer) {
+                        const svc = new ThreadService(this.sessionManager);
+                        await svc.renameThread({ selfAid, peer, threadId: topic.threadId, name: newName });
+                    }
+                }
+                catch (err) {
+                    logger.debug('[MenuHandler] Thread index rename sync failed:', err);
+                }
+            }
             this.eventBus.publish({ type: 'session:renamed', sessionId: topic.id, oldName, newName });
             return {
                 data: {
@@ -4754,6 +4834,7 @@ async function execMenuForSystemControl(payload, context) {
             : undefined,
     });
     const trustedIdentity = trustedSubject.identity;
+    trustedSubject.agentFullAccessManagement = context.source === 'control' && context.authMethod === 'daemon-owner';
     const cmd = name ? (menuCommandForName(name) ?? payload.cmd) : payload.cmd;
     if (payload?.type === 'menu.action'
         && menuCommandToken(cmd) === '/system'
@@ -4781,6 +4862,14 @@ async function execMenuForSystemControl(payload, context) {
                         request: payload.args.context,
                         paircodeAllowed: context.authMethod === 'daemon-owner'
                             && (context.source !== 'control' || context.encrypted),
+                        resolveLoopTarget: async (catalogContext) => {
+                            const target = await resolveCurrentSessionLoopTarget(this.sessionManager, {
+                                channel: targetChannel, channelId: catalogContext.channelId, selfAid: catalogContext.self ?? '',
+                            });
+                            if (target.peerKey !== catalogContext.peerKey)
+                                throw { code: 'INVALID_CONTEXT', message: '当前会话关系不匹配' };
+                            return { level: target.level, sessionId: target.session.id };
+                        },
                     });
                     return menuSuccess({ id, ...(name ? { name } : {}) }, data);
                 }
@@ -4839,8 +4928,10 @@ async function execMenuForSystemControl(payload, context) {
             case 'menu.update': {
                 if (!cmd)
                     return ecwebErr(id, name, 'MISSING_CMD', '缺少 name/cmd');
-                if (!payload.value)
+                if (payload.value === undefined || payload.value === null
+                    || (typeof payload.value === 'string' && payload.value.length === 0)) {
                     return ecwebErr(id, name, 'MISSING_VALUE', '缺少 value');
+                }
                 const execution = await resolveExplicitMenuExecutionContext({
                     subject: trustedSubject,
                     channelType: 'aun',

package/dist/core/command/menu-protocol.js

@@ -4,6 +4,7 @@ import { loadDaemonConfig } from '../../config-store.js';
 import { readInstalledEvolcoreVersion } from '../../utils/evolcore-version.js';
 import { compareStableSemver, parseStableSemver } from '../../utils/stable-semver.js';
 import { logger } from '../../utils/logger.js';
+import { validateIdleSeconds } from '../session/session-idle-monitor.js';
 export const MENU_REQUEST_TYPES = new Set([
     'menu.token.request',
     'menu.list',
@@ -334,9 +335,31 @@ export function validateMenuRequest(request) {
         if (scopeError)
             return scopeError;
     }
-    if (type === 'menu.update' && (typeof request.value !== 'string' || request.value.length === 0)) {
+    const isSessionLoopUpdate = type === 'menu.update'
+        && (request.name === 'session' || request.cmd === '/session')
+        && request.args?.resource === 'loop';
+    if (isSessionLoopUpdate) {
+        if (typeof request.value !== 'boolean')
+            return { code: 'INVALID_ARGUMENT', message: 'session.loop value must be a boolean' };
+        const args = request.args;
+        const unknown = Object.keys(args ?? {}).find(key => !['resource', 'idleSeconds', 'context'].includes(key));
+        if (unknown)
+            return { code: 'INVALID_ARGUMENT', message: `session.loop update does not accept args.${unknown}` };
+        if (Object.hasOwn(args ?? {}, 'idleSeconds') && validateIdleSeconds(args?.idleSeconds) === undefined) {
+            return { code: 'INVALID_ARGUMENT', message: 'idleSeconds must be an integer between 30 and 86400' };
+        }
+        if (request.value === false && Object.hasOwn(args ?? {}, 'idleSeconds')) {
+            return { code: 'INVALID_ARGUMENT', message: 'idleSeconds is not allowed when session.loop is disabled' };
+        }
+    }
+    else if (type === 'menu.update' && (typeof request.value !== 'string' || request.value.length === 0)) {
         return { code: 'INVALID_ARGUMENT', message: 'Menu request value is required' };
     }
+    if (type === 'menu.query' && (request.name === 'session' || request.cmd === '/session')
+        && request.args?.view === 'loop'
+        && Object.keys(request.args).some(key => key !== 'view' && key !== 'context')) {
+        return { code: 'INVALID_ARGUMENT', message: 'session.loop query only accepts args.view' };
+    }
     if (type === 'menu.action' && (typeof request.action !== 'string' || request.action.trim().length === 0)) {
         return { code: 'INVALID_ARGUMENT', message: 'Menu request action is required' };
     }
@@ -447,6 +470,7 @@ const STABLE_CODES = new Set([
     'RESPONSE_TOO_LARGE',
     'ACTIVITY_NOT_FOUND', 'ACTIVITY_EXPIRED',
     'TOPIC_SESSION_NOT_FOUND', 'TOPIC_SESSION_LOOKUP_FAILED',
+    'LOOP_TRIGGER_NOT_FOUND', 'LOOP_TRIGGER_DISABLED', 'LOOP_TRIGGER_INVALID',
     'ROOT_NOT_FOUND', 'ROOT_FORBIDDEN', 'ROOT_EXPIRED', 'ROOT_SCOPE_MISMATCH', 'ROOT_PEER_MISMATCH',
     'INVALID_ROOT_ID', 'MISSING_ROOT_ID', 'INVALID_ROOT_PATH', 'NOT_A_DIRECTORY', 'FILE_TOO_LARGE',
 ]);

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));
+    }
+}