手册概览

本手册面向负责部署和使用 TradingCopilot 的读者。你不需要先理解 Go 后端或 Vue 前端实现，但需要能运行 Docker、编辑环境变量，并理解外部 AI、Telegram、RSS/Atom 和行情服务可能带来的网络与凭据问题。

读者路径

读者	建议路径	完成标志
第一次部署	快速开始 → 首次初始化 → AI 模型配置 → 投研会议	能登录系统并完成一次会议
接入消息源	AI 模型配置 → 消息订阅 → 端到端工作流 → 日志与排障	消息能采集、过滤并按需触发会议
运行生产环境	Docker Compose → 生产部署 → 配置说明 → 安全与数据	服务可稳定重启，关键数据可恢复
研究模拟盘	行情与自选 → 模拟交易 → 唤醒计划 → 工作流	能从行情或消息触发研究并记录模拟交易
开发贡献	架构概览 → API 契约 → 测试矩阵 → 贡献指南	能提交带测试和文档的变更

核心概念

• 研究团队：会议、消息订阅、自选列表、唤醒计划和模拟交易账户的业务边界。
• AI 提供商：OpenAI 兼容模型服务，用于会议、过滤、复盘和结构化分析。
• 消息订阅：Telegram 或 RSS/Atom 来源，采集后进入异步过滤队列。
• 投研会议：多角色 AI 讨论过程，记录事件、工具调用、引用和结论。
• 唤醒计划：基于时间、行情或消息事件触发后续研究。
• 模拟交易：用于研究验证的账户、订单、成交、持仓和绩效记录。

系统全景

手册约定

• 命令默认使用 Bash；涉及 Windows 本地操作时补充 PowerShell。
• 生产环境默认通过 HTTPS 访问，不建议直接暴露未加密 HTTP。
• 所有投资相关输出只用于研究、测试和学习，不构成投资建议。
• 涉及真实密钥、session、数据库和日志的内容不应提交到公开仓库。