1. 项目定位与用途
zframes 是面向 AI 编码代理的免密钥个人市场终端生成框架，核心逻辑是 AI 代理读取预定义的 typed、validated frames 组件目录，生成符合规范的 dashboard.json 配置，运行时自动接入公开数据源渲染实时仪表盘。用户无需手动搭建项目、编写前端代码，最终产物为单一可 git 追踪的配置文件，无托管服务锁定，完全由用户自主掌控。
项目档案开源项目
zentryHQ/zframes 是什么？用途、安装与使用指南
zentryHQ/zframes：zframes 是 AI 驱动的个人市场终端生成框架，用户无需手动搭建项目、配置 API 密钥或编写前端代码，通过自然语言对话即可生成实时更新的本页整理它解决什么问题、适用场景、安装方式和使用方法。
AI 总结
zframes 是 AI 驱动的个人市场终端生成框架，用户无需手动搭建项目、配置 API 密钥或编写前端代码，通过自然语言对话即可生成实时更新的个性化市场仪表盘，产物为可 git 追踪的单一配置文件，无服务锁定。
中文项目介绍
zframes 是一个面向 AI 编码代理的免密钥个人市场终端生成框架，核心定位是让用户无需手动搭建 Node 项目、配置数据源 API 密钥或编写 React 前端代码，仅通过自然语言描述需求即可生成实时更新的个性化市场仪表盘。
它解决了传统搭建实时市场看板时的高门槛问题：用户无需处理多数据源的密钥管理、前端组件开发、服务部署与维护成本，同时避免了托管服务的锁定风险。
框架内置 29 个免密钥公开数据源，覆盖股票、加密货币、DeFi、衍生品及美国宏观经济数据，支持 Claude Code、Cursor、Gemini CLI 等主流 AI 编码代理，生成的仪表盘配置为单一可 git 追踪的 dashboard.json 文件，CLI 可直接本地启动服务渲染，适合个人投资者快速搭建行情看板、团队共享统一市场数据视图等场景。
详细信息与使用说明
2. 解决的问题
传统搭建实时市场仪表盘需要手动配置多数据源 API 密钥、编写前端组件、处理服务部署与维护，门槛高且成本大，同时多数托管服务存在数据与配置锁定问题。zframes 通过免密钥公开数据源、AI 代理自动生成配置、运行时自动渲染的模式，彻底消除了密钥管理、前端开发、服务维护的成本，同时保证用户对仪表盘配置的完全自主权。
3. 适用场景
适合个人投资者快速搭建个性化实时行情看板，如个股 K 线图、多资产行情线、资金费率、恐惧贪婪指数、美国宏观经济数据面板等；也适合团队共享可 git 追踪的仪表盘配置，统一市场数据视图；还可用于快速验证市场数据看板原型，无需投入前端开发资源。
4. 安装方式
zframes 以 skill 形式安装到支持开放 skills 标准的 AI 编码代理中，执行命令 npx skills add zentryhq/zframes 即可完成安装，该命令会自动将 skill 拉取到代理的技能目录（如 Claude Code 的 ~/.claude/skills/ 目录），无需手动克隆仓库或执行额外包安装步骤。
5. 使用方式
安装 skill 后，在 AI 编码代理中通过对应方式召唤 zframes skill，用自然语言描述目标仪表盘需求即可，例如输入“build me a TSLA + NVDA terminal with funding and fear-greed”。代理会自动完成读取 frames 组件目录、生成 dashboard.json 配置、配置校验、启动本地服务渲染并打开浏览器的全流程，用户全程无需手动操作配置文件或启动服务。
6. 补充说明与实现特点
项目采用 pnpm monorepo 架构管理多包，核心模块包括 AI 代理交互 skill、CLI 工具、运行时渲染引擎、explorer 展示应用；内置 29 个免密钥公开数据源，覆盖 Hyperliquid、Nasdaq、CoinGecko、DeFiLlama、U.S. Treasury 等；配置校验采用 per-frame 模式，无效配置会返回可读错误供代理自我修正，生成循环内置于渲染契约；CLI 提供 lint、serve、catalogue 等命令，explorer 应用支持仪表盘的展示、编辑与分享。
思维导图
zframes
核心定位
AI驱动市场终端生成
免密钥无API配置
单一配置文件无锁定
核心模块
zframes Skill（AI代理交互）
CLI工具
运行时渲染引擎
explorer展示应用
技术特性
pnpm monorepo架构
per-frame配置校验
agent自修正生成循环
TypeScript严格模式
使用流程
安装skill到AI代理
自然语言描述仪表盘需求
自动生成校验配置
本地渲染打开仪表盘
数据源能力
29个免密钥公开源
覆盖股票/加密/宏观/DeFi
无需.env配置
常见问题
zframes 需要配置 API 密钥吗？
不需要，zframes 内置 29 个免密钥公开数据源，包括 Hyperliquid、CoinGecko、SEC EDGAR、FRED 等，无需注册、无需配置 .env 文件即可获取实时市场数据。
支持哪些 AI 编码代理？
支持 Claude Code、Cursor、Gemini CLI、OpenAI Codex 等遵循开放 skills 标准的编码代理，安装 skill 后即可通过对话生成仪表盘，其中 Claude Code 为已做端到端测试的主支持代理。
生成的仪表盘配置如何管理？
生成的仪表盘配置为单一的 dashboard.json 文件，可直接纳入 git 版本控制，支持团队共享与版本回溯，无托管服务锁定，用户可完全自主掌控配置。
如何自定义调整仪表盘组件？
直接在 AI 代理中用自然语言描述调整需求即可，代理会自动读取预定义的 frames 组件目录、更新配置并完成校验，无需手动修改代码或配置文件。
zframes 的运行时如何启动？
安装 skill 的 AI 代理在生成校验通过的 dashboard.json 后，会自动启动本地运行时服务渲染仪表盘并在浏览器打开，也可通过 CLI 的 serve 命令手动启动本地服务。