[Feature]: 自建站点命令行所在目录建议

[robaggio]

Feature Description

感谢作者开发 OpenCLI，今天试用下来体验很好，很快就创建了两个自用的站点命令行。不过使用中有一个建议反馈一下：我新建的命令行与 OpenCLI 内置命令行都被放在 ~/.opencli/clis目录下，这一点我有些疑问。

• 自定义命令可能与未来官方命令重名冲突。例如我今天新建了 cnn 命令，如果后续官方也推出同名命令，两者用途可能完全不同，会产生覆盖或执行异常。
• 自定义命令与官方命令混在同一目录，不方便管理，也不适合用 Git 进行版本控制。

我目前主要使用 Claude Code，本身已有独立项目目录，但现在项目目录里没有生成任何文件，所有内容都集中在 ~/.opencli 下。建议增加一种机制，让自定义站点命令可以保留在项目目录中。

Use Case

用户新创建命令行后，更方便项目代码管理，同时避免和官方命令混淆冲突。

Proposed Solution

例如可以新增类似 ~/.opencli/custom_clis 目录，也是opencli认可的网站路径，内部通过软链接指向项目目录。这样既能避免自定义命令与官方命令冲突，也方便进行代码版本管理，体验会更合理。

Alternatives Considered

No response

[Astro-Han]

感谢反馈！这个场景其实用 opencli 已有的 plugin 机制就可以满足，不需要新增目录：

# 在你的项目目录里 scaffold 一个 plugin
opencli plugin create my-cnn

# 把它 symlink 进 ~/.opencli/plugins/my-cnn/
cd my-cnn
opencli plugin install file://$(pwd)

# 命令立刻可用
opencli my-cnn hello

这样：

• 文件留在你自己的项目目录里，可以正常用 git 管理
• ~/.opencli/plugins/ 和 ~/.opencli/clis/ 完全隔离，不会被官方适配器更新流程（fetch-adapters.js）触碰
• 加载顺序在内置命令之后，即便和官方同名也是你的 plugin 生效，不会出现覆盖问题

只是这条路径目前在 README 里只示范了 `opencli plugin install github:...`，没提 `plugin create` 和本地 `file://` 安装，所以不容易被发现。

[robaggio]

确实README里没有针对想自己定制几个cli要怎么做说明，建议文档方面再细化一下，现在只是主要针对直接使用现有命令的用户要如何使用，还有开发opencli的开发如何使用 - 缺少想要自己开发新的命令，要如何操作的部分，这恰好是我认为opencli最吸引人的功能。

另外，刚刚我试了plugin的方式，提两个建议：

1. 自己开发和官方cli并列的新的cli用plugin会有一点点误导，以为是某种插件机制，并没有直接理解成是和官方cli一样的三方cli机制，当然不影响使用。
2. 我刚开始按照 plugins.md 里的Monorepo Plugins做尝试（因为我有两个site的cli），但是安装plugin时会报错

Bash(opencli plugin install file:///path/mycollection 2>&1)
⎿  Error: Exit code 1
Error: Invalid plugin structure:
- No command files found in plugin directory. A plugin must contain at least one .yaml, .ts, or .js command file.

看起来这里的文档也许有问题， monorepo 的方式 opencli 并没有解析出来，不过Claude Code自动帮我改造成了下面的样子，实测工作效果和放到clis目录里效果一样

mycollection/
├── command_a.js # opencli site_a command_a
├── command_b.js # opencli site_b command_b
├── opencli-plugin.json
├── package.json
└── README.md

同样支持两个site的不同命令，也不知道这样是否是正确的多site plugin方式，还请开发者帮忙确认一下，或者修复monorepo的方式。