User Guide

Longtee 使用指南

不需要先理解模型、Agent 或 MCP。直接说清楚你想完成的目标,Longtee Code 会负责理解需求、检查能力、选择执行路径、协调内核并返回结果。 只有任务需要真实操作本机文件、浏览器、账号或外部系统时,才进入相应的授权与执行流程。

Start Here

第一次使用,按这六步走

1 登录或注册

登录后才能使用需要账号的任务、查看用量、管理会员和查看任务结果。

登录/注册
2 进入 Longtee Code

这是统一的智能任务入口。普通任务不需要先手动选择 Codex、Hermes、LongClaw 或 Claude。

新建任务
3 描述目标

说明你要完成什么、结果希望是什么形式,以及是否需要实际操作文件、浏览器或平台账号。

开始对话
4 按需要连接本机

需要读取或写入本机文件、打开浏览器、使用登录态或执行桌面自动化时,安装并启动 Desktop Connector。

下载与连接
5 确认真实操作

发布、评论、账号操作、文件写入等有外部影响的动作,会在派发前显示审批卡片。

查看审批
6 检查结果和用量

完成后查看回答、成功证据、失败原因、Trace、执行模式和会员中心的实际用量记录。

查看用量

Portal Map

各个入口分别做什么?

Longtee Code

统一理解需求、检查能力、规划步骤、选择 Agent、调度 MCP/Connector、验证结果并汇总到当前会话。

打开 Longtee Code
AI 数字人

制作口播、人物和数字人视频。具体模型、密钥和费用以数字人页面及对应 API 账户状态为准。

打开 AI 数字人
媒体与电商创作

生成商品主图、场景图、卖点图、短视频和电商模板内容,支持按电商、社交媒体、短剧等场景创作。

打开媒体创作
我的作品

在媒体创作页统一查看已成功生成并完成交付的图片和视频。失败或未完成的任务不会进入成品列表。

查看我的作品
MCP 工具

MCP Hub 负责发现工具、校验参数、选择 Connector、记录调用和回调状态。普通用户通常不需要手动处理协议细节。

打开 MCP
技能中心

查看可用技能及其状态。技能是可复用的专项能力,是否需要启用由任务的能力检查结果决定。

打开技能中心
手机连接

管理移动端消息和平台连接。接入的消息仍回到 Longtee Code 统一理解和调度。

打开手机连接
下载中心

下载 Desktop Connector、Hermes、LongClaw,以及接入官方 Codex 的 Longtee Adapter。普通用户先用 Longtee Code;需要独立运行某个本地 Agent 时再从这里安装。

打开下载中心
模型 API

面向开发者和外部应用创建 API Key、充值和调用模型。API 账户、钱包与门户 Longtee Code 积分分开管理。

打开 API 网关

Longtee Code

Longtee Code 如何处理一条任务?

理解目标

先判断你要的是文字结果、文件结果、平台动作、网页研究还是媒体作品,不把“写方案”和“真实执行”混为一谈。

能力检查

执行前检查内置能力、技能中心、MCP 工具和本机 Connector;缺少必要能力时会说明阻塞点,而不是假装已经完成。

规划与调度

复杂任务可以拆成多个步骤,按任务需要选择 Codex、Hermes、LongClaw、Claude 或 Longtee Code 自身能力。

执行与回调

需要工具时经过 MCP Hub 调度;需要本机能力时通过 Desktop Connector 执行。回调会关联到同一条任务 Trace。

结果验证

文件类任务应回读路径或内容,平台类任务应返回执行证据,媒体类任务以真实任务状态和成品回传为准。

状态可追踪

会话中可能显示理解、能力检查、规划、调度、执行、验证和汇总阶段,以及 Agent、Tool、execution_mode 和 Trace。

Agent Roles

四个内核怎么分工?

  • Codex:代码、项目文件、脚本、工程实现和技术排查。
  • Hermes:网页和社交平台流程、电商运营及需要平台登录态的任务。
  • LongClaw:网页研究、资料整理、浏览链路和本机文件/桌面协同。
  • Claude:复杂分析、架构评审、长文本和需要更强表达或推理的任务。
自动选择与手动指定

未指定内核时,由 Longtee Code 根据目标和可用能力安排。使用 @Codex、@Hermes、@LongClaw 或 @Claude 时,指定内核参与当前任务;遇到理解不足或能力不匹配,Longtee Code 可以继续兜底。

能力不是承诺已完成

Agent 的文字回答、工具调用和真实执行是不同状态。只有收到实际回调、文件回读或平台证据,才表示动作完成。

Desktop Connector

