从写代码到交付结果：Qoder 为什么不再把自己定义为 IDE

目标：为内部运营人员增加库存查询页面
约束：复用现有登录系统，不新增数据库
验收条件：
1. 支持按 SKU 和仓库筛选
2. 无权限用户返回 403
3. 查询接口 P95 小于 500ms
4. 包含接口测试和回滚说明

import json
import os
import sys
import urllib.request
from pathlib import Path

BASE_URL = os.getenv("LLM_BASE_URL", "https://api.openai.com/v1").rstrip("/")
API_KEY = os.getenv("LLM_API_KEY")
MODEL = os.getenv("LLM_MODEL", "gpt-4o-mini")
APPLY = os.getenv("APPLY", "0") == "1"

if not API_KEY:
    raise SystemExit("请设置 LLM_API_KEY")

if len(sys.argv) < 2:
    raise SystemExit('用法: python mini_agent.py "描述你想完成的任务"')

goal = sys.argv[1]
system_prompt = """
你是一个受限的软件任务代理。请根据用户目标生成最小可运行项目。
只返回合法 JSON，不要返回 Markdown。格式必须是：
{
  "summary": "方案摘要",
  "files": [
    {"path": "相对路径", "content": "完整文件内容"}
  ]
}
限制：
- 最多生成 10 个文件；
- 不使用绝对路径或包含 .. 的路径；
- 不生成密钥；
- 优先生成 README 和可执行验证步骤。
""".strip()

payload = {
    "model": MODEL,
    "messages": [
        {"role": "system", "content": system_prompt},
        {"role": "user", "content": goal},
    ],
    "temperature": 0.2,
}

request = urllib.request.Request(
    f"{BASE_URL}/chat/completions",
    data=json.dumps(payload).encode("utf-8"),
    headers={
        "Authorization": f"Bearer {API_KEY}",
        "Content-Type": "application/json",
    },
    method="POST",
)

with urllib.request.urlopen(request, timeout=120) as response:
    api_result = json.loads(response.read().decode("utf-8"))

content = api_result["choices"][0]["message"]["content"]
plan = json.loads(content)
files = plan.get("files", [])

if not isinstance(files, list) or len(files) > 10:
    raise ValueError("文件计划不合法")

root = Path("workspace").resolve()
root.mkdir(exist_ok=True)

print("方案：", plan.get("summary", "无摘要"))
print("模式：", "写入文件" if APPLY else "仅预览")

for item in files:
    relative_path = item["path"]
    file_content = item["content"]
    target = (root / relative_path).resolve()

    if root not in target.parents:
        raise ValueError(f"拒绝越界路径：{relative_path}")
    if len(file_content.encode("utf-8")) > 200_000:
        raise ValueError(f"文件过大：{relative_path}")

    print(f"- {relative_path} ({len(file_content)} chars)")
    if APPLY:
        target.parent.mkdir(parents=True, exist_ok=True)
        target.write_text(file_content, encoding="utf-8")

if not APPLY:
    print("预览完成。确认计划后设置 APPLY=1 再次运行。")

export LLM_BASE_URL="https://api.openai.com/v1"
export LLM_API_KEY="替换为你的密钥"
export LLM_MODEL="gpt-4o-mini"

# 第一次只查看计划，不写入文件
python mini_agent.py "生成一个 Python 命令行工具，读取 CSV 并按地区汇总销售额，包含测试和 README"

# 确认目标与输出范围后，再允许写入 workspace
APPLY=1 python mini_agent.py "生成一个 Python 命令行工具，读取 CSV 并按地区汇总销售额，包含测试和 README"