fnvtk/karuo-ai
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

🔄 卡若AI 同步 2026-02-22 10:56 | 更新：卡土、总索引与入口、运营中枢参考资料、运营中枢工作台 | 排除 >20MB: 8 个

Browse Source
This commit is contained in:
karuo
2026-02-22 10:56:20 +08:00
parent 4ae9756920
commit 0ec22b0a67
8 changed files with 274 additions and 7 deletions
Download Patch File Download Diff File Expand all files Collapse all files

16
05_卡土（土）/土砖_技能复制/基因胶囊/SKILL.md
View File

@@ -68,18 +68,30 @@ python3 .../gene_capsule.py list
---
## 四、相关文件
## 四、导出时产出
每次 **pack** 会自动生成：
| 产出 | 路径 |
|:---|:---|
| 胶囊 JSON | `卡若Ai的文件夹/导出/基因胶囊/技能名_sha256前8位.json` |
| **说明文档（含流程图）** | `卡若Ai的文件夹/导出/基因胶囊/README_基因胶囊导出说明.md` |
说明文档内含：基因胶囊功能总览、**完整流程图**（Mermaid）、已导出胶囊清单、使用方法。
## 五、相关文件
| 文件 | 说明 |
|:---|:---|
| `运营中枢/参考资料/基因胶囊规范.md` | 概念与格式规范 |
| `运营中枢/参考资料/基因胶囊功能流程图.md` | 流程图（仓库内常驻） |
| `脚本/gene_capsule.py` | pack/unpack/list 主脚本 |
| `capsule_index.json` | 继承胶囊索引（解包时更新） |
| `卡若Ai的文件夹/导出/基因胶囊/` | 导出目录 |
---
## 五、依赖
## 六、依赖
- Python 3.9+
- 可选：PyYAML（用于精确解析 frontmatter，无则用简单解析）

155
05_卡土（土）/土砖_技能复制/基因胶囊/脚本/gene_capsule.py
View File

