feat: initial public release v0.1.0

- young CLI with subcommands: a, hk, us, global, indices, zt-pool, flow, cache-clear
- Eastmoney public endpoints, no login required
- 7-day local response cache
- Rich terminal tables
- Tests + CI (lint + py3.10/3.11/3.12)
- Trusted publisher workflow ready for PyPI

Author: AdvancingTitans

.github/ISSUE_TEMPLATE/bug_report.md

@@ -1,25 +1,26 @@
 ---
 name: Bug report
-about: Something is broken or returning wrong data
+about: Report a problem with young-stock-cli
+title: "[BUG] "
 labels: bug
 ---
 
-## What happened
+**What happened**
+A short description of the bug.
 
-<!-- exact command, exact output, exact trading day -->
+**Steps to reproduce**
+1. Run `young ...`
+2. ...
 
-```
-$ young a 20260526
-...
-```
-
-## What you expected
+**Expected behavior**
+What you expected to see.
 
-## Environment
-
-- young-stock-cli version: `young --version`
-- Python: `python3 --version`
+**Environment**
+- `young --version`:
+- Python version:
 - OS:
-- Network (mainland China / overseas / proxy):
 
-## Extra context
+**Output / traceback**
+```
+paste here
+```

.github/ISSUE_TEMPLATE/feature_request.md

@@ -1,15 +1,17 @@
 ---
 name: Feature request
-about: Suggest a new market, data source, or CLI feature
+about: Suggest a new feature or data source
+title: "[FEAT] "
 labels: enhancement
 ---
 
-## What problem does this solve
+**Problem**
+What problem would this solve?
 
-## Proposed solution
+**Proposed solution**
+What would the CLI / API look like?
 
-## Data source(s) involved
+**Alternatives considered**
 
-<!-- e.g. Eastmoney clist, Sina finance, Tushare, Futu, ... -->
-
-## Alternatives considered
+**Data source (if applicable)**
+URL / endpoint / docs link, and whether it requires login.

.github/PULL_REQUEST_TEMPLATE.md

@@ -1,17 +1,18 @@
-## Summary
+## What
 
-<!-- One sentence: what does this PR change and why? -->
+<!-- short description -->
 
-## Type of change
+## Why
 
-- [ ] Bug fix (non-breaking)
-- [ ] New feature (non-breaking)
-- [ ] Breaking change
-- [ ] Documentation / refactor only
+<!-- problem being solved or motivation -->
+
+## How tested
+
+- [ ] `pytest` passes locally
+- [ ] `ruff check .` passes
+- [ ] Manual test: `young ...`
 
 ## Checklist
 
-- [ ] `uv run pytest -q` passes
-- [ ] `uv run ruff check src tests` is clean
-- [ ] `CHANGELOG.md` updated
-- [ ] Tested on at least one real trading day (paste the date)
+- [ ] Updated `CHANGELOG.md` if user-visible
+- [ ] Updated README if behavior changed

.github/workflows/ci.yml

@@ -7,36 +7,26 @@ on:
     branches: [main]
 
 jobs:
+  lint:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+      - run: pip install ruff
+      - run: ruff check .
+
   test:
-    runs-on: ${{ matrix.os }}
+    runs-on: ubuntu-latest
     strategy:
       fail-fast: false
       matrix:
-        os: [ubuntu-latest, macos-latest]
-        python-version: ["3.9", "3.10", "3.11", "3.12"]
-
+        python-version: ["3.10", "3.11", "3.12"]
     steps:
       - uses: actions/checkout@v4
-
-      - name: Set up Python ${{ matrix.python-version }}
-        uses: actions/setup-python@v5
+      - uses: actions/setup-python@v5
         with:
           python-version: ${{ matrix.python-version }}
-
-      - name: Install
-        run: |
-          python -m pip install --upgrade pip
-          pip install -e ".[dev]"
-
-      - name: Lint
-        run: ruff check src tests
-
-      - name: Test
-        run: pytest -q --cov=young_stock_cli --cov-report=xml
-
-      - name: Upload coverage
-        if: matrix.os == 'ubuntu-latest' && matrix.python-version == '3.11'
-        uses: codecov/codecov-action@v4
-        with:
-          files: ./coverage.xml
-          fail_ci_if_error: false
+      - run: pip install -e ".[dev]"
+      - run: pytest --cov=young_stock --cov-report=term-missing

.github/workflows/publish.yml

@@ -3,26 +3,32 @@ name: Publish to PyPI
 on:
   push:
     tags:
-      - "v*.*.*"
+      - "v*"
 
 jobs:
-  build-and-publish:
+  build:
     runs-on: ubuntu-latest
-    permissions:
-      id-token: write  # trusted publishing
-      contents: read
-
     steps:
       - uses: actions/checkout@v4
-
       - uses: actions/setup-python@v5
         with:
-          python-version: "3.11"
-
-      - name: Build distribution
-        run: |
-          python -m pip install --upgrade pip build
-          python -m build
+          python-version: "3.12"
+      - run: pip install build
+      - run: python -m build
+      - uses: actions/upload-artifact@v4
+        with:
+          name: dist
+          path: dist/
 
