v0.2.0+ · 2026-06-10 时间锚 · 续 16 P1 ✅ · launchd cron 03:00 daily 在岗 · 390 tests · 7 Source 全谱系 · events 855 · 主线命中率 20% → 68.8%

开发计划 全貌 · 一页看懂在做什么
已经做到哪一步、下一步往哪

这是 Satellite Agent 的总览门户:卫星互联网产业 CEO 主驱动 × 投资人仓位双视角决策辅助。回答四个问题:为谁做(目标)做成什么样(需求)已经做了哪些下一步做什么。详细工程档案在 next-steps.html / NEXT-STEPS.md;产品策略与边界在 PRODUCT-STRATEGY.md

测试376 passed 公司种子47 家 主线5 条 Source7 + wiki 种子 events 入库855 validation corpus96 条 规则版 baseline27% 下次盘点2026-06-17
开始浏览 → 详细 14-commit 档案 ↗ 看 live demo ↗ README
0四问索引

你想知道什么?

这四张卡分别对应"目标 / 全貌 / 已做 / 下一步"四个问题。每张点进去跳到对应章节;它们之间互相依赖,但按这个顺序读最顺。

01
Why · 目的

为谁做 · 想达到什么

两类用户、两个视角、五条主线。Satellite Agent 服务产业 CEO 与二级投资人,卫星互联网 5 主线(核心网 / 终端 / 芯片 / 运营支撑 / 运载发射)深度覆盖。
跳到目标
02
What · 全貌

架构是什么样的

仓库里两条产品线:agent ✅ 已跑、web ⏳ 纸面。共享方法学不共享 schema。当前只推 agent。
跳到全貌
03
Done · 已交付

已经做了哪些

Phase 1-3c 全链路 + 横切 8 件 + EH-1/3 调度 + Tier 1.2 LiteLLM + FE Round 1 + ADVICE 三件套 + expert/ 整合 + cron + 7 Source 全谱系(HarnessFarm / ShockEvents / InvestorManifest)+ sources.html 第 7 视角门户。
跳到已做
04
Next · 下一步

下一步做什么

近期:D V2 真 LLM E2E + cron 7 天观察。中期:Tier 2 Postgres + FE Round 2 + wiki/timeline 扩 corpus。远期:Tier 3 X→wiki 双向回写。
跳到下一步
1目标 · 需求

为谁做 · 想解决什么问题

Satellite Agent 不是"自动化研报",是给两类决策者节省判断成本的辅助工具。两个视角共用同一套事件 / 公司 / 主线数据,但组织叙事完全不同:CEO 关心"下一步该 all in 哪一块",投资人关心"这周该加减仓哪条主线"。

C
视角 A · 产业决策

CEO 主驱动 · 战略层

"我现在该不该 all in 终端业务?" — 卫星互联网公司的 CEO 想知道:本周 5 主线里哪条信号最强、什么事件在推动、跟我的业务 thesis 是顺还是逆。
输出
主驱动 Top-N + 战略建议 4 条
尺度
7 / 14 / 30 天滚动周报
语法
5 步 + 5 色 emoji 锚
FE 增强
WYHTB 看牛/看熊 + 反方矛盾
I
视角 B · 二级仓位

投资人 位势 · 仓位信号

"哪条主线该加,哪家公司该减?" — 二级投资人想知道:47 家覆盖股里(运营支撑 19 / 运载发射 14 / 芯片 6 / 核心网 4 / 终端 4)谁的 thesis 在改善、谁在恶化、debate 多空裁决怎么走、有没有 trigger 触发证伪信号。
输出
加仓 / 减仓 / 持有 信号清单
尺度
公司 × 主线两维矩阵
边车
Bull/Bear/Judge multiplier
证伪
trigger distance + alerts
核心网
CORE NETWORK
天地一体化 / 频段 / Direct-to-Cell · 4 家种子覆盖
终端
USER TERMINAL
天线 / 收发模组 / 手持终端 · 4 家种子覆盖
芯片
CHIPSETS
射频 / 基带 / FPGA / GNSS · 6 家(含 P0-C 新增星联芯通 / 艾可萨)
运营支撑
OPERATIONS
运营商 / 高精位置 / 应用 · 19 家(P0-C 大幅扩容 +11)
运载发射
LAUNCH VEHICLE
火箭 / 制造 / 商业发射 · 14 家(06-08 上线 · SpaceX / Blue Origin / Rocket Lab + 中国民营 6 家)
2全貌 · 架构

