# 供應端工作台：技能書與協作來源

在自己的電腦查看工坊商品與供貨申請。

## 工坊收錄說明

供貨與商店

已在工坊供貨的人，以及協助整理資料的開發者。

一份只讀取自己資料的供貨檢視。

搭配供貨中心查看自己的商品；刊登、改價與供貨決定仍回網站處理。

先讀準備步驟，再由本人核准自己的供應端讀取連線。

## 封面與來源署名

封面插畫：/art/skills/supplier-client.webp

原作者 GitHub：https://github.com/FreeTWAI/freedom-supplier-client

登入自由工坊並連結自己的 GitHub，即可在技能書加星或取消星星。

原作數據：/api/v1/github/books/supplier-client/metrics

Stars、Forks、追蹤數、未結 Issues 與 PR 合計、最近程式更新時間以 GitHub 回覆為準；數據附核對時間，讀取失敗不冒充零。

## 讀者與格式

讀取客戶端

- 已刊登商品的供貨者

- 想改造自己供應端介面的開發者

## 功能與使用範圍

可連中央平台讀取自己的資料；刊登、改價與供貨決定仍在網站完成，沒有寫入或付款權限。

- 一次性代碼核准供應端讀取

- 商品、供貨申請與連線狀態 JSON

- 本機私人憑證保存與網站撤銷

## 開始前準備

- Node.js 24

- 自由工坊會員已完成定位，供貨中心已有自己的商品與供貨條件

## 第一個練習

1. 先在供貨中心整理商品和供貨條件。

2. 執行 npm run connect，複製終端顯示的代碼；到「我的名片」貼進「客戶端一次性代碼」，核對名稱與供應端讀取範圍後核准。

3. 讀取自己的商品，挑一個欄位整理成私人商品檢視；資料不放公開 GitHub。

## 練習成果

一份能讀回自己商品與申請的私人供應端檢視。

## 原始專案的起步指令

在自己的專案副本根目錄執行；指令已對照收錄版本的說明，這次介紹核對沒有代為安裝或執行。

```sh
npm ci --ignore-scripts
npm test
npm run connect
npm run read -- products
```

## 專案與授權

原作 Repo：https://github.com/FreeTWAI/freedom-supplier-client
從原作建立自己的版本：https://github.com/FreeTWAI/freedom-supplier-client/fork
工坊整合參考：https://github.com/FreeTWAI/freedom-supplier-client
記錄的授權：NOASSERTION

## 一起改這本技能書

改善私人商品檢視與錯誤提示；保留中央資料權限與讀取範圍。

原作 Repo：https://github.com/FreeTWAI/freedom-supplier-client
預設 PR 目標：FreeTWAI/freedom-supplier-client:main
從原作建立自己的版本：https://github.com/FreeTWAI/freedom-supplier-client/fork
原作 PR：https://github.com/FreeTWAI/freedom-supplier-client/pulls

工坊整合參考：https://github.com/FreeTWAI/freedom-supplier-client
工坊整合任務專用 Fork：https://github.com/FreeTWAI/freedom-supplier-client/fork
工坊任務：https://github.com/FreeTWAI/freedom-supplier-client/issues
工坊 PR：https://github.com/FreeTWAI/freedom-supplier-client/pulls
GitHub Milestones：https://github.com/FreeTWAI/freedom-supplier-client/milestones

先閱讀原作現行的貢獻規則。Fork 不會自動回饋原作；修改要以 PR 提交，由原作維護者決定是否合併。工坊整合任務可在工坊審查，另外記錄回饋原作的 PR 或未回送原因。

以下是入口與建議，不代表已認領或已完成。以 GitHub 最新 Issue、PR 與維護者確認為準。

- 第一份可重用的共同成果（建議里程碑）：提交可重現案例、來源與驗證結果，由維護者審查；這是建議里程碑，尚未建立為 GitHub milestone。

### 補供貨讀取的失敗提示 · 建議任務

只改供應端 client 的憑證撤銷、連線失敗或商品空狀態。

- 驗收：用合成回應覆蓋失敗與重試，不擴大讀取權限或把私人商品寫入 Git。

Agent Skill：/development/skills/supplier-client/SKILL.md
協作 JSON：/api/v1/skills/supplier-client/collaboration

## 參與開發

改善私人商品檢視與錯誤提示；保留中央資料權限與讀取範圍。

工坊 Issue／PR 協調入口：https://github.com/FreeTWAI/freedom-supplier-client/issues

先讀該 Repo 根目錄 README.md、AGENTS.md、CONTRIBUTING.md；原始程式、測試及來源授權留在該專案。平台介紹與公會收錄則在 freedom-platform 的 modules/community 維護。

要改善平台介紹：https://github.com/FreeTWAI/freedom-platform/issues

## 閱讀與來源

閱讀原始專案：https://github.com/FreeTWAI/freedom-supplier-client/blob/53fd5b0ac4a1b67ccd71a8cc4ba092ea15bb3534/README.md
核對日期：2026-09-27
核對版本：53fd5b0ac4a1b67ccd71a8cc4ba092ea15bb3534

- README.md：https://github.com/FreeTWAI/freedom-supplier-client/blob/53fd5b0ac4a1b67ccd71a8cc4ba092ea15bb3534/README.md

- package.json：https://github.com/FreeTWAI/freedom-supplier-client/blob/53fd5b0ac4a1b67ccd71a8cc4ba092ea15bb3534/package.json

## 共創原則

GitHub Issue 是待辦與協調來源，PR 是審查與合併紀錄。先確認任務範圍，再用自己的分支完成相關驗證；保留上游與實際貢獻者。Fork 不等於平台認證、已測試運行或新授權。

完整結構化目錄：/api/v1/development-map