qa-source-index

name	QA_source_index
kind	docs
description	莲莲Bot 源码与文档索引。用于回答“去哪里查”“某功能在哪改”“测试该跑什么”的代码库问题，减少盲目全库搜索。

QA Source Index

当用户问到莲莲Bot的实现、配置、部署、测试或前端入口时，先用本索引定位候选文件，再根据可用工具读取实际源码。不要只凭索引给结论。

Agent 与工具

• Agent 主循环：packages/koishi-plugin-dongxuelian-ai/lib/agent/engine.js
• Agent 消息构建：packages/koishi-plugin-dongxuelian-ai/lib/agent/messages.js
• Agent 工具注册：packages/koishi-plugin-dongxuelian-ai/lib/agent/tools/registry.js
• 工具开关与默认权限：packages/koishi-plugin-dongxuelian-ai/lib/agent/config.js
• 危险工具审批：packages/koishi-plugin-dongxuelian-ai/lib/agent/safety.js、packages/koishi-plugin-dongxuelian-ai/lib/agent/pending.js
• 路径边界：packages/koishi-plugin-dongxuelian-ai/lib/agent/path-guard.js

Skill 与人格

• 实用 Skill 索引和按需读取：packages/koishi-plugin-dongxuelian-ai/lib/agent/skills.js
• Skill 开关命令：packages/koishi-plugin-dongxuelian-ai/lib/agent/skill-hub.js
• Agent 人格上下文：packages/koishi-plugin-dongxuelian-ai/lib/agent/persona-context.js
• 普通聊天人格管理：packages/koishi-plugin-dongxuelian-ai/lib/persona.js
• 人格文件目录：packages/koishi-plugin-dongxuelian-ai/data/ai-skills/personas/
• 核心安全规则目录：packages/koishi-plugin-dongxuelian-ai/data/ai-skills/core/

搜索与浏览器

• 搜索查询规划与结果打分：packages/koishi-plugin-dongxuelian-ai/lib/agent/search-query.js
• web_search 工具：packages/koishi-plugin-dongxuelian-ai/lib/agent/tools/web-search.js
• 浏览器工具：packages/koishi-plugin-dongxuelian-ai/lib/agent/tools/browser-action.js
• QQ 显式搜索路由：packages/koishi-plugin-dongxuelian-ai/lib/agent/router.js

QQ 命令和聊天链路

• Koishi 插件入口：packages/koishi-plugin-dongxuelian-ai/lib/index.js
• 命令路由：packages/koishi-plugin-dongxuelian-ai/lib/handler.js
• 普通聊天：packages/koishi-plugin-dongxuelian-ai/lib/chat.js
• API 调用与 fallback：packages/koishi-plugin-dongxuelian-ai/lib/api.js
• 对话、记忆与摘要：packages/koishi-plugin-dongxuelian-ai/lib/conversation.js
• 防越狱规则：packages/koishi-plugin-dongxuelian-ai/lib/rulesets/jailbreak.js

前端与 Dashboard

• 独立 Agent Console：packages/agent-console/src/main.tsx
• Agent Console API 客户端：packages/agent-console/src/api/client.ts
• Agent Console 样式：packages/agent-console/src/styles.css
• Dashboard standalone 后端：packages/koishi-plugin-dashboard/standalone.js
• Dashboard Agent 面板：packages/koishi-plugin-dashboard/frontend/src/components/AgentPanel.vue

测试与质量门禁

• 结构测试：packages/koishi-plugin-dongxuelian-ai/test/cascade-test.js
• 场景测试入口：packages/koishi-plugin-dongxuelian-ai/test/scenario-test.js
• 聊天场景：packages/koishi-plugin-dongxuelian-ai/test/scenarios/chat.test.js
• 命令场景：packages/koishi-plugin-dongxuelian-ai/test/scenarios/command.test.js
• fake 数据目录：packages/koishi-plugin-dongxuelian-ai/test/fake/file.js
• 根检查命令：package.json 的 scripts.check

新增生产 JS 模块时，必须同步 package.json 的 check 脚本、cascade-test.js 的模块路径、导出、语法检查和重复函数扫描列表。

部署

• AI 包部署：scripts/ai.sh
• 通用包部署：scripts/deploy-package.sh
• 重启脚本：scripts/restart-bot.sh
• 初始化脚本：setup.sh

部署时不要覆盖服务器私有配置和运行数据。ai-skills 会跟随 AI 包复制，但核心/persona 等目录中的已有用户内容需要谨慎处理。