Skip to content

CLI: 重构为名词-动词命令结构 #9

@KenyonY

Description

@KenyonY

问题

当前命令是扁平动词/名词混合:`ask / chat / batch / models / list / set-model / test / init / pricing / credits / mock / version / install-skill / serve / chat-web`

agent-cli-guide P1 要求名词-动词层级,当前问题:

  • `list` vs `models` 语义混淆(同为"列表",一个本地一个远程)
  • `set-model` 是 verb-noun
  • `chat` 和 `chat-web` 缺乏层级关系
  • 没有一致的 list/get/create/delete 动词复用

目标命令结构

```
flexllm ask "..." # 保留,非资源类命令
flexllm chat # 保留
flexllm batch in.jsonl # 保留

flexllm model list # = 老 list
flexllm model list --remote # = 老 models
flexllm model set # = 老 set-model
flexllm model test # = 老 test
flexllm model pricing [name] # = 老 pricing
flexllm model credits # = 老 credits

flexllm config init # = 老 init
flexllm config show # 新增

flexllm server start # = 老 serve
flexllm server mock # = 老 mock

flexllm chat serve # = 老 chat-web (或保留 chat-web)

flexllm schema [cmd] # issue #4
```

兼容策略

  • 老命令全部保留,内部转发到新命令
  • 老命令 help 标注 `[Deprecated: use `flexllm model list`]`
  • 2-3 个 minor 版本后移除

附带修复

验收

  • 所有新命令可用
  • 所有老命令仍可用 + 显示 deprecated
  • 更新 README / CLAUDE.md / SKILL.md 示例
  • 单测覆盖新旧命令等价性

Metadata

Metadata

Assignees

No one assigned

    Labels

    enhancementNew feature or request

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions