161 篇文章 含有標籤「微信公眾號」

发布于 2026-05-21 22:13:51（微信公众号导出记录）。

本文来自公众号后台的“导出文章内容”功能。博客正文由导出长图进行本地 OCR 转写，并保留原始排版图用于逐段核对。

原文链接：查看原文

OCR 转写有效文字约 15508 字；代码、流程图和版式以文末原始排版图为准。

正文（本地 OCR 转写）​

original wex7ce EI V1ajero 2026年5月21日 22:14 日本 最近在持绩选代一個專系:MarketBridge。 https://github. com/okloorcl/MarketBridge README MarketBridge n , sentment data. Marketrdge nmalles pubilc data, caches reh state, mars stale records and expses ne stable AP sufcer dwnstremreearch system5. Curent vwersion: ve.4.3 中文文档 Jcwres NCT 它的定位很克制: MarketBridge是一個面向量化研究的資料服務,目標是把多個公開市场資料源整理成相 對统一的REST/WebSocket/本地資料湖介面。它只做資料,不做下單。 遗的“只做資料,很重要。 MarketBridge不是交易機器人,不是自勐交易框架,也不是策略平台。它不托管資金,不飘 行打單,不需要交易權限,也不承諾任何收益。 它更接近量化研究系统前面的一基碳設施:负賣接入公醒資料、棵化资料、继携最新快照、 提供即時或掌即時资料流、按塞存歷史资料,亚露資料源状患、基监控、品質資訊和AI /Agent 友好的上下文介面。 這篇文童想把它目前能做什座、怎磨用、不能做什座、還存在哪些遗界,债量客地鼓清楚。

一、為什磨先做资料唇​

做量化研究时,大家很容易先时涂策略、模型、回测和行。 但真正開始勤手後,資料唇往往是第一批瓶颈。 不同交易所和資料源之同存在很多差异:

• symbol 命名不一致

• 现貨、永續、期貨、期權的資料结橘不一致

• 訂單薄、成交、資金率、持逾量、强平等榴位告不相同

• WebSocket 和 REST 的剧新方式不同

• 有些来源不需要APIkey,有些来源需要

• 有些資料是即時推送,有些資料只能定時输詢

• 歷史资料有善通 OHLCV,也有 mark、index、premiumIndex、funding_rate 等特殊

candle

• 資料可能延速、退期、缺失、重视或出现位异常

• 下游研究系统需要回放和復算,但即時快取重後就富丢失

如果每一因研究本都自己虑理這些周随,专案很快會费成一堆耀继着的adapter。 因此,先做一個强立的资料層,把這些重工程集中虚理。後面的研究系统只需要面到相對统一 的介面,而不是直接面到频十個外部API。

二、MarketBridge目前是什磨​

MarketBridge 目前是一個 Rust 實现的市场資料服務。 它主要做展件事:

1.设定樓中用不同公開資料源​

?.執行各類 connector 探集资料

3.将資料送入内部 router 和event bus​

1.维薄显新 snapshot​

5.透過REST API 回傅目前快照​

3.透過WebSocket 推送即時或掌即時资料​

7.透過 SQLite 保存工作想kline 和本地翼料湖manifest​

3.透退Parquet 按震存歷史 candle分區​

3. 暴霉 catalog、health Prometheus metrics​

3.露 universe、research features、agent context 等研究友好介面​

目前版本的重黏是研究資料接入:「统一查詢介面:按需歷史資料保存和"AI/Agent 可消费的資料上下文:,不是交易執行。 它比较適合作為:

• 量化研究的资料输入唇

• 因子挖掘的資料上下文服務

• 多資料源监控與除销工具

• 内部研究平台的資料底座

• 史candle和資料品置棱查的量本地資料湖

• 後因子验證、AI分析流程、Agent工作流的前置服務

三、目前覆盖的資料型别​

下面這张表接照目前專案程式碼能力整理。需要注意:不同資料源的公開能力不同,某些帽位只 有在交易所或第三方服精實際提供時才會有資料。 保存方式 资料型别 目前能力 典型用途 價格基率、 现货quo 统一b1d、ask、mid 類行情快照 記惊快照 跨交易所比 te 较 衍生品状 永quo perp bid/ask,部分束源包含 mar 慧、期現廊 記惊险快照 k、funding 等位 te 侨 深度、流動 L2 訂量 保存最新bids/asks 快照 性、蟹口圣 记德快照 薄 力 主勤買页方 最新快照+滚動 保存最新trade 事件,亚疆勐order 向、成交强 公用成交 flow 記慎视窗 度 悍成本、 保存公资会费率快照 記憶情快照 Funding 摄度靓察 uI uado 保存公限持意量快照 记憶体快照 收缩翻察 terest Liquida 去悍和凰 記像快照 保存公限强平事件 t1ons 隆状想翻察 回测、因子 SQLite 工作康, SQLite 储存 OHLCV; 支援 REST ba 针算、Un1v KL1nes 可按需窝Parque ckfilL 和即時聚合 erse 髓通 衍生品雁史 按需REST Binance / OKX 支援 mark、inde 研究、资金 特殊歷史 取,可窝 Parque x、 funding_rate: Binance 支握 p candles 資率regim remiumIndex t e 基玲quote cache 甘算 spot-perp 期現结横研 Bas1s basis 究 buy/sell qty、 notional, delta、 0rder F 短通期資金 滚助配愤错聚合 VTUe1 滚勤记憶程聚合 Low CVD、 大单徽、 aggressive ratio 流察 price-bin volume profile, bid/ ask amount, per-price delta、1 微结概研 Footpr1 滚勤配憶帽聚合 滚动配愉體聚合 mbalance, stacked imbalance, m nt 究 1n/max delta volume、 percent change, volati 即时計算+kl1n Univers lity、 spread、 cross-market、 mar e / quote / e 市場池赣通 市场池脑通 e Engin ket cap、age, listing、 delist-r xternal signa isk rolling returns, volume, reali Researc 因子前處 zed vol、z-score, correlation, h Featu 理、研究特 即時計算 basis/funding/0I/liquidity reg 微包 res 1me Derib1t / 0KX/ Byb1t / B1nanc 波动率和期 快取 Options 限结碘研究 e期键快照 CLOB book、midpoint、 spread、pr 预测市場和 快取+ REST wr Polymar 事件研究 ket ice history 等介面 Jadde DeF1 qu ote / p 硬上流封性 Jupiter、 Raydium, Uniswap、 Para 記偿快照 Swap、11nch,DexScreener 等 参考 0ol pr1 ce TradF1 宏regim referen DXY、VIX、US10Y 等 记憶快照 e filter ce 聚合行借 CoinGecko, CoinCap. CoinMarket 外部参考资 quote / exter /衍生指 Cap、 CoinGlass, Custon API nal signal Fear & Greed, CryptoPanic, San external sign 情绪資料 情鳍退滤器 t1ment, LunarCrush al 大颜韩帐和 Whale Alert、mempool.space、Et 键上资料 狮立 store 包监控 herscan watched addresses AI / Agen Agent C 量目前快照、保存manifest、可用 即時聚合 t工作流 ontext 能力和推离下一步呼叫 遗张表不是说每個交易所、每個市場、每图位都端是完整可用。更链地规,MarketBridge 提供统一的资料接入框架和介面表面;實魔可用資料取决龄段定、APIkey、公阙可達性、第三 方服释状態,以及封惠资料源是否公開提供旅榈位,

四、它和CCXT、Hummingbot、Freqtrade 的差翼​

MarketBridge 和 CCXT、Hummingbot、Freqtrade 不是同一原工具。 CCXT更像通用交易所APISDK.它通合在程式直接呼叫交易所介面。使用CCXT時,鹰 用仍然需要自已虚理資料快取、即時流、一schema、服務化介面、健康检查、监控和歷史资 料落盟, Hummingbot更偏交易機器人和策略行框架,重點是速接交易所亚敦行做市、套利等蛋略。 Freqtrade更偏完盈策略研究和交易概器人框架,包含pairlist、回测、策略介面、部分 orderfLow/FreqAI特微工程能力。它對研究很有参考借值,但它的目福不是做立的资 料服释。 如是用更直接的一句話區分: CCXT是SDK,Freqtrade 是策略框架,MarketBridge 是可通行的资料股和本地 研究资料湖。 MarketBridge 的定位更窄,也更明:

• 不模接CCXT

• 不依赖 Hummingbot 執行

• 不做下单

• 不虑理资金

• 不需要交易權限

• 不做策略回测敦行器

• 不做AI模型訓续框架

• 重贴是公阅市場資料的探集、模弹化、快照、流式分發、按需歷史保存和研究特微輸出

它不是為了替代這些專,而是作為一個狮立的资料服務,為後缩研究系统提供更统一的资料入 口

五、目前架構概​

MarketBridge 内部大致可以分成眉。

