DSH Plugins Marketplace

DSH Plugins

Plugins

/

mmw-tools

m

mmw-tools

Discovered

DSH plugin: connect a DeepSeek Harness agent to a single GitHub repo via OAuth Device Flow, follow AGENTS.md, edit only the allowlisted paths, run a pre-flight validate, push to content/* branches, an

mmw-tools

mmw-devs 运维仓库的工具集。两个交付物:

  • dsh-mmw-tools/ —— 一个 DeepSeek Harness 插件,让 DSH agent 在一个已注册的 GitHub 仓库里,按仓库自己发布的 AGENTS.md 规则工作——读、只改 allowlist 中的路径、每次提交前跑 pre-flight、开 PR,并且只有宿主确认后才合并或关闭。会话用 select_repo 绑定一个仓库;用户用飞书登录,broker 用自己的 GitHub App 身份访问 GitHub。
  • mmw-tools-auth/ —— 飞书 H5 授权核心。它拥有成员、角色,以及插件在 每次工具调用时检查的 operation 授权表。
dsh-mmw-tools/           插件(bundle + stdio MCP server)
mmw-tools-auth/          飞书授权核心 + agent 路由表
contracts/               共享工具目录 / 角色 / golden 路由表

插件

dsh-mmw-tools —— broker 中介的 GitHub App 认证、MCP 工具、两个原生工具 (mmw_tools_status、mmw_tools_run)、唯一的飞书设置面板,以及加固过的工具 边界。版本和脚本见 dsh-mmw-tools/package.json。完整说明、配置和 安全模型见 dsh-mmw-tools/README.md。

# 推荐:从 monorepo 安装已提交的构建产物。
dsh plugin --profile <profile> add "git+https://github.com/mmw-devs/mmw-tools.git#path:/dsh-mmw-tools"
# 重启 DSH

# 从本地 checkout 开发安装:先构建,再用 file: 安装。
cd dsh-mmw-tools
pnpm install
pnpm build:all
dsh plugin --profile <profile> add "file:$PWD"
# 重启 `dsh web`

用 file:,不要用 link:;link: 可能让设置面板静默不加载。然后打开 Settings → MMW Tools,点击 使用飞书登录。不需要 GitHub 账号、OAuth App 或 client secret:broker 持有 GitHub App 身份,在验证飞书成员后签发仓库 token。

第一次业务调用之前,管理员必须已经在 auth core 注册仓库、给成员授予 select_repo 和需要的 operations,并且仓库 base 分支上要有 .dsh-mmw-tools.yaml。工作区必须是已注册仓库的 clone;如果不是, mmw_tools_status 会报告对应的 workspace 模式。

在受管工作区里,可以直接让 agent 绑定并工作,例如:“选择这个仓库,读规则, 把 public/data.json 里的某处改掉,跑 validation,然后开一个 PR。” agent 会 调用 select_repo、mmw_tools_run、repo_read、repo_edit 和 pr_create。 合并或关闭仍然需要宿主确认;pr_merge 还需要 broker approval。

授权核心

mmw-tools-auth Phase 1 MVP —— 飞书 OAuth(PKCE)、成员/角色、plugin token,以及 GET /v1/agent/routes。插件不根据这些路由动态挂载或卸载工具; 它静态注册所有工具,并在每次调用时检查 allowed / allowedOperations。

cd mmw-tools-auth
cp .env.example .env
node --env-file=.env src/main.mjs   # http://127.0.0.1:4326
node tests/run.mjs                  # auth-core 测试套件

配置、bootstrap-admin 流程、端点和限制见 mmw-tools-auth/README.md。部署步骤见 mmw-tools-auth/deploy/README.md。

部署: 主机布局、TLS 和验证步骤见 mmw-tools-auth/deploy/README.md。auth core 只监听 loopback;由 nginx 终止 TLS。

第一个客户:mmw-devs/ffxiv-race-ops

插件是围绕这个仓库的 AGENTS.md 契约构建的:

  • 只有 public/data.json 可以修改。
  • 分支使用 content/* 前缀——直接向 main push 会被拒绝。
  • 提交落地前必须通过 npm run validate。
  • PR 默认以 draft 打开。pr_merge 和 pr_close 需要宿主确认;pr_merge 还需要绑定 PR head SHA 的 broker approval,GitHub 的分支保护仍然决定是否 允许合并。

binding 把这些规则镜像到 dsh-mmw-tools/cordis.patch.yml,从而不需要解析 Markdown 就能执行。这种重复是故意的,也有文档记录:见 docs/OPERATIONS-SYNC.md。

目录布局

路径内容
AGENTS.mdAgent 硬规则和文档地图入口。
.dsh/skills/docs-ssot/SKILL.md语义化文档更新流程和 Doc-Impact 记录格式。
scripts/doc-map.json文档到源码的映射,以及影响检查使用的状态标签。
dsh-mmw-tools/插件:DSH bundle、stdio MCP server、设置面板、测试。
mmw-tools-auth/飞书 H5 授权核心:OAuth、成员、角色、plugin token、路由表。见 mmw-tools-auth/README.md。
mmw-tools-auth/deploy/systemd/nginx/TLS 安装、经验证的 SQLite 快照、健康检查 timer、回滚。见 deploy/README.md。
dsh-mmw-tools/README.md插件 README——安装、配置、工具、安全模型。
dsh-mmw-tools/CHANGELOG.md按 increment 的历史。
dsh-mmw-tools/docs/OAuth 走查、operations sync、按 increment 的设计记录、发布清单。
dsh-mmw-tools-design.md架构和业务逻辑设计(v2,对齐 ffxiv-race-ops 的 AGENTS.md)。
contracts/共享工具目录、角色、路由表 schema 和 golden 示例。见 contracts/README.md。当前角色/操作矩阵:contracts/REFERENCE.md(生成的)。
scripts/check-contracts.mjs校验目录,重新生成 golden 路由表和 contracts/REFERENCE.md。
scripts/check-docs.mjs拒绝 living 文档里的过期标识符,以及长期文档缺失状态标签。见 docs/DOCUMENTATION.md。
scripts/doc-impact.mjs把改动源码映射到定义它们的文档;文档未更新时失败。
docs/OBSERVABILITY.mdrun id、审计事件,以及为什么 trace 存储是有界 JSONL 而不是 collector。
docs/CONFORMANCE.md2026-11-11 的“声明 vs 证据”快照;historical,不代表当前行为。
docs/MULTI-REPO-ROUTING.md多仓库授权的目标设计;已实现的部分记录在 docs/ADR-0001-MULTI-REPO.md。
docs/ADR-0001-MULTI-REPO.md仓库注册表和“一会话一仓库”绑定的决策记录,包括 2026-11-13 的 select_repo 修正。
docs/TOOL-NAMING.md工具/operation 命名规则:仓库不进名字,CI 检查格式。
scripts/prune-merged-branches.mjs只有所有依赖和保留检查都通过后,才删除远端分支。
mmw-tools-routing-layer-plan.md以飞书 H5 授权为中心的功能路由计划:auth core 拥有目录和策略;DSH 插件静态注册工具并逐次授权。
mmw-tools-routing-state-machine.md静态注册 + 调用时授权的 Auth、Policy、Transport、Tool Call 状态机。
dsh-plugin-api-cheatsheet.mdDSH 0.1.5 插件 API 参考,摘自 zhengjy01/dsh-feishu-mcp 并对照 DSH 源码。
github-oauth-app-checklist.md旧 GitHub 用户 OAuth 笔记;插件不再使用这条登录路径。
lark-vs-dsh.md研究笔记:DSH 的飞书相关插件 vs 官方 lark-cli。

工具契约

contracts/tools.json 是飞书授权核心和 DSH 插件共享的工具目录。它定义每个 工具的 roles、requiredPermissions、operations 和 risk。目录由 core 拥有; 插件静态实现每个 operation,并在每次调用时检查 core 的 allowed / allowedOperations。

没有 role → permission 表:角色决定谁可以使用工具;requiredPermissions 描述工具本身需要什么。

node scripts/check-contracts.mjs
node scripts/check-contracts.mjs --update   # 有意改动目录之后
node scripts/check-docs.mjs

golden 路由表在 contracts/examples/;人类可读的矩阵是 contracts/REFERENCE.md,两者都是生成的。不要手改。v2 模型见 contracts/README.md,稳定错误码见 ERRORS.md,权威文档见 docs/DOCUMENTATION.md。

文档

AGENTS.md 持有硬规则并链接地图; scripts/doc-map.json 说明每个文档定义什么、哪些源码 改动需要触碰它;.dsh/skills/docs-ssot/SKILL.md 是语义更新流程。提交前:

node scripts/doc-impact.mjs --base origin/main --worktree

CI 对 PR base 跑同样的检查,所以改了源码却没更新文档会导致构建失败。生成文档 只把生成输入列为 sources;消费它们的运行时代码由定义行为的 living 文档覆盖, 而不是由生成快照覆盖。它还会拒绝漏掉 tracked markdown 的 map,或匹配不到任何 文件的 source glob。--worktree 会在进入 CI 前报告未登记的新 markdown。 AGENTS.md 链接地图而不是复制它,所以只有一张表要维护。

分支清理

scripts/prune-merged-branches.mjs 只有在以下条件全部满足时才删除远端分支: PR 已合并;它没有 base 分支之外的提交;没有 open PR 把它当 head 或 base;它 没有受保护;没有 workflow/config 引用它;合并时间早于保留窗口(默认 7 天)。 脚本默认 dry run,除非传 --apply;未知或不可读的信号会保留分支。

GITHUB_TOKEN="$(gh auth token)" node scripts/prune-merged-branches.mjs
GITHUB_TOKEN="$(gh auth token)" node scripts/prune-merged-branches.mjs --apply
node --test scripts/prune-merged-branches.test.mjs

.github/workflows/branch-cleanup.yml 每周带 --apply 运行;手动运行默认 dry run。用 --keep <pattern> 添加长期例外。

验证

node scripts/check-contracts.mjs
node scripts/check-docs.mjs
node scripts/doc-impact.mjs --base origin/main
node --test scripts/doc-impact.test.mjs
node mmw-tools-auth/tests/run.mjs
node --test scripts/prune-merged-branches.test.mjs
cd dsh-mmw-tools
pnpm check                    # typecheck、namespace 和全量测试
cd mcp-server && pnpm test    # MCP guard 和 schema 套件

许可证

MIT © 2026 mmw-devs。见 dsh-mmw-tools/LICENSE。

Comments

Loading…

Similar plugins

dsh-github-aide

by maxid

DeepSeek Harness plugin: publish a workspace or project directory to GitHub — read-only preflight, secret scan, .gitignore generation, repository creation, commit, divergence handling, and push.

Manifest valid

★ 0

MIT

JavaScript

Nov 2, 2026

dsh plugin --profile web add dsh-github-aide

by LeeLee592

Provides DeepSeek Harness (DSH) agents with Obsidian plugin development capabilities: scaffolding, validation, version syncing, plus a development-guidelines skill.

Manifest valid

★ 0

MIT

TypeScript

Sep 23, 2026

dsh plugin --profile web add @leelee592/dsh-obsidian-plugin

by iasiv5

DSH 插件市场:Marketplace for DeepSeek Harness plugins · dsh-m

Tools & CapabilitiesManifest valid

★ 35

↓ 9.1k/wk

MIT

JavaScript

Nov 20, 2026

dsh plugin --profile web add dsh-m

by Yazzyk

DeepSeek Harness (dsh) 插件:在 Web GUI 里手动点选文件或目录,屏蔽 agent 对它们的读取、搜索、写入与编辑。A dsh plugin that denies an agent read/search/write/edit access to chosen files and directories, picked from the plugin's own We

Security & AuditUI & ExperienceDevelopment & InfrastructureManifest valid

★ 3

MIT

JavaScript

Nov 8, 2026

dsh plugin --profile web add dsh-file-shield

by ZSeven-W

DeepSeek Harness (DSH) plugin: a read-only ledger for the plugins you already have installed — a capability inventory with file:line evidence, declared-vs-detected reconciliation, cross-profile versio

Security & AuditManifest valid

★ 30

↓ 204/wk

MIT

JavaScript

Nov 21, 2026

dsh plugin --profile web add @zseven-w/dsh-harbor

by fazhu4

DSH plugin manager: official/community grouped plugin list with localized descriptions, one-click enable/disable and uninstall, plus a GitHub dsh-plugin market tab.

Terminal & ClientsManifest valid

★ 4

↓ 159/wk

MIT

TypeScript

Aug 18, 2026

dsh plugin --profile web add dsh-plugin-studio