4e89b57798
- Expand batch upload list area and optimize preview image layout - Improve upload speed tracking and display (server-side & client-side) - Reduce network detection log noise - Optimize Docker build process (caching, env validation) - Add shadow environment deployment support
470 lines
11 KiB
Markdown
470 lines
11 KiB
Markdown
# Claude Code 命令速查
|
||
|
||
本文档按命令来源分类，整理了所有可用命令。
|
||
|
||
---
|
||
# 影子系统（测试）
|
||
.\deploy-remote-build.ps1 -Target shadow # 有缓存
|
||
.\deploy-remote-build.ps1 -Target shadow -NoCache # 无缓存
|
||
|
||
# 正式系统
|
||
.\deploy-remote-build.ps1 # 有缓存
|
||
.\deploy-remote-build.ps1 -NoCache # 无缓存
|
||
|
||
|
||
## 目录
|
||
|
||
1. [Claude 自带命令](#1-claude-自带命令)
|
||
2. [已安装插件命令](#2-已安装插件命令)
|
||
3. [插件命令 (MCP)](#3-插件命令-mcp)
|
||
4. [项目技能 (Skills)](#4-项目技能-skills)
|
||
5. [自定义命令 (Slash Commands)](#5-自定义命令-slash-commands)
|
||
|
||
---
|
||
|
||
部署命令
|
||
# 影子系统（测试）
|
||
.\deploy-remote-build.ps1 -Target shadow # 有缓存
|
||
.\deploy-remote-build.ps1 -Target shadow -NoCache # 无缓存
|
||
|
||
# 正式系统
|
||
.\deploy-remote-build.ps1 # 有缓存
|
||
.\deploy-remote-build.ps1 -NoCache # 无缓存
|
||
|
||
|
||
## 1. Claude 自带命令
|
||
|
||
### 1.1 基础控制
|
||
|
||
| 命令 | 功能 |
|
||
|------|------|
|
||
| `/help` | 获取使用帮助信息 |
|
||
| `/status` | 查看账户和系统状态 |
|
||
| `/release-notes` | 查看最新发布说明 |
|
||
| `/exit` / `/quit` | 退出 REPL 交互模式 |
|
||
|
||
### 1.2 会话管理
|
||
|
||
| 命令 | 功能 |
|
||
|------|------|
|
||
| `/clear` | 清除对话历史 |
|
||
| `/clear reset` | 完全重置对话 |
|
||
| `/clear new` | 开始新对话 |
|
||
| `/compact` | 压缩对话历史但保留摘要 |
|
||
| `/resume` | 恢复之前的对话 |
|
||
|
||
### 1.3 上下文查看
|
||
|
||
| 命令 | 功能 |
|
||
|------|------|
|
||
| `/context` | 可视化当前上下文使用情况 |
|
||
| `/cost` | 显示当前会话的费用和持续时间 |
|
||
|
||
### 1.4 账户管理
|
||
|
||
| 命令 | 功能 |
|
||
|------|------|
|
||
| `/login` | 使用 Anthropic 账户登录 |
|
||
| `/logout` | 登出当前账户 |
|
||
| `/upgrade` | 升级到 Max 计划 |
|
||
|
||
### 1.5 项目与目录
|
||
|
||
| 命令 | 功能 | 示例 |
|
||
|------|------|------|
|
||
| `/add-dir <path>` | 添加新的工作目录 | `/add-dir /path/to/project` |
|
||
| `/init` | 使用 CLAUDE.md 初始化项目 | `/init` |
|
||
|
||
### 1.6 导入导出
|
||
|
||
| 命令 | 功能 |
|
||
|------|------|
|
||
| `/export` | 导出当前对话到文件 |
|
||
| `/memory` | 编辑 Claude 记忆文件 |
|
||
|
||
### 1.7 配置管理
|
||
|
||
| 命令 | 功能 |
|
||
|------|------|
|
||
| `/config` | 打开设置页面 |
|
||
| `/config theme` | 打开主题设置 |
|
||
| `/permissions` | 管理工具权限规则 |
|
||
| `/output-style` | 设置输出样式 |
|
||
| `/output-style:new` | 创建自定义输出样式 |
|
||
| `/hooks` | 管理钩子配置 |
|
||
|
||
### 1.8 模型选择
|
||
|
||
| 命令 | 功能 |
|
||
|------|------|
|
||
| `/model` | 查看可用模型 |
|
||
| `/model <model-name>` | 切换指定模型 |
|
||
|
||
**模型选择指导**：
|
||
|
||
| 模型 | 适用场景 |
|
||
|------|----------|
|
||
| **Opus** | 复杂推理、创意写作、复杂代码重构 |
|
||
| **Sonnet** | 日常编程、代码审查、技术文档 |
|
||
| **Haiku** | 简单查询、快速响应、基础编程 |
|
||
|
||
### 1.9 诊断工具
|
||
|
||
| 命令 | 功能 |
|
||
|------|------|
|
||
| `/doctor` | 诊断安装和设置问题 |
|
||
| `/ide` | 管理 IDE 集成状态 |
|
||
|
||
### 1.10 智能体和任务
|
||
|
||
| 命令 | 功能 |
|
||
|------|------|
|
||
| `/agents` | 管理智能体配置和创建专门化 AI 助手 |
|
||
| `/bashes` | 列出和管理后台任务 |
|
||
|
||
### 1.11 GitHub 集成
|
||
|
||
| 命令 | 功能 |
|
||
|------|------|
|
||
| `/install-github-app` | 为仓库设置 Claude GitHub Actions |
|
||
| `/pr-comments` | 从 GitHub 拉取请求获取评论 |
|
||
| `/review` | 审查拉取请求 |
|
||
|
||
### 1.12 安全与审查
|
||
|
||
| 命令 | 功能 |
|
||
|------|------|
|
||
| `/security-review` | 对当前分支的待处理更改进行完整安全审查 |
|
||
| `/privacy-settings` | 查看和更新隐私设置 |
|
||
|
||
### 1.13 终端与界面
|
||
|
||
| 命令 | 功能 |
|
||
|------|------|
|
||
| `/terminal-setup` | 为换行和视觉提示启用终端键绑定 |
|
||
| `/vim` | 在 Vim 和普通编辑模式之间切换 |
|
||
| `/statusline` | 设置 Claude Code 的状态行 UI |
|
||
| `/todos` | 列出当前待办事项 |
|
||
|
||
### 1.14 安装迁移
|
||
|
||
| 命令 | 功能 |
|
||
|------|------|
|
||
| `/migrate-installer` | 从全局 npm 安装迁移到本地安装 |
|
||
|
||
### 1.15 反馈
|
||
|
||
| 命令 | 功能 |
|
||
|------|------|
|
||
| `/feedback` | 提交关于 Claude Code 的反馈 |
|
||
| `/feedback bug` | 报告错误 |
|
||
|
||
---
|
||
|
||
## 2. 已安装插件命令
|
||
|
||
### 2.1 superpowers 插件 (v4.1.1)
|
||
|
||
**用途**：创意工作流程管理（头脑风暴 → 计划 → 执行）
|
||
|
||
| 命令 | 功能 | 使用场景 |
|
||
|------|------|----------|
|
||
| `/brainstorm` | 头脑风暴 | 创建功能、构建组件、添加功能前必须使用 |
|
||
| `/write-plan` | 创建详细实施计划 | 将头脑风暴的结果转化为可执行的小任务 |
|
||
| `/execute-plan` | 分批执行计划 | 带审查检查点，逐步执行计划 |
|
||
|
||
**推荐工作流**：
|
||
```
|
||
/brainstorm → /write-plan → /execute-plan
|
||
```
|
||
|
||
### 2.2 claude-mem 插件 (v9.0.6)
|
||
|
||
**用途**：基于文档发现的计划执行
|
||
|
||
| 命令 | 功能 | 使用场景 |
|
||
|------|------|----------|
|
||
| `/make-plan` | 创建带文档发现的实施计划 | 在实施前先发现和阅读相关文档 |
|
||
| `/do` | 使用子代理执行计划 | 部署子代理执行各个阶段的工作 |
|
||
|
||
**特点**：
|
||
- 强制先阅读文档再实施
|
||
- 防止"发明"不存在的 API
|
||
- 每个阶段都有验证检查清单
|
||
|
||
---
|
||
|
||
## 3. 插件命令 (MCP)
|
||
|
||
### 3.1 MCP 管理
|
||
|
||
| 命令 | 功能 |
|
||
|------|------|
|
||
| `/mcp` | 管理 MCP 服务器 |
|
||
|
||
### 3.2 MCP 命令格式
|
||
|
||
```
|
||
/mcp__<server-name>__<prompt-name>
|
||
```
|
||
|
||
**示例**：
|
||
|
||
| 命令 | 功能 |
|
||
|------|------|
|
||
| `/mcp__github__create_issue` | 创建 GitHub Issue |
|
||
| `/mcp__github__list_prs` | 列出 Pull Requests |
|
||
| `/mcp__database__query` | 执行数据库查询 |
|
||
| `/mcp__docker__list_containers` | 列出 Docker 容器 |
|
||
|
||
---
|
||
|
||
## 4. 项目技能 (Skills)
|
||
|
||
**存放位置**：`.claude/skills/`
|
||
|
||
### 4.1 系统维护
|
||
|
||
| 命令 | 功能 | 说明 |
|
||
|------|------|------|
|
||
| `/cleanup-temp` | 清理临时文件 | 清理 `uploads/temp/`、`uploads/assembled/` 中的临时文件，保留正常数据 |
|
||
| `/cleanup-old` | 清理旧镜像 | 清理旧的 Docker 镜像，保留构建缓存 |
|
||
| `/system-health` | 系统健康检查 | 检查 Redis、数据库、存储、网络状态 |
|
||
|
||
### 4.2 素材管理
|
||
|
||
| 命令 | 功能 | 说明 |
|
||
|------|------|------|
|
||
| `/material-status` | 查询素材状态 | 支持按作者、类型、日期、任务号查询 |
|
||
|
||
---
|
||
|
||
## 5. 自定义命令 (Slash Commands)
|
||
|
||
### 5.1 命令存放位置
|
||
|
||
**项目级命令**（团队共享）：
|
||
```
|
||
.claude/commands/
|
||
```
|
||
|
||
**个人级命令**（个人使用）：
|
||
```
|
||
~/.claude/commands/
|
||
```
|
||
|
||
### 5.2 命令文件结构
|
||
|
||
```markdown
|
||
---
|
||
description: "命令描述"
|
||
argument-hint: "<参数>"
|
||
allowed-tools: ["Read", "Edit", "Bash"]
|
||
model: "claude-3-sonnet"
|
||
---
|
||
|
||
# 命令说明
|
||
|
||
请执行以下操作：
|
||
|
||
@$1
|
||
```
|
||
|
||
### 5.3 参数占位符
|
||
|
||
| 占位符 | 功能 |
|
||
|--------|------|
|
||
| `$ARGUMENTS` | 捕获所有参数 |
|
||
| `$1`, `$2` | 访问特定位置参数 |
|
||
| `${1:-default}` | 带默认值的参数 |
|
||
|
||
### 5.4 文件引用
|
||
|
||
```
|
||
@src/config.js # 直接引用文件内容
|
||
@$1 # 引用参数指定的文件
|
||
@src/utils/*.js # 引用多个文件
|
||
```
|
||
|
||
### 5.5 Bash 命令集成
|
||
|
||
```
|
||
!npm test # 执行测试
|
||
!eslint $1 # 代码检查
|
||
!git add . && git commit -m "消息" # 复合命令
|
||
```
|
||
|
||
### 5.6 Front Matter 配置选项
|
||
|
||
```yaml
|
||
---
|
||
# 命令描述
|
||
description: "执行特定功能的命令"
|
||
|
||
# 参数提示
|
||
argument-hint: "<必需参数> [可选参数]"
|
||
|
||
# 允许的工具
|
||
allowed-tools:
|
||
- "Read"
|
||
- "Edit"
|
||
- "Bash"
|
||
- "Glob"
|
||
|
||
# 指定模型
|
||
model: "claude-3-sonnet"
|
||
|
||
# 扩展思考模式
|
||
thinking: true
|
||
|
||
# 权限模式
|
||
permission-mode: "standard"
|
||
---
|
||
```
|
||
|
||
---
|
||
|
||
## 6. 项目部署命令
|
||
|
||
> **重要**：所有部署命令都需要在项目根目录下执行
|
||
|
||
### 6.1 部署到影子系统（测试环境）
|
||
|
||
| 场景 | 命令 | 说明 |
|
||
|------|------|------|
|
||
| **有缓存部署** | `.\deploy-remote-build.ps1 -Target shadow` | 推荐日常使用，构建速度快 |
|
||
| **无缓存部署** | `.\deploy-remote-build.ps1 -Target shadow -NoCache` | 完全重新构建，构建时间长 |
|
||
|
||
**访问地址**：http://192.168.58.20:5320
|
||
|
||
**容器名称**：`youyidian-3d-shadow`
|
||
|
||
---
|
||
|
||
### 6.2 部署到正式系统
|
||
|
||
| 场景 | 命令 | 说明 |
|
||
|------|------|------|
|
||
| **有缓存部署** | `.\deploy-remote-build.ps1` | 推荐日常使用，构建速度快 |
|
||
| **无缓存部署** | `.\deploy-remote-build.ps1 -NoCache` | 完全重新构建，构建时间长 |
|
||
|
||
**访问地址**：http://192.168.58.20:4320
|
||
|
||
**容器名称**：`youyidian-3d-material`
|
||
|
||
---
|
||
|
||
### 6.3 部署流程说明
|
||
|
||
```
|
||
1. 本地打包代码（排除 node_modules、.next、.git）
|
||
↓
|
||
2. 上传到构建服务器（192.168.42.134）
|
||
↓
|
||
3. 在构建服务器上构建 Docker 镜像
|
||
↓
|
||
4. 推送到本地 Registry（192.168.42.134:5000）
|
||
↓
|
||
5. 拉取到生产服务器（192.168.58.20）
|
||
↓
|
||
6. 启动容器（影子端口5320 / 正式端口4320）
|
||
```
|
||
|
||
---
|
||
|
||
### 6.4 部署后验证命令
|
||
|
||
```powershell
|
||
# 检查容器运行状态
|
||
ssh root@192.168.58.20 "docker ps | findstr youyidian-3d"
|
||
|
||
# 查看容器日志
|
||
ssh root@192.168.58.20 "docker logs youyidian-3d-shadow --tail 100"
|
||
ssh root@192.168.58.20 "docker logs youyidian-3d-material --tail 100"
|
||
|
||
# 检查 Redis 连接
|
||
ssh root@192.168.58.20 "docker exec gongxiangpan-redis redis-cli ping"
|
||
|
||
# 查看上传会话
|
||
ssh root@192.168.58.20 "docker exec gongxiangpan-redis redis-cli keys 'upload:*'"
|
||
|
||
# 查看环境变量
|
||
ssh root@192.168.58.20 "docker exec youyidian-3d-material printenv | grep -E 'DATABASE|REDIS|S3'"
|
||
```
|
||
|
||
---
|
||
|
||
### 6.5 推荐工作流
|
||
|
||
```powershell
|
||
# 1. 先部署到影子系统测试
|
||
cd "d:\AI Code\gongxiangp2"
|
||
.\deploy-remote-build.ps1 -Target shadow
|
||
|
||
# 2. 访问 http://192.168.58.20:5320 测试功能
|
||
|
||
# 3. 确认无误后部署到正式系统
|
||
.\deploy-remote-build.ps1
|
||
|
||
# 4. 访问 http://192.168.58.20:4320 验证
|
||
```
|
||
|
||
---
|
||
|
||
### 6.6 参数说明
|
||
|
||
| 参数 | 说明 |
|
||
|------|------|
|
||
| `-Target shadow` | 部署到影子系统（默认为正式系统） |
|
||
| `-NoCache` | 禁用 Docker 构建缓存，完全重新构建 |
|
||
|
||
---
|
||
|
||
### 6.7 部署失败处理
|
||
|
||
```powershell
|
||
# 查看详细错误日志
|
||
ssh root@192.168.58.20 "docker logs youyidian-3d-shadow"
|
||
|
||
# 重启容器
|
||
ssh root@192.168.58.20 "docker restart youyidian-3d-shadow"
|
||
|
||
# 回滚到上一个版本（如果需要）
|
||
ssh root@192.168.58.20 "docker stop youyidian-3d-shadow && docker rm youyidian-3d-shadow"
|
||
# 然后重新部署上一个版本的镜像
|
||
```
|
||
|
||
---
|
||
|
||
## 快捷技巧
|
||
|
||
### 常用命令组合
|
||
|
||
```
|
||
# 开发前检查
|
||
/doctor → /context → /status
|
||
|
||
# 清理和重置
|
||
/compact → /clear new
|
||
|
||
# 系统维护
|
||
/system-health → /cleanup-temp → /cleanup-old
|
||
|
||
# 创意工作流程（使用 superpowers 插件）
|
||
/brainstorm → /write-plan → /execute-plan
|
||
```
|
||
|
||
### 自动化工作流
|
||
|
||
```
|
||
# 代码审查流程
|
||
/lint && /test && /review
|
||
|
||
# 完整部署
|
||
/build && /test && /deploy
|
||
```
|
||
|
||
---
|
||
|
||
**提示**：输入 `/help` 可以随时获取完整命令列表和详细帮助。
|