@liujitcn/kratos-taro-app-system 0.0.1

package/README.md

@@ -0,0 +1,29 @@
+# @liujitcn/kratos-taro-app-system
+
+`@liujitcn/kratos-taro-app-system` 是默认应用业务模块，提供个人中心、设置、个人资料和 AI 助手页面。模块只依赖 core 与 UI 的公开入口，不持有宿主配置。
+
+## 页面与视图键
+
+| 页面 | 视图键 | 用途 |
+| --- | --- | --- |
+| `pages/my/my` | `PROFILE_HOME` | 我的 tab 与登录概览。 |
+| `pagesMember/profile/profile` | `PROFILE` | 头像、昵称、性别和地区资料。 |
+| `pagesMember/settings/settings` | `SETTINGS` | 设置与退出登录。 |
+| `pagesMember/ai/index` | `AI` | AI 会话、流式消息、附件和快捷入口。 |
+
+页面配置统一登记在 `src/pages.ts`，运行时映射位于 `src/index.ts`，构建期描述位于 `src/build.ts`。页面私有组件放在页面目录的 `components` 中，不会被 runner 扫描为路由。
+
+## AI 助手
+
+AI 页面支持会话创建与切换、历史会话搜索、消息加载、附件上传、复制、删除、再生成、工具提示和快捷入口。H5 使用 Fetch SSE，微信小程序使用 chunked 请求，两端共用增量 SSE 解析器和相同事件契约。
+
+请求统一封装在 `src/api`，RPC 类型由 backend Buf 模板生成。页面不能直接写 `Taro.request`，也不能手工修改 `src/rpc`。
+
+## 验证
+
+```bash
+pnpm --filter @liujitcn/kratos-taro-app-system tsc
+pnpm test
+pnpm build:h5
+pnpm build:mp-weixin
+```

package/dist/build.mjs

@@ -0,0 +1,40 @@
+// src/build.ts
+import { dirname, resolve } from "node:path";
+import { fileURLToPath } from "node:url";
+import { defineKratosTaroBuildModule } from "@liujitcn/kratos-taro-app-core/build";
+
+// src/pages.ts
+var systemPages = {
+  "pages/my/my": {
+    style: {
+      navigationStyle: "custom",
+      navigationBarTextStyle: "white",
+      navigationBarTitleText: "\u6211\u7684"
+    }
+  },
+  "pagesMember/settings/settings": { style: { navigationBarTitleText: "\u8BBE\u7F6E" } },
+  "pagesMember/ai/index": {
+    style: {
+      navigationStyle: "custom",
+      navigationBarTitleText: "AI \u52A9\u624B"
+    }
+  },
+  "pagesMember/profile/profile": {
+    style: {
+      navigationStyle: "custom",
+      navigationBarTextStyle: "white",
+      navigationBarTitleText: "\u4E2A\u4EBA\u4FE1\u606F"
+    }
+  }
+};
+
+// src/build.ts
+var packageRoot = resolve(dirname(fileURLToPath(import.meta.url)), "..");
+var buildModule = defineKratosTaroBuildModule({
+  name: "@liujitcn/kratos-taro-app-system",
+  root: packageRoot,
+  pages: systemPages
+});
+export {
+  buildModule
+};

package/package.json

@@ -0,0 +1,36 @@
+{
+  "name": "@liujitcn/kratos-taro-app-system",
+  "description": "Kratos Taro system module with profile, settings, and AI views.",
+  "version": "0.0.1",
+  "type": "module",
+  "files": [
+    "dist",
+    "src",
+    "README.md"
+  ],
+  "exports": {
+    ".": "./src/index.ts",
+    "./build": {
+      "types": "./src/build.ts",
+      "import": "./dist/build.mjs",
+      "default": "./dist/build.mjs"
+    },
+    "./views/*": "./src/views/*",
+    "./package.json": "./package.json"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "@tarojs/components": "4.2.1",
+    "@tarojs/taro": "4.2.1",
+    "react": "18.3.1",
+    "@liujitcn/kratos-taro-app-core": "^0.0.1",
+    "@liujitcn/kratos-taro-app-ui": "^0.0.1"
+  },
+  "scripts": {
+    "build": "pnpm run build:entries && pnpm pack --pack-destination ../../../dist/npm",
+    "build:entries": "esbuild src/build.ts --bundle --platform=node --format=esm --packages=external --outfile=dist/build.mjs",
+    "tsc": "tsc --noEmit -p tsconfig.json"
+  }
+}

package/src/api/base/ai_message.ts

