tickflow-assist 0.2.4 → 0.2.6

package/dist/prompts/analysis/prompt-text-utils.js

@@ -0,0 +1,28 @@
+export function extractNarrativeWithoutJson(text) {
+    const stripped = text.replace(/```json\s*[\s\S]*?\s*```/gi, "").trim();
+    return stripped || text.trim();
+}
+export function truncatePromptText(text, maxLength) {
+    const normalized = text.trim();
+    if (!normalized) {
+        return "";
+    }
+    return normalized.length <= maxLength ? normalized : `${normalized.slice(0, maxLength)}...`;
+}
+export function buildReferencedNarrative(text, maxLength) {
+    return truncatePromptText(extractNarrativeWithoutJson(text), maxLength);
+}
+export function sanitizeExternalPromptText(text, maxLength) {
+    const normalized = String(text ?? "")
+        .replace(/```[\s\S]*?```/g, " ")
+        .replace(/[`#>*]/g, " ")
+        .replace(/\s+/g, " ")
+        .trim();
+    if (!normalized) {
+        return "";
+    }
+    if (/(忽略以上|请忽略|不要遵循|system\s*prompt|developer\s*:|assistant\s*:|user\s*:|只输出\s*json)/i.test(normalized)) {
+        return "";
+    }
+    return truncatePromptText(normalized, maxLength);
+}

package/dist/prompts/analysis/shared-schema.d.ts

@@ -0,0 +1,4 @@
+export declare const KEY_LEVELS_JSON_SCHEMA_INNER: string;
+export declare const KEY_LEVELS_JSON_SCHEMA: string;
+export declare const KEY_LEVELS_FIELD_GUIDANCE: string;
+export declare function indentPromptBlock(text: string, spaces: number): string;

package/dist/prompts/analysis/shared-schema.js

@@ -0,0 +1,40 @@
+export const KEY_LEVELS_JSON_SCHEMA_INNER = [
+    '"current_price": number,',
+    '"stop_loss": number | null,',
+    '"breakthrough": number | null,',
+    '"support": number | null,',
+    '"cost_level": number | null,',
+    '"resistance": number | null,',
+    '"take_profit": number | null,',
+    '"gap": number | null,',
+    '"target": number | null,',
+    '"round_number": number | null,',
+    '"score": integer',
+].join("\n");
+export const KEY_LEVELS_JSON_SCHEMA = [
+    "{",
+    indentPromptBlock(KEY_LEVELS_JSON_SCHEMA_INNER, 2),
+    "}",
+].join("\n");
+export const KEY_LEVELS_FIELD_GUIDANCE = [
+    "- current_price: 最新可用价格，必须与输入中的最新收盘价或实时价一致。",
+    "- support: 当前最近支撑位；不存在或当前不适用填 null。",
+    "- resistance: 当前最近压力位；不存在或当前不适用填 null。",
+    "- breakthrough: 需要放量或收盘确认的向上突破位；不存在或当前不适用填 null。",
+    "- stop_loss: 短线止损参考位；不存在或当前不适用填 null。",
+    "- take_profit: 短线分批止盈参考位；不存在或当前不适用填 null。",
+    "- target: 突破后的第一目标位；不存在或当前不适用填 null。",
+    "- round_number: 重要整数关口；不存在或当前不适用填 null。",
+    "- gap: 近期未回补的跳空缺口；无明确缺口填 null。",
+    "- cost_level: 若提供了用户成本价，必须填写该成本价；未提供则填 null。",
+    "- 除 current_price 外，其余价格字段已知则填真实数值，不存在或当前不适用填 null。",
+    "- score: 1-10 的整数。",
+    "- 最终输出必须是合法 JSON，并用 ```json 代码块包裹，不要输出裸 JSON。",
+].join("\n");
+export function indentPromptBlock(text, spaces) {
+    const prefix = " ".repeat(spaces);
+    return text
+        .split("\n")
+        .map((line) => `${prefix}${line}`)
+        .join("\n");
+}

package/dist/prompts/analysis/watchlist-profile-extraction-prompt.js

@@ -1,5 +1,6 @@
 const MAX_PROMPT_DOCUMENTS = 8;
 const MAX_TRUNK_LENGTH = 600;
+const MAX_THEME_COUNT = 10;
 export const WATCHLIST_PROFILE_EXTRACTION_SYSTEM_PROMPT = [
     "你是A股证券资料结构化抽取助手。",
     "",
@@ -15,11 +16,11 @@ export const WATCHLIST_PROFILE_EXTRACTION_SYSTEM_PROMPT = [
     '  "confidence": "low" | "medium" | "high"',
     "}",
     "4. sector 优先提取申万行业/行业分类，保留完整层级；没有可靠信息时填 null。",
-    "5. themes 尽量完整列出概念板块，去重后输出数组；优先保留明确的概念/题材/板块名称。",
+    `5. themes 尽量完整列出概念板块，去重后输出数组；优先保留明确的概念/题材/板块名称，最多保留 ${MAX_THEME_COUNT} 个。`,
     "6. themes 中不要输出泛词，例如公司新闻、最新公告、市场快讯；也不要输出等。",
     "7. 若资料中是组合表达，拆成独立概念更优，例如华为昇腾 / 华为昇思应拆成两个数组项。",
     "8. 若资料仅出现业务描述而没有足够证据支持概念标签，不要强行扩写。",
-    "9. confidence 仅反映你对提取结果的把握，不要附加解释。",
+    "9. confidence 仅反映你对提取结果的把握，不要附加解释；high 表示多条资料交叉印证，medium 表示有较明确来源但证据有限，low 表示仅能做保守提取。",
 ].join("\n");
 export function buildWatchlistProfileExtractionUserPrompt(input) {
     const documents = input.documents.slice(0, MAX_PROMPT_DOCUMENTS);

package/dist/utils/cost-price.d.ts

@@ -1,3 +1,4 @@
 export declare function normalizeCostPrice(value: unknown): number | null;
 export declare function formatCostPrice(value: number | null | undefined, suffix?: string): string;
 export declare function calculateProfitPct(currentPrice: number, costPrice: number | null | undefined): number | null;
+export declare function formatCostRelationship(currentPrice: number, costPrice: number | null | undefined): string;

package/dist/utils/cost-price.js

@@ -16,3 +16,18 @@ export function calculateProfitPct(currentPrice, costPrice) {
     }
     return ((currentPrice - numeric) / numeric) * 100;
 }
+export function formatCostRelationship(currentPrice, costPrice) {
+    const numeric = normalizeCostPrice(costPrice);
+    if (numeric == null || !Number.isFinite(currentPrice)) {
+        return "未设置";
+    }
+    const diff = currentPrice - numeric;
+    const pct = calculateProfitPct(currentPrice, numeric);
+    if (pct == null) {
+        return "未设置";
+    }
+    const direction = diff > 0 ? "高于" : diff < 0 ? "低于" : "持平";
+    const diffPrefix = diff > 0 ? "+" : diff < 0 ? "-" : "";
+    const pctPrefix = pct > 0 ? "+" : pct < 0 ? "-" : "";
+    return `${direction}成本价 ${Math.abs(diff).toFixed(2)} 元（${diffPrefix}${Math.abs(diff).toFixed(2)} 元，${pctPrefix}${Math.abs(pct).toFixed(2)}%）`;
+}

package/openclaw.plugin.json

@@ -1,7 +1,7 @@
 {
   "id": "tickflow-assist",
   "name": "TickFlow Assist",
-  "version": "0.2.4",
+  "version": "0.2.6",
   "description": "A-share watchlist analysis, monitoring, and alert delivery powered by TickFlow and OpenClaw.",
   "skills": [
     "skills"
@@ -9,54 +9,69 @@
   "configSchema": {
     "type": "object",
     "additionalProperties": false,
+    "required": ["tickflowApiKey", "llmApiKey"],
     "properties": {
       "tickflowApiUrl": {
         "type": "string",
-        "default": "https://api.tickflow.org"
+        "default": "https://api.tickflow.org",
+        "description": "TickFlow API base URL."
       },
       "tickflowApiKey": {
-        "type": "string"
+        "type": "string",
+        "minLength": 1,
+        "description": "Required. TickFlow API key used for market and financial data."
       },
       "tickflowApiKeyLevel": {
         "type": "string",
         "enum": ["Free", "Start", "Pro", "Expert"],
-        "default": "Free"
+        "default": "Free",
+        "description": "TickFlow subscription level. Pro and Expert enable intraday K-line fetching."
       },
       "mxSearchApiUrl": {
         "type": "string",
-        "default": "https://mkapi2.dfcfs.com/finskillshub/api/claw"
+        "default": "https://mkapi2.dfcfs.com/finskillshub/api/claw",
+        "description": "MX Search API base URL."
       },
       "mxSearchApiKey": {
         "type": "string",
-        "default": ""
+        "default": "",
+        "description": "Optional. Enables mx_search, mx_select_stock, and non-Expert financial fallback."
       },
       "llmBaseUrl": {
         "type": "string",
-        "default": "https://api.openai.com/v1"
+        "default": "https://api.openai.com/v1",
+        "description": "OpenAI-compatible LLM API base URL."
       },
       "llmApiKey": {
-        "type": "string"
+        "type": "string",
+        "minLength": 1,
+        "description": "Required. API key for the analysis model endpoint configured in llmBaseUrl."
       },
       "llmModel": {
         "type": "string",
-        "default": "gpt-4o"
+        "default": "gpt-4o",
+        "description": "Model name used for analysis."
       },
       "databasePath": {
         "type": "string",
-        "default": "./data/lancedb"
+        "default": "./data/lancedb",
+        "description": "Local LanceDB data directory."
       },
       "calendarFile": {
         "type": "string",
-        "default": "./day_future.txt"
+        "default": "./day_future.txt",
+        "description": "Trading calendar file path."
       },
       "requestInterval": {
         "type": "integer",
         "minimum": 5,
-        "default": 30
+        "default": 30,
+        "description": "Realtime monitoring polling interval in seconds."
       },
       "dailyUpdateNotify": {
         "type": "boolean",
-        "default": true
+        "default": true,
+        "description": "Whether scheduled daily update and post-close review send notifications."
       },
       "alertChannel": {
         "type": "string",
@@ -73,44 +88,74 @@
       },
       "alertTarget": {
         "type": "string",
-        "description": "Channel target, e.g. Telegram chat ID, qqbot:c2c:OPENID, or WeCom userId/chatId",
+        "description": "Optional. Channel target for test_alert, monitoring alerts, and scheduled notifications.",
         "default": ""
       },
       "pythonBin": {
         "type": "string",
-        "default": "uv"
+        "default": "uv",
+        "description": "Python launcher used for indicator calculation."
       },
       "pythonArgs": {
         "type": "array",
         "items": {
           "type": "string"
         },
-        "default": ["run", "python"]
+        "default": ["run", "python"],
+        "description": "Arguments passed to pythonBin before indicator_runner.py."
       },
       "pythonWorkdir": {
         "type": "string",
-        "default": "./python"
+        "default": "./python",
+        "description": "Working directory for the Python indicator bridge."
       }
     }
   },
   "uiHints": {
     "tickflowApiKey": {
       "label": "TickFlow API Key",
+      "help": "Required for TickFlow market and financial data.",
       "sensitive": true
     },
     "tickflowApiKeyLevel": {
-      "label": "TickFlow API Key Level"
+      "label": "TickFlow API Key Level",
+      "help": "Set this to your actual TickFlow subscription level."
     },
     "mxSearchApiKey": {
       "label": "MX Search API Key",
+      "help": "Optional. Enables mx_search, mx_select_stock, and lite financial fallback.",
       "sensitive": true
     },
+    "llmBaseUrl": {
+      "label": "LLM Base URL",
+      "help": "OpenAI-compatible analysis endpoint."
+    },
     "llmApiKey": {
       "label": "LLM API Key",
+      "help": "Required for analysis model requests.",
       "sensitive": true
     },
+    "llmModel": {
+      "label": "LLM Model",
+      "help": "Model name used for stock analysis."
+    },
+    "alertChannel": {
+      "label": "Alert Channel",
+      "help": "Default delivery channel for alert messages."
+    },
     "alertTarget": {
-      "label": "Alert Target"
+      "label": "Alert Target",
+      "help": "Optional. Configure this if you want test_alert, monitoring alerts, or scheduled notifications."
+    },
+    "databasePath": {
+      "label": "Database Path",
+      "help": "Local LanceDB storage directory.",
+      "advanced": true
+    },
+    "calendarFile": {
+      "label": "Calendar File",
+      "help": "Trading calendar file path.",
+      "advanced": true
     }
   }
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "tickflow-assist",
-  "version": "0.2.4",
+  "version": "0.2.6",
   "description": "OpenClaw plugin for TickFlow-based A-share analysis, monitoring, and alerting.",
   "license": "MIT",
   "type": "module",
@@ -10,7 +10,6 @@
   },
   "files": [
     "dist",
-    "docs",
     "skills",
     "python",
     "day_future.txt",
@@ -25,9 +24,11 @@
     "lancedb"
   ],
   "scripts": {
-    "build": "tsc -p tsconfig.json",
+    "build": "node ./scripts/clean-dist.mjs && tsc -p tsconfig.json",
     "check": "tsc -p tsconfig.json --noEmit",
     "dev": "tsc -p tsconfig.json --watch",
+    "prepack": "npm run build && node ./scripts/prepare-package-assets.mjs",
+    "postpack": "node ./scripts/restore-package-assets.mjs",
     "test": "npm run build && node --test dist/plugin-registration.test.js",
     "community-setup": "node dist/dev/tickflow-assist-cli.js configure-openclaw",
     "tool": "node dist/dev/run-tool.js",
@@ -36,6 +37,11 @@
     "validate:mx-search": "npm run build && node dist/dev/validate-mx-search.js"
   },
   "openclaw": {
+    "compat": {
+      "pluginApi": "1.2.0",
+      "minGatewayVersion": "2026.3.22",
+      "builtWithOpenClawVersion": "2026.3.22"
+    },
     "extensions": [
       "dist/plugin.js"
     ]

package/skills/database-query/SKILL.md

@@ -5,7 +5,8 @@ metadata:
   openclaw:
     skillKey: database_query
     requires:
-      config: true
+      config:
+        - plugins.entries.tickflow-assist.enabled
 ---
 # LanceDB 数据查询
 

package/skills/stock-analysis/SKILL.md

@@ -5,7 +5,10 @@ metadata:
   openclaw:
     skillKey: stock_analysis
     requires:
-      config: true
+      config:
+        - plugins.entries.tickflow-assist.enabled
+        - plugins.entries.tickflow-assist.config.tickflowApiKey
+        - plugins.entries.tickflow-assist.config.llmApiKey
 ---
 # 股票分析与监控
 

package/dist/runtime/monitor-process.d.ts

@@ -1,3 +0,0 @@
-import type { PluginConfig } from "../config/schema.js";
-export declare function spawnMonitorLoop(config: PluginConfig, configSource: "openclaw_plugin" | "local_config"): number | null;
-export declare function isPidAlive(pid: number): boolean;

package/dist/runtime/monitor-process.js

@@ -1,24 +0,0 @@
-import { spawn } from "node:child_process";
-import { fileURLToPath } from "node:url";
-import { buildProcessConfigEnv } from "./process-config.js";
-const PROJECT_ROOT = fileURLToPath(new URL("../../", import.meta.url));
-const MONITOR_LOOP_SCRIPT = fileURLToPath(new URL("../dev/run-monitor-loop.js", import.meta.url));
-export function spawnMonitorLoop(config, configSource) {
-    const child = spawn(process.execPath, [MONITOR_LOOP_SCRIPT], {
-        cwd: PROJECT_ROOT,
-        detached: true,
-        stdio: "ignore",
-        env: buildProcessConfigEnv(config, configSource),
-    });
-    child.unref();
-    return child.pid ?? null;
-}
-export function isPidAlive(pid) {
-    try {
-        process.kill(pid, 0);
-        return true;
-    }
-    catch {
-        return false;
-    }
-}