JustGenius-s/DSH-Plugs

DSH-Plugs

一个用于 DeepSeek Harness（DSH）的插件 monorepo —— 一个文件夹 = 一个插件。

插件

@just-genius/dsh-codex

为 DSH 官方右侧边栏提供 Side Chat、Terminal 和 Git 标签页类型。文件默认使用 DSH 的内置包，并可从 Codex 设置中启用保留的自定义预览；Warp 风格的终端由真实的登录 shell PTY 支持。可选功能：滚动时固定最新问题，并在打开时加载会话的完整历史记录。

@just-genius/dsh-debug-mode

Cursor 风格的调试模式：/debug、红色的 Debug 标签、位于输入框上方的 Debug Logs 停靠面板，以及带有 Proceed / Mark as fixed 的复现步骤卡片。插桩通过 .dsh/debug/ 下的工作区辅助程序进行；停靠面板可被清空；运行时日志行会镜像到 .dsh/debug/debug.log。模式/等待状态仅保存在实时会话的进程内存中（不会写入持久会话日志）。

@just-genius/dsh-flow

Leader 规划 / 子代理执行的编排模式，在你选择或运行 /flow 之前处于关闭状态。一旦开启，主代理只负责规划 —— 它通过 flow_plan 将工作布置为 DAG，每个节点被分派给各自的子代理，并在结果返回时通过 flow_patch 在运行中重塑图结构（用修订后的提示词重试、跳过、插入纠正步骤）。执行守卫仅允许 Leader 调用 flow_plan、flow_status、flow_next、flow_patch 和 flow_confirm；调查与执行均委托给子代理。右侧边栏中专门的 Flow 标签页使用 React Flow 绘制实时图：节点颜色 = 状态，边 = 依赖关系，点击节点可查看其简报、结果和失败原因。在命令菜单中选择 /flow 以启用该模式并打开标签页。输入框会显示一个 Flow 标签；点击它或使用 /flow off 可退出并取消正在运行的子代理。

@just-genius/dsh-multi-repo

多文件夹工作区（Codex 风格，无 git 扫描）：逐个添加文件夹，选择一个作为 主文件夹 —— 即官方工作区、会话 cwd 和 workspace-write 范围 —— 其余文件夹保持可读和可协调。绑定关系保存在 ~/.dsh/multi-repo/projects.json 中，并注入到系统提示词中。

@just-genius/dsh-workspace-plus

工作区增强功能，取代了同时安装 dsh-multi-repo 和行菜单插件的做法：将多个文件夹附加到一个工作区（主文件夹即官方 cwd / workspace-write 范围），并在工作区和会话行上添加双击 / 右键菜单 —— 固定、重命名、未读、归档、分叉、打开文件夹。绑定关系保存在 ~/.dsh/workspace-plus/bindings.json 中。会话菜单不提供永久删除功能。

@just-genius/dsh-memory
全局 Markdown 记忆：设置 → 记忆用于手动增删改查，memory_propose 用于等待用户确认的 AI 写入，已启用的条目会注入系统提示词。存储于 ~/.dsh/memory/ 下，为 index.json + entries/.md。

@just-genius/dsh-computer-tools

设置 → 浏览器与桌面：每个能力一张卡片——Browser Use（Playwright MCP）和 Computer Use（Cua MCP 或 Native）——各自独立保存。保存时会写入一条托管的 cordis.patch.yml 插入内容；默认配置开箱即用，各项调节项位于高级选项下。这些能力包是单独的按需安装项，因此当某张卡片对应的包缺失时，会提供一键安装（并附可复制的命令作为备选）。它不会重启宿主或操控计算机。需要 dsh-plugin-config。

@just-genius/dsh-sync

GitHub Device Flow + 私密 Gist 配置同步：设置 → Sync 推送/拉取 settings.yaml 和 Web 插件列表（可移植规格 + cordis.patch.yml），无需自建同步服务器。状态存放于 ~/.dsh/sync/state.json。

@just-genius/dsh-desktop-update

在侧边栏设置按钮旁为 DSH-Desktop 显示更新徽标，由 window.dshDesktop Electron 桥接驱动。应用更新会跳转到 GitHub Releases；DSH 运行时更新则就地安装。在普通浏览器中不渲染任何内容。

@just-genius/dsh-model-custom-ex

替换官方模型设置页面（ui-settings-models 的分支），为每个模型添加下拉多选，用于视觉（input）和思考强度（reasoningEfforts），并增加每个模型的默认思考强度以及可输入的容量组合——这些是原版页面推给 settings.yaml 的控件。

@just-genius/dsh-notify-jump

点击 dsh-notification 系统横幅即可聚焦窗口并打开该会话；当 DSH-Desktop 桥接存在时，会经由 window.dshDesktop.notify 路由，使点击跳转在 Electron 外壳中依然有效。还会在审批 / 询问 / 计划评审等待的上升沿发出通知。

@just-genius/dsh-session-archive

设置 → 会话归档：按工作区分组显示已归档会话，并提供带确认的删除。侧边栏保留其一键归档会话入口。

@just-genius/dsh-plugin-config

