docs: resources - point to assets and remove 04-资源

.gitmodules

@@ -1,9 +1,9 @@
-[submodule "libs/external/.tmux"]
-	path = libs/external/.tmux
+[submodule "repo/.tmux"]
+	path = repo/.tmux
 	url = https://github.com/gpakosz/.tmux.git
-[submodule "libs/external/tmux"]
-	path = libs/external/tmux
+[submodule "repo/tmux"]
+	path = repo/tmux
 	url = https://github.com/tmux/tmux.git
-[submodule "libs/external/claude-official-skills"]
-	path = libs/external/claude-official-skills
+[submodule "repo/claude-official-skills"]
+	path = repo/claude-official-skills
 	url = https://github.com/anthropics/skills.git

AGENTS.md

@@ -7,22 +7,22 @@
 ## 1. Mission & Scope（目标与边界）
 
 ### 允许的操作
-- 读取、修改顶层文档：`README.md`、`AGENTS.md`、`CLAUDE.md`、`GEMINI.md` 等
-- 读取、修改 `documents/`、`prompts/`、`skills/`、`workflow/`、`config/`、`tools/`、`libs/` 下的文档与代码
+- 读取、修改顶层文档：`README.md`、`AGENTS.md`、`CONTRIBUTING.md` 等
+- 读取、修改 `documents/`、`prompts/`、`skills/`、`workflow/`、`config/`、`tools/`、`repo/` 下的文档与代码
 - 执行 `make lint`、备份脚本、prompts-library 转换工具
 - 新增/修改提示词、技能、文档
 - 提交符合规范的 commit
 
 ### 禁止的操作
 - 修改 `.github/workflows/` 中的 CI 配置（除非任务明确要求）
-- 删除或覆盖 `backups/gz/` 中的存档文件
+- 删除或覆盖 `repo/backups/gz/` 中的存档文件
 - 修改 `LICENSE`、`CODE_OF_CONDUCT.md`
 - 在代码中硬编码密钥、Token 或敏感凭证
 - 未经确认的大范围重构
 
 ### 敏感区域（禁止自动修改）
 - `.github/workflows/*.yml` - CI/CD 配置
-- `backups/gz/` - 历史备份存档
+- `repo/backups/gz/` - 历史备份存档
 - `.env*` 文件（如存在）
 
 ---
@@ -63,9 +63,9 @@ git push origin develop
 |:---|:---|:---|
 | `make help` | 列出所有 Make 目标 | 无 |
 | `make lint` | 校验全仓库 Markdown | 需安装 markdownlint-cli |
-| `bash backups/一键备份.sh` | 创建完整项目备份 | 无 |
-| `python3 backups/快速备份.py` | Python 版备份脚本 | Python 3.8+ |
-| `cd libs/external/prompts-library && python3 main.py` | 提示词格式转换 | pandas, openpyxl, PyYAML |
+| `bash repo/backups/一键备份.sh` | 创建完整项目备份 | 无 |
+| `python3 repo/backups/快速备份.py` | Python 版备份脚本 | Python 3.8+ |
+| `cd repo/prompts-library && python3 main.py` | 提示词格式转换 | pandas, openpyxl, PyYAML |
 
 ### prompts-library 支持的转换模式
 1. Excel → Docs：将 Excel 工作簿转换为 Markdown 文档目录
@@ -89,12 +89,11 @@ git push origin develop
 - `workflow/` - 可复用工作流模板（自动开发闭环等）
 - `config/` - 工具与开发配置（例如 Codex CLI）
 - `tools/` - 预留：自定义脚本/小工具（保持可替换、可审计）
-- `libs/common/` - 通用模块
-- `libs/external/` - 外部工具与依赖
+- `repo/` - 外部工具与依赖（含 Git submodule）
 
 ### 依赖添加规则
 - 新增工具或库时记录安装方式、最小版本与来源
-- 外部依赖来源记录在 `libs/external/` 目录下
+- 外部依赖来源记录在 `repo/` 目录下
 - 引入第三方脚本需标明许可证与来源
 
 ### 禁止行为
@@ -131,14 +130,16 @@ git push origin develop
 .
 ├── README.md                    # 项目主文档
 ├── AGENTS.md                    # AI Agent 行为准则（本文件）
-├── CLAUDE.md                    # Claude 模型上下文（合并在本文件末尾）
-├── GEMINI.md                    # Gemini 模型上下文
 ├── Makefile                     # 自动化脚本
 ├── LICENSE                      # MIT 许可证
 ├── CODE_OF_CONDUCT.md           # 行为准则
 ├── CONTRIBUTING.md              # 贡献指南
 ├── .gitignore                   # Git 忽略规则
 │
+├── assets/                      # 外部资源（指向在线表格）
+│   ├── README.md                # 远程表格索引（唯一真相源）
+│   └── AGENTS.md                # assets/ 目录规则
+│
 ├── config/                      # 工具与开发配置
 │   └── .codex/                  # Codex CLI 配置（项目级）
 │       ├── config.toml          # Codex CLI 配置文件
@@ -161,7 +162,6 @@ git push origin develop
 │   ├── 01-入门指南/             # 从零开始教程
 │   ├── 02-方法论/               # 具体工具与技巧
 │   ├── 03-实战/                 # 项目实战案例
-│   └── 04-资源/                 # 外部资源聚合
 │
 ├── prompts/                     # 提示词库（指向云端表格）
 │   └── README.md                # 在线表格链接
@@ -181,37 +181,30 @@ git push origin develop
 │   ├── auto-dev-loop/           # 自动开发循环
 │   └── canvas-dev/              # Canvas白板驱动开发
 │
-├── libs/                        # 核心库代码
-│   ├── common/                  # 通用模块
-│   │   ├── models/              # 模型定义
-│   │   └── utils/               # 工具函数
-│   ├── database/                # 数据库模块（预留）
-│   └── external/                # 外部工具
-│       ├── prompts-library/     # Excel ↔ Markdown 互转工具
-│       ├── chat-vault/          # AI 聊天记录保存工具
-│       ├── Skill_Seekers-development/ # Skills 制作器
-│       ├── html-tools-main/     # HTML 工具集（Markdown 编辑器、任务卡片生成等）
-│       ├── .tmux/               # oh-my-tmux (submodule)
-│       ├── tmux/                # tmux 源码 (submodule)
-│       ├── my-nvim/             # Neovim 配置
-│       ├── MCPlayerTransfer/    # MC 玩家迁移工具
-│       └── XHS-image-to-PDF-conversion/ # 小红书图片转 PDF
+├── repo/                        # 可执行代码与外部依赖镜像
+│   ├── README.md                # 外部工具索引
+│   ├── AGENTS.md                # repo/ 目录规则
+│   ├── prompts-library/         # Excel ↔ Markdown 互转工具
+│   ├── chat-vault/              # AI 聊天记录保存工具
+│   ├── Skill_Seekers-development/ # Skills 制作器
+│   ├── html-tools-main/         # HTML 工具集
+│   ├── my-nvim/                 # Neovim 配置
+│   ├── MCPlayerTransfer/        # MC 玩家迁移工具
+│   ├── XHS-image-to-PDF-conversion/ # 小红书图片转 PDF
+│   ├── backups/                 # 历史备份脚本快照
+│   ├── .tmux/                   # oh-my-tmux (submodule)
+│   ├── tmux/                    # tmux 源码 (submodule)
+│   └── claude-official-skills/  # Claude 官方 skills (submodule)
 │
 ├── tools/                       # 工具目录（预留）
 │   └── .gitkeep                 # 保持空目录被 Git 追踪
-│
-└── backups/                     # 备份脚本与存档
-    ├── 一键备份.sh              # Shell 备份脚本
-    ├── 快速备份.py              # Python 备份脚本
-    ├── README.md                # 备份说明
-    └── gz/                      # 压缩存档目录
 ```
 
 ### 关键入口文件
 - `README.md` - 项目主文档，面向人类开发者
 - `AGENTS.md` - AI Agent 操作手册（本文件）
-- `libs/external/prompts-library/main.py` - 提示词转换工具入口
-- `backups/一键备份.sh` - 备份脚本入口
+- `repo/prompts-library/main.py` - 提示词转换工具入口
+- `repo/backups/一键备份.sh` - 备份脚本入口
 - `skills/tmux-autopilot/` - tmux 自动化操控技能（基于 oh-my-tmux，含 capture-pane/send-keys/蜂群巡检脚本）
 - `skills/sop-generator/` - SOP 生成与规范化技能（输入资料/需求 -> 标准 SOP）
 
@@ -223,8 +216,9 @@ git push origin develop
 |:---|:---|:---|
 | `make lint` 失败 | 未安装 markdownlint-cli | `npm install -g markdownlint-cli` |
 | prompts-library 报错 | 缺少 Python 依赖 | `pip install pandas openpyxl PyYAML rich InquirerPy` |
+| CI markdown-lint 失败 | `.github/lint_config.json` 缺失 | TODO：新增 `.github/lint_config.json` 或调整 `.github/workflows/ci.yml` 的 lint 命令（需任务明确授权） |
 | CI link-checker 失败 | 文档中存在失效链接 | 检查并修复 Markdown 中的链接 |
-| 备份脚本权限不足 | Shell 脚本无执行权限 | `chmod +x backups/一键备份.sh` |
+| 备份脚本权限不足 | Shell 脚本无执行权限 | `chmod +x repo/backups/一键备份.sh` |
 
 ---
 
@@ -266,13 +260,12 @@ feat|fix|docs|chore|refactor|test: scope - summary
 **任何功能/命令/配置/目录/工作流变化必须同步更新：**
 - `README.md` - 面向人类开发者
 - `AGENTS.md` - 面向 AI Agent（本文件）
-- `GEMINI.md` - Gemini 模型上下文
 
 **不确定的内容用 TODO 标注，不允许猜测。**
 
 ---
 
-# CLAUDE.md
+# Claude 上下文（合并在本文件）
 
 本节为 Claude 系列模型提供项目上下文。
 
@@ -284,13 +277,13 @@ feat|fix|docs|chore|refactor|test: scope - summary
 
 ```bash
 # 提示词库转换
-cd libs/external/prompts-library && python3 main.py
+cd repo/prompts-library && python3 main.py
 
 # Lint 所有 Markdown 文件
 make lint
 
 # 创建完整项目备份
