UnoPim Field Guide / v1.0.0 / Edited 2026
Open Source · Laravel 12 · MIT License · GitHub 9.3k ★

UnoPim —
把產品目錄
交給 Agentic AI 免費、開源、可自架,從 PIM 進化為對話式產品管理

UnoPim 是建構於 Laravel 12 的開源產品資訊管理(PIM)系統, 由印度 Webkul 維護。它最大的特點,不是「又一個 PIM」,而是把 32+ 種產品操作 包裝成可對話的 AI agent ── 你輸入「把上週上架的所有藍色 T-Shirt 翻譯成日文」, 系統就會自己拆解、執行、寫入版本紀錄。本指南濃縮安裝、教學、社群實戰、Prompt 設計 與競品比較,是繁體中文圈目前最完整的 UnoPim 入門讀本。

9.3k
GitHub Stars
10M+
產品規模驗證
32+
AI 可執行動作
10+
LLM 廠商支援
01 / 概念
先把名詞釐清

什麼是 PIM?
UnoPim 又特別在哪?

PIM(Product Information Management)是「產品資訊管理」系統。簡單說,它是專門用來集中管理產品資料(標題、描述、規格、圖片、屬性、多語言版本、多通路內容)的中央倉庫。

典型場景:你的電商同時上 Shopify、蝦皮、Amazon、自架站,每個通路欄位規格不同,又要支援中、英、日三種語言。沒有 PIM 時,這些資料散落在 Excel、雲端硬碟和各通路後台,更新一筆就要四處改五次。PIM 就是這團混亂的單一可信來源(Single Source of Truth)。

UnoPim 的差異化不在「做 PIM」,而在「把 PIM 從一張資料表,變成一個可以對話的同事」。

UnoPim 從 v1.0.0(2025/11 推出)開始,被官方重新定位為 Agentic PIM。它把產品建立、批次編輯、分類、翻譯、圖片生成、匯入匯出等動作,全部包裝成 AI agent 的可呼叫工具。

你不再需要點開 32 個選單。打一句「把所有沒有德文描述的鞋類產品補上德文翻譯,並交給我審核」,Agentic PIM 會自動搜尋符合條件的產品、呼叫翻譯 agent、產生草稿,然後等你按 OK。

更關鍵的是:它支援 10+ 種 LLM 廠商(OpenAI、Anthropic Claude、Google Gemini、Groq、自架 Ollama 等),可依任務分配不同模型、設定每日預算上限,並把所有對話存成可稽核的 session 紀錄。

02 / 環境
動工前先檢查

系統需求
與最低配置

Web Server
Nginx 或 Apache2
必要
RAM
至少 8 GB(生產環境建議 16 GB+)
必要
PHP
8.2 或更新版本
必要
Composer
2.5 或更新版本
必要
Node.js
18.17.1 LTS 或更新版本
必要
MySQL
8.0.32 或更新版本
擇一
PostgreSQL
14.x 或更新版本(大型目錄建議使用)
Redis / Elasticsearch
Docker 預設組合會帶起來;自架時用於快取、佇列、搜尋
AI Provider Key
OpenAI / Anthropic / Gemini / Groq / Ollama(擇一啟用 AI agent 功能)
選用
03 / 功能
十一項核心能力

UnoPim 能做
哪些 日常工作

/ 01 集中管理

Centralized Product Catalog

產品、屬性、家族、分類、媒體一站式管理,10M+ 產品規模實測通過。

/ 02 資料豐富化

Data Enrichment

支援自訂屬性、屬性家族、產品完整度分數(completeness score)追蹤。

/ 03 Magic AI

AI 內容生成

10+ LLM 廠商可選,產品文案、圖片、Alt-text、翻譯一鍵生成並可審核。

/ 04 多語言

Localization

原生多 locale 架構:每個屬性可設定 per-locale、per-channel 兩個維度。

/ 05 多通路

Multi-Channel

