Quiet personal research cockpit for A-shares, Hong Kong stocks, US stocks, funds, and after-hours portfolio review. 轻量个人投研驾驶舱。
young-stock-cli 把 A 股、港股、美股的盘后查看、持仓复盘、证据驱动深度分析和本地报告导出收进一个小而完整的终端工作流。
uv tool install young-stock-cli
young init
young daily --format summary
young stock 600519 --llm --lens buffett
young reportUse it when you want a personal terminal workflow for watchlists, reports, local investment memory, PDF export, and Feishu/Lark delivery.
- One CLI covers market snapshots, single-symbol evidence, watchlist reports, local profiles, PDF export, and sending.
- Deterministic by default: LLM analysis only runs when you pass
--llm. - Built for real after-hours routines: cache, profile memory, dry-run delivery, and source diagnostics.
- Designed to be useful as a CLI and as an AI-agent tool.
- Use
young-stock-clifor a polished personal investing cockpit. - Use
stock-analysisfor the lower-level evidence engine and global market recap framework. - See
awesome-ai-agent-research-toolsfor related AI-agent research tools.
它的定位很直接：
- 输出的是“态度 + 证据 + 持仓相关建议”。
- 默认走 HTTP-only 公共数据路径。
- 浏览器兜底只在显式开关下启用。
young daily的默认模式不需要 LLM。young stock <symbol>默认确定性数据源；young stock <symbol> --llm才深度复盘；只有显式--lens才会进入 lens。young fund <code>使用基金数据源；young fund <code> --llm会继承 stock 的完整分析链路。young daily默认确定性数据源；young daily --llm才深度复盘；只有显式--lens才会进入 lens。- young 是投研复盘工具：不会自动交易，不连接券商，也不会执行真实订单。
- 缺失的数据保持缺失，不把空值硬写成零。
Requires Python 3.9+.
uv tool install young-stock-cli
young init
young profile add-stock 600519 --buy-date 2026-01-15 --quantity 100
young profile add-fund 161725 --buy-date 2026-01-10 --quantity 1000
young daily --format summary
young daily --llm --lens all --debate-rounds 3
young report
young send --dry-run
young send --yes如果你使用 Kimi Coding Plan、火山方舟 Ark 等 OpenAI-compatible 供应商，先配置 API key，再用 young config models --list 查询当前账号真正可用于 daily --llm / stock --llm / fund --llm 的 chat 模型；列表会过滤目录里有但不可调用的模型。
如果你用的是普通 Python 环境：
python3 -m pip install --upgrade young-stock-cli
young inityoung daily默认是确定性的 watchlist 日报，不依赖模型。young daily --llm和young stock <symbol> --llm才会进入证据驱动深度复盘。- 兼容口径：young stock 默认确定性数据源；young daily 默认确定性数据源。
young report只负责把最新已保存 Markdown 导出成 PDF，不会主动再跑一遍 LLM。young send --dry-run只预览将要发送的 Markdown/PDF 与渠道。young send --yes才会真的发送最新 Markdown 和摘要；同名 PDF 存在时才会附带。young config show会遮蔽密钥。young profile add-stock会基于 quote 自动生成可解释标签（market / asset_type / category / evidence），不是主观评分。- 需要浏览器时必须显式传
--browser-fallback。 - 需要更慢、更宽的补充源时必须显式传
--rich-source。
| Scope | Commands | Notes |
|---|---|---|
| Market snapshots | young a, young hk, young us, young global, young indices, young zt-pool, young flow |
--refresh bypasses cache; --browser-fallback is explicit. |
| Single-symbol evidence | young stock <symbol>, young stock <symbol> --llm, young lhb <symbol>, young fund <code>, young fund <code> --llm, young news 3690.HK |
Plain stock and fund are deterministic evidence views; add --llm for deep replay. --no-news skips news/social/event lookups where supported. |
| Watchlist reports | young daily --format summary, young daily --format key-points, young daily --format full, young daily --llm, young daily --llm --lens ... |
Plain daily is deterministic; --llm is the only deep replay entry, and --lens only applies when you explicitly ask for it. |
| Deep analysis | young stock <symbol> --llm, young stock <symbol> --llm --lens ..., young fund <code> --llm, young fund <code> --llm --lens ... |
stock --llm and fund --llm share the asset analysis pipeline; --lens only applies when explicitly provided. |
| Export & delivery | young report, young send --dry-run, young send --yes |
report exports PDF only; send previews by default and only sends with explicit --yes. |
| Local state | young profile ..., young portfolio ..., young memory ..., young style ... |
Profiles drive reports; portfolio is a lightweight local sandbox; memory is chat memory. |
| Config & support | young config ..., young diagnose, young init, young guide, young example, young cache-clear, young update, young uninstall, young chat |
young update/uninstall mirror the installation path you chose. |
young is intentionally narrow and opinionated.
- It is a personal research cockpit, not a评分 machine.
- It prefers evidence first, then a clear attitude, then action triggers tied to your holdings.
- It is HTTP-first by default.
- It keeps browser use and slower external sources behind explicit opt-in flags.
- It treats missing evidence as missing evidence.
The default data path is built around public no-login sources. In practice, young prefers the stable HTTP path first and only widens the net when you ask for it.
- Primary path: stable HTTP sources for A/HK/US market snapshots, quotes, news, flow, and board data.
- Optional rich path:
--rich-sourceunlocks slower supplemental sources for extra financial, social, and event evidence. - Browser path:
--browser-fallbackenables the explicit browser fallback for capabilities that support it. - Safety rule: if a source is weak or missing, young prefers cached or shorter verified output over guessing.
young diagnose shows recent source health and readiness so you can see which path is currently safe to lean on.
young stock <symbol>prints quote data plus optional news and evidence extras.- The extras layer can include:
- 龙虎榜 / LHB
- 五年财务趋势
- 社交热度
- 公告与事件
- 技术指标 fallback
young lhb <symbol>is the standalone LHB view.young fund <code>shows fund estimate, top holdings quotes, and holding-stock news.young fund <code> --llmenters the same LLM, lens, investment committee, review gate, and final advice path asyoung stock <symbol> --llm; only the evidence builder and fund language differ.- Examples:
young fund 161725 --llmyoung fund 161725 --llm --lens allyoung fund 161725 --llm --lens buffett- in chat:
/fund 161725 --llm --lens all
young flowcan show whole-market flow, northbound flow, or a single-stock daily flow.young news 3690.HKis the focused news-only view.
balanced 是默认风格。下面这些 lens 共享同一套 young style / /style 注册表，也会同步到聊天口吻与分析框架。
| Lens | Lean |
|---|---|
buffett |
质量、护城河、资本配置、安全边际 |
munger |
多元思维、反向思考、激励与错配 |
graham |
资产负债表、稳定性、下行保护 |
klarman |
复杂性折价、催化剂、永久损失控制 |
lynch |
可理解的增长故事、盈利兑现 |
o_neil |
盈利加速、龙头、量价确认 |
wood |
颠覆式创新、长期渗透率 |
dalio |
宏观周期、分散化、风险平衡 |
soros |
反身性、预期差、政策拐点 |
livermore |
顺势、关键点、严格止损 |
minervini |
趋势模板、强势股、波动收缩 |
simons |
可检验信号、样本外稳健性、交易成本 |
duan_yongping |
商业模式、文化、本分、长期现金创造 |
zhang_kun |
高质量商业模式、长期自由现金流 |
feng_liu |
市场认知、赔率、困境反转、边际变化 |
young style list、young style show、young style set <name>、young style clear 和 chat 里的 /style ... 是同一套风格入口。
Method cards are structural lenses, not scores. They exist to help daily --llm and stock --llm keep the same decision discipline.
- Valuation:
DCF-lite,Reverse DCF,Comps,LBO-lite,3-statement-lite,SOTP-lite - Research:
财报解读,业绩前瞻,催化剂日历,投资逻辑追踪,行业综述,新闻情绪归因,持仓风险复盘 - Decision:
IC Memo,Due Diligence checklist,Porter Five Forces,Unit Economics,VCP,Rebalancing Review
young daily --llm、young stock <symbol> --llm 和 young fund <code> --llm 共享同一套证据驱动的报告纪律。
| Module | Question it answers |
|---|---|
| M1 大盘指数与市场广度 | 市场整体是偏强、偏弱，还是分化？ |
| M2 板块强弱与资金流 | 钱在流向哪里，哪些板块更强？ |
| M3 赚钱效应与涨停结构 | 市场的正反馈是否成立？ |
| M4 下跌风险与炸板结构 | 风险释放是否在扩大？ |
| M5 持仓与市场风格 | 当前风格是否支持你的持仓？ |
| M6 抗跌方向 | 哪些方向更稳，哪些更适合观察？ |
| M7 机构化综合判断 | 仅在 --lens all 时形成研究委员会综合判断 |
young 借鉴多角色投研思想，增强自身投资委员会最终建议，但仍保持 young 的 M1-M7 和资产分析报告结构，不提供“TradingAgents 模式”，也不新增 agent 参数。
- 数据分析层强化 M1-M6、个股前半部分证据分析、基金证据分析。
- 研究委员会通过
--lens all形成 M7 判断；只输出压缩后的共识、分歧、看多证据、看空证据和待验证问题，不输出逐轮辩论。 - 单个专家视角（例如
--lens buffett）不触发辩论，也不输出 M7；daily / stock / fund 都会按该专家框架给出态度、持仓建议和风险提示。 - 交易计划角色只生成条件化交易计划草案。
- 风险管理角色补充风险约束和证据缺口。
- 组合经理角色整合最终态度和具体意见。
--lens all 的最后一章“综合持仓建议与风险提示”会包含：最终态度、交易计划草案、风险管理意见、组合经理最终意见、下一交易日观察清单。单 lens 时最后一章沿用对应专家视角标题，例如“巴菲特持仓建议与风险提示”，只需要给出该专家框架下的态度、持仓建议和风险提示。所有动作都是条件化触发器；证据不足时会写“维持观察，不生成新增动作”或“证据不足，暂不提高风险暴露”。young 不会自动交易，不连接券商，不执行买入、卖出、申购、赎回、调仓、止损或对冲。
这些命令是本地状态层，和市场查询分开。
profile 负责给 daily 提供你的真实关注列表。
对 stock 来说，保存时会自动写入最小自动分类：
market：如 A股 / 港股 / 美股asset_type：如 股票 / ETF / 指数category：只写证据标签，例如 消费 / 金融 / 科技 / 周期 / 医药 / 公用事业 / 创业板 / 科创板 / 北交所 / 主题ETF / 指数ETF；证据不足才给待观察evidence：仅保留当前 quote 可解释证据；若检测到可选 research bridge，只提示“深度分析可补充”，不会在 add-stock 阶段主动搜索
young profile add-stock 600519 --buy-date 2026-01-15 --quantity 100
young profile add-fund 161725 --buy-date 2026-01-10 --quantity 1000
young profile list
young profile remove-stock 600519
young profile remove-fund 161725
young profile clear
young profile clear-stocks
young profile clear-fundsportfolio 是更轻量的本地实验区，适合临时组合草稿，不会替代 profile。
young portfolio create core
young portfolio add core 600519 100
young portfolio show core
young portfolio compare 600519 000858young memory show|list|clear|reset管理 chat 长期记忆。young diary save <date> --text ...和young diary show <date>保存/查看日记式快照。
young config models 是唯一正式的模型配置入口。
它会保存：
- provider
- model
- api key 或
api-key-env - api base
- timeout
- max tokens
- fallback models
支持的 provider 包括 openai、ark、kimi、moonshot、deepseek、qwen、ollama、anthropic。
保存或更新模型配置时必须指定 --model；不带 --model 时只允许用 --list 查询模型 ID，不会写入配置。
--list 面向 young daily --llm / young stock --llm / young fund --llm 这类 chat 工作流，会过滤 Ark 等服务返回的 status=Shutdown 目录项以及纯 embedding、图片、视频生成等非文本生成模型，并对候选模型做一次最小 chat/completions 探测；因此它比单纯查询 /models 慢，但只展示当前实际可调用的模型。失败时你仍然可以直接填写 custom model id。
export OPENAI_API_KEY="..."
young config models --provider openai --model gpt-4.1 --api-key-env OPENAI_API_KEY
young config models --provider ark --api-base https://ark.cn-beijing.volces.com/api/coding/v3 --api-key-env ARK_API_KEY --model <model-id>
young config models --provider ollama --model llama3.1 --api-base http://localhost:11434/v1
young config models --list
young config show
young config path查询模型列表前需要先配置好可用 API key，或在本次命令里传入 --api-key-env / --api-key。也可以直接用通用 OpenAI-compatible curl 核对 endpoint：
curl -sS "$API_BASE/models" \
-H "Authorization: Bearer $MODEL_API_KEY" |
python3 -c 'import json,sys; print("\n".join(x["id"] for x in json.load(sys.stdin).get("data", [])))'Kimi Coding Plan (https://api.kimi.com/coding/v1, kimi-for-coding) 主要面向 Coding Agents；如果你的 endpoint 只暴露 coding 任务接口，就不要拿它去跑 young daily --llm、young chat、young stock --llm 这类投研/问答工作流。young 更适合接 OpenAI-compatible 的通用 chat/completions endpoint。
如果你要复制多行命令，记得反斜杠必须是行尾最后一个字符，后面不能有空格。最稳妥的写法还是直接用单行命令。
同一个 endpoint 需要回退模型时，可以用 young config models ... --fallback-model X --fallback-model Y 这样配置。只在限流、额度、瞬时服务错误或明确模型不可用时切换；认证、generic404、api_base 错误不切换。Ark 先用 --list 核对 model ID，即 young config models --provider ark --list，再填 --model 和 --fallback-model；--list 会过滤到 chat 可调用范围，不要直接使用 raw /models 里 status=Shutdown 的模型目录项。
Migration notes:
young init会补齐本地默认配置结构。young config show会遮蔽密钥。young config show和young config channel list默认输出 human-readable bullets，而不是直接 JSON。chat.style和chat.analysis_framework会同步成同一个值。- 旧配置里如果已经有
api-key-env，运行时会尽量把已解析的密钥回填到本地配置，减少重复输入。
young config channel add|list|remove 管理通知渠道，young send 使用这些配置发报告。Feishu 支持 webhook 模式和 app 模式。
young chat 启动后会先显示一个 Rich 欢迎框，包含 young 品牌、当前 style、常用命令、安全边界，以及研究工作流：
Evidence Pack → Lens Research → Trading Plan Draft → Risk Review → Portfolio Final Opinion
这只是研究报告生成流程，不会自动交易、不连接券商，也不会执行真实订单。chat 输入提示符是干净的 >；输出通过统一 Rich renderer 展示，模型回复不额外添加 young: 或 assistant: 前缀。
young chat 的 slash 命令和 Click 命令是同一套能力，只是入口不同。
| CLI | Chat slash |
|---|---|
young a |
/a |
young stock <symbol> [--llm] [--lens ...] |
/stock <symbol> [--llm] [--lens ...] |
young fund <code> [--llm] [--lens ...] |
/fund <code> [--llm] [--lens ...] |
young news 3690.HK |
/news <query> |
young daily --llm |
/daily [--llm] [--lens ...] |
young report |
/report |
young send |
/send |
young profile list |
/profile list |
young memory show |
/memory show |
young memory clear |
/memory clear |
| `young style list | set |
young diagnose |
/diagnose |
Chat 里还支持 /help、/clear 和 /exit。update、uninstall、init、config、portfolio、diary 和 cache-clear 这些命令保留在 CLI 侧。
Pick one installation path and keep using the same family of commands.
uv tool install young-stock-cli
uv tool install --upgrade young-stock-cli
uv tool install --force 'young-stock-cli'
uv tool install --upgrade 'young-stock-cli[pdf]'
# if you installed from this repo checkout:
uv tool install --force '.[pdf]'
uv tool uninstall young-stock-clipython3 -m pip install --upgrade young-stock-cli
python3 -m pip install --upgrade 'young-stock-cli[pdf]'
python3 -m pip uninstall -y young-stock-cliThe mirrored CLI helpers are:
young update
young uninstallyoung init is the first-run check for local state, config, and PDF readiness. PDF export is an optional extra; if you installed from PyPI, use young-stock-cli[pdf], and if you installed from the current repo checkout, use '.[pdf]'.
young diagnoseis read-only.young diagnose --jsonprints machine-readable support data.- It reports source health, model readiness, PDF readiness, and configured channels without exposing secrets.
- Secrets are masked in
young config show. - API keys can stay in environment variables via
--api-key-env. - Local state lives under
~/.young_stock/and is not uploaded by default. - Browser fallback and richer sources only run when you ask for them.
Q: Does young daily need a model?
A: No. Plain young daily is deterministic.
Q: When should I use --llm?
A: When you want the deep M1–M7 replay or a single-stock deep analysis. Plain young daily and young stock <symbol> stay deterministic unless you explicitly add --llm.
Q: Can it use a browser automatically? A: No. Browser fallback stays explicit.
Q: Where do reports go?
A: Saved reports live under ~/.young_stock/reports/YYYYMMDD/.
Q: What if there is no saved Markdown for PDF export?
A: young report can fall back to saved diary text or a fresh deterministic daily snapshot for that date.
These assets live in docs/images/ and are safe to reuse in issues, release notes, or demos.
| Asset | File |
|---|---|
| Cover | docs/images/cover.png |
| Indices demo | docs/images/demo-indices.png |
| ZT pool demo | docs/images/demo-zt-pool.png |
MIT — see LICENSE.