设置 → 插件 → 插件扩展在 DSH 官方插件页面旁新增一个标签页，用于 Cordis npm 插件（awesome-dsh-plugin 市场、配置文件清单和 npm 更新）以及 Agent 能力包（内置目录 → ~/.dsh/agent-plugins）。共享顶部搜索。Agent 包在启用时挂载托管的 MCP 工具/技能，无需重启 DSH；Cordis 安装和更新需要重启。官方插件列表和 DSH v0.1.6-alpha.2+ 侧边栏插件管理器仍然可用。

@just-genius/dsh-quick-notes
随手笔记：悬浮在 shell 上的便签卡片，带搜索浮层（Mod+Shift+F；Mod+Shift+N 新建笔记）。卡片是所见即所得的——输入 #  会变成标题，- [ ] 会变成真正的复选框，GFM 表格保持为可编辑表格——而磁盘上的笔记仍是纯 Markdown。一轮模型会生成标题和最多 3 个标签；手动重命名会冻结后续的 AI 覆盖。设置 → 随手笔记 管理笔记库（搜索、标签、置顶 / 归档 / 删除、批量操作）。笔记是全局的，而非按工作区划分，位于 $DSH_HOME/quick-notes 下，且每次写入都是原子的（临时文件 + 重命名）。

dsh-synapse

一个可视化、非线性的对话工作区（从 liangmianya/dsh-synapse 0.4.1 引入）：将一个工作区的会话、追问和分叉绘制成可拖拽、可缩放的地图，通过顶层 会话地图 开关进入，并在 /synapse 提供服务。DSH 的会话日志仍是唯一事实来源——Synapse 只投影已提交的事件，通过真实的分叉边连接卡片，而不是构建第二份历史记录，并将其画布布局保存在 $DSH_HOME/synapse/ 中，因此删除该目录永远不会删除会话。卡片还可以将其答案保存到随手笔记中。仅限 Web 配置，复用现有的 DSH 服务器。它是唯一一个纯根级 JS 的插件（index.js / client.js / app.js，用 node --check 构建）——没有 @just-genius 作用域，没有共享运行时，没有 typecheck。

@just-genius/dsh-whale-girl

桌面宠物（鲸鱼娘）。在普通浏览器中，它是页面内的伴侣；在 DSH-Desktop 中，它通过 window.dshDesktop.overlays 打开一个透明、始终置顶的浮层，让宠物坐在操作系统桌面上。

共享包

packages/runtime（@just-genius/dsh-plugin-runtime）是
唯一直接适配官方 DSH 宿主/客户端 API 的包。所有插件都依赖这一边界，
而不是导入 @deepseek-ai/ 包或独立固定它们的版本。

packages/agent-plugin（@just-genius/dsh-agent-plugin）是
Agent 能力包的纯逻辑：清单验证、变量替换、
托管 MCP HTTP、OAuth，以及安装/启用/禁用状态。宿主 UI 位于
dsh-plugin-config。

packages/ui（@just-genius/dsh-plugin-ui）提供 DSH --dsw- 主题令牌以及 React 原语（Button、Input、Menu、Modal、Markdown、确认和 toast UI）和设置界面外壳。插件在构建时将其打包；独立应用（例如 Vellum）可以通过 file: / npm 依赖它，并在启动时调用一次 installTheme()。参见 packages/ui/README.md。

官方 DSH 契约在共享边界处固定为最新经过测试的
已发布 API（本次迁移中为 0.1.1-rc.2）。

仓库布局

DSH-Plugs/
├── package.json          # 根工作区（共享构建/类型工具链）
├── pnpm-workspace.yaml   # packages: ['plugins/', 'packages/*']
├── tsconfig.base.json    # 共享 TS 配置
├── packages/
│   ├── runtime/          # @just-genius/dsh-plugin-runtime
│   ├── agent-plugin/     # @just-genius/dsh-agent-plugin（Agent 包逻辑）
│   └── ui/               # @just-genius/dsh-plugin-ui
└── plugins/
└── /         # 每个文件夹一个插件

什么是插件

插件是一个 Cordis 插件 npm 包，分为两半：

| 部分 | 源文件 | 输出 | 作用 |
| --- | --- | --- | --- |
| node | src/index.ts | lib/index.js | 宿主入口（对于纯 UI 插件通常是空的 apply） |
| browser | src/client/index.tsx | lib/client.js | 浏览器入口，通过 window.__ModuleLoader__.load({ id, factory }) 注册，在 apply 中使用 ctx.slots.register 挂载 React UI |

package.json 中的两个关键声明：

- dsh.client —— 声明浏览器端的注入（inject 列出它所依赖的客户端包名；platform: web）。
- dsh.bundle.patch —— 指向 cordis.patch.yml，因此安装该包时会自动将其 loader 行插入到 profile 中。

开发

pnpm install      # 安装依赖
pnpm build        # 构建所有插件（src → lib）
pnpm watch        # 监听并重新构建
pnpm typecheck    # 类型检查
pnpm clean        # 删除所有 lib/

添加插件

在创建插件之前，请遵循 AGENTS.md 中的依赖规则。

安装插件

将本地文件夹链接到 profile 中（相对路径以当前目录为基准）
dsh plugin --profile web add ./plugins/dsh-codex

由于该包声明了 dsh.bundle.patch，它会在安装时自动加入 profile 的 bundle 层；重启 DSH web（对于 bundle 栈的更改，仅刷新是不够的）。

卸载：

dsh plugin --profile web remove @just-genius/dsh-codex