@minus-ai/create-skill 0.1.0-beta.1

package/templates/README.md.tpl

@@ -0,0 +1,123 @@
+# {{displayName}}
+
+Minus Skill 项目，由 `create-skill` 脚手架生成。
+
+## 环境要求
+
+| 依赖 | 最低版本 | 说明 |
+|---|---|---|
+| Node.js | >= 18 | 前端构建和开发服务 |
+| pnpm | >= 9 | 包管理（全局 store 共享，多 skill 不重复下载） |
+| Python | >= 3.12 | 后端 Pipeline 运行时 |
+| uv | >= 0.4 | Python 包管理（全局缓存，秒级安装） |
+| Git | >= 2 | 版本管理 |
+
+## 项目结构
+
+```
+{{folder}}/
+├── pipeline.py          # 后端 Pipeline 逻辑（step_1, step_2 ...）
+├── server.py            # ASGI 服务入口
+├── pyproject.toml       # Python 依赖声明
+├── package.json         # Node 根配置（workspaces + dev 脚本）
+├── .env.local           # 运行时凭证（不提交到 Git）
+├── .env.example         # 凭证示例
+├── .minus/skill.json    # Skill ID 标识
+├── frontend/
+│   ├── src/main.tsx     # 前端入口（输入表单 + 结果渲染）
+│   ├── src/locales/     # 多语言文件（zh-CN / en-US）
+│   ├── embed.html       # iframe 宿主页
+│   ├── vite.config.ts   # Vite 构建配置
+│   └── package.json     # 前端依赖
+└── tests/               # 测试用例
+```
+
+## 安装依赖
+
+### 前端（Node）
+
+```bash
+pnpm install
+```
+
+### 后端（Python）
+
+```bash
+uv venv .venv
+source .venv/bin/activate    # Windows: .venv\Scripts\activate
+uv pip install -e .
+```
+
+## 配置
+
+复制环境变量文件并填入真实凭证：
+
+```bash
+cp .env.example .env.local
+```
+
+`.env.local` 中需要配置：
+
+| 变量 | 说明 |
+|---|---|
+| `MINUS_AI_SKILL_API_KEY` | Skill 的 API Key（创建时自动生成） |
+| `MINUS_AI_PLATFORM_URL` | 平台地址（默认已填好） |
+
+## 开发
+
+一键启动前后端开发服务：
+
+```bash
+pnpm run dev
+```
+
+这会同时启动：
+- **后端** — `uvicorn` 监听 `http://localhost:{{port}}`，修改 `.py` 文件自动重载
+- **前端** — `vite` 开发服务，修改前端代码自动热更新
+
+单独启动前端：
+
+```bash
+cd frontend && pnpm exec vite
+```
+
+## 构建
+
+```bash
+pnpm run build
+```
+
+产物输出到 `static/` 目录。
+
+## 发布
+
+在 Claude Code 中使用命令发布到 Minus 平台：
+
+```
+/minus-publish
+```
+
+或在 Minus 开发模式下：
+
+```
+/minus publish
+```
+
+## 常用开发命令
+
+| 命令 | 说明 |
+|---|---|
+| `pnpm run dev` | 启动开发环境（前后端） |
+| `pnpm run build` | 构建前端产物 |
+| `cd frontend && pnpm exec vite` | 仅启动前端 |
+| `.venv/bin/uvicorn server:app --port {{port}} --reload --env-file .env.local` | 仅启动后端 |
+
+## 进入开发模式（Claude Code）
+
+在项目目录下启动 Claude Code，会自动激活 Minus 开发环境：
+
+```bash
+cd ~/minus/{{folder}} && claude
+```
+
+进入后输入 `/minus` 即可开始开发。

package/templates/asin/en-US.json.tpl

@@ -0,0 +1,7 @@
+{
+  "{{namespace}}.step.title": "Result",
+  "{{namespace}}.step.empty": "(empty)",
+  "{{namespace}}.home.placeholder": "Enter one or more ASINs",
+  "{{namespace}}.home.processing": "Processing…",
+  "{{namespace}}.home.send": "Start"
+}

package/templates/asin/main.tsx.tpl

