geml-spec/geml#integrations/dsh-plugin

English | 中文

本插件为 harness 提供 Agent-Native 的文档处理能力。多轮交互最容易被 Token 膨胀拖垮——整篇读进来、整篇写回去，内容越滚越臃肿，也越来越偏离事实。 GEML 把文档呈现为可寻址的块，让 LLM 能精准理解与改写：取一个小节、写回一个小节，Token 只需零头，宝贵的上下文窗口 留给真正的工作。内建的引用机制维持单一数据源（Single Source of Truth），事实不再散落成互相漂移的副本，Agent 可以零负担地读写与维护。

这个 bundle 带三样东西：

• GEML MCP server —— 一行 @deepseek-ai/dsh-mcp-client，运行 npx -y @geml/geml mcp --root .，限定在会话自己的项目目录内。模型看到的是 mcp__geml__geml_get、mcp__geml__geml_set、mcp__geml__geml_check 等工具， 于是一次改一个块，而不是重写整个文件。
• 写作技能（skills/geml/）—— 黄金规则、校验闭环，以及一份分节的参考文档 （references/authoring.geml），Agent 按需取其中一节。
• 代码图谱技能（skills/geml-code-graph/）—— 构建、查看、更新和浏览项目的 调用图：谁调用了 X、X 调用了谁、影响路径，并在浏览器里渲染出图。

这个 bundle 自身不含任何代码——它配置的两个插件都随 dsh 安装自带，技能则是 Markdown。安装时不构建任何东西，因此完全不涉及 allowBuilds 构建授权。

安装

dsh plugin --profile web add @geml/dsh-plugin

先不启动、只验证这一层，再启动：

dsh --profile web --dump-config   # 应能看到 "# == @geml/dsh-plugin" 这一层
dsh --profile web

dsh plugin --profile web remove @geml/dsh-plugin 会同时移除依赖和这一层。

配置

两行都是普通配置：在你 profile 的 cordis.patch.yml 里按 id 覆盖即可，注意 要把该行需要的每个键都重新写全。例如把 mcp-geml 钉到某个 CLI 版本：

- id: mcp-geml
  name: '@deepseek-ai/dsh-mcp-client'
  config:
    serverName: geml
    transport: stdio
    command: npx
    args: ['-y', '@geml/geml', 'mcp', '--root', '.']

用 PATH 上的全局 geml 也可以——把 command 改成 geml，去掉 npx 那几个 参数。

想要 CLI 和同一套技能用在 Claude Code 上：npx -y @geml/geml skill install， 或使用 ../claude-plugin 下的插件。