图核心模组的酸责如下: 模组 磁贵 敏勤管理各個资料源任務,滤理重速和backoff SourceRuntime 把 connector 生的 DataEvent 送入内部 channel SourceContext 把 source 資料分聚 event bus 和 aggregator EventRouter 维展通道和 snapshot store EventBus EventSnapshot 保存显新 quote、funding、OI、trade、order book 等快照 Store OrderFlowStor 基於trade事件维薄order flowbucket和footprint rol Ling buffer e KlineStore SQLite 鳞存 OHLCV,支援 REST backfill 和B即時 tick 聚合 按需寫 Parquet 分區,亚用 SQLite 保存 manifest 和品質元 DataLakeStore 資讯 提供 REST、history、storage、universe,research、agen api/routes/* t、WebSocket 等介面 可選地把事件离入 Redis Strean,亚提供deadletter redis_sink 601e1e3 catalog 暴露资料源、domain、instrument 和 API key 默態 按幂歷史资料湖的离入路径如下:

公XEVajero 這径的期键贴是:不用的資料不存;只有請求翻式带persist=true才會寫入本地瓷料湖。

六、個工程設計節​

下面這些是目前程式碼理已提有封应實现的設計黏。這理偿量用潭確表述,不把它说成已經解决 所有問题。

1.慢WebSocket用户端不會直接阻塞生產者​

MarketBridge使用tokio:brcadcast给不同消意者分登事件。每图WebSocket 速综 都有自己的receiver。 如果某自用户端消费太慢,它营出现Lagged,服務管纪缝warning,亚继绩處理後續讯 息。WebSocket send 也有超時控制,预设 3000ms,可以造巡段定修改。 這意味著慢用户端不题敲直接阻塞資料源探集任猜。但如果系统整锥容量不足,仍然需要根擦實 際吞吐调整行列、部署资漂和订開方式,

2.高频事件做了基硬解耦,但還不是完全零製​

Eventbus中摘展市场事件使用ArcsDataEventa廣播,这可以减少按訂园者装大物件 的情况,尤其是訂单薄道频包含bids/asks的事件。 但目前實現或不是完全零硬聚。router 分验時仍然存在一次DataEventcLone, snapshotstore保存最新诗也clone 别愿物件。 更藏罐的职法是: 目前已經减少了按訂開者福裂,但打单随熟路径仍有進一步侵化空間。

3.Redis寫入失有重試和deadletter​

Redis sink 是可逻功能。 敏用後,MarketBridge批次离入Redis Stream。如果寫人失胶,重试多次亚試重 速。多次失後,批次會官入 JSONL deadletter 案,预经路径是: data/redis_dead_letters . 1sonl 棉系入放在blocking task中執行,避免直接阻塞 tokio worker。 这不是说Redis离入永還不曾丢资料,而是说目前實现不曾在多次寒入失败後静默忽略:它鲁 留下 dead Letter 記,方便後續排查和捕。

4.Freshness/stale已覆蓝一部分標化瓷料​

棵化quote 使用DataEnvelope,其中包含:

• ts_source

• ts rereived

• latency_ns

• stale

期權快取和Polymarket 快取也有stale 标記。 不遇,目前 funding、open interest、trade、liquidation、order book 等 REST 快照仍然主要回傅raw snapshot 结,包含ts_ns,還没有全部统一成带完整Freshne 5s的 envelope, 所以這理的弹殖設法是: quote、options、prediction book 已經有比较明的 freshness / stale 機 制;其他market snapshot 後續荒要统一.

5.APIkey缺失會暴露到catalog​

對需墨 API key 的来源,例如 CoinMarketCap、CoinGlass、FRED、CryptoPanic、 Santinent、LunarCrush、Whale Alert、Etherscan 等,MarketBridge 鲁在 catalog 中標记状感。 如果某個来源已經敏用,但key没有設定,富期示: enabled_missing_api_key 這對谨继和除错很重墨,因為它可以显分“来源故用:和来源敏用了但缺key1。

6.不同domain可以獨立訂​

WebSocket/v1/strean 支援技 domain ,例如:

• market_quote

buipurny· open_interest trade

• liquidation

• order_book

• external_signal

• prediction_book

如果只訂明單一事件domain,程式走对度 domain channel:如果訂多個domain, 盲走混合事件流亚做通淘。 這旗消費者可以只拿自己雨心的资料,而不是接收所有事件後再自己遇湿。

7.歷史资料是按需储存,不预設全量寫盤​

目前宽现中,/vi/history/candles和/vl/market/klines都支援persist=true。 只有额式较定persist=true時,回傅的資料才盲寫人本地 Parquet 資料湖。 這様做的原因是:

• 不需要的资料不占碰镰

• 可以先只储存BTCUSDT、ETHUSDT、SOLUSDT 等重贴標的

• 可以按研究任释储存 mark/ index/premiunIndex/ funding_rate candle

• 可以透透manifest查看娜些资料已经存在

• 可以透透deleteendpoint到除不需要的分區

目前本地Lake结标大致是: data/lake/ /spueugeuop donain=candles/ exchange=binance/ market=perp/ 5yr bol=BTCUSDT/ interval=1n/ /xusad4 a1pue3 candle_type=mark/ day-2026-85-21/ /12-58-9z0z=Aep part-*, parquet SQLite manifest 記疑:

• rowS

• bytes

• file path

• first / last timestamp

• latest watermark

• gap count

• duplicate count

• coverage ratio

• latency p5e / p95

• stale count

8.AgentAPI是资料的,不是交易代理​

目前程式码新增了雨個Agent友好介面:

• GET /vl/agent/cepabilities

它們的目棵是AI/Agent 不需要自已拼很多endpoint,就能捶得:

• 目前quote/ funding/ OI快照

• 可用能力列表

• 推震下一步呼叫

• 可選 storage manifest

• 明的 data-only 界

这個Agentmode不是自動交易模式,不會握有下单權限,也不會输出策路保證。

七、對外介面​

常用REST 介面包括: 介面 就明 Systen GET /health 健康榜查 GET /v1/catalog/sources Catalog 資料源和 APIKey 获 GET /v1/catalog/source-roadin Catalog connector 蛋盖和来源路線圈 ap domain/source 记蜂數和新鲜 Catalog GET /v1/catalog/health 度 GET /v1/catalog/domains Catalog 已支援的資料domain Catalog 目前可見 instrument GET /v1/catalog/instruments quote 快照 GET /v1/market/quotes Market Market GET /v1/market/order -books 訂單薄快照 显新公關成交 Market GET /v1/market/trades GET /v1/market/funding Market funding 快照 Market 0I快照 GET /v1/market/open-interest GET /v1/market/L1qu1dations Market 11quidat1on 快照 SQLite kline:可按需腐 Parq GET /v1/market/kl1nes Market uet Market GET /v1/market/basis stseq duad-ods 0rderflo GET /v1/market/order-flow 單視窗 order flow GET /v1/market/order-flow/w1 0rderflo 多視窗order flow/ CVD ndows W 0rderflo GET /v1/market/footprint footprint profile 特殊原史cande,支援按需Par History GET /v1/history/candles quet Storage 本地Lake manifest GET /v1/storage/manifest DELETE /v1/storage/partit1on Storage 剔除本地lake分區 5 Universe GET /v1/un1verse/top-volume 成交量筛遵 GET /v1/universe/percent-cha 涨跌帽静溢 Un1verse nge Universe GET /v1/universe/volatility GET /v1/universe/spread-filt spread 都選 Universe er GET /v1/universe/cross-marke spot/perp 和跨市场可用性 Universe t GET /v1/universe/market-cap 市值排序 Universe Universe GET /v1/universe/age-filter 上市年岭薛選 GET /v1/universe/new-listing Universe 新上市候道 5 Universe delist risk 觀察 GET /v1/universe/delist-risk GET /v1/research/features 研究特微包 Research GET /v1/research/market-reg1 Research 市堤regime 快照 ou AI / Agent 友好上下文 GET /v1/agent/context Agent GET /v1/agent/capabilities AI/ Agent 可用能力 Agent GET /v1/opt1ons/cha1ns 期捷 Opt1ons Predicti GET /v1/pred1ct1on/books Polynarket book on GET /v1/external/s1gnals 聚合、宏觀、情储等外部信號 External ueq -uo GET /v1/onchain/transfers 大额键上轉幅 Metrics GET /metrics Prometheus metrics 事案狸仍然保留了一些莓版相客介面,例如/snapshot、/funding、/Spread、/optian 5/*、/polymarket/等,方便早期图本耀绩使用;折的研究系统建優先使用/v1/。 即時流介面: WS /v1/strean 示例: npx wscat -c "us://127.o.a.1:8080/vl/stream?donains-market_quote,trade,

八、一個最小使用流程​

原始碼執行: cd MarketBridge MARKETBRIDGE_coNFIG= /config - yanl cargo run

或使用编後的二进位楼: MARKETBRIDGE_coNFIG= /config yanl /market -bridge 检查服務: Curl -s http: //127.0.0.1:808/health 1 1q TERMINAL [base)x7cegTienjuiceMecBook-Pro AACC curl s http/127,e,8.1:88e/health 1 jq ok": true base) uebx7cegTienjuidetlacBookPro AACC a 查看资料源状据: curl -s "http://127.0.e.1:8080/vl/catalog/sources* | 1q

th": src/connectors/cex,

查看行侨: curl -s "http:/127.0.0.1:8080/v1/market/quotes?synbols=BTcusDT* | jq se) vx7cngTierjuideMacBeskro ACC curl s http://127,e,8l1:aeea/vl/arket/quetes?symbols=TUSoT 1 _quote, reshness":( rypto",

d“BTC-USDT-PERP*

查看汀单薄: curl -s "http://127.0. e. 1:8080/v1/market/order-books?symbols=BTcUsDT&na

qtye::.7139.9,

查看funding: curl -s "http://127.0.0.1:8080/v1/market/funding?symbols=BTcUsDT* I 1q

s: 1779379288669, 177937211828 : ssll,

查看order flow: "http://127.0.B.1:8089/v1/market/order-flow7symbol=8TcusDT5wind

查看footprint: curl -s "http://127.B.B.1:Hg8a/v1/market/faatprint7exchange=hinance5nar

按幂拉取亚存 Binance mark price candle: curl -s "http://127.0.0.1:8080/v1/history/candles?exchange=binanceasymb

按拉取亚存 Binance premiumIndex candle:

按幂拉取或铺存OKXfunding_rate 愿史: curl -s "http://127.0.0.1:8080/v1/history/candles?exchange=okx&synbol=B'

查看本地 Lakemanifest: pqu/sgs1pues=utuoe1setueu/afeso1s/ta/0se8:1'a'a zt//:d11u. 5- 1ns

剩除不需要的本地分區: curl -x DELETE *http://127.0.0.1:808e/v1/storage/partitions?donain=cand

查看Agent 上下文: curl -s "http://127.6.B.1:8a89/v1/agent/context7synbols=BTcusDT,ETHUSDT.

这些介面回傅的是研究原材料和瓷料特微,不是交易建罐。

九、它可以如何辅助量化研究​

MarketBridge不判暨買實方向,也不验證策略有效性 它提供的是更容易被研究系统消費的资料。基於运些资料,可以进一步造和验调因子。

1.Basis 因子​

基龄 spot quote 和 perp quote,可以計算現貨和永之周的 bas1s. 这知因子可以用於截察:

• 期現结横

• 资金费率璟境

• 跨交易所圾價差具

• 捍市場是否過熟

需要注意的是,basis本身不是策略。它退需要结合手續費、滑點、資金貢率、持愈通期和围 酸约束验。

2.Funding/OI/Mark/Index歷史研究​

新增的/v1/history/candles可以按需拉取:

• spot

• futures / perp

• mark

• 1ndex

• prem1umIndex

• funding_rate

这些资料封衍生品研究很重要。例如:

• mark 奥index 的偏雕

• premiunIndex 的時司序列曼化

• funding_rate 的 regime 切换

• funding+0I 的组合状想

• 便格下跌但0I不降反升時的加横标行為

这些史candle 可以透過persist=true寫入本地 Parquet,後續给回测、特微工程或 notebook 取

3.0rder Flow和Footprint 因子​

基铃trade事件,可以聚合主勤買賣暨力。 目前order flow支援:

• buy qty / sell qty

• buy notional / sell notional

• buy trade count / sell trade count

[euotou e1ap / Aqb eap *

• CVD

• large trade count

0ie1 11as / Anq assau66e . Footprint 進一步提供:

• 每根bucket 的raw trade 可選输出

• pr1ce-bin volume prof1le

• bid/ ask amount

• bid / ask notional

• per-price delta

• imbalance

• stacked bid / ask imbalance

• min / max delta

• total trades

这些指标可以用於翻察短退期成交蛋力,但是否有预涮力,需要在不同市场、不同時同视黑上

4.盤口整力和流勤性因子​

基铃L2 order book,可以翻察b1d/ ask depth 的翼化。 这知资料可能用龄:

• 流動性状照鞭察

• 流动性状思凝察

• 短期葡整成本估計

• 做市研究

• 签口不平衡研究

• liquidity score 裸造

但訂单薄资料噪聲很高,也容易受撤單、延逐和交易所握合概制影響,不能直接等同於真實贡賣 意图。

5.UniverseEngine:先筛市場池,再做研究​

Freqtrade 的 PairList 給了一個很好的敏号:研究前先定教universe。 MarketBridge 目前提供:

• top volume

• percent change

• volatility

• spread filter

• cross-market availability

• market cap

• age filter

• new listings

• delist risk

遗些介面可以助研究系统先回答:

• 哪些標的成交量足购?

• 哪些福的最近波动较大?

• 那些福的spread 太寶,不滤合短通期研究?

• 曙些標的同時有 spot 和 perp?

• 哪些概的愿史上出现遇,但目前quote缺失或通期?

遍裸需要特别锐明雨點:market-cap依莉CoinGecko、CoinMarketCap或其他 kline存在、但目前quote缺失或遥期,推遵出的資料属提示。

6.ResearchFeatureAPI:資料眉输出研究特微包​

MarketBridge 不做 AI模型凯辣,但可以输出研究特微包:

• multi-timefrane OHLCV features

• rolling returns

• rolling volume

• real1zed volatility

• z-score

• benchmark correlation

• correlated asset features

• funding / 0I regime

• liquidity score

• exchange disagreement

• market regime snapshot

遗据下游研究系统可以把更多稿力放在因子稳證,而不是重视寫資料预虑理遥朝。 这些feature 和reg1me Label只是資料特微與研究标,不是買賣信號,也不代表任伺 策略有效。

7.0ptions波動率研究​

期權可以為波勤率研究提供資料基。 例如:

• 不同expiry 的波動率结机

• 不同 strike 的偏斜

• 期權OI分值

• 市场封未来波助的定侵化

目前MarketBridge更帽資料探集和快取;,不是完整的期耀定價平台。

8.Polymarket和事件研究​

Polymarket的CLOB资料可以作為预测市場資訊源。 这频資料可能用於事件翻動研究,例如察某些市场機率是否领先新闻携散。 但预测市場本身也有流勤性、差、参與者偏差等問题,需要蓬镇使用。

9.宏、情和上過器​

DXY、VIX、US1oY、Fear &Greed、新情络、大翻链上帐等,更遍合作為reg1me filter 或上下文数。 它們不一定直接生交易信號,但可以助研究系统理解市增退境,

十、Agent 友好的資料入口​

现在很多研究流程會接入LLM或Agent。这性容易出现一個問题:Agent不知道愿該先查娜 些介面,也不知道資料服稿的遗界。 MarketBridge 新增了雨個介面: GET /v1/agent/context /v1/agent/capabilities告新 Agent:

• 有哪些資料能力

• 每佰能力對鹿睡endpoint

• 道合做什座

• 理些操作是read-only

/v1/agent/context會国体一国凑上下文:

• 目前quotes

• funding

ps uo .

• 可 storage manifest

• 推藏下一步endpoint

• 明硅 data-onty contract

這知介面不是為了Agent下覃,而是為了镇Agent更容易理解目前資料状感,少走增 路

一個典型呼叫:​

curl -s "http://127.0.e.1:8080/v1/agent/context?synbols=BTcUsDT,ETHUsDT,

十一、作為下游研究系統的资料入口​

MarketBridge更通合放在研究系统前面,作為資料入口,而不是直接承擅因子睡證或策略决 策。

一個比较自然的分工是:​

MarketBridge負青資料接入和整理:

• 即時行情

• 口

• 成交

• funding

• 11qu1dat1on

• 史 candles

• mark / index/ premiumIndex / funding_rate candles

• 期權

• 预测市場

• DeFi

• 宏

• 情缝

• 疑上

• universe 韩選

• research feature package

• 本地 Parquet 資科湖

下游研究系统负青研究和验證:

• 因子定羲

• 因子分類

• 因子验银

• 栈本外副试

• 黄略歸因

• 風险评估

• 交易成本和滑點建模

• 訓辣资料集概造

• paper trading

• 小资金责验验益

也就是就,MarketBridge 提供資料输入;因子是否有效、是否定、是否值得进一步研究, 需要由下游研究流程自行验源。

十二、目前遗界與可能問题​

為了避免误解,这里把目前界腐清楚。 MarketBridge 目前不是:

• 交易機器人

• 下覃系统

• 托管資金系统

• 自動套利系统

• 完整回测软行器

• AI训框架

• 低延遍交易所共址行情系统

• 保盈利的蛋略系统

MarketBridge目前更接近:

• 公開資料探集服務

• 多資料源標维化

• 即時快照和流式介面

• 按需雁史candle資料湖

• 資料品質 manifest

• 研究資料入口

• 因子研究的前置資料平面

• AI/Agent友好的只词市增上下文服務

目前仍然存在一些需要须虑理的同题: L.資料完整性取决龄外部来源外部API、交易所WebSocket、第三方資料股都可能限 频、變更格式或短暂不可用。

2.不是所有资料城都已完全 envelope 化 Quote、options、prediction book 的​

freshness / stale 结橘比较明锥: funding、0I、trade、Liquidation、order book 等raw snapshot 後續遗密要速一步统一.

3.特殊睡史candle遇不是全交易所覆蓝目前/v1/histary/candles重黏支援​

Binance 和 OKX Binance 支援 premiumIndex,OKX 没有同名定 public candle endpoint,因此 0KX 目前支援 mark、index,funding_rate,

1.public trades 退没有金量Parquet 落璧Orderflow/ footprint 目前依赖​

livetrade 事件和勤记憶體視窗。對龄可回放、可復算的长期footprint,需要後 public trades 的按需 Parquet 储存。

5.高频訂单仍有優化空麗目前已使用doma1n broadcast和ArcDataEvcntx减少​

按订者德,但router 和 snapshot store 仍有必要 clone.

5.資料品遇可以續增强 Parquet manifest 已露有 gap、duplicate、coverage、​

latency、stale、watermark,但更细的昊常值機测、source disagreement、自勤 修復和回補遗可以耀續做。

7.研究有效性不由瓷料保整NarketBridge提供资科,不負责證明某個因子或策路有效。​

所有策略都需要狮立回测、槎本外验盈和凰险部估。 任何基於它橘造的策略,在进入真置交易前仍然需要:

• 史回测

• 槎本外继證

• 交易成本建模

• 滑贴建模

• 延近群估

• 资金容量辞估

• paper trading

• 小资金實验验

十三、下一步計劃​

後德可以细續改进费因方向:

1.撞摘展更多原生資料connector​

?.將更多raw market snapshot 統一成 envelope 结

3.支援 public trades 的按需 Parquet 落盈、回放和 footprint 德算​

1.增加資料潮retention policy,例如保留7 / 38/ 90 天​

5.携展更多交易所的mark/index/funding/premiun 類雁史资料​

. 加强 catalog health、 freshness 和 source disagreement 计

7.提供更方便的 Parquet 错取示例和 notebook/ research SDK​

3.完善Polymarket 和包地址分析​

3.保持data-only 界,不引入下单和交易霍限​

这些都還需要持读工程驰證,不能只停留在文件程。 總結 MarketBridge是一個為量化研究場景構建的Rust市場資料層。 它目前比较明確的用途是:

• 只做公開資料,不做下單

将多调市场资科退整理成统一介面

• 將多個市場資料源整理成統一介面

• 提供 REST、WebSocket、catalog、health 和 metrics

• 支援quote、訂單簿、成交、funding、OI、liquidation、kline、特殊歷史

candle、basis、order flow、footprint、options、Polymarket、DeFi、宏觀、 情、上等多類資料

• 提供按需Parquet本地資料湖,而不是预設無腦全量落盤

• 提供universe、researchfeatures、agent context 等研究友好介面

• 可以作為研究系統、内部資料平台或AI分析流程的資料底座

如果用一句話概括: MarketBridge想解决的是量化研究前面的資料工程問題:把分散、巽構、難維護的公開 市場資料,整理成更統一、更容易消費、更容易监控、更容易按需存的資料介面。 它遗在持續迭代中,仍可能存在不足。 如果你也在做量化研究、市場資料工程、事件研究,或只是對這類data-only工具有興趣, 歡迎試用、提isSue、指出問題,或者分享哪些資料源和介面設計最值得優先改進。 真實使用中的回會非常重要,因為這類基設施只有放到具體研究流程裡,才知道哪些地方真 的有用,哪些地方還需要重新設計。 https://github.com/okloorcl/MarketBridge

原始排版图​

原始导出图超过单张 WebP 的尺寸上限，以下图片按从上到下的顺序连续保存。

发布于 2026-05-16 17:17:24（微信公众号导出记录）。

本文来自公众号后台的“导出文章内容”功能。博客正文由导出长图进行本地 OCR 转写，并保留原始排版图用于逐段核对。

原文链接：查看原文

OCR 转写有效文字约 22527 字；代码、流程图和版式以文末原始排版图为准。

正文（本地 OCR 转写）​

original wex7ce EI V1ajero 2026年5月16日 17:17 日本 2026年5月,美园加密监管立法迎来键時刻。針封已在思藤院推进的H.R.3633《数 位资產市场清晰法案》(Digital Asset Market Clarity Act,稠 CLARITY 法案),端院银行委员言主席蒂姆·斯科特(TimScott)正式抛出了一份長速308多 真的完全替代正案(Amendnent 1n the Nature of a Substitute),試图 以更全面的框架重塑該法案的底规则。是《GENIUS法案》(定增立法)之後,美 固圆曾推进的第二部重大加密資立法。法案共九個標题(Title),涵蔗管辖權副分、反 洗钱、DeF1监管、银行创新、敢體發者保器等核心题。 本文试圆以有限的祝角,到法案中三個最受開注的维度一管辖權劃分、技药豁免舆用發者保罐、 反洗框架一進行桃理,标主期键分析點的原文依擦與英文出露,供错者些考。文中的理解强 免有疏调之處,歌迎指正。 BANKING Digital Asset Market Clarity Act TOPLINE The Banklng Committees MarketSructure Bl establshes clear protectionsfor digtal assetmaret artipntngryaristholsthed tprip In digital asset markets. Sec 101. Short Title, Sec 102 Discksure Reqiremets fr Certa Trractios ing Anilay Ass Thssei fiat r te hal hn crtrepreneural ormangral eferts. Requiresilmldure foerain rctoncllets dtrs tokens themsekes as commodies. Cretes raeprthat tes nnlarset ulestgt at netwerk tken, or a dgtalasset intermedary submits to the ommlon a completed writen certfcaton supprted by resonable evidence, as cefine by the Commlsson, sufdent to demnstrate that he netwcrk token is not an ancilary asset. Thengtfmththtef,s Intenmediary reasonabl detemines they cornot provide thzt certfication. Alrrrlinteyh eforts hae ened ad thatEdiscores re ngerqd. H.R.3633 To provide for a system of regulation of the offer and sale of digital commodities by the Seeurities and Exehange Comrmission and the Commodity Futures Trading Com- mission, to amend the Federal Reserve Aet to prohibit the Federal reserve banks from offering certain produets or services direetly to an individual, to prohibit the use of eentral bank digital eurreney for monetary poliey, and for other purposes. Referred to the Committee on and ordered to be printed Ordered to lie on the table and to be printed AMENDMENT IN THE NATURE OF A SUBSTITUTE intended to be proposed by Mr. Scorr of South Carolina Z Strike all after the enacting elause and insert the fol- 1 2 lowing: 3 SECTION 1, SHORT TITLE; TABLE OF CONTENTS. (a) SHoRr TrrLE.—This Aet may be eited as the 4 5"Digital Asset Marltet Clarity Aet". (b) TABLE oF CoNrENTs.—The table of contents for 6 7 this Aet is as follows: Set, 1. Shoet title; table of eomtents See. 3. Definiti 核心速實 關發者解套:规粹富程式碼、跑節贴、做基碰设链不磺成資金传输:,不受證券法與洗法 管糕 管辖權落定:證券SEC,去中心化钢路通湿CFTC,项目方可透通合规退機制量 为纯粹商品。 DeFi抓前端:真正去中心化的智能合的不管,但提供缓页介面的前端:必须接入匠境翘分 析工具损截黑钱。

一、法案全貌:九大標题的结構與選辑​

在深入组丽之前,先了解法案的整经结标有助於把握其立法通辑: 核心内容 標题 名 SEC/CFTC管魅權劃分、附属資 负责任的避创新(Responsible Secu Titl 產:與频路通源:定、Regulat e I r1t1es Innovation) 1on Crypto 豁免 数位商品中介BSA適用、加密ATM Titl 打非法金融(Protecting Against Illicit Finance) e II 整管、公私合作试贴 DeFi 负责任創薪 (Responsible Inno Titl 去中心化DeF1榕监管、前 e II vat1on in Decentralized Financ 端AML囊務、可疑交易源结安全港 I e) 负任的银行创新(Responsible Bank 银行数位資產业程許可、蔡止支付 Titl 定利息 e IV 1ng Innovat1on) 负责任的管創新(Responsible Regu 創新沙盒、圆際合作、代整化湿券、 Titl latory Innovation) e V 後量子密码標准 保體开髮者與體創新(Protectin 阿發者免、NFT安全港、自托管 Titl g Software Developers and Softw e VI 包保 are Innovation) Titl 保客户财產(Protecting Customer e VI 破產中数位资產的客户财牵地位 Property) I Titl 客户保蓓(Customer Protection) 教育材料、SIPC技露要求 e VI II SEC-CFTC 够機F1nCEN 报 T1tl 其他事项(Other Matters) e IX 款、生效日期 原文出處:法系目缘見H.R.3633法系全文 (https: //ww. banking.senate. gov/ino/media/doc/ehf26374 .pdf ) Table of Contents;各标粗概要見 Chairman Tim Scott (https://ww. banking senate. gov/ino/media/doc/section-by- section.pdf)。 、管辖權分:SEC奥CFTC的三分法

2.1核心問题:一個通證,該歸管?​

在现行法律框架下,数位資產究竞是“券:(SEC管)遗是商品:(蹈CFTC管), 是侵期困捶行的核心同题,CLARITY法案的回答是建立一個三分法框架: 数位资(Digital Assets) |——退券(Securities)-具有分红、股霍等取消資格的财移權利一SEC 管 路通證(Network Tokens)-本胃為傲位商品-CFTC 管幅 ——[末果案子集】附属资盈(Ancillary Assets) ——底眉法律属性仍为细路通遇(数位商品) ——底层法律展性仍為纲踏通(数位南品) ——初版市場:因依频制装/管理努力,搜“投资合的:受SEC披露差務的束 ——二版市增:视为非券,CFTC管辖 L可通通烫速「果案」-脱翠SEC鼓雷 L—可通适果脱SEC披露務 [已翠粪]梓银路通-完全去中心化,焦SEC技露務 注意:在法律定上,附展资產是钢路通避的子集而非亚列翼係。Sec,4B(a)(1)明 规定:“The term‘ancillary asset’means a network token..."—所有附属 資在底歷法律属性上都是網路通篮(即数位商品),只是因為尚末「軍案:(依然依赖制 始團账的愈案/管理努力),所以被5EC暂時按投资合的套上揭露瓣。

2.2路通證(NetworkToken):CFTC侧的基石​

法封“频路通露的核心定瓣如下: intrinsically linked to a distributed ledger system and that derives, or is reasonably expected to derive, its value from the use of such distributed ledger systen, and, pursuant to the Digital Asset Market Clarity Act and the amendments made by the Digital Asset Market Clarity Act, is treated as a non-security solely for purposes of the Federal securities laws." 中文:「细路通證:是指一種與分散式细本系统内在雨哪的数位商品,其情值来源於或可 合理预期来漂於旅分散式本系统的使用,且依據本法及其修正案,谨爲聊邦證券法之目的 被视為非證芬。 Sec. 4B(a) (7) (A) (https://ww. banking senate. gov/ino/media/doc/ehf26374.pdf) 这意味著:路通證在本質上被歸入CFTC管辖的数位商品:瞻,而非SEC管辖的 券。但這種類非無條件—如果通涨包含“取消资格的财精權利:(disqualifying financialrights),刚被劃入 SEC 管辖。

2.3「取消瓷格的财務權利:到入SEC管辖的紅線​

Sec,4B(a)(7)(B)列事了激致细路通表失非證券地位的情形:

• 到某人的鸦或股權益(debt or equityinterest),或其期;

• 到某人的清算權(liquidationrights):

• 某人得利息、股息或其他支付的合理预期(entitlenmenttointerest,

dividend,or other payment)—去中心化治理系统除外:

• 别某人的明示或默示财利益(express or implied financial interest)—去中

心化治理系统除外。 原文出處:Sec.4B(a)(7)(B)(ii), (https: //vw. banking.senate- gov/1no/med1a/doc/ehf26374 pdf)。

一個购设计值得注意:去中心化治理系統(DA0)提供的耀益不橘成取消资格的财務權​

利。这意味著DA0的治理權益本易不會致通超被歸為超券。

2.4「附属资產:(AncillaryAsset):灰色地带的關键福纽​

附丽資產是整回管辖權副分的核心概念: 原文:“The tern ‘ancillary asset” means a network token, the value of which is dependent upon the entrepreneurial or managerial efforts of an ancillary asset originator or a related person, as those concepts are further specified by the Commission by regulation." 中文:「附资至:是指一種绸路通證,其價值依赠於附高资發起人或飘聯人的創業或 管理努力,概念由委員(SEC)通退法规进一步具偿化。 5ec.4B(a) (1) (https://www. banking senate. gov/ino/media/doc/ehf26374. pdf) 附画資產處於「灰色地带」:

• 在初级市場:由發起人稳行、出售時,被视為「投資合約:(即罐券),受SEC管糕;

• 在二级市場:任何人出售钢路通證,不被视為涉及谊券的出售,歸CFTC管鞋;

• 但附带有SEC的资披露要求

原文出處:初级市场處理見Sec.4B(b)(1)—"the offer,sale,or Aieiiue ue q pn o Aq yasse ieiioue ue 4o uons asset originator...shall be considered to be an offer, sale, or distribution of an investment contract involving an ancillary asset";二级市场虎理見 Sec.4B(b)(3)。

2.5「可反的推定機制:SEC管辖業的路径​

这是法案最精巧的製度投計之一: L.默翘推定:所有细路通證显初都被推定为“附資產:——即虚投SEC的提露整管厘内; ?.反路径:起人或中介人可向 SEC提交超器(written certification),速明鼓通 不再依瀚創業/管理努力:

3.自勤生效:提交後60天内SEC未提出反,即自勤生效:​

1.SEC否决權:SEC可否决懿,但必须經全委員投票(不得委托结員),且否决决定​

可接受司法塞查。 原文出處:Sec.4B(c)(5)—*There shall be a rebuttable presumption that a network token (including a network token distributed 生效楼制見 Sec,4B(c)(5)(B); SEC 否決程序見 Sec.4B(c)(5)(C)。 https ://www.banking senate gov/imo/media/doc/ehf26374 -pdf 这一機制兼顾了投资者保进(默推定需要揭露)和行業签活性(提供明確的“果業:路径), 避免了永久性的监管不確定性。

2.6RegulationCrypto:輕量级證券發行制度​

法創经了一种名為“Regulation Crypto”的新注册整免(Sec,103),允許公司在不 满足完整上市公司合规要求的情况下發行附属资座: 数值 法案依據 年度需资上限 5,880美元(或爆市值10%,取较大者) Sec. 103(b) (1) (A) Sec. 103(b) (2) 2像美元 善资上限 4年 有效期 Sec. 103(b) (1) (A) 原文:"The exemption allows companies to raise money fron everyday investors. without having to comply with the full suite of burdensome securities law requirements that public companies must comply with." (https : //www.banking senate gov/imo/media/doc/section-by- section.pdf), Sec. 183 但Regulation Crypto 排除了空公司、投资公司、通去1θ 年内有金融欺量平記錄的 圆人等。同時,在豁免下提交的握露文件不解發《證券法》第11条的社册脱明害贵任,但 保留反款诈保,

2.7SEC-CFTC協調機制​

為證免雨楼横之闻的管葡突,法案設立了雨困雨键铜楼制: 聊合数位資產路詢委員會(Sec,901):由SEC和CFTC联合設立,不超遇14名非政 府投票成员,包括市场参與者、注册者、學術研究者、零售用户和州證券监管者。委員管的 建是非豹束性的(nonbinding recommendat1ons),但 SEC 和 CFTC 须在 96 天内 提供正式害面回度。 镇解備忘(SeC.982):要求SEC與CFTC签订MOU,硫保调监管和執法 原文:Clarifies that the SEC retains ant1-fraud and ant1- manipulation authority, including insider trading, while the CFTC retains market integrity authority over comnodities markets. (https : //www.banking senate gov/1mo/media/doc/section-by- section.pdf), Sec. 982

2.8法院既判力的尊重​

Sec.105(b)(1) 规定: 原文:“1f, prior to the date of enactment of this Act, a United States court determined in a non-appealable judgment that a transaction involving a digital asset did not constitute an offer, sale, or d1str1but1on of a security, the dgital asset 1nvolved 1n such transaction shall not be considered a security for purposes of this Act." 此外,Sec。105(b)(2)遍一步规定:如果某细路通露是已在国家證券交易所上市的交易所交 易座品(ETP)的主要资座,且該ETP末在《投资公司法》下册,刚該路通證不愿被視為 刚属资座或监芬,这實置上為比特常和以太坊等已有ETP的基碰资塞提供了明確的非證券 定。

section.pdf), Sec. 105.

三、技術豁免與開發者保護:法律為程式碼留出空間​

3.1软體用發者豁免(Sec.601):三大類活動​

法案TitleVI的核心條。在《證芬法》和《交易法》中分别嵌入了保條款(新增Sec. 27C及5ec,15H),明以下三规活動不受罐券法管辖: 骼免活勤 具雅内容 網路基提 编细路交易(compiling network transactions),中继、搜索、排 投施维撰 序、验糟(relaying,searching, sequencing,validating) 計算資源 通行黏或预言機服(operating a node or oracle serv1ce)、提 提供 供網路频實 黎、壁布分敲式本系统:登戴助用户保管私的接包款 舆布

• Notwithstanding any other provision of this Act, a person

原文: shall not be subject to this Act and the regulations promulgated under this Act solely based on the person engaging in any of the following activities...* —Sec. 27C(b) (新增於 Securities Act of 1933), https ://www.bank1ng .senate-gov/1mo/med1a/doc/ehf26374 -pdf 但道一器免有一個重要的雙轨制:設計—開髮者免於證券注册和合规教務,但SEC仍 保留計對撤靠、操和虚假报告的全部敦法權力: 原文: *The determination to be not subject to this Act under subsections (b) and (d) shall not apply to the ant1-fraud, ant1- manipulation, or false reporting enforcement authorities of the Commission." Sec. 27C(c)

3.2區愧键监管確定性法案(Sec.604):開發者不是「资金傅输者​

这一條款直接回鹰了此前F1nCEN和各州試医將區地捷節贴莲管者、包開發者蜗频为資金 傳输者(money transmitter)的做法。 法系定了非控制型關者或提供者:(non-controllingdeveloperor provider) 的概念: 原文:“The term‘non-controlling developer or provider’means a developer or provider of a distributed ledger service that, in the regutar course of operations, does not have the legal right or the unilateral and independent ability to control, initiate upon demand, or effectuate transactions involving digital assets to which users are entitled, without the approval, consent, or direction of any other third party." Sec. 604(b) (3), (https://vw.banking senate gov/1no/med1a/doc/ehf26374 .pdf) 此類非控制型限我者不得被视為资金傅输業務,也不受與资金儒输移實質颈似的册要求的 束 但刑事青任被保留一明知資金来源於犯罪或意医用於非法活動而仍代他人勒移資金的,不受豁免 保薄。 原文:“Exempts blockcha1n developers and prov1ders from be1ng classified as money transmitters or subject to money transmission registration requirenents, but preserves existing federal criminal l1ability for anyone who 1ntentionally transfers funds on behalf of another person knowing those funds are proceeds of a crime or intended to further unlawful activity." (https : //www.banking senate gov/imo/media/doc/section-by- section.pdf), Sec. 684

3.3KeepYourCoins法案(Sec.605):自管包的合法性​

这是哪郑眉面首次以立法形式碰立自托管包的合法性: 原文:“A Federal agency may not prohibit,restrict,or otherwise impair the ability of a covered user to self-custody digital assets using a self-hosted wallet or other means to conduct transactions for any lawful purpose.* Sec. 605(c), (https://www.banking.senate.gov/ino/media/doc/ehf26374.pdf) 自托管包:(self-hostedwallet)被定为数位资產所有者對资產保持疆立控制的 數位介面。但保仅限於「合法目的(Lawfulpurpose),财政部、SEC、CFTC 等機 横在反洗钱、反恐融瓷和制裁方面的款法權限被完整保留。 原文出滤:(https://ww.banking. senate.gov/imo/media/doc/section-by- section.pdf), Sec. 685.

3.4NFT 安全港(SeC.602)​

法赛为NFT创設了明的安全港: 原文: *The offer, sale, resale, transfer, or conveyance of a nonfungible token shall not be deemed to constitute an offer, sale, or distribution of a security or investment contract under the Securities Act of 1933...unless the transaction, in substance, involves all of the elements of an investment contract." 5ec. 602(b), (https://ww.banking senate. gov/ino/media/doc/ehf26374.pdf) 同键要贴:

• 谨因NFT可能升值或部分依赖於逾造者驾叠,不携成跟券—即使核NFT是收蕊品、會员

權或防同證:

• 安全港不通用龄:批量造的實質同質化NFT、NFT辞片化權益、代表NFT經清索求權

的權益:

• SEC若定安全港不適用於特定情形,鼓定催具前瞻效力。

原文出虑:(https://ww.banking.senate.gov/imo/media/doc/section-by- section.pdf), Sec. 682。

3.5「無价分發與質押爽励(Sec.4B(a)(5))​

法案群墨列了六大频不横成證券分發的無优分發:(gratuitousdistribution) 制,直接回应了曾押是否成银券行,的核心爭: 件 分登類型 自質押(Self Staking) 質押代需所有者與的站運暨者為同一人 自托管赞押與第三方(Self-Custodia

第三方不持有或控制質押的代需​

1 Staking with a Third Party) LST作為行政/文害收登行,不提供裁量管理 流勤性質押(Liquid Staking) 權 托管和辅助算押服務(Custodialand 服務纯属行政或文善性質 Ancillary Staking Services) 程序化與自勤化分(Programmatic 满足五项度格修件(公開透明参数、可验银参 and Autonated D1stribut1ons ) 民、比例分配、去中心化来源、悬单方更改權) 技中立條致(Technology-Neutral 兜底修款,蓝未来新型概制 Clause) 核心法律效果: 原文: *A gratuitous distribution, by itself, shall be presumed to not constitute an offer, sale, or distribution of a security. 5ec. 4B(b)(4), (https://ww. banking senate. gov/ino/media/doc/ehf26374.pdf) 原文出處:Sec.4B(a)(5)酮於“gratuitous distribution”的鲜组定及六 大分發楼制列,見 (https: //ww. banking senate. gov/ino/media/doc/ehf26374 .pdf ).

3.6去中心化治理系統(DA0)的法律地位​

法系對DA0的滤理是其最具前瞻性的制度創新之一。核心法律推定:

a person or a group of persons acting under common control." —Sec. 2(5) (D), (https://ww.bank1ng senate gov/1no/med1a/doc/ehf26374 pdf) 这意味著:

• DA0参者的行為不會因DA0的存在而被歸因於共同控制::

• DA0提供的經清權益或投票權不横成取消資格的财移權利;

• DAD可包含法律實體(如去中心化非誉利悠富),前提是不以集中管理方式理作;

• 安全委最盲的预定羲網路安全器急措施不横成共同控制

原文出處:Sec.2(5)定善—*The term‘decentralized governance system’ means...any transparent, rules-based system permitting toformconsensusorreachagreenent...inwhich persons participation is not limited to, or under the control of, any person or group of persons under common control":安全委員言安全港見 Sec. 104(b) (3)(C) 及 Sec. 301(f).

四、反洗框架:系統性建設舆關鍵缺口存​

4.1TitleII:核心AML條款​

4.1.1数位商品中介納入BSA(Sec.201)​

法案將数位商品經纪商(digitalcommodity broker)、交易商(dealer)和交易所 (exchange)纳人银行保密法下的「金機槽:(financialinstitution)鲸畴,要求 其:

• 建立和维持AML/CFT项目(含风隆部估、内部政策、合规官、培訓、立睿計):

• 保留交易記錄:

• 监控和报告可疑活动,「可包括使用墨的分散式帐本分析工具:(wh1chmay 1nclude

use of appropriate distributed ledger analytics);

• 继持有效的客户懂刚程序(CIP)和客户需调查(CDD)。

原文出虑:(https://www.banking.senate,gov/imo/media/doc/section-by- sect1on.pdf), Sec. 281—*Th1s sect1an requ1res d1g1tal commodity brokers, digital commodity dealers,and digital commodity rsbunu the Bank Secrecy Act, which requires anti-money laundering programs, customer identification, and customer due diligence."

4.1.2加密ATM全面监管框架(SeC.205)​

这是目前美圆群邦唇面到加密ATM最全面的监管框架,核心措施包括: 措施 内容 注册奥地址報告 每90天向财政部提交更新的终端地址清單 交易前必须向客户提供群列常見躺局類型的警告 欺养预防揭露 反欺诈政策 聊邦底绿标率,允許州實施更格棵率 必须指定全联合规官(不得為CE0或持有10%以上益) 合规官任命 疑上分析 强制使用分散式板本分析防止向已知欺昨包發送資叠 接包额定 禁止不同客户使用同一载包地址 72小時持有期後才可向特定线包發送資產 24小時内不超透3,508美元 新客户日限 欧炸受害者30天内投新可推退費 退款提制 客户服热娘 登同人工客服 原文: Until the effective date of regulations prescribed under subsection (k), a digital asset kiosk operator shall not pernit a new customer to conduct transact1ons exceeding $3,56e9 1n the aggregate within any 24-hour period.(新客户臨時日限额) Sec. 205(1), (https://ww. banking senate gov/ino/media/doc/ehf26374 pdf)

4.1.3公私合作舆能力建设​

法案遗設立了多個跨部门概制:

• 公私合作試點(Sec.203):5年期项目,允許聯邦法機属與30家私誉實险安全共享

資訊:

• 金融科技保罐工作组(Sec,284):由财政長主持,跨9图群邦機横+私警部門代表,

研究数位资至非法使用:

• FinCEN握款(Sec.983):5年共1.5僵美元(每年3,809高),另允許20%薪

酬溢價吸引显境继分析人才。 原文:“Authorizes an appropriation of $38,086,000 per year for the first five years following the enactment of this Act./ “Author1zes the D1rector of F1nCEN to pay a 28% preniun to attract highly qualified candidates." —(ht tps ://www.banking senate. gov/imo/media/doc/section-by - section.pdf), Sec. 983

4.2TitleIII:DeFi领域的AML條款​

4.2.1「非去中心化DeFi協的韶定(Sec.301)​

以下任一條件下被潔定為「非去中心化」(non-decentralized):

• 某人或某群體有權控制或實質性更協摄的功能、谨登或共微规则:

• 不基於原始程式码中预設的透明规则谨行:

• 基人或某群體有權限制、塞查或禁止摄使用。

被韶定為「非去中心化:的,其控制人需册遗用BSA。但法案同時明殊:去中心化治 理系统(DA0)本身不被说為“人:或共同控制群,前贴通叠、验温等基础设施活勤不會募致 超端被提定為“非去中心化」。 原文出感:(https://www.banking.senate.gov/imo/media/doc/section-by- section.pdf). Sec. 381—Defines when a DeFi trading protocol is considered ‘non-decentralized, focusing on control, discretion, or the ability to alter or censor protocol operations."

4.2.2前端监管:分散式帐本訊息系统(Sec.302)​

法案在法律定美上進行了精华的「防火切割:: 原文:*Defines a ‘distributed ledger messaging systen’ as a web- hosted front-end that lets users send 1nstructions to a blockchain app or DeFi protocol, while expressly excluding the protocol, nodes,wallets,and other core infrastructure conponents themselves . " (https : //www.bank1ng senate gov/1mo/med1a/doc/sect1on-by- section.pdf), Sec. 382 财政部须在法案生效360天内發布前巍制裁和AML/CFT羲猜指源。这亚非“技街上管不了 所以不管:,而是立法者在法律文中做出了明硫的骼免切割—將底屠罐、前贴、包和智能 合韵排除在讯息系统:的定载之外,免除了底層程式碼的反洗款務:只到提供细真纺同介面 的美圆前端谨警者施加制裁静查责任。

4.2.3 其他 DeFi AML 工具​

• 财政部特别措施(Sec,303):播展爱回者法案第311條力,允许财政部長針到数位

資奎领域的外固洗频闻注禁止或刚加条件於美圆金融楼福的資金匯兑:

• 雕岸辑定报告(Sec.304):要求财政部定期报告依赖美國借资座(如國慎)的魁岸

定整的非法金融凰险—直接回离Tether(USDT)等岸模定陷的整管届切,但目前懂 是情报收集」:

• 可疑交易冻结安全港(Sec.3θ5):这是一项民事免责嫩款(protectionfrom

privatecauses of act1on),而非強制凌结善。法案亚未要求交易所冻结用户資金

一其真實意图是:如果股務商稳现可疑洗接行為或接到警方害面請求,自题​

(voluntarily)置施盈时源结(初始30天,可依朝法機标善面請求延侵至156 天),则在限行通知和記疑保存薪移後,免於被用户提起民事新然。這是為了打消服務商 制警察凌结資金害被用户起新:的顾遍,而不是增加一填强制性的凌结瓣。

• 混器研究(Sec,309):要求财政部在1年内研究混器的非法使用比例和疆私利益,

但堡足「研究:而非「禁止」。 原文出虑:(https://www.bank1ng.senate.gov/1mo/med1a/doc/sect1on-by- section.pdf), Sec. 303-369.

4.3参員華偷的批部:四大核心指控​

2026年5月14日,参院银行委员鲁资深成員伊莎白·華偷(ELizabethWarren) 在委員會標妃會(markup)上發表激烈批部。地的核心输黏如下: 指控一:DeFi洗漏洞 原文:Th1s 1ncludes a f1x requested by the Nat1onal Sheriffs Association to close a massive loophole in the current bill that would make it harder for law enforcement officials to go after cartels and crininals using decentralized platforms to launder money. So, the sheriff's concerns have just been cut out.

去中心化平台洗筑的版毒集墨和犯罪分子。而警长们的切刚则被排除在外。」 —Senator Warren (https: //ww.banking,senate. gov/newsroom/minority/senator-warren- opening-remarks-at-committee-mark-up-of-the-clarity-act) . May 14, 2026 舆法案文本的對惠:Sec.301以「控制人為盈管描點,無控制人即無监管。真正去中心化 的虚龄监管灰色地带。全国警長(NationalSheriffs’Association)要求 这一漏润的修正系被主席以程序要求;(proceduralrequirements)為由拒纳入表 沃 指控二:国家安全威险 原文: “Just 3 days ago, the Treasury Department issued an alert warning that Iran is exploiting crypto businesses to move their money around. Muttiple public anatyses documents that drug cartels are shifting their money laundering to crypto, and, quote, the 'cops can't keep up.*" Warren Senator (https: //vww, banking senate gov/newsroom/minority/senator-warren- opening-remarks-at-committee-mark-up-of-the-clarity-act) 指控三:州法律欺靠保被削弱

• Second, this bill declares open season on defrauding

原文: American consumers who use crypto. The bill wipes out a huge number of state-level protections against fraud." Warren Senator (https: //ww. banking senate. gov/newsroom/minority/senator -warren- opening-remarks-at-committee-mark-up-of-the-clarity-act) 奥法案文本的惠:Sec.108将網路通温视為“受覆蒸遗券;(coveredsecurity), 侵先於州證券法的主册要求。 原文:“Preempts certain state securities law requirements but preserves state anti-fraud authorities.* (https :/www.bank1ng senate. gov/1mo/med1a/doc/sect1on-by- section.pdf), Sec. 188 掌愉的批舒属於政治视角的引申:她韶為不镶告州要求项目方册,實置上削了反欺靠能力。 但法律文本的字面来看,法明文保留了各州對撤靠行為的執法權——寒的是各州要求代 需册,的權力,而非调查和起.欺作的權力。这一区别对於理解法案的實際法律效果至阑重 要。 指控四:加密行業主導立法 crypto industry for the crypto industry. Nothing made it into this bill that wasn’t approved by the crypto industry." —Senator Warren (https: //vww, banking senate gov/newsroom/minority/senator-warren- opening-remarks-at-committee-mark-up-of-the-clarity-act) 華偷遗指出,儒管多名参員(Reed、Kennedy、Van HoLlen、Smith)要求举行公涨 营,敲法案征未驱行遇任何题湿善,十多项修正案被以程序要求:為由排除。

4.4法案AML框架與批部之間的張力​

客觀而言,法案的AML框架存在一国根本性的設計張力: 支持者的退辑是通遇將数位资產中介機机(而非灌本身)纳入现有BSA框架来熙管AML围 险,與傅统金融的AML還辑一致一监管中介而非市堤。 批辞者的搬豪定,数位資座的特性在於去中心化協端可以消除中介,使监管中介:的策略失 效。法案封無控制人的真正去中心化藤懂提供了前端整管(Sec,382)和中介楼横图险管理 的間接的束(Sec.388),被執法界為不钧充分。 这一張力反映了一個更深屠的立法遗挥:在鼓助去中心化新與防非法金融之間如何取得平衡

一道亚非CLARITY法案摘有的困境,而是全球加密监管面蕴的共同挑嗽。​

五、銀行創新與穩定:支付與投资的遗界​

5.1銀行数位资產務許可(Sec.401)​

法系以立法形式础立了“技術中立:原则—如果一项活助用傅统方式可以做,用區现键方式同機 可以做 具管授權涵整14類活勤,包括:数位資塞托管、置押服務、客户交易促进、以数位資為抵 押放货、支付活動、银行自警投资交易、警前黏、提供自托管包款禮、行生品證险、經纪清 算、做市交易等。 同時明確保留了所有现有密佰监管要求,银行不能因為使用数位资座技術而进避资本、流勤性和 安全操健性要求。 原文: “Amends the Bank Holding Company Act, National Bank Act, and other banking laws to clarify that financial holding conpanies, national banks, state banks, and certain credit unions can use digital assets and blockchain technology for any activity they're already allowed to do, like payments, lending. custody. and trading." —(https : //ww.banking senate, gov/imo/media/doc/section-by- section.pdf), Sec. 481

5.2禁止支付穩定利息和收益(Sec.404)一最具爭的條款之一​

圆首明随表连了斐重立场: 原文:售韶为:(1)数位资座服務商以频似銀行存款利息的方式向支付稳定需持有者支 付收益,可能抑制存款機福的核心经清功能:(2)同時,医會承懿支付定是重大金融 基碰设施剧新,基於活動的赞励和滋封推動新和消意者操用至雨重要。 5ec. 404(b), (https: //www. banking- senate - gov/ino/media/doc/ehf26374 .pdf) 核心禁止: 原文:“No covered party shall, directly or 1ndirectly, pay any form of interest or yield (whether in cash, tokens, or other consideration) to a restricted recipient-(A) solely in connection w1th the holding of such restricted recipient's payment stablecoins; or (B) on a payment stablecoin balance in a manner that is econonically or functionally equivalent to the payment of interest or yield on an interest-bearing bank deposit." 5ec. 404(c)(1), (https:/vww.banking senate gov/ino/media/doc/ehf26374.pdf) 允許的骼免—基於真實活助的励(bonafide activities):

• 交易、支付、轉邮相的返利或激励:

• 為做市提供流勤性、弧贴交易抵押品:

• 参與治理、验盘、贺押或忠城度計置。

键澄清:允許的类助可以按照除额、持續時間来計算一只要其根本性質是基於活動的,而非單 细持有收益。 值得注意的是,上述第二项器免直接低到量化交易和DeFi流勤性提供者(LP)的利潜来源

一演算法交易和自勤化做市商(AMM)的合法收益模式得到了明随保疆,未被一刀切:禁止。​

這意味著在Uniswap、Curve 等DEX上提供流動性所得的交易手讀費收益,以及在CEX 上事做市活勤的差收益,均不在禁止前圆之内 通反者每次面脂最高500葛美元民事5款。 原文出處:(https://www.banking.senate.gov/imo/media/doc/section-by- section.pdf), Sec. 484,

5.3客户财產的破產保(Sec.701-702)​

直接回愿FTX事件中的法律空白:

• Sec.7θ1辅助資座和数位商品:纳入破座法「客户财座(customer

property)定羲,客户享有侵先值權;

• Sec,782將数位商品交易纳入破產安全港,封手方可立即平逾取得抵押品,無需等待破

至程序。 原文出感:(https://www.banking senate.gov/1mo/media/doc/section-by- section.pdf), Sec. 78l-762.

5.4代化證券(Sec.505):代化不改法律丽性​

"Explicitly states that tokenized securities are still 原文: securities for regulatory purposes." (https ://www.bank1ng senate gov/1mo/med1a/doc/sect1on-by- section.pdf), Sec. 505 Sins tesapay aua sapn ktnas e st reua tasse Au. 1xm laws shall not cease to be a security solely because the asset is 1ssued, recorded, represented, or transferred using distributed ledger technology or comparable technology.* Sec. 505(h), (https : //www. bank1ng senate gov/1no/med1a/doc/ehf26374 pdf) 这消除了「代需化是否改监管分频;的事。

六、生效時間線與關鍵數字一​

6.1關鍵時間節點​

事项 時間要求 法案依

一般生效日​

颁布368天 Sec. 906 366天與最终规则公布後60天(取较晚 需规则制定的保款 Sec. 906 者) Sec. 965 各监管機横规则制定 颁布後1年内 SEC州商资超规 Sec. 4B(a) (2) 颁布後368天内 则 (C) 加密 ATH 注册 Sec. 205(a) 法案生效99天内 前端AML 指填 Sec. 302(b) 颁布368天内 Sec. 884(b) SIPC 揭露规则 颁布後278天内 Sec. 309 颁布後1年内 混需器研究报告 向圆富提交定附餐 颁布後2年内 5ec, 404(h) 告 “Establishes a general effective date, which is 366 days 原文: effect e1ther 360 days after enactment or 60 days after the final rule is published in the Federal Register, whichever comes later." —(https ://www.banking senate.gov/imo/media/doc/section-by- section.pdf). Sec. 986

6.2關鍵数字速查​

项目 数值 法案依據 Regulation Crypto 年度等資上 5,080萬美元或德市值1 Sec, 183(b) (1) % (A) 限 Regulation Crypto 塞资上限 2债美元 Sec. 103(b) (2) Sec. 184(b) (2) 超遇49% 調控制持整比例門 (C) 60天 Sec. 4B(c) (5) (B) 附商資產招證自動生效 加密ATH新客户冷静期 72小時 Sec. 285(1) 加密ATH新客户日限额 3,500美元 Sec. 205(1) 30天(可延至158天) Sec. 305 可疑交易冻结初始期限 Sec. 963 3,000第美元(5年) FinCEN 年度据款 最高20% Sec. 963 FinCEN 薪酬溢價 遵反稳定常利息禁令到致 最高508高美元/次 Sec. 484(f) 创新沙盒年度参失上限 每横28项目 Sec. 501(d) (3)

七、小結:一部具有里程碑意羲的立法草案​

CLARITY法案是美圆迄今最全面的数位資產市場结横立法。它試图回答三個核心同题: 雄管什磨?通遇網路通退-附隔资產-学:的三分法和可反推定機制,在SEC與CFTC 之同则定了这今最清晰的管辖通界。 什鹰被蓄免?通退软噬阳發者保證、NFT安全港、自托管包合法性、置押莫的非芬 定、DAO的非“人:待過,為技術创新留出了题著的法律空闭。 如何防洗?通透将数位商品中介纳入BSA、加密ATM全面整管、非去中心化DeFi 需管、前端AML捐得、财政部特剧措施等,磷建了多唇防體系,但在真正去中心化俗的监 管覆签上仍存在争罐性缺口, 这部法案目前仍在委真會塞运段,最终文本可能进一步修改。其走向不价將深刻影響美圆数位 资產行業的监管格局,也將對全球加密监管框架產生重要的示航效惠。 警明:本文基於公開的法案文本、5cott主席逐综摘要和草偷参谨員册場陈述逾行梳理分 析,旨在提供资讯参考,不成法律意見。法案仍處於立法通程中,最终内容可能發生 化。文中如有疏漏或不當之處,迎讀者批评指正。 参考来源:

• Senator Elizabeth Warren, Opening Remarks at Committee Mark

Up of the Clarity Act (https://www.banking.senate.gov/newsroom/minority/senator- warren-opening-remarks-at-committee-mark-up-of-the-clarity- act) (May 14, 2026)

• H.R.3633 Full Bill Text:EHF26374 -Digital Asset Market

Clarity Act(https://www.banking.senate.gov/imo/media/doc/ehf26374.pd f)(Senate Amendment in the Nature of a Substitute,proposed by Sen.Scott) .Chairman Tim Scott,Section-by-Section Summary(https://www.banking.senate.gov/imo/media/doc/section

• by-section.pdf) of the Digital Asset Market Clarity Act

(May 12,2026)

原始排版图​

原始导出图超过单张 WebP 的尺寸上限，以下图片按从上到下的顺序连续保存。

发布于 2026-04-25 20:48:39（微信公众号导出记录）。

本文来自公众号后台的“导出文章内容”功能。博客正文由导出长图进行本地 OCR 转写，并保留原始排版图用于逐段核对。

原文链接：查看原文

OCR 转写有效文字约 6419 字；代码、流程图和版式以文末原始排版图为准。

正文（本地 OCR 转写）​

original wex7ce EI V1ajero 2826年4月25日 20:49 日本 引言:為什磨成交量」是金融界最大的言? 在傅统交易者的知中,“故量下跌;代表賣墅沈重,「缩量积壁:代表市场平静。这是度危 的锚凳。 在金融市场的底物理学中,每一筆成交,必然到愿著一買一實,成交量在物理上永速是1:1 翘對平衡的。所的巨大红色成交量柱,不意味著寰方比買方多:,它记錄的只是「提合 引擎完成的配剥数量。 就像看著車褐現场的,無法得知是娜車超速。要预判車礼(跌),我們不能只看 (成交量),过需翌看然車痕與油門的力度—這就是**「未成交的排單(Linit Orders)**,即流動性的本質。 核心润見:市场的真正疆動力不是已登生的交易,而是尚未生但随時可能被撤回的「意

第一章:顿悟時刻一「冰攻防载比喻​

為了建立对0FI的直觉,我們引入一個**「冰攻防载**的比喻:

• 線(最新成交俱):雨重交载的中線。

• 真方防紫工事(BidDepth):多頭在戚線下方紫起的冰撞:。冰越厚(拼覃量越

大),越能阻摇格下跌、

• 寰方攻最工事(AskDepth):空显在贼综上方菜起的「冰;。

• 市價單(Taker0rders):士兵的街锋—市價页出就是控買方冰涵。

傳毓散户的盲點:只盯著「霸線(價格)和「成交量:。当價格慰、成交量低時,表面 上看起来「市場很安全1。 大資金参舆者的策略:大型参與者不需要直接派士兵去撞。要载综扇清,更有效率的做法 是一逐步把冰:一埋一现地抽走(撒單/LiquidityPulL).常買方的冰牺被抽乾 時,即便成交量苟3,一個橙小的市價真单就能硬穿防線,引驳雪崩。 OFI(訂单流失衡),就是用来度量「冰正在被加厚遗是被抽走:的量化工具。 诗刻T-1:防娘完整 晓刻T:撤甲 资100 BTC 资100 BTC

股煤:550,000 X胜望:50,000 情抛單 120 8TC 成交量=0 R-58TCA

质二 250 BTC T二8BTCA 质三3508TC T三三

第二章:OFI的理根基​

念是:金融市場不是抽象的格發现機器,而是由無数微参與者横成的系统一格不是 「被發现;的,而是「被製造的。 这個领城的關健进展:Demsetz(1968)奠定了流助性定基:GLosten&Milgrom [1985)證明了做市商的置賣俱差本置上是期“與知情交易者對:的保隙费:Lyons (1995-2001)将微觀结横實源研究系统化;Cont&de Larrard(2013)提出了0FI模 型,首次用经数學量化了訂单薄净通量到價格的衡。 知情交易者與逆向選選 理解OFI為什座有效,需要先理解一因核心概念:市場中存在知情交易者(Informed Traders) 1 L.知情交易者知道某個資即将下跌

2.他们舍在最佳買须上撤自己的買单,在最佳贡顶上增加實單​

3.這南個勤作都會镶OFI成负值​

1.做市商翻察到OFI持續为负,意到有人在截退:,於是跟追調整格​

做市商最大的恐幅是进向通援(Adverse Selection):你永通不知道對手是「無知的散户 (利测来漂):還是「知情的巨鲸(孵损来源)1。0FI提供了一個解答—如果你無法判對 手是能,那就翻察划手的罩借勤作」。道就像援克中觀察下注前的微表情,而非最終下了多少 普码。 與傅統技術分析的對比 排度 傳统技術分析 OFI微结分析 债格、成交量(滞後) 数来源 訂单薄即时快照(前瞻) 数學推薄、同行辞客输文 理输基碰 经验规律、图形形服 畸闻尺度 分籍-日级 毫秒-秒级(可向上聚合) 资訊含量 已成交的硬酸 未成交的意图

第三章:Cont-Larrard模型的数學架構​

2813 年,Rama Cont 贝 Adrien de Larrard 表了文 《Price Dynanics in a Markovian Linit Order Market》。我們只雨注**最前線(最佳買寶價,Best Bid/Ask) **的微鞭整化。

3.1變量定羲​

設t為離数時确(例如每108毫秒):

• P:t時刻的最佳買借,V:最佳買上的拼覃量

• P:t時刻的显佳寶价,V:显佳需价上的挂單德量

3.2買盤通量e的数學推薄​

買馨通量計算一1到時刻,買方防综上滞注入或流失的量。分為三個互斥状舰: e=vI(e>P+(Vv2)-Ip-VI(P<P} 逐项解析: 公式分支 账件 含羲 P>P'-1 e=+V (鞍综推 真情提高,新债位上全部是新注入的流動性 进) P=P 價格不炭,浮提化即流勐性增减,若為负+冰糟被抽 e=V-Vv e=v-v- (综僵 雕 持) P<P-

• d>d

e=-V2 (鞍综渍 茜页债上的排單全部被消派,產生巨大负通量 退)

3.3贾盤通量e與0FI​

囊盟通量同理(賣價越低代表空原越具攻擎性): <}}()+=a 0FI(訂罩流失衡)=買慰通量-賣验通量: OFI, = e2 -e OFI值 市場解镇 真盟增厚+實盤削薄-强烈看多 0FI > 0 0FI ∞ θ 員實均衡-格可能震 0FI < 0 買盤渍散+賣盤增厚-可能预示跌

3.4数值例​

時刻 t-1: P=50,000, V = 120 BTC: P°=50,010, V=80 BTC 時刻t(缴单後):P=50,.000(不),V=15BTC(减):P°=50,010 (不),V°=95BTC(增加) 由於情格均不攀,均解登第二项: e=15-120 = -105 BTC,e=95 80=+15 BTC OFI = 105 15 = 120 BTC 结输:在没有任何重大成交的情况下,訂单缝已经發出了扇消预善一買盘被抽难了105 BTC,寶盤增加了 15 BTC的聚力。

第四章:價格衡定理​

Cont-Larrard明了:在微藏時間尺度下,格助奥OFI呈近似的嫁性關係。 △P++k OFI i=

• △P:未来债格化,OFI:累精訂单流失衡

• D:市场深度(真實盤排單的平均厚度),C:常数

避推導:當莊家撤销页單,0FI成巨大的负数(分子):同時市場深度D提近小值 (分母)。分子巨大負值小分母=俱格面覃急劇放大。 當流助性枯竭(D→0)且伴隨撤單(OFI<0)時,即便资有巨大的市價砸盤,倡格 也會生刺烈的向下断(Flash Crash)。 多级OFI(MLOFI)舆加衰减 原始模型只看買賣一楼。後續研究指展為MLOFI: MLOFI 實稿上,距離成交越运的權位影据力越小,引入距超衰减權重: Weighted MLOFI, 常見衰减函敏:指数衰减w=e-、倒数衰减n=1/n、杨衰减。對BTC等高流勤 性種,前3-5權的聚合0FI通常已提供足菊定的信號。 實務建:在回测中分别計算1/3/5/18/28楼的ML0FI,比较它价到價格炭勤的解释 力,找到「甜密贴:。

第五章:0FI在加密货市場的關键地位​

加密市最是0FI的理想實验場,原因如下:

• 即時訂单薄數據:交易所WebSocketAPI即時推送每一檔爱化

• 7x24不間断交易:無收盈跳空,0FI信號速绩

• 巨鲸效惠期著:少数大户控制大量流勤性,0FI炭化更极、更可侦测

• 高频做市商活露:Bot占交易量70%+,截单行為高度规律

• 無做市務:做市商可隨時撒单,流动性蒸發更制烈

加密市場的獨特OFI信號 Spoofing(假着):排出巨大買單隧阻到手,成交前一刻撤。OFI中表现为“大正通量- 突然大负通量,成交量低」。 跨交易所退移:同一常種在 Binance的 OFI 持續為负、OKX的OFI持额為正-巨鲸在 为大规模交易做准備。 到期日效康:期货/期權到期前,做市商降低凰院撤口,OFI趣近零、深度下降。 多维度信號融合

• OFI持编為负且续上测到大量BTC流入交易所+高重信度做空信號

• 0FI持编為正且资金率為负且持逾量上升-高置信度做多信號(空顾整)

特微 停统股市 加密货警市場 做市商務 無,可隨時撒單 有法定美務 粥跌幅限制 多数有邪跌停 無限制 监管 监不足,Spoofing 横行 Spoof1ng 速法

第六章:歷史事件驗證​

2010年5月6日:道FlashCrash tineline title 281e Flash Crash 時間線 section 14:32-14:45 Waddel 6 Rced 搓售:画出75,006手 E-mini 合約 sect10n 14:45-14:46 亮绩做市商指量:買望流性被大规梗抽<hr/>DFI急剧轉负,D急剧下降 section 14:46-14:47 深度枯湿:△P=Cx[负0FI)/(橙小D)br/>道璀暴跌1,999贴 section 14:47-14:58 情值控资者进场:OFI畅正,市场反弹 OFI解:教科善级剧的流性真空引發崩。SEC/CFTC合调查告實,高频交 易商在危機時刻微回了大量買。 2022年5月:Terra/Luna崩盤 UST 脱胸零,LUNA徙60跌至9.088091. 做市商 X33 CEX 歌户 第南段(5月7-8日) 大量猪前 UST/LUNA 宽强 OF1 急剧博身

第二赌段(5月9日)​

性助售-市惯单撞上枯竭的资量 D0·情格的至下-可用情位

第三随段(5月10-13日)​

完全都出做市,OF1持境深度动负 情络端零 做市南 X ElViajeto 其他關键事件 2021年519暴跌:比特整43,000→36,060。0FI在中医公告前48小時已厕始出 预答——知情资金提前撤買鼠。 2022年FTX扇:FTT 22一1.5.在趣曼肥發推前,FTT交易对已出现0FI昊常。 FTX暂停提款後D實置上為零。 2024年8月黑色星期一:比特整65,000→49,608.日元套利平盒引狼全球凰险资產 OFI 同步轉负。 歷史事件OFI特微總结 DFI预鉴提前 键特微 事件 2016 Flash Crash 16-15 分籍 高频做市商集撤单,D→θ 24-48小時 知情者在公告前撤真 2021 519 暴跌 2022 Terra/Luna 6-12 小時 做市商率先撒出流動性,死亡螺旋 8 2022 FTX 内部人士勘售+外部微空 2024黑色星期一 12-24小時 跨市场傅染,OFI同步弱負

第七章:實载應用框架​

信號生成流程 L,接收交易所 WebSocket 訂章摊推送 2,针算每個時步的e和e

3.算 OFI=e-e​

1.计算滚動累OFI(如5分锋医口)​

5.累稿0FI0且D下降→做空;累稿0FIθ且D上升-做多;否刚馥望​

3.结合硬上數操/资金費率確後轨行​

多時間框架 時周框架 用途 100ms 覃步OFI 高频做市 1-30s 滚動10-30步 捕提网扇前兆 波段交易 1-5min 滚5-20分籍 1h 中缘方向 滚動1-4小時 Spoofing Score [OFI,] S= Volume:+ S:速超限值:巨大OFI 警化+低成交量-Spoofing疑似 Maker-Taker雙重失衡 OFI計算的是排单(Maker)端的失。结合主勐吃单(Taker)巍的Trade FLow Inbalance (TFI): TFI = Taker Buy Volume, Taker Sell Volume: 解清 信心 Maker OFI Taker TFI 极高 負(冰璐抽雕) 負(主勤实出) 冰糖撤+有人砸-强烈看空 冰播加固+有人買-强烈看多 橙高 正(冰继加固) 正(主勐買入) 正 方向矛盾 中等 負 负 正 中等 需察

一量。工程上,可合供 Binance 的gbhpokTicker 和aggTrade雨姻 WebSocket​

流同時計算。 凤险管理 L.Spoofing假信號:结合HLOFI遇通,關注深订单薄

2.數據延退:使用co-Location或專综​

3.通度提合:滚勤窗口回测,定期重新校罩​

1.端行情数擦置量:闪满赋间WebSocket可能延逗或丢包​

第八章:永續合約操的0FI逆向工程​

以下基於公開市场数和OFI理龄框架,旨在展示微觀结标分析的方法输。 这個案例将冰疆攻防、訂單流失衡、深度明場、Spoofing、資金費率榨取用聊成一国系统性通 程。 雙線場 操耀者同时操作兩個载場:

• 瞬场A(外部现货):在低流勤性现货市場左手换右手,小资金拉抬现货價格

• 场B(合約口):现货被强行拔高-指數價格上邪-吸引做空者烫入成為物

操三層結構 通透操握低流動性现货強行拔高指

第一-指数劫持:Index Price=w;×P​

数。

第二-虚假冰+轧空:在合的盈口捷出巨量虚假買单,旗0FI呈现端正值。遗些置​

單永速不會成交-—會在质惠瞬全部撤銷。同時,僵格上涨+空眼一解及维持保證金被 强平+清算引擎市價贾入→进一步推升俱格-通環爆意。

第三-閃扇收:​

• 段A:冰撒離,e≈-V1《0

• 段B:深度歸零,D→0

• 段C:△PFI,價格跳至下一可用债位,瞬間暴跌90%+

附錄:Binance接口數據對照一每個参數如何對應公式 數據源 Binance 合約@bookTickerWebSocket,每約100ms 更新: wss : //fstream.binance. com/ws/btcusdt@bookTicker JSON字段對照公式 "e":"bookTicker" "u": 408960217, "s":"BTCUSDT", "b":"25.351", //-V^b_t(員一單量) //-P^b_t(買一價格) "B":"94125.10", //-V^a_t(要-接單量) "A":"94125.20", //+P^a_t(要一價格) "T":1591097736593 JSON字段 含羲 對應公式變量 Vb "b" 買一排单量 P "B" 買一價格 va 賣一单量 "a" Pa "A" 賣一價格 不直接用於公式 用於確保数顺序 "u" 毫秒時同戳 對鹰t "T" 用雨次真實推送逐步計算0FI 推送1(時刻t-1): "b":"25.351","B":"94125.10*,"a":"18.423","A":"9412 5 .20" 推送2(時刻t,100ms後):"b":"3.120"(剧减!),“B":"94125.10",“a":"32. 800"(大增!),"A":*94125.20" 雨次推送價格均不登,發第二项: Step1-買盤通量: e=3.120-25.351=-22.231BTC→冰被抽走了 Step2-賣盤通量: e=32.800-18.423=+14.377BTC-賣方冰在加固 Step 3 - 0FI: OFI=-22.231-14.377=-36.608BTC+極端负值 Step4-深度: D≈(3.120+32.800)/2=17.960 BTC(偏低) Step5-Spoofing Score:若成交量0.5BTC,则St=36.608/0.501=73.1 →速超关值 計算結果總 婴量 数值 含羲 et

• 22.231 BTC

買盤100ms内被抽走22BTC e

• 14.377 BTC

寶盤100ms内增加14BTC OFIt

• 36.608 BTC

强烈看空信號 St

73.1​

Spoofing 疑似 (低成交) RESTAPI快照驗證 https: //fapi binance. com/fapi/v1/depth?symbol=BTCusDT&limit=5 返回 bids[θ]=[P^b_t,Vb_t],asks[0]=[P^a_t,V^a_t],更新频率-1-2s,適合 手動验證。精確計算請用WebSocket。 極端行情下的數據質量 閃崩瞬間,Web5ocket可能出現延運(100ms→500ms-2s)、丢包(u序號不連續)、 冰醬「瞬時幻影」(V=50→0→50→0的虚假序列)。應對策略:序號速續性機 查、翼常OFI通滤(|OFII/D>50時標記翼常)、時間跳跟值測。在端行情中,將 OFI信號分為可信和不確定雨级,不確定時暂停交易是更務實的遇握。 結語 OFI基於Cont&deLarrard(2013)的数學框架,將訂單薄的流動性化量化爲可計算 的凈通量。在加密货7x24、即時訂单簿、巨鲸效應顯著、做市商無羲務的市場環境中,0FI 的價值被大放大。 D→0, OFI<0 ∑OFI △P Flash Crash 这是Cont-Larrard模型的遥辑推導结。而OFI,是理解市場微戳運作的一個起點。

原始排版图​

发布于 2026-04-23 08:00:24（微信公众号导出记录）。

本文来自公众号后台的“导出文章内容”功能。博客正文由导出长图进行本地 OCR 转写，并保留原始排版图用于逐段核对。

原文链接：查看原文

OCR 转写有效文字约 8907 字；代码、流程图和版式以文末原始排版图为准。

正文（本地 OCR 转写）​

original wex7ce EI V1ajero 2826年4月23日 08:81 日本 9家交易所24份官方文件×可验證引用一本文只故能查到的束西,每一條结能都跟 著出處 驾明:本文懂狗研究用逢,不横成任何投資建。行生品交易具高周酸,請以你帐户下的實账 薏率、宵结算纪、實察流助性與凰控参数為。 目錄

一、验规​

• 二、各交易所资金营率公式身可验露数域

• 三、三层定借法模與通用计算模板

• 四、跨所公式结標深度比较

• 五、跨所持意成本通界:静患数学推源

一、驗證规​

1.只使用交易所官方来源(官方HelpCenter、官方文件、官方API 文件、官方公告)。​

?.每個關键数擦或公式都附官方速结,直接列在核交易所區境底部。

3.若官方资訊圈“勤服/分级/地显化:,不寓死單一常数。​

1.無法由官方真面直接確證者,不纳入確定事霞。​

二、各交易所资金費率公式舆可验證數據​

2.1 Binance (USD-M)​

1.資金费率是永绩市场多空之间的定期支付機制,正负或决定多空支付能。​

?. B1nance Academy 明指出 funding 由 Interest Rate + Premium Index 成。

3.预设利率為每日0.03%,拆成每8小時0.01%(每日3次)。​

1.官方 API 可查funding 墨史:GET/tap1/v1/fundingRate。​

5. 官方 API 可查 cap/floor 翼 interval: GET /fapi/v1/fundingInfo 。​

3.官方 API 可查個人交易費率:GET/fapi/vl/conmissionRate(含 maker/taker​

rate) .

https://www.binance. com/en/acadeny/articles/what -are-funding-rates-in- crypto-markets/ https://developers .binance ,con/docs/derivatives/usds -margined- futures/market -data/rest-api/Get-Funding-Rate-History https ://developers -binance con/docs/derivatives/usds-margined- futures/market -data/ rest -ap1/Get-Funding-Rate-Info https: //developers .binance , con/docs/derivatives/usds -margined- futures/account/rest-api/User-Commission-Rate

2.2 0KX(Perpetual Futures)​

L.0KX 官方明酶编出 funding 公式: F = clampP + clamp(I P, 0.05%,+0.05%), Fcap, Ffhor

0.03%​

1.利率公式:I=​

:8h例子慰度=0.01% 24 / Tsetleet

3.Premium Index 公式:​

P= Pindex

1.预设每8小時结算,部分合的可為1/2/4小時。​

5. Funding fee 算: FF =Vp × F。​

5.2025年公告题示封永编funding公式进行改版或分批上線。​

https://www, okx, com/help/perps-funding- fee-mechanism https://www.okx.com/help/funding-fees-for-perpetual-contracts- faq https://ww.okx.com/en-gb/help/okx-to-change-the-funding-rate-formula- for-perpetual-futures

2.3 Bybit(Perpetual/ Futures)​

L.Bybit 官方规则真输出 funding 公式:

十 Feazreat​

Pindex F =P + clamp(I P,0.05%, +0.05%)

2.结算时:80:80、08:00、16:08(UTC)。​

3. FF = Vpos × F.​

1.常見合的交易费基率:Maker 0.02%、Taker 0.055%(受VIP影智)。​

https://www.bybit . com/en/contract-rules https://www.bybit.com/en/help- center/art1cle/Funding-fee-calculat1on https://www.byb1t.com/en/help- center/article/Perpetual-Futures-Contract-Fees-Explained

2.4 Bitget(Perpetual Futures)​

L.Bitget 官方给出 funding 公式: F = clamp 8/N

2.一般8小时结算,部分合的可2/4小時,可按市况调整。​

3.I = 0.01%​

1. FF = Vps × F。​

5.常見基率:Maker 0.02%、Taker0.06%(依等级舆活勤炭勤)。​

https://www.bitget.com/support/articles/12560683811573

2.5 Gate(Perpetual Futures)​

L.Gate 官方给出 funding 公式: max(0, Pim Padex) max(0, Piede Pipset) Ppremium = Pindex F = P + clamp(Iisteval Pesrest 0.05%, +0.05%) Funal = clap(F, fmax, fmax)

2.预設日利率0.03%,8h 退期對度Iinteral=0.01%。​

3.8h结算時黏 08:08/ B8:B6/ 16:00UTC;另有 4h遇期市壤​

1. Fund1ng/prem1um 每 66 秒計算。​

5.交易费:TF=Vpos×mar/r​

5.2026-93-25公告明碴列出整後分级查率(如VIP0 USDT-M Taker 0.0500%)。​

https://ww.gate.com/help/futures/futures-logic/27569/funding-rate- https://wwr.gate.com/help/futures/futures-1ogic/22079 and-fund1ng https://www.gate.com/announcenents/article/50390

2.6 MEXC (Perpetual Futures)​

L.MEXC 官方教學文给出funding fee 针算: USDT-M:FF = Vp × F,Vps = Qpx × Pir Qpos × Sctrset Coin-M:FF =Vps × F,Vpxs Pixir

2.常見结算時00:00/08:08/16:86UTC,部分合的可整为4h​

3.贵率可能因活助或地显而具(不属窟死单一全域常数)。​

1.2024-91-29公告提到合的率调整(含maker/taker 活動值)。​

https://www.mexc.com/support/articles/13322295212313 https://www.mexc. com/fee https://www.mexc,com/announcements/article/mexc-Launches -lowest - fees- in- the-market-17827791513157

2.7 Deribit (Perpetual)​

1.永镖funding 以mark price 與 index 差翼為基,8 小時 funding 携制作用於​

未平盒合的。 .BTC/ETH Futures (含 Perpetual) 基潭常見 Maker 0.00%、Taker 0.05%。 https://support .deribit,com/hc/en-us/articles/31424954847133-Inverse- Perpetual https://support.deribit . com/hc/en- us/art1cles/25944746248989 -Fees

2.8 Hyperliquid​

l.Hyperliquid 官方 funding 公式: F = P + clamp(I P, 0.0005, +0.0005)

2.Funding每小時支付,8h公式折算到每小時支付1/8:​

I = 0.01%/8 = 0.00125%/h

3.Cap 為 4%/hour.​

1.Perps 分级(T1ere 基萃): Taker 0.045%、Maker 0.015%。​

https ://hyperl1qu1d. g1tbook,1o/hyperl1qu1d-docs/trad1ng/funding https://hyperliquid.gitbook,1o/hyperliquid-docs/trading/fees

2.9 dYdx (v4)​

L.dYdX 官方funding 公式(预設框架): Pindex Cprmim

• Ciates

F 8 . Impact notional 预设為 500 USDC / IMF。

3.每分链梯本、每小時收费(funding tick 预设1小時)。​

1. 8h cap 贝 IMF MMF 有酮(示例: 600% × (IMF MMF))。​

5.率探maker-taker舆38天成交量分级,可由治理斓整。​

• uo-sa1e-6upun,-1ne,#p-z669t/st4e/ua/ape xppd1au//:sdu

dydx https://help,dydx.trade/en/articles/166995- trading- fees -on-dydx 明確排除 以下项目不作固定数值结输:

1.「某交易所永通固定手續費=X%]一多数官方真面顯示分级/活動/地區差异。​

2.「未能官方史页舞立重现的国别常對端fund1ng案例:,​

3.「未附官方来源的保酸基金趣封值、跨所市估超封值:。​

三、三層定價結構與通用計算模板​

以下解精基於第二额的官方公式,将各家规则转為统一的可敦行定價框架。

3.1三定價​

永續合约的持盒成本由三唇杨成:

第一:交易寶(Maker/Taker)​

乎所有交易所都操分级意率(依VIP、38日成交量、活動或地區)。

第二眉:资金寶(Funding)​

利率加溢,经clamp/cap/floor約束,按固定通期结算。偏雕越大,支付方越可能 是推高偏解的那一例。

第三:风控参数(含俱格)​

包含funding cap/floor、结算隔、1mpact not1onal 等。影客持盒成本上限與校正 速度

3.2通用計算模板​

單次funding成本(各所共同口径): FF = Vpos × F 日化持盒成本: Caaily FF: n x Vp × F i=1 其中n為每日结算次数(8h制n=3,1h制n=24).同一名教意位下,结算率越 高,對短線資金效率越敏感。 交易回轉穗成本(用来比较“同策略跨所可行性:的核心指标): Crodtrip = (ropen + Feloe) × Vns + Cally × D + Slip augy 滑帖

四、跨所公式结構深度比较​

4.1統一架下的参数差巽​

9家交易所的funding公式都遵循同一個核心架横: P+clamp(IP,a, +a), FapF F = clamp 其中P為加權移動平均溢情指数,I為利率,α為clamp半宣度。需要注盒P拿即时 快照,而是交易所在一细结算通期内每分链探機Impact Bid/Ask镂計算的TwAP(時加 橙平均)或EMA(指數移勤平均)。各所数道环福成了不同的市场微结福: Binan Hyperli 参数 OKX Bybit Bitget Gate XPAP quid ce I

0.00125%​

%10°0

0.01%​

(8h等 /h 效) IMF %90°0千%90"0 Clamp α ±0.05% ±0.05% ±0.05% 相 Premum IndexIndex Mark Index Index Index 基准 基弹 8h/4h/ 8h/4h/2 结算频率 8h 1h 48 h/1h 2h IMF 财舰 勤照 4%/h Cap 助熊 相丽 CLamp的實际效果:當P奥I的差距落在[一a,+al范圍内時,内層clamp输出I,整個 fund1ng被「钉:在利率值上。以I=0.01%、α=0.05%為例,只要溢借在一0.04%到

0.06%之照,funding就是0.01%。这就是為什磨整行情中主流整的funding 摊孚不助​

一交易所用clamp概建了一個维標區同;,只有在偏雕足钩大時funding才闻始響匿​

4.2三個關鍵差​

1 Bybit 用Mark Price 計算premium(其鲸所用Index Price) Mark Price 本身含波平济機制,Bybit 的premium 反匯较平缓但疆定。常Bybit 奥 其他所之間存在funding利差時,Bybit蓬的熨化會有「落後效感。 2Hyperliquid 的Cap/利事比篷3200倍 Fop 4% = 3200

0.00125%​

端行情下funding可能升至正常借成本的数十倍。经計目的是快速校正偏魅、保護交易 所,但极瑞成本围险主要由持盒者承携。 3dYdX的保细金-定俱速勤 500 USDC Impact Notional = IMF 高择帮封(低IMF)的impact notional 更大,premium 针算需穿透更深訂單薄,其 funding封流勤性化也更敏感。

4.3 Interest Rate 的含定​

预設利率的年化含羲:

这是交易所設定的無恩险資金成本」—可理解為到「借USDT做多的固定定债,不随市场 浮勤: {markct<I=funding利率部分偏高,利於空頭收取 market > I= premium index 神足差额,funding 波動加劇 對比DeF1 定借利率(Aave USDT supply rate 通常 5-15%/年),I處於同一 量级但不浮勤—偏雄時存在跨市場定價差。 需要注意的是,I=0.01%是主流(BTC、ETH)的预設值,交易所舍針到特定到(如暴 涨中的Meme)手勤調高基碟利率,或继短结算間隔(徙8h改为4h/2h),以抑制单 择累稿。這频额整通常以公告形式稳布,不反映在静然公式中。

4.4结算率的含效應​

年化Interest Rate 名美上相同,但结算频率差具體现在訊鳞延退上。此外,CEX 與 DEX 在结算機制上存在根本區别:

• CEX(Binance、0KX、Bybit)探快照结算:以结算時刻(如08:00:00UTC)的持盒

默感為率。结算前1秒平意则不付本期funding,结算前1秒开意刚付满整期。持意時 周长短不影響罩次funding金额.

• DEX(HyperLiquid、dYdX)趣向高频連讀計息:HyperL1qu1d 每小時结算一次,

dYdX每小時收费且每分锌累稿。持愈時翻越短,分撒的funding越少—运在数学上更接 近速绩分而非解散快照。 faely = Tcex TDex = Sh 1h = 7h 在单遗行情欲動的 T ∈[0,8h)窑口内,Hyperliquid funding 已反映新 premium, Binancefunding仍為上一期结算值——跨所利差可能顯著振大。 跨所套利的「频率不匹配现金流: 假設在 Hyperliquid (1h)做多+ B1nance(8h)做空。前 7 小時 HyperL1qu1d 已结 算7次亚扣除 funding,而Binance 端的funding收入要到第B小時才落袋。這段期 同泽现金流為負,保證金垦力在Binance结算前最大。

五、跨所持詹成本遗界:静態數學推​

定位警明:本额探之成本模型為無摩据理想璟境下的理编計算,旨在展示跨所持意之静 馨数學逸界,未計入API延理、流動性滑贴、資金輸時间與端行情下的交易所风控干 预、所有数值均由第二前官方費率数據直接推漠,非回测结果。

5.1跨所淨收益的数學結構​

假設在交易所A做多、交易所B做空同一棵的,名差持售Vpos,持有N個结算通期: II=[Fs(t)-FA(t)]·Vpx -Co -Cdoee {=1 Capen和Celoe是殊定性的(由官方率决定),唯一的外生炭量是△F(t)—一固隨概過 程。本前先算清固定成本部分。 模型假設炭已知偏差 上述封开形式公式建立在以下理想化假设之上,這些假設在實盤中均不成立。列出它們是為 了明确本文推源的適用通界,而非作為實签建模依據:

1.静题名裁盒位假設​

公式將Vpas視為常数提取至之外,現實中Vpos(t)=Q×Pmark(t)髓標配價格 浮動。若BTC在持盒期圈波動28%,空题端的名鞋食位等比例膨,資金費超對值也随之 勤態化。格的計算需到價格轨蹄做路径依强(Path-dependent)分,本文的一近 似催在窄幅盈整期近似成立。

2.Prenium Index 的時間平滑效瘾​

第四顾的核心公式中P亚非即時值,而是退去一個结算退期内每分鐘探楼的TWAP或​

EMA.這意味著即便结算前数分鑫出现极端真賣盤偏離,最终funding也可能被前段平播 数據稀耀。封於试圈描捉“瞬時利差;的短線逻辑,这是一個不可忽略的讯赋衰减层—我們 目前尚未封其进行定量建模。

3.保證金消耗與植择漂移​

資金费直接徙可用保證金扣除。持續支付funding的一端,保超金餘翘逐步下降,實察植 棵倍数被财升高。这种「慢速泄整:在模型中完全不可見,但在桶端行情下可能使强平综提 前解發——即保證金消耗衍生出的非線性尾部周隙。本文的線性模型無法捕提这一效愿。

4.跨所行的 Legging Risk​

Crouarip假設南端同时同情成交。現實中API 通訊存在毫秒至秒磁延逻(尤其CEX奥 键上DEX之),一端成交、另一握未成交的窦口内,持食虚於單遗数口状照。道部分成 本奥市漫波勤本正相,本質上是一固随概曼量,需要揭立的執行模型来刻重。 以上四點是本文理输框架與實琅境之间最顯著的结福性落差。若有贵釜量化經疆的者顾 意補充更多偏差项,迎交流。

5.2回轉成本的封開形式推導​

定義回轉費率Rroundtrip 舆回轉成本Croundtrip: Croundtrip = Rroundtrip ·Vpos Rroundtrip = Tij Fe,fs {op do]f {} {asopo ado}≥{g') 每一個ri都来自第二的官方費率数據: 情境一:BTC,Taker,雨端(取Bybit0.055%+Bitget0.06%) 项目 A所(Taker) B所(Taker)

0.055%​

0.115%​

0.06%​

開食

0.055%​

0.06%​

0.115%​

平詹 Rroundtrip 0.23% 回轉費率 情境二:BTC,Maker,雨端(取Deribit0.00%到Bybit0.02%的中位数) 项目 小計 A所(Maker) B所(Maker) ≈0.01% ≈0.01%

0.02%​

開詹 ≈0.01% ≈0.01% 平詹

0.02%​

Rroundtrip ≈ 0.04% 回轉費率

5.3损益平衡的必要條件​

定義捐益平衡所需的结算期数: Croundtrip Rroundtrip NBE = F.Vpos 业 F 回韩冀率 Rroundtrip NBE 损益平衡天数 情境 /期(假設)

0.01%​

4期 ≈0.04% BTC,Maker, 8h

1.3天​

0.01%​

0.23%​

23期 BTC, Taker, 8h

7.7天​

0.003%​

0.04%​

13期

0.5天​

BTC, Maker, 1h 解讀:Taker回轉成本是Maker的≈5.75倍,来自官方費率,與行情無阔。Taker 需利差持續至少7.7天才能损益平衡,Maker只需1.3天-執行方式直接决定時間門 槛。

5.4六層摩擦的数學表達​

理模型與實際之同的差可分解為六個確定性或随機性的摩擦填: Cmargin Rbasis Cops Ilactual = Itheoretical - Slip — OF.VN 跨所價差 Funding 波動 誉通成本 滑點 資金销定成本 摩擦项 数学性質 来源 级 手續费 確定性,由官方費率決定

第二節各所数據​

1 非官方数據,需自行測 滑贴Slip 隨機,與訂单薄深度正相 2 量 非官方数據,需歷史統 Funding 波動OF 隨機,均值回歸過程 3 確定性, 资金额定Cmargin 機會成本 4 =Vpos/Leverage × ropp Basis Risk 非官方数據,需歷史统 随機,尾部分怖 5 Rbasis 管通成本Cops 工程測量 6 確定性(API限速、gasfee) 第2、3、5唇是不可官方文件推導的随機项一理遗界與實盤之間的真正落差。把確定性部 分算清,可以識到不確定性集中在哪理。 此外,實盤環境下的端尾部凰—如穩定脱導致的跨所價差(StablecoinBasis)、 單逸獲利食位遭交易所ADL自動减詹、以及大资金部位面臨的梯保證金衰减效應一-均不在本 基碰模型的探圈内。

5.5結算频率不匹配的現金流結構​

第四節的結算類率差具在数学上表現為:​

[T/TDex] [T/Tcex] FcEx(i)·V FDEx(k)·V Net Cash Flow(T) = k=0 j=0 在T∈(0,8h)窗口内,[T/TcEx」=0而[T/TDEx」≤7.這意味著:

• 如果DEX端是支付方(funding正),前7小時會持流出現金,保證金墅力單向累

精。

• 如果DEX端是收取方(funding負),前7小時會持續流入現金,但CEX端的保證金

不會同步增加。 这是频率不匹配的確定性结一只要持危跨越结算窗口,它就一定存在。 本文至此。第二是原始规格,第三是统一框架,第四是参数比较,第五前是成本逸界。 所有数據均附官方出處,款迎交流指正。 修改于2026年4月23日

原始排版图​

发布于 2026-04-19 03:49:16（微信公众号导出记录）。

本文来自公众号后台的“导出文章内容”功能。博客正文由导出长图进行本地 OCR 转写，并保留原始排版图用于逐段核对。

原文链接：查看原文

OCR 转写有效文字约 11653 字；代码、流程图和版式以文末原始排版图为准。

正文（本地 OCR 转写）​

前言 2026年4月中旬,加密货带市场上演了一場教科學级别的血醒收副——$RAVE代需在短時 間内翘歷了無量暴涨、疯狂通空、脂梯式废盟、最近乎解零的完整远期。無数散户在源的 FOMO情鳍驱使下街进場,又被速環爆會的死亡螺旋瞬圈吞噬。截止至4月19日凌晨三点跌幅接 近96%,

0054

這不是一個孤立事件,而是高度控盤山赛常反覆上演的棵劇本。所以就有了如下個圈 vOx7oe 12:30:55 RAVEUSDT永排

• 61.21%

RAVEUSDT永境

• 59.34%

FUTURES

RAVEUSDT永境 IL I 4s

• 65.84%

FUTURES

RAVEUSDT 永墙

• 63.77%

ecT FUTURES

RAVEUSDT永棚

• 9.75%

FUTURES 要真正看透類“恶意通空(ShortSqueeze)和“高度控盘:的金融收割機,我 們必须脱離单规的K综国,進入微觀市增结横(MicrostructuralMarket Theory)奥量化金融的领域。 赶家的操壁亚非單纯的拉盟;,而是一場經退精密計算的流勤性操奥衍生品套利。我們可 以用多他核心的数學與經清学模型,来微底拆解這套將散户生吞活制的皎肉機遥朝」。 本文将以RAVE事件實例背景,按照上涨(逼空)-扇盤(瞬間麟零)-梯式下跌+暴 跌後的残局(二次拉升的死亡阻力)+模型的局限的完整辑修,眉屠逐进地剖析整個返程,

第一章:上涨邂辑一莊家如何用精密計算將散户生吞活剥​

模型一:流動性枯竭與價格衡模型(Kyle'sMarketImpactModel) 疑家能用少的資金把價格拉上天,核心在於**「控制流通量**,在量化金融中,我們通常 使用Kyle(1985)的情格衡整模型来解訂单到市场格的影喜力。 在一個正常的市场中,僵格的變動可以化為以下公式: P=入·Q △P:資慶情格的密動幅度。

• Q:買入或實出的訂率数量。

• 入(KyLe'sLambda):市增流動性深度参数的倒数,代表**“市場非流動性

(Illiquidity),**。流勤性越差,入值越大。 莊家的操作: 旺家會在随上將代需轉出交易所(提),或者在現货验口掉所有的賣軍,道會導致交易所内 的现貨深度(Depth)急下降,使得入→OC。 在这種極端的非流動性狀下,硬怕莊家只用非常小的资金量Q(例如美金)去市 入,乘以超近於無限大的入,也曾生其履大的△P(例如瞬周拉升56%)。道就是為什 塞你會看到遗频代常的K缘常常出现抵量暴涨。 模型二:资金費率的吸血模型(FundingRate BLeedModeL) 永绩合的(PerpetualFutures)的核心機制是翼金囊率(Funding Rate),是旺家在 不寰出现背的情况下,持编抽取散户血液的“抽水機」。 资金费率R的核心针算基於合的價格现貨指数格的溢(Premium):

• I,Rmi,Rm

R = Clamp Pspot P 永额合的的偏格

• Pept:现货指数價格。

• I:基萍利率(通需很小,可忽略)。

• CLamp:交易所設定的貢率上下限(例如最高2%或-2%)。

驻家的操作: 散户看到情格暴涨,狂在合约市場開空單(Short)時,魔大的空显實盛基低合約價格, 增致Pxr<Pext。此時溢價為負,資金費率Ry量成端的負值(例如每4小時

• 2. .

這意味著,空跟必须向多显支付高昂的持盒費。 BINANCE [Binance] USDS-M Futures Funding FeeNotification Dear Binancian, oe s a ug no u uood tianrking@gmail.com) wll be charged afunding fee at 2026-04-14 17:00:00(UTC+0). The expected funding rate is -2.000%, and you wil be charged a fee of 2.87161247 USDT. Important to know : If you wish to avoic the funding fee, you can close your position anytime before the funding is applied. If youhave closed your posilion and received a notification, please ignore the notification. Visit Futures Account dsesr pu pue mdn pasa aseeld oe sa ezuoo lu immediately. This is an automated message, please do not reply.

X4 家作為最大的多跟(持有現貨的同時,可能也在合的用低倍多单),其每一期收取的資金費收 益C為: T (IQshr|·Ppery,t-|R,|) =1 只要散户的空显合的量|Qshor大,姓家每天光是收「遇路费:就能產生数百薰美金的無 凰险现金流。这就是亚家!看起来不贡常也能睡翻;的数学真相。 模型三:强制平食的連環踩踏效雁(LiquidationCascadeFunction) 這是退空行情中最血醒的一琅,也就是俗稠的“爆盒:。合的交易带有择,常情格上混到一定 程度時,交易所的引擎言强制接管敬户的空单市價買入平意, 到於一個在價格P开空單、横样率為L、持保遭金率為MfMR的户,其爆意價格 (L1qu1dat1on Pr1ce) Pq 为: × = MMR 連理踩路的微分方程: 當莊家將倡格推升至P:=P時,交易所系统曾自動向市场砸人一图市偏页單Qforcrd 结合我們前面的【模型一】,这個被迫的買单含立刻導致俱格进一步上涨: Pr+1= P +入-Qf(P) 运產生了一图致命的正反鳞通圈(Positive FeedbackLoop): 偏格上涨→A的爆意單→系统市偏贯入→倡格进一步上涨→解整更高位B的燥愈單→ 系统再次市债费入。 在數學上,這是一個發散的指敏函数。此時的行情已經不需要旺家花一分去拉壁,散户空頭的 爆逾單(强制盤)就成了推動借格火箭升空的無限燃料。 模型四:崩盤的博弈局(Prisoner'sDilemmainMarket Making) 最後,我們用博奔涂(Gane Theory)中的**囚徒困境(Prisoner's Dilenma)**来解 释,為什度遗種常的顶部提束不是耀慢回落,而是取间的“断崖式解等」。 假設操盛聊盟中有雨個主要莊家(大户A舆大户B),他們共同持有绍大多数的現貨。在高位 時,他們面脂两種逼捶:续護盤(HoLd)或砸套现(SeLL)。 其收益矩(Payoff Matrix)如下: 大户B:砸套现(SelL) 大户B:續曦(HoLd)大 A号零,B富(-50,16 大户A:護(Hol斐方继續撑资金费(10,1 d) 0) 0) 大户A:硬盤塞現(SelA暴富,B歸零(16B,-5方5踪路,少曦(20,2 L) 0) 在现货格桶应虚高、底下完全没有真實買盤(流動性桶差)的情况下,谁先宣,进就能把懂存 的一點黏現货買單(Exit Liquidity)吃掉换成真金白銀USDT。 根納什均衡(Nash EquiLibrium),债管雙方都继續摄显(Hold,Hold)能撰得长期的 资金費收益,但由於無法保證對方不背叛,「砸盤套现(Sel1)成為了雙方的格侵势策略 (Strictly Dominant Strategy)。 因此,在利益的划助下,聯盟内部的信任极其脆弱。只要價格谨到某個心理醒界點,或者有 任何凤吹草動,一定有一個家逻择绝跑(Front-runn1ng).第一肇天量砸盈单出 现時,入(流勤性倒数)同样會反向捶作用—杨少的抛聚就能债格膜圈跌穿96%。这就是 為什摩前显翘是裂生在一眼間。

第二章:下跌避辑一為什崩盤總是瞬間歸零​

很多敌户在看時他差生一個致命的端景:『它現在價格是100美金,就算跌,也會握通

90、86、70,慢慢跌下来吧?但现實中,高度控验的代带一旦离慰,K综往往是一根没有​

任何反弹的垂直「断頭翻」,直接徙106硬到1甚至0.0001。這種现象在李業金融领域被 瑞為流助性真空(Liquidity Vacuum)或閃端(FLash Crash), 要理解為什度價格「瞬同绍零,而不是「慢慢下跌」,我們需要循底抛案K線图,深人到交 易引肇最底唇的訂单薄(OrderBook)微结横中去。 以下是導致倡格瞬阻零的四大深唇楼制:

第一節:流勤性真空舆瞬周崩场的四大機制​

1.價格的全息覺與流動性真空(TheILlusionofPrice&​

Liquidity Vacuum) 我們首先要链立一個最基提的金融常:盤面上的「當前俱格」,谨催代表最後一肇交易的成 交俱!,它组到不代表整困整子的俱值。 支按借格的,不是市值,而是訂單薄理的“限倡買單(Bids)。

• 正常的市場(如比特):169美金到90美金之同,密密麻麻排著成千上离固買单。你

砸盤,需要大的资金才能把遗些員單全部吃掉,这叫「深度好。

• 控蟹的山赛(流勤性真空):旺家拉验到180美金後,其實下方根本波有散户接盈。訂

单第可能是这梯的: ■99美金:有10回黄單

• 95美金:有5個買單

• 94美金到2美金之同:9個員单(这就是流助性真空)

• 1美金:有1098個買单(散户排著玩的低债抄底單)

富旺家决定出货,直接丢出一個「市價賣出169四常:的指令時,交易引擎舍怎魔做? 它會間吃掉99美金和95美金的15員单,此時賣单遗没成交完(遗剩85個)。因 為中間没有任何黄单,引肇宙直接跳遇94到2美金的所有僵格,直接链向1美金的真覃去 成交 在敬户眼理,这一秒迎發生的事情就是:俱格偿95美金脚同成了1美金。中間完全没有缓 面,因為中周根本没有綫。

2.做市商的拔網線自保(MarketMakerWithdrawal/​

Spoofing) 在孚时,為了然面看起来活醒,莊家或做市商(MarketMaker)的機器人會在各借位上 大量虚假的買单和实單(这叫提供流勤性)。 但是,这些機器人非常明且冷血。它們的算法裡有一個硬性條件:一旦機测到市場出现单遗巨 量抛墨(比如主力家明始砸盤),或者波勤率(VolatiLity)突破值,模器人音在毫秒级 别内撤銷所有的真單。 这就好比你站在100楼,楼下本来销满了数生氯垫(做市商買單)。你刚跳下去的一瞬間,底 下的人把氯垫全部抽走了。你只能重重地砸在1的水泥地上。这也是為什度前题登生時,速 微小的反弹都没有。

3.滑點舆面财富的减(Slippage andWealthAnnihilation)​

我們可以用**滑點(SLippage)**的數學模型来解释财富是如何「空系:的。滑黏是指你 预期的需出價格與實察成交情格之闻的差值。 在流勤性枯竭時,市價賣出的平均成交價P可以用以下商化公式表逵: i=1(P; × V;) P= Viotal (其中P:是限價置單價格,V:是鼓價格的排單量,Vtcta是你的您售量) 需鞋家持有10,088低整,展面價格为106美金时,面财富看似是100萬美金。 但如果底下的置單极其稀薄(例如上述的流動性真空),遍10,080個繁的實際加權成交均 可能只有2美金。亚家最终套现的只有2高美金,而剩下的98勇美金「市值;,不是被 膳走了,而是因為没有真實瓷金承接,直接在数学面上涯減了。

4.横悍清算瀑布(LiquidationCascade)​

结合我們之前提到的合的市場。當家的一董大賣单把價格征109砸到56時,言觸發大量 在高位(比如88、96)用多單(Long)的数户爆盒。 多罩爆盒的本置,就是系统强制**「市债宽出」“*。 於是,莊家的馨引了敬户多單的強制囊出,這些强制賣出單再次砸向已经有買單的訂單 薄,把债格砸到26,道文解發了50抄底的多单爆意.形成了一個死亡螺旋,直到惯格磁到 9,所有的模保被微底清零。 流勤性真空小结: 價格微108跌到1,不塞要99美金的抛区,只需要中間的99美金度有任何人員。 在這些毫無基本面支搏的資金礼,高品的價格就像是恶在离丈深潮上方的一薄纸。只要莊家 酸破這低,或者做市商撤走垫到的砖頭,格就會完全遵徙自由落禮定律,在一秒鐘内回歸它

第二節:隋梯式下跌的微觀機制一—為何不是直線歸零而是台隋式」​

崩塌 你觀察到的遗個现象非常敏。在其惨烈的崩壁中,面少呈現完美的垂直直银,而是表现 出**「腊梯式下跌:(Sta1r-step Drop)**,每跌破一個数期口(比如徙15跌到

14),格就會在那国位置停额、横器基至小幅反弹分锌,然後再缩砸盤。​

运理現象在金融微鞭结(Market Microstructure)中有着非常清晰的物理和博奔退辑, 主要由以下四個概制共同造成,每個概制都有其對感的数学刻量:

1.訂單簿的整数關口阻力:心理價位的買單聚集​

在限價订單(Limit Order Book)上,敲户和部分機構有着天然的整数偏好(Round- nunberBias)

四價格在​

15.50時,很多試圈抄底(接飛刀)的人曹把限價買单卧在15.08、$14.08這種​

整数心理购口。常價格硬到这些位置時,做空者和抛售者的市價實單(MarketSells)撞上了 遗堵限债員章湛」。 横整的本置:賣方需要时同把这些卦在整数鼠口的買单全部「吃掉:。這展分鐘的横盟,其實 就是多空暨方在特定情位癌狂换手的消耗融。一旦置單被消耗殆盘,偏格就會职物滑落到下一 信真空區。 数學刻壹-—訂单薄密度聚集模型: 我們可以将盈额闻口附近的買单密度用高斯核函数叠加来刻盖。假设p為價格,整数開口為 (k∈Z),则整数雨口虚的真覃密度函数爲: V (p-k)2

• d=(d)a

exp 10√2π

• Po:基提汀单密度(非整数價位的稀疏買单)。

• V:挂在整數價位附近的買单继量。

• :敬户“整数偏好,的心理集中度。0,越小,買单越集中在整數位。

價格p→k時,D(p)出现峰值,形成一堵買单.真方必须消耗時间△来消化 這些置单: V 其中R寶方的抛售速率。這图△t就是你飘察到的“每跌一美元就横盤分缝的数 学本質。

2.空頭獲利了结(ShortCovering):反向的買盤力量​

很多人忽略了一個基本的交易常递:平掉空单,實藤上就是一次買入(BuytoCover)。 當那些在20高位做空的資金看到價格跌到10或$15時,他們需要落袋為安。為了 平意,他們必须在市场上页入。这種由空摸利了结带来的巨量買慰,言在短時間内和恐候抛售 的實盤形成到冲,而强行拉平價格,造成囊分的局部横盟。 数季刻壹--空眼平盒的累精概率模型: 假段空眼的期盒均僵益P时,常前震格益1。空额通捶平盒的概率随着浮盈增加而上升,可 以用正患分怖的累分怖函数(CDF)来刻量: Vue(P) = Vshrt Φ profit msfoud

• Vhort:空照持查量。

• 重(-):标弹正鹅分怖的累精分怖函数。

• rofe:空酮的「获利了结容忍度;—浮盈多大時细向於平意。

當俱格每下跌一美元,都曾有一批空跟逼到其平意值,至生突發的页签服街。这個街暂時托 消了賣要,形成了短暂的價格平台。

3.爆詹層的冷區舆霍克斯過程的衰减​

我們在前面提到的“速環爆意踩踏;(崔克斯過程),它的能量放是一波一波的。 营價格段間跌破15時,發了15附近所有的多单止捐和爆愈單,導致價格眼間砸到

14.20。但是在14.28到$14.08之闻,可能暂时有新的爆逾罩被解。​

市場在這個時候虚於“能量耗毒:的真空期必须等巍分罐,镶盤面上的敬户產生新的恐慌,或 者等價格缓慢摩擦到$14.09,才舍解發下一输的通爆售。这频分經的横,就是雨波踩踏事 件之間的冷期 数票刻查--霍克斯遇程的冷都時而横型: 回颜霍克斯通程的條件强度图数: A(t) =μ + aef(x) 在上一波爆愈事件(發生在t;)之线,自激项(xe-(t-t)髓時開指数衰减。营事件强度衰减 至接近基水平μ时,市爆进入冷额期。我们可以定辨冷部時圈△fcoo: tox ln

• Nigr:上一波爆意中需的事件数量。

• β:恐慌衰流速率。

遍個△t精確地刻量了雨波爆意之同的横蟹窗口;。你看到的機分鐘横,就是霍克斯 通程在等待下一波自激项被重新黏燃的数學空窗期。

4.高频做市商(MM)的重新定價暂停​

在桶端單通下跌中,提供流勤性的高频微市商機器人承携着巨大的险,當债格登生剧烈跳水 (比如一分内跌了一美元),做市商的风控算法會被解發。 此時,算法會暂时撤掉所有買单(即前面提到的流動性抽乾),或者大幅拉開買賣价差。经過 分锋的計算,重新辞估了常前的市場波動率(Volatility)和自身数口後,做市商才會重新在 新的價格區同铺設訂單。在道费分經的機器凰控重敏:时間程,显面往往舍陷入僵添的横。 数票刻查--AvelLaneda-Stoikov做市商最侵價差横型: 在高频做市的核心模型(Avellaneda&Sto1kav,2868)中,做市商的最侵报价取决於当 前波勤率和刻時: 82=o2(T-t)+n(1+)

• s:显優贾富偏差(Bid-Ask Spread)。

:做市商的凰险紧系数。

• 0:常前市场波慰率。

• T一t:距雕清算的剩除時間。

• K:訂单流强度必数。

關推:盈導致浪勤率T增時,最侵差8急制接大。做市商的算法會眼間 捧原有轻价,进入“凰控重欲,状然。此時的整面表现為: 1 →0 波勤率越高,流助性越趣近於零。做市商需要等待0回落至可接受水平後才合重新報價,道 段等待時间就是蟹面上的「僵滞模题」。 曙梯式下跌小喆: 你看到的「每跌一美元就概验频分證:,實原上是**抛墅在晴食多顾防線(翌敏買單D(p) )、空頭在分批结账(平盒黄盟Vonr(p))、爆盒能量在衰试冷(霍克斯△tr)、做市 商在量新定偏(AS模型s”摘张)**的综合表现 逼種陪梯获的下跌往往比直下跌更可怕,因為它善不給人一程跌到底了,支罐住了,的錯 觉,赫骗新的抄底資金进場,然後再次将其较段。每一段横盛都不是「止跌」,而是下一波事跌 的能量蓄精。

第三節:崩盤的数學刻一三唇量化模型​

试固用旅谨的数学模型来量化和刻蛋行情的前器,是票業量化交易(Quantitative Trading)和金融工程的核心。对於短期暴涤後跌、带有橙强「泡沫破裂:和「流勤性枯竭」 特微的极端下跌,传统的综性或常慰分怖模型(如触单的正慰分饰随楼走)是完全失效的。 為了確刻壶這種下跌,金融数學中通常會操用以下三回磨次的模型,提宏飘泡沫破裂到微额躁 蹈爆愈来遗原崩蟹的物理和数學透程:

1.泡沫破裂的宏预警:数遇期寡律奇點模型(LPPLS)​

LPPLS(Log-Periodic Power Law Singularity)棱型由物理學家和金融學家 Didier Sornette提出,是目前刻量泡沫精聚到限亚最终崩盘;最经典的数學模型。它將市场的 病狂視為一植物理学上的·區界相翼」,元美契合了添後歸零的走药。 其核心方程用於凝合資叠情格的自然数 In(P(t)): In(P(t) = A + B(tc t)* + C(te t)" cos(wln(tc t) + Φ)

• t。(CriticalTime):脂界时,即模型预测的删盤發生的数票奇贴。

• A,B,C:常数参数,分则代表内在借值、泡沫增長率和波動幅度。

• mm(0<m<1):幕律指数,刻壶价格癌近蕴界贴t時的超指数增長(即暴涨

段)。

• w:刻量價格在榴近前显時,陪著情绪波勤產生的到数退期性震频率。

刻查下跌的意羲:時間越接近t。時,市场的正反髓(FOMO情)逐到限,系统 得其弱。一旦越透t,方程的凝合機制磨清,格將壁生虚式的「相:下跌。

2.突發性崖下跌:默顿跳蹈-散模型(Jump-DiffusionModel)​

在標华的期權定價和資塞路徨模摄中,格通常被假設為速波勤的(频何布朗连動)。但盤 通需伴隨著“向下插針:或「跳空缺口。Merton跳屋-摘敲模型在速绩浓動中加入了一個泊 松通程(Poisson Process)来刻墨这種突發易致。 資至價格S的德分方程益: dS, NP(-x)+po+p(-)= S

• μdt+odW:棵萃的何布朗谨動部分(漂移率μ和布明谨融的波助率odW),刻

量平時的震湿陷跌

• dN:泊松遗程,表示在時間dt内是否發生「践露;(即突發崩显)。生概率為入dt

• (Y一1):刻声跳蹈的幅度。在暴跌模型中,Y通常服微對数正慰分饰,且其均值速小龄

1(意味著一旦登生跳显,僵格将按百分比剧烈缩水)。 刻壹下跌的意羲:完美描述了旺家突然撤買單或大户集中挞售時,盤面出现的無流助性自由 落體。 落帽。

3.微觀踩踏舆速環爆詹:霍克斯過程(HawkesProcess)​

當價格跌破某個厕键支撑位(例如某回重要的整数厕口)時,舍解發大量多显的止捐單和標多 单的强制平盒(Liquidation)。遗種「真单引發價格下跌→價格下跌熊浆更多賣单:的踩 踏现象,在数学上被祸為自激贴透程(Self-Exciting Point Process)。 崔克斯退程的條件强度函数(即短时周内賣单發生的概率密度)表示為: A(t) =μ+ae-(r-t) t

• 入(t):時刻t登生抛售事件的概率强度。

• μ:基强窟(正常的市場實盤)。

• (自激项):核心部分。遇去每一国抛售事件(登生在t;)部窄使常前t時刻慰生新

抛售的概率激增。

• α:每次暴跌带来的「恐优傅染;強度。

• e-(t-1):指数衰减函敏,要示形优情鳍隨時间推移逐渐减弱的透度。

刻壹下跌的意羲:如果你看到签面上出现一秒经内價格速媚跌破数個整数厕口(還恐爆意), 這就是α值高時的霍克斯退程在現實中的映射。 扇馨数学填型小结: 真正的绍零暴跌亚不是一條商單的向下斜線,而是由LPPLS模型预测的宏情鳍崩渍一→跳

• 摘散模型刻查的流勤性断裂一霍克斯遇程腦勤的微额連環爆盒共同组成的辨数学過

程。

第三章:暴跌後的局一為什磨二次拉升乎不可能​

要在量化金融中確刻毒暴跌後拉桶其因難(套牢馨阻力):运一现象,我們需要引入**微 觀市場插概(MicrostructuralMarketTheory)和行為金融學(Behavioral F1nance)**的交叉模型。 這因遇程本置上是在計算:將格徙P推升至P1所需要消耗的真實資本量。 以下是三個事案的数學模型,厚层退进地刻壶运图“死亡阻力1。 模型一:訂單簿瓷本消耗积分模型(CapitalConsumptionIntegral Model) 要拉升價格,亚家必须用真金白银買下訂單落(0rderBook)上所有的限價賣單。我們可以用 定精分来精班計算拉疆成本。 假设p為镇格,p(p)為倡格p處的囊軍密度函数(即格排了多少因陷的囊軍)。將價格起 始P拉升到目棵情P所需消耗的资本C為: p·p(p)d C=

1.场景A:新拉升(無套牢壁)​

到於一個新帮(或第一次暴力拉升),上方是“真空:的。真单密度催谨是做市商排的幢少数流 脑性 Pe- L Cnrr= ↓ Pa 由龄Po捶小,拉盤成本m非常低,莊家可以轻易拉飛。

2.場景B:暴跌後二次拉升(海量套牢盤)​

解歷遇暴跌後,訂單筛的结槽生了臂。离單密度不再是平滑的Pp,而是加上了愿史遗留的 「套牢盟抛里;S(p)。 fP p-[po+ S(p)]dp =Cnex + Ccrashcd = p·S(p)dp / P 這理的∫p-S(p)dp就是莊家必须翻外支付的「天價解亡费1。由龄S(p)在歷史高位极 其廠大,Ccraxhed往往是Ccr的十倍甚至百倍。道就是為什度莊家率额登新能,也不顾去 吃道固精分。 模型二:前景理输與抛整分怖函数(ProspectTheory&SeLL Pressure Distribution) 那座,食牢盤函数S(p)具赠長什塞楼?為什密散户一解套就富碰起? 根行為全融學中的前景理始(ProspectTheory)和處置效康(Disposition Effect),敬户對回本的效用敏感度還速大於「盈利;。常價格接近他們的建意成本 Pcntry時,他竹贵出平愈的数率言呈指敏级萄升。 我們可以用以建盒赁Peetry為均值的高斯分饰(正慰分怖)来刻盖某他歷史高位套牢资金的抛 (p Petry.c)2 S(p)=> exp a√2π 2o2

• V:在恩史格Pentry;成成交被套牢的细资金量。

• :散户心理预期的方差(容忍度)。价格越接近成本線,勘墅越集中。

数季推演结果: 需鞋家向上拉整,管前情格p→Pentry 時,指数项exp(0)→1,S(p)速到峰值。這意 味著價格每靠近一個歷史密集成交區,莊家就會迎顾撞上一堵由数学公式注定的捌垦高;。 模型三:非對耦流勤性的動態Kyle模型(AsymmetricDynamic Kyle's Model) 我们把上述原理带入到續格街擎的經典模型中。在之前提到的Kyle模型中,债格婴勤 △P=入·Q(入是流融性制数,Q是莊家真入省金)。 在暴跌後的残局程,入整成了一伍度非對稠的勤感分段函数: X(P, direction) if direction = DOWN (班盤)

• 向上拉璧(UP):分母中加上了巨大的套牢显S(P+).導致拉的入up→0.这意味著

莊家投入天量資金Q,价格△P也展乎敏缘不勤(被套牢型全部吸收)。

• 向下链盤(DOWN):下方毫無支搏,分母只有橙小的基碟流动性Ibasc,致入dmm橙

大、极少的撇聲就能接僵格照缩深跌。 暴跌後綫局小结: 通過这三個数學模型的推演,结输非常冷酷:暴跌後的K線图,在學本質上是一個「向上的 引力無限大(套牢阻力),向下的支撑無限小(流勤性真空)的非對空限。任何理性的量 化算法和操盤手在計算完{p·S(p)dp的成本雀,都會直接放囊二次逼空;的剧本。

第四章:模型的局限一数之外的三個致命現實量​

坦證地设:谨靠数学填型能否100%潭確地预测和遗原整個扇整遇程?或没有。 金融工程界有一句至理名言,出自统計學家需治·再克斯(GeorgeBox):「所有模型都是 的,但有些是有用的(All models are wrong, but some are useful)。」 前面提到的多個模型(LPPLS、跳散、霍克斯過程等)就像是物理學中的「理想狀態方 程」,它們極其精地刻尽了崩盤的宏觀骨架和動力學機制。但在真實的加密貨市場(尤其是 高控盤山寨)中,要想「全部且對確」地遗原整個崩盤的血肉,這些純粹的数學物理模型 遗缺少了三個最致命的現實量:

1.單薄維度:做市商撤單與流勤性真空​

数學模型通常假設市場總是有對手盤的,價格是連續或半連續波動的。但在真實的「歸零」過程 中,最可怕的是流勤性瞬間抽乾。 當恐慌達到點時,做市商(MarketMaker)為了自保,會瞬間撤銷訂單簿(OrderBook) 上所有的買單。此時,買賣價差(Bid-AskSpread)會發生極端的巽燮:

• v=s

其中PA是最優賣價,PB是最優買價。在正常市場中St極小;但在崩盤瞬間,最優買 價 PB可能直接跳水到零點美分。此時盤面出現「買盤真空」,任何市價賣單(Market Sell)都會導致價格無視任何支撑位,像自由落體一樣直接砸穿底部。這需要結合**限價訂單 薄動力學(LoBDynamics)**才能完整刻盖。

2.博弈度:莊家控盤舆虚假交易(Spoofing/WashTrading)​

数學模型假設市場参與者然瘋狂,但行為是遵循統計规律的。然而,高控盤山寨的崩盤,背 後往往是高度中心化的人為操。

• 多反毅:莊家可能會在下跌過程中突然在下方出巨量買單(Spoofing),散户(甚

至量化模型)误以為有「强支撑」而進場抄底,随後莊家瞬間撤單,反手將自己的等碼砸給 這些散户。

• 這種行為超出了隨機過程的畴,進入了**非合作博弈(Non-cooperativeGame

Theory)**的领域。數學模型無法预測莊家按動「核按钮」的具體心理時刻。

3.底層機制度:代經濟學舆「拔網線」(RugPuLL)​

價格序列模型只看盤面數據,但很多山寨的歸零是「降維打墅」。 如果填目方突然解鎖了天量代直接砸盤,或者智能合約被黑客利用增發,這種瞬間的「通式 歸零」完全獨立於市場的交易情。任何基於歷史價格推導出的時間序列模型,在對的等碼增 發面前都是失效的。 總結 我們現有的数學模型,能完美刻盖散户的食婪(泡沫期)、恐慌(跳期)和踩踏(連環爆詹 期)。但這只是硬的一面。要真正100%准確地刻尽全過程,需要將統計學模型與微觀訂單 流(OrderFlow)以及莊家博弈矩陣結合起来,這是一個極度複雜的多維系統工程。 在這些毫無基本面支撑的資金盤裡,高昂的價格來不是價值的體現,而是流動性操的幻象。 Kyle模型的流動性枯竭、資金費率的持續吸血、連環爆詹的正反迥圈、囚徒困境的必然 背叛,到流動性真空的瞬間崩塌、LPPLS的宏觀泡沫破裂、霍克斯过程的微觀踩踏,再到暴跌 後套牢盤的數學阻力一-每一個環節都是精密計算的結果。 理解這些底層邂辑,不是為了在下一個資金盤中「勝莊家」,而是為了你骨子裡明白:在 這個游裡,散户一開始就不是玩家,而是燃料。

原始排版图​

原始导出图超过单张 WebP 的尺寸上限，以下图片按从上到下的顺序连续保存。

发布于 2026-04-16 00:01:00（微信公众号导出记录）。

本文来自公众号后台的“导出文章内容”功能。博客正文由导出长图进行本地 OCR 转写，并保留原始排版图用于逐段核对。

原文链接：查看原文

OCR 转写有效文字约 6401 字；代码、流程图和版式以文末原始排版图为准。

正文（本地 OCR 转写）​

XML模板) wex7ce EI V1ajero 2826年4月16日 86:81 日本 本文記祭了 AI Agent(Claude)通遇Lark-cl1 操作飛害幻燈片的完整實测程。幻 增片通透XML格式定差真面内容,支援文本、矩形、線保、表格、固表等元素。每一個命 令都在同服器上青际行退。 工具: Claude Code + lark-cl1 v1.9.9 核心思路和之前的文檔、表格一楼:Agent直接調用lark-cli命令,通過XML格式創疆 和管理幻燈片。不需要闹發飛書应用。

一、前置:補授權幻燈片權限​

如果之前有授權通 slides 相盟 scope,操作蜜報missing_scopc。授權: lark-cli auth login --scope *slides:presentation:create slides:presenta 走DeviceFLow 授權後,實返回: 0K:登成功!侵用者:w9x7ce 本次新授予 scopes: slides:presentation:create slides:presentation:write 榴限表: 操作 所需 scope presentat1on:create 创建 PPT

• write_only

端取 PPT presentation:read presentation:update 添加/剩除真面 或write_only

二、幻燈片XML基​

飛書幻澄片用XML定薪页面内容。理解XML结横是操作幻经片的前提。

2.1最小可用例​

<slide xmlns=http://www. larkoffice.com/sml/2.0s sstyles cfills<fillcolor color=rgb(z48,258,252)/a</fill> </style> sdata> =1461o4 -808.=41pin -88,=Afa7d01 08.x4f7d01 a1x91.=odk4 ade4ss <content textType="title"s <p>页面题/p c/contenta </shapes c/data> s/slides

2.2 slide 的結構​

"slidex cstyles <!--面标式(背景色等) <fill><fillcolor color=.../>s/fill> </styles cdatas <!--页南元素容露-- <alxat,=adfg adeqss <!文本框 cshape type-'rect"> <!--短形/膜 ctables <!--表格 <chart> 置表 elines </ - 直综 <ing> <!--显片 ≤/data> enotex 济旗密储驻- </ - - <contentsp>内容/ps/content> ≤/note> </slides

2.3背景色和渐​

色背景: sfill>sfillcalor color="rgb(248,25e,252)"/2s/fill> (+) sfill><fillcalar color=*linear-gradient(135deg,rgba(15,23,42,1) 8%, rgba 坑:浙色必须用rgba[)格式加百分比停靠點,用rgb或省略停靠粘售導 致背景整成白色。

2.4座標和尺寸​

PPT壶布预段966x540。所有元素用topLcftx、topLeftY(左上角座标)、width、h elght 定位: (960,0) (0,0) topLeftx,topLeftY w1dth- |height (969,540) (0,540)

2.5文本檬式​

scontent textType=*title" color=rgb(255,255,255) bold="true' textAlig p>檬题文本</p s/content> 常用性: 说明 隔性 值 textTy t1tle/headline/sub-headlin 文本频型,决定预設字 e/body/caption pe font51 手動設定字號(t1tle=54,headl1n 数字 ze e=38, body=16 ) rgb() 文字颜色 color 加粗 bold true/false textAl 封 left/center/right ign

三、創建空白PPT​

三、​

PPT lark-cli slides+create-title“我的演示文”

• -a5 user

• ok": trwe,

• data":{

• xnl_presentation_1d": *UE5rs5QBILPDUvdzDHxcAIeBnNh",

"title":“我的演示文稿", "url": "https://d7fwkz4t4y.feishu.cn/slides/UE5rs50BIlPpuvdzDMxcAIel 'revision_id*: 1

創建的是一個空白PPT,没有任何真面。需要後婚用xnL_presentatlon.sLide create 页添加

四、一步創建带页面的PPT(推)​

slidc5参数,在创建PPT的同时直接离入页面内容。10页以内推满此方式。 用 lark-cli slidcs crcate--title“lark-cli 如耀片功嵌全置--as uscr --slid

• sslide xmlns=http: //ww.larkoffice.com/snl/2.o>sstyle>sfill>sfil

實际返回:

• ok": true。

• data": {

"xml_presentation_id": TyizsQyunlmY2FdJbPEcN4Afn8g", "slide_ids: [*puu", pUa].

• 2:,pappe sa!1s-

"url": "https://07fwkz4t4y.feishu,cn/sl1des/Ty1zs0yumlmY2FdJbPEcN4. "revision_id*: 1

關键返回值: xnl_presentation id-後所有操作的 ID

• slide ids-每真幻澄片的 ID(按顺序)

• slidesadded-實原添加了频页

五、添加新真面​

向已有PPT追加新真面(超退10页時用这個方式逐真添加): Lark-cli slides xnl_presentation.slide create

• a5 user \

• -params 4"xnl_presentation_id':"TyizsQyunlnY2FdJbPEcN4Afnog}' \

3'aotjoyye //:dnu=sunux aptis>, yuaquoa bue-- u- b$ eiep-- cstyle><fill><fillcolor color=rgb(248,25a,252)/>s/fill></style> cdatax cshape type=text" topleftx="se" toplefty=4o width="aae" height= <content textType="headline" color="rgb(3o,6s,114)"> <P>常用XML元系</p </contents cadeys/s cshape type=text" topleftx-"80" topleftY-"130" width-"800" height <content textType="body' color="rgb(3a,41,59)> <a<strong>shape</strong> - 文本框(type=text)、矩形(type=rect]</f <p><strong=chart</strong> 表</p> </contents </shapes c/data> </slide>′{slide: (content:$content))*1"

• cote": θ,

• data":{

• revision_1d*: 6,

und. :aP! ap!1s, ), 'nsg": "success*

技巧:用jq-n--arg content“XML'{slide:[content:$content}}可以避 免手動动XML中的引。比直接寫

• dataJSON方便得多,

六、讀取PPT全文内容​

lark-cli slides xnl_presentations get

• as user \

• -params '{"xnl presentation id*:TyizsqyunlnY2FdlbPEcN4Afneg}"

返回完盈的XML内容,包含所有真面的群细瓷鼠。可以用来:

• 確真数是否正值

• 检查每页内容是否完整

• 取slide_id用岭後續删除操作

七、删除页面​

lark-cli slides xnl_presentation.slide delete \

• as user

• -params ‘<"xnl_presentation id*:TyizsqyuntnY2FdJbPEcN4Afneg.*slide

實际返回: {cote": θ, “data: {“revision_id*: 7 }, “nsg*: *sucress" } 注意:删除操作不可逆。PPT至少保留一真幻澄片,不能刑除最後一真。

八、XML元素實戴例​

8.1封面真模板(深色渐背景)​

cslide xmlns= http: //www. larkoffice.com/sml/2.0*s sstyles <fill><fillcolor color-Linear-gradient(135deg,rgba115,23,42,1) e% s/styles cdatax <shape type=text" toplettx-"80" toplettY-150" width-"800 height <content textType="title color="rgh(25s,2ss,255)" textAlign="ce cd/>cd </contents </shape> 1461o4 -088=41p1a -08z,=4o7d01 -08.=x+fo7d0l s4xo4=odf4 ade4ss <content textType"body color="rgb(200,200,200)" textAlign-"cen <p>副想翘脱明</p c/contenta </shapes <shape type=*text" topleftx=*se" topleftY=44e- width=aae heiyht: ccontent textType="caption color="rgb(15e,15e,159)" textalign=" <p>wex7ce |2026-04-13</ps </content> code4s/s c/datas s/slides

8.2内容页模板(色背景+左侧暨線装飾)​

cslide xmlns==http://www.larkoffice.com/sml/2.0*> estyles <fill><fillcolor color=′rgb(248,25e,252)*/s/f1ll> </stylea cdatax <shape type=text" topleftx=ee" toplefty=4o width="aee height= <content textType="headline" color="rgb(30,6s,114)"> <p>页面標箱</p </contents ≤/shape> <shape type=rect" topleftx="80" topleftY-"11o" width-"4′ height-" <style>sfillssf11lcalor color="rgb(59,130,246)/></fill>s/style> </shape> <shape type-"text" topleftx-"10o" toplefty-12e" width-"78e" heigh" <content textType="body color="rgb(3a,41,59)> <>正文内容第一段</p </contents ≤/shape> c/datax 2/slides

