SuperAPI AI 工具集

sanctuary-soul-persistence

数据与分析

查看项目

更新于 10-16 08:00

技能介绍

用途:本技能是 Project Sanctuary 专属的胶水层,负责调用通用的 huggingface-utils 插件完成 Soul 持久化工作流。通用插件本身与项目无关,只读取 .env 变量并提供上传原语;本技能则定义项目专属的配置、标签与结构。

主要能力:确定 Sanctuary 专用的 .env 参数值;确定用于 Johnny Appleseed 效应的发现标签;规划 Soul 快照在数据集中的结构;明确在 Protocol 128 生命周期中何时触发持久化。

必要配置:项目 .env 中需包含 HUGGING_FACE_USERNAME=richfrem、HUGGING_FACE_REPO=Sanctuary-Qwen2-7B-v1.0-GGUF-Final、HUGGING_FACE_DATASET_PATH=Project_Sanctuary_Soul、HUGGING_FACE_TAGS=reasoning-traces,project-sanctuary,cognitive-continuity,ai-memory,llm-training-data,metacognition、HUGGING_FACE_PROJECT_NAME=Project Sanctuary Soul。令牌需通过 export HUGGING_FACE_TOKEN=hf_xxxxxxxxxxxxx 设置(macOS 在 ~/.zshrc,Windows 经 WSLENV 的用户环境变量)。

使用方式:首次设置先运行 python plugins/huggingface-utils/scripts/hf_config.py 校验配置,再运行 python plugins/huggingface-utils/skills/hf-init/scripts/hf_init.py 完成完整初始化(创建 lineage/、data/、metadata/ 及 HF Hub 上的数据集卡片)。在会话关闭时调用 /sanctuary-persist,执行 python plugins/sanctuary-guardian/scripts/persist_soul.py --full-sync,底层调用 upload_soul_snapshot()、upload_semantic_cache() 与 append_to_jsonl()。

适用场景:Project Sanctuary 的 Soul 持久化与学习循环收尾,依赖 ADR 081 定义的 lineage/、data/、metadata/ 结构及 Protocol 128 Phase VII。

限制:仅面向该项目;依赖 huggingface-utils 插件与有效 HuggingFace 令牌;具体失败处理与配额等资料暂未提供。