脚本结构
一份 JokyMouse 脚本不只是 Lua 代码。脚本标题、key、版本、描述和 settings 会直接影响发布审核、市场安装、更新流程和用户订阅体验。
推荐元信息
{
"title": "账号切换助手",
"key": "julywind.account_switcher",
"version": "1.0.0",
"description": "自动完成窗口切换与账号轮换",
"settings": [
{
"key": "account_count",
"type": "number",
"label": "账号数量"
}
]
}字段职责
| 字段 | 作用 | 建议 |
|---|---|---|
| title | 用户在列表页、安装页、订单页里看到的名称 | 首发后尽量保持稳定 |
| key | 平台内稳定标识 | 一旦正式上架，不要频繁修改 |
| version | 版本迭代依据 | 每次审核更新都应明确递增 |
| description | 解释脚本做什么 | 写清适用场景和限制条件 |
| settings | 运行时配置来源 | key 要稳定，避免重命名造成兼容问题 |
为什么 key 很重要
- 它不是展示字段，而是平台链路里的稳定主键。
- 订阅关系、市场安装、脚本恢复、版本审核都会围绕它建立关联。
- 如果上架后反复修改 key，历史订阅和更新路径会变得难以追踪。
settings 设计建议
- 同一个 key 应长期保持语义稳定。
- 默认值变化可以接受，但不要轻易删掉已发布设置项。
- 如果必须废弃某个设置项，优先在脚本内兼容旧值，再通过新版本迁移。
脚本结构设计完成后，再去看 市场与商业化，会更容易理解为什么这些字段必须在一开始就设计得足够稳定。