dsh-devforge 天工造梦
dsh-devforge 是面向 DeepSeek Harness(DSH)的规范驱动服务工厂与本机智能体工作台。它同时提供 Host 能力和 Web 面板:Host 负责路由、工具、凭据、SQLite 持久化、子代理和外部服务;浏览器侧负责操作台、配置页和可视化状态。
当前源码版本:0.23.3。已发布到自有官网的稳定包以 版本清单 为准;完整页面说明、截图和发布流程见:
- 通用开发规范库:版本化 Markdown 规范存放于
standards/,通过系统提示和devforge_standards工具提供给 Agent;创建服务时按模板注入生成子代理。 - 一键生成服务:
devforge_jobs工具和“新建服务”页创建独立子代理。后端服务默认注入 Api、Bll/BAL、Dal、Model、Utility/Utils 分层,要求中文注释、通用能力复用、成熟开源包优先、结构化日志和验证后的中文 Git 提交。 - 服务工厂操作台:侧边栏“服务工厂”入口提供开发规范、智谱 Coding Plan、生成任务、新建服务、记忆中枢、记忆工作台、工作流、远程运维、项目、代码仓库、飞书、插件更新和皮肤换肤能力。
- 智谱 Coding Plan:复用 DSH 受管凭据
ZAI_CODING_CN_API_KEY,一键补齐zai-coding-cn的 GLM-5.3 与 GLM-5.3-Flash;Host 直连智谱官方监控接口,展示 5 小时、周额度、重置倒计时、近 24 小时/7 天模型和 MCP 用量。支持自定义命名的 Key 池:每把 Key 独立凭据引用并可自行起名,主 Key 只是聊天模型路由当前指向(切换不增删池成员),官方调用(MCP 工具、额度看板、模型拉取)在 401/403/429 时自动切换下一把 Key,用量页按 Key 独立出卡片展示;旧版派生槽位_2…_6中已配置的 Key 升级时自动并入池。Key 不进入浏览器、日志或普通配置。 - 火山方舟 Agent Plan:使用 Plan Key 调用官方套餐模型并同步推理档位;用受管控制面 AK/SK 经火山 OpenAPI V4 签名查询 Agent Plan/Coding Plan 的 5 小时、周、月额度。操作步骤见火山方舟用量看板教程。
- OpenAI 兼容中转站:在 Coding Plan 页配置中转站地址和受管 API Key,通过
GET /v1/models获取模型并注册为openai-gateway聊天路由;可从模型目录指定全局generate_image的生图模型,生成结果写入工作区并在聊天中内联展示。旧dsh-sub2api的 OpenAI 地址、凭据引用、模型元数据和生图模型会自动迁移,Key 明文不会被读取或复制。 - 本机 DSH 重启:操作台“重启 DSH”按钮和
devforge_restart工具仅在用户明确要求时使用。重启接口要求 loopback 与同源请求,复用现有启动参数,启动日志写入$DSH_HOME/logs/dsh-web-restart.log。 - 可见运营浏览器:本机前台 Chrome 保存持久登录档案,支持多标签页、页面快照、稳定元素操作和安全图片上传;多个会话共用一个浏览器进程,不复制 Cookie,也不另开隐形浏览器。
- 闲鱼运营助手:发布商品和消息回复分别使用独立标签页,页面状态互不覆盖;真实发布和真实发送均要求用户明确确认,并核验平台结果。
- 已安装插件功能总览注入:自动枚举 Loader 中用户安装的插件并读取各包描述,把「每个插件是干什么的」以动态系统提示节注入所有会话上下文;插件装卸、启停后实时跟随,官方核心内置模块仅汇总计数以防上下文膨胀。可通过设置里的「已安装插件功能总览注入开关」关闭,访问
GET /api/dsh-devforge/plugin-brief可查看当前实际注入文本。 - 插件更新:操作台「插件更新」页签对比官网(modagentai.com)版本清单检查更新源登记表里的插件(默认登记 dsh-devforge 自己,可在设置里加包名→官网清单或 GitHub 仓库),一键升级走下载 tgz(官网渠道强制 sha256 校验)→
dsh plugin add的同一条人工验证路径;升级后提示重启 DSH 生效(重启仍需用户确认)。 - DSH 全 GUI 换肤:操作台「皮肤」页签基于官方
ctx.theme.register/overrideTokens一等 API 提供 14 套内置主题(7 浅 7 深,含 4 套紫色:薰衣草、雾紫、星紫夜、水晶紫夜;以及晨雾蓝、樱花粉、纸感暖、森林绿、蜜柑橙、午夜蓝、石墨黑、松林夜、墨玉青、中国红)+ 8 色强调色 + 可选壁纸(本地图片/http(s)/data URL,配遮罩浓度/模糊/显示方式)。选择持久化到 localStorage 跨重启自动跟随,深浅色与 GUI 自带模式自动联动;针对 ThemeRuntime 持久化偏好 schema 不接受第三方皮肤 id 的限制,引导期做 4 次 200ms 重试兜底,状态真相源切换为ctx.theme.getTheme().active.id保证 active 高亮与 GUI 实际着色始终一致;写入失败时 UI 顶部 banner 提示。
推荐阅读:
- 中文用户手册:14 个顶层页签、重要子页、Agent 工具、数据与安全边界。
- 发布与开源指南:官网、GitHub、CNB、Awesome DSH Plugin 与 dsh-market 的关系和操作步骤。
- 暂存环境测试约束:隔离 HOME、3081 端口、禁用桌面宠物/飞书桥以及生产重启红线。
能力概览
| 领域 | 能力 |
|---|---|
| 开发工厂 | 版本化开发规范、devforge_jobs 一键生成服务、规范注入、项目上下文和产出目录公约 |
| 模型接入 | 智谱 GLM、MiniMax、火山方舟、硅基流动、OpenAI 兼容中转站、模型目录和用量看板 |
| 知识与记忆 | RAG 知识库、中文全文+向量混合检索、精排、项目索引、会话自动沉淀、主动注入、知识图谱 |
| 工作流 | 查询改写、检索、精排、生成、自评重试、运行记录和来源耗时 |
| 代码托管 | CNB 与 GitHub 账号、仓库、Clone/Pull/Status/Commit/Push;推送默认关闭 |
| 远程运维 | SSH、WinRM、批量执行、PTY/SFTP、端口隧道、Windows 进程和服务管理 |
| 可见自动化 | 前台 Chrome 多标签页、无障碍快照、稳定引用、图片上传、闲鱼/小红书操作 |
| 协作与备份 | 飞书长连接、独立会话、完成通知、CNB 加密备份、跨机预览/同步/恢复 |
| 维护与外观 | 插件更新、DSH 本体版本检查、14 套主题、强调色、壁纸、插件能力总览注入 |
| 直播侧栏 | 抖音直播间连接、弹幕/礼物/点赞/进场等消息筛选、伴侣跟随和语音播报 |

