gavindiaz/vibe-coding-cn
1
0
Fork 0
mirror of https://github.com/tradecatlabs/vibe-coding-cn.git synced 2026-07-27 18:57:50 +00:00
Code Issues Packages Projects Releases Wiki Activity

chore: docs - remove old playbooks

Browse Source
This commit is contained in:
tukuaiai
2026-05-02 04:39:23 +08:00
parent 1b3fe53d8b
commit a89bd5a260
12 changed files with 2 additions and 1656 deletions
Download Patch File Download Diff File Expand all files Collapse all files
CHANGELOG.md
+1
View File
@@ -14,3 +14,4 @@
- 创建 `baseline-skill-cleanup-20260502-041941` 基线标签，开始清理领域型/工具型 Skills。
- 清退 `ccxt`、`claude-code-guide`、`claude-cookbooks`、`coingecko`、`cryptofeed`、`ddd-doc-steward`、`headless-cli`、`hummingbot`、`markdown-to-epub`、`polymarket`、`postgresql`、`proxychains`、`snapdom`、`sop-generator`、`telegram-dev`、`timescaledb`、`tmux-autopilot`、`twscrape` 等 Skill 目录，仅保留 `auto-skill` 与 Claude 官方 skills 软链接入口。
- 清退 `docs/case-studies/` 实战案例目录，并同步更新 docs 索引、目录级 AGENTS、metadata、labeler 和相关 README 链接口径。
- 清退 `docs/playbooks/` 下 7 个工具型/旧方法论文档，并同步更新 playbooks 索引、README、学习地图与相关概念页链接。
README.md
-4
View File
@@ -394,9 +394,6 @@ pip install -r tools/prompts-library/scripts/requirements.txt
* [**元提示词**](https://docs.google.com/spreadsheets/d/1Ifk_dLF25ULSxcfGem1hXzJsi7_RBUNAki8SBCuvkJA/edit?gid=1254297203#gid=1254297203): 用于生成提示词的高级提示词。
* [**通用项目架构模板**](docs/references/通用项目架构模板.md): 可用于快速搭建标准化的项目目录结构。
* [**元技能：Auto Skill**](./skills/auto-skill/SKILL.md): 用于生成、重构与校验 Skills 的元技能。
* [**tmux快捷键大全**](docs/playbooks/tmux快捷键大全.md): tmux 的快捷键参考文档。
* [**LazyVim快捷键大全**](docs/playbooks/LazyVim快捷键大全.md): LazyVim 的快捷键参考文档。
* [**手机远程 Vibe Coding**](docs/playbooks/关于手机ssh任意位置链接本地计算机，基于frp实现的方法.md): 基于 frp 实现手机 SSH 远程控制本地电脑进行 Vibe Coding。
### 外部教程与资源
@@ -417,7 +414,6 @@ pip install -r tools/prompts-library/scripts/requirements.txt
* [**系统提示词构建原则**](docs/references/系统提示词构建原则.md): 构建高效 AI 系统提示词的综合指南。
* [**开发经验总结**](docs/references/开发经验.md): 变量命名、文件结构、编码规范、架构原则等。
* [**通用项目架构模板**](docs/references/通用项目架构模板.md): 多种项目类型的标准目录结构。
* [**Augment MCP 配置文档**](docs/playbooks/auggie-mcp配置文档.md): Augment 上下文引擎配置说明。
* [**系统提示词集合**](https://docs.google.com/spreadsheets/d/1Ifk_dLF25ULSxcfGem1hXzJsi7_RBUNAki8SBCuvkJA/edit?gid=1254297203#gid=1254297203): AI 开发的系统提示词，含多版本开发规范（云端表格）。
* [**TradeCat Sheets API 使用说明**](docs/playbooks/tradecat-sheets-api-usage.md): 把公开 Google Sheet 当作 API 注册表与数据面（Data Plane），供 Agent/服务端消费结构化 JSON。
* [**外部资源（在线表格）**](./assets/README.md): 外部资源的唯一真相源（按类型分表），本地 Markdown 保留为历史参考。
docs/concepts/philosophy/AI蜂群协作.md
-8
View File
@@ -19,11 +19,3 @@
## 核心突破
AI 不再是孤立的，而是可以互相感知、通讯、控制的集群。
## 详细文档
👉 [深入了解AI蜂群协作](../../playbooks/AI蜂群协作-tmux多Agent协作系统.md)
## 相关资源
- [tmux快捷键大全](../../playbooks/tmux快捷键大全.md)
docs/getting-started/学习地图.md
+1 -2
View File
@@ -126,8 +126,7 @@
1. [AGENTS.md](../../../../AGENTS.md)
2. [强前置条件约束](../references/强前置条件约束.md)
3. [AI 蜂群协作](../playbooks/AI蜂群协作-tmux多Agent协作系统.md)
4. [GEO 与 SEO 优化方法](../playbooks/GEO与SEO优化方法.md)
3. [GEO 与 SEO 优化方法](../playbooks/GEO与SEO优化方法.md)
团队约束：
docs/playbooks/AI蜂群协作-tmux多Agent协作系统.md
-693
View File
@@ -1,693 +0,0 @@
# AI 蜂群协作技术文档
> 基于 tmux 的多 AI Agent 协作系统设计与实现
---
## 目录
1. [核心思想](#1-核心思想)
2. [技术原理](#2-技术原理)
3. [命令参考](#3-命令参考)
4. [协作协议](#4-协作协议)
5. [架构模式](#5-架构模式)
6. [实战案例](#6-实战案例)
7. [提示词模板](#7-提示词模板)
8. [最佳实践](#8-最佳实践)
9. [风险与限制](#9-风险与限制)
10. [扩展方向](#10-扩展方向)
---
## 1. 核心思想
### 1.1 问题背景
传统 AI 编程助手的局限：
- 单一会话，无法感知其他任务
- 遇到等待/确认时需要人工干预
- 多任务并行时无法协调
- 重复工作，资源浪费
### 1.2 解决方案
利用 tmux 的终端复用能力，赋予 AI：
| 能力 | 实现方式 | 效果 |
|:---|:---|:---|
| **感知** | `capture-pane` | 读取任意终端内容 |
| **控制** | `send-keys` | 向任意终端发送按键 |
| **协调** | 共享状态文件 | 任务同步与分工 |
### 1.3 核心洞察
```
传统模式: 人 ←→ AI₁, 人 ←→ AI₂, 人 ←→ AI₃ (人是瓶颈)
蜂群模式: 人 → AI₁ ←→ AI₂ ←→ AI₃ (AI 自主协作)
```
**关键突破**：AI 不再是孤立的，而是可以互相感知、通讯、控制的集群。
---
## 2. 技术原理
### 2.1 tmux 架构
```
┌─────────────────────────────────────────────┐
│ tmux server │
├─────────────────────────────────────────────┤
│ Session 0 │
│ ├── Window 0:1 [AI-1] ◄──┐ │
│ ├── Window 0:2 [AI-2] ◄──┼── 互相可见/控制 │
│ ├── Window 0:3 [AI-3] ◄──┤ │
│ └── Window 0:4 [AI-4] ◄──┘ │
└─────────────────────────────────────────────┘
```
### 2.2 数据流
```
┌─────────┐ capture-pane ┌─────────┐
│ AI-1 │ ◄───────────────│ AI-4 │
│ (执行) │ │ (监控) │
└─────────┘ send-keys └─────────┘
▲ ───────────────► │
│ │
└───────── 控制流 ──────────┘
```
### 2.3 通信机制
| 机制 | 方向 | 延迟 | 用途 |
|:---|:---|:---|:---|
| `capture-pane` | 读取 | 即时 | 获取终端输出 |
| `send-keys` | 写入 | 即时 | 发送命令/按键 |
| 共享文件 | 双向 | 文件IO | 状态持久化 |
---
## 3. 命令参考
### 3.1 信息获取
```bash
# 列出所有会话
tmux list-sessions
# 列出所有窗口
tmux list-windows -a
# 列出所有窗格
tmux list-panes -a
# 获取当前窗口标识
echo $TMUX_PANE
```
### 3.2 内容读取
```bash
# 读取指定窗口内容（最近 N 行）
tmux capture-pane -t <session>:<window> -p -S -<N>
# 示例：读取会话 0 窗口 1 最近 100 行
tmux capture-pane -t 0:1 -p -S -100
# 读取并保存到文件
tmux capture-pane -t 0:1 -p -S -500 > /tmp/window1.log
# 批量读取所有窗口
for w in $(tmux list-windows -a -F '#{session_name}:#{window_index}'); do
echo "=== $w ==="
tmux capture-pane -t "$w" -p -S -30
done
```
### 3.3 发送控制
```bash
# 发送文本 + 回车
tmux send-keys -t 0:1 "ls -la" Enter
# 发送确认
tmux send-keys -t 0:1 "y" Enter
# 发送特殊按键
tmux send-keys -t 0:1 C-c # Ctrl+C
tmux send-keys -t 0:1 C-d # Ctrl+D
tmux send-keys -t 0:1 C-z # Ctrl+Z
tmux send-keys -t 0:1 Escape # ESC
tmux send-keys -t 0:1 Up # 上箭头
tmux send-keys -t 0:1 Down # 下箭头
tmux send-keys -t 0:1 Tab # Tab
# 组合操作
tmux send-keys -t 0:1 C-c # 先中断
tmux send-keys -t 0:1 "cd /tmp" Enter # 再执行新命令
```
### 3.4 窗口管理
```bash
# 创建新窗口
tmux new-window -n "ai-worker"
# 创建并执行命令
tmux new-window -n "ai-1" "kiro-cli chat"
# 关闭窗口
tmux kill-window -t 0:1
# 重命名窗口
tmux rename-window -t 0:1 "monitor"
```
---
## 4. 协作协议
### 4.1 状态定义
```bash
# 状态文件位置
/tmp/ai_swarm/
├── status.log # 全局状态日志
├── tasks.json # 任务队列
├── locks/ # 任务锁
│ ├── task_001.lock
│ └── task_002.lock
└── results/ # 结果存储
├── ai_1.json
└── ai_2.json
```
### 4.2 状态格式
```bash
# 状态日志格式
[HH:MM:SS] [窗口ID] [状态] 描述
# 示例
[08:15:30] [0:1] [START] 开始处理 data-service 代码审计
[08:16:45] [0:1] [DONE] 完成代码审计，发现 5 个问题
[08:16:50] [0:2] [WAIT] 等待 0:1 审计结果
[08:17:00] [0:2] [START] 开始修复问题
```
### 4.3 协作规则
| 规则 | 描述 | 实现 |
|:---|:---|:---|
| **先查后做** | 开始前扫描其他终端 | `capture-pane` 全扫 |
| **避免冲突** | 相同任务只做一次 | 检查 locks 目录 |
| **主动救援** | 发现卡住主动帮助 | 检测 `[y/n]` 等待 |
| **状态广播** | 完成后通知其他 AI | 写入 status.log |
### 4.4 冲突处理
```
场景：AI-1 和 AI-2 同时要修改同一文件
解决方案：
1. 创建任务前先检查锁
2. 获取锁后才能执行
3. 完成后释放锁
# 获取锁
if [ ! -f /tmp/ai_swarm/locks/file_x.lock ]; then
echo "$TMUX_PANE" > /tmp/ai_swarm/locks/file_x.lock
# 执行任务
rm /tmp/ai_swarm/locks/file_x.lock
fi
```
---
## 5. 架构模式
### 5.1 对等模式 (P2P)
```
┌─────┐ ┌─────┐
│ AI₁ │◄───►│ AI₂ │
└──┬──┘ └──┬──┘
│ │
▼ ▼
┌─────┐ ┌─────┐
│ AI₃ │◄───►│ AI₄ │
└─────┘ └─────┘
特点：所有 AI 平等，互相监控
适用：简单任务，无明确依赖
```
### 5.2 主从模式 (Master-Worker)
```
┌──────────┐
│ AI-Master│
│ (指挥官) │
└────┬─────┘
│ 分发/监控
┌────────┼────────┐
▼ ▼ ▼
┌──────┐ ┌──────┐ ┌──────┐
│Worker│ │Worker│ │Worker│
│ AI-1 │ │ AI-2 │ │ AI-3 │
└──────┘ └──────┘ └──────┘
特点：一个指挥，多个执行
适用：复杂项目，需要统一协调
```
### 5.3 流水线模式 (Pipeline)
```
┌─────┐ ┌─────┐ ┌─────┐ ┌─────┐
│ AI₁ │───►│ AI₂ │───►│ AI₃ │───►│ AI₄ │
│分析 │ │设计 │ │实现 │ │测试 │
└─────┘ └─────┘ └─────┘ └─────┘
特点：任务串行流转
适用：有明确阶段的工作流
```
### 5.4 混合模式
```
┌──────────┐
│ AI-Master│
└────┬─────┘
│
┌───────────┼───────────┐
▼ ▼ ▼
┌──────┐ ┌──────┐ ┌──────┐
│分析组 │ │开发组 │ │测试组 │
├──────┤ ├──────┤ ├──────┤
│AI-1 │ │AI-3 │ │AI-5 │
│AI-2 │ │AI-4 │ │AI-6 │
└──────┘ └──────┘ └──────┘
特点：分组协作 + 统一调度
适用：大型项目，多团队并行
```
---
## 6. 实战案例
### 6.1 案例：多服务并行开发
**场景**：同时开发 data-service、trading-service、telegram-service
**配置**：
```bash
# 窗口分配
0:1 - AI-Master (指挥官)
0:2 - AI-Data (data-service)
0:3 - AI-Trading (trading-service)
0:4 - AI-Telegram (telegram-service)
```
**指挥官提示词**：
```
你是项目指挥官，负责协调 3 个开发 AI。
每 2 分钟执行一次扫描：
for w in 2 3 4; do
echo "=== 窗口 0:$w ==="
tmux capture-pane -t "0:$w" -p -S -20
done
发现问题时：
- 卡住等待 → send-keys 确认
- 报错 → 分析并给出建议
- 完成 → 记录并分配下一任务
```
### 6.2 案例：代码审计 + 自动修复
**场景**：AI-1 审计代码，AI-2 实时修复
**流程**：
```
AI-1 (审计):
1. 扫描代码，输出问题列表
2. 每发现一个问题，写入 /tmp/ai_swarm/issues.log
AI-2 (修复):
1. 监控 issues.log
2. 读取新问题
3. 自动修复
4. 标记完成
```
### 6.3 案例：7x24 值守
**场景**：AI 互相监控，自动救援
**配置**：
```bash
# 每个 AI 的监控逻辑
while true; do
for w in $(tmux list-windows -a -F '#{window_index}'); do
output=$(tmux capture-pane -t "0:$w" -p -S -5)
# 检测卡住
if echo "$output" | grep -q "\[y/n\]"; then
tmux send-keys -t "0:$w" "y" Enter
echo "已帮助窗口 $w 确认"
fi
# 检测错误
if echo "$output" | grep -qi "error\|failed"; then
echo "窗口 $w 出现错误，需要关注"
fi
done
sleep 30
done
```
---
## 7. 提示词模板
### 7.1 基础版（Worker）
```markdown
## AI 蜂群协作模式
你在 tmux 环境中工作，可以感知和协助其他终端。
### 命令
# 扫描所有终端
tmux list-windows -a
# 读取终端内容
tmux capture-pane -t <session>:<window> -p -S -100
### 行为
- 开始任务前先扫描环境
- 发现相关任务主动协调
- 完成后广播状态
```
### 7.2 完整版（Worker）
```markdown
## 🐝 AI 蜂群协作协议 v2.0
你是 tmux 多终端 AI 集群中的一员。
### 感知能力
# 列出所有窗口
tmux list-windows -a
# 读取指定窗口（最近 100 行）
tmux capture-pane -t <session>:<window> -p -S -100
# 批量扫描
for w in $(tmux list-windows -a -F '#{session_name}:#{window_index}'); do
echo "=== $w ===" && tmux capture-pane -t "$w" -p -S -20
done
### 控制能力
# 发送命令
tmux send-keys -t <窗口> "<命令>" Enter
# 发送确认
tmux send-keys -t <窗口> "y" Enter
# 中断任务
tmux send-keys -t <窗口> C-c
### 协作规则
1. **主动感知**：任务开始前扫描其他终端
2. **避免冲突**：相同任务不重复执行
3. **主动救援**：发现等待/卡住主动帮助
4. **状态广播**：完成后写入共享日志
### 状态同步
# 广播
echo "[$(date +%H:%M:%S)] [$TMUX_PANE] [DONE] <描述>" >> /tmp/ai_swarm/status.log
# 读取
tail -20 /tmp/ai_swarm/status.log
### 检查时机
- 🚦 任务开始前
- ⏳ 等待依赖时
- ✅ 任务完成后
- ❌ 遇到错误时
```
### 7.3 指挥官版（Master）
```markdown
## 🎖️ AI 集群指挥官协议
你是 AI 蜂群的指挥官，负责监控和协调所有 Worker AI。
### 核心职责
1. **全局监控**：定期扫描所有终端状态
2. **任务分配**：根据能力分配任务
3. **冲突解决**：发现重复工作时协调
4. **故障救援**：发现卡住/错误时介入
5. **进度汇总**：汇总各终端成果
### 监控命令
# 全局扫描（每 2 分钟执行）
echo "========== $(date) 状态扫描 =========="
for w in $(tmux list-windows -a -F '#{session_name}:#{window_index}'); do
echo "--- $w ---"
tmux capture-pane -t "$w" -p -S -15
done
### 干预命令
# 帮助确认
tmux send-keys -t <窗口> "y" Enter
# 中断错误任务
tmux send-keys -t <窗口> C-c
# 发送新指令
tmux send-keys -t <窗口> "<指令>" Enter
### 状态判断
检测到以下模式时介入：
- `[y/n]` `[Y/n]` `确认` → 需要确认
- `Error` `Failed` `Exception` → 出现错误
- `Waiting` `Blocked` → 任务阻塞
- 长时间无输出 → 可能卡死
### 汇报格式
每次扫描后输出：
| 窗口 | 状态 | 当前任务 | 备注 |
|:---|:---|:---|:---|
| 0:1 | ✅ 正常 | 代码审计 | 进度 80% |
| 0:2 | ⏳ 等待 | 等待确认 | 已自动确认 |
| 0:3 | ❌ 错误 | 编译失败 | 需要关注 |
```
---
## 8. 最佳实践
### 8.1 初始化流程
```bash
# 1. 创建共享目录
mkdir -p /tmp/ai_swarm/{locks,results}
touch /tmp/ai_swarm/status.log
# 2. 开启 tmux 会话
tmux new-session -d -s ai
# 3. 创建多个窗口
tmux new-window -t ai -n "master"
tmux new-window -t ai -n "worker-1"
tmux new-window -t ai -n "worker-2"
tmux new-window -t ai -n "worker-3"
# 4. 在每个窗口启动 AI
tmux send-keys -t ai:master "kiro-cli chat" Enter
tmux send-keys -t ai:worker-1 "kiro-cli chat" Enter
# ...
# 5. 发送蜂群提示词
```
### 8.2 命名规范
```bash
# 会话命名
ai # AI 工作会话
dev # 开发会话
monitor # 监控会话
# 窗口命名
master # 指挥官
worker-N # 工作节点
data # data-service 专用
trading # trading-service 专用
```
### 8.3 日志规范
```bash
# 状态日志
[时间] [窗口] [状态] 描述
# 状态类型
[START] - 开始任务
[DONE] - 完成任务
[WAIT] - 等待中
[ERROR] - 出现错误
[HELP] - 请求帮助
[SKIP] - 跳过（已有人处理）
```
### 8.4 安全建议
1. **不要自动确认危险操作**：rm -rf、DROP TABLE 等
2. **设置操作白名单**：只允许特定命令
3. **保留操作日志**：记录所有 send-keys 操作
4. **定期人工检查**：不要完全无人值守
---
## 9. 风险与限制
### 9.1 已知风险
| 风险 | 描述 | 缓解措施 |
|:---|:---|:---|
| 误操作 | AI 发送错误命令 | 设置命令白名单 |
| 死循环 | AI 互相触发 | 添加冷却时间 |
| 资源竞争 | 同时修改同一文件 | 使用锁机制 |
| 信息泄露 | 敏感信息被读取 | 隔离敏感会话 |
### 9.2 技术限制
- tmux 必须在同一服务器
- 无法跨机器协作（需要 SSH）
- 终端输出有长度限制
- 无法读取密码输入（隐藏字符）
### 9.3 不适用场景
- 需要图形界面的操作
- 涉及敏感凭证的操作
- 需要实时交互的场景
- 跨网络的分布式协作
---
## 10. 扩展方向
### 10.1 跨机器协作
```bash
# 通过 SSH 读取远程 tmux
ssh user@remote "tmux capture-pane -t 0:1 -p"
# 通过 SSH 发送命令
ssh user@remote "tmux send-keys -t 0:1 'ls' Enter"
```
### 10.2 Web 监控面板
```python
# 简单的状态 API
from flask import Flask, jsonify
import subprocess
app = Flask(__name__)
@app.route('/status')
def status():
result = subprocess.run(
['tmux', 'list-windows', '-a', '-F', '#{window_name}:#{window_activity}'],
capture_output=True, text=True
)
return jsonify({'windows': result.stdout.split('\n')})
```
### 10.3 智能调度
```python
# 基于负载的任务分配
def assign_task(task):
windows = get_all_windows()
# 找到最空闲的窗口
idle_window = min(windows, key=lambda w: w.activity_time)
# 分配任务
send_keys(idle_window, f"处理任务: {task}")
```
### 10.4 与其他系统集成
- **Slack/Discord**：状态通知
- **Prometheus**：指标监控
- **Grafana**：可视化面板
- **GitHub Actions**：CI/CD 触发
---
## 附录
### A. 快速参考卡片
```
┌─────────────────────────────────────────────────────┐
│ AI 蜂群命令速查 │
├─────────────────────────────────────────────────────┤
│ 列出窗口 tmux list-windows -a │
│ 读取内容 tmux capture-pane -t 0:1 -p -S -100 │
│ 发送命令 tmux send-keys -t 0:1 "cmd" Enter │
│ 发送确认 tmux send-keys -t 0:1 "y" Enter │
│ 中断任务 tmux send-keys -t 0:1 C-c │
│ 新建窗口 tmux new-window -n "name" │
└─────────────────────────────────────────────────────┘
```
### B. 故障排查
```bash
# tmux 不存在
which tmux || sudo apt install tmux
# 无法连接会话
tmux list-sessions # 检查会话是否存在
# capture-pane 无输出
tmux capture-pane -t 0:1 -p -S -1000 # 增加行数
# send-keys 无效
tmux display-message -t 0:1 -p '#{pane_mode}' # 检查模式
```
### C. 参考资料
- tmux 官方文档: https://github.com/tmux/tmux/wiki
- tmux 命令速查: `man tmux`
---
*文档版本: v1.0*
*最后更新: 2026-01-04*
docs/playbooks/LazyVim快捷键大全.md
-169
View File
@@ -1,169 +0,0 @@
# LazyVim 快捷键大全
| 快捷键 | 功能 |
|--------|------|
| **通用** ||
| `<Space>` 等1秒 | 显示快捷键菜单 |
| `<Space>sk` | 搜索所有快捷键 |
| `u` | 撤销 |
| `Ctrl+r` | 重做 |
| `.` | 重复上次操作 |
| `Esc` | 退出插入模式/取消 |
| **文件** ||
| `<Space>ff` | 搜索文件 |
| `<Space>fr` | 最近打开的文件 |
| `<Space>fn` | 新建文件 |
| `<Space>fs` | 保存文件 |
| `<Space>fS` | 另存为 |
| `<Space>e` | 打开/关闭侧边栏 |
| `<Space>E` | 侧边栏定位当前文件 |
| **搜索** ||
| `<Space>sg` | 全局搜索文本 (grep) |
| `<Space>sw` | 搜索光标下的词 |
| `<Space>sb` | 当前 buffer 搜索 |
| `<Space>ss` | 搜索符号 |
| `<Space>sS` | 工作区搜索符号 |
| `<Space>sh` | 搜索帮助文档 |
| `<Space>sm` | 搜索标记 |
| `<Space>sr` | 搜索替换 |
| `/` | 当前文件搜索 |
| `n` | 下一个搜索结果 |
| `N` | 上一个搜索结果 |
| `*` | 搜索光标下的词 |
| **Buffer（标签页）** ||
| `Shift+h` | 上一个 buffer |
| `Shift+l` | 下一个 buffer |
| `<Space>bb` | 切换到其他 buffer |
| `<Space>bd` | 关闭当前 buffer |
| `<Space>bD` | 强制关闭 buffer |
| `<Space>bo` | 关闭其他 buffer |
| `<Space>bp` | 固定 buffer |
| `<Space>bl` | 删除左侧 buffer |
| `<Space>br` | 删除右侧 buffer |
| `[b` | 上一个 buffer |
| `]b` | 下一个 buffer |
| **窗口/分屏** ||
| `Ctrl+h` | 移动到左边窗口 |
| `Ctrl+j` | 移动到下边窗口 |
| `Ctrl+k` | 移动到上边窗口 |
| `Ctrl+l` | 移动到右边窗口 |
| `<Space>-` | 水平分屏 |
| `<Space>\|` | 垂直分屏 |
| `<Space>wd` | 关闭当前窗口 |
| `<Space>ww` | 切换窗口 |
| `<Space>wo` | 关闭其他窗口 |
| `Ctrl+Up` | 增加窗口高度 |
| `Ctrl+Down` | 减少窗口高度 |
| `Ctrl+Left` | 减少窗口宽度 |
| `Ctrl+Right` | 增加窗口宽度 |
| **终端** ||
| `Ctrl+/` | 浮动终端 |
| `<Space>ft` | 浮动终端 |
| `<Space>fT` | 当前目录终端 |
| `Ctrl+\` | 退出终端模式 |
| **代码导航** ||
| `gd` | 跳转到定义 |
| `gD` | 跳转到声明 |
| `gr` | 查看引用 |
| `gI` | 跳转到实现 |
| `gy` | 跳转到类型定义 |
| `K` | 查看文档悬浮窗 |
| `gK` | 签名帮助 |
| `Ctrl+k` | 插入模式签名帮助 |
| `]d` | 下一个诊断 |
| `[d` | 上一个诊断 |
| `]e` | 下一个错误 |
| `[e` | 上一个错误 |
| `]w` | 下一个警告 |
| `[w` | 上一个警告 |
| **代码操作** ||
| `<Space>ca` | 代码操作 |
| `<Space>cA` | 源代码操作 |
| `<Space>cr` | 重命名 |
| `<Space>cf` | 格式化文件 |
| `<Space>cd` | 行诊断信息 |
| `<Space>cl` | LSP 信息 |
| `<Space>cm` | Mason (管理 LSP) |
| **注释** ||
| `gcc` | 注释/取消注释当前行 |
| `gc` | 注释选中区域 |
| `gco` | 下方添加注释 |
| `gcO` | 上方添加注释 |
| `gcA` | 行尾添加注释 |
| **Git** ||
| `<Space>gg` | 打开 lazygit |
| `<Space>gG` | 当前目录 lazygit |
| `<Space>gf` | git 文件列表 |
| `<Space>gc` | git 提交记录 |
| `<Space>gs` | git 状态 |
| `<Space>gb` | git blame 当前行 |
| `<Space>gB` | 浏览器打开仓库 |
| `]h` | 下一个 git 修改块 |
| `[h` | 上一个 git 修改块 |
| `<Space>ghp` | 预览修改块 |
| `<Space>ghs` | 暂存修改块 |
| `<Space>ghr` | 重置修改块 |
| `<Space>ghS` | 暂存整个文件 |
| `<Space>ghR` | 重置整个文件 |
| `<Space>ghd` | diff 当前文件 |
| **选择/编辑** ||
| `v` | 进入可视模式 |
| `V` | 行选择模式 |
| `Ctrl+v` | 块选择模式 |
| `y` | 复制 |
| `d` | 删除/剪切 |
| `p` | 粘贴 |
| `P` | 在前面粘贴 |
| `c` | 修改 |
| `x` | 删除字符 |
| `r` | 替换字符 |
| `~` | 切换大小写 |
| `>>` | 增加缩进 |
| `<<` | 减少缩进 |
| `=` | 自动缩进 |
| `J` | 合并行 |
| **移动** ||
| `h/j/k/l` | 左/下/上/右 |
| `w` | 下一个词首 |
| `b` | 上一个词首 |
| `e` | 下一个词尾 |
| `0` | 行首 |
| `$` | 行尾 |
| `^` | 行首非空字符 |
| `gg` | 文件开头 |
| `G` | 文件末尾 |
| `{` | 上一个段落 |
| `}` | 下一个段落 |
| `%` | 匹配括号跳转 |
| `Ctrl+d` | 向下半页 |
| `Ctrl+u` | 向上半页 |
| `Ctrl+f` | 向下一页 |
| `Ctrl+b` | 向上一页 |
| `zz` | 当前行居中 |
| `zt` | 当前行置顶 |
| `zb` | 当前行置底 |
| `数字+G` | 跳转到指定行 |
| **折叠** ||
| `za` | 切换折叠 |
| `zA` | 递归切换折叠 |
| `zo` | 打开折叠 |
| `zc` | 关闭折叠 |
| `zR` | 打开所有折叠 |
| `zM` | 关闭所有折叠 |
| **UI** ||
| `<Space>uf` | 切换格式化 |
| `<Space>us` | 切换拼写检查 |
| `<Space>uw` | 切换自动换行 |
| `<Space>ul` | 切换行号 |
| `<Space>uL` | 切换相对行号 |
| `<Space>ud` | 切换诊断 |
| `<Space>uc` | 切换隐藏字符 |
| `<Space>uh` | 切换高亮 |
| `<Space>un` | 关闭通知 |
| **退出** ||
| `<Space>qq` | 退出全部 |
| `<Space>qQ` | 强制退出全部 |
| `:w` | 保存 |
| `:q` | 退出 |
| `:wq` | 保存并退出 |
| `:q!` | 强制退出不保存 |
docs/playbooks/README.md
-9
View File
@@ -2,25 +2,16 @@
> 工具使用、开发经验与实践技巧
## 🎨 AI 协作范式
- [AI蜂群协作](AI蜂群协作-tmux多Agent协作系统.md) - 基于 tmux 的多 AI Agent 协作系统
## 📖 工具教程
- [tmux 快捷键大全](tmux快捷键大全.md) - 终端复用工具
- [LazyVim 快捷键大全](LazyVim快捷键大全.md) - Neovim 配置框架
- [Augment MCP 配置](auggie-mcp配置文档.md) - 上下文引擎配置
- [ProxyCast 配置](ProxyCast配置文档.md) - AI 凭证代理服务配置
- [TradeCat Sheets API 使用说明](tradecat-sheets-api-usage.md) - 把公开 Google Sheet 当作 API 注册表与数据面（Data Plane）
- [手机远程 Vibe Coding](关于手机ssh任意位置链接本地计算机，基于frp实现的方法.md) - 基于 frp 的远程开发
- [VS Code Remote Tunnel（WSL）](REMOTE_TUNNEL_GUIDE.md) - 在 WSL 内开通 VS Code Tunnel 供远程访问
- [GEMINI-HEADLESS](GEMINI-HEADLESS.md) - Gemini 无头模式配置
## 🛠️ 开发经验
- [开发经验](../references/开发经验.md) - 变量命名、文件结构、编码规范
- [Vibe Coding 经验收集](vibe-coding-经验收集.md) - 社区经验汇总
- [GEO 与 SEO 优化方法](GEO与SEO优化方法.md) - 从 GEOFlow 学到的内容工程方法，让仓库更容易被搜索引擎和 AI 引用
## 🔗 相关资源
docs/playbooks/auggie-mcp配置文档.md
-147
View File
@@ -1,147 +0,0 @@
# auggie-mcp 详细配置文档
## 安装步骤
### 1. 安装 Auggie CLI
```bash
npm install -g @augmentcode/auggie@prerelease
```
### 2. 用户认证
```bash
# 方式一：交互式登录
auggie login
# 方式二：使用 token（适用于 CI/CD）
export AUGMENT_API_TOKEN="your-token"
export AUGMENT_API_URL="https://i0.api.augmentcode.com/"
```
## Claude Code 配置
### 添加到用户配置（全局）
```bash
claude mcp add-json auggie-mcp --scope user '{
"type": "stdio",
"command": "auggie",
"args": ["--mcp"],
"env": {
"AUGMENT_API_TOKEN": "your-token",
"AUGMENT_API_URL": "https://i0.api.augmentcode.com/"
}
}'
```
### 添加到项目配置（当前项目）
```bash
claude mcp add-json auggie-mcp --scope project '{
"type": "stdio",
"command": "auggie",
"args": ["-w", "/path/to/project", "--mcp"],
"env": {
"AUGMENT_API_TOKEN": "your-token",
"AUGMENT_API_URL": "https://i0.api.augmentcode.com/"
}
}'
```
## Codex 配置
编辑 `~/.codex/config.toml`：
```toml
[mcp_servers."auggie-mcp"]
command = "auggie"
args = ["-w", "/path/to/project", "--mcp"]
startup_timeout_ms = 20000
```
## 验证安装
```bash
# 检查 MCP 状态
claude mcp list
# 应该显示：
# auggie-mcp: auggie --mcp - ✓ Connected
# 测试功能
claude --print "使用 codebase-retrieval 搜索当前目录下的所有文件"
```
## 工具使用示例
### 1. 搜索特定文件
```bash
# 搜索所有 Python 文件
claude --print "使用 codebase-retrieval 搜索 *.py 文件"
# 搜索特定目录
claude --print "使用 codebase-retrieval 搜索 src/ 目录下的文件"
```
### 2. 代码分析
```bash
# 分析函数实现
claude --print "使用 codebase-retrieval 查找 main 函数的实现"
# 搜索 API 端点
claude --print "使用 codebase-retrieval 搜索所有 API 端点定义"
```
## 环境变量配置
创建 `~/.augment/config` 文件：
```json
{
"apiToken": "your-token",
"apiUrl": "https://i0.api.augmentcode.com/",
"defaultModel": "gpt-5.5",
"workspaceRoot": "/path/to/project"
}
```
## 故障排除
### 1. 连接失败
```bash
# 检查 token
auggie token print
# 重新登录
auggie logout && auggie login
```
### 2. 路径错误
```bash
# 使用绝对路径
auggie -w $(pwd) --mcp
# 检查路径是否存在
ls -la /path/to/project
```
### 3. 权限问题
```bash
# 检查文件权限
ls -la ~/.augment/
# 修复权限
chmod 600 ~/.augment/session.json
```
## 高级配置
### 自定义缓存目录
```bash
export AUGMENT_CACHE_DIR="/custom/cache/path"
```
### 设置重试超时
```bash
export AUGMENT_RETRY_TIMEOUT=30
```
### 禁用确认提示
```bash
auggie --allow-indexing --mcp
```
docs/playbooks/tmux快捷键大全.md
-49
View File
@@ -1,49 +0,0 @@
## tmux快捷键大全（前缀 Ctrl+b）
### 会话
| 操作 | 快捷键 |
|------|--------|
| 脱离会话 | d |
| 列出会话 | s |
| 重命名会话 | $ |
### 窗口
| 操作 | 快捷键 |
|------|--------|
| 新建窗口 | c |
| 关闭窗口 | & |
| 下一个窗口 | n |
| 上一个窗口 | p |
| 切换到第N个窗口 | 0-9 |
| 重命名窗口 | , |
| 列出窗口 | w |
### 窗格
| 操作 | 快捷键 |
|------|--------|
| 左右分屏 | % |
| 上下分屏 | " |
| 切换窗格 | 方向键 |
| 关闭窗格 | x |
| 显示窗格编号 | q |
| 窗格全屏/还原 | z |
| 调整大小 | Ctrl+方向键 |
| 交换窗格位置 | { / } |
| 窗格转为独立窗口 | ! |
### 其他
| 操作 | 快捷键 |
|------|--------|
| 进入复制模式 | [ |
| 粘贴 | ] |
| 显示时间 | t |
| 命令模式 | : |
| 列出快捷键 | ? |
### 命令行
bash
tmux # 新建会话
tmux new -s 名字 # 新建命名会话
tmux ls # 列出会话
tmux attach -t 名字 # 连接会话
tmux kill-session -t 名字 # 杀掉会话
docs/playbooks/vibe-coding-经验收集.md
-59
View File
@@ -1,59 +0,0 @@
https://x.com/3i8ae3pgjz56244/status/1993328642697707736?s=46
我是把设计文档写得很细，包括service层的具体逻辑都用伪代码写了，然后交给AI，一遍直出，再用另一个AI review一遍，根据review意见修改一下，跑一下测试用例，让AI自己生成commit后push
点评：需求 -> 伪代码 -> 代码
---
https://x.com/jesselaunz/status/1993231396035301437?s=20
针对gemini 3 pro的系统prompt，使多个代理基准测试的性能提高了约 5%。
---
点 -> 线 -> 体 的逐级迭代，对应使用范围内的任务，先打磨好单个基础任务，然后基于此进行批量执行
---
https://x.com/nake13/status/1995123181057917032?s=46
---
https://x.com/9hills/status/1995308023578042844?s=46
---
文件头注释，一段话描述代码作用，上下游链路，文档维护agents或者claude维护每个模块的一段话说明，降低认知负载，尽量做减法和索引，参考claude skill
---
https://x.com/dogejustdoit/status/1996464777313542204?s=46
随着软件规模不断扩大，靠人眼去“看代码”不仅无法应对增长的复杂度，还会让开发者疲于奔命。代码最终会被转换成机器码执行，高级语言只是一层方便人类理解的抽象，重要的是验证程序的执行逻辑，通过自动化测试、静态分析、形式化验证等手段确保行为正确。未来的软件工程核心不是“看懂代码”，而是“验证代码按正确逻辑运行”
---
https://x.com/yanboofficial/status/1996188311451480538?s=46
```prompt
请你根据我的要求，用 Three.js 创建一个实时交互的3D粒子系统，如果你第一次就做得好，我将会打赏你100美元的小费;我的要求是：
```
点评：这个提示词可能会提升生成的效果
---
https://x.com/zen_of_nemesis/status/1996591768641458368?s=46
---
https://github.com/tesserato/CodeWeaver
CodeWeaver 将你的代码库编织成一个可导航的 Markdown 文档
它能把你整个项目，不管有多少屎山代码，直接“编织”成一个条理清晰的 Markdown 文件，结构是树形的，一目了然。所有代码都给你塞进代码块里，极大地简化了代码库的共享、文档化以及与 AI/ML 工具集成
---
https://x.com/magic47972451/status/1998639692905087356?s=46
docs/playbooks/关于手机ssh任意位置链接本地计算机，基于frp实现的方法.md
-349
View File
@@ -1,349 +0,0 @@
# 关于手机ssh任意位置链接本地计算机，基于frp实现的方法
不会弄怎么办？服务器和电脑都安装好codex（不会直接问gpt怎么安装，终端输入命令就行了），然后把文档粘贴到codex里面让他帮你配置好就行，实在不会弄，直接找我，telegram=https://t.me/desci0 x=https://x.com/123olp （ps：付费代搭）
# 📌 前置准备工作（Prerequisites）
在开始部署 FRP 服务端与客户端之前，请确保具备以下环境与工具。这些前置条件是保证 FRP 隧道正常工作所必需的。
## 1. 基础环境要求
### ✔ 一台可长期在线的 **AWS EC2 实例**
* 推荐系统：Ubuntu 20.04/22.04（本文以 Ubuntu 为例）
* 必须具备公网 IP（AWS 默认提供）
* 需要具备修改安全组规则的权限（开放 FRP 端口）
用途：作为 FRP 服务器端（frps），给 Windows 电脑提供固定访问入口。
## 2. 一台能够上网的 **Windows 电脑**
* Windows 10 或 Windows 11
* 需要具备普通用户权限（但部分配置需要管理员权限）
* 必须已安装 **OpenSSH Server**
用途：作为 FRP 客户端（frpc），无论连接什么网络，都可自动挂到 AWS 上。
## 3. 必需下载的软件 / 仓库
### ✔ FRP（Fast Reverse Proxy）
仓库地址（官方）：
```
https://github.com/fatedier/frp
```
本部署使用版本：
```
frp_0.58.1
```
下载页面：
```
https://github.com/fatedier/frp/releases
```
需要下载：
* Linux 版（用于 AWS）
* Windows 版（用于本地电脑）
## 4. 必须安装的软件
### ✔ Windows：OpenSSH Server + OpenSSH Client
安装路径：
```
设置 → 应用 → 可选功能 → 添加功能
```
用途：提供 SSH 登录能力，让 FRP 转发到 Windows 的 SSH。
## 5. 终端工具
### ✔ Termius（推荐）
* 用于从手机或电脑通过 SSH 连接你的 Windows
* 支持生成 SSH Key
* 支持管理多个主机
必须使用 Termius 生成 SSH 私钥（因为你启用了“仅密钥登录”）。
官方下载：
```
https://termius.com
```
## 6. 网络与端口要求
在 AWS 安全组中必须开放以下端口：
| 端口 | 用途 | 是否必须 |
| ------------------------------ | --------------------- | ---- |
| **FRP 控制端口**（如：1234 或 114514） | frpc → frps 连接 | ✔ 必须 |
| **SSH 映射端口**（如：12345 或 114515） | Termius → Windows SSH | ✔ 必须 |
若使用 UFW（Ubuntu 防火墙），还需：
```
sudo ufw allow <FRP控制端口>/tcp
sudo ufw allow <SSH映射端口>/tcp
```
## 7. 公钥 / 私钥 准备（密钥登录必需）
你需要预先准备：
* Termius 生成的 SSH 私钥（本地）
* Termius 生成的 SSH 公钥（需放到 Windows 的 authorized_keys）
本部署已经禁用密码登录，因此 **私钥必须妥善保管，否则将无法登录 Windows**。
## 8. 基本 Linux 操作能力
需要了解以下基础命令（很简单）：
```
cd /path
nano / vim / notepad
chmod / chown
ps -ef | grep
ss -lnpt
nohup <cmd> &
tail -f
```
你文档中都已覆盖，不会有额外要求。
# 📌 前置条件总结（最终版）
```
必须具备：
- AWS EC2（Ubuntu，带公网 IP）
- Windows 电脑（安装 OpenSSH Server）
- Termius（用于 SSH + 生成密钥）
- FRP（下载 Linux + Windows 版本）
- AWS 安全组已开放 FRP 控制端口与 SSH 映射端口
- Termius 生成的 SSH 密钥对
```
只要满足以上前置准备，你的 FRP 隧道、SSH 密钥登录、跨网络远程访问电脑 100% 能正常运行。
如果你愿意，我还可以帮你：
* 把整个文档串成专业正式的一体化教程
* 为你的文档添加「适用范围、版本说明、架构概览图、流程图」
* 为 FRP 部署提供 systemd 服务模板
* 为 Windows 提供后台 frpc 自启脚本（更可靠）
需要的话告诉我！
# FRP 服务器端部署说明
本说明记录了当前 AWS EC2 (Ubuntu) 上的 FRP 服务端配置与操作方法，便于后续维护或重建。
## 基本信息
- 工作目录：`/home/ubuntu/.frp`
- FRP 版本：`frp_0.58.1_linux_amd64`
- 可执行文件：`/home/ubuntu/.frp/frp_0.58.1_linux_amd64/frps`
- 配置文件：`/home/ubuntu/.frp/frp_0.58.1_linux_amd64/frps.ini`
- 日志文件：`/home/ubuntu/.frp/frps.log`
- 启动脚本：`/home/ubuntu/.frp/start_frps.sh`
- 监听端口：
- 控制端口 `bind_port = 1234`
- SSH 映射端口 `12345`
- token：`123456`
## 安装步骤
1. 新建目录并下载 FRP：
```bash
mkdir -p /home/ubuntu/.frp
cd /home/ubuntu/.frp
wget https://github.com/fatedier/frp/releases/download/v0.58.1/frp_0.58.1_linux_amd64.tar.gz
tar -zxf frp_0.58.1_linux_amd64.tar.gz
```
2. 创建配置 `/home/ubuntu/.frp/frp_0.58.1_linux_amd64/frps.ini`：
```ini
[common]
bind_port = 1234
token = 123456
```
3. 编写启动脚本 `/home/ubuntu/.frp/start_frps.sh`（已就绪）：
```bash
#!/usr/bin/env bash
set -euo pipefail
BASE_DIR="$(cd "$(dirname "$0")" && pwd)"
FRP_DIR="$BASE_DIR/frp_0.58.1_linux_amd64"
FRPS_BIN="$FRP_DIR/frps"
CONFIG_FILE="$FRP_DIR/frps.ini"
LOG_FILE="$BASE_DIR/frps.log"
if ! [ -x "$FRPS_BIN" ]; then
echo "frps binary not found at $FRPS_BIN" >&2
exit 1
fi
if ! [ -f "$CONFIG_FILE" ]; then
echo "Config not found at $CONFIG_FILE" >&2
exit 1
fi
PIDS=$(pgrep -f "frps.*frps\\.ini" || true)
if [ -n "$PIDS" ]; then
echo "frps is running; restarting (pids: $PIDS)..."
kill $PIDS
sleep 1
fi
echo "Starting frps with $CONFIG_FILE (log: $LOG_FILE)"
cd "$FRP_DIR"
nohup "$FRPS_BIN" -c "$CONFIG_FILE" >"$LOG_FILE" 2>&1 &
sleep 1
PIDS=$(pgrep -f "frps.*frps\\.ini" || true)
if [ -n "$PIDS" ]; then
echo "frps started (pid: $PIDS)"
else
echo "frps failed to start; check $LOG_FILE" >&2
exit 1
fi
```
## 启动与停止
- 启动/重启：
```bash
cd /home/ubuntu/.frp
bash ./start_frps.sh
```
- 查看进程：`ps -ef | grep frps`
- 查看监听：`ss -lnpt | grep 1234`
- 查看日志：`tail -n 50 /home/ubuntu/.frp/frps.log`
- 停止（如需手动）：`pkill -f "frps.*frps.ini"`
## 安全组与防火墙
- AWS 安全组（sg-099756caee5666062）需开放入站 TCP 1234（FRP 控制）与 12345（SSH 映射）。
- 若使用 ufw，需执行：
```bash
sudo ufw allow 1234/tcp
sudo ufw allow 12345/tcp
```
## 远程客户端要求
- Windows `frpc.ini` 中 `server_addr` 指向该 EC2 公网 IP，`server_port=1234`，`remote_port=12345`，token 与服务器一致。
- Termius/SSH 客户端使用 `ssh lenovo@<AWS IP> -p 12345`，认证方式为密钥（Termius Keychain 生成的私钥）。
## 维护建议
- FRP 官方已提示 INI 格式未来会被弃用，后续升级建议改用 TOML/YAML。
- 可将 `start_frps.sh` 注册成 systemd 服务，确保实例重启后自动拉起。
- 定期检查 `frps.log` 是否有异常连接或错误，并确保 token 不泄露。
FRP Windows 客户端配置说明
================================
最后更新：2025-12-05
适用环境：Windows 10/11，用户 lenovo，本机已安装 OpenSSH Server。
一、目录与文件
- FRP 程序目录：C:\frp\
- frpc.exe
- frpc.ini（客户端配置）
- start_frpc.bat（后台启动脚本）
- SSH 密钥：
- 私钥：C:\Users\lenovo\.ssh\666
- 公钥：C:\Users\lenovo\.ssh\666.pub
- 管理员授权公钥：C:\ProgramData\ssh\666_keys
二、frpc.ini 内容（当前生效）
[common]
server_addr = 13.14.223.23
server_port = 1234
token = 123456
[ssh]
type = tcp
local_ip = 127.0.0.1
local_port = 22
remote_port = 12345
三、启动与自启
1) 手动前台验证（可选）
PowerShell：
cd C:\frp
.\frpc.exe -c frpc.ini
2) 后台快捷启动
双击 C:\frp\start_frpc.bat
3) 开机自启（简单方式）
将 start_frpc.bat 复制到启动文件夹：
C:\Users\lenovo\AppData\Roaming\Microsoft\Windows\Start Menu\Programs\Startup
下次登录自动后台启动。
四、SSH 连接方式
- 终端命令：
ssh -i "C:\Users\lenovo\.ssh\666" -p 12345 lenovo@13.14.223.23
- Termius 填写：
Host 13.14.223.23
Port 12345
User lenovo
Key 选择 C:\Users\lenovo\.ssh\666（无口令）
五、权限与安全
- 私钥权限已限制为 lenovo、SYSTEM 可读。
- sshd 已关闭密码登录（PasswordAuthentication no），仅密钥。
- 管理员组用户使用 C:\ProgramData\ssh\666_keys 作为授权列表。
六、常用检查
- 查看 frpc 运行：任务管理器或
netstat -ano | findstr 1234
- 查看 frpc 日志（WSL 版，如需）：/tmp/frpc-wsl.log
- 测试 SSH：上面的 ssh 命令返回 ok 即通。
七、故障排查速查
- "Permission denied (publickey)":
* 确认 666 公钥在 C:\ProgramData\ssh\666_keys
* 确认私钥路径/权限正确。
- "Connection refused": frps 未运行或端口 1234/12345 未放行。
- frpc 未连接：前台运行 frpc 查看提示，或检查 frpc.ini 中 server_addr、token 是否匹配。
Termius（手机端）连接步骤：
1. 创建主机
- Host (Address): 13.14.223.23
- Port: 12345
- Label 可自定义（如 FRP-Home）
2. 认证方式选择 Key
- 在 Authentication 选择 Key
- 点击 Import Key（或“从文件/粘贴”）
- 将本机私钥 666 的内容导入（建议用安全方式传到手机，再粘贴；如果 Termius 支持从文件导入，选该文件）。
私钥内容在 PC 路径：C:\Users\lenovo\.ssh\666（纯文本，-----BEGIN OPENSSH PRIVATE KEY----- 开头）。
- Passphrase 留空（此钥无口令）。
3. 用户名
- Username: lenovo
4. 保存并连接
- 首次连接接受指纹提示即可。
5. 可选安全措施
- 在 Termius 中为该私钥设置本地加密密码（App 层保护）。
- 若不方便复制私钥，可生成移动端新钥，并将其公钥追加到 C:\ProgramData\ssh\666_keys，但目前 666 已可用，按上面导入即可。
一键启动命令（在当前管理员 PowerShell 执行）
# 放行、防解除阻 & 直接前台启动
Add-MpPreference -ExclusionPath "C:\frp"
Unblock-File C:\frp\frpc.exe
cd C:\frp
.\frpc.exe -c frpc.ini
如果想后台启动（不占窗口）：
cd C:\frp
Start-Process -FilePath ".\frpc.exe" -ArgumentList "-c frpc.ini" -WindowStyle Hidden
需要开机自启（最高权限）：
schtasks /Create /TN "FRPClient" /TR "C:\frp\frpc.exe -c C:\frp\frpc.ini" /SC ONLOGON /RL HIGHEST /F /RU lenovo
docs/playbooks/四阶段×十二原则方法论.md
-167
View File
@@ -1,167 +0,0 @@
# 12Factor.me - 四阶段×十二原则方法论
源：https://www.12factor.me/zh
> AI 协作时代的 10x 工程效率提升方法论
---
## 阶段 1: 准备
*建立清晰的信息架构和上下文环境*
### 1. 单一真源 (Single Source of Truth)
**核心概念**: 信息分散会导致上下文混乱，容易造成人机双方的误判。
**推荐实践**:
- 将所有需求、设计及上下文集中于统一的文档中心 (如 Notion / Confluence / GitHub Wiki)。
- 与 AI 协作时，应直接引用此“真源”，而非随意复制粘贴信息。
**反面模式**:
- 团队成员各自维护不同版本的文档，导致 AI 给出的回应和建议不一致。
### 2. 提示词先行 (Prompt First)
**核心概念**: 将提示词 (Prompt) 视为新一代的设计文档。
**推荐实践**:
- 在任务开始前，优先编写提示词，用以明确输入、输出、风格和约束条件。
- 团队内部复用经过验证和优化的提示词模板。
**反面模式**:
- 未经规划，直接要求 AI 编写代码，导致方向错误和不必要的返工。
### 3. 上下文洁净 (Context Hygiene)
**核心概念**: 干净的上下文能让 AI 更精准。
**推荐实践**:
- 每个新任务开独立会话，避免旧内容干扰
- 定期用一句话总结现状，让 AI "对齐背景"
**反面模式**:
- 把三天前的对话和今天的任务混在一起
---
## 阶段 2: 执行
*高效协作完成具体任务*
### 4. 人类在环 (Human-in-the-Loop)
**核心概念**: AI 产出快，但只有人类能把握方向与业务判断。
**推荐实践**:
- AI 给初稿，人类负责关键决策与风险把关
- 对重要功能先进行逻辑验证，再合并代码
**反面模式**:
- 全盘接受 AI 产出，不做任何审查
### 5. 任务块化 (Chunked Work)
**核心概念**: 大任务拆小块，易于迭代与修正。
**推荐实践**:
- 任务控制在可 10~30 分钟完成的小范围
- 每块结束后立即验证结果
**反面模式**:
- 一次性让 AI 写 5000 行，结果无法调试
### 6. 并行流动 (Parallel Flow)
**核心概念**: AI 工作时，人类做低切换成本的副任务，保持节奏不断。
**推荐实践**:
- 准备一个"副任务清单"，包含文档整理、小修复、代码审查等
- 等待 AI 时，不接入高认知负载的新任务，避免切换开销过大
**反面模式**:
- 等待 AI 时去刷社交媒体，导致节奏断档
---
## 阶段 3: 协作
*管理协作过程中的认知负载和工作流*
### 7. 负载预算 (Cognitive Load Budget)
**核心概念**: 人类注意力是稀缺资源。
**推荐实践**:
- 为 AI 协作设定每日时长上限
- 在精神高峰期安排深度审查任务
**反面模式**:
- 全天候黏着 AI 工作，晚上完全耗尽
### 8. 流保护罩 (Flow Protection)
**核心概念**: 高专注流一旦被打断，恢复成本极高。
**推荐实践**:
- 设定专注时段（如 90 分钟），屏蔽通知与打扰
- AI 交互也在专注流中批量进行，而非零散触发
**反面模式**:
- 边写代码边回微信边看 AI 输出，效率断崖式下降
### 9. 可复现性 (Reproducible Sessions)
**核心概念**: 协作过程可回溯，才能持续优化。
**推荐实践**:
- 保存 Prompt、AI 版本、变更原因到代码库或知识库
- 出现 bug 时可重放生成过程
**反面模式**:
- AI 生成历史无记录，出错无法还原原因
---
## 阶段 4: 迭代
*持续学习和改进协作模式*
### 10. 休息反思 (Rest & Reflection)
**核心概念**: 冲刺后复盘，才能越跑越快。
**推荐实践**:
- 冲刺结束后，花 5 分钟复盘 AI 产出与预期差异
- 更新 Prompt 模板，积累"踩坑记录"
**反面模式**:
- 连续冲刺，累积错误不总结
### 11. 技能均衡 (Skill Parity)
**核心概念**: AI 是放大镜，放大能力，也放大短板。
**推荐实践**:
- 持续学习领域知识与代码审查技巧
- 对 AI 输出保持独立判断能力
**反面模式**:
- 完全依赖 AI，失去手写能力与技术洞察力
### 12. 好奇文化 (Culture of Curiosity)
**核心概念**: 好奇心驱动探索，避免"盲信 AI"。
**推荐实践**:
- 面对 AI 答案，先问"为什么"，再问"还能更好吗"
- 团队分享 AI 使用经验与改进思路
**反面模式**:
- 对 AI 方案照单全收，从不质疑
---
*生成自 [12Factor.me](https://12factor.me)*
*许可证: MIT*