资讯详情

资讯详情

HoneClaw 架构深度解析:Rust + SolidJS 开源 AI 投研助手是如何搭起来的

【免费下载链接】honeclawHoneClaw (Hone-Financial) is dedicated to being a professional investment assistant that truly understands you.项目地址https://gitcode.com/gh_mirrors/ho/honeclaw点击查看免费下载HoneClawHone-Financial是一个开源的 AI 投研助手用 Rust 搭建后端运行时、SolidJS 搭建 Web 前端支持 Web、桌面端、iOS 以及飞书、Telegram 等多通道接入。这篇文章带你快速看懂 HoneClaw 的整体架构它由哪些模块组成、一条消息从提问到回答要经过哪几层、以及新手该如何阅读它的源码。一、HoneClaw 是做什么的HoneClaw 定位是「真正懂你的专业投资助手」你用自然语言提问比如推理需求增长会怎样影响光模块和存储它会结合产业研究背景、专业金融数据与联网搜索给出带数据时间、行情口径的研究级回答还能把公司加入跟踪列表、做定时盯盘与事件推送。它的开源目标是让你可以自部署、二次开发。完整使用与自部署说明见 docs/wiki.md模块导航见 docs/repo-map.md。二、技术栈总览为什么是 Rust SolidJS整个项目可以概括为「Rust 做运行时SolidJS 做界面」层技术位置后端运行时 / 各二进制RustTokio 异步、axum HTTPcrates/、bins/Web 控制台与用户端SolidJS TypeScriptBun 工作区packages/app/桌面端TauriRust 壳 Web 前端bins/hone-desktop/iOS 客户端原生 SwiftUI WKWebViewapps/hone-ios/持久化PostgreSQL会话、配额、组合、Cron、计费memory/边缘加速Cloudflare Workersworkers/Rust 负责高并发的通道监听、Agent 运行时、LLM 流式协议与数据库访问SolidJS 负责管理端与用户端的交互界面。两边通过/api/*与 SSE 事件流对接互不侵入。三、Rust 后端分层一次对话要穿过哪几层后端按职责拆成多个 crate依赖方向基本是「上层依赖下层」hone-core配置门面、日志、错误类型、时区、进程锁等基础设施crates/hone-core/src/lib.rshone-llm模型提供方抽象OpenRouter 与通用 OpenAI 兼容协议统一流式生命周期crates/hone-llm/src/provider.rshone-tools工具注册表与内置工具——行情/财务数据、联网搜索、组合、定时任务、Skill 运行时crates/hone-tools/src/registry.rshone-channels整个「会话运行时」的大脑——入站归一、会话编排、Runner 抽象、出站投递crates/hone-channels/src/agent_session/mod.rshone-scheduler定时任务与心跳式监控hone-event-engine事件引擎轮询价格、新闻、财报等事件并推送crates/hone-event-engine/src/engine.rshone-web-apiWeb 服务的路由、鉴权、公共 APIcrates/hone-web-api/src/routes/public.rsmemoryPostgreSQL 持久化层会话、配额、组合、Cron、账单等memory/src/session.rs一条消息的完整旅程大致是通道入口Web / 飞书 / Telegram / Discord / iMessage / 桌面接收原始消息hone-channels::ingress统一做身份Actor识别、去重、会话加锁AgentSession::run()编排整轮配额检查、提示词组装、调用 RunnerRunner执行 Agent 循环——内置 function-calling Agent 或 Codex / OpenCode 等 ACP 外部运行时crates/hone-channels/src/runners/其间按需调用数据、搜索等工具response_finalizer做安全清理后经outbound按各通道能力分片投递Web 端则通过 SSE 事件流实时接收run_progress/assistant_delta/run_finished等事件。提示词方面投资推理与回答格式的完整契约写在仓库根目录的 soul.md 中再由 Rust 侧叠加时区、安全与隐私规则这是它回答「专业」的关键之一。四、多通道接入同一套大脑多个身体bins/下每个二进制就是一个「身体」bins/hone-feishu/、bins/hone-telegram/、bins/hone-discord/ 等通道入口都很薄真正的启动引导、调度、出站渲染都在共享的hone-channels里完成——所以新增一个 IM 通道成本主要是协议适配。桌面端 bins/hone-desktop/ 是 Tauri 应用支持两种后端模式bundled本地启动内置服务适合离线自托管remote直连远端 HTTP适合只当客户端。iOS 客户端 apps/hone-ios/ 则是轻量壳内嵌同一套 Web 用户界面保持单一功能真相源。五、前端SolidJS 控制台与用户端管理端Console与用户端共用一个 SolidJS 工程 packages/app/但按端口与构建产物分离管理端提供会话、技能库、任务中心、记忆、LLM 审计等管理面用户端提供/chat、研究面板、社区动态、持仓跟踪等界面。聊天页面是整个前端最复杂的部分它会消费 Runner 的实时流式事件把思考、工具状态、恢复与错误都收敛在「同一张消息卡片」内刷新页面也能恢复运行中的对话packages/app/src/pages/chat.tsx。六、Skill 系统让 AI 按方法论做研究HoneClaw 把「投研方法论」做成了可插拔的 Skill每个 Skill 是一个目录核心是一份 SKILL.md定义触发条件、工作流与产出契约。仓库内置了 30 多个例如skills/stock_research/个股研究与估值框架skills/earnings-research/财报前瞻与财报分析skills/company_portrait/公司画像与长期跟踪skills/chart_visualization/图表生成Python 脚本渲染 PNGskills/hari-invest/投资决策决策层模型运行时先看到技能摘要命中后才会加载完整 SKILL.md运行时实现见 crates/hone-tools/src/skill_runtime.rs。这种「提示词即插件」的设计是普通用户理解 HoneClaw 能力边界的最佳入口。七、新手上手路径如果你想本地跑起来或读源码建议按这个顺序阅读 docs/repo-map.md 与 docs/invariants.md建立模块地图与关键约束参考 config.example.yaml 准备配置模型密钥、数据源、通道开关克隆仓库体验自部署需要自备模型与数据服务配置git clone https://gitcode.com/gh_mirrors/ho/honeclaw从入口文件开始读CLI 是 bins/hone-cli/src/main.rsWeb 后端是 bins/hone-console-page/src/main.rs前端是 packages/app/src/app.tsx安装 CLI 可参考 scripts/install_hone_cli.sh部署手册在 docs/runbooks/ 目录下。写在最后HoneClaw 的架构思路可以浓缩成三句话Rust crate 按职责分层通道只是薄壳一次会话由 AgentSession 统一编排Runner 与工具可插拔方法论以 Skill 形式沉淀前端 SolidJS 只做体验。理解这三点你就能顺着 docs/repo-map.md 把整个代码库读通。项目采用 MIT 协议欢迎在源码基础上构建属于你的投研工作流。赞分享【免费下载链接】honeclawHoneClaw (Hone-Financial) is dedicated to being a professional investment assistant that truly understands you.项目地址https://gitcode.com/gh_mirrors/ho/honeclaw点击查看免费下载相关推荐React 19 Three.jsprehistoric-animal-museum 的 3D 查看器架构是如何搭起来的React 19 Three.jsprehistoric animal museum 的 3D 查看器架构是如何搭起来的 prehistoricncc 多 Bundle 构建实战用 vercel/ncc 将主模块与 CLI 分别打包成一个文件ncc 多 Bundle 构建实战用 vercel/ncc 将主模块与 CLI 分别打包成一个文件 导读 本文以 ncc 仓库内置的 examples/muHoneClaw 实战AI 投研助手如何回答“为什么盘后大跌”“现在买贵了吗”5 个真实案例HoneClaw 实战AI 投研助手如何回答“为什么盘后大跌”“现在买贵了吗”5 个真实案例 当一只股票盘后急跌或者你在现在该不该买之间纠结时普通 A上一篇ATLauncher终极指南如何快速安装和管理Minecraft模组包下一篇JOAL高级使用技巧10个配置优化提升PT站点做种效率与积分获取创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考
觉得有用,分享给同行:

为您的企业打造数字门面

稳重轻奢商务风格,端正雅致视觉,长效耐看不易过时。

立即咨询 →