跳到主要内容

AI 助手

AI 助手让你用大白话描述工作，由 TikMatrix 替你排进任务队列。它会读取你的设备、账号和任务历史，把它将要创建的内容原样展示给你，在你确认之前不会写入任何东西。

需要 Pro

AI 助手需要 Pro 及以上套餐，与本地自动化 API 的要求一致。

它是什么（以及不是什么）​

助手不会直接操作你的手机。它的工作方式和你一样：先看看你手上有什么，然后创建任务，再由正常的任务执行器去跑。它创建的任何东西都会像普通任务一样出现在任务列表里，来源标记为 assistant。

它也不能自作主张地写入任何东西。每一个会改变状态的动作都会中断对话并先征求你的同意——见没有你的确认，什么都不会执行。

配置​

模型由你自己提供。TikMatrix 既不自带模型，也不代理你的请求——应用直接从你的机器访问你配置的接口。

  1. 点击左侧导航栏的 助手。
  2. 点击 模型设置。
  3. 填写：
字段该填什么
接口地址完整的 chat-completions URL，例如 https://api.openai.com/v1/chat/completions
模型模型 ID，例如 gpt-4o 或 claude-sonnet-4-5
API Key该服务商的密钥
API 格式保持 根据接口自动识别，除非识别错了
单次确认的任务上限一次确认最多能创建多少个任务（默认 200）
  1. 点击 保存。

设置被接受后，面板顶部的状态栏会显示当前使用的模型，你一眼就能确认这次对话走的是哪个接口。

支持哪些接口​

支持两种协议格式：

  • OpenAI 兼容 —— 任何支持 POST /v1/chat/completions 的接口。包括 OpenAI 本身以及大多数自建服务：vLLM、LocalAI、Ollama 的 OpenAI 兼容层、DeepSeek、OpenRouter 等。
  • Anthropic —— 支持 POST /v1/messages 的接口。

API 格式通常保持根据接口自动识别：URL 中包含 api.anthropic.com 或 /v1/messages 的按 Anthropic 处理，其余按 OpenAI 兼容处理。只有当你用的代理地址看不出协议时，才需要手动指定。

选一个会用工具的模型

助手完全依赖工具调用来工作。工具调用能力不可靠的模型可以跟你聊天，但永远规划不出任何东西。

如何选模型​

如果你想要就用
规划最可靠、最省心OpenAI 或 Anthropic 当前的旗舰模型
日常「给整机架排任务」成本更低同一批服务商的中档模型
数据完全不出本机本地服务（Ollama、vLLM、LocalAI）搭配工具调用能力扎实的模型

「能聊天但从不规划」的典型原因就是本地小模型。在断定助手坏掉之前，先用托管模型跑一次同样的请求——如果那样能成，问题就出在模型上，而不是配置上。

设置保存在哪里​

你的接口地址和密钥会写入应用数据目录下的 assistant_settings.json，后端在发起请求时读取。除了你配置的那个接口，它们不会被发送到任何地方。

有一项设置只存在于这个文件里：max_tokens，也就是发给模型的回复长度预算。默认 8192，取值被限制在 1024–64000 之间。如果长回答被截断，可以手动调大。

提出需求​

用大白话描述你想做的事。一些例子：

  • 把所有账号养号 20 分钟
  • 我上一批任务为什么失败了？
  • 明天早上 9 点在所有设备上发帖
  • 用 Marketing 分组里的手机关注这五个账号

一次请求通常分三步：

  1. 查询。 哪些设备在线、哪些账号已登录、脚本接受哪些参数。
  2. 规划。 算出这次请求究竟会产生多少个任务，并把总量展示给你——多少个任务、涉及多少台设备和多少个账号。
  3. 你确认。 确认之后才会真正写入。

如果一个请求的歧义会影响任务数量，助手会来问你，而不是自己猜。

一次完整的请求长什么样​

你： 把所有已登录账号养号 20 分钟，明天早上 9 点开始