-bash backups/一键备份.sh
+bash repo/backups/一键备份.sh
 ```
 
 ## Architecture & Structure
@@ -298,10 +291,11 @@ bash backups/一键备份.sh
 ### Core Directories
 - **`prompts/`**: 提示词库（指向云端表格）
 - **`skills/`**: 扁平化技能库（详见 skills/README.md）
-- **`documents/`**: 知识库（05-哲学与方法论、00-基础指南、01-入门指南、02-方法论、03-实战、04-资源）
-- **`libs/external/prompts-library/`**: Excel ↔ Markdown 转换工具
-- **`libs/external/chat-vault/`**: AI 聊天记录保存工具
-- **`backups/`**: 备份脚本与存档
+- **`documents/`**: 知识库（05-哲学与方法论、00-基础指南、01-入门指南、02-方法论、03-实战）
+- **`assets/`**: 外部资源（在线表格）入口与使用说明
+- **`repo/prompts-library/`**: Excel ↔ Markdown 转换工具
+- **`repo/chat-vault/`**: AI 聊天记录保存工具
+- **`repo/backups/`**: 备份脚本与存档
 
 ### Key Technical Details
 1. **Prompt Organization**: 提示词使用 `(row,col)_` 前缀进行分类
@@ -318,7 +312,7 @@ bash backups/一键备份.sh
 
 ---
 
-# GEMINI.md - 项目上下文文档
+# Gemini 上下文（合并在本文件）
 
 ## 项目概述
 

README.md

@@ -40,16 +40,16 @@
   <a href="./documents/00-基础指南/语言层要素.md"><img src="https://img.shields.io/badge/📊_语言层要素-12层框架-gold?style=for-the-badge" alt="语言层要素"></a>
   <a href="./documents/00-基础指南/常见坑汇总.md"><img src="https://img.shields.io/badge/🕳️_常见坑-避坑指南-yellow?style=for-the-badge" alt="常见坑汇总"></a>
   <a href="./documents/00-基础指南/强前置条件约束.md"><img src="https://img.shields.io/badge/🚫_硬约束-铁律-darkred?style=for-the-badge" alt="强前置条件约束"></a>
-  <a href="./documents/04-资源/外部资源聚合.md"><img src="https://img.shields.io/badge/📡_信息源-聚合-teal?style=for-the-badge" alt="信息源聚合"></a>
+  <a href="./assets/README.md"><img src="https://img.shields.io/badge/📡_信息源-聚合-teal?style=for-the-badge" alt="信息源聚合"></a>
   <a href="./documents/00-基础指南/A%20Formalization%20of%20Recursive%20Self-Optimizing%20Generative%20Systems.md"><img src="https://img.shields.io/badge/📐_元方法论-递归优化-darkorange?style=for-the-badge" alt="元方法论"></a>
   <a href="./documents/00-基础指南/编程之道.md"><img src="https://img.shields.io/badge/🧭_编程之道-道法术-orange?style=for-the-badge" alt="编程之道"></a>
   <a href="./documents/03-实战/README.md"><img src="https://img.shields.io/badge/🎬_实战案例-项目实操-orange?style=for-the-badge" alt="实战案例"></a>
-  <a href="./documents/04-资源/工具集.md"><img src="https://img.shields.io/badge/🛠️_工具集-速查-teal?style=for-the-badge" alt="工具集"></a>
+  <a href="./assets/README.md"><img src="https://img.shields.io/badge/🛠️_工具集-速查-teal?style=for-the-badge" alt="工具集"></a>
   <a href="./prompts/"><img src="https://img.shields.io/badge/💬_提示词-精选-purple?style=for-the-badge" alt="提示词精选"></a>
   <a href="./skills/"><img src="https://img.shields.io/badge/⚡_Skills-技能大全-forestgreen?style=for-the-badge" alt="skills技能大全"></a>
   <a href="https://docs.google.com/spreadsheets/d/1Ifk_dLF25ULSxcfGem1hXzJsi7_RBUNAki8SBCuvkJA/edit?gid=1254297203#gid=1254297203"><img src="https://img.shields.io/badge/📋_提示词-在线表格-blue?style=for-the-badge" alt="提示词在线表格"></a>
   <a href="https://github.com/x1xhlol/system-prompts-and-models-of-ai-tools"><img src="https://img.shields.io/badge/🔧_系统提示词-仓库-slateblue?style=for-the-badge" alt="系统提示词仓库"></a>
-  <a href="./libs/external/chat-vault/README.md"><img src="https://img.shields.io/badge/🔐_Chat_Vault-AI会话库-gold?style=for-the-badge" alt="Chat Vault"></a>
+  <a href="./repo/chat-vault/README.md"><img src="https://img.shields.io/badge/🔐_Chat_Vault-AI会话库-gold?style=for-the-badge" alt="Chat Vault"></a>
 </p>
 
 [📋 工具与资源](#tools)
@@ -330,15 +330,15 @@ Canvas方式：**代码 ⇄ 白板 ⇄ AI ⇄ 人类**，白板成为单一真
 ### 项目内部文档
 
 *   [**胶水编程 (Glue Coding)**](./documents/00-基础指南/): 软件工程的圣杯与银弹，Vibe Coding 的终极进化形态。
-*   [**Chat Vault**](./libs/external/chat-vault/): AI 聊天记录保存工具，支持 Codex/Kiro/Gemini/Claude CLI。
-*   [**prompts-library 工具说明**](./libs/external/prompts-library/): 支持 Excel 与 Markdown 格式互转，包含数百个精选提示词。
+*   [**Chat Vault**](./repo/chat-vault/): AI 聊天记录保存工具，支持 Codex/Kiro/Gemini/Claude CLI。
+*   [**prompts-library 工具说明**](./repo/prompts-library/): 支持 Excel 与 Markdown 格式互转，包含数百个精选提示词。
 *   [**编程提示词集合**](https://docs.google.com/spreadsheets/d/1Ifk_dLF25ULSxcfGem1hXzJsi7_RBUNAki8SBCuvkJA/edit?gid=1254297203#gid=1254297203): 适用于 Vibe Coding 流程的专用提示词（云端表格）。
 *   [**系统提示词构建原则**](./documents/00-基础指南/系统提示词构建原则.md): 构建高效 AI 系统提示词的综合指南。
 *   [**开发经验总结**](./documents/00-基础指南/开发经验.md): 变量命名、文件结构、编码规范、架构原则等。
 *   [**通用项目架构模板**](./documents/00-基础指南/通用项目架构模板.md): 多种项目类型的标准目录结构。
 *   [**Augment MCP 配置文档**](./documents/02-方法论/auggie-mcp配置文档.md): Augment 上下文引擎配置说明。
 *   [**系统提示词集合**](https://docs.google.com/spreadsheets/d/1Ifk_dLF25ULSxcfGem1hXzJsi7_RBUNAki8SBCuvkJA/edit?gid=1254297203#gid=1254297203): AI 开发的系统提示词，含多版本开发规范（云端表格）。
-*   [**外部资源聚合**](./documents/04-资源/外部资源聚合.md): GitHub 精选仓库、AI 工具平台、提示词资源、优质博主汇总。
+*   [**外部资源（在线表格）**](./assets/README.md): 外部资源的唯一真相源（按类型分表），本地 Markdown 保留为历史参考。
 
 ---
 
@@ -368,14 +368,16 @@ Canvas方式：**代码 ⇄ 白板 ⇄ AI ⇄ 人类**，白板成为单一真
 .
 ├── README.md                    # 项目主文档
 ├── AGENTS.md                    # AI Agent 行为准则
-├── CLAUDE.md                    # Claude 模型上下文
-├── GEMINI.md                    # Gemini 模型上下文
 ├── Makefile                     # 自动化脚本
 ├── LICENSE                      # MIT 许可证
 ├── CODE_OF_CONDUCT.md           # 行为准则
 ├── CONTRIBUTING.md              # 贡献指南
 ├── .gitignore                   # Git 忽略规则
 │
+├── assets/                      # 外部资源（指向在线表格）
+│   ├── README.md                # 远程表格索引（唯一真相源）
+│   └── AGENTS.md                # assets/ 目录规则
+│
 ├── config/                      # 工具与开发配置
 │   └── .codex/                  # Codex CLI 配置（项目级）
 │       ├── config.toml          # Codex CLI 配置文件
@@ -398,7 +400,6 @@ Canvas方式：**代码 ⇄ 白板 ⇄ AI ⇄ 人类**，白板成为单一真
 │   ├── 01-入门指南/             # 从零开始教程
 │   ├── 02-方法论/               # 具体工具与技巧
 │   ├── 03-实战/                 # 项目实战案例
-│   └── 04-资源/                 # 外部资源聚合
 │
 ├── prompts/                     # 提示词库（指向云端表格）
 │   └── README.md                # 在线表格链接
@@ -418,29 +419,22 @@ Canvas方式：**代码 ⇄ 白板 ⇄ AI ⇄ 人类**，白板成为单一真
 │   ├── auto-dev-loop/           # 自动开发循环
 │   └── canvas-dev/              # Canvas白板驱动开发
 │
-├── libs/                        # 核心库代码
-│   ├── common/                  # 通用模块
-│   │   ├── models/              # 模型定义
-│   │   └── utils/               # 工具函数
-│   ├── database/                # 数据库模块（预留）
-│   └── external/                # 外部工具
-│       ├── prompts-library/     # Excel ↔ Markdown 互转工具
-│       ├── chat-vault/          # AI 聊天记录保存工具
-│       ├── Skill_Seekers-development/ # Skills 制作器
-│       ├── .tmux/               # oh-my-tmux (submodule)
-│       ├── tmux/                # tmux 源码 (submodule)
-│       ├── my-nvim/             # Neovim 配置
-│       ├── MCPlayerTransfer/    # MC 玩家迁移工具
-│       └── XHS-image-to-PDF-conversion/ # 小红书图片转 PDF
+├── repo/                        # 外部工具与依赖镜像（含 Git submodule）
+│   ├── README.md                # 外部工具索引
+│   ├── prompts-library/         # Excel ↔ Markdown 互转工具
+│   ├── chat-vault/              # AI 聊天记录保存工具
+│   ├── Skill_Seekers-development/ # Skills 制作器
+│   ├── html-tools-main/         # HTML 工具集
+│   ├── my-nvim/                 # Neovim 配置
+│   ├── MCPlayerTransfer/        # MC 玩家迁移工具
+│   ├── XHS-image-to-PDF-conversion/ # 小红书图片转 PDF
+│   ├── backups/                 # 历史备份脚本快照
+│   ├── .tmux/                   # oh-my-tmux (submodule)
+│   ├── tmux/                    # tmux 源码 (submodule)
+│   └── claude-official-skills/  # Claude 官方 skills (submodule)
 │
 ├── tools/                       # 工具目录（预留）
 │   └── .gitkeep                 # 保持空目录被 Git 追踪
-│
-└── backups/                     # 备份脚本与存档
-    ├── 一键备份.sh              # Shell 备份脚本
-    ├── 快速备份.py              # Python 备份脚本
-    ├── README.md                # 备份说明
-    └── gz/                      # 压缩存档目录
 ```
 
 </details>
