@vibe-forge/core 0.4.0 → 0.6.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vibe-forge/core",
-  "version": "0.4.0",
+  "version": "0.6.0",
   "imports": {
     "#~/*.js": {
       "__vibe-forge__": {
@@ -22,60 +22,61 @@
         "require": "./dist/index.js"
       }
     },
-    "./channel": {
+    "./adapter": {
       "__vibe-forge__": {
-        "default": "./src/channel.ts"
+        "default": "./src/adapter/index.ts"
       },
       "default": {
-        "import": "./dist/channel.mjs",
-        "require": "./dist/channel.js"
+        "import": "./dist/adapter.mjs",
+        "require": "./dist/adapter.js"
       }
     },
-    "./utils/*": {
+    "./channel": {
       "__vibe-forge__": {
-        "default": "./src/utils/*.ts"
+        "default": "./src/channel.ts"
       },
       "default": {
-        "import": "./dist/utils/*.mjs",
-        "require": "./dist/utils/*.js"
+        "import": "./dist/channel.mjs",
+        "require": "./dist/channel.js"
       }
     },
-    "./controllers/task": {
+    "./schema": {
       "__vibe-forge__": {
-        "default": "./src/controllers/task/index.ts"
+        "default": "./src/schema.ts"
       },
       "default": {
-        "import": "./dist/controllers/task/index.mjs",
-        "require": "./dist/controllers/task/index.js"
+        "import": "./dist/schema.mjs",
+        "require": "./dist/schema.js"
       }
     },
-    "./controllers/benchmark": {
+    "./hooks": {
       "__vibe-forge__": {
-        "default": "./src/controllers/benchmark/index.ts"
+        "default": "./src/hooks/index.ts"
       },
       "default": {
-        "import": "./dist/controllers/benchmark/index.mjs",
-        "require": "./dist/controllers/benchmark/index.js"
+        "import": "./dist/hooks/index.mjs",
+        "require": "./dist/hooks/index.js"
       }
     },
-    "./schema": {
+    "./utils/*": {
       "__vibe-forge__": {
-        "default": "./src/schema.ts"
+        "default": "./src/utils/*.ts"
       },
       "default": {
-        "import": "./dist/schema.mjs",
-        "require": "./dist/schema.js"
+        "import": "./dist/utils/*.mjs",
+        "require": "./dist/utils/*.js"
       }
     },
-    "./hooks": {
+    "./controllers/*": {
       "__vibe-forge__": {
-        "default": "./src/hooks/index.ts"
+        "default": "./src/controllers/*/index.ts"
       },
       "default": {
-        "import": "./dist/hooks/index.mjs",
-        "require": "./dist/hooks/index.js"
+        "import": "./dist/controllers/*/index.mjs",
+        "require": "./dist/controllers/*/index.js"
       }
-    }
+    },
+    "./package.json": "./package.json"
   },
   "dependencies": {
     "fast-glob": "^3.3.3",

package/src/adapter/type.ts

@@ -20,6 +20,7 @@ export type SessionInfo =
 export interface SessionInitInfo {
   uuid: string
   model: string
+  adapter?: string
   version: string
   tools: string[]
   slashCommands: string[]

package/src/channel.ts

@@ -4,12 +4,53 @@ export interface ChannelMap {}
 
 export type ChannelType = keyof ChannelMap
 
+export const channelAccessSchema = z.object({
+  // 管理员
+  admins: z.array(z.string()).optional().describe(
+    '频道管理员账号（sender ID），管理员拥有管理操作权限且不受以下访问控制限制'
+  ),
+  // 会话类型控制
+  allowPrivateChat: z.boolean().optional().describe('是否允许私聊消息，默认 true'),
+  allowGroupChat: z.boolean().optional().describe('是否允许群聊消息，默认 true'),
+  // 群组访问控制
+  allowedGroups: z.array(z.string()).optional().describe('群组白名单（channel ID），设置后仅在指定群中响应'),
+  blockedGroups: z.array(z.string()).optional().describe('群组黑名单（channel ID），在指定群中不响应'),
+  // 用户访问控制
+  allowedSenders: z.array(z.string()).optional().describe('发送者白名单（sender ID），设置后仅白名单内的用户可交互'),
+  blockedSenders: z.array(z.string()).optional().describe('发送者黑名单（sender ID），黑名单内的用户消息将被忽略')
+})
+
+export type ChannelAccessConfig = z.infer<typeof channelAccessSchema>
+
 export const channelBaseSchema = z.object({
-  type: z.string().min(1).describe('频道类型'),
-  title: z.string().optional().describe('频道标题'),
-  description: z.string().optional().describe('频道说明'),
-  enabled: z.boolean().optional().describe('是否启用'),
-  admins: z.array(z.string()).optional().describe('频道管理员账号')
+  // 基础配置
+  type: z
+    .string().min(1)
+    .describe('频道类型'),
+  title: z
+    .string().optional()
+    .describe('频道标题'),
+  description: z
+    .string().optional()
+    .describe('频道说明'),
+  enabled: z
+    .boolean().optional()
+    .describe('是否启用'),
+  // 会话行为
+  systemPrompt: z
+    .string().optional()
+    .describe('在此频道启动会话时注入的系统提示词'),
+  // 指令
+  commandPrefix: z
+    .string().optional()
+    .describe('频道指令前缀，默认 /'),
+  language: z
+    .enum(['zh', 'en']).optional()
+    .describe('频道提示语言，默认 zh'),
+  // 访问权限控制
+  access: channelAccessSchema
+    .optional()
+    .describe('频道访问权限配置')
 })
 
 export type ChannelBaseConfig = z.infer<typeof channelBaseSchema>
@@ -20,14 +61,48 @@ export type ChannelConfig = {
   [K in ChannelType]: ChannelConfigByType<K>
 }[ChannelType]
 
+export interface ChannelSendResult {
+  messageId?: string
+}
+
+export interface ChannelFollowUp {
+  content: string
+  i18nContents?: Array<{
+    content: string
+    language: string
+  }>
+}
+
 export interface ChannelConnection<TMessage> {
-  sendMessage: (message: TMessage) => Promise<void>
+  sendMessage: (message: TMessage) => Promise<ChannelSendResult | undefined>
+  pushFollowUps?: (input: {
+    messageId: string
+    followUps: readonly ChannelFollowUp[]
+  }) => Promise<void>
   startReceiving?: (options: {
     handlers: ChannelEventHandlers
   }) => Promise<void>
+  /**
+   * Called when a new session is being created for this channel.
+   * The channel implementation can use this to inject channel-specific context
+   * (e.g. bot profile fetched from platform API) into the system prompt.
+   */
+  generateSystemPrompt?: (inbound: ChannelInboundEvent) => Promise<string | undefined>
   close?: () => Promise<void>
 }
 
+export interface ChannelLogger {
+  error: (...msg: unknown[]) => void | Promise<void>
+  warn: (...msg: unknown[]) => void | Promise<void>
+  info: (...msg: unknown[]) => void | Promise<void>
+  debug: (...msg: unknown[]) => void | Promise<void>
+  trace: (...msg: unknown[]) => void | Promise<void>
+}
+
+export interface ChannelConnectionOptions {
+  logger?: ChannelLogger
+}
+
 export interface ChannelInboundEvent {
   channelType: string
   sessionType: string
@@ -70,6 +145,11 @@ export const defineChannel = <TConfigSchema extends z.ZodTypeAny, TMessageSchema
   descriptor: ChannelDescriptor<TConfigSchema, TMessageSchema>
 ) => descriptor
 
-export const defineChannelConnection = <TConfigSchema extends z.ZodTypeAny, TMessageSchema extends z.ZodTypeAny>(
-  connect: (config: z.infer<TConfigSchema>) => Promise<ChannelConnection<z.infer<TMessageSchema>>>
-) => connect
+export type ChannelCreateFn<TConfig = unknown, TMessage = unknown> = (
+  config: TConfig,
+  options?: ChannelConnectionOptions
+) => Promise<ChannelConnection<TMessage>>
+
+export const defineCreateChannelConnection = <TConfigSchema extends z.ZodTypeAny, TMessageSchema extends z.ZodTypeAny>(
+  connect: ChannelCreateFn<z.infer<TConfigSchema>, z.infer<TMessageSchema>>
+): ChannelCreateFn<z.infer<TConfigSchema>, z.infer<TMessageSchema>> => connect

package/src/config/types.ts

@@ -1,8 +1,14 @@
-import type { ChannelConfig } from '../channels'
+import type { ChannelConfig } from '../channel'
 import type { PluginConfig } from '../hooks'
 
 export interface AdapterMap {}
 
+export interface AdapterBuiltinModel {
+  value: string
+  title: string
+  description: string
+}
+
 export interface ModelServiceConfig {
   /**
    * 模型服务展示标题
@@ -228,6 +234,7 @@ export interface ConfigSection {
   modelServices?: Config['modelServices']
   channels?: Config['channels']
   adapters?: Config['adapters']
+  adapterBuiltinModels?: Record<string, AdapterBuiltinModel[]>
   plugins?: {
     plugins?: Config['plugins']
     enabledPlugins?: Config['enabledPlugins']

package/src/controllers/task/prepare.ts

@@ -1,7 +1,7 @@
 import process from 'node:process'
 
-import type { AdapterCtx, AdapterQueryOptions } from '@vibe-forge/core'
 import { loadConfig } from '@vibe-forge/core'
+import type { AdapterCtx, AdapterQueryOptions } from '@vibe-forge/core/adapter'
 import { getCache, setCache } from '@vibe-forge/core/utils/cache'
 import { createLogger } from '@vibe-forge/core/utils/create-logger'
 import { uuid } from '@vibe-forge/core/utils/uuid'

package/src/controllers/task/run.ts

@@ -1,12 +1,8 @@
-import type {
-  AdapterCtx,
-  AdapterOutputEvent,
-  AdapterQueryOptions,
-  ModelServiceConfig,
-  TaskDetail
-} from '@vibe-forge/core'
-import { loadAdapter } from '@vibe-forge/core'
-import { callHook } from '@vibe-forge/core/utils/api'
+import type { AdapterCtx, AdapterOutputEvent, AdapterQueryOptions } from '#~/adapter/index.js'
+import { loadAdapter } from '#~/adapter/index.js'
+import type { ModelServiceConfig } from '#~/config.js'
+import type { TaskDetail } from '#~/types.js'
+import { callHook } from '#~/utils/api.js'
 
 import { prepare } from './prepare'
 import type { RunTaskOptions } from './type'
@@ -26,17 +22,29 @@ const resolveQueryModel = (params: {
   inputModel?: string
 }) => {
   const inputModel = normalizeNonEmptyString(params.inputModel)
-  if (inputModel?.includes(',')) return inputModel
+  // User explicitly provided a model → pass through as-is.
+  // The adapter decides CCR vs native based on whether it contains ",".
+  if (inputModel != null) return inputModel
 
+  // No explicit model → auto-resolve from modelServices config.
+  // Produces "service,model" format when services are configured,
+  // which signals the adapter to route through CCR.
   const mergedModelServices = {
     ...(params.config?.modelServices ?? {}),
     ...(params.userConfig?.modelServices ?? {})
   }
-  const mergedDefaultModel = pickFirstNonEmptyString([params.userConfig?.defaultModel, params.config?.defaultModel])
-  const mergedDefaultModelService = pickFirstNonEmptyString([
-    params.userConfig?.defaultModelService,
-    params.config?.defaultModelService
-  ])
+  const mergedDefaultModel = pickFirstNonEmptyString(
+    [
+      params.userConfig?.defaultModel,
+      params.config?.defaultModel
+    ]
+  )
+  const mergedDefaultModelService = pickFirstNonEmptyString(
+    [
+      params.userConfig?.defaultModelService,
+      params.config?.defaultModelService
+    ]
+  )
 
   const serviceEntries = Object.entries(mergedModelServices)
   const modelToService = new Map<string, string>()
@@ -54,20 +62,21 @@ const resolveQueryModel = (params: {
     }
   }
 
+  if (availableModels.length === 0) return undefined
+
   const resolveDefaultModel = () => {
-    if (availableModels.length === 0) return undefined
     if (mergedDefaultModel && modelToService.has(mergedDefaultModel)) return mergedDefaultModel
     if (mergedDefaultModelService && mergedModelServices[mergedDefaultModelService]) {
-      const service = mergedModelServices[mergedDefaultModelService]
+      const service = mergedModelServices[mergedDefaultModelService] as ModelServiceConfig | undefined
       const models = Array.isArray(service?.models)
-        ? service?.models.filter(item => typeof item === 'string' && item.trim() !== '')
+        ? service?.models.filter((item: unknown) => typeof item === 'string' && (item as string).trim() !== '')
         : []
       if (models.length > 0) return models[0]
     }
     return availableModels[0]
   }
 
-  const resolvedModel = inputModel ?? resolveDefaultModel()
+  const resolvedModel = resolveDefaultModel()
   if (!resolvedModel) return undefined
 
   const resolvedService = modelToService.get(resolvedModel) ??
@@ -120,6 +129,17 @@ export const run = async (
 
   const originalOnEvent = adapterOptions.onEvent
   const wrappedOnEvent = (event: AdapterOutputEvent) => {
+    if (event.type === 'init') {
+      originalOnEvent({
+        ...event,
+        data: {
+          ...event.data,
+          adapter: adapterType
+        }
+      })
+      return
+    }
+
     if (event.type === 'exit') {
       const { data } = event
 

package/src/env.ts

@@ -11,8 +11,6 @@ export interface ServerEnv {
   __VF_PROJECT_AI_CLIENT_MODE__?: 'dev' | 'static'
   __VF_PROJECT_AI_CLIENT_BASE__?: string
   __VF_PROJECT_AI_CLIENT_DIST_PATH__?: string
-  __VF_PROJECT_AI_ADAPTER_CLAUDE_CODE_CLI_PATH__?: string
-  __VF_PROJECT_AI_ADAPTER_CLAUDE_CODE_CLI_ARGS__?: string
 }
 
 export function loadEnv(): ServerEnv {
@@ -26,10 +24,7 @@ export function loadEnv(): ServerEnv {
     __VF_PROJECT_AI_SERVER_ALLOW_CORS__,
     __VF_PROJECT_AI_CLIENT_MODE__ = 'static',
     __VF_PROJECT_AI_CLIENT_BASE__,
-    __VF_PROJECT_AI_CLIENT_DIST_PATH__,
-
-    __VF_PROJECT_AI_ADAPTER_CLAUDE_CODE_CLI_PATH__,
-    __VF_PROJECT_AI_ADAPTER_CLAUDE_CODE_CLI_ARGS__
+    __VF_PROJECT_AI_CLIENT_DIST_PATH__
   } = processEnv || {}
   return {
     __VF_PROJECT_AI_SERVER_HOST__,
@@ -42,12 +37,8 @@ export function loadEnv(): ServerEnv {
     __VF_PROJECT_AI_SERVER_ALLOW_CORS__: __VF_PROJECT_AI_SERVER_ALLOW_CORS__ != null
       ? __VF_PROJECT_AI_SERVER_ALLOW_CORS__ === 'true'
       : true,
-    __VF_PROJECT_AI_CLIENT_MODE__:
-      __VF_PROJECT_AI_CLIENT_MODE__ as ServerEnv['__VF_PROJECT_AI_CLIENT_MODE__'],
+    __VF_PROJECT_AI_CLIENT_MODE__: __VF_PROJECT_AI_CLIENT_MODE__ as ServerEnv['__VF_PROJECT_AI_CLIENT_MODE__'],
     __VF_PROJECT_AI_CLIENT_BASE__,
-    __VF_PROJECT_AI_CLIENT_DIST_PATH__,
-
-    __VF_PROJECT_AI_ADAPTER_CLAUDE_CODE_CLI_PATH__,
-    __VF_PROJECT_AI_ADAPTER_CLAUDE_CODE_CLI_ARGS__
+    __VF_PROJECT_AI_CLIENT_DIST_PATH__
   }
 }

package/src/index.ts

@@ -1,4 +1,3 @@
-export * from './adapter'
 export * from './config'
 export * from './controllers/benchmark'
 export * from './controllers/config'

package/src/types.ts

@@ -9,6 +9,8 @@ export interface Project {
 
 export type SessionStatus = 'running' | 'completed' | 'failed' | 'terminated' | 'waiting_input'
 
+export type SessionPermissionMode = 'default' | 'acceptEdits' | 'plan' | 'dontAsk' | 'bypassPermissions'
+
 export interface Session {
   id: string
   parentSessionId?: string
@@ -21,6 +23,9 @@ export interface Session {
   isArchived?: boolean
   tags?: string[]
   status?: SessionStatus
+  model?: string
+  adapter?: string
+  permissionMode?: SessionPermissionMode
 }
 
 export type ChatMessageContent =

package/src/utils/cache.ts

@@ -46,6 +46,13 @@ export const getCache = async <K extends keyof Cache>(
   key: K
 ): Promise<Cache[K] | undefined> => {
   const cachePath = getCachePath(cwd, taskId, sessionId, key)
-  await fs.access(cachePath)
+  try {
+    await fs.access(cachePath)
+  } catch (error) {
+    if ((error as NodeJS.ErrnoException).code === 'ENOENT') {
+      return undefined
+    }
+    throw error
+  }
   return JSON.parse(await fs.readFile(cachePath, 'utf-8'))
 }

package/src/utils/definition-loader.ts

@@ -1,6 +1,6 @@
 import { existsSync } from 'node:fs'
 import { readFile } from 'node:fs/promises'
-import { basename, dirname, join, relative, resolve } from 'node:path'
+import { basename, dirname, relative, resolve } from 'node:path'
 import process from 'node:process'
 
 import { glob } from 'fast-glob'
@@ -79,6 +79,50 @@ export const loadLocalDocuments = async <Attrs extends object>(
   return Promise.all(promises)
 }
 
+const normalizePath = (path: string) => path.split('\\').join('/')
+
+const stripExtension = (fileName: string) => fileName.replace(/\.[^/.]+$/, '')
+
+const getFirstNonEmptyLine = (text: string) =>
+  text
+    .split('\n')
+    .map(line => line.trim())
+    .find(Boolean)
+
+const toPromptPath = (cwd: string, path: string) => {
+  const relPath = normalizePath(relative(cwd, path))
+  return relPath.startsWith('..') ? normalizePath(path) : relPath
+}
+
+const resolveDocumentName = (
+  path: string,
+  explicitName?: string,
+  indexFileNames: string[] = []
+) => {
+  const trimmedName = explicitName?.trim()
+  if (trimmedName) return trimmedName
+
+  const fileName = basename(path).toLowerCase()
+  if (indexFileNames.includes(fileName)) {
+    return basename(dirname(path))
+  }
+
+  return stripExtension(basename(path))
+}
+
+const resolveDocumentDescription = (
+  body: string,
+  explicitDescription?: string,
+  fallbackName?: string
+) => {
+  const trimmedDescription = explicitDescription?.trim()
+  return trimmedDescription || getFirstNonEmptyLine(body) || fallbackName || ''
+}
+
+const resolveSpecIdentifier = (path: string, explicitName?: string) => {
+  return resolveDocumentName(path, explicitName, ['index.md'])
+}
+
 export class DefinitionLoader {
   private readonly cwd: string
 
@@ -113,13 +157,12 @@ export class DefinitionLoader {
     const rulesPrompt = rules
       .map((rule) => {
         const { path, body, attributes } = rule
-        const name = attributes.name ?? basename(path)
-        const desc = attributes.description ?? name
-        return (
-          `  - ${name}：${desc}\n` +
-          `${attributes.always ? body : ''}\n` +
-          '--------------------\n'
-        )
+        const name = resolveDocumentName(path, attributes.name)
+        const desc = resolveDocumentDescription(body, attributes.description, name)
+        const content = attributes.always && body.trim()
+          ? `<rule-content>\n${body.trim()}\n</rule-content>\n`
+          : ''
+        return `  - ${name}：${desc}\n${content}--------------------\n`
       })
       .filter(Boolean)
       .join('\n')
@@ -150,9 +193,7 @@ export class DefinitionLoader {
     // Filter by directory name (skill name)
     if (skills) {
       paths = paths.filter(path => {
-        const parts = path.split('/')
-        // .../skills/{name}/SKILL.md
-        return skills.includes(parts[parts.length - 2])
+        return skills.includes(basename(dirname(path)))
       })
     }
 
@@ -164,13 +205,17 @@ export class DefinitionLoader {
   generateSkillsPrompt(skills: Definition<Skill>[]): string {
     return skills
       .map((skill) => {
-        const { path, body } = skill
+        const { path, body, attributes } = skill
+        const name = resolveDocumentName(path, attributes.name, ['skill.md'])
+        const desc = resolveDocumentDescription(body, attributes.description, name)
         return (
           '技能相关信息如下，通过阅读以下内容了解技能的详细信息：\n' +
-          `- 技能文件资源路径：${dirname(path)}\n` +
+          `- 技能名称：${name}\n` +
+          `- 技能介绍：${desc}\n` +
+          `- 技能文件资源路径：${toPromptPath(this.cwd, dirname(path))}\n` +
           '- 资源内容：\n' +
           '<skill-content>\n' +
-          `${body}\n` +
+          `${body.trim()}\n` +
           '</skill-content>\n' +
           '资源内容中的文件路径相对「技能文件资源路径」路径，通过读取相关工具按照实际需要进行阅读。\n'
         )
@@ -185,7 +230,11 @@ export class DefinitionLoader {
         skills
           .filter(({ attributes: { always } }) => always !== false)
           .map(
-            ({ attributes: { name, description } }) => `  - ${name}：${description}\n`
+            ({ path, body, attributes }) => {
+              const name = resolveDocumentName(path, attributes.name, ['skill.md'])
+              const desc = resolveDocumentDescription(body, attributes.description, name)
+              return `  - ${name}：${desc}\n`
+            }
           )
           .join('')
       }\n` +
@@ -197,7 +246,8 @@ export class DefinitionLoader {
     const patterns = [
       `.ai/specs/${name}.md`,
       `.ai/specs/${name}/index.md`,
-      `.ai/plugins/*/specs/${name}.md`
+      `.ai/plugins/*/specs/${name}.md`,
+      `.ai/plugins/*/specs/${name}/index.md`
     ]
     const paths = await this.scan(patterns)
     if (paths.length === 0) return undefined
@@ -221,34 +271,23 @@ export class DefinitionLoader {
   generateSpecRoutePrompt(specsDocuments: Definition<Spec>[]): string {
     const specsRouteStr = specsDocuments
       .filter(({ attributes }) => attributes.always !== false)
-      .map(({ path, attributes }) => {
-        const name = attributes.name ?? basename(dirname(path))
-        const desc = attributes.description ?? name
+      .map(({ path, body, attributes }) => {
+        const name = resolveDocumentName(path, attributes.name, ['index.md'])
+        const desc = resolveDocumentDescription(body, attributes.description, name)
+        const identifier = resolveSpecIdentifier(path, attributes.name)
         const params = attributes.params ?? []
-        // Calculate relative path for display/ID
-        // User code used relative('.ai/specs', path), but here path is absolute.
-        // We can try to make it relative to cwd/.ai/specs if possible, or just relative to cwd.
-        // The user code seems to assume specs are in .ai/specs.
-        // Let's use relative(join(this.cwd, '.ai/specs'), path) if it's in there, otherwise...
-        // Actually, just providing a relative path from project root is probably fine or the name.
-        // User code: relative('.ai/specs', path)
-
-        let relPath = relative(join(this.cwd, '.ai/specs'), path)
-        if (relPath.startsWith('..')) {
-          // Maybe in a plugin?
-          relPath = relative(this.cwd, path)
-        }
+        const paramsPrompt = params.length > 0
+          ? params
+            .map(({ name, description }) => `    - ${name}：${description ?? '无'}\n`)
+            .join('')
+          : '    - 无\n'
 
         return (
           `- 流程名称：${name}\n` +
           `  - 介绍：${desc}\n` +
-          `  - 标识：${relPath}\n` +
+          `  - 标识：${identifier}\n` +
           '  - 参数：\n' +
-          `${
-            params
-              .map(({ name, description }) => `    - ${name}：${description}\n`)
-              .join('')
-          }\n`
+          `${paramsPrompt}`
         )
       })
       .join('\n')
@@ -285,7 +324,9 @@ export class DefinitionLoader {
 
     // 2. Fallback to Markdown file
     const patterns = [
+      `.ai/entities/${name}.md`,
       `.ai/entities/${name}/README.md`,
+      `.ai/plugins/*/entities/${name}.md`,
       `.ai/plugins/*/entities/${name}/README.md`
     ]
     const paths = await this.scan(patterns)
@@ -327,7 +368,9 @@ export class DefinitionLoader {
     // List both .md and index.json entities
     const mdPatterns = [
       '.ai/entities/*.md',
-      '.ai/plugins/*/entities/*.md'
+      '.ai/entities/*/README.md',
+      '.ai/plugins/*/entities/*.md',
+      '.ai/plugins/*/entities/*/README.md'
     ]
     const jsonPatterns = [
       '.ai/entities/*/index.json',
@@ -350,7 +393,12 @@ export class DefinitionLoader {
       '项目存在如下实体：\n' +
       `${
         entities
-          .map(({ attributes: { name, prompt: _p }, body }) => `  - ${name}：${body}\n`)
+          .filter(({ attributes }) => attributes.always !== false)
+          .map(({ path, attributes, body }) => {
+            const name = resolveDocumentName(path, attributes.name, ['readme.md', 'index.json'])
+            const desc = resolveDocumentDescription(body, attributes.description, name)
+            return `  - ${name}：${desc}\n`
+          })
           .join('')
       }\n` +
       '解决用户问题时，需根据用户需求可以通过 run-tasks 工具指定为实体后，自行调度多个不同类型的实体来完成工作。\n' +