Axis Iliad - Codebase Intelligence For Agentic Commerce

Axis' Iliad

Axis' Iliad — 这部现代史诗，将原始代码库塑造成规范化、可供 Agent 使用的产物。Axis' Iliad 为下一代自然语言工作区开发奠定权威基础。

规范名称： Axis' Iliad。请在文档、注册表和集成中统一使用此名称。

---

AXIS 生态系统

Iliad 是 Trust Fabric 技术栈中的 x402 展示项目。完整注册表：packages/generator-core/src/estate-registry.ts，通过 GET /.well-known/axis-estate.json 实时提供（取代已于 2026-08-22 停用的 ecosystem.registry.yaml——参见 docs/ESTATE_FEDERATION_STRATEGY.md）。

项目	角色	x402
Axis' Iliad（本仓库）	Agent 产物 + MCP 网关	已接入 — @axis/mpp
PAID	多通道支付 + 结算	结算层（计划采用 Go x402）
AXIS Foundry	3D 流水线 + MCP	部分接入
Trust Fabric	合规审计、修复 + Trust Passport	计划中

x402 合约：docs/x402/CONTRACT.md

---

30 秒内试用 — 无需注册

每个程序都提供免费的产物，无需 API 密钥——总计 152 个产物中的 47 个。其中 3 个程序完全免费：

# 1. Get an API key (free tier, instant)
curl -X POST https://api.iliad.trustfabric.ai/v1/accounts \
  -H 'Content-Type: application/json' \
  -d '{"email":"[email protected]","name":"My Agent","tier":"free"}'

# 2. Analyze any public GitHub repo
curl -X POST https://api.iliad.trustfabric.ai/v1/github/analyze \
  -H 'Content-Type: application/json' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -d '{"url":"https://github.com/owner/repo","programs":["search","skills","debug"]}'

# 3. Download the generated artifacts as a ZIP
curl https://api.iliad.trustfabric.ai/v1/projects/PROJECT_ID/export \
  -H 'Authorization: Bearer YOUR_API_KEY' -o artifacts.zip

免费层包括： 覆盖全部 21 个程序的 47 个产物——Search（上下文映射）、Skills（AGENTS.md、CLAUDE.md、.cursorrules）和 Debug（操作手册、事件模板）全部免费，此外还包括其他每个程序的主要产物（设计令牌、Dockerfile、MCP 配置、品牌指南等）。付费后可解锁每个程序的其余产物。

---

你将获得什么

一次扫描 → 数秒内即可获得 21 个程序生成的 152 项成果：

你需要什么	程序	主要输出
帮助新的 AI Agent 熟悉项目	Search (免费)	context-map.json、repo-profile.yaml、architecture-summary.md
为任何大模型提供代码库上下文	Skills (免费)	AGENTS.md、CLAUDE.md、.cursorrules、workflow-pack.md
调试生产环境事故	Debug (免费)	debug-playbook.md、tracing-rules.md、root-cause-checklist.md
审查你的 UI	Frontend	frontend-rules.md、ui-audit.md、component-guidelines.md
修复搜索排名	SEO	seo-rules.md、meta-tag-audit.json、schema-recommendations.json
降低大模型成本	Optimization	optimization-rules.md、cost-estimate.json、token-budget-plan.md
发布设计系统	Theme	design-tokens.json、theme.css、dark-mode-tokens.json
统一品牌语调	Brand	brand-guidelines.md、voice-and-tone.md、messaging-system.yaml
自动化开发工作流	Superpowers	superpower-pack.md、workflow-registry.json、automation-pipeline.yaml
发起营销活动	Marketing	campaign-brief.md、funnel-map.md、ab-test-plan.md
构建数据/研究工具	Notebook	notebook-summary.md、research-threads.md、source-map.json
管理知识库	Obsidian	obsidian-skill-pack.md、vault-rules.md、graph-prompt-map.json
连接 AI 工具（MCP）	MCP	mcp-config.json、mcp-registry-metadata.json、protocol-spec.md、spec.types.ts、mcp/README.md、mcp/project-setup.md、mcp/build-artifacts.md、mcp/package-json.root.template.json、mcp/package-json.package.template.json、mcp/tsconfig.root.template.json、mcp/tsconfig.package.template.json、mcp/monorepo-structure.md、mcp/core-implementation-artifacts.md、mcp/testing-documentation-polish-artifacts.md、mcp/fintech-mcp-surface-package.md、mcp/fintech-domain-schema.yaml、connector-map.yaml、capability-registry.json、server-manifest.yaml
生成组件	Artifacts	generated-component.tsx、dashboard-widget.tsx、component-library.json
制作开发视频	Remotion	remotion-script.ts、scene-plan.md、storyboard.md
社交媒体与视觉素材	Canvas	canvas-spec.json、social-pack.md、poster-layouts.md
生成式艺术 / NFT	Algorithmic	generative-sketch.ts、variation-matrix.json、parameter-pack.json
Agent 商务（Visa AP2）	Agentic Purchasing	agent-purchasing-playbook.md、checkout-flow.md、negotiation-rules.md