@@ -0,0 +1,95 @@
+import { StrictMode, useMemo, useState } from 'react';
+import { createRoot } from 'react-dom/client';
+import { FlowApp, I18nProvider, mergeMessages, useT, type StepConfig } from '@minus/widget-framework';
+import { AmazonSearchBar, CountrySelect, SearchSubmitButton, validateAsins, platformWidgetMessages } from '@minus/platform-widgets';
+import { Toaster } from 'sonner';
+import zhCN from './locales/zh-CN.json';
+import enUS from './locales/en-US.json';
+
+/*
+ * 防御性编码提示（适用于所有 step render 函数）：
+ * - 后端 data 不可信，所有字段都要 ?? 兜底
+ * - 数组：(data.list as T[] | undefined) ?? []
+ * - 字符串：(data.name as string | undefined) ?? ''
+ * - 数字：Number(data.count) || 0
+ * - 嵌套：(data.obj as Record<string, unknown> | undefined)?.field ?? fallback
+ * 框架已有 Error Boundary 兜底，但不应依赖——优先在数据层做防御。
+ */
+function buildSteps(t: (k: string, fb?: string) => string): StepConfig[] {
+  return [
+    {
+      render: ({ data }) => (
+        <div className="minus-default-step-done">
+          {(data.text as string | undefined) ?? t('{{namespace}}.step.empty', '(空)')}
+        </div>
+      ),
+    },
+  ];
+}
+
+function Home({ title, description, useCases, tags, onStart }: { title: string; description?: string; useCases?: string[]; tags?: Array<{ code: string; label: string }>; onStart: (input: Record<string, unknown>) => Promise<void> }) {
+  const t = useT();
+  const [value, setValue] = useState('');
+  const [country, setCountry] = useState('US');
+  const [error, setError] = useState<string | null>(null);
+  const [loading, setLoading] = useState(false);
+
+  async function handleSubmit() {
+    if (loading) return;
+    const { asins, error: asinError } = validateAsins(value);
+    if (asinError) { setError(t(asinError.key, asinError.fallback, asinError.vars)); return; }
+    setError(null);
+    setLoading(true);
+    try { await onStart({ asins: asins.join(','), country }); } finally { setLoading(false); }
+  }
+
+  return (
+    <>
+      <h1>{title}</h1>
+      {description && <p className="minus-skill-hero__subtitle">{description}</p>}
+      {((useCases && useCases.length > 0) || (tags && tags.length > 0)) && (
+        <ul className="minus-skill-hero__use-cases">
+          {useCases?.map((uc, i) => (
+            <li key={`uc-${i}`} className="minus-skill-hero__use-case-chip">{uc}</li>
+          ))}
+          {tags?.map((tag) => (
+            <li key={`tag-${tag.code}`} className="minus-skill-hero__use-case-chip">{tag.label}</li>
+          ))}
+        </ul>
+      )}
+      <AmazonSearchBar
+        onSubmit={handleSubmit}
+        country={<CountrySelect onChange={setCountry} />}
+        input={<input type="text" value={value} onChange={(e) => { setValue(e.target.value); if (error) setError(null); }} placeholder={t('{{namespace}}.home.placeholder', '输入一个或多个ASIN')} spellCheck={false} disabled={loading} />}
+        submit={<SearchSubmitButton />}
+        error={error}
+      />
+    </>
+  );
+}
+
+const rootEl = document.getElementById('root');
+if (!rootEl) throw new Error('#root not found');
+
+const skillMessages = mergeMessages(platformWidgetMessages, { 'zh-CN': zhCN as Record<string, string>, 'en-US': enUS as Record<string, string> });
+
+function SkillRoot() {
+  const t = useT();
+  const steps = useMemo(() => buildSteps(t), [t]);
+  return (
+    <FlowApp
+      steps={steps}
+      renderHome={({ flow, onStart }) => <Home title={flow.title} description={flow.description} useCases={flow.useCases} tags={flow.tags} onStart={onStart} />}
+      renderCompletion={() => null}
+      renderHistoryItem={(entry) => {
+        const inp = entry.entryParams as Record<string, string> | undefined;
+        return {
+          label: inp?.asins ?? '—',
+          meta: inp?.country || undefined,
+        };
+      }}
+    />
+  );
+}
+
+createRoot(rootEl).render(<StrictMode><I18nProvider messages={skillMessages}><SkillRoot /><Toaster /></I18nProvider></StrictMode>);

