Skip to content

Releases

v2.5.0

Choose a tag to compare

@github-actions github-actions released this 20 Nov 05:04

Added

  • 收息场景闭环(disc.income 域,4 个场景接口):与 web 应用台「收息佬」、开放平台
    wm-income 技能共享同一评分 SoT(sys/income/score.xs,真值在服务端、SDK 不重算)。
    • cli.dividend.rating(top_n, grade, industry, min_yield, gates):全市场收息排行
      (四维评分 + 档位 + 股息分排序 + 资格门)。memo 直读零冷算;COLD_CACHE 显式
      失败
      (cron 未就绪),绝不现场重算全市场评分。实测 ≈15k~70k EC。
    • cli.dividend.diagnose(symbols, include_history):收息诊断原生批量(一次
      eval 按票计价)——四维评分逐项解释 + 静态下限双腿复原 + 榜内位置 + 十年国债参照;
      deep 档才带分红史/方案。实测 ≈10k EC/票。
    • cli.dividend.calendar(cal_from, cal_to, codes):分红日历(公告/登记/除息/到账
      四日期任一命中即返回;stocks enrich)。实测 ≈20k/月。
    • cli.dividend.decomp(symbols, years):N 年持有收益拆解(≤10 票批量;总收益 =
      价格 + 股息贡献,hfq−nr 差值口径含再投效应)。热态 ≈10k/票;
      AT 锚点指标序列首查有冷物化尖刺(单票可达 ~20 万 EC),复查即热。

Changed

  • 评分真值层从 web_echo/v2income 迁入 sys/income(catalog 化,10 函数进公开目录);
    web 收息佬前端按 file_name 直调的 decomp.xs/calendar.xs 改薄壳(路径不变零改动);
    skillhub wm_income.xs 编排改调 sys 函数。三面共享 SoT,消除双实现。
  • 收息榜直读 EC 优化:循环去 DEFAULT 链 + topn 截断早停——同语义 95 万 → 5.4 万 EC
    (实测;老版 skill 同语义贴 fuel 顶)。
  • indices.members_daily 上游新函数(前向 PIT 成分快照)随 cli.index.members_history
    门面公开(并发会话交付,随本版四源发布)。

Fixed

  • hist_stats 窗口测试与 5b5f781 白名单放开(5y/10y)对齐。
  • llms-full 体积预算 412k → 424k(income 场景新节)。

v2.4.2

Choose a tag to compare

@github-actions github-actions released this 19 Nov 08:26

