chore: initialize qiming workspace repository
This commit is contained in:
Codex
145
qimingcode/docs/PERF-OPTIMizations-2026-03-28.md
Normal file
145
qimingcode/docs/PERF-OPTIMizations-2026-03-28.md
Normal file
@@ -0,0 +1,145 @@
|
||||
# qimingcode ACP 性能优化
|
||||
|
||||
**日期**: 2026-03-28
|
||||
**作者**: Claude Code (自动生成)
|
||||
|
||||
## 概述
|
||||
|
||||
本文档记录了针对 qimingcode ACP 性能的优化措施，目标是将首次聊天请求从 ~5044ms 降到 ~2500-3500ms。
|
||||
|
||||
## 优化前基线
|
||||
|
||||
| 指标 | 耗时 |
|
||||
|------|------|
|
||||
| engine.getOrCreate | 1783ms |
|
||||
| acp.session.create | 3255ms |
|
||||
| **总请求耗时** | **5044ms** |
|
||||
|
||||
## 优化措施
|
||||
|
||||
### 1. 并行配置加载 (`config/config.ts`)
|
||||
|
||||
**问题**: 配置加载是串行的，远程配置获取 → 全局配置加载 → 项目配置加载）
|
||||
|
||||
**优化**:
|
||||
- 使用 `Promise.all` 并行加载所有远程配置和全局配置
|
||||
- 远程配置错误不再阻塞启动，而是记录错误并继续
|
||||
|
||||
**预期收益**: -300~500ms
|
||||
|
||||
```typescript
|
||||
// 优化前
|
||||
for (const [key, value] of Object.entries(auth)) {
|
||||
if (value.type === "wellknown") {
|
||||
const response = await fetch(`${key}/.well-known/opencode`)
|
||||
// ...
|
||||
}
|
||||
}
|
||||
result = mergeConfigConcatArrays(result, await global())
|
||||
|
||||
// 优化后
|
||||
const [remoteConfigs, globalConfig] = await Promise.all([
|
||||
Promise.all(wellknownEntries.map(async ([key]) => {
|
||||
try {
|
||||
const response = await fetch(`${key}/.well-known/opencode`)
|
||||
// ...
|
||||
} catch (err) {
|
||||
log.error("failed to fetch remote config", { url: key, error: err })
|
||||
return { key, config: null }
|
||||
})),
|
||||
global(),
|
||||
])
|
||||
```
|
||||
|
||||
### 2. 模型解析缓存 (`acp/agent.ts`)
|
||||
|
||||
**问题**: `defaultModel()` 每次调用都会执行两个串行 SDK 调用
|
||||
|
||||
**优化**:
|
||||
- 添加 60 秒 TTL 的模型缓存
|
||||
- 使用 `Promise.all` 并行执行 `sdk.config.get()` 和 `sdk.config.providers()`
|
||||
|
||||
**预期收益**: -200~400ms
|
||||
|
||||
```typescript
|
||||
// 优化前
|
||||
const specified = await sdk.config.get(...)
|
||||
const providers = await sdk.config.providers(...)
|
||||
|
||||
// 优化后
|
||||
const [specified, providers] = await Promise.all([
|
||||
sdk.config.get(...),
|
||||
sdk.config.providers(...),
|
||||
])
|
||||
|
||||
// 缓存
|
||||
const modelCache = new Map<string, { model: ModelInfo; expires: number }>()
|
||||
const MODEL_CACHE_TTL = 60_000 // 60 seconds
|
||||
```
|
||||
|
||||
### 3. Bootstrap 并行化 (`project/bootstrap.ts`)
|
||||
|
||||
**问题**: 服务初始化是串行的，Plugin.init → Share.init → Format.init → LSP.init → ...
|
||||
|
||||
**优化**:
|
||||
- 所有独立服务并行初始化
|
||||
- LSP 初始化不再阻塞启动（懒加载）
|
||||
|
||||
**预期收益**: -200~400ms
|
||||
|
||||
```typescript
|
||||
// 优化前
|
||||
await Plugin.init()
|
||||
Share.init()
|
||||
ShareNext.init()
|
||||
Format.init()
|
||||
await LSP.init()
|
||||
FileWatcher.init()
|
||||
// ...
|
||||
|
||||
// 优化后
|
||||
const parallelInits = Promise.all([
|
||||
LSP.init().catch(...),
|
||||
Promise.resolve().then(() => Share.init()),
|
||||
Promise.resolve().then(() => Format.init()),
|
||||
// ... 其他服务
|
||||
])
|
||||
await parallelInits
|
||||
```
|
||||
|
||||
### 4. MCP 连接复用 (`mcp/index.ts`)
|
||||
|
||||
**注意**: 此优化已存在于代码中，无需修改
|
||||
|
||||
- `addBatch()` 方法使用 configHash 检测配置变化
|
||||
- 如果配置未变化，直接复用现有连接
|
||||
|
||||
## 预期总收益
|
||||
|
||||
| 优化项 | 预计收益 |
|
||||
|--------|----------|
|
||||
| 并行配置加载 | -300~500ms |
|
||||
| 模型解析缓存 | -200~400ms |
|
||||
| Bootstrap 并行化 | -200~400ms |
|
||||
| MCP 连接复用 | 已存在 |
|
||||
| **总计** | **-700~1300ms** |
|
||||
|
||||
**目标**: 将首次聊天请求从 ~5044ms 降到 **~2500-3500ms**
|
||||
|
||||
## 验证
|
||||
|
||||
1. 运行 TypeScript 类型检查:
|
||||
```bash
|
||||
cd /Users/apple/workspace/qimingcode/packages/opencode
|
||||
bun run typecheck
|
||||
```
|
||||
|
||||
2. 启动 QimingClaw 应用并测试首次聊天请求
|
||||
3. 查看 `~/.qimingclaw/logs/perf.*.log` 性能日志
|
||||
|
||||
## 后续优化建议
|
||||
|
||||
1. **LSP 懒加载**: 将 LSP 初始化延迟到首次使用时
|
||||
2. **文件监视器按需启动**: 只在有文件变更监听需求时才启动
|
||||
3. **网络请求压缩**: 启用 HTTP/2 和 gzip 压缩
|
||||
4. **提供商列表缓存**: 跨会话缓存提供商和模型列表
|
||||
194
qimingcode/docs/PERF-PLUGIN-INIT-2026-03-28.md
Normal file
194
qimingcode/docs/PERF-PLUGIN-INIT-2026-03-28.md
Normal file
@@ -0,0 +1,194 @@
|
||||
# plugin.init 性能优化 - 移除 npm 安装延迟
|
||||
|
||||
**日期**: 2026-03-28
|
||||
**影响版本**: qimingcode 1.1.64+
|
||||
**优化效果**: 首次聊天请求从 11s 降到 5s (-55%)
|
||||
|
||||
---
|
||||
|
||||
## 问题背景
|
||||
|
||||
QimingClaw 应用首次聊天请求耗时 12549ms，其中 `plugin.init` 占用 5428ms（59%）。
|
||||
|
||||
### 性能分析
|
||||
|
||||
| 阶段 | 耗时 | 占比 |
|
||||
|------|------|------|
|
||||
| ACP 握手 (plugin.init) | 7392ms | 59% |
|
||||
| 会话创建 (MCP 连接) | 5146ms | 41% |
|
||||
|
||||
**plugin.init 耗时分解**：
|
||||
```
|
||||
opencode-anthropic-auth@0.0.9 install: 1450ms
|
||||
@gitlab/opencode-gitlab-auth@1.3.0 install: 2427ms
|
||||
─────────────────────────────────────────────────
|
||||
总计: ~3900ms (占 plugin.init 的 72%)
|
||||
```
|
||||
|
||||
### 根因
|
||||
|
||||
每次引擎启动时，通过 `bun add` 从 npm 安装两个 BUILTIN 认证插件。
|
||||
|
||||
---
|
||||
|
||||
## 解决方案
|
||||
|
||||
### 方案 A：将 BUILTIN 插件改为 INTERNAL_PLUGINS（已实施）
|
||||
|
||||
**原理**：将 `opencode-anthropic-auth` 和 `@gitlab/opencode-gitlab-auth` 的源码直接复制到 qimingcode 中，像 `CodexAuthPlugin` 一样作为内部插件。
|
||||
|
||||
### 修改文件
|
||||
|
||||
1. **`src/plugin/anthropic.ts`** (新建)
|
||||
- 从 `opencode-anthropic-auth` npm 包转换
|
||||
- 使用 `@openauthjs/openauth/pkce` 进行 PKCE 认证
|
||||
- 支持 Claude Pro/Max OAuth 和 API Key 创建
|
||||
|
||||
2. **`src/plugin/gitlab.ts`** (新建)
|
||||
- 从 `@gitlab/opencode-gitlab-auth` npm 包转换
|
||||
- 使用 `Bun.serve` 替代 Fastify（避免额外依赖）
|
||||
- 支持 GitLab OAuth 和 Personal Access Token
|
||||
|
||||
3. **`src/plugin/index.ts`** (修改)
|
||||
```typescript
|
||||
// 删除
|
||||
// const BUILTIN = ["opencode-anthropic-auth@0.0.9", "@gitlab/opencode-gitlab-auth@1.3.0"]
|
||||
|
||||
// 添加导入
|
||||
import { AnthropicAuthPlugin } from "./anthropic"
|
||||
import { GitLabAuthPlugin } from "./gitlab"
|
||||
|
||||
// 修改 INTERNAL_PLUGINS
|
||||
const INTERNAL_PLUGINS: PluginInstance[] = [
|
||||
CodexAuthPlugin,
|
||||
CopilotAuthPlugin,
|
||||
AnthropicAuthPlugin,
|
||||
GitLabAuthPlugin
|
||||
]
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 技术细节
|
||||
|
||||
### TypeScript 类型适配
|
||||
|
||||
原始 npm 包使用 JavaScript，转换时需要正确处理类型：
|
||||
|
||||
```typescript
|
||||
// 定义回调结果类型
|
||||
type AuthCallbackResult =
|
||||
| { type: "failed" }
|
||||
| { type: "success"; provider?: string; refresh: string; access: string; expires: number }
|
||||
| { type: "success"; provider?: string; key: string }
|
||||
|
||||
// authorize 函数签名
|
||||
async authorize(_inputs?: Record<string, string>): Promise<AuthOuathResult>
|
||||
```
|
||||
|
||||
### GitLab 插件：Bun.serve 替代 Fastify
|
||||
|
||||
```typescript
|
||||
// 原始（Fastify）
|
||||
import fastify from "fastify"
|
||||
const app = fastify()
|
||||
app.get("/callback", async (req, reply) => { ... })
|
||||
await app.listen({ port: OAUTH_PORT })
|
||||
|
||||
// 修改后（Bun.serve）
|
||||
oauthServer = Bun.serve({
|
||||
port: OAUTH_PORT,
|
||||
fetch(req) {
|
||||
const url = new URL(req.url)
|
||||
if (url.pathname === "/callback") {
|
||||
// 处理回调
|
||||
return new Response(HTML_SUCCESS, { headers: { "Content-Type": "text/html" } })
|
||||
}
|
||||
return new Response("Not found", { status: 404 })
|
||||
},
|
||||
})
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## macOS 代码签名问题
|
||||
|
||||
### 现象
|
||||
|
||||
复制新构建的二进制到 `~/.qimingclaw/node_modules/qimingcode-darwin-arm64/bin/` 后，运行时收到 SIGKILL。
|
||||
|
||||
### 原因
|
||||
|
||||
macOS 代码签名验证机制会拒绝未正确签名的二进制文件。即使源文件有 adhoc 签名，复制后可能失效。
|
||||
|
||||
### 解决方案
|
||||
|
||||
复制后重新签名：
|
||||
|
||||
```bash
|
||||
codesign --force --sign - /path/to/qimingcode
|
||||
```
|
||||
|
||||
### CI/CD 建议
|
||||
|
||||
在构建流程中确保二进制被正确签名，或在 Electron 端安装逻辑中添加签名步骤。
|
||||
|
||||
---
|
||||
|
||||
## 优化效果
|
||||
|
||||
### 性能对比
|
||||
|
||||
| 指标 | 优化前 | 优化后 | 提升 |
|
||||
|------|--------|--------|------|
|
||||
| engine.getOrCreate | 5615ms | 1783ms | **-68%** |
|
||||
| acp.session.create | 5464ms | 3255ms | **-40%** |
|
||||
| 总请求耗时 | 11086ms | 5044ms | **-55%** |
|
||||
|
||||
### 详细日志
|
||||
|
||||
**优化前** (10:24:25):
|
||||
```
|
||||
[PERF] engine.getOrCreate: 5615ms project=1560772
|
||||
[PERF] acp.session.create: 5464ms mcpCount=1
|
||||
[PERF] /chat: 11086ms
|
||||
```
|
||||
|
||||
**优化后** (10:44:43):
|
||||
```
|
||||
[PERF] acp.init.handshake: 1779ms engine=qimingcode
|
||||
[PERF] engine.getOrCreate: 1783ms project=1560796
|
||||
[PERF] acp.session.create: 3255ms mcpCount=1
|
||||
[PERF] /chat: 5044ms
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 维护注意事项
|
||||
|
||||
1. **插件更新**：如果 Anthropic 或 GitLab 更改 OAuth 流程，需要同步更新 `anthropic.ts` 和 `gitlab.ts`
|
||||
|
||||
2. **依赖管理**：
|
||||
- `@openauthjs/openauth` 已在 package.json 中
|
||||
- GitLab 插件使用 Bun 内置能力，无额外依赖
|
||||
|
||||
3. **忽略旧插件**：`plugin/index.ts` 中已添加过滤逻辑，避免用户配置中的旧 npm 包被重复安装
|
||||
|
||||
---
|
||||
|
||||
## 相关文件
|
||||
|
||||
| 文件 | 说明 |
|
||||
|------|------|
|
||||
| `src/plugin/index.ts` | 插件系统入口 |
|
||||
| `src/plugin/anthropic.ts` | Anthropic OAuth 认证 |
|
||||
| `src/plugin/gitlab.ts` | GitLab OAuth 认证 |
|
||||
| `src/plugin/codex.ts` | 内部插件参考示例 |
|
||||
| `src/bun/index.ts` | BunProc.install 实现 |
|
||||
|
||||
---
|
||||
|
||||
## 参考
|
||||
|
||||
- 原始计划：`~/.claude/plans/witty-tumbling-ripple.md`
|
||||
- npm 包：`opencode-anthropic-auth@0.0.9`, `@gitlab/opencode-gitlab-auth@1.3.0`
|
||||
Reference in New Issue
Block a user