@mzzsfy/dsh-stock-assistant 0.0.0-stage → 0.3.2
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +100 -3
- package/cordis.patch.yml +3 -0
- package/package.json +62 -4
- package/src/application.mjs +231 -0
- package/src/budget.mjs +34 -0
- package/src/catalog.mjs +167 -0
- package/src/client.js +1731 -0
- package/src/collector.mjs +171 -0
- package/src/demand.mjs +33 -0
- package/src/executor.mjs +110 -0
- package/src/index.js +33 -0
- package/src/kline-cache.mjs +29 -0
- package/src/market-model.mjs +99 -0
- package/src/provider-registry.mjs +18 -0
- package/src/provider-router.mjs +33 -0
- package/src/providers/eastmoney.mjs +234 -0
- package/src/providers/sina.mjs +121 -0
- package/src/providers/tencent.mjs +122 -0
- package/src/providers/tushare.mjs +92 -0
- package/src/providers/xueqiu.mjs +81 -0
- package/src/routes.mjs +65 -0
- package/src/schemas.mjs +98 -0
- package/src/serve-vendor.mjs +22 -0
- package/src/service.mjs +82 -0
- package/src/state.mjs +56 -0
- package/vendor/lightweight-charts.standalone.production.js +7 -0
- package//345/205/274/345/256/271/346/200/247/346/265/213/350/257/225.md +242 -0
|
@@ -0,0 +1,242 @@
|
|
|
1
|
+
# 股票工具兼容性与验收记录
|
|
2
|
+
|
|
3
|
+
日期:2026-10-29。包版本0.1.0,Node v24.14.1,Windows。验证由当前主会话执行,用户明确禁止子agent;不声称独立审查通过。本记录将已验证行为与未验证环境事实分开,不以测试通过推导真实账户可用。
|
|
4
|
+
|
|
5
|
+
## 环境与范围
|
|
6
|
+
|
|
7
|
+
- 主测真实宿主:DSH 0.2.1-rc.2,使用系统临时目录中的独立 `DSH_HOME`、临时web profile、随机端口;只装载股票插件与session-manager公共client占位链。无真实行情token,不发送对话轮,不消耗LLM或行情账户额度。
|
|
8
|
+
- 浏览器:有头 `dev-browser`,口令隔离窗口。固定行情夹具与真实宿主各一个标签页。生产3080页面、生产profile和宿主进程不变。
|
|
9
|
+
- 行情夹具:包内 `test/browser-fixture.mjs`,运行真实client与Host应用/HTTP,使用测试适配器、内存数据域、真实common-tools快照调度器;事件传输替为测试桥。真实WS另外在隔离宿主验证。
|
|
10
|
+
- 持久化:实际宿主 `DomainFacility` + 系统临时目录文件后端夹具,校验本包spec、put/update/close/重开;不把内存桩称为真实磁盘。
|
|
11
|
+
|
|
12
|
+
## 分层结果
|
|
13
|
+
|
|
14
|
+
| 层次 | 结果 | 实际证据 |
|
|
15
|
+
| --- | --- | --- |
|
|
16
|
+
| L1 加载 | 通过 | `node scripts/smoke-load.mjs`,19包入口全部加载,含股票插件 |
|
|
17
|
+
| L2 装配 | 通过已测部分 | 隔离真宿主启动,股票导航出现,点击后根main空态显示;`snapshot`200;一份归属完整包名的style;公共client依赖可解析 |
|
|
18
|
+
| L2 通道 | 通过已测部分 | 真宿主`/api/bus/ws`订阅股票空间→ready;POST显示偏好→收到invalidate,带serverEpoch/snapshotSeq |
|
|
19
|
+
| L3 夹具全流程 | 通过 | 添加实例→六条市场能力路由→检查→保存→同步目录/日历→搜索茅台→显式选择→添加→刷新→详情,显示同源价格/涨跌/来源/未知延迟 |
|
|
20
|
+
| L3 生命周期 | 通过已测部分 | 隔离夹具详情中输入未保存别名→隐藏工具→模拟会话通知→重开,详情/草稿保留;Node实际factory测试覆盖无session绑定、反复入口、卸载 |
|
|
21
|
+
| L3 存储 | 通过 | 真实DomainFacility打开独立stock_sidebar(验收时域名,2026-10-30 已随包改名 stock_assistant);写偏好→关闭→重开,revision与偏好回读;域表仅control/cache,未写默认settings |
|
|
22
|
+
| L3 真实账户 | 未验证 | 本机与用户级环境均无`DSH_STOCK_TUSHARE_TOKEN`;授权后执行`node scripts/stock-probe.mjs`即可完成该项(约3次请求)。无凭据HTTPS协议与AUTH映射已验 |
|
|
23
|
+
| DSH版本 | rc.2/rc.3兼容(2026-10-30 当时记录) | rc.2与rc.3隔离真宿主均完成:导航入口、main页面、data-plugin样式、snapshot 200、WS ready→invalidate;rc.3另验证无凭据AUTH检查拒绝与保存守卫。当时 manifest 登记两版本 compatible;当前 manifest 已增至 rc.2/rc.3/rc.5/0.2.2-rc.1 四个 compatible,以 manifest 为准 |
|
|
24
|
+
|
|
25
|
+
## 自动化验证
|
|
26
|
+
|
|
27
|
+
包内 `npm test` 覆盖实际生产模块与ModuleLoader factory:标准身份与价格/时间、能力注册、Tushare字段名映射与错误、两独立适配器混用、沪深拆批、主备驻留、配置检查摘要、独立域并发/幂等/失败与撤销、配额、租约、周期、手动批次等待、迟到结果、防回滚、IME、暂停与设置冲突、真实React渲染及装配守卫。
|
|
28
|
+
|
|
29
|
+
仓库级 `node --test "tests/*.test.mjs"`:109项,99通过、0失败、10跳过。跳过为既有Playwright Chromium缺失的browser-probe与onboarding夹具自测;本任务的浏览器验收使用有头dev-browser实际执行。输出中的聚合器故障注入FAIL/missing/dual是测试预期,最终失败数为0。既有DEP0190警告来自仓库子进程shell测试,不在本次插件代码中。
|
|
30
|
+
|
|
31
|
+
图标包 `npm test`:76/76通过,生产者自动发现已包含股票NAV_ICON,不新增手工清单。
|
|
32
|
+
|
|
33
|
+
最终股票包 `npm test`:57/57通过、0失败、0跳过(含U09/C05/C06/C07/P12缺口与目录细分、收盘对账、未知预算探针等最后一批)。最终全仓smoke仍为19/19加载通过。文件核对未发现疑似密钥或测试产物误入files白名单。`git diff --check`通过。
|
|
34
|
+
|
|
35
|
+
## 2026-10-30 补充验证
|
|
36
|
+
|
|
37
|
+
- BDD缺口:routing.test扩展P12驻留期内切回被拒并验证epoch推进;新增bdd-gaps.test.mjs覆盖U09(无目录/搜索来源时CATALOG_NOT_READY)、C05(真实执行器预算包装下手动刷新429+等待时间)、C06(部分缺行成功且保旧值)、C07(Retry-After约束下轮时间)。
|
|
38
|
+
- rc.3多版本:pnpm安装0.2.1-rc.3到独立home(需仓库`scripts/compat/lib.mjs`同款`allowBuilds`清单,否则`ERR_PNPM_IGNORED_BUILDS`);junction挂载工作副本,`dsh web`正常启动。有头dev-browser验证:导航入口存在、点击后main工具页渲染(heading"股票")、1份data-plugin样式、snapshot 200、WS订阅ready→写偏好→invalidate回包。无凭据下provider-check返回AUTH denied,configuration被CHECK_REQUIRED守卫拒绝(符合规格:检查失败不能启用能力)。Tushare适配器在rc.3闭包下经真实执行器触达`api.tushare.pro`并完成40101→AUTH映射。
|
|
39
|
+
- 真实账户探针工具:新增`scripts/stock-probe.mjs`(仓库根执行,`node scripts/stock-probe.mjs [XSHG|XSHE]`),读`DSH_STOCK_TUSHARE_TOKEN`,按quotes/catalog/calendar各1次最小只读请求输出JSON结果;无凭据时明确退出码2。本机与用户级环境实测均无该变量,真实账户行为待授权执行,工具已就绪。
|
|
40
|
+
- manifest `dsh.compatibility.dshReleases` 当时登记 `0.2.1-rc.2`/`0.2.1-rc.3` 为 `compatible`(依据上述隔离宿主接入证据);当前已增至 rc.2/rc.3/rc.5/0.2.2-rc.1 四个 compatible,以 manifest 为准。
|
|
41
|
+
|
|
42
|
+
## 2026-10-30 公开行情适配器
|
|
43
|
+
|
|
44
|
+
用户要求接入腾讯/新浪/东财等零注册来源,按"每个平台一个独立文件"落位:
|
|
45
|
+
|
|
46
|
+
- 新增`src/providers/tencent.mjs`/`sina.mjs`/`eastmoney.mjs`,仅声明`quotes`能力,GBK/JSON解析、停牌`"-"`不伪造价格、缺行记NO_DATA、冲突报BAD_PAYLOAD,均走标准合同(probe+quotes+Network映射)。`application.mjs` registry默认装配四适配器。
|
|
47
|
+
- 新增`test/public-providers.test.mjs`四项:三源字段解析(含时间戳/成交量单位/涨跌派生)、东财停牌null语义、注册表能力校验、网络错误归NETWORK。真实拉取实测:腾讯沪深两证券(茅台1370.80/平安11.53带快照时间)、新浪与东财对平安银行同秒同价11.54一致。
|
|
48
|
+
- 最终包测试**61/61通过**。公开源在设置页按市场选主/备即可用,无需凭据;额度按本地保守预算管理,无SLA与延迟承诺已在README明示。目录/搜索/日历仍走Tushare(公开接口未提供标准目录端点,不伪造全量目录来源)。
|
|
49
|
+
|
|
50
|
+
## 2026-10-30 零注册全流程闭环
|
|
51
|
+
|
|
52
|
+
用户确认"多数据供应商、每个独立部分便于维护"后追加:
|
|
53
|
+
|
|
54
|
+
- **东财扩展 catalog/search**:`clist` 分页目录(每页100、动态页数上限50、按市场板块过滤、重复身份BAD_PAYLOAD)、`suggest` 联想搜索(中文/代码/首字母拼音;实测全拼`maotai`不命中属来源行为)。descriptor 新增 `credential:'none'` 声明。
|
|
55
|
+
- **免凭据实例机制**:`credentialEnv=null` schema 支持(校验强制免凭据实例必须声明保守预算,防无界请求);executor 跳过 Host 环境检查;snapshot 的 credentialPresent 对 null 恒真;设置页适配器切换按 descriptor 自动置空/恢复凭据字段并标注"(免凭据)"。
|
|
56
|
+
- **探针工具双源**:`node scripts/stock-probe.mjs XSHG eastmoney` 免凭据实测 quotes ready 294ms / search ready 1035ms;catalog 因本机此前连续分页触发来源临时限流返回 NETWORK(等待自愈,插件退避即为此设计),换 XSHE 或稍后重试即可。
|
|
57
|
+
- **U03 测试**:真实渲染断言未选中候选时"确认添加"disabled,不自动取首项。
|
|
58
|
+
- 最终包测试 **65/65 通过**(公开适配器7项含免凭据合同),smoke 19/19。零注册路径文档已更新到 README(含混合路由示例与日历缺失的保守行为说明)。
|
|
59
|
+
|
|
60
|
+
## 2026-10-30 首用引导与市场浏览(用户手动测试反馈修复)
|
|
61
|
+
|
|
62
|
+
用户在隔离宿主实测发现三个首用断点,同根为"首用路径断裂":
|
|
63
|
+
|
|
64
|
+
- **默认数据源**:`initialControl` 现内嵌 `defaultConfig()`——免凭据 eastmoney 实例(rpm=60)+ 沪深 catalog/search/quotes 六条路由,配置自身过 parseConfiguration 校验。已持久化的空 root 不自动改写,设置页空配置时显示「启用默认数据源」(提交快照 `suggested` 字段,与初始配置同源)。
|
|
65
|
+
- **市场浏览**:catalog 新增 `browse({market,offset,limit})`(代码升序分页,limit钳1..200,offset钳≥0;语义修正:无有效缓存记录才报 CATALOG_NOT_READY,空目录是合法状态);routes 注册 GET `/browse`;顶栏「浏览市场」入口 + BrowseView(市场切换/分页/行内加自选/空态同步引导)。
|
|
66
|
+
- **搜索引导**:搜索页在目录未就绪错误下显示「前往浏览市场」直达浏览视图,不再死路。
|
|
67
|
+
- 测试新增 7 项(D1/D2/E1/M1-M4),包内 **72/72 通过**,smoke 19/19。BDD 场景与决策记录见 `.work/feat-first-run-browse.md`。
|
|
68
|
+
|
|
69
|
+
## 2026-10-30 审查修复(独立子代理审查结论落地)
|
|
70
|
+
|
|
71
|
+
阻断项 B-1:一键默认源直提交必被 CHECK_REQUIRED 拒绝——改为填充 settingsDraft 走既有「检查→保存」流(不绕过合同),补 HTTP 层保存回路测试(空 checkIds 拒绝→检查→保存成功)。采纳建议:错误码替代文案耦合(errorCode/CATALOG_NOT_READY)、eastmoney 分页 complete 判定移至 break 前并提常量、全批 secids 无效降级逐证券 NO_DATA(不再 BAD_PAYLOAD 瘫痪路由)、删除未消费实体(maxCatalogBatch/timestampSemantics×4/budget.reset/queryId 回显)、服务端不变式失配归 INVARIANT_VIOLATION 500、ensureCaches 失败经 snapshot ensureError 在 UI 展示、探针词按市场选代表证券(跨市场词曾误判 XSHE search denied)、GBK 真实多字节夹具、GET /browse HTTP 层钳制用例。未采纳:CATALOG_NOT_READY 粒度统一(remote 为能力守卫、browse 为市场数据守卫,语义本不相同,仅改文案指明出路)。包内最终 **74/74**。真实宿主端到端复测:默认六路由开箱→检查(search/quotes ready,catalog 因 clist 域对本机临时限流 denied 属来源侧)→深市搜索 ready→按合同拒未就绪保存。
|
|
72
|
+
|
|
73
|
+
## 有头实操与网络记录
|
|
74
|
+
|
|
75
|
+
浏览器证据目录为本次dev-browser会话自动生成的本机目录,未打入npm包;可复现夹具保留在test目录。原始操作产物包括截图、DOM、Markdown和console:
|
|
76
|
+
|
|
77
|
+
- 固定行情配置全链路:初轮有头截图/DOM包含添加实例、路由、检查、同步、搜索、确认添加与详情;实际价格1428.00、+2.00%,延迟未知。
|
|
78
|
+
- 当前源码夹具:`181–193`操作记录。通过HTTP播种两市场三证券配置,实际点击详情、置顶、删除及立即撤销;撤销后Host回读`restored:true`。1280px双栏、768px单栏、360px单栏,document与工具root均无横向溢出;窄屏隐藏来源辅助列,返回自选按钮继承自有样式。
|
|
79
|
+
- 显示主题:1280px亮色、768/360px暗色截图。颜色从宿主语义token映射,真实宿主确认主按钮白字/黑底,一份data-plugin样式。
|
|
80
|
+
- 运行时:隐藏/再打开与会话变化夹具通知后,未保存别名“长期观察”与详情保留;Node factory测试另外验证订阅释放、暂停只影响本页、重复入口不重发需求。
|
|
81
|
+
- 初轮失效风暴:50条通知合并成两次snapshot,启动相距1013ms;长空闲基线snapshot14→14。新夹具`194→195`实测1078.737秒,snapshot计数21→21,无周期HTTP快照;其中供应商时段为已知休市。不能据此替代交易时段持续变价的所有5分钟组合。
|
|
82
|
+
- 真实宿主记录`171–180`:根导航与空态、主按钮宿主token、专用域快照;独立WS探针收到ready→写偏好→message/invalidate,浏览器刷新后偏好仍为30秒。
|
|
83
|
+
|
|
84
|
+
无凭据HTTPS端点检查:POST `https://api.tushare.pro`,token为空,HTTP200、JSON code40101,确认HTTPS端点可达及认证错误协议。已将40101认证失败映射为AUTH并用固定结构测试;未读取本机token、未取得真实行情。
|
|
85
|
+
|
|
86
|
+
## 未验证与当前边界
|
|
87
|
+
|
|
88
|
+
- 0.2.1-rc.2/rc.3之外版本、真实浏览器多窗口同时写、实际关闭最后一条宿主会话、30次P95打开时延、150%浏览器缩放及所有5分钟网络组合尚未逐项实测。生产HMR开发通道未经本插件改动验证(未改生产profile,无可热重载对象;client为请求现读)。
|
|
89
|
+
- client factory测试能证明代码不引用session,不代替真实宿主全部会话操作人工验收;测试夹具SSE桥不代替真宿主WS。两者证据分开记录。
|
|
90
|
+
- 当前内置生产适配器仅Tushare;混平台抽象由两独立测试适配器覆盖。真实平台字段、权限、预算及来源最终时效需授权账户单独核对。
|
|
91
|
+
- 收盘边界最后对账、目录上限板块细分、U09/C05/C06/C07/P12驻留等缺口已补固定结构测试,最终计数57/57。未逐项复刻全部57条BDD的每个环境组合,测试名与BDD ID的对应关系以断言语义为准。
|
|
92
|
+
- 设置与自选从专用stock_sidebar结构持久化(验收时域名,现 stock_assistant),报价只在内存;浏览器刷新清临时草稿。卸载保留数据;本轮无发布、push或生产安装。
|
|
93
|
+
|
|
94
|
+
## 环境收尾
|
|
95
|
+
|
|
96
|
+
本任务启动的旧/最终行情夹具与临时home真宿主均已停止,相关进程与端口两次确认无残留;有头隔离窗口的两个测试标签均已关闭。源码、测试与持久文档保留,临时日志/计划位于忽略的本地工作目录,没有进入包的files白名单。生产宿主未启停、生产profile未修改。
|
|
97
|
+
|
|
98
|
+
## 2026-10-31 K线与多市场端到端(M1–M6)
|
|
99
|
+
|
|
100
|
+
测试基线 node --test **123/123**;隔离宿主(argv=local,端口随机)+ dev-browser 有头六轮实测,期间定位并修复的缺陷均已带回归测试提交:
|
|
101
|
+
|
|
102
|
+
| 环节 | 实测证据 |
|
|
103
|
+
| --- | --- |
|
|
104
|
+
| 东财日K | XSHG:600519 `1d` 250 根、末收 1392.05;XSHE:000001 `trend` 241 根 09:30 起、preClose 11.54 |
|
|
105
|
+
| 双源对齐 | 东财/腾讯 000001 日K 同值 11.64;00700 双源 383.6/385.20(cents 归一化后一致) |
|
|
106
|
+
| 港股 | XHKG:00700 `1w` 250 根末收 383.6;腾讯备源 qt[4] 昨收 11.54 与东财 f18 对齐 |
|
|
107
|
+
| 美股 | XNAS:AAPL `1M` 250 根末收 344.63;secid 105 前缀动态归属 |
|
|
108
|
+
| 日韩英 | 7203 东证 176.7203 / 005930 韩证 177.005930(旧快照) / 155.SHEL 伦交所 4036.5 探针全通,八市场 verifiedByDefault=true |
|
|
109
|
+
| 搜索市场面 | remote `00700` 返回 XHKG 腾讯控股·HKD + 沪深 fuzzy;`AAPL` 返回 XNAS 苹果·USD;市场面=启用实例适配器市场并集(Set 扁平化缺陷已修) |
|
|
110
|
+
| 真机一键配置 | 设置页按钮 → provider-check 8 项 ready(capability 并集)→ configuration 保存 → klineReady 五市场翻转 |
|
|
111
|
+
| 真机图表 | 茅台日K 蜡烛+MA 三线+量副图+昨收虚线;分时 Area+时间轴 HH:mm;腾讯周K 跨年轴+HKD 徽标;detail 全页单列 holderW=444px |
|
|
112
|
+
| 真机港美行情(2026-11-01 补) | XHKG:00700 自选行 383.60/+1.59%(红涨)、XNAS:AAPL 344.63/-1.23%(绿跌)多市场混排同屏;AAPL 详情 USD 徽标+月K 跨 2023→2026 蜡烛长轴+字段栏全数据(最高 349.19/最低 334.35/昨收 348.91/量 67841555);期间修复 search/catalog 探针词按市场代表证券(沪深词致港美误判 denied)与离 detail 视图 detailId 残留 |
|
|
113
|
+
| 从零用户流(2026-11-01 UX 轮) | 全新宿主零预置:开面板→添加自选→输入 600519→候选(贵州茅台沪 · CNY)→确认添加→行情行 1392.05 自动采集,全程 UI 点击无 curl 预置;详情 K 线零配置态报"未配置该市场的数据来源"(kline 路由未配的预期保守文案);本轮补 UX 缺陷修复:K 线 RATE_LIMIT/NETWORK/TIMEOUT 退避自动重试一次(曾无限重试致测试挂起,已修+回归);NO_ROUTE 错误条内嵌引导按钮 |
|
|
114
|
+
| 真机自选准入 | 港股 XHKG:00700 经 search→候选徽标→确认添加成功(watchlist securityId 曾硬编码沪深,已改 parseSecurityId 单源) |
|
|
115
|
+
| kline HTTP 合同 | GET query `limit=250` 字符串形态曾 400(z.number 拒)→ z.coerce 修复;响应双层 data 包裹已修;路由上限 8→40 |
|
|
116
|
+
| 截图留档 | `.work/e2e-day-kline.png`(沪深日K)、`.work/e2e-trend.png`(分时)、`.work/e2e-hk-week.png`(港股周K)、`.work/e2e-us-month.png`(美股月K)、`.work/e2e-hkus-list-clean.png`(港美混排);`.work/` 不入版本库 |
|
|
117
|
+
|
|
118
|
+
端到端期间修复提交:`6041e7d`(响应包裹+capability 并集+路由上限)、`5dd0a2c`(limit coerce)、`44d7ffa`+`f1d3975`(remote 搜索市场面)、`a622a3d`(自选八市场准入)。浏览器会话 tab 关闭、多轮隔离宿主 taskkill /T 级联清理、无残余监听端口;vendor lightweight-charts 197922 字节经 `/plugins-vendor/dsh-stock-assistant` 200 命中。
|
|
119
|
+
|
|
120
|
+
## 2026-11-01 三角色评审收敛轮
|
|
121
|
+
|
|
122
|
+
三份独立只读评审(产品/QA/架构,子代理)结论均为**有保留通过**;保留项与建议逐条消化:
|
|
123
|
+
|
|
124
|
+
| 评审 | 保留项/风险 | 处置 |
|
|
125
|
+
| --- | --- | --- |
|
|
126
|
+
| 产品 | 阻断:宽屏详情无返回入口(0.2.0 单列化回归) | `ssb-mobile-back` 常驻显示,宽窄屏详情头部均有"返回自选" |
|
|
127
|
+
| 产品 | 一键K线零反馈/静默 no-op | 成功 → notice 横幅"N 个市场已开启"并返回列表;no-op → notice 说明已全配 |
|
|
128
|
+
| 产品 | NO_ROUTE 引导落点深(跳设置+滚动找按钮) | 错误条内联"一键开启K线"(busy 态防重入,完成后自动重拉当前股K线) |
|
|
129
|
+
| 产品 | 搜索筛选缺日经/韩证/伦敦;NASDAQ 标签不对称 | 八市场全量+对称标签 |
|
|
130
|
+
| 产品 | "个股状态"恒未知死字段;别名 maxLength 60 与提示 30 矛盾 | 死字段移除;maxLength=30 对齐 |
|
|
131
|
+
| 产品 | 设置页术语对免凭据用户过重 | 高级预算项(每日上限/计费单位/分能力额度)details 默认折叠 |
|
|
132
|
+
| QA | remote 市场面并集零断言 | 补:直连批次计数+XHKG 候选入结果+ROUTE_CONFLICT(首拍后推 revision 即拒) |
|
|
133
|
+
| QA | routes 错误码→HTTP 状态零覆盖 | 补:NO_ROUTE 422 code 透传+RATE_LIMIT 429 status/retryAfterMs 透传 |
|
|
134
|
+
| QA | 退避固定 4s 忽略 retryAfterMs;无非瞬时码负向断言 | 退避=max(4s, retryAfterMs);K8 NO_ROUTE 首拍即拒 calls=1 |
|
|
135
|
+
| 架构 | client 币种回退表第二事实源(XLON 'GBp' vs MARKET_META 'GBP' 已漂移) | 回退表删除,币种唯一来源=watchlist 条目 currency |
|
|
136
|
+
| 架构 | usSymbols 双写无归一化属主;oneClickKline 用例在 client 层 | **待办池**(重构面大,当前 131 测试护栏下行为正确;触碰 catalog/美股链路时收口) |
|
|
137
|
+
|
|
138
|
+
测试基线 123→**131**(K4-K8+routes 错误映射+市场面合同两用例);全量两连绿确认(曾现一例 K5 计时 flaky,夹具 retryAfterMs 300ms→20ms 消除)。
|
|
139
|
+
|
|
140
|
+
## 2026-11-07 悬浮盯盘与指标线(代码审查整改轮)
|
|
141
|
+
|
|
142
|
+
三轮子代理对抗审查外加一次收窄的修复验证:第一轮 5 个阻断,第二轮 3 个新阻断(其一为第一轮修复引入),第三轮 2 个阻断;末轮修复后经窄范围复审确认无阻断。
|
|
143
|
+
|
|
144
|
+
| 项 | 现象 | 处置 |
|
|
145
|
+
| --- | --- | --- |
|
|
146
|
+
| 分时成交量单位 | 沪深分时 `volume` 未按手换算,图例比日K/详情小 100 倍 | `trend()` 改走 `sharesFromLots`;`public-providers.test.mjs` 补 `11523 手 → 1152300 股` 断言;宿主重启后实测末条 `2988207 → 298820700` |
|
|
147
|
+
| 切标的残留 | 图模式切标的后新请求返回前仍显示上一只价格 | `trend` 改为 `{securityId, data}` 绑定;实测从智谱切上证,30ms 内读 DOM 为 `—\|—`,2.6s 后为 `3649.18/-1.10%` |
|
|
148
|
+
| 详情入口分裂 | 悬浮窗「打开详情」不清成本草稿(会串写到别的股票),面板不在前台时无反应 | 新增 `runtime.openDetail` 收口(`layout.selectPanel` + 详情加载交给挂载 effect),草稿清理下沉到 `updateView` 的 `detailId` 变更处,五条打开路径共用;实测在插件面板点 ⤢ 正确切回并打开详情 |
|
|
149
|
+
| K 线与图例双源 | 手动刷新后图例/辅助线/指标更新而蜡烛不动;快速切周期旧结果覆盖新结果 | effect 拆成「加载」与「灌图」两条,`maybeFill` 增加 `fit` 参数,`loadKline` 成功与失败分支都校验 `klineKey`,`getKlineResult` 与图例同样按 key 取数;↻ 未做端到端实测 |
|
|
150
|
+
| 空壳灌图 | 切周期当帧 state.kline 是上一轮的空壳,直接灌会把分时的 `09:30` 交给 Candlestick 触发 vendor 抛 Invalid date;空壳又会被误当成"已铺满" | 灌图 effect 先校验 key;空壳只清屏且不推进 `shippedKeyRef`(空数据上 fitContent 是 no-op),`applyIndicators` 收到空数组时清掉指标线 |
|
|
151
|
+
| 别名被清空 | 从浏览市场/搜索打开"已在自选"的标的时 `view.alias` 为空,未改动直接点保存会写回空串,抹掉已存别名 | 别名回填下沉到 `updateView` 的 `detailId` 变更处,五条打开路径不再各自内联;`openDetail` 不预载 K 线(与挂载 effect 重复) |
|
|
152
|
+
| 浮窗配色 | 独立 root 缺 `ssb-green-up`,绿涨红跌用户在浮窗看到反色 | `.ssb-float` 按 `preferences.colorMode` 拼类名;实测切到 green-up 后面板与浮窗同时变为跌红涨绿,切回 red-up 复原 |
|
|
153
|
+
| 全部取消勾选 | `ids` 清空后又回退到自选前五只,"一只都不盯"无法表达 | `ids` 为 `null` 才是"没勾过",空数组表示明确不盯;实测取消全部勾选后显示"盯盘 0 / 未选择标的",不再自动加回 |
|
|
154
|
+
| 图表配色越界 | 均线/布林/BBI 的色在 JS 与 CSS 各写裸 hex,MA60 与布林上下轨饱和度仅两成 | 改为包局部 token `--ssb-chart-*`,饱和度统一七成以上;实测图例色与 token 一致,宿主切配色后蜡烛与均线一并重涂 |
|
|
155
|
+
| 指标无测试 | `seriesMA/EMA/Boll/BBI` 纯函数零覆盖 | 新增 `test/indicators.test.mjs` 8 例:前导 null、滑动和、EMA 的 k 与种子、BOLL 中轨=MA 与上下轨对称、BBI 24 根门槛、空序列与短序列边界;`__testing` 导出四个函数 |
|
|
156
|
+
| 暗色下可辨 | 图表色只有一套固定值,暗底上深色线条溶进背景;亮色侧有四个取值本身对比度不到 2.5(MA5 2.06、MA60 2.32、BOLL 上轨 2.43、BBI 2.43),色差一项旧值本就合格(最小 18.98) | 按宿主 `body[data-ds-dark-theme]` 给出两套值,明暗标记不在 `.ssb-root` 上,重涂 observer 单开一路监听 body;新增 `test/chart-colors.test.mjs` 解析 token 直接算对比度(≥2.5)与两两 CIELAB 色差(≥12),把旧亮色值整段回退后对比度用例变红、色差用例仍绿 |
|
|
157
|
+
| 缺失值当 0 | `Number(null)` 得到真实的 0,区间最高/最低与迷你图被压到地板上,成本盈亏在缺收盘价时算出 −100% | 新增 `finiteOr`(null/空串给 NaN),区间高低、迷你图、成本盈亏四处改用它 |
|
|
158
|
+
| 成交量 0 | `formatAmount` 把 0 与 null 一样显示成破折号,掩盖了「真的没成交」 | 增加 `zeroIsMissing` 开关,成交额仍按缺失呈现,成交量与图例的量传 `false` |
|
|
159
|
+
| 浮窗状态 | 拉取失败仍显示「监听中」,未勾选标的时也照旧 | 三态:未选择 / 更新失败(悬停给原因、warn 配色)/ 监听中 |
|
|
160
|
+
| 并发代际 | 同一标的连点刷新会并发两个同 key 请求,先发后到的响应盖掉新数据 | `loadKline` 增加 `klineSeq`,成功与失败分支都要求代际匹配;补测试并回退验证会变红 |
|
|
161
|
+
| 拖动与触摸 | 右键也会触发拖动;`.ssb-float` 的 `touch-action:none` 让列表与勾选区无法触摸滚动;`dragging` 类名挂在 ref 上不会触发重渲染,从未生效 | 只认左键;列表与勾选区改 `touch-action:pan-y`;删掉失效类名 |
|
|
162
|
+
| 本地偏好无守卫 | 收尾时把 `localStorage` 的断言整条删了,等于放行任意本地写入 | 改为收窄:只允许 `readPref`/`writePref` 两处调用,key 集合固定为 `ssb-floating`/`ssb-guides` |
|
|
163
|
+
| 重涂从未生效 | 建图与重涂回调跑在空依赖 effect 里,闭包中的 `kline` 与 `colorMode` 停在首帧,重涂时读到空数据直接早退;`applyIndicators` 同理 | 新增 `liveRef` 每帧写入 `{ candles, colorMode, indicators }`,回调与 `themeOf` 一律现取;实测切周K→日K 指标线不丢 |
|
|
164
|
+
| 暗色露白块 | 图表背景写死 `transparent`,而 `.ssb-kline-holder` 自身无底色,canvas 留白在暗色下是白色 | 背景改取 `--ssb-bg`;实测给 body 打暗色标记并覆盖 `--dsw-*` 后,图表背景随面板变深,蜡烛/成交量/均线一并重涂 |
|
|
165
|
+
| 休市降频是死代码 | 读 `quotes[id].sessionState`,实际在 `quotes[id].quote` 里,`allClosed` 恒 false;且 `allClosed` 时提前 return 会让低频拍空转 | 改读 `quote.sessionState`,去掉提前 return 只保留降频;实测全部休市时 22 秒内零次 `/refresh`(15 秒间隔时应有 1 次) |
|
|
166
|
+
| 代际失败路径 | 被淘汰的旧请求失败后仍走错误写入,覆盖新请求已落地的数据 | 失败分支先按代际退出;补「后发成功、先发失败」用例,破坏代际可复现变红 |
|
|
167
|
+
| 触摸滚不动列表 | `touch-action` 取触摸路径上的交集,父级 `.ssb-float` 的 `none` 把子元素设的 `pan-y` 一起废掉,列表在触屏上无法滚动 | 容器改 `pan-y`、标题条 `none`,拖动起点收到标题条;实测头部拖动位置与落点都变、列表上拖动位置不变 |
|
|
168
|
+
| 格式化无单测 | `finiteOr` 与 `formatAmount` 决定界面怎么区分「没有数据」与「真的是 0」,零覆盖 | 提到模块级并 `__testing` 导出,新增 `formatters.test.mjs`:缺失值/空串一律 NaN、真实 0 保留、成交额 0 按缺省、成交量显式关开关、万/亿缩写与负数取量级 |
|
|
169
|
+
| 分时曲线不重涂 | 重涂只按蜡烛的键名下发布,而分时面积序列用的是 `lineColor`/`topColor`/`bottomColor`,两组键名互不相通,切主题后只有背景变了 | 抽 `seriesPaintPlan` 按已建形态选键名,测试断言两套键名不重叠 |
|
|
170
|
+
| 悬浮窗把缺失当 0 | 调用方先 `Number(close)`/`Number(preClose)` 再交给已用 `finiteOr` 的迷你图,`null` 变 0:基准画在 0、价格显示「0」 | 调用方改用 `finiteOr`,显示判 `Number.isFinite` |
|
|
171
|
+
| 首帧闭包 | 建图 effect 空依赖,捕获的是首帧那份 `maybeFill`,建图窗口内切的周期/开关/成本全用旧值 | 改用 `fillRef` 转发最新渲染;`setKlineError` 取 `liveRef` 的当前周期 |
|
|
172
|
+
| 休市仍打上游 | 降频只降了频率,`/refresh` 走手动通道,休市时每分钟仍是一次真实请求 | 决策收进 `pollPlan` 纯函数:安静档(收盘+午休)列表九拍只读快照、图形九拍完全不发请求,两者第十拍各做一次真刷新——只读快照回放缓存、不重算交易时段,单靠它永远发现不了开市 |
|
|
173
|
+
| 图形模式白烧额度 | 上一版把「休市停打」只修在列表分支;后来改成收市档拉快照,但 `/snapshot` 走 `collector.entries()` 缓存克隆、不重算 `sessionState`,探针被「已知收市」门控而自锁,第 10 拍仍落 `trend`(该端点不进缓存,每拍都是真上游) | 图形模式整十拍无条件先真刷新,`quiet` 才翻得过来;`stateOf` 按 `receivedAt` 在两份报价间择优,不再无条件偏爱自己那份 |
|
|
174
|
+
| 本地存储守卫形同虚设 | 只数 `localStorage.getItem\|setItem` 两个字符串,`clear()`/`removeItem`/属性访问/`sessionStorage` 都能绕过 | 连属性访问一起数并与白名单逐条比对,另禁 `sessionStorage`/`indexedDB`;六种绕过实测均被识别 |
|
|
175
|
+
|
|
176
|
+
测试基线 204→**256**。分时量单位、切标的残留、详情入口、分时→日K 不崩、浮窗配色、全部取消勾选、图表配色、暗色双套取值、暗色重涂、休市降频、悬浮窗拖动与列表手势、分组切面与整组勾选、浮窗三态、拆分后的悬浮窗、自选列表分组常显与全局排序保留分区、顶部刷新按钮无错误条、周期切换后指标线回归、图形模式收市停打 trend 共十八项有真机验证记录;手动刷新(↻)端到端仍是代码路径确认。配色可辨性另外由 `chart-colors.test.mjs` 以对比度、色差与饱和度量化,不再依赖肉眼。
|
|
177
|
+
|
|
178
|
+
以下为**已确认但当前不可达**的限制,记录以免将来误判为回归:
|
|
179
|
+
|
|
180
|
+
- 分时横轴在缺少行情自带时间戳时,退回「当天 UTC 零点 + 分钟偏移」。对非 UTC 市场会整体偏时区(实测美股偏约 11 小时、A 股偏 1.5 小时)。东财分时恒给时间戳,该路径当前不可达;一旦上游改口径会立刻显现,届时需按市场时区取当天零点。
|
|
181
|
+
- 四秒退避的代际检查没有自动化用例:需要真实计时,靠代码路径确认。
|
|
182
|
+
- 悬浮窗的轮询状态机没有端到端用例:`pollPlan` 各分支已由纯函数用例锁定,但从「面板报价冻结」到「状态翻回」的整链只在真机上确认过。
|
|
183
|
+
- 开市发现延迟:安静档最快一分钟一拍,第十拍才真刷新,所以收盘后开市最多要等十拍(默认间隔下约十分钟)才恢复实时。
|
|
184
|
+
|
|
185
|
+
## 宿主升级回归项(本包相关)
|
|
186
|
+
|
|
187
|
+
- **插件 client bundle 缓存失效缺陷(DASH 本体)**:`/plugins/??...&rev=` 聚合 bundle 的 rev 不包含第三方插件 client 内容(多次宿主重启 rev 恒为 a8db260a2844),插件升级后浏览器按 URL 命中磁盘缓存继续执行旧 client;服务端 bundle 内容已更新(fetch no-store 可取到新代码)。用户侧需强刷或等 rev 变化;宿主修复 rev 内容寻址后,本包 client 级 UX 修复(内联一键开启、RATE_LIMIT 自动重试)需在真机回归一遍运行时表现(测试已覆盖逻辑,运行时验证被该缺陷阻断)。
|
|
188
|
+
|
|
189
|
+
## 兼容性维度适用表
|
|
190
|
+
|
|
191
|
+
标记:M 手工必测 / A 自动化覆盖 / C 条件必测 / N 不适用。维度定义与判定口径见 [兼容性检查总纲](../../docs/兼容性测试/兼容性检查总纲.md)。
|
|
192
|
+
|
|
193
|
+
| 维度 | 标记 | 本包落点(检查点/证据) |
|
|
194
|
+
|---|---|---|
|
|
195
|
+
| D01 宿主代际与 API 契约 | M | 不使用 DSH 默认 settings(无 `Config`),经 `storageDomain` 自有域;`slots/locale/layout` client 注入;`storageDomain.open` 缺失时干净禁用;宿主 client bundle rev 缺陷见「宿主升级回归项」 |
|
|
196
|
+
| D02 运行平台与架构 | C | 无平台分支;触发条件 = 跨平台路径/编码/时区。落点:自有数据目录、K 线缓存文件、Windows 大小写;macOS 未验证(登记) |
|
|
197
|
+
| D03 Web 客户端形态 | M | 左侧「股票」独立主页面、K 线(lightweight-charts)、悬浮盯盘、分组/搜索/排序、窄屏与缩放、亮暗主题、图表色对比 |
|
|
198
|
+
| D04 宿主部署与配置形态 | M | 八个市场的外部行情源可达性、代理/TLS/限流、Tushare token(`DSH_STOCK_TUSHARE_TOKEN`)、vendor 静态资源路由;离线时降级到可用源或提示 |
|
|
199
|
+
| D05 插件互操作与组合 | M | `common-tools` 总线/toast;vendor 路由不与宿主/他包前缀冲突;其他主页面插件共存;全家桶 |
|
|
200
|
+
| D06 生命周期 | M | 采集暂停/恢复、页面切换/关闭会话保持状态、重启恢复自选与设置草稿、K 线缓存重建、HMR 后定时器不叠加 |
|
|
201
|
+
| D07 多实例与并发 | M | 多市场并发采集、预算/限流、多窗口/多标签共享、悬浮窗与列表同源分区、重复请求合并 |
|
|
202
|
+
| D08 持久化代际与迁移 | M | `stock_assistant` 数据域 version=1/layout=single;旧域 `stock_sidebar` 改名(生产未挂载旧域,无迁移面);域打开失败降级;缓存文件格式 |
|
|
203
|
+
| D09 数据规模与异常数据 | M | 空自选/空市场、休市快照、坏行情数据、超大 K 线序列、重复/缺失字段、时区与交易时段 |
|
|
204
|
+
| D10 配置读写与默认值 | M | 自有设置存储(数据源/能力路由/刷新间隔/别名/分组/置顶);默认值、非法值、保存失败回读;无宿主 settings 迁移 |
|
|
205
|
+
| D11 降级与错误路径 | M | 行情源超时/限流/格式变化/停服、无 token、市场不可用;切换备用源或明确错误,不空白不崩 |
|
|
206
|
+
| D12 安全边界与信任 | C | 触发条件 = 路由对外。落点:`/api/stock-assistant/*` 同源、vendor 静态资源路径不越界、不设自有认证层;Tushare token 不落日志 |
|
|
207
|
+
| D13 性能与资源 | M | 悬浮盯盘轮询/刷新间隔、采集预算、K 线缓存上限、图表渲染点数、页面切走暂停;无请求风暴 |
|
|
208
|
+
| D14 呈现与可访问性 | M | 无 locale 词典:语言切换不崩、中文文案可读;亮暗/图表色、窄屏、悬浮窗遮挡、键盘可达;对比度 |
|
|
209
|
+
| D15 观测与判定面 | M | activation live/findings 0/console 0;采集状态与错误可观测;L3 证据含页面截图与网络记录 |
|
|
210
|
+
|
|
211
|
+
## 维度检查点(补充)
|
|
212
|
+
|
|
213
|
+
1. **数据源矩阵**:八个市场各至少一次列表/详情/K 线;单一数据源失败时路由到备用源或给出可读错误,不整页空。
|
|
214
|
+
2. **交易时段**:休市快照冻结、当日/分时口径、时区与跨日;不得把休市当故障。
|
|
215
|
+
3. **预算与限流**:高频刷新触发限流时退避;多市场并发不超预算;页面切走/悬浮隐藏时降低采集。
|
|
216
|
+
4. **持久化代际**:`stock_assistant` v1 读写;旧域不存在时新建;域打开失败降级后操作按调用失败而非崩溃。
|
|
217
|
+
5. **token 边界**:无 Tushare token 时该源不可用且提示;token 不出现在日志/错误文本/前端可读位置。
|
|
218
|
+
6. **图表规模**:长 K 线/多指标开关不卡死主线程;缩放/拖拽/悬浮读数正确。
|
|
219
|
+
|
|
220
|
+
## 判据补充
|
|
221
|
+
|
|
222
|
+
上表 D01/D03/D04/D08/D11/D13 的检查点全部通过才可宣称本窗口兼容;外部行情源不可达时,D04/D11 记 E 并写明已排除项,不得以静态数据代替真实链路。
|
|
223
|
+
|
|
224
|
+
## 本包验证点(最小判定)
|
|
225
|
+
|
|
226
|
+
| 维度 | 验证点(操作→预期) | 证据 | 级别 |
|
|
227
|
+
|---|---|---|---|
|
|
228
|
+
| D01 | 隔离宿主启动 → 左侧「股票」入口出现、点开后 main 页(空态/工具页)渲染、`snapshot` 200、恰一份归属完整包名的 style;`storageDomain.open` 缺失 → 干净禁用不崩 | 页面截图、HTTP 状态码、`data-plugin` style 计数、console | B |
|
|
229
|
+
| D02 | 触发 = 跨平台路径/编码/时区。Windows 上以自有数据目录与 K 线缓存文件启动并切换时区 → 路径与缓存可读写、大小写不误判、时区展示正确;macOS 未验证登记 | 目录列表、K 线截图、boot.log | C |
|
|
230
|
+
| D03 | 添加自选后看行情行 → 价格/涨跌/来源/未知延迟呈现;打开详情 K 线 → 蜡烛+MA 三线+量副图+昨收虚线;1280px 双栏、768/360px 单栏,document 与工具 root 均无横向溢出 | 截图、`scrollWidth`/`clientWidth` 回读、K 线截图 | B |
|
|
231
|
+
| D04 | 默认六路由开箱 → 检查(search/quotes ready)→ 保存成功;`/api/bus/ws` 订阅股票空间 → ready → 写偏好 → 收到 invalidate(带 serverEpoch/snapshotSeq);`/plugins-vendor/dsh-stock-assistant` 200 | WS 消息字段、provider-check 结果、HTTP 状态码、网络记录 | B |
|
|
232
|
+
| D05 | 同装 `common-tools` 与全家桶 → 总线/toast 通道可用、vendor 路由不与宿主或他包前缀冲突、主页面与其他主页面插件共存,页面无 `Failed to load plugins` | toast 截图、vendor 请求状态码、页面横幅检查 | B |
|
|
233
|
+
| D06 | 停用/启用面板与插件、HMR 一次 → 入口与采集/轮询随启停,无重复定时器;重启后自选与设置恢复 | 入口截图、定时器计数、回读值 | B |
|
|
234
|
+
| D07 | 两个标签同开面板并同时触发采集/改偏好 → 多窗口共享、重复请求合并、预算/限流生效、悬浮窗与列表同源分区,不互相覆盖 | 双窗截图、snapshot 序列、请求计数 | B |
|
|
235
|
+
| D08 | 重启后重开面板 → 自选与设置从 `stock_assistant` 域回读(version=1/layout=single),偏好与别名一致;域表仅 control/cache,未写宿主默认 settings | 域快照回读值、重开前后 UI 值、settings 未写入核对 | B |
|
|
236
|
+
| D09 | 停牌源返回 `"-"` → 不伪造价格而显示缺省;某证券缺行/坏行 → 记 NO_DATA 且不瘫痪同批其他证券;重复身份/冲突 → BAD_PAYLOAD;空目录合法,仅无有效缓存记录才 CATALOG_NOT_READY | 行内显示回读、错误码、console | B |
|
|
237
|
+
| D10 | 设置页「检查→保存」流 → 空 checkIds 直提交被 `CHECK_REQUIRED` 拒绝,检查通过后保存成功且回读一致;改默认数据源/刷新间隔/别名后回读同值;检查失败的能力不可启用 | HTTP 错误码、配置回读值、UI 提示截图 | B |
|
|
238
|
+
| D11 | 无 `DSH_STOCK_TUSHARE_TOKEN` → provider-check 返 AUTH denied(40101→AUTH 映射)、保存守卫拒启用;`NO_ROUTE`/`CATALOG_NOT_READY` → 错误条内嵌引导按钮;`RATE_LIMIT` → 退避 max(4s, retryAfterMs) 后自动重试一次不无限重试 | HTTP 状态码/错误码、notice 与错误条截图、请求计数 | B |
|
|
239
|
+
| D12 | 触发条件 = `/api/stock-assistant/*` 路由对外可达。跨源访问该路由 → 同源比对拒绝(无自设认证层);`/plugins-vendor/` 路径不越界;日志与错误文本不出现 Tushare token | HTTP 状态码、越界探测响应、日志检索结果 | C |
|
|
240
|
+
| D13 | 全部休市 → 15 秒刷新间隔下 22 秒窗口内 `/refresh` 计数为 0(走只读快照);长空闲基线 snapshot 计数不增长;面板隐藏/切走后采集暂停 | 请求计数、snapshot 计数、日志 | B |
|
|
241
|
+
| D14 | 亮色/暗色各视口截图 → 图表色取自宿主语义 token,暗色下图表背景随面板变深、蜡烛/成交量/均线一并重涂;窄屏隐藏来源辅助列,详情宽窄屏均有「返回自选」;对比度 ≥2.5、两两色差 ≥12 | 截图、`--ssb-chart-*` token 回读、`chart-colors.test.mjs` 输出 | B |
|
|
242
|
+
| D15 | boot → activation live、findings 0、console 0;浮窗三态(未选择/更新失败/监听中)可观测;L3 证据含页面截图与网络记录 | activation/findings、console、截图与网络记录路径 | B |
|