Add plugin command help aliases

Author: SqlRush

docs/cc-100-roadmap.md

@@ -39,6 +39,8 @@ M4/M11 补充：bridge-safe 内置本地命令 `/summary`、`/release-notes`、`
 
 M11 补充：`/native status|show` 已接入 no-query 本地路径，复用 `/status show native` 的 session native manifest 审计输出，报告平台、capability、clipboard adapter、file index 和 clipboard state，不请求模型且不调用外部 adapter。
 
+M8 补充：`/plugin help|--help|-h` 已输出官方插件命令用法，`/plugin manage` 复用 installed plugin summary，`/plugin i` 作为 install alias 复用安装路径；builtin command registry 同步声明官方 `/plugins` 与 `/marketplace` 顶层别名。
+
 M10 补充：plugin command/agent 的 allowed tool frontmatter 解析现在只在顶层逗号或空白处分隔，保留括号、方括号和引号内的逗号/空白，避免 `Bash(git commit -m "x,y")` 这类 tool pattern 被误拆。
 
 M8 补充：CLI `plugin marketplace list` 现在可列出 settings 中已配置的 marketplace；`--json` 输出按名称排序的 source/repo/url/path/package/installLocation 结构，普通文本输出与无配置提示也已覆盖。CLI `plugin marketplace add [--scope user|project|local] [--type ...] <name> <source>` 和 `plugin marketplace remove [--scope user|project|local] <name>` 现在复用 `internal/config` settings 文件写入 helper，可按目标 scope 写入/删除 `extraKnownMarketplaces`，并在写入前复用 marketplace source validation，且 `installLocation` 会校验为 `user|project|local`。CLI `plugin marketplace update [name]` 现在可按全部或指定 marketplace 触发现有 URL/git/github/npm/settings cache 加载刷新路径，命名 update 会用轻量 settings 读取避免启动时提前刷新全部 marketplace。运行时插件发现现在会合并项目链 `.claude/plugins` 和用户级 `${CLAUDE_CONFIG_DIR}/plugins`，项目同名插件优先。CLI `plugin install --scope project|user|local <plugin>` 与 headless `/plugin install [--scope project|user|local] <plugin>` 现在复用 `internal/plugins` 共享安装 API，把 marketplace 插件复制到目标 scope 的 `plugins/<safe-name>`，未显式传 scope 时会尊重 marketplace `installLocation` 默认值，并保留冲突检测、重复安装识别和 symlink/non-regular file 拒绝。CLI `plugin update --scope project|user|local|all <plugin>` 与 headless `/plugin update [--scope project|user|local|all] [plugin]` 现在复用 `internal/plugins` 共享更新 API，把目标 scope 已安装同名插件替换为最新 marketplace 副本，未显式传 scope 的命名更新同样会尊重 marketplace `installLocation`。CLI `plugin enable|disable [--scope user|project|local] <plugin>` 与 `plugin disable --all --scope ...` 现在复用 `internal/config` settings 文件写入 helper，按目标 scope 更新 `enabledPlugins` 并覆盖基本参数冲突。

docs/claude-code-go-rewrite-plan.md

@@ -897,6 +897,8 @@ test/parity/                 # golden tests against TS/official behavior
 - 本轮补充：`/native clipboard status|show` 现在走 no-query 本地状态路径，只展示 session clipboard 文件路径、item 数、更新时间和 adapter 可用性/命令，不读取、不写入、不展示剪贴板文本内容；`/native clipboard` usage 同步暴露 status 子命令。
 - 本轮补充：`/native status|show` 现在复用 `/status show native` 的 no-query 状态路径，可直接审计 session native manifest、平台、capability 数、clipboard adapter、file index 和 clipboard state，不请求模型也不调用外部 clipboard adapter。
 
+- 本轮补充：`/plugin help|--help|-h` 现在输出官方 Plugin Command Usage 文案，`/plugin manage` 复用已安装 plugin summary，`/plugin i` 作为 install alias 接入同一安装路径，builtin command registry 同步声明官方 `/plugins` 与 `/marketplace` 顶层别名。
+
 - 本轮补充：bridge-safe 内置本地命令 `/summary`、`/release-notes`、`/files` 现在已注册并接入 no-query runner 路径；`/summary` 输出确定性的会话/历史消息计数、工具使用计数、估算 token 和最近用户/助手预览，`/files` 只读列出当前工作目录第一层条目而不读取文件内容，`/release-notes` 明确报告当前 Go runtime 未打包 release notes。完整 local-jsx UI surface 和其它本地命令 parity 仍需继续补。
 
 ### M12: Parity hardening

docs/first-second-parity-audit.md

@@ -87,6 +87,7 @@ Anthropic API 和 conversation：
 - `/native voice status|show` and `/native computer status|show` now take no-query local status paths that report the session plan path, adapter availability, selected commands, and voice/computer-use runtime parameters without starting capture or input actions.
 - `/mcp refresh` and `/mcp reload` now take a no-query local refresh path that checks settings-file changes, refreshes plugin MCP server app-state, and reports configured/plugin MCP server counts instead of falling into the unsupported-subcommand branch.
 - `/mcp <server-name>` now takes the no-query local server-detail path used by `/mcp show <server-name>` when the name matches a configured settings or plugin MCP server, while unknown one-word subcommands still report unsupported.
+- `/plugin help|--help|-h` now returns the official plugin command usage text without querying the model, `/plugin manage` reuses the installed-plugin summary path, `/plugin i` aliases install, and the built-in command registry now exposes the official `/plugins` and `/marketplace` aliases.
 - `/plugin <plugin-name>` now takes the no-query local plugin-detail path used by `/plugin show <plugin-name>` when the name matches a local plugin manifest, while unknown one-word subcommands still report unsupported.
 - `/model show`, `/model info`, and `/model current` now take the no-query current-model path instead of treating those words as custom model names and mutating the runner model.
 - A basic `Skill` tool wrapper is now registered with the default built-in tool set. It can invoke local project and plugin-directory prompt skills through the command registry, returns the official-style `Launching skill: ...` result plus structured command metadata, preserves command source/display/root/frontmatter metadata for plugin skills, and passes expanded meta user messages through `ToolResult.NewMessages`; the conversation runner now appends those new messages to transcripts and subsequent model requests.

internal/commands/registry.go

@@ -288,7 +288,7 @@ func BuiltinCommands() []contracts.Command {
 		{Type: contracts.CommandLocalJSX, Name: "help", Description: "Show help and available commands", Source: contracts.CommandSourceBuiltin},
 		{Type: contracts.CommandLocalJSX, Name: "config", Aliases: []string{"settings"}, Description: "Open config panel", Source: contracts.CommandSourceBuiltin},
 		{Type: contracts.CommandLocalJSX, Name: "mcp", Description: "Manage MCP servers", ArgumentHint: "[enable|disable [server-name]]", Source: contracts.CommandSourceBuiltin, Immediate: true},
-		{Type: contracts.CommandLocalJSX, Name: "plugin", Description: "Manage plugins", Source: contracts.CommandSourceBuiltin},
+		{Type: contracts.CommandLocalJSX, Name: "plugin", Aliases: []string{"plugins", "marketplace"}, Description: "Manage plugins", Source: contracts.CommandSourceBuiltin},
 		{Type: contracts.CommandLocalJSX, Name: "skills", Description: "List available skills", Source: contracts.CommandSourceBuiltin},
 		{Type: contracts.CommandLocalJSX, Name: "memory", Description: "Edit memory files", Source: contracts.CommandSourceBuiltin},
 		{Type: contracts.CommandLocal, Name: "native", Description: "Run explicit native integration commands", ArgumentHint: "clipboard|chrome|voice|computer", Source: contracts.CommandSourceBuiltin, SupportsNonInteractive: true},

internal/conversation/run.go

@@ -3357,7 +3357,9 @@ func (r Runner) formatPluginSummary(raw string) string {
 	args := strings.Fields(strings.TrimSpace(raw))
 	if len(args) > 0 {
 		switch args[0] {
-		case "list", "status":
+		case "list", "status", "manage":
+		case "help", "--help", "-h":
+			return pluginCommandHelp()
 		case "show", "info":
 			return r.formatPluginShow(args)
 		case "search", "find":
@@ -3386,7 +3388,7 @@ func (r Runner) formatPluginSummary(raw string) string {
 			return r.formatMarketplacePlugins(subcommandRemainder(raw, args[0]))
 		case "config", "settings":
 			return r.formatPluginConfig(args)
-		case "install":
+		case "install", "i":
 			return r.installPluginSummary(subcommandRemainder(raw, args[0]))
 		case "update":
 			return r.updatePluginSummary(subcommandRemainder(raw, args[0]))
@@ -3506,6 +3508,42 @@ func (r Runner) formatPluginSummary(raw string) string {
 	return strings.Join(lines, "\n")
 }
 
+func pluginCommandHelp() string {
+	return strings.Join([]string{
+		"Plugin Command Usage:",
+		"",
+		"Installation:",
+		"/plugin install - Browse and install plugins",
+		"/plugin install <marketplace> - Install from specific marketplace",
+		"/plugin install <plugin> - Install specific plugin",
+		"/plugin install <plugin>@<market> - Install plugin from marketplace",
+		"",
+		"Management:",
+		"/plugin manage - Manage installed plugins",
+		"/plugin enable <plugin> - Enable a plugin",
+		"/plugin disable <plugin> - Disable a plugin",
+		"/plugin uninstall <plugin> - Uninstall a plugin",
+		"",
+		"Marketplaces:",
+		"/plugin marketplace - Marketplace management menu",
+		"/plugin marketplace add - Add a marketplace",
+		"/plugin marketplace add <path/url> - Add marketplace directly",
+		"/plugin marketplace update - Update marketplaces",
+		"/plugin marketplace update <name> - Update specific marketplace",
+		"/plugin marketplace remove - Remove a marketplace",
+		"/plugin marketplace remove <name> - Remove specific marketplace",
+		"/plugin marketplace list - List all marketplaces",
+		"",
+		"Validation:",
+		"/plugin validate <path> - Validate a manifest file or directory",
+		"",
+		"Other:",
+		"/plugin - Main plugin menu",
+		"/plugin help - Show this help",
+		"/plugins - Alias for /plugin",
+	}, "\n")
+}
+
 func (r Runner) formatPluginShow(args []string) string {
 	if len(args) < 2 || strings.TrimSpace(args[1]) == "" {
 		return "Usage: /plugin " + args[0] + " <plugin-name>"

internal/conversation/run_test.go

@@ -4942,6 +4942,53 @@ func TestRunnerExecutesPluginSlashCommandWithoutQuery(t *testing.T) {
 			t.Fatalf("plugin text missing %q: %q", want, text)
 		}
 	}
+
+	result, err = runner.RunTurn(context.Background(), nil, messages.UserText("/plugin manage"))
+	if err != nil {
+		t.Fatal(err)
+	}
+	if len(client.requests) != 0 {
+		t.Fatalf("model should not be queried, requests = %#v", client.requests)
+	}
+	text = result.Messages[1].Content[0].Text
+	for _, want := range []string{
+		"Plugins",
+		"Local plugin manifests: 1",
+		"Plugin commands:",
+		"- /plugin:deploy",
+	} {
+		if !strings.Contains(text, want) {
+			t.Fatalf("plugin manage text missing %q: %q", want, text)
+		}
+	}
+
+	for _, prompt := range []string{"/plugin help", "/plugin --help", "/plugin -h", "/plugins help", "/marketplace help"} {
+		result, err = runner.RunTurn(context.Background(), nil, messages.UserText(prompt))
+		if err != nil {
+			t.Fatal(err)
+		}
+		if len(client.requests) != 0 {
+			t.Fatalf("%s queried model, requests = %#v", prompt, client.requests)
+		}
+		text = result.Messages[1].Content[0].Text
+		for _, want := range []string{
+			"Plugin Command Usage:",
+			"Installation:",
+			"/plugin install <plugin>@<market> - Install plugin from marketplace",
+			"Management:",
+			"/plugin manage - Manage installed plugins",
+			"Marketplaces:",
+			"/plugin marketplace list - List all marketplaces",
+			"Validation:",
+			"/plugin validate <path> - Validate a manifest file or directory",
+			"Other:",
+			"/plugin help - Show this help",
+		} {
+			if !strings.Contains(text, want) {
+				t.Fatalf("%s help missing %q: %q", prompt, want, text)
+			}
+		}
+	}
 }
 
 func TestRunnerPluginShowReportsLocalPluginDetails(t *testing.T) {
@@ -5166,7 +5213,7 @@ func TestRunnerPluginInstallCopiesSettingsMarketplacePlugin(t *testing.T) {
 		}},
 	}
 
-	result, err := runner.RunTurn(context.Background(), nil, messages.UserText("/plugin install market demo"))
+	result, err := runner.RunTurn(context.Background(), nil, messages.UserText("/plugin i market demo"))
 	if err != nil {
 		t.Fatal(err)
 	}