# AI Coding Process Asset

**Repository Path**: mykin2026/ai-coding-process-asset

## Basic Information

- **Project Name**: AI Coding Process Asset
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 1
- **Forks**: 0
- **Created**: 2026-02-11
- **Last Updated**: 2026-02-23

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# AI 记录查询与备份中心

本目录用于统一管理这台服务器上的 `Codex`、`Claude Code`、`Gemini` 记录，目标是：

- 统一发现各类 AI 数据目录（全局 + 项目内 + 历史快照）
- 统一生成会话索引（按项目、按 session）
- 生成可浏览结构视图（`global-assets` / `project-assets` / `snapshot-assets`）
- 按“核心价值”做四层归档（`coreA` / `coreAB` / `recover` / `full`）

## 目录结构

- `scripts/`：扫描、索引、结构化视图、备份脚本
- `manifests/`：数据源清单、备份清单
- `indexes/`：标准化会话索引和汇总
- `catalog/`：按项目与 session 的链接视图
- `global-assets/`：全局 AI 资产视图
- `project-assets/`：项目本地 AI 资产视图
- `snapshot-assets/`：历史快照 AI 资产视图（`backup` / `diff` 等）
- `backups/`：备份输出目录

## 快速开始

1) 刷新发现与索引

```bash
cd /root/ai-records-center
./scripts/refresh_all.sh /root /root
```

2) 结构化梳理（推荐）

```bash
# 轻量模式（视图为软链接）
./scripts/backup_ai_structured.sh --no-archives --view-mode symlink

# 自包含模式（视图为真实复制）
./scripts/backup_ai_structured.sh --no-archives --view-mode copy
```

输出结构示例：

- `backups/structured-<timestamp>/structure/scope-structure.md`
- `backups/structured-<timestamp>/views/global-assets`
- `backups/structured-<timestamp>/views/project-assets`
- `backups/structured-<timestamp>/views/snapshot-assets`

3) 四层归档（可单独执行）

```bash
./scripts/backup_ai_records.sh --mode coreA
./scripts/backup_ai_records.sh --mode coreAB
./scripts/backup_ai_records.sh --mode recover
./scripts/backup_ai_records.sh --mode full
```

## 视图模式说明

- `symlink`：默认模式，体积小、速度快，适合“看结构与定位”。
- `copy`：真实复制，完全自包含，适合离线交付与抽样核验（体积更大）。

## Claude 迁移重点（全局 vs 项目）

- **全局（`/root/.claude`）**
  - 核心：`projects/`、`history.jsonl`
  - 能力：`commands/`、`skills/`、`agents/`、`plugins/`、`settings.json`
  - 过程：`file-history/`、`todos/`、`plans/`、`workflows/`
  - 诊断：`debug/`、`telemetry/`、`shell-snapshots/`

- **项目本地（`<project>/.claude`）**
  - 项目规则、项目技能、局部配置与项目文档（如 `settings.local.json`、`CLAUDE.md`）

- **历史快照（`backup`/`diff` 中的 `.claude`）**
  - 用于历史追溯与比对，不应与主项目资产混为一类

## 安全提示

- `backups/`、`indexes/`、`manifests/`、`global-assets/`、`project-assets/`、`snapshot-assets/` 都是本地数据产物，默认不入库。
- 建议对 `backups/` 归档再做二次加密（`gpg` / KMS）。