8.3结尾页模板​

sslide xmlns==http://www. larkaffice.com/ sml/2.8*> estyloo <fill><fillcolor color="linear-gradient(135deg.rgba[15,23,42,1) c s/style> <data> <shape type="text" toplettx="s0" topLeftY=200" width="80o height: <rontent textType="title* color="rgh(2ss,2ss,255)" textalign="ce <p>Thank Youc/pox </contents ≤/shape> 4b1o4 -0ez-41pim -02e.-a4fondol .0se.-x+fondo1 -1sa1,-adla ode4ss <style><fill><f1llcolor color="rgb(59,130,246)*/></fillsc/style> </shape> c/datax c/slides

8.4矩形色瑰(装饰元素)​

sshape type="rect* topleftx=8e toplefty="12a* vidth="35a" height=18 cstyle> <f1ll><fillcolor color=rgb(219,234,254)/></f1ll> sborder hardercolor="rgb(59,138,246)" borderMidlh="1"/> c/style> <content textType-"body" color-rgb(3e,41.59) textAlign-'center> <p<strang>卡片棵题s/strong></p> cp卡片内客</p </contents </shapes

九、踩坑記錄​

原因 解决方案 同题 auth login --scope missing_scope 没有授程slides 權限 捕授權 必须用rgba()+百分比 渐翼背景白色 用了rgb()或省略了停靠點 停靠點 4001000 invalid XMIL格式错(想合、性 检查XML語法,確保概髓 结麒等) 正硫围合 param 用jq bash中雙引號薇