助手： （依次调用 get_script_schema、list_devices、list_accounts，然后 plan_tasks） 34 个养号任务，覆盖 12 台设备、34 个账号，每个 20 分钟，2026-08-27 09:00 开始。有两个账号未登录，已排除。

接着会弹出确认卡片，逐条列出它将要创建的每一行——设备、账号，以及脚本需要的目标对象——外加将要写入的完整 script_config。你点击确认，34 个任务就出现在任务列表里。

指定执行时间​

任务可以排到稍后执行：只要在话里提到时间，助手就会把它写进计划作为任务开始时间，确认卡片上也会显示。请求量很大时这尤其重要——把整机架的关注量摊到一整天，比一次性全部发出去要自然得多，助手在遇到有风险的请求时也会主动这么建议。

助手按电脑的本地时间排期。指定日期使用 YYYY-MM-DD HH:MM；只写 HH:MM 表示今天。过去或无效的时间会被拒绝，因此「明天 09:00」不会被误排为今天。

同时支持两个应用的版本​

如果你的 TikMatrix 版本同时支持 TikTok 和 Instagram，它不会去猜你指的是哪一个——没有指明平台的请求会被反问一次。说「用 Marketing 分组在 TikTok 上发帖」而不是「用 Marketing 分组发帖」，它就能直接进入规划。单平台版本永远不会问这个问题。

没有你的确认，什么都不会执行​

这一点是由代码强制的，不是靠好言好语地叮嘱模型。

当助手要做任何改变状态的事情时，对话会停下来，弹出一张确认卡片说明接下来会发生什么。只有你按下确认按钮，这个调用才会真正执行。

有四类动作受此保护：

动作作用
create_tasks把规划好的任务排入队列
stop_task停止一个运行中的任务
retry_task把失败的任务重新排队
create_custom_script写入并注册一个新的脚本文件

任务创建之上还有第二道锁：确认按钮只能执行你看到的那个计划。助手无法在预览和你确认之间修改参数——计划是一次性的，15 分钟后过期，所以一个你离开去忙别的、放着没管的预览，不会在设备列表早已变化之后还能被确认。

而且这张卡片不是模型写的摘要。它渲染的是计划里真实的每一行和真实的 script_config，所以你批准的就是最终写入的内容。

拒绝也是一种正常答复，而不是错误：模型会被告知你拒绝了，于是它可以换个方案，而不是把同一个调用再试一遍。

任务数量上限​

一次确认最多创建 200 个任务。这是给「理解偏了的请求」踩的一脚刹车——避免「给我的账号养号」变成第二天早上才发现的一千个任务。更大的批量依然可以做：助手会把它拆成若干批，让你逐批确认。

上限可以在 模型设置 → 单次确认的任务上限 中修改，超过 2000 的值会被截断到 2000。

助手能看到什么​

以下这些它可以随意使用，无需询问：

工具读取什么
list_devices已连接的设备、是否在线或正忙、所属分组
list_accounts账号、各自所在的设备，以及是否已登录
list_groups设备分组及其规模
get_script_schema本版本可运行的全部脚本，以及各自准确的参数
list_tasks任务列表，可按状态、设备或脚本筛选
get_task_log单个任务的日志——失败原因通常就写在里面
get_activity_log最近的账号活动
device_screenshot某台设备当前的屏幕内容
list_custom_scripts你已注册的自定义脚本
get_custom_script_guide如何编写自定义脚本
plan_tasks算出一个请求会创建什么，但不创建
截图会发送给你的模型服务商

device_screenshot 会把手机屏幕的图片发送到你配置的接口。如果某个界面上可能有你不希望交给第三方服务商的内容，就别让它截图，或者把助手指向你自己部署的模型。

哪些数据会离开你的机器​