@@ -88,8 +88,150 @@ def _parse_frontmatter(content: str) -> tuple:
return fm, parts[2].strip()
EXPORT_README = "README_基因胶囊导出说明.md"
def _render_flowchart_mermaid() -> str:
"""返回基因胶囊功能流程图 Mermaid 源码"""
return """```mermaid
flowchart TB
subgraph internal["卡若AI 内部流程"]
A1[用户需求/任务] --> A2{查 SKILL_REGISTRY}
A2 --> A3[读 SKILL.md 执行]
A3 --> A4[执行完成 + 复盘]
A4 --> A5{经验有价值?}
A5 -->|是| A6[写入经验库/待沉淀]
A5 -->|否| A7[结束]
A6 --> A8{要打包为胶囊?}
end
subgraph capsule["基因胶囊 核心流程"]
B1[pack: Skill 转 胶囊JSON] --> B2[导出目录 + 说明文档]
B2 --> B3[list: 查看本地胶囊]
B3 --> B4{需要继承?}
B4 -->|是| B5[unpack: 胶囊 转 Skill]
B4 -->|否| B6[保留备用]
B5 --> B7[写入对应成员目录]
B7 --> B8[更新 SKILL_REGISTRY]
end
subgraph factory["技能工厂联动"]
C1[创建 Skill 前] --> C2[list 查本地胶囊]
C2 --> C3{有匹配?}
C3 -->|是| C4[unpack 继承]
C3 -->|否| C5[新建 Skill]
C5 --> C6[创建 Skill 后]
C6 --> C7[pack 打包为胶囊]
C4 --> B7
end
subgraph external["未来对外流通"]
D1[EvoMap Market] --> D2[上传胶囊]
D2 --> D3[全球 Agent 继承]
D3 --> B5
B2 -.->|可选| D2
end
A8 -->|是| B1
A8 -->|否| A7
```"""
def _write_export_readme() -> str:
"""生成/更新导出说明文档（含流程图），返回说明文档路径"""
EXPORT_DIR.mkdir(parents=True, exist_ok=True)
readme_path = EXPORT_DIR / EXPORT_README
# 收集已导出胶囊列表（按创建时间倒序）
caps = []
if EXPORT_DIR.exists():
for f in sorted(EXPORT_DIR.glob("*.json")):
try:
data = json.loads(f.read_text(encoding="utf-8"))
m = data.get("manifest", {})
caps.append({
"file": f.name,
"name": m.get("name", ""),
"capsule_id": data.get("capsule_id", "")[:19],
"created_at": data.get("created_at", ""),
})
except Exception:
pass
caps.sort(key=lambda x: x.get("created_at", ""), reverse=True)
lines = [
"# 基因胶囊 · 导出说明",
"",
"> **生成时间**：{now} ",
"> **导出目录**：`卡若Ai的文件夹/导出/基因胶囊/` ",
"> **规范文档**：`运营中枢/参考资料/基因胶囊规范.md`",
"",
"---",
"",
"## 一、基因胶囊功能总览",
"",
"**基因胶囊**将验证过的 Skill + 环境指纹 + 审计记录打包为可遗传能力单元，支持：",
"",
"- **pack**：Skill → 胶囊 JSON（导出）",
"- **unpack**：胶囊 JSON → Skill（继承）",
"- **list**：查看本地所有胶囊",
"",
"---",
"",
"## 二、基因胶囊完整流程图",
"",
"以下流程图展示卡若AI 中基因胶囊的完整工作流程、与技能工厂的联动，以及未来与 EvoMap 的流通路径。",
"",
_render_flowchart_mermaid(),
"",
"---",
"",
"## 三、已导出胶囊清单",
"",
"| 技能名 | 胶囊文件 | capsule_id | 创建时间 |",
"|:---|:---|:---|:---|",
]
for c in caps:
lines.append(f"| {c.get('name', '')} | {c.get('file', '')} | {c.get('capsule_id', '')} | {c.get('created_at', '')} |")
if not caps:
lines.append("| （暂无） | — | — | — |")
lines.extend([
"",
"---",
"",
"## 四、使用方法",
"",
"### 解包（继承能力）",
"",
"```bash",
"cd /Users/karuo/Documents/个人/卡若AI",
'python3 "05_卡土（土）/土砖_技能复制/基因胶囊/脚本/gene_capsule.py" unpack 技能名_xxxx.json',
'python3 .../gene_capsule.py unpack 技能名_xxxx.json -o 目标目录/ # 指定输出目录',
"```",
"",
"### 列表",
"",
"```bash",
'python3 .../gene_capsule.py list',
"```",
"",
"---",
"",
"## 五、引用",
"",
"- 规范：`运营中枢/参考资料/基因胶囊规范.md`",
"- 技能：`05_卡土（土）/土砖_技能复制/基因胶囊/SKILL.md`",
"- 流程图亦可于规范文档中查看",
"",
])
now = datetime.now().strftime("%Y-%m-%d %H:%M")
content = "\n".join(lines).replace("{now}", now)
readme_path.write_text(content, encoding="utf-8")
return str(readme_path)
def pack(skill_ref: str, include_audit: bool = True) -> str:
"""打包：将 SKILL 转为基因胶囊 JSON"""
"""打包：将 SKILL 转为基因胶囊 JSON，并生成导出说明文档（含流程图）"""
skill_path = _find_skill_path(skill_ref)
content = skill_path.read_text(encoding="utf-8")
rel_path = str(skill_path.relative_to(KARUO_AI_ROOT))
@@ -121,14 +263,16 @@ def pack(skill_ref: str, include_audit: bool = True) -> str:
}
if include_audit:
# 尝试从复盘目录读取最近一条（若有）
capsule["audit"] = {"last_retro": "", "source": "pack"}
EXPORT_DIR.mkdir(parents=True, exist_ok=True)
safe_name = manifest["name"].replace(" ", "_").replace("/", "_")[:30]
out_file = EXPORT_DIR / f"{safe_name}_{capsule_id[7:15]}.json"
out_file.write_text(json.dumps(capsule, ensure_ascii=False, indent=2), encoding="utf-8")
return str(out_file)
# 生成导出说明文档（含完整流程图）
readme_path = _write_export_readme()
return str(out_file) + "\n📄 说明文档: " + readme_path
def unpack(capsule_path: str, target_dir: str | None = None) -> str:
@@ -204,7 +348,10 @@ def main():
if args.cmd == "pack":
out = pack(args.skill, include_audit=not args.no_audit)
print(f"✅ 已打包: {out}")
parts = out.split("\n")
print(f"✅ 已打包: {parts[0]}")
if len(parts) > 1:
print(parts[1])
elif args.cmd == "unpack":
out = unpack(args.capsule, target_dir=args.output)
print(f"✅ 已解包: {out}")

1
BOOTSTRAP.md
View File

