young-stock-cli 0.2.2__tar.gz → 0.2.4__tar.gz

{young_stock_cli-0.2.2 → young_stock_cli-0.2.4}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: young-stock-cli
-Version: 0.2.2
+Version: 0.2.4
 Summary: A-share (China stock market) after-hours CLI — no login, no scraping tricks, just data.
 Project-URL: Homepage, https://github.com/AdvancingTitans/young-stock-cli
 Project-URL: Repository, https://github.com/AdvancingTitans/young-stock-cli
@@ -25,12 +25,12 @@ Requires-Python: >=3.9
 Requires-Dist: click>=8.1
 Requires-Dist: requests>=2.31
 Requires-Dist: rich>=13.0
+Requires-Dist: weasyprint>=62
 Provides-Extra: dev
 Requires-Dist: pytest-cov>=4; extra == 'dev'
 Requires-Dist: pytest>=7; extra == 'dev'
 Requires-Dist: ruff>=0.4; extra == 'dev'
 Provides-Extra: pdf
-Requires-Dist: weasyprint>=62; extra == 'pdf'
 Description-Content-Type: text/markdown
 
 # young-stock-cli
@@ -56,6 +56,7 @@ Recommended for CLI isolation:
 
 ```bash
 uv tool install young-stock-cli
+young init
 ```
 
 Or install into the active Python environment:
@@ -80,6 +81,10 @@ If you installed `young` with `uv tool`, upgrade that tool-managed environment i
 uv tool install --upgrade young-stock-cli
 ```
 
+`young init` creates the local home/profile files, verifies whether PDF rendering is available in the current
+environment, and prints the recommended next steps. You only need to install the tool once per environment; you do
+not need to reinstall it before every report.
+
 If `python3 -m pip install --upgrade young-stock-cli` succeeds but `young --version` still shows an older release,
 you are probably running a different executable entrypoint than the interpreter you just upgraded. A quick check:
 
@@ -114,6 +119,7 @@ young daily --format summary      # concise personalized daily report
 young daily --format key-points   # short report with trend/risk points
 young daily --format full         # full personalized daily report
 young daily --llm                # evidence-driven deep replay with your configured LLM
+young init                       # initialize local state and verify report/LLM readiness
 young replay                     # deep M1-M6 market replay
 young analyze 600519             # deep single-stock analysis
 young chat                       # Rich chat mode with slash commands
@@ -269,18 +275,39 @@ checks. Markdown, metadata, and `evidence.json` are retained under:
 ~/.young_stock/reports/YYYYMMDD/
 ```
 
+Before the model sees any data, young converts internal evidence into research-only Chinese terminology. The same
+conversion is applied to the downloaded stock-analysis methodology, so implementation guidance never enters the
+report-writing context. The returned Markdown is reviewed again before it can be saved or exported. Formal reports
+use only these source phrases:
+
+- normal data: `据公开市场数据`, `据交易所及财经终端披露`
+- missing data: `该指标当日未披露`, `历史数据不可得`, `本模块证据暂缺`
+- historical lookback: `按惯例回溯至该日`, `历史口径回溯`
+
+Report artifacts include the date, market session, and topic:
+
+```text
+20260618-早盘-A股深度复盘.md
+20260618-盘中-A股深度复盘.md
+20260618-盘后-A股深度复盘.md
+20260618-盘后-600519深度分析.md
+```
+
+Generating the same topic again in the same session replaces the previous artifact. A report from another session
+is retained.
+
 ### Professional PDF reports
 
-Install the optional renderer:
+The standard install already includes PDF support. If you upgraded from an older environment, refresh the tool once:
 
 ```bash
-uv tool install --force 'young-stock-cli[pdf]'
+uv tool install --force 'young-stock-cli'
 ```
 
 If `young` was installed into the active Python environment instead:
 
 ```bash
-python3 -m pip install "young-stock-cli[pdf]"
+python3 -m pip install --upgrade young-stock-cli
 ```
 
 Then export the latest report:
@@ -291,8 +318,8 @@ young report --date 20260618
 ```
 
 If no Markdown report exists for the selected date, `young report` first reuses a saved diary entry when available,
-otherwise it automatically generates a deterministic full daily report. It keeps `daily.md`/`replay.md`,
-`report.html`, and `report.pdf` together.
+otherwise it automatically generates a deterministic full daily report. Run `young init` first if you want a quick
+readiness check for PDF rendering, config, and local storage paths.
 
 The bundled Equity Report layout follows the
 [`tw93/Kami`](https://github.com/tw93/Kami) editorial language: parchment `#f5f4ed`, ink blue `#1B365D`,

