@liujitcn/kratos-uni-app-system 0.0.1

package/README.md

@@ -0,0 +1,31 @@
+# @liujitcn/kratos-uni-app-system
+
+`@liujitcn/kratos-uni-app-system` 是内置 system 业务模块。个人中心、个人资料、设置和 AI 能力都归属本模块，并沿用 core 的登录态、请求、导航和页面装配协议。
+
+## 目录结构
+
+```text
+packages/modules/system
+├── src
+│   ├── api/base               # AI 消息、会话和工具接口
+│   ├── rpc                    # system 相关 Buf 生成类型
+│   ├── views
+│   │   ├── pages/my           # 个人中心主页
+│   │   └── pagesMember        # AI、个人资料和设置页面
+│   ├── index.ts               # systemModule 定义和公开入口
+│   └── pages.ts               # 页面样式与分包声明
+├── tsconfig.json
+└── package.json
+```
+
+`src/rpc` 是生成产物，只能通过 workspace 根目录的 `pnpm generate:rpc` 更新；该命令委托 backend 的 `make ts-app` 和 `backend/api/buf.app.core.typescript.gen.yaml` 生成。
+
+## 功能
+
+- 注册 `PROFILE_HOME`、`PROFILE`、`SETTINGS` 和 `AI` 四个稳定 `viewKey`。
+- 提供个人中心、资料维护、应用设置和 AI 助手页面。
+- 通过 core 的公开 service、store 和工具复用底座能力。
+- 允许后续模块按相同物理路由或 `viewKey` 覆盖 system 静态视图。
+- npm 根入口使用 `dist/index.mjs`；workspace 的 Turbo 任务和 `prepare:modules` 会先构建 system 及其依赖的 core Node 入口，干净安装后不依赖历史 dist。
+
+模块装配与动态导航约定见 [workspace 文档](../../../README.md)。

package/dist/index.mjs

@@ -0,0 +1,93 @@
+// ../../core/src/pages.ts
+var corePages = {
+  "pages/index/index": {
+    style: {
+      navigationStyle: "custom",
+      navigationBarTextStyle: "white",
+      navigationBarTitleText: "\u9996\u9875"
+    }
+  },
+  "pages/login/login": { style: { navigationBarTitleText: "\u767B\u5F55" } },
+  "pages/login/protocal": { style: { navigationBarTitleText: "\u534F\u8BAE\u8BE6\u60C5" } },
+  "pages/webview/webview": {
+    style: {
+      navigationBarTitleText: "",
+      "app-plus": { titleNView: false }
+    }
+  },
+  "pages/status/index": {
+    style: {
+      navigationStyle: "custom",
+      navigationBarTitleText: ""
+    }
+  }
+};
+
+// ../../core/src/module.ts
+function defineKratosAppModule(module) {
+  return module;
+}
+var coreModule = defineKratosAppModule({
+  name: "@liujitcn/kratos-uni-app-core",
+  pages: corePages,
+  views: {
+    HOME: "pages/index/index",
+    LOGIN: "pages/login/login",
+    PROTOCOL: "pages/login/protocal",
+    WEBVIEW: "pages/webview/webview",
+    BOOTSTRAP_LOADING: "pages/status/index",
+    FORBIDDEN: "pages/status/index",
+    NOT_FOUND: "pages/status/index",
+    OFFLINE: "pages/status/index",
+    CONFIG_ERROR: "pages/status/index",
+    PAGE_UNAVAILABLE: "pages/status/index"
+  },
+  icons: {
+    HOME_DEFAULT: "static/tabs/home_default.png",
+    HOME_SELECTED: "static/tabs/home_selected.png",
+    USER_DEFAULT: "static/tabs/user_default.png",
+    USER_SELECTED: "static/tabs/user_selected.png"
+  }
+});
+
+// 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/index.ts
+var systemModule = defineKratosAppModule({
+  name: "@liujitcn/kratos-uni-app-system",
+  pages: systemPages,
+  views: {
+    PROFILE_HOME: "pages/my/my",
+    PROFILE: "pagesMember/profile/profile",
+    SETTINGS: "pagesMember/settings/settings",
+    AI: "pagesMember/ai/index"
+  }
+});
+var src_default = systemModule;
+export {
+  src_default as default,
+  systemModule
+};

package/package.json

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

package/src/api/base/ai_message.ts

@@ -0,0 +1,373 @@
+import {
+  getRequestAccessToken,
+  handleAuthExpired,
+  http,
+  requestBaseURL,
+} from '@liujitcn/kratos-uni-app-core/utils/http'
+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 = UniNamespace.RequestTask & {
+  onChunkReceived?: (listener: (result: ChunkReceivedResult) => void) => number
+}
+
+/** 从 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 = uni.request({
+        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: UniApp.RequestSuccessCallbackResult) {
+  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-uni-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-uni-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/index.ts

@@ -0,0 +1,16 @@
+import { defineKratosAppModule } from '@liujitcn/kratos-uni-app-core/module'
+import { systemPages } from './pages'
+
+/** system 内置模块，AI 能力也归属 system。 */
+export const systemModule = defineKratosAppModule({
+  name: '@liujitcn/kratos-uni-app-system',
+  pages: systemPages,
+  views: {
+    PROFILE_HOME: 'pages/my/my',
+    PROFILE: 'pagesMember/profile/profile',
+    SETTINGS: 'pagesMember/settings/settings',
+    AI: 'pagesMember/ai/index',
+  },
+})
+
+export default systemModule

package/src/pages.ts

@@ -0,0 +1,26 @@
+import type { KratosAppPageConfig } from '@liujitcn/kratos-uni-app-core/module'
+
+/** system 页面编译配置。 */
+export const systemPages: Record<string, KratosAppPageConfig> = {
+  '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: '个人信息',
+    },
+  },
+}