[English](../README.md) · [العربية](README.ar.md) · [Español](README.es.md) · [Français](README.fr.md) · [日本語](README.ja.md) · [한국어](README.ko.md) · [Tiếng Việt](README.vi.md) · [中文 (简体)](README.zh-Hans.md) · [中文（繁體）](README.zh-Hant.md) · [Deutsch](README.de.md) · [Русский](README.ru.md)

Lachlan Chen banner

AgInTiFlow banner

# AgInTiFlow ![Node.js](https://img.shields.io/badge/Node.js-22%2B-339933?logo=nodedotjs&logoColor=white) ![Playwright](https://img.shields.io/badge/Browser-Playwright-2EAD33?logo=playwright&logoColor=white) ![CLI + Web](https://img.shields.io/badge/Interface-CLI%20%2B%20Web-0ea5e9) ![Text Models](https://img.shields.io/badge/Text-LocalLLM%20%2B%20Optional%20Hosted-2563eb) ![Aux Image](https://img.shields.io/badge/Aux%20Image-GRS%20AI%20%2B%20Venice-ec4899) ![Sandbox](https://img.shields.io/badge/Shell-Docker%20Sandbox-f97316) ![Status](https://img.shields.io/badge/Status-Prototype-7c3aed) **面向真实问题的低成本、项目感知智能体。** AgInTiFlow 是一个 project-aware agent 工作空间，面向混合干湿研发、硬件感知智能、软件自动化和工业工作流。从实验规划到数据分析，从硬件控制到生产脚本，从显微成像、无人机和机器人到报告，它帮助智能体通过 API、Web 或 CLI 工作，并配合 SCS 监督、AAPS 工作流、受保护执行和持久证据。 简短理解：在项目目录里运行 `aginti`，交给它一个任务，检查它的计划，看到每一次工具调用，之后还能恢复会话，并把输出保留在你的工作区里。 > **翻译时效提示：** 此译文的部分细节可能落后于[当前英文 README](../README.md)和[本地优先运行时说明](../docs/local-first-agent-runtime.md)。默认使用 `http://127.0.0.1:8008/v1` 上的 LocalLLM，并采用 `localllm-fast` 与 `localllm-deep`。Hosted provider 只是必须明确选择的可选升级；环境中已有密钥不会选择 provider，也不会触发自动 fallback。辅助图像生成同样默认关闭，必须明确启用。 **链接** | 资源 | URL | | --- | --- | | 网站 | [https://flow.lazying.art](https://flow.lazying.art) | | GitHub | [https://github.com/lazyingart/AgInTiFlow](https://github.com/lazyingart/AgInTiFlow) | | npm | [https://www.npmjs.com/package/@lazyingart/agintiflow](https://www.npmjs.com/package/@lazyingart/agintiflow) | | AAPS npm | [https://www.npmjs.com/package/@lazyingart/aaps](https://www.npmjs.com/package/@lazyingart/aaps) | | 产品定位 | [../references/agintiflow-product-positioning.md](../references/agintiflow-product-positioning.md) | | 完整归档 README 参考 | [../references/notes/readme-full-reference-2026-05-05.md](../references/notes/readme-full-reference-2026-05-05.md) |

AgInTiFlow interactive CLI launch screen with colorful terminal banner, Docker workspace status, and chat input panel