-      - name: Publish to PyPI
-        uses: pypa/gh-action-pypi-publish@release/v1
+  publish:
+    needs: build
+    runs-on: ubuntu-latest
+    environment: pypi
+    permissions:
+      id-token: write
+    steps:
+      - uses: actions/download-artifact@v4
+        with:
+          name: dist
+          path: dist/
+      - uses: pypa/gh-action-pypi-publish@release/v1

.gitignore

@@ -1,13 +1,35 @@
-.venv/
+# Python
 __pycache__/
-*.pyc
+*.py[cod]
+*$py.class
+*.so
+.Python
+build/
+dist/
 *.egg-info/
+*.egg
 .pytest_cache/
 .ruff_cache/
 .coverage
-coverage.xml
-dist/
-build/
+htmlcov/
+.tox/
+.mypy_cache/
+
+# Virtual envs
+.venv/
+venv/
+env/
+
+# IDE
+.vscode/
+.idea/
+*.swp
 .DS_Store
-.python-version
+
+# Project
+.young_stock/
+*.cast
+.env
+
+# Lock files (uv)
 uv.lock

CHANGELOG.md

@@ -1,18 +1,18 @@
 # Changelog
 
-All notable changes to this project are documented here. The format follows
-[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).
+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.1.0] - 2026-05-31
 
 ### Added
 - Initial public release.
-- `young a` / `hk` / `us` / `global` subcommands.
-- A-share post-market replay: indices, 涨停/跌停/炸板 pool, fund flow,
-  industry & concept sector rankings (via browser fallback).
-- HK & US replays via Eastmoney `clist` batch endpoint (no-login, no rate limit).
-- Three-tier fetch strategy: cache → stable JSON API → browser fallback
-  (camofox / Playwright / Hermes built-in browser).
-- Data-quality scoring + diagnostic reporting for every run.
-- Cross-market sentiment summary for `young global`.
+- `young a` — A-share after-hours dashboard (indices, ZT/DT pool, fund flow, sector boards).
+- `young hk`, `young us`, `young global` — Hong Kong / US / global indices snapshots.
+- `young indices`, `young zt-pool`, `young flow` — focused subcommands.
+- `young cache-clear` — manage the local response cache.
+- Eastmoney public endpoints (`push2.eastmoney.com`, `push2ex.eastmoney.com`) integrated, no login required.
+- Built-in 7-day response cache (`~/.young_stock/cache/`).
+- Rich terminal tables for human-friendly output.

CONTRIBUTING.md

@@ -1,48 +1,39 @@
 # Contributing
 
-Thanks for your interest in improving `young-stock-cli`. This is a small,
-focused project; contributions of all sizes are welcome.
+Thanks for considering a contribution! This project welcomes pull requests, bug reports, and feature suggestions.
 
-## Development setup
+## Quick start
 
 ```bash
 git clone https://github.com/AdvancingTitans/young-stock-cli.git
 cd young-stock-cli
-uv venv --python 3.11
-uv pip install -e ".[dev]"
-uv run pytest -q
+pip install -e ".[dev]"
+pytest
+ruff check .
 ```
 
-## How to contribute
+## Pull requests
 
-- **Bug reports**: open an issue with the exact command you ran, the full
-  stack trace, and the trading day you queried (Eastmoney's payload format
-  changes over time — knowing the date matters).
-- **New data source / endpoint**: open an issue first to discuss API
-  stability and rate-limit behaviour before sending a PR.
-- **Documentation / translation**: PRs welcome. The README is bilingual
-  (English on top, Chinese below).
+1. Fork → create a topic branch (`feat/...` or `fix/...`).
+2. Add or update tests for your change.
+3. Run `pytest` and `ruff check .` locally — CI runs both.
+4. Open a PR with a clear description: what + why.
 
-## Pull request checklist
+## Reporting bugs
 
-- [ ] `uv run pytest -q` passes locally.
-- [ ] `uv run ruff check src tests` is clean.
-- [ ] New behaviour has a test (mock the network, do not hit live APIs).
-- [ ] `CHANGELOG.md` updated under `## [Unreleased]`.
+Please include:
 
-## Code style
+- `young --version`
+- Python version (`python --version`)
+- OS
+- The exact command you ran and the full traceback / output.
 
-- Python 3.8+ syntax (we still support 3.8 because some quant users are
-  stuck on legacy interpreters).
-- 100-column line limit (enforced by ruff).
-- Prefer the standard library; runtime dependencies should stay at zero
-  unless there's a clear reason.
+## Code style
 
-## Release process
+- `ruff` for linting and import sorting.
+- Type hints encouraged but not required for small fixes.
+- Keep functions focused; prefer composing small helpers.
 
-Maintainers only:
+## License
 
-1. Bump `__version__` in `src/young_stock_cli/__version__.py`.
-2. Move `## [Unreleased]` content to a new dated section in `CHANGELOG.md`.
-3. Tag: `git tag v0.x.y && git push --tags`.
-4. GitHub Actions builds the wheel and publishes to PyPI on tag push.
+By contributing, you agree your contribution will be licensed under the MIT license.