lstnet 0.1.0__tar.gz

lstnet-0.1.0/.github/workflows/publish.yml

@@ -0,0 +1,30 @@
+name: publish
+
+# Trusted publishing (OIDC) to PyPI on GitHub Release.
+# One-time setup: create the project on https://pypi.org and add a trusted
+# publisher for this repo + environment `pypi` + workflow `publish.yml`.
+on:
+  release:
+    types: [published]
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-python@v5
+        with: { python-version: "3.x" }
+      - run: pip install build
+      - run: python -m build
+      - uses: actions/upload-artifact@v4
+        with: { name: dist, path: dist/ }
+  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

lstnet-0.1.0/.github/workflows/release-binaries.yml

@@ -0,0 +1,51 @@
+name: release-binaries
+
+# Build standalone GUI binaries (PyInstaller) for Win/macOS/Linux and attach
+# them to the GitHub Release. Users download for their OS — no Python needed.
+# Runs alongside the PyPI publish workflow (both trigger on release).
+
+on:
+  release:
+    types: [published]
+
+jobs:
+  build:
+    strategy:
+      fail-fast: false
+      matrix:
+        include:
+          - os: ubuntu-latest
+            artifact: lstnet-gui-linux.tar.gz
+          - os: macos-latest
+            artifact: lstnet-gui-macos.zip
+          - os: windows-latest
+            artifact: lstnet-gui-windows.zip
+    runs-on: ${{ matrix.os }}
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+
+      - name: Install Qt system libs (Linux only)
+        if: runner.os == 'Linux'
+        run: sudo apt-get update && sudo apt-get install -y libxcb-cursor0 libegl1 libgl1 libxkbcommon0
+
+      - run: pip install -e ".[gui]"
+      - run: pip install pyinstaller
+
+      - name: Build binary
+        run: pyinstaller lstnet-gui.spec --noconfirm --clean
+
+      - name: Archive (Linux/macOS)
+        if: runner.os != 'Windows'
+        run: tar czf "${{ matrix.artifact }}" -C dist lstnet-gui
+
+      - name: Archive (Windows)
+        if: runner.os == 'Windows'
+        run: Compress-Archive -Path dist/lstnet-gui -DestinationPath "${{ matrix.artifact }}"
+
+      - name: Upload to release
+        uses: softprops/action-gh-release@v2
+        with:
+          files: ${{ matrix.artifact }}

lstnet-0.1.0/.github/workflows/test.yml

@@ -0,0 +1,30 @@
+name: tests
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+
+jobs:
+  test:
+    runs-on: ${{ matrix.os }}
+    strategy:
+      fail-fast: false
+      matrix:
+        os: [ubuntu-latest, macos-latest, windows-latest]
+        python-version: ["3.11", "3.12"]
+    env:
+      QT_QPA_PLATFORM: offscreen
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-python@v5
+        with:
+          python-version: ${{ matrix.python-version }}
+      - name: Install Qt system libraries (Linux only — headless PySide6 needs libEGL etc.)
+        if: runner.os == 'Linux'
+        run: sudo apt-get update && sudo apt-get install -y libegl1 libgl1 libxkbcommon0 libdbus-1-3 libxcb-cursor0
+      - run: pip install --upgrade pip
+      - run: pip install -e .[dev]
+      - run: pip install PySide6 fastmcp   # extras (GUI/MCP smoke tests)
+      # Golden tests gate on EARTHDATA creds -> skipped automatically on CI.
+      - run: pytest -q

lstnet-0.1.0/.gitignore

@@ -0,0 +1,33 @@
+# Python
+__pycache__/
+*.py[cod]
+*.egg-info/
+.eggs/
+*.egg
+
+# Virtual environments
+.venv/
+venv/
+env/
+
+# PyInstaller build artifacts
+build/
+dist/
+
+# Observation / satellite data (large; obtained separately, not version-controlled)
+# Small test fixtures live in tests/fixtures/
+data/
+
+# IDE
+.idea/
+
+# OS
+.DS_Store
+Thumbs.db
+
+# Secrets / personal
+.env
+CLAUDE.local.md
+
+# Logs
+*.log

lstnet-0.1.0/AGENTS.md

@@ -0,0 +1 @@
+@CLAUDE.md

lstnet-0.1.0/CITATION.cff