Fixed

  • 英文 Quickstart 计费模型写反(docs/QUICKSTART_EN.md):原文「Requests are
    billed per request, not per row — which is why batching matters」与 EC 的真实
    计费口径相反——EC 按服务端物化行计,批量只省请求数与调度、不省 EC(见
    docs/LIMITS.md §4)。英文用户照此跑全市场会严重超额。改为双计费口径说明
    (限流按请求 / 计费按 EC 行),并补 cli.cost_estimate 先估后取入口。同文件
    修正 2,752→2,983 指标码、132→152 核心接口、快照日期、示例输出值与示例数。
  • demo_client() 的同签名承诺不成立:DemoClient 缺 8 个命名空间
    (cbond/etf/intl/segments/filings/forecast/workout/estimates)
    与多个方法,README 推荐的 cli.notice.has_buyback(...) 在 demo 上直接
    AttributeError——等于「假装没有这个能力」。新增 _UnsupportedNamespace 垫片:
    属性存在且可调用,调用即抛 UsageError(code="demo_unsupported"),并按 live
    门面挂真实 __signature__;dunder 名仍走 AttributeError。
  • 单位口径文档自相矛盾:README/GUIDE 称「全库返回前做量级校验」,而
    docs/INDICATORS.md 明说只有精选 78 码带守护(函数级 66/317 ≈ 20.8%)。
    两处表述已对齐;同时把文档示例里 up_pct 的 80.3 / 9.5 改为小数
    (0.803 / 0.095),与 2.0「*_pct 一律小数」契约一致——此前测试 FakeClient
    直接返回百分数,把错误示例焊死成绿色。
  • docs/ERRORS.md 处理范式示例无法运行:from wmshare import QuotaError
    报 ImportError(QuotaError 未从包根导出),而 test_errors_doc_in_sync
    只比对「生成器输出 == 文档」,把错行硬编码进生成器后门禁永远绿。已导出
    QuotaError(LimitError 子类,纯增量)、示例补 import time。
  • estimate_cost 严重低估多票成本:valuation.daily_basic 分支忽略
    syms 票数,200 票时报的是单票价(低估一个数量级以上)。按 2026-11-19 live
    实测 9 个点(1/5/10/30/50 票 × 跨度 1/18/90 自然日)拟合为
    150 + 票数 × (230 + 20 × 跨度),全部落点误差 <12%;syms>1 时 note
    明示「EC 按票计价,批量不省算力」。
  • 对外计数与日期漂移:server.json 描述 2,752→2,983(MCP Registry 机器可读
    描述)、SKILL.md 5,691→5,375 家与 12→11 次请求、GUIDE.md 空参捷径阈值
    ≥4,000→≥2,000 票与 311→317 函数、README 12→11 次请求、examples 的
    wmshare[dataframe] 死引用(2.0 起 pandas 为核心依赖)、README/examples 的
    「18 个示例全部支持离线」实际为 3 纯离线 + 14 --demo + 1 需凭证。

Changed

  • 门禁扫描面扩围:test_docs_no_stale_counts 纳入 QUICKSTART_EN、
    METRIC_ADAPTER、examples/README、server.json 并补英文计数 pattern;
    扩围后立刻抓出 3 处此前漏掉的真实漂移。
    test_demo_signatures_cover_live_facade_params 不再对 demo 缺失方法
    continue 静默跳过(缺失即失败),新增
    test_demo_unbacked_calls_raise_demo_unsupported、
    test_quickstart_en_matches_runtime、test_pct_example_values_are_decimals、
    test_errors_doc_snippet_imports_resolve 四条防回归门禁。
  • docs/PROMOTION.md 迁出仓库(→ 工作区 ../promo/):推广执行手册属方案/流程
    类文档,CONTRIBUTING.md 明确要求不入库。
  • release 流水线新增前置质量门禁(.github/workflows/release.yml):
    job 链改为 gates → release → publish-pypi,PyPI 上传前跑与 ci.yml 同款的
    离线门禁(leak / catalog / taxonomy / units / 版本互校 / 许可证 / 守卫覆盖率 /
    8 个生成物漂移 / mypy / pytest)。此前 release.yml 只做版本互校 + twine check,
    1.21.0 因此把指向已下线底层函数的门面直接发上 PyPI,次日才出补丁;发布件不可
    撤回,故门禁必须前置到流水线而非依赖人工记忆。

v2.4.1

Choose a tag to compare

@github-actions github-actions released this 19 Nov 07:35

Fixed / Changed

  • valuation.daily_basic 读窗下推(EC 大幅下降):此前无论请求多窄的区间,
    都会先读满 1,500 个日文档再由 XS 侧过滤——13 天窗口实测扫 727 个文档、
    11,944 EC。现在 begin/end 通过 kernel window + anchorTs 锚点下推到
    读面
    ,只读窗口覆盖的日文档:13 天窗口 249~962 EC(降 92%)、单日
    578 EC(原 1,707,降 66%)、1 年 8,626 EC(原 23,371,降 63%);
    不给 begin/end 时行为不变(全表扫 ≈23,414 EC)。
    • meta.window 新增 pushed_down 标志;scan_days/scan_limit 反映本次
      实际读窗(下推后按跨度算出,不是固定 1,500)。
    • as_of 合同不变(窗口查询时单独点查表内最新,≈33 EC)。
    • 正确性:6 个标的 × 6 种跨度(单日/两日/月内/半年/全年/跨年)与「全量读后
      过滤」逐行完全一致。
    • estimate_cost("valuation.daily_basic") 模型按新成本结构重写:有窗口时
      ≈2540 EC/日文档 + 地板,无窗口时 ≈2.02.6 万 EC。
    • docs/BACKLOG.md:该项原记为「依赖上游 kernel 能力、未排期」,属未实测
      的误判
      (kernel 锚点在 alt.valuation_daily 上完全可用);已更正为落地。

