thousandsailagent

ThousandSailAgent（千帆 Agent）

千帆竞发，万舸争流 — 多 AI Agent 编排框架，用声明式 YAML 定义 Agent 协作流程。

特性

• 声明式工作流 — 用 YAML 定义多步骤 Agent 编排规则，支持依赖关系和并行执行
• 多模型混用 — 不同步骤可使用不同 LLM（DeepSeek 写代码、GLM 审查、Qwen 生成测试）
• 国产模型优先 — 内置 DeepSeek、智谱GLM、通义千问、Moonshot、豆包 等国内主流模型支持
• 真实工具调用 — Agent 自主决定何时读写文件、执行命令，多轮工具调用循环
• 交互式配置 — TUI 引导配置 Provider、选择默认模型、验证 API Key 有效性
• 中英文界面 — tsail config --lang en 一键切换界面语言
• 执行历史 — SQLite 存储每次运行记录，可回溯查看

安装

npm install -g thousandsailagent

快速开始

1. 配置 Provider

tsail config

交互式引导，选择 LLM Provider、输入 API Key、选择默认模型：

◆ 选择要配置的 Provider
│ ● DeepSeek（深度求索）     已配置 ✓
│ ○ 智谱 GLM（ChatGLM）
│ ○ 通义千问（Qwen）
│ ○ Moonshot（Kimi）
│ ○ 豆包（火山引擎）
│ ○ Anthropic（Claude）
│ ○ OpenAI（GPT）
│ ○ 自定义 Provider
└ ○ 完成配置

也可以直接配置指定 Provider：

tsail config deepseek    # 跳过菜单，直达 DeepSeek 配置

2. 编写工作流

创建 pipeline.yaml：

name: code-review-pipeline

steps:
  - id: code
    agent: coder
    model: deepseek/deepseek-v4-flash
    prompt: "根据以下需求实现功能: {{input.requirement}}"
    tools: [file_write, file_read, terminal]
    max_steps: 5

  - id: review
    agent: reviewer
    model: glm/glm-4-flash
    prompt: "审查代码，检查安全和性能问题: {{steps.code.output}}"
    depends_on: [code]
    tools: [file_read]

  - id: test
    agent: tester
    model: deepseek/deepseek-v4-flash
    prompt: "为以下代码编写单元测试并执行: {{steps.code.output}}"
    depends_on: [code]
    tools: [file_write, file_read, terminal]
    max_steps: 5

  - id: refine
    agent: coder
    model: deepseek/deepseek-v4-flash
    prompt: "根据审查意见和测试结果修改代码。审查: {{steps.review.output}} 测试: {{steps.test.output}}"
    depends_on: [review, test]
    tools: [file_write, file_read, terminal]
    max_steps: 5
    retry_count: 1

3. 运行

tsail run pipeline.yaml -i requirement="实现一个HTTP服务器"

使用 --verbose 查看工具调用详情：

tsail run pipeline.yaml -i requirement="实现一个HTTP服务器" --verbose

CLI 命令

命令	说明
tsail run <file>	运行工作流 YAML
tsail config	交互式配置 Provider
tsail config <provider>	直接配置指定 Provider（如 tsail config deepseek）
tsail config --lang en	切换界面语言（zh/en）
tsail providers	查看已配置的 Provider
tsail providers --test	验证所有 API Key 是否有效
tsail list	列出当前目录的工作流文件
tsail history [id]	查看运行历史

run 选项

-i, --input <k=v...>   传入输入参数
-d, --db <path>        指定数据库路径
    --verbose          显示详细输出（含工具调用详情）

工作流 YAML 语法

name: <工作流名称>
workdir: <工作目录>            # 可选，工具在指定目录下执行

steps:
  - id: <步骤ID>              # 必填，唯一标识
    agent: <Agent类型>         # coder / reviewer / tester
    model: <provider/model>    # 必填，支持省略模型名使用默认模型
    prompt: <提示词>           # 必填，支持模板变量
    tools: [file_read, ...]    # 可用工具列表
    depends_on: [step_id, ...] # 依赖的步骤（可选）
    max_steps: <number>        # 最大工具调用轮数（可选）
    retry_count: <number>      # 失败重试次数（可选）

模板变量

变量	说明
{{input.xxx}}	运行时传入的参数
{{steps.xxx.output}}	上游步骤的 LLM 输出

模型引用

model: deepseek/deepseek-v4-flash   # 完整写法
model: deepseek                      # 省略模型名，使用配置的默认模型

依赖与并行

无 depends_on 的步骤会并行执行，有依赖的步骤等待上游完成后才启动。

支持的 Provider

Provider	类型	默认模型
DeepSeek	OpenAI-compatible	deepseek-v4-flash
智谱 GLM	OpenAI-compatible	glm-4-flash
通义千问	OpenAI-compatible	qwen-plus
Moonshot	OpenAI-compatible	moonshot-v1-8k
豆包	OpenAI-compatible	doubao-pro-32k
Anthropic	Anthropic	claude-sonnet-4-20250514
OpenAI	OpenAI-compatible	gpt-4o

也支持通过 tsail config 添加任意 OpenAI-compatible API。

开发进度

当前版本：V0.3.0

已完成

• YAML 工作流解析与 Zod 校验
• DAG 依赖分析与并行调度
• 多 Provider LLM 调用（7 个内置 + 自定义）
• 交互式 TUI Provider 配置（模型选择、API Key 验证）
• API Key AES-256-CBC 加密存储
• 模板变量解析（input / steps.output）
• 内置工具注册（file_read / file_write / terminal）
• SQLite 执行历史持久化
• CLI 工具（run / config / providers / list / history）
• 端到端测试（42 个测试全部通过）
• 真实 API 调用验证（DeepSeek + GLM）
• Agent 类型系统提示（coder / reviewer / tester 差异化策略）
• LLM 真实工具调用（自主决定读写文件、执行命令）
• 工具调用可观测（--verbose 显示工具名、参数、返回值）
• 工作目录支持（workdir）
• 步骤重试机制（retry_count）
• 上下文智能摘要（压缩长文本，控制 Token 消耗）
• 配置系统完善（模型选择、Key 验证、删除、快捷入口、测试）
• 中英文界面切换
• 配置目录自动迁移

待开发

• 条件分支（if/else 工作流）
• 人工审批节点
• 更多工具（HTTP 请求、Web 搜索）
• Web Dashboard
• VS Code 插件

开发

git clone https://github.com/Lion-1209/ThousandSailAgent.git
cd ThousandSailAgent
npm install
npm test        # 运行测试
npm run dev -- --help   # 开发模式运行

License

MIT