DSH Plugins Marketplace

DSH Plugins

Plugins

/

Development & Infrastructure

/

dsh-confluence

d

dsh-confluence

Manifest valid

Read, search, create, update, move, and delete Confluence pages, comments, attachments, and content properties through 29 typed tools, plus a settings page for the site, credentials, and write approva

UI (client)hasBundlePatch

dsh-plugin-confluence

A DeepSeek Harness bundle that puts Atlassian Confluence into every DSH session: 29 typed confluence_* tools, a confluence skill, and a Settings page for the connection and the write policy.

中文说明见 README_ZH.md(纯文本版)。

Every call is executed by confluence-cli in a child process, so authentication, rate limiting, Markdown↔storage conversion, and JSON envelopes behave exactly as they do in a terminal — and the CLI stays the single implementation of the Confluence API surface.

Tools

AreaTools
Read (13)confluence_read, confluence_search, confluence_info, confluence_find, confluence_spaces, confluence_children, confluence_export, confluence_convert, confluence_versions, confluence_comments, confluence_attachments, confluence_property_list, confluence_property_get
Write (16)confluence_create, confluence_create_child, confluence_update, confluence_move, confluence_delete, confluence_comment_create, confluence_comment_delete, confluence_property_set, confluence_property_delete, confluence_attachment_upload, confluence_attachment_delete, confluence_version_delete, confluence_copy_tree_preview / confluence_copy_tree, confluence_versions_purge_preview / confluence_versions_purge

Read tools always register. Write tools register only when the plugin row enables them with an allowed-space list; a write runs local preflight, checks that allowlist, asks the harness approval channel, then mutates. Bulk operations are two-step: a preview resolves every affected page and returns a single-use approval id, and the execute tool accepts nothing else.

Every result is prefixed as untrusted external content.

Requirements

  • DeepSeek Harness with a profile (tested on 0.2.2).
  • Node.js 20 or newer.
  • Confluence credentials: CONFLUENCE_* environment variables, confluence init, the macOS Keychain, or ~/.netrc. The plugin stores nothing by itself.

Install

From this repository — in DSH, add the plugin by spec:

Plugins → Add plugin → https://github.com/liujia1128/dsh-confluence

or from an agent session, plugin_manager with action: install_bundle and that address as target.

From a clone (development, or a pinned revision):

git clone https://github.com/liujia1128/dsh-confluence
cd dsh-confluence
npm install          # the bundle needs its own dependencies when linked

then add the checkout directory as the plugin. A local directory install links the folder, so edits apply after a plugin reload.

Offline / air-gapped machine — the runtime dependencies are committed to this repository, so no package install is needed:

# on the offline machine, from the repository folder
node scripts/install-offline.mjs     # verifies deps/node_modules.tar.gz, extracts it

Then add this directory as the plugin (local directory install). Do not add the git address on an offline machine: that path runs a package install and needs the network. npm run deps:pack rebuilds the archive from package-lock.json after a dependency change; details in deps/README.md.

Configure

Open Settings → Confluence — the page this bundle contributes. Three values are enough to start: site URL, the email you sign in with (Cloud), and an API token. For Server 6.x without PAT, use username + password with basic auth instead. The host name and REST base path are derived from the site URL; fill them only to override the derivation.

AreaFields
Site and authenticationSite URL, host name (optional), API base path, authentication (basic/bearer), email, username, CLI profile, API token
Write accessRegister write tools, allowed space keys, approval mode
Current runtimeRegistered tool count, allowed spaces, approval mode, CLI root

Saving writes the confluence row of this profile's cordis.patch.yml through configEditor and the loader reconciles it immediately, so the tool set changes without a restart. Test connection runs one spaces --limit 1 read and reports the space count or the CLI's own error. The token is stored in that row and is only ever echoed back as "set"; use CONFLUENCE_API_TOKEN in the environment if it must not live in the file.

The same row can be written by hand:

- id: confluence
  name: dsh-plugin-confluence
  config:
    writes: true
    spaces: [ENG, DOCS]
    confirm: ask
    confluence:
      domain: company.atlassian.net
      apiPath: /wiki/rest/api
      authType: basic
      email: you@company.com
    env:
      CONFLUENCE_API_TOKEN: !!js process.env.CONFLUENCE_API_TOKEN
KeyDefaultMeaning
siteUrl / domain—The site, as a full URL or a bare host name. A site URL alone is enough: the host name and REST base path are derived from it.
apiPath—/wiki/rest/api on Cloud, /rest/api on Server/Data Center.
authTypebasicbasic (email + API token) or bearer (Data Center personal access token).
email / username—Identity for basic.
token—API token; falls back to the environment, the Keychain, or ~/.netrc.
profile—A confluence-cli named profile.
writesfalseRegister the write tools.
spaces—Allowed space keys; wildcards are rejected. Empty disables writes.
confirmaskask routes every write through the harness approval channel; never skips it.
preflightTtlMs300000Lifetime of a bulk approval id.
packageRootautoconfluence-cli package directory, when you want a specific copy.
nodePathDSH runtimeJavaScript runtime used for the CLI child process.
skilltrueRegister the confluence skill.

