READMESource: main@7d6a241d
⚡ dsh Plugins Workspace
DeepSeek Harness 插件开发工作区:一个插件项目一个文件夹(各自独立 GitHub 仓库,主仓用 submodule 引用)。
Topics: dsh-plugin · deepseek-harness · windows
仓库清单
| 仓库 | 说明 |
|---|---|
| dsh-workspace | 本工作区(README、package.json,submodule 引用各插件) |
当前工作区暂无挂载的 submodule。新插件成熟后按下方流程登记。
克隆工作区(含所有插件):
git clone --recursive https://github.com/wenliang9527/dsh-workspace.git
目录结构
deepseekH\
├── plugins\ # 插件项目(每个插件 = 一个独立仓库,经 submodule 挂载)
├── package.json # 工作区 npm 配置(dsh CLI)
├── package-lock.json
├── DEV-NOTES.md # 开发笔记(动态插件契约、踩坑记录)
└── README.md
开发新插件
- 在
plugins/下新建项目文件夹:plugins/<my-plugin>/ - 按需创建文件:
host.js(Host 半区)、client.js(Client 半区)、README.md - 在本工作区的 DSH 会话里用
cordis_define加载调试(参数契约与踩坑见DEV-NOTES.md§2) - 开发期复用工作区根部的
package.json/node_modules,用npm run dsh或npm start启动 Harness - 成熟后独立建仓:在插件目录内
git init+ 建 GitHub 仓库推送,然后回主仓登记:git submodule add https://github.com/<你>/<dsh-插件名>.git plugins/<my-plugin>
小技巧:插件目录内已有独立
.git时,git submodule add会直接把它登记进主仓("Adding existing repo"),无需重新克隆。
⚠️ 两个环境前提
1. cordis_* 工具需要 cordis preset
cordis_define / cordis_run / cordis_stop / cordis_undefine 只挂在 preset-cordis 下。
standard preset 里没有这些工具,会话里会直接看不到。要用动态插件,先把 agent preset 切到 cordis。
2. 工作区 npm start 与桌面 App 是两套运行时
| 版本 | |
|---|---|
| 桌面 App(当前 GUI 跑的就是它) | 0.2.1-rc.5 |
工作区 node_modules/@deepseek-ai/dsh |
0.1.0-rc.6 |
package.json 声明 |
latest |
三者不一致,npm start 起的是另一个版本的 Harness。想跟桌面 App 对齐就先 npm install 重装工作区依赖。
说明
dsh web默认端口 3080,被占用时提示EADDRINUSE;但桌面 App 每次重启会分配随机端口,不要写死- 需要 Node.js(npm):https://nodejs.org
No comments yet. Be the first to write one.