@@ -0,0 +1,377 @@
+import {
+  getRequestAccessToken,
+  handleAuthExpired,
+  http,
+  requestBaseURL,
+} from '@liujitcn/kratos-taro-app-core/utils/http'
+import Taro from '@tarojs/taro'
+import type { ListAiMessageRequest, ListAiMessageResponse } from '../../rpc/base/v1/ai_session'
+import type {
+  AiMessageService,
+  DeleteAiMessageRequest,
+  DeleteAiMessageResponse,
+  RegenerateAiMessageRequest,
+  RetryAiUserMessageRequest,
+  SendAiMessageRequest,
+  SendAiMessageResponse,
+  UpdateAiMessageRequest,
+} from '../../rpc/base/v1/ai_message'
+
+const AI_SESSION_URL = '/v1/base/ai/session'
+
+/** 微信小程序 chunked stream 分片处理选项。 */
+export type AiMessageChunkedStreamOptions = {
+  onChunk: (chunkText: string) => void
+}
+
+/** 微信小程序 chunked stream 请求任务。 */
+export type AiMessageChunkedStreamTask = {
+  promise: Promise<void>
+  abort: () => void
+}
+
+/** direct stream 请求控制选项。 */
+export type AiMessageStreamOptions = {
+  /** 外部取消信号，用于页面卸载或会话删除时终止流式请求。 */
+  signal?: AbortSignal
+}
+
+type ChunkReceivedResult = {
+  data?: ArrayBuffer
+}
+
+type ChunkedRequestTask = Promise<Taro.request.SuccessCallbackResult<ArrayBuffer>> & {
+  abort: () => void
+  onChunkReceived: (listener: (result: ChunkReceivedResult) => void) => void
+}
+
+/** 从 direct stream 错误响应中提取后端业务提示。 */
+async function resolveStreamErrorMessage(response: Response): Promise<string> {
+  const fallbackMessage = `AI 助手请求失败（${response.status}）`
+  const contentType = response.headers.get('Content-Type') ?? ''
+  if (contentType.includes('application/json')) {
+    try {
+      const payload = await response.json()
+      return String(payload?.message || payload?.error || fallbackMessage)
+    } catch {
+      return fallbackMessage
+    }
+  }
+
+  try {
+    const text = (await response.text()).trim()
+    return text || fallbackMessage
+  } catch {
+    return fallbackMessage
+  }
+}
+
+/** 使用 direct stream 发送 AI 助手消息，并返回原始 Fetch Response 供调用方消费。 */
+export async function SendAiMessageStream(
+  request: SendAiMessageRequest,
+  options?: AiMessageStreamOptions,
+): Promise<Response> {
+  const accessToken = await getRequestAccessToken()
+  const headers: Record<string, string> = {
+    Accept: 'text/event-stream',
+    'Content-Type': 'application/json;charset=utf-8',
+    'source-client': 'miniapp',
+  }
+  if (accessToken) {
+    headers.Authorization = accessToken
+  }
+
+  const response = await fetch(`${requestBaseURL}${AI_SESSION_URL}/${request.session_id}/message`, {
+    method: 'POST',
+    headers,
+    body: JSON.stringify(request),
+    signal: options?.signal,
+  })
+
+  // direct stream 不经过 uni.request 拦截器，需要在这里补齐登录失效处理。
+  if (response.status === 401 || response.status === 403) {
+    handleAuthExpired('required')
+    throw new Error('登录状态已失效，请重新登录')
+  }
+  if (!response.ok) {
+    throw new Error(await resolveStreamErrorMessage(response))
+  }
+
+  return response
+}
+
+/** 使用微信小程序 chunked request 发送 AI 助手消息并增量返回 SSE 文本。 */
+export function StreamAiMessageByChunkedRequest(
+  request: SendAiMessageRequest,
+  options: AiMessageChunkedStreamOptions,
+): AiMessageChunkedStreamTask {
+  let requestTask: ChunkedRequestTask | undefined
+  let aborted = false
+  let receivedChunk = false
+  const decoder = createChunkTextDecoder()
+
+  const promise = (async () => {
+    const accessToken = await getRequestAccessToken()
+    if (aborted) {
+      return
+    }
+
+    await new Promise<void>((resolve, reject) => {
+      requestTask = Taro.request<ArrayBuffer>({
+        url: `${requestBaseURL}${AI_SESSION_URL}/${request.session_id}/message`,
+        method: 'POST',
+        data: request,
+        dataType: 'text',
+        responseType: 'arraybuffer',
+        enableChunked: true,
+        timeout: 120000,
+        header: {
+          Accept: 'text/event-stream',
+          'Content-Type': 'application/json;charset=utf-8',
+          'source-client': 'miniapp',
+          ...(accessToken ? { Authorization: accessToken } : {}),
+        },
+        success(res) {
+          if (aborted) {
+            resolve()
+            return
+          }
+          if (res.statusCode === 401 || res.statusCode === 403) {
+            handleAuthExpired('required')
+            reject(new Error('登录状态已失效，请重新登录'))
+            return
+          }
+          if (res.statusCode < 200 || res.statusCode >= 300) {
+            reject(new Error(resolveChunkedStreamErrorMessage(res)))
+            return
+          }
+
+          const tailText = decoder.flush()
+          if (tailText) {
+            options.onChunk(tailText)
+          }
+          if (!receivedChunk) {
+            const fallbackText = decodeChunkedResponseData(res.data)
+            if (fallbackText) {
+              options.onChunk(fallbackText)
+            }
+          }
+          resolve()
+        },
+        fail(error) {
+          if (aborted) {
+            resolve()
+            return
+          }
+          reject(error)
+        },
+      }) as ChunkedRequestTask
+
+      if (typeof requestTask.onChunkReceived !== 'function') {
+        requestTask.abort()
+        reject(new Error('当前端不支持流式回复'))
+        return
+      }
+
+      requestTask.onChunkReceived((result) => {
+        if (aborted || !result.data) {
+          return
+        }
+        receivedChunk = true
+        const chunkText = decoder.decode(result.data)
+        if (chunkText) {
+          options.onChunk(chunkText)
+        }
+      })
+    })
+  })()
+
+  return {
+    promise,
+    abort() {
+      aborted = true
+      requestTask?.abort()
+    },
+  }
+}
+
+/** AI 助手消息服务。 */
+export class AiMessageServiceImpl implements AiMessageService {
+  /** 查询 AI 助手消息列表。 */
+  ListAiMessage(request: ListAiMessageRequest): Promise<ListAiMessageResponse> {
+    return http<ListAiMessageResponse>({
+      url: `${AI_SESSION_URL}/${request.session_id}/message`,
+      method: 'GET',
+      authMode: 'required',
+      data: request,
+    })
+  }
+
+  /** 发送 AI 助手消息并等待完整响应。 */
+  SendAiMessage(request: SendAiMessageRequest): Promise<SendAiMessageResponse> {
+    return http<SendAiMessageResponse>({
+      url: `${AI_SESSION_URL}/${request.session_id}/message`,
+      method: 'POST',
+      authMode: 'required',
+      data: request,
+    })
+  }
+
+  /** 删除 AI 助手消息。 */
+  DeleteAiMessage(request: DeleteAiMessageRequest): Promise<DeleteAiMessageResponse> {
+    return http<DeleteAiMessageResponse>({
+      url: `${AI_SESSION_URL}/${request.session_id}/message/${request.message_id}`,
+      method: 'DELETE',
+      authMode: 'required',
+      data: request,
+    })
+  }
+
+  /** 更新 AI 助手消息文本并重新生成输出。 */
+  UpdateAiMessage(request: UpdateAiMessageRequest): Promise<SendAiMessageResponse> {
+    return http<SendAiMessageResponse>({
+      url: `${AI_SESSION_URL}/${request.session_id}/message/${request.message_id}`,
+      method: 'PUT',
+      authMode: 'required',
+      data: request,
+    })
+  }
+
+  /** 重试失败的 AI 助手消息。 */
+  RetryAiUserMessage(request: RetryAiUserMessageRequest): Promise<SendAiMessageResponse> {
+    return http<SendAiMessageResponse>({
+      url: `${AI_SESSION_URL}/${request.session_id}/message/${request.message_id}/retry`,
+      method: 'POST',
+      authMode: 'required',
+      data: request,
+    })
+  }
+
+  /** 重新生成 AI 助手输出。 */
+  RegenerateAiMessage(request: RegenerateAiMessageRequest): Promise<SendAiMessageResponse> {
+    return http<SendAiMessageResponse>({
+      url: `${AI_SESSION_URL}/${request.session_id}/message/${request.message_id}/regeneration`,
+      method: 'POST',
+      authMode: 'required',
+      data: request,
+    })
+  }
+
+  /** 使用 direct stream 发送 AI 助手消息，并返回原始 Fetch Response 供调用方消费。 */
+  StreamAiMessage(
+    request: SendAiMessageRequest,
+    options?: AiMessageStreamOptions,
+  ): Promise<Response> {
+    return SendAiMessageStream(request, options)
+  }
+}
+
+export const defAiMessageService = new AiMessageServiceImpl()
+
+function resolveChunkedStreamErrorMessage(
+  response: Taro.request.SuccessCallbackResult<ArrayBuffer>,
+) {
+  const fallbackMessage = `AI 助手请求失败（${response.statusCode}）`
+  const text = decodeChunkedResponseData(response.data).trim()
+  if (!text) {
+    return fallbackMessage
+  }
+
+  try {
+    const payload = JSON.parse(text) as { message?: string; error?: string }
+    return payload.message || payload.error || fallbackMessage
+  } catch {
+    return text || fallbackMessage
+  }
+}
+
+function decodeChunkedResponseData(data: unknown) {
+  if (typeof data === 'string') {
+    return data
+  }
+  if (data instanceof ArrayBuffer) {
+    return createChunkTextDecoder().decode(data)
+  }
+  if (data && typeof data === 'object') {
+    return JSON.stringify(data)
+  }
+  return ''
+}
+
+function createChunkTextDecoder() {
+  if (typeof TextDecoder !== 'undefined') {
+    const decoder = new TextDecoder('utf-8')
+    return {
+      decode(data: ArrayBuffer) {
+        return decoder.decode(data, { stream: true })
+      },
+      flush() {
+        return decoder.decode()
+      },
+    }
+  }
+
+  let pendingBytes: number[] = []
+  return {
+    decode(data: ArrayBuffer) {
+      const bytes = [...pendingBytes, ...Array.from(new Uint8Array(data))]
+      const boundary = resolveUtf8Boundary(bytes)
+      pendingBytes = bytes.slice(boundary)
+      return decodeUtf8Bytes(bytes.slice(0, boundary))
+    },
+    flush() {
+      const text = decodeUtf8Bytes(pendingBytes)
+      pendingBytes = []
+      return text
+    },
+  }
+}
+
+function resolveUtf8Boundary(bytes: number[]) {
+  let index = bytes.length - 1
+  while (index >= 0 && (bytes[index] & 0xc0) === 0x80) {
+    index--
+  }
+  if (index < 0) {
+    return 0
+  }
+
+  const length = resolveUtf8SequenceLength(bytes[index])
+  if (length > 1 && bytes.length - index < length) {
+    return index
+  }
+  return bytes.length
+}
+
+function resolveUtf8SequenceLength(lead: number) {
+  if ((lead & 0x80) === 0) {
+    return 1
+  }
+  if ((lead & 0xe0) === 0xc0) {
+    return 2
+  }
+  if ((lead & 0xf0) === 0xe0) {
+    return 3
+  }
+  if ((lead & 0xf8) === 0xf0) {
+    return 4
+  }
+  return 1
+}
+
+function decodeUtf8Bytes(bytes: number[]) {
+  if (!bytes.length) {
+    return ''
+  }
+
+  let encoded = ''
+  for (const byte of bytes) {
+    encoded += `%${byte.toString(16).padStart(2, '0')}`
+  }
+
+  try {
+    return decodeURIComponent(encoded)
+  } catch {
+    return String.fromCharCode(...bytes)
+  }
+}

