sinapse-ai 5.0.8 → 6.0.1

package/docs/zh/uninstallation.md

@@ -1,348 +0,0 @@
-# 卸载指南
-
-> 🌐 [EN](../uninstallation.md) | [PT](../pt/uninstallation.md) | [ES](../es/uninstallation.md) | **ZH**
-
----
-
-本指南提供了从您的系统中卸载 SINAPSE 的全面说明。
-
-## 目录
-
-1. [卸载前](#卸载前)
-2. [快速卸载](#快速卸载)
-3. [完全卸载](#完全卸载)
-4. [选择性卸载](#选择性卸载)
-5. [数据保留](#数据保留)
-6. [清洁系统移除](#清洁系统移除)
-7. [卸载故障排除](#卸载故障排除)
-8. [卸载后清理](#卸载后清理)
-9. [重新安装](#重新安装)
-
-## 卸载前
-
-### 重要考虑事项
-
-⚠️ **警告**：卸载 SINAPSE 将：
-
-- 删除所有框架文件
-- 删除代理配置（除非保留）
-- 清除内存层数据（除非备份）
-- 删除所有自定义工作流
-- 删除日志和临时文件
-
-### 卸载前检查清单
-
-- [ ] 备份重要数据
-- [ ] 导出自定义代理和工作流
-- [ ] 保存 API 密钥和配置
-- [ ] 记录自定义修改
-- [ ] 停止所有运行的进程
-- [ ] 通知团队成员
-
-### 备份您的数据
-
-```bash
-# 创建完整备份
-npx @sinapse/sinapse-ai backup --complete
-
-# 或手动备份重要目录
-tar -czf sinapse-backup-$(date +%Y%m%d).tar.gz \
-  .sinapse/ \
-  agents/ \
-  workflows/ \
-  tasks/ \
-  --exclude=.sinapse/logs \
-  --exclude=.sinapse/cache
-```
-
-## 快速卸载
-
-### 使用内置卸载程序
-
-卸载 SINAPSE 的最快方法：
-
-```bash
-# 基本卸载（保留用户数据）
-npx @sinapse/sinapse-ai uninstall
-
-# 完全卸载（删除所有内容）
-npx @sinapse/sinapse-ai uninstall --complete
-
-# 卸载并保留数据
-npx @sinapse/sinapse-ai uninstall --keep-data
-```
-
-### 交互式卸载
-
-对于引导式卸载：
-
-```bash
-npx @sinapse/sinapse-ai uninstall --interactive
-```
-
-这会提示您：
-
-- 要保留/删除什么
-- 备份选项
-- 每一步的确认
-
-## 完全卸载
-
-### 步骤 1：停止所有服务
-
-```bash
-# 停止所有运行的代理
-*deactivate --all
-
-# 停止所有工作流
-*stop-workflow --all
-
-# 关闭元代理
-*shutdown
-```
-
-### 步骤 2：导出重要数据
-
-```bash
-# 导出配置
-*export config --destination backup/config.json
-
-# 导出代理
-*export agents --destination backup/agents/
-
-# 导出工作流
-*export workflows --destination backup/workflows/
-
-# 导出内存数据
-*export memory --destination backup/memory.zip
-```
-
-### 步骤 3：运行卸载程序
-
-```bash
-# 完全移除
-npx @sinapse/sinapse-ai uninstall --complete --no-backup
-```
-
-### 步骤 4：删除全局安装
-
-```bash
-# 删除全局 npm 包
-npm uninstall -g @sinapse/sinapse-ai
-
-# 删除 npx 缓存
-npm cache clean --force
-```
-
-### 步骤 5：清理系统文件
-
-#### Windows
-
-```powershell
-# 删除 AppData 文件
-Remove-Item -Recurse -Force "$env:APPDATA\@sinapse/sinapse-ai"
-
-# 删除临时文件
-Remove-Item -Recurse -Force "$env:TEMP\sinapse-*"
-
-# 删除注册表条目（如果有）
-Remove-Item -Path "HKCU:\Software\SINAPSE" -Recurse
-```
-
-#### macOS/Linux
-
-```bash
-# 删除配置文件
-rm -rf ~/.sinapse
-rm -rf ~/.config/@sinapse/sinapse-ai
-
-# 删除缓存
-rm -rf ~/.cache/@sinapse/sinapse-ai
-
-# 删除临时文件
-rm -rf /tmp/sinapse-*
-```
-
-## 选择性卸载
-
-### 删除特定组件
-
-```bash
-# 仅删除代理
-npx @sinapse/sinapse-ai uninstall agents
-
-# 仅删除工作流
-npx @sinapse/sinapse-ai uninstall workflows
-
-# 删除内存层
-npx @sinapse/sinapse-ai uninstall memory-layer
-
-# 删除特定代理
-*uninstall agent-name
-```
-
-### 保留核心，删除扩展
-
-```bash
-# 删除所有插件
-*plugin remove --all
-
-# 删除 Squads
-rm -rf Squads/
-
-# 删除自定义模板
-rm -rf templates/custom/
-```
-
-## 数据保留
-
-### 要保留的内容
-
-卸载前，确定要保留的内容：
-
-1. **自定义代理**
-
-   ```bash
-   # 复制自定义代理
-   cp -r agents/custom/ ~/sinapse-backup/agents/
-   ```
-
-2. **工作流和任务**
-
-   ```bash
-   # 复制工作流
-   cp -r workflows/ ~/sinapse-backup/workflows/
-   cp -r tasks/ ~/sinapse-backup/tasks/
-   ```
-
-3. **内存数据**
-
-   ```bash
-   # 导出内存数据库
-   *memory export --format sqlite \
-     --destination ~/sinapse-backup/memory.db
-   ```
-
-4. **配置**
-
-   ```bash
-   # 复制所有配置文件
-   cp .sinapse/config.json ~/sinapse-backup/
-   cp .env ~/sinapse-backup/
-   ```
-
-5. **自定义代码**
-   ```bash
-   # 查找并备份自定义文件
-   find . -name "*.custom.*" -exec cp {} ~/sinapse-backup/custom/ \;
-   ```
-
-## 清洁系统移除
-
-### 完整清理脚本
-
-```bash
-#!/bin/bash
-echo "SINAPSE 完全卸载"
-echo "================================="
-
-# 确认
-read -p "这将删除所有 SINAPSE 数据。继续吗？(y/N) " -n 1 -r
-echo
-if [[ ! $REPLY =~ ^[Yy]$ ]]; then
-    exit 1
-fi
-
-# 停止所有进程
-echo "停止所有进程..."
-pkill -f "@sinapse/sinapse-ai" || true
-pkill -f "sinapse-developer" || true
-
-# 删除项目文件
-echo "删除项目文件..."
-rm -rf .sinapse/
-rm -rf agents/
-rm -rf workflows/
-rm -rf tasks/
-rm -rf templates/
-rm -rf Squads/
-rm -rf node_modules/@sinapse/sinapse-ai/
-
-# 删除全局文件
-echo "删除全局文件..."
-npm uninstall -g @sinapse/sinapse-ai
-
-# 删除用户数据
-echo "删除用户数据..."
-rm -rf ~/.sinapse
-rm -rf ~/.config/@sinapse/sinapse-ai
-rm -rf ~/.cache/@sinapse/sinapse-ai
-
-# 清理 npm 缓存
-echo "清理 npm 缓存..."
-npm cache clean --force
-
-# 从 package.json 中删除
-echo "更新 package.json..."
-npm uninstall @sinapse/sinapse-ai/core
-npm uninstall @sinapse/sinapse-ai/memory
-npm uninstall @sinapse/sinapse-ai/meta-agent
-
-echo "卸载完成！"
-```
-
-## 卸载故障排除
-
-### 常见问题
-
-#### 1. 权限被拒绝
-
-```bash
-# Linux/macOS
-sudo npx @sinapse/sinapse-ai uninstall --complete
-
-# Windows（以管理员身份运行）
-npx @sinapse/sinapse-ai uninstall --complete
-```
-
-#### 2. 进程仍在运行
-
-```bash
-# 强制停止所有进程
-# Linux/macOS
-killall -9 node
-killall -9 @sinapse/sinapse-ai
-
-# Windows
-taskkill /F /IM node.exe
-taskkill /F /IM @sinapse/sinapse-ai.exe
-```
-
-## 卸载验证检查清单
-
-- [ ] 所有 SINAPSE 进程已停止
-- [ ] 项目文件已删除
-- [ ] 全局 npm 包已卸载
-- [ ] 用户配置文件已删除
-- [ ] 缓存目录已清理
-- [ ] 环境变量已删除
-- [ ] 注册表条目已清理 (Windows)
-- [ ] Git 存储库已更新
-- [ ] 未找到剩余 SINAPSE 文件
-- [ ] 系统 PATH 已更新
-
-## 获取帮助
-
-如果您在卸载期间遇到问题：
-
-1. **检查文档**
-   - [FAQ](https://github.com/SinapseAI/sinapse-ai/wiki/faq#uninstall)
-   - [故障排除](https://github.com/SinapseAI/sinapse-ai/wiki/troubleshooting)
-
-2. **社区支持**
-   - Discord：#uninstall-help
-   - GitHub Issues：标记为"uninstall"
-
----
-
-**记住**：卸载前始终备份您的数据。卸载过程是不可逆的。

package/docs/zh/versioning-and-releases.md

@@ -1,140 +0,0 @@
-# 如何发布新版本
-
-> 🌐 [EN](../versioning-and-releases.md) | [PT](../pt/versioning-and-releases.md) | [ES](../es/versioning-and-releases.md)
-
----
-
-## 自动化发布（推荐）
-
-发布新版本的最简单方法是通过**自动语义发布**。只需使用正确的消息格式进行提交并推送，其他一切都会自动发生。
-
-### 提交消息格式
-
-使用这些前缀来控制发生什么类型的发布：
-
-```bash
-fix: resolve CLI argument parsing bug      # → 补丁发布 (4.1.0 → 4.1.1)
-feat: add new agent orchestration mode     # → 次要发布 (4.1.0 → 4.2.0)
-feat!: redesign CLI interface              # → 主要发布 (4.1.0 → 5.0.0)
-```
-
-### 自动发生的事情
-
-当您推送带有 `fix:` 或 `feat:` 的提交时，GitHub Actions 将：
-
-1. ✅ 分析您的提交消息
-2. ✅ 在 `package.json` 中增加版本
-3. ✅ 生成更改日志
-4. ✅ 创建 git 标签
-5. ✅ **自动发布到 NPM**
-6. ✅ 使用发行说明创建 GitHub 发布
-
-### 您的简单工作流
-
-```bash
-# 进行更改
-git add .
-git commit -m "feat: add team collaboration mode"
-git push
-
-# 就这样！发布会自动发生
-# 用户现在可以运行：npx @sinapse/sinapse-ai（并获得新版本）
-```
-
-### 不触发发布的提交
-
-这些提交类型不会创建发布（将其用于维护）：
-
-```bash
-chore: update dependencies     # 无发布
-docs: fix typo in readme      # 无发布
-style: format code            # 无发布
-test: add unit tests          # 无发布
-```
-
-### 测试您的设置
-
-```bash
-npm run release:test    # 安全在本地运行 - 测试配置
-```
-
----
-
-## 手动发布方法（仅限例外）
-
-如果需要绕过自动系统，仅使用这些方法。
-
-### 快速手动版本增加
-
-```bash
-npm run version:patch   # 4.1.0 → 4.1.1 (bug fixes)
-npm run version:minor   # 4.1.0 → 4.2.0 (new features)
-npm run version:major   # 4.1.0 → 5.0.0 (breaking changes)
-
-# 然后手动发布：
-npm publish
-git push && git push --tags
-```
-
-### 手动 GitHub Actions 触发
-
-如果需要，您也可以通过 GitHub Actions 工作流分派手动触发发布。
-
----
-
-## 故障排除
-
-### 未触发发布
-
-如果您的合并到 `main` 未触发发布：
-
-1. **检查提交消息** - 仅 `fix:` 和 `feat:` 前缀触发发布
-2. **验证 CI 通过** - 如果 lint、typecheck 和 test 通过，发布才会运行
-3. **检查工作流日志** - 转到"操作"→"语义发布"以查看详情
-
-### 发布失败
-
-常见问题和解决方案：
-
-| 错误 | 解决方案 |
-|------|----------|
-| `ENOGHTOKEN` | GITHUB_TOKEN 密钥缺失或过期 |
-| `ENOPKGAUTH` | NPM_TOKEN 密钥缺失或无效 |
-| `ENOTINHISTORY` | 分支没有正确的历史（使用 `fetch-depth: 0`） |
-| `EINVALIDNPMTOKEN` | 重新生成具有发布权限的 NPM 令牌 |
-
-### 跳过发布
-
-要在不触发发布的情况下进行合并，请使用以下其中一种：
-
-```bash
-# 方法 1：使用非发布前缀
-git commit -m "chore: update dependencies"
-
-# 方法 2：将 [skip ci] 添加到提交消息
-git commit -m "feat: new feature [skip ci]"
-```
-
-### 强制手动发布
-
-如果自动发布失败，您可以手动发布：
-
-```bash
-npm run version:patch   # 或 minor/major
-git push && git push --tags
-npm publish
-```
-
----
-
-## 配置文件
-
-| 文件 | 目的 |
-|------|------|
-| `.releaserc.json` | 语义发布配置 |
-| `.github/workflows/semantic-release.yml` | GitHub Actions 工作流 |
-| `package.json` | 版本源，npm 脚本 |
-
----
-
-*上次更新：Story 6.17 - 语义发布自动化*