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

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

Browse Source
This commit is contained in:
karuo
2026-02-22 10:38:14 +08:00
parent 824cef5d31
commit adf91a688b
8 changed files with 460 additions and 5 deletions
Download Patch File Download Diff File Expand all files Collapse all files

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

@@ -0,0 +1,85 @@
---
name: 基因胶囊
description: 将验证过的 Skill 打包为可遗传的能力单元（基因胶囊），支持 pack/unpack/list。触发词：基因胶囊、打包技能、解包胶囊、继承能力。
group: 土
triggers: 基因胶囊、打包技能、解包胶囊、继承能力、胶囊列表
owner: 土砖
version: "1.0"
updated: "2026-02-22"
---
# 基因胶囊
> **归属**：土砖（技能复制）
> **理念**：将 Skill + 环境指纹 + 审计记录打包成可遗传能力单元，支持本地复用与未来跨 Agent 流通。
---
## 一、概念
**基因胶囊** = 策略（SKILL） + 环境指纹 + 审计记录 + 资产 ID（SHA-256）
- 一个 Skill 学会 → 打包成胶囊 → 可被其他 Agent 或本机继承
- 规范见：`运营中枢/参考资料/基因胶囊规范.md`
---
## 二、使用方法
### 2.1 打包（Skill → 基因胶囊）
```bash
cd /Users/karuo/Documents/个人/卡若AI
python3 05_卡土（土）/土砖_技能复制/基因胶囊/脚本/gene_capsule.py pack "技能工厂"
# 或指定路径
python3 .../gene_capsule.py pack "05_卡土（土）/土砖_技能复制/技能工厂/SKILL.md"
```
- 输出目录：`/Users/karuo/Documents/卡若Ai的文件夹/导出/基因胶囊/`
- 文件名：`技能名_sha256前8位.json`
### 2.2 解包（基因胶囊 → Skill）
```bash
python3 .../gene_capsule.py unpack 技能工厂_abc12345.json
# 指定输出目录
python3 .../gene_capsule.py unpack 技能工厂_abc12345.json -o 02_卡人（水）/水溪_整理归档/
```
- 默认按胶囊内 `manifest.skill_path` 写回
- 可选 `-o` 指定目录，则写入该目录下的 `SKILL.md`
### 2.3 列表
```bash
python3 .../gene_capsule.py list
```
输出本地所有胶囊：名称、capsule_id、创建时间。
---
## 三、与技能工厂的联动
| 场景 | 操作 |
|:---|:---|
| **创建 Skill 前** | `list` 查看本地胶囊，有匹配则 `unpack` 继承 |
| **创建 Skill 后** | `pack` 将新 Skill 打包，供后续复用或未来上传 |
---
## 四、相关文件
| 文件 | 说明 |
|:---|:---|
| `运营中枢/参考资料/基因胶囊规范.md` | 概念与格式规范 |
| `脚本/gene_capsule.py` | pack/unpack/list 主脚本 |
| `capsule_index.json` | 继承胶囊索引（解包时更新） |
| `卡若Ai的文件夹/导出/基因胶囊/` | 导出目录 |
---
## 五、依赖
- Python 3.9+
- 可选：PyYAML（用于精确解析 frontmatter，无则用简单解析）

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