• -arg技巧避免手

XML和JSON引號嵌套 地默 無法副除唯一幻痘片 PPT至少保留一真 先添加新真面再刑除要的 shape 的 w1dth/he1ght 不剪 增大尺寸 文字被截 元系重叠 整座标,拉阴間距 topLeftX/topLeftY 位置衡实

十、全部命令清單​

命令 创建空白 PPT slides +create 創建PPT亚同时添加真面(≤10真推 日 slides +create --slides 两) 取 PPT 全文 XML xnl_presentations get 已润 xnl_presentation.slide crea 向已有PPT添加新真面 已润 te xml_presentation.slide dele 删除报定真面 已测 te 共5個命令全部實潮通通。 本文所有命令和输出均為真實執行结果。實测PPT地址: https ://d7fwkz4t4y feishu, cn/slides/TyiZsQyumlmY2FdJbPEcN4Afneg

lark-cli:目录三 <上一篇·lark-cli實02:AIAgent操作飛書電子表格全流程實測(22功能)

原始排版图​

发布于 2026-04-15 00:04:25（微信公众号导出记录）。

本文来自公众号后台的“导出文章内容”功能。博客正文由导出长图进行本地 OCR 转写，并保留原始排版图用于逐段核对。

原文链接：查看原文

OCR 转写有效文字约 7192 字；代码、流程图和版式以文末原始排版图为准。