什么时候需要本机连接器?

  • 在电脑创建、读取、修改或保存你明确指定的文件。
  • 打开本机浏览器,使用已登录的平台账号或浏览器配置。
  • 执行网页自动化、桌面 GUI、截图识别和键鼠操作。
  • 调用安装在电脑上的本机技能、脚本或本地运行时。
不需要连接器

普通文字分析、写方案、写文案、生成模板、云端模型回答、查看会员中心和管理 API,都可以直接在网页完成。

连接和隐私边界

安装包从下载中心获取。门户只检测连接器在线状态,不会主动扫描硬盘;需要本机执行时,任务会明确使用 Connector,并按权限和审批规则执行。

Approval

什么时候会出现审批?

内容任务默认直接回答

评审、分析、总结、写方案、写文案、规划等只产生文字结果时,原则上不需要审批,也不会因为出现“请执行”四个字就自动操作外部系统。

真实副作用需要确认

文件写入或删除、运行代码、调用外部 API、浏览器自动化、账号操作、发布、评论等,会进入授权和审批边界。

批准前不会派发

需要审批的任务会先显示审批卡片。批准后才派发到 MCP Hub、Desktop Connector 或对应 Agent;拒绝后不会执行该动作。

完成后检查证据

请检查状态是否为完成、Connector 是否成功、Trace 是否存在,以及返回的路径、快照、回读值或平台证据是否与目标一致。

Create

媒体、数字人和我的作品

媒体创作

在媒体创作页选择 AI 图片或 AI 视频,按电商、社交媒体、短剧等场景填写提示词、素材和参数。提交前页面会检查当前 API 密钥可用的模型和钱包状态。

进入媒体创作
AI 数字人

用于人物口播、数字人视频和配音成片。按页面提示配置可用的 API 密钥或账户余额,再提交生成任务;具体可用能力以页面实时状态为准。

进入 AI 数字人
我的作品

媒体任务成功生成并完成交付后,成品会进入“我的作品”;失败、取消或未完成任务只保留在任务状态中,不会冒充成品。

查看作品

Examples

推荐指令写法

内容分析

请评审这份方案的风险和遗漏,只返回文字分析,不操作外部系统,也不保存文件。

代码任务

@Codex 请读取我指定的 CSV,生成汇总脚本并保存为本机文件。完成后返回文件路径、内容校验结果和 Trace。

本机文件任务

@LongClaw 请把这份内容保存到我指定的文件夹。批准前不要写入,完成后回读文件并确认是否存在。

平台自动化任务

@Hermes 请在已登录的平台完成指定操作。先展示审批卡,批准后通过 Desktop Connector 执行,并返回页面证据。

Billing

积分、API 钱包和用量怎么区分?

Longtee Code 账务

Longtee Code 使用门户会员积分。模型实际产生输入/输出时会形成用量记录;实际扣费、失败状态和退款以会员中心的用量与账单为准。

查看门户用量
MCP 与 Desktop Connector

当前门户规则中,MCP 工具和 Desktop Connector 不额外扣 Longtee Code 积分;但通过工具调用的模型或第三方服务,仍按对应服务账务结算。

媒体与数字人

图片、视频和数字人能力使用对应 API 密钥与 API 钱包,和 Longtee Code 门户积分分开。提交前先检查 API Key 的模型权限和余额。

开发者 API

API Key、充值、模型调用和 API 用量在独立 API 网关管理,不会自动显示为 Longtee Code 的门户积分消耗。

打开 API 网关

FAQ

常见问题

我应该先选哪个 Agent?

不确定时先进入 Longtee Code,让它根据目标选择。需要时也可以用 @ 指定 Codex、Hermes、LongClaw 或 Claude;指定并不等于已经完成真实操作。

为什么回答里会显示理解、能力检查、调度和验证?

这些是任务状态。它们用于说明 Longtee Code 当前处于哪一步;最终应同时检查交付状态和实际证据,不能只看“已调度”。

连接器在线但任务没有执行怎么办?

先看会话中的 Trace、状态、目标 Agent、execution_mode 和失败原因,再确认连接器在线、平台账号已登录、审批已批准,以及浏览器是否需要人工验证。

媒体任务失败,为什么没有出现在我的作品?

“我的作品”只展示成功生成并完成交付的成品。失败任务请在媒体页的任务状态中查看真实回调、上游错误和重试结果。

API Key 没有某个模型能力怎么办?

先在 API 网关检查 Key 的模型权限、白名单和钱包余额。门户媒体页显示的可用模型也以当前 Key 能力为准。

平台要求扫码、验证码或人工验证怎么办?

AI 不能绕过平台安全验证。请在 Desktop Connector 控制的本机浏览器中完成验证,完成后再让任务继续。