Hacktoberfest 2026：維護者為十月標記出來的 issue，仍然開放、適合新手。 瀏覽 Hacktoberfest issue

Docs: plugin install vs disable vs uninstall lifecycle and enabled-state ground truth

未關閉
  • 哪裡不對？
#136 1 則留言 0 個 reaction 已指派 0 人 在 GitHub 檢視

維護者通常 1 天內回覆

還沒有人認領這個 Issue。

評估

難度
3/5
預估耗時
1-2 天
新手友好度
68/100
Issue 類型
文件
描述清晰度
基本清楚
活躍度
活躍
技術堆疊
sqlite
領域
cli, documentation

研究方向

首先找到 plugin 文件，並連同 ~/.config/Cursor/User/globalStorage/state.vscdb 與 ~/.cursor/cli-config.json 一起檢視 /plugins 和 /plugin uninstall 進入點。記錄安裝、停用與解除安裝的生命週期，找出啟用狀態鍵，並包含所要求的 CLI 以及新工作階段的疑難排解指南。

由索引模型根據 Issue 內容生成。

描述

Summary

There is no single doc that explains install vs disable vs uninstall for Cursor marketplace plugins, or where enabled state actually lives on disk. This causes repeated misdiagnosis (especially CLI-first users) when disabled plugins still appear under /plugins or when slash commands from a disabled plugin persist in autocomplete.

Related: #130 (opt-out / deactivate skills globally).

Problem

Users (and agents troubleshooting plugin state) commonly assume:

  • If ~/.cursor/plugins/cache/cursor-public/<slug>/ exists → plugin is enabled
  • If /plugins lists a plugin → plugin is enabled
  • Moving/deleting cache dirs → valid way to disable

None of these match observed behavior on Cursor CLI (agent 2026.06.19, Linux).

Observed semantics

Action Disk effect Agent effect
Install (marketplace) Creates/updates cache under ~/.cursor/plugins/cache/cursor-public/<slug>/ Plugin ID added to enabled list
Disable (toggle in /plugins detail or Settings) Cache retained Plugin ID removed from enabled list
Uninstall (/plugin uninstall <name>) Removed from installed scope Must reinstall from marketplace
Ground truth for enabled plugins

SQLite: ~/.config/Cursor/User/globalStorage/state.vscdb

cursor.plugins.installedIds.no-team
cursor.plugins.installedIds.no-workspace   # workspace-scoped overrides

Value is a JSON array of numeric marketplace plugin IDs.

Naming confusion: key says installedIds but value represents enabled IDs only — not "all plugins ever installed."

CLI ~/.cursor/cli-config.json does not store plugin enable state.

UX gaps (product — filing on forum too)

  1. CLI /plugins mixes marketplace browse + installed list; disabled (cached-off) plugins appear without an ENABLED / DISABLED badge.
  2. Slash menu can retain stale entries in agentData.cacheStorage.agentEnvironment.slashMenuItems.* (same vscdb); staff track this class of bug on forum #161008.
  3. /resume sessions may keep prior plugin context; new session required after toggling plugins.

Requested doc changes (this repo or cursor.com/docs)

  1. Lifecycle table (install / disable / uninstall) with filesystem + vscdb effects.
  2. Explicit note: plugins/cache/ = downloaded artifacts; not enable state.
  3. CLI section: /plugins is browse + manage; verify enable state via Settings or vscdb keys above.
  4. Troubleshooting: after disable, start new agent session; slash menu cache may need fresh session (not /resume).
  5. Link to forum threads for product UX bugs (uninstall button redirect, slash menu cache).

Environment

  • OS: Linux (Ubuntu)
  • CLI: agent 2026.06.19-20-24-33
  • Example: compound-engineering (ID 680) CACHED-OFF but cache present; cursor-team-kit (677) ENABLED — only distinguishable via vscdb, not /plugins UI.

Note

cursor/cursor has issues disabled; forum is the right channel for IDE/CLI product bugs. This issue is scoped to documentation / plugin-spec clarity so plugin authors and power users stop fighting the cache directory.

主要語言
TypeScript
星號
13.9k
分支
1.4k
平均合併
6 小時 55 分鐘
30 天內合併 PR
158

環境準備

這個專案沒有提供開發容器、Dockerfile 或貢獻指南，環境需要你自己搭建：先看它的 README，通用步驟見我們的新手貢獻指南。

從這裡開始

  1. 先讀完整個 Issue，再讀專案的貢獻指南。
  2. 在 Issue 下留言說明你要接手 —— 這能避免兩個人做同樣的事。
  3. Fork 儲存庫，在一個分支上完成修改。
  4. 送出 Pull Request，並在描述裡引用這個 Issue 編號。

cursor/plugins 的其他 Issue

查看 cursor/plugins 的全部 Issue

相似的 Issue

更多 TypeScript Issue

把新 issue 寄到你的電子郵件信箱

精選適合新手參與的 GitHub issue 摘要。