@dshtrading/kit-crypto 0.1.0

package/lib/derivatives.d.ts

@@ -0,0 +1,18 @@
+import { DerivativesData } from "./api/lib/index.js";
+//#region src/derivatives.d.ts
+interface DerivativesFetchOptions {
+  symbol: string;
+  fetch?: typeof globalThis.fetch;
+}
+interface DerivativesResult {
+  data?: DerivativesData;
+  unavailable?: string[];
+}
+/** 将输入 symbol 规范化为 Binance USDT-M 合约 symbol（如 BTCUSDT）。 */
+declare function normalizeBinanceFuturesSymbol(raw: string): string;
+/** 提取 base 资产名称（如 BTCUSDT → BTC）。 */
+declare function extractBaseAsset(symbol: string): string;
+declare function fetchCryptoDerivatives(options: DerivativesFetchOptions): Promise<DerivativesResult>;
+declare function renderDerivativesData(result: DerivativesResult, requestedSymbol: string): string;
+//#endregion
+export { DerivativesFetchOptions, DerivativesResult, extractBaseAsset, fetchCryptoDerivatives, normalizeBinanceFuturesSymbol, renderDerivativesData };

package/lib/derivatives.js

@@ -0,0 +1,110 @@
+//#region src/derivatives.ts
+const BINANCE_FAPI_BASE = "https://fapi.binance.com";
+const BINANCE_FUTURES_DATA_BASE = "https://fapi.binance.com/futures/data";
+/** 将输入 symbol 规范化为 Binance USDT-M 合约 symbol（如 BTCUSDT）。 */
+function normalizeBinanceFuturesSymbol(raw) {
+	const clean = raw.trim().toUpperCase().replace(/[-_]/g, "");
+	if (clean.endsWith("SWAP")) return clean.slice(0, -4);
+	return clean;
+}
+/** 提取 base 资产名称（如 BTCUSDT → BTC）。 */
+function extractBaseAsset(symbol) {
+	const norm = normalizeBinanceFuturesSymbol(symbol);
+	for (const q of [
+		"USDT",
+		"USDC",
+		"BUSD",
+		"USD"
+	]) if (norm.endsWith(q) && norm.length > q.length) return norm.slice(0, -q.length);
+	return norm;
+}
+async function fetchCryptoDerivatives(options) {
+	const fetchImpl = options.fetch ?? globalThis.fetch;
+	const symbol = normalizeBinanceFuturesSymbol(options.symbol);
+	const unavailable = [];
+	let openInterest;
+	let openInterestValue;
+	let longShortRatio;
+	let topTraderLongShortRatio;
+	let takerBuySellRatio;
+	let fundingRate;
+	let timestamp = Date.now();
+	try {
+		const res = await fetchImpl(`${BINANCE_FAPI_BASE}/fapi/v1/openInterest?symbol=${encodeURIComponent(symbol)}`, { headers: { accept: "application/json" } });
+		if (res.ok) {
+			const json = await res.json();
+			if (json.openInterest) openInterest = Number(json.openInterest);
+			if (json.time) timestamp = json.time;
+		} else unavailable.push(`binance-oi: HTTP ${res.status}`);
+	} catch (err) {
+		unavailable.push(`binance-oi: ${err instanceof Error ? err.message : String(err)}`);
+	}
+	try {
+		const res = await fetchImpl(`${BINANCE_FUTURES_DATA_BASE}/globalLongShortAccountRatio?symbol=${encodeURIComponent(symbol)}&period=1h&limit=1`, { headers: { accept: "application/json" } });
+		if (res.ok) {
+			const arr = await res.json();
+			if (Array.isArray(arr) && arr.length > 0 && arr[0]?.longShortRatio) longShortRatio = Number(arr[0].longShortRatio);
+		} else unavailable.push(`binance-global-ls: HTTP ${res.status}`);
+	} catch (err) {
+		unavailable.push(`binance-global-ls: ${err instanceof Error ? err.message : String(err)}`);
+	}
+	try {
+		const res = await fetchImpl(`${BINANCE_FUTURES_DATA_BASE}/topLongShortPositionRatio?symbol=${encodeURIComponent(symbol)}&period=1h&limit=1`, { headers: { accept: "application/json" } });
+		if (res.ok) {
+			const arr = await res.json();
+			if (Array.isArray(arr) && arr.length > 0 && arr[0]?.longShortRatio) topTraderLongShortRatio = Number(arr[0].longShortRatio);
+		} else unavailable.push(`binance-top-ls: HTTP ${res.status}`);
+	} catch (err) {
+		unavailable.push(`binance-top-ls: ${err instanceof Error ? err.message : String(err)}`);
+	}
+	try {
+		const res = await fetchImpl(`${BINANCE_FUTURES_DATA_BASE}/takerlongshortRatio?symbol=${encodeURIComponent(symbol)}&period=1h&limit=1`, { headers: { accept: "application/json" } });
+		if (res.ok) {
+			const arr = await res.json();
+			if (Array.isArray(arr) && arr.length > 0 && arr[0]?.buySellRatio) takerBuySellRatio = Number(arr[0].buySellRatio);
+		} else unavailable.push(`binance-taker-vol: HTTP ${res.status}`);
+	} catch (err) {
+		unavailable.push(`binance-taker-vol: ${err instanceof Error ? err.message : String(err)}`);
+	}
+	try {
+		const res = await fetchImpl(`${BINANCE_FAPI_BASE}/fapi/v1/fundingRate?symbol=${encodeURIComponent(symbol)}&limit=1`, { headers: { accept: "application/json" } });
+		if (res.ok) {
+			const arr = await res.json();
+			if (Array.isArray(arr) && arr.length > 0 && arr[0]?.fundingRate) fundingRate = Number(arr[0].fundingRate);
+		} else unavailable.push(`binance-funding: HTTP ${res.status}`);
+	} catch (err) {
+		unavailable.push(`binance-funding: ${err instanceof Error ? err.message : String(err)}`);
+	}
+	if (openInterest !== void 0 || longShortRatio !== void 0 || topTraderLongShortRatio !== void 0 || takerBuySellRatio !== void 0 || fundingRate !== void 0) return {
+		data: {
+			symbol: `${symbol}-SWAP`,
+			source: "binance-futures-public",
+			openInterest,
+			openInterestValue,
+			longShortRatio,
+			topTraderLongShortRatio,
+			takerBuySellRatio,
+			fundingRate,
+			timestamp
+		},
+		unavailable
+	};
+	return { unavailable };
+}
+function renderDerivativesData(result, requestedSymbol) {
+	const { data, unavailable = [] } = result;
+	if (!data) return `crypto_get_derivatives ${requestedSymbol}: no derivative data available.${unavailable.length > 0 ? ` (errors: ${unavailable.join("; ")})` : ""}`;
+	const lines = [`crypto_get_derivatives ${data.symbol} (source: ${data.source}, updated: ${new Date(data.timestamp).toISOString()}):`];
+	if (data.openInterest !== void 0) lines.push(`- Open Interest (OI): ${data.openInterest.toLocaleString()} base-coins`);
+	if (data.fundingRate !== void 0) {
+		const pct = (data.fundingRate * 100).toFixed(4);
+		lines.push(`- Latest Funding Rate: ${data.fundingRate} (${pct}%)`);
+	}
+	if (data.longShortRatio !== void 0) lines.push(`- Global Long/Short Account Ratio: ${data.longShortRatio.toFixed(2)} (Accounts)`);
+	if (data.topTraderLongShortRatio !== void 0) lines.push(`- Top Trader Position L/S Ratio: ${data.topTraderLongShortRatio.toFixed(2)} (Whale Positions)`);
+	if (data.takerBuySellRatio !== void 0) lines.push(`- Taker Buy/Sell Volume Ratio: ${data.takerBuySellRatio.toFixed(2)} (Market taker aggressiveness)`);
+	if (unavailable.length > 0) lines.push(`  (partially unavailable sub-queries: ${unavailable.join("; ")})`);
+	return lines.join("\n");
+}
+//#endregion
+export { extractBaseAsset, fetchCryptoDerivatives, normalizeBinanceFuturesSymbol, renderDerivativesData };

package/lib/fundamentals.d.ts

@@ -0,0 +1,19 @@
+import { CryptoFundamentals, FundamentalsPackage } from "./api/lib/index.js";
+//#region src/fundamentals.d.ts
+interface CryptoFundamentalsOptions {
+  symbol: string;
+  fetch?: typeof globalThis.fetch;
+}
+interface CryptoFundamentalsResult {
+  data?: CryptoFundamentals;
+  quoteVolume24h?: number;
+  priceChangePercent24h?: number;
+  tradesCount24h?: number;
+  unavailable?: string[];
+}
+declare function fetchCryptoFundamentals(options: CryptoFundamentalsOptions): Promise<CryptoFundamentalsResult>;
+/** 获取完整加密资产基本面数据包。 */
+declare function fetchCryptoFundamentalsPackage(symbol: string, fetchImpl?: typeof globalThis.fetch): Promise<FundamentalsPackage>;
+declare function renderCryptoFundamentals(result: CryptoFundamentalsResult, requestedSymbol: string): string;
+//#endregion
+export { CryptoFundamentalsOptions, CryptoFundamentalsResult, fetchCryptoFundamentals, fetchCryptoFundamentalsPackage, renderCryptoFundamentals };

package/lib/fundamentals.js

@@ -0,0 +1,154 @@
+import { extractBaseAsset } from "./derivatives.js";
+//#region src/fundamentals.ts
+const COINCAP_API_BASE = "https://api.coincap.io/v2";
+const BINANCE_API_BASE = "https://api.binance.com";
+/** 上游超时（2026-09-02 整改）：防公共端点挂起拖死桥请求。 */
+const UPSTREAM_TIMEOUT_MS = 1e4;
+const COMMON_COIN_ID_MAP = {
+	BTC: "bitcoin",
+	ETH: "ethereum",
+	SOL: "solana",
+	BNB: "binance-coin",
+	XRP: "ripple",
+	DOGE: "dogecoin",
+	ADA: "cardano",
+	AVAX: "avalanche-2",
+	DOT: "polkadot",
+	LINK: "chainlink",
+	MATIC: "polygon",
+	POL: "polygon-ecosystem-token",
+	NEAR: "near",
+	SUI: "sui",
+	APT: "aptos",
+	PEPE: "pepe",
+	SHIB: "shiba-inu",
+	UNI: "uniswap",
+	LTC: "litecoin",
+	BCH: "bitcoin-cash"
+};
+async function fetchCoinCapAsset(base, fetchImpl) {
+	const directId = COMMON_COIN_ID_MAP[base];
+	if (directId) try {
+		const res = await fetchImpl(`${COINCAP_API_BASE}/assets/${directId}`, {
+			headers: { accept: "application/json" },
+			signal: AbortSignal.timeout(UPSTREAM_TIMEOUT_MS)
+		});
+		if (res.ok) {
+			const json = await res.json();
+			if (json.data) return json.data;
+		}
+	} catch {}
+	const res = await fetchImpl(`${COINCAP_API_BASE}/assets?search=${encodeURIComponent(base)}&limit=5`, {
+		headers: { accept: "application/json" },
+		signal: AbortSignal.timeout(UPSTREAM_TIMEOUT_MS)
+	});
+	if (!res.ok) throw new Error(`HTTP ${res.status}`);
+	const list = (await res.json()).data ?? [];
+	return list.find((item) => item.symbol.toUpperCase() === base) ?? list[0];
+}
+async function fetchCryptoFundamentals(options) {
+	const fetchImpl = options.fetch ?? globalThis.fetch;
+	const rawSymbol = options.symbol.trim().toUpperCase();
+	const base = extractBaseAsset(rawSymbol);
+	const binancePair = `${base}USDT`;
+	const unavailable = [];
+	let coincapAsset;
+	try {
+		coincapAsset = await fetchCoinCapAsset(base, fetchImpl);
+	} catch (err) {
+		unavailable.push(`coincap: ${err instanceof Error ? err.message : String(err)}`);
+	}
+	let quoteVolume24h;
+	let priceChangePercent24h;
+	let tradesCount24h;
+	try {
+		const res = await fetchImpl(`${BINANCE_API_BASE}/api/v3/ticker/24hr?symbol=${encodeURIComponent(binancePair)}`, {
+			headers: { accept: "application/json" },
+			signal: AbortSignal.timeout(UPSTREAM_TIMEOUT_MS)
+		});
+		if (res.ok) {
+			const ticker = await res.json();
+			if (ticker.quoteVolume) quoteVolume24h = Number(ticker.quoteVolume);
+			if (ticker.priceChangePercent) priceChangePercent24h = Number(ticker.priceChangePercent);
+			if (ticker.count !== void 0) tradesCount24h = ticker.count;
+		} else unavailable.push(`binance-24hr: HTTP ${res.status}`);
+	} catch (err) {
+		unavailable.push(`binance-24hr: ${err instanceof Error ? err.message : String(err)}`);
+	}
+	if (coincapAsset) {
+		const rank = Number(coincapAsset.rank);
+		const marketCapUsd = Number(coincapAsset.marketCapUsd);
+		const circulatingSupply = Number(coincapAsset.supply);
+		const totalSupply = coincapAsset.maxSupply ? Number(coincapAsset.maxSupply) : void 0;
+		const volume24hUsd = Number(coincapAsset.volumeUsd24Hr);
+		const priceUsd = Number(coincapAsset.priceUsd);
+		const fdvUsd = totalSupply && Number.isFinite(priceUsd) ? totalSupply * priceUsd : void 0;
+		return {
+			data: {
+				symbol: rawSymbol,
+				name: coincapAsset.name,
+				rank: Number.isFinite(rank) ? rank : void 0,
+				marketCapUsd: Number.isFinite(marketCapUsd) ? marketCapUsd : void 0,
+				fdvUsd: fdvUsd && Number.isFinite(fdvUsd) ? fdvUsd : void 0,
+				circulatingSupply: Number.isFinite(circulatingSupply) ? circulatingSupply : void 0,
+				totalSupply: totalSupply && Number.isFinite(totalSupply) ? totalSupply : void 0,
+				volume24hUsd: Number.isFinite(volume24hUsd) ? volume24hUsd : void 0,
+				timestamp: Date.now()
+			},
+			quoteVolume24h,
+			priceChangePercent24h,
+			tradesCount24h,
+			unavailable
+		};
+	}
+	if (quoteVolume24h !== void 0) return {
+		data: {
+			symbol: rawSymbol,
+			name: base,
+			volume24hUsd: quoteVolume24h,
+			timestamp: Date.now()
+		},
+		quoteVolume24h,
+		priceChangePercent24h,
+		tradesCount24h,
+		unavailable
+	};
+	return { unavailable };
+}
+/** 获取完整加密资产基本面数据包。 */
+async function fetchCryptoFundamentalsPackage(symbol, fetchImpl = globalThis.fetch) {
+	const quoteRes = await fetchCryptoFundamentals({
+		symbol,
+		fetch: fetchImpl
+	});
+	const base = extractBaseAsset(symbol);
+	return {
+		market: "crypto",
+		symbol,
+		crypto: quoteRes.data,
+		profile: {
+			symbol,
+			name: quoteRes.data?.name ?? base,
+			industry: "Blockchain / Cryptocurrency",
+			sector: "Digital Asset",
+			description: `${quoteRes.data?.name ?? base} 是全球主流加密数字资产，提供去中心化网络价值与交易结算能力。`
+		}
+	};
+}
+function renderCryptoFundamentals(result, requestedSymbol) {
+	const { data, quoteVolume24h, priceChangePercent24h, tradesCount24h, unavailable = [] } = result;
+	if (!data) return `crypto_get_fundamentals ${requestedSymbol}: no fundamental data available.${unavailable.length > 0 ? ` (errors: ${unavailable.join("; ")})` : ""}`;
+	const lines = [`crypto_get_fundamentals ${data.symbol}${data.name ? ` (${data.name})` : ""}:`];
+	if (data.rank !== void 0) lines.push(`- Global Market Cap Rank: #${data.rank}`);
+	if (data.marketCapUsd !== void 0) lines.push(`- Market Cap: \$${data.marketCapUsd.toLocaleString(void 0, { maximumFractionDigits: 0 })} USD`);
+	if (data.fdvUsd !== void 0) lines.push(`- Fully Diluted Valuation (FDV): \$${data.fdvUsd.toLocaleString(void 0, { maximumFractionDigits: 0 })} USD`);
+	if (data.circulatingSupply !== void 0) lines.push(`- Circulating Supply: ${data.circulatingSupply.toLocaleString()} coins`);
+	if (data.totalSupply !== void 0) lines.push(`- Total / Max Supply: ${data.totalSupply.toLocaleString()} coins`);
+	if (data.volume24hUsd !== void 0) lines.push(`- 24h Volume (Global): \$${data.volume24hUsd.toLocaleString(void 0, { maximumFractionDigits: 0 })} USD`);
+	if (priceChangePercent24h !== void 0) lines.push(`- 24h Price Change: ${priceChangePercent24h > 0 ? "+" : ""}${priceChangePercent24h.toFixed(2)}%`);
+	if (tradesCount24h !== void 0) lines.push(`- 24h Trades Count (Binance Spot): ${tradesCount24h.toLocaleString()} trades`);
+	if (unavailable.length > 0) lines.push(`  (partially unavailable sources: ${unavailable.join("; ")})`);
+	return lines.join("\n");
+}
+//#endregion
+export { fetchCryptoFundamentals, fetchCryptoFundamentalsPackage, renderCryptoFundamentals };