v2.4.0

Choose a tag to compare

@github-actions github-actions released this 19 Nov 07:13

Added

  • valuation.daily_basic 读窗口可见化与自动翻页:信封 meta 新增
    window 段(scan_days / scan_limit / oldest_scanned / truncated /
    requested_begin)。此前超过服务端读窗口(1,500 日文档)更早的日期静默
    缺席
    ,调用方无从判断;现在 truncated=True 明示区间左端可能缺行,SDK 按
    oldest_scanned 自动向前翻页(上限 10 片 ≈15,000 交易日)拼成完整升序序列,
    回 meta.pages。live 实测 600519 自 2015 起 → 2 片 724 行(此前只能拿到
    最近 200727 日且不知被截断)。
  • cli.valuation.daily_basic_coverage(symbol, begin, end):可用范围发现。
    不拉序列,只取一个日窗口的 window 元数据,返回
    {as_of, oldest_scanned, scan_days, scan_limit, truncated, pages}——先探
    「这段区间有没有数据 / 表能回溯到多早」再决定要不要拉整段。
  • 多票每日估值序列:服务端 valuation.daily_basic_multi(syms, begin, end, fields)(一次 eval 内循环多票)与 SDK cli.valuation.daily_basic_multi (symbols, ...)。行合同与单票完全一致({date, symbol, field, value} 升序,
    可直接 concat 分组),meta.per_symbol 给每票的 count /
    oldest_scanned / truncated。EC 仍按票计价——批量只省请求调度,不省
    算力;≥200 票时 SDK 告警成本量级。
  • 2.3.0 新面补齐 estimate_cost 成本模型(全部 live 实测,无 cache_hit
    拍脑袋档):buyback.snapshot 170750、notice.type_keys/type_regex
    5
    20、toplist.by_date 17013,000(冷/热差)、toplist.by_symbol
    185
    1,600、futures.mapping 1605,000(note 提示全历史 ≈21.4 万)、
    pdf_doc.search 按行 150
    200/行。
  • demo 快照重拍 2026-11-19:2.3.0 的三批新面此前在 demo 侧一律
    demo_unsupported,现在全部真实回放——equity.buyback_snapshot(演示宇宙
    10 票)、toplist.by_date/by_symbol(整日榜单 95 行 + 单票历史)、
    futures.mapping(RB.SHF/IF.CFX 各 121 行)、notice.categories/ category_regex(14 类目改为从快照回放)、pdf_doc.search/read_text/ read_markdown/status/find_by_*。榜单盘后 T+1 落库,生成器向前回退最多 5 天
    取最近有数据日并记 toplist.date。

Changed

  • 计数:24 域 / 317 底层函数 / 2983 指标码 / 152 核心接口 /
    169 friendly API;guard 66/317 = 20.82%。
  • docs/BACKLOG.md:daily_basic 四项候选闭环(分页+truncated、coverage、
    多票批量、成本再校准);begin/end ts 下推保留为上游依赖(需 kernel
    日文档级过滤);卫生窗 limit≤0 排查完成。

