feat: add llm chat reports and delivery (#6)

Adds optional LLM configuration, Rich chat/slash commands, evidence-driven replay and stock analysis, Kami-compatible PDF export, and Feishu delivery.

Author: AdvancingTitans

CHANGELOG.md

@@ -5,6 +5,21 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [0.2.0] - 2026-06-18
+
+### Added
+- Added versioned LLM and delivery-channel configuration in `~/.young_stock/config.json`, including masked display and environment-based API key lookup.
+- Added OpenAI-compatible providers (OpenAI, DeepSeek, Qwen, Ollama) plus Anthropic message support with timeouts, retries, and safe errors.
+- Added `young chat`, a Rich interactive REPL whose slash commands reuse the existing Click command tree.
+- Added evidence-driven `young replay`, `young daily --llm`, and `young analyze <symbol>` workflows based on the stock-analysis M1-M6 methodology and quality-score degradation.
+- Added persistent report/evidence artifacts under `~/.young_stock/reports/YYYYMMDD/`.
+- Added `young report` with automatic deterministic-report fallback and optional WeasyPrint PDF export using a Kami-compatible Equity Report layout.
+- Added modular `young send` delivery with Feishu webhook preview mode and Feishu App Markdown/PDF attachment mode.
+
+### Changed
+- Extended `young diagnose --json` with non-secret LLM, PDF, report, and configured-channel readiness.
+- Version advanced to 0.2.0 for the new optional AI/reporting surface; all existing commands remain available without LLM or PDF dependencies.
+
 ## [0.1.22] - 2026-06-15
 
 ### Changed

README.md

@@ -70,6 +70,12 @@ young profile clear-funds   # clear all saved funds only
 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 replay                     # deep M1-M6 market replay
+young analyze 600519             # deep single-stock analysis
+young chat                       # Rich chat mode with slash commands
+young report                     # export latest Markdown as a Kami-style PDF
+young send                       # send latest Markdown + PDF to configured channels
 young daily --only 基金,A股 --quick
 young news 3690.HK      # multi-source news only
 young diagnose          # network/source diagnostic
@@ -92,6 +98,131 @@ young uninstall         # uninstall from the current Python env
 young --help
 ```
 
+### LLM configuration and chat
+
+LLM features are optional. Existing market commands do not require a model or API key. Configuration is stored in
+`~/.young_stock/config.json` (or `$YOUNG_STOCK_HOME/config.json`).
+
+```bash
+# Prefer an environment variable so the key is not stored in config.json
+export DEEPSEEK_API_KEY="..."
+young config llm \
+  --provider deepseek \
+  --model deepseek-chat \
+  --api-key-env DEEPSEEK_API_KEY
+
+# Other supported providers
+young config llm --provider openai --model gpt-4.1 --api-key-env OPENAI_API_KEY
+young config llm --provider qwen --model qwen-plus --api-key-env DASHSCOPE_API_KEY
+young config llm --provider anthropic --model claude-sonnet-4-20250514 --api-key-env ANTHROPIC_API_KEY
+young config llm --provider ollama --model qwen2.5:14b --api-base http://localhost:11434/v1
+
+young config show       # secrets are masked
+young config path
+```
+
+Start the interactive mode with `young chat`. Slash commands reuse the same Click command tree, so traditional CLI
+and chat behavior stay aligned:
+
+```text
+/a
+/stock 600519
+/fund 161725
+/daily --format summary
+/daily --llm
+/daily-llm
+/replay
+/analyze 600519
+/profile list
+/report
+/send
+```
+
+The chat keeps the five most recent user/assistant turns. If no LLM is configured, enhanced commands fail with a
+configuration hint while `/a`, `/stock`, `/daily`, and every other deterministic command continue working.
+
+### Evidence-driven deep replay
+
+`young replay`, `young daily --llm`, and `/replay` build an Evidence Pack entirely from the structured values returned
+by `young_stock._core`. The model is used for synthesis, not data collection.
+
+The report follows the six-module method from
+[`AdvancingTitans/stock-analysis`](https://github.com/AdvancingTitans/stock-analysis):
+
+1. M1 index overview
+2. M2 sector and fund flow
+3. M3 upside/limit-up effect
+4. M4 downside and blow-up risk
+5. M5 market/portfolio style
+6. M6 resilient directions
+
+Each module has an evidence score. Missing fields remain missing rather than being rendered as zero. Low-quality
+evidence automatically produces a shorter report limited to verified indices, holdings, risks, and next-session
+checks. Markdown, metadata, and `evidence.json` are retained under:
+
+```text
+~/.young_stock/reports/YYYYMMDD/
+```
+
+### Professional PDF reports
+
+Install the optional renderer:
+
+```bash
+python3 -m pip install "young-stock-cli[pdf]"
+```
+
+Then export the latest report:
+
+```bash
+young report
+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.
+
+The bundled Equity Report layout follows the
+[`tw93/Kami`](https://github.com/tw93/Kami) editorial language: parchment `#f5f4ed`, ink blue `#1B365D`,
+serif-led hierarchy, compact rhythm, and print-ready A4 output. To use a locally installed Kami-derived template,
+set `YOUNG_STOCK_KAMI_TEMPLATE` to an HTML file containing `{{TITLE}}`, `{{DATE}}`, and `{{BODY}}`.
+
+### Feishu delivery
+
+Webhook mode sends a text preview. Feishu incoming webhooks cannot upload arbitrary PDF attachments:
+
+```bash
+young config channel add feishu work \
+  --webhook "https://open.feishu.cn/open-apis/bot/v2/hook/..."
+```
+
+App mode uploads and sends both Markdown and PDF:
+
+```bash
+young config channel add feishu research-app \
+  --app-id "$FEISHU_APP_ID" \
+  --app-secret "$FEISHU_APP_SECRET" \
+  --receive-id "$FEISHU_CHAT_ID"
+
+young config channel list
+young config channel remove feishu work
+```
+
+One-click workflow:
+
+```bash
+young replay
+young report
+young send
+
+# Or target one date/channel
+young send --date 20260618 --channel research-app
+```
+
+Requests use timeouts and bounded retries. Channel errors are reported independently, and secrets are masked in
+configuration and diagnostic output.
+
 ### Example output (`young indices`)
 
 ```

pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "young-stock-cli"
-version = "0.1.22"
+version = "0.2.0"
 description = "A-share (China stock market) after-hours CLI — no login, no scraping tricks, just data."
 readme = "README.md"
 requires-python = ">=3.9"
@@ -41,6 +41,9 @@ Changelog = "https://github.com/AdvancingTitans/young-stock-cli/blob/main/CHANGE
 young = "young_stock.cli:cli"
 
 [project.optional-dependencies]
+pdf = [
+    "weasyprint>=62",
+]
 dev = [
     "pytest>=7",
     "pytest-cov>=4",
@@ -50,6 +53,12 @@ dev = [
 [tool.hatch.build.targets.wheel]
 packages = ["src/young_stock"]
 
+[tool.hatch.build]
+include = [
+    "src/young_stock/**/*.py",
+    "src/young_stock/templates/*.html",
+]
+
 [tool.ruff]
 line-length = 110
 target-version = "py39"

src/young_stock/__init__.py

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

src/young_stock/artifacts.py

@@ -0,0 +1,65 @@
+"""Report artifact paths and persistence."""
+
+from __future__ import annotations
+
+import json
+from dataclasses import dataclass
+from datetime import datetime
+from pathlib import Path
+from typing import Any
+
+from .local_store import young_home
+
+
+@dataclass
+class ReportArtifacts:
+    trade_date: str
+
+    def __post_init__(self) -> None:
+        if len(self.trade_date) != 8 or not self.trade_date.isdigit():
+            raise ValueError("trade_date must use YYYYMMDD")
+
+    @property
+    def directory(self) -> Path:
+        path = young_home() / "reports" / self.trade_date
+        path.mkdir(parents=True, exist_ok=True)
+        return path
+
+    def path(self, name: str, suffix: str) -> Path:
+        safe = "".join(character for character in name if character.isalnum() or character in "-_")
+        if not safe:
+            raise ValueError("artifact name is empty")
+        return self.directory / f"{safe}.{suffix.lstrip('.')}"
+
+    def write_markdown(self, name: str, content: str) -> Path:
+        path = self.path(name, "md")
+        path.write_text(content.rstrip() + "\n", encoding="utf-8")
+        return path
+
+    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")
+        return path
+
+    @classmethod
+    def latest_markdown(cls, trade_date: str | None = None) -> Path | None:
+        reports = young_home() / "reports"
+        if trade_date:
+            candidates = list((reports / trade_date).glob("*.md"))
+        else:
+            candidates = list(reports.glob("*/*.md"))
+        return max(candidates, key=lambda path: path.stat().st_mtime) if candidates else None
+
+    @classmethod
+    def latest_date(cls) -> str | None:
+        reports = young_home() / "reports"
+        dates = [
+            path.name
+            for path in reports.iterdir()
+            if path.is_dir() and len(path.name) == 8 and path.name.isdigit()
+        ] if reports.exists() else []
+        return max(dates) if dates else None
+
+    def write_metadata(self, data: dict[str, Any]) -> Path:
+        payload = {"created_at": datetime.now().isoformat(timespec="seconds"), **data}
+        return self.write_json("metadata", payload)

src/young_stock/channels/__init__.py

@@ -0,0 +1,32 @@
+"""Delivery channel registry."""
+
+from __future__ import annotations
+
+from pathlib import Path
+
+from ..artifacts import ReportArtifacts
+from ..config import load_config
+from .base import DeliveryResult
+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")
+    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", {})
+    selected = {
+        name: config
+        for name, config in configs.items()
+        if channel_name is None or name == channel_name
+    }
+    if not selected:
+        raise ValueError("未配置匹配的发送渠道；请运行 `young config channel add feishu --help`。")
+    return [FeishuChannel(name, config).send(Path(markdown), pdf) for name, config in selected.items()]
+
+
+__all__ = ["DeliveryResult", "send_report"]

src/young_stock/channels/base.py

@@ -0,0 +1,13 @@
+"""Channel adapter primitives."""
+
+from __future__ import annotations
+
+from dataclasses import dataclass
+
+
+@dataclass
+class DeliveryResult:
+    channel: str
+    target: str
+    ok: bool
+    detail: str