DeepSeek Harness Hub
← 返回列表

插件开发沙箱zhn1100/dsh-forge

DeepSeek Harnessspec-screenedcode在 GitHub 查看 ↗
⚠ 装前注意

隔离环境开发调试插件,验证后一键晋级正式版

基本兼容但装前注意:npm 同名包「dsh-forge」归属 dushaobindoudou/dsh-forge,装到的可能不是本插件 · 最近上游提交 2026/8/16 · 已提供中文文档

可复现的 DeepSeek Harness 插件开发环境

综合分
33.2
GitHub 分
33.2
用户评分
★ Stars
5
周下载量
安装插件(需先安装 dsh CLI 引擎:npm install -g @deepseek-ai/dsh)
dsh plugin --profile web add zhn1100/dsh-forge
npm 同名包「dsh-forge」归属 dushaobindoudou/dsh-forge,装到的可能不是本插件,改用 GitHub 源安装
数据截至 2026/8/21(元数据每日更新 · 实装验证按队列轮转,单条结论的验证时间见上方)
安装兼容性检查⚠ 装前注意

以下结论由程序自动检查 npm 包、engines 声明与入口文件得出,未做人工实机验证——能装不等于用着没问题。

npm 包dsh-forge @ 0.0.1
Node 引擎要求 ^22.19.0 || >=24.0.0 · 基线 Node 22.19 满足
dsh CLI 依赖未声明 dsh 版本约束
入口文件main/exports/bin 已声明

npm 同名包「dsh-forge」归属 dushaobindoudou/dsh-forge,装到的可能不是本插件

验证方式:npm registry 存在性 + package.json 静态校验 · 最后验证 2026/9/18 16:59:20

依赖的 DSH / Cordis 模块
@deepseek-ai/cordis@deepseek-ai/dsh-system-prompt@deepseek-ai/dsh-tools
用户评分
还没有人投票,来当第一个
订阅周报,不错过优质插件更新
每周一封 · 高评分插件 + 新用户活动

README

DSH Forge

面向 DeepSeek Harness 的独立插件开发环境。它把源码参考、运行时检查、实验记录、验证和正式化流程收进一个可复现的 Forge Profile,同时避免污染日常使用的 DSH 环境。

当前版本针对 @deepseek-ai/dsh@0.1.0-rc.6,参考源码固定在官方提交 47f943859bef60e4160492346772ded9b24f765a。本项目不是 DeepSeek 官方项目。

能做什么

- 建立独立的 ~/.dsh-forge Home、forge Profile 和开发者 Agent Preset。
- 本地索引 Harness 文档、源码符号、Service、事件、工具、Config 和示例。
- 管理可恢复的插件实验、验证状态与 Promotion scaffold。
- 提供受限的 quick、package、full 验证流程。
- 每次启动安全同步普通 ~/.dsh 中的用户配置,同时保护 Forge 本地修改。
- 每次启动镜像普通 ~/.dsh 各 Profile 通过 cordis.patch.yml insert 声明的 out-of-tree 插件(包目录 + Forge Profile 注册),让主线的插件在 Forge 环境同样可用。
- 使用 SHA-256 内容寻址 tarball 安装自身,避免复用旧包缓存。
- 将 Cordis、System Prompt 和 Tools 保持为宿主提供的可选 peer,避免 Profile 内重复运行时破坏 Symbol 身份。
- 升级时先由 DSH 正常移除旧 Forge 依赖再安装新工件,避免 lockfile 保留旧 peer 绑定。

安装

需要 Node.js ^22.19.0 或 >=24,以及 pnpm。

git clone https://github.com/zhn1100/dsh-forge.git
cd dsh-forge
pnpm install
pnpm run verify
node lib/cli.js install

安装程序不会写入普通 ~/.dsh,默认目标为 ~/.dsh-forge。

启动

在需要开发插件的工作区运行:

DSH_HOME="$HOME/.dsh-forge" npx @deepseek-ai/dsh@0.1.0-rc.6 --profile forge

Forge Profile 默认监听 127.0.0.1:3188(与主线 dsh 的 3080 错开,可同时运行);需要其他端口时用 --port  覆盖。

打开 Web UI 后选择 DSH Forge 开发者 Preset。

工作区边界

Forge 启动时同步的是 ~/.dsh → ~/.dsh-forge 的用户态数据,不同步当前工作文件夹的源码。

- 从工作区 A 切换到工作区 B,不会复制 A 的代码到 B。
- A、B 的修改互不影响,但共享同一个 Forge 配置和控制面。
- forge/、profiles/、.agent-presets/ 和 cordis.patch.yml 永不参与 Home 同步(唯一例外:主线 Profile 通过 insert 声明的 out-of-tree 插件会镜像到 ~/.dsh-forge/profiles/node_modules/ 并在 Forge Profile 的 cordis.patch.yml 注册)。
- Forge 侧已修改或删除的文件不会被覆盖;源端删除也不会传播。

同步基线保存在 ~/.dsh-forge/forge/home-sync-manifest.json。如需使用其他上游 Home,可显式设置 DSH_FORGE_SOURCE_HOME。

常用命令

环境检查
DSH_HOME="$HOME/.dsh-forge" node lib/cli.js doctor

重建指定 Harness revision 的知识索引
DSH_HOME="$HOME/.dsh-forge" node lib/cli.js sync --revision

搜索本地索引
DSH_HOME="$HOME/.dsh-forge" node lib/cli.js search "Service.init"

验证当前插件项目
node lib/cli.js verify --root . --level full

完整设计和安全边界见 任务书。

开发验证

pnpm run verify

验证包括类型检查、测试、构建和包结构检查。动态 Cordis Package 仍属于显式信任边界;Forge 提供隔离和恢复能力,但不将其包装成强安全沙箱。

License

MIT

上游仓库有新提交时邮件通知你(每天最多一封,无更新不打扰),随时一键退订。

💬 加入 DPharness 群聊

插件用法、部署报错、新插件第一时间同步——群里问,比一个人翻文档快。

点击加入 QQ 群
DPharness 群聊二维码,手机 QQ 扫码进群
扫码进群