package/lib/index.d.ts

@@ -0,0 +1,27 @@
+import { CryptoFundamentalsOptions, CryptoFundamentalsResult, fetchCryptoFundamentals, fetchCryptoFundamentalsPackage, renderCryptoFundamentals } from "./fundamentals.js";
+import { DerivativesFetchOptions, DerivativesResult, extractBaseAsset, fetchCryptoDerivatives, normalizeBinanceFuturesSymbol, renderDerivativesData } from "./derivatives.js";
+import { AggregateNewsOptions, AggregateNewsResult, NewsItem, NewsSource, aggregateNews, deriveSymbolTokens, parseCryptoPanic, parseRss2 } from "./news.js";
+import Schema from "@deepseek-ai/schemastery";
+import { SkillProvider } from "@deepseek-ai/dsh-skill";
+import { Context } from "@deepseek-ai/cordis";
+//#region src/index.d.ts
+declare const provider: SkillProvider;
+interface Config {
+  dryRun: boolean;
+  liveTrading: boolean;
+}
+declare const Config: Schema<Config>;
+declare const inject: string[];
+declare const name = "dsh-trading-crypto-kit";
+declare function apply(ctx: Context, _config: Config): void;
+declare function createGetDerivativesTool(options?: {
+  fetch?: typeof globalThis.fetch;
+}): import("@deepseek-ai/dsh-tools").ToolDefinition;
+declare function createGetFundamentalsTool(options?: {
+  fetch?: typeof globalThis.fetch;
+}): import("@deepseek-ai/dsh-tools").ToolDefinition;
+declare function createGetNewsTool(toolOptions?: {
+  cryptoPanicKey?: string;
+}): import("@deepseek-ai/dsh-tools").ToolDefinition;
+//#endregion
+export { AggregateNewsOptions, AggregateNewsResult, Config, CryptoFundamentalsOptions, CryptoFundamentalsResult, DerivativesFetchOptions, DerivativesResult, NewsItem, NewsSource, aggregateNews, apply, createGetDerivativesTool, createGetFundamentalsTool, createGetNewsTool, deriveSymbolTokens, extractBaseAsset, fetchCryptoDerivatives, fetchCryptoFundamentals, fetchCryptoFundamentalsPackage, inject, name, normalizeBinanceFuturesSymbol, parseCryptoPanic, parseRss2, provider, renderCryptoFundamentals, renderDerivativesData };

