🔧 chore(playbook): align repo with latest workflow
lsp-server ci / build-and-test (push) Failing after 0s
lsp-server ci / build-and-test (push) Failing after 0s
sync playbook-managed rules and prompts. migrate memory-bank to the new structure and move plans to docs/superpowers/plans. keep product README files untouched.
This commit is contained in:
@@ -2,47 +2,49 @@
|
||||
|
||||
## 项目定位
|
||||
|
||||
**核心目标**:为 TSL (TinySoft Language) 提供完整的 IDE 开发体验
|
||||
**核心目标**:为 TSL 提供稳定、可扩展的语言服务与编辑器集成能力。
|
||||
|
||||
**一句话描述**:基于 LSP 标准的 TSL 语言服务器及编辑器扩展套件
|
||||
**一句话描述**:以 C++23 LSP 服务器为核心,配套 VSCode 与 Vim 支持的
|
||||
TSL 开发套件。
|
||||
|
||||
## 项目边界
|
||||
|
||||
### 做什么
|
||||
|
||||
- 实现 LSP (Language Server Protocol) 服务器,提供标准语言服务
|
||||
- 提供 VSCode 扩展,集成语法高亮、代码补全、诊断等功能
|
||||
- 提供 Vim 语法支持
|
||||
- 支持跨平台运行 (Linux / Windows)
|
||||
- 实现 TSL 的 LSP 服务器,提供补全、跳转、引用、符号等语言能力
|
||||
- 维护 Tree-sitter 解析、AST、语义与符号链路,保障编辑时反馈质量
|
||||
- 提供 VSCode 扩展与 Vim 语法支持,覆盖主要编辑器接入场景
|
||||
- 维护 Linux / Windows 的构建、测试与发布路径
|
||||
|
||||
### 不做什么
|
||||
|
||||
- 不实现 TSL 语言的编译器/解释器
|
||||
- 不实现 TSL 语言的运行时环境
|
||||
- 不提供 TSL 语言的调试功能 (Debugger)
|
||||
- 不实现 TSL 编译器、解释器或运行时
|
||||
- 不实现调试器或独立 IDE 产品
|
||||
- 不把 playbook 同步内容扩展到产品 README 范围
|
||||
|
||||
### 约束条件
|
||||
|
||||
- 必须遵循 LSP 3.17+ 协议标准
|
||||
- LSP 服务器必须支持增量解析以保证响应性能
|
||||
- 必须同时支持 Linux 和 Windows 平台
|
||||
- 对外行为必须保持 LSP 3.17+ 兼容
|
||||
- 解析链路必须支持增量更新,避免编辑场景响应退化
|
||||
- C++ 服务器代码以 C++23 Modules 组织,依赖现代编译器工具链
|
||||
- `docs/standards/playbook/` 作为 vendored 快照维护,更新流程固定
|
||||
|
||||
## 核心概念
|
||||
|
||||
| 术语 | 说明 |
|
||||
| --------------- | ------------------------------------------------ |
|
||||
| **TSL** | TinySoft Language,天软公司的领域特定脚本语言 |
|
||||
| **LSP** | Language Server Protocol,微软定义的语言服务协议 |
|
||||
| **Tree-sitter** | 增量解析框架,用于构建语法树 |
|
||||
| **Provider** | LSP 功能提供者,处理特定类型的请求 |
|
||||
| **Manager** | 管理器,负责文档、符号、解析等核心状态管理 |
|
||||
| 术语 | 说明 |
|
||||
| --- | --- |
|
||||
| **TSL** | TinySoft Language,天软公司的领域脚本语言 |
|
||||
| **LSP** | Language Server Protocol,编辑器与语言服务的标准协议 |
|
||||
| **Tree-sitter** | 增量解析器,用于语法树构建和局部更新 |
|
||||
| **Provider** | 处理具体 LSP 请求的能力模块 |
|
||||
| **Manager** | 管理文档、解析结果、符号等共享状态的核心组件 |
|
||||
|
||||
## 参考资料
|
||||
|
||||
- [LSP 规范](https://microsoft.github.io/language-server-protocol/specifications/lsp/3.17/specification/)
|
||||
- [Tree-sitter 文档](https://tree-sitter.github.io/tree-sitter/)
|
||||
- [VSCode 扩展 API](https://code.visualstudio.com/api)
|
||||
- [VSCode Extension API](https://code.visualstudio.com/api)
|
||||
|
||||
---
|
||||
|
||||
**最后更新**:2026-02-02
|
||||
**最后更新**:2026-05-24
|
||||
|
||||
Reference in New Issue
Block a user