助手读到的一切都会作为对话内容发送到你的模型接口——模型正是这样「看到」它们的。具体来说包括：设备序列号和分组名称、账号用户名及其登录状态、任务行和任务日志，以及你要求的任何截图。API Key、代理凭据和账号密码不在它可读取的范围内，因此永远不会出现在请求体里。

如果这份清单超出了你愿意交给第三方服务商的范围，就把接口指向你自己运行的模型；该功能的其它部分完全不变。

编写自定义脚本​

如果没有任何内置脚本能满足你的需求，助手可以替你写一个。用大白话说明这项工作即可；它会读取脚本编写指南、起草程序，然后展示给你。

这一步的确认卡片会特意点明：脚本会被写入磁盘并注册，之后就能像内置脚本一样运行。批准之前请先读一遍。 脚本会落在应用数据目录下的 assistant_scripts 文件夹里，因此它写过的所有内容都可以在同一个地方审查、编辑或删除。

对模型给出的方案，应用会强制以下限制：

  • 解释器只能是 python、python3、node、bun、deno——不允许注册那种「先起一个 shell、后面再挂载荷」的命令。
  • 文件名必须是纯文件名：不含路径分隔符、不含 ..、不以点开头，最长 64 个字符。
  • 源码上限 200 KB，平台必须是 generic、tiktok 或 instagram。

注册之后它就是一个普通的自定义脚本：你可以在 设备 → 自定义脚本 中打开它，修改命令、调整超时时间或停用它。脚本注册后能做什么，见自定义脚本。

值得知道的限制​

  • 一次请求，最多十二步。 如果十二次工具调用之后还没完成，助手会停下来报告哪些问题没解决，而不是在循环里烧掉你的 token。
  • 对话不是档案。 它保存在内存里——最近 8 个对话，每个保留最后 120 轮——应用重启后就没了。发送给模型的对话文字还会控制在约 48,000 字符以内，优先移除较早的完整交互，保留最新请求。真正值得留存的东西最终都会变成任务，而任务在数据库里。
  • 切走页面是安全的。 回来时对话线程和尚未处理的确认都会恢复。
  • 停止 会中断正在等待的模型请求或只读工具。已经开始执行的写入动作会完成，之后助手停止。
  • token 是你自己付费的。 每次请求都会带上脚本目录和保留下来的对话，所以长对话的单条消息成本高于新开的对话。面板会逐步显示回复，并展示每步耗时以及服务商返回的 token 用量。做不相干的工作时，新开一个对话比接着旧对话聊更省钱。

常见问题排查​

API access requires Pro or higher plan 你的授权是 Starter 或已失效。检查 设置 → 授权。

The app is still starting up. Try again in a moment. 面板在后台服务启动完成之前就打开了。等几秒再发一次。

No model endpoint configured / No API key configured / No model configured 打开 模型设置，把接口地址、模型和 API Key 三项都填上。 可先点 测试连接 检查鉴权、模型和工具调用；测试不会发送设备或账号数据。

Could not reach the model endpoint 应用无法建立连接。检查 URL，以及本地接口是否真的在那个端口上监听。

模型会回话，但从不规划任何东西 它多半没有在调用工具。换一个工具调用能力扎实的模型，并检查 API 格式 是否与接口的协议一致。

每次回复都被截断 一些 OpenAI 兼容服务默认的输出上限很低。请在服务端调高，或者调大 assistant_settings.json 里的 max_tokens。

它总是反问用哪个平台 说明这个版本同时支持 TikTok 和 Instagram。在请求里指明你要的那一个。

确认卡片点了没反应 计划在 15 分钟后过期。重新提一次同样的需求，拿一个新的计划。

任务创建了，但没有跑起来 多半是自动唤醒 Agent 被关掉了——助手在你确认之前会就此发出提示。到 设置 里重新打开。

下一步​

  • 自定义脚本 —— 编写并注册内置脚本没有覆盖的自动化
  • 本地 API 概览 —— 用你自己的程序驱动同一套任务队列
  • 任务设置 —— 排入队列的任务是如何被取走并执行的