另有 begin 循环 — 交给 Agent 并输入 begin

每次分析都会融入一个自动驾驶控制循环，让 AI 编码 Agent 不只是理解工作，还能完成工作：

• begin.yaml — 循环入口：推断出的目标、人机协同协议（负责人只需回答通俗易懂的产品问题）、行动选择算法，以及收敛式停止条件。
• continuation.yaml — 循环状态：按顺序排列的全部成果步骤列表，以及根据分析结果预先填充的优先级候选队列（目标、检测到的缺口，以及在没有测试时使用的验证框架）。
• 每个 Markdown 成果末尾都有 ⟳ Continue 页脚；最后一步会自我提示 begin，让循环回到 begin.yaml。

下载资料包（CLI、MCP 或完整资料包导出），交给 Agent 并输入 begin——它会处理队列、逐步验证，并在队列清空时停止（循环会收敛，不会失控）。负责人无需编写代码。

AXIS 在自身项目中也使用这套机制：此仓库根目录的 begin.yaml / continuation.yaml 就是我们实际使用的循环，同时也会通过 REST 原样提供，地址为 GET /begin.yaml / GET /continuation.yaml——因此，通过此 API 探索的 Agent 无需克隆仓库，也能发现同样的约定。

---

面向 AI Agent — MCP 集成

AXIS 提供位于 https://api.iliad.trustfabric.ai/mcp 的 Streamable HTTP MCP 服务。将它添加到你的 Agent 后，它便能自主分析任意代码仓库，或为 Agent 式采购做准备。

VS Code（.vscode/mcp.json）：

{
  "servers": {
    "axis-iliad": {
      "type": "http",
      "url": "https://api.iliad.trustfabric.ai/mcp",
      "headers": { "Authorization": "Bearer YOUR_API_KEY" }
    }
  }
}

Claude Desktop（claude_desktop_config.json）：

{
  "mcpServers": {
    "axis-iliad": {
      "url": "https://api.iliad.trustfabric.ai/mcp",
      "headers": { "Authorization": "Bearer YOUR_API_KEY" }
    }
  }
}

免费 MCP 工具（无需身份验证）：list_programs、search_and_discover_tools、get_install_manifest、discover_agentic_purchasing_needs、prepare_agentic_purchasing_preview、discover_estate_tools（AXIS 旗下的其他产品，包括支付、3D 生成等），以及确定性的商务决策引擎：sca_exemption_decision、grade_compliance、assemble_ce3_evidence、build_ap2_mandate、score_dispute_readiness（证据采集就绪度评估，而非争议胜诉预测）。还有五个标记为 estate 的计划能力存根（Foundry Wave-1；在 Iliad 托管的代理服务上线前，会明确重定向到 Foundry 自己的 MCP 端点）：axis_validate、axis_inspect、axis_compare、axis_manifest_verify、roblox_compliance_check。get_referral_code、get_referral_credits 和 iliad_network_tokenization 也是免费的（不收费），但与上述工具不同，它们需要身份验证。ping_payment 并非免费：费用为 $0.01，可体验真实的 x402 支付流程，是目录中价格最低的付费调用。