正文（本地 OCR 转写）​

original wex7ce EI V1ajero 2026年4月15日 00:84美国 這是一份真實操作記,每一個命令和输出都在何服器上實账敦行退。記综了如何在一台 Linux 何服器上配置lark-cli,读AI Agent(Claude)直接以用户身份调用飛害 API,實現零代碼操作刑鲁文權。 工具: Hermes + ClaudeCode + lark-cli vl.0.9 核心思路:不間發飛書用,不寫代码。直接用Lark-cl1绑定你的飛善畅户,然後据AI Agent 用 CLI 命令操作冠害。 Aaout Th atcsl LagFEtu CLIo I yme ar,IMal, laeks, aertings cevmanes and 23+IAgeet irsm tnetct (NX) yiseer dna ay1g9 heanaga 合 TB s

一、琅境配置全過程​

1.1 安装lark-cli​

伺服器上已有Node.jsv24.14.1,直接安装: npn install -g @larksuilte/cl1 邵 Lark-cli version 1.0.9

1.2配置飛晋應用證​

lark-cli 幂要一個飛善开放平台的愿用(App ID+App Secret)。有雨種方式: 围後自動创建) 配量完後硫: sess yane tio-yue s

• appId": "cli a956xxxxx*

• brand": "feishu*,

• identity": "bot*,

