Skip to content

Add BookStack plugin v0.0.1 submission package#2616

Merged
crazywoola merged 3 commits into
langgenius:mainfrom
pandaria75:bookstack-v0.0.1
Jul 1, 2026
Merged

Add BookStack plugin v0.0.1 submission package#2616
crazywoola merged 3 commits into
langgenius:mainfrom
pandaria75:bookstack-v0.0.1

Conversation

@pandaria75

Copy link
Copy Markdown
Contributor

Plugin Submission

Plugin information

Submission type

  • New plugin
  • Version update

What changed

BookStack Dify Tool plugin for publishing, reading, and syncing BookStack pages. This submission includes the BookStack tool manifest, provider, tools, privacy policy, README, and the packaged v0.0.1 .difypkg artifact.

Implemented capabilities include credential validation, page search, page read/write, publish, and listing tools for books/chapters/shelves/pages. The plugin uses self-hosted BookStack credentials supplied through the Dify provider form.

Release tag: https://github.com/pandaria75/dify-plugin-bookstack/releases/tag/v0.0.1

Risk level

  • Low risk
  • Medium risk
  • High risk

Required checks

  • I have read and followed the Marketplace submission requirements.
  • I have read and comply with the Plugin Developer Agreement.
  • I tested this plugin on Dify Community Edition and Dify Cloud, or documented any limitation below.
  • The package contains only files needed at runtime.
  • The package does not contain secrets, local credentials, .env files, .git directories, virtual environments, caches, logs, or IDE files.
  • The package does not contain executables or bundled binaries, or I explained why they are required below.
  • The plugin README includes setup steps, usage instructions, required APIs or credentials, connection requirements, and the source repository link.
  • The plugin includes PRIVACY.md or a hosted privacy policy, and manifest.yaml references it.
  • All user-facing text is primarily in English, with any localized README files following the i18n guidance.

Security and privacy notes

Writes to a third-party BookStack instance using user-supplied API credentials. No command execution, SQL, browser automation, filesystem access, or arbitrary URL fetching. token_secret is not logged, and the package is source-only.

Local validation

  • dify plugin package "/tmp/opencode/bookstack-package-clean-20260628" --output_path "dist/bookstack-0.0.1.difypkg" → success
  • python3 zip inspection of dist/bookstack-0.0.1.difypkg → no bookstack_datasource/, .git/, .task/, .agents/, .aiassistant/, tests/, __pycache__/, or .pyc entries
  • gh release view v0.0.1 → release exists with bookstack-0.0.1.difypkg asset
  • Dify import/runtime smoke → NOT_RUN (no approved smoke environment in this task)

Reviewer notes

  • This is a new plugin submission for BookStack, not a version bump of a Marketplace-listed plugin.
  • The official upstream PR is based on release v0.0.1 and includes the packaged artifact plus privacy documentation.
  • Datasource packaging/submission is out of scope for this PR.

@crazywoola crazywoola left a comment

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

❌ Request Changes

Decision: Request changes

Failed Checks

Check Status Detail Required action
Project structure ❌ Fail Missing files: PRIVACY.md. Present: manifest.yaml, README.md. _assets/: yes. Include all required files in the package: manifest.yaml, README.md, PRIVACY.md, and _assets/.
PRIVACY.md ❌ Fail PRIVACY.md not found in plugin package. A privacy policy file is required for marketplace submission. Add a non-empty PRIVACY.md file to the plugin package.

Full Check Results

Check Status Detail Required action
PR content language ✅ Pass PR title/body CJK ratio=0.0% (zh=0, en=2315, ignored_zh=0, allowed_zh<=0) None.
Project structure ❌ Fail Missing files: PRIVACY.md. Present: manifest.yaml, README.md. _assets/: yes. Include all required files in the package: manifest.yaml, README.md, PRIVACY.md, and _assets/.
Manifest author ✅ Pass author is valid. None.
Icon validation ✅ Pass icon exists: _assets/icon.svg None.
Version check ✅ Pass version 0.0.1 is available. None.
README language ✅ Pass README.md CJK ratio=0.0% (zh=0, en=1626, allowed_zh<=0) None.
PRIVACY.md ❌ Fail PRIVACY.md not found in plugin package. A privacy policy file is required for marketplace submission. Add a non-empty PRIVACY.md file to the plugin package.
Dependency install ✅ Pass requirements installed successfully. None.
dify_plugin version ✅ Pass dify_plugin version 0.9.1 satisfies >= 0.9.0. None.
Install test ✅ Pass plugin install test passed. None.
Packaging test ✅ Pass packaging check passed. None.

Next steps

  • Project structure: Include all required files in the package: manifest.yaml, README.md, PRIVACY.md, and _assets/.
  • PRIVACY.md: Add a non-empty PRIVACY.md file to the plugin package.

Please address these issues and push an update.

@pandaria75

Copy link
Copy Markdown
Contributor Author

Updated the submission package to address the requested changes.\n\nChanges made:\n- Added to .\n- Rebuilt and re-uploaded ; the package now includes , , , and .\n- Verified the package does not include , caches, tests, datasource files, or .\n- Pushed the updated package and matching source files to this PR branch.\n\nRelease asset was also updated at: https://github.com/pandaria75/dify-plugin-bookstack/releases/tag/v0.0.1

@pandaria75

Copy link
Copy Markdown
Contributor Author

Correction to my previous update comment: the branch has been updated to address the requested changes.

Changes made:

  • Added privacy: PRIVACY.md to manifest.yaml.
  • Rebuilt and re-uploaded bookstack-0.0.1.difypkg; the package now includes manifest.yaml, README.md, PRIVACY.md, and _assets/icon.svg.
  • Verified the package does not include .git/, caches, tests, datasource files, __pycache__/, or .pyc files.
  • Pushed the updated package and matching source files to this PR branch.

Release asset was also updated at: https://github.com/pandaria75/dify-plugin-bookstack/releases/tag/v0.0.1

@crazywoola crazywoola left a comment

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

✅ LGTM

Decision: Approve

Local Check Results

Check Status Detail Required action
PR content language ✅ Pass PR title/body CJK ratio=0.0% (zh=0, en=2315, ignored_zh=0, allowed_zh<=0) None.
Project structure ✅ Pass All expected files present: manifest.yaml, README.md, PRIVACY.md. _assets/: yes. None.
Manifest author ✅ Pass author is valid. None.
Icon validation ✅ Pass icon exists: _assets/icon.svg None.
Version check ✅ Pass version 0.0.1 is available. None.
README language ✅ Pass README.md CJK ratio=0.0% (zh=0, en=2699, allowed_zh<=0) None.
PRIVACY.md ✅ Pass PRIVACY.md exists and is non-empty. None.
Dependency install ✅ Pass requirements installed successfully. None.
dify_plugin version ✅ Pass dify_plugin version 0.9.1 satisfies >= 0.9.0. None.
Install test ✅ Pass plugin install test passed. None.
Packaging test ✅ Pass packaging check passed. None.

@crazywoola crazywoola merged commit 0bcf66d into langgenius:main Jul 1, 2026
@pandaria75 pandaria75 deleted the bookstack-v0.0.1 branch July 1, 2026 10:36
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants