@h-ai/cli 0.1.0-alpha.47 → 0.1.0-alpha.48

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@h-ai/cli",
   "type": "module",
-  "version": "0.1.0-alpha.47",
+  "version": "0.1.0-alpha.48",
   "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.47"
+    "@h-ai/core": "0.1.0-alpha.48"
   },
   "devDependencies": {
     "@types/fs-extra": "^11.0.4",

package/templates/apps/api/apps/{{projectName}}-service/config/_serv.yml.hbs

@@ -2,6 +2,10 @@
 # {{projectName}} API Service - Serv / HTTP 入口配置
 # =============================================================================
 
+server:
+  host: 127.0.0.1
+  port: 3000
+
 http:
   apiPrefix: /api/v1
   openapi:

package/templates/apps/api/apps/{{projectName}}-service/src/index.ts.hbs

@@ -1,3 +1,4 @@
+import type { ServConfig } from '@h-ai/serv'
 import process from 'node:process'
 import { core } from '@h-ai/core'
 import { serv } from '@h-ai/serv'
@@ -9,7 +10,11 @@ const logger = core.logger.child({ app: '{{api.servicePackageName}}', scope: 'en
 async function main(): Promise<void> {
   await initApp()
 
+  // host/port 来自 config/_serv.yml 的 server（HOST/PORT 环境变量高于配置文件）。
+  const { server } = core.config.getOrThrow<ServConfig>('serv')
   serv.listen({{api.serviceAppFactoryName}}(), {
+    host: server.host,
+    port: server.port,
     onListening: info => logger.info('API service listening', { address: info.address, port: info.port }),
     onClose: closeApp,
   })

package/templates/apps/fullstack/packages/{{projectName}}-serv/config/_serv.yml.hbs

@@ -5,6 +5,10 @@
 # 业务接口路径直接写在对应 *-contract.ts；公共 HTTP 传输配置以本文件为准。
 # =============================================================================
 
+server:
+  host: 127.0.0.1
+  port: 3000
+
 http:
   apiPrefix: /api/v1
   openapi:

package/templates/apps/fullstack/packages/{{projectName}}-serv/src/index.ts.hbs

@@ -1,18 +1,18 @@
-import process from 'node:process'
+import type { ServConfigInput } from '@h-ai/serv'
 import { core } from '@h-ai/core'
-import { serv } from '@h-ai/serv'
+import { serv, ServConfigSchema } from '@h-ai/serv'
 import { createServerApp } from './app-server.js'
 
 // 加载 config/ 下的 _core.yml / _serv.yml 等配置文件（约定优于配置）
 core.init({ configDir: './config', logging: { level: 'info' } })
 
+// host/port 来自 config/_serv.yml 的 server（HOST/PORT 环境变量高于配置文件）。
+const { server } = ServConfigSchema.parse(core.config.get<ServConfigInput>('serv') ?? {})
 const app = createServerApp()
-const port = process.env.PORT ? Number(process.env.PORT) : 3000
-const host = process.env.HOST ?? '127.0.0.1'
 const listenApp = app as Parameters<typeof serv.listen>[0]
 
 serv.listen(listenApp, {
-  port,
-  host,
-  onListening: info => core.logger.info('{{fullstack.servPackageName}} listening', { host, port: info.port }),
+  host: server.host,
+  port: server.port,
+  onListening: info => core.logger.info('{{fullstack.servPackageName}} listening', { host: server.host, port: info.port }),
 })

package/templates/base/package.json.hbs

@@ -1,6 +1,6 @@
 {
   "name": "{{projectName}}",
-  "version": "0.1.0-alpha.47",
+  "version": "0.1.0-alpha.48",
   "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 'mobile-app'}}Mobile app built with hai Agent Framework{{/if_eq}}",
   "keywords": ["hai", {{#unless isSvelteOnlyApp}}"sveltekit", {{/unless}}"svelte5", "{{appType}}"],

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

@@ -131,6 +131,10 @@ transport 默认保护同源 `/api/*` endpoint 与 SvelteKit `__data.json` 页
 同时驱动 `hooks.server.ts` 与浏览器端 `kit.client.installBrowserTransport()`：
 
 ```yml
+server:
+  host: 127.0.0.1
+  port: 3000
+
 transport:
   keyExchangePath: /api/_hai/key-exchange
   requireEncryption: true
@@ -150,7 +154,8 @@ import rawKitConfig from '../config/_kit.yml?raw'
 export const appKitConfig = resolveKitConfig(parse(rawKitConfig) ?? {})
 ```
 
-`_kit.yml` 只放公开的 transport 路径/开关，不放密钥；如自定义 `keyExchangePath`，浏览器端必须同步映射为 `keyExchangeUrl`。
+`resolveKitConfig()` 同时解析 `server`（host/port）与 `transport`；host/port 优先级为 `HOST` / `PORT` 环境变量 > `_kit.yml` 的 `server` > 默认 `127.0.0.1:3000`（与 `@h-ai/serv` 同构）。
+`_kit.yml` 只放公开的 server/transport 路径/开关，不放密钥；如自定义 `keyExchangePath`，浏览器端必须同步映射为 `keyExchangeUrl`。
 
 ## 核心 API
 

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

@@ -86,8 +86,11 @@ const app = serv.createApp({
   },
 })
 
-// Node.js 启动（自动读取 PORT / HOST 环境变量；onClose 自动监听 SIGINT/SIGTERM）
+// Node.js 启动（host/port 来自 _serv.yml 的 server；HOST/PORT 环境变量高于配置文件；onClose 自动监听 SIGINT/SIGTERM）
+const { server } = core.config.getOrThrow<ServConfig>('serv')
 serv.listen(app, {
+  host: server.host,
+  port: server.port,
   onListening: info => logger.info('API service listening', { port: info.port }),
   onClose: closeApp, // 业务模块关闭函数（ai/storage/iam/reldb 等反向释放）
 })
@@ -265,6 +268,10 @@ const app = serv.createApp({
 
 ```yaml
 # config/_serv.yml
+server:
+  host: 127.0.0.1
+  port: 3000
+
 http:
   apiPrefix: /api/v1
   openapi: