@h-ai/cli 0.1.0-alpha.12 → 0.1.0-alpha.15

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@h-ai/cli",
   "type": "module",
-  "version": "0.1.0-alpha.12",
+  "version": "0.1.0-alpha.15",
   "description": "Hai Framework CLI for project scaffolding and code generation.",
   "license": "Apache-2.0",
   "keywords": [
@@ -34,7 +34,7 @@
     "ora": "^9.1.0",
     "prompts": "^2.4.2",
     "yaml": "^2.7.0",
-    "@h-ai/core": "0.1.0-alpha.12"
+    "@h-ai/core": "0.1.0-alpha.15"
   },
   "devDependencies": {
     "@types/fs-extra": "^11.0.4",

package/templates/apps/android-app/src/lib/api.ts.hbs

@@ -7,8 +7,9 @@
 import { api } from '@h-ai/api-client'
 import { createCapacitorTokenStorage } from '@h-ai/capacitor'
 
-/** API 基础地址（开发时指向本地后端） */
-const API_BASE = import.meta.env.PUBLIC_API_BASE ?? 'http://localhost:3000'
+// Capacitor 静态构建后通过 Vite 的 import.meta.env 注入 PUBLIC_* 变量
+// 此处不使用 SvelteKit 的 $env/static/public，避免脱离 SvelteKit SSR 上下文时的类型/运行时缺失
+const API_BASE = (import.meta.env.PUBLIC_API_BASE as string | undefined) ?? 'http://localhost:3000'
 
 /**
  * 初始化 API 客户端
@@ -19,10 +20,10 @@ const API_BASE = import.meta.env.PUBLIC_API_BASE ?? 'http://localhost:3000'
  */
 export async function initApi() {
   return api.init({
-    baseUrl: API_BASE,
+    baseUrl: `${API_BASE}/api/v1`,
     auth: {
       storage: createCapacitorTokenStorage(),
-      refreshUrl: '/api/v1/auth/refresh',
+      refreshPath: '/auth/refresh',
     },
   })
 }

package/templates/base/package.json.hbs

@@ -1,6 +1,6 @@
 {
   "name": "{{projectName}}",
-  "version": "0.1.0-alpha.12",
+  "version": "0.1.0-alpha.15",
   "private": true,
   "description": "{{#if_eq appType 'admin'}}Enterprise management system built with hai Agent Framework{{/if_eq}}{{#if_eq appType 'website'}}Enterprise website built with hai Agent Framework{{/if_eq}}{{#if_eq appType 'h5'}}Mobile H5 app built with hai Agent Framework{{/if_eq}}{{#if_eq appType 'api'}}REST API service built with hai Agent Framework{{/if_eq}}{{#if_eq appType 'android-app'}}Android app built with hai Agent Framework{{/if_eq}}",
   "keywords": ["hai", "sveltekit", "svelte5", "{{appType}}"],
@@ -21,26 +21,26 @@
     "clean": "rimraf .svelte-kit build .turbo"
   },
   "dependencies": {
-    "@h-ai/core": "^0.1.0-alpha.12",
-    "@h-ai/kit": "^0.1.0-alpha.12"{{#if hasUi}},
-    "@h-ai/ui": "^0.1.0-alpha.12"{{/if}}{{#if features.db}},
-    "@h-ai/reldb": "^0.1.0-alpha.12"{{/if}}{{#if features.cache}},
-    "@h-ai/cache": "^0.1.0-alpha.12"{{/if}}{{#if features.iam}},
-    "@h-ai/iam": "^0.1.0-alpha.12"{{/if}}{{#if features.crypto}},
-    "@h-ai/crypto": "^0.1.0-alpha.12"{{/if}}{{#if features.storage}},
-    "@h-ai/storage": "^0.1.0-alpha.12"{{/if}}{{#if features.ai}},
-    "@h-ai/ai": "^0.1.0-alpha.12"{{/if}}{{#if features.audit}},
-    "@h-ai/audit": "^0.1.0-alpha.12"{{/if}}{{#if features.reach}},
-    "@h-ai/reach": "^0.1.0-alpha.12"{{/if}}{{#if features.payment}},
-    "@h-ai/payment": "^0.1.0-alpha.12"{{/if}}{{#if features.vecdb}},
-    "@h-ai/vecdb": "^0.1.0-alpha.12"{{/if}}{{#if features.datapipe}},
-    "@h-ai/datapipe": "^0.1.0-alpha.12"{{/if}}{{#if features.scheduler}},
-    "@h-ai/scheduler": "^0.1.0-alpha.12"{{/if}}{{#if features.deploy}},
-    "@h-ai/deploy": "^0.1.0-alpha.12"{{/if}}{{#if features.api-client}},
-    "@h-ai/api-client": "^0.1.0-alpha.12"{{/if}}{{#if features.capacitor}},
-    "@h-ai/capacitor": "^0.1.0-alpha.12"{{/if}}{{#if isCapacitorApp}}{{#unless features.api-client}},
-    "@h-ai/api-client": "^0.1.0-alpha.12"{{/unless}}{{#unless features.capacitor}},
-    "@h-ai/capacitor": "^0.1.0-alpha.12"{{/unless}}{{/if}},
+    "@h-ai/core": "^0.1.0-alpha.15",
+    "@h-ai/kit": "^0.1.0-alpha.15"{{#if hasUi}},
+    "@h-ai/ui": "^0.1.0-alpha.15"{{/if}}{{#if features.db}},
+    "@h-ai/reldb": "^0.1.0-alpha.15"{{/if}}{{#if features.cache}},
+    "@h-ai/cache": "^0.1.0-alpha.15"{{/if}}{{#if features.iam}},
+    "@h-ai/iam": "^0.1.0-alpha.15"{{/if}}{{#if features.crypto}},
+    "@h-ai/crypto": "^0.1.0-alpha.15"{{/if}}{{#if features.storage}},
+    "@h-ai/storage": "^0.1.0-alpha.15"{{/if}}{{#if features.ai}},
+    "@h-ai/ai": "^0.1.0-alpha.15"{{/if}}{{#if features.audit}},
+    "@h-ai/audit": "^0.1.0-alpha.15"{{/if}}{{#if features.reach}},
+    "@h-ai/reach": "^0.1.0-alpha.15"{{/if}}{{#if features.payment}},
+    "@h-ai/payment": "^0.1.0-alpha.15"{{/if}}{{#if features.vecdb}},
+    "@h-ai/vecdb": "^0.1.0-alpha.15"{{/if}}{{#if features.datapipe}},
+    "@h-ai/datapipe": "^0.1.0-alpha.15"{{/if}}{{#if features.scheduler}},
+    "@h-ai/scheduler": "^0.1.0-alpha.15"{{/if}}{{#if features.deploy}},
+    "@h-ai/deploy": "^0.1.0-alpha.15"{{/if}}{{#if features.api-client}},
+    "@h-ai/api-client": "^0.1.0-alpha.15"{{/if}}{{#if features.capacitor}},
+    "@h-ai/capacitor": "^0.1.0-alpha.15"{{/if}}{{#if isCapacitorApp}}{{#unless features.api-client}},
+    "@h-ai/api-client": "^0.1.0-alpha.15"{{/unless}}{{#unless features.capacitor}},
+    "@h-ai/capacitor": "^0.1.0-alpha.15"{{/unless}}{{/if}},
     "zod": "^4.3.6"
   },
   "devDependencies": {

package/templates/base/src/app.css.hbs

@@ -9,7 +9,8 @@
 @import '@h-ai/ui/styles/mobile.css';
 
 /* ─── 扫描 @h-ai/ui 组件中使用的 Tailwind 类名 ─── */
-@source "../node_modules/@h-ai/ui/dist/**/*.{svelte,ts}";
+@source "../node_modules/@h-ai/ui/dist/**/*.{svelte,js,ts}";
+@source "../../../node_modules/@h-ai/ui/dist/**/*.{svelte,js,ts}";
 
 /* ─── DaisyUI 主题 ─── */
 @plugin "daisyui" {

package/templates/skills/AGENTS.md

@@ -24,3 +24,4 @@
 - **框架模块**：`hai-core/`、`hai-kit/`、`hai-reldb/`、`hai-iam/`、`hai-crypto/`、`hai-cache/`、`hai-storage/`、`hai-ai/`
 - **UI 组件**：`hai-ui/SKILL.md`
 - **TDD 开发流程**：`hai-app-tests/`（TDD 测试先行）、`hai-app-create/`（TDD 实现）、`hai-app-review/`（TDD 重构审查）
+- **仓库工程流程**：`hai-ci/`（CI/CD 与质量门禁）、`hai-pr-review/`（PR / Issue 交付审查与 AI Review）、`hai-framework-sync/`（两仓同步）

package/templates/skills/copilot-instructions.md

@@ -48,6 +48,9 @@
 | `hai-app-create` | TDD 驱动的功能创建（先测试后实现）                    |
 | `hai-app-review` | 应用代码审查（含 TDD 合规检查）                       |
 | `hai-app-tests`  | TDD 测试规范（Vitest 单元测试 + Playwright E2E）      |
+| `hai-ci`         | CI/CD、GitHub Actions、质量门禁与 workflow 安全       |
+| `hai-pr-review`  | PR / Issue 交付审查、AI Review 策略、CODEOWNERS 与合并门禁 |
+| `hai-framework-sync` | hai-framework 模板源头与应用仓库同步            |
 
 ## 开发流程
 

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

@@ -20,7 +20,7 @@ description: 使用 @h-ai/ai 进行 LLM 调用（OpenAI 兼容）、MCP 服务
 | `ai.memory` / `ai.conversation` | ✅ | ❌（通过 API 查询） |
 | `ai.knowledge` 知识库 | ✅ | ❌（通过 API 查询） |
 
-浏览器端消费 AI 能力的标准模式：通过 `api.stream()` 或 `apiFetch` 调用服务端 API 端点。
+浏览器端消费 AI 能力的标准模式：通过 `@h-ai/api-client` 的 typed contract 调用 `apiClient.ai.chats.*`；如需 SSE 流式输出，由应用显式暴露自定义流式 endpoint，再用 `fetch` / `apiFetch` 消费。
 
 ---
 
@@ -266,27 +266,20 @@ await mcp.connect(transport)
 ### 前端客户端
 
 ```typescript
-import { api } from '@h-ai/api-client'
-import { createAIClient } from '@h-ai/ai/client'
+import { apiClient } from '@h-ai/api-client'
 
-await api.init({ baseUrl: '/api', auth: { ... } })
-const client = createAIClient({ api })
+await apiClient.init({ baseUrl: '/api/v1', auth: {} })
 
 // 非流式
-const response = await client.chat({ messages })
-
-// 流式
-for await (const chunk of client.chatStream({ messages }, {
-  onProgress: (p) => { /* 处理进度 */ },
-})) { /* ... */ }
+const response = await apiClient.ai.chats.createCompletion({ messages })
 
 // 便捷方法
-const reply = await client.sendMessage('你好', '系统提示')
+const reply = await apiClient.ai.chats.sendMessage({ message: '你好', systemPrompt: '系统提示' })
 
 // 记忆与会话查询
-const memories = await client.recallMemories('用户偏好', { topK: 5, objectId: 'user-001' })
-const page = await client.listMemories({ objectId: 'user-001', offset: 0, limit: 20 })
-const sessions = await client.listSessions('user-001')
+const memories = await apiClient.ai.memories.recall({ query: '用户偏好', topK: 5, objectId: 'user-001' })
+const page = await apiClient.ai.memories.list({ objectId: 'user-001', limit: 20 })
+const sessions = await apiClient.ai.sessions.list({ objectId: 'user-001' })
 ```
 
 ### 记忆管理 — `ai.memory`
@@ -656,36 +649,57 @@ async function manualChat(userInput: string) {
 
 ## 浏览器端使用
 
-### 流式对话（SSE）
+### typed 对话调用
 
-浏览器通过 `api.stream()` 消费服务端流式 API：
+浏览器 / App 通过 `@h-ai/api-client` 调用由 `@h-ai/api-contract` 定义、`@h-ai/serv` 挂载的 AI contract：
 
 ```typescript
-import { api } from '@h-ai/api-client'
+import { apiClient } from '@h-ai/api-client'
 
-const controller = new AbortController()
+const result = await apiClient.ai.chats.createCompletion({
+  messages: [{ role: 'user', content: '你好' }],
+})
 
-for await (const chunk of api.stream('/api/v1/ai/chat', {
-  conversationId: 'conv-1',
-  content: '你好',
-}, { signal: controller.signal })) {
-  // 每个 chunk 是 SSE data: 行的文本内容
-  appendToUI(chunk)
+if (result.success) {
+  appendToUI(result.data.choices[0]?.message?.content ?? '')
 }
-
-// 主动停止
-controller.abort()
 ```
 
-或使用 `apiFetch`（SSR SvelteKit 同源场景）：
+### 流式对话（SSE，自定义 endpoint）
+
+标准 `api-client` 不再提供旧的通用流式方法。若产品需要 SSE 流式输出，请在应用服务端显式定义流式 endpoint（例如 SvelteKit `+server.ts` 或 `@h-ai/serv` 自定义 route），浏览器端再用 `fetch` / `apiFetch` 消费。
 
 ```typescript
 import { apiFetch } from '$lib/utils/api'
 
-const res = await apiFetch('/api/v1/ai/chat', {
+const controller = new AbortController()
+
+const res = await apiFetch('/api/ai/chat-stream', {
+  method: 'POST',
+  headers: { 'Content-Type': 'application/json' },
+  body: JSON.stringify({ conversationId: 'conv-1', content: '你好' }),
+  signal: controller.signal,
+})
+
+const reader = res.body!.getReader()
+const decoder = new TextDecoder()
+while (true) {
+  const { done, value } = await reader.read()
+  if (done)
+    break
+
+  appendToUI(decoder.decode(value))
+}
+```
+
+或直接使用原生 `fetch`（跨域公共 API 场景）：
+
+```typescript
+const res = await fetch(`${apiBase}/ai/chat-stream`, {
   method: 'POST',
   headers: { 'Content-Type': 'application/json' },
   body: JSON.stringify({ conversationId, content: userInput }),
+  signal: controller.signal,
 })
 
 // 手动消费 SSE 流