@@ -0,0 +1,24 @@
+cff-version: 1.2.0
+message: "If you use lstnet in your research, please cite it as below."
+title: "lstnet: a pure-Python land surface temperature ground-validation library"
+abstract: >-
+  lstnet computes ground-truth land surface temperature (LST) from in-situ
+  longwave radiation at SURFRAD / PKULSTNet / HiWATER sites and validates it
+  against retrieved LST (bias / RMSE / R + plots). GDAL-free, cross-platform.
+authors:
+  - family-names: "Zeng"
+    given-names: "Hui"
+    email: "zenghui@pku.edu.cn"
+  - name: "LSTNet Contributors"
+keywords:
+  - land surface temperature
+  - LST
+  - validation
+  - MODIS
+  - SURFRAD
+  - remote sensing
+  - broadband emissivity
+license: MIT
+version: 0.1.0
+date-released: "2026-06-20"
+repository-code: "https://github.com/veniai/lstnet"

lstnet-0.1.0/CLAUDE.md

@@ -0,0 +1,82 @@
+# CLAUDE.md
+
+This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.
+
+## 项目概述
+
+**lstnet**：地表面温度（LST）地面验证库。读取 SURFRAD / PKULSTNet / HiWATER（共 25 站）现场辐射数据，算出**地面真值 LST**，与**反演 LST**（用户自己的算法或卫星产品）配对验证（bias / RMSE / R + 图）。纯 Python，零系统 GDAL，跨平台（Win / macOS 含 Apple Silicon / Linux），MIT。
+
+- 原作者：曾辉（北大遥感所热红外组），2021 PyQt5 桌面应用
+- 现状：已重构为 `lstnet` 库（核心域 + 发射率源 + 验证引擎 + GUI + MCP + PyPI 就绪）。**仓库根目录的 legacy PyQt5 代码（`main.py` / `methods/` / `all.py` / `*.ui`）是退役基线，逐字节未动，勿在其上开发**——活跃代码在 `src/lstnet/`
+
+## 运行 / 测试 / 构建
+
+```bash
+python3 -m pip install -e .            # 装核心库（editable）
+python3 -m pip install -e .[gui]       # + PySide6（GUI）
+python3 -m pip install -e .[mcp]       # + fastmcp（MCP 服务器）
+python3 -m pip install -e .[dev]       # + pytest
+
+python3 -m pytest -q                   # 全量（golden 测试无凭据时自动 skip）
+lstnet-gui                             # 启动 PySide6 桌面 GUI
+lstnet-mcp                             # 启动 MCP 服务器（AI agent 接入）
+python3 -m build                       # 打 wheel/sdist（发 PyPI 前验证）
+```
+
+- Earthdata 凭据（MODIS/GED 发射率源需要，`FixedEmissivity` 不需要）：
+  `export EARTHDATA_USERNAME=... EARTHDATA_PASSWORD=...`（**绝不硬编码**）
+- GUI 离屏测试：`QT_QPA_PLATFORM=offscreen`
+
+## 架构（`src/lstnet/`）
+
+```
+models.py            值对象：Site / GroundLST / RetrievedLST / ValidationPair/Stats/Result
+sites.py             25 站注册表（SUR7/PKU7/Hi11）
+ground_lst.py        物理与编排：lst_from_radiance、compute_ground_lst、SIGMA(5.670374e-8)
+qc.py                decide_qc + qc_flag 枚举
+dayornight.py        astral 太阳高度角判昼夜
+config.py            package_root/project_root + earthdata_credentials（读环境变量）
+io/base.py           接口：EmissivitySource / NetworkReader + Radiation 类型
+io/surfrad.py        SURFRAD .dat（HTTPS，非 FTP）
+io/pku.py io/hiwater.py  历史本地 CSV/xlsx 读取器
+io/modis.py          MODIS C6.1 发射率（earthaccess + pyhdf，正弦像元查找，QC+padding 修复）
+io/emissivity.py     FixedEmissivity / ModisDailyEmissivity + broadband_emissivity
+io/aster_ged.py      AsterGEDEmissivity（CMR AG100 V003 + h5py）
+io/raster.py         pixel_at_lonlat（GeoTIFF 站点像元提取，rasterio）
+validation.py        validate()（按 site+过境时刻配对）+ TableRetrievedLST
+stats.py             bias / rmse / pearson_r / linear_regression
+plotting.py          scatter(1:1) + time_series
+gui.py               PySide6 GUI（lstnet-gui）
+mcp_server.py        FastMCP 工具服务器（lstnet-mcp）
+```
+
+**分层**：值对象 → 数据访问接口/读取器 → 域编排 → 前端（GUI/MCP）。核心库**无 Qt 依赖**（PySide6/fastmcp 仅在 GUI/MCP）。`compute_ground_lst` 的 `emiss_src` 必须显式传入（不静默联网）。
+
+## 依赖
+
+- `requires-python >=3.9`；核心 deps：`numpy pandas openpyxl requests earthaccess pyhdf astral matplotlib h5py rasterio`
+- **零系统 GDAL**：MODIS HDF4 走 `pyhdf`、ASTER GED HDF5 走 `h5py`、GeoTIFF 走 `rasterio`（自带 GDAL wheel，**无需 `apt install gdal`**）。跨平台 wheel 齐全。
+- extras：`gui`(PySide6) / `mcp`(fastmcp) / `dev`(pytest)。
+
+## 关键约束（铁律）
+
+- **无 `eval`、无硬编码凭据、无 CWD 依赖**（数据路径走 `config.project_root()`）；改代码 grep 确认。
+- **MODIS C6.1**（`.061`），不是 C6（`.006` 已停用）；UTC 过境时刻。
+- **BBE 系数一手化**：MODIS 走 Ogawa 2004 (RSE 88)；ASTER GED 默认走 Cheng & Liang 2014（开放获取一手），Ogawa 为可选 `bbe='ogawa'`。
+- **旧码勿动**：`git diff --exit-code -- main.py methods/ all.py` 应 exit 0。
+- `data/`（数百 MB 真实观测）gitignored；小样本在 `tests/fixtures/`。
+
+## 文档与决策
+
+- 设计 spec：`docs/superpowers/specs/2026-06-19-lstnet-refactor-design.md`（§9 含 pyhdf spike 结论）
+- ADR-0001：`docs/adr/0001-...`（核心库 + 薄前端 + 验证引擎）
+- 实现计划：`docs/superpowers/plans/`（1a / 1b 最终版 / 1c / validation-engine）
+- 领域词典：`CONTEXT.md`（地面真值 LST / 反演 LST / 验证引擎 / 过境时刻…）
+- 执行进度 ledger：`.git/sdd/progress.md`（gitignored，恢复图）
+- 发布：`.github/workflows/`（test 跨平台矩阵 + publish trusted-publishing）
+
+## 路线图
+
+- ✅ Plan 1a 核心域 · 1b 发射率（MODIS+GED，全闭合）· 1c 验证引擎 · PyPI 脚手架 · PySide6 GUI · MCP
+- 待办（用户操作，非代码）：建 GitHub 仓库 → 推送 → pypi.org 配 trusted publisher → 打 Release 自动发 → `pip install lstnet` 生效
+- 可选未来：CLI（自动化批处理）、neighbor-tile mosaic、按网络分组报告、raster 式反演 LST source（待用户真实格式）