package/src/api/base/ai_session.ts

@@ -0,0 +1,85 @@
+import { http } from '@liujitcn/kratos-taro-app-core/utils/http'
+import type {
+  AiSessionService,
+  CreateAiSessionBranchRequest,
+  CreateAiSessionBranchResponse,
+  CreateAiSessionRequest,
+  CreateAiSessionResponse,
+  DeleteAiSessionRequest,
+  DeleteAiSessionResponse,
+  ListAiMessageRequest,
+  ListAiMessageResponse,
+  ListAiSessionRequest,
+  ListAiSessionResponse,
+  UpdateAiSessionRequest,
+  UpdateAiSessionResponse,
+} from '../../rpc/base/v1/ai_session'
+
+const AI_SESSION_URL = '/v1/base/ai/session'
+
+/** AI 助手会话服务。 */
+export class AiSessionServiceImpl implements AiSessionService {
+  /** 查询 AI 助手会话列表。 */
+  ListAiSession(request: ListAiSessionRequest): Promise<ListAiSessionResponse> {
+    return http<ListAiSessionResponse>({
+      url: AI_SESSION_URL,
+      method: 'GET',
+      authMode: 'required',
+      data: request,
+    })
+  }
+
+  /** 创建 AI 助手会话。 */
+  CreateAiSession(request: CreateAiSessionRequest): Promise<CreateAiSessionResponse> {
+    return http<CreateAiSessionResponse>({
+      url: AI_SESSION_URL,
+      method: 'POST',
+      authMode: 'required',
+      data: request,
+    })
+  }
+
+  /** 更新 AI 助手会话。 */
+  UpdateAiSession(request: UpdateAiSessionRequest): Promise<UpdateAiSessionResponse> {
+    return http<UpdateAiSessionResponse>({
+      url: `${AI_SESSION_URL}/${request.id}`,
+      method: 'PUT',
+      authMode: 'required',
+      data: request,
+    })
+  }
+
+  /** 删除 AI 助手会话。 */
+  DeleteAiSession(request: DeleteAiSessionRequest): Promise<DeleteAiSessionResponse> {
+    return http<DeleteAiSessionResponse>({
+      url: `${AI_SESSION_URL}/${request.id}`,
+      method: 'DELETE',
+      authMode: 'required',
+      data: request,
+    })
+  }
+
+  /** 查询 AI 助手消息列表。 */
+  ListAiMessage(request: ListAiMessageRequest): Promise<ListAiMessageResponse> {
+    return http<ListAiMessageResponse>({
+      url: `${AI_SESSION_URL}/${request.session_id}/message`,
+      method: 'GET',
+      authMode: 'required',
+      data: request,
+    })
+  }
+
+  /** 从指定消息创建 AI 助手分支会话。 */
+  CreateAiSessionBranch(
+    request: CreateAiSessionBranchRequest,
+  ): Promise<CreateAiSessionBranchResponse> {
+    return http<CreateAiSessionBranchResponse>({
+      url: `${AI_SESSION_URL}/${request.source_session_id}/branch`,
+      method: 'POST',
+      authMode: 'required',
+      data: request,
+    })
+  }
+}
+
+export const defAiSessionService = new AiSessionServiceImpl()