@@ -86,6 +86,7 @@
| **技能查找** | 用户说任何需求 | 查 SKILL_REGISTRY.md → 找到技能路径 → 读 SKILL.md 执行 |
| **复盘** | **所有对话强制（卡若AI 统一回复形式）** | 卡若AI 内**所有对话**的 AI 回复一律用复盘形式；每轮可带简版（🎯+▶），**最终回复必须以完整复盘块收尾**；复盘须带日期+时间、目标行≤30字、下一步关联项目目标；格式见 `运营中枢/参考资料/卡若复盘格式_固定规则.md`。不得省略、不得改格式。 |
| **沉淀** | 发现有价值的经验 | 写入 `02_卡人（水）/水溪_整理归档/经验库/待沉淀/` |
| **基因胶囊** | 打包技能、解包胶囊、继承能力 | 读 `05_卡土（土）/土砖_技能复制/基因胶囊/SKILL.md`；pack 时自动生成导出说明（含流程图） |
| **Gitea 同步** | 有文件变更时 | `bash 01_卡资（金）/金仓_存储备份/Gitea管理/脚本/自动同步.sh` |
| **跑 Pipeline** | 用户说「新项目上线」「内容发布」「日常运维」等 | 读 `运营中枢/参考资料/Pipeline执行清单.md` 按步骤执行 |
| **对外输出** | 报告、复盘存档、执行日志、导出文件、**生成图片** | 统一写到 `/Users/karuo/Documents/卡若Ai的文件夹/` 下对应子目录；**图片** → `图片/`，并在 `图片/图片索引.md` 登记来源 Skill、生成者。经验沉淀仍写 `02_卡人（水）/水溪_整理归档/经验库/待沉淀/`。详见 `运营中枢/参考资料/输出目录规范.md`。 |

1
运营中枢/参考资料/Pipeline执行清单.md
View File

@@ -26,6 +26,7 @@
| 5 | 火锤 | 代码修复 | `04_卡火（火）/火锤_代码修复/代码修复/SKILL.md` | 代码/报错 | 修复后代码 |
| 6 | 金仓 | 部署 | `01_卡资（金）/金仓_存储备份/服务器管理/SKILL.md` 或 `金盾/Vercel与v0部署流水线/SKILL.md` | 代码/仓库 | 线上地址 |
| 7 | 水溪 | 归档 | `02_卡人（水）/水溪_整理归档/对话归档/SKILL.md` + 执行日志 | 全过程 | 执行日志、归档记录 |
| 8 | 土砖 | 基因胶囊（可选） | `05_卡土（土）/土砖_技能复制/基因胶囊/SKILL.md` | 新建/更新的 Skill | 胶囊 JSON + 导出说明（含流程图） |
---

72
运营中枢/参考资料/基因胶囊功能流程图.md Normal file
View File

@@ -0,0 +1,72 @@
# 基因胶囊 · 功能流程图
> **版本**：1.0 | 更新：2026-02-22
> **导出时同步**：每次 pack 会在 `导出/基因胶囊/README_基因胶囊导出说明.md` 中生成含流程图的说明文档
---
## 流程图（Mermaid）
以下为基因胶囊在卡若AI 中的完整功能流程，包含内部流程、核心操作、技能工厂联动及未来对外流通。
```mermaid
flowchart TB
subgraph internal["卡若AI 内部流程"]
A1[用户需求/任务] --> A2{查 SKILL_REGISTRY}
A2 --> A3[读 SKILL.md 执行]
A3 --> A4[执行完成 + 复盘]
A4 --> A5{经验有价值?}
A5 -->|是| A6[写入经验库/待沉淀]
A5 -->|否| A7[结束]
A6 --> A8{要打包为胶囊?}
end
subgraph capsule["基因胶囊 核心流程"]
B1[pack: Skill 转 胶囊JSON] --> B2[导出目录 + 说明文档]
B2 --> B3[list: 查看本地胶囊]
B3 --> B4{需要继承?}
B4 -->|是| B5[unpack: 胶囊 转 Skill]
B4 -->|否| B6[保留备用]
B5 --> B7[写入对应成员目录]
B7 --> B8[更新 SKILL_REGISTRY]
end
subgraph factory["技能工厂联动"]
C1[创建 Skill 前] --> C2[list 查本地胶囊]
C2 --> C3{有匹配?}
C3 -->|是| C4[unpack 继承]
C3 -->|否| C5[新建 Skill]
C5 --> C6[创建 Skill 后]
C6 --> C7[pack 打包为胶囊]
C4 --> B7
end
subgraph external["未来对外流通"]
D1[EvoMap Market] --> D2[上传胶囊]
D2 --> D3[全球 Agent 继承]
D3 --> B5
B2 -.->|可选| D2
end
A8 -->|是| B1
A8 -->|否| A7
```
---
## 流程说明
| 区块 | 说明 |
|:---|:---|
| **卡若AI 内部流程** | 用户任务 → 查技能 → 执行 → 复盘 → 经验沉淀 → 可选打包为胶囊 |
| **基因胶囊 核心流程** | pack/unpack/list，导出时自动生成说明文档（含本流程图） |
| **技能工厂联动** | 创建前先查胶囊继承，创建后可打包为胶囊 |
| **未来对外流通** | 与 EvoMap Market 对接，实现跨 Agent 能力遗传 |
---
## 引用
- 规范：`运营中枢/参考资料/基因胶囊规范.md`
- 技能：`05_卡土（土）/土砖_技能复制/基因胶囊/SKILL.md`
- 导出说明：`卡若Ai的文件夹/导出/基因胶囊/README_基因胶囊导出说明.md`