package/templates/asin/pipeline.py.tpl

@@ -0,0 +1,11 @@
+from minus_ai_sdk import Pipeline, PipelineContext, StepOutcome
+
+
+class {{className}}(Pipeline):
+
+    async def step_1(self, ctx: PipelineContext) -> StepOutcome:
+        asins: str = ctx.entry_params.get("asins", "")
+        country: str = ctx.entry_params.get("country", "US")
+
+        result = f"ASINs: {asins} ({country})"
+        return StepOutcome.complete(payload={"text": result})

package/templates/asin/zh-CN.json.tpl

@@ -0,0 +1,7 @@
+{
+  "{{namespace}}.step.title": "结果",
+  "{{namespace}}.step.empty": "(空)",
+  "{{namespace}}.home.placeholder": "输入一个或多个ASIN",
+  "{{namespace}}.home.processing": "处理中…",
+  "{{namespace}}.home.send": "开始"
+}

package/templates/custom/en-US.json.tpl

@@ -0,0 +1,8 @@
+{
+  "{{namespace}}.step.title": "Result",
+  "{{namespace}}.step.empty": "(empty)",
+  "{{namespace}}.home.fieldLabel": "Input",
+  "{{namespace}}.home.placeholder": "Enter...",
+  "{{namespace}}.home.processing": "Processing…",
+  "{{namespace}}.home.send": "Start"
+}

package/templates/custom/main.tsx.tpl

@@ -0,0 +1,93 @@
+import { StrictMode, useMemo, useState } from 'react';
+import { createRoot } from 'react-dom/client';
+import { FlowApp, I18nProvider, mergeMessages, useT, type StepConfig } from '@minus/widget-framework';
+import { platformWidgetMessages } from '@minus/platform-widgets';
+import { Toaster } from 'sonner';
+import zhCN from './locales/zh-CN.json';
+import enUS from './locales/en-US.json';
+
+/*
+ * 防御性编码提示（适用于所有 step render 函数）：
+ * - 后端 data 不可信，所有字段都要 ?? 兜底
+ * - 数组：(data.list as T[] | undefined) ?? []
+ * - 字符串：(data.name as string | undefined) ?? ''
+ * - 数字：Number(data.count) || 0
+ * - 嵌套：(data.obj as Record<string, unknown> | undefined)?.field ?? fallback
+ * 框架已有 Error Boundary 兜底，但不应依赖——优先在数据层做防御。
+ */
+function buildSteps(t: (k: string, fb?: string) => string): StepConfig[] {
+  return [
+    {
+      render: ({ data }) => (
+        <div className="minus-default-step-done">
+          {(data.text as string) ?? t('{{namespace}}.step.empty', '(空)')}
+        </div>
+      ),
+    },
+  ];
+}
+
+function Home({ title, description, useCases, tags, onStart }: { title: string; description?: string; useCases?: string[]; tags?: Array<{ code: string; label: string }>; onStart: (input: Record<string, unknown>) => Promise<void> }) {
+  const t = useT();
+  const [value, setValue] = useState('');
+  const [loading, setLoading] = useState(false);
+
+  async function handleSubmit() {
+    if (!value.trim() || loading) return;
+    setLoading(true);
+    try { await onStart({ text: value.trim() }); } finally { setLoading(false); }
+  }
+
+  return (
+    <div style={{ maxWidth: 480, padding: '24px 0' }}>
+      <h2 style={{ margin: '0 0 4px', fontSize: 20, fontWeight: 600 }}>{title}</h2>
+      {description && <p className="minus-skill-hero__subtitle">{description}</p>}
+      {((useCases && useCases.length > 0) || (tags && tags.length > 0)) && (
+        <ul className="minus-skill-hero__use-cases" style={{ justifyContent: 'flex-start' }}>
+          {useCases?.map((uc, i) => (
+            <li key={`uc-${i}`} className="minus-skill-hero__use-case-chip">{uc}</li>
+          ))}
+          {tags?.map((tag) => (
+            <li key={`tag-${tag.code}`} className="minus-skill-hero__use-case-chip">{tag.label}</li>
+          ))}
+        </ul>
+      )}
+      <div style={{ background: '#fff', border: '1px solid #e5e7eb', borderRadius: 8, padding: 20, display: 'flex', flexDirection: 'column', gap: 16, boxShadow: '0 1px 2px rgba(0,0,0,0.04)' }}>
+        <label className="minus-field">
+          <span>{t('{{namespace}}.home.fieldLabel', '输入')}</span>
+          <input type="text" value={value} onChange={(e) => setValue(e.target.value)} placeholder={t('{{namespace}}.home.placeholder', '请输入...')} onKeyDown={(e) => e.key === 'Enter' && handleSubmit()} />
+        </label>
+        <button className="minus-btn minus-btn-primary" onClick={handleSubmit} disabled={!value.trim() || loading}>
+          {loading ? t('{{namespace}}.home.processing', '处理中…') : t('{{namespace}}.home.send', '开始')}
+        </button>
+      </div>
+    </div>
+  );
+}
+
+const rootEl = document.getElementById('root');
+if (!rootEl) throw new Error('#root not found');
+
+const skillMessages = mergeMessages(platformWidgetMessages, { 'zh-CN': zhCN as Record<string, string>, 'en-US': enUS as Record<string, string> });
+
+function SkillRoot() {
+  const t = useT();
+  const steps = useMemo(() => buildSteps(t), [t]);
+  return (
+    <FlowApp
+      steps={steps}
+      homeLayout="left"
+      renderHome={({ flow, onStart }) => <Home title={flow.title} description={flow.description} useCases={flow.useCases} tags={flow.tags} onStart={onStart} />}
+      renderCompletion={() => null}
+      renderHistoryItem={(entry) => {
+        const inp = entry.entryParams as Record<string, string> | undefined;
+        return {
+          label: inp?.text ?? '—',
+          meta: inp?.country || undefined,
+        };
+      }}
+    />
+  );
+}
+
+createRoot(rootEl).render(<StrictMode><I18nProvider messages={skillMessages}><SkillRoot /><Toaster /></I18nProvider></StrictMode>);

