sinapse-ai 5.0.8 → 6.0.0

package/docs/zh/guides/permission-modes.md

@@ -1,307 +0,0 @@
-# 权限模式指南
-
-> 控制SINAPSE代理对您系统的自主权。
-
----
-
-## 概述
-
-权限模式让您控制SINAPSE代理拥有的自主权级别。无论您是探索新代码库还是运行完全自主的构建，都有适合您工作流的模式。
-
-```
-┌─────────────────────────────────────────────────────────────┐
-│  🔍 探索         │  ⚠️ 询问         │  ⚡ 自动           │
-│  安全浏览        │  确认更改        │  完全自主         │
-├─────────────────────────────────────────────────────────────┤
-│  读取: ✅        │  读取: ✅        │  读取: ✅         │
-│  写入: ❌        │  写入: ⚠️确认    │  写入: ✅         │
-│  执行: ❌        │  执行: ⚠️确认    │  执行: ✅         │
-│  删除: ❌        │  删除: ⚠️确认    │  删除: ✅         │
-└─────────────────────────────────────────────────────────────┘
-```
-
----
-
-## 快速开始
-
-```bash
-# 检查当前模式
-*mode
-
-# 切换到探索模式（安全）
-*mode explore
-
-# 切换到询问模式（均衡-默认）
-*mode ask
-
-# 切换到自动模式（狂野）
-*mode auto
-# 或
-*yolo
-```
-
----
-
-## 模式说明
-
-### 🔍 探索模式
-
-**最适合:** 首次探索、学习代码库、只读审计
-
-```
-*mode explore
-```
-
-在探索模式中:
-
-- ✅ 读取任何文件
-- ✅ 搜索代码库
-- ✅ 运行只读命令（git status、ls等）
-- ❌ 无法写入或编辑文件
-- ❌ 无法运行潜在破坏性命令
-- ❌ 无法执行构建/部署操作
-
-**示例阻止的操作:**
-
-- `Write` / `Edit` 工具
-- `git push`, `git commit`
-- `npm install`
-- `rm`, `mv`, `mkdir`
-
----
-
-### ⚠️ 询问模式（默认）
-
-**最适合:** 日常开发、安全性和生产力的平衡
-
-```
-*mode ask
-```
-
-在询问模式中:
-
-- ✅ 读取任何文件
-- ⚠️ 写入操作需要确认
-- ⚠️ 执行操作需要确认
-- ⚠️ 破坏性操作需要明确批准
-
-**确认流程:**
-
-```
-⚠️ 需要确认
-
-操作: 写入
-工具: 编辑
-
-文件: `src/components/Button.tsx`
-
-[继续] [跳过] [切换到自动]
-```
-
----
-
-### ⚡ 自动模式
-
-**最适合:** 高级用户、自主构建、信任的工作流
-
-```
-*mode auto
-# 或
-*yolo
-```
-
-在自动模式中:
-
-- ✅ 完整读取访问权限
-- ✅ 完整写入访问权限
-- ✅ 完整执行访问权限
-- ✅ 无需确认
-
-**警告:** 谨慎使用。代理可以修改和删除文件而不询问。
-
----
-
-## 模式指示器
-
-您的当前模式始终在代理问候语中可见:
-
-```
-🏛️ Aria (架构师) 已准备好！[⚠️ 询问]
-
-快速命令:
-...
-```
-
-徽章显示:
-
-- `[🔍 探索]` - 只读模式
-- `[⚠️ 询问]` - 确认模式（默认）
-- `[⚡ 自动]` - 完全自主模式
-
----
-
-## 配置
-
-模式持久化在`.sinapse/config.yaml`:
-
-```yaml
-permissions:
-  mode: ask # explore | ask | auto
-```
-
----
-
-## 操作分类
-
-系统将操作分为4种类型:
-
-| 类型 | 示例 |
-|------|------|
-| **读取** | `Read`、`Glob`、`Grep`、`git status`、`ls` |
-| **写入** | `Write`、`Edit`、`mkdir`、`touch`、`git commit` |
-| **执行** | `npm install`、`npm run`、任务执行 |
-| **删除** | `rm`、`git reset --hard`、`DROP TABLE` |
-
-### 安全命令（始终允许）
-
-这些命令即使在探索模式下也始终允许:
-
-```bash
-# Git（只读）
-git status, git log, git diff, git branch
-
-# 文件系统（只读）
-ls, pwd, cat, head, tail, wc, find, grep
-
-# 包信息
-npm list, npm outdated, npm audit
-
-# 系统信息
-node --version, npm --version, uname, whoami
-```
-
-### 破坏性命令（额外谨慎）
-
-这些触发删除分类，即使在询问模式下也需要明确批准:
-
-```bash
-rm -rf
-git reset --hard
-git push --force
-DROP TABLE
-DELETE FROM
-TRUNCATE
-```
-
----
-
-## ADE集成
-
-自主开发引擎(ADE)尊重权限模式:
-
-| 模式 | ADE行为 |
-|------|---------|
-| **探索** | 仅规划，无执行 |
-| **询问** | 批量操作待批准 |
-| **自动** | 完全自主执行 |
-
-### 询问模式中的批量批准
-
-运行自主工作流时，操作被分组:
-
-```
-⚠️ 批量确认
-
-以下5个操作将被执行:
-- 写入: 创建 src/components/NewFeature.tsx
-- 写入: 更新 src/index.ts
-- 执行: npm install lodash
-- 写入: 添加 tests/newFeature.test.ts
-- 执行: npm test
-
-[全部批准] [逐个审查] [取消]
-```
-
----
-
-## 最佳实践
-
-### 对于新用户
-
-1. 从`*mode explore`开始安全浏览
-2. 准备好进行更改时切换到`*mode ask`
-3. 仅在确信时使用`*mode auto`
-
-### 对于CI/CD
-
-在自动化中设置模式:
-
-```yaml
-# .github/workflows/sinapse.yml
-- name: 运行SINAPSE
-  run: |
-    echo "permissions:\n  mode: auto" > .sinapse/config.yaml
-    sinapse run build
-```
-
-### 对于团队
-
-- 在共享环境中默认使用`ask`模式
-- 在代码审查中使用`explore`
-- 为指定的自动化帐户保留`auto`
-
----
-
-## 故障排除
-
-### "在探索模式中操作被阻止"
-
-切换到限制较少的模式:
-
-```
-*mode ask
-```
-
-### 模式不持久化
-
-检查`.sinapse/config.yaml`存在且可写:
-
-```bash
-ls -la .sinapse/config.yaml
-```
-
-### 确认过于频繁
-
-切换到自动模式:
-
-```
-*mode auto
-```
-
-或在ADE工作流中使用批量批准。
-
----
-
-## API参考
-
-```javascript
-const { PermissionMode, OperationGuard } = require('./.sinapse-ai/core/permissions');
-
-// 加载当前模式
-const mode = new PermissionMode();
-await mode.load();
-console.log(mode.currentMode); // 'ask'
-console.log(mode.getBadge()); // '[⚠️ 询问]'
-
-// 更改模式
-await mode.setMode('auto');
-
-// 检查操作
-const guard = new OperationGuard(mode);
-const result = await guard.guard('Bash', { command: 'rm -rf node_modules' });
-// { proceed: false, needsConfirmation: true, operation: 'delete', ... }
-```
-
----
-
-_权限模式 - 受 [Craft Agents OSS](https://github.com/lukilabs/craft-agents-oss) 启发_