境外投资补税测算

在 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 申报表、官方表格或带有固定税务居民身份的合规文件。

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