Market Monitoring
一个用于 VS Code 的市场行情监控扩展，支持自定义标的、分组、排序、预警和状态栏摘要。
交流与反馈
- QQ 群：
1065570056
- 点击链接加入群聊【Market Monitoring 交流群】：https://qm.qq.com/q/JqzQhIrNio
功能
- 自定义分组，默认包含“自选”，用户在具体分组底部搜索并添加标的。
- 新增标的支持按名称、简称、拼音、拼音首字母或代码搜索后选择。
- 同一标的可添加到多个分组；仅同一分组内会跳过重复标的。
- 分组支持折叠和展开。
- 在行情面板中添加标的，并通过分组标题的编辑按钮修改分组名称、删除分组及组内标的、上移、下移或删除标的。
- 支持中文、英文界面切换，也可跟随 VS Code 显示语言。
- 涨跌颜色模式可配置，默认无颜色。
- 支持按涨跌幅阈值给标的行添加低调的左侧色带标识。
- 自定义价格小数位。
- 标的表格列可配置，支持名称、别名、代码、价格、涨跌幅、涨跌额、成本、持仓、市值、仓位、净收益额。
- 表格列默认均分，最小宽度为 20px，支持拖动列名右侧边缘调整列宽。
- 成本和持仓可在表格中输入并修改，净收益额自动计算。
- 分组末尾展示当前总资产，并在填写成本和持仓后汇总今日收益。
- 支持从 CSV 导入标的，自动创建缺失分组，并跳过无效或同一分组内已存在的标的。
- 支持导出 CSV，包含所有标的列和分组末尾汇总数据。
- 表格支持点击列名排序，升序、降序、恢复默认三态切换。
- 分组统计上涨、下跌、平盘数量。
- 支持按配置顺序、涨跌幅、价格、名称、别名、代码排序。
- 支持价格和涨跌幅预警。
- 底部右下角展示可配置指数（由
marketMonitoring.indexSymbol 指定）的实时行情，悬停可查看全市场涨跌平家数。
- Activity Bar 独立行情视图。
- 支持手动刷新、启动、暂停。
配置示例
在 VS Code settings.json 中配置：
{
"marketMonitoring.symbols": [
{
"code": "sz300308",
"name": "中际旭创",
"group": "观察"
},
{
"code": "sh603986",
"name": "兆易创新",
"group": "自选"
},
{
"code": "AAPL",
"name": "Apple",
"group": "美股"
},
{
"code": "005930.KS",
"name": "Samsung Electronics",
"group": "韩股"
}
],
"marketMonitoring.groups": [
"自选",
"观察",
"美股",
"韩股"
],
"marketMonitoring.sortBy": "changePercent",
"marketMonitoring.sortDirection": "desc",
"marketMonitoring.quoteColumns": [
"name",
"price",
"changePercent"
],
"marketMonitoring.groupSummaryMetrics": [],
"marketMonitoring.priceDecimalPlaces": {
"threshold": 10,
"belowThreshold": 3,
"fromThreshold": 2
},
"marketMonitoring.compactLargeAmounts": false,
"marketMonitoring.enableGroupSummaryDrawdownAlert": false,
"marketMonitoring.groupSummaryDrawdownThresholdPercent": 20,
"marketMonitoring.showMarketBreadth": true,
"marketMonitoring.marketBreadthRefreshIntervalSeconds": 300,
"marketMonitoring.language": "auto",
"marketMonitoring.colorMode": "none",
"marketMonitoring.rowHighlightUpPercent": 5,
"marketMonitoring.rowHighlightDownPercent": 5,
"marketMonitoring.defaultMonitoringIndicators": [
"movingAverageBelow",
"movingAverageS",
"intradayHighPullback"
],
"marketMonitoring.refreshIntervalSeconds": 5,
"marketMonitoring.onlyDuringTradingTime": true
}
当前数据源支持的常见代码格式包括：
sh600519sz000001600519510300159915600519.SHAAPLUS:AAPLNASDAQ:MSFTBRK.B.US005930.KS035720.KQks005930kq035720
无交易所前缀时，6 位数字会按 A 股规则自动推断，纯字母/美股 ticker 会按美股规则自动推断；韩国标的需要使用 .KS、.KQ、ks 或 kq 标明市场。
美股和韩股搜索使用 Yahoo Finance 数据源，通常支持英文名称和代码搜索，但不保证支持中文名称搜索。例如搜索 SK hynix、000660.KS 或 ks000660 可以添加海力士，直接搜索 海力士 可能无法返回结果。
预警配置
marketMonitoring.alerts 支持价格和涨跌幅阈值。一个规则可以同时配置多个阈值：
{
"marketMonitoring.alerts": [
{
"code": "sz300308",
"name": "中际旭创",
"changePercentAbove": 1.2,
"changePercentBelow": -1.0
},
{
"code": "sh603986",
"name": "兆易创新",
"priceAbove": 180,
"priceBelow": 160
},
{
"code": "sh600519",
"name": "MA example",
"movingAverageDays": [5, 10, 20, 60, 120],
"movingAverageSDays": 20,
"movingAverageSOffsetPercent": 4,
"movingAverageHoldBelow": true,
"movingAverageHoldBelowDays": [5, 10, 20, 60, 120]
},
{
"code": "sh601318",
"name": "MA support example",
"movingAverageBelow": false,
"movingAverageAbove": true,
"movingAverageAboveDays": [5, 10, 20, 60, 120],
"movingAverageHoldAbove": true,
"movingAverageHoldAboveDays": [5, 10, 20, 60, 120]
},
{
"code": "sh600519",
"name": "EXPMA example",
"movingAverageBelow": false,
"movingAverageS": false,
"expmaDeviation": true,
"expmaDays": 13,
"expmaDeviationAbovePercent": 4,
"expmaDeviationBelowPercent": 4
},
{
"code": "sz000001",
"name": "trend risk example",
"bearishMovingAverage": true,
"macdDeathCross": true,
"macdBelowZeroOnly": true,
"volumeDrop": true,
"volumeDropPercent": 2,
"volumeDropMultiplier": 1.5,
"reboundLowVolume": true,
"reboundLowVolumeRatio": 0.8,
"lowBreakDays": 20,
"rsiWeak": true,
"rsiBelow": 50,
"bollingerBelow": "middle",
"intradayHighPullback": true,
"intradayHighPullbackPercent": 2,
"intradayDowntrendConfirmTicks": 3,
"intradayDowntrendSlopePoints": 5,
"intradayVwapBelow": true
}
],
"marketMonitoring.enableAlerts": true,
"marketMonitoring.enableAlertNotifications": false
}
当开启 marketMonitoring.enableAlerts 时，holding > 0 的标的应用由 marketMonitoring.defaultMonitoringIndicators 配置的默认监控指标。默认值为 ["movingAverageBelow", "movingAverageS", "intradayHighPullback", "expmaDeviation"]；使用空数组可禁用自动默认指标。没有有效持仓的标的不会展示这些默认监控指标，默认也不会被加入 SQLite 监控标的池。marketMonitoring.alerts 中的显式规则即使标的没有持仓也仍然会执行。
movingAverageBelow 会添加默认的 movingAverageBelow: true 预警，窗口为 movingAverageDays: [5, 10, 20, 60, 120]；movingAverageS 会添加默认的 movingAverageS: true 预警，窗口为 movingAverageSDays: 20、阈值为 movingAverageSOffsetPercent: 4。movingAverageBelow 现在表示盘中"跌破 N 日线"下穿预警：上一日收盘价大于等于上一日 N 日均线，且最新价小于当前 N 日均线。可对该标的添加显式规则 movingAverageBelow: false 或 movingAverageS: false 来关闭对应的均线预警。
movingAverageS 在最新价小于等于 MA(N) * (1 - X / 100) 时触发"S预警"。用 movingAverageSDays 配置 N，用 movingAverageSOffsetPercent 配置 X。
expmaDeviation 在最新价高于 EXPMA(expmaDays) 至少 expmaDeviationAbovePercent，或低于它至少 expmaDeviationBelowPercent 时触发 EXPMA 偏离预警。默认 EXPMA 窗口为 13，两个默认阈值均为 4，行情行标记显示 E13 以及上/下方向箭头。
设置 movingAverageHoldBelow: true 可开启收盘确认的"失守 N 日线"预警，在收盘后按相同的下穿条件判断。该下跌确认预警默认关闭，可用 movingAverageHoldBelowDays 选择其窗口。
设置 movingAverageAbove: true 可在上一日收盘价低于上一日 N 日均线、且最新价大于等于当前 N 日均线时触发盘中"站上 N 日线"预警。设置 movingAverageHoldAbove: true 可在收盘后按相同的上穿条件触发收盘确认的"站稳 N 日线"预警。这些均线向上预警默认关闭，可用 movingAverageAboveDays 或 movingAverageHoldAboveDays 选择其窗口。若某个标的同时开启了均线向下与向上预警，面板会分别显示绿色向下与红色向上标记。
intradayHighPullback 会在标的当日最高价高于开盘价、当前涨跌幅转为负值，且从当日最高点回落幅度超过 intradayHighPullbackPercent 时触发。盘中会结合实时分时 VWAP（可用时）、最近刷新价格斜率和 intradayDowntrendConfirmTicks 连续确认来判断分时下跌趋势；收盘后会按当日日 K 收盘价继续展示预警。
预警触发后会：
- 默认不在 VS Code 右下角弹出通知；如需弹窗，将
marketMonitoring.enableAlertNotifications 设为 true。
- 在行情面板中给对应标的加预警标记。
- 在面板标题栏的小铃铛按钮上展示预警状态：无预警时为灰色铃铛，有预警时切换为带红点的铃铛；点击可查看预警详情。
开启通知后，同一个标的每天最多弹出一次右下角通知；行情面板预警标记和小铃铛预警状态仍会实时更新。
状态栏还提供一个可独立开关的展示项，默认关闭：将 marketMonitoring.showStatusBar 设为 true 可在状态栏显示前几个标的涨跌的紧凑摘要。
排序配置
行情面板里的上移、下移会调整 marketMonitoring.symbols 的配置顺序。每个分组底部提供添加标的和修改按钮；上移、下移、删除按钮默认隐藏，点击分组底部的修改按钮后显示。默认按持仓标的的市值排序，只有能根据实时价格和持仓数量计算出市值的标的参与市值排序，其余标的保持配置顺序并跟在后面。
当 marketMonitoring.sortBy 使用 marketValue、changePercent、price、name、alias 或 code 时，行情面板会按对应字段自动排序；上移、下移仍然只调整配置顺序。只有 sortBy 设为 configured 时，面板才严格按手动配置顺序展示。该说明保留在 README 和 CHANGELOG 中，插件界面不再展示额外提示文字。若希望面板严格按手动顺序展示，请使用：
{
"marketMonitoring.sortBy": "configured"
}
marketMonitoring.sortBy 可选值：
configured：保持 marketMonitoring.symbols 中的配置顺序。marketValue：按市值排序，仅对有持仓且能计算市值的标的生效，其余标的保持配置顺序。changePercent：按涨跌幅排序。price：按最新价排序。name：按展示名称排序。alias：按拼音别名排序。code：按代码排序。
marketMonitoring.sortDirection 可选 desc 或 asc。
表格列名也支持点击排序：第一次点击升序，第二次点击降序，第三次恢复默认顺序。当前排序方向会显示在列名旁边。
价格小数位
marketMonitoring.priceDecimalPlaces 控制标的和指数价格的小数位数。默认按金额分档：绝对值低于 10 时显示 3 位小数，大于等于 10 时显示 2 位小数。
{
"marketMonitoring.priceDecimalPlaces": {
"threshold": 10,
"belowThreshold": 3,
"fromThreshold": 2
}
}
threshold 可自定义分档金额；belowThreshold 和 fromThreshold 支持 0-6。旧版数字配置仍可使用，例如 2 表示所有价格都按 2 位小数显示。
marketMonitoring.compactLargeAmounts 控制超过 10000 的金额是否以 W 为单位展示，默认 false，即展示完整数值。开启后会影响分组汇总和导出 CSV 中的汇总金额。
marketMonitoring.enableGroupSummaryDrawdownAlert 控制是否在分组总资产从当前运行期间最高点下跌超过阈值时显示回撤标记，默认 false。开启后，marketMonitoring.groupSummaryDrawdownThresholdPercent 控制下跌阈值，默认 20，即超过 20% 时在总资产右侧显示向下箭头和最高点下跌比例。
语言切换
marketMonitoring.language 控制行情面板显示语言，默认 auto，会跟随 VS Code 显示语言。可选值为 auto、zh-CN、en-US。请在 VS Code Settings 或 settings.json 中修改。
涨跌颜色
marketMonitoring.colorMode 控制涨跌指标颜色，默认 none。
可选值：
none：无颜色，涨跌指标使用普通文字颜色。redUpGreenDown：上涨红、下跌绿。greenUpRedDown：上涨绿、下跌红。
行阈值标识
marketMonitoring.rowHighlightUpPercent 和 marketMonitoring.rowHighlightDownPercent 控制标的行左侧色带阈值，默认均为 5。下跌阈值使用正数，例如 5 表示涨跌幅 <= -5% 时标识；设置为 0 可关闭对应方向的行标识。
表格列配置
marketMonitoring.quoteColumns 控制标的表格展示哪些列，默认：
{
"marketMonitoring.quoteColumns": [
"name",
"price",
"changePercent"
]
}
请在 VS Code Settings 或 settings.json 中修改该配置。数组顺序即表格列展示顺序。也可以运行 Market Monitoring: Configure Quote Columns，用上移、下移、隐藏和添加操作调整同一个配置项。
例如下面配置会按“名称、代码、价格、涨跌幅、持仓、市值、净收益额”的顺序展示：
{
"marketMonitoring.quoteColumns": [
"name",
"code",
"price",
"changePercent",
"holding",
"marketValue",
"netProfit"
]
}
可选列：
name：名称。alias：别名，按名称自动转换为拼音，拼音之间用 ' 分隔。code：代码。price：价格。changePercent：涨跌幅。change：涨跌额。cost：成本，可在表格中编辑。holding：持仓，可在表格中编辑。marketValue：市值，按 当前价 * 持仓 自动计算，仅在填写持仓且有有效价格时展示。position：仓位，按当前标的市值占所在分组可计算总市值的比例自动计算，仅在填写持仓且有有效价格时展示。netProfit：净收益额，按 (当前价 - 成本) * 持仓 自动计算。
指数显示
行情面板底部右下角展示一个指数的实时行情，由 marketMonitoring.indexSymbol 配置项指定（可选 sh000985 中证全指、sh000001 上证指数、sz399001 深证成指、sz399006 创业板指、sh000688 科创50、bj899050 北证50，默认 sh000001 上证指数）。悬停指数报价可查看全市场上涨、下跌、平盘家数。指数行情由扩展自动拉取，不需要添加到 marketMonitoring.symbols。
刷新时段
默认仅在内置活跃交易时段刷新。非交易时段会在缺少本地行情快照时拉取一次最新行情，并会在 15:00 后补拉一次收盘行情，用于显示收盘后的价格和预警；之后不会按高频间隔持续刷新。节假日不会自动识别。如果需要全天刷新，可将 marketMonitoring.onlyDuringTradingTime 设为 false。
行情数据优先来自新浪财经公开行情接口，失败后会自动切换到腾讯行情接口。扩展会在本机 VS Code 进程中直接请求接口。默认请求超时为 10 秒，可通过 marketMonitoring.requestTimeoutMs 调整。
开发
npm install
npm run check
然后在 VS Code 中按 F5 启动扩展开发宿主。
调试配置默认带有 --disable-extensions，这样 Extension Development Host 只加载当前开发中的扩展，避免其他本机扩展的日志干扰排查。
打包
npm install
npm run package