CONFLUENCE_READ_ONLY=true always wins: the write tools are not registered.

Which confluence-cli runs?

First hit wins:

  1. packageRoot on the plugin row;
  2. CONFLUENCE_CLI_ROOT in the environment;
  3. a checkout that surrounds this bundle (.. twice) — how the upstream repository develops it;
  4. the confluence-cli dependency this package installs.

A wrong or missing candidate fails loudly at activation with instructions, rather than silently picking another copy.

Safety model

  1. Write tools exist only with an explicit enable and a non-empty space allowlist.
  2. Each ordinary write runs local preflight (which resolves the real title, id, and space), checks the allowlist, then requests one-use approval from the harness. The preflight summary is the audited approval reason.
  3. Bulk writes are preview → execute: the execution re-runs preflight, rejects a changed plan with STALE_PREFLIGHT, and asks for approval again.
  4. Files touched by a write (body, property, attachment uploads) are hashed before approval and re-hashed after it (STALE_FILE); local paths must stay inside the session working directory.
  5. A write that times out or is interrupted fails as UNKNOWN_RESULT and is never retried automatically.
  6. The Settings API is three same-origin routes under /dsh-confluence; each requires the page's own x-dsh-confluence header and a loopback Host, and refuses a mismatched Origin.

Development

npm install
npm test

The suite covers configuration resolution, the tool surface, argument validation, read/write/bulk execution, approval wiring, the settings routes, the client module contract, and the offline dependency archive (66 tests). CI runs npm ci + npm test on Node 20 / 22 / 24.

After changing a dependency, rebuild the offline archive on a machine with network access:

npm run deps:pack     # rewrites deps/node_modules.tar.gz and deps/node_modules.sha256

Commit both files together — the checksum is what makes the archive trustworthy, and the tests fail when they disagree.

PathRole
index.jsESM entry: apply, inject, plugin name, Config schema.
lib/plugin.cjsWires config, engine, tools, approval, skill, and the settings routes.
lib/engine.cjsResolves confluence-cli and loads its lib/pi/* engine.
lib/config.cjsRow config + environment → CLI environment and write policy.
lib/tools.cjsTool specs, schemas, and per-call execution.
lib/args.cjsArgument validation for the declared schema subset.
lib/settings-route.cjsThe three settings routes: state, save, test.
client/client.jsThe Settings page and its navigation icon (browser module).
SKILL.mdThe confluence skill contributed at activation.
docs/DETAIL.mdLonger configuration and behaviour notes shown in Plugin Manager.
locale/, icon.svgPlugin Manager display metadata.
deps/Committed runtime dependency archive and its checksum, for offline installs.
scripts/deps:pack rebuilds the archive; deps:install extracts it offline.

License

MIT

Comments

Loading…

Similar plugins

dsh-share

by 991206772-debug

Turns the current conversation into a shareable analysis: overview, prompts, conclusion, todos, tools, files, plus one read-only link for other people.

Manifest valid

★ 0

MIT

JavaScript

Nov 8, 2026

dsh plugin --profile web add @local/dsh-share

Backs up and syncs DSH configuration, model routes, MCP rows, plugin inventory, skills, memory and chosen directories to WebDAV. Each scope can be enabled independently with push or two-way sync; file

Tools & CapabilitiesManifest valid

★ 1

MIT

JavaScript

dsh plugin --profile web add @stone-yu/dsh-sync

by leanderli

DSH Web UI 的文件与变更面板插件:为当前会话的工作区目录提供一体化的 文件浏览 / 搜索 / 预览 / 编辑与 Git 操作(状态、暂存、提交、拉取、推送、 分支、历史、diff 等),在浏览器里以居中模态面板呈现,无需离开 WebUI 即可完成 日常文件与版本控制操作。

Development & InfrastructureManifest valid

★ 2

MIT

JavaScript

Oct 10, 2026

dsh plugin --profile web add dsh-files-git

by zengxiaolou

Annotation browser in the DSH sidebar: a real Chrome page streamed over CDP with input forwarded, where picking an element or selecting text attaches its source location, component stack, styles and a

Tools & CapabilitiesDevelopment & InfrastructureManifest valid

★ 1

MIT

JavaScript

Oct 26, 2026

dsh plugin --profile web add dsh-annotate-browser

DSH 的浏览器:登录一次,它就用你的账号替你办事(查后台/填表/抓列表/多标签);要登录、验证码、弹框会停下来等你,绝不替你点「确定」;你最小化它就不吵你,AI 在哪动手你随时看得见

Tools & CapabilitiesManifest valid

★ 2

MIT

TypeScript

dsh plugin --profile web add dsh-browser-playwright-codex

by huazhiliange

Share any DeepSeek Harness (DSH) session as a self-contained, read-only static webpage — timeline, collapsible tool calls & reasoning, default redaction, dual SHA-256 fingerprints, watermark.

Manifest valid

★ 0

JavaScript

Aug 20, 2026

dsh plugin --profile web add dsh-share-page