34
运营中枢/参考资料/基因胶囊规范.md
View File

@@ -126,7 +126,39 @@ capsule_id = "sha256:" + SHA256(manifest.skill_path + skill_content 前 8192 字
---
## 七、引用
## 七、卡若AI 全流程改造（基因胶囊融入）
### 7.1 流程概览
```
用户任务 → 查 SKILL_REGISTRY → 读 SKILL 执行 → 复盘
↓
经验有价值 → 经验库/待沉淀 ──→ 可打包为胶囊
↓
创建 Skill 前 → list 查胶囊 → 有则 unpack 继承
创建 Skill 后 → pack 打包为胶囊
```
### 7.2 导出时产出
每次 `pack` 执行时自动生成：
- **胶囊 JSON**：`导出/基因胶囊/技能名_sha256前8位.json`
- **说明文档**：`导出/基因胶囊/README_基因胶囊导出说明.md`（含完整功能流程图）
### 7.3 流程图
完整流程图见 **`卡若Ai的文件夹/导出/基因胶囊/README_基因胶囊导出说明.md`**，包含：
- 卡若AI 内部流程（需求→执行→复盘→经验→打包）
- 基因胶囊核心流程（pack/unpack/list）
- 技能工厂联动（创建前查/创建后打包）
- 未来对外流通（EvoMap）
---
## 八、引用
- 战略分析：`卡若Ai的文件夹/报告/EvoMap与卡若AI结合战略分析_20260222.md`
- 技能：`05_卡土（土）/土砖_技能复制/基因胶囊/SKILL.md`
- 导出说明（含流程图）：`卡若Ai的文件夹/导出/基因胶囊/README_基因胶囊导出说明.md`

1
运营中枢/工作台/gitea_push_log.md
View File

@@ -76,3 +76,4 @@
| 2026-02-22 10:38:16 | 🔄 卡若AI 同步 2026-02-22 10:38 | 更新：卡土、总索引与入口、运营中枢参考资料、运营中枢工作台 | 排除 >20MB: 8 个 |
| 2026-02-22 10:43:14 | 🔄 卡若AI 同步 2026-02-22 10:43 | 更新：运营中枢工作台 | 排除 >20MB: 8 个 |
| 2026-02-22 10:48:02 | 🔄 卡若AI 同步 2026-02-22 10:48 | 更新：运营中枢工作台 | 排除 >20MB: 8 个 |
| 2026-02-22 10:50:57 | 🔄 卡若AI 同步 2026-02-22 10:50 | 更新：运营中枢工作台 | 排除 >20MB: 8 个 |

1
运营中枢/工作台/代码管理.md
View File

@@ -79,3 +79,4 @@
| 2026-02-22 10:38:16 | 成功 | 成功 | 🔄 卡若AI 同步 2026-02-22 10:38 | 更新：卡土、总索引与入口、运营中枢参考资料、运营中枢工作台 | 排除 >20MB: 8 个 | [仓库](http://open.quwanzhi.com:3000/fnvtk/karuo-ai) [百科](http://open.quwanzhi.com:3000/fnvtk/karuo-ai/wiki) |
| 2026-02-22 10:43:14 | 成功 | 成功 | 🔄 卡若AI 同步 2026-02-22 10:43 | 更新：运营中枢工作台 | 排除 >20MB: 8 个 | [仓库](http://open.quwanzhi.com:3000/fnvtk/karuo-ai) [百科](http://open.quwanzhi.com:3000/fnvtk/karuo-ai/wiki) |
| 2026-02-22 10:48:02 | 成功 | 成功 | 🔄 卡若AI 同步 2026-02-22 10:48 | 更新：运营中枢工作台 | 排除 >20MB: 8 个 | [仓库](http://open.quwanzhi.com:3000/fnvtk/karuo-ai) [百科](http://open.quwanzhi.com:3000/fnvtk/karuo-ai/wiki) |
| 2026-02-22 10:50:57 | 成功 | 成功 | 🔄 卡若AI 同步 2026-02-22 10:50 | 更新：运营中枢工作台 | 排除 >20MB: 8 个 | [仓库](http://open.quwanzhi.com:3000/fnvtk/karuo-ai) [百科](http://open.quwanzhi.com:3000/fnvtk/karuo-ai/wiki) |