前言¶
軟件著作權登記要交源程序鑑別材料、說明書、界面截圖，以及在線申請表裏一堆與項目相關的字段。內容往往已經在倉庫和文檔裏，真正耗時間的是排版合規：源程序前後各 30 頁、每頁不少於 50 行、頁眉軟件名與版本號、右上角頁碼；說明書還要目錄、標題層級和正文行距。這些規則固定，手工在 Word 裏反覆調整很容易出錯。
DeepSeek Harness（DSH）把能力拆成插件按需加載。下面介紹維護者 Lucky020 發佈的 dsh-copyright-kit（社區目錄：lucky020/dsh-copyright-kit），它在一套工具裏完成源程序 docx、說明書排版、五屏截圖、申請表填報信息推導，以及多項目批量出件。插件歸類爲工作流；GitHub 倉庫當前約 2 stars，npm 包版本 0.7.5，MIT 許可證。
這是什麼¶
dsh-copyright-kit（README 中稱「軟著工坊」）的定位是：給定「一個代碼倉庫 + 軟件全稱與版本號」，生成登記環節常用的結構化輸出——源程序 docx（60 頁規則）、說明書 docx、PNG 界面截圖、申請表填報用 Markdown，必要時一次 manifest 批量處理多個軟件。
維護者 Lucky020，源碼與說明見 GitHub。插件通過 DSH 的 Cordis patch 註冊 server 端工具；安裝後需重啓 dsh web，工具纔會註冊到當前 profile。
核心功能：六個工具¶
copyright_source_doc — 源程序鑑別材料¶
從倉庫根目錄遞歸收集源碼，自動跳過 node_modules、.venv、dist、二進制、鎖文件、隱藏目錄等；可通過 exclude 再排除目錄。總行數對應頁數少於 60 頁時全量提交，否則取前 30 頁 + 後 30 頁；每頁固定 50 行、顯式分頁符與固定行距，分頁不依賴 Word/WPS 的自動排版。頁眉爲「軟件名 + 版本號」，右上角 Word PAGE 域頁碼。返回頁數、收錄文件數、總行數、提交行數等結構化結果。
copyright_manual — 軟件說明書排版¶
先把章節內容寫成 JSON spec（sections 支持 paragraphs、bullets、steps、table、image）。調用時傳入 spec_path 與 out_path。標題自動編號，一級黑體三號、二級黑體四號；正文宋體小四、1.5 倍行距；圖片居中限寬、表格 Table Grid；頁眉與頁碼規則與源程序材料一致。toc: true 時插入目錄域，在 Word 中更新域後生效。可選 appendix_root 從代碼抽取附錄表（接口清單、數據表清單、源代碼組織）。
copyright_screens — 五屏界面截圖¶
按一份 screens spec 在同一套 UI 殼下渲染多頁，headless Chrome 輸出 2 倍高清 PNG（默認 3200×2000）。內容塊類型包括 kpis、table、list、chart、progress、form、timeline 等，用 12 柵格 span 排布；狀態文案可觸發預設配色。README 建議每屏約 3 行內容塊以填滿默認視口；內容少時可調 height。
copyright_apply_info — 申請表填報信息¶
掃描 root 倉庫與說明書 spec_path，能自動統計或推斷的字段寫入 Markdown 填報單（源程序量、文件數、語言、框架、數據庫、git 最後提交日期、面向領域與模塊等）；無法確定的項標 ⚠。功能簡介與技術特點優先使用 spec 中的 summary / tech_points，否則按模塊名與依賴棧生成草稿，供複製到在線申請表。
copyright_pack — 批量出件¶
一份 manifest 列出多個軟件各自的 root、spec、screens 等；在 out_dir 下爲每個軟件生成獨立目錄：源程序 docx、說明書 docx、申請表信息 md、screens/*.png。說明書章節未寫 image 時，可按「章節標題 === 截圖標題」自動插圖；單件失敗不影響其它條目，最後彙總成功/失敗清單。
copyright_kit_status — 環境自檢¶
生成失敗時先調用，檢查 python3、python-docx 及插件內腳本是否就緒。
安裝與依賴¶
插件要求 Node >= 22。從 npm 安裝：
dsh plugin --profile web add dsh-copyright-kit
從 GitHub 安裝：
dsh plugin --profile web add github:Lucky020/dsh-copyright-kit
本地 link 開發（改代碼即時生效）：
dsh plugin --profile web add link:/absolute/path/to/dsh-copyright-kit
裝完後重啓 dsh web。README 明確：不要同時用多種方式安裝同名插件，否則會重複註冊並報 already registered。
文檔生成依賴：
python3 -m pip install python-docx
界面截圖需要 Google Chrome（或 Chromium / Edge）；也可通過環境變量 DSH_COPYRIGHT_CHROME 指定瀏覽器可執行文件路徑。
典型用法¶
單件：源程序 docx¶
在 DSH Web 或對話中調用 copyright_source_doc，參數示例：
{
"root": "/Users/you/project/donghuan",
"software_name": "設備管理系統軟件",
"version": "V1.0",
"out_path": "/Users/you/軟著/設備管理系統軟件_V1.0_源程序.docx",
"exclude": ["tests", "migrations"]
}
路徑改爲本機絕對路徑；軟件全稱與版本號按登記材料要求原樣填寫。
單件：說明書¶
先編寫 spec JSON，再調用：
{
"spec_path": "/abs/spec.json",
"out_path": "/abs/說明書.docx"
}
README 給出篇幅配方：說明書頁數與字數、截圖張數、模塊章節數量相關；工具會返回 est_pages 與 thin（少於 20 頁）提示。能從代碼統計的內容應交給工具或 appendix_root，業務描述與甲方信息需自行在 spec 中提供，README 強調「代碼裏沒有的一律先問用戶、不要推斷後寫入正文」。
批量：copyright_pack¶
{
"out_dir": "/abs/軟著材料",
"defaults": { "version": "V1.0", "developer": "某某公司" },
"software": [
{
"name": "設備管理系統軟件",
"root": "/abs/donghuan",
"exclude": ["frontend", "docker"],
"spec": "/abs/device/spec.json",
"screens": "/abs/device/screens.json"
}
]
}
輸出目錄結構見 README：每個軟件名下源程序、說明書、申請表 md 與截圖子目錄。
適用場景與注意¶
適合誰：已有可掃描的代碼倉庫，需要按常見軟著材料格式出 docx 與截圖，並希望申請表字段儘量從倉庫與 spec 推導的團隊或個人開發者。
運行權限：插件工具在 DSH server 進程權限下讀寫 root、out_path 及調用本機 Chrome、python3。安裝前應閱讀 倉庫源碼 與 LICENSE，確認路徑與排除規則符合預期。
已知邊界：macOS Quick Look 預覽 Word 可能無法正確顯示自定義製表位與分頁，頁碼顯示異常；用 Word 或 WPS 打開正常。源程序 60 頁是按固定行數構造的分頁，與「真實打印頁」在 Finder 預覽中可能不一致，以 Word/WPS 爲準。
寫作紀律（插件 README）：軟件簡稱、首次發表日期、著作權人等僅用戶可定的字段，未提供時應待填寫，不由工具擅自定論。
結尾¶
dsh-copyright-kit 把軟著材料裏重複的排版與掃描工作收到 DSH 工具鏈裏：六個工具覆蓋源程序、說明書、截圖、申請表信息與批量打包，並帶環境自檢。社區目錄頁：https://www.skillhub.cn/plugins/Lucky020/dsh-copyright-kit；安裝說明與參數細節以 GitHub README 爲準。
