前言¶
在 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 亦强调:读取、保存凭证或生成失败会明确报错,禁止把失败结果显示成生成成功。