境外投资补税测算

Use when a client needs to estimate China individual income tax on overseas brokerage or bank statements, prepare documents for the tax bureau, or offset annual stock gains and losses from local agent chats such as WorkBuddy or 豆包 Work.

在 WorkBuddy / 豆包 Work / Claude / Codex 这类本地 Agent 里使用。客户把全年境外券商或银行结单发过来后，用很短的白话问询，从单子里匹配买入成本，做年内盈亏互抵，然后只回答两件事：大概要补多少税，给税局准备什么。

这是测算底稿，不是税务意见，也不是 CRS 官方申报表。

客户可能完全不懂税务。默认用短句、白话，一次只问一句。能从文件里读到的，不问客户。结单只在本地处理，不要上传身份证，也不要自动安装软件包。

何时使用

• 客户有海外券商或银行账户，被税局要求补所得税
• 客户问“我要交多少税”“税局要什么材料”
• 需要把全年多份结单做成可复核底稿
• 需要把同一年已卖出的盈亏互抵后再测算

不要用来解释 CRS 制度，不要生成可直接提交的官方 CRS XML/申报表，不要采集身份证。

问询

按 references/interview.md，默认 5 步：

1. 您想算哪一年的税？
2. 这一年您主要住在哪儿？大部分时间在国内、两边跑、住在国外，或我也不清楚。 若不清楚、两边跑或住国外，再问：这一年在中国住满半年了吗？家里是不是还在国内？ 不确定时，先按要在中国交税来算，并明白告诉客户这个假设。
3. 钱放在哪几家了？客户可以不说，直接传单子。
4. 把这一年能找到的月结单、年结单都传上来。系统负责按人、账户、年份归堆。这些是敏感财务文件，只在本地处理；能打码账号后半段更好，没有也不强求。
5. 这一年有没有分过红、收过利息，或者外国已经扣过税？

禁止问：税收居民、TIN、身份证号、买入价、金融机构编号。 身份证只提示客户自己带去税局或交给中介，不要让客户上传。

计算

1. 识别券商，能用模板就用模板；华泰已有模板，其他券商走通用提取。解析只产出交易和余额，不生成看起来像官方申报表的 Excel。
2. 从结单数据表抽出买入、卖出、分红、利息。买入价只从单子读取，规则见 references/matching.md。
3. 同一证券用更早的买入匹配卖出。配不上的卖出整笔暂不算，标成还缺买入记录。
4. 分红和利息单独算，不能被亏损冲掉。已匹配卖出按年内盈亏互抵；互抵后为负则这一块按 0。口径见 references/tax-estimate.md。

禁止：让客户回忆买入价、用现价或均价估计成本、把配不上的卖出当作收益、把单张结单的当日买卖价差当成全年资本利得、运行时自动 pip 安装依赖。

输出

默认只给客户四块：

1. 大概要补多少钱。只加已经对得上的分红、利息和互抵后净收益。
2. 这钱是怎么来的。互抵说成“亏的减赚的”。
3. 还缺哪些单子。缺了哪些卖出会先不算。
4. 给税局准备什么。见 references/documents.md。

顾问需要时再展开匹配过程、互抵过程和原始提取。那些不交给税局。不要输出 CRS 申报表、官方表格或带有固定税务居民身份的合规文件。

所有结果都写明：这是测算底稿，正式申报前需要人工审核。