# 光影與光雕製作手冊：技能書與協作來源

把投影光雕構想整理成場勘、畫面分區、素材規格與播放 cue。

## 工坊收錄說明

內容與行銷

光雕與投影設計者、燈光與影像技術夥伴、展演視覺創作者。

一份可交接的光雕製作提案：場勘紀錄、畫面配置與播放 cue 表。

在光影光雕公會分享原創模板、討論待辦，透過 Fork／PR 留下可重用成果。

複製 templates/site-survey.md，記錄表面尺寸、環境光、觀眾位置與設備限制。

## 封面與來源署名

封面插畫：/art/skills/projection-mapping.webp

原作者 GitHub：https://github.com/FreeTWAI/freedom-skill-projection-mapping

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

原作數據：/api/v1/github/books/projection-mapping/metrics

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

## 讀者與格式

實作手冊與模板

- 光雕與投影設計者

- 燈光與影像技術夥伴

- 展演視覺創作者

## 功能與使用範圍

先做提案、素材與播放排程；不包含硬體控制、實際投影校正或現場技術認證。

- 場勘與投影表面配置

- 素材來源與播放 cue 清單

- 素材引用與 cue 結構檢查

## 開始前準備

- 投影表面、觀看距離、環境光與場地可用時段

- 可用投影機與播放設備的已確認规格或待查項目

- 原創或獲授權的素材及輸出尺寸、幀率、長度

## 第一個練習

1. 複製 templates/site-survey.md，記錄表面尺寸、環境光、觀眾位置與設備限制。

2. 用 templates/surface-map.md 為每個投影區域命名，附原創線框示意與對應尺寸。

3. 在 templates/cue-sheet.csv 列出 cue、素材檔名、觸發時點、操作角色與黑場備援。

4. 填 templates/projection-plan.json，執行驗證，排除重複 cue 與未列入清單的素材。

5. 現場試播另留紀錄；只有實際量測與播放才標完成，提案測試不算現場驗收。

## 練習成果

一份可交接的光雕製作提案：場勘紀錄、畫面配置與播放 cue 表。

## 專案與授權

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

## 一起改這本技能書

從 BACKLOG.md 選一項模板或合成案例改善，以 Fork／PR 附實測結果一起完成。

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

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

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

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

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

### 補一個桌上光雕的校準範例 · 建議任務

用自有小模型規劃投影面、遮罩、對位與播放 cue。

- 驗收：每段 cue 有輸入輸出、校準方法與授權素材來源；現場條件需另驗。

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

## 參與開發

從 BACKLOG.md 選一項模板或合成案例改善，以 Fork／PR 附實測結果一起完成。

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

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

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

## 閱讀與來源

閱讀原始專案：https://github.com/FreeTWAI/freedom-skill-projection-mapping/blob/4d43669501aabbaf329989d32e4e404a80f1a539/SKILL.md
核對日期：2026-09-23
核對版本：4d43669501aabbaf329989d32e4e404a80f1a539

- SKILL.md：https://github.com/FreeTWAI/freedom-skill-projection-mapping/blob/4d43669501aabbaf329989d32e4e404a80f1a539/SKILL.md

- README.md：https://github.com/FreeTWAI/freedom-skill-projection-mapping/blob/4d43669501aabbaf329989d32e4e404a80f1a539/README.md

- BACKLOG.md：https://github.com/FreeTWAI/freedom-skill-projection-mapping/blob/4d43669501aabbaf329989d32e4e404a80f1a539/BACKLOG.md

## 共創原則

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

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