Merge commit '3d83740f88b6aaba6962256be517656496b83f25' into lsp-server

2026-05-24 13:04:22 +08:00
parent 7aa60e78f8 3d83740f88
commit 696920df73
292 changed files with 30774 additions and 218828 deletions
@@ -0,0 +1,48 @@
+# 当前上下文
+
+<!--
+填写指南：
+- 本文件记录高频变化的上下文，供 AI 在跨 Session 时快速恢复工作状态
+- 保持简洁，只写“现在仍然重要”的信息
+- 任务完成或方向切换后及时更新
+-->
+
+## Current Goal
+
+<!-- 当前最重要的目标；一句话即可 -->
+
+- {{CURRENT_GOAL}}
+
+## Recent Changes
+
+<!-- 最近完成且会影响后续判断的变更 -->
+
+- {{RECENT_CHANGE_1}}
+
+## Touched Files
+
+<!-- 最近修改或正在关注的关键文件 -->
+
+- `{{FILE_1}}` - {{FILE_1_REASON}}
+
+## Open Questions
+
+<!-- 尚未确认、但会影响实现或验证的事项 -->
+
+- {{QUESTION_1}}
+
+## Next Steps
+
+<!-- 接下来最优先的 1-3 步 -->
+
+1. {{NEXT_STEP_1}}
+
+## Session Notes
+
+<!-- 只记录本轮最容易忘的上下文 -->
+
+- {{SESSION_NOTE_1}}
+
+---
+
+**最后更新**：{{DATE}}
@@ -1,44 +0,0 @@
-# 架构设计
-
-<!--
-填写指南：
- 【必填】：项目启动前必须填写
- 【可选】：按需填写，可随项目发展补充
- 小项目可只填核心模块，架构图可后补
-->
-
-## 整体架构
-
-<!-- 【可选】项目成熟后补充 -->
-
-```txt
-{{ARCHITECTURE_DIAGRAM}}
-```
-
-## 核心模块
-
-<!-- 【必填】至少列出主要模块 -->
-
-### {{MODULE_1}}
-
-**职责**：{{MODULE_1_DESC}}
-
-## 关键约束
-
-<!-- 【可选】 -->
-
- {{CONSTRAINT_1}}
-
-## 扩展点
-
-<!-- 【可选】大项目建议填写 -->
-
-### {{EXTENSION_1}}
-
-**步骤**：
-
-1. {{STEP_1}}
-
---
-
-**最后更新**：{{DATE}}
@@ -1,4 +1,54 @@
-# Plan 状态
+# 当前进展
+
+<!--
+填写指南：
+- 上半部分给人类和 AI 快速恢复上下文
+- 中间的 workflow-state 块记录当前阶段、spec、plan 与执行约束
+- 下半部分的 plan-status 块由 main_loop.py 维护，是唯一权威状态源
+-->
+
+## Current Focus
+
+- {{CURRENT_FOCUS}}
+
+## Recent Changes
+
+- {{RECENT_CHANGE_1}}
+
+## Next Steps
+
+1. {{NEXT_STEP_1}}
+
+## Open Risks
+
+- {{RISK_1}}
+
+## 状态块示例
+
+以下示例仅用于说明结构，真实状态由 `main_loop.py` 维护：
+
+```text
+## Workflow State
+<!-- workflow-state:start -->
+phase: planning
+spec: docs/superpowers/specs/2026-05-18-demo-design.md
+plan: docs/superpowers/plans/2026-05-18-demo.md
+executor: executing-plans
+constraints: karpathy-guidelines,.agents,AGENT_RULES
+<!-- workflow-state:end -->
+
+## Plan Status
+<!-- plan-status:start -->
+- [ ] `2026-05-18-demo.md` pending
+<!-- plan-status:end -->
+```
+
+## Workflow State
+
+<!-- workflow-state:start -->
+<!-- workflow-state:end -->
+
+## Plan Status

 <!-- plan-status:start -->
 <!-- plan-status:end -->
