用途：这是一个针对葡萄牙个人所得税（IRS）申报的诊断式运行手册（runbook）。每种“症状”对应一种申报情形，通过决策树从情形路由到正确的附表（annex）、自主税率与截止日期，最终落到具体申报动作，或明确提示“就某原因升级咨询 contabilista certificado（注册会计师）”。默认收入年度为 2025 年（2026 年 4 月 1 日至 6 月 30 日申报），资料未提及其他默认年度。
适用情形：用户询问如何申报 Modelo 3 或应使用哪些附表；需要判断是葡萄牙税务居民还是非居民及其影响；收到葡萄牙来源收入（租金、房产或股份转让、工资、养老金、自雇报酬）需申报；非居民房东或居民有海外收入需确定税率与双重征税减免；询问 IRS automático、IRS Jovem、IFICI（后 NHR 制度）、englobamento、mais-valias 再投资等具体制度。该技能仅针对葡萄牙；英国等其他国家申报超出范围，但可覆盖跨境情形的葡萄牙一侧（如同时出现在英国 SA106 上的葡萄牙租金收入）。
使用方式：始终从居住身份入手，先读 residency-tree，因为身份（Art. 16）决定整个制度——全球收入还是仅葡源收入、累进还是单一税率、有无扣除。然后读 filing-obligation-tree 判断是否必须申报、可用哪些附表。针对用户每种收入打开对应树，一名纳税人常需同时使用多个附表。税率与门槛统一查 rates-and-deductions.md，各树只链接不重述数字。用 references/queries/ 中的计算器（天数、租金税、资本利得）做确定性估算，再到 Portal das Finanças 核对。用 assets/templates/report.md 汇总结果。
入口树：居住身份（residency-tree，P1 网关）；申报义务与 IRS automático、附表（filing-obligation-tree，P1 路由）；租金收入 Categoria F（rental-income-tree，P1）；房产或股份转让 Categoria G / mais-valias（capital-gains-tree，P1）；工资或养老金 Categoria A / H（employment-pension-tree，P2）；自雇 / recibos verdes Categoria B（self-employment-tree，P2）；海外收入 / 双重征税风险 Anexo J（foreign-income-tree，P2）。
常见易错点（资料列举）：租金收入并非按累进税率，Cat F 有自主税率（基础 25%，长期租约更低），englobamento 为可选项；Art. 72 减免从 5 年永久住房合同起算，不足 5 年仍为 25%；非居民并非对全部房产收益按 28% 征税，自 2023 年起与居民一样享受 50% 计入加累进税率；NHR 已对新移居者关闭，现行制度为 IFICI 且资格更窄；非居民不必须指定税务代表，若同意电子通知即为可选，欧盟/欧洲经济区居民始终可选。
限制：资料明确声明不构成税务建议，规则以引用日期核验为准，税率和门槛每届国家预算（Orçamento do Estado）可能变化；提交前须对照现行 Art. 68/72 文本及官方 Modelo 3 / IRS automático 界面确认数字，非例行事项应咨询注册会计师。首次使用需在 config.json 中填写纳税人情况（居住国、税务代表状态、适用税收协定、NIF），字段为空则询问用户并保存；不得存储密码，登录 Portal das Finanças 为交互式。非例行申报前应阅读 gotchas.md。配套的英国 Self Assessment / SA106 手册不在本技能范围内。