package/src/api/base/ai_tool.ts

@@ -0,0 +1,23 @@
+import { http } from '@liujitcn/kratos-taro-app-core/utils/http'
+import type {
+  AiToolService,
+  ListAiShortcutRequest,
+  ListAiShortcutResponse,
+} from '../../rpc/base/v1/ai_tool'
+
+const AI_SHORTCUT_URL = '/v1/base/ai/shortcut'
+
+/** AI 助手工具服务。 */
+export class AiToolServiceImpl implements AiToolService {
+  /** 查询 AI 助手快捷入口列表。 */
+  ListAiShortcut(request: ListAiShortcutRequest): Promise<ListAiShortcutResponse> {
+    return http<ListAiShortcutResponse>({
+      url: AI_SHORTCUT_URL,
+      method: 'GET',
+      authMode: 'required',
+      data: request,
+    })
+  }
+}
+
+export const defAiToolService = new AiToolServiceImpl()

package/src/build.ts

@@ -0,0 +1,13 @@
+import { dirname, resolve } from 'node:path'
+import { fileURLToPath } from 'node:url'
+import { defineKratosTaroBuildModule } from '@liujitcn/kratos-taro-app-core/build'
+import { systemPages } from './pages'
+
+const packageRoot = resolve(dirname(fileURLToPath(import.meta.url)), '..')
+
+/** system 构建期模块描述。 */
+export const buildModule = defineKratosTaroBuildModule({
+  name: '@liujitcn/kratos-taro-app-system',
+  root: packageRoot,
+  pages: systemPages,
+})

