Claude-Code-Workflow/INSTALL_CN.md

Claude Code Workflow (CCW) - 安装指南

English | 中文

Claude Code Agent 工作流协调和分布式内存系统的交互式安装指南。

⚡ 一键远程安装（推荐）

所有平台 - 远程 PowerShell 安装

# 从功能分支进行交互式远程安装（最新版本）
iex (iwr -useb https://raw.githubusercontent.com/catlog22/Dmsflow/main/install-remote.ps1)

# 包含统一文件输出系统的全局安装
iex (iwr -useb https://raw.githubusercontent.com/catlog22/Dmsflow/main/install-remote.ps1) -Global

# 强制覆盖（非交互式）- 包含所有新的工作流文件生成功能
iex (iwr -useb https://raw.githubusercontent.com/catlog22/Dmsflow/main/install-remote.ps1) -Force -NonInteractive

# 一键备份所有现有文件（无需确认）
iex (iwr -useb https://raw.githubusercontent.com/catlog22/Dmsflow/main/install-remote.ps1) -BackupAll

远程安装器的功能：

• ✅ 检查系统要求（PowerShell 版本、网络连接）
• ✅ 从 GitHub 下载最新版本（main 分支）
• ✅ 包含所有新的统一文件输出系统功能
• ✅ 自动解压并运行本地安装程序
• ✅ 安全确认和用户提示
• ✅ 自动清理临时文件
• ✅ 设置 .workflow/ 目录结构进行会话管理

注意：为了跨平台兼容性，界面使用英文

📂 本地安装

所有平台（PowerShell）

# 克隆包含最新功能的仓库
git clone -b main https://github.com/catlog22/Claude-CCW.git
cd Dmsflow

# Windows PowerShell 5.1+ 或 PowerShell Core（仅支持全局安装）
.\Install-Claude.ps1

# Linux/macOS PowerShell Core（仅支持全局安装）
pwsh ./Install-Claude.ps1

注意：功能分支包含所有最新的统一文件输出系统增强功能，应用于新安装。

安装选项

远程安装参数

所有参数都可以传递给远程安装器：

# 全局安装
iex (iwr -useb https://raw.githubusercontent.com/catlog22/Dmsflow/main/install-remote.ps1) -Global

# 安装到指定目录
iex (iwr -useb https://raw.githubusercontent.com/catlog22/Dmsflow/main/install-remote.ps1) -Directory "C:\MyProject"

# 强制覆盖而不提示
iex (iwr -useb https://raw.githubusercontent.com/catlog22/Dmsflow/main/install-remote.ps1) -Force -NonInteractive

# 从特定分支安装
iex (iwr -useb https://raw.githubusercontent.com/catlog22/Dmsflow/main/install-remote.ps1) -Branch "dev"

# 跳过备份（更快）
iex (iwr -useb https://raw.githubusercontent.com/catlog22/Dmsflow/main/install-remote.ps1) -NoBackup

本地安装选项

全局安装（默认且唯一模式）

安装到用户主目录（~/.claude）：

# 所有平台 - 全局安装（默认）
.\Install-Claude.ps1

# 自动备份（从 v1.1.0 开始默认）
.\Install-Claude.ps1 -BackupAll

# 禁用自动备份（不推荐）
.\Install-Claude.ps1 -NoBackup

# 自动化的非交互式模式
.\Install-Claude.ps1 -Force -NonInteractive

全局安装结构：

~/.claude/
├── agents/
├── commands/
├── output-styles/
├── settings.local.json
└── CLAUDE.md

注意：从 v1.2.0 开始，仅支持全局安装。移除了本地目录和自定义路径安装，以简化安装流程并确保所有平台的一致行为。

高级选项

强制安装

覆盖现有文件：

.\Install-Claude.ps1 -Force

跳过备份

不创建备份文件：

.\Install-Claude.ps1 -NoBackup

卸载

删除安装：

.\Install-Claude.ps1 -Uninstall -Force

平台要求

PowerShell（推荐）

• Windows：PowerShell 5.1+ 或 PowerShell Core 6+
• Linux：PowerShell Core 6+
• macOS：PowerShell Core 6+

安装 PowerShell Core：

• Ubuntu/Debian：sudo apt install powershell
• CentOS/RHEL：sudo dnf install powershell
• macOS：brew install powershell
• 或下载：https://github.com/PowerShell/PowerShell

完整安装示例

⚡ 超快速（一键）

# 一条命令完成安装
iex (iwr -useb https://raw.githubusercontent.com/catlog22/Dmsflow/main/install-remote.ps1) -Global

# 完成！🎉
# 开始使用 Claude Code Agent 工作流！

📂 手动安装方法

# 手动安装步骤：
# 1. 安装 PowerShell Core（如果需要）
# Windows：从 GitHub 下载
# Linux：sudo apt install powershell
# macOS：brew install powershell

# 2. 下载 Claude Code 工作流系统
git clone https://github.com/catlog22/Claude-CCW.git
cd Dmsflow

# 3. 全局安装（交互式）
.\Install-Claude.ps1 -Global

# 4. 开始使用 Claude Code Agent 工作流！
# 使用 /workflow 命令和内存系统进行开发

验证

安装后，验证：

1. 检查安装：

   # 全局
   ls ~/.claude
   
   # 本地
   ls ./.claude
   

2. 测试 Claude Code：

   • 在项目中打开 Claude Code
   • 检查全局 .claude 目录是否被识别
   • 验证工作流命令和内存命令是否可用
   • 测试 /workflow 命令的 Agent 协调功能
   • 测试 /workflow version 检查版本信息

故障排除

PowerShell 执行策略

如果出现执行策略错误：

Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser

工作流命令无效

• 确保项目中存在 .claude 目录
• 验证 workflow.md 和 agent 文件是否正确安装
• 检查 Claude Code 是否识别配置

权限错误

• Windows：以管理员身份运行
• Linux/macOS：如果需要全局 PowerShell 安装，使用 sudo

安装器功能说明

🛡️ 用户配置保护

安装器会智能处理现有文件：

• 新文件：直接复制
• 非配置文件：覆盖更新
• 用户配置文件（如 settings.local.json）：提供选项
  • 保留现有文件（推荐）
  • 覆盖为新文件
  • 备份后覆盖

📦 安全卸载

卸载时保护用户数据：

• 选项 1：仅删除安装的文件（保留用户配置）
• 选项 2：删除整个目录（需要二次确认）
• 选项 3：不删除任何内容

🔄 智能备份

• 自动为现有文件创建带时间戳的备份
• 备份文件格式：filename.backup_yyyyMMdd_HHmmss
• 可以使用 -NoBackup 跳过备份

常见问题

Q：为什么安装器界面是英文的？ A：为了确保跨平台兼容性并避免字符编码问题，安装器使用英文界面。

Q：可以自定义安装位置吗？ A：是的，使用 -Directory 参数指定任何位置。

Q：如何更新到最新版本？ A：再次运行一键安装命令，它会自动获取最新版本。

Q：卸载会删除我的配置吗？ A：默认情况下，卸载只删除我们安装的文件，保留您的个人配置。

支持

• 问题：GitHub Issues
• 文档：主 README
• 工作流文档：.claude/commands/workflow.md