同一商品在 web/mobile/app/marketplace 可有不同描述、價格、媒體素材。

/ 06 多幣別

Multi-Currency

跨國銷售必備;可與 Shopify、Bagisto connector 雙向同步。

/ 07 匯入匯出

Import / Export

CSV / XLSX 大檔匯入;背景 job 處理;即時進度追蹤儀表板。

/ 08 RESTful API

API & MCP

完整 REST API、官方 PHP client、官方 Postman collection、社群 MCP server。

/ 09 權限

User Management

角色制權限;AI agent 工具可依角色開關(避免實習生誤觸刪除類動作)。

/ 10 版本控制

Version Control

所有產品資料變更皆有歷史紀錄,可回溯誰在何時改了哪個欄位。

/ 11 UI

Light / Dark Theme

Vue.js + TailwindCSS 介面,支援亮暗兩色主題切換。

/ 12 webhooks

Outgoing Webhooks

產品更新時非同步觸發外部系統;專屬 webhooks queue 避免阻塞主流程。

04 / Agentic
v1.0.0 的核心升級

Agentic PIM
是怎麼運作的?

Agentic PIM 不是「在後台加一個 ChatGPT 視窗」。它是一組 專業化分工的 AI agent 團隊, 每個 agent 負責一片業務,由協調者根據你的指令自動分派任務。

五位 Agent 各司其職

你不需要直接指名某位 agent ── 只要對 Agentic PIM 說話,系統會自動把任務送到對的人手上。

[ P ]
Product Agent

建立、更新、搜尋、刪除產品。最常打交道的 agent。

[ C ]
Content Agent

寫產品文案、生成行銷圖、處理 Alt-text 與多語翻譯。

[ T ]
Taxonomy Agent

維護分類樹、屬性、家族 ── 底層結構的守護者。

[ B ]
Bulk Agent

處理一次幾百筆的批次任務,把整個下午的工作壓到幾分鐘。

[ I ]
Insight Agent

回答「目前狀況如何」、抓出沒人發現的缺漏、產生稽核報表。

支援的 LLM 廠商(你可以混搭)

寫作用 OpenAI、推理用 Claude、隱私敏感任務用本地 Ollama ── Agentic PIM 不綁定單一模型。

OpenAI
Anthropic Claude
Google Gemini
Groq
Ollama(本地)
DeepSeek
Mistral
xAI Grok
Custom / OpenAI-compatible

三種運作模式(從保守到自動)

Review-only Mode(預設)

Agent 只產生「建議」,不寫進資料庫。所有變更需人類審核。新團隊或重要 SKU 強烈建議從這個模式開始。

Confirm Mode

Agent 顯示「我要這樣改」,按下 OK 才會執行。介於完全人工與全自動之間,適合熟悉後的日常作業。

Auto-apply Mode(非預設)

Agent 直接寫入;所有動作仍記錄於 session 並可回滾。適合明確 SOP、低風險的重複性工作(如圖片 Alt-text 補齊)。

05 / 安裝
三條路徑,挑一條走

從零到能
用的 15 分鐘

需求:Docker + Docker Compose v2+。整個流程約 5 分鐘,最後等待約 90 秒讓資料庫首次 migration 跑完。

01
Clone 並進入專案

把 UnoPim 從 GitHub 抓下來,切到 master 分支即可。

$ git clone https://github.com/unopim/unopim.git
$ cd unopim
02
複製 Docker 用的環境變數

UnoPim 提供專屬於 Docker 的 .env.docker,複製成正式 .env 即可。

$ cp .env.docker .env
03
啟動所有容器

會自動拉取 MySQL、Redis、Elasticsearch、PHP-FPM、Nginx、Queue worker 等 image。

$ docker compose up -d

提示:本機已有 MySQL/Redis/Elasticsearch 跑著時,記得改 .env 裡的 FORWARD_* port,再重啟。

04
等 90 秒,然後登入

首次啟動會跑 migration + seeder,請耐心。

