tickflow-assist 0.2.0 → 0.2.2

package/README.md

@@ -37,9 +37,18 @@ TickFlow Assist 面向一条完整的“自选管理 -> 数据抓取 -> 综合
 
 ## 🛠 安装与配置
 
-### 一键安装
+### 社区安装（推荐）
 
-如果你已经安装了 `git`、`node`、`npm`、`uv`、`openclaw` 与 `jq`，可以直接运行安装向导：
+如果你不需改动源码，可直接通过 OpenClaw 插件市场或 npm 安装：
+
+```bash
+openclaw plugins install tickflow-assist
+npx -y tickflow-assist configure-openclaw
+```
+
+### 一键安装脚本
+
+如果你已经安装了 `git`、`node`、`npm`、`uv`、`openclaw` 与 `jq`，并且想要从源码运行，可以直接运行安装向导：
 
 ```bash
 bash -c "$(curl -fsSL https://raw.githubusercontent.com/robinspt/tickflow-assist/main/setup-tickflow.sh)"
@@ -49,7 +58,7 @@ bash -c "$(curl -fsSL https://raw.githubusercontent.com/robinspt/tickflow-assist
 
 如果你已经装过旧版本，优先直接执行“升级”。具体升级与重装边界见 [docs/installation.md](docs/installation.md)。
 
-### 手动安装
+### 手动源码安装
 
 ```bash
 git clone https://github.com/robinspt/tickflow-assist.git