• note": "No user logged in. Only bot (tenant) identity is available."

此時只有bot(愿用)身份,看不到用户的個人资源。要邯定用户易份。

1.3用户登錄授權-0AuthDeviceFLow群解​

何服器没有测贸器,所以用Dev1ce FLow模式。道一步是整個配置的核心。

第一步:Agent起授權請求​

业“回“TM- Agent 孰行 Lark-cl1 auth login --recommend - -donain docs,drive,wiki,im - -no-wait 返回值(JS0N):

• device_code*: *oQTl_UBkqutIThCPUFCBjMVxCat2rSBP...",

• verification_url*: "https://accounts. feishu-cn/oauth/v1/device/verif

• user_code": *7JZR-TR4Y",

expires_in*: 600

谁奎生的 字段 含额 换token的愚證,後續要 飛善OAuth何服器,通适本命令返 dev1ce_code 用 国 verif1cat1on_ur 授權真面翘接 同上 1 user_code 在授權真面輸入的验證碼 同上 有效期686秒(10分 同上 expires_in 键) device_code 是這個命令直接返回的,不是测質器授權後產生的。先拿到devireC odc,用户再去测置器授槽,显後用devicc_codc换token。

第二步:用户在實器授權​

Agent 把縫接和user_code登给用户。用户在自己電上: L. 打用 verification url

2.真面顯示user_cade(或手勤输入)​

3.贴链超授槽​

飛害伺服器會配:這因dcvicc_codc對庭用户wex7ce,已授權。

第三步:Agent用device_code完成置錄​

用户告新Agent 授權完成,Agent 用第一步的device_code敦行: lark-cli auth login --device-code "oQTl_uekqutIThcPUFCBjMVxCotzr5BP.." 實察返回: 0K:冀赣成功! 用卢:w8x7ce (ou_8b699fcd377ea78ff5e16abb4b8ba397) 本次求 scopes: docs:docunent.content:read decx:docunent:create docx:c 本次末授予scopes:(空) 验最终状部: 瞻證最终状题: S lark-cli auth status

xxxxxx9s6eT1p...,Idde.

• identity": “user*,

• userName": "uex7ce",

• tokenstatus*:*valid",

Ldentity徙bot爱成了user。现在Agent 可以用wox7ce的身份操作册 V 書了。

二、創建文檔一每種元素的真實命令​

以下是所有文檔能力的實测结果。每個命令都在何服器上實腐執行透,输出是真實的。

2.1創建文檔基础​

Lark-cli docs +create \

• -markdown“遭是一段普通文本。

實际返回:

• ok": true,

• data":{

• doc_id": "QfqTaXy6AoVRz7xdTNcc6Xgmngb",

"dpc_url": "https://www. feishu.cn/docx/QfqTdxybApvRz7xdTNcc6Xgmngb" 厚x。obessu

後绩操作都用 doc_id来定位道霜文榴。

2.2富文本格式​

Lark-cli docs +update \

• -doc "QfqTdxy6AoVRz7xdTNcc6Xgnngb"

\ puodde apou-

• -markdown“普通文本,支持*加和**、科體、障螺,“行内代碼”。

返回:

• ok": true,

',puadde,. +,apou.

對效果:普通文本中的加粗、斜、删除線、行内代疆。

2.3高亮塊(Callout)​

三福常用高亮境:​

Lark-c1i docs +update

• -doc "QfqTdXy6AoVRz7xdTNcc6Xgnngb"\

\ puadde apou-- =1 [cue 4malless, umopyeu-

• backgraund-color=-light-hlue">

亚色提示高亮境。 /callout> ccallout emoji-** background-color-"light-yellow"> 黄色警告高亮场。 </callout> ccallout emoji=X background-color="light-red*s 红色危险高亮境。 </callout>: 返回:同上 append 成功. 到愿效果:带enoji图标、带背景色的高亮场。 隔性明: 隔性 可退值 脱明 左例 enoj1 任意emoji字符 light-blue 背景 background ,light-yellow, Light-red, light-green, light-pu J0103- 色 rple, light-orange, pale-gray callout内部可以格式化文本,但不支持代碼现、表格、图片。

2.4分(Grid)​

雨等宽: Lark-cl1 docs +update
1puadde opoa markdo/n ,=5]02 p7./6>, <column> 左内容,支持格式化。 列表项1

• 列表2

</column> 右帽内客。

1.有序列表​

2.第二顷​

</column> </gr1d>

三棚自定宽度:​

Lark-cli docs +update
70C mode append 1 1puadde opos

• ,08/ko

<3=apim ums 20%真 </column> <,09,=qapim uuos> 60%宽 </column> <,3,=qapim uuas> 20%真 </column> </grid> 性就明: cols 列数,2到5

• width-列寶百分比,铺和必须為160,等实可省略

2.5表格​

表格直接用Markdown惩法: Lark-cl1 docs +update \

• doc"QfqTdXy6AoVR7xdTVc5Xgm

mode appcnd 1

• Barkdown°1列 1|列 2|列 3

1 数 1 | 数域 2 1 数摄 3 | 数球4|数擦5|数6| 辩表格(单元格内有列表、代码等)用飛画增强表格: Lark-cli docs +update

• doc "QfqTdXy6AovRz7xdTNcc6Xgnngb"

\ puadde apou--

• -narkdown *slark-table calumn-widths="2ee,2so,2ee" header-row=*true

xlark tr> zlark-td>

• 功能*

s/lark-td>

• 部令**

slark-td>

• 些明*

</lark-td> clark-tr> 创建文福 clark-td> docs +create </lark-td> Markdown 刨建新文榴 c/lark-td> c/lark-tables' lark-table的clark-td标箍内的内容前後必须空行,否则解析失。

2.6代碼瑰​

lark-cli docs +update
doc "0fqTdXy6AoVRz7xdTVcC

• oode append 1

srkdown“##代碍示例 python def hello() : print(“Hello, Feishu!*) return True 支持的語言磁:python,javascript,go,Java,sql,json,yanl,shcl L, bash 等。

2.7任務列表​

lark-cli docs +update

• doc "QfqTdXy6AoVRz7xdTNcc6Xgmngb"

\puadde apou-- markdown"-[]末完成的任称

• [x]已完成的任務“

效果:带勾避框的待群列表,

2.8引用瑰​

lark-cli docs +update

• doc "QfqTdXy6AoVRz7xdTNcc6Xgnngb

• -node append 1

可以跨多行 支持**加赠*和寂

2.9文字颜色​

lark-cli docs +update
doc "ofqTdXy6AoVRz7xdTNC mode append 1 Barkdawin‘红色文字暂色文字 红色文字蓝色文字 黄色背景高亮 支持的频色:red,orange,yellow,green,blue,purple,gray。 支持的颜色:red, purple , ef

2.10插入圆片​

通過公開URL插人国片(lark-cli自封下载亚上傅到形善): Lark-cli docs +update \

• doc "0fqTdxy6AoVRz7xdTNcc6Xgnngb"

\ pusdde apou

• -narkdown *<inage url="https://exanple.con/photo. jpg" width=40e al.

图片插入是具步操作。命令返回的是task_id,不是立即生效。實察测斌中耗時的8 秒。 返回示例:

• status": "running*.

• task_id": "418dcd05=852f-4fa8-bdda-ec231cae3b49*,

• estimated_tine*: *5-15s"

性明: 隔性 必填 就明 url 是 图片的公可防間 URL 宽度(像素) width 否 left align 否 / center / right caption 否 图片下方期明文字 支持格式:PNG/JPG/GIF/WebP/BMP,显大10MB. 如果是本地图片,流程不同:先用docs+update离文本,再用docs+Hiedla-insert追 加本地文件。

2.11標题颜色和對齊​

lark-cli docs +update ↑

• -doc "QtqTdxy6AoVRz7xdTNcc6Xgmngb"\

puadde apou- ##红色精题{coLor=red°} 国中文字{align="center*}

2.12分割線​

Lark-cli docs +updatc

• doc "0fqTαXy6AoVRz7xaTVcc6Xgmngb*

1 puadde apow-

分割缘下面的内容

三、文檔更新-六種模式详解​

doc5+update有7种模式,以下是每種模式的實测命令和结果。

3.1append-追加到末尾​