package/templates/custom/pipeline.py.tpl

@@ -0,0 +1,9 @@
+from minus_ai_sdk import Pipeline, PipelineContext, StepOutcome
+
+
+class {{className}}(Pipeline):
+
+    async def step_1(self, ctx: PipelineContext) -> StepOutcome:
+        text: str = ctx.entry_params.get("text", "")
+
+        return StepOutcome.complete(payload={"text": text})

package/templates/custom/zh-CN.json.tpl

@@ -0,0 +1,8 @@
+{
+  "{{namespace}}.step.title": "结果",
+  "{{namespace}}.step.empty": "(空)",
+  "{{namespace}}.home.fieldLabel": "输入",
+  "{{namespace}}.home.placeholder": "请输入...",
+  "{{namespace}}.home.processing": "处理中…",
+  "{{namespace}}.home.send": "开始"
+}

package/templates/default/en-US.json.tpl

@@ -0,0 +1,4 @@
+{
+  "{{namespace}}.step.title": "Result",
+  "{{namespace}}.step.empty": "(empty)"
+}

package/templates/default/main.tsx.tpl

@@ -0,0 +1,109 @@
+import { StrictMode, useMemo } from 'react';
+import { createRoot } from 'react-dom/client';
+import { FlowApp, I18nProvider, mergeMessages, useT, type StepConfig } from '@minus/widget-framework';
+import { CompletionPanel, platformWidgetMessages } from '@minus/platform-widgets';
+import { Toaster } from 'sonner';
+import zhCN from './locales/zh-CN.json';
+import enUS from './locales/en-US.json';
+
+/*
+ * 防御性编码提示（适用于所有 step render 函数）：
+ * - 后端 data 不可信，所有字段都要 ?? 兜底
+ * - 数组：(data.list as T[] | undefined) ?? []
+ * - 字符串：(data.name as string | undefined) ?? ''
+ * - 数字：Number(data.count) || 0
+ * - 嵌套：(data.obj as Record<string, unknown> | undefined)?.field ?? fallback
+ * 框架已有 Error Boundary 兜底，但不应依赖——优先在数据层做防御。
+ */
+function buildSteps(t: (k: string, fb?: string) => string): StepConfig[] {
+  return [
+    {
+      render: ({ data }) => (
+        <div className="minus-default-step-done">
+          {(data.text as string | undefined) ?? t('{{namespace}}.step.empty', '(空)')}
+        </div>
+      ),
+    },
+  ];
+}
+
+function Home({
+  title,
+  description,
+  useCases,
+  tags,
+}: {
+  title: string;
+  description?: string;
+  useCases?: string[];
+  tags?: Array<{ code: string; label: string }>;
+}) {
+  return (
+    <>
+      <h1>{title}</h1>
+      {description && <p className="minus-skill-hero__subtitle">{description}</p>}
+      {((useCases && useCases.length > 0) || (tags && tags.length > 0)) && (
+        <ul className="minus-skill-hero__use-cases">
+          {useCases?.map((uc, i) => (
+            <li key={`uc-${i}`} className="minus-skill-hero__use-case-chip">{uc}</li>
+          ))}
+          {tags?.map((tag) => (
+            <li key={`tag-${tag.code}`} className="minus-skill-hero__use-case-chip">{tag.label}</li>
+          ))}
+        </ul>
+      )}
+    </>
+  );
+}
+
+const rootEl = document.getElementById('root');
+if (!rootEl) throw new Error('#root not found');
+
+const skillMessages = mergeMessages(
+  platformWidgetMessages,
+  { 'zh-CN': zhCN as Record<string, string>, 'en-US': enUS as Record<string, string> },
+);
+
+function SkillRoot() {
+  const t = useT();
+  const steps = useMemo(() => buildSteps(t), [t]);
+  return (
+    <FlowApp
+      steps={steps}
+      renderHome={({ flow }) => (
+        <Home title={flow.title} description={flow.description} useCases={flow.useCases} tags={flow.tags} />
+      )}
+      renderCompletion={({ stepHistory }) => {
+        const last = stepHistory.reduce<import('@minus/widget-framework').StepRecord | undefined>(
+          (acc, r) => (acc && acc.stepNumber > r.stepNumber ? acc : r),
+          undefined,
+        );
+        const data = last?.data ?? {};
+        return (
+          <CompletionPanel
+            title={data.title as string | undefined}
+            summary={data.summary as string | undefined}
+            filename={data.filename as string | undefined}
+            fileId={data.fileId as string | undefined}
+            sizeBytes={data.sizeBytes as number | undefined}
+          />
+        );
+      }}
+      renderHistoryItem={(entry) => {
+        const inp = entry.entryParams as Record<string, string> | undefined;
+        return {
+          label: inp?.text ?? '—',
+        };
+      }}
+    />
+  );
+}
+
+createRoot(rootEl).render(
+  <StrictMode>
+    <I18nProvider messages={skillMessages}>
+      <SkillRoot />
+      <Toaster />
+    </I18nProvider>
+  </StrictMode>,
+);