安装
官网预构建包
官网包不需要在目标机重新构建:
dsh plugin --profile web add https://modagentai.com/downloads/dsh-devforge-latest.tgz
安装后重启 DSH Web Host 才能让 Host 半边生效。已经安装的机器可以进入「天工造梦 → 插件更新」页检查官网清单;官网渠道会校验 sha256。
GitHub 源码
仓库公开后可从 GitHub 安装:
dsh plugin --profile web add github:andyfan1094/dsh-devforge#main
源码安装会执行 prepare/构建流程。需要稳定、免构建的安装体验时,使用 GitHub Release 中的预构建 .tgz 或官网包。
CNB 镜像
CNB 用于国内镜像、代码协作和加密备份;dsh-market 的精选目录要求使用 GitHub 仓库地址,因此市场条目的主链接仍应指向 GitHub,CNB 作为同步镜像维护。CNB 的账号、Clone、Pull、Commit 和 Push 见 CNB/GitHub 发布说明。
开发与验证
pnpm install --frozen-lockfile
pnpm run typecheck
pnpm test
pnpm run build
源码不依赖任何机器的绝对路径;pnpm-workspace.yaml 不应提交本机 link: 覆盖。插件改动在生产前必须按隔离暂存流程验收,生产实例不要直接试验。
项目结构
src/index.ts Host 入口、配置、路由、工具和生命周期
src/client/ Web 入口、侧栏入口、面板和主题运行时
src/client/panel/ 14 个顶层页签与各工作台子页
src/*/protocol.ts Host/Client/API 数据契约
standards/ 版本化开发规范
docs/ 中文手册、发布说明、暂存约束和截图
screenshots.json dsh-market 使用的精选截图清单
cordis.patch.yml DSH bundle 注册
截图
完整截图索引在 中文用户手册 中。市场详情页使用仓库根目录的 screenshots.json,截图文件存放在 docs/assets/screenshots/,不包含 API Key、Token 或 Secret。
许可证
项目代码使用 MIT AND Apache-2.0;第三方声明见 THIRD_PARTY_NOTICES.md,许可证文件见 LICENSE 与 LICENSES/。
No comments yet. Be the first to write one.