最常用的模式,在文檀最後追加内容: Lark-cli dacs +update
xxxuoxopop- \ puadde apou-- 返回: { ',puadde., ..apou. (puade)x。:,afessau.

• success":truc

3.2insert_before-在指定位置前面插入​

用标题定位,在标题前面插入内容: Lark-cli docs +update
xxxuoxopop-

• -node insert_before \

• -selectian-by-title“目题\

markdown“>这段言出现在目标杨题的南面 返回:

• node": "insert before",

• success": true

3.3insert_after-在指定位置後面插入​

lark-cli docs +update xxxu5xopoop-

• -node insert_after \

selection-by-title“##目题\

返回: "node": "insert_after",

• success": true

3.4replace_range-替换整個章節​

用标题定位,替换被标题下的整個章的内容: Lark-cli docs +update \

• doc "doxcnXXX* 1

mode replace_range 1 selection-by-title “ 標蹈”

• 8rkdown“新棵题

mankcdown 智换後的全新内容。 可以包含列表 可以包含其他格式 返回: "node": "replacc_range", success": true

3.5replace_all-全文替换文本​

在全文图内查找亚警换文本: 1 Lark-cl1 docs +update \

• -doc"daxcnxxx"\

11easedou apou-

• -markdown“新文本”

實际返回: '11e aseldau, +.apou, ‘t :,lun agda, “ncssage":“文福更新感功(replacc_all模式),共世1虚"

注意rcplacc_count字段告新你實际替换了袭点。

3.6delete_range-删除整個章節​

用棵定位,删除敲棵题下的整個童前: lark-cli docs +update
\xxxuoxopoop--

• -node delete_range \

返回:

• node": "delete range",

“nessage":“文福更斯成功(delctc_rangc模式)", 'success": true

3.7overwrite-全文覆蓝(慎用)​

清空文榴重宽。會丢失已有圆片、钾输等。 lark-cli docs +update
xxxuoxopoop--

• -node overwrite \

• narkdown“全斯的文指内容

更新横式速查表: 定位方式 模式 用途 围险 無(末尾) 追加新内容 低 puedde 低 标题定位 在某章顾前插入 insert before 标翘定位 在某章前後插入

• 低

insert_after

• 中

replace_range 标题定位 替换整個章的 中● replace_all 文本匹配 全文查找替拍 delete_range 标题定位 删除盈個章筋 overwrite 清空重窝 無 高

四、镇取文檔内容​

Lark-cli docs +fetch 返回文樓的 Markdown 内容(Lark-flavored 格式),包含文樓标题、长度、正文。可用 来检查文檀當前内容後再决定如何更新。

五、踩坑記錄(真實遇到的問题)​

5.1長文槛必须分段寫入​

刑晋API对单次寫入有限制實测中發现一篇9章衍的文楼無法一次性寫入,需要: 别建主经 lark-cli docscreate --title“棵题--markdown“第—部分 #逐段通加 lark-cli docs +update --doc

• -narkdown“第二部分”

"xxx" puadde apou-

5.2搜索文檔需要额外權限​

實涮docs +search罐:

• ok": falsc,

• error":{

"type": "missing scope", 'nessage*: nissing required scopc(s]: scarch=docs:read

search:docs:read scope: 需要额外授權 lark-cli auth login --scope search:docs:read

5.3圆片插入是巽步的​

插入圖片不會立即生效,返回的是task_id: "status":"running" "task_id":"418dcd05-052f-4fa8-bdda-ec231c0e3b49", "estimated_time":"5-15s"

實測約8秒後圖片才出現在文檔中。

5.4bash中---會被解析為flag​

在shell中通過$(catfile)傅含 分割線的Markdown時,bash會把 當作命令行flag,導致報錯。 解决方案:直接在参数中寫内容,避免用$(cat) 展開。

六、最終效果​

配置完成後,我可以直接對Agent: “我創建一篇飛書文檔,標題是XXX" "我在飛書文檔裡追加一段關於XXX的内容" “我把飛書文檔裡那個舊章節替換成新内容“ “我往飛書文檔裡插一張圖” lark-cli完成操作,文檔實時出現在飛書裡。 Agent會直接調用 本文所有命令和輸出均為真實執行結果

lark-cli·目录= 下一篇·lark-cli實02:AIAgent操作飛書電子表格全流程實測(22頂功能)>

原始排版图​

原始导出图超过单张 WebP 的尺寸上限，以下图片按从上到下的顺序连续保存。

发布于 2026-04-15 23:15:52（微信公众号导出记录）。

本文来自公众号后台的“导出文章内容”功能。博客正文由导出长图进行本地 OCR 转写，并保留原始排版图用于逐段核对。

原文链接：查看原文

OCR 转写有效文字约 10231 字；代码、流程图和版式以文末原始排版图为准。

正文（本地 OCR 转写）​

(22填功能) nalwe×7ce EI V1ajero 2826年4月15日 23:15 日本 本文記祭了AI Agent(Claude)通遇Lark-cl1 操作飛害電子表格的完整實潮退程。 每一個命令都在何服器上實除執行過,所有输出為真實返回值。 工具: Claude Code + Lark-cli v1l.0.9 和上一篇文檔一樣:不宣程式碼,Agent 直接测用lark-cli令操作你的飛害表格。前提 是已经完成Lark-cli安装和使用者登錄授權(見上一篇)。

一、前置:補授權表格權限​

如果之前置時没有授權表格相脚的scope,操作表格會报籍:

• ok": false,

• error":(

• type": "missing_scope",

"nessage": "nissing required scope(s]: sheets:spreadsheet:crcate, 5

解決方法-授權(走Dev1ceFLow,和首次登一楼): lark-cli auth login --scope shectsspreadshect:create sheetsspreadshe 返回授槽速结和user_code,在灣震器理础即可。新增的 scope 會增量累精到已有權限 上,不曾覆盈之前的。 實际返回: 0K:登成功!使用者:w8x7ce 本次新授予 scopes:shccts:sprcadsheet:crcate sheets:sprcadshcct:writc_o 本次木授予scopes:(空)

二、創建表格​

2.1带表頭和数據一次性創建​

Lark-cl1 sheets +create \

• -title"lark-cll 表格置测”\

• -headers“[“姓名","部","成",“呼级"]’\

• data“[["张三",“挂蜥部”,95,"A"],[“李四*,斋品部,88,“B”].[“王五”,“超部

實际返回:

• ok*: trwe,

• data":{

• spreadsheet_token*: "IPxPsm0ILh3ZXmtr7SBcnR8unpg",

"title":“lark-cli 表格言测", "url": "https://d7fwkz4t4y.feishu.cn/sheets/IPxPsm0iLh3zXntr7SBcnR8

参数設明: 参数 必填

• -title

表格標题 是 表额行,JSON 陣列 晋

• -headers

• -data

初始數缘,二维JSON 犀列

• -folder-token

目標資料夹token,不填刚創建在個人空間根目錄 否 打開ur1就能在飛害裡看到這個表格,表眼和数擦都已經入了。

三、查看表格资訊​

創建後需要拿到sheet_id才能後缩操作,用+1nfo查看:

實际返回:

• ok": true,

• data":{

"sheets": { "sheet_1d*: "83d526*, "title*:"sheet1", "1ndex*: 0, "grid_properties*: { "colunn_count": 20, "frozen_column_count*:

}:,laauspea,ds, "spreadsheet*:{ "title':"lark-cli 衰格實测", "owner_id*: "pu_Hh99fcd3xxx"

關建资讯: sheet Id:83d526-後所有操作都需要個ID

• 预設 Sheet 名:Sheet1

• 预設260行×20列

shcct_id不是序號,而是飛書分配的字串ID(如“83d526”)。後绩错离操作必 须带上它

四、讀取數據​

lark-cli sheets +read \

• -sheet-1d83d526*\

925p58 PT-ias-

• -range "A1:D6*

實际返回:

• ok": true,

• data":{

):,obuegonleA, "range": *83d526!A1:D6′, ]=,sanleA, [“姓名”,“部",“成”,“呼级“], ["张三",“挂析部”,95,“A"], ["学四",“品部”,88,“B"], [“王五",“般計部",72,“C"], [“超六”,“挂斯部”,91,“A”], [“猴七”。“品部”,63,“D"]

坑:range不能只寡“A1:D6,必须加

• -sheet-id参,或者range 嘉

成“83d5261A1:D6”格式.否则报:{error:{message:"-range*A1:D5 " requires --sheet-id or a ! prefix*J} 雨種窟法等俱: 方式一:分肥察 方式二:合在range經

• -range "83d526!A1:D6*

五、追加行数據​

在现有表格末尾追加新行: lark-cli sheets +append \

• -sheet-1d 83d526*\

• -range "A:D* 1

• values·[[“m八",市增部”,85,“B"],[“周九,“技部”,78,"C"]

實际返回:

• ok": true。

“data":{ "tableRange*:83d526!A7:D8,

"updatedRows*: 2, “updatedRange*:“83d5261A7:D8"

返回值告新你:数离到了A7:D8(第7-8行),共2行x4列-8個單元格。 露坑:range 不能寡 “A1:D1”(只含1行但给了2行数),报籍: ("err or*: ("code": 982o2, "nessage*: "range in request is wrong. rows of value:2 A:D表示整列箱圍,或碰保range行数≥数撼行數。 正链腐法:用

六、寫入單元格(覆盖模式)​

寓人會面蓝目标區域的已有数。

6.1寫入單個單元格​

Lark-cll sheets +urite
\adungausast1uxzeumrousdxdI. uayos-aauspra.ds.-- range “83d5261E1*
[。ll. sneA-- 返回: "updatedcells′: 1, '.13.taigzspee. -,abueapatepdn.

• updatedRows*: 1

6.2寫入一列数據​

Lark-cli sheets +write \

• range "83d5261E2:E8" \

[][][,][][][][。]].sA- 返回: uptatedCells*: 7, "updatedRange*: 83d5261E2:E8, updatedRows* : 7

注意values的格式:寡入一列時,每個值是一個单元素障列[“侵秀"],整體套一 ....

七、查找和替换​

7.1查找​

lark-cll sheets +find \

• -sheet-id 83d526*\

• find“技折部”

實际返回: 回照邀 }

• ok": true,

• data": {

• find_resutt*: {

}:,insau putj, "matched cells*: ["B2*, 85, “B8"1 "rows_count*: 3

返回匹配到的量元格位置列表,“技怖部”出現在B2、B5、B8三個位置。

7.2替换​

lark-cli sheets +replace \

• -sheet-id #83d526*\

• find“技部"\

I。 yuwelda-- 實际返回:

• ok°: true,

• data":{

1:,linsau aoeldau, "matched_cells*:["Bz", B5, *B8"], "rows_count’: 3

替换结果同時告诉你匹配或替换了频虑,打開删害表格可以看到B2、B5、B8的技術部,已 成“工程部」。 支援的逾赠遇项: 福分大小度

• -natch-case

• -natch-entire-cell

完全四配(不是包含) 正所匹配

• -search-by-regex

• - include-formulas

也援导公式中的文本

八、合供單元格​

lark-cli sheets +nerge-cells \

• -range "83d526!A10:D18" \

• -nerge-type HERGE ALL

返回: {ok": true, “data: {"spreadsheetToken": *IPxPsnDiLh3ZXmtr7SBcnRBunp merge-type三模式: 模式 就明 MERGE_ALL 合供為一個單元格 按行合供(每行各自合供) MERGE_R0WS 按列合供(每列各自合供) MERGE_COLUMNS 踩坑:merge-type 是必填参数,不便會报罐。取消合供用

• urnerge-cells.

九、設定單元格様式​

Lark-cli sheets +set-style \

• range “83d5261A1:E1"\

• -style ‘{"font*:(bold":true).backColor":#4472c4","fontColor:*#FF

實际返回:

• updates":{

‘5:s11apatepdn,

• updatedRange*: B3u526!A1:E1,

updatcdRous*: 1

遗把表照(A1:E1)段成了白字蓝底加粗。 style JSON支援的丽性:

• font":{

"bold°: true, "italic°: falsc, "s1ze": 14, "family": "Arial "fontColor":WFFFFFF", “backColar: #447224", “hAlign":“Center,

• vAlign": "Middle”,

• borderType*: FULL BORDER

十、插入和删除行列​

10.1插入行​

在第2行位置插人2行(9-1ndexed,start=1end=3): lark-cli shccts +insert-dimension \

• -sheet-id 83d526*\

dincnsion RoWS
xaput-1e1s--

• -end-index 3\

inherit-style BEFORE 返回: {“ok”:true,“data:{}} 数明: 锐明 参数 警数 ROWS SMO8

• -dimension

或COLUMNS 起始位置(0-indexed,θ表示第1行/列前)

• -start-index

• end-index

结束位置(θ-indexed,exclusive) BEFORE

• 1nherit-style

或AFTER,事一行/列承梯式 注意:insert-dinension 用的是 0-1ndexed,而delete-dinension 用的是 1-indexed雨個命令的索引醋系不一致,容易搞湿。

10.2删除行​

到除第2-3 行(1-indexed,inclusive):

• sheet-id83d526*

• -dlmension RowS \

• -start-index 2\

• end-index 3

返回: {*delCount": 2,najorDimension:*Row5"} 索引體系對比: 命令 索引方式 start含 end 含裁 exclus1ve 起始位置 8-1ndexed

• 1nsert -dimens1on

起始位置 1-1ndexed inclusive

• delete-dimens1.on

十一、插入圆片到單元格​

cd /tnp && lark-cli sheets +write-inage

• -range "83d5261F2*\

• -inage ",/test-ing.png"

實际返回: {

• ok": true,

• data":{

'revision*: 10,

• updateRange*: 83d526!F2:F2

霖坑1:图片路锂必须用相期路(-/xX-png),不能用韬剩路径(/Lnp/xx-p ),否则报错“unsafe inagc path"。 踩坑2:图片必须是有效的PNG/JPG等格式,捐坏的檔案窑報code 95201 server error.

十二、導出表格​

12.1薄出為xlsx​

cd /tnp 55 lark-cli sheets +export \

• -file-extension xlsx \

xsx*4uedxa-1sa4/ . qaed-1ndno-- 實際返回: Maiting for cxport task to complete... Export complete: f1le_token=I2BNb6T6ao5LAhx6EICcVo7WnDe

• ok": true,

"data":{ "saved _path*: */tmp/test-export.xlsx", "size_bytes': 7746

12.2薄出爲cSV​

cd /tnp 5& lark-cli shects +export ↑

• - file-extension csv \

sheet-id83d526

• -output-path*./test-export.csv"

募出的CSV内容: 姓名,部門,成绩,部级,備注 张三,工程部,95,A,秀 李四,產品部,88,B,良好 王五,缺計部,72,C,一般 趟六,工程部,91,A,秀 踏七,產品部,63,D,需改进 孫八,市场部,85,B,良好 周九,工程部,78,C,一般 注意: CSV導出需要

• -sheet-id警数

putput-path必须用相對路径

十三、取消合供單元格​

取消之前合供的A10:D10: lark-cli sheets +unnerge-cells \

• -range "83d5261A10:D18"

返回: {ok": true, “data: {"spreadsheetToken": "IPxPsn01Lh3ZXmtr7SBcnR&unp

十四、批量設定檬式​

一次性對多個區域投定不同檬式:​

lark-cli sheets +batch-set-style ↑ Moeq.*(anus+.plog.): 4uo.)+aa1/1s,*av=zvi92spe8...sabue.s1l. e1ep-- 實限返图:

• ok": true,

• data":{

"responses*: [ "updatedCells": 7, "updatedRange*: 83d526!A2:A8" "updatedcells: 7, "updatedRange*: 1, totalupdatedCel1s": 14

data是一個 JSON障列,每個元素包含: 目标區域(字串或障列) 槎式物件

• style

一次API调用就能設定多细不同區域的不同式,比逐個+5et-style高效。​

十五、在末尾追加行/列​

在表格末尾追加3列(不指定位置,只能追加到末尾): Lark-cli sheets +add-dimension \

• sheet-id 83d526*

• -dinension COLUMNS

E q1fua-- 返回: {“addcount":3,najorDimension:*COLUMNS") 射比 +insert-dinension: 用途 索引方式 位量 只能迪加到末尾 無需指定位置 摘展表格容量

• add-dimension

指定位置插入 在中間插入行/列

• insert-dimension

6-indexed

十六、設定行高/列宽和藏行/列​

16.1設定列宽​

把A列(第1列)襄度投为158px(1-1ndexed,1nclus1ve): lark-cli sheets +update-dimension

• -spreadsheet-token "IPxPsmo1Lh3ZXntr7SBcmR8unpg*\

• -sheet-id 83d526*\

• dimension COLUMNS

• -start-1ndex 1\

• -end-index 1 \

• fixed-size 150

返回: {*ok”: true, “data2:{}}

16.2隐藏列​

隐藏G-H列(第7-8列): Lark-cli sheets +update-dimension ↑

• -sheet-1d 83d526*

• -dinension COLUMNS \

• -start-index 7\

• end-1ndex 8

• -visible=false

• visible必猬离成

跟坑:

• -visible-false(用等號),寓成

• -visible fal

se曹把“false”成位置参數报端。 update-dimension 支援的操作: 参数 效果 设定行高或列寶為158px

• fixed-size 150

• -visible=false

限藏行/列

• -visible=true

顾示行/列 注意:這因命令用的是1-indexedinclusive 索引l。

十七、移動行/列​

把第7行移到第2行的位置(9-indexed): 1 Lark-cl1 sheets +nove-dimension
sheet-id #83d526*\

• -dimens1on RoNS \

\g xaput-1ye1s--

• end-index 6\

• -destination-1ndex 1

返回: {ok”: true, “data: {} } 参数就明: 就明 参数

• -start-index

源起始位置(0-indexed) 源结束位置(9-indexed,inclusive) end-index

• -destination-index

目標位置(9-1ndexed) 可以移單行(start=end)或多行(start<end)

十八、数據選​

速功能通退原生API 用(非shortcut),要四個步:create→get→update

• delete,

18.0弹備筛選数據​

先高入测试数據: Lark-cli sheets +urite \

• -range “83d5261G1:H8*\

• values“[I“效體”,“情感”],[“微博”,"正面”].[“微博”,“负面”],[“抖音”,"正面”]。

18.1創建筛選​

按「媒始:列(G列)餘選微博: lark-cli sheets spreadsheet,sheet.filters create

• -params '{"spreadsheet_token':IPxPsmoiLn3zXntr7SBcmRBunpg,*sheet_1

• -data {"cal:G,condition={"expected":[微w].filter type:*nul

返回:

坑:range必须覆所有幂要参贝霹逻的列。如果只离“G1:G8",後面想加H 列條件就不行了,必弧先 delete 再create 重新指定更大的range.

18.2取選状態​

lark-cli sheets spreadsheet sheet.filters get \

• params ‘{"spreadsheet_token*:IPxPsmoiLh3zXntr7SBcmRBunpg,*sheet_1

實际返回:

"data":{ "sheet_filter_info: "cot′: 6, "canditions":[{*expected”:["微博"].filter_type:“nultiv 1, "filtered_out_rows: [4, 5, 6, 8].

• SH:1ei9zspe8. .obuel.

返回中可以看到:

• fiLter_infos-营前所有筛避條件

• 被過滤掉的行號(4,5,6,8是抖音和小红署)

• filtered_out_rows

18.3追加選條件​

在已有還基上,再加一個“情感,列(H列)="正面“的條件: Lark-cli sheets spreadsheet.sheet.filters update params ‘{"sprcadshect_token*:IPxPsm0iLh3zxntr75BcmRBunpg,*shcct_i

• -data ‘{"col*:H","condition={"expected":[i正m]."fllter_type*:*nul

返回: { code": 8. "msg: success } 现在静選终件是:G列="微博”且H列=”正面”。

18.4删除筛選​

Lark-cll sheets spreadsheet.sheet.filters delete \

• -params '{"spreadsheet_token*:IPxPsm0iLh3ZXntr7SBcmRBunpg.*sheet_i

返回:

剩除後所有行恢额示。 筛遥操作流程德结: L.create-首次創建薛通(range必须覆蒸所有参與筋通的列)

2.get-查看常前解逛像件和被過通的行​

3.update-在已有部速上添加/修改案列的條件(不需要range)​

1.delete-清除所有远​

十九、踩坑匯總​

同题 原因 解决方案 auth login --scope 没有授表格權限 missing_scope 补授(增量,不覆盈之前的) requtres 加--sheet-1d 或用 sheetId!r

• -sheet

range 注带 sheet_id ange 格式

• 1d

append 时range 行数 用“A:D"整列航凰 不钩 > range unsafe inage/out cd到目標目錄,用./相封路径 用了到路径 put path merge-cells 必填参数 merge-type not s 加 --nerge-type MERGE_ALL/R 没傅 OWS/COLUMNS et 95201 server err 国片楼案损顷或格式不封 固片檔案捐坏或格式不對 確保是有效PNG/JPG or J0 insert 0-indexed, delete 1- insert/delete索 雨者索引體系不同 引湿乱 引混 indexed 寫成--visible=false(用等 "false" 寡成

• -visible false

報錯 號) 被当成位置参数 range要包含所有参與筛選的列, create時range 没覆 筛選range太小 蓝所有筛選列 如G1:H8 先delete 再create,或用up 筛選已存在 重複create會覆蓄 date追加條件

二十、全部功能清單​

以下是lark-clisheets所有shortcut的測試狀態: 是否實测 功能 Shortcut 已测 創建表格(带表頭和数據)

• create

已测

• info

查看表格和sheet資訊 已测

• read

讀取單元格数據 已测

• write

寫入單元格(覆蓄模式)

• write-image

已测 插入圖片到單元格 puadde+ 追加行数據 已测 查找單元格 已测

• find

查找替换

• replace

已测 遵出爲xlsx/csv 已测

• export

合供单元格

• merge-cells

日

• unmerge-cells

日 取消合供 已测 設定单元格様式

• set-style

• batch-set-style

批量設定多區域檬式 日

• add-dimension

在末尾追加行/列 日 在指定位置插入行/列

• insert-dimension

删除行/列 已测

• delete-dimension

已测 設定行高/列實、藏行/列

• update-dimension

移動行/列 日

• move-dimension

spreadsheet.sheet.filters create 創建筛選 已测 spreadsheet.sheet.filters get 已测 獲取筛選狀態 已测 spreadsheet.sheet.filters update 更新筛選條件 spreadsheet.sheet.filters delete 删除選 已测 全部22個功能均已實测通過。 本文所有命令和输出均為真實執行结果。實测表格地址: https ://d7fwkz4t4y.feishu.cn/sheets/IPxPsm0iLh3ZXmtr7SBcmR8unpg 附:踩坑匯總(精簡版) 問题 解决方案 原因 auth login--scope 没有授權表格權限 missing_scope 補授權 range 没带 sheet 加--sheet-id 或用sheetId!ran requires --sheet- ge格式 id id append時range rows of value:2 > 用“A:D" 整列圍 行数不钧 range unsafe image/outp 用了對路径 cd到目標目錄,用./相對路径 ut path merge-cells必填 merge-type not se 加--merge-type 参数没傅 t 国片檔案捐堰或格式 95201 server erro 確保是有效PNG/JPG 不對 r insert/delete索引 insert用0-indexed,delete用 兩者索引體系不同 1-indexed 混勐 本文所有命令和输出均為真實執行结果。實测表格地址: https://d7fwkz4t4y.feishu.cn/sheets/IPxPsm0iLh3ZXmtr7SBcmR8unpg

lark-cli·目录三 <上一篇 下一篇> lark-cli實03:AIAgent 操作飛害 lark-cli實载θ1:安装到創建飛書文檔 完整指南 幻燈片全流程實测(含XML模板)

原始排版图​

原始导出图超过单张 WebP 的尺寸上限，以下图片按从上到下的顺序连续保存。

发布于 2026-03-31 22:40:28（微信公众号导出记录）。

本文来自公众号后台的“导出文章内容”功能。博客正文由导出长图进行本地 OCR 转写，并保留原始排版图用于逐段核对。

原文链接：查看原文

OCR 转写有效文字约 7245 字；代码、流程图和版式以文末原始排版图为准。

正文（本地 OCR 转写）​

開源填目解剖:特斯拉CAN匯流排協是怎被20欧元開發板 利用的 original wθ×7ce EI V1ajero 2826年3月31日 22:40 日本 最近看到GitLab上一個間源项目 tesla-open-can-mod,作者用一增20酸元的間發板接進特斯拉的 CAN匯流排,實现 了FSD敏用、Nag抑制、速度配置等一系列控制项目就明狸有一句話... Tesla Open Can Mod porag Azurnwuog s 1o epose and control everythirg accesstle via CAN as afuly spen project. b no more tan 90 Tris prject eiss so mobcay has to overpe. Warning e ep n se sN p sdnn pusuds unexpected bahavlor, disable safety-crtical sysitems, or pare sBeup .(gu nents. The CAN bus o derstanc whet you're doing, do notimstal ts on your cer. Cautlon ad u0 0 pe u npq peuod ss umnefl sn ty. Mod ifying GIN Ous messages on e vehicie cen leed to unesqpected or dangerous beneviort. hf oftwiere. This project mey roid your wehicie swa os e nof u ev ug sn

tesla open can mode

tebr mor'8 rm hacs 1 torm Dm UCENBE aeI SMU I

3.9​

README.rd racs 1 1or

我仔细精完了它的全部源码(handers.h、can_helpers.h、各疆动屠以及单元测试),把 细前微代碾蓬语中提取整理出来。本文所有内容均来源龄封被项目代碼的分析,不涉及任何 到實重的直接逆向操作。 特斯拉的CAN匯流排没有任何加密或證概制所有訊號以明文在匯流排上,任何接入的 装置都船整糖與送。這意味著只需任何一埋有can控制器到率片楼加上一個can收器,就能 透退修改少数摊個 bit 来解辑Full Self-Driving(FSD)功能。本文完整记罐细 的,任何熟悉嵌入式闻發的人都可以基铃此在任意平台自行置作。

一、物理層​

项目 规格 598 kb1t/s (CAN 2.8B 椿军帧) 速率 鳞别碼格式 11-bit 华帧,ID 圍ex868-6x7FF 资料最度 固定8位元组(DLC=8) X179 速接器 P1n 13 (CAN-H)、P1n 14 (CAN-L) 接入點(新款) 接入點(离款2020前) X652 速接器 Pin 1(CAN-H)、Pin 2(CAN-L)

二、CAN帧通用結構​

每條讯息固定8位元组。Byte0的低3位是MuxID(多工别碼),用来區分同一個 CANID下的不同子规息颈型。 [1] [2] [8] [4] Byte: [E] [5] [6] 低3位=MUX 有效负延(纽接bit码,可跨位元组排列) Bit線性编號规则 全文的bit N均指線性端號,换算方式:Byte 索引x8+Byte内bit 位置(LSB=

0).​

综性Bit 能圆 對德位元组 Byte 内 bit 6-7 Byte β 9 - 7 Byte 1 8 -15 67 16 23 Byte 2 67 24 - 31 Byte 3 67 6 -2 Byte 4 67 48 47 Byte 5 67 48 55 Byte 6 67 56 - 63 Byte 7 67

三、涉及的CANID總質​

CAN ID Hex 蔬息名 適用車型 操作方向 Legacy 69 STW_ACTN_RQ 只请 0x045 镇+改 921 DAS_status MH 0x399 请+改 1066 θx3EE

• (未命名)

Legacy 1016 8HEX8 HA3 / HN4 UI_driverAss1stControl 只镇 UI_autop1lotControl HA3 / HN4 請+改 1821 Bx3FD 重型就明:

• Legacy = 竖屏+HM3 的老款 Model S/X

• HW3=横屏+HN3:以及搭载H4但僵早龄2026.2.9.×的重(跑FSDv13)

• HW4= HW4硬體+ FSDv14(韧锥 2026.2.9.x以上)

判暨方式:車韩慕Controls+Software→AdditionalVehicle Information可查硬聘版本。

四、速度配置(speedProfile)​

speedProfile是整图系最核心的状,控制FSD 的解激造程度,由跟重距雕或操杆位 置决定,再注入回 CAN帕。 HN3 / Legacy(3 级): profile 值 名瓣 触驶凰格 Chill 激进:鞍高速、较少减速 标军行為 Normal 潭行為 1 JnH 保守:鞍低速、提早减速 Hurry 2 HN4 (5 级) : profile 值 名稀 名網 斓驶凰格 潮驶凤格 Chill 最激进 0 标率 Normal 1 KuJnH 2 保守 最保守 Max Stoth 檀保守 4

五、CANID69(0x045)-方向盤报杆位置​

限Legacy事型,只镇。老款方向盤报杆的物理位置,用来封癌迹度配置。 同键棚位:Byte 1的高3位(bit5-7),提取方式為data[1]>5。 Byte 1: bit 7 bit 6 bit 5 bit 4 bit 3 bit 2 bit 1 bit B pos (3位) pos(高3位) data[1]原始值 映射 speedProfile (n) 8x08 2 (Hurry) 0x21 1 8x42 1 ( Normal ) 2 t9x8 m θ (Ch111 ) S8x8 0 (Chilt) 4 8xA6 θ (Chil ) 5 0xC8 0 (Chill ) 6 规律:pos ≤1 -Hurry;pos = 2 +Normal; pos ≥3 + Chill. 此 ID 收到後不回

六、CANID1016(0x3F8)-跟車距離設定​

HN3/HN4共用,只讀。车辆UI的跟车距雕滑样值,用来决定速度配置。 键椭位:Byte 5的高3位(bit 5-7),提取方式为【data[5]否Bb111baeB)> 5. Byte 5: bit 7 bit 6 bit 5 bit 4 bit 3 bit 2bit 1 bit θ followDistance(高3位,值1-5) ENH followDistance speedProfile 2 (Hurry) 1 1 ( Normal ) 2 8 (Ch111) 3 不炭 8或其他 HN4映射: speedProfile followDistance 3 (Max) 1 2 ( Hurry ) 2 1 ( Normal ) 3 8 (Ch111) 4 4 (Sloth) 5 不炭 8或其他 此ID收到後不回發,只用来更新 speedProfile 默感。

七、CANID1006(0x3EE)-Legacy 自動驶控制​

催限Legacy 車型。需插截原帖、修改指定bit、再转發回随流排。 Muxθ(data[0]&0x07==θ):FSD用+速度配置 [0] :a1g [s1 [4] [9] [∈] [1] [z] [ 7 ] X=日 bit38 bit46 85-6119 速度配置 FSD糖 F5D Bit(線 遮 操 Byt 含额 性) bit 作 e 0x4 FSDUI還援標:使用者是否用红 只 8 4 6 8 端 燈與停止标缺控制 0x4 置 46 5 6 FSD使位:告新重楠FSD已激活 1 0x0 4950 12 6 速度配置(2bit) 人 6 速度配置的 2-bit 编碼(寡入 data[6]的 bit 1-2): speedProfile data[6] bit 2 data[6] bit 1 data[6]遮罩值 0x00 (Ch111) 8 Bx02 1 ( Normal ) 9 1 0x04 2 ( Hurry ) 1 解發件:bit38為1时才修改亚确段. Mux 1(data[0]&0x07 ==1):Nag 抑制 Byle: [θ] [3] [4] [5] [6] [7] [1] [2] bit19=Nag mUX=1 Bit(線性) Byte 遮罩 操作 含瓣 19 2 3 89x0 清θ 請握住方向:nag提醒 無输FSD是否龄用都必须虚理亚回。

八、CANID1021(0x3FD)-自動完整控制​

HN3/HW4共用,这是整個中最被雕的环息,承载所有FSD控制信號。 Mux 0(data[0]&0x07==0):FSD用 Byte: [8] [1] [2] [6] [4] [3] [5] [2] [7] speedoff bit59 b. bit38 bit46 =xnu nUX=θ HN4粤用 MEMH H3还度配置 HW3通 FSD窝 Bit( Byte内 遮 By 含瓣 H4 te 性) bit E 3 速度偏移原始值(6bit,以 8×7 2530 m 16 E 30為零整) E 取 3A 0x4 只 6 8E FSDUI遥操檬 8x4 置 46 FSD 使能 5 6 3 1 8x0 寓 4950 12 HV3速度配置(2 bit) 6 入 0x0 香1(可 59 照急重稀情测 7 3 8 0x1 置1 FSDv14使能(Hk4必须) 60 7 4 3 HW3速度偏移量讀取(Muxθ特有): raw=(data[3]> 1)&0x3F,镜 063, 以 36 為零贴: speedProfile rav值 raw - 30 速度偏移(km/h) 9 (Chill) 31 1 (Normal ) 1 5 2 (Hurry ) 32 10 2 完整轉换公式:speedoffset=clanp((raw-36)x5,0,180) Mux1(data[0]&0x07==1):Nag抑制+ASS解 [8] [2] Byte: [3] [4] [6] [7] [1] [5] bit19=Niag bit47=AS5 [=xnu Byte 内 Byt HW4 含额 性) bit e 罩 6x8 清 19 2 3 8 0 6x8 ASS (Actually Smart Sumno 置 47 7 1 n)地區限制解额 Mux2(data[0]&0x07==2):速度参数注入 HW3-speedoffset 跨位元組注入: 8-b1t 的 speei0ffset(θ-10B)被拆成雨段,分别存入Mux2帧的data[0]和 data[1]: speedoffset (8 bit)=[高6位 HHHHHH][低2位 LL] ↓ data[1] bit 85 data[a] bit B7 片段 遮票 存入位置 0xC0 低 2 位 (LL) data[0] 的 bit 67 JEX8 高 6位(HHHHHH) data[1] 的 bit 85 遇原公式:speedoffsel = ((data[1] & Bx3F]<< 2) | (data[θ] > 6) HN4-speedProfile 直接注入: Byte 7: bit 7 bit 6 bit 5 bit 4 bit 3 bit 2 bit 1 bit θ speedProfile (3 bit, 遮墨 8x78) Bit( Byte 遮罩 操作 性) t 离入 3-bit profile, profile << 6862 46 7 4 重要差翼:Hk4的Mux2無缘件轉發,不管FSD是否敏用。HV3的Mux2只在 FSD 故用時才尊貌。

九、CANID921(0x399)-ISA速度蜂鸣抑制​

值HN4,可選功能(预股盟)。 ISA(IntelLigent Speed Assistance,智燕速度辅助)是欧盟法规要求的超速蜂略功 能。此功能透過修改 DAS_status 訊息的一bit 来抑制。 [2] [3] [4] [5] [6] [7] [1] Byte: [8] bit5=抑制 校验和 遮罩 操作 含瓣 Bit(螺性) Byte 0x26 置1 41 抑制ISA 超速蜂吗 1 5 9-95 6xFF 重新計算 8-bit 校独和 7 副作用:放用後表板速限标喆圆示登为空白。 校融和演算法 这是整個端中唯一有校瞻和的讯息,其他所有CANID均無完整性校验。 計算步骤:累加 data[8]到data[6](共7個位元组),再加上CANID 921的低 8 位(8x99)與高8位(θx03),取结果的低8位离入data[7]。 計算项目 值 0x99 CAN ID 921 =6x8399 的低 8位 CAN ID 921-6x8399 的高 8位 06X8 雨者相加(固定常数) data[7] = (data[6] + + data[6] + θx9C) & 6xFF 瞻證能例: 原始帧 data =[0x10,6x05,8x08,0x80,0x80,6x90,6x06,7} 修改後 data[1]=6x85|0x20=0x25 校辅和 = 0x16 + Bx25 + Bx98x5+ 0x9C = 0xD1 → data[7] = xD]

十、完整Bit 快速查詢表​

線性B Byt 遮 Mu 操 CAN ID 含裁 作 it bit e X 0xE 杆位置pos(data 1315 57 69 1 [1]>>5) 1006 / 1 x8 8X0 清 Nag 抑制(所有重裂) 19 3 2 1 821 8 0x7 16 1021 HW3速度偏移raw值 2530 3 E FSDUI港標( 1066 / 1 ×4 38 4 9 8E 6 條件) 修件) 821 [S ISA蜂喘抑制(HW4可 @×2 置 921 41 5 通) 9 1 @x4 1866 / 1 置 46 FSD使能(所有重裂) 5 6 1 621 6x8 ASS 地区限制解(HW 置 1021 47 5 7 4) 8 1 速度配置bit9(HW3/ 1066 / 1 0x8 49 6 1 821 Legacy) 2 速度配置bit 1(HW3/ 0x8 1006 / 1 50 6 2 Legacy) 821 4 θxC HW3 speed0ffset 低 5455 1021 67 2位 HW3 speedoffset 高 x3 85 5661 1021 1 6位 F 8X0 1021 59 E 7 選) 8 1 θ×1 FSD v14 使能(Hk4必 置 1021 60 7 4 9 9 渠) 1 0×7 46 1021 HW4速度犯置(3bit) 6062 7 2 921 E99S ISA 校验和 7 F

十一、完整工作流程示例​

例1:HW4車辆FSD啟用流程 1使用奢在UI效红缘境具停止標社控制; 1車幅 CAN ID 1θ21,MUX B: (1=8E 1q)0x0 -[1e1ep 3開登板掘,晒取 bit 38=1 -FSDEnabled = truc 降改:cata[5] 1= 0x40(b1t 46,FSD 使) data[7] |= Bx18 (bit 69, FsD v14) data[7]|=BxBB(bit 59,聚急車幅慎测,可逻) 回登修改拨的帽 2車幅属择 CAN ID 1821, Mux 1(方向整 nag): 降改:data[2]6=~0x08(bit 19,清除nag) data[5] [= BxBe (bit 47, ASs 解镇) 整回 2平菊度播CANID1916(限車距津): 通取:data[5]高3位=followDistance-更新 speedProfile 不回 車幅播 CAN ID 1HZ1, MUX 2: 改:data[7] 的 bit 46 寫入 speedProfile 值 回發(無端FSD状思郁税行) 箱例2:Legacy車杆控制流程 1方向整操杆搬到位置3 桶属播 CAN ID69:data[1]-6x42 期發板情联: 0x42 >> 5 = 2 - speedProfile = 1(Normal) 1率幅CANID 1096,Mux0:data[4]-0x40 發板捐:FSDEnabled=true 改: data[5] |= @x4θ (bit 46 ) data[6]的 bit 1-2 m人 profile-1 - data[6] 1- 0x62 回發 3車幅演CANID 1896,MUX1: 修改:data[2]6=-0x08(bit 19, 清除nag)

例3:HW4ISA蜂抑制 車畅CANID921: data = [0x10, 0x05, 0x09, 09x00, 0x0e, 0x80, 0x00, 0x??} 闭登板修改: data[1] |= 0x20 ~ data[1] =0x25(bit 41, 抑制号) 重算校独和: sun = 0x18 + 0x25 + 0×5 + 0x9C = 0xD1 data[7] = xD1 回發:{0×10, 0x25, 0x00, 0x66, 0x00, 0x00, 0x80, 0xD1}

十二、關键行為遥辑​

FSD 状存:FSDErnabled只在Mux 0翰中更新,Mux 1 和 Mux 2沿用额存值。原因 是 Mux 1/2帧的 data[4](bit 38)通常為0,若每帧都重新取,判 FSD 已 图。正碴做法:Muxθ 错取盖额存-MuX1/2 耀承 Nag 抑制無件敦行:bit 19清6不受FSDEnabted影暮,即使只使用普通 Autopilot 也生效。 HN4Mux2無件回骤:Hiv4的Mux2速度配置注入永透行;HW3的Mux2需FSD 般用才敦行。 改最少的bit:整国系统只修改2-4因雨键bit,其鲶相位保持車棘原始值,最大程度保留 重辆自身的安全通辑。

十三、協安全性分析​

安全特性 状恩 借注 韶證機制 無 任何接入装置都能狼送 所有訊號明文傅翰 加密機制 無 校验和 部分 CAN ID 921 有 8-bit 累加和 机息来源验證 無 車朝不验值發送方身份 5细 CAN ID,的8 倡酮键 bit 攻型面 桓小 CAN题流排是魔播式逐流排,所有ECU共享同一對差分線(CAN-H/CAN-L),任何物理接 入的前點都有平等的送。运是20酸元關登板就能做到运些事的根本原因一非技術高 明,而是端本易的较計如此開放。 免聲明:本文仅用於技術研究與教育目的。在車CAN匯流排上發送未授權訊息可能 導致不可预期的行為,影響行車安全,可能達反當地法规及使車保固失效。

原始排版图​

发布于 2026-03-25 00:31:10（微信公众号导出记录）。

本文来自公众号后台的“导出文章内容”功能。博客正文由导出长图进行本地 OCR 转写，并保留原始排版图用于逐段核对。

原文链接：查看原文

OCR 转写有效文字约 7393 字；代码、流程图和版式以文末原始排版图为准。

正文（本地 OCR 转写）​

作者: Kenton Varda、 Sunil Pai、Ketan Gupta 去年九月 Cloudflare 推出了https://blog.cloudflare.con/code-mode/, 其核心理念是:代理不愿旅通通调用工具来行任移,而愿该撰客调用API的程式码。 CLoudflare 已经證明,催催将 MCP 伺服器换为 TypeScript API,就能减少 81% 的token使用量。Cloudflare 遗展示了程式碼模式可以在 MCP 何服器後方谨作,而 不是在前方,而創建了全新的CLoudflare MCP伺股器,用雨個工具和不到1,000 個 token 就零露了整個 Cloudflare API. 但是,如果代理(或MCP何服器)要缺行AI即時生成的程式碼来完成任務,道段程式碼需 要一但通行场所,而個场所必须是安全的。你不能直接在惠用程式中eval()AI生成的程 式碼:照意使用者可以醒易地提示AI注入漏润。 你需要一個沙盒:一個與你的鹰用程式和世界其他地方隔魅的地方,只有程式碼预期访同的特定 功能才能被使用。

為什需要新的沙盒方案? 沙盒是AI行案的熟门話题。对於道回任務,大多數人會選择容器。使用基於Linux的容 器,你可以啟勤任何你想的程式砖敦行填境。Ctoudflare甚至為此提供了容器谨行時和沙 盒SDK 但容器昂贵且敏勤慢,需要数百毫秒来敬助,通行时需要数百兆字節的記倦體,你可能需要保 持它們的熟度以澄免延逻,亚且可能盲试圆為多個任猜重用现有容器,这會损害安全性。 如果想要支援消費者级别的代理,旗每因懿端使用者都有一個代理(或多因!),而且每姻代理 都程式码,那度容器是不萄的。需要更量的束西。 而现在Cloudflare摄有了它。 動態Worker载入器:精簡的沙盒 在CLoudflare去年九月的程式码模式文章中,隐藏著一個新的囊性功能的公告:勤 Worker 截入器 API. 运個 API 允許 Cloudflare Worker 即時實例化一新的 Worker,它位於自已的沙盒 中,程式码在運行時指定,全部都是即時完成的。 勤想Worker载入器现在虑於公開测試段,所有付費的Workers使用者都可以使用。 使用方式 阅遍文件以遵取完整详细資讯,但它的使用方式如下: 1//确你的LLM生成像得的程式码 let agentcade: string = cxport default ( async myAgent(param, env, ctx) { //

10/I接取代表代理密鼓能购防周的API的RPC 存根。 11//(道可以是您定兼的任何 Workers RPC API。) 12let chatRoonRpcStub = ...· I 3 14//使用worker戴入器锦定载入一需worker束通行程式碼。 let worker = env.LoADER.load({ //指定程式强 conpatibilityDate: 2826-03-01, mainModule: *agent,js", nodules: {*agent.js": agentcode }, //給予代理纺間那天室API的耀原。 env: { CHAT_RoOM: chatRoomRpcStub }, 1/限止解碍網路防司。(您也可以据账它。 globaloutbound: null, }) ; //钢用代理程式码尊出的RPC方法 aait worker . getEntrypoint() .myAgent(paran) : 就道样。 速度快100倍 勤Workers使用奥整個CloudflareWorkers平台自八年来一直横建的相同底層沙盒 機制:isolates(隔雕執行個體)。Isolate 是V8 JavaScript 行引擎的實例,與 Google Chrome 使用的引肇相同。 般動一1solate只需要毫秒,使用兆字部的配愉體。這比典型的容器:

• 快的100倍

• 記憶效率高10-100倍

無限展性 许多基於容器的沙盒提供商到全域發沙盒和沙盒建立速率施加了限制感Worker载人器 没有這檬的限制。 它不需要,因為它只是一API,用於防周一直為Cloudflare平台提供動力的相同技術, 而旅技術一直允許Workers無缝携展到每秒数百黄個请求, 想要虚理每秒一百萬請求,每請求都鼓入一個單猫的動Worker沙盒,全部發谨 行?没同题!

零延運​

一次性勤慧Workers通常與建立它竹的Worker在同一台機器上谨行-—甚至在同一個行​

上。無需在世界凰内通信以找到熟沙盒。Isolates 如此轻量,Cloudflare 可以在請求 到達的任何地方通行它們 勤想Workers 在Cloudflare 全球徽百回位置中的每一個都受到支援。 全是JavaScript 與容器相比,唯一的缺贴是你的代理需要换离JavaScript。 技術上,Workers(包括動服的)可以使用 Python 和 WebAssembly,但封於小程序式 但射於小程序式 码片段——比如代理按需撰的程式碍-—JavaScript曾载入和通行得快得多。 人频倾向於对程式語言有強烈的偏好,然許多人喜JavaScript,但其他人可能更喜款 Python、Rust 或無数其他語言。 但這程被的不是人類,而是AI。 AI 會撰离你要的任何語言。LLM是每種主要语言的需家。它們在 JavaScript 方面的訓l 辣數據定照大的。 JavaScript本置上是為沙盒而設計的,因為它在網路上的特性。它是谊项工作的正確語言。 用TypeScript定羲的工具 如果希望代理能做任何有用的事情,它需要舆外部API通信。如何告薪它可以防周哪些 API ?

• MCP定教了平面工具调用的架标,但没有定教程式設計API

• OpenAPI提供了一程表篷RESTAPI的方式,但它在架榻本身和调用它所需藻高的程式

碼方面都很長 對於暴露给JavaScript 的API,有一国明题的答案:TypeScript. 代理了解TypeScript。TypeScript 的設计紧。用很少的 token,你就可以绘你的代理 對你的API 的精確理解。 TypeScript vs OpenAPI 11舅聊天室交互的介面。 interface ChatRoon { //殖取哪天记的最後“Tinit账滑息。 getHistory(linit: nunber): PronisccMessage[]>; //辽院新消息。丢案返回的物件以取消打院。 subscribe(callback: (msg: Messagc) => void): Pronisc<disposable>; /1在刷天中發布消息。 post(text: string): Pronisccvoid>; type Messagc = ( author: string; tine: Date; text: string; CLoudflare 為TypeScript API更好。它使用更少的token,蓝且更容易理解(对 於代理和人類来)。 勤器Worker 截入器使得在你自己的Worker 中實現這様的 TypeScript API 得容易, 然後游其作為方法参数或在env物件中傅退给勤题Worker。Cloudflare Workers 通行 時將自勤在沙盒和控制代碼程式码之同建立Cap'nWebRPC标,以便代理可以跨安全遗界 用你的API,而提不意链到它不是在使用本地康。 代理可以這檬寫代碼 1//思考:使用害要求我缘结来白ALice的最近募天消息。 11我在程式碍中通温最近的游息愿史,道裱我只需要情取相的消息。 let history - aMait env.CHAT_RooM-getHistory(100o) ; return history-flter(nsg => msg-author == "alice*);

HTTP過滤和證注入 如果你更喜数绘你的代理HTTP API,那完金支援。使用worker戴入器API的 globaLOutbound選项,你可以册一個在每個 HTTP 部求時調用的回調,在其中你可以橡 查請求、重离它、注入身份验谊密输、直接喜应它、阻止它,或任何你可能想做的事情。 例如,你可以使用它来實现恶證注入(token注入):常代理向需要授權的服務壁出HTTP請 求時,你在错求外出時添加造。这檬,代理本身微不知道秘密源證,因此不可能流露它们 TypeScript vs HTTP 括如此,在疫有相容性要求的情况下,TypeScript RPC介面侵龄HTTP: 侵势 说明 Token更 TypeScript 介面需要比 HTTP 介面少得多的 token 来描述 少 代碼更間 代理可以摘离程式码来調用Type5cript介面,使用的token比等效的H TTP少得多 安全性更 使用Type5cript介面,更客易缩小介面以暴露你想要提供给代理的功能 高 實现更間 只需撰察一個TypeScript包装器,它只實现你想要允許的功能 單 經過實考驗的安全性 强化基於isolate的沙盒是耕手的,因為它比硬虚提概是更覆離的攻擎面。虽然所有沙盒 楼制都有错膜,但V8中的安全错比典型虚凝機管理程式中的安全锚联更常見。当使用 isolates来沙盒可能恶意的程式碼時,携有外的深应防震屑很重要。 cloudflare的安全優 Cloudflare 有近十年的翘睡来保基於1solate 的平台:

• 自勤部警安全捕丁:Cloudflare的系统在数小时内自動將V8安全祎丁部警到生產跟境

—比 Chrome本身退快

• 二沙盒架:Cloudflare的安全架棉具有定制的二屠沙盒,根據围险评信動態隔雕租户

• 硬體增强:CLoudflLare播展了V8沙盒本身以利用像MPK道模的硬疆功能

• 前沿研究:CLoudflare 與(亚用了)领先的研究人員合作,开髮針對Spectre 的新

防紧措施

• 意代码描:Cloudflare有系统播描程式琪中的照盒模式自動阻止它們或应用额外

的沙盒屋 當你在CLoudflare上使用勤Workers 時,你會自勤獲得所有這些功能。 辅助工具库 Cloudflare横建了一些你在使用勤Workers 時可能觉得有用的率:

1.程式碼模式(@cloudflare/codemode)​

简化了使用勐慧Workers对AI工具速行模型生成的程式碼。其核心是DynanicwarkerExe cutar{》,它模建了一專用的沙盒,具有程式碼正规化功能来虑理常見的格式錯误,以及直接 防周globalOutbound擅取器来控制沙盒内部的fetch[)行為。 const executor = new DynamicWorkerExecutor(4 Loader: env.LoADER, globaloutbound:null,//完全隔舱 )); }}; const codenode = creetecodeTool({ tools: myTools, executor, )); return generateText({ nodel, nessages, tools: { codenode },

2.打包工具(@cloudflare/worker-bundler)​

勤Workers 需要预打包的模组。ecloudflare/worker-bundler為你虚理运個:给它源 文件和package.json,它册表解析npm 依精项,用esbuild 打包所有内容,蓝返回 Worker 酸入器期望的模组映射。

const worker = env.LoADER.get(ny-worker", async () => { cDnst { mainModule, modules } = wwnit createMorker[{ files:{ "src/index.ts": 1,auoy. unuf { auon } iuodaj import { cors } fron “hono/cors':; canst app = new Hono(); app.use(**, cors{)); app.get(/', (c) => c.text(Hette fron Hono!)): app-get(/json', {c) => c.json(f message: It works! )); :dde lineap lodxa "package-json: Json,stringify({ dependencies: {hono: ^4.0.0"} }1 :({ rcturn {mainodule, modules, conpatibilityDate: “2826-91-91 }; amait worker.getEntrypoint() fetch(request);

3.文件操作(@cloudflare/shelL)​

read、write、search、replace、diff、glob、JSoN 查物/更新、archive——具有结標 化翰入和输出,而不是字串解析。

inport { DynamicMorkerExecutor, resolveProvider } from "@cloudflare/cα const workspace = new workspace(( sql:this.ctx.storage.sql。 // 用龄任何 Do 的 SqLStorage、D2 或自定薇 St r2:this.env.MY_BUCKET,// 大文件白融溢出到 R2 name:()=>this.name//增情--在需要解析,而不是在桥造时 >) ; 11//程式码在泣有蜗络防向的隔雕Worker沙盒中通行 Const executor = new DynamicWorkerExecutor(< Loader: env.LoADER ): 14//LLM高迹段程式码:state.旗用通返RPC度回主 const result = aMalt executor.execute( )<= (1 su/se, //在所有Type5cript 文件中擅索模式 1/落多次编骄舒副物單四事验 const plan - awalt state.planEdits([ { kind: *replace", path: /src/app.ts, { kind: *writeJson", path: "/src/config-json", value: { version: 2 3 } 11; 11原子原用—失险時回滨 return await state.applyEditPlan(plan): [resolveProvider(stateTools(workspace))]

實際愿用案例 程式碼模式 關者希望他們的代理撰和執行針對工具API的程式碼,而不是一次一個地追行顺序工具调 用。使用勤慧 Workers,LLM 生成一個 TypeScript 函敏,多图 API 用疑接在一 起,在動Worker中谨行它,亚將最结果返回绘代理。 结果:只有输出,而不是每個中耀步骤,显终會出现在上下文窦口中。這流少了延逗和token 使用,亚座生更好的结果,特别是當工具表面很大時。 Cloudflare 自家的CLoudflareMCP同服器正是以道種方式橘建的:它堡通退雨個工具 —search 和 execute—在不到 1,Bo9 token 中暴露了整 Cloudflare API. 建自定羲自動化 間發者正在使用勤感Workers银代理即時概建自定自勤化。 例如,Zite正在橘建一個愿用程式平台,使用者通退聊天介面進行交互-—LLM在幕後撰寡 TypeScript 来机建CRUD 唐用程式,連接到Stripe、Airtable 和Google Calendar等服務,運行後端通辑,所有这些都無需使用者看到一行程式码。 To enable server-side code for Zite's LLM-generated apps, we needed an execution layer that was instant, isolated, and secure. Cloudflare's Dynamic Workers hit the mark on all three, and out- perforned all of the other platforms we benchmarked for speed and library support. The NodeJS compatible runtine supported all of Zite′s workflows, allowing hundreds of third party integrations, without sacrificing on startup time. Zite now services millions of execution requests daily thanks to Dynamic Workers.J Antony Toron,CTo 和聊合創始人,Zite 運行AI生成的應用程式 開發者正在構建AI生成完整應用程式的平台—無是為了他們的客户還是為了構建原型的 内部图除。 内部團隧。 使用動態Workers:

• 每個應用程式都可以按需動

• 然後放回冷存,直到再次被調用

• 快速動時間使得在活動開發期間预更改變得容易

• 平台還可以阻止或截生成的程式碼發出的任何網絡請求,使AI生成的應用程式可以安全

運行 定價 動熊载入的Workers按每天载入的每個唯一Worker$0.002定價(截至本文發布時), 除了常规WorkerS的通常CPU時間和調用定價之外。 對於AI生成的「程式碼模式」用例,其中每個Worker都是唯一的臨時的,這意味著價格為 每個载入的Worker$0.002(加上CPU和調用)。這填成本與生成程式碼的推理成本相比 通常可以忽略不計。 在測試段,$0.002的費用被免除。由於定價可能會燮化,請始終查看Cloudflare 的動態Workers定價以獲取最新資訊。

原始排版图​