panzr 0.2.5__tar.gz

panzr-0.2.5/.claude/settings.local.json

@@ -0,0 +1,14 @@
+{
+  "permissions": {
+    "allow": [
+      "mcp__codegraph__codegraph_files",
+      "mcp__codegraph__codegraph_context",
+      "WebFetch(domain:harlequin.sh)",
+      "WebSearch",
+      "Bash(pip show *)",
+      "Bash(python3 -c \"import harlequin; print\\(dir\\(harlequin\\)\\)\")",
+      "Bash(python3 -c \"import harlequin; print\\(harlequin.__file__\\)\")",
+      "Bash(python3 *)"
+    ]
+  }
+}

panzr-0.2.5/.gitignore

@@ -0,0 +1,18 @@
+__pycache__/
+*.py[cod]
+*.egg-info/
+dist/
+build/
+.eggs/
+*.so
+.pytest_cache/
+.ruff_cache/
+.mypy_cache/
+*.swp
+*.swo
+*~
+.DS_Store
+venv/
+.venv/
+.env
+test_log.txt

panzr-0.2.5/PKG-INFO

@@ -0,0 +1,149 @@
+Metadata-Version: 2.4
+Name: panzr
+Version: 0.2.5
+Summary: Armored Analytics in Your Terminal — 终端数据分析驾驶舱
+Author-email: Song <song@example.com>
+License: MIT
+Keywords: cli,csv,data-analysis,duckdb,polars,sql,terminal,tui
+Classifier: Development Status :: 3 - Alpha
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: Intended Audience :: Science/Research
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Scientific/Engineering :: Information Analysis
+Classifier: Topic :: Scientific/Engineering :: Visualization
+Requires-Python: >=3.10
+Requires-Dist: duckdb>=1.0.0
+Requires-Dist: openai>=1.0.0
+Requires-Dist: plotext>=5.0.0
+Requires-Dist: polars>=1.0.0
+Requires-Dist: rich>=13.0.0
+Requires-Dist: textual>=0.52.0
+Provides-Extra: dev
+Requires-Dist: pytest-asyncio>=0.23; extra == 'dev'
+Requires-Dist: pytest>=8.0; extra == 'dev'
+Provides-Extra: full
+Requires-Dist: harlequin; extra == 'full'
+Requires-Dist: jq; extra == 'full'
+Requires-Dist: visidata; extra == 'full'
+Provides-Extra: harlequin
+Requires-Dist: harlequin; extra == 'harlequin'
+Provides-Extra: visidata
+Requires-Dist: visidata; extra == 'visidata'
+Description-Content-Type: text/markdown
+
+# 🐼🔧 Panzr v0.2.4
+
+**Armored Analytics in Your Terminal.** 终端里的装甲数据分析。
+
+> Panzr 是你的终端数据分析驾驶舱。
+> *"Your Terminal Data Cockpit."*
+
+---
+
+## 产品定位
+
+Panzr 是一个 **TUI (Terminal User Interface)** 数据分析工具箱。底层整合 DuckDB、Polars、plotext 等成熟引擎，Panzr 本身只负责：菜单导航、参数拼装、流程串联、结果展示。
+
+**v0.2.4** 核心升级：**DuckDB 成为唯一数据引擎**。文件组注册为 DuckDB View（零内存），探查/聚合/SQL 统一走 DuckDB。新增 LLM 自然语言生成 SQL。
+
+---
+
+## 功能矩阵
+
+| Tab | 功能 | 底层引擎 |
+|:---|:---|:---|
+| 🔌 **连接** | 扫描目录、关键词搜索分组、多选加载、DuckDB View 注册 | DuckDB + Polars |
+| 🔍 **探查** | Polars 管道 (筛选→排序→去重→选列), 懒加载, 三段式布局 | Polars Lazy |
+| 📝 **SQL** | DuckDB 查询, DataCatalog + 编辑器 + 结果, Harlequin 布局 | DuckDB |
+| 🤖 **AI SQL** | 自然语言 → SQL (DeepSeek), 自动注入表结构 | LLM |
+| 📊 **聚合** | 跨文件 GROUP BY, 多聚合函数, DuckDB 全量扫描 | DuckDB |
+| 📈 **可视化** | 柱状图/折线图/散点图/直方图, 终端渲染 | plotext |
+| 📋 **报告** | 一键数据诊断报告 (Data Profile) | DuckDB + Rich |
+
+---
+
+## 安装
+
+```bash
+pip install -e .
+```
+
+依赖: `textual` `duckdb` `polars` `plotext` `rich` `openai`
+
+外部工具 (可选): `visidata` `harlequin` `jq`
+
+### LLM SQL 生成
+
+```bash
+export DEEPSEEK_API_KEY=sk-你的key
+```
+
+---
+
+## 使用
+
+```bash
+panzr
+# 自动加载目录
+panzr --load ~/FinData/资金结算
+# 加载 siku 插件
+panzr --siku
+```
+
+### 典型工作流
+
+```
+扫描目录 → 多选分组 → DuckDB View 注册 (全量零内存)
+  → 探查 (Polars lazy 管道, limit 500)
+  → SQL (AI 生成或手写, 全量查询)
+  → 聚合 (跨文件 GROUP BY)
+  → 可视化
+```
+
+---
+
+## 快捷键
+
+| 快捷键 | 功能 |
+|:---|:---|
+| `Ctrl+Q` / `Ctrl+C` | 退出 Panzr |
+| `Ctrl+T` | 下一个 Tab |
+| `Ctrl+P` | 上一个 Tab |
+| `Ctrl+Enter` | 执行 SQL 查询 |
+
+---
+
+## 项目结构
+
+```
+panzr/
+├── app.py                  # 主 App + CSS + 快捷键
+├── state.py                # 全局数据上下文 (AppState)
+├── startup_check.py        # 启动环境检测器
+├── engines/
+│   ├── loader.py           # 文件扫描 + 分组
+│   ├── duckdb_engine.py    # DuckDB 查询引擎
+│   ├── harlequin_launcher.py  # Harlequin 子进程启动
+│   ├── llm.py              # LLM SQL 生成 (DeepSeek)
+│   └── exporter.py         # 导出
+└── tabs/
+    ├── connect.py          # 连接 Tab (扫描+多选+DuckDB)
+    ├── explore.py          # 探查 Tab (Polars lazy 管道)
+    ├── query.py            # SQL Tab (DataCatalog 布局)
+    ├── aggregate.py        # 聚合 Tab (DuckDB GROUP BY)
+    ├── vision.py           # 可视化 Tab (plotext)
+    └── report.py           # 报告 Tab (Rich)
+```
+
+---
+
+## License
+
+MIT