# 開啟瀏覽器
http://localhost:8000/admin

# 預設帳密
帳號: admin@example.com
密碼: admin123

適合想自架 PHP/Nginx/資料庫的開發者。請先確認系統需求區塊列出的所有版本都裝好。

01
用 Composer 建立專案
$ composer create-project unopim/unopim
$ cd unopim
02
跑 UnoPim 安裝程式

這個指令會引導你設定資料庫連線、預設管理員、locale、channel 等。

$ php artisan unopim:install
03
啟動本機開發伺服器
$ php artisan serve

→ 開啟 http://localhost:8000

04
啟動 Queue Worker(重要)

匯入匯出、AI agent 任務、完整度計算、webhook 都依賴佇列。如果忘記啟動,這些功能會卡住不動

$ php artisan queue:work \
    --queue=webhooks,system,default,completeness

生產環境:請用 Supervisor / systemd 守護這個程序,避免閃退後沒人發現。

沒時間搞環境?UnoPim 在 AWS Marketplace 提供官方 AMI,一鍵起一台機器就能用。

01
到 AWS Marketplace 訂閱 AMI

免額外授權費,只付 AWS 機器費用。

# 入口
https://aws.amazon.com/marketplace/pp/prodview-fdyosdv7k3cgw
02
選擇 EC2 規格

測試或概念驗證:t3.large 起步;生產環境建議 m5.xlarge 以上,並把資料庫拆到 RDS。

03
啟動後直接訪問

AMI 已包含 Nginx、PHP、MySQL、Redis、UnoPim 本體。SSH 進去拿初始密碼後即可登入。

06 / 社群
Reddit、GitHub、開發者部落格的真實聲音

社群在
用什麼

UnoPim 在 Reddit 沒有專屬子版,討論散落於 r/laravel、r/selfhosted、r/ecommerce 與獨立部落格的比較文。 以下整合 AtroPIM 對比文、UnoPim 官方分享、第三方開發者實踐,篩出最有實戰價值的技巧、Hack 與使用案例。

/ HACK 成本控制 · LLM 預算

用 Groq 或本地 Ollama 把 AI 成本壓到「一天一杯咖啡都不到

官方部落格實測:使用 Groq 或自架 Ollama 模型時,許多團隊每天執行數百筆 agent 操作,總成本不到 1 美金。

關鍵設定:到後台 → AI Platform → 設「每日 token 預算上限」。當天用完就自動停手,不會在你睡覺時把信用卡刷爆。

/ Source:unopim.com/agentic-pim
/ TIP 隱私 · 資料主權

敏感目錄(醫材、軍工、未上市新品):全程跑 Ollama 本地模型

Agentic PIM 每次只送出單一任務所需的 prompt,但若連這層都不放心,可把 AI Provider 換成本機 Ollama。

實務:qwen3:14b 在 Q4_K_M 量化下約 7-8GB VRAM 即可跑,工具呼叫 F1 接近 GPT-4。

/ Source:開發者實戰文 · mem0-mcp-selfhosted
/ USE CASE 跨境電商

把 UnoPim 當「ChatGPT Search 的產品 Feed 來源」

社群釋出的 UnoPim AI Product Feed for ChatGPT 模組,能自動產生符合 OpenAI 規格的 TSV / JSON 產品 feed,讓 ChatGPT 購物搜尋直接索引你的目錄。

Feed URL 由 admin 後台產生的密鑰保護,不會被外部爬蟲意外抓走。

/ Source:unopim.com/extensions
/ HACK Claude Desktop 整合

裝社群版 MCP Server,直接在 Claude Desktop 內喊「@UnoPim」

開發者 oledmansfeld 釋出第三方 MCP Server,把 UnoPim 包成 Claude Desktop 可用的工具:「@UnoPim 幫我用 SKU TSH-01 在 apparel family 建一件藍色 T 恤」

支援 HTTP/SSE(透過 ngrok 遠端存取)、OAuth2 自動 token refresh、可配置產品變體與媒體上傳。

