![\"DSH](\"assets/hero-v2.png\")
\n\n \n
![\"AIHubMix\"](\"assets/logo_aihubmix.png\"){kind=logo} | \nThanks to AIHubMix for sponsoring this project! AIHubMix is a stable, high-concurrency AI model API gateway that connects Claude, GPT, Gemini, DeepSeek, and other mainstream models through a single API key, compatible with multiple protocols, with free model options available. To sign up, use the AIHubMix entry outside mainland China or the Inferera entry within mainland China. | \n
![\"E-API\"](\"assets/logo_eapi_dark.png\"){kind=logo} | \nThanks to E-API for sponsoring this project! E-API aggregates mainstream AI models behind OpenAI-, Anthropic-, and Codex-compatible APIs, with selected Claude models up to 98% below official prices and DeepSeek V4 models about 25% below official prices. | \n
\n ![\"A](\"assets/dsh-view-example.png\")
\n
\n ![\"Reference](\"assets/upstream/infographic-reference.webp\")
\n ![\"Editable](\"assets/upstream/infographic-result.webp\")
\n
\n ![\"Hand-drawn](\"assets/upstream/ui-sketch.webp\")
\n ![\"Working](\"assets/upstream/ui-result.webp\")
\n
\n ![\"Original](\"assets/upstream/ui-fast-restore-reference.webp\")
\n ![\"Approximate](\"assets/upstream/ui-fast-restore-result.webp\")
\n
\n English · 简体中文\n
\n\n\n ![\"dsh-auto-mode](\"./assets/readme/hero.svg\")
\n
\n ![\"npm](\"https://img.shields.io/npm/v/@nanmicoder/dsh-auto-mode.svg\")
\n ![\"MIT](\"https://img.shields.io/npm/l/@nanmicoder/dsh-auto-mode.svg\")
\n ![\"See](\"https://img.shields.io/badge/DeepSeek%20Harness-0.2.0--rc.2-202724\"){kind=icon}
![\"local-shell-mcp](\"docs/assets/logo.svg\"){kind=logo}
\n\n# local-shell-mcp\n\n**A ChatGPT-ready MCP control plane for shell, files, browser automation, file links, and remote machines.**\n\n[](https://fwerkor.github.io/local-shell-mcp/)\n[](https://github.com/fwerkor/local-shell-mcp/actions/workflows/ci.yml)\n[](https://www.dsh.so/artifact/local-shell-mcp)\n[](https://github.com/fwerkor/local-shell-mcp/releases)\n[](https://github.com/fwerkor/local-shell-mcp)\n[](https://github.com/fwerkor/local-shell-mcp/pkgs/container/local-shell-mcp)\n[](LICENSE)\n\n[Documentation](https://fwerkor.github.io/local-shell-mcp/) · [Quickstart](https://fwerkor.github.io/local-shell-mcp/getting-started/quickstart/) · [Runtime choices](https://fwerkor.github.io/local-shell-mcp/guides/deployment/) · [ChatGPT connector](https://fwerkor.github.io/local-shell-mcp/getting-started/chatgpt-connector/) · [DSH plugin](https://fwerkor.github.io/local-shell-mcp/clients/deepseek-harness/) · [Tools](https://fwerkor.github.io/local-shell-mcp/reference/tools/) · [Releases](https://github.com/fwerkor/local-shell-mcp/releases)\n\n\n English · 简体中文\n
\n\n\n \n
\n ![\"Recommended](\"https://img.shields.io/badge/recommended%20by-dshfind-FFD700?style=flat-square\"){kind=icon}
\n
\n
\n ![\"npm](\"https://img.shields.io/npm/v/@nanmicoder/dsh-agent-teams?style=flat-square&color=5B4CF0\")
![\"MIT](\"https://img.shields.io/badge/license-MIT-0B7285?style=flat-square\"){kind=icon}
![\"DSH](\"https://img.shields.io/badge/DSH-Web%20%2B%20Headless-5B4CF0?style=flat-square\"){kind=icon}
\n ![\"AgentTeams](\"./assets/readme/workspace.png\")
\n
![\"Model](\"assets/screenshots/model-picker.png\")
\n\n**Usage dashboard** — `/commandcode` per-account report:\n\n![\"Usage](\"assets/screenshots/usage-dashboard.png\")
\n\n**Settings page** — accounts with live quota, model visibility, privacy switches, connection options:\n\n![\"Command](\"assets/screenshots/settings-page.png\")
\n\n## Install\n\n```sh\ndsh plugin --profile web add @mars-sea/dsh-commandcode-provider@latest\n```\n\nThis build admits **dsh `>=0.2.1-rc.2 <0.2.2-0`** — every RC of the `0.2.1` channel from `0.2.1-rc.2` onward — **and `>=0.2.2-alpha.2 <0.2.3-0`**, the `0.2.2` channel from its current alpha. `0.2.1-rc.5` is what npm `latest` and `next` run, and `0.2.2-alpha.3` is on `alpha`. All six are covered by the full engine matrix (`npm run test:engine`, `npm run test:install`). A later release of either channel is admitted without a plugin update, but stays unverified until a record is added to `dsh.compatibility.dshReleases`. `0.2.3` and later are deliberately excluded — the upper bounds are written `<0.2.2-0` / `<0.2.3-0` for exactly that reason. A profile on `0.2.0-rc.2`, `0.2.1-alpha.5` or older must upgrade its engine first. Compatibility details — the `engines.dsh` admission rule, package pairings, evidence — live in [engine compatibility](docs/agent-reference/engine-compatibility.md).\n\n### Node.js 24.9 or newer is required\n\n**The Node.js floor was raised from 22 to 24.9 in 0.16.0. On Node 22 or 23, upgrade Node before updating this plugin.**\n\ndsh `0.2.2-alpha.2` declares `engines.node >=24.9.0` and this plugin admits that engine, so the package-wide floor had to follow: a plugin that claims to support an engine must not be installable on a Node version that engine cannot start on. What that means in practice:\n\n- `npm` reports `EBADENGINE` when installing or updating this plugin on Node 22/23. It is a warning, not a hard failure, unless your npm sets `engine-strict=true`.\n- The `0.2.2` engines genuinely cannot run on Node 22/23, so a profile admitted there would fail at startup — the failure this floor exists to prevent.\n- The `0.2.1` RC engines still run on Node 22, but `engines.node` is a single floor for the whole package, so it applies to them too. That is the cost of admitting two channels in one build.\n\n`nvm install 24 && nvm use 24` (or any Node 24.9+ distribution) resolves it. Node 24 is a current LTS line.\n\n**Older dsh releases** are no longer supported: the last plugin release for dsh 0.1.7 is `0.11.17`, for 0.1.2–0.1.6 it is `0.11.11`, and for the 0.5.0-era line `0.9.1` — all installed by exact version, none maintained.\n\n> **pnpm 11 holds back new releases.** `minimumReleaseAge` defaults to 1440 minutes, so a version published less than a day ago is skipped and `@latest` resolves to the *previous* release — silently, with a success exit code. To install a release from the last 24 hours, name it exactly: `@mars-sea/dsh-commandcode-provider@0.11.15`. This applies to every profile, including the terminal UI below.\n\n**Updating** — same tag, then restart the web app. Each profile updates separately, because the terminal UI owns its own plugin list:\n\n```sh\ndsh plugin --profile web update @mars-sea/dsh-commandcode-provider@latest\ndsh plugin --profile dsh-tui update @mars-sea/dsh-commandcode-provider@latest\n```\n\n## Get an API key and verify it works\n\nEasiest via the official CLI (Node.js 22+):\n\n```sh\nnpm i -g command-code@latest\ncmd login # macOS/Linux; native Windows: cmdc login\n```\n\nOr skip the CLI: click **Sign in to Command Code** under **Settings → Command Code** — the browser opens the commandcode.ai authorization page (the same flow `cmd login` runs) and the key is stored locally once you approve. You can also create a key on the [Keys page](https://commandcode.ai/mars-sea/settings/keys) and paste it, or `export COMMANDCODE_API_KEY=\"user_...\"`.\n\n> The sign-in flow needs the Host and your browser on the same machine (loopback callback). With a remote Host, paste the key manually; a literal composition-level `apiKey`, if set, still takes precedence over a signed-in credential.\n\n**To verify:** after restart, enter your API key in **Settings → Command Code** and save. **Settings → Models** shows a **Command Code** card, and the model picker lists the live catalog under **commandcode**. Send a message with a model your plan includes.\n\n## Terminal UI (dsh-TUI)\n\n**Each dsh profile owns its own plugin list**, so the web install does not reach the terminal — add the plugin to the `dsh-tui` profile as well, pinned to an exact version (within 24 hours of a release a bare name resolves to the previous build, leaving a fresh install with no `/settings` → Command Code page and no `commandcode` models):\n\n```sh\ndsh plugin --profile dsh-tui add @mars-sea/dsh-commandcode-provider@latest\n```\n\nThen pick the provider in the model selector, or name it directly:\n\n```text\n/model commandcode/deepseek/deepseek-v4.1-flash\n```\n\n`/model` lists every registered provider, with the live catalog and its plan/deal/context annotations; the `/commandcode` dashboard works there too.\n\n**Entering the key.** The TUI has no web Models page, so the plugin declares its own page — **`/settings` → Command Code** — with the API key, API base, out-of-plan filter, active account and command language. The key field is write-only: it shows whether a key is configured and writes what you type to the credential store, never to a settings document. The same page lists the whole catalog as checkboxes grouped by plan tier, free models first; everything starts checked, and the choice is stored as per-model overrides next to the `visibleModels` list the web page edits.\n\nAlternatively set the key outside the TUI. The first match wins:\n\n- A literal `apiKey` in the composition config wins over everything and is always used.\n- Otherwise the credential reference is resolved (`apiKeyEnv`, `COMMANDCODE_API_KEY` by default). In a profile that mounts the credentials service (Web, desktop, SDK, ACP) that service owns the order: **since 0.2.1-alpha.3 a saved credential wins over the launching environment**; earlier releases had the environment first.\n- A **headless profile mounts no credentials service on purpose**, so only the launching environment, the project `.env` and `$DSH_HOME/.env` apply — **a key saved on the page never reaches a headless run**.\n- The last resort is `~/.commandcode/auth.json`, written by the official CLI.\n\n```sh\nexport COMMANDCODE_API_KEY=\"user_...\" # launching environment\ncmd login # writes ~/.commandcode/auth.json\n```\n\n**Making Command Code the default.** dsh-TUI pins its own agent route, so its `agent-default-model` setting does not override it. Override the `agent-loop` row in your profile patch (`$DSH_HOME/profiles/dsh-tui/cordis.patch.yml`):\n\n```yaml\n- id: agent-loop\n inject: [tuiStartup]\n config:\n agents:\n - id: main\n provider: commandcode\n model: deepseek/deepseek-v4.1-flash\n reasoningEffort: max\n cwd: !!js process.cwd()\n```\n\n## Usage dashboard\n\nThe plugin registers a `/commandcode` slash command showing per-account usage:\n\n```text\n/commandcode (or /commandcode status)\n```\n\nIts copy follows the shell's locale: explicit `lang: 'en' | 'zh'` in the `llm-commandcode` plugin config wins, otherwise `LC_ALL`/`LANG` is read, otherwise it falls back to `zh`. The web settings page is independent — it follows the browser's language preference.\n\n## Account rotation\n\nWith several Command Code subscriptions, the plugin **switches to the next account automatically** when one hits its usage limit:\n\n- **Setup** — **Add account** in the **Accounts** card at Settings → **Command Code**, then sign in or paste an API key. Account actions (add, rename, replace or clear a key, remove, pin) apply immediately; only the other settings wait for the Save bar. The top-level key always serves first as the `default` account.\n- **Manual switching** — **Pin this account** in an account's **⋯** menu makes ","truncated":true,"reason":"GitHub metadata HTTP 403"}},{"slug":"dsh-plugin-solo-thinking-5e5869","name":"dsh-plugin-solo-thinking","description":"Solo-style isolated brainstorm branches and Handoffs for DeepSeek Harness","description_zh":"把头脑风暴拆成独立 DSH Session 分支，以 Agent 撰写的 Handoff 传递结论，并在思考树中管理分支；完整顶部 Tab 可独立使用，右侧栏增强需另装 Better Sidebar。README 要求 Node.js 22.19+ 与 DSH 0.1.0-rc.6。","description_en":"Creates isolated DSH Session branches for brainstorming, passes findings through agent-authored handoffs, and displays a thinking tree. The full tab works alone; its optional sidebar requires Better Sidebar. Requires Node.js 22.19+ and DSH 0.1.0-rc.6.","author":"fredalxin","install_spec":"dsh-plugin-solo-thinking","repo":"https://github.com/fredalxin/dsh-solo-thinking","github_repo_id":1334302358,"category":"workflow","tags":["brainstorming","session-branches","handoff","multi-agent"],"trust":"community","source":[{"kind":"registry","url":"https://raw.githubusercontent.com/dshplugin-app/deepseek-harness-plugins/main/README.md","fetched_at":"2026-11-05T00:15:41.408Z","evidence_url":"https://dshplugin.app/plugins/dsh-solo-thinking","attribution":"DSH Plugin Registry (independent directory)"},{"kind":"github","url":"https://raw.githubusercontent.com/fredalxin/dsh-solo-thinking/a77f3bb45ae8557df8a849e03ca0ed0b2d1a9e5d/package.json","fetched_at":"2026-11-05T00:19:02.923Z","evidence_url":"https://raw.githubusercontent.com/fredalxin/dsh-solo-thinking/a77f3bb45ae8557df8a849e03ca0ed0b2d1a9e5d/package.json","attribution":"fredalxin upstream package manifest"},{"kind":"github","url":"https://raw.githubusercontent.com/fredalxin/dsh-solo-thinking/a77f3bb45ae8557df8a849e03ca0ed0b2d1a9e5d/package.json","fetched_at":"2026-11-05T22:11:57.808Z","evidence_url":"https://raw.githubusercontent.com/fredalxin/dsh-solo-thinking/a77f3bb45ae8557df8a849e03ca0ed0b2d1a9e5d/package.json","attribution":"fredalxin upstream package manifest"},{"kind":"github","url":"https://raw.githubusercontent.com/fredalxin/dsh-solo-thinking/a77f3bb45ae8557df8a849e03ca0ed0b2d1a9e5d/package.json","fetched_at":"2026-11-05T22:24:14.930Z","evidence_url":"https://raw.githubusercontent.com/fredalxin/dsh-solo-thinking/a77f3bb45ae8557df8a849e03ca0ed0b2d1a9e5d/package.json","attribution":"fredalxin upstream package manifest"}],"data_as_of":"2026-11-05T22:24:14.930Z","readme":{"status":"fetch_failed","source_url":"https://github.com/fredalxin/dsh-solo-thinking/blob/a77f3bb45ae8557df8a849e03ca0ed0b2d1a9e5d/README.md","source_sha":"85874d32561a9cf213f4c11a3ea901767979d7c5","fetched_at":"2026-11-05T00:19:02.633Z","checked_at":"2026-11-05T22:24:14.597Z","excerpt":"# DSH Solo Thinking\n\n把头脑风暴拆成一棵可操作的思考树：每个方向都是独立的 DeepSeek Harness Session，分支之间只交换 Agent 主动撰写的 Handoff。 Solo Thinking 是项目 [Solo](https://github.com/solo-agent/solo) 的一部分能力。\n\n> Solo-style isolated brainstorm branches, automatic Handoffs, and a visual thinking tree for DeepSeek Harness.\n\n\n\n> [!NOTE]\n> 上图是 Solo Thinking 自带的完整“头脑风暴”Tab，只安装本插件即可使用。对话右侧栏是可选增强，需要同时安装 [Better Sidebar](https://github.com/omdsh-dev/DSH-better-sidebar)。\n\n## 核心能力\n\n- 默认建议模式：信息足够时自动创建 2–4 个真正独立的方向，优先 4 个，不为凑数而分裂。\n- 独立 Session：每个节点拥有自己的对话、状态和生命周期，建议节点先休眠，收到第一条消息后才启动。\n- 自动 Handoff：分裂继承、Current State、兄弟感知和 Return 总结均由 Agent 自动撰写，用户不需要手写。\n- Workspace 继承：分支持久化挂在父 Session 所属 Workspace，不落入“未分组”。\n- 输入不串线：主输入框只发给当前 Session；思考树可直接向选中的其他分支发送；只有“进入对话”会导航。\n- 可回放持久化：树状态写入 DSH append-only Session 事件并通过 Projection 恢复。\n\n## 兼容性与界面\n\n| 安装组合 | 顶部完整 Tab | 对话右侧栏 | 支持情况 |\n|---|---:|---:|---|\n| 官方 DSH `0.1.0-rc.6` + Solo Thinking | ✓ | — | Thinking 工具、自动建议、分支 Session、Handoff、Workspace 继承和完整上下文 |\n| 再安装 Better Sidebar `>=0.12.1` | ✓ | ✓ | 在对话右侧查看思考树、选择节点、控制分支并直接发消息 |\n\nBetter Sidebar 是**右栏功能依赖**，但不是 Solo Thinking 核心能力的硬依赖：包中声明为 optional peer，运行时通过公开 `registerTab` 服务软检测，不会被重复打包。没有安装或运行中被卸载时，完整顶部 Tab 与 Host 侧 Thinking 能力仍然可用。`dsh-web-ui` 的 AionUI 文件/预览右栏目前没有第三方 Tab 注册接口，因此本插件不会依赖其 DOM 结构；使用它时继续用完整标签页。可选宿主补丁及其精确适用版本见 [`patches/README.md`](patches/README.md)。\n\n## 安装\n\n要求 Node.js `^22.19.0 || >=24.0.0` 和 DSH `0.1.0-rc.6`。\n\n### 官方 npm 单行安装（推荐，自动使用 latest）\n\n```bash\ndsh plugin --profile web add dsh-better-sidebar dsh-plugin-solo-thinking\n```\n\n两个包都发布在 npm 官方 Registry；不指定版本时会自动安装各自 `latest` 标签对应的版本。安装后会由各自的 `dsh.bundle.patch` 自动挂载。Solo Thinking 将 Better Sidebar 声明为可选 peer，避免重复实例；DSH 目前不会自动挂载传递依赖，所以命令中需要把两个插件都列为 profile 的直接依赖。若 pnpm 拦截 `node-pty` 构建或新包发布时间门禁，可使用下面的 Release 安装器。\n\nBetter Sidebar 0.12.1 可能打印宿主 DSH/React peer 警告；不要为消除提示把整套 DSH 或 React 重复装进 profile。已确认 Solo Thinking 自身没有缺失 peer，警告来源与上游 `@xterm/addon-fit` 版本债务见 [依赖审计](docs/DSH-PLUGIN-DESIGN-AUDIT.md#profile-peer-dependency-检查)。\n\n### 一行安装（自动使用最新 Release）\n\nmacOS / Linux（Windows 可在 Git Bash 或 WSL 中使用）：\n\n```bash\ncurl -fsSL https://raw.githubusercontent.com/fredalxin/dsh-solo-thinking/main/scripts/install.sh | bash\n```\n\nWindows PowerShell 5.1+ / pwsh：\n\n```powershell\nirm https://raw.githubusercontent.com/fredalxin/dsh-solo-thinking/main/scripts/install.ps1 | iex\n```\n\n安装器会先为 Better Sidebar 精确放行 `node-pty` / `protobufjs` 构建并将其挂载为 profile 的直接插件，再解析最新 Solo Thinking Release、下载预构建 `.tgz` 与 `.sha256`、校验后交给官方 `dsh plugin add`，最后通过 `--dump-config` 验证两个 bundle。它不会修改 DSH 源码；对 `pnpm-workspace.yaml` 的改动仅限上述构建白名单和 `dsh-better-sidebar` 的发布时间例外，重复执行保持幂等。\n\n固定版本或先预览：\n\n```bash\ncurl -fsSL https://raw.githubusercontent.com/fredalxin/dsh-solo-thinking/main/scripts/install.sh | bash -s -- 0.1.19\ncurl -fsSL https://raw.githubusercontent.com/fredalxin/dsh-solo-thinking/main/scripts/install.sh | bash -s -- 0.1.19 --dry-run\n```\n\n```powershell\n& ([scriptblock]::Create((irm 'https://raw.githubusercontent.com/fredalxin/dsh-solo-thinking/main/scripts/install.ps1'))) -Version 0.1.19 -DryRun\n```\n\n### 不执行远程脚本：官方 CLI 单行安装（固定版本）\n\n仓库提交了预构建 `lib/`，因此也可以直接固定 GitHub tag 安装；macOS、Linux 和 Windows 通用，不执行插件构建脚本：\n\n```bash\ndsh plugin --profile web add github:fredalxin/dsh-solo-thinking#v0.1.19\n```\n\n安装完成后启动或重启 DSH，再硬刷新浏览器：\n\n```bash\ndsh --profile web --dump-config\ndsh --profile web\n```\n\n源码运行 DSH 时，把命令中的 `dsh` 换成 `pnpm dsh`。\n\n### 下载后离线安装\n\n下载 Release 中的 `dsh-plugin-solo-thinking-0.1.19.tgz` 后执行：\n\n```bash\ndsh plugin --profile web add ./dsh-plugin-solo-thinking-0.1.19.tgz\ndsh --profile web\n```\n\n### 从源码构建\n\n```bash\nnpm ci\nnpm run verify\nnpm pack\ndsh plugin --profile web add ./dsh-plugin-solo-thinking-0.1.19.tgz\n```\n\n卸载：\n\n```bash\ndsh plugin --profile web remove dsh-plugin-solo-thinking\n```\n\n## 右栏模式\n\n> [!IMPORTANT]\n> 以下“对话 + 右侧头脑风暴”界面只有在 Better Sidebar 已安装并启用时才会出现。只安装 Solo Thinking 时，请使用对话顶部的完整“头脑风暴”Tab。\n\n\n\n推荐安装命令已经包含 [DSH Better Sidebar](https://github.com/omdsh-dev/DSH-better-sidebar) `0.12.1+`。如果只安装了 Solo Thinking，可以单独补装：\n\n```bash\ncurl -fsSL https://raw.githubusercontent.com/omdsh-dev/DSH-better-sidebar/main/scripts/install.sh | bash -s -- 0.12.1\n```\n\n本插件会软检测 `ctx.betterSidebar`，注册一个独立的“头脑风暴”Tab；当前会话第一次出现思考树时会自动准备该 Tab，也可以在 Better Sidebar 的“＋ 新建标签页”菜单里手动打开。思考图会占满折叠上下文后剩余的纵向空间，父节点结论、当前结论、兄弟感知和子节点结论默认折叠、按需展开。Better Sidebar 未安装或被卸载时，官方完整标签页仍提供同样四类上下文和全部 Host 侧 Thinking 能力。\n\n## 30 秒开始使用\n\n在普通 DSH 对话里说：\n\n```text\n开启头脑风暴，主题是“给独立开发者做一个本地 AI 工作台”。\n请先发散；如果有多个值得独立深挖的方向，直接建立建议分支。\n```\n\nAgent 会调用 `thinking_start`，随后在适合分裂时调用一次 `thinking_suggest`。建议分支只创建、不自动运行；点击节点可查看 Handoff，直接在树中发消息即可启动该分支。\n\n## 思考树操作\n\n- `＋ 分裂`：只填写方向名称；父 Agent 自动为新节点准备定向 Handoff。\n- `● 进展`：让当前分支从自己的完整对话整理 Current State，供兄弟分支下一次模型轮读取。\n- `✓ 回传`：分支 Agent 撰写最终 Handoff，返回父节点并封存当前分支。\n- `■ 结束`：结束并清空当前思考空间的界面状态；历史 Session 与 Handoff 保留，随后可重新开启一棵独立的新树。\n- `进入对话`：显式导航到该 Session；单击节点本身只选择，不跳转。\n- 分支输入框：给非当前分支发消息，主会话仍停留在中间。\n\nHandoff 使用简短 Markdown，覆盖目标、已确认结论、证据、风险、开放问题和下一步。兄弟分支与父分支不会被后台自动唤醒，而是在自己的下一次显式模型轮消费最新 Handoff。\n\n## DSH 架构对齐\n\n插件遵循 DSH 的服务依赖、effect 回卷、bundle/profile 分层和双端 Client Module 模型。Better Sidebar 是可选服务能力：运行时卸载不会拖垮主插件，恢复后会重新注册侧栏；但新增或删除 npm 插件会改变 DSH 的 Client Module 包集合，因此仍需重启。逐项结论和保留的 RC 兼容层见 [DSH 插件设计对齐审计](docs/DSH-PLUGIN-DESIGN-AUDIT.md)。\n\n## Thinking 工具\n\n| 工具 | 用途 |\n|---|---|\n| `thinking_start` | 在当前 Session 建立头脑风暴空间 |\n| `thinking_suggest` | 一次创建 2–4 个休眠建议方向 |\n| `thinking_split` | Agent 自主分裂并写入定向 Handoff |\n| `thinking_fork_handoff` | 为人工创建的待继承节点补齐父分支 Handoff |\n| `thinking_checkpoint` | 发布本分支 Current State |\n| `thinking_return` | 向父分支提交最终 Handoff 并封存 |\n| `thinking_end` | 结束整棵树并允许原 Session 重新开始 |\n| `thinking_status` | 读取当前节点和整棵树状态 |\n\n## 数据与安全边界\n\n- 插件不调用外部网络服务，不读取其他分支的原始对话。\n- 跨分支信息只来自显式 Handoff；发送目标由 DSH Session ID 隔离。\n- 状态随 DSH Session persistence 保存；卸载插件不会主动删除历史 Session 数据。\n- 插件包使用预构建产物且没有安装生命周期脚本；生产环境建议固定 npm 版本、GitHub tag 或 Release 校验安装器。\n- `curl | bash` / `irm | iex` 会执行公开仓库中的远程安装器；不接受这一信任模型时，请使用透明的官方 CLI 单行命令，或先下载并审阅 [`scripts/install.sh`](scripts/install.sh) / [`scripts/install.ps1`](scripts/install.ps1)。\n\n## 开发与验证\n\n```bash\nnpm ci\nnpm run check\nnpm test\nnpm run verify\n```\n\n完整 Web E2E 使用受控 Provider，但仍经过真实 DSH adapter、Agent loop、Tools、Session persistence、Projection 和 Web RPC：\n\n```bash\n# 终端 A\nSOLO_E2E_PROVIDER_KEY=solo-e2e-key npm run e2e:provider\n\n# 终端 B\nDEEPSEEK_BASE_URL=http://127.0.0.1:8000/v1 \\\nDEEPSEEK_API_KEY=solo-e2e-key \\\ndsh --profile web --patch ./scripts/e2e.patch.yml\n\n# 终端 C\nnpm run e2e:run\n```\n\n成功测试会验证：4 个休眠建议分支、Workspace 继承、Agent-authored split/checkpoint Handoff、Return、父 Session notice，以及冷启动恢复。完整说明见 [`docs/E2E.md`](docs/E2E.md)，设计边界见 [`docs/ARCHITECTURE.md`](docs/ARCHITECTURE.md)。\n\n## 与完整 Solo 的边界\n\n本插件只移植 Thinking 的核心不变量，不移植 Solo 的 Channel、Team Agent 关系、PostgreSQL、daemon 或 CLI 管理：\n\n- DSH Session 代替 Thinking Node 的独立消息作用域；\n- DSH persistence 代替进程池和数据库绑定；\n- DSH Tool 与 System Prompt context 代替 Handoff 控制协议；\n- DSH Conversation View / 可选右栏插槽代替整页 Channel 工作区。\n\n## License\n\n[MIT](LICENSE)\n","truncated":false,"reason":"GitHub metadata HTTP 403"}},{"slug":"dsh-mermaid","name":"dsh-mermaid","description":"Render Mermaid code blocks in DeepSeek Harness with a diagram/code toggle.","description_zh":"在 DSH Web 与 Desktop 对话中把 Mermaid 代码块渲染为可交互 SVG，支持源码切换、全屏缩放和平移及 SVG 导出；需要 DSH 和 Node.js 22.19+。项目自述最近 UI 检查为 2026-10-28，未覆盖完整回归或原生 Desktop 窗口。","description_en":"Renders Mermaid code blocks as interactive SVGs in DSH Web and Desktop, with source switching, fullscreen zoom and pan, and SVG export. Requires DSH and Node.js 22.19+. Its README reports a 2026-10-28 UI smoke check, not full regression coverage.","author":"Mrmo072","install_spec":"dsh-mermaid","repo":"https://github.com/MrmoLabs/dsh-mermaid","github_repo_id":1343511865,"category":"ui-theme","tags":["mermaid","diagram-rendering","svg-export","markdown"],"trust":"community","source":[{"kind":"github","url":"https://raw.githubusercontent.com/MrmoLabs/dsh-mermaid/5fc59cde411f38a0d8930146c384881c9ff5046c/package.json","fetched_at":"2026-11-05T22:10:23.377Z","evidence_url":"https://raw.githubusercontent.com/MrmoLabs/dsh-mermaid/5fc59cde411f38a0d8930146c384881c9ff5046c/package.json","attribution":"MrmoLabs upstream package manifest pinned to 5fc59cde411f38a0d8930146c384881c9ff5046c"},{"kind":"npm","url":"https://registry.npmjs.org/dsh-mermaid/latest","fetched_at":"2026-11-05T22:10:23.377Z","evidence_url":"https://registry.npmjs.org/dsh-mermaid/latest","attribution":"public npm package metadata declaring dsh.bundle"}],"data_as_of":"2026-11-05T22:10:23.377Z","readme":{"status":"ready","source_url":"https://github.com/MrmoLabs/dsh-mermaid/blob/5fc59cde411f38a0d8930146c384881c9ff5046c/README.md","source_sha":"0a8f30231034be65581a046d552366a566e536a5","fetched_at":"2026-11-05T22:10:24.648Z","checked_at":"2026-11-05T22:10:23.377Z","excerpt":"# dsh-mermaid\n\n[简体中文](README.zh-CN.md) | English\n\nRender Mermaid code blocks as interactive SVG diagrams in **DeepSeek Harness Web and Desktop**. Switch between source and diagram, explore large diagrams in fullscreen, and export SVG files without leaving the conversation.\n\n[](https://www.npmjs.com/package/dsh-mermaid)\n\n\n\nAn English pull request workflow rendered in a DSH conversation. [View the Mermaid source](docs/examples/pull-request-workflow.mmd).\n\n## Quick start\n\nRequires DeepSeek Harness (DSH) and **Node.js 22.19 or later**. Commands below use Windows PowerShell; on macOS or Linux, use `npx` and `npm` in place of `npx.cmd` and `npm.cmd`.\n\n### 1. Install\n\nWith a global `dsh` command, install the npm release into your Web profile:\n\n```powershell\ndsh plugin --profile web add -w dsh-mermaid\n```\n\nIf `dsh` is not on your PATH, invoke it through npx:\n\n```powershell\nnpx.cmd --yes @deepseek-ai/dsh plugin --profile web add -w dsh-mermaid\n```\n\nFor **DSH Desktop**, replace `--profile web` with `--profile desktop`. DSH installs the package through pnpm and automatically registers its `dsh.bundle` declaration in the selected profile. Restart DSH Web or DSH Desktop after installation; for an already running Web session, refresh the browser page as well.\n\n### 2. Render a diagram\n\nAsk a model to output a Mermaid fenced code block, for example:\n\n````markdown\n```mermaid\nflowchart LR\n A[Idea] --> B[Mermaid code]\n B --> C[Diagram]\n C --> D[SVG export]\n```\n````\n\nThe block opens in **Diagram** view by default. Use **Code / Diagram** to switch views. The plugin also recognizes `mermaidjs` and `mmd` fences; inline code is left unchanged.\n\n### 3. Explore and export\n\n- **Fullscreen** opens a viewer with mouse-wheel zoom, dragging, 100% reset, and fit-to-window controls. Press `Esc` to close it.\n- **Download SVG** saves the rendered diagram as a standalone file.\n- Both actions remain available in Code view once a diagram has rendered successfully.\n\n\n\n## Features\n\n- **Streaming support** — discovers new blocks as responses arrive and prevents older renders from replacing newer content.\n- **Theme and language** — follows DSH's light/dark theme and uses English or Simplified Chinese based on the page and browser language.\n- **Large-diagram viewing** — fullscreen zoom and pan, with a stable toolbar position when switching views.\n- **Accessible controls** — keyboard focus management, render/download announcements, and accessible SVG names.\n- **Bundled runtime** — pins Mermaid `11.17.0`, loads it on demand from DSH's own origin, and requires no runtime CDN. Multiple diagrams render through a serial queue.\n- **Source fallback** — uses Mermaid's `securityLevel: strict` and returns to source on rendering errors. Diagrams exceeding 50,000 characters or 2,000 lines are rejected before rendering.\n\n## Update and uninstall\n\nRun the command for your installed profile; replace `web` with `desktop` for DSH Desktop.\n\n```powershell\n# Update the npm release\ndsh plugin --profile web update -w dsh-mermaid\n\n# Uninstall\ndsh plugin --profile web remove -w dsh-mermaid\n```\n\nIf needed, replace the leading `dsh` with `npx.cmd --yes @deepseek-ai/dsh`. Restart the corresponding DSH application afterward and refresh any open Web page. See the [changelog](CHANGELOG.md) for release details.\n\n## Troubleshooting\n\n| Symptom | What to check |\n| --- | --- |\n| No Code / Diagram controls | Confirm that the plugin is installed in the profile you are using, restart DSH, and refresh the page. Use an explicit `mermaid` fenced block. |\n| Source appears with an error | Check the Mermaid syntax and the displayed error. Split diagrams that exceed 50,000 characters or 2,000 lines. |\n| Fullscreen or download is unavailable | These actions require a successfully rendered SVG. Resolve any rendering error first. |\n| GitHub installation reports a blocked build script | Follow the build-script guidance under **Install from GitHub** below. |\n\n## Compatibility\n\nThe most recent UI check was on **2026-10-28**, using Windows / Chrome, `@deepseek-ai/dsh 0.2.1-rc.3` (Web profile), and `dsh-mermaid 0.4.4`. The DSH host ran on Node.js 24.21.0 bundled with DSH Desktop.\n\nAn isolated environment with a local example conversation confirmed English flowchart rendering, toolbar display, opening and closing fullscreen, and fullscreen panning. The screenshots above come from that environment. This was a UI smoke check; it did not cover a full feature regression or the native Desktop window.\n\nDSH is a developer preview; newer versions may change its plugin loader or Markdown DOM. When [reporting an issue](https://github.com/MrmoLabs/dsh-mermaid/issues), include your DSH, plugin, and Node.js versions, Web/Desktop profile, and a minimal Mermaid example. Remove private conversation content before sharing.\n\n## Advanced usage\n\n\n ![\"npm](\"https://img.shields.io/npm/v/dsh-web-search-diy?style=flat-square&label=npm&color=cb3837\")
![\"license:](\"https://img.shields.io/npm/l/dsh-web-search-diy?style=flat-square&color=blue\")
![\"node](\"https://img.shields.io/badge/node-%3E%3D18-339933?style=flat-square&logo=nodedotjs&logoColor=white\"){kind=icon}
![\"vendors:](\"https://img.shields.io/badge/vendors-7-8A2BE2?style=flat-square\"){kind=icon}
![\"protocols:](\"https://img.shields.io/badge/protocols-4-8A2BE2?style=flat-square\"){kind=icon}
![\"dsh](\"https://img.shields.io/badge/dsh-plugin-4D6BFE?style=flat-square\"){kind=icon}