📌 重要備忘 #31

🎨 Content-Studio 優化實施計劃

📅 2026-04-09　⏱️ 11:59

content-studio .wb-config.json 多專案通用 merge-docx ideatorich

🔄 教學工作流位置

ideatorich — 構想收集

主公說「教學構想：...」→ 由貞寫入 ideatorich.docx

✅ 已存在

→

主公審核 — 審核構想

→

merge-docx — 合併更新 docx

將 ideatorich.docx 的構想段落合併進 aiworkforme.docx

⚡ 優化中

→

主公審核 — 最終確認

→

content-studio（本次優化） — HTML 預覽

將 aiworkforme.docx 轉換為完整 HTML 網站預覽

⚡ 本次優化目標

→

aiworkforme-update — 部署上線

一鍵完成：docx → HTML → 圖片處理 → 部署上線

✅ 已存在

📊 現況診斷（v0.1.0）

❌ 規劃中狀態，未完整實作

status: planning — content-studio 目前僅有框架，無實作
工作流斷裂 — 未與 merge-docx、aiworkforme-update 無縫銜接
無配置管理 — 路徑、工作目錄未標準化
功能不明確 — docx→HTML 預覽的核心功能未實作
獨立觸發 — 需手動觸發，無法自動串入工作流

🔍 參考：可配置通用技能的模式

技能	配置方式	自動偵測	版本	狀態
upload-html	.wb-config.json	✅ 自動搜尋 ./ ../ ../..	v3.0	✅ 已完成
updatememo	.wb-config.json	✅ 自動搜尋 ./ ../ ../..	v2.0	✅ 已完成
updatesk	.wb-config.json	✅ 自動搜尋 ./ ../ ../..	v2.0	✅ 已完成
delete-olddata	.wb-config.json	✅ 自動偵測所有專案	v2.0	✅ 已完成
merge-docx	.wb-config.json	✅ 自動搜尋	v2.0	⚡ 優化中
content-studio	❌ 無配置	❌ 未實作	v0.1.0	⚡ 待優化

✅ 優化方案（v1.0.0）

三大核心改進

1. 配置檔標準化 — 採用 .wb-config.json，與其他技能一致
2. 工作流完整串接 — 無縫銜接 merge-docx（輸入）+ aiworkforme-update（輸出）
3. 零參數自動執行 — 自動偵測配置檔，無需手動指定

📁 新配置檔格式

欄位	說明	預設值
project	專案名稱	aiworkforme
contentStudio.input	輸入 docx 檔（來自 merge-docx 輸出）	aiworkforme.docx
contentStudio.outputDir	HTML 預覽輸出目錄	本地臨時資料夾
contentStudio.highlightChanges	是否高亮本次變更段落	true
contentStudio.openPreview	生成後自動開啟預覽	true

配置檔範例

{
  "project": "aiworkforme",
  "contentStudio": {
    "input": "aiworkforme.docx",
    "outputDir": "C:\\Users\\Administrator\\WorkBuddy\\aiworkforme-preview",
    "highlightChanges": true,
    "openPreview": true
  }
}

🔍 自動偵測邏輯

偵測配置檔

執行時自動搜尋 .wb-config.json

偵測順序：
1. ./wb-config.json（當前目錄）
2. ../wb-config.json（上一層）
3. ../../wb-config.json（上兩層）
4. 找到即停

→

串接 merge-docx 輸出

自動讀取 merge-docx 輸出的最新版 docx

→

docx → HTML 轉換

使用 Python + python-docx 轉換為 HTML

→

生成預覽包

包含 index.html + 圖片，支援差異高亮

→

開啟預覽

自動開啟瀏覽器供主公檢視

🔗 工作流串接設計

環節	上游（輸入）	下游（輸出）	自動化程度
merge-docx → content-studio	ideatorich.docx → aiworkforme.docx	最新版 aiworkforme.docx	★★★ 完全自動
content-studio → aiworkforme-update	aiworkforme.docx	HTML 預覽包	★★★ 完全自動

觸發方式

觸發方式	說明	自動化程度
「執行 content-studio」	直接執行，使用配置檔自動偵測	★★★ 完全自動
「預覽網站效果」	自然語言觸發	★★★ 完全自動
「生成 HTML 預覽」	從 merge-docx 完成後自動觸發	★★★ 完全自動

📊 升級對比：v0.1.0 vs v1.0.0

❌ v0.1.0（規劃中）

status: planning
無實作程式碼
無配置管理
工作流斷裂
需手動觸發
功能不明確

✅ v1.0.0（優化後）

status: active
完整 docx→HTML 功能
.wb-config.json 配置
merge-docx 無縫串接
零參數自動執行
支援差異高亮預覽

📋 實施清單

⚡ content-studio v1.0.0 建置清單

更新 SKILL.md 頂部 metadata（version → 1.0.0, status → active）
新增 .wb-config.json 配置檔偵測邏輯
實作 docx → HTML 轉換核心功能
串接 merge-docx 輸出（自動讀取最新版 aiworkforme.docx）
支援差異高亮（本次變更段落 Highlight）
生成本地預覽包（index.html + 圖片）
自動開啟瀏覽器預覽
串接 aiworkforme-update（預覽確認後一鍵部署）
建立 .wb-config.json 範本
更新觸發關鍵字（零參數觸發）

📚 參考文檔

文檔	用途	路徑
15-teachflow-framework.html	工作流設計框架	`C:\Users\Administrator\WorkBuddy\wh-all-deploy\`
30-merge-docx-optimization.html	merge-docx 優化模式參考	`C:\Users\Administrator\WorkBuddy\工作備忘\`
upload-html v3.0 SKILL.md	.wb-config.json 配置模式	`C:\Users\Administrator\.workbuddy\skills\`