Fixed

  • fmt_maps 跨标的缓存串号(13 域,严重):缓存键只有「行数:首:末日期」
    不含标的,两只票同交易日区间、同窗口长度必然撞键——kline.query_bars 对
    任意标的都返回首调标的的 K 线(实测 600519/000858/601318/688981 全同)。
    各域新增 rows_owner 探测标的字段并拼进指纹,缓存键 v1→v2 避开线上旧档。
  • pdf_doc.search 恒返回空数组(自 2026-11-09):循环里裸 APPEND(out, v)
    不改 out,静默 0 行;连带 read_markdown 的 stock_code 回退与
    find_ready 全废。改 out = out.append(v)。
  • toplist.by_symbol 复跑无折扣:取数仅 37 EC,成本全在逐 doc 扫全市场
    行;按数据版本键(store 最新 trade_date)缓存 + 凑满 limit 即停,
    冷 2,349 → 热 185 EC。
  • limit≤0 语义不一致:kline.query_bars(..., 0) 返 0 行、
    moneyflow.query_bars(..., 0) 返 200 行(kernel 默认而非域默认)。三域
    包装层统一归一(kline.store_window_limit / moneyflow.store_limit /
    bonus.store_query)。

v2.3.1

Choose a tag to compare

@github-actions github-actions released this 19 Nov 05:18

Docs

  • valuation.daily_basic 读窗事故登记与合同校准(SDK 代码无变更):
    2026-11-19 午间发现端点只回最新 ~200 交易日——kernel/analysis 读面对
    limit≤0 取 200 默认,XS store_query(s, 0) 显式传 0 不被 DEFAULT 替换
    (11-18 实测曾为全量 726 日 / 18,317 EC,当日服务端发布波收紧;store 数据
    始终完好)。服务端 script 侧当日修复:store_query 包装层把 ≤0 归一到
    DEFAULT_LIMIT(015032f2 / pipeline-5982),修复后实测 600519/000001
    全量各回 727 日(2023-11-20 起)、历史窗口 ok=true。LIMITS §1 窗口行按
    修复后实测校准:合同窗口 1,500 行(XS DEFAULT_LIMIT),累积 >1,500 日
    (≈6 年)后更早区间静默缺席(无 truncated 标志)。服务端候选清单移至
    docs/BACKLOG.md([Unreleased] 按仓纪律保持为空)。

v2.3.0

Choose a tag to compare

@github-actions github-actions released this 19 Nov 02:05

Added

  • 龙虎榜域 market.toplist:cli.toplist.by_date(trade_date, limit)(指定
    交易日全市场榜单)与 cli.toplist.by_symbol(symbol, limit)(单票上榜事件
    历史)。同票多上榜原因各一行(榜单原值行合同);15 字段行:率为小数
    (上游百分数 /100)、金额=元、日期=ISO,11 个金额/率量级守护(结构性宽界,
    live 锚点单日 95 行、最大成交额 ≈8.5e9 元)。席位/营业部明细上游无落库,
    不提供按席位查询(明示缺口)。
  • 期货换月映射 cli.futures.mapping(symbol, begin, end):主力连续码 →
    当日实际合约(换月追踪,随日线日更;RB.SHF 全历史 date 升序,窗口可空)。
    期货域首个目录函数(此前期货走 $FUT_* 指标码)。
  • 回购六口径快照 cli.equity.buyback_snapshot(symbol):exec/plan ×
    近1年/累计 × 含/不含注销式(元/原币;无数据源字段为 None 不伪造 0;
    A股 plan_/cancel_ 齐全,港股仅 exec_*)。live 实测四标的量级
    2.4e8~5.1e10。
  • 公告类目表 cli.notice.categories() / cli.notice.category_regex(key):
    14 类目键列表与类目→匹配正则解析(未知键原样透传,可直接传自定义正则)。
  • 公告 PDF 全文域 disc.pdf_doc:cli.pdf_doc.search / read_text / read_markdown / status / find_by_url / find_by_key 六个纯读面
    (pdftotext 预览正文 + 财报 markdown/经营评述挂接 + 转换状态)。
    写面(submit/ensure 触发抓取任务)标 internal 不进公开门面。
  • 随包目录 24 域 / 316 底层函数 / 2983 指标码 / 150 核心接口 / 167 friendly;
    friendly 层门面委托器支持跨命名空间域函数(corp.equity 域含
    buyback.snapshot)。