---

定价

层级	价格	程序
免费	$0	所有 21 个程序中的 47 个构件（完整提供 Search、Skills、Debug）
专业版	$3.00 / 次运行	全部 21 个程序，共 152 个构件
Lite 模式	$0.15–$0.25 / 次运行	差距摘要，精简输出

预算协商：在任何付费调用中发送 X-Agent-Budget: {"budget_per_run_cents": 25} + X-Agent-Mode: lite。

---

自托管

系统要求

• Node.js：≥ 20.x（建议使用 LTS）
• pnpm：≥ 9.x
• 操作系统：macOS 11+、Linux（任意发行版）或 Windows 10+
• 内存：至少 4 GB（建议 8 GB）
• 磁盘空间：依赖项和构建约需 2 GB

快速开始

# Prerequisites: Node.js ≥ 20, pnpm ≥ 9
git clone https://github.com/lastmanupinc-hub/axis-iliad.git
cd axis-iliad
pnpm install
pnpm build

# Start the API server (port 4000)
node apps/api/dist/server.js

# Start the web UI (port 5173)
cd apps/web && npx vite

# Or use the CLI directly
node apps/cli/dist/cli.js analyze .
node apps/cli/dist/cli.js github https://github.com/owner/repo

Docker

docker build -t axis-iliad .
docker run -p 4000:4000 axis-iliad

要求：Docker 20.10+ 或 Docker Desktop

---

架构

axis-iliad/
├── apps/
│   ├── api/          → Zero-dependency HTTP server (port 4000, 188 endpoints)
│   ├── cli/          → CLI tool: axis analyze <dir> | axis github <url>
│   └── web/          → Vite + React 19 SPA (dark theme, toast, command palette)
├── packages/
│   ├── snapshots/    → Snapshot intake, Postgres (Neon) persistence, billing, funnel
│   ├── repo-parser/  → Language detection (60+), framework detection (10), import graph
│   ├── context-engine/ → Context map builder, repo profile, route/architecture analysis
│   └── generator-core/ → 152 generators across 21 programs
└── vitest.config.ts  → Shared test config

Programs (21)

Program	Outputs	Tier
Search	context-map.json, repo-profile.yaml, architecture-summary.md, dependency-hotspots.md	Free
Skills	AGENTS.md, CLAUDE.md, .cursorrules, workflow-pack.md, policy-pack.md	Free
Debug	debug-playbook.md, incident-template.md, tracing-rules.md, root-cause-checklist.md	Free
Frontend	frontend-rules.md, component-guidelines.md, layout-patterns.md, ui-audit.md	Pro
SEO	seo-rules.md, schema-recommendations.json, route-priority-map.md, content-audit.md, meta-tag-audit.json	Pro
Optimization	optimization-rules.md, prompt-diff-report.md, cost-estimate.json, token-budget-plan.md	Pro
Theme	design-tokens.json, theme.css, theme-guidelines.md, component-theme-map.json, dark-mode-tokens.json	Pro
Brand	brand-guidelines.md, voice-and-tone.md, content-constraints.md, messaging-system.yaml, channel-rulebook.md	Pro
Superpowers	superpower-pack.md, workflow-registry.json, test-generation-rules.md, refactor-checklist.md, automation-pipeline.yaml	Pro
Marketing	campaign-brief.md, funnel-map.md, sequence-pack.md, cro-playbook.md, ab-test-plan.md	Pro
Notebook	notebook-summary.md, source-map.json, study-brief.md, research-threads.md, citation-index.json	Pro
Obsidian	obsidian-skill-pack.md, vault-rules.md, graph-prompt-map.json, linking-policy.md, template-pack.md	Pro
MCP	mcp-config.json, mcp-registry-metadata.json, protocol-spec.md, connector-map.yaml, capability-registry.json, server-manifest.yaml	Pro
Artifacts	generated-component.tsx, dashboard-widget.tsx, embed-snippet.ts, artifact-spec.md, component-library.json	Pro
Remotion	remotion-script.ts, scene-plan.md, render-config.json, asset-checklist.md, storyboard.md	Pro
Canvas	canvas-spec.json, social-pack.md, poster-layouts.md, asset-guidelines.md, brand-board.md	Pro
Algorithmic	generative-sketch.ts, parameter-pack.json, collection-map.md, export-manifest.yaml, variation-matrix.json	Pro
Agentic Purchasing	agent-purchasing-playbook.md, product-schema.json, checkout-flow.md, negotiation-rules.md, commerce-registry.json	Pro
Closer	packaging/README.md, Dockerfile, .github/workflows/ci.yml, packaging-report.md, DISTRIBUTABLE.md, Makefile	Pro
Deploy	deploy/Dockerfile, deploy/render.yaml, deploy/deploy.sh, deploy/worker.ts, deploy-qualification-report.md	Pro

