mirror of
https://gitcode.com/JianFeeeee/HomeAgent.git
synced 2026-09-21 09:28:14 +00:00
48b5c2401c
## 动效统一 各组件重复实现按压反馈（@State pressed + scale + animation + onTouch 四件套）， 时长各写魔数导致全局手感不一致。 - 新增 components/MotionBase.ets：通用动效的"父组件"。ArkUI V1 的 @Component struct 无法继承他人 build，改用组合表达继承——调用组件把内容经 @BuilderParam 内容插槽传入，MotionBase 在包装节点统一挂动效修饰器。 pressEnabled 默认关（纯展示容器零开销）；fillWidth=false 供气泡内卡片按内容 自适应宽度；flexWeight 供等分排列按钮参与剩余空间分配。 onPress 只作按压瞬时轻量钩子，导航/提交语义仍由调用组件 onClick 负责， 避免"按下即触发"的手感偏差。 - Constants.ets 新增动效 token：ANIM_FAST(150) / ANIM_NORMAL(220) / ANIM_ENTER(280) / ANIM_SLOW(400) / PRESS_SCALE(0.97)。 取值依据：状态切换 150-250ms（>300ms 显拖沓），大位移进出场 300-400ms 才不突兀；曲线统一 EaseOut 起步快收尾缓。 - NavRow / StatusSummaryCard / AttachmentCard / 插件卡片等公共组件接入 MotionBase，移除各自的按压四件套。组件专属动效（聊天输入框上弹、加号菜单 浮起、折叠面板展开、toast 进出场）保留在各组件内，不塞进父组件。 ## 图标与启动页随主题切换 原先直接指向位图 app_icon.png，浅色底被烧进图标，深色模式下桌面与启动页跳脱。 - 改用分层图标 layered_image：foreground 为字形，background（沉淀色）在 base/ 与 dark/ 各一份，随系统主题切换。app.json5 与 module.json5 的 icon 均指向 :layered_image。 - startWindowIcon 改用透明底 start_icon.png，配合 start_window_background 的 base(#F1F3F5) / dark(#000000) 两份取值，浅深模式遮罩与图标都能对上。 ## 验证 清空 entry/build 后全量重编：hvigorw assembleHap BUILD SUCCESSFUL（9.8s）， 零 ArkTS 错误。提交内容已确认不含 build/ oh_modules/ .hap 与签名材料。
HomeAgent 鸿蒙客户端
HarmonyOS / OpenHarmony 原生客户端，用 ArkTS + ArkUI 实现（不是 WebView 套壳）。 功能与 WebUI 对齐：SSE 流式对话、工具调用卡片、思考过程折叠、附件上传预览、 设备桥、插件管理、设置编辑、宽屏双栏、深浅色主题。
工程结构
HomeAgent/
├── AppScope/ 应用级配置与图标
├── entry/src/main/
│ ├── ets/
│ │ ├── common/ 通信与全局状态
│ │ │ ├── ApiClient.ets REST 客户端（X-API-Key 鉴权、超时、二进制附件）
│ │ │ ├── SseClient.ets SSE 长连接（Last-Event-ID 断线续传）
│ │ │ ├── DeviceBridge.ets 设备桥：把本机能力暴露给 agent
│ │ │ ├── BridgeRouter.ets 桥请求路由
│ │ │ ├── BridgeCaps.ets 能力声明
│ │ │ ├── ConnStore.ets 连接配置持久化
│ │ │ ├── StatusStore.ets 运行状态缓存
│ │ │ ├── NavBarController.ets / NavStackRegistry.ets 导航
│ │ │ ├── Constants.ets 主题色板、圆角、超时、分页大小
│ │ │ └── UserError.ets 错误转人类可读文案
│ │ ├── components/ 可复用组件
│ │ │ ├── MarkdownView.ets 流式 Markdown（增量渲染）
│ │ │ ├── StaticMarkdown.ets 静态 Markdown（历史消息，一次成型）
│ │ │ ├── Attachment.ets 附件卡片 + 详情
│ │ │ ├── StatusCards.ets 状态卡片
│ │ │ ├── SettingsEditor.ets 配置编辑器
│ │ │ ├── PageTopBar.ets 顶栏 + 悬浮按钮
│ │ │ ├── SubPage.ets 二级页容器
│ │ │ └── GradientBackground.ets
│ │ ├── model/Model.ets 共享类型定义
│ │ ├── pages/ 页面
│ │ │ ├── Index.ets Tab 容器（入口）
│ │ │ ├── ChatPage.ets 对话
│ │ │ ├── DevicePage.ets 设备
│ │ │ ├── PluginsPage.ets 插件
│ │ │ └── SettingsPage.ets 设置
│ │ └── entryability/EntryAbility.ets
│ ├── module.json5 权限、能力声明
│ └── resources/ 字符串、颜色、图标、页面路由表
├── build-profile.json5.example 构建/签名配置模板（复制后填本机签名材料）
└── oh-package.json5 依赖
编译
需要 DevEco Studio 或 command-line-tools。
本工程用 compatibleSdkVersion 6.1.1(24) / compileSdkVersion 26.0.0。
-
准备签名配置（
build-profile.json5含密码明文，未入库）：cd cmd/ohos/HomeAgent cp build-profile.json5.example build-profile.json5把
REPLACE_WITH_YOUR_*换成本机 DevEco 生成的调试签名材料， 默认在~/.ohos/config/下（.cer/.p7b/.p12三件套 + 两个密码）。 用 DevEco Studio 打开工程会自动生成，命令行可参考deveco-cli生成签名材料。 -
构建 HAP：
# hvigorw 未入库（本机是符号链接），直接用 command-line-tools 里的 /path/to/command-line-tools/bin/hvigorw \ --mode module -p module=entry@default assembleHap --no-daemon产物在
entry/build/default/outputs/default/entry-default-signed.hap。 -
安装到设备：
hdc install entry/build/default/outputs/default/entry-default-signed.hap
连接 homed
首次启动在「设置」里填：
- 服务地址：
http://<homed 主机>:8080（WebUI 插件监听端口） - API Key：homed 的
plugin.webui.api_key
客户端所有请求走 <服务地址>/api/v1/*，带 X-API-Key 头。
附件路径 /files/ /uploads/ 不带 /api/v1 前缀，同样携带鉴权头。
设备桥需要 homed 启用 remotedevice 插件（默认 9890），
在「设备」页填 ws token 后本机能力即可被 agent 调用。
注意事项
- 聊天历史分页：首屏只拉最新
CHAT_PAGE_SIZE（40）条，向上滚动触顶自动加载更早的。 服务端/chat/history支持limit/before游标；工具调用详情与思考内容完整下发不裁剪。 - 修改主题色：改
common/Constants.ets的DARK_PALETTE/LIGHT_PALETTE，全局生效。 - 新增页面：同时在
resources/base/profile/main_pages.json注册，且只有入口页带@Entry。 - 项目代码部分由 AI 辅助生成，改动请自行评估。