@@ -65,20 +74,7 @@ openclaw plugins enable tickflow-assist
 openclaw gateway restart
 ```
 
-### 社区安装（npm / 社区插件）
-
-发布到 npm 后，社区安装不需要源码目录，也不需要 `setup-tickflow.sh`：
-
-```bash
-openclaw plugins install tickflow-assist
-npx -y tickflow-assist configure-openclaw
-```
-
-第二条命令会自动写入 `plugins.entries["tickflow-assist"].config`、补 `tools.allow += ["tickflow-assist"]`，并默认执行 `openclaw plugins enable`、`openclaw config validate` 与 `openclaw gateway restart`。如需保留手动控制，可追加 `--no-enable` 或 `--no-restart`。
-
-正式插件运行读取 `~/.openclaw/openclaw.json` 中的 `plugins.entries["tickflow-assist"].config`。本地调试与 CLI 读取项目根目录 `local.config.json` 下的 `plugin` 字段，两套配置互不共享。
 
-从 `0.2.0` 起，`add_stock`、`remove_stock`、`start_monitor`、`stop_monitor`、`start_daily_update`、`stop_daily_update`、`update_all`、`test_alert` 以及自选资料刷新工具按 OpenClaw 官方建议注册为 optional agent tools。若你给 Agent 显式配置了 `tools.allow`，请把插件 id `tickflow-assist` 或这些工具名加入允许列表；Slash Command 不受影响。
 
 ## 🚀 使用方式
 

package/dist/dev/tickflow-assist-cli.js

@@ -19,7 +19,7 @@ const DEFAULTS = {
     dailyUpdateNotify: true,
     alertChannel: "telegram",
     openclawCliBin: "openclaw",
-    alertAccount: "",
+    alertAccount: "default",
     pythonBin: "uv",
     pythonArgs: ["run", "python"],
 };
@@ -37,6 +37,7 @@ Options:
   --non-interactive           Use existing config / flags only, no prompts
   --no-enable                 Do not run 'openclaw plugins enable'
   --no-restart                Do not run 'openclaw gateway restart'
+  --no-python-setup           Do not run 'uv sync' for Python dependencies
   --openclaw-bin <path>       OpenClaw CLI binary, default: openclaw
   --tickflow-api-key <key>
   --tickflow-api-key-level <Free|Start|Pro|Expert>
@@ -59,6 +60,7 @@ function parseArgs(argv) {
         nonInteractive: false,
         restart: true,
         enable: true,
+        pythonSetup: true,
         openclawBin: DEFAULTS.openclawCliBin,
         overrides: {},
     };
@@ -110,6 +112,9 @@ function parseArgs(argv) {
             case "--no-restart":
                 options.restart = false;
                 break;
+            case "--no-python-setup":
+                options.pythonSetup = false;
+                break;
             case "--no-enable":
                 options.enable = false;
                 break;
@@ -281,7 +286,99 @@ function inferAllowTarget(root, options) {
     }
     return { type: "global" };
 }
-async function promptForConfig(options, existing, pluginDir) {
+async function discoverConfiguredChannels(configPath) {
+    try {
+        const root = await readConfigFile(configPath);
+        const channels = typeof root.channels === "object" && root.channels !== null
+            ? root.channels
+            : {};
+        const results = [];
+        for (const [name, value] of Object.entries(channels)) {
+            if (typeof value !== "object" || value === null)
+                continue;
+            const entry = value;
+            if (entry.enabled === false)
+                continue;
+            const accounts = [];
+            if (typeof entry.accounts === "object" && entry.accounts !== null) {
+                for (const [acctName, acctValue] of Object.entries(entry.accounts)) {
+                    if (typeof acctValue !== "object" || acctValue === null)
+                        continue;
+                    if (acctValue.enabled === false)
+                        continue;
+                    accounts.push(acctName);
+                }
+            }
+            results.push({ channel: name, accounts });
+        }
+        return results;
+    }
+    catch {
+        return [];
+    }
+}
+async function promptSelect(rl, label, choices, defaultValue) {
+    const defaultIndex = Math.max(0, choices.findIndex((c) => c.value === defaultValue));
+    console.log(`  ${label}`);
+    for (let i = 0; i < choices.length; i++) {
+        const marker = i === defaultIndex ? " (默认)" : "";
+        console.log(`    ${i + 1}) ${choices[i].label}${marker}`);
+    }
+    while (true) {
+        const answer = (await rl.question(`  请选择 (1-${choices.length}) [${defaultIndex + 1}]: `)).trim();
+        if (!answer) {
+            return choices[defaultIndex].value;
+        }
+        const num = Number(answer);
+        if (Number.isInteger(num) && num >= 1 && num <= choices.length) {
+            return choices[num - 1].value;
+        }
+        console.error(`  请输入 1-${choices.length}`);
+    }
+}
+async function promptAlertChannel(rl, configPath, defaultChannel) {
+    const configured = await discoverConfiguredChannels(configPath);
+    let selectedChannel = defaultChannel;
+    if (configured.length > 0) {
+        console.log("  检测到 openclaw.json 中已有通道配置：");
+        const choices = configured.map((c) => {
+            const acctLabel = c.accounts.length > 0 ? ` (accounts: ${c.accounts.join(", ")})` : "";
+            return { value: c.channel, label: `${c.channel}${acctLabel}` };
+        });
+        choices.push({ value: "__manual__", label: "手动输入其他通道" });
+        selectedChannel = await promptSelect(rl, "推送通道", choices, defaultChannel);
+        if (selectedChannel === "__manual__") {
+            selectedChannel = await promptString(rl, "Alert Channel", defaultChannel, true);
+        }
+    }
+    else {
+        const knownChannels = [
+            { value: "telegram", label: "telegram" },
+            { value: "qqbot", label: "qqbot" },
+            { value: "wecom", label: "wecom" },
+        ];
+        selectedChannel = await promptSelect(rl, "推送通道", knownChannels, defaultChannel);
+    }
+    // Resolve account
+    const channelAccounts = configured.find((c) => c.channel === selectedChannel)?.accounts ?? [];
+    let selectedAccount = "";
+    if (channelAccounts.length === 1) {
+        selectedAccount = channelAccounts[0];
+        console.log(`  已自动选择账号: ${selectedAccount}`);
+    }
+    else if (channelAccounts.length > 1) {
+        const acctChoices = channelAccounts.map((a) => ({ value: a, label: a }));
+        selectedAccount = await promptSelect(rl, "选择账号", acctChoices, channelAccounts[0]);
+    }
+    else {
+        // Default for channels that typically need an account
+        if (["qqbot", "wecom"].includes(selectedChannel)) {
+            selectedAccount = "default";
+        }
+    }
+    return { channel: selectedChannel, account: selectedAccount };
+}
+async function promptForConfig(options, existing, pluginDir, configPath) {
     const defaults = {
         tickflowApiUrl: DEFAULTS.tickflowApiUrl,
         tickflowApiKey: "",
@@ -319,17 +416,28 @@ async function promptForConfig(options, existing, pluginDir) {
     const rl = createInterface({ input: process.stdin, output: process.stdout });
     try {
         console.log("TickFlow Assist 社区安装配置向导");
-        console.log(`OpenClaw 配置文件: ${resolveOpenClawConfigPath(options.configPath)}`);
+        console.log(`OpenClaw 配置文件: ${configPath}`);
         console.log(`插件目录: ${pluginDir}`);
         console.log("");
         seed.tickflowApiKey = await promptString(rl, "TickFlow API Key", seed.tickflowApiKey, true);
-        seed.tickflowApiKeyLevel = normalizeApiKeyLevel(await promptString(rl, "TickFlow API Key Level [Free/Start/Pro/Expert]", seed.tickflowApiKeyLevel, true));
+        seed.tickflowApiKeyLevel = normalizeApiKeyLevel(await promptSelect(rl, "TickFlow 订阅等级", [
+            { value: "Free", label: "Free" },
+            { value: "Start", label: "Start" },
+            { value: "Pro", label: "Pro" },
+            { value: "Expert", label: "Expert" },
+        ], seed.tickflowApiKeyLevel));
         seed.mxSearchApiKey = await promptString(rl, "MX Search API Key (可留空)", seed.mxSearchApiKey, false);
         seed.llmBaseUrl = await promptString(rl, "LLM Base URL", seed.llmBaseUrl, true);
         seed.llmApiKey = await promptString(rl, "LLM API Key", seed.llmApiKey, true);
         seed.llmModel = await promptString(rl, "LLM Model", seed.llmModel, true);
-        seed.alertChannel = await promptString(rl, "Alert Channel", seed.alertChannel, true);
-        seed.alertAccount = await promptString(rl, "Alert Account (可留空)", seed.alertAccount, false);
+        console.log("");
+        const alertResult = await promptAlertChannel(rl, configPath, seed.alertChannel);
+        seed.alertChannel = alertResult.channel;
+        seed.alertAccount = alertResult.account;
+        console.log(`  已选择通道: ${seed.alertChannel}`);
+        if (seed.alertAccount) {
+            console.log(`  已选择账号: ${seed.alertAccount}`);
+        }
         seed.alertTarget = await promptString(rl, "Alert Target", seed.alertTarget, true);
         seed.requestInterval = await promptInteger(rl, "Request Interval (seconds)", seed.requestInterval, 5);
         seed.dailyUpdateNotify = await promptBoolean(rl, "Daily Update Notify", seed.dailyUpdateNotify);
@@ -481,6 +589,37 @@ function runOpenClaw(bin, args, description) {
         console.warn(`Warning: ${description} exited with status ${result.status}`);
     }
 }
+function setupPythonDeps(pythonWorkdir) {
+    let uvBin = "uv";
+    try {
+        const which = spawnSync("which", ["uv"], { encoding: "utf-8" });
+        if (which.status !== 0) {
+            console.warn("Warning: uv not found in PATH, skipping Python dependency setup.");
+            console.warn("Please install uv (https://docs.astral.sh/uv/) and run 'uv sync' manually in:");
+            console.warn(`  ${pythonWorkdir}`);
+            return;
+        }
+        uvBin = which.stdout.trim() || "uv";
+    }
+    catch {
+        // fall through with default "uv"
+    }
+    console.log(`Setting up Python dependencies in ${pythonWorkdir} ...`);
+    const result = spawnSync(uvBin, ["sync"], { cwd: pythonWorkdir, stdio: "inherit" });
+    if (result.error) {
+        console.warn(`Warning: failed to run uv sync: ${result.error.message}`);
+        console.warn("Please run 'uv sync' manually in:");
+        console.warn(`  ${pythonWorkdir}`);
+        return;
+    }
+    if (result.status !== 0) {
+        console.warn(`Warning: uv sync exited with status ${result.status}`);
+        console.warn("Please check the output above and run 'uv sync' manually if needed in:");
+        console.warn(`  ${pythonWorkdir}`);
+        return;
+    }
+    console.log("Python dependencies installed successfully.");
+}
 async function configureOpenClaw(options) {
     const configPath = resolveOpenClawConfigPath(options.configPath);
     const stateDir = resolveStateDir(configPath);
@@ -488,9 +627,12 @@ async function configureOpenClaw(options) {
     const root = await readConfigFile(configPath);
     const target = inferAllowTarget(root, options);
     const existing = getExistingPluginConfig(root);
-    const config = await promptForConfig(options, existing, pluginDir);
+    const config = await promptForConfig(options, existing, pluginDir, configPath);
     await ensurePathNotice(config.calendarFile, "calendarFile");
     await ensurePathNotice(config.pythonWorkdir, "pythonWorkdir");
+    if (options.pythonSetup) {
+        setupPythonDeps(config.pythonWorkdir);
+    }
     applyPluginConfig(root, config, target);
     const backupPath = await writeConfig(configPath, root);
     console.log("");

package/dist/plugin.d.ts

@@ -1,8 +1,2 @@
-declare const _default: {
-    id: string;
-    name: string;
-    description: string;
-    configSchema: import("openclaw/plugin-sdk").OpenClawPluginConfigSchema;
-    register: NonNullable<import("openclaw/plugin-sdk/core").OpenClawPluginDefinition["register"]>;
-} & Pick<import("openclaw/plugin-sdk/core").OpenClawPluginDefinition, "kind">;
+declare const _default: import("./runtime/plugin-api.js").PluginEntryResult;
 export default _default;

package/dist/runtime/plugin-api.d.ts

@@ -1,7 +1,21 @@
-import { definePluginEntry } from "openclaw/plugin-sdk/plugin-entry";
-import type { AnyAgentTool, OpenClawConfig, OpenClawPluginApi, OpenClawPluginCommandDefinition, OpenClawPluginService, OpenClawPluginServiceContext, PluginCommandContext, PluginLogger } from "openclaw/plugin-sdk/plugin-entry";
+import type { AnyAgentTool, OpenClawConfig, OpenClawPluginApi, OpenClawPluginCommandDefinition, OpenClawPluginDefinition, OpenClawPluginService, OpenClawPluginServiceContext, PluginCommandContext, PluginLogger } from "openclaw/plugin-sdk/plugin-entry";
 import type { PluginRuntime } from "openclaw/plugin-sdk/runtime-store";
-export { definePluginEntry };
+interface DefinePluginEntryOptions {
+    id: string;
+    name: string;
+    description: string;
+    kind?: OpenClawPluginDefinition["kind"];
+    configSchema?: unknown;
+    register: (api: OpenClawPluginApi) => void;
+}
+export interface PluginEntryResult {
+    id: string;
+    name: string;
+    description: string;
+    kind?: string;
+    register: (api: OpenClawPluginApi) => void;
+}
+export declare function definePluginEntry({ id, name, description, kind, register, }: DefinePluginEntryOptions): PluginEntryResult;
 export interface ToolContext {
     rawInput?: unknown;
 }
@@ -20,3 +34,4 @@ export type CommandContext = PluginCommandContext;
 export type OpenClawPluginConfig = OpenClawConfig;
 export type OpenClawPluginRuntime = PluginRuntime;
 export type OpenClawPluginLogger = PluginLogger;
+export {};

package/dist/runtime/plugin-api.js

@@ -1,2 +1,9 @@
-import { definePluginEntry } from "openclaw/plugin-sdk/plugin-entry";
-export { definePluginEntry };
+export function definePluginEntry({ id, name, description, kind, register, }) {
+    return {
+        id,
+        name,
+        description,
+        ...(kind ? { kind } : {}),
+        register,
+    };
+}

package/docs/installation.md

@@ -39,11 +39,31 @@ bash -c "$(curl -fsSL https://raw.githubusercontent.com/robinspt/tickflow-assist
 - 安装并启用 `tickflow-assist`
 - 重启 OpenClaw Gateway
 
-如果你只是日常升级，重新运行同一条命令并在菜单里选择“升级”即可。更具体的升级与重装说明见下文 [6.2 升级](#62-升级) 与 [6.3 禁用重装与清理](#63-禁用重装与清理)。
+如果你只是日常升级，重新运行同一条命令并在菜单里选择“升级”即可。更具体的升级与重装说明见下文 [7.2 升级](#72-升级) 与 [7.3 禁用重装与清理](#73-禁用重装与清理)。
 
-## 3. 手动安装
+## 3. 社区安装（推荐）
 
-### 3.1 拉取源码
+如果你不需改动源码，可直接通过 OpenClaw 插件市场或 npm 安装：
+
+```bash
+openclaw plugins install tickflow-assist
+npx -y tickflow-assist configure-openclaw
+```
+
+第二条命令会自动：
+
+- 安装 Python 依赖（`uv sync`）
+- 写入 `plugins.entries["tickflow-assist"].config`
+- 给顶层 `tools.allow` 或推断出的目标 Agent 补 `tickflow-assist` allowlist
+- 执行 `openclaw plugins enable tickflow-assist`
+- 执行 `openclaw config validate`
+- 执行 `openclaw gateway restart`
+
+如果你已经手动启用插件，或暂时不想重启 Gateway，可追加 `--no-enable` 或 `--no-restart`。如果 Python 已经装好或不需要自动安装，可追加 `--no-python-setup`。
+
+## 4. 源码安装
+
+### 4.1 拉取源码
 
 推荐把项目放在普通开发目录，不要放到 `~/.openclaw/workspace/...` 下面。
 
@@ -53,7 +73,7 @@ git clone https://github.com/robinspt/tickflow-assist.git
 cd tickflow-assist
 ```
 