Changed

  • 指标目录刷新 2752→2983(上游 catalog 2026-11 重生成):$BUYBACK_AMT_*
    6 码等 231 个新码随包可查。语义跟随两码:$BONUS_RATE_TTM_LAST /
    $DPS_TTM_LAST 上游改报告期 LTM 口径(taxonomy 锁定表同步;实测值仍为
    小数,精选组 range [0,1] 兼容)。
  • 「基金净值未覆盖」口径修正(llms.txt / SKILL.md):ETF 九视图自 2.0 已
    覆盖,排除面=场外/LOF/货基(生产端明确排除,非欠账)。

Fixed

  • docs/PROMOTION.md 计数对齐当前真值;CHANGELOG 1.7.x 历史段「港美三大报表
    数据未上线」加注记(已随 v2.0 全量上线)。
  • guard_coverage 门禁阈值与 tests 基线对齐(0.156→0.2026,CI 同步——
    此前 CI 阈值过时会让回退漏拦)。

v2.2.1

Choose a tag to compare

@github-actions github-actions released this 18 Nov 10:43

Fixed

  • estimate_cost("valuation.daily_basic") 档位纠偏:此前标 cache_hit
    4200 EC,实测(2026-11-18 生产 probe)不是缓存——按扫描行计费:
    1 日 × 1 字段 = 1,707 EC,1 日 × 8 字段 = 1,851,13 交易日 × 2 字段 = 2,038,
    全史 726 docs × 8 字段 = 18,317。现模型 measured:无窗口 → 1,707
    18,317;
    传 begin/end → 地板 + ≈23 EC/自然日。以 metering.ec_cost 为准不变。

v2.2.0

Choose a tag to compare

@github-actions github-actions released this 18 Nov 06:39

Added

  • 区间取数自动分页:cli.kline.bars(begin=, end=)(日 K)与
    cli.moneyflow.bars(begin=, end=) 不传 n 时按「锚点切片」自动补齐——
    每片走服务端锚点窗口(kline.query_at_anchor(_adj)、moneyflow.query_bars_anchor),
    只物化 ≤ end 的行、覆盖 begin 即停,跨片去重后升序返回。任意长度区间一次
    拿全量、不静默截断
    ,计费 ≈ 区间实际行数(服务端窗口读取,客户端不砍量)。
    显式传 n= 保持「区间内最近 n 根」单次语义。
  • 目录新增 moneyflow.query_bars_anchor(+= 300 个底层函数);kline.query_at_anchor
    / _adj 补齐 normalize_with+units+ranges+checks 声明(锚点入口与正排查询
    行合同逐字一致,守护函数 59 → 61)。
  • _fields= 列投影(cli.call/call_batch/batch_all 与 kline/moneyflow/cbond/
    margin 门面):换算/排序之后只保留指定字段,按请求顺序输出;未知字段报
    UsageError(code="params")。不降 EC(EC 按服务端物化行计),只收窄返回体。
  • BatchResult.truncated:准全市场捷径下结果是否为请求集子集(停牌/索引外标的
    缺席时显式披露,便于用小清单补拉)。
  • 文档资产:docs/COMPATIBILITY.md(MAJOR/MINOR/PATCH 语义 + 弃用流程)、
    docs/LIMITS.md(硬限制与配方)、docs/ERRORS.md(错误码全集,源码扫描生成)、
    docs/DATA_CALENDAR.md(数据生产日历,兄弟仓缺失时 SKIP)、docs/changelog.xml
    (RSS)、docs/fields.json(236 个公开函数的字段/单位/范围)、
    docs/indicators/(2,753 个指标单页)。API.md 输出字段表新增「单位/换算」与
    「守护范围」两列。

