经 AI Skill Hub 精选评估,Synax 获评「推荐使用」。这款Agent工作流在功能完整性、社区活跃度和易用性方面表现出色,AI 评分 7.5 分,适合有一定技术背景的用户使用。
Synax 是一套完整的 AI Agent 自动化工作流方案。通过可视化的节点编排,将复杂的多步骤任务拆解为清晰的自动化流程,实现全程无人值守的智能处理。支持与数百种外部服务和 API 无缝集成,适合构建数据处理管线、业务自动化和 AI 辅助决策系统。
Synax 是一套完整的 AI Agent 自动化工作流方案。通过可视化的节点编排,将复杂的多步骤任务拆解为清晰的自动化流程,实现全程无人值守的智能处理。支持与数百种外部服务和 API 无缝集成,适合构建数据处理管线、业务自动化和 AI 辅助决策系统。
# 方式一:npm 全局安装 npm install -g synax # 方式二:npx 直接运行(无需安装) npx synax --help # 方式三:项目依赖安装 npm install synax # 方式四:从源码运行 git clone https://github.com/coldmint9/Synax cd Synax npm install npm start
# 命令行使用
synax --help
# 基本用法
synax [options] <input>
# Node.js 代码中使用
const synax = require('synax');
const result = await synax.run(options);
console.log(result);
# synax 配置说明 # 查看配置选项 synax --config-example > config.yml # 常见配置项 # output_dir: ./output # log_level: info # workers: 4 # 环境变量(覆盖配置文件) export SYNAX_CONFIG="/path/to/config.yml"
Synax is built around one core loop: import a local codebase, analyze its files and symbols, generate a Codebase Design Wiki with source bindings, then keep that wiki refreshed as the code changes.
The Wiki is not meant to be decorative documentation. It is the project's structured context layer: a place where architecture, modules, APIs, flows, risks, decisions, source references, refresh drafts, and future agent work can meet without drifting away from the actual code.
The project is built as a TypeScript monorepo with a Hono API, React web client, libSQL/Drizzle persistence, tree-sitter based code analysis, a profile-driven agent runtime, and an Electron desktop shell.
build-essential (Debian/Ubuntu) or equivalent (gcc, g++, make).git clone https://github.com/coldmint9/Synax.git
cd Synax
npm install
Synax reads .env automatically through dotenv/config, but no template file is required. Create .env only when you need to override defaults.
| Variable | Default | Description |
|---|---|---|
PORT | 3210 | API server port. |
WEB_PORT | 5173 | Vite development server port. |
WEB_HOST | 0.0.0.0 | Vite development server host used by dev scripts. |
DATA_ROOT | .data | Local data directory for libSQL, project metadata, config, logs, and model catalog cache. |
LOG_LEVEL | info | API log level. |
CONFIG_ENCRYPTION_KEY | unset | Secret used to encrypt stored provider keys. |
Synax_CONFIG_SECRET | unset | Alternative secret used for config encryption. |
CONTEXT_SESSION_TTL_HOURS | 72 | Context session expiration window. |
CONTEXT_TOKEN_WARNING_THRESHOLD | 32000 | Token warning threshold for context sessions. |
CONTEXT_MEMORY_MAX_PER_PROJECT | 500 | Maximum stored memory entries per project. |
Runtime data is local by default and is ignored by Git. Use a stable CONFIG_ENCRYPTION_KEY or Synax_CONFIG_SECRET before storing provider credentials you intend to keep across machines or environments.
The API is mounted under /api and organized by domain:
/api/projects for project metadata and local imports./api/wiki for snapshots, documents, blocks, refresh drafts, patches, exports, and design mapping./api/agent-runtime for profiles, skills, contexts, sessions, streamed turns, permissions, and runtime events./api/config and /api/llm for provider configuration and model discovery./api/context for memory, coordinates, sessions, and contextual signals./api/acp for Agent Client Protocol discovery and provider integration./api/notifications, /api/logs, and /api/health for operational support.npm run typecheck
npm run test
npm run lint
Synax 是围绕一个核心循环构建的:导入本地代码库,分析其文件和符号,生成一个 Codebase Design Wiki,绑定源代码,随着代码的变化而保持该 Wiki 的更新。该 Wiki 不是用于装饰性的文档。它是项目的结构化上下文层:一个地方,架构、模块、API、流程、风险、决策、源代码引用、刷新草稿等都可以在这里找到。
Synax 的主要功能包括:代码库设计 Wiki:从源代码生成层次化文档,绑定 Wiki 块回源文件和符号,导出 Markdown,随着代码的变化而刷新文档。- 代理运行时:运行规划器、执行器、审查员、探索者、Wiki 专用配置文件,使用流式事件、权限门控、暂停、恢复、取消和会话历史等功能。- 上下文内存:持久化项目上下文、对话等。
Synax 的环境依赖与系统要求包括:Node.js 22(>=22,<23)、npm 10 或新版本、Git、一个本地构建工具链包(tree-sitter 包)。在 macOS 上,安装 Xcode Command Line Tools;在 Windows 上,安装 Visual Studio Build Tools(C++ workload);在 Linux 上,安装 `build-essential`(Deb)。
安装 Synax,需要执行以下步骤:git clone https://github.com/coldmint9/Synax.git,cd Synax,npm install
Synax 的使用教程包括:快速启动、配置文件等
Synax 读取 `.env` 文件自动通过 `dotenv/config`,但不需要模板文件。创建 `.env` 文件仅当需要覆盖默认值时。配置变量包括:PORT(API 服务器端口)、WEB_PORT(Vite 开发服务器端口)、WEB_HOST(Vite 开发服务器主机)等
Synax 的 APISurface 部分包括:/api/projects(项目元数据和本地导入)、/api/wiki(快照、文档、块、刷新草稿、补丁、导出、设计映射)、/api/agent-runtime(配置文件、技能、上下文、会话、流式事件、权限门控等)
Synax 的开发工作流包括:保持变更集中和小到足够可以审查的程度、添加或更新测试当触摸运行时行为、持久化、路由契约或 Wiki 生成时、在打开拉取请求前运行相关检查:npm run typecheck、npm run test、npm run lint
高质量的AI工作流项目
AI Skill Hub 为第三方内容聚合平台,本页面信息基于公开数据整理,不对工具功能和质量作任何法律背书。
建议在沙箱或测试环境中充分验证后,再部署至生产环境,并做好必要的安全评估。
✅ MIT 协议 — 最宽松的开源协议之一,可自由商用、修改、分发,仅需保留版权声明。
AI Skill Hub 点评:Synax 的核心功能完整,质量良好。对于自动化工程师和运维人员来说,这是一个值得纳入个人工具库的选择。建议先在非生产环境试用,再逐步推广。
| 原始名称 | Synax |
| 原始描述 | 开源AI工作流:Turn a local codebase into a source-linked, refreshable design wiki that becomes。⭐7 · TypeScript |
| Topics | ai-agenttypescriptworkflow |
| GitHub | https://github.com/coldmint9/Synax |
| License | MIT |
| 语言 | TypeScript |
收录时间:2026-06-03 · 更新时间:2026-06-06 · License:MIT · AI Skill Hub 不对第三方内容的准确性作法律背书。
选择 Agent 类型,复制安装指令后粘贴到对应客户端