-### 3.2 安装依赖并构建
+### 4.2 安装依赖并构建
 
 ```bash
 npm install
@@ -64,33 +84,14 @@ npm run check
 npm run build
 ```
 
-### 3.3 安装并启用插件（源码安装）
+### 4.3 安装并启用插件（源码安装）
 
 ```bash
 openclaw plugins install -l /path/to/tickflow-assist
 openclaw plugins enable tickflow-assist
 ```
 
-### 3.4 社区安装（npm / 社区插件）
-
-发布到 npm 后，社区安装不需要源码目录，也不需要 `setup-tickflow.sh`：
-
-```bash
-openclaw plugins install tickflow-assist
-npx -y tickflow-assist configure-openclaw
-```
-
-第二条命令会自动：
-
-- 写入 `plugins.entries["tickflow-assist"].config`
-- 给顶层 `tools.allow` 或推断出的目标 Agent 补 `tickflow-assist` allowlist
-- 执行 `openclaw plugins enable tickflow-assist`
-- 执行 `openclaw config validate`
-- 执行 `openclaw gateway restart`
-
-如果你已经手动启用插件，或暂时不想重启 Gateway，可追加 `--no-enable` 或 `--no-restart`。
-
-## 4. 插件配置
+## 5. 插件配置
 
 正式插件运行读取：
 