package/templates/default/pipeline.py.tpl

@@ -0,0 +1,8 @@
+from minus_ai_sdk import Pipeline, PipelineContext, StepOutcome
+
+
+class {{className}}(Pipeline):
+
+    async def step_1(self, ctx: PipelineContext) -> StepOutcome:
+        # TODO: implement step logic
+        return StepOutcome.complete(payload={"text": "done"})

package/templates/default/zh-CN.json.tpl

@@ -0,0 +1,4 @@
+{
+  "{{namespace}}.step.title": "结果",
+  "{{namespace}}.step.empty": "(空)"
+}

package/templates/embed.html.tpl

@@ -0,0 +1,13 @@
+<!doctype html>
+<html lang="zh-CN">
+<head>
+  <meta charset="utf-8" />
+  <meta name="viewport" content="width=device-width,initial-scale=1" />
+  <title>minus-{{displayName}}</title>
+  <script async src="//at.alicdn.com/t/c/font_4940197_un471494j1t.js"></script>
+</head>
+<body style="margin:0">
+  <div id="root"></div>
+  <script type="module" src="./src/main.tsx"></script>
+</body>
+</html>

package/templates/en-US.json.tpl

@@ -0,0 +1,10 @@
+{
+  "{{namespace}}.step.title": "Result",
+  "{{namespace}}.step.empty": "(empty)",
+  "{{namespace}}.home.tab.keyword": "Keyword",
+  "{{namespace}}.home.tab.asin": "ASIN",
+  "{{namespace}}.home.placeholderKeyword": "Enter keyword, e.g. bluetooth earbuds",
+  "{{namespace}}.home.placeholderAsin": "Enter one or more ASINs",
+  "{{namespace}}.home.processing": "Processing…",
+  "{{namespace}}.home.send": "Start"
+}

