TakeFlow · 鲲图OS

TakeFlow 本地连接器 · 接入指南

连接器版本 v2.4.0 文档生成 2026-11-19 适用 macOS · Windows · Linux
目录(10 节)
  1. 一、连接器能为您做什么
  2. 二、安装前的准备工作
  3. 三、安装步骤
  4. 四、日常使用示例
  5. 五、需要您确认的操作
  6. 六、常见问题
  7. 七、数据与隐私
  8. 八、版本、升级与卸载
  9. 九、法律与合规声明
  10. 附录:面向 IT 人员的手动配置

本指南介绍 TakeFlow 本地连接器的安装、使用与常见问题处理方式。按第三节完成安装后,您可以直接用自然语言向 AI 助手描述需求,无需记忆任何命令或参数。

若您更习惯网页阅读,可打开同目录下的 接入指南.html,内容与本文件一致,并支持打印。

English version: 接入指南-EN.md / 接入指南-EN.html.

适用对象使用 TakeFlow 云机坐席的运营人员
适用版本本地连接器 v2.4.0
阅读建议首次安装请阅读第二、三节;日常使用参考第四、五节;遇到问题查阅第六节

一、连接器能为您做什么

安装连接器后,AI 助手可以在您授权的范围内直接操作 TakeFlow 云机坐席,包括:

连接器适用于 WorkBuddy、Codex、Claude Desktop、Cursor、DeepSeek Harness 等可在本机运行程序的桌面客户端,安装一次即可通用。ChatGPT 等纯云端产品无法加载本地连接器,原因与处理方式见第六节。

关于运行方式,有三点说明:

无需准备服务器连接器运行在您自己的电脑上
无需等待审核解压并运行安装程序即可使用
数据不离开本机登录凭证保存在本地,请求由您的电脑直接发往平台

二、安装前的准备工作

1. 一台可联网的电脑

macOS、Windows、Linux 均可。

2. Node.js 18 或更高版本

在终端(Windows 为「命令提示符」)中执行 node -v 查看版本:

3. 一个 TakeFlow 账号

即您平时登录 TakeFlow 后台所使用的手机号与密码。

ffmpeg 为可选组件,仅在使用「录屏诊断」功能时需要;若仅提供截图进行分析,则无需安装。如需安装:macOS 执行 brew install ffmpeg,Windows 在 PowerShell 中执行 winget install Gyan.FFmpeg。

4. Python 3(可选)

仅在使用「封号检测」功能时需要。在终端执行 python3 --version 查看版本,显示 3.8 或更高即可;macOS 与常见 Linux 发行版通常已自带,Windows 可从 https://www.python.org/downloads/ 安装。


三、安装步骤

第 1 步:解压到固定目录

解压后可见两个文件夹:

建议放置位置:

请注意以下两点:

  1. 请勿直接放在「下载」文件夹中使用,该目录可能被系统清理;
  2. 安装完成后请勿删除或移动该目录。客户端配置中记录的是该路径,一旦移动需要重新安装。

第 2 步:运行安装程序

系统操作方式
macOS双击 一键安装.command(首次运行可能被系统拦截,处理方法见 3.1)
Windows双击 一键安装.bat(若出现「Windows 已保护你的电脑」,点击「更多信息」→「仍要运行」)
Linux在该目录中打开终端,执行 bash 一键安装.sh

3.1 macOS 首次运行被系统拦截

安装程序未做 Apple 签名,首次双击时系统会提示:

Apple 无法验证“一键安装.command”是否包含可能危害 Mac 安全或泄漏隐私的恶意软件。

这是系统对未签名脚本的常规保护提示,并非病毒警告。按以下步骤放行一次即可:

  1. 点击「好」关闭提示;
  2. 打开「系统设置」→「隐私与安全性」;
  3. 在「安全性」区域可看到「已阻止“一键安装.command”以保护 Mac」,其右侧有「仍要打开」;
  4. 点击「仍要打开」,输入电脑密码或使用触控 ID;
  5. 再次双击 一键安装.command,在弹窗中点击「打开」。

若未出现「仍要打开」,可先在文件上右键选择「打开」,再返回查看。 如仍无法运行,可在该目录打开终端执行 bash 一键安装.sh,此方式不受双击拦截影响。

3.2 安装程序会依次询问四项信息

  1. API 地址:直接回车,使用默认地址即可;
  2. 手机号:输入 TakeFlow 账号手机号后回车;
  3. 密码:输入过程中屏幕不显示任何字符(包括星号),此为正常现象,输入完成后直接回车;
  4. 需要接入的客户端:程序会依次询问 WorkBuddy、Codex、Claude Desktop、Cursor、DeepSeek Harness,请根据实际安装的客户端输入 y 或 n。其中 WorkBuddy、以及已检测到安装目录的 Codex 与 DeepSeek Harness 会默认选「是」,Claude Desktop 与 Cursor 默认选「否」。