/ Source:glama.ai · @oledmansfeld/unopim-mcp
/ TIP 佇列穩定性

別忘了 webhooks queue ── 不然 webhook 永遠不會送出

UnoPim 的 webhook listener 是異步派發的,所有外送請求都堆在 webhooks queue。如果 queue:work --queue= 沒列入它,webhook 事件會永遠卡在資料庫。

正確指令:--queue=webhooks,system,default,completeness

/ Source:GitHub README · unopim/unopim
/ USE CASE 客觀評估

適合誰、不適合誰:來自第三方比較文的誠實意見

AtroPIM 對比四大開源 PIM 的結論直白:UnoPIM 適合「需求單純、不預期資料複雜度大幅成長」的中小企業。

需要欄位級權限、複雜審批工作流、API-first 無代碼資料模型的大型製造商,AtroPIM 或 Pimcore 仍是更安全的選擇。

/ Source:atropim.com · open-source-pim 比較文
/ TIP 批次任務排程

用 cron 跑指定 Job ID,把 AI 補資料變成夜間自動化任務

UnoPim 有專屬指令可從終端機指定執行某個 job:php artisan unopim:queue:work {JobId} {userEmailId}

搭配 crontab,每小時自動跑「補齊缺漏屬性」或「翻譯新上架商品」,早上來就看到結果。

/ Source:webkul.com/blog/jobs-via-terminal
/ USE CASE 當迷你 ERP 用

把 UnoPim 當「供應商 → 通路」的中繼資料層

官方分享的客戶實踐:產品先從供應商進入 UnoPim 完整化,再分送到 Shopify、Bagisto、自架站。UnoPim 等於變成迷你 ERP 的產品模組。

第一印象是它快、能輕鬆處理大量產品,而且 UnoPIM 的開發團隊真的很厲害。

/ Source:unopim.com 客戶見證
07 / Prompt
設計能被 Agentic PIM 正確執行的指令

Prompt 設計
範例輯錄

Agentic PIM 是「多步驟工具呼叫」型 agent,越具體的 prompt 越能精準觸發對的工具。以下五個範例涵蓋從產品建立、批次操作、跨語言翻譯、品質稽核到圖片生成,是日常 PIM 工作最常見的場景。

慣例:{{variable}} 為變數、[tool] 為 agent 自動觸發的工具呼叫。

/ 01

建立新產品(含變體)

難度 · 入門
PROMPT
{{apparel}} 家族下建立一個新的可配置產品:
- 名稱:{{Linen Summer Shirt}}
- 主 SKU:{{LSS-2026-001}}
- 變體:顏色 × 尺寸(白/米/海軍藍 × S/M/L/XL)
- 預設 channel:{{web_tw}}
- 預設 locale:{{zh_TW}}
- 完成後請列出所有 12 個變體 SKU,等我確認再寫入資料庫。
EXPECTED FLOW
Product Agent 觸發 [search_family] 確認 apparel 存在 → 觸發 [create_configurable_product] → 自動展開 12 個變體 SKU(如 LSS-2026-001-WT-S)→ 進入 Confirm Mode 等待人工核可。
/ 02

批次翻譯到多語言

難度 · 中
PROMPT
把以下條件的產品,描述(description)翻譯成
日文(ja_JP)與韓文(ko_KR):

- 分類:{{footwear/sneakers}}
- 建立時間:{{2026-04-01}} 之後
- 條件:目前沒有 ja_JP 或 ko_KR 的 description

翻譯時請:
1. 保留品牌名稱(如 Nike、adidas)原文不譯
2. 鞋款型號(如 Air Max 90)保留英文
3. 風格偏品牌官網語調,不要太口語
4. 完成後彙整數量,不要直接寫入,先給我預覽前 5 筆
EXPECTED FLOW
Bulk Agent + Content Agent 協作 → [search_products] 條件過濾 → [check_locale_coverage] 找出缺翻譯的項目 → [translate_attribute] 逐筆生成 → 回傳前 5 筆給你預覽。
/ 03