package/templates/env.example.tpl

@@ -0,0 +1,3 @@
+MINUS_AI_SKILL_API_KEY=ska_REPLACE_ME_WITH_REAL_KEY
+MINUS_AI_SKILL_ID=skl_REPLACE_ME_WITH_SKILL_ID
+MINUS_AI_PLATFORM_URL=http://47.107.144.22:18990

package/templates/file/en-US.json.tpl

@@ -0,0 +1,10 @@
+{
+  "{{namespace}}.step.title": "Result",
+  "{{namespace}}.step.empty": "(empty)",
+  "{{namespace}}.home.fieldLabel": "File",
+  "{{namespace}}.home.filePlaceholder": "Click to select a file",
+  "{{namespace}}.home.fileEmpty": "Please select a file",
+  "{{namespace}}.home.uploadFailed": "File upload failed",
+  "{{namespace}}.home.processing": "Uploading…",
+  "{{namespace}}.home.send": "Start"
+}

package/templates/file/main.tsx.tpl

@@ -0,0 +1,104 @@
+import { StrictMode, useMemo, useState } from 'react';
+import { createRoot } from 'react-dom/client';
+import { FlowApp, I18nProvider, mergeMessages, useT, type StepConfig } from '@minus/widget-framework';
+import { FilePicker, uploadFile, platformWidgetMessages } from '@minus/platform-widgets';
+import { Toaster } from 'sonner';
+import zhCN from './locales/zh-CN.json';
+import enUS from './locales/en-US.json';
+
+/*
+ * 防御性编码提示（适用于所有 step render 函数）：
+ * - 后端 data 不可信，所有字段都要 ?? 兜底
+ * - 数组：(data.list as T[] | undefined) ?? []
+ * - 字符串：(data.name as string | undefined) ?? ''
+ * - 数字：Number(data.count) || 0
+ * - 嵌套：(data.obj as Record<string, unknown> | undefined)?.field ?? fallback
+ * 框架已有 Error Boundary 兜底，但不应依赖——优先在数据层做防御。
+ */
+function buildSteps(t: (k: string, fb?: string) => string): StepConfig[] {
+  return [
+    {
+      render: ({ data }) => (
+        <div className="minus-default-step-done">
+          {(data.text as string) ?? t('{{namespace}}.step.empty', '(空)')}
+        </div>
+      ),
+    },
+  ];
+}
+
+function Home({ title, description, useCases, tags, onStart }: { title: string; description?: string; useCases?: string[]; tags?: Array<{ code: string; label: string }>; onStart: (input: Record<string, unknown>) => Promise<void> }) {
+  const t = useT();
+  const [file, setFile] = useState<File | null>(null);
+  const [error, setError] = useState<string | null>(null);
+  const [loading, setLoading] = useState(false);
+
+  async function handleSubmit() {
+    if (loading) return;
+    if (!file) { setError(t('{{namespace}}.home.fileEmpty', '请选择一个文件')); return; }
+    setError(null);
+    setLoading(true);
+    try {
+      const { fileId } = await uploadFile(file);
+      await onStart({ fileId, fileName: file.name });
+    } catch (e: any) {
+      setError(e?.message ?? t('{{namespace}}.home.uploadFailed', '文件上传失败'));
+    } finally {
+      setLoading(false);
+    }
+  }
+
+  return (
+    <div style={{ maxWidth: 480, padding: '24px 0' }}>
+      <h2 style={{ margin: '0 0 4px', fontSize: 20, fontWeight: 600 }}>{title}</h2>
+      {description && <p className="minus-skill-hero__subtitle">{description}</p>}
+      {((useCases && useCases.length > 0) || (tags && tags.length > 0)) && (
+        <ul className="minus-skill-hero__use-cases" style={{ justifyContent: 'flex-start' }}>
+          {useCases?.map((uc, i) => (
+            <li key={`uc-${i}`} className="minus-skill-hero__use-case-chip">{uc}</li>
+          ))}
+          {tags?.map((tag) => (
+            <li key={`tag-${tag.code}`} className="minus-skill-hero__use-case-chip">{tag.label}</li>
+          ))}
+        </ul>
+      )}
+      <div style={{ background: '#fff', border: '1px solid #e5e7eb', borderRadius: 8, padding: 20, display: 'flex', flexDirection: 'column', gap: 16, boxShadow: '0 1px 2px rgba(0,0,0,0.04)' }}>
+        <label className="minus-field">
+          <span>{t('{{namespace}}.home.fieldLabel', '文件')}</span>
+          <FilePicker value={file} onChange={(f) => { setFile(f); if (error) setError(null); }} disabled={loading} />
+        </label>
+        {error && <p style={{ margin: 0, fontSize: 13, color: 'var(--minus-color-danger, #ef4444)' }}>{error}</p>}
+        <button className="minus-btn minus-btn-primary" onClick={handleSubmit} disabled={!file || loading}>
+          {loading ? t('{{namespace}}.home.processing', '上传中…') : t('{{namespace}}.home.send', '开始')}
+        </button>
+      </div>
+    </div>
+  );
+}
+
+const rootEl = document.getElementById('root');
+if (!rootEl) throw new Error('#root not found');
+
+const skillMessages = mergeMessages(platformWidgetMessages, { 'zh-CN': zhCN as Record<string, string>, 'en-US': enUS as Record<string, string> });
+
+function SkillRoot() {
+  const t = useT();
+  const steps = useMemo(() => buildSteps(t), [t]);
+  return (
+    <FlowApp
+      steps={steps}
+      homeLayout="left"
+      renderHome={({ flow, onStart }) => <Home title={flow.title} description={flow.description} useCases={flow.useCases} tags={flow.tags} onStart={onStart} />}
+      renderCompletion={() => null}
+      renderHistoryItem={(entry) => {
+        const inp = entry.entryParams as Record<string, string> | undefined;
+        return {
+          label: inp?.fileName ?? '—',
+          meta: inp?.country || undefined,
+        };
+      }}
+    />
+  );
+}
+
+createRoot(rootEl).render(<StrictMode><I18nProvider messages={skillMessages}><SkillRoot /><Toaster /></I18nProvider></StrictMode>);

package/templates/file/pipeline.py.tpl

@@ -0,0 +1,11 @@
+from minus_ai_sdk import Pipeline, PipelineContext, StepOutcome
+
+
+class {{className}}(Pipeline):
+
+    async def step_1(self, ctx: PipelineContext) -> StepOutcome:
+        file_id: str = ctx.entry_params.get("fileId", "")
+        file_name: str = ctx.entry_params.get("fileName", "")
+
+        result = f"File: {file_name} (id: {file_id})"
+        return StepOutcome.complete(payload={"text": result})

package/templates/file/zh-CN.json.tpl

@@ -0,0 +1,10 @@
+{
+  "{{namespace}}.step.title": "结果",
+  "{{namespace}}.step.empty": "(空)",
+  "{{namespace}}.home.fieldLabel": "文件",
+  "{{namespace}}.home.filePlaceholder": "点击选择文件",
+  "{{namespace}}.home.fileEmpty": "请选择一个文件",
+  "{{namespace}}.home.uploadFailed": "文件上传失败",
+  "{{namespace}}.home.processing": "上传中…",
+  "{{namespace}}.home.send": "开始"
+}