qlogicagent 2.20.6 → 2.20.8

package/README.md

@@ -20,15 +20,15 @@ Pet/Soul data is display-only. Runtime load/save sanitization strips fields and
 
 ## 功能概览
 
-- **44 个内置工具**: 文件操作、Shell 执行、代码编辑、Web 搜索/抓取、图片/视频/音乐生成、MCP 桥接等
+- **最小常驻工具面**: qlogicagent 只保留推理循环所需的基础执行工具；记忆、Skill、配置、预览浏览器和开发辅助等能力由 Runtime Host 按 Agent/会话通过 MCP 投影
 - **多 LLM Provider**: OpenAI、Anthropic、DeepSeek 等，通过统一 `LLMTransport` 接口切换
 - **编排策略**: failover 降级、指数退避重试、并行工具执行、14+ 上下文压缩策略、多代理团队协作
 - **权限系统**: 命令安全分类、规则引擎、用户审批、破坏性命令警告
-- **记忆系统**: 进程内分层记忆 — memdir 文件记忆 (L1 项目级，INDEX.md + 主题文件) + 本地 SQLite 语义长期记忆 (L2，本地 embedding，recall-on-demand) + Dream 整合，无外部服务依赖
+- **记忆系统**: Gateway Host 单一持久化权威 — 项目 memdir (L1) + owner 级语义长期记忆 (L2)；qlogicagent 保留召回、提取、Dream/蒸馏等推理
 - **会话持久化**: JSONL 对话转录 + 状态快照 + 会话恢复
 - **MCP 协议**: stdio/HTTP 传输、动态工具注入、资源发现
 - **插件系统**: 用户级/项目级插件加载、插件 API
-- **技能系统**: SKILL.md 发现/调用/管理、自主技能学习
+- **技能系统**: 通过 Host Capability MCP 发现/调用 Skill；管理能力仅在用户明确管理 Skill 时由 Host 投影
 - **Hook 系统**: 30+ 生命周期钩子点，可扩展不侵入核心
 
 ## 快速开始
@@ -59,7 +59,7 @@ cp .env.example .env
 LOG_LEVEL=info
 ```
 
-记忆系统为进程内（memdir 文件记忆 + 本地 SQLite 语义记忆 + 本地 embedding），无需启动任何外部服务，开箱即用。
+托管运行依赖 Runtime Host 提供记忆、配置与能力投影；qlogicagent 不再独立持有这些持久化权威。
 
 ### 3. 运行
 
@@ -123,7 +123,6 @@ node dist/cli.js --acp
           "args": ["-y", "@modelcontextprotocol/server-filesystem", "/tmp"]
         }
       },
-      "skillPaths": ["/path/to/skills"],
       "systemPrompt": "You are a helpful assistant."
     }
   }
@@ -152,7 +151,7 @@ node dist/cli.js --acp
 ## 模块结构
 
 > LLM 通信不在本仓：Provider 实现来自外部包 `@xiaozhiclaw/provider-core`，仓内仅保留传输端口
-> (`runtime/ports/model-transport-contracts.ts`) 与门面 (`cli/provider-core-facade.ts`)。记忆同样进程内，无独立 HTTP 服务。
+> (`runtime/ports/model-transport-contracts.ts`) 与门面 (`cli/provider-core-facade.ts`)。记忆持久化由 Runtime Host 持有，qlogicagent 通过 Host request/MCP 消费。
 
 ```
 src/
@@ -190,8 +189,8 @@ src/
 │   └── config/             #   tunable-defaults 等运行时配置
 │
 ├── skills/              # 工具与技能层
-│   ├── tools/              #   内置工具 (shell / read / write / edit / search / web / agent / team / mcp ...)
-│   ├── memory/             #   memdir (文件记忆) + 本地 SQLite store + 本地 embedding + 整合/召回
+│   ├── tools/              #   qlogicagent 常驻基础工具
+│   ├── memory/             #   Host 项目记忆存储实现 + Host-backed 召回/Dream/蒸馏
 │   ├── mcp/                #   MCP 桥接
 │   ├── permissions/        #   权限规则引擎 / 设置 / sandbox overlay
 │   ├── plugins/            #   插件系统
