Package Exports

@optima-chat/optima-agent
@optima-chat/optima-agent/dist/src/index.js

This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (@optima-chat/optima-agent) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.

Readme

Optima Agent

基于 Claude Agent SDK 的电商运营 AI 助手。

安装

npm install -g @optima-chat/optima-agent

认证

设置环境变量（推荐）：

export ANTHROPIC_API_KEY=your-api-key

或使用 Claude Code 的认证（~/.claude/）。

架构

┌─────────────────────────────────────────────────────────────────────────────┐
│                              客户端                                          │
│          终端 CLI                              Web 前端                      │
│              │                                    │                         │
└──────────────┼────────────────────────────────────┼─────────────────────────┘
               │                                    │ WebSocket
               ▼                                    ▼
┌─────────────────────────────────────────────────────────────────────────────┐
│                            Optima Agent                                      │
│  ┌───────────────────────────────────────────────────────────────────────┐  │
│  │                        Claude Agent SDK                                │  │
│  │                                                                        │  │
│  │  Skills · 流式输出 · 上下文压缩 · Hooks · 会话管理 · 权限控制          │  │
│  │  Bash · Read/Write/Edit · Glob/Grep · WebFetch · Task · TodoWrite     │  │
│  │                                    │                                   │  │
│  └────────────────────────────────────┼───────────────────────────────────┘  │
└───────────────────────────────────────┼─────────────────────────────────────┘
                                        ▼
┌─────────────────────────────────────────────────────────────────────────────┐
│                            CLI 工具生态                                      │
│   commerce          comfy           google-ads       scout         bi       │
│  商品·订单·库存    图像·视频        广告投放        选品调研      数据分析   │
└─────────────────────────────────────────────────────────────────────────────┘

使用

# 交互模式
optima

# 单次查询
optima -p "查看商品列表"

# 服务器模式
optima serve --port 3000

Skills

Skill	CLI	用途
commerce-product	commerce-cli	商品管理
commerce-order	commerce-cli	订单处理
commerce-inventory	commerce-cli	库存管理
commerce-i18n	commerce-cli	国际化翻译
commerce-storefront	commerce-cli	店铺配置
comfy-cli	comfy-cli	图像/视频生成
google-ads-cli	google-ads-cli	广告投放
optima-scout	scout-cli	选品调研
bi-cli	bi-cli	数据分析

配置

在项目根目录创建配置文件：

OPTIMA.json - 配置选项

{
  "model": "claude-sonnet-4-5-20250929",
  "maxTurns": 50,
  "theme": "dark"
}

OPTIMA.md - 自定义 System Prompt

# 项目规则

- 使用简体中文
- 优先使用现有库存

API

import { OptimaAgent } from '@optima-chat/optima-agent';

const agent = new OptimaAgent({
  model: 'claude-sonnet-4-5-20250929',
  maxTurns: 50,
});

// 单次对话
for await (const event of agent.chat('查看商品列表')) {
  if (event.type === 'text') {
    console.log(event.text);
  }
}

// 重置会话
agent.reset();

文档

技术设计

License

MIT