完成后将显示:

✓ 登录成功,凭证已保存
✓ 连接验证通过,账号下共 8 个坐席
✓ 安装完成!

出现「安装完成」即表示安装成功。其中坐席数量以您账号的实际情况为准。

3.3 安装完成后可以关闭终端

可以。终端窗口仅用于运行安装程序,关闭不影响使用。连接器并非常驻后台的程序,客户端在需要调用时才会自动启动,使用完毕即退出。

窗口底部显示「进程已完成」,表示程序已正常退出。

第 3 步:重启客户端并验证

请将客户端完全退出后重新打开。WorkBuddy 需退出整个应用(macOS 使用 Cmd+Q,Windows 在托盘图标上选择退出),仅关闭窗口不生效。

随后输入以下指令进行验证:

请帮我查看 TakeFlow 的坐席列表,并标出即将到期的坐席

首次调用时,客户端可能询问是否允许该连接器,选择允许即可。若能正常返回坐席列表,说明安装与连接均已完成。


四、日常使用示例

以下场景均可通过一句话完成。AI 助手会自动判断所需的操作步骤,您无需了解背后的工具与参数。

查询坐席与到期时间

我有哪些坐席?哪些即将到期?

将返回坐席编号、绑定账号、粉丝数、到期时间与开机状态,临近到期者会单独标注。

开机、关机与查看画面

请将 16 号坐席开机,完成后把画面链接发给我

AI 助手会先与您确认目标坐席,随后执行开机并等待画面就绪,最后提供控制台链接。打开链接后,使用 TakeFlow 账号登录一次即可查看画面。

补充说明:坐席在未使用时处于关机状态,这不影响已排定的任务。平台会在任务开始前自动开机、任务结束后自动关机,无需人工干预。

续费与下单

29 号坐席续费 3 个月需要多少费用?

将先给出套餐与实付金额(含手续费),经您确认后才会下单,并提供支付链接。支付完成后,可请 AI 助手查询到账状态。

上传与发布作品

请把桌面上的 10月新品.mp4 发布到 52 号和 53 号坐席,文案沿用上一次的

该操作分为两个步骤:平台要求以素材目录为单位选择素材,无法直接指定单个文件。因此需要先将文件上传至云盘目录,再基于该目录创建发布任务。

您只需确认以下信息,其余步骤由 AI 助手完成:发布到哪些坐席、目录中有几条素材、立即发布或定时发布时间、标题与文案。

操作前建议了解以下规则:

修改账号资料

请把 16 号坐席的头像换成这张图片,并将昵称改为 your_nickname

头像会先上传至云盘并取得链接后自动替换,无需您自行处理格式。未提及的字段不会被清空:若只修改头像,昵称与简介保持原样。

查询播放数据

52 号坐席最近的作品播放情况如何?

将返回账号概览(粉丝数、获赞数、作品数)以及最近 10 条作品的数据。

两点提示:

分析失败任务

昨天的任务为什么没有发布成功?(附录屏文件路径或链接)

请分析这张截图,看看卡在哪一步。

将抽取关键帧并与规则库比对,输出四部分内容:分析结果、关键画面、核心判断、规避建议。

检测账号是否被封

请帮我查一下这几个 TikTok 账号还在不在:@user123、@user456、@user789

将逐个返回结论:存在、查无此号、存在但全零或未确认,并附昵称、作品数、粉丝数。十个账号约需两分钟,属正常速度。

两点提示:

其他常见操作

请检查所有坐席的登录状态,掉线的账号帮我重新登录

请给 2 号和 19 号坐席创建养号任务,明天早上 9 点开始

请帮我录入一条客户信息,开通 CLAW


五、需要您确认的操作

以下四类操作在执行前,AI 助手会复述操作内容并等待您确认:

类型示例确认方式
涉及费用续费下单「29 号坐席续费 3 个月,实付 ¥xxx(含手续费),是否确认下单?」
对外发布发布作品、修改头像昵称「发布到 52、53 号坐席,各 1 条,明天 10:00,标题为 xxx,是否确认?」
状态变更开机、关机、批量登录、养号任务「即将对 16 号坐席执行开机,是否确认?」
文件上传上传素材、创建目录「即将把 xxx.mp4 上传到『20261026』目录,是否确认?」

概括而言:涉及资金、账号状态与对外内容的操作,均会事先征求您的确认。


六、常见问题

排查前建议先确认当前版本号(见第八节)。联系技术支持时一并提供,有助于更快定位问题。

双击安装程序无反应

提示未检测到 Node.js

电脑未安装 Node.js,或版本低于 18。请前往 https://nodejs.org/zh-cn 安装 LTS 版本后重新运行安装程序。

安装完成后客户端中找不到 TakeFlow