package/lib/index.js

@@ -0,0 +1,323 @@
+import { aggregateNews, deriveSymbolTokens, parseCryptoPanic, parseRss2 } from "./news.js";
+import { extractBaseAsset, fetchCryptoDerivatives, normalizeBinanceFuturesSymbol, renderDerivativesData } from "./derivatives.js";
+import { fetchCryptoFundamentals, fetchCryptoFundamentalsPackage, renderCryptoFundamentals } from "./fundamentals.js";
+import { readFile } from "node:fs/promises";
+import { fileURLToPath } from "node:url";
+import Schema from "@deepseek-ai/schemastery";
+import { BUNDLED_SKILL_RANK } from "@deepseek-ai/dsh-skill";
+import { defineTool } from "@deepseek-ai/dsh-tools";
+//#region src/index.ts
+/**
+* Crypto 工具箱插件（dsh-trading crypto 切片）。
+*
+* 包含：
+*   1. skill provider：crypto-risk-checklist、crypto-instrument-analysis、indicator-authoring、trading-strategy-paradigms、knowledge-curation 与 trading-notes-setup 随包分发；
+*   2. crypto_funding_rate（Binance 公共资金费率）；
+*   3. crypto_get_news（动态聚合新闻）；
+*   4. crypto_get_derivatives 与 crypto_get_fundamentals 工具；
+*   5. indicator_author 创作工具（Issue #19）；
+*   6. knowledge_ingest 与 knowledge_search 知识库工具（Issue #24）。
+*
+* @module @dshtrading/kit-crypto
+*/
+const PROVIDER_NAME = "dsh-trading-crypto";
+const SKILL_BODY_URL = new URL("../assets/skills/crypto-risk-checklist.md", import.meta.url);
+const ANALYSIS_BODY_URL = new URL("../assets/skills/crypto-instrument-analysis.md", import.meta.url);
+const AUTHORING_BODY_URL = new URL("../assets/skills/indicator-authoring.md", import.meta.url);
+const STRATEGY_BODY_URL = new URL("../assets/skills/trading-strategy-paradigms.md", import.meta.url);
+const KNOWLEDGE_CURATION_BODY_URL = new URL("../assets/skills/knowledge-curation.md", import.meta.url);
+const JOURNAL_BODY_URL = new URL("../assets/skills/trading-notes-setup.md", import.meta.url);
+const RESOURCE_BASE = {
+	kind: "directory",
+	path: fileURLToPath(new URL("../assets/skills/", import.meta.url))
+};
+const CANDIDATE = {
+	name: "crypto-risk-checklist",
+	description: "加密合约交易风控检查清单：开仓前逐项核对杠杆、仓位、资金费率与强平价。",
+	invocation: {
+		modelInvocable: true,
+		userInvocable: true
+	},
+	provider: PROVIDER_NAME,
+	source: "bundled",
+	resourceBase: RESOURCE_BASE,
+	rank: BUNDLED_SKILL_RANK,
+	locator: SKILL_BODY_URL
+};
+const SKILL_CANDIDATES = [
+	CANDIDATE,
+	{
+		name: "crypto-instrument-analysis",
+		description: "加密标的定性分析框架：趋势结构→量价→波动率→资金面→新闻面五步，输出带依据与反方情景的定性结论。",
+		invocation: {
+			modelInvocable: true,
+			userInvocable: true
+		},
+		provider: PROVIDER_NAME,
+		source: "bundled",
+		resourceBase: RESOURCE_BASE,
+		rank: BUNDLED_SKILL_RANK,
+		locator: ANALYSIS_BODY_URL
+	},
+	{
+		name: "indicator-authoring",
+		description: "自定义技术指标创作指南：根据用户自然语言需求生成符合契约的指标代码（TD9/SuperTrend/OBV+MA等），并通过 indicator_author 工具验证与落库。",
+		invocation: {
+			modelInvocable: true,
+			userInvocable: true
+		},
+		provider: PROVIDER_NAME,
+		source: "bundled",
+		resourceBase: RESOURCE_BASE,
+		rank: BUNDLED_SKILL_RANK,
+		locator: AUTHORING_BODY_URL
+	},
+	{
+		name: "trading-strategy-paradigms",
+		description: "经典交易策略参考范式指南：提供短线（唐奇安突破/RSI极值回归）、波段（EMA双均线/布林带下轨回归）、长线（200日均线基线/12月动量）6大策略原理、参数调优、8项回测指标研读与风险防范 SOP。",
+		invocation: {
+			modelInvocable: true,
+			userInvocable: true
+		},
+		provider: PROVIDER_NAME,
+		source: "bundled",
+		resourceBase: RESOURCE_BASE,
+		rank: BUNDLED_SKILL_RANK,
+		locator: STRATEGY_BODY_URL
+	},
+	{
+		name: "knowledge-curation",
+		description: "财经观点沉淀与知识库策展指南：基于 Content Insight 事实核查产物，规范化提取知识卡片字段、受控词表对齐、查重与关联建立，通过 knowledge_ingest 工具入库。",
+		invocation: {
+			modelInvocable: true,
+			userInvocable: true
+		},
+		provider: PROVIDER_NAME,
+		source: "bundled",
+		resourceBase: RESOURCE_BASE,
+		rank: BUNDLED_SKILL_RANK,
+		locator: KNOWLEDGE_CURATION_BODY_URL
+	},
+	{
+		name: "trading-notes-setup",
+		description: "交易日志建立与记录规范：检查/创建工作区 .trading-journal/ 双轨目录（agent 轨 + human 轨），分别记录 agent 与人类各自的操作。会话启动检查发现工作区没有交易日志目录时调用本技能建立骨架；记录条目格式以本技能为权威。",
+		invocation: {
+			modelInvocable: true,
+			userInvocable: true
+		},
+		provider: PROVIDER_NAME,
+		source: "bundled",
+		resourceBase: RESOURCE_BASE,
+		rank: BUNDLED_SKILL_RANK,
+		locator: JOURNAL_BODY_URL
+	}
+];
+const provider = {
+	name: PROVIDER_NAME,
+	list: () => Promise.resolve(SKILL_CANDIDATES),
+	async get(candidate) {
+		const target = SKILL_CANDIDATES.find((c) => c.name === candidate.name) ?? CANDIDATE;
+		return {
+			name: target.name,
+			description: target.description,
+			invocation: target.invocation,
+			provider: target.provider,
+			source: target.source,
+			resourceBase: RESOURCE_BASE,
+			content: await readFile(target.locator, "utf8")
+		};
+	}
+};
+const Config = Schema.object({
+	dryRun: Schema.boolean().default(true),
+	liveTrading: Schema.boolean().default(false)
+});
+const inject = ["skills", "tools"];
+const name = "dsh-trading-crypto-kit";
+const FUNDING_RATE_URL = "https://fapi.binance.com/fapi/v1/fundingRate";
+const SYMBOL_PATTERN = /^[A-Z0-9]{4,20}$/;
+const DEFAULT_FUNDING_LIMIT = 3;
+const MAX_FUNDING_LIMIT = 1e3;
+async function fetchFundingRates(symbol, limit) {
+	const url = new URL(FUNDING_RATE_URL);
+	url.searchParams.set("symbol", symbol);
+	url.searchParams.set("limit", String(limit));
+	const response = await fetch(url, { headers: { accept: "application/json" } });
+	if (!response.ok) {
+		const body = await response.text().catch(() => "");
+		throw new Error(`Binance futures API error: HTTP ${response.status}${body ? ` — ${body.slice(0, 200)}` : ""}`);
+	}
+	const data = await response.json();
+	if (!Array.isArray(data)) throw new Error("Binance futures API returned an unexpected payload (expected an array of funding records)");
+	return data;
+}
+function renderFundingRates(symbol, records) {
+	const lines = records.map((record) => {
+		const rate = Number(record.fundingRate);
+		const percent = Number.isFinite(rate) ? `${(rate * 100).toFixed(4)}%` : record.fundingRate;
+		const when = Number.isFinite(record.fundingTime) ? new Date(record.fundingTime).toISOString() : String(record.fundingTime);
+		const mark = record.markPrice === void 0 ? "" : `  markPrice=${record.markPrice}`;
+		return `- ${when}  rate=${record.fundingRate} (${percent})${mark}`;
+	});
+	return [`crypto_funding_rate ${symbol} — last ${records.length} funding event(s):`, ...lines].join("\n");
+}
+function apply(ctx, _config) {
+	ctx.skills.registerProvider(() => provider);
+	const fundingTool = defineTool({
+		name: "crypto_funding_rate",
+		description: "Get recent funding rate history for a Binance USDⓈ-M perpetual futures symbol (public endpoint, no credentials). Returns the most recent funding events with rate and mark price.",
+		parameters: {
+			symbol: {
+				type: "string",
+				required: true,
+				description: "Perpetual futures symbol, e.g. BTCUSDT"
+			},
+			limit: {
+				type: "number",
+				description: `Number of most recent funding events to return (1-${MAX_FUNDING_LIMIT}, default ${DEFAULT_FUNDING_LIMIT})`,
+				default: DEFAULT_FUNDING_LIMIT
+			}
+		},
+		output: {
+			schema: { type: "string" },
+			render: (_args, value) => [{
+				type: "text",
+				text: String(value)
+			}]
+		},
+		async execute(raw) {
+			const args = raw ?? {};
+			const symbol = typeof args.symbol === "string" ? args.symbol.trim().toUpperCase() : "";
+			if (!SYMBOL_PATTERN.test(symbol)) throw new Error(`crypto_funding_rate: invalid symbol ${JSON.stringify(args.symbol)} — expected an uppercase Binance futures symbol like BTCUSDT`);
+			const requested = typeof args.limit === "number" && Number.isFinite(args.limit) ? Math.trunc(args.limit) : DEFAULT_FUNDING_LIMIT;
+			return renderFundingRates(symbol, await fetchFundingRates(symbol, Math.min(Math.max(requested, 1), MAX_FUNDING_LIMIT)));
+		}
+	});
+	const tools = ctx.tools;
+	const registerOnce = (tool) => {
+		if (tools.get(tool.name) !== void 0) {
+			ctx.logger("dsh-trading-crypto-kit").info("[dsh-trading-crypto-kit] tool %s already registered by another provider — skipped (mutual exclusion)", tool.name);
+			return;
+		}
+		tools.register(tool);
+	};
+	registerOnce(fundingTool);
+	const router = ctx.get?.("tradingMarketRouter", false);
+	registerOnce(createGetNewsTool({ cryptoPanicKey: router?.newsKey?.() }));
+	registerOnce(createGetDerivativesTool());
+	registerOnce(createGetFundamentalsTool());
+	const lifecycle = ctx;
+	lifecycle.inject?.(["tradingNewsRegistry"], (scope) => {
+		const registry = scope.tradingNewsRegistry;
+		if (registry && typeof registry.register === "function") lifecycle.effect?.(() => registry.register("crypto", aggregateNews), "kit-crypto news registration");
+	});
+}
+function createGetDerivativesTool(options = {}) {
+	return defineTool({
+		name: "crypto_get_derivatives",
+		description: "Get real-time crypto derivatives indicators (Open Interest, Long/Short Account Ratio, Top Trader Position Ratio, Taker Buy/Sell Volume Ratio, and latest Funding Rate) for a perpetual contract via Binance Futures public REST API. Accepts market-canonical (e.g. BTCUSDT, BTCUSDT-SWAP) or native symbols. No credentials required.",
+		parameters: { symbol: {
+			type: "string",
+			required: true,
+			description: "Perpetual contract symbol, market-canonical vocabulary, e.g. BTCUSDT or BTCUSDT-SWAP"
+		} },
+		output: {
+			schema: { type: "string" },
+			render: (_args, value) => [{
+				type: "text",
+				text: String(value)
+			}]
+		},
+		async execute(raw) {
+			const args = raw ?? {};
+			const symbol = typeof args.symbol === "string" ? args.symbol.trim() : "";
+			if (!symbol) throw new Error("crypto_get_derivatives: symbol parameter is required (e.g. BTCUSDT or BTCUSDT-SWAP)");
+			const result = await fetchCryptoDerivatives({
+				symbol,
+				fetch: options.fetch
+			});
+			return renderDerivativesData(result, symbol);
+		}
+	});
+}
+function createGetFundamentalsTool(options = {}) {
+	return defineTool({
+		name: "crypto_get_fundamentals",
+		description: "Get tokenomics and fundamental data (Market Cap Rank, Market Cap, Fully Diluted Valuation (FDV), Circulating Supply, Max Supply, 24h Volume and Price Change) for a crypto asset via CoinCap and Binance public REST APIs. Accepts symbol (BTCUSDT) or asset ticker (BTC). No credentials required.",
+		parameters: { symbol: {
+			type: "string",
+			required: true,
+			description: "Crypto symbol or asset ticker, e.g. BTCUSDT, BTC, ETH, SOL"
+		} },
+		output: {
+			schema: { type: "string" },
+			render: (_args, value) => [{
+				type: "text",
+				text: String(value)
+			}]
+		},
+		async execute(raw) {
+			const args = raw ?? {};
+			const symbol = typeof args.symbol === "string" ? args.symbol.trim() : "";
+			if (!symbol) throw new Error("crypto_get_fundamentals: symbol parameter is required (e.g. BTCUSDT or BTC)");
+			const result = await fetchCryptoFundamentals({
+				symbol,
+				fetch: options.fetch
+			});
+			return renderCryptoFundamentals(result, symbol);
+		}
+	});
+}
+const DEFAULT_NEWS_WINDOW_HOURS = 24;
+const DEFAULT_NEWS_LIMIT = 20;
+function renderNewsItem(item) {
+	return `[${item.source}] ${item.publishedAt}  ${item.title}\n  ${item.url}`;
+}
+function createGetNewsTool(toolOptions = {}) {
+	const description = "Get recent crypto news from public no-key sources (Binance listing/delisting/API announcements, OKX announcements, CoinDesk & The Block RSS). " + (toolOptions.cryptoPanicKey ? "CryptoPanic user key is set — the CryptoPanic free tier is queried as an additional source and degrades gracefully if it fails. " : "") + "Aggregates and sorts newest-first; each item carries source name, publish time and a link for traceability. Optionally filter by symbol (matched against item titles; note media headlines often use asset names like \"Bitcoin\" rather than tickers) and by a time window. Source failures are tolerated and reported instead of failing the whole call. No credentials required. Distinguish announcements (listing, delisting, regulatory) from opinion (media) when citing.";
+	return defineTool({
+		name: "crypto_get_news",
+		description,
+		parameters: {
+			symbol: {
+				type: "string",
+				description: "Optional symbol to filter by, market-canonical vocabulary, e.g. BTCUSDT or BTCUSDT-SWAP. Matched against item titles (case-insensitive substring of the symbol or its base asset)."
+			},
+			windowHours: {
+				type: "number",
+				description: `Only keep items published within the last N hours (1-168, default ${DEFAULT_NEWS_WINDOW_HOURS}).`,
+				default: DEFAULT_NEWS_WINDOW_HOURS
+			},
+			limit: {
+				type: "number",
+				description: `Max items to return (1-50, default ${DEFAULT_NEWS_LIMIT}).`,
+				default: DEFAULT_NEWS_LIMIT
+			}
+		},
+		output: {
+			schema: { type: "string" },
+			render: (_args, value) => [{
+				type: "text",
+				text: String(value)
+			}]
+		},
+		async execute(raw) {
+			const args = raw ?? {};
+			const options = {
+				symbol: typeof args.symbol === "string" ? args.symbol : void 0,
+				windowHours: typeof args.windowHours === "number" ? args.windowHours : void 0,
+				limit: typeof args.limit === "number" ? args.limit : void 0,
+				cryptoPanicKey: toolOptions.cryptoPanicKey
+			};
+			const { items, unavailable } = await aggregateNews(options);
+			if (items.length === 0 && unavailable.length === 0) return "crypto_get_news: no news items found within the requested window.";
+			const symbolNote = options.symbol ? ` symbol=${options.symbol.trim().toUpperCase()} (tokens: ${deriveSymbolTokens(options.symbol).join(", ")})` : "";
+			const keyNote = options.cryptoPanicKey ? " cryptopanicKey=set (B-source)" : "";
+			const lines = [`crypto_get_news — ${items.length} item(s)${symbolNote}${keyNote}, window=${options.windowHours ?? DEFAULT_NEWS_WINDOW_HOURS}h (newest-first):`, ...items.map(renderNewsItem)];
+			if (unavailable.length > 0) lines.push("  (source(s) unavailable this call: " + unavailable.join("; ") + ")");
+			return lines.join("\n");
+		}
+	});
+}
+//#endregion
+export { Config, aggregateNews, apply, createGetDerivativesTool, createGetFundamentalsTool, createGetNewsTool, deriveSymbolTokens, extractBaseAsset, fetchCryptoDerivatives, fetchCryptoFundamentals, fetchCryptoFundamentalsPackage, inject, name, normalizeBinanceFuturesSymbol, parseCryptoPanic, parseRss2, provider, renderCryptoFundamentals, renderDerivativesData };