Skip to content

docs: 补齐 LSP 插件完整生命周期与构建接入教程 - #9

Merged
xiaoyumuxi merged 1 commit into
mainfrom
docs/lsp-plugin-lifecycle
Oct 17, 2026
Merged

xiaoyumuxi merged 1 commit into
mainfrom
docs/lsp-plugin-lifecycle

Conversation

@xiaoyumuxi

@xiaoyumuxi xiaoyumuxi commented Oct 17, 2026 •

Copy link
Copy Markdown
Collaborator

插件作者现有的发布说明缺少从语言服务器打包到运行、停止和版本切换的开发路径。本次新增中文教程,以 macOS 声明式插件和 Lua 模板串起完整生命周期,并提供可合并进清单的运行、测试示例。

变更

  • 新增 LSP 生命周期教程:最小清单、模板派生、固定上游版本及 SHA-256、归档验证、三种启动方式、API 2 状态目录和运行时、社区源安装、LSP 协议与故障排查。
  • 补齐启用、禁用、关闭、取消、更新、上一版本回滚和卸载的验收步骤,说明重启生效、状态归属及进程清理边界。
  • 新增构建/运行/测试指南,包含 Lua 运行、Go 运行与三个测试范围的 JSON 示例;区分现有 executionProviders、官方 JDT 集成及开发中的 API 3 buildSystems。
  • 将教程接入首页、贡献说明和发布文档导航。操作示例限定 macOS,明确 Windows 独立扩展实现及 API 3 尚未形成通用宿主工作流。

验证

  • node --test scripts/store.test.mjs:30 项通过。
  • node scripts/validate-index.mjs --verify-archives:索引及全部已发布归档通过。
  • 6 组完整/合并 JSON 示例通过 Lithe 已提交的 API 1/2 Schema,以及语言引用、权限和激活事件检查;两个仓库合计 41 个本地/跨仓库文件链接及锚点通过检查。
  • Lua 模板 0.3.0 的 macOS arm64/x64 包构建和 Store 归档校验通过。
  • 本机实际验证 API 1 启动器、API 2 直接启动 LuaLS 两条路径的 initialize → initialized → shutdown → exit;均正常退出,包内容与权限保持不变。
  • Lithe 界面中的安装、补全、更新和回滚尚未实测,已作为发布前人工验收项列入教程;共享校验不代表 Windows 产品验收。

核对基线:Lithe 826b3063 的已提交 API 1/2 契约,以及工作区中尚在开发、市场排除的 API 3 能力。新文档链接在本地按文件与锚点验证,合入后才会出现在 main 上。

配套 PR

Lua 模板入口与验收说明:Lithe-IDEA/lithe-plugin-lua#2

合入顺序:先合入本 PR,再合入 Lua 模板 PR,使模板中的 Store main 文档链接生效。

@xiaoyumuxi
xiaoyumuxi marked this pull request as ready for review October 17, 2026 08:58
@xiaoyumuxi
xiaoyumuxi merged commit 01e6707 into main Oct 17, 2026
1 check passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant