tmailday 0.1.6

电商日报表格数据处理工具 — 读取电商平台导出的数据，按来源写入日报表格

tmailday

表格数据处理工具 — 读取导出的数据表格，按数据来源写入模板文件对应工作簿。

安装

uv pip install tmailday
# 或直接运行
uvx tmailday --help
uvx --extra-index-url https://heibai2006:[e-mail]/api/packages/ruichuang/pypi/simple tmailday

用法

CLI

# 校验模板
tmailday <模板文件>

# 处理单个数据文件，原地更新模板
tmailday <模板文件> <数据文件>

# 批量处理多个数据文件
tmailday <模板文件> <数据1> <数据2> ...

# 指定输出路径
tmailday <模板文件> <数据文件> -o <输出文件>

MCP Server

# stdio 模式
tmailday mcp

# HTTP(SSE) 模式
tmailday mcp --transport sse

在 MCP 客户端配置中添加：

{
  "mcpServers": {
    "tmailday": {
      "command": "uvx",
      "args": ["tmailday", "mcp"]
    }
  }
}

MCP Tools

Tool	说明
process_table(template_path, source_path, output_path?)	stdio 本地路径，单文件处理
process_table_batch(template_path, source_paths, output_path?)	stdio 本地路径，批量处理
process_table_data(template_data, template_filename, source_data, source_filename)	base64 编码文件内容，单文件（SSE/HTTP 通用）
process_table_data_batch(template_data, template_filename, source_list)	base64 编码文件内容，批量

HTTP 路由（SSE 模式下可用）

端点	方法	说明
/upload	POST	multipart 上传文件，返回临时路径 JSON
/process	POST	multipart 上传并直接处理，返回处理后的 xlsx 文件
/download/{token}	GET	通过 token 下载已存储的文件

支持的数据类型

类型	格式	目标工作簿	匹配方式
日报	.xlsx	B-日报	统计日期
生意参谋	.xls	B-商品	统计日期 + 商品ID
商品报表	.zip (内含 .csv)	B-无界	日期 + 场景ID

模板要求

模板文件为 .xlsx 格式，必须包含以下工作簿：

• 月报、日报、B-日报、B-无界、B-商品

常用命令

uvx tmailday   #uvx运行
uvx --extra-index-url https://heibai2006:[e-mail]/api/packages/ruichuang/pypi/simple tmailday   #uvx运行(从自有服务器加载)
uv sync                    # 安装/同步依赖
uv run tmailday --help        # 查看 CLI 帮助
uv run tmailday <模板> <数据1> <数据2> ...          # 批量处理，原地更新模板
uv run tmailday <模板> <数据> -o <输出>              # 处理后输出到指定文件
uv run tmailday mcp         # 启动 MCP Server (stdio)
uv run tmailday mcp --transport sse  # 启动 MCP HTTP Server transport支持stdio,sse,streamable-http,http
uv add <package>           # 添加依赖

开发

git clone https://git.des8.com/ruichuang/rctmailday.git
cd rctmailday
uv sync
uv run tmailday --help

• Python >= 3.12
• 包管理器: uv
• 框架: FastMCP

License

Copyright © 2026 瑞创. All rights reserved.