AIStockMarket

基于 Tencent KuiklyUI 的 AI 股票行情原型 Demo，使用 Kotlin Multiplatform（KMP）编写，一套代码跨 Android / iOS。

---

页面截图

首页行情列表

个股详情

)

AI 分析与解读

)

---

已实现功能

首页行情列表页

• 股票名称、代码、最新价、涨跌额、涨跌幅色块展示（红涨绿跌）
• 顶部市场概况：实时统计上涨 / 下跌 / 平盘家数
• 搜索：输入股票名称或代码，列表实时过滤；清空即恢复全量
• 排序：默认 / 涨幅榜 / 跌幅榜三档，点击立即重排，选中标签高亮
• 点击任意行跳转个股详情页

个股详情页

• 基础信息：名称、代码、最新价、涨跌幅
• 8 项指标网格：今开、昨收、最高、最低、成交量、成交额、市值、市盈率

AI 分析与解读模块

• 趋势判断（看涨 / 看跌 / 震荡）+ 置信度进度条
• 信号标签（利多 / 利空）
• 买入 / 卖出建议卡片
• 操作提示区
• 风险等级徽章（高 / 中 / 低）+ 风险提醒文案
• 行情总结
• 可折叠 AI 配置面板，支持接入任意 OpenAI 兼容大模型（DeepSeek、通义千问、Kimi 等）

---

技术栈

项目	版本
KuiklyUI	2.7.0
Kotlin	2.1.21
Android compileSdk	34
Android minSdk	23

---

运行方式（Android）

只能通过 Android Studio 构建，不支持纯命令行 assembleDebug（环境 dex 工具链限制）。

1. 打开 Android Studio，导入项目根目录
2. 等待 Gradle 同步完成
3. 选择 androidApp run configuration，连接设备或启动模拟器后点击运行

AI 大模型配置（可选）

默认使用本地规则引擎生成 AI 分析。接入真实大模型：

1. 复制配置模板：

   cp shared/src/commonMain/kotlin/com/elyric/aistockmarket/ai/AiRuntimeConfig.kt.example \
      shared/src/commonMain/kotlin/com/elyric/aistockmarket/ai/AiRuntimeConfig.kt

2. 填入 BASE_URL、MODEL、API_KEY（示例见模板注释）
3. 该文件已加入 .gitignore，不会被提交到 git

支持的服务商示例：

服务商	BASE_URL	MODEL
DeepSeek	https://api.deepseek.com	deepseek-chat
OpenAI	https://api.openai.com	gpt-4o
通义千问	https://dashscope.aliyuncs.com/compatible-mode/v1	qwen-turbo
Kimi	https://api.moonshot.cn/v1	moonshot-v1-8k

BASE_URL 末尾不要加 /chat/completions，框架会自动拼接。

---

开发注意事项

Kuikly 响应式渲染

• body() 只在页面构建时执行一次，普通 Kotlin forEach / if 不会随 Observable 变化重渲染
• 列表必须用 vfor { observableList }，且 creator lambda 只能产生一个顶层子节点（多个子节点会抛运行时错误）
• 条件渲染用 vif { condition }
• 需要随 Observable 变化更新的样式（背景色、字体色等），必须在 attr {} 闭包内直接读，不能提前缓存到 val

DSL 作用域约束

• body() 的 lambda 及各 helper 函数内，访问页面成员需要显式 receiver，推荐在每个渲染函数顶部 val ctx = this@PageClass
• helper 函数签名用 fun render(c: ViewContainer<*, *>, ...) = with(c) { ... }，不要写成扩展函数

页面跳转

• 使用 RouterModule.openPage("page_name", jsonObject) 跳转
• 目标页通过 getPager().pageData 接收参数
• 入口页在 KuiklyRenderActivity 中配置，当前默认为 stock_list

API Key 安全

• AiRuntimeConfig.kt 已加入 .gitignore，严禁提交含真实 Key 的文件
• 提交前用 git status 确认该文件未出现在暂存区