Changed

  • kline.snapshot 批量捷径阈值 4,000 → 2,000:与服务端 snapshot_batch 对齐
    (去重 ≥2,000 的清单上游本来就按全市场扫描计费,空参捷径另享按日缓存)。
    大清单中停牌标的会进 truncated,用小清单(<2,000,逐票按量路径含停牌行)补拉。
  • estimate_cost 校准:区间查询改 range_rows 模型(按区间交易日密度)、
    kline.snapshot 认 symbol= 批量参数并区分空参捷径、缓存类接口拆出 cache_hit
    档(hist_stats/daily_basic/indices.trend 分别≈4200/4200/1~50 EC)。
  • demo 与 live 门面签名逐字对齐(58 对方法零漂移):补齐 _fields/freq/
    _raw/fut_symbol/native/min_ratio/idx 等形参,kline.last 由「返回 23
    字段快照」修正为「返回 9 字段 bar」(与 live 一致);未回放的能力一律
    UsageError(code="demo_unsupported"),不再以缺少形参抛 TypeError 或吞掉参数。
  • _validate_snapshot 扩展数据质量校验:calendar(升序/唯一/≤as_of)、margin
    (沪深成对、余额>0、universe 去重≤500)、futures(价格>0)。
  • 单位台账补登记 $VOLUME_AR_DAY(手)与 $ROC_TTM_LAST(百分数)。

Fixed

  • estimate_cost("kline.snapshot", symbol=[...]) 曾按单票估算(门面参数名与目录
    参数名不同的历史坑),现三种写法(sym/codes/symbol)都按票数估算。
  • 4 个接口返回说明为空、10 个参数说明为 —、组合接口参数兜底缺失。
  • test_live.py 中与 2.0 升序契约相反的降序断言(含 index.trend 新信封)。

Removed

  • docs/COST_MATRIX.md 与 tools/gen_cost_matrix.py:成本信息不对用户暴露,
    对外只保留运行时 cli.cost_estimate 与 docs/LIMITS.md 的硬限制;实测成本
    审计进维护者内部工具 tools/audit_ec.py(写 .internal/,不进 CI/文档)。

v2.1.0

Choose a tag to compare

@github-actions github-actions released this 18 Nov 01:42

Added

  • cli.valuation.daily_basic(symbol, begin, end, fields):个股每日估值序列——
    服务端物化宽表(alt.valuation_daily,仅 CN,airflow
    pipeline.cn.valuation_daily 每日 16:25 物化、SLA 当日 17:00)。8 字段
    (pe_ttm/pb/ps/pr/total_mv/circ_mv/turnover_rate/dv_ttm)全部服务端现成
    口径直出、2.0 基础单位;长表信封 {ok, as_of, data, meta},as_of 为
    表内最新行日期供调用方判新鲜度。数据自物化日起可用,历史回填深度见
    域目录 notes(诚实缺行,不伪造)。
  • estimate_cost:valuation.daily_basic 归入 cached_eval 档(物化表近似
    免费读;首日回补另计)。
  • demo 模式对该面显式 demo_unsupported(物化表未投产,无罐头不伪造)。

Changed

  • 目录扩容:fund.valuation 域(+1 函数 = 299 个底层函数 / 21 个数据域 /
    138 个核心接口);inventory.json 手工同步该条目(extractor 白名单已加
    valuation,下次上游重跑提取不丢失)。

v2.0.1

Choose a tag to compare

@github-actions github-actions released this 17 Nov 08:16

Fixed

  • demo_client().cost_estimate(...) 缺失(GUIDE 推荐的先估后取在演示模式直接
    AttributeError):EC 预估模型上提为模块级 estimate_cost,真实客户端与 demo
    共用同一套函数,纯离线零请求。

Changed

  • 无行为变更;Client._EC_* 类属性保留为模块常量的别名(既有取值不破)。