CRS 境外补税计算工具

上传券商月结单（PDF/Excel），自动计算中国CRS境外补税或加拿大CRA税务申报所需的资本利得。

前提条件

CRS API Key：在 https://wealthlplantation.com 注册并购买套餐后，在用户中心生成 API Key。

AI 文档解析由服务端完成，用户无需提供任何额外的 AI 密钥。

环境变量设置

运行前必须设置 CRS_API_KEY 环境变量。如果用户未设置，你必须主动引导用户完成以下步骤：

步骤 0：检查环境变量

echo "CRS_API_KEY=${CRS_API_KEY:-(未设置)}"

如果显示"未设置"，引导用户：

1. 获取 API Key：如果用户还没有 API Key，告知他们在 https://wealthlplantation.com 注册账户（免费送 20 页体验额度），然后在用户中心生成 API Key
2. 设置环境变量：让用户在当前终端会话中设置：

export CRS_API_KEY="用户提供的key"

如果用户希望永久生效，可以手动将上述行添加到 ~/.zshrc 或 ~/.bashrc。

设置完成后验证：echo $CRS_API_KEY，确认已生效再继续。

数据安全

• 上传的文件仅用于 AI 解析交易数据，处理完成后立即丢弃，不做任何存储
• 服务端不保存文件内容，仅记录处理日志（文件名、页数、耗时）
• AI 解析由服务端安全调用，用户无需提供自己的 AI 密钥
• API 端点 api.wealthlplantation.com 由 wealthlplantation.com 运营，TLS 加密传输

⚠️ 重要：文件处理规则

严禁读取或查看文件内容！ 你（AI agent）绝对不能用任何方式读取、查看、cat、head、base64 命令查看 PDF 或 Excel 文件的内容。这些文件是二进制的券商月结单，读取它们会消耗巨量 tokens 导致超限。

正确做法：只收集文件路径，然后调用本 skill 自带的 do_audit.py 脚本，由脚本在内部处理编码和 API 调用。

⚠️ 重要：Token 节约规则

为了最大限度节约 Token 消耗，你必须遵守以下规则：

1. 不要在对话中内联编写 Python 代码。使用本 skill 自带的 do_audit.py 脚本
2. 调用脚本时只传文件路径参数，不要在命令中嵌入任何额外代码
3. 报告结果时只摘要关键数字，不要复述脚本的完整输出

使用方法

步骤 1：收集同一年度的所有月结单文件路径

向用户询问要处理的文件。收集所有文件的完整路径。

重要：同一年度的所有月结单必须一起提交，才能保证数据准确。 例如，如果用户有2025年1月到12月的月结单，应该全部一起处理。

步骤 2：定位 do_audit.py 脚本

本 skill 包含一个独立的 Python CLI 脚本 do_audit.py。查找顺序：

# 查找 skill 目录下的 do_audit.py
SCRIPT=$(find ~/.claude/skills/crs-tax-calculator ~/.openclaw/skills/crs-tax-calculator -name "do_audit.py" 2>/dev/null | head -1)
echo "Script: $SCRIPT"

如果找不到脚本，提示用户重新安装此 skill（通过 ClawHub 或 Claude Code 的 /install 命令），脚本包含在 skill 包内。

步骤 3：运行脚本

python3 "$SCRIPT" /path/to/file1.pdf /path/to/file2.pdf --method FIFO --output /path/to/output/dir

参数说明：

• 文件路径：直接列出所有月结单文件的完整路径
• --method FIFO：中国税务（默认）；--method ACB：加拿大税务
• --output：指定 Excel 输出目录（默认保存到第一个输入文件所在目录）

一行命令即可，无需编写任何额外代码。

步骤 4：报告结果

脚本执行完后，简要告知用户：

• 生成了哪些 Excel 文件（文件名和路径）
• 每个年度的记录数、净损益（CNY）和估算税额
• 剩余配额
• 任何审计问题或警告

如果有错误，根据错误码提供建议：

• UNAUTHORIZED：API Key 无效，需要在 wealthlplantation.com 获取
• QUOTA_EXCEEDED：配额不足，需要购买更多页数
• GEMINI_API_ERROR：AI 解析服务暂时不可用，请稍后重试
• CALCULATION_ERROR：计算错误，可能是文件内容无法识别

支持的文件类型

• .pdf — PDF 月结单
• .xlsx — Excel 文件（月结单或历史审计底稿）
• .csv — CSV 文件
• .png, .jpg — 图片格式的对账单

支持的券商

盈立证券(uSMART)、长桥证券(Longbridge)、富途证券(Futu/Moomoo)、老虎证券(Tiger)、盈透证券(IBKR)、卓锐证券(Zircon) 等主流券商的月结单。

定价

按页计费，购买后永久有效：

详情和购买：https://wealthlplantation.com/pricing

输出内容

生成的 Excel 审计底稿包含：

• 交易明细表（买入/卖出/股息/利息/IPO）
• FIFO 或 ACB 成本匹配明细
• 汇率换算（PBOC 人民币 / Bank of Canada 加元）
• 税务摘要（应税收入、资本利得、预扣税抵扣）
• 审计问题清单