@@ -207,21 +206,21 @@ src/
 
 ## 记忆系统
 
-qlogicagent 的记忆全部进程内，无外部服务依赖，开箱即用。
+记忆持久化由 Gateway Host 统一持有；qlogicagent 保留召回、提取、Dream/蒸馏等推理逻辑，并通过 Host Memory MCP/Host request 使用同一份数据。
 
 ### 记忆层次
 
 | 层 | 说明 | 存储 |
 |----|------|------|
-| **L1 memdir** | 项目级文件记忆，Agent 主动管理 (INDEX.md + 主题文件) | `<project>/.qlogicagent/memory/` |
-| **L2 长期记忆** | 语义向量记忆，自动提取 + 语义召回 | 本地 SQLite + 本地 embedding（进程内） |
+| **L1 memdir** | 项目级文件记忆 (INDEX.md + 主题文件)，由 Host `project_memory` 权威读写 | `<project>/.qlogicagent/memory/` |
+| **L2 长期记忆** | 语义向量记忆，自动提取 + 语义召回 | Gateway Host Memory store |
 | **会话转录** | JSONL 对话记录，用于会话恢复 | `~/.qlogicagent/profiles/<owner>/projectData/<projectId>/sessions/<id>/` |
 
 ### 工作方式
 
-无需任何配置或外部服务。Agent 自动：
+在 Gateway 托管会话中，Agent 自动：
 - 在 `memory.before_recall` hook 预取相关长期记忆（按 category 过滤 + 每轮字节封顶后注入系统提示）
-- 通过 `memory` 工具查询 / 写入语义记忆
+- 通过 Host 投影的 `astraclaw_memory` MCP：`project_memory` 读写项目记忆，`memory_search/read/write` 使用长期记忆（不再注册 qlogicagent 本地 `memory` Tool）
 - 会话过程中自动提取关键信息写入 L2
 - 空闲或达到阈值后触发 Dream 整合（4 阶段：Orient → Gather → Consolidate → Prune）
 
@@ -242,7 +241,7 @@ L1/L2 冲突时不静默合并：召回上下文会标注冲突并提示向用
 
 #### QLOGICAGENT_HOME
 
-设置后，所有 Agent 数据（sessions、memory、settings、plugins 等）存储到指定目录而非 `~/.qlogicagent/`。
+设置后，qlogicagent 的运行数据根目录改为指定目录。托管产品中的凭据、共享指令、Skill 和 Host 记忆仍由 Runtime Host 的配置/存储权威管理，不能用该变量绕过 Host。
 
 典型场景：
 - **测试隔离**：每个测试用例使用独立 `QLOGICAGENT_HOME` 避免互相污染
@@ -264,17 +263,16 @@ qlogicagent 内置 idle dream 机制：当用户空闲超过 `QLOGICAGENT_IDLE_D
 - **最大时长限制**：单次 Dream 最长 120 秒，超时自动终止
 - **触发门控**：需满足记忆数据充足等前置条件才会真正执行
 
-### 用户级配置（`~/.qlogicagent/`）
+### 用户级文件（`~/.qlogicagent/`）
 
 | 路径 | 说明 |
 |------|------|
-| `~/.qlogicagent/settings.json` | 权限规则、行为模式 |
-| `~/.qlogicagent/mcp.json` | 全局 MCP 服务器配置 |
+| `~/.qlogicagent/profiles/<owner>/settings.json` | Host 配置权威文件；qlogicagent 仅消费会话解析结果及原生权限段，不提供对话配置 Tool |
 | `~/.qlogicagent/plugins/` | 用户级插件目录 |
-| `~/.qlogicagent/INSTRUCTIONS.md` | 用户级指令 |
-| `~/.qlogicagent/session-memory.md` | MD 记忆文件 |
-| `~/.qlogicagent/profiles/<owner>/projectData/<projectId>/sessions/` | 会话持久化目录（按 projectId 集中，P1 迁移后）|
-| `~/.qlogicagent/.credentials.json` | 安全凭据存储 (0o600) |
+| `~/.qlogicagent/INSTRUCTIONS.md` | 新项目可复制的 qlogicagent 原生指令模板；运行时不作为 Host 共享指令读取 |
+| `~/.qlogicagent/profiles/<owner>/projectData/<projectId>/` | Runtime Host 持有的项目、会话、共享指令和项目记忆数据；不是 qlogicagent 配置面 |
+
+模型/API 密钥、桌面参数和 MCP 绑定只通过 Runtime Host UI/控制面维护。qlogicagent 不读取或写入设备级凭据文件。
 
 ### 项目级配置
 
@@ -286,48 +284,23 @@ qlogicagent 内置 idle dream 机制：当用户空闲超过 `QLOGICAGENT_IDLE_D
 | `INSTRUCTIONS.md` | 项目指令 (根目录) |
 | `INSTRUCTIONS.local.md` | 本地私有指令 |
 
