AI 助手
AI 助手让你用大白话描述工作，由 TikMatrix 替你排进任务队列。它会读取你的设备、账号和任务历史，把它将要创建的内容原样展示给你，在你确认之前不会写入任何东西。
AI 助手需要 Pro 及以上套餐，与本地自动化 API 的要求一致。
它是什么（以及不是什么）
助手不会直接操作你的手机。它的工作方式和你一样：先看看你手上有什么，然后创建任务， 再由正常的任务执行器去跑。它创建的任何东西都会像普通任务一样出现在任务列表里，来源标记为 assistant。
它也不能自作主张地写入任何东西。每一个会改变状态的动作都会中断对话并先征求你的同意——见没有你的确认，什么都不会执行。
配置
模型由你自己提供。TikMatrix 既不自带模型，也不代理你的请求——应用直接从你的机器访问你配置的接口。
- 点击左侧导航栏的 助手。
- 点击 模型设置。
- 填写：
| 字段 | 该填什么 |
|---|---|
| 接口地址 | 完整的 chat-completions URL，例如 https://api.openai.com/v1/chat/completions |
| 模型 | 模型 ID，例如 gpt-4o 或 claude-sonnet-4-5 |
| API Key | 该服务商的密钥 |
| API 格式 | 保持 根据接口自动识别，除非识别错了 |
| 单次确认的任务上限 | 一次确认最多能创建多少个任务（默认 200） |
- 点击 保存。
设置被接受后，面板顶部的状态栏会显示当前使用的模型，你一眼就能确认这次对话走的是哪个接口。
支持哪些接口
支持两种协议格式：
- 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 分组里的手机关注这五个账号
一次请求通常分三步：
- 查询。 哪些设备在线、哪些账号已登录、脚本接受哪些参数。
- 规划。 算出这次请求究竟会产生多少个任务，并把总量展示给你——多少个任务、涉及多少台设备和多少个账号。
- 你确认。 确认之后才会真正写入。
如果一个请求的歧义会影响任务数量，助手会来问你，而不是自己猜。
一次完整的请求长什么样
你： 把所有已登录账号养号 20 分钟，明天早上 9 点开始
助手： （依次调用
get_script_schema、list_devices、list_accounts，然后plan_tasks） 34 个养号任务，覆盖 12 台设备、34 个账号，每个 20 分钟，2026-08-27 09:00 开始。有两个账号未登录，已排除。
接着会弹出确认卡片，逐条列出它将要创建的每一行——设备、账号，以及脚本需要的目标对象——外加将要写入的完整 script_config。你点击确认，34 个任务就出现在任务列表里。
指定执行时间
任务可以排到稍后执行：只要在话里提到时间，助手就会把它写进计划作为任务开始时间，确认卡片上也会显示。请求量很大时这尤其重要——把整机架的关注量摊到一整天，比一次性全部发出去要自然得多，助手在遇到有风险的请求时也会主动这么建议。
同时支持两个应用的版本
如果你的 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 轮——应用重启后就没了。真正值得留存的东西最终都会变成任务，而任务在数据库里。
- 切走页面是安全的。 回来时对话线程和尚未处理的确认都会恢复。
- 停止 会在下一个检查点结束循环。它无法打断已经发出去的模型请求，所以当前这一步会先跑完。
- 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 被关掉了——助手在你确认之前会就此发出提示。到 设置 里重新打开。