数据工作室

🟢 适合入门。 数据工作室（Data Studio）只构建只读仪表盘。它不会下单、转账、连接钱包，也不会索要私钥。

数据工作室会把自然语言需求变成带实时或单次加载金融数据的 React 仪表盘。项目包含方案、源码、经过验证的构建；选择发布后，还会生成可分享的本地站点。

它适用于行情监控、自选列表、排行榜、财报表格、组合视图、热力图、K 线、风险视图、收益率曲线、订单簿深度等需要复用和交互的页面。

当前工作流程

1. 打开 数据工作室，描述想要的仪表盘，也可以附上参考图片。
2. 在输入框中选择 计划 或 自动。
3. Agent 会创建项目方案、解析数据与组件契约、编写源码，并执行确定性的构建和预览检查。
4. 在 预览、Code、方案、数据与统计 和 设置 中检查结果。继续聊天即可修改同一个项目。
5. 预览就绪后，可把某个固定版本发布到可自定义的本地链接。

这里的聊天使用与主 Chat 模块相同的工作日志和工具展示。执行成功后，仪表盘交付卡片会显示在 Agent 输出末尾。卡片可以打开预览，也提供项目根目录入口。

计划与自动模式

计划 会先生成完整方案。方案保存后，数据工作室会立即打开 方案 标签页。批准执行前，你可以查看方案、预览交付物并提出修改意见。批准后会开启一个新 Agent turn，并允许使用正常的数据工作室工具。

自动 会立即开始实现。Agent 仍会在项目中保存 plan.md，并执行相同的数据、组件、构建和预览检查。后续需求可以随时切换模式，计划模式不是永久默认值。

项目文件与版本

每个项目都存放在 Minara 的稳定 workspace 中，不依赖临时 Git worktree 或运行目录。项目会保留：

• 当前 plan.md；
• src/ 下的生成源码；
• 不可变的成功构建版本和最新预览产物。

会话中上传的文件使用独立的持久化恢复存储，因此进程重启后，图片与文件引用仍然可用。

通过 Code → 项目根目录 可以定位项目目录。只有组件契约、编译和必需运行时检查全部通过后，构建才会成为正式版本。失败的修改不会覆盖最后一个可用预览。

重新进入项目时默认打开 预览。如果重启后仍有源码但预览产物缺失，系统会在统一的预览 loading 状态下自动尝试构建一次。自动尝试失败后，空状态会提供 恢复 按钮。若项目只有方案还没有构建，预览空状态会引导打开 方案 标签页。

数据访问与刷新规则

生成代码通过数据工作室 SDK 请求白名单内的数据。Provider 凭证只保留在本地 gateway 或 publisher，不会写入生成源码。

数据工作室会根据用户需要选择数据通路：

• 用户要求实时数据时，优先使用能够覆盖全部必需字段、无需 Key 的已登记公共 WebSocket。
• 无 Key Public API 可以单次加载，也可以按数据源允许的间隔轮询。
• 使用你自己已配置 Key 的 API 可以单次加载或轮询。
• 如果支持转发的 Provider 缺少本地 Key，Minara 数据转发可以提供单次加载结果。设置 中会标记为 正在使用 Minara 数据转发。
• Minara 数据转发不允许轮询。需要轮询时必须使用 Public API 或自己的 Key。

HTTP 数据默认只在页面加载时请求一次。刷新频率较高时，数据工作室会显示刷新间隔和用量提示。刷新期间会保留已有的有效数据，只更新发生变化的图表与数值，不会重新挂载整张图或重复显示全屏 loading。

在 数据与统计 中可以查看调用次数、错误和延迟。在 设置 中可以确认每个数据源是公共数据、使用本地 Key、使用 Minara 转发，还是当前不可用。API Key 统一在 设置 → API Keys 管理。

金融 UI 与图表规则

生成的仪表盘使用固定的 @minara/studio primitives 和统一图表主题。写代码前，Agent 会读取当前组件 Schema 与 Types。生成后，自动契约审查会阻止未知 Prop、缺少必填字段、错误 import 和不支持的 JSX spread。

组件覆盖常见金融问题：

• MetricCard、SignedValue、SparklineChart 用于单点数值和小趋势；
• LineChart、AreaChart、KLineChart、MixedLineBarChart、PerformanceChart 用于时间序列、价量、净值和回撤；
• HorizontalBarChart、DataTable、AssetHeatmapChart、MatrixHeatmapChart、HistogramChart 用于排名、明细、市场热力图、相关性和分布；
• OrderBookDepthChart、VolumeProfileChart、YieldCurveChart、RangeBandChart、VolatilitySurfaceChart 用于专业金融视图。

PnL、change、return 等带方向的数值会同时显示正负号和金融涨跌色。数据变化时使用短暂颜色过渡，不闪动整张卡片。货币和其他度量值必须显示单位，热力图中的金额也必须带货币符号。颜色不会成为唯一的信息表达方式。

统一主题负责坐标轴、网格、Tooltip、Legend、字体、间距、涨跌色和动效。生成项目可以在全局 CSS 中覆盖公开的 --studio-chart-* 变量，无需逐个重写图表 option。每个完成的仪表盘都会检查桌面端和 390 px 移动端，并覆盖 loading、空数据、部分失败和刷新状态。

发布与分享

发布表单会根据项目生成一个短站点 ID，发布前可以修改。任何获得链接的人都能打开站点，无需登录。

以下两个选项默认开启，发布后仍可修改：

• 允许局域网访问 会把 publisher 绑定到局域网，并显示使用本机局域网 IP 和 publisher 端口的链接。
• Minara 关闭后保持访问 会让本地 publisher 继续运行，并在登录这台电脑时恢复已发布站点。

关闭局域网访问后，链接仅限本机。关闭后台访问后，站点依赖正在运行的 Minara 客户端。点击 取消发布 会撤销该项目的所有访问链接并停止站点服务。

发布站点托管在本机或局域网。允许局域网访问不会把站点暴露到公网，主机也必须保持开机并可访问。

安全边界

数据工作室只能请求白名单内的只读数据，并在自己的项目目录中写文件。它不能：

• 调用钱包、交易、swap、withdraw 或 order 工具；
• 连接 MetaMask、WalletConnect 或其他浏览器钱包；
• 在生成文件中写入 API Key 或其他 secret；
• 从预览页面请求任意第三方 URL；
• 在发布的仪表盘中加入交易或资金操作控件。

如需执行交易，请使用 Chat、Portfolio、Trading、Strategy Studio 或 Autopilot。这些模块会应用各自的预览与确认门禁。