仓库里有两条产品线,当前只推一条

读者经常困惑"这是一个产品还是两个产品"——答案是两个,但同一方法学agent/ 是真实迭代的卫星垂类样本,web/ 是纸面工程的通用横向产品化。不并行—— agent 先跑实,web 三个触发条件之一满足才启动。

agent/ · 代号 SatAgent
Satellite Agent (真实迭代中)
v0.2.0+ · 2026-Q1 起 · 376 tests / 0 回归
卫星互联网产业 × 双视角决策辅助。方法学先在垂类里跑通,再做 web 端横向产品化。
  • 主对象events / companies / threads / thesis_state / jobs
  • 用户产业 CEO + 二级投资人(同一份决策周报双视角)
  • 数据源7 Source 全谱系 + wiki 种子层 · RSS(SpaceNews 真闭环)/ X SQLite(3123 推文)/ HarnessFarm jsonl / ShockEvents csv / InvestorManifest 3 schema 通杀 / 政策 / 公告
  • 报告双视角周报 · HTML / CSV / DOCX / PPTX 导出
  • 部署FastAPI + SQLite + Docker · launchd 03:00 daily
  • 前端agent/docs/live.html 单文件 5 色 layer demo
web/ · 代号 IRA
InvesResearch Agent (PRD 纸面)
v1.0 PRD · 2026-Q2 起 · 工程 0 行
A / HK / US 三地市场通用深度调研系统。触发条件之一满足才启动 M1 数据层。
  • 主对象Security / DailyBar / FinancialStatement / DCFResult / ResearchReport
  • 用户任何分析师 / PM(贵州茅台深度报告 / 商业航空行业研究)
  • 数据源Tushare / AKShare / yfinance / edgartools / SEC EDGAR
  • 报告Quick / Standard / Deep 三档结构化 PDF / DOCX
  • 里程碑M1 数据层 → M2 单 Agent → M3 多 Agent → M3.5 调度 → M4 检索 → M5 报告 → M6 多市场
  • 触发agent 4 条上线稳定 2 周 / 增员 ≥1 BE + 0.5 SRE / 商业 PoC 意向
3已交付

到 2026-06-09 已经跑通了什么

三个层次:核心链路(Phase 1-3c + 8 件横切)/ 方法学增强(FE Round 1 + ADVICE 三件套 + Tier 1.2 LiteLLM)/ 上游接入(EH-1 调度 + EH-3 飞书 + expert/ 整合 + X cron 在岗 + 7 Source 全谱系 · HarnessFarm jsonl / ShockEvents csv / InvestorManifest 通杀 5 manifest 入 events +334)。任何"再做一遍"的提议都要先在这里排除。

