AgentLaunch

AgentLaunch 是一个用于分析 AI agent 项目并生成发布资料的 TypeScript 工具。它会扫描本地项目，提取项目证据、agent 配置、密钥名称和发布风险，然后生成结构化的 Agent Bundle 与一组 launch pack 文档。

功能

• 扫描本地 agent 项目的关键文件、示例、说明文档和配置文件。
• 识别 Codex、Claude、Qwen、MCP 等常见 agent 配置。
• 只记录密钥名称，不保存密钥值。
• 生成 agentlaunch/agent-bundle.json，用于保存项目能力、输入输出、风险和发布建议。
• 生成 launch/ 目录，包含产品简介、目标用户、定价、README 改进建议、发布清单等文档。

环境要求

• Node.js 22 或更高版本
• npm

安装

npm install

使用

开发模式下可以直接运行源码：

npm run agentlaunch -- ./path/to/agent-project

处理 endpoint 输入：

npm run agentlaunch -- --endpoint https://example.com/a2a/jsonrpc

当前 CLI 对本地路径输入会写入输出文件；--endpoint 目前只返回处理状态。

构建后也可以运行编译产物：

npm run build
node dist/cli.js ./path/to/agent-project

输出文件

对本地路径运行后，AgentLaunch 会在输入目录下生成：

agentlaunch/
  agent-bundle.json
launch/
  product-brief.md
  target-users.md
  positioning.md
  demo-examples.md
  api-docs.md
  pricing.md
  landing-page-copy.md
  readme-improvements.md
  launch-posts.md
  publish-checklist.md
  risk-review.md

agent-bundle.json 是结构化结果，包含项目名称、来源、能力摘要、输入输出、捕获到的 agent 配置、密钥名称、发布建议和风险列表。

launch/ 下的 Markdown 文件用于辅助发布、定价、落地页文案、风险审查和 README 改进。

扫描范围

本地项目扫描会关注：

• 根目录下的 README.md、package.json、pyproject.toml、requirements.txt、Dockerfile、LICENSE、.env.example
• src/、app/、examples/、docs/ 下的文件
• AGENTS.md、CLAUDE.md、mcp.json、.mcp.json
• .codex/、.claude/、.qwen/ 下的 Markdown、JSON、TOML、YAML 配置

扫描会跳过 .git、node_modules、dist、build、虚拟环境、缓存目录和常见构建目录。

密钥处理

AgentLaunch 会扫描类似 API_KEY、TOKEN、SECRET、PASSWORD、PRIVATE_KEY、ACCESS_KEY 的环境变量名称。它只保留密钥名称和来源文件，不会把密钥值写入 bundle 或 launch pack。

.env.example 和 agent 配置中的密钥赋值会被脱敏后再参与分析。

编程式使用

import { runAgentLaunch } from "agentlaunch";

const result = await runAgentLaunch({
  input: "./path/to/agent-project",
});

console.log(result.bundlePath);
console.log(result.launchDir);

默认使用内置的 fake provider，便于本地开发和测试。需要接入真实模型时，可以实现 LLMProvider，并通过 runAgentLaunch({ input, provider }) 传入。

开发命令

npm run build
npm test

项目使用 TypeScript、Vitest 和 ESM。源码位于 src/，编译输出位于 dist/。

项目结构

src/
  agent/       agent loop 相关逻辑
  bundle/      Agent Bundle 构建与校验
  launch/      launch pack 生成
  llm/         LLM provider 接口与实现
  scanner/     本地项目、配置和密钥扫描
  types/       共享类型和 schema
  writers/     输出文件写入
  cli.ts       命令行入口
  index.ts     主要公共 API