人工智能AI AgentAgent 编排RPA后端前端企业应用【免费下载链接】astron-agentEnterprise-grade, commercial-friendly agentic workflow platform for building next-generation SuperAgents.项目地址https://gitcode.com/gh_mirrors/as/astron-agent点击查看免费下载本文围绕 docs/Makefile-readme.md 展开深入讲解 astron-agent 仓库内建的多语言 CI/CD 工具链如何用一套 Make 命令统一驱动 Go、Java、Python、TypeScript 四种技术栈的格式化、质量检查、测试、构建与安全推送并通过.localci.toml实现按模块的智能检测与局部开发。读完本文你将掌握make setup/check/test/build/push等核心命令的实际用法、底层执行链路以及如何将这套工具链复用到自己的多语言工程中。astron-agent 是一个企业级的 Agent 编排平台代码仓库横跨多种语言core/tenant是 Go 服务console/backend是 JavaMaven工程core/agent、core/memory、core/workflow、core/knowledge、core/plugin等是 Python 服务console/frontend是 TypeScript 前端。为了让开发者在如此庞杂的工程中保持统一的开发节奏仓库根目录的 Makefile 将 95 个零散命令收敛为 15 个核心命令配合 makefiles/core/detection.mk 的智能项目检测机制实现一条命令全栈生效。工具链整体架构从 95 个命令收敛到 15 个核心命令打开仓库根目录的 Makefile第一行注释就点明了设计目标Multi-language CI/CD Toolchain - Optimized Main Makefile (Only 15 Core Commands)Streamlined from 95 commands to 15 core commandsproviding intelligent project detection and automated workflows。整个工具链由多个 makefile 模块组合而成主 Makefile 通过include引入include makefiles/core/detection.mk include makefiles/core/workflows.mk include makefiles/go.mk include makefiles/typescript.mk include makefiles/java.mk include makefiles/python.mk include makefiles/git.mk include makefiles/common.mk include makefiles/comment-check.mk各模块职责划分清晰模块文件职责makefiles/core/detection.mk智能项目检测、颜色输出检测、LOCALCI_CONFIG解析、活动项目统计makefiles/core/workflows.mksmart_*系列智能工作流实现setup/check/test/build/push/clean/ci/status/infomakefiles/go.mkGo 语言工具链gofmt/goimports/gofumpt/gocyclo/staticcheck/golangci-lintmakefiles/java.mkJava 工具链Mavenspotless/checkstyle/pmd/spotbugsmakefiles/python.mkPython 工具链black/isort/flake8/mypy/pylintmakefiles/typescript.mkTypeScript 工具链prettier/eslint/tscmakefiles/git.mkGit hooks 安装/卸载、分支规范校验、安全推送makefiles/common.mk多语言工具聚合安装与检查命令makefiles/comment-check.mk注释语言合规检查强制英文注释主 Makefile 将核心命令按日常使用频率分为两层Tier 1 日常核心命令7 个——setup、check、test、build、push、clean加上默认目标helpTier 2 专业命令5 个——status、info、lint、ci、hooks。这些命令全部是smart_*智能实现的薄封装例如check: smart_check、push: smart_push见 Makefile。快速开始一次性环境初始化与日常命令一次性环境设置make setup文档推荐的初始化命令只有一条make setup它会依次完成三件事对应 makefiles/core/workflows.mk 中smart_setup的实现安装开发工具smart_install_tools遍历当前激活的语言类型ACTIVE_PROJECTS分别调用install-tools-go、install-tools-java、install-tools-python、install-tools-typescript配置 Git hooks调用hooks-install安装 pre-commit、commit-msg、pre-push 三个钩子设置分支策略调用branch-setup生成分支管理辅助脚本并输出 GitHub Flow 分支命令清单。初始化完成后终端会打印可用核心命令提示。日常开发循环make format # 格式化所有代码 make check # 质量检查check 是唯一权威入口lint 为其别名 make test # 运行测试 make build # 构建项目 make push # 安全推送推送前自动执行预检查 make clean # 清理构建产物当前仓库顶层 Makefile 实际声明的核心命令以help、setup、check、test、build、push、clean、status、info、lint、ci、hooks为主其中format与fix等便捷命令在文档中作为统一入口描述格式化的底层实现在各语言模块中可查——例如 Java 侧 makefiles/java.mk 提供了fmt-java执行mvn spotless:apply。若你所在的分支未提供format目标可直接使用对应语言级命令如make fmt-java或查阅make help输出的完整清单。查看项目状态与工具版本make status # 显示项目信息与激活的工程 make info # 显示各语言工具版本与安装状态smart_status会调用show_project_status输出每个已激活语言项目的目录是否存在打勾/打叉并打印ACTIVE_PROJECTS、PROJECT_COUNT、IS_MULTI_PROJECT等检测结果smart_info在此基础上进一步对每个语言执行check-tools-*报告 Go/Python/Java/TypeScript 工具链的可用性与版本号见 makefiles/core/workflows.mk。本地开发配置用.localci.toml精准控制激活模块对于只改动某一个模块的日常开发全量执行四个语言的所有检查既慢又没有必要。工具链支持在仓库根目录创建.localci.toml覆盖默认配置# 复制默认配置 cp makefiles/localci.toml .localci.toml # 编辑只保留你在开发的模块 enabled true其余设为 false仓库自带的默认配置 makefiles/localci.toml 完整列出了本仓库的全部模块结构如下[meta] version 1 [[java.apps]] name console-backend dir console/backend enabled true [[typescript.apps]] name console-frontend dir console/frontend enabled true [[go.apps]] name core-tenant dir core/tenant enabled true [[python.apps]] name core-memory dir core/memory/database enabled true [[python.apps]] name core-rpa dir core/plugin/rpa enabled true [[python.apps]] name core-link dir core/plugin/link enabled true [[python.apps]] name core-aitools dir core/plugin/aitools enabled true [[python.apps]] name core-agent dir core/agent enabled true [[python.apps]] name core-knowledge dir core/knowledge enabled true [[python.apps]] name core-workflow dir core/workflow enabled true [[python.apps]] name core-common dir core/common enabled true配置解析的底层实现这份 TOML 由 makefiles/parse_localci.sh 解析它支持三种查询模式makefiles/parse_localci.sh enabled lang config输出该语言下所有enabled true的应用格式为name|dirmakefiles/parse_localci.sh langs config输出至少包含一个启用应用的编程语言列表空格分隔makefiles/parse_localci.sh all config输出全部lang|name|dir|enabled明细。解析规则上enabled字段缺省时按true处理脚本会用awk剥离注释、按[[lang.apps]]节切分节名取点号前部分作为语言标识。各语言模块如 makefiles/go.mk再通过parse_localci.sh enabled go … | cut -d| -f2拿到目录列表动态计算出GO_DIRS、PYTHON_DIRS、JAVA_DIRS、TS_DIRS。智能检测的两级回退makefiles/core/detection.mk 定义了检测优先级若仓库根目录存在.localci.toml优先读取它否则使用makefiles/localci.toml若两者都不存在则回退到探测demo-apps下的示例工程结构go.modcmd/、pom.xmluser-web/、main.pyrequirements.txt、package.jsontsconfig.json这是模板工程的默认场景。同时detect_current_context会根据当前所在目录判断当前上下文go/java/python/typescript/all为单工程环境提供智能定位。本地配置的收益更快的执行ACTIVE_PROJECTS只包含启用模块对应的语言smart_check/smart_test/smart_build的for project in $(ACTIVE_PROJECTS)循环只会处理被启用的语言聚焦的开发只检查你正在修改的模块避免无关模块的报错干扰灵活的切换改动enabled值即可在模块间切换无需修改任何源码。核心命令详解从入口到底层执行链路make check别名make lint质量检查的唯一权威入口check直接调用smart_checkmakefiles/core/workflows.mk执行逻辑为若ACTIVE_PROJECTS为空则报错退出遍历激活语言分别调用check-go、check-java、check-python、check-typescript调用check-comments-*进行注释语言合规检查强制英文注释见 makefiles/comment-check.mk。各语言检查工具链如下与 docs/Makefile-readme.md 一致并有源码佐证语言格式化质量检查Gogofmtgoimportsgofumptgolinesgocyclo复杂度阈值 10staticcheck2025.1.1golangci-lintv2.5.0见 makefiles/go.mkJavaMavenspotless:applyGoogle Java Formatcheckstyle:checkpmd:checkspotbugs:check见 makefiles/java.mkPythonblack24.4.2isort5.13.2--profile blackflake87.0.0行宽 88、--max-complexity 10mypy1.18.2严格类型pylint3.1.0--fail-under8.0见 makefiles/python.mkTypeScriptprettiereslint--quiet仅报错误tsc --noEmit类型检查见 makefiles/typescript.mk值得注意的设计哲学在make help输出与 hooks 注释中反复强调CI 只检测、不自动修复。格式化类检查如goimports -l、black --check只报告不合规文件并提示修复命令不会擅自改写代码——修复动作由开发者手动执行以保证代码归属与评审记录的清晰。make test按语言分别执行测试smart_testmakefiles/core/workflows.mk同样按激活语言分发Gogo test ./... -v并通过GOCACHE$(pwd)/.gocache把构建缓存隔离在项目目录内makefiles/go.mkJavamvn testmakefiles/java.mkPython若存在tests/目录则执行pytest tests/ -v若项目使用uv.lock会先uv sync再用uv run python -m pytestmakefiles/python.mk——仓库内core/agent、core/knowledge、core/workflow等目录均带uv.lock因此统一走 uv 路径TypeScript若package.json中定义了test:unit脚本则执行npm run test:unitmakefiles/typescript.mk。make build构建与依赖安装smart_buildmakefiles/core/workflows.mk的分发逻辑为Gogo build -o bin/server ./cmd/server产物输出到各模块的bin/目录Javamvn clean package -DskipTestsPython不执行编译解释型语言而是安装依赖——优先uv sync检测到uv.lock时否则回退到pip install -r requirements.txtTypeScriptnpm ci --prefer-offline后执行npm run buildVite。make push带预检查的安全推送push是smart_pushmakefiles/core/workflows.mk的封装推送链路包含三道关卡check-branch校验当前分支名是否符合规范正则^(main|develop|feature/.*|bugfix/.*|hotfix/.*|design/.*|doc/.*|refactor/.*|test/.*)$见 makefiles/git.mksmart_check推送前自动执行完整质量检查safe-push再次确认分支合规后执行git push origin branch不合规则拒绝推送并给出改名建议如feature/branch。make clean清理构建产物smart_clean按语言清理Go 清bin/、.gocache/、coverage/Java 执行mvn cleanPython 删除__pycache__、.pytest_cache、.mypy_cache、.coverage等TypeScript 删除dist/、build/、node_modules/.cache/等。make ci一键完整流水线smart_cimakefiles/core/workflows.mk串行执行smart_check→smart_test→smart_build与 CI 系统的标准阶段一一对应另有smart_check_with_comments、smart_ci_with_comments两个变体见 makefiles/comment-check.mk在检查阶段额外叠加注释语言校验。Git 规范体系分支命名、提交信息与安全推送工具链把 Git 工程规范也纳入了统一管理全部实现集中在 makefiles/git.mk。分支命名规范支持的分支前缀包括main、develop、feature/*、bugfix/*、hotfix/*、design/*、doc/*、refactor/*、test/*。pre-push 钩子与check-branch使用同一套正则进行校验makefiles/git.mk。feature/user-auth # 功能分支 bugfix/fix-login # 缺陷修复 hotfix/security-patch # 紧急修复创建分支无需手敲git checkout -b工具链提供了快捷命令make new-branch typefeature nameuser-auth # 通用形式 make new-feature nameuser-auth # 快捷形式 make new-bugfix nameauth-error make new-hotfix namesecurity-patch make new-design namemobile-layout make list-remote-branches # 列出合规的远端分支 make branch-help # 查看分支管理帮助这些命令调用branch-setup生成到.git/git-branch-helpers.sh的辅助脚本重复创建同名分支会被拒绝。提交信息规范Conventional Commitscommit-msg 钩子强制校验提交信息格式makefiles/git.mk匹配正则^(build|chore|ci|docs|feat|fix|perf|refactor|revert|style|test)(\(.\))?: .{1,50}即type(scope): description类型限定为build|chore|ci|docs|feat|fix|perf|refactor|revert|style|test描述不超过 50 字符feat: add user authentication fix(auth): resolve login validation issue docs: update API documentationGit hooks 的安装与卸载make hooks-install # 安装完整钩子pre-commit 检查 commit-msg pre-push make hooks-install-basic # 安装轻量钩子仅格式化类检查文档描述 make hooks-uninstall # 卸载全部钩子 make hooks-commit-msg # 仅安装提交信息校验钩子 make hooks-pre-push # 仅安装推送分支校验钩子 make hooks-uninstall-pre # 卸载 pre-commit make hooks-uninstall-msg # 卸载 commit-msg从源码看hooks-install由hooks-check-allpre-commit只做质量检查、不自动格式化、hooks-commit-msg、hooks-pre-push三个目标聚合而成makefiles/git.mk。每个钩子脚本都会写入.git/hooks/并赋予可执行权限。若钩子异常可先卸载再重装make hooks-uninstall make hooks-install智能检测与调试_debug与make status当项目检测结果不符合预期时可用隐藏调试命令make _debug定义于 Makefile查看关键变量ACTIVE_PROJECTS当前激活的语言集合CURRENT_CONTEXT当前目录推断出的上下文PROJECT_COUNT与IS_MULTI_PROJECT判断是否为多工程环境。make statussmart_status则在.localci.toml存在时进一步展示每个启用应用的name - dir映射以及全部应用含禁用的lang: name [enabled] - dir明细见 makefiles/core/workflows.mk。直接运行各语言服务工具链负责开发流程服务运行仍可直接操作路径与仓库实际结构一致# Go 服务 cd core/tenant go run main.go # Java 服务console 后端聚合工程含 commons/hub/toolkit 子模块 cd console/backend mvn spring-boot:run # Python 服务各核心模块均自带 uv.lock建议使用 uv cd core/memory/database python main.py cd core/agent python main.py # TypeScript 前端 cd console/frontend npm run dev说明文档示例中的go run cmd/main.go对应 Go 服务源码组织本仓库core/tenant的入口实际为根目录main.go两者都属于进入模块目录后启动服务的同一模式实际以你所拉取分支的目录结构为准。Python 各模块core/agent、core/knowledge、core/workflow等均配有 pyproject.toml 与 uv.lock可用uv sync安装依赖后启动。故障排查手册工具安装问题make info # 检查工具状态与版本 make install-tools # 重新安装全部语言工具聚合命令见 makefiles/common.mk各语言的工具安装目标独立可用install-tools-go、install-tools-java、install-tools-python、install-tools-typescript。其中 Go 工具通过go install安装goimports/gocyclo/staticcheck并下载golangci-lintv2.5.0Python 工具通过 pip 固定版本安装black24.4.2、isort5.13.2、flake87.0.0、mypy1.18.2、pylint3.1.0。项目检测问题make status # 查看项目检测结果 make _debug # 打印 ACTIVE_PROJECTS / CURRENT_CONTEXT / PROJECT_COUNT / IS_MULTI_PROJECT常见原因.localci.toml中dir路径与仓库实际目录不一致或未创建.localci.toml导致回退到demo-apps探测。钩子问题make hooks-uninstall make hooks-install # 重新安装本地配置问题rm .localci.toml # 删除本地配置回退到默认makefiles/localci.toml cp makefiles/localci.toml .localci.toml # 重置本地配置源码地图把工具链迁移到自己的项目如果想把这套工具链复用到其他多语言工程核心资产都在makefiles/目录复制makefiles/整个目录与根 Makefile按自己工程的模块改写 makefiles/localci.toml 中的[[lang.apps]]节name、dir、enabled各语言工具的版本与参数集中在对应*.mk文件顶部按需调整如 Python 的FLAKE8/MYPY/PYLINT变量、Java 的MAVEN_OPTS若仓库是纯模板工程无.localci.toml检测机制会回退到探测demo-apps目录结构可参考 makefiles/core/detection.mk 修改探测路径。配合 makefiles/check-comments.sh注释语言检查脚本与 makefiles/comment-check.mk还能在统一入口内强制团队注释语言规范。这套工具链的价值在于把跨语言的工程规范沉淀为可复制的 Make 模块让任何开发者在一分钟内进入格式化→检查→测试→构建→安全推送的标准开发循环。赞分享人工智能AI AgentAgent 编排RPA后端前端企业应用【免费下载链接】astron-agentEnterprise-grade, commercial-friendly agentic workflow platform for building next-generation SuperAgents.项目地址https://gitcode.com/gh_mirrors/as/astron-agent点击查看免费下载相关推荐BAML 开发环境搭建指南基于 mise 与 pnpm/Turbo 的多语言开发工作流实战BAML 开发环境搭建指南基于 mise 与 pnpm/Turbo 的多语言开发工作流实战 BAMLBoundary ML 的 agent 编程语言是一个编程语言AI Agent编译器CLI人工智能e2core安全管理手册如何防范恶意插件攻击e2core安全管理手册如何防范恶意插件攻击 e2core是一个强大的沙箱化第三方插件服务器它使用WebAssembly技术为应用程序提供安全的插件执行环境大数据批处理流处理数据工程Phoenix 仓库 Agent 开发规范解析Makefile 统一工作流、uv/pnpm 双工具链与 PEP 440 依赖版本策略Phoenix 仓库 Agent 开发规范解析Makefile 统一工作流、uv/pnpm 双工具链与 PEP 440 依赖版本策略 导读 CLAUDE.md可观测性AI 评测LLMOpsAI 应用人工智能上一篇WorkshopDL 免费模组下载完整指南没有 Steam 客户端也能一键拿到创意工坊的模组下一篇老旧Mac升级macOS免费方案OpenCore Legacy Patcher让2012年的老本子再战五年创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
astron-agent 多语言 CI/CD 工具链：基于 Makefile 的统一开发工作流实战指南
人工智能AI AgentAgent 编排RPA后端前端企业应用【免费下载链接】astron-agentEnterprise-grade, commercial-friendly agentic workflow platform for building next-generation SuperAgents.项目地址https://gitcode.com/gh_mirrors/as/astron-agent点击查看免费下载本文围绕 docs/Makefile-readme.md 展开深入讲解 astron-agent 仓库内建的多语言 CI/CD 工具链如何用一套 Make 命令统一驱动 Go、Java、Python、TypeScript 四种技术栈的格式化、质量检查、测试、构建与安全推送并通过.localci.toml实现按模块的智能检测与局部开发。读完本文你将掌握make setup/check/test/build/push等核心命令的实际用法、底层执行链路以及如何将这套工具链复用到自己的多语言工程中。astron-agent 是一个企业级的 Agent 编排平台代码仓库横跨多种语言core/tenant是 Go 服务console/backend是 JavaMaven工程core/agent、core/memory、core/workflow、core/knowledge、core/plugin等是 Python 服务console/frontend是 TypeScript 前端。为了让开发者在如此庞杂的工程中保持统一的开发节奏仓库根目录的 Makefile 将 95 个零散命令收敛为 15 个核心命令配合 makefiles/core/detection.mk 的智能项目检测机制实现一条命令全栈生效。工具链整体架构从 95 个命令收敛到 15 个核心命令打开仓库根目录的 Makefile第一行注释就点明了设计目标Multi-language CI/CD Toolchain - Optimized Main Makefile (Only 15 Core Commands)Streamlined from 95 commands to 15 core commandsproviding intelligent project detection and automated workflows。整个工具链由多个 makefile 模块组合而成主 Makefile 通过include引入include makefiles/core/detection.mk include makefiles/core/workflows.mk include makefiles/go.mk include makefiles/typescript.mk include makefiles/java.mk include makefiles/python.mk include makefiles/git.mk include makefiles/common.mk include makefiles/comment-check.mk各模块职责划分清晰模块文件职责makefiles/core/detection.mk智能项目检测、颜色输出检测、LOCALCI_CONFIG解析、活动项目统计makefiles/core/workflows.mksmart_*系列智能工作流实现setup/check/test/build/push/clean/ci/status/infomakefiles/go.mkGo 语言工具链gofmt/goimports/gofumpt/gocyclo/staticcheck/golangci-lintmakefiles/java.mkJava 工具链Mavenspotless/checkstyle/pmd/spotbugsmakefiles/python.mkPython 工具链black/isort/flake8/mypy/pylintmakefiles/typescript.mkTypeScript 工具链prettier/eslint/tscmakefiles/git.mkGit hooks 安装/卸载、分支规范校验、安全推送makefiles/common.mk多语言工具聚合安装与检查命令makefiles/comment-check.mk注释语言合规检查强制英文注释主 Makefile 将核心命令按日常使用频率分为两层Tier 1 日常核心命令7 个——setup、check、test、build、push、clean加上默认目标helpTier 2 专业命令5 个——status、info、lint、ci、hooks。这些命令全部是smart_*智能实现的薄封装例如check: smart_check、push: smart_push见 Makefile。快速开始一次性环境初始化与日常命令一次性环境设置make setup文档推荐的初始化命令只有一条make setup它会依次完成三件事对应 makefiles/core/workflows.mk 中smart_setup的实现安装开发工具smart_install_tools遍历当前激活的语言类型ACTIVE_PROJECTS分别调用install-tools-go、install-tools-java、install-tools-python、install-tools-typescript配置 Git hooks调用hooks-install安装 pre-commit、commit-msg、pre-push 三个钩子设置分支策略调用branch-setup生成分支管理辅助脚本并输出 GitHub Flow 分支命令清单。初始化完成后终端会打印可用核心命令提示。日常开发循环make format # 格式化所有代码 make check # 质量检查check 是唯一权威入口lint 为其别名 make test # 运行测试 make build # 构建项目 make push # 安全推送推送前自动执行预检查 make clean # 清理构建产物当前仓库顶层 Makefile 实际声明的核心命令以help、setup、check、test、build、push、clean、status、info、lint、ci、hooks为主其中format与fix等便捷命令在文档中作为统一入口描述格式化的底层实现在各语言模块中可查——例如 Java 侧 makefiles/java.mk 提供了fmt-java执行mvn spotless:apply。若你所在的分支未提供format目标可直接使用对应语言级命令如make fmt-java或查阅make help输出的完整清单。查看项目状态与工具版本make status # 显示项目信息与激活的工程 make info # 显示各语言工具版本与安装状态smart_status会调用show_project_status输出每个已激活语言项目的目录是否存在打勾/打叉并打印ACTIVE_PROJECTS、PROJECT_COUNT、IS_MULTI_PROJECT等检测结果smart_info在此基础上进一步对每个语言执行check-tools-*报告 Go/Python/Java/TypeScript 工具链的可用性与版本号见 makefiles/core/workflows.mk。本地开发配置用.localci.toml精准控制激活模块对于只改动某一个模块的日常开发全量执行四个语言的所有检查既慢又没有必要。工具链支持在仓库根目录创建.localci.toml覆盖默认配置# 复制默认配置 cp makefiles/localci.toml .localci.toml # 编辑只保留你在开发的模块 enabled true其余设为 false仓库自带的默认配置 makefiles/localci.toml 完整列出了本仓库的全部模块结构如下[meta] version 1 [[java.apps]] name console-backend dir console/backend enabled true [[typescript.apps]] name console-frontend dir console/frontend enabled true [[go.apps]] name core-tenant dir core/tenant enabled true [[python.apps]] name core-memory dir core/memory/database enabled true [[python.apps]] name core-rpa dir core/plugin/rpa enabled true [[python.apps]] name core-link dir core/plugin/link enabled true [[python.apps]] name core-aitools dir core/plugin/aitools enabled true [[python.apps]] name core-agent dir core/agent enabled true [[python.apps]] name core-knowledge dir core/knowledge enabled true [[python.apps]] name core-workflow dir core/workflow enabled true [[python.apps]] name core-common dir core/common enabled true配置解析的底层实现这份 TOML 由 makefiles/parse_localci.sh 解析它支持三种查询模式makefiles/parse_localci.sh enabled lang config输出该语言下所有enabled true的应用格式为name|dirmakefiles/parse_localci.sh langs config输出至少包含一个启用应用的编程语言列表空格分隔makefiles/parse_localci.sh all config输出全部lang|name|dir|enabled明细。解析规则上enabled字段缺省时按true处理脚本会用awk剥离注释、按[[lang.apps]]节切分节名取点号前部分作为语言标识。各语言模块如 makefiles/go.mk再通过parse_localci.sh enabled go … | cut -d| -f2拿到目录列表动态计算出GO_DIRS、PYTHON_DIRS、JAVA_DIRS、TS_DIRS。智能检测的两级回退makefiles/core/detection.mk 定义了检测优先级若仓库根目录存在.localci.toml优先读取它否则使用makefiles/localci.toml若两者都不存在则回退到探测demo-apps下的示例工程结构go.modcmd/、pom.xmluser-web/、main.pyrequirements.txt、package.jsontsconfig.json这是模板工程的默认场景。同时detect_current_context会根据当前所在目录判断当前上下文go/java/python/typescript/all为单工程环境提供智能定位。本地配置的收益更快的执行ACTIVE_PROJECTS只包含启用模块对应的语言smart_check/smart_test/smart_build的for project in $(ACTIVE_PROJECTS)循环只会处理被启用的语言聚焦的开发只检查你正在修改的模块避免无关模块的报错干扰灵活的切换改动enabled值即可在模块间切换无需修改任何源码。核心命令详解从入口到底层执行链路make check别名make lint质量检查的唯一权威入口check直接调用smart_checkmakefiles/core/workflows.mk执行逻辑为若ACTIVE_PROJECTS为空则报错退出遍历激活语言分别调用check-go、check-java、check-python、check-typescript调用check-comments-*进行注释语言合规检查强制英文注释见 makefiles/comment-check.mk。各语言检查工具链如下与 docs/Makefile-readme.md 一致并有源码佐证语言格式化质量检查Gogofmtgoimportsgofumptgolinesgocyclo复杂度阈值 10staticcheck2025.1.1golangci-lintv2.5.0见 makefiles/go.mkJavaMavenspotless:applyGoogle Java Formatcheckstyle:checkpmd:checkspotbugs:check见 makefiles/java.mkPythonblack24.4.2isort5.13.2--profile blackflake87.0.0行宽 88、--max-complexity 10mypy1.18.2严格类型pylint3.1.0--fail-under8.0见 makefiles/python.mkTypeScriptprettiereslint--quiet仅报错误tsc --noEmit类型检查见 makefiles/typescript.mk值得注意的设计哲学在make help输出与 hooks 注释中反复强调CI 只检测、不自动修复。格式化类检查如goimports -l、black --check只报告不合规文件并提示修复命令不会擅自改写代码——修复动作由开发者手动执行以保证代码归属与评审记录的清晰。make test按语言分别执行测试smart_testmakefiles/core/workflows.mk同样按激活语言分发Gogo test ./... -v并通过GOCACHE$(pwd)/.gocache把构建缓存隔离在项目目录内makefiles/go.mkJavamvn testmakefiles/java.mkPython若存在tests/目录则执行pytest tests/ -v若项目使用uv.lock会先uv sync再用uv run python -m pytestmakefiles/python.mk——仓库内core/agent、core/knowledge、core/workflow等目录均带uv.lock因此统一走 uv 路径TypeScript若package.json中定义了test:unit脚本则执行npm run test:unitmakefiles/typescript.mk。make build构建与依赖安装smart_buildmakefiles/core/workflows.mk的分发逻辑为Gogo build -o bin/server ./cmd/server产物输出到各模块的bin/目录Javamvn clean package -DskipTestsPython不执行编译解释型语言而是安装依赖——优先uv sync检测到uv.lock时否则回退到pip install -r requirements.txtTypeScriptnpm ci --prefer-offline后执行npm run buildVite。make push带预检查的安全推送push是smart_pushmakefiles/core/workflows.mk的封装推送链路包含三道关卡check-branch校验当前分支名是否符合规范正则^(main|develop|feature/.*|bugfix/.*|hotfix/.*|design/.*|doc/.*|refactor/.*|test/.*)$见 makefiles/git.mksmart_check推送前自动执行完整质量检查safe-push再次确认分支合规后执行git push origin branch不合规则拒绝推送并给出改名建议如feature/branch。make clean清理构建产物smart_clean按语言清理Go 清bin/、.gocache/、coverage/Java 执行mvn cleanPython 删除__pycache__、.pytest_cache、.mypy_cache、.coverage等TypeScript 删除dist/、build/、node_modules/.cache/等。make ci一键完整流水线smart_cimakefiles/core/workflows.mk串行执行smart_check→smart_test→smart_build与 CI 系统的标准阶段一一对应另有smart_check_with_comments、smart_ci_with_comments两个变体见 makefiles/comment-check.mk在检查阶段额外叠加注释语言校验。Git 规范体系分支命名、提交信息与安全推送工具链把 Git 工程规范也纳入了统一管理全部实现集中在 makefiles/git.mk。分支命名规范支持的分支前缀包括main、develop、feature/*、bugfix/*、hotfix/*、design/*、doc/*、refactor/*、test/*。pre-push 钩子与check-branch使用同一套正则进行校验makefiles/git.mk。feature/user-auth # 功能分支 bugfix/fix-login # 缺陷修复 hotfix/security-patch # 紧急修复创建分支无需手敲git checkout -b工具链提供了快捷命令make new-branch typefeature nameuser-auth # 通用形式 make new-feature nameuser-auth # 快捷形式 make new-bugfix nameauth-error make new-hotfix namesecurity-patch make new-design namemobile-layout make list-remote-branches # 列出合规的远端分支 make branch-help # 查看分支管理帮助这些命令调用branch-setup生成到.git/git-branch-helpers.sh的辅助脚本重复创建同名分支会被拒绝。提交信息规范Conventional Commitscommit-msg 钩子强制校验提交信息格式makefiles/git.mk匹配正则^(build|chore|ci|docs|feat|fix|perf|refactor|revert|style|test)(\(.\))?: .{1,50}即type(scope): description类型限定为build|chore|ci|docs|feat|fix|perf|refactor|revert|style|test描述不超过 50 字符feat: add user authentication fix(auth): resolve login validation issue docs: update API documentationGit hooks 的安装与卸载make hooks-install # 安装完整钩子pre-commit 检查 commit-msg pre-push make hooks-install-basic # 安装轻量钩子仅格式化类检查文档描述 make hooks-uninstall # 卸载全部钩子 make hooks-commit-msg # 仅安装提交信息校验钩子 make hooks-pre-push # 仅安装推送分支校验钩子 make hooks-uninstall-pre # 卸载 pre-commit make hooks-uninstall-msg # 卸载 commit-msg从源码看hooks-install由hooks-check-allpre-commit只做质量检查、不自动格式化、hooks-commit-msg、hooks-pre-push三个目标聚合而成makefiles/git.mk。每个钩子脚本都会写入.git/hooks/并赋予可执行权限。若钩子异常可先卸载再重装make hooks-uninstall make hooks-install智能检测与调试_debug与make status当项目检测结果不符合预期时可用隐藏调试命令make _debug定义于 Makefile查看关键变量ACTIVE_PROJECTS当前激活的语言集合CURRENT_CONTEXT当前目录推断出的上下文PROJECT_COUNT与IS_MULTI_PROJECT判断是否为多工程环境。make statussmart_status则在.localci.toml存在时进一步展示每个启用应用的name - dir映射以及全部应用含禁用的lang: name [enabled] - dir明细见 makefiles/core/workflows.mk。直接运行各语言服务工具链负责开发流程服务运行仍可直接操作路径与仓库实际结构一致# Go 服务 cd core/tenant go run main.go # Java 服务console 后端聚合工程含 commons/hub/toolkit 子模块 cd console/backend mvn spring-boot:run # Python 服务各核心模块均自带 uv.lock建议使用 uv cd core/memory/database python main.py cd core/agent python main.py # TypeScript 前端 cd console/frontend npm run dev说明文档示例中的go run cmd/main.go对应 Go 服务源码组织本仓库core/tenant的入口实际为根目录main.go两者都属于进入模块目录后启动服务的同一模式实际以你所拉取分支的目录结构为准。Python 各模块core/agent、core/knowledge、core/workflow等均配有 pyproject.toml 与 uv.lock可用uv sync安装依赖后启动。故障排查手册工具安装问题make info # 检查工具状态与版本 make install-tools # 重新安装全部语言工具聚合命令见 makefiles/common.mk各语言的工具安装目标独立可用install-tools-go、install-tools-java、install-tools-python、install-tools-typescript。其中 Go 工具通过go install安装goimports/gocyclo/staticcheck并下载golangci-lintv2.5.0Python 工具通过 pip 固定版本安装black24.4.2、isort5.13.2、flake87.0.0、mypy1.18.2、pylint3.1.0。项目检测问题make status # 查看项目检测结果 make _debug # 打印 ACTIVE_PROJECTS / CURRENT_CONTEXT / PROJECT_COUNT / IS_MULTI_PROJECT常见原因.localci.toml中dir路径与仓库实际目录不一致或未创建.localci.toml导致回退到demo-apps探测。钩子问题make hooks-uninstall make hooks-install # 重新安装本地配置问题rm .localci.toml # 删除本地配置回退到默认makefiles/localci.toml cp makefiles/localci.toml .localci.toml # 重置本地配置源码地图把工具链迁移到自己的项目如果想把这套工具链复用到其他多语言工程核心资产都在makefiles/目录复制makefiles/整个目录与根 Makefile按自己工程的模块改写 makefiles/localci.toml 中的[[lang.apps]]节name、dir、enabled各语言工具的版本与参数集中在对应*.mk文件顶部按需调整如 Python 的FLAKE8/MYPY/PYLINT变量、Java 的MAVEN_OPTS若仓库是纯模板工程无.localci.toml检测机制会回退到探测demo-apps目录结构可参考 makefiles/core/detection.mk 修改探测路径。配合 makefiles/check-comments.sh注释语言检查脚本与 makefiles/comment-check.mk还能在统一入口内强制团队注释语言规范。这套工具链的价值在于把跨语言的工程规范沉淀为可复制的 Make 模块让任何开发者在一分钟内进入格式化→检查→测试→构建→安全推送的标准开发循环。赞分享人工智能AI AgentAgent 编排RPA后端前端企业应用【免费下载链接】astron-agentEnterprise-grade, commercial-friendly agentic workflow platform for building next-generation SuperAgents.项目地址https://gitcode.com/gh_mirrors/as/astron-agent点击查看免费下载相关推荐BAML 开发环境搭建指南基于 mise 与 pnpm/Turbo 的多语言开发工作流实战BAML 开发环境搭建指南基于 mise 与 pnpm/Turbo 的多语言开发工作流实战 BAMLBoundary ML 的 agent 编程语言是一个编程语言AI Agent编译器CLI人工智能e2core安全管理手册如何防范恶意插件攻击e2core安全管理手册如何防范恶意插件攻击 e2core是一个强大的沙箱化第三方插件服务器它使用WebAssembly技术为应用程序提供安全的插件执行环境大数据批处理流处理数据工程Phoenix 仓库 Agent 开发规范解析Makefile 统一工作流、uv/pnpm 双工具链与 PEP 440 依赖版本策略Phoenix 仓库 Agent 开发规范解析Makefile 统一工作流、uv/pnpm 双工具链与 PEP 440 依赖版本策略 导读 CLAUDE.md可观测性AI 评测LLMOpsAI 应用人工智能上一篇WorkshopDL 免费模组下载完整指南没有 Steam 客户端也能一键拿到创意工坊的模组下一篇老旧Mac升级macOS免费方案OpenCore Legacy Patcher让2012年的老本子再战五年创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考