@@ -243,7 +244,7 @@ openclaw gateway restart
 
 </details>
 
-## 5. 消息通道配置（可选）
+## 6. 消息通道配置（可选）
 
 TickFlow Assist 当前通过 `openclaw message send` 投递告警，因此前提是目标通道本身已经能在 OpenClaw 中正常工作。
 
@@ -266,6 +267,7 @@ TickFlow Assist 当前通过 `openclaw message send` 投递告警，因此前提
 | 通道 | 官方项目 / 接入方式 | `alertAccount` | `alertTarget` 示例 | 说明 |
 |---|---|---|---|---|
 | `telegram` | `openclaw channels add --channel telegram` | 通常留空 | `-1001234567890` | 直接使用群组 / 会话 ID |
+| `discord` | `openclaw channels add --channel discord` | 通常留空 | `user:1234567890` | 优先在目标会话发送 `/whoami`，读取 `User id`，拼装成 `user:User id` |
 | `qqbot`（QQ机器人） | [@tencent-connect/openclaw-qqbot](https://www.npmjs.com/package/@tencent-connect/openclaw-qqbot) | 推荐 `default` | `qqbot:c2c:YOUR_OPENID` | 优先在目标会话发送 `/whoami`，读取 `User id` |
 | `wecom`（企业微信） | [@wecom/wecom-openclaw-plugin](https://www.npmjs.com/package/@wecom/wecom-openclaw-plugin) | 常见为 `default` | `YOUR_USER_ID_OR_CHAT_ID` | 优先在目标会话发送 `/whoami`，再区分单聊 `userId` / 群聊 `chatId` |
 | `weixin`（微信） | [@tencent-weixin/openclaw-weixin](https://www.npmjs.com/package/@tencent-weixin/openclaw-weixin) | 视插件配置 | `YOUR_TARGET` | 预留通道，当前 TickFlow Assist 尚未做专门适配，建议先用 `test_alert` 验证 |
@@ -316,9 +318,9 @@ TickFlow Assist 当前通过 `openclaw message send` 投递告警，因此前提
 
 </details>
 
-## 6. 运维与日常管理
+## 7. 运维与日常管理
 
-### 6.1 重启与验收
+### 7.1 重启与验收
 
 完成安装或修改配置后，建议按下面顺序做一次验收：
 
@@ -338,7 +340,7 @@ npm run tool -- test_alert
 
 或者直接在 OpenClaw 对话里发送“测试告警”。
 
-### 6.2 升级
+### 7.2 升级
 
 推荐继续使用安装向导，在菜单里选择“升级”。
 
@@ -360,7 +362,7 @@ openclaw plugins enable tickflow-assist
 openclaw gateway restart
 ```
 
-### 6.3 禁用、重装与清理
+### 7.3 禁用、重装与清理
 
 禁用插件：
 

package/openclaw.plugin.json

@@ -1,7 +1,7 @@
 {
   "id": "tickflow-assist",
   "name": "TickFlow Assist",
-  "version": "0.2.0",
+  "version": "0.2.2",
   "description": "A-share watchlist analysis, monitoring, and alert delivery powered by TickFlow and OpenClaw.",
   "skills": [
     "skills"

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "tickflow-assist",
-  "version": "0.2.0",
+  "version": "0.2.2",
   "description": "OpenClaw plugin for TickFlow-based A-share analysis, monitoring, and alerting.",
   "license": "MIT",
   "type": "module",