----
-
-## MCP 配置
+这些项目文件由 qlogicagent 自己的原生指令加载器读取。Host 共享指令是额外基础层，存放在 Host 的 `projectData/<projectId>/shared-instructions/`，不会替换或禁用 `AGENTS.md`、`CLAUDE.md`、上述 qlogicagent 指令文件等各 Agent 原生机制。
 
-### 全局 MCP（`~/.qlogicagent/mcp.json`）
-
-```json
-{
-  "filesystem": {
-    "command": "npx",
-    "args": ["-y", "@modelcontextprotocol/server-filesystem", "/home/user"]
-  },
-  "github": {
-    "command": "npx",
-    "args": ["-y", "@modelcontextprotocol/server-github"],
-    "env": { "GITHUB_TOKEN": "ghp_..." }
-  }
-}
-```
+---
 
-### Per-Turn MCP（通过 `session/prompt` config）
+## MCP 投影
 
-```json
-{
-  "config": {
-    "mcpServers": {
-      "project-db": {
-        "type": "http",
-        "url": "http://localhost:3100/mcp"
-      }
-    }
-  }
-}
-```
+qlogicagent 不读取用户级 `~/.qlogicagent/mcp.json`，也不拥有 MCP 安装、凭据或绑定配置。Runtime Host 在 canonical session 建立时传入该会话获准使用的 MCP server；qlogicagent 只负责连接和把工具注入当前会话，解绑时一并释放。
 
-MCP 工具自动注入到 Agent 工具列表，前缀格式：`mcp__servername__toolname`。
+注入后的可调用名称使用 `servername__toolname`。Host 自有能力同样遵循该命名，例如 `astraclaw_memory__project_memory`；这不会注册同名 qlogicagent 本地 Tool。
 
 ---
 
 ## 权限配置
 