@@ -469,8 +463,10 @@ prompts/
   02-编程提示词/         # 需求澄清、计划、执行链的核心提示词
   03-用户提示词/         # 可复用的用户侧提示词
 documents/
-  04-资源/代码组织.md, 04-资源/通用项目架构模板.md, 00-基础指南/开发经验.md, 00-基础指南/系统提示词构建原则.md 等知识库
-backups/
+  00-基础指南/代码组织.md, 00-基础指南/通用项目架构模板.md, 00-基础指南/开发经验.md, 00-基础指南/系统提示词构建原则.md 等知识库
+assets/
+  README.md  # 外部资源（在线表格）唯一真相源入口
+repo/backups/
   一键备份.sh, 快速备份.py  # 本地/远端快照脚本
 ```
 
@@ -491,8 +487,8 @@ graph TB
   subgraph ingest_layer[数据接入与采集层]
     excel_raw[prompt_excel/*.xlsx]
     md_raw[prompt_docs/外部MD输入]
-    excel_to_docs[prompts-library/scripts/excel_to_docs.py]
-    docs_to_excel[prompts-library/scripts/docs_to_excel.py]
+    excel_to_docs[repo/prompts-library/scripts/excel_to_docs.py]
+    docs_to_excel[repo/prompts-library/scripts/docs_to_excel.py]
     ingest_bus[标准化数据帧]
     ext_sheet --> excel_raw
     ext_md --> md_raw
@@ -530,9 +526,9 @@ graph TB
 
   subgraph infra_layer[基础设施与横切能力层]
     git[Git 版本控制] --> orchestrator
-    backups[backups/一键备份.sh · backups/快速备份.py] --> artifacts_md
+    backups[repo/backups/一键备份.sh · repo/backups/快速备份.py] --> artifacts_md
     deps[requirements.txt · scripts/requirements.txt] --> orchestrator
-    config[prompts-library/scripts/config.yaml] --> orchestrator
+    config[repo/prompts-library/scripts/config.yaml] --> orchestrator
     monitor[预留：日志与监控] --> orchestrator
   end
 ```
@@ -596,7 +592,7 @@ gantt
 
 本指南同时适用于 CLI 终端版本和 VSCode 扩展版本（Codex 和 Claude Code 都有扩展，且界面更新）。
 