package/src/index.ts

@@ -0,0 +1,14 @@
+import { defineKratosTaroModule } from '@liujitcn/kratos-taro-app-core'
+import { systemPages } from './pages'
+
+/** system 业务模块。 */
+export const systemModule = defineKratosTaroModule({
+  name: '@liujitcn/kratos-taro-app-system',
+  pages: systemPages,
+  views: {
+    PROFILE_HOME: 'pages/my/my',
+    PROFILE: 'pagesMember/profile/profile',
+    SETTINGS: 'pagesMember/settings/settings',
+    AI: 'pagesMember/ai/index',
+  },
+})

package/src/pages.ts

@@ -0,0 +1,26 @@
+import type { KratosTaroPageConfig } from '@liujitcn/kratos-taro-app-core'
+
+/** system 页面编译配置。 */
+export const systemPages: Record<string, KratosTaroPageConfig> = {
+  'pages/my/my': {
+    style: {
+      navigationStyle: 'custom',
+      navigationBarTextStyle: 'white',
+      navigationBarTitleText: '我的',
+    },
+  },
+  'pagesMember/settings/settings': { style: { navigationBarTitleText: '设置' } },
+  'pagesMember/ai/index': {
+    style: {
+      navigationStyle: 'custom',
+      navigationBarTitleText: 'AI 助手',
+    },
+  },
+  'pagesMember/profile/profile': {
+    style: {
+      navigationStyle: 'custom',
+      navigationBarTextStyle: 'white',
+      navigationBarTitleText: '个人信息',
+    },
+  },
+}