## 为什么存在 大多数智能体工具要么只是一个带隐藏状态的聊天框，要么是一个昂贵的单模型循环。AgInTiFlow 采用另一种设计哲学： | 原则 | 实际含义 | | --- | --- | | 本地智能会改变架构 | 基线使用相邻的 LocalLLM gateway，在本地私密运行 route 与 main；Hosted model 保持为明确选择的升级。 | | 可检查胜过神秘 | 计划、工具调用、文件 diff、命令输出、画布产物和会话事件都会保存，并可恢复。 | | 基于角色的模型 | route、main、spare、wrapper、auxiliary image 是分开的角色。LocalLLM Fast/Deep 是默认值；DeepSeek、OpenAI、OpenRouter、Qwen、Venice 都要明确选择。 | | 大任务前先 scouts | 并行 scouts 可以低成本绘制架构、测试、风险、符号和集成点，然后主执行器再编辑文件。 | | SCS 用于高风险工作 | Student-Committee-Supervisor 模式增加类型化关卡：committee 起草，student 批准/监控，supervisor 执行。使用 `/scs` 或 `--scs auto`。 | | AAPS 用于大型流程 | AAPS 描述自顶向下的智能体流水线脚本；AgInTiFlow 可以作为交互式后端验证、编译和执行这些流程。 | | 默认本地安全 | Docker workspace、路径保护、密钥脱敏、阻止 npm publish/token 命令、可见日志，让智能体实用但不黑箱。 | ## 快速开始 安装并打开一个项目： ```bash npm install -g @lazyingart/agintiflow cd /path/to/your-project aginti init aginti ``` 默认情况下，AgInTiFlow 无需 Hosted key，连接 `http://127.0.0.1:8008/v1` 上相邻的 LocalLLM 服务：route 使用 `localllm-fast`，main 使用 `localllm-deep`。只有在使用 DeepSeek、OpenAI、OpenRouter、Qwen 或 Venice 时，才明确选择 provider 并运行认证向导。LocalLLM 失败会以清晰错误停止，不会自动把任务发送到云端： ```bash aginti auth aginti auth deepseek aginti auth openrouter aginti auth venice aginti login grsai ``` 已保存的 Hosted key 只用于认证，不会改变 active provider。辅助图像工具在明确使用 `/auxiliary on`、`/auxiliary image` 或对应开关之前保持关闭。 从同一项目启动 Web UI： ```bash aginti web --port 3210 # open http://127.0.0.1:3210 ``` 没有真实模型凭据时也可以用本地 mock 做冒烟测试： ```bash aginti --provider mock --routing manual --allow-file-tools "Create notes/hello.md with a smoke-test note" ``` 显式指定语言，或省略以跟随系统 locale： ```bash aginti --language ja aginti --language zh-Hans aginti --language de ``` ## 日常命令 | 目标 | 命令 | | --- | --- | | 启动交互式聊天 | `aginti` 或 `aginti chat` | | 启动本地 Web 应用 | `aginti web --port 3210` | | 保存 provider 密钥 | `aginti auth`, `/auth`, `/login` | | 审查当前仓库 | `/review [focus]` | | 切换 SCS 质量关卡 | `/scs` | | 仅在复杂任务使用 SCS | `/scs auto` 或 `aginti --scs auto "task"` | | 使用 AAPS 流程 | `aginti aaps status`, `/aaps validate` | | 选择模型 | `/route`, `/model`, `/spare`, `/wrapper`, `/auxiliary model` | | 启用 Venice 快捷模式 | `/venice` | | 生成图像 | `/auxiliary image`，然后描述图像需求 | | 恢复当前项目 | `aginti resume` | | 浏览全部会话 | `aginti resume --all-sessions` | | 向运行中会话排队 | `aginti queue "extra instruction"` | | 清理空会话 | `aginti --remove-empty-sessions` | | 检查能力 | `aginti capabilities`, `aginti doctor --capabilities` | | 同步已审查技能 | `aginti skillmesh status`, `aginti skillmesh sync` | | 更新 CLI | `aginti update` | 交互式聊天支持 slash 补全、Up/Down 选择器、用 `Ctrl+J` 输入多行、完整恢复历史、Markdown 渲染、可见运行状态、运行期间的 ASAP pipe 消息，以及用 `Ctrl+C` 干净中断/恢复。已安装的交互命令还会检查 npm 上是否有新版本，并显示更新/跳过选择器；源码 checkout 和非 TTY 自动化不会被打扰。 如果需要完全可控的一次性恢复，使用显式 session id，并主动选择任务 profile。普通路由用 `auto`，Android/模拟器相关工作用 `android`： ```bash PROFILE=android # or auto aginti --resume \ --profile "$PROFILE" \ --sandbox-mode host \ --package-install-policy allow \ --approve-package-installs \ --allow-shell \ --allow-file-tools \ --allow-destructive \ "Take a fresh screenshot of the running app in the emulator, save it with a durable filename in this project, and keep git status clean." ``` ## 真实截图 | CLI 启动 | Web 应用概览 | | --- | --- | | AgInTiFlow CLI launch | AgInTiFlow web app overview | | 任务控制 | 运行输出 | | --- | --- | | AgInTiFlow task controls | AgInTiFlow runtime output | | 对话历史 | 沙箱状态 | | --- | --- | | AgInTiFlow conversation history | AgInTiFlow sandbox status | | 移动端概览 | | --- | | AgInTiFlow mobile overview | 旧版启动截图保留在源码仓库的 [demos/archive/](https://github.com/lazyingart/AgInTiFlow/tree/main/demos/archive)。 ## 核心能力 | 能力 | AgInTiFlow 提供什么 | | --- | --- | | CLI 智能体工作区 | 持久终端聊天，带项目 cwd、会话恢复、可见模型/工具状态和清晰命令提示。 | | 本地 Web 工作区 | 浏览器 UI，包含会话、运行日志、产物、模型设置、项目控制、画布预览和沙箱状态。 | | 文件工具 | `inspect_project`, `list_files`, `read_file`, `search_files`, `write_file`, `apply_patch`, `open_workspace_file`, `preview_workspace`。 | | Shell 工具 | 受保护的 host 或 Docker workspace shell 执行，带包安装策略和命令安全检查。 | | 浏览器工具 | Playwright 浏览器操作，延迟启动，并可配置域名 allowlist。 | | 模型路由 | LocalLLM Fast/Deep 是默认值。DeepSeek、OpenAI、OpenRouter、Qwen、Venice、mock 都是明确选择的路线；环境密钥不会触发 Hosted fallback。 | | Patch 工作流 | Codex 风格 patch envelope、统一 diff、精确替换、hash、紧凑 diff 和路径保护。 | | 并行 scouts | 可选 scout 调用，用于架构、实现、审查、测试、git 流程、研究、符号追踪和依赖风险。 | | SCS 模式 | 可选 Student-Committee-Supervisor 质量关卡，用于复杂或高风险任务。 | | AAPS adapter | 可选 `@lazyingart/aaps` 集成，用于 `.aaps` 流程 init、validate、parse、compile、dry-run 和 run。 | | 图像生成 | GRS AI 和 Venice 默认关闭并需明确启用；仅保存密钥不会启用工具，也不会选择替代 provider。 | | 技能库 | 内置 Markdown 技能，覆盖代码、网站、Android/iOS、Python、Rust、Java、LaTeX、写作、审查、GitHub、AAPS 等。 | | Skill Mesh | 可选、严格的技能记录/共享，用于经过审查的可复用技能包。不使用时，AgInTiFlow 正常运行，不进行后台共享。 | | 多语言 UI | CLI 与文档支持英语、日语、简体/繁体中文、韩语、法语、西班牙语、阿拉伯语、越南语、德语和俄语。 | ## 模型与角色 AgInTiFlow 不把“模型”当成一个全局设置。它有多个角色： | 角色 | 默认值 | 用途 | | --- | --- | --- | | Route | `localllm/localllm-fast` | 本地规划、分流、短任务和路由决策。 | | Main | `localllm/localllm-deep` | 复杂编码、调试、写作、研究和长任务的本地执行器。 | | Spare | `localllm/localllm-deep` medium | 本地交叉检查路线；Hosted spare 必须明确选择。 | | Wrapper | `codex/gpt-5.5` medium | 可选外部编码智能体顾问。 | | Auxiliary | `grsai/nano-banana-2` (off) | 仅在明确启用后提供图像生成和非文本工具，不按密钥进行 provider failover。 | 常用选择器： ```text /models /route /model /spare /wrapper /auxiliary model /venice ``` Venice 可用于可选的 uncensored 或限制较少的创意工作。LocalLLM 保持本地默认基线；DeepSeek 等 Hosted provider 只是明确选择的升级。见 [../docs/model-selection.md](../docs/model-selection.md)、[../docs/local-first-agent-runtime.md](../docs/local-first-agent-runtime.md) 和 [../references/venice-model-reference.md](../references/venice-model-reference.md)。 ## AAPS 与大型流程 AAPS 是 pipeline-script 层；AgInTiFlow 是交互式智能体/工具后端。 ```bash aginti aaps status aginti aaps init "Project Workflow" aginti aaps validate aginti aaps compile check ``` 聊天内： ```text /aaps on /aaps validate /aaps dry-run workflows/main.aaps ``` 当任务大于一次聊天时使用 AAPS：带阶段的应用开发、论文/书籍流程、验证关卡、恢复步骤、产物生产，或自顶向下的智能体脚本。见 [../docs/aaps.md](../docs/aaps.md) 和 package [https://www.npmjs.com/package/@lazyingart/aaps](https://www.npmjs.com/package/@lazyingart/aaps)。 ## 本地 API 快速参考 Web 应用暴露本地 API，供 UI 和自动化使用。这些 endpoint 会报告状态，但不会暴露原始 API key 或 npm token： ```bash curl http://127.0.0.1:3210/api/config curl http://127.0.0.1:3210/api/capabilities curl http://127.0.0.1:3210/api/sandbox/status curl -X POST http://127.0.0.1:3210/api/sandbox/preflight \ -H 'Content-Type: application/json' \ -d '{"sandboxMode":"docker-workspace","buildImage":true}' curl http://127.0.0.1:3210/api/workspace/changes curl "http://127.0.0.1:3210/api/sessions//artifacts" curl "http://127.0.0.1:3210/api/sessions//inbox" ``` 运行无凭据 API 冒烟测试： ```bash npm run smoke:web-api ``` ## 存储、安全与恢复 AgInTiFlow 将 canonical session 集中存储，只在项目本地保留指针： | 位置 | 用途 | | --- | --- | | `~/.agintiflow/sessions//` | canonical 状态、事件、浏览器状态、产物、快照、画布文件。 | | `/.aginti-sessions/` | 项目本地会话指针和 Web UI 数据库。被 git 忽略。 | | `/.aginti/.env` | 可选项目本地 API key，权限受限。被 git 忽略。 | | `/AGINTI.md` | 可编辑的项目说明和持久本地偏好。如果没有密钥，可安全提交。 | 默认安全策略： - Docker workspace mode 是普通 CLI/Web 编码与产物生成的默认模式。 - 文件工具会阻止类似 secret 的路径、`.env`、`.git`、`node_modules` 写入、绝对路径逃逸、大文件和二进制编辑。 - Shell 命令会经过策略检查；npm publish、npm token 命令、sudo、破坏性 git 和凭据读取会被阻止。 - 文件写入会记录 hash 和紧凑 diff。 - 工具调用和结果会记录到结构化 session events。 - Web 与 CLI 使用同一个 session store，因此运行可以之后检查和恢复。 详细运行时说明见 [../docs/runtime-modes-and-autonomy.md](../docs/runtime-modes-and-autonomy.md)、[../docs/patch-tools.md](../docs/patch-tools.md) 和 [../docs/agent-runtime-pipe.md](../docs/agent-runtime-pipe.md)。 ## 配置 常用环境变量： ```bash AGENT_PROVIDER=localllm LOCALLLM_BASE_URL=http://127.0.0.1:8008/v1 LOCALLLM_API_KEY=local-dev-key AGINTI_LOCALLLM_ROUTE_MODEL=localllm-fast AGINTI_LOCALLLM_MAIN_MODEL=localllm-deep # 可选且必须明确选择的 hosted upgrade；绝不会从 LocalLLM 自动 fallback。 DEEPSEEK_API_KEY=... OPENAI_API_KEY=... OPENROUTER_API_KEY=... QWEN_API_KEY=... VENICE_API_KEY=... GRSAI_API_KEY=... AGENT_ROUTING_MODE=smart AGINTI_TASK_PROFILE=auto AGINTI_LANGUAGE=en SANDBOX_MODE=docker-workspace PACKAGE_INSTALL_POLICY=allow COMMAND_CWD=/path/to/project ``` 项目本地密钥： ```bash aginti init printf '%s' "$DEEPSEEK_API_KEY" | aginti keys set deepseek --stdin printf '%s' "$VENICE_API_KEY" | aginti keys set venice --stdin ``` 更多细节： - [../docs/model-selection.md](../docs/model-selection.md) - [../docs/auxiliary-image-generation.md](../docs/auxiliary-image-generation.md) - [../docs/cli-i18n.md](../docs/cli-i18n.md) - [../docs/skillmesh.md](../docs/skillmesh.md) ## 文档地图 | 主题 | 链接 | | --- | --- | | AAPS adapter | [../docs/aaps.md](../docs/aaps.md) | | 模型选择与角色 | [../docs/model-selection.md](../docs/model-selection.md) | | SCS 模式 | [../docs/student-committee-supervisor.md](../docs/student-committee-supervisor.md) | | 大型代码库工程 | [../docs/large-codebase-engineering.md](../docs/large-codebase-engineering.md) | | 运行模式与自主性 | [../docs/runtime-modes-and-autonomy.md](../docs/runtime-modes-and-autonomy.md) | | 技能与工具 | [../docs/skills-and-tools.md](../docs/skills-and-tools.md) | | Skill Mesh | [../docs/skillmesh.md](../docs/skillmesh.md) | | Housekeeping 日志 | [../docs/housekeeping.md](../docs/housekeeping.md) | | npm 发布 | [../docs/npm-publishing.md](../docs/npm-publishing.md) | | 产品路线图 | [../docs/productive-agent-roadmap.md](../docs/productive-agent-roadmap.md) | | 监督式能力课程 | [../docs/supervised-capability-curriculum.md](../docs/supervised-capability-curriculum.md) | | 旧版完整 README 参考 | [../references/notes/readme-full-reference-2026-05-05.md](../references/notes/readme-full-reference-2026-05-05.md) | ## 开发 从源码运行： ```bash git clone https://github.com/lazyingart/AgInTiFlow.git cd AgInTiFlow npm install npx playwright install chromium npm run check npm test ``` 从源码启动本地 Web： ```bash npm run web # open http://127.0.0.1:3210 ``` 常用冒烟检查： ```bash npm run smoke:web-api npm run smoke:coding-tools npm run smoke:aaps-adapter npm run smoke:cli-chat npm run smoke:toolchain-docker ``` 除非明确标记为真实 provider 测试，smoke scripts 使用本地 mock provider。 ## 发布说明 AgInTiFlow 以 `@lazyingart/agintiflow` 发布。推荐发布路径是 GitHub Actions Trusted Publishing 与 npm provenance。本地 token 发布只适合 bootstrap fallback，绝不能提交 `.env`、`.npmrc`、npm token、OTP 或 debug logs。 完整发布流程见 [../docs/npm-publishing.md](../docs/npm-publishing.md)。 ## 支持 如果这个项目对你有用，可以在这里支持开发： | 支持 | URL | | --- | --- | | GitHub Sponsors: LazyingArt | [https://github.com/sponsors/lazyingart](https://github.com/sponsors/lazyingart) | | GitHub Sponsors: Lachlan Chen | [https://github.com/sponsors/lachlanchen](https://github.com/sponsors/lachlanchen) | | LazyingArt | [https://lazying.art](https://lazying.art) | | Chat | [https://chat.lazying.art](https://chat.lazying.art) | | OnlyIdeas | [https://onlyideas.art](https://onlyideas.art) | AgInTiFlow 由 AgInTi Lab, LazyingArt LLC 开发。