Files
wecom_it_smart_desk/docs/02-技术文档/实现配置/dify变更日志.md
T
Simon facc04aa65 chore: docs 结构整改 + compose 双目录对齐(合并重建提交)
本提交为 .git 对象库损坏后的重建提交,内容等价于原先三个本地提交
(5e2fd4c2 / 57a53c98 / 5d7e1873)的累积结果,未做任何额外改动。

一、docs 结构整改(整改 #14)
根因:重构时新结构为 untracked 文件,执行 git stash(未带 -u)未纳入,
随后 git reset 拉回 HEAD 旧 tracked 树,导致旧树复活、新旧两棵目录
树并存于 docs/,共 791 文件、双分类体系冲突。

修复动作:
- b2 同名异主题文件改名迁移保全 9 个
- C 类 39 个孤立文件按主题正确归类
- A/B1 类 222 个重复文件删除(新结构已有内容副本)
- 9 个旧独有空目录删除
- 270 处内部引用按 verified 映射改写
- 整改记录 #14 登记于 04-运维文档/部署运维

结果:docs 791 → 569 文件,顶层仅规范 8 类 + 治理文件,单树恢复。
残留:约 20 处指向从未存在文件的陈旧死链,归入独立文档卫生任务。

二、compose 双目录对齐(消除踩坑 A)
- docker-compose.yml:nginx 前端挂载全部由根目录 frontend-*/dist
  改为 src/frontend-*/dist(h5 / agent / admin / terminal)
- docker-compose.dev.yml:dev 服务 build context 与卷同步改 src/
- 效果:本地 docker compose up 不再把根目录 stale dist 挂回,
  与线上一致,分叉隐患消除(已 docker compose config 校验通过)

防复发铁律:
- 重构须提交;仓库修复须 git stash -u 或先 commit
- 新结构须 git add 并提交,避免再次 untracked 复活
- H5 改动只动 src/frontend-h5/,禁改根目录遗留 frontend-*/
2026-08-07 22:31:32 +08:00

39 lines
1.3 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# Dify 变更日志
> 用于记录 Dify 应用的 DSL 备份、配置修改等操作,便于版本追溯。
---
## ⚠️ 重要:发布机制说明
> **所有 Dify 工作流修改必须手动发布**
Dify 的工作流(Workflow)修改后:
- **保存 ≠ 发布**:点击保存只是保存了草稿
- **必须点击「发布」按钮**:新版本才会真正生效
- **未发布的表现**:修改了 Prompt 或节点逻辑,但 API 调用时行为未变化
**故障排查优先检查**:遇到 Dify 行为与预期不符时,首先检查是否点击了「发布」按钮。
---
## 2026-07-24
- **应用**:智能IT支持-员工咨询
- **操作**:规范整理,迁移历史备份文件
- **文件**
- `itdesk_main_v1_clean.yml`(由 dify_export_clean.yaml 迁移)
- `itdesk_main_v2_result.yml`(由 dify_export_result.yaml 迁移)
- `itdesk_main_BACKUP.yml`(由 dify_export_BACKUP.yaml 迁移)
- **备注**:建立统一的 DSL 备份规范和存储目录
---
## 2026-07-24(续)
- **应用**:智能IT支持-员工咨询
- **操作**:修复"打印机"被误判为非IT业务的问题
- **文件**`itdesk_main_2026-7-24_打印机-fix.yml`
- **变更内容**:添加"打印机"短Query示例,intent_type=it_consult
- **原因**:用户输入"打印机"自动进入排队,原因是Dify缺少简短Query的示例