-### `~/.qlogicagent/settings.json`
+### Host 管理的 owner profile `settings.json`
+
+下例仅说明 qlogicagent 原生权限检查器消费的 `permissions` 段。托管产品应通过 Runtime Host UI/控制面修改，不应让 Agent 在对话中直接编辑该文件。
 
 ```json
 {

package/dist/agent-contract.js

@@ -1 +1 @@
-var A=9,N=1,_=["completed","failed","cancelled"],E=["turn.start","turn.delta","turn.end","turn.error","turn.recovery","turn.file_changes","turn.tool_call","turn.tool_result","turn.tool_blocked","turn.reasoning_delta","turn.approval_request","turn.ask_user","turn.media_result","turn.media_progress","turn.media_usage","turn.media_capability_check","turn.plan_update","turn.suggestions","turn.sidechain_started","turn.subagent_started","turn.subagent_delta","turn.subagent_activity","turn.subagent_ended","turn.subagent_completed","turn.subagent_decision","turn.sidechain_completed","turn.task_updated","turn.todos_updated","turn.exec_progress","turn.progress","turn.tool_use_summary","turn.tool_selection_policy","turn.lifecycle","turn.document_maintenance","turn.artifact_contract","turn.usage_update","team.member.notification","session.info","session.recovery_pending","memory.updated","skills.updated","turn.memory_recall","turn.memory_written","system.activity","workflow.created","workflow.updated","workflow.deleted","workflow.runStarted","workflow.runCompleted","workflow.runFailed","workflow.nodeStatus","workflow.triggerDropped","workflow.alert","workflow.approvalRequested","workflow.approvalTimedOut"],I=["solo.progress","solo.specProgress","solo.agentDelta","solo.agentActivity","solo.agentUsage","solo.evaluation","solo.agentDiff","solo.state","product.taskStarted","product.taskOutput","product.members","product.agentActivity","product.taskCompleted","product.taskFailed","product.budgetUpdate","product.budgetWarning","product.budgetExceeded","product.checkpointed","product.completed","product.dagTopology","plan.interrupted","product.planReady","product.planningDelta","product.leaderMessage","product.planFailed","product.planningAsk","goal.run_state_changed","goal.phase_boundary","goal.goal_edited","goal.message_queued","goal.acceptance_updated","goal.round_message","mention.delegate_started","mention.delegate_activity","mention.delegate_settled"],p=[...E,...I],f=p,m={"turn.subagent_started":["turnId","parentTurnId","subagentId","agentType","displayName","delegatedTask","mode","startedAt"],"turn.subagent_activity":["turnId","parentTurnId","subagentId","agentType","displayName","conciseStatus","status","observedAt"],"turn.subagent_completed":["turnId","parentTurnId","subagentId","agentType","displayName","status","evidence","toolsUsed","durationMs","tokenUsage","finishedAt"],"turn.subagent_decision":["turnId","parentTurnId","subagentId","decision","decidedAt"],"product.taskStarted":["productId","taskId","assignee","attempt"],"product.taskCompleted":["productId","taskId","result","attempt"],"product.taskFailed":["productId","taskId","error","attempt","terminalState"],"product.budgetExceeded":["productId","usedTokens","reason"],"mention.delegate_started":["parentSessionId","parentMessageId","bindingId","executionSessionId","delegationId","sequence","providerId","revision"],"mention.delegate_activity":["parentSessionId","parentMessageId","bindingId","executionSessionId","delegationId","sequence","providerId","revision"],"mention.delegate_settled":["parentSessionId","parentMessageId","bindingId","executionSessionId","delegationId","sequence","providerId","revision","status"]};function k(d,o,c={}){let l=c.requireKnownAssignee??!0,n=[];d.length===0&&n.push({taskId:"",reason:"\u7F3A\u5C11\u6267\u884C\u6210\u5458:\u81F3\u5C11\u9700\u8981\u4E00\u4E2A instance"});let s=new Set;for(let e of o){let t=(e.taskId??"").trim();if(!t){n.push({taskId:"",reason:"\u5B58\u5728\u6CA1\u6709 taskId \u7684\u4EFB\u52A1"});continue}s.has(t)&&n.push({taskId:t,reason:`taskId \u91CD\u590D:"${t}"`}),s.add(t),(e.prompt??"").trim()||n.push({taskId:t,reason:"\u4EFB\u52A1\u8BF4\u660E\u4E3A\u7A7A"}),(e.assignee??"").trim()||n.push({taskId:t,reason:"\u6CA1\u6709\u6307\u6D3E\u8D1F\u8D23\u6210\u5458"})}let i=new Set(d.flatMap(e=>[(e.name??"").trim(),(e.agentId??"").trim()]).filter(Boolean));for(let e of o){let t=(e.assignee??"").trim();l&&t&&i.size>0&&!i.has(t)&&n.push({taskId:e.taskId,reason:`\u8D1F\u8D23\u6210\u5458\u300C${t}\u300D\u4E0D\u5728\u56E2\u961F\u540D\u5355\u91CC`});for(let a of e.dependsOn??[])a===e.taskId?n.push({taskId:e.taskId,reason:"\u4EFB\u52A1\u4F9D\u8D56\u4E86\u81EA\u5DF1"}):s.has(a)||n.push({taskId:e.taskId,reason:`\u4F9D\u8D56\u4E86\u4E0D\u5B58\u5728\u7684\u4EFB\u52A1\u300C${a}\u300D`})}let g=new Map(o.map(e=>[e.taskId,(e.dependsOn??[]).filter(t=>s.has(t))])),r=new Map,u=e=>{let t=r.get(e);if(t==="done")return!1;if(t==="visiting")return!0;r.set(e,"visiting");for(let a of g.get(e)??[])if(u(a))return!0;return r.set(e,"done"),!1};for(let e of s)if(u(e)){n.push({taskId:e,reason:"\u4EFB\u52A1\u4F9D\u8D56\u6210\u73AF"});break}return n}var y={version:9,eventSchemaVersion:1,eventNames:p,eventRequiredKeys:m,terminalStates:_},T="1a1a3a59c6601cab382ac31e58198f8f61b182ed452061cd50f68faddeebc5cc",S={version:9,hash:T};export{y as AGENT_CONTRACT_DESCRIPTOR,T as AGENT_CONTRACT_HASH,S as AGENT_CONTRACT_IDENTITY,A as AGENT_CONTRACT_VERSION,p as AGENT_EVENT_NAMES,m as AGENT_EVENT_REQUIRED_KEYS,N as AGENT_EVENT_SCHEMA_VERSION,I as AGENT_TEAM_WS_EVENT_NAMES,_ as AGENT_TERMINAL_STATES,E as AGENT_WS_EVENT_NAMES,f as ALL_AGENT_WS_EVENT_NAMES,k as collectProductPlanIssues};
+var T=10,A=1,_=["completed","failed","cancelled"],E=["turn.start","turn.delta","turn.end","turn.error","turn.recovery","turn.text_rollback","turn.file_changes","turn.tool_call","turn.tool_result","turn.tool_blocked","turn.reasoning_delta","turn.approval_request","turn.ask_user","turn.media_result","turn.plan_update","turn.suggestions","turn.sidechain_started","turn.subagent_started","turn.subagent_delta","turn.subagent_activity","turn.subagent_ended","turn.subagent_completed","turn.subagent_decision","turn.sidechain_completed","turn.task_updated","turn.todos_updated","turn.exec_progress","turn.progress","turn.tool_use_summary","turn.tool_selection_policy","turn.lifecycle","turn.document_maintenance","turn.artifact_contract","turn.usage_update","team.member.notification","session.info","session.recovery_pending","thread.item","memory.updated","skills.updated","turn.memory_recall","turn.memory_written","system.activity","workflow.created","workflow.updated","workflow.deleted","workflow.runStarted","workflow.runCompleted","workflow.runFailed","workflow.nodeStatus","workflow.triggerDropped","workflow.alert","workflow.approvalRequested","workflow.approvalTimedOut"],I=["solo.progress","solo.specProgress","solo.agentDelta","solo.agentActivity","solo.agentUsage","solo.evaluation","solo.agentDiff","solo.state","product.taskStarted","product.taskOutput","product.members","product.agentActivity","product.taskCompleted","product.taskFailed","product.taskHandoff","product.budgetUpdate","product.budgetWarning","product.budgetExceeded","product.checkpointed","product.completed","product.dagTopology","plan.interrupted","product.planReady","product.planningDelta","product.leaderMessage","product.planFailed","product.planningAsk","mention.delegate_started","mention.delegate_activity","mention.delegate_settled"],p=[...E,...I],N=p,f={"turn.subagent_started":["turnId","parentTurnId","subagentId","agentType","displayName","delegatedTask","mode","startedAt"],"turn.subagent_activity":["turnId","parentTurnId","subagentId","agentType","displayName","conciseStatus","status","observedAt"],"turn.subagent_completed":["turnId","parentTurnId","subagentId","agentType","displayName","status","evidence","toolsUsed","durationMs","tokenUsage","finishedAt"],"turn.subagent_decision":["turnId","parentTurnId","subagentId","decision","decidedAt"],"product.taskStarted":["productId","taskId","assignee","attempt"],"product.taskCompleted":["productId","taskId","result","attempt"],"product.taskFailed":["productId","taskId","error","attempt","terminalState"],"product.taskHandoff":["productId","taskId","from","to","reason","attempt","timestamp"],"product.budgetExceeded":["productId","usedTokens","reason"],"mention.delegate_started":["parentSessionId","parentMessageId","bindingId","executionSessionId","delegationId","sequence","providerId","revision"],"mention.delegate_activity":["parentSessionId","parentMessageId","bindingId","executionSessionId","delegationId","sequence","providerId","revision"],"mention.delegate_settled":["parentSessionId","parentMessageId","bindingId","executionSessionId","delegationId","sequence","providerId","revision","status"]};function k(d,a,c={}){let l=c.requireKnownAssignee??!0,n=[];d.length===0&&n.push({taskId:"",reason:"\u7F3A\u5C11\u6267\u884C\u6210\u5458:\u81F3\u5C11\u9700\u8981\u4E00\u4E2A instance"});let s=new Set;for(let e of a){let t=(e.taskId??"").trim();if(!t){n.push({taskId:"",reason:"\u5B58\u5728\u6CA1\u6709 taskId \u7684\u4EFB\u52A1"});continue}s.has(t)&&n.push({taskId:t,reason:`taskId \u91CD\u590D:"${t}"`}),s.add(t),(e.prompt??"").trim()||n.push({taskId:t,reason:"\u4EFB\u52A1\u8BF4\u660E\u4E3A\u7A7A"}),(e.assignee??"").trim()||n.push({taskId:t,reason:"\u6CA1\u6709\u6307\u6D3E\u8D1F\u8D23\u6210\u5458"})}let i=new Set(d.flatMap(e=>[(e.name??"").trim(),(e.agentId??"").trim()]).filter(Boolean));for(let e of a){let t=(e.assignee??"").trim();l&&t&&i.size>0&&!i.has(t)&&n.push({taskId:e.taskId,reason:`\u8D1F\u8D23\u6210\u5458\u300C${t}\u300D\u4E0D\u5728\u56E2\u961F\u540D\u5355\u91CC`});for(let o of e.dependsOn??[])o===e.taskId?n.push({taskId:e.taskId,reason:"\u4EFB\u52A1\u4F9D\u8D56\u4E86\u81EA\u5DF1"}):s.has(o)||n.push({taskId:e.taskId,reason:`\u4F9D\u8D56\u4E86\u4E0D\u5B58\u5728\u7684\u4EFB\u52A1\u300C${o}\u300D`})}let g=new Map(a.map(e=>[e.taskId,(e.dependsOn??[]).filter(t=>s.has(t))])),r=new Map,u=e=>{let t=r.get(e);if(t==="done")return!1;if(t==="visiting")return!0;r.set(e,"visiting");for(let o of g.get(e)??[])if(u(o))return!0;return r.set(e,"done"),!1};for(let e of s)if(u(e)){n.push({taskId:e,reason:"\u4EFB\u52A1\u4F9D\u8D56\u6210\u73AF"});break}return n}var S={version:10,eventSchemaVersion:1,eventNames:p,eventRequiredKeys:f,terminalStates:_},m="5fcb0701c3e9acaff61e5039729e6eb5f41352581ce52079edfa434913ef234c",y={version:10,hash:m};export{S as AGENT_CONTRACT_DESCRIPTOR,m as AGENT_CONTRACT_HASH,y as AGENT_CONTRACT_IDENTITY,T as AGENT_CONTRACT_VERSION,p as AGENT_EVENT_NAMES,f as AGENT_EVENT_REQUIRED_KEYS,A as AGENT_EVENT_SCHEMA_VERSION,I as AGENT_TEAM_WS_EVENT_NAMES,_ as AGENT_TERMINAL_STATES,E as AGENT_WS_EVENT_NAMES,N as ALL_AGENT_WS_EVENT_NAMES,k as collectProductPlanIssues};