请按以下顺序排查:

  1. 客户端是否已完全退出并重新启动?仅关闭窗口不生效;
  2. 在 WorkBuddy 中打开「插件 → MCP 服务器」,确认 takeflow 一项的状态是否正常(绿色),若显示红色则表示配置有误;
  3. 在安装目录打开终端,手动执行 node server/takeflow-mcp.mjs。该命令没有输出属正常现象,按 Ctrl+C 退出即可;若出现报错信息,请提供给技术支持。

提示未配置凭证或令牌失效

请重新运行安装程序完成登录。令牌每 30 天到期一次,属平台安全策略,并非故障。

登录失败,提示账号或密码错误

请确认使用的是 TakeFlow 平台账号(而非 TikTok 账号)。若该手机号尚未注册,安装程序会询问是否使用同一密码注册,输入 y 即可。

图片或视频上传失败

视频诊断提示缺少 ffmpeg

请参考第二节安装 ffmpeg,安装完成后重启客户端。若仅使用截图分析,则无需安装。

封号检测提示找不到 python3

该功能依赖 Python 3.8 及以上版本。请参考第二节第 4 项安装,安装完成后重新执行即可。若您的电脑不允许安装,可跳过该功能,不影响其他功能使用。

公司电脑不允许安装 Node.js

可请 IT 人员使用便携版 Node(解压即用,无需安装),并将客户端配置中的 command 指向该 node 文件,具体方式见附录。

ChatGPT 能直接使用这个连接器吗

不能。ChatGPT 运行在云端,无法调用您电脑上的程序;本连接器在本地运行,凭证与操作都不离开本机,因此无法添加进 ChatGPT。

若确需在 ChatGPT 中使用,需要单独部署一套公网网关,包含域名、证书、登录鉴权与日常运维。这部分属于独立服务,费用与本地接入包分开计算。WorkBuddy、Codex、Claude Desktop、Cursor、DeepSeek Harness 均为桌面客户端,不受此限制。


七、数据与隐私


八、版本、升级与卸载

如何确认当前版本

以下三种方式任选其一:

  1. 查看压缩包名称:形如 TakeFlow-MCP-本地接入包-v2.4.0-20261119.zip,v 之后为版本号,末尾 8 位为打包日期(2026 年 11 月 19 日);
  2. 运行安装程序:首行会显示版本号,查看后可直接关闭窗口,不会改动任何内容;
  3. 询问 AI 助手:「TakeFlow 连接器是什么版本?令牌还有多久到期?」即可获得本机相关信息。

联系技术支持时提供版本号,有助于缩短排查时间。

组件版本

安装包内含一个连接器与六项技能,版本如下:

组件版本用途
本地连接器v2.4.0安装程序与 MCP 服务
takeflow2.3.0坐席、开关机、续费、任务、素材、发布、账号资料、播放数据
seats-check1.0.0坐席登录状态与账号检查
cultivation-task1.0.0养号任务
client-info1.0.0客户信息录入
tiktok-auto-ops-diagnostic1.1.2失败任务录屏诊断
tiktok-ban-check1.0.0账号封号检测

技能随安装包一同发布,无需单独升级。

升级

将新版本压缩包解压并覆盖原目录(或解压至新目录),重新运行安装程序,随后重启客户端。原有配置与技能会先自动备份。本地版不会自动更新,需要手动执行。

卸载

  1. 删除 ~/.takeflow 目录(macOS 可在访达中按 Cmd+Shift+G,输入 ~/.takeflow 后回车);
  2. 打开客户端的 MCP 配置,删除 takeflow 一项(DeepSeek Harness 用户请删除 ~/.dsh/profiles/<profile>/cordis.patch.yml 中的 takeflow-mcp 条目);
  3. WorkBuddy 用户还需删除 ~/.workbuddy/skills/ 下的六个目录:takeflow、seats-check、cultivation-task、client-info、tiktok-auto-ops-diagnostic、tiktok-ban-check;DeepSeek Harness 用户对应删除 ~/.dsh/skills/ 下的同名目录。

九、法律与合规声明

本节说明本连接器与第三方平台、第三方商标之间的关系,以及使用过程中的责任边界,建议在使用前阅读。

第三方名称与图标

本指南、安装包及配套演示视频中出现的 WorkBuddy、Codex、Claude、DeepSeek Harness 等产品的名称、图标、界面截图与商标,分别归其各自权利人所有。上述内容仅用于说明本连接器的兼容范围与配置位置,不代表本产品与这些公司存在隶属、合作、代理、赞助或背书关系,也不代表其对本产品作出认证或推荐。相关名称与图标的使用不构成对其权利的挑战;如权利人认为使用方式不当,我们将在收到通知后及时调整或移除。

MCP 是通用开放协议

