@h-ai/cli 0.1.0-alpha.61 → 0.1.0-alpha.62

package/templates/skills/hai-storage/SKILL.md

@@ -12,10 +12,10 @@ description: "使用 @h-ai/storage 访问本地/S3 文件、目录和预签名
 | 能力 | 使用 @h-ai/storage 访问本地/S3 文件、目录和预签名上传下载 |
 | 适用场景 | 文件接口、目录操作或浏览器直传 |
 | 输入 | StorageConfigInput、文件 key、内容、presign 选项 |
-| 输出 | file/dir/presign 操作的 HaiResult |
+| 输出 | file/dir/presign 操作的 HaiResult；checksum 生成字符串或校验结果 |
 | 限制 | 仅服务端；浏览器经 API/预签名 URL。Local list 非真分页；putUrl 不提供 maxSize 强制约束，上传大小须服务端验证。 |
 
-> `@h-ai/storage` 提供统一文件存储接口，支持本地文件系统（LocalProvider）和 S3 兼容存储（S3Provider），通过 `storage.file`、`storage.dir`、`storage.presign` 三组接口访问能力。
+> `@h-ai/storage` 提供统一文件存储接口，支持本地文件系统（LocalProvider）和 S3 兼容存储（S3Provider），通过 `storage.file`、`storage.dir`、`storage.presign` 访问存储，`storage.checksum` 提供 Node 端无需初始化的字节完整性工具。
 
 ## 运行环境
 