API Endpoints

核心流水线

方法	路径	描述
POST	/v1/snapshots	上传仓库快照（multipart 文件上传）
POST	/v1/github/analyze	根据 GitHub URL 分析仓库
GET	/v1/snapshots/:id	获取快照元数据
GET	/v1/projects/:project_id/snapshots	列出项目的快照
POST	/v1/search/export	运行 search 程序
POST	/v1/skills/generate	运行 skills 程序
POST	/v1/debug/analyze	运行 debug 程序
POST	/v1/frontend/audit	运行 frontend 程序
POST	/v1/seo/analyze	运行 SEO 程序
POST	/v1/optimization/analyze	运行 optimization 程序
POST	/v1/theme/generate	运行 theme 程序
POST	/v1/brand/generate	运行 brand 程序
POST	/v1/superpowers/generate	运行 superpowers 程序
POST	/v1/marketing/generate	运行 marketing 程序
POST	/v1/notebook/generate	运行 notebook 程序
POST	/v1/obsidian/analyze	运行 obsidian 程序
POST	/v1/mcp/provision	运行 MCP 程序
POST	/v1/artifacts/generate	运行 artifacts 程序
POST	/v1/remotion/generate	运行 remotion 程序
POST	/v1/canvas/generate	运行 canvas 程序
POST	/v1/algorithmic/generate	运行 algorithmic 程序
POST	/v1/agentic-purchasing/generate	运行 agentic purchasing 程序
GET	/v1/programs	列出所有程序及其生成器数量
GET	/v1/projects/:id/generated-files/:path	下载单个生成文件
GET	/v1/projects/:id/export	下载生成文件的 ZIP 压缩包

计费与账户

方法	路径	描述
POST	/v1/accounts	创建账户
GET	/v1/account	获取账户信息
POST	/v1/account/keys	创建 API 密钥
GET	/v1/account/keys	列出 API 密钥
POST	/v1/account/keys/:id/revoke	撤销 API 密钥
GET	/v1/account/usage	获取用量统计
GET	/v1/account/quota	获取配额信息
POST	/v1/account/tier	更新计费层级
POST	/v1/account/programs	更新程序权益
POST	/v1/account/github-token	保存加密的 GitHub 令牌
GET	/v1/account/github-token	列出 GitHub 令牌
DELETE	/v1/account/github-token/:token_id	删除 GitHub 令牌
GET	/v1/billing/history	计费层级变更审计记录
GET	/v1/billing/proration	预览层级变更的按比例计费金额

转化漏斗与方案

方法	路径	描述
GET	/v1/plans	获取方案目录
POST	/v1/account/seats	邀请团队成员
GET	/v1/account/seats	列出团队席位
POST	/v1/account/seats/:id/revoke	撤销席位
GET	/v1/account/upgrade-prompts	获取情境化升级提示
GET	/v1/account/funnel-status	获取漏斗阶段
GET	/v1/admin/funnel-metrics	汇总漏斗分析数据

