核心优势功能

Orchidea Intel

上市企业分析

面向上市企业的分析服务：制造业价值投资评分、上下游图谱钻取、市场风向与大模型推荐。与 NSAA 为两个独立子项目，无代码依赖。

核心能力

  • 制造业价值投资评分：多维因子、评分追溯与证据链
  • 上下游图谱钻取与行业传导分析
  • 市场风向（全量 / 分页筛选）与市场分析
  • 明日 / 下周推荐、任务状态、历史与回测；推荐 vs 真实行情复盘（T+1/T+5）与纠错建议
  • 自选股与阈值预警、组合买卖建议报告
  • 真实数据源：新浪财经（行情 / K 线）+ 东方财富（财务 / 北向 / 两融 / 分红 / 公告 / 资讯）
  • 35 个 MCP 工具，接入 Orchidea Desktop 等客户端；权限含 intel:recommend:read / watchlist:read / reports:read
  • 缺失字段返回 null，前端以 — 展示；未配置大模型时 available:false，不伪造行情或推荐

技术优势

  • Express + TypeScript API（4600），React + Ant Design + ECharts Web（4180）
  • 本地 SQLite 报告库与磁盘缓存，支持保留策略
  • Docker Compose 部署，非 root 运行、内置 HEALTHCHECK 与 API Token
  • 与 NSAA 独立：无代码依赖，使用真实市场数据与统计 / LLM 推荐
应用场景 制造业上市公司研究与价值投资评分；产业链上下游钻取、传导分析与传导验证；自选股预警、推荐复盘与 AI 分析报告
分析流转 行情/财报 → 评分建模 → 图谱钻取 → 市场风向 → 推荐/报告
数据存储 本地缓存 · 报告库

Orchidea Intel

与 NSAA 是两个独立子项目：Intel 为 TypeScript 实现的上市企业分析服务，不依赖 NSAA 代码，也不作为 NSAA 的”产品化形态”。

上市企业分析服务：制造业价值投资评分 + 上下游图谱钻取 + 市场风向 + 大模型推荐。

  • 后端：Express + TypeScript（apps/api），默认 http://127.0.0.1:4600
  • 前端：React + Ant Design + ECharts（apps/web），开发端口 4180
  • MCP：mcp-server（35 个工具，供 Orchidea Desktop 等客户端调用）

快速开始

pnpm install

# 终端 1：API（4600）
pnpm dev:api

# 终端 2：Web（4180，/api 反向代理到 4600）
pnpm dev:web

生产模式（API 同端口托管 Web 构建产物）：

pnpm build
node apps/api/dist/index.js
# 打开 http://127.0.0.1:4600

常用脚本

命令说明
pnpm dev:api / pnpm dev:web开发模式
pnpm build构建 API 与 Web
pnpm typecheck全量类型检查
pnpm --filter @orchidea-intel/api testAPI 单元测试（vitest）
node mcp-server/smoke.jsMCP 工具契约冒烟（需 API 已启动）
scripts/healthcheck.sh部署后健康检查

环境变量