lstnet-0.1.0/CONTEXT.md

@@ -0,0 +1,34 @@
+# CONTEXT.md — LSTNet 领域语言
+
+> 项目领域术语表。涉及需求/架构/跨模块讨论时用这些词，避免歧义。
+
+## 术语
+
+### 地面真值 LST (ground-truth LST)
+从地面站点（SURFRAD / PKULSTNet / HiWATER）的上下行长波辐射数据反演出的 LST，作为**验证基准**。公式：`T = ((L↑ - (1-ε)·L↓) / (ε·σ))^0.25`。
+- **避免**："site LST"（与"站点观测的 LST"歧义）
+
+### 反演 LST (retrieved LST)
+反演算法产出的 LST——**用户自己的算法**，或卫星产品（MYD21 / MYD11）。**被验证的对象**。
+- **避免**："satellite LST"（含混；用户验证的是自己的算法，不是 NASA 产品）
+
+### 验证引擎 (validation engine)
+核心库模块：按 (站点, 过境时刻) 配对**地面真值**与**反演 LST**，算 bias / RMSE / R，出散点/时序图。
+
+### 过境时刻 (overpass time)
+卫星过境瞬间，12 位时间戳 `YYYYMMDDHHMM`（**UTC**）。地面真值与反演 LST 的**配对键**。
+- **避免**："tiftime"（旧代码实现细节名）
+
+### 发射率来源 (emissivity source)
+可插拔：`Fixed`（固定值）/ `ModisDaily`（MYD21 日值）/ `AsterGED`（气候态，**默认**）。
+
+### BBE (宽带发射率, broadband emissivity)
+8–13.5µm 有效发射率，用于地面 LST 公式中的 ε。旧代码用的 `0.329·em29+0.572·em31+0.095` 是 Cheng & Liang (2014) **裸土专用**公式，已 deprecated。
+
+### 网络 (networks)
+- **SURFRAD**：美国 7 站，NOAA **在线**（HTTPS），**主力**。
+- **PKULSTNet**：中国 7 站，历史本地 CSV（2018-2019）。
+- **HiWATER**：黑河 11 站，历史本地 xlsx（2018-2019）。
+
+### 反演 LST 取值 (retrieved LST extraction)
+验证时按**站点经纬度**从反演结果（栅格 GeoTIFF / 点表）取出该像元的 LST 值，与地面真值比——复用 MODIS 发射率取像元的同一模式（`findpointmodis`）。格式无关。

