tmailday 0.1.0__tar.gz

tmailday-0.1.0/.gitignore

@@ -0,0 +1,10 @@
+# Python-generated files
+__pycache__/
+*.py[oc]
+build/
+dist/
+wheels/
+*.egg-info
+
+# Virtual environments
+.venv

tmailday-0.1.0/.openmcp/connection.json

@@ -0,0 +1,75 @@
+{
+  "items": [
+    [
+      {
+        "connectionType": "STDIO",
+        "command": "uv",
+        "args": [
+          "run",
+          "tmday",
+          "serve"
+        ],
+        "url": "",
+        "cwd": "D:/tmailday",
+        "oauth": "",
+        "clientName": "openmcp.connect.STDIO",
+        "clientVersion": "0.0.1",
+        "env": {
+          "HOME": "C:\\Users\\Administrator",
+          "LOGNAME": "Administrator",
+          "PATH": "C:\\Program Files\\ShadowBot;C:\\Python314\\Scripts\\;C:\\Python314\\;C:\\Windows\\system32;C:\\Windows;C:\\Windows\\System32\\Wbem;C:\\Windows\\System32\\WindowsPowerShell\\v1.0\\;C:\\Windows\\System32\\OpenSSH\\;C:\\Program Files\\nodejs\\;C:\\ProgramData\\chocolatey\\bin;C:\\Program Files\\Git\\cmd;C:\\Program Files\\TortoiseGit\\bin;C:\\Program Files\\WireGuard\\;C:\\Program Files\\dotnet\\;C:\\ProgramData\\ComposerSetup\\bin;C:\\Program Files\\Git\\bin;C:\\Program Files\\ShadowBot;C:\\Users\\Administrator\\.local\\bin;C:\\Users\\Administrator\\AppData\\Local\\Microsoft\\WindowsApps;C:\\Users\\Administrator\\AppData\\Roaming\\npm;D:\\VS Code\\bin;C:\\Users\\Administrator\\.lmstudio\\bin;C:\\Users\\Administrator\\AppData\\Local\\Programs\\Ollama;D:\\phpstudy_pro\\Extensions\\php\\php8.0.2nts;C:\\Users\\Administrator\\AppData\\Roaming\\Composer\\vendor\\bin;C:\\Program Files\\Wukong\\0.9.51-26052503\\bin\\dingsync;C:\\Users\\Administrator\\AppData\\Local\\Microsoft\\WinGet\\Packages\\Anthropic.ClaudeCode_Microsoft.Winget.Source_8wekyb3d8bbwe;C:\\Users\\Administrator\\AppData\\Local\\Microsoft\\WinGet\\Links;C:\\Users\\Administrator\\.bun\\bin;D:\\MiniClaude;C:\\Users\\Administrator\\AppData\\Local\\rmux\\bin;",
+          "SHELL": "C:\\Windows\\system32\\cmd.exe",
+          "TERM": "未设置 (Windows 默认终端)",
+          "USER": "Administrator"
+        },
+        "serverInfo": {
+          "name": "tmailday",
+          "version": "3.4.2"
+        },
+        "name": "tmailday",
+        "version": "3.4.2"
+      }
+    ],
+    [
+      {
+        "connectionType": "STDIO",
+        "name": "STDIO-1781335265906",
+        "command": "uv",
+        "args": [
+          "run",
+          "tmday",
+          "serve"
+        ],
+        "cwd": "D:\\tmailday",
+        "filePath": "D:\\tmailday\\tmday",
+        "commandString": "uv run tmday serve"
+      }
+    ],
+    [
+      {
+        "connectionType": "SSE",
+        "command": "",
+        "args": [],
+        "url": "http://127.0.0.1:8000/sse",
+        "cwd": "",
+        "oauth": "",
+        "clientName": "openmcp.connect.SSE",
+        "clientVersion": "0.0.1",
+        "env": {
+          "HOME": "C:\\Users\\Administrator",
+          "LOGNAME": "Administrator",
+          "PATH": "C:\\Program Files\\ShadowBot;C:\\Python314\\Scripts\\;C:\\Python314\\;C:\\Windows\\system32;C:\\Windows;C:\\Windows\\System32\\Wbem;C:\\Windows\\System32\\WindowsPowerShell\\v1.0\\;C:\\Windows\\System32\\OpenSSH\\;C:\\Program Files\\nodejs\\;C:\\ProgramData\\chocolatey\\bin;C:\\Program Files\\Git\\cmd;C:\\Program Files\\TortoiseGit\\bin;C:\\Program Files\\WireGuard\\;C:\\Program Files\\dotnet\\;C:\\ProgramData\\ComposerSetup\\bin;C:\\Program Files\\Git\\bin;C:\\Program Files\\ShadowBot;C:\\Users\\Administrator\\.local\\bin;C:\\Users\\Administrator\\AppData\\Local\\Microsoft\\WindowsApps;C:\\Users\\Administrator\\AppData\\Roaming\\npm;D:\\VS Code\\bin;C:\\Users\\Administrator\\.lmstudio\\bin;C:\\Users\\Administrator\\AppData\\Local\\Programs\\Ollama;D:\\phpstudy_pro\\Extensions\\php\\php8.0.2nts;C:\\Users\\Administrator\\AppData\\Roaming\\Composer\\vendor\\bin;C:\\Program Files\\Wukong\\0.9.51-26052503\\bin\\dingsync;C:\\Users\\Administrator\\AppData\\Local\\Microsoft\\WinGet\\Packages\\Anthropic.ClaudeCode_Microsoft.Winget.Source_8wekyb3d8bbwe;C:\\Users\\Administrator\\AppData\\Local\\Microsoft\\WinGet\\Links;C:\\Users\\Administrator\\.bun\\bin;D:\\MiniClaude;C:\\Users\\Administrator\\AppData\\Local\\rmux\\bin;",
+          "SHELL": "C:\\Windows\\system32\\cmd.exe",
+          "TERM": "未设置 (Windows 默认终端)",
+          "USER": "Administrator"
+        },
+        "serverInfo": {
+          "name": "tmailday",
+          "version": "3.4.2"
+        },
+        "name": "tmailday",
+        "version": "3.4.2"
+      }
+    ]
+  ]
+}