变量默认说明
PORT4600API 端口
INTEL_HOST127.0.0.1监听地址；容器内需设为 0.0.0.0
INTEL_WEB_DISTapps/web/distWeb 静态资源目录（存在 index.html 时启用托管）
INTEL_API_TOKEN空设置后 /api/* 需携带 X-API-Token 或 Authorization: Bearer（/api/health 豁免）
INTEL_ALLOWED_ORIGINS本地端口CORS 白名单，逗号分隔；* 表示放行全部
INTEL_RATE_LIMIT_PER_MIN240单 IP 每分钟 API 请求上限，0 关闭
INTEL_TRUST_PROXY空设为 1 / true 时信任反向代理的 X-Forwarded-For（仅部署在可信代理后启用）
INTEL_STORE_DIR~/.orchidea-intel/store行情/财报/推荐/报告等本地缓存根目录
INTEL_DB_PATH$INTEL_STORE_DIR/intel.dbSQLite 报告库路径（推荐报告 / 复盘 / 归因；需 Node 22+）
INTEL_CACHE_RETENTION_DAYS14磁盘行情缓存保留天数（保留任务按 mtime 清理）
INTEL_REC_RETENTION_DAYS / INTEL_REC_KEEP_MIN180 / 30推荐快照保留天数与最少保留期数
INTEL_ARCHIVE_RETENTION_DAYS540归档快照保留天数
PLATFORM_API_URL / PLATFORM_API_KEYhttp://localhost:3000 / 空平台存储接入地址与密钥（不可达时诚实降级）
PLATFORM_TIMEOUT_MS2500平台探测/请求超时；失败后 30s 负缓存，避免拖慢接口
INTEL_PROBE_TIMEOUT_MS1500向量库/图库/SPARQL 探测超时；结果缓存 60s
INTEL_LLM_BASE_URL / INTEL_LLM_API_KEY / INTEL_LLM_MODEL空大模型直连配置（亦可用 DASHSCOPE_API_KEY / DEEPSEEK_API_KEY / OPENAI_API_KEY 或 Ollama）
ORCHIDEA_INTEL_API_URLhttp://localhost:4600MCP server 代理的 API 地址
ORCHIDEA_INTEL_TIMEOUT_MS15000MCP 单次上游请求超时
ORCHIDEA_INTEL_LONG_TIMEOUT_MS180000MCP 长任务（推荐生成 / AI 分析）超时
INTEL_RECOMMEND_FULL_SCAN1推荐是否启用全市场逐批 LLM 预筛；0 回退到本地预筛前 48 只
INTEL_RECOMMEND_SCAN_BATCH60全市场扫描单批送入大模型的股票数（20–200）
INTEL_RECOMMEND_SCAN_TOP4每批最多入选数量（1–10）
INTEL_RECOMMEND_SCAN_CONCURRENCY4扫描并发批次数（1–8，避免上游限流）
INTEL_RECOMMEND_SHORTLIST24批次汇总后进入最终推理的精选池上限（5–200）

大模型（推荐 / AI 分析）通过 PUT /api/llm/config 或前端「大模型设置」配置，未配置时相关接口返回 available: false，不生成伪造行情或推荐。

数据来源（真实接口）

数据来源
实时行情 / K 线新浪财经
财务、北向、两融、分红、公告东方财富数据中心
资讯东方财富站内搜索
全市场目录东方财富股票列表（磁盘缓存 + 内置兜底）

缺失字段统一返回 null（而非 0），前端以 — 展示；数据时效见 /api/data-freshness 与顶栏时效条。

API 分组

  • /api/companies/*：企业列表、详情、评分追溯、行情、证据、公告
  • /api/market/*：市场风向（全量 / 分页筛选）、市场分析
  • /api/recommendations/*：明日推荐、下周推荐、任务状态、历史与回测
  • /api/recommendations/:mode/review：推荐 vs 真实行情复盘（T+1/T+5）、差异归因、纠错建议
  • /api/recommendations/:mode/reports：入库报告列表；/api/recommendations/reports/:id：单期报告与复盘
  • /api/news、/api/announcements：资讯与公告检索
  • /api/watchlist/*：自选股与阈值预警
  • /api/watchlist/advice：自选股明日/下周买卖建议（评分 + K 线 + 实时行情）
  • /api/watchlist/advice/report：自选股组合买卖建议分析报告（Markdown / HTML / JSON）
  • /api/reports/*：分析报告、Markdown / HTML 导出
  • /api/industry-chain/*、/api/conduction/*：行业链与传导
  • /api/data-feeds、/api/data-freshness：资料接入与数据时效
  • /api/maintenance/retention：推荐快照保留策略（GET 状态 / POST 执行，支持 dryRun）
  • /api/health、/api/metrics、/api/metrics/industry-chain：健康、请求指标与行业链覆盖审计
  • 前端「系统运维」页（/ops）：指标、行业链覆盖、调度器与锁状态、存储保留（支持 dryRun）、数据源采集方式

部署

Docker Compose（推荐）：

cp .env.example .env      # 至少设置 INTEL_API_TOKEN
docker compose up -d --build
# 默认宿主端口 4610（HOST_PORT 可覆盖），打开 http://127.0.0.1:4610

或直接使用镜像：

docker build -t orchidea-intel .
docker run -p 4600:4600 \
  -e INTEL_API_TOKEN=your-token \
  -v intel-data:/home/node/.orchidea-intel \
  orchidea-intel

镜像为多阶段构建：构建 Web + API 后仅保留运行产物，使用非 root 用户 node 运行，内置 HEALTHCHECK。

MCP 接入

mcp-server/lib/tools.js 定义 35 个工具（企业检索、评分、行业链、量化信号、推荐与历史、资讯公告、长期判定、科学库、股票搜索、分页行情、自选、报告、传导、数据时效、存储保留、AI 分析、运行指标等）。在 Orchidea Desktop 的 mcp-registry/registry.mcp-servers.json 中已注册 orchidea-intel，所需权限含 intel:recommend:read、intel:watchlist:read、intel:reports:read。

← 返回平台架构总览