lstnet-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2021-2026 Zeng Hui and LSTNet Contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

lstnet-0.1.0/PKG-INFO

@@ -0,0 +1,166 @@
+Metadata-Version: 2.4
+Name: lstnet
+Version: 0.1.0
+Summary: LSTNet: pure-Python land surface temperature library (ground truth LST production refactor).
+Author: LSTNet Contributors
+License: MIT
+License-File: LICENSE
+Requires-Python: >=3.9
+Requires-Dist: astral
+Requires-Dist: earthaccess
+Requires-Dist: fastmcp
+Requires-Dist: h5py
+Requires-Dist: matplotlib
+Requires-Dist: numpy
+Requires-Dist: openpyxl
+Requires-Dist: pandas
+Requires-Dist: pyhdf
+Requires-Dist: pyside6
+Requires-Dist: rasterio
+Requires-Dist: requests
+Provides-Extra: dev
+Requires-Dist: pytest; extra == 'dev'
+Description-Content-Type: text/markdown
+
+# lstnet
+
+**Pure-Python land surface temperature (LST) ground-validation library + GUI.**
+
+`lstnet` computes **ground-truth LST** from in-situ longwave radiation at
+SURFRAD / PKULSTNet / HiWATER validation sites and **validates** it against
+retrieved LST (your own algorithm or a satellite product) — bias / RMSE / R +
+scatter and time-series plots. Zero system GDAL; cross-platform
+(Windows / macOS incl. Apple Silicon / Linux); MIT-licensed.
+
+**Networks:** **SURFRAD** (7 US sites, served online by NOAA — the default,
+works out of the box) is the primary network. **PKULSTNet** (7) and **HiWATER**
+(11) readers are also included for users who hold those local datasets (they
+are not publicly downloadable — point the reader at your `data/` directory).
+
+## Install
+
+```bash
+pip install lstnet
+```
+
+That's it — core library, GUI (`lstnet-gui`), and MCP server (`lstnet-mcp`) are
+all included.
+
+For MODIS / ASTER GED emissivity sources, set NASA Earthdata credentials
+(never hardcoded):
+
+```bash
+export EARTHDATA_USERNAME=you@example.com
+export EARTHDATA_PASSWORD=********
+```
+
+Or enter them in the GUI: **Settings → Earthdata Login** (saved to
+`~/.lstnet/earthdata.json`, chmod 600). Register at
+<https://urs.earthdata.nasa.gov/users/new>.
+
+`FixedEmissivity` needs no credentials.
+
+## GUI usage
+
+```bash
+lstnet-gui        # launch the PySide6 desktop application
+```
+
+The GUI lets you:
+
+1. **Select sites** (multi-select, with lon/lat shown) from SURFRAD / PKULSTNet
+   / HiWATER.
+2. **Enter overpass times** (12-digit `YYYYMMDDHHMM`, one per line, UTC).
+3. **Pick an emissivity source** — ASTER GED (default, recommended for
+   validation), MODIS daily, or a manual fixed value.
+4. **Compute ground LST** — batch across all selected sites × times.
+5. **Validate** — load a retrieved-LST CSV (`site, overpass_time_utc, lst_k`),
+   the tool auto-computes ground truth for each row, pairs, and shows
+   bias / RMSE / R + an embedded scatter plot (retrieved vs ground, 1:1 line).
+6. **Export** the enriched CSV (retrieved LST + ground LST + diff + emissivity).
+
+**Sample data** is in `samples/`:
+- `retrieved_sample.csv` — 9-site multi-network demo (SURFRAD ×7 + HiWATER ×2).
+- `validation_template.csv` — all 25 sites pre-filled (fill in time + your LST).
+
+**Linux note:** the GUI needs `libxcb-cursor0`:
+```bash
+sudo apt install -y libxcb-cursor0 libegl1 libgl1
+```
+
+## Library usage (script / notebook)
+
+Compute ground-truth LST for one site/time:
+
+```python
+from datetime import datetime, timezone
+from lstnet import compute_ground_lst, FixedEmissivity
+from lstnet.sites import get_site
+from lstnet.io.surfrad import SurfradReader
+
+site = get_site("psu")
+t = datetime(2011, 2, 12, 14, 30, tzinfo=timezone.utc)
+g = compute_ground_lst(site, t, FixedEmissivity(0.98), SurfradReader())
+print(g.lst_k, g.qc_flag)   # e.g. 270.15 OK
+```
+
+Validate ground truth against your retrieved LST:
+
+```python
+from lstnet import validate, TableRetrievedLST
+from lstnet.plotting import scatter_plot
+
+ground = [compute_ground_lst(s, t, FixedEmissivity(0.98), SurfradReader())
+          for s, t in your_site_times]
+result = validate(ground, TableRetrievedLST("your_retrieval.csv"))
+print(result.stats.bias, result.stats.rmse, result.stats.r)
+scatter_plot(result)   # retrieved-vs-ground with 1:1 line
+```
+
+`your_retrieval.csv` columns: `site, overpass_time_utc, lst_k[, source]`
+(`overpass_time_utc` = 12-digit `YYYYMMDDHHMM` or ISO 8601, UTC).
+
+## MCP server (AI agent integration)
+
+```bash
+lstnet-mcp        # start the FastMCP server
+```
+
+Exposes three tools that an AI agent (Claude Desktop, etc.) can call:
+`list_sites`, `compute_lst`, `validate_csv`.
+
+## Features
+
+- **Ground-truth LST** from SURFRAD (NOAA, HTTPS) / PKULSTNet / HiWATER
+  station data, at satellite overpass times (Stefan–Boltzmann radiance inversion).
+- **Emissivity sources**: `FixedEmissivity` (offline), `ModisDailyEmissivity`
+  (MYD21A1D/A1N C6.1, Ogawa 2004 broadband), `AsterGEDEmissivity`
+  (AG100 V003 climatological, Cheng & Liang 2014 broadband — recommended for
+  sub-K validation).
+- **Validation engine**: pair ground-truth + retrieved LST by `(site, overpass
+  time)` within a tolerance; bias / RMSE / Pearson R / regression; scatter +
+  time-series plots.
+- **GDAL-free**: MODIS HDF4 via `pyhdf`, ASTER GED HDF5 via `h5py`, GeoTIFF via
+  `rasterio` — all ship pip wheels, no system GDAL install.
+- Quality control (configurable `strict`), day/night (astral), credential
+  externalization, CWD-independent paths.
+- **Cross-platform**: tested on Windows / macOS / Linux via GitHub Actions CI.
+
+## Platform notes
+
+| Platform | Status | Notes |
+|----------|--------|-------|
+| Linux | ✅ Full | GUI needs `libxcb-cursor0 libegl1 libgl1` (apt install) |
+| macOS (Intel + Apple Silicon) | ✅ CI green | Native Qt backend; no extra libs |
+| Windows | ✅ CI green | Native Qt backend; no extra libs |
+
+All binary dependencies (pyhdf, h5py, rasterio, PySide6) ship pip wheels for
+all three platforms — no compilation needed.
+
+## Citing
+
+See [`CITATION.cff`](CITATION.cff).
+
+## License
+
+MIT — see [`LICENSE`](LICENSE).

