DSH Finance Data
面向 DSH 的金融数据采集插件:纯 JavaScript、零依赖。按需采集 A 股 / 基金 / 指数 / 宏观 / 期货 / 估值 / 财报 / 事件等公开数据,解析后增量留存本地,并提供模型工具。
特性
- 报名字/代码即可采集(
贵州茅台/CPI/黄金/801010),自动解析到对应数据源 - 增量落盘,重复采集
added=0;数据随 profile 持久,卸载重装后可续采 - 纯 JS、零 npm 依赖;从 GitHub 安装,无需构建授权
安装
安装为 DSH 组合包（bundle），每个会话自动获得 finance_* 工具：
dsh plugin --profile <name> add github:coder-wu/dsh-finance-data
# 组合包层在启动时加载，安装后需重启 dsh：
dsh --profile <name>> 建议锁定 commit：dsh plugin --profile <name> add github:coder-wu/dsh-finance-data#<sha>
数据落盘
- 数据经 DSH 的
ctx.fs服务写盘，受 workspace 沙箱约束：workspace-write 模式下仅允许写入工作区根目录（dsh 启动时的process.cwd()）与系统临时目录（/tmp、os.tmpdir()）；沙箱外路径会被拒绝（FS_SANDBOX_DENIED）。 - 默认数据根目录为 dsh 启动目录，明细在
./data/<source>/<symbol>.json，索引在status.json/catalog.json。已采集数据随磁盘持久，卸载重装后按日期增量续采。 - 可用环境变量
FINANCE_DATA_ROOT覆盖数据根目录（优先于默认.）。
卸载
dsh plugin --profile <name> remove dsh-finance-data> 卸载只移除配置层与依赖，不清除已采集数据；重新安装后可继续增量续采。
使用
模型在对话中自动解析意图并调用工具:
| 你想 | 插件调用 |
|---|---|
| 采集贵州茅台日线 | finance_collect {target:'stock', symbols:['贵州茅台']} |
| 看 CPI / PMI | finance_collect {target:'macro', series:['cpi','pmi']} |
| 抓黄金期货 | finance_collect {target:'futures', futures:['gold']} |
| 看行业估值 | finance_collect {target:'valuation', scope:'industry'} |
| 查已采集数据 | finance_status |
finance_search {query}:把名字/代码解析为可采集候选finance_collect {target, ...}:按需采集并落盘;返回{ok, results:[{kind, added, asOf}]},重复采集added=0finance_status:按源显示最近采集日期与 catalog
target 支持:stock(A 股日线)、fund(基金净值)、index(申万 L1/L2)、csi(中证指数)、futures(COMEX/LME)、macro(LPR/PMI/CPI/M2/PPI)、valuation(行业/个股估值)、shareholders(股东户数)、reports(财报)、events(业绩预告/分红/预约披露/FOMC)。
数据源
| target | 数据源 |
|---|---|
stock | 新浪 getKLineData(名字→代码经东财搜索) |
fund | 东财 api.fund.eastmoney.com f10/lsjz |
index | 申万 swsresearch 指数日线(L1 31 / L2 134) |
csi | 中证 csindex index-perf |
futures | 雅虎 v8/finance/chart(COMEX/LME 金银铜) |
macro | 东财 RPTA_WEB_RATE(LPR)+ 金十 jin10(PMI/CPI/M2/PPI) |
valuation | 东财 RPT_VALUEINDUSTRY_DET / RPT_VALUEANALYSIS_DET |
shareholders | 东财 RPT_HOLDERNUM_DET |
reports | 东财 RPT_DMSK_FN_INCOME/BALANCE/CASHFLOW |
events | 东财 业绩预告/分红/预约披露 + 美联储 FOMC 日历 |
> 雅虎期货对数据中心出口 IP 限流(429),实网环境/代理下可用。 > EM_TOKEN 与金十 x-app-id 为对应网站公开网页客户端凭据(非私有密钥),可在 src/em.mjs / src/collectors/macro.mjs 中替换。
开发
npm test # 离线单元测试(不联网)
npm run test:static # 静态入口 index.js 冒烟测试(不联网)
npm run test:e2e # 端到端测试(真网络)
npm run build # 重新生成 index.js / plugin.json / plugin/host.js(产物已提交,改 src/ 后需重建再提交)License
[MIT](LICENSE)