@@ -0,0 +1,60 @@
+# 系统模式与约束
+
+<!--
+填写指南：
+- 本文件记录跨模块稳定成立的实现模式，而不是一次性的设计草图
+- 优先记录：模块边界、数据流、不变量、扩展路径、禁止破坏的约束
+- 小项目可只保留最关键的 2-3 个部分
+-->
+
+## 模块边界
+
+<!-- 至少列出主要模块及其职责边界 -->
+
+### {{MODULE_1}}
+
+- **职责**：{{MODULE_1_DESC}}
+- **输入**：{{MODULE_1_INPUT}}
+- **输出**：{{MODULE_1_OUTPUT}}
+- **不应负责**：{{MODULE_1_NON_GOAL}}
+
+## 关键数据流
+
+<!-- 描述系统中的主路径；按“输入 -> 处理 -> 输出”写 -->
+
+1. {{FLOW_STEP_1}}
+2. {{FLOW_STEP_2}}
+3. {{FLOW_STEP_3}}
+
+## 核心不变量
+
+<!-- 这些约束一旦被破坏，系统行为就可能失真 -->
+
+- {{INVARIANT_1}}
+
+## 常见实现模式
+
+<!-- 给 AI 明确“这里通常怎么改” -->
+
+### {{PATTERN_1}}
+
+- **适用场景**：{{PATTERN_1_SCENARIO}}
+- **推荐做法**：{{PATTERN_1_APPROACH}}
+- **避免事项**：{{PATTERN_1_AVOID}}
+
+## 扩展路径
+
+<!-- 新增功能时，优先走哪些入口或目录 -->
+
+1. {{EXTENSION_STEP_1}}
+2. {{EXTENSION_STEP_2}}
+
+## 禁止破坏的约束
+
+<!-- 记录兼容性、安全性或组织层面的硬约束 -->
+
+- {{DO_NOT_BREAK_1}}
+
+---
+
+**最后更新**：{{DATE}}
@@ -0,0 +1,72 @@
+# 技术上下文与工具链
+
+<!--
+填写指南：
+- 本文件记录“如何在这个仓库里安全工作”
+- 优先填写命令、环境、入口路径、依赖限制
+- 未填写的占位符保持原样或删除整行
+-->
+
+## 核心技术
+
+<!-- 【必填】项目主要语言、框架、运行时 -->
+
+- {{TECH_1}}
+
+## 项目结构
+
+<!-- 【必填】至少列出关键目录 -->
+
+```text
+{{PROJECT_NAME}}/
+├── {{DIR_1}}/           # {{DIR_1_DESC}}
+└── memory-bank/         # 项目上下文
+```
+
+## 关键入口
+
+<!-- 【必填】AI 最常用的入口文件、命令或目录 -->
+
+- `{{ENTRY_PATH_1}}` - {{ENTRY_PATH_1_DESC}}
+
+## 开发环境
+
+<!-- 【必填】至少填写验证相关命令 -->
+
+**必需工具**：
+
+- {{TOOL_1}}
+
+**运行测试**：
+
+```bash
+{{TEST_CMD}}
+```
+
+**格式化 / Lint**：
+
+```bash
+{{FORMAT_OR_LINT_CMD}}
+```
+
+## 环境与平台差异
+
+<!-- 【可选】如 Windows/Linux/macOS 行为不同，写在这里 -->
+
+- {{ENV_DIFF_1}}
+
+## 依赖与限制
+
+<!-- 【可选】外部服务、私有依赖、危险命令、慢命令 -->
+
+- {{DEPENDENCY_OR_LIMIT_1}}
+
+## 验证约定
+
+<!-- 【可选】什么叫“验证通过” -->
+
+- {{PASS_CONDITION_1}}
+
+---
+
+**最后更新**：{{DATE}}
@@ -1,64 +0,0 @@
-# 技术栈与工具链
-
-<!--
-填写指南：
- 【必填】：项目启动前必须填写
- 【可选】：按需填写，可随项目发展补充
- 未填写的占位符保持原样或删除整行
-->
-
-## 核心技术
-
-<!-- 【必填】 -->
-
-**主语言**：{{MAIN_LANGUAGE}}
-
-**文件类型**：{{FILE_TYPES}}
-
-## 项目结构
-
-<!-- 【必填】 -->
-
-```text
-{{PROJECT_NAME}}/
-├── {{DIR_1}}/           # {{DIR_1_DESC}}
-└── memory-bank/         # 项目上下文
-```
-
-## 开发环境
-
-<!-- 【必填】至少填写运行测试命令 -->
-
-**必需工具**：
-
- {{TOOL_1}}
-
-**运行测试**：
-
-```bash
-{{TEST_CMD}}
-```
-
-## 依赖管理
-
-<!-- 【可选】 -->
-
-**外部依赖**：
-
- {{EXTERNAL_DEP_1}}
-
-## 测试策略
-
-<!-- 【可选】大项目建议填写 -->
-
-**测试类型**：
-
- {{TEST_TYPE_1}}
-
-**验证标准**：
-
- {{PASS_CONDITION_1}}
-
---
-
-**最后更新**：{{DATE}}