Repository navigation
Releases
Releases · open-winmale/wmshare
v2.5.0
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改薄壳(路径不变零改动);
skillhubwm_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
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.md5,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
Fixed / Changed
valuation.daily_basic读窗下推(EC 大幅下降):此前无论请求多窄的区间,
都会先读满 1,500 个日文档再由 XS 侧过滤——13 天窗口实测扫 727 个文档、
11,944 EC。现在begin/end通过 kernelwindow+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
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 内循环多票)与 SDKcli.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.snapshot170750、20、notice.type_keys/type_regex
5toplist.by_date17013,000(冷/热差)、1,600、toplist.by_symbol
185futures.mapping1605,000(note 提示全历史 ≈21.4 万)、200/行。
pdf_doc.search按行 150 - 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/endts 下推保留为上游依赖(需 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
Docs
valuation.daily_basic读窗事故登记与合同校准(SDK 代码无变更):
2026-11-19 午间发现端点只回最新 ~200 交易日——kernel/analysis 读面对
limit≤0取 200 默认,XSstore_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 行(XSDEFAULT_LIMIT),累积 >1,500 日
(≈6 年)后更早区间静默缺席(无truncated标志)。服务端候选清单移至
docs/BACKLOG.md([Unreleased]按仓纪律保持为空)。
v2.3.0
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
Fixed
estimate_cost("valuation.daily_basic")档位纠偏:此前标cache_hit
4200 EC,实测(2026-11-18 生产 probe)不是缓存——按扫描行计费:18,317;
1 日 × 1 字段 = 1,707 EC,1 日 × 8 字段 = 1,851,13 交易日 × 2 字段 = 2,038,
全史 726 docs × 8 字段 = 18,317。现模型measured:无窗口 → 1,707
传 begin/end → 地板 + ≈23 EC/自然日。以metering.ec_cost为准不变。
v2.2.0
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
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
Fixed
demo_client().cost_estimate(...)缺失(GUIDE 推荐的先估后取在演示模式直接
AttributeError):EC 预估模型上提为模块级estimate_cost,真实客户端与 demo
共用同一套函数,纯离线零请求。
Changed
- 无行为变更;
Client._EC_*类属性保留为模块常量的别名(既有取值不破)。