# 1. 安装依赖（uv 会自动创建 .venv）
uv sync

# 2. 配置凭据（参考 .env.example）
Copy-Item .env.example .env   # 然后填入 DASHSCOPE_API_KEY
# 或在 ~/.dsh/.env 中配置，DSH 启动时会自动加载

# 3. 本地以 stdio 启动（MCP）
uv run dsh-image-generate --transport stdio

# 4. 或启动 streamable-http 服务（默认 127.0.0.1:8900/mcp）
uv run dsh-image-generate --transport streamable-http --port 8900

# 5. 跑测试
uv run pytest -q

# 6. 真实 API 冒烟测试（消耗少量额度，视频需数分钟）
uv run python scripts/smoke_test.py

{
  "created": 1789...,
  "provider": "dashscope-native",
  "model": "z-image-turbo",
  "data": [
    {"url": "https://.../xx.png", "revised_prompt": null,
     "local_path": "C:\\Users\\...\\outputs\\dsh-image-generate\\img-1-....png",
     "width": 1024, "height": 1024}
  ],
  "usage": {},
  "output_dir": "C:\\Users\\...\\outputs\\dsh-image-generate"
}

# 方式 A：写入 ~/.dsh/.env（IMG_* 不在保留名单内，安全；Harness 启动时自动加载）
#   DASHSCOPE_API_KEY=sk-xxx
#   IMG_DASHSCOPE_BASE_URL=https://dashscope.aliyuncs.com/api/v1
#   IMG_OPENAI_BASE_URL=https://dashscope.aliyuncs.com/compatible-mode/v1

# 方式 B：导出为系统/用户环境变量（DSH 进程重启后生效）
setx DASHSCOPE_API_KEY "sk-xxx"
setx IMG_DASHSCOPE_BASE_URL "https://dashscope.aliyuncs.com/api/v1"
setx IMG_OPENAI_BASE_URL "https://dashscope.aliyuncs.com/compatible-mode/v1"
setx IMG_OUTPUT_DIR "C:\Users\YOURNAME\.dsh\outputs\dsh-image-generate"

- insert:
    - id: mcp-dsh-image-generate
      name: '@deepseek-ai/dsh-mcp-client'
      config:
        serverName: dsh-image-generate
        transport: stdio
        command: D:/py/dsh-imageGenerate/.venv/Scripts/dsh-image-generate.exe
        args: ['--transport', 'stdio']
        cwd: D:/py/dsh-imageGenerate
        env:
          DASHSCOPE_API_KEY: !!js process.env.DASHSCOPE_API_KEY
          IMG_DASHSCOPE_BASE_URL: !!js process.env.IMG_DASHSCOPE_BASE_URL
          IMG_OPENAI_BASE_URL: !!js process.env.IMG_OPENAI_BASE_URL
          IMG_OUTPUT_DIR: !!js process.env.IMG_OUTPUT_DIR
        failOnStartupError: true
        toolCallTimeoutMs: 900000   # 视频生成需数分钟

src/dsh_image_generate/
├── server.py                  # MCP 工具层（generate_image / edit_image / generate_video / ...）
├── config.py                  # 环境变量配置
├── storage.py                 # 下载落盘与 .meta.json
├── utils.py                   # size 语法、图片输入归一化等
└── providers/
    ├── openai_images.py       # OpenAI 兼容 transport（/images/generations、/images/edits）
    ├── dashscope_native.py    # DashScope 原生同步接口（z-image / qwen-image-3.0）
    └── dashscope_video.py     # DashScope 视频异步任务（提交 + 轮询）
tests/                         # 离线 mock 测试（httpx.MockTransport，无需 Key）
scripts/smoke_test.py          # 真实 API 冒烟测试

uv sync                # 安装依赖（含 dev）
uv run pytest -q       # 离线测试
uv run python scripts/smoke_test.py   # 真实 API 冒烟（需 Key 与额度）