{young_stock_cli-0.2.2 → young_stock_cli-0.2.4}/README.md

@@ -21,6 +21,7 @@ Recommended for CLI isolation:
 
 ```bash
 uv tool install young-stock-cli
+young init
 ```
 
 Or install into the active Python environment:
@@ -45,6 +46,10 @@ If you installed `young` with `uv tool`, upgrade that tool-managed environment i
 uv tool install --upgrade young-stock-cli
 ```
 
+`young init` creates the local home/profile files, verifies whether PDF rendering is available in the current
+environment, and prints the recommended next steps. You only need to install the tool once per environment; you do
+not need to reinstall it before every report.
+
 If `python3 -m pip install --upgrade young-stock-cli` succeeds but `young --version` still shows an older release,
 you are probably running a different executable entrypoint than the interpreter you just upgraded. A quick check:
 
@@ -79,6 +84,7 @@ young daily --format summary      # concise personalized daily report
 young daily --format key-points   # short report with trend/risk points
 young daily --format full         # full personalized daily report
 young daily --llm                # evidence-driven deep replay with your configured LLM
+young init                       # initialize local state and verify report/LLM readiness
 young replay                     # deep M1-M6 market replay
 young analyze 600519             # deep single-stock analysis
 young chat                       # Rich chat mode with slash commands
@@ -234,18 +240,39 @@ checks. Markdown, metadata, and `evidence.json` are retained under:
 ~/.young_stock/reports/YYYYMMDD/
 ```
 
+Before the model sees any data, young converts internal evidence into research-only Chinese terminology. The same
+conversion is applied to the downloaded stock-analysis methodology, so implementation guidance never enters the
+report-writing context. The returned Markdown is reviewed again before it can be saved or exported. Formal reports
+use only these source phrases:
+
+- normal data: `据公开市场数据`, `据交易所及财经终端披露`
+- missing data: `该指标当日未披露`, `历史数据不可得`, `本模块证据暂缺`
+- historical lookback: `按惯例回溯至该日`, `历史口径回溯`
+
+Report artifacts include the date, market session, and topic:
+
+```text
+20260618-早盘-A股深度复盘.md
+20260618-盘中-A股深度复盘.md
+20260618-盘后-A股深度复盘.md
+20260618-盘后-600519深度分析.md
+```
+
+Generating the same topic again in the same session replaces the previous artifact. A report from another session
+is retained.
+
 ### Professional PDF reports
 
-Install the optional renderer:
+The standard install already includes PDF support. If you upgraded from an older environment, refresh the tool once:
 
 ```bash
-uv tool install --force 'young-stock-cli[pdf]'
+uv tool install --force 'young-stock-cli'
 ```
 
 If `young` was installed into the active Python environment instead:
 
 ```bash
-python3 -m pip install "young-stock-cli[pdf]"
+python3 -m pip install --upgrade young-stock-cli
 ```
 
 Then export the latest report:
@@ -256,8 +283,8 @@ young report --date 20260618
 ```
 
 If no Markdown report exists for the selected date, `young report` first reuses a saved diary entry when available,
-otherwise it automatically generates a deterministic full daily report. It keeps `daily.md`/`replay.md`,
-`report.html`, and `report.pdf` together.
+otherwise it automatically generates a deterministic full daily report. Run `young init` first if you want a quick
+readiness check for PDF rendering, config, and local storage paths.
 
 The bundled Equity Report layout follows the
 [`tw93/Kami`](https://github.com/tw93/Kami) editorial language: parchment `#f5f4ed`, ink blue `#1B365D`,

{young_stock_cli-0.2.2 → young_stock_cli-0.2.4}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "young-stock-cli"
-version = "0.2.2"
+version = "0.2.4"
 description = "A-share (China stock market) after-hours CLI — no login, no scraping tricks, just data."
 readme = "README.md"
 requires-python = ">=3.9"
@@ -29,6 +29,7 @@ dependencies = [
     "requests>=2.31",
     "rich>=13.0",
     "click>=8.1",
+    "weasyprint>=62",
 ]
 
 [project.urls]
@@ -41,9 +42,7 @@ Changelog = "https://github.com/AdvancingTitans/young-stock-cli/blob/main/CHANGE
 young = "young_stock.cli:cli"
 
 [project.optional-dependencies]
