feat: 接入 SEC 与 Apple 官方研究文档和证据检索

[Zhangchenhao-111]

改动说明

为研究流程增加统一 ResearchDocument 元数据、SEC EDGAR 与 Apple 官方 Newsroom 两个真实来源连接器，并注册 search_research_documents / get_document_evidence 工具。支持公司、文档类型、报告期、日期和来源过滤；HTML 引用包含稳定文档 ID、规范化文本位置、内容哈希和来源跳转。默认及综合研究计划接入检索，EvidenceRef 保留来源类型和证据。

关联 Issue

Closes #32

当前为 Draft：以下未完成验收项补齐前，请勿合并。

测试报告（正式审核前必填）

环境

• Bun：1.4.2 (744846f84)
• OS：Windows NT 10.0.26200.0
• 原始基线：6a9a288eb354c01ae39a0339c902dd38e94ee89c

实际执行命令与结果

bun test packages/shared/src/research-documents
→ 30 pass / 0 fail / 62 assertions

bun test packages/core packages/shared --isolate
→ 899 pass / 1 fail / 3410 assertions

bun run typecheck
→ core / i18n / shared / ui / electron 全部 exit 0

bun scripts/research-documents-live.ts
→ PASS：生产 registry → 生成的 Agent tools → 真实 SEC / Apple → HTML 证据

git diff --check
→ exit 0

按 CI 高信号模式扫描仓库源码：未发现 secret。真实来源脚本使用本地环境变量设置 SEC User-Agent，联系信息未提交。脚本验证 Apple 10-K（2025-10-31，报告期 2025-09-27）和当前官方公告；输出来源类型、有界引用、哈希及证据跳转。它是 provider/tool integration，不能代替 LLM 或 Electron UI E2E。

与上游 3ce3848 在本地合并后，再次运行：

bun run typecheck
→ 所有工作区 exit 0

bun test packages/shared/src/research-documents packages/shared/src/research
→ 106 pass / 0 fail / 347 assertions

已知失败 / Baseline

唯一失败为 PiRuntimeAdapter 的 disposeSession 删除会话文件测试：Windows 沙箱拒绝创建 /tmp/pi（C:\tmp\pi）。在原始基线的独立干净 worktree 执行 bun test packages/shared/src/agent/pi-runtime-agent-backend.test.ts，同样 16 pass / 1 fail；失败位置及实现未被本 PR 修改。

• 已提供实际测试命令与 pass/fail 结果
• 已说明测试环境
• 已提供基线对照
• 核心改动已有 focused / 真实来源 integration 验证

详细报告：docs/research-documents-test-report.md。

UI 截图

未修改 UI 组件，但新增研究资料可能出现在已有研究结果中。尚未完成 Electron 视觉验证和截图；本地 Electron 可执行文件不可用，未宣称通过 UI 验收。

• 核对实际研究结果并补充需要的截图

Scope / 后续

• 完成真实 Agent 研究会话，核对最终回答来源类型及引用跳转
• 完成 Electron UI 验证
• 完成上游合并与 CI 检查后再转为 ready for review

首版 IR 来源仅覆盖 Apple 当前 Newsroom feed；SEC 历史查询最多 20 个匹配文件，超限明确报错。暂不支持 PDF 文本定位。第三方研报仅提供独立许可适配器契约，未接入付费服务。不将来源缺失、未知报告期或研报观点伪装为监管披露。