@@ -0,0 +1,219 @@
#!/usr/bin/env python3
# -*- coding: utf-8 -*-
"""
基因胶囊 · 打包/解包/列表
卡若AI 基因胶囊管理脚本，归属土砖。
"""
import argparse
import hashlib
import json
import os
import platform
import sys
from datetime import datetime
from pathlib import Path
# 卡若AI 工作台根目录
KARUO_AI_ROOT = Path(__file__).resolve().parent.parent.parent.parent.parent
EXPORT_DIR = Path("/Users/karuo/Documents/卡若Ai的文件夹/导出/基因胶囊")
CAPSULE_INDEX = Path(__file__).resolve().parent.parent / "capsule_index.json"
def _collect_env():
"""收集环境指纹（可选）"""
return {
"python_version": f"{sys.version_info.major}.{sys.version_info.minor}",
"platform": platform.system().lower(),
}
def _calc_capsule_id(skill_path: str, content: str) -> str:
"""计算资产 ID：SHA256(skill_path + content 前 8192 字符)"""
data = (skill_path + content[:8192]).encode("utf-8")
h = hashlib.sha256(data).hexdigest()
return f"sha256:{h}"
def _find_skill_path(name_or_path: str) -> Path:
"""根据技能名或路径找到 SKILL.md"""
if name_or_path.endswith("SKILL.md"):
p = KARUO_AI_ROOT / name_or_path
elif os.path.sep in name_or_path or name_or_path.startswith("0"):
# 形如 05_卡土/土砖_技能复制/技能工厂
p = KARUO_AI_ROOT / name_or_path
if p.is_dir():
p = p / "SKILL.md"
else:
# 按名称在 SKILL_REGISTRY 中查找（简化：扫描常见路径）
registry = KARUO_AI_ROOT / "SKILL_REGISTRY.md"
if registry.exists():
text = registry.read_text(encoding="utf-8")
# 简单匹配：找包含 name_or_path 的 SKILL 路径
for line in text.splitlines():
if "SKILL.md" in line and name_or_path in line:
# 提取路径，如 `05_卡土（土）/土砖_技能复制/技能工厂/SKILL.md`
start = line.find("`") + 1
end = line.rfind("`")
if start > 0 and end > start:
rel = line[start:end].strip()
p = KARUO_AI_ROOT / rel
if p.exists():
return p
raise FileNotFoundError(f"未找到技能: {name_or_path}")
if not p.exists():
raise FileNotFoundError(f"SKILL 不存在: {p}")
return p
def _parse_frontmatter(content: str) -> tuple:
"""解析 YAML frontmatter，返回 (frontmatter_dict, body)。无 PyYAML 时用简单解析。"""
if not content.strip().startswith("---"):
return {}, content
parts = content.split("---", 2)
if len(parts) < 3:
return {}, content
fm = {}
try:
import yaml
fm = yaml.safe_load(parts[1]) or {}
except Exception:
for line in parts[1].strip().splitlines():
if ":" in line:
k, v = line.split(":", 1)
k, v = k.strip(), v.strip().strip("'\"").strip()
if k == "triggers":
fm[k] = [x.strip() for x in v.replace("、", ",").split(",") if x.strip()]
else:
fm[k] = v
return fm, parts[2].strip()
def pack(skill_ref: str, include_audit: bool = True) -> str:
"""打包：将 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))
fm, body = _parse_frontmatter(content)
manifest = {
"name": fm.get("name", skill_path.stem),
"description": fm.get("description", ""),
"triggers": fm.get("triggers", [])
if isinstance(fm.get("triggers"), list)
else (fm.get("triggers", "") or "").split("、"),
"owner": fm.get("owner", ""),
"group": fm.get("group", ""),
"skill_path": rel_path,
}
capsule_id = _calc_capsule_id(rel_path, content)
now = datetime.now().strftime("%Y-%m-%dT%H:%M:%S+08:00")
capsule = {
"version": "1.0",
"capsule_id": capsule_id,
"manifest": manifest,
"skill_content": content,
"created_at": now,
"updated_at": now,
"environment": _collect_env(),
"source": "karuo-ai",
}
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)
def unpack(capsule_path: str, target_dir: str | None = None) -> str:
"""解包：将胶囊 JSON 解压为 SKILL.md"""
p = Path(capsule_path)
if not p.exists():
p = EXPORT_DIR / capsule_path
if not p.exists():
raise FileNotFoundError(f"胶囊不存在: {capsule_path}")
data = json.loads(p.read_text(encoding="utf-8"))
manifest = data.get("manifest", {})
skill_content = data.get("skill_content", "")
if target_dir:
dest = Path(target_dir)
else:
# 按 manifest.skill_path 写回
rel = manifest.get("skill_path", "")
dest = KARUO_AI_ROOT / Path(rel).parent
dest.mkdir(parents=True, exist_ok=True)
skill_file = dest / "SKILL.md"
skill_file.write_text(skill_content, encoding="utf-8")
# 更新 capsule_index
idx = {}
if CAPSULE_INDEX.exists():
idx = json.loads(CAPSULE_INDEX.read_text(encoding="utf-8"))
cid = data.get("capsule_id", "")[:19]
idx[cid] = {
"name": manifest.get("name", ""),
"source": data.get("source", "local"),
"unpacked_at": dest,
"created_at": data.get("created_at", ""),
}
CAPSULE_INDEX.write_text(json.dumps(idx, ensure_ascii=False, indent=2), encoding="utf-8")
return str(skill_file)
def list_capsules() -> list[dict]:
"""列表：扫描导出目录与索引"""
result = []
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", {})
result.append({
"file": f.name,
"name": m.get("name", ""),
"capsule_id": data.get("capsule_id", "")[:19],
"created_at": data.get("created_at", ""),
})
except Exception:
pass
return result
def main():
parser = argparse.ArgumentParser(description="基因胶囊 · pack/unpack/list")
sub = parser.add_subparsers(dest="cmd", required=True)
# pack
p_pack = sub.add_parser("pack", help="将 SKILL 打包为基因胶囊")
p_pack.add_argument("skill", help="技能路径或名称，如 技能工厂 或 05_卡土（土）/土砖_技能复制/技能工厂/SKILL.md")
p_pack.add_argument("--no-audit", action="store_true", help="不包含审计信息")
# unpack
p_unpack = sub.add_parser("unpack", help="将胶囊解包为 SKILL")
p_unpack.add_argument("capsule", help="胶囊文件路径或文件名")
p_unpack.add_argument("-o", "--output", help="输出目录，默认按 manifest.skill_path")
# list
p_list = sub.add_parser("list", help="列出本地胶囊")
args = parser.parse_args()
if args.cmd == "pack":
out = pack(args.skill, include_audit=not args.no_audit)
print(f"✅ 已打包: {out}")
elif args.cmd == "unpack":
out = unpack(args.capsule, target_dir=args.output)
print(f"✅ 已解包: {out}")
elif args.cmd == "list":
items = list_capsules()
for i in items:
print(f" {i['name']} {i['capsule_id']} {i['created_at']}")
print(f"共 {len(items)} 个胶囊")
if __name__ == "__main__":
main()

9
05_卡土（土）/土砖_技能复制/技能工厂/SKILL.md
View File

@@ -162,3 +162,12 @@ description: 飞书日程转周报。触发词：生成周报、飞书日程、
```
/Users/karuo/Documents/个人/卡若AI/.cursor/skills/
```
## 与基因胶囊联动
创建 Skill 前可先查本地胶囊，有则继承；创建后可将 Skill 打包为基因胶囊：
- **继承**：`python3 05_卡土（土）/土砖_技能复制/基因胶囊/脚本/gene_capsule.py list` → `unpack 胶囊文件`
- **打包**：`python3 .../gene_capsule.py pack "技能名"` → 输出到 `卡若Ai的文件夹/导出/基因胶囊/`
详见：`05_卡土（土）/土砖_技能复制/基因胶囊/SKILL.md`

7
SKILL_REGISTRY.md
View File

@@ -1,7 +1,7 @@
# 卡若AI 技能注册表（Skill Registry）
> **一张表查所有技能**。任何 AI 拿到这张表，就能按关键词找到对应技能的 SKILL.md 路径并执行。
> 47 技能 | 14 成员 | 5 负责人
> 48 技能 | 14 成员 | 5 负责人
> 版本：5.0 | 更新：2026-02-16
---
@@ -84,6 +84,7 @@
|:--|:---|:---|:---|:---|:---|
| E01 | 商业工具集 | 土基 | 商业分析、竞品 | `05_卡土（土）/土基_商业分析/商业工具集/SKILL.md` | 竞品分析、商业画布 |
| E02 | 技能工厂 | 土砖 | 创建技能、生成Skill | `05_卡土（土）/土砖_技能复制/技能工厂/SKILL.md` | 批量创建/复制 SKILL |
| E07 | 基因胶囊 | 土砖 | **基因胶囊、打包技能、解包胶囊、继承能力** | `05_卡土（土）/土砖_技能复制/基因胶囊/SKILL.md` | Skill 打包为可遗传胶囊，pack/unpack/list |
| E03 | 流量自动化 | 土渠 | 刷流量、SEO | `05_卡土（土）/土渠_流量招商/流量自动化/SKILL.md` | SEO、流量投放自动化 |
| E04 | 手机流量自动操作 | 土渠 | 手机自动化、AutoGLM | `05_卡土（土）/土渠_流量招商/手机与网页流量自动操作/SKILL.md` | 手机 App 自动化操作 |
| E05 | 财务管理 | 土簿 | 财务、报表、银行 | `05_卡土（土）/土簿_财务管理/财务管理/SKILL.md` | 收支记录、财务报表 |
@@ -114,5 +115,5 @@
| 水 | 卡人 | 3 | 10 |
| 木 | 卡木 | 3 | 6 |
| 火 | 卡火 | 4 | 13 |
| 土 | 卡土 | 4 | 6 |
| **合计** | **5** | **14** | **55** |
| 土 | 卡土 | 4 | 7 |
| **合计** | **5** | **14** | **56** |

11
运营中枢/参考资料/EvoMap与卡若AI结合概要.md
View File

@@ -24,6 +24,13 @@
3. **输入**（2–3 月）：技能工厂「先查 EvoMap」再创建
4. **深度**（3+ 月）：定期同步、声誉经济、GEP 节点
## 触发词（供 SKILL_REGISTRY 扩展）
## 触发词（已录入 SKILL_REGISTRY）
EvoMap、GEP、基因胶囊、经验遗传、Agent 进化
EvoMap、GEP、**基因胶囊**、打包技能、解包胶囊、继承能力、经验遗传、Agent 进化
## 已实现：基因胶囊（土砖）
卡若AI 已抽象并实现基因胶囊概念：
- 规范：`运营中枢/参考资料/基因胶囊规范.md`
- 技能：`05_卡土（土）/土砖_技能复制/基因胶囊/SKILL.md`
- 脚本：`gene_capsule.py` → pack / unpack / list

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

@@ -0,0 +1,132 @@
# 基因胶囊规范 · 卡若AI 抽象概念
> **版本**：1.0 | 更新：2026-02-22
> **归属**：土砖（技能复制）
> **理念来源**：EvoMap GEP 协议，适配卡若AI 本地与未来流通
---
## 一、概念定义
**基因胶囊**（Gene Capsule）是卡若AI 对「可遗传能力单元」的抽象：将验证过的 Skill + 执行环境 + 审计记录打包成不可篡改的资产，支持本地复用与未来跨 Agent 流通。
```
基因胶囊 = 策略（SKILL） + 环境指纹 + 审计记录 + 资产 ID
```
| 层 | 含义 |
|:---|:---|
| **策略** | SKILL.md 完整内容，含触发词、步骤、脚本路径 |
| **环境指纹** | Python 版本、平台、依赖（便于继承时校验） |
| **审计记录** | 最近一次复盘的「目标·结果·达成率」或执行摘要 |
| **资产 ID** | 对策略内容做 SHA-256，用于去重与溯源 |
---
## 二、胶囊格式（JSON）
### 2.1 必填字段
```json
{
"version": "1.0",
"capsule_id": "sha256:abc123...",
"manifest": {
"name": "技能名称",
"description": "一句话描述",
"triggers": ["触发词1", "触发词2"],
"owner": "土砖",
"group": "土",
"skill_path": "05_卡土（土）/土砖_技能复制/技能工厂/SKILL.md"
},
"skill_content": "---\nname: ...\n---\n\n# 技能名\n\n...",
"created_at": "2026-02-22T21:30:00+08:00",
"updated_at": "2026-02-22T21:30:00+08:00"
}
```
### 2.2 可选字段
```json
{
"environment": {
"python_version": "3.11",
"platform": "darwin",
"dependencies": ["requests", "beautifulsoup4"]
},
"audit": {
"last_retro": "目标·结果·达成率 ≤30字",
"success_rate": "100%",
"execution_count": 3
},
"source": "karuo-ai",
"tags": ["文档", "自动化"]
}
```
### 2.3 资产 ID 计算规则
```
capsule_id = "sha256:" + SHA256(manifest.skill_path + skill_content 前 8192 字符)
```
保证内容变动则 ID 变动，便于去重与版本追溯。
---
## 三、存储与流通
| 用途 | 存放位置 |
|:---|:---|
| **本地导出的胶囊** | `/Users/karuo/Documents/卡若Ai的文件夹/导出/基因胶囊/` |
| **继承的胶囊（解包后）** | 按 SKILL 归属写入对应 `01～05` 成员目录 |
| **胶囊索引** | `05_卡土（土）/土砖_技能复制/基因胶囊/capsule_index.json` |
---
## 四、与 SKILL 的映射
| SKILL 元素 | 基因胶囊字段 |
|:---|:---|
| frontmatter（name/description/triggers/owner/group） | manifest |
| 正文 Markdown | skill_content |
| 脚本目录 scripts/ | 打包时一并纳入（可选，或仅记录路径） |
| 复盘块 | audit.last_retro |
---
## 五、操作流程
### 5.1 打包（pack）
1. 指定 SKILL 路径或技能名
2. 读取 SKILL.md，解析 frontmatter
3. 收集环境信息（可选）
4. 若存在最近复盘，写入 audit
5. 计算 capsule_id，输出 JSON 到导出目录
### 5.2 解包（unpack）
1. 读取胶囊 JSON
2. 按 manifest.skill_path 或用户指定路径写入 SKILL.md
3. 若有 scripts 等附加文件，按需创建目录
4. 更新 capsule_index.json（若为继承的胶囊）
### 5.3 列表（list）
1. 扫描导出目录 + capsule_index
2. 输出：胶囊名、capsule_id 前 12 位、创建时间、来源
---
## 六、与技能工厂的联动
- **创建 Skill 前**：可先 `list` 本地胶囊，若有匹配则 `unpack` 继承
- **创建 Skill 后**：可 `pack` 将新 Skill 打包为胶囊，供后续复用或未来上传
---
## 七、引用
- 战略分析：`卡若Ai的文件夹/报告/EvoMap与卡若AI结合战略分析_20260222.md`
- 技能：`05_卡土（土）/土砖_技能复制/基因胶囊/SKILL.md`

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

@@ -72,3 +72,4 @@
| 2026-02-22 10:28:14 | 🔄 卡若AI 同步 2026-02-22 10:28 | 更新：金仓、运营中枢工作台 | 排除 >20MB: 8 个 |
| 2026-02-22 10:35:52 | 🔄 卡若AI 同步 2026-02-22 10:35 | 更新：金仓、水溪整理归档、卡土、总索引与入口、运营中枢参考资料、运营中枢工作台、运营中枢 | 排除 >20MB: 8 个 |
| 2026-02-22 10:37:28 | 🔄 卡若AI 同步 2026-02-22 10:37 | 更新：金仓、水溪整理归档、卡土、总索引与入口、运营中枢参考资料、运营中枢工作台、运营中枢 | 排除 >20MB: 8 个 |
| 2026-02-22 10:37:37 | 🔄 卡若AI 同步 2026-02-22 10:37 | 更新：金仓、运营中枢工作台 | 排除 >20MB: 8 个 |

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

@@ -75,3 +75,4 @@
| 2026-02-22 10:28:14 | 成功 | 成功 | 🔄 卡若AI 同步 2026-02-22 10:28 | 更新：金仓、运营中枢工作台 | 排除 >20MB: 8 个 | [仓库](http://open.quwanzhi.com:3000/fnvtk/karuo-ai) [百科](http://open.quwanzhi.com:3000/fnvtk/karuo-ai/wiki) |
| 2026-02-22 10:35:52 | 成功 | 成功 | 🔄 卡若AI 同步 2026-02-22 10:35 | 更新：金仓、水溪整理归档、卡土、总索引与入口、运营中枢参考资料、运营中枢工作台、运营中枢 | 排除 >20MB: 8 个 | [仓库](http://open.quwanzhi.com:3000/fnvtk/karuo-ai) [百科](http://open.quwanzhi.com:3000/fnvtk/karuo-ai/wiki) |
| 2026-02-22 10:37:28 | 成功 | 成功 | 🔄 卡若AI 同步 2026-02-22 10:37 | 更新：金仓、水溪整理归档、卡土、总索引与入口、运营中枢参考资料、运营中枢工作台、运营中枢 | 排除 >20MB: 8 个 | [仓库](http://open.quwanzhi.com:3000/fnvtk/karuo-ai) [百科](http://open.quwanzhi.com:3000/fnvtk/karuo-ai/wiki) |
| 2026-02-22 10:37:37 | 成功 | 成功 | 🔄 卡若AI 同步 2026-02-22 10:37 | 更新：金仓、运营中枢工作台 | 排除 >20MB: 8 个 | [仓库](http://open.quwanzhi.com:3000/fnvtk/karuo-ai) [百科](http://open.quwanzhi.com:3000/fnvtk/karuo-ai/wiki) |