@@ -84,6 +84,7 @@ if (!closeResult.success) {
 
 - `put(key, data, options?)`
 - `get(key, options?)`
+- `getStream(key, options?)`（字节流，迭代错误可抛出）
 - `head(key)`
 - `exists(key)`
 - `delete(key)`
@@ -135,6 +136,8 @@ const downloadUrl = await storage.presign.getUrl('uploads/doc.pdf', {
 | `HaiStorageError.OPERATION_FAILED` | `hai:storage:002` | 操作失败 |
 | `HaiStorageError.NOT_FOUND` | `hai:storage:003` | 文件不存在 |
 | `HaiStorageError.ALREADY_EXISTS` | `hai:storage:004` | 文件已存在 |
+| `HaiStorageError.CHECKSUM_FAILED` | `hai:storage:016` | checksum 读取/计算失败 |
+| `HaiStorageError.INVALID_CHECKSUM` | `hai:storage:017` | checksum 格式/算法非法 |
 | `HaiStorageError.PERMISSION_DENIED` | `hai:storage:005` | 权限不足 |
 | `HaiStorageError.QUOTA_EXCEEDED` | `hai:storage:006` | 配额超限 |
 | `HaiStorageError.INVALID_PATH` | `hai:storage:007` | 路径无效 |
@@ -159,6 +162,10 @@ const result = await apiClient.storage.presignedUrls.createUpload({ key: 'avatar
 
 ## 常见模式
 
+大文件上传用 `file.put(key, readableOrAsyncByteStream, { signal, ifNoneMatch: '*' })`，内部使用有界 S3 multipart；下载用 `file.getStream(key, { signal, rangeStart, rangeEnd })`，及时消费或关闭，迭代期间 I/O/取消可能抛错。本地读取目录直接返回 `INVALID_PATH`。checksum 的 signal 取消会停止等待下一块数据并请求关闭输入迭代器。`get()` 返回完整 Buffer，只用于容量可控的数据。仅创建写入采用 S3 标准条件或本地原子发布，冲突返回 `ALREADY_EXISTS`；后端不支持时失败，不退回覆盖。
+
+`checksum.generate(data, options?)` / `checksum.verify(data, expected, options?)` 默认 SHA-256、小写 hex，可选 sha384/sha512/sha1/md5、base64 编码与 signal；流仅消费一次，读取失败返回 HaiResult 错误，不匹配返回 false。MD5/SHA-1 不作安全认证，ETag 和 multipart 复合 checksum 不当作完整文件摘要。浏览器不导入 Node checksum；离线增量摘要需使用适用的浏览器实现，不把 SubtleCrypto.digest 当流式 API。
+
 ### 与 kit 集成（文件上传 API）
 
 ```typescript

package/templates/skills/hai-ui/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: hai-ui
-description: "使用 @h-ai/ui 构建 Svelte 5 表单、表格、弹窗、移动界面、主题与 AI 内容展示。"
+description: "使用 @h-ai/ui 构建 Svelte 5 表单、表格、弹窗、新手引导、帮助中心、主题与 AI 内容展示。"
 ---
 
 # hai-ui
@@ -29,6 +29,8 @@ description: "使用 @h-ai/ui 构建 Svelte 5 表单、表格、弹窗、移动
 
 ## 按需参考
 
+新手引导、首次 Cookie 提示、操作导览和帮助中心见 [guide.md](guide.md)。fullstack 默认在共享管理界面接入，新增业务只补内容与 data-guide 锚点。
+
 详细配置、API 签名、错误码和范本在 [reference.md](reference.md)。按下列标题定位所需小节，不默认通读；用例中的业务变量需结合当前应用补齐。
 
 - 运行环境

package/templates/skills/hai-ui/guide.md

@@ -0,0 +1,79 @@
+# 新手引导与帮助中心
+
+`@h-ai/ui/guide` 提供 `createGuide`、`GuideHost`、`HelpCenter` 和相关类型。无需 init/close；driver.js 引擎在开始导览时动态加载，样式由 GuideHost 导入并跟随现有 DaisyUI 主题。
+
+## 最小接入
+
+下面的 `m`、`locale`、`currentUser`、`createUser` 来自应用。翻译 key 需要在应用中英文消息文件定义；`nav` 使用当前宿主的公开导航适配器。
+
+```svelte
+<script lang='ts'>
+  import { createGuide, GuideHost } from '@h-ai/ui/guide'
+  import { createSvelteKitNavAdapter } from '@h-ai/kit/client'
+  import * as m from '$lib/paraglide/messages.js'
+
+  const guide = createGuide({
+    nav: createSvelteKitNavAdapter(),
+    persistKey: 'my-app-guide',
+    tours: [{
+      id: 'users',
+      version: 1,
+      route: '/users',
+      title: () => m.guide_users_title(),
+      description: () => m.guide_users_description(),
+      steps: [{
+        target: 'users-create',
+        title: () => m.guide_create_title(),
+        description: () => m.guide_create_description(),
+      }],
+    }],
+    articles: [{
+      id: 'users-help',
+      title: () => m.guide_users_title(),
+      content: () => m.guide_users_markdown(),
+      tourId: 'users',
+    }],
+  })
+</script>
+
+<GuideHost {guide} {locale} scope={currentUser.id} autoStart='users' />
+<Button onclick={() => guide.openHelp()}>{m.help()}</Button>
+<Button data-guide='users-create' onclick={createUser}>{m.create_user()}</Button>
+```
+
+每个布局只放一个宿主；实际目标按钮位于 `route` 对应的页面，跨页面调用时先导航再定位。SPA、Capacitor、Tauri 使用已有 `NavAdapter`；默认导航通过 location.assign 完整加载页面，GuideHost 用短期 sessionStorage 记录在目标页继续启动。
+
+## 行为契约
+
+| API / 配置 | 契约 |
+| --- | --- |
+| `resolveGuideText(text?)` | 将字符串或 i18n 回调解析为当前文本；宿主组件已自动调用，通常无需手动解析 |
+| `guide.start(id)` | 手动启动或重看；返回 `Promise<boolean>`。失败返回 false，`guide.error` 为当前 UI 语言提示 |
+| `guide.startIfNeeded(id)` | 尚未看过时提供首次邀请；返回 boolean，不直接跳转。通常由 GuideHost 的 autoStart 代劳 |
+| `guide.openHelp(articleId?)` | 打开帮助中心，可直接定位文章；开始导览时自动关闭帮助弹窗 |
+| `guide.stop()` | 取消等待并释放浮层，不记为完成；关闭按钮、Escape 和遮罩点击在首帧定位期间也会清除 busy，启动中的 start 返回 false |
+| `guide.reset(id)` | 删除当前 scope 的偏好，使首次邀请可以再次显示 |
+| `persistence` | `'cookie'`（默认）、`'localStorage'` 或 `'memory'`；受限存储在实例内回退到内存 |
+| `persistKey` / `scope` / `version` | 应用、用户、引导版本独立记录；使用非敏感标识，不能用于权限校验 |
+| `waitTimeout` | 元素等待上限，默认 3000ms；异步操作取消后不得回填旧状态 |
+| `step.before(signal)` | 展开页签或抽屉等 UI 准备，返回 void 或 Promise；不得自动提交业务表单 |
+| `step.optional` | 可选元素缺失可跳过；必要元素缺失必须停止，不能误记为完成 |
+| `tour.enabled` / `article.enabled` | 依据现有权限或功能开关提供内容，不能代替业务授权 |
+
+首次邀请提供开始、稍后、不再提醒。稍后暂缓一天；完成和不再提醒默认保存一年（Cookie）。关闭导览不等于完成；手动重看始终可用。切换账号或离开当前导览页面会清理交互。
+
+## i18n、样式与边界
+
+- 通用按钮、进度和错误由 UI 内置中英文维护。业务文案使用 `() => m.key()` 延迟求值；GuideHost 的 locale 接入应用已有语言状态，不另建语言体系。
+- 语言变化时宿主重新解析文案并刷新当前浮层。应用若采用整页重载或销毁组件切换语言，应按自身生命周期重新挂载宿主。
+- 目标优先使用 `data-guide`，不依赖 Tailwind 类名或 DOM 顺序；现有 UI 组件支持 data 属性透传。复杂目标可用 `target: () => document.querySelector(...)`。
+- 步骤标题和说明按纯文本显示；帮助正文使用现有安全 MarkdownRenderer，原始 HTML 关闭。
+- 控制器在组件内创建，不能在 SSR 模块级共享用户状态。GuideHost 挂载前不读取浏览器记录，卸载时清理。
+- 保留 Tailwind 对 UI 包的 `@source` 扫描。只改变应用局部 data-theme 时，body 浮层需要同步相同主题；标准 applyTheme 设置 html 的 data-theme，浮层会自动继承。
+- HelpCenter 可独立作为帮助页面：提供 articles、可选 tours、locale、selectedId 和 onstart，无需自己实现搜索与安全 Markdown 渲染。
+
+## 默认应用
+
+fullstack 的 Web/App/Desktop 在共享 AdminWorkspace 中启用帮助入口、首次邀请和个人设置导览；Web 使用 Cookie，App/Desktop 使用 localStorage，按当前用户 ID 隔离。新增业务功能时，在共享 guide-store 和中英文消息中补充文章、导览和稳定锚点。
+
+验证首次提示、完成后刷新、手动重看、跳转后等待、缺失目标、账号/版本隔离、语言与主题、移动宽度、键盘和卸载取消。

package/templates/skills/hai-ui/reference.md

@@ -344,6 +344,15 @@ const p = usePlatform()
 
 内置中英文翻译的业务场景组件。
 
+#### 引导与帮助场景组件
+
+| 组件 | Props 要点 | 说明 |
+| --- | --- | --- |
+| `GuideHost` | `guide`, `locale`, `scope`, `autoStart` | 首次邀请、操作导览和帮助弹窗 |
+| `HelpCenter` | `articles`, `tours`, `locale`, `selectedId`, `onstart` | 可独立使用的搜索帮助中心 |
+
+控制器与导航、偏好和业务 i18n 契约见 [guide.md](guide.md)。
+
 #### IAM 场景组件
 
 | 组件           | Props 要点                                      | 说明     |
@@ -628,6 +637,8 @@ AuthPanel 在 SSR 阶段禁用原生表单控件，客户端挂载并绑定事
 
 ## 导出路径
 
+新手引导与帮助中心使用公开 `@h-ai/ui/guide` 入口；`createGuide` 控制器、`GuideHost` 和独立 `HelpCenter` 的接入、首次偏好和导航契约见 [guide.md](guide.md)。
+
 | 路径                        | 用途                                   |
 | --------------------------- | -------------------------------------- |
 | `@h-ai/ui`                 | 主入口：所有组件、工具函数、类型       |

package/templates/skills/opencode.json

@@ -1,6 +1,6 @@
 {
   "$schema": "https://opencode.ai/config.json",
   "instructions": [
-    ".github/copilot-instructions.md"
+    "AGENTS.md"
   ]
 }

package/dist/chunk-WWG3U5ZD.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../messages/en-US.json","../messages/zh-CN.json","../src/cli-i18n.ts","../src/commands/cli-skill-templates.ts"],"names":[],"mappings":"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","file":"chunk-WWG3U5ZD.js","sourcesContent":["{\n  \"cli_createFailed\": \"Failed to create project:\",\n  \"cli_installFailed\": \"Dependency installation failed ({pm}).\",\n  \"cli_commandLabel\": \"Command: {command}\",\n  \"cli_exitCode\": \"Exit code: {code}\",\n  \"cli_signal\": \"Signal: {signal}\",\n  \"cli_selectHint\": \"- ↑/↓ select, Enter confirm\",\n  \"cli_multiselectHint\": \"- Space select, Enter confirm\",\n  \"cli_featuresPrompt\": \"Select features:\",\n  \"cli_frontendsPrompt\": \"Select frontend targets:\",\n  \"cli_invalidGenerateName\": \"Use a name starting with a letter, with only letters, digits, hyphens or underscores\",\n  \"cli_generateOutsideWorkspace\": \"Generated files must remain inside the workspace, including symbolic link targets\",\n  \"cli_generateExists\": \"File already exists: {path}. Use --force to overwrite it\",\n  \"cli_deploy_module_missing\": \"Deploy module not found. Install @h-ai/deploy first:\",\n  \"cli_deploy_load_credentials\": \"Loading credentials...\",\n  \"cli_deploy_credentials_failed\": \"Failed to load credentials: {message}\",\n  \"cli_deploy_credentials_loaded\": \"Loaded {count} credentials\",\n  \"cli_deploy_load_config\": \"Loading deploy config...\",\n  \"cli_deploy_config_missing\": \"Deploy config not found: {path}\",\n  \"cli_deploy_config_hint\": \"Run: hai add deploy to generate config template\",\n  \"cli_deploy_config_loaded\": \"Deploy config loaded\",\n  \"cli_deploy_scanning\": \"Scanning application...\",\n  \"cli_deploy_scan_failed\": \"Scan failed: {message}\",\n  \"cli_deploy_scanned\": \"Scanned: {name} (SvelteKit: {sveltekit}, Services: {services})\",\n  \"cli_deploy_none\": \"none\",\n  \"cli_deploy_initializing\": \"Initializing deploy module...\",\n  \"cli_deploy_init_failed\": \"Init failed: {message}\",\n  \"cli_deploy_initialized\": \"Deploy module initialized\",\n  \"cli_deploy_deploying\": \"Deploying application...\",\n  \"cli_deploy_failed\": \"Deploy failed: {message}\",\n  \"cli_deploy_success\": \"Deployment successful!\",\n  \"cli_deploy_url\": \"  URL: {url}\",\n  \"cli_deploy_id\": \"  ID: {id}\",\n  \"cli_deploy_env\": \"  Env: {names}\",\n  \"cli_deploy_command_failed\": \"Deploy command failed\",\n  \"cli_adminPasswordSaved\": \"  Administrator: admin; the random initial password is saved as HAI_ADMIN_DEFAULT_PASSWORD in .env\"\n}\n","{\n  \"cli_createFailed\": \"创建项目失败:\",\n  \"cli_installFailed\": \"安装依赖失败（{pm}）。\",\n  \"cli_commandLabel\": \"命令: {command}\",\n  \"cli_exitCode\": \"退出码: {code}\",\n  \"cli_signal\": \"信号: {signal}\",\n  \"cli_selectHint\": \"- ↑/↓ 选择，回车确认\",\n  \"cli_multiselectHint\": \"- 空格选择，回车确认\",\n  \"cli_featuresPrompt\": \"选择功能:\",\n  \"cli_frontendsPrompt\": \"选择前端目标:\",\n  \"cli_invalidGenerateName\": \"名称必须以字母开头，且仅包含字母、数字、短横线或下划线\",\n  \"cli_generateOutsideWorkspace\": \"生成文件必须位于工作目录内，符号链接目标也不得越界\",\n  \"cli_generateExists\": \"文件已存在：{path}。使用 --force 才可覆盖\",\n  \"cli_deploy_module_missing\": \"未找到部署模块，请先安装 @h-ai/deploy：\",\n  \"cli_deploy_load_credentials\": \"正在加载凭证…\",\n  \"cli_deploy_credentials_failed\": \"加载凭证失败：{message}\",\n  \"cli_deploy_credentials_loaded\": \"已加载 {count} 项凭证\",\n  \"cli_deploy_load_config\": \"正在加载部署配置…\",\n  \"cli_deploy_config_missing\": \"未找到部署配置：{path}\",\n  \"cli_deploy_config_hint\": \"运行 hai add deploy 生成部署配置模板\",\n  \"cli_deploy_config_loaded\": \"部署配置已加载\",\n  \"cli_deploy_scanning\": \"正在扫描应用…\",\n  \"cli_deploy_scan_failed\": \"扫描失败：{message}\",\n  \"cli_deploy_scanned\": \"已扫描：{name}（SvelteKit：{sveltekit}，服务：{services}）\",\n  \"cli_deploy_none\": \"无\",\n  \"cli_deploy_initializing\": \"正在初始化部署模块…\",\n  \"cli_deploy_init_failed\": \"初始化失败：{message}\",\n  \"cli_deploy_initialized\": \"部署模块已初始化\",\n  \"cli_deploy_deploying\": \"正在部署应用…\",\n  \"cli_deploy_failed\": \"部署失败：{message}\",\n  \"cli_deploy_success\": \"部署成功！\",\n  \"cli_deploy_url\": \"  地址：{url}\",\n  \"cli_deploy_id\": \"  标识：{id}\",\n  \"cli_deploy_env\": \"  环境变量：{names}\",\n  \"cli_deploy_command_failed\": \"部署命令失败\",\n  \"cli_adminPasswordSaved\": \"  管理员：admin；随机初始密码已保存到 .env 的 HAI_ADMIN_DEFAULT_PASSWORD\"\n}\n","/** CLI 用户可见消息；通过 core 的全局 locale 选择语言。 */\nimport { core } from '@h-ai/core'\nimport enUS from '../messages/en-US.json'\nimport zhCN from '../messages/zh-CN.json'\n\nexport const cliM = core.i18n.createMessageGetter<keyof typeof zhCN>({ 'en-US': enUS, 'zh-CN': zhCN })\n","/**\n * @h-ai/cli — Skill 模板生成\n *\n * 将 Skill 模板文件复制到用户项目中，供 AI 编程助手使用。\n * @module cli-skill-templates\n */\n\nimport type { AppType } from '../cli-types.js'\nimport path from 'node:path'\nimport { fileURLToPath } from 'node:url'\nimport fse from 'fs-extra'\nimport Handlebars from 'handlebars'\nimport { cliM } from '../cli-i18n.js'\n\n/**\n * 模块名到 Skill 目录名的映射\n */\nconst MODULE_SKILL_MAP: Record<string, string> = {\n  'db': 'hai-reldb',\n  'reldb': 'hai-reldb',\n  'cache': 'hai-cache',\n  'iam': 'hai-iam',\n  'storage': 'hai-storage',\n  'ai': 'hai-ai',\n  'crypto': 'hai-crypto',\n  'payment': 'hai-payment',\n  'vecdb': 'hai-vecdb',\n  'datapipe': 'hai-datapipe',\n  'reach': 'hai-reach',\n  'scheduler': 'hai-scheduler',\n  'audit': 'hai-audit',\n  'deploy': 'hai-deploy',\n  'kit': 'hai-kit',\n  'ui': 'hai-ui',\n  'api-client': 'hai-api-client',\n  'capacitor': 'hai-capacitor',\n}\n\n/**\n * 各 appType 互斥的 Skill。\n *\n * 生成样板工程时，默认复制 templates/skills 下所有 hai-* Skill，\n * 仅排除与当前样板技术栈明显冲突的少数 Skill。\n */\nconst SKILL_EXCLUSIONS_BY_APP_TYPE: Partial<Record<AppType, string[]>> = {\n  'admin': ['hai-serv', 'hai-api-contract', 'hai-api-client', 'hai-capacitor'],\n  'website': ['hai-serv', 'hai-api-contract', 'hai-api-client', 'hai-capacitor'],\n  'h5': ['hai-serv', 'hai-api-contract', 'hai-api-client', 'hai-capacitor'],\n  'api': ['hai-ui', 'hai-kit', 'hai-capacitor'],\n  'mobile-app': ['hai-core', 'hai-kit', 'hai-serv', 'hai-api-contract'],\n  'fullstack': ['hai-kit'],\n}\n\nconst WORKFLOW_SKILLS = [\n  'hai-build',\n  'hai-app-create',\n  'hai-app-review',\n  'hai-app-tests',\n]\n\nconst PACKAGE_SKILL_MAP: Record<string, string> = {\n  '@h-ai/api-contract': 'hai-api-contract',\n  '@h-ai/api-client': 'hai-api-client',\n  '@h-ai/core': 'hai-core',\n  '@h-ai/serv': 'hai-serv',\n  '@h-ai/kit': 'hai-kit',\n  '@h-ai/ui': 'hai-ui',\n  '@h-ai/reldb': 'hai-reldb',\n  '@h-ai/cache': 'hai-cache',\n  '@h-ai/iam': 'hai-iam',\n  '@h-ai/storage': 'hai-storage',\n  '@h-ai/ai': 'hai-ai',\n  '@h-ai/crypto': 'hai-crypto',\n  '@h-ai/payment': 'hai-payment',\n  '@h-ai/vecdb': 'hai-vecdb',\n  '@h-ai/datapipe': 'hai-datapipe',\n  '@h-ai/reach': 'hai-reach',\n  '@h-ai/scheduler': 'hai-scheduler',\n  '@h-ai/audit': 'hai-audit',\n  '@h-ai/deploy': 'hai-deploy',\n  '@h-ai/capacitor': 'hai-capacitor',\n}\n\nconst SKILL_TARGET_DIRS = ['.agents/skills'] as const\n\nconst BRIDGE_FILES = [\n  {\n    source: 'copilot-instructions.md',\n    destination: '.github/copilot-instructions.md',\n  },\n  {\n    source: 'CLAUDE.md',\n    destination: 'CLAUDE.md',\n  },\n  {\n    source: 'AGENTS.md',\n    destination: 'AGENTS.md',\n  },\n  {\n    source: 'opencode.json',\n    destination: 'opencode.json',\n  },\n] as const\n\nconst BRIDGE_PROFILE_REGEX = /^[a-z0-9-]+$/\n\n/** 从已有模板标识与实际包布局确认桥接类型，不按项目名称猜测技术栈。 */\nasync function detectBridgeContext(projectPath: string): Promise<{ appType?: AppType, projectName?: string }> {\n  const packagePath = path.join(projectPath, 'package.json')\n  if (!(await fse.pathExists(packagePath))) {\n    return {}\n  }\n\n  let metadata: unknown\n  try {\n    metadata = await fse.readJson(packagePath)\n  }\n  catch {\n    return {}\n  }\n  if (!metadata || typeof metadata !== 'object' || !('name' in metadata)\n    || typeof metadata.name !== 'string' || !BRIDGE_PROFILE_REGEX.test(metadata.name)) {\n    return {}\n  }\n\n  const projectName = metadata.name\n  for (const [appType, directory, suffixes] of [\n    ['fullstack', 'packages', ['contract', 'serv', 'shared']],\n    ['api', 'apps', ['contract', 'service']],\n  ] as const) {\n    const manifests = await Promise.all(suffixes.map(suffix => fse.pathExists(\n      path.join(projectPath, directory, `${projectName}-${suffix}`, 'package.json'),\n    )))\n    if (manifests.every(Boolean)) {\n      return { appType, projectName }\n    }\n  }\n\n  if ('keywords' in metadata && Array.isArray(metadata.keywords) && metadata.keywords.includes('hai')) {\n    for (const appType of ['admin', 'website', 'h5', 'mobile-app'] as const) {\n      if (metadata.keywords.includes(appType)) {\n        return { appType, projectName }\n      }\n    }\n  }\n  return { projectName }\n}\n\nasync function listTemplateSkillNames(templatesDir: string): Promise<string[]> {\n  const entries = await fse.readdir(templatesDir, { withFileTypes: true })\n  const skillNames: string[] = []\n\n  for (const entry of entries) {\n    if (!entry.isDirectory() || !entry.name.startsWith('hai-')) {\n      continue\n    }\n\n    const skillFilePath = path.join(templatesDir, entry.name, 'SKILL.md')\n    if (await fse.pathExists(skillFilePath)) {\n      skillNames.push(entry.name)\n    }\n  }\n\n  return skillNames.sort((a, b) => a.localeCompare(b))\n}\n\nexport function resolveCompatibleSkillNames(\n  skillNames: string[],\n  appType?: AppType,\n): string[] {\n  const excludedSkills = new Set(appType ? SKILL_EXCLUSIONS_BY_APP_TYPE[appType] ?? [] : [])\n  return skillNames.filter(skillName => !excludedSkills.has(skillName))\n}\n\n/**\n * 获取 templates/skills/ 目录的绝对路径\n *\n * 兼容两种运行环境：\n * - 构建后：dist/cli-skill-templates.js → ../templates/skills\n * - 测试时：src/commands/cli-skill-templates.ts → ../../templates/skills\n */\nfunction getSkillTemplatesDir(): string {\n  const currentDir = path.dirname(fileURLToPath(import.meta.url))\n  const distPath = path.resolve(currentDir, '..', 'templates', 'skills')\n  if (fse.pathExistsSync(distPath)) {\n    return distPath\n  }\n  return path.resolve(currentDir, '..', '..', 'templates', 'skills')\n}\n\n/**\n * 复制单个 Skill 目录到项目\n *\n * @param templatesDir - Skill 模板根目录\n * @param skillName - Skill 目录名（如 'hai-reldb'）\n * @param projectPath - 用户项目根目录\n */\nasync function copySkill(\n  templatesDir: string,\n  skillName: string,\n  projectPath: string,\n  targetDirs: readonly string[] = SKILL_TARGET_DIRS,\n  overwrite = true,\n): Promise<string[]> {\n  const src = path.join(templatesDir, skillName)\n\n  if (!(await fse.pathExists(src))) {\n    return []\n  }\n\n  const copiedFiles: string[] = []\n  const resources = await fse.readdir(src, { recursive: true, withFileTypes: true })\n  const relativeFiles = resources.filter(resource => resource.isFile())\n    .map(resource => path.relative(src, path.join(resource.parentPath, resource.name)))\n\n  for (const targetDir of targetDirs) {\n    const dest = path.join(projectPath, targetDir, skillName)\n    await assertProjectOutputPath(projectPath, dest)\n    if (!overwrite) {\n      // 已有入口不能使新参考资源被跳过；逐文件补缺，同时保留用户修改。\n      const missingFiles: string[] = []\n      for (const relativeFile of relativeFiles) {\n        if (!(await fse.pathExists(path.join(dest, relativeFile)))) {\n          missingFiles.push(relativeFile)\n        }\n      }\n      if (missingFiles.length === 0) {\n        continue\n      }\n      for (const relativeFile of missingFiles)\n        await assertProjectOutputPath(projectPath, path.join(dest, relativeFile))\n      await fse.copy(src, dest, { overwrite: false })\n      copiedFiles.push(...missingFiles.map(relativeFile => `${targetDir}/${skillName}/${relativeFile.replaceAll(path.sep, '/')}`))\n    }\n    else {\n      for (const relativeFile of relativeFiles)\n        await assertProjectOutputPath(projectPath, path.join(dest, relativeFile))\n      await fse.copy(src, dest, { overwrite: true })\n      copiedFiles.push(`${targetDir}/${skillName}/SKILL.md`)\n    }\n  }\n\n  return copiedFiles\n}\n\n/** 写入前解析已有目录/文件链接，所有 AI 输出均限制在当前项目内。 */\nasync function assertProjectOutputPath(projectPath: string, destination: string): Promise<void> {\n  let ancestor = destination\n  while (!(await fse.pathExists(ancestor))) {\n    const parent = path.dirname(ancestor)\n    if (parent === ancestor)\n      throw new Error(cliM('cli_generateOutsideWorkspace'))\n    ancestor = parent\n  }\n  const relativeAncestor = path.relative(await fse.realpath(projectPath), await fse.realpath(ancestor))\n  if (relativeAncestor === '..' || relativeAncestor.startsWith(`..${path.sep}`) || path.isAbsolute(relativeAncestor))\n    throw new Error(cliM('cli_generateOutsideWorkspace'))\n}\n\nasync function copySkills(\n  templatesDir: string,\n  skillNames: string[],\n  projectPath: string,\n  targetDirs: readonly string[] = SKILL_TARGET_DIRS,\n  overwrite = true,\n): Promise<string[]> {\n  const copiedFiles: string[] = []\n\n  for (const skillName of new Set(skillNames)) {\n    copiedFiles.push(...await copySkill(templatesDir, skillName, projectPath, targetDirs, overwrite))\n  }\n\n  return copiedFiles\n}\n\n/**\n * 复制桥接文件到项目\n *\n * @param templatesDir - Skill 模板根目录\n * @param projectPath - 用户项目根目录\n */\nasync function copyBridgeFiles(\n  templatesDir: string,\n  projectPath: string,\n  overwrite = true,\n  appType?: string,\n  projectName?: string,\n): Promise<string[]> {\n  const copiedFiles: string[] = []\n\n  for (const file of BRIDGE_FILES) {\n    const src = await resolveBridgeSource(templatesDir, file.source, appType, projectName !== undefined)\n    const dest = path.join(projectPath, file.destination)\n\n    if (!src) {\n      continue\n    }\n\n    if (!overwrite && await fse.pathExists(dest)) {\n      continue\n    }\n\n    await assertProjectOutputPath(projectPath, dest)\n    await fse.ensureDir(path.dirname(dest))\n    if (src.endsWith('.hbs')) {\n      const template = await fse.readFile(src, 'utf8')\n      const rendered = Handlebars.compile(template, { noEscape: true })({ projectName })\n      await fse.writeFile(dest, rendered, 'utf8')\n    }\n    else {\n      await fse.copy(src, dest, { overwrite })\n    }\n    copiedFiles.push(file.destination)\n  }\n\n  return copiedFiles\n}\n\nasync function resolveBridgeSource(\n  templatesDir: string,\n  source: string,\n  appType?: string,\n  allowTemplate = false,\n): Promise<string | null> {\n  const profile = appType && BRIDGE_PROFILE_REGEX.test(appType) ? appType : 'generic'\n  const candidates = [\n    ...(allowTemplate ? [path.join(templatesDir, 'bridges', profile, `${source}.hbs`)] : []),\n    path.join(templatesDir, 'bridges', profile, source),\n    path.join(templatesDir, 'bridges', 'generic', source),\n    path.join(templatesDir, source),\n  ]\n\n  for (const candidate of candidates) {\n    if (await fse.pathExists(candidate)) {\n      return candidate\n    }\n  }\n\n  return null\n}\n\n/**\n * 为新项目生成完整的 Skill 文件。\n *\n * 默认复制 templates/skills 下所有 hai-* Skill，再按 appType 排除互斥项。\n *\n * @param projectPath - 用户项目根目录\n * @param _features - 预留参数；保留签名兼容 createProject 调用方\n * @param appType - 应用类型（api 类型不复制 UI Skill）\n */\nexport async function generateSkillFiles(\n  projectPath: string,\n  _features: string[],\n  appType?: string,\n  projectName?: string,\n): Promise<string[]> {\n  const templatesDir = getSkillTemplatesDir()\n\n  if (!(await fse.pathExists(templatesDir))) {\n    return []\n  }\n\n  const copiedFiles: string[] = []\n\n  const templateSkillNames = await listTemplateSkillNames(templatesDir)\n  const compatibleSkillNames = resolveCompatibleSkillNames(templateSkillNames, appType as AppType | undefined)\n\n  copiedFiles.push(...await copySkills(templatesDir, compatibleSkillNames, projectPath))\n\n  // 复制桥接文件\n  copiedFiles.push(...await copyBridgeFiles(templatesDir, projectPath, true, appType, projectName))\n\n  return copiedFiles\n}\n\n/**\n * 为已有项目添加单个模块的 Skill 文件\n *\n * 同时补全普通开发所需工作流及缺失参考资源，保留已有文件。\n *\n * @param projectPath - 用户项目根目录\n * @param moduleId - 模块标识（如 'db'、'iam'）\n * @returns 复制的文件路径，若模块无对应 Skill 则返回 null\n */\nexport async function generateModuleSkillFile(\n  projectPath: string,\n  moduleId: string,\n): Promise<string[] | null> {\n  const skillName = MODULE_SKILL_MAP[moduleId]\n  if (!skillName) {\n    return null\n  }\n\n  const copiedFiles = await generateProjectAiSupport(projectPath, [skillName], {\n    overwriteSkills: false,\n    overwriteBridgeFiles: false,\n  })\n  return copiedFiles.length > 0 ? copiedFiles : null\n}\n\nexport function resolveSkillNamesForPackages(packageNames: string[]): string[] {\n  const skillNames = [...WORKFLOW_SKILLS]\n\n  for (const packageName of packageNames) {\n    const skillName = PACKAGE_SKILL_MAP[packageName]\n    if (skillName) {\n      skillNames.push(skillName)\n    }\n  }\n\n  return [...new Set(skillNames)]\n}\n\nexport async function generateProjectAiSupport(\n  projectPath: string,\n  skillNames: string[],\n  options: {\n    overwriteSkills?: boolean\n    overwriteBridgeFiles?: boolean\n    appType?: string\n    projectName?: string\n  } = {},\n): Promise<string[]> {\n  const templatesDir = getSkillTemplatesDir()\n\n  if (!(await fse.pathExists(templatesDir))) {\n    return []\n  }\n\n  const {\n    overwriteSkills = true,\n    overwriteBridgeFiles = true,\n  } = options\n\n  const detected = await detectBridgeContext(projectPath)\n  const appType = options.appType ?? detected.appType\n  const projectName = options.projectName ?? detected.projectName\n  // 已确认的样板补全整个兼容目录；其它项目只补工作流与明确请求的模块。\n  const selectedSkillNames = appType\n    ? [...resolveCompatibleSkillNames(await listTemplateSkillNames(templatesDir), appType as AppType), ...WORKFLOW_SKILLS, ...skillNames]\n    : [...WORKFLOW_SKILLS, ...skillNames]\n  const copiedFiles: string[] = []\n  copiedFiles.push(...await copySkills(templatesDir, selectedSkillNames, projectPath, SKILL_TARGET_DIRS, overwriteSkills))\n  copiedFiles.push(...await copyBridgeFiles(templatesDir, projectPath, overwriteBridgeFiles, appType, projectName))\n\n  return copiedFiles\n}\n"]}

package/templates/skills/bridges/admin/copilot-instructions.md

@@ -1,11 +0,0 @@
-# GitHub Copilot 项目指令
-
-> 管理后台工程指引。详细模块用法按需读取 `.agents/skills/`。
-
-共享规则见项目根 [AGENTS.md](../AGENTS.md)；若未自动加载，先读取该文件。模块/流程按需读取项目根 .agents/skills/<name>/SKILL.md 及其相邻参考文件。
-
-## 质量门禁
-
-按 AGENTS.md 和实际 package.json 选择 typecheck、lint、build、test、test:e2e；最终说明已执行结果、未运行原因及同步文档/依赖方。
-
-普通新增、修改、修复任务先读 [应用开发 Skill](../.agents/skills/hai-app-create/SKILL.md) 和 [开发规范与框架能力路由](../.agents/skills/hai-app-create/development.md)，依照 AGENTS.md 的默认规则复用框架并完成安全与质量验证。

package/templates/skills/bridges/api/copilot-instructions.md

@@ -1,13 +0,0 @@
-# GitHub Copilot 项目指令
-
-> API 服务工程指引。详细模块用法按需读取 `.agents/skills/`。
-
-使用 `@h-ai/serv` + 共享 contract 装配服务；不要退回到 SvelteKit API routes。
-
-共享规则见项目根 [AGENTS.md](../AGENTS.md)；若未自动加载，先读取该文件。模块/流程按需读取项目根 .agents/skills/<name>/SKILL.md 及其相邻参考文件。
-
-## 质量门禁
-
-按 AGENTS.md 和实际 package.json 选择 typecheck、lint、build、test、test:e2e；最终说明已执行结果、未运行原因及同步文档/依赖方。
-
-普通新增、修改、修复任务先读 [应用开发 Skill](../.agents/skills/hai-app-create/SKILL.md) 和 [开发规范与框架能力路由](../.agents/skills/hai-app-create/development.md)，依照 AGENTS.md 的默认规则复用框架并完成安全与质量验证。

package/templates/skills/bridges/fullstack/copilot-instructions.md.hbs

@@ -1,19 +0,0 @@
-# GitHub Copilot 项目指令
-
-共享工作规范见 [AGENTS.md](../AGENTS.md)，模块用法按需读取 `.agents/skills/`。
-
-- `packages/{{projectName}}-contract` 定义 API；Fullstack 服务端 `packages/{{projectName}}-serv` 实现业务；`packages/{{projectName}}-shared` 共享 UI、i18n 和 typed client。
-- 前端按选择生成；App 使用 Capacitor，Desktop 使用 Tauri v2。miniapp 当前仅预留说明，不是可运行应用。
-- 默认 mini 管理后台复用 IAM/reldb/cache/audit/storage/crypto。管理员管理用户、固定 admin/user 角色及审计；普通用户仅操作个人设置，服务端按角色和当前会话验证权限。
-- typed api-client 与 serv 的 crypto transport 统一加解密 JSON 请求与响应，包含认证与刷新。Web 使用内存 access token + HttpOnly refresh Cookie，App 原生端使用 Capacitor 安全 TokenStorage，Desktop 使用内存 TokenStorage；具体边界与例外见根 AGENTS。
-- 应用名称、版本、环境、日志与 locale 配置通过 core 获取；前端消费 `app.info`。头像、分页、偏好与管理员保护以 contract、服务端实现和根 AGENTS 为准，改动时同步各端。
-
-## 质量门禁
-
-按根 AGENTS 执行 typecheck、lint、build、test 和 test:e2e；原生或发布变更另执行对应 compile/package。
-
-## 完成条件
-
-同步受影响的 contract、serv、shared、各端调用方及文档与测试，报告门禁结果和未执行原因。
-
-普通新增、修改、修复任务先读 [应用开发 Skill](../.agents/skills/hai-app-create/SKILL.md) 和 [开发规范与框架能力路由](../.agents/skills/hai-app-create/development.md)，依照 AGENTS.md 的默认规则复用框架并完成安全与质量验证。

package/templates/skills/bridges/h5/copilot-instructions.md

@@ -1,11 +0,0 @@
-# GitHub Copilot 项目指令
-
-> H5 移动端工程指引。详细模块用法按需读取 `.agents/skills/`。
-
-共享规则见项目根 [AGENTS.md](../AGENTS.md)；若未自动加载，先读取该文件。模块/流程按需读取项目根 .agents/skills/<name>/SKILL.md 及其相邻参考文件。
-
-## 质量门禁
-
-按 AGENTS.md 和实际 package.json 选择 typecheck、lint、build、test、test:e2e；最终说明已执行结果、未运行原因及同步文档/依赖方。
-
-普通新增、修改、修复任务先读 [应用开发 Skill](../.agents/skills/hai-app-create/SKILL.md) 和 [开发规范与框架能力路由](../.agents/skills/hai-app-create/development.md)，依照 AGENTS.md 的默认规则复用框架并完成安全与质量验证。

package/templates/skills/bridges/mobile-app/copilot-instructions.md

@@ -1,11 +0,0 @@
-# GitHub Copilot 项目指令
-
-> Capacitor Mobile App 工程指引。详细模块用法按需读取 `.agents/skills/`。
-
-共享规则见项目根 [AGENTS.md](../AGENTS.md)；若未自动加载，先读取该文件。模块/流程按需读取项目根 .agents/skills/<name>/SKILL.md 及其相邻参考文件。
-
-## 质量门禁
-
-按 AGENTS.md 和实际 package.json 选择 typecheck、lint、build、test、test:e2e；最终说明已执行结果、未运行原因及同步文档/依赖方。
-
-普通新增、修改、修复任务先读 [应用开发 Skill](../.agents/skills/hai-app-create/SKILL.md) 和 [开发规范与框架能力路由](../.agents/skills/hai-app-create/development.md)，依照 AGENTS.md 的默认规则复用框架并完成安全与质量验证。

package/templates/skills/bridges/website/copilot-instructions.md

@@ -1,11 +0,0 @@
-# GitHub Copilot 项目指令
-
-> 企业官网工程指引。详细模块用法按需读取 `.agents/skills/`。
-
-共享规则见项目根 [AGENTS.md](../AGENTS.md)；若未自动加载，先读取该文件。模块/流程按需读取项目根 .agents/skills/<name>/SKILL.md 及其相邻参考文件。
-
-## 质量门禁
-
-按 AGENTS.md 和实际 package.json 选择 typecheck、lint、build、test、test:e2e；最终说明已执行结果、未运行原因及同步文档/依赖方。
-
-普通新增、修改、修复任务先读 [应用开发 Skill](../.agents/skills/hai-app-create/SKILL.md) 和 [开发规范与框架能力路由](../.agents/skills/hai-app-create/development.md)，依照 AGENTS.md 的默认规则复用框架并完成安全与质量验证。