T4: Markitdown adapter——docx/pptx/pdf 轉檔 + 原檔進 assets/originals(design §4)
transform.js:MARKITDOWN_EXT(docx/pptx/pdf)走 markitdown CLI 子行程轉出 md,輸出路徑 副檔名換 .md;回傳 originalCopy 供 index.js 把原檔複製進 assets/originals/<相對路徑>。 git-sync.js:ensureGitAttributes() 啟動時冪等寫入 LFS 宣告(三種格式 filter=lfs)。 已驗(雲端 sandbox,兩輪煙測):用 python-docx 生真實 docx(含標題+段落)丟進 watch 資料夾, collector 呼叫 markitdown 轉出真實 md 內容(人工核對與原檔一致)、原檔複製進 assets/originals/、.gitattributes 正確含三種格式 LFS 宣告、commit+push 送達 bare remote。 誠實邊界:sandbox 無 git-lfs 二進位,驗不到真實 LFS smudge/clean filter 生效(只驗到 .gitattributes 內容正確);真實 Gitea remote push/憑證、真實客戶檔案樣本仍待本機/客戶環境。 其餘格式(xlsx/圖片)不在第一波承諾範圍,仍誠實丟 NotImplementedError。
This commit is contained in:
+20
@@ -1,5 +1,24 @@
|
||||
const fs = require('fs');
|
||||
const path = require('path');
|
||||
const { execFileSync } = require('child_process');
|
||||
|
||||
// design.md §4「原檔進 LFS」:assets/originals/ 底下的常見二進位格式走 git-lfs。
|
||||
// ⚠️ 這裡只寫 .gitattributes 宣告(冪等、不重複寫)——LFS 是否真的生效取決於部署機器
|
||||
// 有沒有裝 git-lfs 並 `git lfs install`;雲端 sandbox 沒有 git-lfs 二進位,只能驗到
|
||||
// .gitattributes 內容正確,驗不到真實 LFS smudge/clean filter,見 README「待本機驗」。
|
||||
const LFS_PATTERNS = ['assets/originals/**/*.pdf', 'assets/originals/**/*.docx', 'assets/originals/**/*.pptx'];
|
||||
|
||||
function ensureGitAttributes(repoDir) {
|
||||
const gaPath = path.join(repoDir, '.gitattributes');
|
||||
const existing = fs.existsSync(gaPath) ? fs.readFileSync(gaPath, 'utf8') : '';
|
||||
const missing = LFS_PATTERNS.filter((p) => !existing.includes(p));
|
||||
if (missing.length === 0) return false;
|
||||
const lines = missing.map((p) => `${p} filter=lfs diff=lfs merge=lfs -text`);
|
||||
const next = existing.length && !existing.endsWith('\n') ? `${existing}\n` : existing;
|
||||
fs.writeFileSync(gaPath, next + lines.join('\n') + '\n', 'utf8');
|
||||
return true;
|
||||
}
|
||||
|
||||
/**
|
||||
* target repo 的 git add/commit/push 封裝(design.md §4:git commit/push 觸發既有
|
||||
* Gitea push webhook → ingest workflow;本模組不打任何 ingest HTTP 端點)。
|
||||
@@ -9,6 +28,7 @@ class GitSync {
|
||||
this.repoDir = config.targetRepoDir;
|
||||
this.authorName = config.gitAuthorName;
|
||||
this.authorEmail = config.gitAuthorEmail;
|
||||
ensureGitAttributes(this.repoDir);
|
||||
}
|
||||
|
||||
_git(args) {
|
||||
|
||||
Reference in New Issue
Block a user