lstnet-0.1.0/PRD.md

@@ -0,0 +1,99 @@
+# Product: LST
+# Current Version: 1.0.0
+# Last Updated: 2026-06-19
+# Status: active
+
+## 0. 使用说明
+> PRD 只管"造什么"：产品定义、范围、功能、进度、决策。
+> 技术架构/命令/规范 → `CLAUDE.md`；安装/部署/测试 → `README.md`。
+>
+> 更新规则：
+> - 长期稳定信息：直接覆盖更新，保持"当前真实状态"
+> - 短期流动信息：追加记录，保留时间线
+> - 每次任务结束前，检查是否需要更新本文件
+
+## 1. 当前快照
+
+- **当前阶段**: discovery
+- **当前目标**:
+- **下一步**:
+
+## 2. 当前进度
+> 路线图/阶段规划只在此处维护，不在 §5 重复。
+
+### 2.1 In Progress
+- [ ]
+
+### 2.2 Next Up
+- [ ]
+
+### 2.3 Blocked
+-
+
+## 3. 最近决策记录
+> 只保留最近 5-10 条仍然影响当前工作的决策。
+
+| Date | Decision | Why | Impact |
+|------|----------|-----|--------|
+| 2026-06-19 | 项目初始化 | 创建 PRD 文档 | 建立产品基线 |
+
+## 4. 版本历史
+> 规则：新版本追加在最上方。超过 5 个版本时，最旧的压缩为一行摘要。
+
+### **V1.0.0 - 2026-06-19 - (Initial Release)**
+- 项目初始化，创建 `PRD.md`
+
+## 5. 产品核心规范
+> 此区域始终反映产品"当前真实状态"，每次迭代直接更新。
+
+### 5.1 核心目标
+
+### 5.2 用户画像
+
+### 5.3 范围定义
+#### In Scope
+-
+
+#### Out of Scope
+-
+
+### 5.4 核心功能
+-
+
+### 5.5 领域实体
+> 描述业务数据模型，不绑定具体框架实现。
+
+### 5.6 业务用例
+> 描述业务规则与流程，不写技术实现细节。
+
+### 5.7 ASCII UI 原型图（可选）
+> 架构图和系统交互图放 `CLAUDE.md`，不放此处。
+
+### 5.8 技术实现规范
+> 仅保留"项目技术决策与质量标准"，不放 AI 代理行为规则。
+
+## 6. 当前风险与假设
+### 6.1 Risks
+-
+
+### 6.2 Assumptions
+-
+
+## 7. 工作日志
+> 只保留最近 5 条。更早的删除——git log 是权威来源。
+> 每条简短、事实化：背景 → 动作 → 结果 → 后续。
+
+### 2026-06-19 - 项目初始化
+- 创建 PRD.md 文档
+
+## 8. 并行开发记录
+
+> **规则**：worktree 中只能编辑当前分支名的子节；全局内容只能回 main 修改。
+> 分支合并后，将结论吸收到正式章节，删除该分支子节。每个子节只记 3 项：进展、卡点、是否影响全局设计。
+
+<!-- 活跃分支在此添加子节，格式：
+### <branch-name>
+- **进展**：
+- **卡点**：
+- **影响全局**：是/否，说明：
+-->

lstnet-0.1.0/Pipfile

@@ -0,0 +1,34 @@
+[[source]]
+url = "https://pypi.tuna.tsinghua.edu.cn/simple/"
+verify_ssl = true
+name = "pypi"
+
+[packages]
+sys = "*"
+pytz = "*"
+pandas = "*"
+os = "*"
+io = "*"
+random = "*"
+requests = "*"
+astral = "*"
+glob = "*"
+urllib-request = "*"
+shutil = "*"
+numpy = "*"
+matplotlib-pyplot = "*"
+osgeo = "*"
+"bs4" = "*"
+DateTime = "*"
+"PyQt5" = "*"
+PIL = "*"
+pyModis = "*"
+matplotlib = "*"
+gdal = {path = "C:/Users/85816/Desktop/GDAL-3.2.1-cp38-cp38-win_amd64.whl"}
+lxml = "*"
+openpyxl = "*"
+
+[dev-packages]
+
+[requires]
+python_version = "3.8"