tmailday-0.1.0/.openmcp/tabs.tmailday.json

@@ -0,0 +1,85 @@
+{
+  "clientId": "05615852-5852-515852d450a-815852d450aa0e8-aa0e831a",
+  "currentIndex": 1,
+  "tabs": [
+    {
+      "name": "工具",
+      "icon": "icon-tool",
+      "type": "blank",
+      "componentIndex": 2,
+      "storage": {
+        "activeNames": [
+          0
+        ],
+        "autoDetectDiagram": {
+          "edges": [],
+          "views": []
+        },
+        "formData": {
+          "template_path": "D:\\tmailday\\测试数据\\日报模板06月.xlsx",
+          "source_paths": [
+            "D:\\tmailday\\测试数据\\日报__20260612_0ffef6cae49818857d2d60ca1d0a9632.xlsx",
+            "D:\\tmailday\\测试数据\\【生意参谋平台】商品_全部_2026-06-11_2026-06-11.xls"
+          ],
+          "output_path": ""
+        },
+        "currentToolName": "process_table_batch",
+        "lastToolCallResponse": {
+          "_meta": {
+            "fastmcp": {
+              "wrap_result": true
+            }
+          },
+          "content": [
+            {
+              "type": "text",
+              "text": "处理完成：2 个文件 → D:\\tmailday\\测试数据\\日报模板06月.xlsx"
+            }
+          ],
+          "structuredContent": {
+            "result": "处理完成：2 个文件 → D:\\tmailday\\测试数据\\日报模板06月.xlsx"
+          },
+          "isError": false
+        }
+      }
+    },
+    {
+      "name": "工具",
+      "icon": "icon-tool",
+      "type": "blank",
+      "componentIndex": 2,
+      "storage": {
+        "activeNames": [
+          0
+        ],
+        "autoDetectDiagram": {
+          "edges": [],
+          "views": []
+        },
+        "formData": {
+          "template_path": "D:\\tmailday\\测试数据\\日报模板06月.xlsx",
+          "source_path": "D:\\tmailday\\测试数据\\商品报表_20260612_173510.zip",
+          "output_path": ""
+        },
+        "currentToolName": "process_table",
+        "lastToolCallResponse": {
+          "_meta": {
+            "fastmcp": {
+              "wrap_result": true
+            }
+          },
+          "content": [
+            {
+              "type": "text",
+              "text": "处理完成：D:\\tmailday\\测试数据\\商品报表_20260612_173510.zip → D:\\tmailday\\测试数据\\日报模板06月.xlsx"
+            }
+          ],
+          "structuredContent": {
+            "result": "处理完成：D:\\tmailday\\测试数据\\商品报表_20260612_173510.zip → D:\\tmailday\\测试数据\\日报模板06月.xlsx"
+          },
+          "isError": false
+        }
+      }
+    }
+  ]
+}

