前言¶
在 DeepSeek Harness（DSH）裏做智能體時，常見做法是單獨配置 API Key，或讓模型自己發 HTTP 請求。圖像、視頻生成往往走另一套賬號體系：OAuth 登錄在 Host 側，對話模型也未必就是 Grok 或 GPT。若希望智能體在工具層直接調用「當前桌面已登錄賬號」的生圖、生視頻能力，而不是把 token 塞進對話或讓模型 curl，就需要 Host 插件把憑證續期、下載校驗和落盤策略接在一起。shengcheng 插件面向的就是這一路徑。
這是什麼¶
shengcheng 是維護者 yueyexiayu 發佈的 DSH 桌面插件，分類屬於模型推理。它通過 DSH 裏已經登錄的 Grok / GPT 賬號調用遠端圖像生成接口；Grok 側還支持視頻生成。是否可用取決於遠端接口是否接受該賬號及權限——對話 OAuth 成功並不保證生成接口一定可用。插件只從 Host 讀取 $DSH_HOME/.credentials.yaml 中的 llm-pi-ai/xai、llm-pi-ai/openai-codex，token 不會進入對話上下文。
- Grok：
grok-imagine-image-2.0生圖，grok-imagine-video-1.5生視頻 - GPT：
gpt-image-2生圖（Codex 賬號接口；README 註明尚未完成真實賬號驗收）。本插件不提供 GPT 視頻生成
社區目錄頁：yueyexiayu/dsh-shengcheng（SkillHub 爲獨立社區站點，與 DeepSeek / 幻方無官方從屬關係）。源碼與說明見 GitHub。當前 package 版本爲 0.1.1。
核心功能¶
工具只有一個：shengcheng。默認 kind=image；視頻需 kind=video，且僅 Grok 支持，指定 provider=gpt 會直接報錯。
生成結果默認寫到會話工作目錄；沒有工作目錄時寫到下載文件夾。新版展示組件 zhanshi 優先讀取結構化結果 shengcheng_result {"path":"…"}，完整保留空格、引號和中文路徑；同時兼容舊版 saved … 首行協議。
provider=auto 時：若當前對話是 Grok 或 GPT，則用對應賬號；否則優先 Grok，再否則 GPT。插件不讀取 ~/.grok/auth.json / ~/.codex/auth.json。
憑證續期在 DSH 共享憑證鎖內完成；等待期間換號或退出不會被舊續期覆蓋。生成文件僅通過 HTTPS 下載，下載請求不攜帶賬號憑證。文件後綴跟隨實際格式（例如請求 image.png 但服務端返回 JPEG 時保存爲 image.jpg）。取消、超時會中止請求與視頻輪詢；併發保存不會覆蓋已有文件。
安裝與啓用¶
安裝方式爲複製插件目錄並在 desktop profile 中插入 Cordis 補丁，README 未提供 dsh plugin add 一類命令。
1、將項目複製到 $DSH_HOME/plugins/shengcheng。
2、在 $DSH_HOME/profiles/desktop/cordis.patch.yml 寫入：
- insert:
- id: shengcheng
name: ../../plugins/shengcheng/lib/index.js
3、安裝 FFmpeg，且 PATH 中同時能啓動 ffmpeg 與 ffprobe（macOS 示例：brew install ffmpeg）。插件在付費生成前會實際啓動兩程序；缺失或啓動失敗會直接報錯。
4、在插件源碼目錄安裝依賴（遵循 pnpm@11.7.0）：
pnpm install --frozen-lockfile
5、完全退出 DeepSeek Harness（macOS：⌘Q）再打開，並新開會話。僅刷新頁面或改磁盤源碼不會替換當前 Host 已加載的實現。
OAuth 續期使用官方 @earendil-works/pi-ai@0.87.1 實現；Grok / GPT 續期路徑不依賴其他 provider 的安裝腳本。
典型用法¶
1、在 DSH 輸入框下方用 OAuth 插件登錄 Grok 或 GPT（Codex）賬號。
2、在對話中讓智能體調用工具 shengcheng，傳入提示詞等參數；生圖保持默認 kind=image，生視頻設 kind=video 且使用 Grok。
3、根據工具返回的路徑在工作區或下載目錄查看文件；若 Host 已集成 zhanshi，可依賴 shengcheng_result 做預覽。
GPT 圖像比例當前支持：1:1 → 1024x1024、3:2 → 1536x1024、2:3 → 1024x1536；不支持的比例或 size / aspect_ratio 衝突會在請求前拒絕。圖像不接受 duration / image_path；視頻不接受 quality / size；Grok 圖像不接受 size；GPT 圖像不接受 resolution。
適用場景與注意¶
適合已在 DSH 桌面完成 Grok / GPT OAuth、希望智能體通過單一工具生圖（及 Grok 生視頻）的開發者。項目 README 說明當前深度適配個人使用，供思路借鑑，儘量不要直接照搬。
插件以當前 DSH 進程權限運行；寫入路徑經 sandboxPolicy.resolve 與官方 fs.resolve 校驗。read-only 拒絕生成落盤；workspace-write 遵從工作區及平臺臨時目錄規則。安裝前應自行閱讀源碼與倉庫許可證，確認憑證與輸出目錄策略符合你的環境。
歷史上 README 記錄過 Grok 生圖、圖生視頻的隔離與真實賬號驗收條目；GPT 真實生成仍未驗收，不應把 Grok 成功等同於 GPT 可用。README 亦強調：讀取、保存憑證或生成失敗會明確報錯，禁止把失敗結果顯示成生成成功。