panzr-0.2.5/PLAN.md

@@ -0,0 +1,188 @@
+# Panzr — 产品方案 v1.0
+
+> **"Armored Analytics in Your Terminal."**
+> 终端里的装甲数据分析。
+
+---
+
+## 一、产品定位
+
+**Panzr 不是新轮子，是所有轮子的引擎盖。**
+
+Panzr 是一个终端数据分析驾驶舱（Terminal Data Cockpit），核心理念是**统一入口 + 编排现有利器**。数据处理、可视化、探索全部调用成熟 CLI 工具或 Python 库，Panzr 本身只负责：菜单导航、参数拼装、流程串联、结果展示。
+
+| 你的痛点 | Panzr 的解法 |
+| :--- | :--- |
+| 记不住 `mlr` / `csvstat` / `vd` 的参数 | 菜单选择，自动翻译成命令 |
+| 多个工具之间数据上下文断裂 | 共享数据上下文，记住当前数据集、列名、筛选状态 |
+| 分析流程割裂，来回切换窗口 | 一个 TUI 内完成 加载→探查→查询→可视化→导出 |
+
+### 产品形象
+
+- **核心形象**：一只戴着护目镜的熊猫，驾驶微型坦克。
+- **坦克炮管**：设计成笔/绘图仪，射出柱状图和折线，而非炮弹。
+- **配色**：终端绿 + 数据蓝 + 熊猫黑白。
+
+---
+
+## 二、核心架构：Panzr 的六块"装甲"
+
+每个模块都标注了底层引擎和 Panzr 提供的增量价值。
+
+### 模块一览
+
+| 装甲模块 | 底层引擎 | Panzr 提供的价值 |
+| :--- | :--- | :--- |
+| **① Panzr-Connect** 数据连接 | pandas / DuckDB 导入 | 统一表单：CSV、Parquet、SQLite、API 一键加载，自动识别 schema |
+| **② Panzr-Explore** 数据探查 | **Visidata** (`vd`) | 一键唤起 Visidata，预设分析宏（频率统计、缺失值定位），退出后结果带回 Panzr |
+| **③ Panzr-Query** SQL 分析 | **DuckDB** (内嵌) | TUI 内写 SQL，直接查 CSV/Parquet，结果 DataTable 展示，一键导出 |
+| **④ Panzr-Transform** 数据转换 | **Miller** (`mlr`) / csvkit / xsv | 菜单选择 → 自动翻译成 `mlr` 命令，告别手写参数 |
+| **⑤ Panzr-Vision** 可视化 | **plotext** / termgraph | 选择 X/Y 列 + 图表类型，终端实时出图，代码自动生成可复用 |
+| **⑥ Panzr-Report** 报告生成 | **csvstat** / Rich | 一键诊断：描述性统计、缺失值、分布概览，高亮格式化输出为 Markdown |
+
+### 全部集成的"轮子"
+
+```
+Visidata    — 终端交互式表格探索（核心体验）
+DuckDB      — SQL on CSV/Parquet/SQLite（查询引擎）
+Miller      — 结构化数据处理，awk for CSV/JSON（转换引擎）
+csvkit      — CSV 列操作、过滤、统计（辅助工具链）
+xsv         — 极速 CSV 切片/统计/join（性能敏感场景）
+jq          — JSON 查询与转换（API 数据预处理）
+fx          — JSON 交互式浏览（可选独立启动）
+plotext     — 终端直方图、折线图、柱状图（可视化核心）
+termgraph   — 终端柱状图补充（备选引擎）
+Rich        — 终端美化渲染（表格、Markdown、语法高亮）
+```
+
+---
+
+## 三、技术架构
+
+### 技术选型
+
+- **TUI 框架**：[Textual](https://github.com/Textualize/textual) — Python 生态最成熟的终端 UI 框架
+- **异步执行**：`asyncio.create_subprocess_exec` — 所有外部工具非阻塞调用，界面不卡死
+- **数据上下文**：内存中维护当前数据集路径、列名 schema、筛选状态，各模块共享
+
+### 应用骨架
+
+```python
+from textual.app import App
+from textual.widgets import TabbedContent, TabPane, DataTable, Input, Button
+
+class Panzr(App):
+    CSS = """
+    #results { height: 1fr; }
+    """
+
+    def compose(self):
+        with TabbedContent():
+            with TabPane("🔌 连接", id="connect"):
+                yield Input(placeholder="文件路径 或 URL")
+                yield Button("加载", variant="primary")
+            with TabPane("🔍 探查", id="explore"):
+                yield Button("打开 Visidata", variant="primary")
+                yield DataTable(id="preview")
+            with TabPane("📝 SQL", id="query"):
+                yield Input(placeholder="SELECT ... FROM ...")
+                yield Button("执行", variant="primary")
+                yield DataTable(id="results")
+            with TabPane("🔄 转换", id="transform"):
+                ...  # 列选择 + 操作菜单 → 翻译为 mlr 命令
+            with TabPane("📊 可视化", id="vision"):
+                ...  # X/Y 列选择器 + 图表类型 + plotext 渲染区
+            with TabPane("📋 报告", id="report"):
+                ...  # 一键生成统计报告
+```
+
+### 两个关键机制
+
+1. **上下文记忆** — 加载数据后，全局 State 记住：当前文件路径、列名列表、列类型、最近筛选条件。所有 Tab 共享这份上下文，切换模块无需重新指定。
+2. **命令翻译** — 用户在 UI 里的操作（选列、选聚合函数、设阈值），自动翻译为底层命令：
+   - 选 "region 列 + COUNT" → `mlr --csv count-distinct -f region`
+   - 选 "amount > 1000" → `mlr --csv filter '$amount > 1000'`
+
+---
+
+## 四、典型工作流
+
+```
+┌─ Panzr ─────────────────────────────────────────────┐
+│ [🔌连接] [🔍探查] [📝SQL] [🔄转换] [📊可视化] [📋报告] │
+├──────────────────────────────────────────────────────┤
+│                                                      │
+│  1. 连接：加载 sales_2024.csv                        │
+│       ↓                                              │
+│  2. 探查：按 V 键 → 唤起 Visidata，浏览全貌          │
+│       ↓                                              │
+│  3. SQL：  SELECT region, SUM(amount)                │
+│            FROM sales_2024 GROUP BY region           │
+│            → 结果表格展示在下方                       │
+│       ↓                                              │
+│  4. 可视化：选 X=region, Y=SUM(amount), 柱状图       │
+│            → 终端右侧实时出图                         │
+│       ↓                                              │
+│  5. 导出：Ctrl+E → Markdown 报告（图表+表格+统计）   │
+│                                                      │
+└──────────────────────────────────────────────────────┘
+```
+
+整个过程不离开终端，不手写复杂命令，不为每个工具装 GUI。
+
+---
+
+## 五、分阶段路线图
+
+### Phase 1：最小可用 — "能跑的驾驶舱" 🚗
+
+- [x] 产品定位与架构方案（本文档）
+- [ ] Textual 骨架：TabbedContent 六页签空壳
+- [ ] 数据连接模块：文件选择 → pandas 加载 → schema 识别
+- [ ] Visidata 一键唤起：`subprocess` 启动 `vd <当前文件>`
+- [ ] DuckDB SQL 面板：输入 SQL → 内嵌 duckdb 执行 → DataTable 展示
+
+**目标**：能在终端里加载 CSV、打开 Visidata、写 SQL 查数据。
+
+### Phase 2：体验打磨 — "好用的驾驶舱" ✨
+
+- [ ] 上下文记忆机制：全局 State，Tab 间共享列名/schema
+- [ ] Miller 命令翻译器：菜单选择操作 → 自动拼装 `mlr` 命令
+- [ ] plotext 可视化面板：X/Y 列下拉选择 + 图表类型切换 + 实时渲染
+- [ ] 一键报告：csvstat 统计 + Rich 美化 → Markdown 导出
+- [ ] 结果导出：CSV / Markdown / JSON 多格式
+
+**目标**：完成六模块闭环，上下文串联，不记命令完成全流程。
+
+### Phase 3：杀手功能 — "聪明的驾驶舱" 🧠
+
+- [ ] **自然语言 → 分析命令**：用 LLM（OpenAI API 或本地模型）把 "帮我看看销售额大于 1000 的订单按地区分布" 翻译成 `mlr --csv filter '$sales > 1000' then count-distinct -f region`，自动执行并展示
+- [ ] 流程录制与回放：记录分析步骤 → 保存为 Pipeline → 一键重放
+- [ ] 多数据源 JOIN：跨 CSV / SQLite / API 数据联合查询
+
+**目标**：从"工具箱"升级为"数据分析副驾驶"。
+
+### Phase 4：生态与分发 🌐
+
+- [ ] `pip install panzr` 可安装
+- [ ] 配置文件 `~/.panzr.yaml`：自定义快捷键、预设分析流程
+- [ ] 插件机制：社区贡献新的数据源连接器或分析模块
+- [ ] Homebrew / apt 分发
+
+---
+
+## 六、README 结构（发布时）
+
+1. **封面**：Panzr 大标题 + 标语 + 熊猫坦克 ASCII Art
+2. **理念**："为什么不造新轮子" — 一句话讲清楚
+3. **Demo GIF**：展示完整工作流（加载→探查→SQL→可视化→导出）
+4. **安装**：`pip install panzr` 或 `git clone`
+5. **模块介绍**：六模块逐一说明，每个标注 "Powered by Visidata / DuckDB / Miller / ..."
+6. **路线图**：Phase 1–4，标注当前进度
+7. **贡献指南**：如何添加新模块/新引擎
+
+---
+
+## 七、一句话总结
+
+> **Panzr 是你的终端数据分析副驾驶 — 整合了 Visidata、DuckDB、Miller 等神器的统一界面。我们不造轮子，我们是所有轮子的引擎盖。**

panzr-0.2.5/README.md

@@ -0,0 +1,109 @@
+# 🐼🔧 Panzr v0.2.4
+
+**Armored Analytics in Your Terminal.** 终端里的装甲数据分析。
+
+> Panzr 是你的终端数据分析驾驶舱。
+> *"Your Terminal Data Cockpit."*
+
+---
+
+## 产品定位
+
+Panzr 是一个 **TUI (Terminal User Interface)** 数据分析工具箱。底层整合 DuckDB、Polars、plotext 等成熟引擎，Panzr 本身只负责：菜单导航、参数拼装、流程串联、结果展示。
+
+**v0.2.4** 核心升级：**DuckDB 成为唯一数据引擎**。文件组注册为 DuckDB View（零内存），探查/聚合/SQL 统一走 DuckDB。新增 LLM 自然语言生成 SQL。
+
+---
+
+## 功能矩阵
+
+| Tab | 功能 | 底层引擎 |
+|:---|:---|:---|
+| 🔌 **连接** | 扫描目录、关键词搜索分组、多选加载、DuckDB View 注册 | DuckDB + Polars |
+| 🔍 **探查** | Polars 管道 (筛选→排序→去重→选列), 懒加载, 三段式布局 | Polars Lazy |
+| 📝 **SQL** | DuckDB 查询, DataCatalog + 编辑器 + 结果, Harlequin 布局 | DuckDB |
+| 🤖 **AI SQL** | 自然语言 → SQL (DeepSeek), 自动注入表结构 | LLM |
+| 📊 **聚合** | 跨文件 GROUP BY, 多聚合函数, DuckDB 全量扫描 | DuckDB |
+| 📈 **可视化** | 柱状图/折线图/散点图/直方图, 终端渲染 | plotext |
+| 📋 **报告** | 一键数据诊断报告 (Data Profile) | DuckDB + Rich |
+
+---
+
+## 安装
+
+```bash
+pip install -e .
+```
+
+依赖: `textual` `duckdb` `polars` `plotext` `rich` `openai`
+
+外部工具 (可选): `visidata` `harlequin` `jq`
+
+### LLM SQL 生成
+
+```bash
+export DEEPSEEK_API_KEY=sk-你的key
+```
+
+---
+
+## 使用
+
+```bash
+panzr
+# 自动加载目录
+panzr --load ~/FinData/资金结算
+# 加载 siku 插件
+panzr --siku
+```
+
+### 典型工作流
+
+```
+扫描目录 → 多选分组 → DuckDB View 注册 (全量零内存)
+  → 探查 (Polars lazy 管道, limit 500)
+  → SQL (AI 生成或手写, 全量查询)
+  → 聚合 (跨文件 GROUP BY)
+  → 可视化
+```
+
+---
+
+## 快捷键
+
+| 快捷键 | 功能 |
+|:---|:---|
+| `Ctrl+Q` / `Ctrl+C` | 退出 Panzr |
+| `Ctrl+T` | 下一个 Tab |
+| `Ctrl+P` | 上一个 Tab |
+| `Ctrl+Enter` | 执行 SQL 查询 |
+
+---
+
+## 项目结构
+
+```
+panzr/
+├── app.py                  # 主 App + CSS + 快捷键
+├── state.py                # 全局数据上下文 (AppState)
+├── startup_check.py        # 启动环境检测器
+├── engines/
+│   ├── loader.py           # 文件扫描 + 分组
+│   ├── duckdb_engine.py    # DuckDB 查询引擎
+│   ├── harlequin_launcher.py  # Harlequin 子进程启动
+│   ├── llm.py              # LLM SQL 生成 (DeepSeek)
+│   └── exporter.py         # 导出
+└── tabs/
+    ├── connect.py          # 连接 Tab (扫描+多选+DuckDB)
+    ├── explore.py          # 探查 Tab (Polars lazy 管道)
+    ├── query.py            # SQL Tab (DataCatalog 布局)
+    ├── aggregate.py        # 聚合 Tab (DuckDB GROUP BY)
+    ├── vision.py           # 可视化 Tab (plotext)
+    └── report.py           # 报告 Tab (Rich)
+```
+
+---
+
+## License
+
+MIT

panzr-0.2.5/panzr/__init__.py

@@ -0,0 +1,3 @@
+"""Panzr — Armored Analytics in Your Terminal."""
+
+__version__ = "0.2.5"

panzr-0.2.5/panzr/__main__.py

@@ -0,0 +1,39 @@
+"""Allow running as `python -m panzr`.
+
+Examples:
+    python -m panzr                              # vanilla
+    python -m panzr --siku                       # + siku-scope tabs
+    python -m panzr --siku --load ~/FinData      # auto-load directory
+"""
+
+import argparse
+
+
+def main() -> None:
+    parser = argparse.ArgumentParser(
+        description="Panzr — Armored Analytics in Your Terminal",
+    )
+    parser.add_argument(
+        "--siku", action="store_true",
+        help="加载 siku-scope 插件 (资金流水 + 账户核对)",
+    )
+    parser.add_argument(
+        "--load", metavar="DIR",
+        help="启动时自动扫描并加载指定目录下的数据文件",
+    )
+    args, _ = parser.parse_known_args()
+
+    from panzr.app import PanzrApp
+
+    plugins = []
+    if args.siku:
+        plugins.append("siku")
+
+    PanzrApp.activate_plugins(plugins)
+
+    app = PanzrApp(auto_load_dir=args.load)
+    app.run()
+
+
+if __name__ == "__main__":
+    main()