前言¶
在 DeepSeek Harness（DSH）裏做 8051 / STC 相關開發時，常見做法是聊天裏描述需求，再切到 STC-ISP、串口助手、Keil 和各類小工具之間手動操作。流程分散，智能體也難以在同一宿主裏完成「體檢 → 試燒 → 真燒 → 讀選項」這類連貫步驟。dsh-mcu51（xsxll22/dsh-mcu51-plugin）把 STC UART ISP、串口調試、硬件選項、鏡像緩衝、芯片目錄以及可選 Keil 編譯等能力打包成 12 個聊天工具，面向 Windows x64 的獨立插件包，並自帶隔離 Python 運行時，不依賴系統 Python 或官方 STC-ISP / PZ-ISP。
下面按定位、工具範圍、安裝與典型用法說明；版本與限制以倉庫 README 與 Release 爲準。當前爲 0.3.0-alpha.3 實驗測試版。
這是什麼¶
- 名稱：dsh-mcu51（GitHub：
XSXLL22/dsh-mcu51-plugin） - 維護者：XSXLL22
- 分類：DSH 客戶端插件
- 平臺：Windows x64；
package.json中engines.dsh爲>=0.2.1-rc.2 <0.2.2-0，README 寫明需 DSH 0.2.1-rc.2 / 0.2.1 系列兼容宿主，未聲明支持尚未驗證的 0.2.2 系列 - 解決的問題：在 DSH 對話中調用工具完成 8051 側燒錄、串口、選項、離線資料與輔助計算，Release 含隔離 CPython 與依賴，插件執行不依賴開發工作區、官方 ISP、系統 Python 或安裝期網絡腳本
README 說明 CT107D / IAP15F2K61S2 / BSL 7.2.5S 已完成原 gs12 燒錄、冷啓動與用戶按鍵驗收；719 條芯片目錄爲離線資料，不能理解爲 719 種型號均可燒錄，細節見倉庫 VALIDATION.md。
核心功能：12 個工具¶
| 工具 | 功能 | 已驗證範圍（README 摘要） |
|---|---|---|
mcu_doctor |
隨包運行時、完整性、串口、板檔案和可選 Keil 體檢 | 枚舉/隔離運行/哈希檢查；體檢通過不等於燒錄通過 |
mcu_build |
已有 Keil C51 工程編譯和 HEX 解析 | 使用用戶安裝並授權的 Keil；不分發編譯器 |
mcu_flash |
HEX、凍結代碼鏡像或受約束 memoryApplication 燒錄 | F449/7.2.5S 原 gs12 公開工具路徑實機通過；其它型號不作同等承諾 |
mcu_chipinfo |
型號、BSL、頻率、原始 MSR 和結構化硬件選項 | F449 實機 16 字段查詢；讀取不校準或擦寫 |
mcu_options |
schema/read/plan/prepare/apply | 15 字段離線計劃；分頻 256→128→256 冷啓動持久化實測 |
mcu_catalog |
719 條官方型號記錄、主/備用 magic、容量事實 | 18 型號有手冊地址佈局，其餘未知；不會新增下載協議支持 |
mcu_image |
HEX/BIN 雙邏輯緩衝、偏移合併、導出、擦寫預覽和 prepare | 離線鏡像；F449 固定組合案例已實測，數據保留未知 |
mcu_serial |
文本/HEX、時間戳、編碼、串口幀/流控、預算、取消和 dryRun | 基本遙測實測；新幀配置主要封閉模擬 |
mcu_calc |
波特率、定時器、延時、DAC、超聲波計算 | 離線；須選對主頻、Timer 和 1T/12T 模式 |
mcu_glyph |
文本/圖片取模、掃描/位序、C 數組和 PNG | 文本用已安裝字體或用戶指定字體，不分發 Microsoft 字體 |
mcu_tone |
簡譜轉頻率、時長、C 數組 | 離線轉換 |
mcu_project |
本機工程登記與查詢 | 存儲在用戶數據目錄 |
官方 Cordis 與 dsh-tools 由 DSH 宿主提供；完整包還包含 pyserial、stcgal、Pillow 等，無需 pip 安裝。
安裝與啓用¶
環境：Windows x64、已被 Windows 識別的串口驅動、兼容的 DSH 宿主。請安裝完整 Release 包——源碼倉庫不保存運行時二進制，GitHub 自動生成的 Source code ZIP 不能直接使用。
- 從 v0.3.0-alpha.3 Release 下載完整
.tgz或.zip。 - 用 DSH 插件管理安裝
.tgz，或安裝 ZIP 解壓後的插件根目錄。 - 命令行管理時可執行（安裝命令以 README 原文爲準）：
dsh plugin --profile <你的配置名> add https://github.com/XSXLL22/dsh-mcu51-plugin/releases/download/v0.3.0-alpha.3/dsh-mcu51-0.3.0-alpha.3-win32-x64.tgz
Desktop 用戶請通過應用自帶的插件管理器安裝，避免裝到另一個 web profile。若宿主提示重啓，按正常流程重啓後檢查版本、12 個工具及 mcu_doctor 結果。安裝成功提示不能證明當前進程已加載新代碼；不要手改 generation 或 app.asar。
插件以當前 DSH 進程權限運行；安裝前可在 GitHub 查看源碼與 MIT 許可證及 THIRD_PARTY_NOTICES.md。
典型用法¶
README 給出的起步順序如下。
- 調用
mcu_doctor檢查隨包運行時和實際串口，按當前接線選擇端口。 - 對已有 HEX 先調用
mcu_flash並設置dryRun: true，覈對型號、頻率、字節數和 SHA256。 - 確認固件與目標後執行真實燒錄，再按板載下載鍵或冷啓動 MCU。端口被插件佔用時不要另開官方軟件下載。
- 查看階段確認、進程關閉和錯誤回執；需要時單獨冷啓動讀取狀態，再覈對板上功能。
參數要點（README 原文）：
expectedUid：可選的已知 7 字節 UID（14 個十六進制字符），用於 F449/7.2.5S/內部 IRC 的有界擦除應答接收；不能防止先擦錯目標，不符時停止後續編程。dryRun不覈驗實際芯片身份；應用 ID 綁定代碼/選項意圖，不能代替對實際目標和固件的確認。- 硬件選項
apply使用完整代碼重刷和重新校準，不是無損單獨寫選項；verify: true明確拒絕；實驗性clockMode: preserve尚未實機通過。
配置與運行時¶
- 數據目錄默認
~/.dsh-mcu51，可通過dataDir或環境變量DSH_MCU51_DATA指定。 - 可選配置：
defaultPort、defaultMcu、flashWaitSeconds、keilPath；端口不默認採用開發機 COM9。 - 運行時低於 Windows Medium 完整性時會報告
RUNTIME_LOW_INTEGRITY；請將完整包解壓到普通用戶應用目錄再檢查。 - 串口操作使用同用戶跨進程 OS 鎖；取消會等待子進程關閉，失敗保留部分狀態，不自動重試擦寫。
適用場景與注意¶
適合：在 Windows x64 上使用 DSH 做 STC/8051 開發、希望在同一宿主內串聯體檢、試燒、燒錄、讀選項、串口與離線計算的開發者。
注意：
- 僅 Windows x64；alpha 版能力邊界見工具表與
VALIDATION.md。 - 共享 IAP 與代碼共用 Flash；恢復代碼不等於恢復未備份數據；主機 ISP 獨立 Flash/EEPROM 讀回等仍未支持。
- 社區目錄 SkillHub 插件頁 爲獨立站點，與 DeepSeek / 幻方無官方從屬關係；生態理念是「一切皆插件」，本文不將其描述爲官方應用商店條目。
結尾¶
dsh-mcu51 把 8051 開發裏常用的 ISP、串口、選項、鏡像與輔助工具收進 DSH 的 12 個聊天工具，Release 自帶運行時，減少在宿主與外部 ISP 之間來回切換。使用前用 mcu_doctor 與 dryRun 燒錄覈對環境與鏡像，再按 README 流程實機操作。
- 目錄頁：https://www.skillhub.cn/plugins/XSXLL22/dsh-mcu51-plugin
- 倉庫與文檔：https://github.com/XSXLL22/dsh-mcu51-plugin
