README.md

@@ -37,6 +37,45 @@ DobotAI 是 WeKnora 的企业外部渠道集成层，负责钉钉协议、身份
 - **DobotAI PostgreSQL**：只保存渠道与业务编排数据，不保存 WeKnora 知识正文。
 - **Redis**：仅用于队列、重试、幂等租约和短期状态。
 
+## 目录结构
+
+```text
+.
+├── cmd/
+│   ├── dobotai/                 主程序入口、运行时装配与后台 Worker
+│   └── directory-import/        钉钉通讯录导入命令
+├── internal/
+│   ├── channels/dingtalk/       钉钉 Stream、卡片、媒体、反馈与群通知
+│   ├── qa/                      问答主流程、WeKnora 调用和检索信号记录
+│   ├── weknora/                 SSE、工具结果和引用解析
+│   ├── coverage/                覆盖判定、Support Case 和人工提醒
+│   ├── reasoningmode/           /think 推理模式
+│   ├── settings/                /setting 与首位管理员绑定
+│   ├── outboundimage/           resource:// 图片私有 OSS 外发
+│   ├── questiontable/           问题表工作流
+│   ├── faqtable/                FAQ 表工作流
+│   ├── directory/               钉钉通讯录查询与导入
+│   ├── audit/                   审计查询
+│   ├── httpapi/                 /healthz、/version、/v1/qa 与审计 API
+│   ├── core/                    核心领域类型
+│   ├── session/                 会话键和会话标题
+│   ├── agentbinding/            渠道到 WeKnora Agent 的绑定
+│   ├── feedback/                点赞/点踩领域逻辑
+│   ├── secretstore/             本地密钥引用存储
+│   ├── dingtalkconfig/          钉钉凭据校验
+│   ├── runtime/                 运行时管理
+│   └── store/postgres/          PostgreSQL 持久化实现
+├── db/migrations/               SQL 迁移及其契约测试
+├── deploy/dobotai-dingtalk/     容器 Compose、安装/配置/启动/绑定脚本和部署手册
+├── docs/                        架构说明与 API 边界文档
+├── scripts/                     本地部署与部署资产契约测试
+├── Dockerfile                   DobotAI 容器镜像构建
+├── .env.example                 无真实凭据的配置示例
+└── README.md                    项目功能、边界和开发说明
+```
+
+目录职责规则：`cmd/`只装配进程，`internal/`承载业务模块，`internal/store/postgres/`只实现数据库持久化，`db/migrations/`只放Schema变更，`deploy/`只放容器运行资产。历史计划、备份、镜像归档和真实环境文件均不进入Git。
+
 ## 钉钉 Stream
 
 使用官方 `dingtalk-stream-sdk-go`，不暴露公网回调入口。
@@ -87,6 +126,7 @@ dobotai bootstrap-admin
 
 - 有结构化检索引用的回答标记为已覆盖；
 - 没有引用但已执行检索的回答标记为未覆盖；
+- 没有引用且未执行检索的文本标记为 `covered_non_knowledge_response`，不创建 Support Case；
 - 纯图片视觉识别单独记录为 `covered_visual_recognition`，不计入“未覆盖”；
 - 无权威知识时，产品统一回复：`当前暂无已发布的权威知识，暂不建议操作。`；
 - 人工通知只带当前问题和同一用户此前最多5个问题，不包含回答、引用或置信度；
@@ -128,6 +168,7 @@ DobotAI 使用独立 PostgreSQL，禁止指向 WeKnora 数据库。生产部署
 000001_core ... 000018_coverage_visual_recognition_reason
 000019_reasoning_mode_state
 000020_feedback_support_trigger
+000021_coverage_non_knowledge_response_reason
 ```
 
 迁移前应执行逻辑备份并验证恢复；迁移、二进制部署和钉钉渠道切换是独立步骤，不能把健康检查代替真实渠道验收。