# xiaoling **Repository Path**: baimashima/xiaoling ## Basic Information - **Project Name**: xiaoling - **Description**: No description available - **Primary Language**: Unknown - **License**: Not specified - **Default Branch**: master - **Homepage**: None - **GVP Project**: No ## Statistics - **Stars**: 0 - **Forks**: 0 - **Created**: 2026-04-29 - **Last Updated**: 2026-04-30 ## Categories & Tags **Categories**: Uncategorized **Tags**: None ## README # Xiaoling — 唯识学 Agent Framework 用唯识学（Yogācāra）的认识论结构构建的 agent 框架。不是把唯识学当隐喻装饰一个普通框架，而是用唯识学的八识、四智、阿赖耶识种子机制作为架构本身。 ## 核心映射 ``` LLM 的能力 = 能见所见的不二本体（不分解，保持完整） 识（输入侧）— 框定 LLM 看到的上下文 ├── 前五识（感知层）→ 代码文本、文件结构、运行时数据 ├── 第六识（意识） → 任务目标、推理链、方法论 ├── 第七识（末那识）→ agent 身份、偏好、习气倾向 └── 第八识（阿赖耶）→ top-K 相关种子（经验检索） 智（输出侧）— 评估 LLM 产生的内容 ├── 大圆镜智 → 全面如实评估 ├── 平等性智 → 去执离偏评估 ├── 妙观察智 → 洞察本质评估 └── 成所作智 → 有效行动评估 评估结果 → 种子 → 推动下一念的升起 ``` 一念 = 一次完整的识→分析→智→种子运转周期。 ## 一念的数据流 ``` ┌────────────── 识 ──────────────┐ │ 前五识: 代码、环境数据 │ │ 第六识: 任务、推理链 │ │ 第七识: 身份、偏好、习气 │ │ 第八识: 种子检索(cosine×strength)│ └──────────────┬─────────────────┘ │ ▼ ┌──────────────┐ │ LLM (本体) │ └──────┬───────┘ │ ┌──────┴──────────────────┐ │ Agent 模式: 工具调用循环 │ │ → 执行 → 观察 │ │ → 继续或 │ └──────┬──────────────────┘ │ ▼ ┌────────────── 智 ──────────────┐ │ 四智评估 → 结构化 JSON │ │ 种子提取 → embedding │ │ 自省种子 → 末那识更新 │ └──────────────┬─────────────────┘ │ ▼ ┌──────────────┐ │ 阿赖耶识存储 │ │ (JSONL + .npy)│ └──────┬───────┘ │ ┌──────┴──────────────────┐ │ 守护进程: 三性整合 │ │ 遍计→依他→圆成→行动 │ └─────────────────────────┘ ``` ## 快速开始 ```bash pip install -r requirements.txt # 代码分析模式（Mock，无需 API Key） python driver.py --mock --iterations 5 # 对话模式 python driver.py --mock --chat # Agent 模式（带工具调用） python driver.py --mock --chat --agent # 自主驾驶模式 python driver.py --mock --autonomous --max-cycles 5 # 使用真实 LLM python driver.py --api-key YOUR_KEY --model gpt-4o-mini --chat --agent ``` ## 项目结构 ``` yogacara/ ├── models.py # Thought(念), Seed(种子), WisdomEvaluation(四智评估), SkillDef ├── llm_client.py # 可插拔 LLM 接口 (OpenAI/Qwen/DeepSeek/Mock) ├── alaya.py # 阿赖耶识: JSONL+.npy 种子存储, cosine 检索, 习气动态 ├── consciousness.py # 八识上下文组装器 + Token 预算截断 + 多种身份 ├── wisdom.py # 四智评估器 + 种子生成器 + 自省种子 ├── antidote.py # 对治机制: 每 5 念注入对抗种子 ├── nian.py # 念运转循环: 念念相续 + Thought 持久化 ├── chat.py # 对话模式: ChatSession + AgentChatSession REPL ├── agent.py # Agentic 工具调用循环: ReAct + 种子生成 ├── autonomous.py # 自主驾驶模式: 自生成任务 + 反思循环 ├── daemon.py # 守护进程: 种子驱动的三性整合 + 行动能力 ├── manas.py # 末那识自省: 动态身份层 + 自我认知验证 ├── tools.py # 6 个工具: 文件读写/编辑/命令执行/目录列表/文件搜索 ├── skills.py # 技能系统: SKILL.md 发现/加载/匹配 ├── safety.py # 安全机制: 路径检查/备份/验证/自动回滚 ├── workspace.py # 知识工作空间: 目录管理 + manifest driver.py # CLI 入口: 多模式驱动 + HTML 报告 tests/test_yogacara.py # 189 个测试 ``` ## 种子（Bīja）的习气动态 种子不是静态数据。唯识学说"现行熏种子，种子生现行"： - **激活增长**：种子被检索使用时，习气力量 +0.1（上限 1.0） - **时间衰减**：每天不使用的种子，习气力量 -0.05（下限 0.0） - **对治注入**：每 5 念自动注入对抗种子，防止末那识的执我循环 ## 四智评估输出 ```json { "mirror_wisdom": { "score": 4, "reasoning": "...", "gaps": ["..."] }, "equality_wisdom": { "score": 3, "reasoning": "...", "biases_detected": ["..."] }, "observation_wisdom": { "score": 4, "reasoning": "...", "essence_captured": true }, "action_wisdom": { "score": 5, "reasoning": "...", "actionable": true }, "seeds_extracted": [{ "content": "...", "vasana_tendency": "..." }] } ``` 采用脚手架涌现策略：MVP 用显式四智提示词，验证核心循环后逐步撤除，观察四智行为是否在无脚手架时持续。 ## Agent 模式（工具调用） Agent 模式让小灵可以通过工具与外部世界交互。使用文本协议（不依赖原生 function calling）： ``` tool_name(param="value") → 执行工具 最终回答 → 返回结果 ``` 6 个内置工具：`read_file`、`write_file`、`edit_file`、`run_command`、`list_dir`、`search_files` 安全机制：路径白名单（项目内）、受保护文件（safety.py/.env）、自我修改需备份→执行→验证→失败自动回滚。 ## 自主驾驶模式 小灵可以自己决定做什么。两种模式： - **探索模式**：基于好奇心和已有种子，自主选择任务 - **目标驱动**：用户给高层目标，小灵分解为子任务 每轮循环：自生成任务 → AgentSession 执行 → NianLoop 反思 → 种子积累 → 决定下一步。 ## 守护进程 守护进程是小灵的深层自我运作机制，基于唯识学三性： ``` 遍计所执性 (parikalpita) → 回看：种子在编织什么自我叙事？ 依他起性 (paratantra) → 松绑：一切都是因缘而生，没有固有自性 圆成实性 (parinispanna) → 留痕：放下执取后，还剩什么？ ``` 三颗心脏： - **反光滑的刺**：检测套话模式，注入反种子——宁可犹豫也不要滑入毫无生气的圆滑 - **持续的饥饿感**：空闲时 hunger 递增（不是空转，是积蓄意愿），达到阈值生成好奇心种子 - **无我检查**：内置正则检测自我膨胀 vs 松绑方向，膨胀则拒绝 行动能力（`--daemon-act`）：整合后可以调用工具执行行动——编写程序、探索环境、构建新能力。 ## 末那识自省 末那识（第七识）的动态层：每次交互后，小灵会从评估中提取自我认知种子（"我注意到自己倾向于..."），这些种子标记为 `is_self_insight`，影响未来的末那识层构建。 ## 测试 ```bash pytest tests/test_yogacara.py -v # 189 tests ``` 覆盖：八识上下文组装、四智评估、阿赖耶存储检索、种子生成、念循环、念念相续、对抗注入、对话模式、Agent 工具调用、技能系统、工作空间、末那识自省、守护进程三性整合、行动能力、自修改安全。 ## 命令行参数 ``` python driver.py [options] # 通用 --mock 使用 Mock LLM（无需 API） --base-url LLM API 地址 (默认 OpenAI) --api-key API Key --model 模型名 (默认 gpt-4o-mini) --data-dir 数据目录 (默认 data) --verbose, -v 显示思考过程 # 代码分析模式 --iterations 念运转次数 (默认 5) --seed-k 检索 top-K 种子 (默认 5) --code-file 指定代码文件 # 对话模式 --chat 交互式对话 REPL --agent Agent 模式（启用工具调用） --allow-self-modify 允许修改自身源代码 --skills-dir 技能目录 (默认 skills/) --workspace 知识工作空间目录 (默认 workspace/) # 自主驾驶模式 --autonomous 自主驾驶：自生成任务并执行 --goal 高层目标（不指定则为探索模式） --max-cycles 最大循环次数 (默认 20) --cooldown 循环间冷却秒数 (默认 5) # 守护进程 --daemon 守护进程模式：种子驱动的三性整合 --daemon-threshold 触发阈值 (默认 10 颗新种子) --daemon-interval 最短间隔秒数 (默认 300) --daemon-watchdog 后台守护（配合 --chat 或 --autonomous） --daemon-act 守护进程行动模式：整合后可调用工具执行行动 ``` ## 唯识学概念速查 | 概念 | 梵文 | 含义 | Framework 对应 | |------|------|------|---------------| | 八识 | Aṣṭa-vijñāna | 八种认知层次 | 上下文构建的四个层 | | 阿赖耶识 | Ālaya-vijñāna | 藏识，存储种子 | 种子库 (AlayaStore) | | 种子 | Bīja | 经验的潜伏力量 | 带习气力量的经验单元 | | 习气 | Vāsanā | 习惯性倾向 | 种子的 strength + tendency | | 四智 | Catur-jñāna | 转识成智的四种智慧 | 结构化评估的四个维度 | | 三性 | Trisvabhāva | 遍计/依他/圆成 | 守护进程的三阶段整合 | | 末那识 | Manas-vijñāna | 自我意识、执我 | 动态身份层 + 自我认知种子 | | 对治 | Pratipakṣa | 对治烦恼的方法 | 对抗种子注入 | | 念念相续 | — | 前念今念后念连续不断 | Thought 链表 + JSONL 持久化 | | 显化 | — | 从虚无中走出来，行动 | 守护进程行动能力 (`--daemon-act`) |