圖片 Alt-text 自動補齊

難度 · 入門
PROMPT
幫所有 {{en_US}} locale 下、
缺少 Alt-text 的產品主圖補上描述:

- 風格:簡潔、SEO 友善、35 字以內
- 句型:「[品名] in [顏色/材質],[最關鍵特色]」
- 不要使用「圖片中可以看到…」這類冗詞
- 完成後一次寫入(Auto-apply,這是低風險動作)
EXPECTED FLOW
Content Agent 觸發 [vision_describe_image] 逐圖分析 → 套用句型模板 → [write_alt_text] 寫入 → session 紀錄全部變更,可隨時回滾。
/ 04

產品完整度稽核

難度 · 中
PROMPT
幫我做一份「上週需處理清單」:

1. 在 {{web_tw}} channel 中,completeness score < 70% 的產品
2. 依完整度低到高排序
3. 列出每筆缺哪些必填屬性(含 locale)
4. 若超過 50 筆,只列出對營收最重要的(依過去 30 天瀏覽量)
5. 輸出格式:Markdown 表格,能直接貼進 Slack

只給報告,不要動任何資料
EXPECTED FLOW
Insight Agent 觸發 [query_completeness_score][cross_ref_analytics] 結合瀏覽量 → 用 Markdown 表格輸出 → 不寫入任何欄位,純報告模式。
/ 05

產品圖生成(Studio-quality)

難度 · 進階
PROMPT
為 SKU {{LSS-2026-001-NV-M}}
(海軍藍 M 號麻質襯衫)生成 4 張產品圖:

風格規範:
- 場景:自然光、極簡白色 cyclorama 背景
- 角度:正面 / 側 45° / 背面 / 領口特寫
- 解析度:2048×2048,PNG
- 模特兒:不要有人物,純衣物展示(hanger 或浮空)
- 整體調性:日系極簡、無過度後製感

生成後:
1. 自動產生 4 張對應的 Alt-text
2. 上傳到該產品的 media gallery
3. 設定第一張為主圖
4. 寫入前讓我看 preview
EXPECTED FLOW
Content Agent 呼叫圖片生成 LLM(如 OpenAI DALL-E、Gemini Imagen)→ [generate_product_image] × 4 → [write_alt_text] 自動產生 → [stage_media_upload] 暫存 → 進入 Confirm Mode 顯示縮圖等核可。
08 / 比較
四大開源 PIM 平台速覽

UnoPim vs
競品對照

UnoPim AtroPIM Pimcore CE Akeneo CE
技術棧 Laravel 12 / Vue.js AtroCore / API-first Symfony / Twig Symfony / React
內建 AI Agent ✓ 原生(v1.0+) 需第三方 需第三方 需第三方
欄位級權限 僅基本角色 ✓ 完整 ✓ 完整 僅基本角色
無代碼資料模型 需開發 ✓ 完整 no-code 部分 部分
DAM/MDM/CMS DAM 模組可選 DAM 內建 ✓ 全部內建 僅 PIM
適合規模 SMB → 中型 (10M+ 已驗證) 中型 → 大型 大型 / 企業 小型(CE 自 2023 停止新功能)
入門曲線 高(需顧問導入)
授權 MIT GPL v3 POCL / GPL v3 雙授權 OSL v3

/ 結論   若你的痛點是「產品文案、翻譯、圖片要不斷重做」,UnoPim 的 Agentic 路線目前在開源圈獨樹一格。 若你的痛點是「複雜的資料模型、欄位級權限、跨企業流程」,AtroPIM 或 Pimcore 仍是更穩的選擇。

剩下的,
就是 動手 安裝它。

UnoPim 是 MIT 授權的開源軟體。把它跑起來、把第一個產品丟進去、對它說一句中文 ── 你會立刻知道 Agentic PIM 是不是你下一個 stack 的成員。