lch262 · lch262 · Aug 21, 2026 · Aug 21, 2026 · Aug 21, 2026
diff --git a/README.md b/README.md
@@ -1,186 +1,190 @@
-# FolioPulse
-
-> [在线试用 FolioPulse](https://folio-pulse-dashboard.lch262.chatgpt.site/) · [提交问题或建议](https://github.com/lch262/folio-pulse/issues/new/choose) · [参与产品讨论](https://github.com/lch262/folio-pulse/discussions)
-
-FolioPulse 是一个 SEC 13F 数据引擎与可视化仪表盘。它从 SEC EDGAR 读取机构最近两份
-**原始** `13F-HR`，生成标准化持仓、季度变化和可浏览的投资人档案。目前已接入伯克希尔
-与 Scion 的真实公开快照。
-
-`13F-HR/A` 修订申报会被忽略，避免把修订文件误当成新的季度。
-
-## 公开试用
-
-无需安装即可打开[在线仪表盘](https://folio-pulse-dashboard.lch262.chatgpt.site/)。建议重点体验：
-
-- 从投资人中心切换伯克希尔与 Scion，核对报告期和提交日期；
-- 搜索持仓，并按新建、增持、减持和清仓筛选季度动作；
-- 打开单项持仓详情，检查跳转、移动端显示和数据解释是否清楚；
-- 对不准确的数据、难理解的文案或希望增加的机构提出建议。
-
-发现问题请使用[反馈模板](https://github.com/lch262/folio-pulse/issues/new/choose)；想讨论产品方向、机构优先级或界面方案，请前往 [Discussions](https://github.com/lch262/folio-pulse/discussions)。提交反馈时不要粘贴 Token、密码、邮箱验证码或其他敏感信息。
-
-## 要求
-
-- Python 3.10 或更高版本
-- 不需要 SEC API Key
-- 不需要第三方运行时依赖
-
-SEC 要求自动请求声明带有联系信息的 `User-Agent`。PowerShell 示例：
-
-```powershell
-$env:FOLIOPULSE_SEC_USER_AGENT = "FolioPulse your-email@example.com"
-python -m backend.main 0001067983
-```
-
-不填写 CIK 时，默认使用 Berkshire Hathaway：
-
-```powershell
-python -m backend.main
-```
-
-也可以直接传入 User-Agent，并输出 JSON：
-
-```powershell
-python -m backend.main 0001067983 `
-  --user-agent "FolioPulse your-email@example.com" `
-  --json
-```
-
-下载并解析最新一期完整持仓：
-
-```powershell
-python -m backend.main 0001067983 `
-  --holdings-output data/berkshire_latest.json
-```
-
-程序会自动读取 filing 目录，识别根元素为 `informationTable` 的 XML，并把每行
-转换成包含 issuer、CUSIP、可选 FIGI、shares、value 和 voting authority 的 JSON。
-
-SEC 从 2023 年 1 月 3 日起把 13F `value` 改为按美元报告；程序会把旧 filing
-的千美元数值乘以 1,000，统一输出 `value_usd`。13F Information Table 通常不含
-ticker，因此当前版本不会猜测股票代码，ticker 映射留到后续版本。
-
-比较最近两个季度并导出变化：
-
-```powershell
-python -m backend.main 0001067983 `
-  --changes-output data/berkshire_changes.json
-```
-
-变化引擎先按 `CUSIP + Put/Call + SH/PRN` 合并同一证券的拆分行，再根据报告
-数量分类：
-
-- `NEW`：上一季度没有，本季度出现
-- `ADDED`：本季度数量增加
-- `REDUCED`：本季度数量减少
-- `UNCHANGED`：数量未变
-- `EXIT`：上一季度存在，本季度消失
-
-比较使用 shares/principal amount，而不是随股价变化的市值。每条变化同时输出
-previous/current amount、差额、百分比和两期报告市值。
-
-生成可直接导入网站的快照：
-
-```powershell
-python -m backend.main 0001067983 `
-  --web-snapshot-output data/berkshire_web_snapshot.json `
-  --ticker-map data/tickers.json
-```
-
-`--ticker-map` 是可选的 CUSIP 到 ticker JSON 对象；未提供映射的证券会以 CUSIP
-作为显示代码，不会猜测 ticker。快照会计算组合权重、带入五类季度变化，并保留
-已清仓证券，同时写入相邻两个报告期日期。登录 FolioPulse 后点击右上角“导入快照”
-即可写入持久化数据库；页面可查看上季持仓、本季持仓、股份变化量并展开单股详情。
-
-## 监控新的 13F
-
-先执行一次检查并建立基线：
-
-```powershell
-python -m backend.filing_watcher 0001067983 --once
-```
-
-首次运行会显示 `INITIALIZED`，并把最新 accession 写入
-`data/watcher_state.json`，不会把已有 filing 误报成新事件。再次检查时，相同
-accession 显示 `UNCHANGED`；检测到更晚的 filing 时显示 `NEW_FILING`。
-
-持续监控，默认每 60 秒检查一次：
-
-```powershell
-python -m backend.filing_watcher 0001067983
-```
-
-可用 `Ctrl+C` 安全停止。也可以通过 `--interval 120` 调整轮询秒数，或使用
-`--json` 输出单行 JSON 事件。Watcher 使用同一个 `FOLIOPULSE_SEC_USER_AGENT`
-环境变量，并且状态文件已被 `.gitignore` 排除。
-
-## 预期输出
-
-```text
-FolioPulse SEC Tracker
-
-Fund: BERKSHIRE HATHAWAY INC
-CIK: 0001067983
-
-Latest 13F-HR
-Form: 13F-HR
-Report period: ...
-Filed: ...
-Accession: ...
-Primary document: ...
-URL: ...
-
-Previous 13F-HR
-...
-```
-
-## 测试
-
-测试全部使用固定的本地样本，不会请求 SEC：
-
-```powershell
-python -m unittest discover -s tests -v
-```
-
-测试覆盖 CIK 规范化、排除修订申报、历史 submissions 文件、无 13F 结果，
-SEC 限流、Information Table 发现、XML 命名空间、可选 FIGI、数值单位转换和
-持仓 JSON 导出，以及重复行聚合、期权分离和五类季度变化。
-Watcher 测试还覆盖首次基线、无变化、新 filing、旧结果保护和损坏状态保护。
-
-## 可视化仪表盘
-
-`web/` 是面向用户的 FolioPulse 仪表盘，包含组合概览、前五大持仓、季度信号、
-变化筛选、公司搜索与 `/api/portfolio` JSON 接口。页面现在从 D1 持久化数据库
-读取快照；数据库首次使用时写入明确标记的演示数据。登录且获授权的管理员可以
-通过 `POST /api/portfolio` 导入标准化快照，前端会自动读取最新报告期。
-
-```powershell
-cd web
-npm install
-npm run dev
-```
-
-打开 `http://localhost:3000`。生产构建使用 `npm run build`。
-
-## 当前范围
-
-- [x] 规范化为十位 CIK
-- [x] 请求 filer submissions JSON
-- [x] 找到最近两份原始 `13F-HR`
-- [x] 输出人类可读文本或 JSON
-- [x] 离线单元测试
-- [x] 定位并解析 13F Information Table（V0.02）
-- [x] 输出标准化持仓 JSON
-- [x] 比较季度持仓并分类变化（V0.03）
-- [x] 输出季度 changes JSON
-- [x] 监控新的原始 13F-HR（V0.04）
-- [x] 原子保存 watcher accession 状态
-- [x] 面向用户的响应式持仓仪表盘（V0.05）
-- [x] 持仓变化筛选与公司搜索
-- [x] Portfolio JSON 接口
-- [x] D1 持久化基金、申报与持仓数据（V0.06）
-- [x] 受账号权限保护的持仓快照导入接口
-- [x] Python SEC 数据到网站快照的转换器（V0.07）
-- [x] 管理员 JSON 导入界面与动态调仓信号
-- [x] 多机构档案、按 CIK 隔离读取与 Scion 真实 13F 快照（V0.08）
+# FolioPulse
+
+> [在线试用 FolioPulse](https://folio-pulse-dashboard.lch262.chatgpt.site/) · [提交问题或建议](https://github.com/lch262/folio-pulse/issues/new/choose) · [参与产品讨论](https://github.com/lch262/folio-pulse/discussions)
+
+FolioPulse 是一个 SEC 13F 数据引擎与可视化仪表盘。它从 SEC EDGAR 读取机构最近两份
+**原始** `13F-HR`，生成标准化持仓、季度变化和可浏览的投资人档案。目前已接入伯克希尔、
+Scion、ARK Invest（木头姐）、H&H International（段永平相关）、桥水、潘兴广场、
+Appaloosa 与 Duquesne 的真实公开快照。
+
+`13F-HR/A` 修订申报会被忽略，避免把修订文件误当成新的季度。
+
+## 公开试用
+
+无需安装即可打开[在线仪表盘](https://folio-pulse-dashboard.lch262.chatgpt.site/)。建议重点体验：
+
+- 从投资人中心切换八家机构，核对各自报告期和提交日期；
+- 搜索持仓，并按新建、增持、减持和清仓筛选季度动作；
+- 打开单项持仓详情，检查跳转、移动端显示和数据解释是否清楚；
+- 对不准确的数据、难理解的文案或希望增加的机构提出建议。
+
+发现问题请使用[反馈模板](https://github.com/lch262/folio-pulse/issues/new/choose)；想讨论产品方向、机构优先级或界面方案，请前往 [Discussions](https://github.com/lch262/folio-pulse/discussions)。提交反馈时不要粘贴 Token、密码、邮箱验证码或其他敏感信息。
+
+## 要求
+
+- Python 3.10 或更高版本
+- 不需要 SEC API Key
+- 不需要第三方运行时依赖
+
+SEC 要求自动请求声明带有联系信息的 `User-Agent`。PowerShell 示例：
+
+```powershell
+$env:FOLIOPULSE_SEC_USER_AGENT = "FolioPulse your-email@example.com"
+python -m backend.main 0001067983
+```
+
+不填写 CIK 时，默认使用 Berkshire Hathaway：
+
+```powershell
+python -m backend.main
+```
+
+也可以直接传入 User-Agent，并输出 JSON：
+
+```powershell
+python -m backend.main 0001067983 `
+  --user-agent "FolioPulse your-email@example.com" `
+  --json
+```
+
+下载并解析最新一期完整持仓：
+
+```powershell
+python -m backend.main 0001067983 `
+  --holdings-output data/berkshire_latest.json
+```
+
+程序会自动读取 filing 目录，识别根元素为 `informationTable` 的 XML，并把每行
+转换成包含 issuer、CUSIP、可选 FIGI、shares、value 和 voting authority 的 JSON。
+
+SEC 从 2023 年 1 月 3 日起把 13F `value` 改为按美元报告；程序会把旧 filing
+的千美元数值乘以 1,000，统一输出 `value_usd`。13F Information Table 通常不含
+ticker，因此当前版本不会猜测股票代码，ticker 映射留到后续版本。
+
+比较最近两个季度并导出变化：
+
+```powershell
+python -m backend.main 0001067983 `
+  --changes-output data/berkshire_changes.json
+```
+
+变化引擎先按 `CUSIP + Put/Call + SH/PRN` 合并同一证券的拆分行，再根据报告
+数量分类：
+
+- `NEW`：上一季度没有，本季度出现
+- `ADDED`：本季度数量增加
+- `REDUCED`：本季度数量减少
+- `UNCHANGED`：数量未变
+- `EXIT`：上一季度存在，本季度消失
+
+比较使用 shares/principal amount，而不是随股价变化的市值。每条变化同时输出
+previous/current amount、差额、百分比和两期报告市值。
+
+生成可直接导入网站的快照：
+
+```powershell
+python -m backend.main 0001067983 `
+  --web-snapshot-output data/berkshire_web_snapshot.json `
+  --ticker-map data/tickers.json
+```
+
+`--ticker-map` 是可选的 CUSIP 到 ticker JSON 对象；未提供映射的证券会以 CUSIP
+作为显示代码，不会猜测 ticker。快照会计算组合权重、带入五类季度变化，并保留
+已清仓证券，同时写入相邻两个报告期日期。登录 FolioPulse 后点击右上角“导入快照”
+即可写入持久化数据库；页面可查看上季持仓、本季持仓、股份变化量并展开单股详情。
+
+## 监控新的 13F
+
+先执行一次检查并建立基线：
+
+```powershell
+python -m backend.filing_watcher 0001067983 --once
+```
+
+首次运行会显示 `INITIALIZED`，并把最新 accession 写入
+`data/watcher_state.json`，不会把已有 filing 误报成新事件。再次检查时，相同
+accession 显示 `UNCHANGED`；检测到更晚的 filing 时显示 `NEW_FILING`。
+
+持续监控，默认每 60 秒检查一次：
+
+```powershell
+python -m backend.filing_watcher 0001067983
+```
+
+可用 `Ctrl+C` 安全停止。也可以通过 `--interval 120` 调整轮询秒数，或使用
+`--json` 输出单行 JSON 事件。Watcher 使用同一个 `FOLIOPULSE_SEC_USER_AGENT`
+环境变量，并且状态文件已被 `.gitignore` 排除。
+
+## 预期输出
+
+```text
+FolioPulse SEC Tracker
+
+Fund: BERKSHIRE HATHAWAY INC
+CIK: 0001067983
+
+Latest 13F-HR
+Form: 13F-HR
+Report period: ...
+Filed: ...
+Accession: ...
+Primary document: ...
+URL: ...
+
+Previous 13F-HR
+...
+```
+
+## 测试
+
+测试全部使用固定的本地样本，不会请求 SEC：
+
+```powershell
+python -m unittest discover -s tests -v
+```
+
+测试覆盖 CIK 规范化、排除修订申报、历史 submissions 文件、无 13F 结果，
+SEC 限流、Information Table 发现、XML 命名空间、可选 FIGI、数值单位转换和
+持仓 JSON 导出，以及重复行聚合、期权分离和五类季度变化。
+Watcher 测试还覆盖首次基线、无变化、新 filing、旧结果保护和损坏状态保护。
+
+## 可视化仪表盘
+
+`web/` 是面向用户的 FolioPulse 仪表盘，包含组合概览、前五大持仓、季度信号、
+变化筛选、公司搜索与 `/api/portfolio` JSON 接口。页面现在从 D1 持久化数据库
+读取快照；数据库首次使用时写入明确标记的演示数据。登录且获授权的管理员可以
+通过 `POST /api/portfolio` 导入标准化快照，前端会自动读取最新报告期。
+
+```powershell
+cd web
+npm install
+npm run dev
+```
+
+打开 `http://localhost:3000`。生产构建使用 `npm run build`。
+
+## 当前范围
+
+- [x] 规范化为十位 CIK
+- [x] 请求 filer submissions JSON
+- [x] 找到最近两份原始 `13F-HR`
+- [x] 输出人类可读文本或 JSON
+- [x] 离线单元测试
+- [x] 定位并解析 13F Information Table（V0.02）
+- [x] 输出标准化持仓 JSON
+- [x] 比较季度持仓并分类变化（V0.03）
+- [x] 输出季度 changes JSON
+- [x] 监控新的原始 13F-HR（V0.04）
+- [x] 原子保存 watcher accession 状态
+- [x] 面向用户的响应式持仓仪表盘（V0.05）
+- [x] 持仓变化筛选与公司搜索
+- [x] Portfolio JSON 接口
+- [x] D1 持久化基金、申报与持仓数据（V0.06）
+- [x] 受账号权限保护的持仓快照导入接口
+- [x] Python SEC 数据到网站快照的转换器（V0.07）
+- [x] 管理员 JSON 导入界面与动态调仓信号
+- [x] 多机构档案、按 CIK 隔离读取与 Scion 真实 13F 快照（V0.08）
 - [x] 机构持仓搜索、动作筛选与机构专属单项详情
+- [x] ARK 与 H&H 最新公开 13F 快照、独立档案与数据边界说明（V0.09）
+- [x] 八家机构全量接入与 Apple 风格扁平化界面（V0.10）
+- [x] 八家机构独立季度增减持折线图、指标切换与持仓交互明细（V0.11）