对话

右侧 Dock AI 助手（Ribbon AI 助手 切换显示）。前端是 DevExpress 官方 AIChatControl（Razor / Blazor WebView），包在共享面板 DarraChatPanel 里。Studio 启动时把上下文设成工业视觉（ChatContextKind.AiStudio），建议词是模型 / 训练 / 数据集，不是 PLC 助手，也不是 CAD 助手。

截图占位。拍好软件界面后替换 /img/guide/chat-placeholder.svg。

面板

官方头 ShowHeader=True：

• 未登录：头文案 未登录
• 已登录：头文案 剩余 xx USD（60 秒轮询）；取不到额度时 剩余 -- USD，不弹错

头上官方只有 Clear 刷子。历史、新建经 WebView 插在刷子前面（顺序：历史 · 新建 · 刷子），不叠自制工具条。

空状态标题「Darra AI 助手」，说明「选择下方建议，或直接输入问题开始对话。」下方建议动态生成：先看本会话最近几轮，再看已注册工具，都空则用 Studio 默认池（查看模型列表 / 解释当前训练参数 / 检查数据集 / 生成推理脚本 / 查看评估指标 / 列出训练任务）。

输入框回车发送（控件原生）。流式输出固定开。Markdown 渲染。可点纸夹上传文件，也支持拖入 / 粘贴；不做扩展名硬拦，失败走既有错误链路。

后端

流式请求打控制台 https://ai.darra.xyz/v1/messages（Anthropic 兼容 SSE）。密钥：DARRA_AI_API_KEY → 登录后账号桥取控制台 Key。门户 token 不当网关密钥。

身份：工业视觉助手。只用已注册的 Studio 工具做数据集、标注、训练、评估、导出与项目操作；没有的能力如实拒绝，不编造。工具集初始化失败则空工具装配，聊天主链路仍在，该拒就拒。

失败把 真错误（含 HTTP 状态）写进助手气泡，不抛未处理异常、不硬编码占位回复。空输入不产生助手气泡。

未登录时先到 设置 用 WebView2 登录，或点 Ribbon 登录。登录成功后面板刷新余额。

会话与历史

• 新建：当前会话留在历史（若已有消息），内存里开一份空白草稿
• 空白草稿：不落盘、不进历史浮窗；发出第一条消息并保存成功后才进历史
• 历史浮窗：只列已有消息的会话（标题 + 时间，当前项高亮）。点一条切换并回填消息
• Clear / 历史条 ×：删除该会话，不弹确认。删光后自动建一份空白草稿
• 落盘：%AppData%\DarraAI\chat-history\，每会话一文件，DPAPI（当前 Windows 用户）简单加密——防明文翻文件，不承诺防本机同用户进程。每会话最多 200 条，最多 50 个会话

相关：设置（账号、API 地址、测试连接）