Cursor 能力移植包 lnuxe/dsh-plugins

DeepSeek Harness 插件集合（dsh-plugins）

一组自托管的 DeepSeek Harness（DSH）bundle 插件与 agent 预设，覆盖 agent 技能、移动测试 MCP、系统提示词、可观测性、MCP 工具过滤、生命周期 hook、工作区规则、根编排、浏览器自动化与 git 分支指示器等能力。

所有插件均为零外部依赖的本地 bundle（@local/），通过 cordis.patch.yml 挂载到 DSH 的 web profile。

插件清单

| # | 插件 | 路径 | 能力 |
| A | @local/dsh-skills | dsh-skills/ | 26 个内置 agent skill（canvas / review / goal / loop / visualize 等） |
| B | @local/dsh-mcp-mobile | dsh-mcp-mobile/ | 移动测试 MCP（mobile-mcp / appium / wdio / adb / dart / perfdog） |
| C | @local/dsh-persona | dsh-persona/ | agent 系统提示词 preset |
| D | @local/dsh-telemetry | dsh-telemetry/ | skill / goal 可观测性统计 |
| E | @local/dsh-mcp-policy | dsh-mcp-policy/ | MCP 工具级过滤（server 开关 / allowlist / denyTools） |
| F | @local/dsh-hooks | dsh-hooks/ | 生命周期 hook（PreToolUse veto 门 + 7 事件桥接） |
| G | @local/dsh-rules | dsh-rules/ | 工作区规则（.cursor/rules/.mdc + AGENTS.md） |
| H | @local/dsh-orchestrator | dsh-orchestrator/ | 根编排 agent preset |
| I | @local/dsh-automation | dsh-automation/ | 浏览器 / 电脑操作自动化 preset |
| J | @local/dsh-git-branch | dsh-git-branch/ | composer git 分支指示器 + 切换器 |

插件说明

A — @local/dsh-skills（内置 agent skill provider）

把 26 个常用 agent skill（automate、autopilot、canvas、create-hook、create-rule、create-skill、create-subagent、goal、loop、migrate-to-skills、new-repo、onboard、origin、rename-chat、review、review-bugbot、review-security、sdk、share、shell、split-to-prs、statusline、update-cli-config、update-cursor-settings、visualize、dsh-orchestrator）打包为 DSH 的 bundled skill provider。

- index.js 零外部依赖（node:fs/promises、node:url），rank = 600（对齐 BUNDLED_SKILL_RANK）。
- 注册在 host 全局层（ctx.skills），所有 preset 可见。
- skill 正文里引用的上游专属工具/命令会在加载时前置一段「DSH 工具适配」说明，映射到 DSH 等价物（见 dshtool-map.json）。

B — @local/dsh-mcp-mobile（移动测试 MCP preset）

把移动端测试常用的 MCP server 收敛到一个 mobile-test preset，避免日常会话为这些工具 schema 付出 token 成本：

| server | transport | 命令 / 地址 |
| mobile-mcp | stdio | npx -y @mobilenext/mobile-mcp@latest |
| appium-mcp | stdio | npx appium-mcp@latest |
| wdio-mcp | stdio | npx -y @wdio/mcp |
| adb-mcp | stdio | npx -y @landicefu/android-adb-mcp-server |
| dart | stdio | dart mcp-server --experimental-mcp-server --force-roots-fallback |
| perfdog-mcp-tools | streamable-http | https://perfdog.qq.com/mcp |

HTTP 密钥在加载时通过 !!js + process.getBuiltinModule('fs') 运行时读取，不落盘到插件。

C — @local/dsh-persona（agent 系统提示词 preset）

新增可选 agent preset（order 20），提供一套 agentic 编码系统提示词（<communication> / <tool_calling> / <search_and_reading> / <making_code_changes> / <maximize_parallel_tool_calls> / <task_management> / <citing_code> / <orchestration> 等分节），工具集与 standard 对齐。

D — @local/dsh-telemetry（可观测性）

零依赖内存态统计，包装 ctx.skills.get 记录 skill 触发次数，监听 skills/change 与 goal/changed。句柄 ctx.dshTelemetry 提供 .stats() / .reset()。

E — @local/dsh-mcp-policy（MCP 工具级过滤）

三级过滤：enabledServers（整 server 开关）→ toolAllowlist（per-server 白名单）→ denyTools（单工具禁用）。用 plain-context tools.guard 做全局守卫，被禁工具调用时返回 deny 原因。

F — @local/dsh-hooks（生命周期 hook）

把 7 个生命周期事件桥接到用户 shell 命令：PreToolUse→tools/pre-execute、PostToolUse→tools/result、UserPromptSubmit→agent/inbox/inserted、Stop→agent/turn-stopping、SubagentStop→subagent/end、SessionStart→agent/created、SessionEnd→agent/disposed。

PreToolUse 为 veto 门：exit code 2 或 stdout {"permissionDecision":"deny"} 阻止工具派发。

G — @local/dsh-rules（工作区规则 + AGENTS.md）

读取 .cursor/rules/*.mdc（YAML frontmatter description / globs / alwaysApply）：

- alwaysApply: true 的规则注入 <always_applied_workspace_rules> 分节（order 400）。
- globs 规则按 name+description+glob 广告（agent 按需读文件）。
- 额外从 cwd 向上遍历收集 AGENTS.md，注入独立 cloud_instructions 分节（order 405）。

H — @local/dsh-orchestrator（根编排 agent preset）

新增 dsh-orchestrator preset（order 30）：plan → delegate subagents → progress.md 持久状态 → 安全并行。工具映射 CREATE_TASK → subagent/subagent_fork、SEND_TO_TASK → send_message、AskQuestion → ask_user_question。

I — @local/dsh-automation（浏览器 / 电脑操作自动化 preset）

新增 automation preset，挂载 Playwright 与 computer-use MCP，让 agent 具备浏览器操作与屏幕控制能力，工具集独立于日常编码会话。

J — @local/dsh-git-branch（composer git 分支指示器）

在 composer dock 渲染当前 git 分支 pill，点击弹出 Local / Remote 分支选择器：

- host 半 git_branch 工具用 git for-each-ref 列出本地 + 远程分支。
- client 半读 .git/HEAD + workspaceFiles，支持 submodule / worktree（.git 为 gitdir: 文件时解析真实 git 目录）。
- 选中分支后把 git checkout 草稿写入 composer，人工确认后执行。

安装

各 bundle 通过 plugin_manager install_bundle 装进目标 profile（link: 到本仓库目录），或直接把 cordis.patch.yml 的 insert 片段并入你的 composition：

- insert:
- id: dsh-skills
name: '@local/dsh-skills'
- id: dsh-git-branch
name: '@local/dsh-git-branch'

改 index.js 模块不会热更新（HMR 只 watch cordis.patch.yml），需重启 dsh 才重新加载。

文档

| 文档 | 内容 |
| docs/why-dsh-is-smooth.md | 工程实践调研：系统提示词分节 / skill 检索 / MCP 自动发现 / 上下文注入 / 长任务编排 |
| docs/orchestration.md | 触发与编排分析：一次 turn 的触发链、skill 门控、MCP 过滤、hook 事件、subagent 编排 |
| docs/canvas-sdk.md | Canvas SDK + 编译渲染分析 |

License

MIT