超轻量 CLI Agent:依赖 + 单文件宿主 + 配套技能集 + Shell 工具执行。
curl -fsSL https://cdn.jsdelivr.net/gh/Xiyinnnnnn/cli-agent-plus-plus@main/install.sh | bash快速安装:依赖+本体+技能集
首次运行输入 DeepSeek API Key:
- 混淆落盘(
~/.config/cli-agent/key.bin)
# Linux:python3 ~/.local/bin/cli-agent/cli-agent.py
# Termux:agentAPI 端点与模型写在 cli-agent.py 顶部常量中(API_URL / MODEL / MAX_TOK / MAX_OUT),可自行修改。
| 按键 | 行为 |
|---|---|
Ctrl+Space |
立即暂停当前执行 |
Ctrl+X |
压缩当前上下文 |
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"]
| 层 | 组件 | 职责 |
|---|---|---|
| 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 不落明文 |
判定权在模型:宿主不扫描命令内容,只按 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/>命令未执行"]
| dangerous | 行为 |
|---|---|
false |
直接执行,宿主不做二次校验 |
true |
终端 push 确认块(⚠ + 命令全文),Y + 回车才执行 |
| 项 | 值 |
|---|---|
| 超时 | AUTH_TIMEOUT = 30,设 0 = 永不超时 |
| 接受输入 | y / yes + 回车(单键不算,全角等效) |
| 拒绝 | N / 超时 / Ctrl+C / Ctrl+D |
- 新终端 = 新对话(每个终端会话独立上下文)
Ctrl+Space= 暂停;Ctrl+X= 请求压缩
安装脚本是幂等的:重复执行安装命令即可覆盖更新程序文件
MIT
- 开发文档:doc/dev.md