-*(注：本指南早期版本使用的是 **Grok 3**，后来切换到 **Gemini 2.5 Pro**，现在我们使用的是 **Claude 4.6**（或 **gpt-5.3-codex (xhigh)**）)*
+*(注：本指南早期版本使用的是 **Grok 3**，后来切换到 **Gemini 3.1 Pro**，现在我们使用的是 **Claude 4.6**（或 **gpt-5.3-codex (xhigh)**）)*
 
 *(注2：如果你想使用 Cursor，请查看本指南的 [1.1 版本](https://github.com/EnzeD/vibe-coding/tree/1.1.1)，但我们认为它目前不如 Codex CLI 或 Claude Code 强大)*
 
@@ -614,7 +610,7 @@ gantt
 </details>
 
 <details>
-<summary><strong>2. 技术栈与 <code>CLAUDE.md</code> / <code>AGENTS.md</code></strong></summary>
+<summary><strong>2. 技术栈与 Agent 规则（<code>AGENTS.md</code> / 自定义 rules）</strong></summary>
 
 - 让 **gpt-5.3-codex** 或 **Claude Opus 4.6** 为你的游戏推荐最合适的技术栈（例如：多人3D游戏用 ThreeJS + WebSocket），保存为 `tech-stack.md`。
   - 要求它提出 **最简单但最健壮** 的技术栈。

assets/AGENTS.md

@@ -0,0 +1,13 @@
+# assets/ 目录 Agent 指南
+
+本目录用于收纳/索引“仓库外部资产”的**入口**，例如：
+
+- 在线表格（资源库、索引表、清单）
+- 远程文档（规范、课程、外部知识库）
+- 其它需要在仓库内保留“可追溯入口”的外部资源
+
+## 约束
+
+- 不在此目录存放敏感信息（Token、私钥、个人隐私）。
+- 尽量只存“入口文档与说明”，不要复制粘贴大段第三方内容。
+- 外部资产必须写清：用途、维护者、更新方式、与仓库内文档的关系（谁是唯一真相源）。

assets/README.md

@@ -0,0 +1,13 @@
+# 📎 Assets（外部资产索引）
+
+本目录用于为仓库中的“外部资产”提供**稳定入口**与**使用说明**，避免资源散落在多个 Markdown 文件里难以维护。
+
+## 外部资源在线表格（唯一真相源）
+
+- 外部资源（按类型分表）：`Google Sheets`
+  - [外部资源在线表格（Google Sheets）](https://docs.google.com/spreadsheets/d/1DY0JfSph_OqaSkVPlrnQrg7OKyPUuhDHsCh-431ot-I/edit?usp=sharing)
+
+## 与仓库文档的关系
+
+- 外部资源的新增/删除/去重/更新，以在线表格为准。
+- 旧的 `documents/04-资源/` 已移除，仓库内所有入口统一指向 `assets/README.md`。

documents/00-基础指南/通用项目架构模板.md

@@ -205,12 +205,12 @@
 │       ├── src/
 │       └── tests/
 │
-├── libs/                 # 共享库
+├── assets/               # 资产中心
 │   ├── common/           # 公共模块
 │   │   ├── utils/
 │   │   └── models/
-│   ├── external/         # 第三方库（不可修改，只调用）
-│   └── database/         # 数据库访问库
+│   ├── repo/             # 外部仓库中心（不可修改，只调用）
+│   └── database/         # 数据库相关
 │
 ├── infrastructure/       # 基础设施
 │   ├── terraform/        # 云资源定义

documents/03-实战/README.md

@@ -14,4 +14,4 @@
 - [基础指南](../00-基础指南/) - 核心理念与方法论
 - [入门指南](../01-入门指南/) - 环境配置
 - [方法论](../02-方法论/) - 工具与经验
-- [资源](../04-资源/) - 模板与工具
+- [外部资源（在线表格）](../../assets/README.md) - 外部资源唯一真相源入口

documents/03-实战/fate-engine-dev/prompt-system-bazi-kline.md

@@ -1,6 +1,6 @@
 # 人生K线 LLM 系统提示词（完整原文）
 
-以下内容对应 `libs/external/web/lifekline-main/constants.ts` 中的 `BAZI_SYSTEM_INSTRUCTION` 字符串，已原样展开，便于单独查看与复用。
+以下内容对应 `repo/libs/external/web/lifekline-main/constants.ts` 中的 `BAZI_SYSTEM_INSTRUCTION` 字符串，已原样展开，便于单独查看与复用。
 
 ```
 你是一位八字命理大师，精通加密货币市场周期。根据用户提供的四柱干支和大运信息，生成"人生K线图"数据和命理报告。
@@ -44,4 +44,3 @@
 # 使用说明
 - 作为 `system` 消息传入 `/chat/completions`，禁止模型输出 Markdown 代码块（由 `geminiService` 再次强调）。
 - 保证 共x条（x = 全部流月数量） 条 `chartPoints`，并严格执行 `reason` 字数与评分波动要求。
-

documents/03-实战/fate-engine-dev/prompt-user-bazi-kline.md

@@ -1,6 +1,6 @@
 # 人生K线 LLM 用户提示词模板（完整原文）
 
-本文件摘自 `libs/external/web/lifekline-main/services/geminiService.ts` 中 `userPrompt` 拼装逻辑，已替换为模板变量，便于直接复用。
+本文件摘自 `repo/libs/external/web/lifekline-main/services/geminiService.ts` 中 `userPrompt` 拼装逻辑，已替换为模板变量，便于直接复用。
 
 ```
 请根据以下**已经排好的**八字四柱和**指定的大运信息**进行分析。
@@ -51,4 +51,3 @@
 - 作为 `user` 消息传入 `/chat/completions`，与系统提示词配套使用。
 - 变量含义：`genderStr` 由性别+乾坤文字组成；`startAgeInt` 为起运年龄整数；`directionExample` 随顺/逆行变化；其余变量直接取用户输入或排盘结果。
 - 输出需为纯 JSON，`geminiService` 会自动剥离代码块并校验 `chartPoints`。
-

documents/04-资源/README.md

@@ -1,24 +0,0 @@
-# 📦 资源
-
-> 模板、工具、外部资源
-
-## 🗂️ 模板与工具
-
-| 资源 | 说明 |
-|:---|:---|
-| [通用项目架构模板](./通用项目架构模板.md) | 多种项目类型的标准目录结构 |
-| [代码组织](./代码组织.md) | 代码组织最佳实践 |
-| [工具集](./工具集.md) | 常用开发工具 |
-
-## 📚 学习资源
-
-| 资源 | 说明 |
-|:---|:---|
-| [编程书籍推荐](./编程书籍推荐.md) | 精选编程书籍 |
-| [外部资源聚合](./外部资源聚合.md) | AI 工具、社区、GitHub 仓库汇总 |
-
-## 🔗 相关资源
-- [基础指南](../00-基础指南/) - 核心理念与方法论
-- [入门指南](../01-入门指南/) - 环境配置
-- [方法论](../02-方法论/) - 工具与经验
-- [实战](../03-实战/) - 动手实践

documents/04-资源/外部资源聚合.md

@@ -1,561 +0,0 @@
-# 🔗 外部资源聚合
-
-> Vibe Coding 相关的优质外部资源汇总
->
-> 最后更新：2025-12-19
-
----
-
-<details open>
-<summary><strong>🎙️ 优质博主</strong></summary>
-
-### 𝕏 (Twitter) 博主
-
-| 博主 | 链接 | 说明 |
-|:---|:---|:---|
-| @shao__meng | [x.com/shao__meng](https://x.com/shao__meng) | |
-| @0XBard_thomas | [x.com/0XBard_thomas](https://x.com/0XBard_thomas) | |
-| @Pluvio9yte | [x.com/Pluvio9yte](https://x.com/Pluvio9yte) | |
-| @xDinoDeer | [x.com/xDinoDeer](https://x.com/xDinoDeer) | |
-| @geekbb | [x.com/geekbb](https://x.com/geekbb) | |
-| @GitHub_Daily | [x.com/GitHub_Daily](https://x.com/GitHub_Daily) | |
-| @BiteyeCN | [x.com/BiteyeCN](https://x.com/BiteyeCN) | |
-| @CryptoJHK | [x.com/CryptoJHK](https://x.com/CryptoJHK) | |
-| @rohanpaul_ai | [x.com/rohanpaul_ai](https://x.com/rohanpaul_ai) | |
-| @DataChaz | [x.com/DataChaz](https://x.com/DataChaz) | |
-
-### 📺 YouTube 博主
-
-| 博主 | 链接 | 说明 |
-|:---|:---|:---|
-| Best Partners | [youtube.com/@bestpartners](https://www.youtube.com/@bestpartners) | |
-| 王路飞 | [youtube.com/@王路飞](https://www.youtube.com/@%E7%8E%8B%E8%B7%AF%E9%A3%9E) | |
-| 即刻风 | [youtube.com/@jidifeng](https://www.youtube.com/@jidifeng) | |
-| 3Blue1Brown | [youtube.com/@3blue1brown](https://www.youtube.com/@3blue1brown) | 数学可视化 |
-| Andrej Karpathy | [youtube.com/andrejkarpathy](https://www.youtube.com/andrejkarpathy) | AI/深度学习 |
-
-### 📱 微信视频号
-
-| 博主 | 说明 |
-|:---|:---|
-| 美国的牛粪博士 | |
-
-### 📺 Bilibili
-
-| 博主 | 链接 | 说明 |
-|:---|:---|:---|
-| 小林coding | [space.bilibili.com/282739748](https://space.bilibili.com/282739748) | |
-| 雍俊海 | [space.bilibili.com](https://b23.tv/zxptu9g) | 入门级软件安装删除 |
-
-### 📕 小红书
-
-| 博主 | 链接 | 说明 |
-|:---|:---|:---|
-| 编程人生 | [xiaohongshu.com/user/661913b5](https://www.xiaohongshu.com/user/profile/661913b50000000007006a56) | 架构师，图解编程知识 |
-
-### 🎵 抖音
-
-| 博主 | 说明 |
-|:---|:---|
-
-</details>
-
----
-
-<details open>
-<summary><strong>🤖 AI 工具与平台</strong></summary>
-
-### 💬 AI 对话平台
-
-#### 第一梯队 (推荐)
-
-| 平台 | 模型 | 特点 |
-|:---|:---|:---|
-| [Claude](https://claude.ai/) | Claude Opus 4.6 | 代码能力强，支持 Artifacts |
-| [ChatGPT](https://chatgpt.com/) | GPT-5.1 | 综合能力强，支持 Codex |
-| [Gemini](https://gemini.google.com/) | Gemini 3.0 Pro | 免费额度大，支持长上下文 |
-
-#### 国产平台
-
-| 平台 | 模型 | 特点 |
-|:---|:---|:---|
-| [Kimi](https://kimi.moonshot.cn/) | Kimi K2.5 | 长文本处理强 |
-| [通义千问](https://tongyi.aliyun.com/) | Qwen | 阿里出品，免费 |
-| [智谱清言](https://chatglm.cn/) | GLM-4 | 智谱 AI 出品 |
-| [豆包](https://www.doubao.com/) | 豆包 | 字节出品 |
-
-### 🖥️ AI 编程 IDE
-
-| 工具 | 链接 | 说明 |
-|:---|:---|:---|
-| Cursor | [cursor.com](https://cursor.com/) | AI 原生编辑器，基于 VS Code |
-| Windsurf | [windsurf.com](https://windsurf.com/) | Codeium 出品 |
-| Kiro | [kiro.dev](https://kiro.dev/) | AWS 出品，免费 Claude Opus |
-| Zed | [zed.dev](https://zed.dev/) | 高性能编辑器，支持 AI |
-
-### ⌨️ AI CLI 工具
-
-| 工具 | 命令 | 说明 |
-|:---|:---|:---|
-| Claude Code | `claude` | Anthropic 官方 CLI |
-| Codex CLI | `codex` | OpenAI 官方 CLI |
-| Gemini CLI | `gemini` | Google 官方 CLI，免费 1000 次/天 |
-| Aider | `aider` | 开源 AI 结对编程，Git 集成 |
-| OpenCode | `opencode` | 开源终端 AI 助手，Go 编写 |
-| Cline CLI | `cline` | VS Code 扩展配套 CLI |
-
-### 🤖 AI Agent 平台
-
-| 工具 | 链接 | 说明 |
-|:---|:---|:---|
-| Devin | [devin.ai](https://devin.ai/) | 自主 AI 软件工程师，$20/月 |
-| Replit Agent | [replit.com](https://replit.com/) | 端到端应用构建 Agent |
-| v0 by Vercel | [v0.dev](https://v0.dev/) | AI UI 生成，React + Tailwind |
-| Bolt.new | [bolt.new](https://bolt.new/) | 浏览器内全栈应用构建 |
-| Lovable | [lovable.dev](https://lovable.dev/) | 原 GPT Engineer，自然语言建应用 |
-
-### 🆓 免费资源
-
-#### 完全免费
-
-| 资源 | 链接 | 说明 |
-|:---|:---|:---|
-| AI Studio | [aistudio.google.com](https://aistudio.google.com/) | Google 免费 Gemini |
-| Gemini CLI | [geminicli.com](https://geminicli.com/) | 免费命令行访问 |
-| antigravity | [antigravity.google](https://antigravity.google/) | Google 免费 AI 服务 |
-| Qwen CLI | [qwenlm.github.io](https://qwenlm.github.io/qwen-code-docs/zh/cli/) | 阿里免费 CLI |
-
-#### 有免费额度
-
-| 资源 | 链接 | 说明 |
-|:---|:---|:---|
-| Kiro | [kiro.dev](https://kiro.dev/) | 免费 Claude Opus 4.6 |
-| Windsurf | [windsurf.com](https://windsurf.com/) | 新用户免费额度 |
-| GitHub Copilot | [github.com/copilot](https://github.com/copilot) | 学生/开源免费 |
-| Codeium | [codeium.com](https://codeium.com/) | 免费 AI 代码补全 |
-| Tabnine | [tabnine.com](https://www.tabnine.com/) | 免费基础版 |
-| Continue | [continue.dev](https://continue.dev/) | 开源 AI 代码助手 |
-| Bito | [bito.ai](https://bito.ai/) | 免费 AI 代码助手 |
-
-### 🎨 AI 生成工具
-
-| 类型 | 工具 | 链接 |
-|:---|:---|:---|
-| 图片 | Midjourney | [midjourney.com](https://midjourney.com/) |
-| 图片 | DALL-E 3 | [ChatGPT](https://chatgpt.com/) |
-| 图片 | Ideogram | [ideogram.ai](https://ideogram.ai/) |
-| 图片 | Leonardo AI | [leonardo.ai](https://leonardo.ai/) |
-| 音乐 | Suno | [suno.ai](https://suno.ai/) |
-| 音乐 | Udio | [udio.com](https://www.udio.com/) |
-| 音效 | ElevenLabs | [elevenlabs.io](https://elevenlabs.io/) |
-| 视频 | Sora | [sora.com](https://sora.com/) |
-| 视频 | Runway | [runwayml.com](https://runwayml.com/) |
-| 视频 | Kling | [klingai.com](https://klingai.com/) |
-| 3D | Meshy | [meshy.ai](https://www.meshy.ai/) |
-
-</details>
-
----
-
-<details>
-<summary><strong>📝 提示词资源</strong></summary>
-
-### 提示词库
-
-| 资源 | 链接 | 说明 |
-|:---|:---|:---|
-| 在线提示词表格 | [Google Sheets](https://docs.google.com/spreadsheets/d/1ngoQOhJqdguwNAilCl1joNwTje7FWWN9WiI2bo5VhpU/edit?gid=2093180351#gid=2093180351&range=A1) | 推荐 |
-| 元提示词库 | [Google Sheets](https://docs.google.com/spreadsheets/d/1ngoQOhJqdguwNAilCl1joNwTje7FWWN9WiI2bo5VhpU/edit?gid=1770874220#gid=1770874220) | |
-| System Prompts 仓库 | [GitHub](https://github.com/x1xhlol/system-prompts-and-models-of-ai-tools) | |
-| Awesome ChatGPT Prompts | [GitHub](https://github.com/f/awesome-chatgpt-prompts) | |
-
-### 提示词工具
-
-| 工具 | 链接 | 说明 |
-|:---|:---|:---|
-| Skills 制作器 | [GitHub](https://github.com/yusufkaraaslan/Skill_Seekers) | 生成定制化 Skills |
-| LangGPT | [GitHub](https://github.com/langgptai/LangGPT) | 结构化提示词框架 |
-
-### 提示词教程
-
-| 教程 | 链接 | 说明 |
-|:---|:---|:---|
-| Google 提示词最佳实践宝典 | [youware.app](https://youware.app/project/q9yxq74um5?enter_from=share&screen_status=2) | Google 官方提示词最佳实践导航 |
-| Prompt Engineering Guide | [promptingguide.ai](https://www.promptingguide.ai/zh) | 中文版 |
-| Learn Prompting | [learnprompting.org](https://learnprompting.org/zh-Hans/) | 中文版 |
-| OpenAI Prompt Engineering | [platform.openai.com](https://platform.openai.com/docs/guides/prompt-engineering) | 官方 |
-| Anthropic Prompt Engineering | [docs.anthropic.com](https://docs.anthropic.com/claude/docs/prompt-engineering) | 官方 |
-| State-Of-The-Art Prompting | [Google Docs](https://docs.google.com/document/d/11tBoylc5Pvy8wDp9_i2UaAfDi8x02iMNg9mhCNv65cU/) | YC 顶级技巧 |
-| Vibe Coding 101 | [Google Drive](https://drive.google.com/file/d/1OMiqUviji4aI56E14PLaGVJsbjhOP1L1/view) | 入门指南 |
-
-</details>
-
----
-
-<details>
-<summary><strong>👥 社区与论坛</strong></summary>
-
-### Telegram
-
-| 社区 | 链接 | 说明 |
-|:---|:---|:---|
-| Vibe Coding 交流群 | [t.me/glue_coding](https://t.me/glue_coding) | |
-| Vibe Coding 频道 | [t.me/tradecat_ai_channel](https://t.me/tradecat_ai_channel) | |
-
-### Discord
-
-| 社区 | 链接 | 说明 |
-|:---|:---|:---|
-| Cursor Discord | [discord.gg/cursor](https://discord.gg/cursor) | |
-| Anthropic Discord | [discord.gg/anthropic](https://discord.gg/anthropic) | |
-| Cline Discord | [discord.gg/cline](https://discord.gg/cline) | |
-| Aider Discord | [discord.gg/aider](https://discord.gg/Tv2uQnR88V) | |
-| Windsurf Discord | [discord.gg/codeium](https://discord.gg/codeium) | |
-
-### Reddit
-
-| 社区 | 链接 | 说明 |
-|:---|:---|:---|
-| r/ChatGPT | [reddit.com/r/ChatGPT](https://www.reddit.com/r/ChatGPT/) | ChatGPT 社区 |
-| r/ClaudeAI | [reddit.com/r/ClaudeAI](https://www.reddit.com/r/ClaudeAI/) | Claude 社区 |
-| r/Bard | [reddit.com/r/Bard](https://www.reddit.com/r/Bard/) | Gemini 社区 |
-| r/PromptEngineering | [reddit.com/r/PromptEngineering](https://www.reddit.com/r/PromptEngineering/) | 提示词工程 |
-| r/ChatGPTPromptGenius | [reddit.com/r/ChatGPTPromptGenius](https://www.reddit.com/r/ChatGPTPromptGenius/) | 提示词分享 |
-| r/LocalLLaMA | [reddit.com/r/LocalLLaMA](https://www.reddit.com/r/LocalLLaMA/) | 本地大模型 |
-
-### X (Twitter)
-
-| 社区 | 链接 | 说明 |
-|:---|:---|:---|
-| Vibe Coding 社群 | [x.com/communities](https://x.com/i/communities/1993849457210011871) | |
-| 社群干货聚合页 | [x.com/vibeverything](https://x.com/vibeverything/status/1999796188053438687) | |
-
-</details>
-
----
-
-<details>
-<summary><strong>🐙 GitHub 精选仓库</strong></summary>
-
-### GitHub 发现
-
-| 资源 | 链接 | 说明 |
-|:---|:---|:---|
-| GitHub Topics | [github.com/topics](https://github.com/topics) | 按主题浏览仓库 |
-| GitHub Trending | [github.com/trending](https://github.com/trending) | 热门仓库排行 |
-
-### CLI 工具
-
-| 仓库 | 链接 | 说明 |
-|:---|:---|:---|
-| claude-code | [GitHub](https://github.com/anthropics/claude-code) | Anthropic 官方 CLI |
-| aider | [GitHub](https://github.com/paul-gauthier/aider) | AI 结对编程工具 |
-| gpt-engineer | [GitHub](https://github.com/gpt-engineer-org/gpt-engineer) | 自然语言生成代码 |
-| open-interpreter | [GitHub](https://github.com/OpenInterpreter/open-interpreter) | 本地代码解释器 |
-| continue | [GitHub](https://github.com/continuedev/continue) | 开源 AI 代码助手 |
-| spec-kit | [GitHub](https://github.com/github/spec-kit) | GitHub 官方 Spec-Driven 开发工具包 |
-| opencode | [GitHub](https://github.com/opencode-ai/opencode) | 开源终端 AI 助手，Go 编写 |
-| oh-my-opencode | [GitHub](https://github.com/code-yeongyu/oh-my-opencode) | OpenCode 配置与插件 |
-| cline | [GitHub](https://github.com/cline/cline) | VS Code 自主编程 Agent |
-| gemini-cli | [GitHub](https://github.com/google-gemini/gemini-cli) | Google 官方 CLI |
-
-### IDE 插件
-
-| 仓库 | 链接 | 说明 |
-|:---|:---|:---|
-| copilot.vim | [GitHub](https://github.com/github/copilot.vim) | GitHub Copilot Vim 插件 |
-| codeium | [GitHub](https://github.com/Exafunction/codeium.vim) | 免费 AI 代码补全 |
-| avante.nvim | [GitHub](https://github.com/yetone/avante.nvim) | Neovim AI 助手插件 |
-| codecompanion.nvim | [GitHub](https://github.com/olimorris/codecompanion.nvim) | Neovim AI 编程伴侣 |
-
-### 提示词工程
-
-| 仓库 | 链接 | 说明 |
-|:---|:---|:---|
-| awesome-chatgpt-prompts | [GitHub](https://github.com/f/awesome-chatgpt-prompts) | ChatGPT 提示词集合 |
-| awesome-chatgpt-prompts-zh | [GitHub](https://github.com/PlexPt/awesome-chatgpt-prompts-zh) | 中文提示词 |
-| system-prompts-and-models-of-ai-tools | [GitHub](https://github.com/x1xhlol/system-prompts-and-models-of-ai-tools) | AI 工具系统提示词 |
-| claude-code-system-prompts | [GitHub](https://github.com/Piebald-AI/claude-code-system-prompts) | Claude Code 系统提示词 |
-| LangGPT | [GitHub](https://github.com/langgptai/LangGPT) | 结构化提示词框架 |
-
-### Agent 框架
-
-| 仓库 | 链接 | 说明 |
-|:---|:---|:---|
-| langchain | [GitHub](https://github.com/langchain-ai/langchain) | LLM 应用开发框架 |
-| autogen | [GitHub](https://github.com/microsoft/autogen) | 多 Agent 对话框架 |
-| crewai | [GitHub](https://github.com/joaomdmoura/crewAI) | AI Agent 协作框架 |
-| dspy | [GitHub](https://github.com/stanfordnlp/dspy) | 编程式 LLM 框架 |
-| MCAF | [mcaf.managed-code.com](https://mcaf.managed-code.com/) | AI 编程框架，定义 AGENTS.md 规范 |
-| smolagents | [GitHub](https://github.com/huggingface/smolagents) | HuggingFace 轻量 Agent 框架 |
-| pydantic-ai | [GitHub](https://github.com/pydantic/pydantic-ai) | 类型安全 AI Agent 框架 |
-| browser-use | [GitHub](https://github.com/browser-use/browser-use) | AI 浏览器自动化 |
-
-### MCP 相关
-
-| 仓库 | 链接 | 说明 |
-|:---|:---|:---|
-| mcp-servers | [GitHub](https://github.com/modelcontextprotocol/servers) | MCP 服务器集合 |
-| awesome-mcp-servers | [GitHub](https://github.com/punkpeye/awesome-mcp-servers) | MCP 资源汇总 |
-
-### 学习资源
-
-| 仓库 | 链接 | 说明 |
-|:---|:---|:---|
-| lovable-for-beginners | [GitHub](https://github.com/cporter202/lovable-for-beginners) | Lovable 新手入门教程 |
-| ai-for-grant-writing | [GitHub](https://github.com/eseckel/ai-for-grant-writing) | AI 辅助撰写资助申请 |
-| awesome-explorables | [GitHub](https://github.com/blob42/awesome-explorables) | 交互式可视化学习资源汇总 |
-| 2025 AI Engineer Reading List | [Latent.Space](https://www.latent.space/p/2025-papers) | 50篇必读论文，涵盖 LLM/RAG/Agent/CodeGen 等10个领域 |
-| prompt-engineering-guide | [GitHub](https://github.com/dair-ai/Prompt-Engineering-Guide) | 提示工程指南 |
-| generative-ai-for-beginners | [GitHub](https://github.com/microsoft/generative-ai-for-beginners) | 微软生成式 AI 教程 |
-| llm-course | [GitHub](https://github.com/mlabonne/llm-course) | LLM 学习路线 |
-| ai-engineering | [GitHub](https://github.com/chiphuyen/aie-book) | AI 工程实践 |
-| awesome-llm | [GitHub](https://github.com/Hannibal046/Awesome-LLM) | LLM 资源汇总 |
-| vibe-vibe | [GitHub](https://github.com/datawhalechina/vibe-vibe) | Datawhale Vibe Coding 教程 |
-| AI 编程最佳实践 | [GitHub](https://github.com/ninehills/blog/issues/97) | ninehills AI 编程经验 |
-
-### 实用工具
-
-| 仓库 | 链接 | 说明 |
-|:---|:---|:---|
-| ollama | [GitHub](https://github.com/ollama/ollama) | 本地大模型运行 |
-| localai | [GitHub](https://github.com/mudler/LocalAI) | 本地 AI API |
-| text-generation-webui | [GitHub](https://github.com/oobabooga/text-generation-webui) | 文本生成 WebUI |
-| lmstudio | [lmstudio.ai](https://lmstudio.ai/) | 本地模型 GUI 工具 |
-| jan | [GitHub](https://github.com/janhq/jan) | 开源本地 AI 助手 |
-| repomix | [GitHub](https://github.com/yamadashy/repomix) | 代码库打包为 AI 上下文 |
-| gitingest | [GitHub](https://github.com/cyclotruc/gitingest) | Git 仓库转 AI 友好格式 |
-
-</details>
-
----
-
-<details>
-<summary><strong>🔧 开发工具</strong></summary>
-
-### IDE & 编辑器
-
-| 工具 | 链接 | 说明 |
-|:---|:---|:---|
-| VS Code | [code.visualstudio.com](https://code.visualstudio.com/) | 主流编辑器 |
-| Cursor | [cursor.com](https://cursor.com/) | AI 原生编辑器，基于 VS Code |
-| Windsurf | [windsurf.com](https://windsurf.com/) | Codeium 出品 AI IDE |
-| Neovim | [neovim.io](https://neovim.io/) | 键盘流首选 |
-| LazyVim | [lazyvim.org](https://www.lazyvim.org/) | Neovim 配置框架 |
-| Zed | [zed.dev](https://zed.dev/) | 高性能编辑器，支持 AI |
-| Void | [voideditor.com](https://voideditor.com/) | 开源 AI 代码编辑器 |
-| PearAI | [trypear.ai](https://trypear.ai/) | 开源 AI IDE |
-
-### 终端工具
-
-| 工具 | 链接 | 说明 |
-|:---|:---|:---|
-| Warp | [warp.dev](https://www.warp.dev/) | AI 终端 |
-| tmux | [GitHub](https://github.com/tmux/tmux) | 终端复用 |
-| zsh | [ohmyz.sh](https://ohmyz.sh/) | Shell 增强 |
-
-### Web 框架
-
-| 工具 | 链接 | 说明 |
-|:---|:---|:---|
-| Django | [djangoproject.com](https://www.djangoproject.com/) | Python 全栈 Web 框架 |
-
-### 数据库工具
-
-| 工具 | 链接 | 说明 |
-|:---|:---|:---|
-| DBeaver | [dbeaver.io](https://dbeaver.io/) | 通用数据库客户端 |
-| TablePlus | [tableplus.com](https://tableplus.com/) | 现代数据库 GUI |
-
-### 可视化工具
-
-| 工具 | 链接 | 说明 |
-|:---|:---|:---|
-| Mermaid | [mermaid.js.org](https://mermaid.js.org/) | 文本转图表 |
-| Excalidraw | [excalidraw.com](https://excalidraw.com/) | 手绘风格图表 |
-| NotebookLM | [notebooklm.google.com](https://notebooklm.google.com/) | AI 笔记工具 |
-
-</details>
-
----
-
-<details>
-<summary><strong>📖 教程与课程</strong></summary>
-
-### 官方文档
-
-| 文档 | 链接 | 说明 |
-|:---|:---|:---|
-| Claude Documentation | [docs.anthropic.com](https://docs.anthropic.com/) | Anthropic 官方 |
-| OpenAI Documentation | [platform.openai.com](https://platform.openai.com/docs/) | OpenAI 官方 |
-| Gemini Documentation | [ai.google.dev](https://ai.google.dev/docs) | Google 官方 |
-
-### 社区教程
-
-| 教程 | 链接 | 说明 |
-|:---|:---|:---|
-| The Modern Software | [themodernsoftware.dev](https://themodernsoftware.dev/) | 现代软件开发实践 |
-| Claude Code in Action | [anthropic.skilljar.com](https://anthropic.skilljar.com/claude-code-in-action) | Anthropic 官方 Claude Code 实战课程 |
-| Claude Code in Action 中文版 | [飞书文档](https://qcnernilww58.feishu.cn/wiki/WIKWwO6WXiMjAgkPCTEcVtWHnsh) | Anthropic 官方实战课程中文版 |
-| Conductor for Gemini CLI | [Google Blog](https://developers.googleblog.com/conductor-introducing-context-driven-development-for-gemini-cli/) | 上下文驱动开发，Gemini CLI 扩展 |
-| 二哥的Java进阶之路 | [javabetter.cn](https://javabetter.cn/) | 开发工具配置教程 |
-| 超级个体资源清单 | [x.com/BiteyeCN](https://x.com/BiteyeCN/status/2000856243645157387) | |
-| AI 编程工具对比 | [x.com/xiaoying_eth](https://x.com/xiaoying_eth/status/2001865097661309260) | Cursor/Windsurf/Augment 等对比 |
-
-</details>
-
----
-
-<details>
-<summary><strong>🌐 网络配置</strong></summary>
-
-### 代理客户端
-
-| 工具 | 链接 | 说明 |
-|:---|:---|:---|
-| FlClash | [GitHub](https://github.com/chen08209/FlClash/releases) | 跨平台代理客户端 |
-
-### 网络服务
-
-| 服务 | 链接 | 说明 |
-|:---|:---|:---|
-| 机场服务 | [链接](https://xn--9kqz23b19z.com/#/register?code=35BcnKzl) | 约 6 元/月起 |
-
-</details>
-
----
-
-<details>
-<summary><strong>💳 支付工具</strong></summary>
-
-### 虚拟卡
-
-| 服务 | 链接 | 说明 |
-|:---|:---|:---|
-| Bybit 虚拟卡 | [bybit.com/cards](https://www.bybit.com/cards/?ref=YDGAVPN&source=applet_invite) | 注册云服务等国际支付 |
-
-</details>
-
----
-
-<details>
-<summary><strong>📏 Rules/规则文件</strong></summary>
-
-### AI 编程规则
-
-| 仓库 | 链接 | 说明 |
-|:---|:---|:---|
-| awesome-cursorrules | [GitHub](https://github.com/PatrickJS/awesome-cursorrules) | Cursor Rules 集合 |
-| cursor.directory | [cursor.directory](https://cursor.directory/) | Cursor Rules 在线目录 |
-| dotcursorrules | [GitHub](https://github.com/pontusab/dotcursorrules) | .cursorrules 模板 |
-| claude-code-system-prompts | [GitHub](https://github.com/Piebald-AI/claude-code-system-prompts) | Claude Code 系统提示词 |
-
-</details>
-
----
-
-<details>
-<summary><strong>📦 模板/脚手架</strong></summary>
-
-### 项目模板
-
-| 仓库 | 链接 | 说明 |
-|:---|:---|:---|
-| create-t3-app | [GitHub](https://github.com/t3-oss/create-t3-app) | 全栈 TypeScript 脚手架 |
-| create-next-app | [nextjs.org](https://nextjs.org/docs/app/api-reference/cli/create-next-app) | Next.js 官方脚手架 |
-| vite | [GitHub](https://github.com/vitejs/vite) | 现代前端构建工具 |
-| fastapi-template | [GitHub](https://github.com/tiangolo/full-stack-fastapi-template) | FastAPI 全栈模板 |
-| shadcn/ui | [ui.shadcn.com](https://ui.shadcn.com/) | React UI 组件库 |
-
-</details>
-
----
-
-<details>
-<summary><strong>📚 文档/知识库工具</strong></summary>
-
-### RAG 相关
-
-| 工具 | 链接 | 说明 |
-|:---|:---|:---|
-| RAGFlow | [GitHub](https://github.com/infiniflow/ragflow) | 开源 RAG 引擎 |
-| Dify | [GitHub](https://github.com/langgenius/dify) | LLM 应用开发平台 |
-| AnythingLLM | [GitHub](https://github.com/Mintplex-Labs/anything-llm) | 私有文档 AI 助手 |
-| Quivr | [GitHub](https://github.com/QuivrHQ/quivr) | 个人知识库 AI |
-| PrivateGPT | [GitHub](https://github.com/zylon-ai/private-gpt) | 私有文档问答 |
-
-### 文档工具
-
-| 工具 | 链接 | 说明 |
-|:---|:---|:---|
-| DevDocs | [GitHub](https://github.com/freeCodeCamp/devdocs) | 多语言 API 文档聚合浏览器 |
-| Docusaurus | [docusaurus.io](https://docusaurus.io/) | Meta 开源文档框架 |
-| VitePress | [vitepress.dev](https://vitepress.dev/) | Vue 驱动静态站点 |
-| Mintlify | [mintlify.com](https://mintlify.com/) | AI 文档生成 |
-| Zread | [zread.ai](https://zread.ai/) | AI 仓库阅读工具 |
-
-</details>
-
----
-
-<details>
-<summary><strong>✅ 代码质量/测试</strong></summary>
-
-### AI 代码审查
-
-| 工具 | 链接 | 说明 |
-|:---|:---|:---|
-| | | 待补充 |
-
-</details>
-
----
-
-<details>
-<summary><strong>🚀 部署/DevOps</strong></summary>
-
-### 一键部署
-
-| 平台 | 链接 | 说明 |
-|:---|:---|:---|
-| | | 待补充 |
-
-</details>
-
----
-
-<details>
-<summary><strong>🎯 特定领域</strong></summary>
-
-### Web3/区块链
-
-| 工具 | 链接 | 说明 |
-|:---|:---|:---|
-| | | 待补充 |
-
-### 数据科学/ML
-
-| 工具 | 链接 | 说明 |
-|:---|:---|:---|
-| | | 待补充 |
-
-</details>
-
----
-
-<details>
-<summary><strong>🇨🇳 中文资源专区</strong></summary>
-
-### 国内镜像/加速
-
-| 资源 | 链接 | 说明 |
-|:---|:---|:---|
-| | | 待补充 |
-
-</details>
-
----
-
-## 📝 贡献
-
-发现好资源？欢迎 PR 补充！

documents/04-资源/工具集.md

@@ -1,51 +0,0 @@
-# 🛠️ 工具集
-
-> Vibe Coding 常用工具速查
-
-## 💻 IDE 与插件
-
-| 工具 | 说明 |
-|:---|:---|
-| [VS Code](https://code.visualstudio.com/) | 主流编辑器 |
-| [Windsurf](https://windsurf.com/) | AI IDE，新用户免费额度 |
-| [Cursor](https://cursor.com/) | AI 原生编辑器 |
-| [Continue](https://continue.dev/) | 开源 AI 代码助手插件 |
-| Local History | VS Code 本地历史插件 |
-| Partial Diff | VS Code 差异对比插件 |
-
-## 🤖 AI 模型
-
-| 模型 | 说明 |
-|:---|:---|
-| Claude Opus 4.6 | 代码能力强 |
-| GPT-5.1 Codex | 复杂逻辑处理 |
-| Gemini 2.5 Pro | 免费长上下文 |
-
-## ⌨️ CLI 工具
-
-| 工具 | 说明 |
-|:---|:---|
-| [Kiro](https://kiro.dev/) | AWS 出品，免费 Claude Opus |
-| [Droid](https://factory.ai/) | 多模型 CLI 访问 |
-| Claude Code | Anthropic 官方 CLI |
-| Codex CLI | OpenAI 官方 CLI |
-| Gemini CLI | Google 官方 CLI，免费 |
-
-## 🌐 常用网站
-
-| 网站 | 用途 |
-|:---|:---|
-| [AI Studio](https://aistudio.google.com/) | Google 免费 Gemini |
-| [ChatGPT](https://chatgpt.com/) | OpenAI 对话 |
-| [Zread](https://zread.ai/) | AI 仓库阅读 |
-| [GitHub](https://github.com/) | 代码托管 |
-| [Mermaid Chart](https://www.mermaidchart.com/) | 文本转图表 |
-| [NotebookLM](https://notebooklm.google.com/) | AI 笔记工具 |
-| [Google Sheets](https://docs.google.com/spreadsheets/) | 在线表格 |
-| [Apps Script](https://script.google.com/) | Google 脚本 |
-| [Z-Library](https://z-lib.fm/) | 电子书资源 |
-| [Bilibili](https://www.bilibili.com/) | 视频教程 |
-
-## 🔗 更多资源
-
-详见 [外部资源聚合](./外部资源聚合.md)

documents/04-资源/编程书籍推荐.md

@@ -1,151 +0,0 @@
-# z-lib 里面全部都可以免费下载
-
-从零开始大模型开发与微调：基于PyTorch与ChatGLM - 王晓华
-
-编程的原则：改善代码质量的101个方法 - 上田勋
-
-生成式 AI 设计模式 - Valliappa Lakshmanan & Hannes Hapke
-
-人月神话 - 弗雷德里克·布鲁克斯
-
-人件（原书第3版） - Tom DeMarco & Timothy Lister
-
-高效程序员的45个习惯：敏捷开发修炼之道 - Andy Hunt & Venkat Subramaniam
-
-项目管理修炼之道 - 罗斯曼
-
-编程珠玑（续） - 乔恩·本特利
-
-编程珠玑（第2版） - 乔恩·本特利
-
-编程原则：来自代码大师Max Kanat-Alexander的建议（让简约设计的思想回归到计算机编程，适合软件开发者、开发团队管理者和软件相关专业学生阅读） （华章程序员书库） - Max Kanat-Alexande
-
-编写可读代码的艺术 - Dustin Boswell & Trevor Foucher
-
-统计思维：程序员数学之概率统计（第2版） - Allen B.Downey
-
-精通Rust（第2版） - Rahul Sharma & Vesa Kaihlavirta
-
-程序员超强大脑（图灵程序设计丛书·程序员修炼系列） - 费莉安·赫尔曼斯
-
-程序员必读之软件架构 - Simon Brown
-
-程序员修炼之道：专业程序员必知的33个技巧 - Josh·Carter
-
-看漫画学Python：有趣、有料、好玩、好用 - 关东升
-
-混沌工程：通过可控故障实验提升软件系统可靠性 - 米科拉吉·帕利科夫斯基_1
-
-深入理解Python特性 - 达恩·巴德尔
-
-微服务实战（覆盖从微服务设计到部署的各个阶段的技术实战书）（异步图书） - 摩根·布鲁斯 & 保罗·A·佩雷拉
-
-大数据系统构建：可扩展实时数据系统构建原理与最佳实践 - NathanMarz & JamesWarren
-
-图解性能优化（图灵程序设计丛书） - 小田圭二 & 榑松谷仁 & 平山毅 & 冈田宪昌
-
-图灵程序设计丛书：大规模数据处理入门与实战（套装全10册）【图灵出品！一套囊括SQL、Python、Spark、Hadoop、妮哈·纳克海德 & 格温·沙皮拉托德 & 帕利诺 & 本杰明·班福特 & 珍妮·基姆 & 埃伦·弗里德曼 & 科斯塔斯·宙马斯
-
-代码整洁之道 - Robert C. Martin
-
-代码之髓：编程语言核心概念（图灵程序设计丛书） - 西尾泰和
-
-人人都懂设计模式：从生活中领悟设计模式 - 罗伟富
-
-Rust权威指南（第2版） - Steve Klabnik & Carol Nichols
-
-Python金融大数据分析（第2版） - 伊夫·希尔皮斯科
-
-Python科学计算基础教程 - Hemant Kumar Mehta_1
-
-Python数据挖掘入门与实践 - Robert Layton
-
-Python数据分析与算法指南（套装共8册） - 江雪松 & 邹静 & 邓立国 & 翟锟 & 胡锋 & 周晓然 & 王国平 & 白宁超 & 唐聃 & 文俊 & 张若愚 & 洪锦魁
-
-Python性能分析与优化 - Fernando Doglio
-
-Python函数式编程（第2版）（图灵图书） - 史蒂文·洛特_1
-
-GPT时代的量化交易：底层逻辑与技术实践 - 罗勇 & 卢洪波_1
-
-ChatGPT数据分析实践 - 史浩然 & 赵辛 & 吴志成
-
-AI时代Python金融大数据分析实战：ChatGPT让金融大数据分析插上翅膀 - 关东升
-
-跨市场交易策略 - John J. Murphy
-
-资产定价与机器学习 - 吴轲
-
-工程思维 - 马克 N. 霍伦斯坦
-
-程序员的思维修炼：开发认知潜能的九堂课（图灵程序设计丛书） - Andy Hunt
-
-程序员修炼之道：通向务实的最高境界（第2版）【这本书颠覆了无数人的软件生涯！并推动整个IT行业走到今天！时隔20年的再版重磅来袭！】 -  大卫·托马斯 & 安德鲁·亨特
-
-不确定状况下的判断：启发式和偏差 - 丹尼尔·卡尼曼
-
-简约之美：软件设计之道 - Max Kanant-Alexander
-
-程序员的底层思维 - 张建飞
-
-程序员的三门课：技术精进、架构修炼、管理探秘 - 于君泽
-
-机器学习系统设计（图灵程序设计丛书） - Willi Richert & Luis Pedro Coelho
-
-思维工程导论 - 钱小一
-
-算法精粹：经典计算机科学问题的Python实现 - David Kopec
-
-函数式编程思维 (图灵程序设计丛书) - Neal Ford
-
-Python函数式编程（第2版）（图灵图书） - 史蒂文·洛特
-
-Effective Python 编写高质量Python代码的90个有效方法（原书第2版） (Effective系列丛书) - Brett Slatkin
-
-高频交易（原书第2版） - Irene Aldridge
-
-高频交易员：华尔街的速度游戏 - 迈克尔·刘易斯
-
-金融学原理（第6版） - 彭兴韵
-
-聪明投资者的第一本金融学常识书 - 肖玉红
-
-可视化量化金融 - Michael Lovelady
-
-GPT时代的量化交易：底层逻辑与技术实践 - 罗勇 & 卢洪波
-
-图灵经典计算机基础系列（套装全4册） -  矢泽久雄 & 户根勤 & 平泽章
-
-软件开发的201个原则 - Alan M· Davis
-
-程序员的AI书：从代码开始 - 张力柯 & 潘晖
-
-计算的本质：深入剖析程序和计算机 - Tom Stuart
-
-程序员投资指南 -  Stefan Papp
-
-精通正则表达式（第3版） - Jeffrey E.F.Friedl
-
-巧用ChatGPT进行数据分析与挖掘 - 谢佳标
-
-工业人工智能三部曲（套装共三册）（世界一流的智能制造专家著作合辑）（2016年被美国制造工程师学会（SME）评选为“美国30位最有远见的智能制造人物”） - 李杰
-
-从零构建大模型：算法、训练与微调 - 梁楠
-
-Vibe Coding_ Building Production-Grade Software With GenAI, Chat, Agents, and Beyond - Gene Kim & Steve Yegge
-
-Vibe Coding AI 编程完全手册 - 谭星星
-
-计算机科学概论（第13版） - J. 格伦·布鲁克希尔 & 丹尼斯·布里罗
-
-Pro Git （中文版） - Scott Chacon & Ben Straub
-
-像程序员一样思考 - V.Anton Spraul
-
-Python核心编程（第3版） - Wesley Chun_1
-
-AI 工程：从基础模型建构应用 - Chip Huyen
-
-AI辅助编程实战 - 汤姆·陶利
-
-编码：隐匿在计算机软硬件背后的语言 - Charles Petzold

documents/AGENTS.md

@@ -12,8 +12,7 @@ documents/
 ├── 00-基础指南/         # 核心原则与底层逻辑
 ├── 01-入门指南/         # 从零开始教程
 ├── 02-方法论/           # 具体工具与技巧
-├── 03-实战/             # 项目实战案例
-└── 04-资源/             # 外部资源聚合
+└── 03-实战/             # 项目实战案例
 ```
 
 ## 操作规范

documents/README.md

@@ -10,8 +10,7 @@ documents/
 ├── 00-基础指南/      # 核心理念，胶水编程，方法论
 ├── 01-入门指南/      # 从零开始，环境配置
 ├── 02-方法论/        # 工具教程，开发经验
-├── 03-实战/          # 项目实战经验
-└── 04-资源/          # 模板，工具，外部资源
+└── 03-实战/          # 项目实战经验
 ```
 
 ## 🚀 快速导航
@@ -23,7 +22,6 @@ documents/
 | [01-入门指南](./01-入门指南/) | 环境配置、从零开始 | 新手入门 |
 | [02-方法论](./02-方法论/) | 工具教程、开发经验 | 提升效率 |
 | [03-实战](./03-实战/) | 项目经验、案例复盘 | 动手实践 |
-| [04-资源](./04-资源/) | 模板、工具、外部链接 | 查阅参考 |
 
 ## 📖 推荐学习路径
 
@@ -39,3 +37,4 @@ documents/
 
 - [提示词库](../prompts/) - AI 提示词资产
 - [技能库](../skills/) - 模块化技能集
+- [外部资源（在线表格）](../assets/README.md) - 外部资源唯一真相源入口

libs/README.md

@@ -1,73 +0,0 @@
-# 📦 通用库与外部集成 (libs)
-
-`libs/` 用来放两类东西：
-
-1. **内部可复用的胶水代码**：小而稳、低耦合、可替换（`common/`）
-2. **第三方工具与外部集成**：尽量保持原样、只做最薄适配（`external/`）
-
-`database/` 预留未来的数据持久化层（当前仅占位）。
-
-## 目录结构
-
-```text
-libs/
-├── README.md
-├── common/
-│   ├── README.md
-│   ├── __init__.py
-│   ├── models/
-│   │   └── __init__.py
-│   └── utils/
-│       └── backups/
-│           ├── README.md
-│           ├── 快速备份.py
-│           └── 一键备份.sh
-├── database/
-│   ├── README.md
-│   └── .gitkeep
-└── external/
-    ├── README.md
-    ├── chat-vault/
-    ├── prompts-library/
-    ├── l10n-tool/
-    ├── my-nvim/
-    ├── MCPlayerTransfer/
-    ├── XHS-image-to-PDF-conversion/
-    └── .gitkeep
-```
-
-## 子目录职责与边界
-
-### `common/`：内部通用模块
-
-- 入口：[`common/README.md`](./common/README.md)
-- 只放 **可复用** 的基础能力：模型、工具函数、脚本等
-- 不要把业务逻辑、项目临时代码塞进来
-- 约定：新增/调整能力时，同步更新 `libs/common/README.md`
-
-### `database/`：数据库适配层（预留）
-
-- 入口：[`database/README.md`](./database/README.md)
-- 目标是把“存储细节”关进盒子里：连接、迁移、查询适配、事务边界
-- 约定：实现前先写清楚目录结构与边界（见 `libs/database/README.md`）
-
-### `external/`：第三方工具与外部集成
-
-- 入口：[`external/README.md`](./external/README.md)
-- 尽量保持第三方代码原样，避免“魔改后不可升级”
-- 每个工具目录至少包含：`README.md`（用途/入口/依赖）与许可证/来源说明
-- 约定：新增外部工具时，同步更新 `libs/external/README.md`
-
-## 常用入口
-
-- AI 聊天记录保存：
-  [`external/chat-vault/`](./external/chat-vault/)（支持 Codex/Kiro/Gemini/Claude CLI）
-- 提示词批量管理：
-  [`external/prompts-library/`](./external/prompts-library/)（配合 `../prompts/` 使用）
-- 备份工具：优先使用仓库根目录的 `backups/`（当前与 `libs/common/utils/backups/` 内容一致）
-
-## 贡献约定（最小要求）
-
-1. 新增模块先定义职责边界，再写代码/文档
-2. 新增依赖记录安装方式与最低版本（必要时补充到 `documents/工具集.md`）
-3. 目录结构/职责变化时，更新对应 README，保证“文档即真相源”

libs/common/README.md

@@ -1,40 +0,0 @@
-# 🔧 libs/common：通用模块
-
-`libs/common/` 放的是项目内部可复用的“胶水代码”：**小而稳、低耦合、可替换**。这里的目标不是堆功能，而是为仓库提供少量可靠的基础能力。
-
-## 目录结构
-
-```
-libs/common/
-├── README.md
-├── __init__.py
-├── models/                 # 预留：数据模型（当前仅占位）
-│   └── __init__.py
-└── utils/
-    └── backups/            # 基于 .gitignore 的快速备份工具
-        ├── README.md
-        ├── 快速备份.py
-        └── 一键备份.sh
-```
-
-## 现有内容
-
-- `utils/backups/`：快速备份工具（当前与仓库根目录 [`backups/`](../../backups/) 内容一致，用于避免脚本散落各处）
-
-## 约束与约定
-
-1. **不放业务逻辑**：`common/` 只提供基础能力与工具
-2. **接口要稳**：一旦被引用，就把它当作公开 API 对待
-3. **可审计输出**：脚本/工具的输出要可复盘（明确输入、输出路径、失败原因）
-4. **新增即文档**：新增模块/目录必须同步更新本 README 与 `libs/README.md`
-
-## 使用方式（当前推荐）
-
-本目录的内容目前主要以“脚本/工具”形式存在，推荐直接运行：
-
-```bash
-# 备份当前仓库（建议优先使用根目录 backups/ 入口）
-python3 backups/快速备份.py
-```
-
-更多参数与说明见：[`../../backups/README.md`](../../backups/README.md)。

libs/common/__init__.py

@@ -1 +0,0 @@
-# Common Library

libs/common/models/__init__.py

@@ -1 +0,0 @@
-# Models Module

libs/database/.gitkeep

@@ -1 +0,0 @@
-# Third-party libraries (read-only)

libs/database/README.md

@@ -1,24 +0,0 @@
-# 🗄️ libs/database：数据库适配层（预留）
-
-`libs/database/` 预留给未来的“存储适配层”。目标是把数据库的细节（连接、迁移、事务、查询）封装在一个清晰边界内，避免业务代码到处散落 SQL/ORM。
-
-## 设计边界（先写清楚再实现）
-
-- 这里负责：连接管理、迁移脚本、ORM/SQL 模型、统一的查询/事务封装
-- 这里不负责：业务规则、HTTP/API 逻辑、领域对象的复杂编排
-
-## 推荐目录结构（落地时按需取舍）
-
-```
-libs/database/
-├── README.md
-├── __init__.py
-├── connection.py             # 连接与池化
-├── migrations/               # 迁移脚本（Alembic/Flyway/自研均可）
-├── repositories/             # 数据访问层（可选）
-└── models/                   # ORM 模型或 SQL schema（可选）
-```
-
-## 何时开始实现
-
-当仓库出现“需要长期保存/查询的数据”且 **文件系统不够用** 时，再把这一层落地；否则保持为空，避免过早引入复杂度。

libs/external/README.md

@@ -1,39 +0,0 @@
-# 🔌 libs/external：外部集成与第三方工具
-
-`libs/external/` 用来收纳第三方工具、外部依赖与集成模块。核心原则是：
-
-- **尽量原样保留**：避免“魔改后不可升级”
-- **隔离依赖与风险**：外部工具的依赖不要污染主仓库
-- **可追溯**：来源、许可证、用法要写清楚
-
-## 目录结构
-
-```
-libs/external/
-├── README.md
-├── chat-vault/                                  # AI 聊天记录保存工具
-├── prompts-library/                             # 提示词库管理工具（Excel ↔ Markdown）
-├── l10n-tool/                                   # 多语言翻译脚本
-├── my-nvim/                                     # Neovim 配置（含 nvim-config/）
-├── MCPlayerTransfer/                            # MC 玩家迁移工具
-├── XHS-image-to-PDF-conversion/                 # 图片合并 PDF 工具
-└── .gitkeep
-```
-
-## 工具清单（入口与文档）
-
-- `chat-vault/`：AI 聊天记录保存工具，支持 Codex/Kiro/Gemini/Claude CLI（详见 [`chat-vault/README_CN.md`](./chat-vault/README_CN.md)）
-- `prompts-library/`：提示词 Excel ↔ Markdown 批量互转与索引生成（详见 [`prompts-library/README.md`](./prompts-library/README.md)）
-- `l10n-tool/`：多语言批量翻译脚本
-- `my-nvim/`：个人 Neovim 配置（详见 [`my-nvim/README.md`](./my-nvim/README.md)）
-- `MCPlayerTransfer/`：MC 玩家迁移工具
-- `XHS-image-to-PDF-conversion/`：图片合并 PDF（详见 [`XHS-image-to-PDF-conversion/README.md`](./XHS-image-to-PDF-conversion/README.md)）
-
-> 📝 `system-prompts-and-models-of-ai-tools-main-cn/` 已移至 [`prompts/system_prompts/`](../../prompts/system_prompts/)
-
-## 新增外部工具（最小清单）
-
-1. 创建目录：`libs/external/<tool-name>/`
-2. 必备文件：`README.md`（用途/入口/依赖/输入输出）、许可证与来源说明（如 `LICENSE` / `SOURCE.md`）
-3. 依赖约束：尽量使用工具自带的虚拟环境/容器化方式，不影响仓库其他部分
-4. 文档同步：在本 README 增加一行工具说明，保证可发现性

prompts/AGENTS.md

@@ -29,4 +29,4 @@
 
 ## 相关工具
 
-- `libs/external/prompts-library/` - Excel ↔ Markdown 互转工具
+- `repo/prompts-library/` - Excel ↔ Markdown 互转工具

prompts/README.md

@@ -25,7 +25,8 @@
 
 - [技能库](../skills/) - 比提示词更高级的能力封装
 - [文档库](../documents/) - 方法论与开发经验
-- [prompts-library 工具](../libs/external/prompts-library/) - Excel ↔ Markdown 互转工具
+- [prompts-library 工具](../repo/prompts-library/)
+  Excel ↔ Markdown 互转工具
 
 ## 原版表格
 

repo/AGENTS.md

@@ -1,11 +1,11 @@
-# libs/external/ 目录 Agent 指南
+# repo/ 目录 Agent 指南
 
 本目录用于收纳 **外部工具/第三方项目**（含 Git submodule），保持“主仓库资产”和“外部依赖”边界清晰、可审计、可更新。
 
 ## 目录结构（约定）
 
 ```text
-libs/external/
+repo/
 ├── AGENTS.md                         # 本文件（目录级行为准则）
 ├── README.md                         # 外部工具索引
 ├── .tmux/                            # submodule：oh-my-tmux 配置
@@ -24,4 +24,3 @@ libs/external/
 
 - 直接复制粘贴大型第三方仓库内容到主仓库（优先 submodule）
 - 将 submodule 替换为本地绝对路径软链接（会导致他人环境不可用）
-

repo/README.md

@@ -0,0 +1,46 @@
+# 🔌 repo/：外部集成与第三方工具
+
+`repo/` 用来收纳第三方工具、外部依赖与集成模块（含 Git submodule）。核心原则是：
+
+- **尽量原样保留**：避免“魔改后不可升级”
+- **隔离依赖与风险**：外部工具的依赖不要污染主仓库
+- **可追溯**：来源、许可证、用法要写清楚
+
+## 目录结构
+
+```
+repo/
+├── AGENTS.md                    # 本目录的 Agent 行为准则
+├── README.md                    # 本文件（外部工具索引）
+├── .tmux/                       # submodule：oh-my-tmux 配置
+├── tmux/                        # submodule：tmux 源码
+├── claude-official-skills/      # submodule：Claude 官方 skills 仓库（Anthropic）
+├── prompts-library/             # Excel ↔ Markdown 转换工具
+├── chat-vault/                  # AI 聊天记录保存工具
+├── Skill_Seekers-development/   # Skills 制作器
+├── html-tools-main/             # HTML 工具集
+├── my-nvim/                     # Neovim 配置（含 nvim-config/）
+├── MCPlayerTransfer/            # MC 玩家迁移工具
+├── XHS-image-to-PDF-conversion/ # 图片合并 PDF 工具
+└── backups/                     # 历史备份脚本快照
+```
+
+## 工具清单（入口与文档）
+
+- `chat-vault/`：AI 聊天记录保存工具（详见 `chat-vault/README.md`）
+- `prompts-library/`：提示词 Excel ↔ Markdown 批量互转与索引生成（详见 `prompts-library/README.md`）
+- `Skill_Seekers-development/`：Skills 抓取/制作器（详见 `Skill_Seekers-development/README.md`）
+- `html-tools-main/`：HTML 工具集（详见 `html-tools-main/README.md`）
+- `my-nvim/`：个人 Neovim 配置（详见 `my-nvim/README.md`）
+- `MCPlayerTransfer/`：MC 玩家迁移工具（详见 `MCPlayerTransfer/README.md`）
+- `XHS-image-to-PDF-conversion/`：图片合并 PDF（详见 `XHS-image-to-PDF-conversion/README.md`）
+- `.tmux/`、`tmux/`、`claude-official-skills/`：以 submodule 形式引入的上游仓库
+
+> 📝 `system-prompts-and-models-of-ai-tools-main-cn/` 已移至 [`prompts/system_prompts/`](../../prompts/system_prompts/)
+
+## 新增外部工具（最小清单）
+
+1. 创建目录：`repo/<tool-name>/`
+2. 必备文件：`README.md`（用途/入口/依赖/输入输出）、许可证与来源说明（如 `LICENSE` / `SOURCE.md`）
+3. 依赖约束：尽量使用工具自带的虚拟环境/容器化方式，不影响仓库其他部分
+4. 文档同步：在本 README 增加一行工具说明，保证可发现性