tmailday-0.1.0/.openmcp/tabs.untitle.json

@@ -0,0 +1,4 @@
+{
+  "tabs": [],
+  "currentIndex": -1
+}

tmailday-0.1.0/.python-version

@@ -0,0 +1 @@
+3.12

tmailday-0.1.0/AGENTS.md

@@ -0,0 +1,65 @@
+# AGENTS.md
+
+## 项目概述
+
+表格数据处理工具。读取导出的数据表格 → 处理数据 → 按数据来源写入模板文件对应工作薄。
+
+## 技术栈
+
+- **Python >= 3.12**（`.python-version` 锁定 `3.12`）
+- **包管理器**: `uv`（非 pip/poetry）— 见 `pyproject.toml` 和 `uv.lock`
+- **框架**: [FastMCP](https://github.com/jlowin/fastmcp) `>=3.4.2`，用于构建 MCP Server
+- **表格处理**: `openpyxl>=3.1` (.xlsx), `xlrd>=2.0` (.xls)
+- **编码检测**: `chardet>=5.0` (CSV 文件编码自动识别)
+- **内置模块**: `csv` (CSV 读写), `zipfile` (ZIP 解压), `argparse` (CLI)
+
+## 常用命令
+
+```bash
+uv sync                    # 安装/同步依赖
+uv run tmday --help        # 查看 CLI 帮助
+uv run tmday <模板> <数据1> <数据2> ...          # 批量处理，原地更新模板
+uv run tmday <模板> <数据> -o <输出>              # 处理后输出到指定文件
+uv run tmday serve         # 启动 MCP Server (stdio)
+uv run tmday serve --transport sse  # 启动 MCP HTTP Server
+uv add <package>           # 添加依赖
+```
+
+## 项目结构
+
+```
+tmday/                  # 主包（CLI 可独立运行，见 pyproject.toml [project.scripts]）
+├── __init__.py         # 版本号
+├── __main__.py         # python -m tmday → CLI
+├── cli.py              # CLI 定义 (argparse)，子命令 process / serve
+├── server.py           # FastMCP 实例 + @mcp.tool() 装饰器
+└── core/               # 核心逻辑（CLI 和 MCP 共享）
+    ├── reader.py       # 读取源表格 → dict
+    ├── processor.py    # 编排：读取 → 处理 → 写入
+    └── writer.py       # 写入模板工作簿
+```
+
+## 三种入口
+
+| 入口 | 命令 | 说明 |
+|------|------|------|
+| CLI | `tmday <模板> [数据...] [-o 输出]` | 批量处理，模板第一个参数 |
+| MCP STDIO | `tmday serve` | MCP stdio 传输（也支持 `uvx tmailday serve`） |
+| MCP HTTP | `tmday serve --transport sse` | MCP HTTP(SSE) 传输 |
+
+**CLI 逻辑**：
+- 第一个参数：模板文件
+- 后续参数：数据文件（可选多个），逐个检测类型后处理
+- `-o` 指定输出路径，缺省则覆盖模板文件
+
+**MCP tools**：
+- `process_table(template_path, source_path, output_path?)` — SSE 单文件处理
+- `process_table_batch(template_path, source_paths, output_path?)` — 批量处理
+
+## 架构约定
+
+- **核心逻辑共享**: `cli.py` 和 `server.py` 都调用 `core/` 中的函数，仅入口层不同
+- **表格文件作为参数传入**，不硬编码路径
+- **MCP tools**: 在 `server.py` 用 `@mcp.tool()` 装饰 `core/` 函数
+- **虚拟环境**: `.venv/`（已在 `.gitignore` 排除）
+- **构建**: hatchling，手动指定 `packages = ["tmday"]`（项目名 `tmailday` ≠ 包目录名 `tmday`）

tmailday-0.1.0/PKG-INFO

@@ -0,0 +1,9 @@
+Metadata-Version: 2.4
+Name: tmailday
+Version: 0.1.0
+Summary: 表格数据处理工具 — 读取导出数据，按来源写入模板工作簿
+Requires-Python: >=3.12
+Requires-Dist: chardet>=7.4.3
+Requires-Dist: fastmcp>=3.4.2
+Requires-Dist: openpyxl>=3.1
+Requires-Dist: xlrd>=2.0

tmailday-0.1.0/pyproject.toml

@@ -0,0 +1,25 @@
+[project]
+name = "tmailday"
+version = "0.1.0"
+description = "表格数据处理工具 — 读取导出数据，按来源写入模板工作簿"
+readme = "README.md"
+requires-python = ">=3.12"
+dependencies = [
+    "chardet>=7.4.3",
+    "fastmcp>=3.4.2",
+    "openpyxl>=3.1",
+    "xlrd>=2.0",
+]
+
+[project.scripts]
+tmday = "tmday.cli:main"
+
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[tool.hatch.build.targets.wheel]
+packages = ["tmday"]
+
+[tool.uv]
+package = true

tmailday-0.1.0/tmday/__init__.py

@@ -0,0 +1 @@
+__version__ = "0.1.0"

tmailday-0.1.0/tmday/__main__.py

@@ -0,0 +1,3 @@
+from tmday.cli import main
+
+main()

tmailday-0.1.0/tmday/cli.py

@@ -0,0 +1,56 @@
+"""CLI 入口 — tmailday 表格数据处理工具
+
+用法:
+    tmday <模板文件> [数据文件...] [-o 输出文件]
+    tmday serve [--transport {stdio,sse}]
+"""
+
+import argparse
+import sys
+
+
+def main():
+    # 特殊处理 serve 子命令
+    if len(sys.argv) > 1 and sys.argv[1] == "serve":
+        parser = argparse.ArgumentParser(prog="tmday serve", description="启动 MCP Server")
+        parser.add_argument(
+            "serve", nargs="?", default="serve", help=argparse.SUPPRESS,
+        )
+        parser.add_argument(
+            "--transport", default="stdio", choices=["stdio", "sse"],
+            help="传输协议 (default: stdio)",
+        )
+        args = parser.parse_args(sys.argv[1:])
+        from tmday.server import mcp
+
+        mcp.run(transport=args.transport)
+        return
+
+    parser = argparse.ArgumentParser(
+        prog="tmday",
+        description="表格数据处理工具 — 将数据文件按类型填入模板对应工作簿",
+    )
+    parser.add_argument("template", help="模板文件路径 (.xlsx)")
+    parser.add_argument("sources", nargs="*", help="数据文件路径（日报/生意参谋/商品报表）")
+    parser.add_argument(
+        "-o", "--output", default=None,
+        help="输出文件路径（默认原地更新模板）",
+    )
+
+    args = parser.parse_args(sys.argv[1:])
+
+    if not args.sources:
+        from tmday.core.validators import validate_template
+
+        validate_template(args.template)
+        print(f"模板校验通过: {args.template}")
+        return
+
+    from tmday.core.processor import process_all
+
+    result = process_all(args.template, args.sources, args.output)
+    print(f"处理完成: {len(args.sources)} 个文件 → {result}")
+
+
+if __name__ == "__main__":
+    main()

tmailday-0.1.0/tmday/core/__init__.py

@@ -0,0 +1 @@
+

tmailday-0.1.0/tmday/core/processor.py

@@ -0,0 +1,74 @@
+"""数据处理：按数据来源分配到模板对应工作簿"""
+
+import shutil
+from pathlib import Path
+
+
+def process_all(
+    template_path: str,
+    source_paths: list[str],
+    output_path: str | None = None,
+) -> str:
+    """统一入口：对模板依次处理多个数据文件。
+    
+    Args:
+        template_path: 模板文件路径
+        source_paths: 数据文件路径列表
+        output_path: 输出路径，为 None 则原地更新模板
+    
+    Returns:
+        实际写入的文件路径
+    """
+    from tmday.core.validators import validate_file, validate_template
+
+    if output_path and Path(output_path) != Path(template_path):
+        shutil.copy2(template_path, output_path)
+        work_path = output_path
+    else:
+        work_path = template_path
+
+    validate_template(work_path)
+
+    for sp in source_paths:
+        file_type = validate_file(sp)
+        if file_type == "daily_report":
+            process_daily_report(sp, work_path)
+        elif file_type == "shengyi_canmou":
+            process_shengyi_canmou(sp, work_path)
+        elif file_type == "product_report":
+            process_product_report(sp, work_path)
+        else:
+            _not_implemented(file_type)
+
+    return work_path
+
+
+def process_daily_report(source_path: str, template_path: str) -> None:
+    """处理日报：读取 → 排序 → 匹配日期写入 B-日报。"""
+    from tmday.core.reader import read_daily_report
+    from tmday.core.writer import write_daily_to_template
+
+    daily_rows = read_daily_report(source_path)
+    write_daily_to_template(daily_rows, template_path)
+
+
+def process_shengyi_canmou(source_path: str, template_path: str) -> None:
+    """处理生意参谋：读取 → 跳过空行 → 匹配日期写入 B-商品。"""
+    from tmday.core.reader import read_shengyi_canmou
+    from tmday.core.writer import write_shengyi_to_template
+
+    rows = read_shengyi_canmou(source_path)
+    write_shengyi_to_template(rows, template_path)
+
+
+def process_product_report(source_path: str, template_path: str) -> None:
+    """处理商品报表：读取 zip/csv → 匹配 日期+场景ID 写入 B-无界。"""
+    from tmday.core.reader import read_product_report
+    from tmday.core.writer import write_product_to_template
+
+    rows = read_product_report(source_path)
+    write_product_to_template(rows, template_path)
+
+
+def _not_implemented(name: str) -> None:
+    raise NotImplementedError(f"{name} 处理逻辑尚未实现")

tmailday-0.1.0/tmday/core/reader.py

@@ -0,0 +1,86 @@
+"""读取源数据表格 (.xlsx/.xls/.csv)"""
+
+from datetime import datetime
+from typing import Any
+
+import openpyxl
+import xlrd
+
+
+def read_daily_report(filepath: str) -> list[list[Any]]:
+    """读取日报文件，按统计日期升序排列（远→近）。
+
+    Returns:
+        排序后的行数据列表，每行为完整的一行（不含表头）
+    """
+    wb = openpyxl.load_workbook(filepath, data_only=True)
+    ws = wb[wb.sheetnames[0]]
+
+    rows = []
+    for row in ws.iter_rows(min_row=2, values_only=True):
+        if row[0] is None:
+            continue
+        date_val = row[0]
+        if isinstance(date_val, str):
+            date_val = datetime.strptime(date_val, "%Y-%m-%d")
+        rows.append((date_val, list(row)))
+
+    wb.close()
+    rows.sort(key=lambda r: r[0])
+    return [r[1] for r in rows]
+
+
+def read_shengyi_canmou(filepath: str) -> list[list[Any]]:
+    """读取生意参谋导出文件 (.xls)，跳过空行，返回数据行列表。"""
+    wb = xlrd.open_workbook(filepath)
+    ws = wb.sheet_by_index(0)
+
+    header_row = _find_header_row_xls(ws)
+    if header_row is None:
+        raise ValueError("生意参谋文件中未找到表头行")
+
+    rows = []
+    for i in range(header_row + 1, ws.nrows):
+        row = [ws.cell_value(i, j) for j in range(ws.ncols)]
+        if any(str(v).strip() for v in row):
+            rows.append(row)
+    return rows
+
+
+def read_product_report(filepath: str) -> list[list[Any]]:
+    """读取商品报表 zip 文件，提取 CSV，解析后返回数据行列表。
+
+    日期列从 col 0 开始，按日期升序排列。
+    """
+    import csv
+    import io
+    import zipfile
+
+    import chardet
+
+    with zipfile.ZipFile(filepath) as zf:
+        csv_names = [n for n in zf.namelist() if n.lower().endswith(".csv")]
+        if not csv_names:
+            raise ValueError("zip 中未找到 csv 文件")
+        raw = zf.read(csv_names[0])
+        encoding = chardet.detect(raw)["encoding"] or "utf-8"
+        text = raw.decode(encoding)
+        reader = csv.reader(io.StringIO(text))
+        header = next(reader)
+
+        rows = []
+        for row in reader:
+            if any(v.strip() for v in row):
+                rows.append(row)
+        # 按日期升序
+        rows.sort(key=lambda r: r[0])
+        return rows
+
+
+def _find_header_row_xls(ws) -> int | None:
+    """在 xls 工作表中查找表头行。"""
+    for i in range(ws.nrows):
+        vals = [str(ws.cell_value(i, j)).strip() for j in range(min(ws.ncols, 40))]
+        if any(vals) and vals[0] == "统计日期":
+            return i
+    return None

tmailday-0.1.0/tmday/core/schema.py

@@ -0,0 +1,50 @@
+"""各文件类型的表头定义与常量"""
+
+TEMPLATE_SHEETS = ["月报", "日报", "B-日报", "B-刷单"]
+
+DAILY_REPORT_HEADER = [
+    "统计日期", "店铺名称", "访客数", "平均停留时长", "跳失率",
+    "商品收藏买家数", "加购人数", "支付金额", "支付买家数",
+    "支付子订单数", "支付件数", "老买家支付金额", "全站推广花费",
+    "关键词推广花费", "精准人群推广花费", "智能场景花费",
+    "淘宝客佣金", "成功退款金额", "支付商品数", "关注店铺人数",
+]
+
+SHENGYI_CANMOU_HEADER = [
+    "统计日期", "商品ID", "商品名称", "主商品ID", "商品类型",
+    "货号", "商品状态", "商品标签", "商品访客数", "商品浏览量",
+    "平均停留时长", "商品详情页跳出率", "商品收藏人数",
+    "商品加购件数", "商品加购人数", "下单买家数", "下单件数",
+    "下单金额", "下单转化率", "支付买家数", "支付件数",
+    "支付金额", "商品支付转化率", "支付新买家数", "支付老买家数",
+    "老买家支付金额", "聚划算支付金额", "访客平均价值",
+    "成功退款金额", "竞争力评分", "年累计支付金额",
+    "月累计支付金额", "月累计支付件数", "搜索引导支付转化率",
+    "搜索引导访客数", "搜索引导支付买家数",
+    "结构化详情引导转化率", "结构化详情引导成交占比",
+]
+
+PRODUCT_REPORT_HEADER = [
+    "日期", "场景ID", "场景名字", "原二级场景ID", "原二级场景名字",
+    "计划ID", "计划名字", "主体ID", "主体类型", "主体名称",
+    "展现量", "点击量", "花费", "点击率", "平均点击花费",
+    "千次展现花费", "总预售成交金额", "总预售成交笔数",
+    "直接预售成交金额", "直接预售成交笔数", "间接预售成交金额",
+    "间接预售成交笔数", "直接成交金额", "间接成交金额",
+    "总成交金额", "总成交笔数", "直接成交笔数", "间接成交笔数",
+    "点击转化率", "投入产出比", "含预售投产比", "总成交成本",
+    "总购物车数", "直接购物车数", "间接购物车数", "加购率",
+    "收藏宝贝数", "收藏店铺数", "店铺收藏成本", "总收藏加购数",
+    "总收藏加购成本", "宝贝收藏加购数", "宝贝收藏加购成本",
+    "总收藏数", "宝贝收藏成本", "宝贝收藏率", "加购成本",
+    "拍下订单笔数", "拍下订单金额", "直接收藏宝贝数",
+    "间接收藏宝贝数", "优惠券领取量", "购物金充值笔数",
+    "购物金充值金额", "旺旺咨询量", "引导访问量", "引导访问人数",
+    "引导访问潜客数", "引导访问潜客占比", "入会率", "入会量",
+    "引导访问率", "深度访问量", "平均访问页面数", "成交新客数",
+    "成交新客占比", "会员首购人数", "会员成交金额", "会员成交笔数",
+    "成交人数", "人均成交笔数", "人均成交金额", "自然流量转化金额",
+    "自然流量曝光量", "平台助推总成交", "平台助推直接成交",
+    "平台助推点击", "平台补贴金额", "补贴引导成交金额",
+    "发券补贴商品个数", "补贴引导成交人数",
+]