7
Core Phase
Phase 1 / 2 / 2.1 / 3a / 3b / 3c + 横切
4
FE Round 1
C / A V1 / B / A v2 + live.html 5 色
3
ADVICE 三件套
D V1 / B skill / E 专题 demo
8
Source 全谱系
RSS / X / JSONL / Text / HarnessFarm / ShockEvents / InvestorManifest / WikiTimeline + wiki 种子层 · 入 events 855(本环境 real-run.db 658)
376
Tests Passed
159 → 287 → 330 → 337 → 376 · 0 回归
类别已交付主要模块 / 文件交付锚
Phase 1rules-based 输入侧 · 周报 · 30 条合成集 100% / 25 条真实集 64%classifier.py · ontology.py · report.py · regress.py远端 sync
Phase 2Source 抽象 · JSONL / Text / RSS · 中文金额提取 · 抓取管线sources/{base,jsonl,text,rss}.py · extract.py远端 sync
Phase 2.1LLM 兜底 · OpenAI / Claude 兼容 · 触发门 conf<0.55 或 ≥3 threadllm.py213eff3
Phase 3a双视角决策周报 · CEO 主驱动+战略 / 投资位势+仓位信号decision.py远端 sync
Phase 3bPE 估值映射(透明可覆盖)+ 市场模型动态视图valuation.py · market_model.py6575be7
Phase 3cHTML / CSV 零依赖导出 · DOCX / PPTX 可选 extraexport.py远端 sync
横切 ×8thesis 实时评分 + 风险预警 · Prometheus / metrics · Bearer · Docker · CI · debate skeleton · CORS · 演示前端 live.htmlthesis.py · observability.py · api.py · debate.py · live.htmla39d5a1 等
EH-1 调度jobs / job_runs schema + ACTIONS registry + satagent job CLI(cron / systemd 单次驱动)+ token budgetjobs.py · db.py · cli.py335db95
EH-3 飞书decision-notify-feishu action · 卡片含 hard-coded 免责声明 · 重试 + 优雅降级notify.py2026-06-03
Tier 1.2LiteLLM 路由 · 单 LiteLLMClient 统一 zhipu / DeepSeek / Qwen / OpenAI / Anthropic 5 家 · last_usage token 计量llm.py5573b79
FE CRed Flag 自查 · 11 条 universal_red_flags 注册 / 5 实施 / 6 stubquality_checks.py9566bda
FE A V1证伪触发器 · thesis_state.triggers + 3 内置 check + 24h cooldown + CLI triggertriggers.py906478e
FE B5 步语法第 3+5 步 · _compute_contradiction 4 级 + _compute_falsification + 5 层 emojidecision.py · triggers.pyb55d474
FE A v2WYHTB 看牛/看熊 · thesis_state.wyhtb_bull/bear + set_wyhtb_conditions + CLI wyhtbthesis.py · decision.pye239e44
live 5 色4 个新 panel section(WYHTB / 反方矛盾 / 如何崩塌 / Quality)+ 5 色 layer 渲染agent/docs/live.html8580b54
ADVICE D V1验证回路 · 10 → 30 → 96 条历史事件 ground truth · 4 字段 4 种 match_kind · v2.0 corpus 规则版 baseline 27%(暴露盲点)· CLI satagent validatevalidation.py · labeled_validation.jsonle14dfc0 / 65aa7f3 / 2c2f631
ADVICE D V2 4 rounds续 18 P3.3-P3.6 同 96 corpus 4 轮收敛: R1 Kimi K2 override -7.3pp ⚠ → R2 union 路线 1 +2.0pp → R3 路线 2+3 (max_threads 3→4 + prompt 加运载发射 few-shot) +8.3pp → R4 智谱 GLM-4.6 + drop_params +13.5pp 🏆 (rules 29.2% → +LLM 42.7%, thesis +24 / strategy +19.8 / fixed 16);累计 20.8pp 净改善 → reports/d-v2-rounds-1-to-4-summary-2026-06-10.mdvalidation.py + llm.pyb57598b → 18-P3.6
ADVICE B5 个 skill 文档 · 总览 + thesis_impact + strategy_5_levels + wyhtb + trigger ~780 行agent/skills/*.md2f852b5
ADVICE E运营支撑专题纵切片 demo · ?focus=主线 URL + 视觉过滤 + scenario-operations.mdagent/samples/scenario_operations_focus.jsonl · live.html2fbe5c0
P0-C wikiexpert/wiki/entities → SEED_COMPANIES 20 → 33 → 47(+13 +14);concepts → ontology +15 +103 词;timeline → labeled_validation 10→96 · 3/4 子项已交付;people NER 留 P3 长尾scripts/import_wiki_*.py · extract_timeline_candidates.py · seed.py · ontology.pya55745d / 83c56b6 / 4bdc4a8 / 2c2f631
第 5 主线06-08 LAUNCH_VEHICLE 上线:Thread enum 加运载发射 · 103 关键词(中/欧/美型号 + 通用动作词)· SEED_COMPANIES +14 家(SpaceX / Blue Origin / Rocket Lab / Firefly / Relativity / Stoke / ULA / ArianeGroup + 中国民营 6 家)· 4 测试硬编码改 enum-driven · 4 dual-thread labeled_real 修标ontology.py · seed.py · thesis.py · labeled_real.jsonl4bdc4a8
cron 闭环06-08 巡检发现 cron 假活:06-07/06-08 都 exit=0 但 ingested=0 · 修上游 twikit UserTweetsAndReplies 404 兜底 · 加 run_x_scrape.sh operator wrapper · runbook 显式 1-2 天手动跑节奏 · 闭环实测 events 357→376(+19)新 SpaceX 推文expert/X/x_agent/scraper.py · run_x_scrape.sh · x-ingest-cron-runbook.md908332a
P0-D X 源XSqliteSource read-only · since 增量 + 9 类账号白名单 + zh 译文拼接 · EH-1 x-ingest action · 13 单测 · 06-09 ISO 日期修(原 since 参数被 sqlite 当字符串比较少召回)sources/x_sqlite.py · jobs.py6902021 / 续 13
HarnessFarm 源第 5 个 Source · jsonl 双入口(CLI + jobs)· 灌入 satellite-agent 205 source-backed corpus · A 路 events 376→501 (+125 全 5 主线) · B 路跨产线 ADVICE baseline · 续 7sources/harness_farm.py · scripts/import_harnessfarm.pya4d57db
ShockEvents 源第 6 个 Source · csv · 加载 NASA / 政策冲击事件列表 · 续 8sources/shock_events.pydf917e0
InvestorManifest 源第 7 个 Source · 3 schema 通杀 5 manifest · 入 events +334(events 521→855)· 通杀 InvesResearch own / Bain 一级回报 / Bloomberg 二级建仓 3 套 schema · CLI + jobs 双入口 · 续 14sources/investor_manifest.py44a63a6
sources.html 门户第 7 视角门户 · 7 Source 全谱系一页看懂 + wiki 种子层 · 配套 vendor 4 工具 + 2 数据(续 11/12)+ P0 X-SQLite ISO 日期修(续 13)+ Source 7 验收(续 14)sources.html · vendor/*续 11~14
launchd cronmacOS launchd com.invesresearch.satagent-x-ingest · 03:00 daily · 首跑 357 推文入 events / 25 命中主线 · 运维 runbookx-ingest-cron-runbook.md · plist3491f45
wiki round-2expert/raw/ 67 新增(60 docx 科普视频 + 7 PDF)→ entities 248→424 / concepts 231→391 / reports 35→102 / timeline 483→931 · 4 路 sub-agent 并行抽 · 7 个脚本路径修(_paths.py)+ extract.py 增量模式expert/wiki/* · _scripts/_paths.py2026-06-07
skill 沉淀项目根新建 skills/expert-wiki-ingest/(SKILL.md + skill.html + README)· process skillagent/skills/(know-how)分层 · 5 phase 流程图 + sub-agent 提示词模板 + 5 个踩坑可复用skills/expert-wiki-ingest/2026-06-07
L1 WikiTimeline 源第 8 个 Source · WikiTimelineSource ✅ · expert/wiki/timeline/all.md 大事年表 725 bullet → 入 events +487(本环境 real-run.db 合计 658)· skip_planned / skip_future 双闸只入已发生事实 · 行级 sha1 判重复跑 0 重复 · 主线命中率 43.5%sources/wiki_timeline.py2026-06-10 · 90f582d
L2 词典反哺wiki 词典反哺 L2 ✅ · SEED_COMPANIES 62 → 76(+14 境外:Lockheed / Northrop / Kuiper / Maxar / ICEYE 等)· ontology THREAD_KEYWORDS 340 → 360(+21 新词 -1 存量重复修复:ISL / 相控阵 / Ka-band / rad-hard / SDA 等)· tests 486 passedseed.py · ontology.py2026-06-10 · 47ee2aa
L3 cross_check MVPwiki entities 第二评委 ✅ · satagent cross-check 对账 events 库 → company_country 维 41 条不一致 + company_recall 维 274 条召回缺口 · 只读 entities/ 不读 timeline/ 防同源循环 · 报告 agent/reports/cross-check-2026-06-10.mdcross_check.py · wiki_reader.py2026-06-10 · 387999d
4当前状态

这一刻在做什么 · 卡在哪

2026-06-10 暂停点:7 Source 全谱系完工(HarnessFarm jsonl / ShockEvents csv / InvestorManifest 3 schema 通杀 5 manifest 入 events +334),cron 闭环已验证 + scrape wrapper 在岗,validation corpus 96 条暴露规则版盲点(27%),真 LLM key 待 operator 填后跑 D V2 看能否推回 50%+续 16 P1 扩 SEED 完工 — 主线命中率 20% → 68.8%(InvestorManifest 0%→100%),下一轮主驱 D V2 真 LLM + 路线 B LLM 抽取。

RUNNING

X cron · 每日 03:00 自动入流

launchd com.invesresearch.satagent-x-ingest 在岗,satagent job run x-ingest 拉取 since=上次 ts、limit=500 兜底。首跑 357 推文真入 events 表 / 25 命中 5 主线;06-08 闭环修:上游 X scraper 没人手动跑导致 cron 重读 stale 数据 → 加 run_x_scrape.sh wrapper + runbook 显式说明 operator 1-2 天跑一次。
WAITING FOR KEY

D V2 真 LLM 对比报告

D V2 脚手架已就位(run_validation_compare + diff 三视角 + Stub demo 66.7%)。用户填任一 provider key 即可一键跑:.env 已扩 5 provider preset(zhipu / DeepSeek / Qwen / OpenAI / Anthropic)。token budget 已实施,jobs.token_budget_monthly 列 + _collect_llm_usage hook 兜底成本。
OPEN DECISION

下一轮 选什么 开工

扩 SEED 加美国公司(让 InvestorManifest 334 events 命中主线)、路线 B LLM 抽取(把 manifest 表格自由文本变结构化)、VOYG customer time fallback、P0-C 余 2 子项(timeline 反推 corpus 30→100 + people NER)、FE Round 2 三件套(D segments / E 3 层叙事 / F Ledger)、Tier 2 Postgres、Tier 3 X→wiki 回写 — 7 个候选,排期开放
5下一步

路线图 · 近 / 中 / 远 三档

三档不是时间表,是触发顺序:近期项依赖"cron 数据跑出曲线"+"D V2 真 LLM 报告产出";中期项依赖"近期至少一条上线";远期项依赖"web 端启动触发条件之一满足"。

近期 · 2026-06 内

跑实 已布的局

本轮交付 7 Source 全谱系 + cron,2026-06-10 续 16 P1 扩 SEED 已完成 — 主线命中率 20% → 68.8%。剩 D V2 真 LLM + VOYG fallback + cron 观察。P0 X-SQLite ISO 日期修已完(续 13)· P1 扩 SEED 已完(续 16)
  • 扩 SEED 加美国公司 · 让 InvestorManifest 334 events 命中主线 ✅ 续 16 已完:加 13 家境外卫星公司 (MDA / VOYG / CRS / Iridium / Viasat / SES …)+ ontology 25 英文词 + alias-fallback + DB sync 20→60 + 446 reclassify · InvestorManifest 0%→100% / 整体 20%→68.8%
  • D V2 真 LLM E2E 跑通对比报告 satagent validate --compare-llm ✅ 续 18 P3.3-P3.6 4 轮完成 (总 ~4小时 wall);R1 -7.3pp ⚠ → R2 +2.0 → R3 +8.3 → R4 智谱 +13.5pp 🏆 (rules 29.2%→+LLM 42.7%);累计 20.8pp 净改善 / fixed 16 / hybrid 4 维设计沉淀
  • 路线 B LLM 抽取 · 把 InvestorManifest 自由文本 → 结构化 amount/company/thread 规则版只抓表头硬字段,自由文本里的 follow-on / partial-exit 全漏
  • VOYG customer time fallback · X 推文无 publish_ts 时回填 customer time 部分 source 无 created_at,落 events 时 ts=NULL,导致按窗口聚合漏召
  • cron 7 天观察 · events 表增长曲线 + 命中率波动 + 重复/去重情况 现有 launchd 03:00 daily 自动跑,人工只需 tail x-ingest.log
中期 · 下下轮

方法学 再深一层

D V2 出报告后启动。FE Round 2 三件套 + P0-C 余 2 子项 + Tier 2 Postgres 三选一或并行,看 D V2 的诊断结果。
  • FE Round 2 · D segments 公司分部维度 + E 3 层叙事 / 敏感度数学传导 + F 数据来源 Ledger 详见 FE-SKILLS-INTEGRATION.md §4 · 与 P1 公司卡片扩 30 合并改 schema 避二次迁移
  • P0-C 余 2 子项 · wiki/timeline → samples 扩 30→100+ · wiki/people → NER 词表 timeline 需 LLM 辅助打 ground truth,等 D V2 真 LLM key 跑通后启动
  • Tier 2 Postgres + Timescale 迁移 + Redis 限流 + Langfuse 自托管 + APScheduler daemon 为 web M1 数据层先验,把 12 周工程风险提前在 agent 端吃掉
  • EH-1 follow-up · REST 端点(POST /jobs/{name}/run-now)+ APScheduler 进程内调度 CLI 已全完,REST 是另一种 operator 入口
远期 · 下下下轮+

横向 泛化

agent 端方法学验证完整后,启动 web 端工程化或多市场延伸。需团队增员或商业触发
  • Tier 3 · X → wiki 双向回写 · 把 X 每日推文回写到 wiki/entities/<slug>.md 的 "## X 动态" 段;新账号落 _drafts/x_new_entities/ 人审 5-7 天工期,使 knowledge base 自更新
  • agent 多市场延伸 · 低空经济 / 储能 / 人形机器人 — 关键是 ontology.py 领域无关化 框架本身可复用,需重做 ontology 桶
  • web 端 M1 启动 · 触发条件之一满足 — agent 4 条上线稳定 2 周 / 增员 ≥1 BE+0.5 SRE / 商业 PoC 意向 Tier 2-3 对齐完成后,启动成本会大幅降低
  • eval 数据集扩展 50→100 条 · 与 web M6 验收对齐 · 与 wiki/timeline 反推协同 一次补齐 D V3 时序数据 + web 验收基线

技术栈对齐路径 · Tier 1 / 2 / 3

不是机械统一,而是把"web 将要用的栈"先在 agent 端用真实数据跑一遍。等 web 启动 M1 时,工程风险已大半被吃掉。详见 PRODUCT-STRATEGY §6

ITier 1 · 几乎免费 大部分 ✅

Pydantic v2 + LiteLLM + design tokens

LiteLLM 路由 5573b79 已交付 · Pydantic 补齐与 design tokens 对齐留作小幅 follow-up。
IITier 2 · 中成本高 ROI 下下轮

Postgres + Timescale + Redis + Langfuse + APScheduler

SQLite → PG 迁移 + 限流令牌桶 + 可观测性升级 + 进程内调度。与 EH-1 / EH-3 同期
IIITier 3 · 大改造 下下下轮

LangGraph + FastMCP + pgvector

debate → StateGraph + Postgres checkpointer · CLI → MCP server · 事件 / 公司语义检索。对应 web M2-M4