第一梯队 · 核心代表作核心代表作 · 已入驻 npm & WinGet最近更新 2026-10-22

轻灵 Qling CLI

  • npm @qlingzzy/qling
  • WinGet 官方源 Zzy-min.qling
  • MCP 白名单治理

基于 TypeScript / Node.js 构建的本地优先终端编码 Agent(已发布至 npm 并合入微软官方 WinGet 软件源)。支持 MCP 网关工具白名单治理、Durable Missions 持久任务、Checkpoint/Resume 断点恢复、三层记忆系统与流式 TUI。

01 / 项目概览与状态

项目概览与状态

我独立完成架构设计、核心运行时研发与跨平台分发,支持 npm 全局安装与微软官方 `winget install Zzy-min.qling` 一键部署,落地 Pipeline 钩子、MCP 白名单治理与可恢复任务状态机。

02 / 要解决的问题

要解决的问题

通用终端编码 Agent 往往耦合特定闭源云端,且在执行长周期多步骤编码任务时缺少本地断点恢复、MCP 外部工具权限隔离与确定性验证门禁。

03 / 我的职责

我的职责

我负责项目发起、Agent 运行时架构、MCP 安全治理、自动化测试与 npm / WinGet 跨平台发布。

  • 01设计并实现本地优先的 Agent Loop、Pipeline 钩子体系与三层分层记忆系统
  • 02研发 Durable Missions 持久任务、Checkpoint/Resume 断点恢复与 MCP 工具白名单策略
  • 03构建跨平台 CI 验证门禁,完成 npm 包发布与微软官方 microsoft/winget-pkgs 仓库合入
04 / AI 参与边界

AI 参与边界

AI 辅助

  • —协助分析局部边缘用例、生成部分 CLI 参数解析与测试脚手架

由我负责

  • —Agent 状态机架构、安全网关权限边界、断点恢复一致性、真实环境调试与官方源发布验收
05 / 系统架构

系统架构

轻灵 Agent Loop、MCP 工具治理与分层记忆架构图
流式 TUI 进入 Pipeline 和 Agent Loop,经由 MCP 白名单网关调度工具,并将任务检查点与状态按层写入本地记忆。
06 / 关键实现

关键实现

  • 01发布至 npm(@qlingzzy/qling)并正式合入微软官方软件源(winget install Zzy-min.qling,PR #402294)
  • 02支持 Durable Missions 持久任务状态机与 Checkpoint / Resume 任意中断点恢复
  • 03内置 MCP 网关集成与细粒度工具白名单(Tool Whitelist)权限治理,阻断高危越权命令
  • 04三层记忆架构(工作记忆 / 长期记忆 / 自动整理)与原子状态落盘
  • 05Claude Code 风格流式 TUI 交互、7 种核心本地工具与实时 Token 预算监控
07 / 一次真实问题与修复

一次真实问题与修复

问题

Windows 并发会话、长任务工具调用与中断恢复之间容易出现状态竞争和上下文损坏。

排查

通过定向集成测试、临时沙箱目录与中断轨迹回放,定位非原子写入与流式事件乱序导致的恢复失败。

修复

加固安全网关与 MCP 工具白名单,引入原子写入锁、Checkpoint 快照校验与确定性恢复路径,并纳入 CI 门禁。

结果

构建、定向测试、ci:check 与跨平台包安装(npm / WinGet)形成完整可复查的工程验证链。

08 / 验证证据

验证证据

09 / 截图与运行记录

截图与运行记录

轻灵项目工程验证记录
terminal仓库真实采用的测试、构建、恢复门禁与官方包分发验证链。
10 / 继续验证

继续验证