Skip to content

Latest commit

 

History

204 Commits

Folders and files

Repository files navigation

CLI-Agent++

license python deps deps platform

超轻量 CLI Agent:依赖 + 单文件宿主 + 配套技能集 + Shell 工具执行。

QUICK START

curl -fsSL https://cdn.jsdelivr.net/gh/Xiyinnnnnn/cli-agent-plus-plus@main/install.sh | bash

快速安装:依赖+本体+技能集

首次运行输入 DeepSeek API Key:

  • 混淆落盘(~/.config/cli-agent/key.bin)

USAGE

# Linux:python3 ~/.local/bin/cli-agent/cli-agent.py

# Termux:agent

API 端点与模型写在 cli-agent.py 顶部常量中(API_URL / MODEL / MAX_TOK / MAX_OUT),可自行修改。

KEY BINDINGS 快捷键

按键 行为
Ctrl+Space 立即暂停当前执行
Ctrl+X 压缩当前上下文

ARCHITECTURE

flowchart TD
    A["welcome()<br/>first-run key setup + encrypt"] --> B["main()<br/>loop: llm <-> RUN<br/>+ 压缩桥接"]
    B --> C["llm()<br/>流式对话<br/>Ctrl+Space=暂停 / Ctrl+X=请求压缩"]
    B --> D["compress()<br/>512K 摘要链"]
    B --> E["RUN()<br/>唯一工具: shell 执行<br/>+ 按 dangerous 标志授权"]
    C --> F["build_context()<br/>mem_hist + summaries"]
    D --> F
    E --> F
    F --> G["key store<br/>encrypt/decrypt 机器种子"]
    F --> H["memory / skill / taskbook<br/>~/.config/cli-agent/*.md"]
Loading
层 组件 职责
ENTRY welcome() 首次运行引导,Key 加密入库
CORE main() 主循环:LLM 对话、工具调用解析、结果回填、压缩请求桥接
LLM llm() 流式 SSE;Ctrl+Space 暂停 / Ctrl+X 设压缩请求标记
MEM compress() / build_context() 512K(MAX_TOK) 阈值压缩,摘要链跨会话延续
TOOL RUN() 唯一工具:Shell 执行 + dangerous 标志授权闸门
SEC encrypt/decrypt_key() 机器指纹种子加密,Key 不落明文

SECURITY 安全模型

判定权在模型:宿主不扫描命令内容,只按 RUN 的 dangerous 标志分流。

flowchart LR
    A["RUN(cmd, dangerous)"] --> B{"dangerous == true?"}
    B -->|否| C["subprocess 直接执行"]
    B -->|是| D["confirm_block()<br/>push ⚠ 确认块"]
    D -->|"Y"| C
    D -->|"N / 超时"| E["拒绝返回<br/>命令未执行"]
Loading
dangerous 行为
false 直接执行,宿主不做二次校验
true 终端 push 确认块(⚠ + 命令全文),Y + 回车才执行

用户授权

项 值
超时 AUTH_TIMEOUT = 30,设 0 = 永不超时
接受输入 y / yes + 回车(单键不算,全角等效)
拒绝 N / 超时 / Ctrl+C / Ctrl+D

NOTES

  • 新终端 = 新对话(每个终端会话独立上下文)
  • Ctrl+Space = 暂停;Ctrl+X = 请求压缩

UPDATE 如何更新

安装脚本是幂等的:重复执行安装命令即可覆盖更新程序文件

LICENSE

MIT

Extras 扩展

Releases

Packages

Contributors

Languages