Files

karuo e0ee8c2e2a 🔄 卡若AI 同步 2026-03-12 23:10 | 更新：水桥平台对接、卡木、总索引与入口、运营中枢工作台 | 排除 >20MB: 11 个

2026-03-12 23:10:26 +08:00

7.4 KiB

Raw Blame History

name, description, triggers, owner, group, version, updated, source

name	description	triggers	owner	group	version	updated	source
CLI万能化	让任意软件变成 AI Agent 可驱动的 CLI 接口；一行命令完成7阶段自动流水线	CLI万能化、cli-anything、软件识形、让软件Agent化、任意软件CLI、软件CLI接口、木识、软件识形、CLI接口生成、让软件可被AI控制、给软件生成CLI、GUI转CLI	木识	木（卡木）	1.0	2026-03-12	https://github.com/HKUDS/CLI-Anything

木识 · CLI万能化

木识（Mù Shí）是卡木第四成员，专司「软件识形」——识别任意软件的形体与架构，将其转化为 AI Agent 可驱动的 CLI 接口。

「识」字连接记忆宫殿：佛教哲学中「阿赖耶识」为万物印记之储库，木识的使命就是将任意软件的能力识别、提炼并存入 Agent 可调用的指令库——让记忆宫殿的每个房间都多一扇可编程的门。

能做什么（Capabilities）

任意软件 → CLI：对任意有源码的软件（GIMP、Blender、LibreOffice、Gitea、Jenkins、Stable Diffusion、ComfyUI 等），自动生成生产级 CLI 接口
7 阶段全自动流水线：分析 → 设计 → 实现 → 规划测试 → 写测试 → 文档 → 发布，无需手写代码
Agent 友好输出：每条命令均支持 --help 自描述 + --json 机器可读输出
REPL 交互模式：有状态交互式会话，支持撤销/重做
本机集成：生成的 CLI 以 pip install -e . 直接装到 PATH，卡若AI 后续技能可直接调用
迭代精化：可对已生成的 CLI 做 gap analysis，增量扩展覆盖范围
与木根联动：木根做逆向分析找 API，木识生成完整可用的 CLI 层

怎么用（Usage）

触发词

CLI万能化、cli-anything、软件识形、让[软件名]被Agent控制、给[软件]生成CLI、木识

使用示例

木识：把本机的 Gitea 生成 CLI 接口
木识：给 Stable Diffusion 做 CLI 万能化
木识：让 ComfyUI 可以被 Agent 调用
CLI万能化 ./blender

执行步骤（Steps）

前置检查

python3 --version       # 需要 ≥ 3.10
which python3
# 确认目标软件已安装（如需要）

方式一：在 Cursor / 卡若AI 内直接执行（推荐）

木识在 Cursor 中按以下流程手动执行 7 阶段（无需 Claude Code 插件市场）：

阶段0：获取源码

# 本地路径（直接用）
TARGET_PATH="./gimp"

# 或克隆 GitHub 仓库
git clone https://github.com/GNOME/gimp /tmp/target-software/gimp
TARGET_PATH="/tmp/target-software/gimp"

阶段1：分析（Analyze）

读取目标软件源码目录
识别后端引擎、GUI-API 映射关系
参考：参考资料/HARNESS.md § Phase 1

阶段2：设计（Design）

设计命令分组、状态模型、输出格式
参考：参考资料/HARNESS.md § Phase 2

阶段3：实现（Implement） 生成以下目录结构：

<software>/
└── agent-harness/
    ├── <SOFTWARE>.md       ← 软件专属 SOP
    ├── setup.py            ← pip 可安装
    └── cli_anything/
        └── <software>/
            ├── README.md
            ├── __init__.py
            ├── __main__.py
            ├── <software>_cli.py    ← 主 CLI（Click）
            ├── core/                ← 核心操作模块
            ├── utils/
            │   ├── repl_skin.py     ← REPL UI（从 harness_templates/ 复制）
            │   └── <software>_backend.py  ← 真实后端封装
            └── tests/
                ├── test_core.py     ← 单元测试
                └── test_full_e2e.py ← 端到端测试

阶段4-5：测试（Test）

cd <software>/agent-harness
pip install -e . --break-system-packages 2>/dev/null || pip install -e . --user
python -m pytest cli_anything/<software>/tests/ -v

阶段6：文档

更新 TEST.md，记录测试结果

阶段7：发布（Publish）

pip install -e . --break-system-packages 2>/dev/null || pip install -e . --user
which cli-anything-<software>
cli-anything-<software> --help

方式二：通过 Claude Code 插件（原生方式）

如果用户已安装 Claude Code：

/plugin marketplace add HKUDS/CLI-Anything
/plugin install cli-anything
/cli-anything:cli-anything ./gimp

方式三：精化已有 CLI

# 通过 Claude Code
/cli-anything:refine ./gimp
/cli-anything:refine ./gimp "增加批量图像处理和滤镜功能"

# 在 Cursor 内：读 HARNESS.md → 执行 gap analysis → 增量实现

7 阶段流水线详解

阶段	名称	做什么
1	分析 Analyze	扫源码、找后端引擎、GUI→API 映射
2	设计 Design	命令分组、状态模型、输出格式设计
3	实现 Implement	Click CLI + REPL + JSON 输出 + 后端封装
4	规划测试 Plan Tests	写 TEST.md（单元+E2E 计划）
5	编写测试 Write Tests	实现 test_core.py + test_full_e2e.py
6	文档 Document	更新 TEST.md + README
7	发布 Publish	setup.py + pip install -e . + 验证

支持的软件类别（已验证）

类别	代表软件
创意/媒体	GIMP、Blender、Inkscape、Audacity、Kdenlive、OBS Studio
AI/ML 平台	Stable Diffusion、ComfyUI、InvokeAI
数据/分析	JupyterLab、Apache Superset、Metabase、DBeaver
开发工具	Jenkins、Gitea、Portainer、pgAdmin、SonarQube
办公/企业	LibreOffice、GitLab、Grafana、Mattermost
图表/可视化	Draw.io、Mermaid、PlantUML、Excalidraw
任意有源码软件	只要有代码库，均可生成 CLI

与卡若AI 系统的联动

木根（逆向分析）：木根分析目标软件 API → 木识生成完整 CLI 层
火炬（全栈开发）：生成的 CLI 可集成进卡若AI 项目的自动化流水线
金仓（系统监控）：Gitea、Jenkins 等开发工具生成 CLI 后可纳入监控体系
土砖（技能工厂）：每个生成的 CLI harness 可打包为基因胶囊，分发复用

依赖（Dependencies）

前置技能：可与木根（逆向分析）联动
外部工具：
- python3 ≥ 3.10
- click ≥ 8.0（pip install click）
- pytest（pip install pytest）
- prompt_toolkit（REPL 模式需要，pip install prompt_toolkit）
- 目标软件需在本机已安装（如需要）

木识 · 身份档案

属性	内容
名字	木识（Mù Shí）
所属	卡木（木组）第四成员
口号	"识形成器，万物可用。"
专司	软件识形：识别任意软件的能力形体，转化为 Agent 可驱动的 CLI
记忆宫殿连接	「识」= 阿赖耶识，万物印记之储库；每识形一款软件，就为记忆宫殿多开一扇可编程的门
五行属性	木（生长、工具、创造）+ 识（认知、识别、意识）
互补成员	木根（逆向分析找路）→ 木识（识形生成CLI通道）

7.4 KiB Raw Blame History Unescape Escape