Model Context Protocol(MCP)是一项开放的技术协议,不属于本产品的专有技术。本连接器依据该协议实现,因而可以在支持 MCP 的客户端中调用;协议本身的演进、版本变更与兼容性,由其规范维护方决定。「支持 MCP」仅表示技术上具备对接条件,不代表任何平台对本产品进行认证、收录或推荐。

需同时遵守各平台规范

接入与使用各智能平台时,您需要同时遵守该平台的用户协议、开发者条款、使用政策以及您所在地区的法律法规。各平台对 MCP 的支持范围、配置方式、可用功能与调用频次,均由平台方自行决定,并可能随时调整、限制或终止。本产品无法保证在任一平台的持续可用性,也不对平台方的上述行为承担责任。

使用边界

本连接器仅限用于您自有或已获授权的 TakeFlow 账号与 TikTok 账号的日常运营。请勿将其用于规避平台风控与审核、批量注册或买卖账号、发布违法违规内容,以及其他违反平台规则或法律的行为。您账号下执行的操作及其后果,由您自行承担。

第三方数据与服务

播放数据、封号检测等结果来自第三方公开数据源,可能存在延迟、截断或缺失,仅供运营参考,不作为平台官方结论,也不作为法律依据。

责任范围

本指南用于说明技术接入方式,不构成对任何第三方平台的授权、代理或担保。因客户端版本变更、平台规则调整、网络环境或第三方数据源异常导致的接入失败、功能受限或数据偏差,我们将协助排查,但不承担由此产生的间接损失。


附录:面向 IT 人员的手动配置

本节供 IT 人员参考。普通用户按第三节运行安装程序即可,无需阅读本节。

A1. 手动获取令牌

curl -X POST https://saas.takeflows.com/admin-api/system/tk-auth/login \
  -H 'Content-Type: application/json' \
  -d '{"phoneNumber":"13800000000","password":"您的密码"}'

将返回的 accessToken 与 refreshToken 写入 ~/.takeflow/config.json,并将文件权限设置为 600:

{
  "baseUrl": "https://saas.takeflows.com",
  "phoneNumber": "13800000000",
  "accessToken": "登录返回的 accessToken",
  "refreshToken": "登录返回的 refreshToken",
  "expiresTime": 1792633796480
}

A2. 客户端配置

客户端配置文件
WorkBuddy~/.workbuddy/mcp.json(Windows:%USERPROFILE%\.workbuddy\mcp.json)
Codex CLI~/.codex/config.toml
Claude DesktopmacOS ~/Library/Application Support/Claude/claude_desktop_config.json;Windows %APPDATA%\Claude\claude_desktop_config.json
Cursor~/.cursor/mcp.json
DeepSeek Harness~/.dsh/profiles/<profile>/cordis.patch.yml(桌面版 profile 为 desktop)
{
  "mcpServers": {
    "takeflow": {
      "command": "/绝对路径/node",
      "args": ["/绝对路径/TakeFlow-MCP/server/takeflow-mcp.mjs"],
      "env": { "TAKEFLOW_HOME": "/Users/您的用户名/.takeflow" }
    }
  }
}
[mcp_servers.takeflow]
command = "/绝对路径/node"
args = ["/绝对路径/TakeFlow-MCP/server/takeflow-mcp.mjs"]

[mcp_servers.takeflow.env]
TAKEFLOW_HOME = "/Users/您的用户名/.takeflow"
# DeepSeek Harness:写在 profile 目录的 cordis.patch.yml
- id: takeflow-mcp
  name: '@deepseek-ai/dsh-mcp-client'
  config:
    serverName: takeflow
    transport: stdio
    command: "/绝对路径/node"
    args:
      - "/绝对路径/TakeFlow-MCP/server/takeflow-mcp.mjs"
    env:
      TAKEFLOW_HOME: "/Users/您的用户名/.takeflow"
    toolCallTimeoutMs: 300000
    failOnStartupError: true

DeepSeek Harness 另有三点需留意:请修改 cordis.patch.yml 而非同目录的 cordis.yml;安装完成后须完全退出应用再启动;toolCallTimeoutMs 若沿用默认的 60 秒,视频抽帧会因下载耗时较长而中断。

两点注意事项:

A3. Codex 的技能索引

Codex 没有技能机制,安装程序会在 ~/.codex/AGENTS.md 中维护一段由 <!-- takeflow-skills:start --> 到 end 的索引,用于告知模型在何种场景下读取哪份说明。该段之外的内容不会被改动。

如需了解更详细的字段与参数说明,可查阅同目录下的 README.md。


若安装或使用过程中遇到问题,可将终端中的报错信息截图发送给技术支持,也可直接询问 AI 助手:「我安装 TakeFlow 连接器时出现了以下报错,应如何处理?」

本页由 接入指南.md 自动生成,内容与 md 完全一致;如需修改,请改 md 后重新生成,不要直接编辑此文件。