CmdCode 项目上下文传递提示词

项目身份

名称：CmdCode
版本：v0.5.0 (实质接近 v0.6.0 成熟度)
定位：基于 Bun 的 AI 编程助手 CLI，具备双路记忆、PAVR 循环、WebUI 与 QQ Bot 集成
运行环境：Debian/Ubuntu，用户 administrator，Bun 1.3.x，支持 SSE 流式响应的 Web 后端

项目路径与入口

• 项目根目录：/home/administrator/CmdCode-V0.5
• 主入口：src/cli.ts (约 795 行，纯调度中心)
• 命令模块：src/commands/ (9 个文件，每个处理一类 REPL 命令)
• 记忆系统：src/memory/ (FTS5 + 向量 + RRF 融合)
• PAVR 增强环：src/intent/, src/planner/, src/verifier/, src/resilience/, src/ui/ (已激活)
• WebUI 前端：webui/index.html (单文件 SPA，约 1200 行)
• Web 后端：src/web.ts (REST + SSE，端口 3010)

架构拆分 (已完成)

所有 REPL 命令处理均从 cli.ts 抽取为独立模块，每个模块通过参数接收颜色常量与交互函数。cli.ts 仅保留启动初始化、参数解析、信号处理，REPL 主循环委托给 commands/repl.ts。

安全加固 (已验证通过)

• 密钥通过 AES-256-CBC 加密存储于 ~/.cmdcode/secrets.enc，无硬编码密钥
• 所有 AI 输出经 ChatEngine.maskKeys() 脱敏，替换 API Key 格式为 ****
• QQ Bot 的 access_token 带 5 分钟内存缓存，减少重复鉴权
• 工具结果存储前同样经过脱敏
• RRF 融合前对搜索结果去重
• 危险命令正则预编译为模块级常量，避免重复创建
• 沙箱路径检查改为基于 homedir() 的动态安全路径

双路记忆系统 (生产可用)

• 数据库 SQLite，FTS5 使用 trigram 分词器支持中文
• 嵌入模型：doubao-embedding-vision (ARK API)，硬编码配置在 src/memory/embedding.ts
• 搜索融合：向量余弦相似度 + FTS5 关键词匹配，经 RRF (k=60) 排序，结果去重
• 自动上下文注入：当非系统消息 ≥10 条时，提取最后用户消息进行双路搜索，召回 5 条最相关记忆注入 System Prompt
• 启动时检查嵌入密钥可用性，缺失则提示配置方法

PAVR 循环 (已启用但待实战验证)

• 全局开关：src/chat-factory.ts 中 globalPAVREnabled = true
• 流程：意图识别 → 计划生成 → 分步执行 (带进度条) → 验证 (语法/测试) → 响应
• 所有相关模块共 21 个文件，代码量约 100KB
• 已知缺陷已修复：progress.setProgress 改为安全调用，风险信息序列化问题已解决

内置模型列表 (共 7 个)

显示名称	模型 ID	厂商	接口地址	费用
GLM-4.7-Flash	glm-4.7-flash	智谱AI	open.bigmodel.cn/api/paas/v4	免费
Hunyuan-Lite	hunyuan-lite	腾讯混元	api.hunyuan.cloud.tencent.com/v1	免费
DeepSeek V4 Flash	deepseek-v4-flash	DeepSeek	api.deepseek.com/v1	付费
DeepSeek V4 Pro	deepseek-v4-pro	DeepSeek	api.deepseek.com/v1	付费
MiniMax-M2.7	minimax-m2.7	MiniMax	api.minimaxi.com/v1	付费
GLM-5.1 (火山引擎)	glm-5.1	字节跳动	ark.cn-beijing.volces.com/api/coding/v3	付费
GLM-5 (腾讯云)	glm-5	腾讯云	api.lkeap.cloud.tencent.com/coding/v3	付费

WebUI (功能较完整)

• 文件：webui/index.html (单文件，无框架)
• 已实现：登录/注册、会话列表、SSE 流式聊天、代码高亮 (highlight.js)、模型选择器、记忆搜索面板、文件浏览、移动端响应式适配
• 端口：Web 后端 (src/web.ts) 监听 3010，ttyd 终端 8080，Python 前端服务 8081

已知待办事项

1. 安全加固：外部文件 models_config.json 含多厂商明文 API Key，需迁入 secrets.enc 加密存储
2. PAVR 实战验证：用 HumanEval 或 SWE‑bench 测试 PAVR 启用后的通过率和延迟
3. Web 服务器端口统一：将前端静态服务合并到 Bun 的 3010 端口，停用 8081
4. access_token 持久化：将 QQ Bot 的 token 缓存加密存储，进程重启不失效
5. WebUI 记忆面板增强：显示时间戳、相似度分数等信息
6. WebUI 文件浏览增强：增加面包屑导航

首步操作指令

请先访问 https://cmdcode.cn/CmdCode/code/ 遍历所有链接，下载或缓存全部源文件（约 55 个 TypeScript 文件 + 1 个 HTML 文件），以获取最新代码状态。完成缓存后，汇报当前代码的结构概览与任何与上述描述不一致的差异，然后即可开始下一优化任务。