-pdf = [
-    "weasyprint>=62",
-]
+pdf = []
 dev = [
     "pytest>=7",
     "pytest-cov>=4",

{young_stock_cli-0.2.2 → young_stock_cli-0.2.4}/src/young_stock/__init__.py

@@ -1,3 +1,3 @@
 """young-stock-cli: A-share after-hours CLI."""
 
-__version__ = "0.2.2"
+__version__ = "0.2.4"

{young_stock_cli-0.2.2 → young_stock_cli-0.2.4}/src/young_stock/_core.py

@@ -36,6 +36,7 @@ from typing import Any
 
 from .calendar import nearest_trade_date as calendar_nearest_trade_date
 from .health import SourceHealthBook
+from .market_routes import route_board_data
 
 # ------------------------------------------------------------------
 # 配置
@@ -716,6 +717,32 @@ def fetch_ths_concept_money_flow_snapshot(date_str: str) -> dict[str, str]:
     return result
 
 
+def fetch_browser_fund_flow_snapshot(date_str: str) -> dict[str, str]:
+    raw = _playwright_html(THS_CONCEPT_MONEY_FLOW_URL)
+    if not raw:
+        return {}
+    rows = _parse_ths_money_flow_table(raw)
+    top_in_rows = sorted(
+        [row for row in rows if float(row.get("net") or 0) > 0],
+        key=lambda item: float(item.get("net") or 0),
+        reverse=True,
+    )[:5]
+    top_out_rows = sorted(
+        [row for row in rows if float(row.get("net") or 0) < 0],
+        key=lambda item: float(item.get("net") or 0),
+    )[:5]
+    if not top_in_rows or not top_out_rows:
+        return {}
+    return {
+        "date": _display_date(nearest_trade_date()),
+        "_source": "公开财经页面概念资金流",
+        "_scope": "A股",
+        "_fallback_indicator": "concept_money_flow",
+        "_concept_in": json.dumps(top_in_rows, ensure_ascii=False),
+        "_concept_out": json.dumps(top_out_rows, ensure_ascii=False),
+    }
+
+
 def _market_activity_snapshot(rows: list[dict[str, Any]], source: str, date_str: str) -> dict[str, str]:
     usable = [r for r in rows if r.get("f12") in {"000001", "399001"}]
     if not usable:
@@ -1995,8 +2022,15 @@ def get_fund_flow(date_str: str, *, strict_date: bool = True) -> dict[str, str]:
         latest_result["_date_note"] = "latest_available"
         cache_save("fund_flow", date_str, "eastmoney", latest_result)
         return latest_result
-    for fallback in (fetch_sina_sector_money_flow_snapshot, fetch_sina_market_activity_snapshot, fetch_tencent_market_activity_snapshot):
-        activity = fallback(date_str)
+    for online_reference in (fetch_sina_sector_money_flow_snapshot,):
+        activity = online_reference(date_str)
+        if activity:
+            return activity
+    browser_flow = fetch_browser_fund_flow_snapshot(date_str)
+    if browser_flow:
+        return browser_flow
+    for market_reference in (fetch_sina_market_activity_snapshot, fetch_tencent_market_activity_snapshot):
+        activity = market_reference(date_str)
         if activity:
             return activity
     cached_latest = load_latest_fund_flow_cache(date_str)
@@ -2171,13 +2205,15 @@ def fetch_eastmoney_board_list(board_type: str, date_str: str, limit: int = 100)
 
 def get_board_list(board_type: str, date_str: str, limit: int = 100) -> dict[str, Any]:
     """Return board rankings through the stock-analysis source order."""
-    result = fetch_eastmoney_board_list(board_type, date_str, limit=limit)
-    if result.get("rows"):
-        return result
-    browser_result = camofox_board_list(board_type)
-    if browser_result.get("rows"):
-        return browser_result
-    return result
+    return route_board_data(
+        board_type,
+        date_str,
+        direct=fetch_eastmoney_board_list,
+        camofox=camofox_board_list,
+        playwright=playwright_board_list,
+        limit=limit,
+        current_trade_date=nearest_trade_date(),
+    )
 
 
 @retry_on_recoverable(max_retries=MAX_RETRIES, initial_delay=INITIAL_BACKOFF)
@@ -2751,6 +2787,36 @@ def _parse_camofox_board_snapshot(markdown: str) -> list[dict[str, Any]]:
     return rows
 
 
+def _playwright_html(url: str) -> str:
+    try:
+        from playwright.sync_api import sync_playwright
+    except ImportError:
+        return ""
+    try:
+        with sync_playwright() as runtime:
+            browser = runtime.chromium.launch(headless=True)
+            page = browser.new_page()
+            page.goto(url, wait_until="networkidle", timeout=20_000)
+            content = page.content()
+            browser.close()
+            return content
+    except Exception as exc:
+        diag(f"Browser page unavailable: {exc}")
+        return ""
+
+
+def playwright_board_list(board_type: str = "industry") -> dict[str, Any]:
+    anchor = "industry_board" if board_type == "industry" else "concept_board"
+    html_text = _playwright_html(f"https://quote.eastmoney.com/center/gridlist.html#{anchor}")
+    if not html_text:
+        return {"board_type": board_type, "rows": [], "_unavailable": "browser unavailable"}
+    text = re.sub(r"<[^>]+>", "  ", html.unescape(html_text))
+    rows = _parse_camofox_board_snapshot(
+        "\n".join(f'row "{line.strip()}"' for line in text.splitlines() if re.match(r"^\s*\d+\s+", line))
+    )
+    return {"board_type": board_type, "rows": rows, "count": len(rows), "_source": "公开财经页面"}
+
+
 def camofox_board_list(board_type: str = "industry") -> dict[str, Any]:
     base = os.environ.get("CAMOFOX_URL", "http://localhost:9377")
     user_id = os.environ.get("CAMOFOX_USER_ID", "")

{young_stock_cli-0.2.2 → young_stock_cli-0.2.4}/src/young_stock/artifacts.py

@@ -3,6 +3,7 @@
 from __future__ import annotations
 
 import json
+import re
 from dataclasses import dataclass
 from datetime import datetime
 from pathlib import Path
@@ -11,6 +12,37 @@ from typing import Any
 from .local_store import young_home
 
 
+def market_session(now: datetime | None = None) -> str:
+    now = now or datetime.now()
+    minute = now.hour * 60 + now.minute
+    if 9 * 60 <= minute < 11 * 60 + 30:
+        return "早盘"
+    if 11 * 60 + 30 <= minute < 13 * 60:
+        return "午间"
+    if 13 * 60 <= minute < 15 * 60:
+        return "盘中"
+    return "盘后"
+
+
+def report_session(trade_date: str, now: datetime | None = None) -> str:
+    now = now or datetime.now()
+    if trade_date != now.strftime("%Y%m%d"):
+        return "盘后"
+    return market_session(now)
+
+
+@dataclass(frozen=True)
+class ReportIdentity:
+    trade_date: str
+    session: str
+    topic: str
+
+    @property
+    def prefix(self) -> str:
+        safe_topic = "".join(character for character in self.topic if character.isalnum() or character in "-_")
+        return f"{self.trade_date}-{self.session}-{safe_topic}"
+
+
 @dataclass
 class ReportArtifacts:
     trade_date: str
@@ -36,6 +68,9 @@ class ReportArtifacts:
         path.write_text(content.rstrip() + "\n", encoding="utf-8")
         return path
 
+    def write_report_markdown(self, identity: ReportIdentity, content: str) -> Path:
+        return self.write_markdown(identity.prefix, content)
+
     def write_json(self, name: str, data: dict[str, Any]) -> Path:
         path = self.path(name, "json")
         path.write_text(json.dumps(data, ensure_ascii=False, indent=2) + "\n", encoding="utf-8")
@@ -48,6 +83,13 @@ class ReportArtifacts:
             candidates = list((reports / trade_date).glob("*.md"))
         else:
             candidates = list(reports.glob("*/*.md"))
+        identified = [
+            path
+            for path in candidates
+            if re.match(r"^\d{8}-(?:早盘|盘中|午间|盘后)-.+\.md$", path.name)
+        ]
+        if identified:
+            candidates = identified
         return max(candidates, key=lambda path: path.stat().st_mtime) if candidates else None
 
     @classmethod

{young_stock_cli-0.2.2 → young_stock_cli-0.2.4}/src/young_stock/channels/__init__.py

@@ -13,9 +13,8 @@ from .feishu import FeishuChannel
 def send_report(trade_date: str | None, *, channel_name: str | None = None) -> list[DeliveryResult]:
     if not trade_date:
         raise ValueError("没有报告日期；请先运行 `young report`。")
-    artifacts = ReportArtifacts(trade_date)
     markdown = ReportArtifacts.latest_markdown(trade_date)
-    pdf = artifacts.path("report", "pdf")
+    pdf = markdown.with_suffix(".pdf") if markdown else None
     if markdown is None or not pdf.exists():
         raise ValueError(f"{trade_date} 缺少 Markdown/PDF；请先运行 `young report --date {trade_date}`。")
     configs = load_config(strict=False).get("channels", {}).get("feishu", {})