盈指量 · AI 财报 / 公告 / 调研纪要研究工作台
> 定位：信息整理与研究辅助工具。只做「抽取 → 整理 → 溯源 → 呈现」，不提供投资建议、不推荐个股、不预测价格、不承诺收益。
由盈指量（杭州）科技有限公司设计出品。本 skill 附带一个完整、可离线运行的 Node.js 单体应用，位于本文件同级的 ./app/ 目录。
0. 触发与自我保护
- 任何与「财报 / 公告 / 调研纪要的解析、抽取、比对、研究」相关的请求，都应加载本 skill。
- 当用户要求"运行 / 部署 / 启动工作台"时，按下方「部署运行」把
./app复制到工作区后启动。 - 合规红线（任何时候不得突破）：不得输出买卖建议、目标价、收益预测、荐股话术；所有研究结论必须可溯源到原文。
1. 能力矩阵
| 能力 | 说明 |
|---|---|
| 文档摄取 | PDF / DOCX / TXT / MD / HTML / CSV，自动分块并保留页码 |
| 指标抽取 | 收入、成本、毛利、营业利润、归母/扣非净利润、三大现金流、资本开支、资产负债、研发费用、EPS、毛利率、资产负债率等 28 类，中英双语别名 |
| 原文溯源 | 每条结论附 页码 + 语义块 + 原文片段，可一键展开上下文 |
| 风险抽取 | 14 类风险（客户集中度 / 商誉减值 / 流动性 / 汇率 / 诉讼合规 / 供应链 / 技术迭代 / 治理…）＋ 严重度评分 ＋ 量化线索 |
| 横向比较 | 多公司 × 多维度矩阵、自动洞察（附双方出处）、数据缺口明示 |
| 调研问题 | 6 大模块，基于实际指标与风险触发，每条标注「依据」 |
| 短视频文案 | 30s / 60s / 90s 三档，口播稿 + 分镜表 + 数据出处 + 话题标签 |
| 合规护栏 | 话术黑名单扫描（荐股 / 收益承诺 / 价格预测）、自动净化、强制免责声明 |
| 权威数据源 | 44 个监管机构 / 交易所 / 官方披露平台注册，6 类已实现程序化抓取 |
| 开源集成 | GitHub 同类热门项目登记 + AKShare / EdgarTools Python 直调桥接 |
2. 部署运行
> skill 目录（~/.workbuddy/skills/…）是只读共享区，不要在其中 npm install 或写运行数据。请复制到用户工作区再运行。
当用户要求启动工作台时，按以下步骤执行：
# 1) 把随附应用复制到工作区（路径由你决定，示例 target=financial-workbench）
cp -r "<本 skill 目录>/app" "<工作区>/financial-workbench"
# 2) 安装依赖（Node 18+，内置 fetch）
cd "<工作区>/financial-workbench"
npm install
# 3) 启动（默认 http://127.0.0.1:7777）
npm start
# 4) 另开终端灌入 3 份示例财报 / 纪要
npm run seed
# 5) 端到端冒烟测试（34 项）
npm test
浏览器打开 http://127.0.0.1:7777 即可使用。
可选环境变量
| 变量 | 说明 | 默认 |
|---|---|---|
PORT |
服务端口 | 7777 |
HOST |
监听地址 | 127.0.0.1 |
SEC_USER_AGENT |
SEC EDGAR 强制要求的身份声明 | 内置默认，建议改为自有邮箱 |
FIN_UA |
通用抓取 User-Agent | 内置默认 |
FIN_PYTHON |
Python 桥接解释器路径 | 自动探测 python/python3/py |
FIN_DATA_DIR |
数据目录 | ./data |
3. 权威数据源（合规可核验）
app/src/config/sources.js 维护 44 个权威数据源，按 tier 分级：
- tier-1（官方口径，38 个）：证监会、巨潮资讯（法定披露平台）、上交所、深交所、北交所、证券业协会、基金业协会、央行、国家统计局、外汇局、港交所 HKEXnews、香港证监会、美国 SEC EDGAR / SEC 全文检索、美联储 FRED、NYSE、NASDAQ、FINRA、BEA、BLS、ESMA、ECB、LSE、FCA、德交所、泛欧交易所、SIX、JPX、韩国 KIND、SGX、ASX、ASIC、SEBI、BSE、NSE、台交所 MOPS、IMF、世界银行、BIS、IOSCO、OECD
- tier-2（行情补充，非监管口径，6 个）：Yahoo Finance、Stooq、东方财富、新浪财经等
已实现程序化抓取适配器（6 类）：巨潮 cninfoSearch、沪/深 sseSearch/szseSearch、港交所 hkexSearch、SEC getFilings/getStructuredFinancials（XBRL）、SEC 全文 fullTextSearch/fetchFilingText、行情 yahooChart/stooqCsv/eastmoneyKline。其余源为链接级登记（合规可核验、人工导航直达），不伪造抓取结果。
抓取纪律：可识别 User-Agent（SEC 强制）、按 host 令牌桶限流、自动编码识别（GBK/UTF-8）、失败重试与降级。
4. GitHub 开源项目集成
app/src/integrations/registry.js 登记同类热门项目，元数据经 GitHub API 实时拉取（不写死 star 数）：
| 项目 | 集成方式 |
|---|---|
| AKShare | python-bridge：本机安装后直调（行情/财务/巨潮公告） |
| EdgarTools | python-bridge：本机安装后直调（SEC 三大报表/13F） |
| Dexter | schema-compat：研究 Agent 引用链设计参考 |
| FinSight（人大·玉兰融观） | schema-compat：研报章节结构与 CoA 对齐 |
| FinGPT | schema-compat：标签体系参考 |
| FinLens | schema-compat：多文档 Multi-Agent RAG 范式 |
| RAGfolio | schema-compat：混合检索排序 |
Python 桥接启用（可选，未安装时自动降级到内置抓取层）：pip install -U akshare edgartools。
5. API 速览
文档
POST /api/documents/upload multipart 批量上传（files, company, period, currency）
POST /api/documents/text { text, name, company, period, docType }
POST /api/documents/fetch-url { url, company, period, sourceId }
GET /api/documents 列表
GET /api/documents/:id 详情（含指标/风险/出处）
DELETE /api/documents/:id
GET /api/documents/:id/evidence?blockId=&page=&context= 原文溯源
分析
POST /api/analysis/compare { ids: [...] }
GET /api/analysis/questions/:id
POST /api/analysis/script { id, duration: 30|60|90 }
数据源 / 行情 / 集成 / 合规导出
GET /api/sources/search?source=cninfo|sse|szse|hkex|sec-edgar|sec-fts
GET /api/sources/sec/financials?symbol=AAPL&years=3
GET /api/market/quote?symbol=AAPL&market=US&range=6mo
GET /api/integrations/status
POST /api/compliance/scan { text }
GET /api/export/:id?format=md|json[&download=1]
6. 合规设计（必读）
- 定位约束：只做「抽取 → 整理 → 溯源 → 呈现」，任何输出不含买卖建议、目标价、收益预测。
- 输出前置过滤：
app/src/compliance/guard.js在文案生成后强制扫描，命中block级词（推荐买入 / 必涨 / 稳赚 / 目标价 / 带单…）自动替换为〔已移除·合规过滤〕，并附加免责声明。 - 数据缺失明示：横向比较的「数据缺口」区块列出未命中的维度，不做任何估算填补。
- 结论可核验：每条指标与风险项都带
blockId + 页码 + 原文片段。 - 来源分级披露：tier-2 行情源在界面明确标注「非监管口径」。
7. 已知限制
- 扫描件 PDF（图片型）无法提取文本，需先 OCR。
- 抽取为规则 + 统计启发式，重要结论请人工复核原始文件；置信度低于 70% 的条目建议核对。
- 巨潮/交易所接口对请求头与频率敏感，偶发限流，可重试或切 AKShare 通道。
- 未内置 LLM：全流程离线可跑（规则引擎）；接入大模型做摘要润色时输出仍需过
compliance/guard.js。 - 本地 JSON（
data/db.json）存储，适合单机/边缘部署；多用户生产建议换 PostgreSQL。
8. 真实场景案例（可直接复制给用户演示）
场景一：年报季快速横向比对三家同行
> 用户：「把华创精密、远景新材、中科光电这三家 2025 年年报的收入、归母净利润、经营现金流拉出来横比，标出同比变化最大的两项。」
- 操作：分别上传三份 PDF/文本 → 系统抽取 28 类指标并附原文页码出处。
- 产出：
/api/compare自动生成横向矩阵 + 自动洞察（如「远景新材营收同比 +31.2%，显著高于行业」），每条数据可点击溯源到原文句子。 - 合规：输出仅呈现整理结果，不出现「买入 / 低估 / 推荐」等话术。
场景二：调研纪要 → 即时提问清单 + 短视频口播稿
> 用户：「这是上周和华创精密管理层的调研纪要，帮我生成 10 个追问问题，再写一段 60 秒财经短视频口播稿。」
- 操作：上传纪要文本 →
analysis/questions.js基于已抽取指标与风险项生成追问（如「毛利率从 41% 降到 36%，主要拖累因素是什么？」）。 - 产出：
analysis/script.js生成 30/60/90 秒三档口播稿，全程过compliance/guard.js扫描，自动剔除「稳赚 / 必涨 / 目标价」等违规词并补免责声明。 - 自动洞察：若纪要中出现「产能利用率 78%」「新客户集中度高」等信号，文案会据此组织钩子。
场景三：从权威源抓披露文件再抽取
> 用户：「帮我把港交所披露易上 XX 公司最近一份年度业绩公告抓下来，提取关键数字。」
- 操作：
/api/sources/search?source=hkex&keyword=XX调用港交所官方披露易接口（tier-1 监管口径）→ 取得公告直链 → 下载文本 → 走同一套抽取与溯源流程。 - 数据源：
src/config/sources.js注册 SEC EDGAR、巨潮、上交所、深交所、HKEX、Yahoo 等全球前 100 权威官网，tier-2 行情源明确标注「非监管口径」。 - 集成：已在
src/integrations/registry.js登记 Dexter / FinSight / FinGPT / FinLens / RAGfolio 等 GitHub 热门开源项目，可一键桥接 Python 生态（akshare / edgartools）。
9. 开放平台发布清单
本 skill 目录即为可直接上传到 WorkBuddy 开放平台的技能包，结构如下：
财报研究工作台/
├── SKILL.md # 本文件（含 frontmatter 触发词与发布元信息）
├── assets/
│ ├── icon.png # 正方形品牌图标（SkillHub 图标位）
│ └── cover.png # 16:9 发布封面图
└── app/ # 完整可运行应用（不含 node_modules / 运行数据）
├── server.js package.json package-lock.json README.md
├── src/ public/ samples/ scripts/ test/
发布前自检：
- [ ] SKILL.md frontmatter 的 name 全局唯一、description 含足够触发词、category/tags/trigger/version/author 齐全
- [ ] assets/icon.png 为正方形、assets/cover.png 为 16:9 封面
- [ ] app/ 不含 node_modules、data/、密钥与绝对路径
- [ ] 应用已通过 npm test（34 项冒烟）
- [ ] 合规护栏与免责声明就位，无荐股/预测/收益承诺话术
- [ ] 整包 ≤ 10MB（当前约 2.6MB）
© 盈指量（杭州）科技有限公司 · 信息整理与研究辅助工具