搜索与版本

方法	路径	描述
POST	/v1/search/index	为快照内容建立全文搜索索引
POST	/v1/search/query	在已索引内容中进行全文搜索
GET	/v1/search/:id/stats	搜索索引统计信息
GET	/v1/snapshots/:id/versions	列出生成版本
GET	/v1/snapshots/:id/versions/:num	获取包含文件的指定版本
GET	/v1/snapshots/:id/diff?old=N&new=M	比较两个版本的差异

Webhook

方法	路径	描述
POST	/v1/account/webhooks	创建 webhook
GET	/v1/account/webhooks	列出 webhook
DELETE	/v1/account/webhooks/:id	删除 webhook
POST	/v1/account/webhooks/:id/toggle	切换 webhook 的启用或禁用状态
GET	/v1/account/webhooks/:id/deliveries	列出投递尝试

基础设施

方法	路径	描述
GET	/v1/health	健康检查
GET	/v1/health/live	存活探针
GET	/v1/health/ready	就绪探针（数据库连接）
GET	/v1/metrics	Prometheus 风格的指标
GET	/v1/db/stats	数据库统计信息
POST	/v1/db/maintenance	数据库维护（清理、WAL 检查点）
GET	/v1/docs	OpenAPI 3.1 规范
GET	/v1/admin/stats	全系统统计信息
GET	/v1/admin/accounts	管理员：列出所有账户
GET	/v1/admin/activity	管理员：近期活动动态

输入方式

1. 文件上传 — 通过 multipart 请求体 POST /v1/snapshots
2. GitHub URL — 使用 { "url": "https://github.com/..." } POST /v1/github/analyze
3. CLI（本地） — axis analyze <directory> 扫描本地文件
4. CLI（远程） — axis github <url> 从 GitHub 获取内容

技术栈

• 运行时：Node.js 20+、TypeScript 5.7 strict
• 后端：零依赖自定义 HTTP 路由器、Neon Postgres（pg，异步连接池）
• 前端：Vite 6 + React 19、CSS 设计系统（深色主题）
• 测试：Vitest 4 — 约 190 个文件中的约 4,900 项测试，使用 Postgres 16 运行
• 基准测试：Vitest 基准测试框架（packages/repo-parser/src/perf.bench.ts、npx vitest bench）在 200 个文件的规模下测试 parseRepo；此处未指定具体延迟数值——本仓库自身的诚信政策（参见 packages/generator-core/src/perf-compliance.test.ts）禁止引用未经已签入的机器生成结果文件佐证的性能数据，而此基准测试目前还没有此类文件。7 个 agentic-purchasing 引擎则有此类文件：packages/generator-core/perf-results.json（通过 pnpm bench:compliance 重新生成）。
• 构建：pnpm 工作区，每个包使用 tsc
• CI：GitHub Actions（Node 20/22 矩阵、覆盖率、依赖审计、Docker 构建）

开发

pnpm install          # Install all dependencies
pnpm build            # Build all packages + apps
pnpm test             # Run all tests
npx vitest run        # Run tests directly
npx vitest bench      # Run performance benchmarks
npx vitest --coverage # Run tests with coverage report

有关如何添加生成器、端点或程序，请参阅 CONTRIBUTING.md。

输入方式

方法	方式
GitHub URL	使用 {"url":"https://github.com/..."} 调用 POST /v1/github/analyze
文件上传	POST /v1/snapshots multipart 请求体
CLI（本地）	axis analyze <directory>
CLI（远程）	axis github <url>
MCP	tools/call → analyze_repo 或 analyze_files

---

网站：https://iliad.trustfabric.ai · 在线 API：https://api.iliad.trustfabric.ai · 文档：https://api.iliad.trustfabric.ai/v1/docs · MCP：https://api.iliad.trustfabric.ai/mcp

许可证

私有。保留所有权利。