前言¶
DeepSeek Harness（DSH）采用插件化架构，开发者可以通过安装插件扩展系统能力。dsh-devforge 是一个面向 DSH 的规范驱动服务工厂与本机智能体工作台插件。它由 andyfan1094 维护，旨在解决智能体开发中缺乏统一规范、服务构建流程繁琐以及多模型接入与运维管理复杂的问题。
该插件提供 Host 能力（路由、工具、凭据、持久化）与 Web 面板（操作台、配置、可视化），将版本化开发规范、一键服务生成、模型接入管理及远程运维整合到一个工作流中。
核心能力¶
开发工厂¶
- 版本化开发规范：规范存放于
standards/目录，通过系统提示和devforge_standards工具提供给 Agent，创建服务时按模板注入子代理。 - 一键生成服务：使用
devforge_jobs工具创建独立子代理。默认挂载用户预设cordis-250k（用于 1M 上下文模型的 250k 请求包自动压缩），缺失时会回退至官方cordis。 - 代码分层与规范：后端服务默认注入 Api、Bll/BAL、Dal、Model、Utility/Utils 分层，要求中文注释与结构化日志。
模型接入与用量¶
- 多模型支持：接入智谱 GLM、火山方舟、OpenAI 兼容中转站。
- 智谱 Coding Plan：复用 DSH 受管凭据
ZAI_CODING_CN_API_KEY，一键补齐 GLM-5.3 与 GLM-5.3-Flash。支持自定义命名的 Key 池，官方调用在 401/403/429 时自动切换下一把 Key，用量独立展示。 - 火山方舟 Agent Plan：使用 Plan Key 调用官方套餐模型，同步推理档位，并查询 5 小时、周、月额度。
- OpenAI 兼容中转：配置中转站地址和受管 API Key，注册为
openai-gateway聊天路由，支持内联展示生图结果。
运维与代码托管¶
- 远程运维：支持 SSH 与 WinRM，具备批量执行、PTY/SFTP、端口隧道及 Windows 进程管理能力。
- 代码托管：支持 CNB 与 GitHub 的账号、仓库管理，提供 Clone/Pull/Status/Commit/Push 功能。
- 直播侧栏：提供抖音直播间连接，支持弹幕、礼物、点赞等消息筛选与语音播报。
可见自动化与协作¶
- 可见自动化：利用前台 Chrome 保存持久登录档案，支持多标签页操作、页面快照与图片上传，闲鱼/小红书的发布与回复使用独立标签页互不覆盖。
- 协作与备份：集成飞书长连接，支持独立会话与完成通知；支持 CNB 加密备份与跨机同步。
维护与外观¶
- 插件更新：操作台提供插件更新页签，对比官网版本清单，支持一键升级（官网渠道强制 SHA256 校验）。
- 主题换肤：内置 14 套主题（7 浅 7 深，含多种紫色系），支持 8 色强调色与本地/网络壁纸配置，支持深浅色联动。
安装与启用¶
安装后需重启 DSH Web Host 才能使 Host 半边生效。
通过官网安装（推荐）
官网提供预构建包，无需本地构建：
dsh plugin --profile web add https://modagentai.com/downloads/dsh-devforge-latest.tgz
通过 GitHub 源码安装
dsh plugin --profile web add github:andyfan1094/dsh-devforge#main
安装后进入操作台的“插件更新”页签可检查官网清单。
典型用法¶
一键生成服务与配置¶
使用 devforge_jobs 工具一键生成服务与 250k 压缩配置。操作台“教程”页提供一键配置功能，写入 cordis-250k 用户预设（窗口 25% 触发、保留 32k 近期原文），并可选设为全局默认。
接入中转站¶
在 Coding Plan 页配置中转站地址和受管 API Key，通过 GET /v1/models 获取模型并注册为 openai-gateway 聊天路由。
本体重启¶
需要重启 DSH 时，使用操作台“重启 DSH”按钮或 devforge_restart 工具。
注意事项¶
- 安全与权限：Key 不进入浏览器、日志或普通配置，明文不会被读取或复制。多个会话共用一个浏览器进程，不复制 Cookie。
- 重启限制：重启接口要求 loopback 与同源请求，启动日志写入
$DSH_HOME/logs/dsh-web-restart.log。 - 版本校验：官网渠道强制 SHA256 校验。
- 生产环境：旧版派生槽位
_2…_6中已配置的 Key 升级时自动并入池。生产实例不要直接试验。
结语¶
dsh-devforge 将开发规范、服务生成、模型管理、运维操作与协作工具整合进 DSH 生态。对于需要规范化开发流程、统一管理多模型 Key 以及进行复杂运维操作的开发者，该插件提供了从规范到落地的完整路径。
更多详情与源码请访问：GitHub
