067、自定义插件开发：API 接口设计、权限声明与发布流程

067、自定义插件开发：API 接口设计、权限声明与发布流程

上周五凌晨两点，我盯着CodeX的插件日志里一行“Permission denied: access to workspace.files”报错，差点把咖啡泼到键盘上。这个自定义插件折腾了三天，明明API文档翻烂了，权限声明也写了，怎么就死活读不到工作区文件？后来发现是权限作用域写成了小写——CodeX的权限系统对大小写敏感，而官方文档里那个示例代码偏偏用了全小写。这种坑，不亲自踩一遍，你永远不知道。

API接口设计：别把RESTful思维带进来

CodeX的插件API不是传统的REST接口，它基于事件驱动的消息通道。你写的每个API端点，本质上是一个事件处理器。刚开始我习惯性地定义了一堆/api/v1/xxx路径，结果CodeX根本不认——它只认plugin:action这种命名空间格式。

// 正确姿势：命名空间+动作codex.api.register(