v0.2.0+ · 2026-06-07 时间锚 · launchd cron 03:00 daily 在岗 · 337 tests

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

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

测试337 passed 公司种子33 家 4 主线×4 X 日抓357 推文 D V1 baseline60% 下次盘点2026-06-17
开始浏览 → 详细 14-commit 档案 ↗ 看 live demo ↗ README
0四问索引

你想知道什么?

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

01
Why · 目的

为谁做 · 想达到什么

两类用户、两个视角、四条主线。Satellite Agent 服务产业 CEO 与二级投资人,卫星互联网 4 主线深度覆盖。
跳到目标
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。
跳到已做
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 想知道:本周 4 主线里哪条信号最强、什么事件在推动、跟我的业务 thesis 是顺还是逆。
输出
主驱动 Top-N + 战略建议 4 条
尺度
7 / 14 / 30 天滚动周报
语法
5 步 + 5 色 emoji 锚
FE 增强
WYHTB 看牛/看熊 + 反方矛盾
I
视角 B · 二级仓位

投资人 位势 · 仓位信号

"哪条主线该加,哪家公司该减?" — 二级投资人想知道:33 家覆盖股里谁的 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)
2全貌 · 架构

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

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

agent/ · 代号 SatAgent
Satellite Agent (真实迭代中)
v0.2.0+ · 2026-Q1 起 · 337 tests / 0 回归
卫星互联网产业 × 双视角决策辅助。方法学先在垂类里跑通,再做 web 端横向产品化。
  • 主对象events / companies / threads / thesis_state / jobs
  • 用户产业 CEO + 二级投资人(同一份决策周报双视角)
  • 数据源RSS(SpaceNews 真闭环)/ X SQLite(3123 推文)/ 政策 / 公告
  • 报告双视角周报 · 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-06 已经跑通了什么

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

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
2
expert/ 整合
P0-C wiki 先验 + P0-D X SQLite
337
Tests Passed
159 → 287 → 330 → 337 · 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 条历史事件 ground truth · 4 字段 4 种 match_kind · Overall 60% baseline · CLI satagent validatevalidation.py · labeled_validation.jsonle14dfc0 / 65aa7f3
ADVICE D V2对比脚手架 · run_validation_compare + diff 三视角 + CLI --compare-llm + Stub demo(66.7%)· 真 LLM E2E 留 user 填 keyvalidation.py + cli.pyb57598b
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(+13);concepts → ontology +15 词;importer + 审计 JSON · timeline / people 留下下下轮scripts/import_wiki_*.py · seed.py · ontology.pya55745d / 83c56b6
P0-D X 源XSqliteSource read-only · since 增量 + 9 类账号白名单 + zh 译文拼接 · EH-1 x-ingest action · 13 单测sources/x_sqlite.py · jobs.py6902021
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
4当前状态

这一刻在做什么 · 卡在哪

2026-06-06 暂停点:cron 在岗自动跑,真 LLM key 待 operator 填,operator 观察 7 天数据增长曲线。这三件事是下次盘点的输入,任何新功能开工前都要先看完这一段。

RUNNING

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

launchd com.invesresearch.satagent-x-ingest 在岗,satagent job run x-ingest 拉取 since=上次 ts、limit=500 兜底。首跑 357 推文真入 events 表 / 25 命中 4 主线,无主线 332 条多为 HR / 招聘类噪音。
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

下一轮 选什么 开工

本轮 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 回写、APScheduler daemon — 5 个候选,排期开放
5下一步

路线图 · 近 / 中 / 远 三档

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

近期 · 2026-06 内

跑实 已布的局

本轮交付了脚手架与 cron,下一步是让它们出真数据。无新代码,主要是 operator 工作与小幅调优。
  • D V2 真 LLM E2E 跑通对比报告 satagent validate --compare-llm 前置:operator 填任一 provider key(.env.example 已就绪)
  • cron 7 天观察 · events 表增长曲线 + 命中率波动 + 重复/去重情况 现有 launchd 03:00 daily 自动跑,人工只需 tail x-ingest.log
  • strategy 启发式 V1.1+ · 反哺 D V1 暴露的"保守 / 多主线漏判" 本轮 V1.1 已把 23.3% → 56.7%,继续小迭代到 70%+
  • SpaceNews + decision-notify-feishu cron 已有 RSS 抓 + 飞书 action,需 operator 串一行 launchd plist
中期 · 下下轮

方法学 再深一层

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