lxy/DevFlow
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

文档: AI文件操作工具手册扩充至10工具全量并归档08-用户指南目录+INDEX更新

Browse Source
This commit is contained in:
绝尘
2026-06-16 03:12:25 +08:00
parent 4dc5219a3c
commit 49e61d4153
3 changed files with 385 additions and 203 deletions
Download Patch File Download Diff File Expand all files Collapse all files

39
docs/INDEX.md
View File

@@ -1,7 +1,7 @@
# DevFlow 文档索引
> 创建: 2026-06-10 | 当前阶段: Phase 2 本地优先开发流程验证
> 更新: 2026-06-14 | 新增功能创意池（5 个架构创意：演化/时效/回溯/债务/契约，待评估）
> 更新: 2026-06-16 | 文件操作工具手册更新（10 工具全量）；任务推进链决策定稿；06-15/16 审查文档补录
---
@@ -12,6 +12,7 @@ docs/
├── README.md # 快速开始与文档导航
├── INDEX.md # 本文件 — 文档导航
├── todo.md # 工作看板（任务/bug 跟踪）
├── 待决策论证-2026-06-16.md # 7 项决策论证（D-01~04 已定 / DEC-01~03 已闭环）
├── 01-技术文档/
│ ├── SQLite-CRUD模式-2026-06-12.md
│ └── Tauri-IPC模式-2026-06-12.md
@@ -31,9 +32,13 @@ docs/
│ ├── B-03-人工审批响应机制-2026-06-14.md
│ ├── aichat审查报告-2026-06-14.md # AI Chat 模块代码审查
│ ├── aichat异步审批构想-2026-06-14.md
│ ├── aichat交互体验改进方案-2026-06-14.md
│ ├── aichat授权体验改进方案-2026-06-14.md
│ ├── aichat信息密度构想-2026-06-14.md
│ ├── 任务推进构想-2026-06-14.md
│ ├── 任务推进链实施路径-2026-06-16.md # 4 阶段实施路径（阶段1决策已定）
│ ├── aichat流式Markdown渲染调研-2026-06-15.md # 流式渲染优化方案（rAF节流/块级diff/换库）
│ ├── patch_file工具设计-2026-06-15.md # patch_file 完整设计（API/三层防御/边界情况）
│ ├── 工作流审批审查报告-2026-06-14.md
│ ├── F-07-df-ai-core-trait下沉设计-2026-06-14.md
│ ├── 密钥迁移健壮性-2026-06-15.md
@@ -61,23 +66,27 @@ docs/
│ ├── 架构审查-2026-06-15.md # 纯架构层（边界/依赖/抽象/扩展性），8 crate + 前端（2 路并行）
│ ├── 自研块级memo流式渲染审查-2026-06-15.md # ARC-260615-08 实施走查（splitBlocks/parseBlock/rAF）
│ ├── 工作区多角度走查-2026-06-15.md # 工作区22文件547行4路并行（selectType/队列收尾/骨架屏/i18n/DRY）
│ ├── 定时走查-2026-06-15-P0复核.md # 定时走查第1轮：B-34已修（B-32·33结论后被第2轮纠正为已修）/B-35 broadcast Lagged新P0/aiShared破环亮点
│ ├── 定时走查-2026-06-15-第2轮.md # 定时走查第2轮：B-32·33·34全修确认（第3次纠正过时）/AR-11前端listener永不attach新P0/ARC-05 store拆分优/CR-11健壮性✅
│ ├── 定时走查-2026-06-15-第3轮.md # 定时走查第3轮：走查价值闭环(AR-11/B-35/CR-18·19全修确认+CR-20撤销误判)/前端P0全闭环/CR-21 App.vue try/catch轻量
│ ├── 定时走查-2026-06-15-第4轮.md # 定时走查第4轮：i18n垂直切片(key树466全对齐优秀)/硬编码40+处(CR-08扩展)/P1-1 useAiEvents:182 i18n破坏bug改一行最高ROI
│ ├── 定时走查-2026-06-15-第5轮.md # 定时走查第5轮：api垂直切片/Tauri v2默认转camelCase权威裁决(代理A 6处IPC遗漏假阳性纠正)/B-34错误注释传播误导(CR-23)/types对齐良好
│ ├── 定时走查-2026-06-15-第6轮.md # 定时走查第6轮：列表页+Dashboard+AI窗口垂直切片/分离窗口生命周期P1(listener双注册+永不清理CR-24)/状态机缺口(CR-25)/列表页契约(CR-26)/Dashboard(CR-27)
│ ├── 定时走查-2026-06-15-第7轮.md # 定时走查第7轮：stores垂直切片/CR-24·26·27三修确认(价值第6闭环)/knowledge error通道断P1(CR-28,CR-08深化)/ai.ts状态机完整亮点(验证修复质量)
│ ├── 定时走查-2026-06-15-第8轮.md # 定时走查第8轮(前端收尾)：CR-25·28·30三修确认(价值第7闭环)/CR-30污染修复/收尾小区域无必修(CR-31 useConfirm/ToolCardList)+5亮点(XSS防护链/useConfirm DRY)/8轮总结+停止cron建议
│ ├── 定时走查-2026-06-15-P0复核.md # 定时走查第1轮
│ ├── 定时走查-2026-06-15-第2轮.md # 定时走查第2轮
│ ├── 定时走查-2026-06-15-第3轮.md # 定时走查第3轮
│ ├── 定时走查-2026-06-15-第4轮.md # 定时走查第4轮
│ ├── 定时走查-2026-06-15-第5轮.md # 定时走查第5轮
│ ├── 定时走查-2026-06-15-第6轮.md # 定时走查第6轮
│ ├── 定时走查-2026-06-15-第7轮.md # 定时走查第7轮
│ ├── 定时走查-2026-06-15-第8轮.md # 定时走查第8轮（前端收尾）
│ ├── 全局代码review-2026-06-15.md # 7维度并行（DRY/架构/bug/安全/AI可靠/工作流），P1×6+P2×13全闭环
│ └── 文档全量核对报告-2026-06-15.md # docs全量+根目录4路核对（ARCHITECTURE漂移/模块文档过期/审查状态断层）
│ ├── 文档全量核对报告-2026-06-15.md # docs全量+根目录4路核对（ARCHITECTURE漂移/模块文档过期/审查状态断层）
│ ├── 任务模块问题分析-2026-06-16.md # 任务模块18项核对（真bug 7+增强5+假3+去重3）
│ └── 任务执行与推进能力分析-2026-06-16.md # 推进能力实现度0%，4阶段路径+决策点
├── 06-前端开发/
│ └── View改造指南-2026-06-12.md
├── 07-项目管理/
│ ├── Phase1任务清单-2026-06-12.md
│ └── Phase2计划-2026-06-12.md
├── 08-用户指南/
│ └── 使用手册-2026-06-12.md
│ ├── 使用手册-2026-06-12.md # 用户手册（对齐 06-15 代码基线）
│ ├── AI文件操作工具手册.md # AI 工具 API 全量参考（10 工具，2026-06-16 更新）
│ └── patch_file使用指南.md # patch_file 专项使用指南
└── 09-问题排查/
└── aichat-apikey-401排查-2026-06-15.md
```
@@ -90,6 +99,7 @@ docs/
|------|------|------|
| 🚀 快速开始 | [README.md](./README.md) | 安装、启动、快速上手 |
| 📖 使用手册 | [使用手册-2026-06-12.md](./08-用户指南/使用手册-2026-06-12.md) | 用户手册 |
| 🔧 AI 工具手册 | [AI文件操作工具手册.md](./08-用户指南/AI文件操作工具手册.md) | 10 个文件操作工具 API 参考 |
| 📋 项目进度 | [PROGRESS.md](../PROGRESS.md) | 实时项目进展与状态 |
| ⚙️ 技术文档 | [01-技术文档/](./01-技术文档/) | SQLite CRUD、Tauri IPC 等技术专题 |
| 🏗️ 架构设计 | [02-架构设计/](./02-架构设计/) | 架构方案、设计决策、产品定位调整 |
@@ -98,7 +108,7 @@ docs/
| 🔍 代码审查 | [05-代码审查/](./05-代码审查/) | 审查报告、代码质量分析 |
| 🎨 前端开发 | [06-前端开发/](./06-前端开发/) | Vue 3 前端分析、优化、迁移指南 |
| 📊 项目管理 | [07-项目管理/](./07-项目管理/) | 任务清单、开发计划、进度跟踪 |
| 📚 用户指南 | [08-用户指南/](./08-用户指南/) | 快速上手、配置指南、FAQ |
| 📚 用户指南 | [08-用户指南/](./08-用户指南/) | 使用手册、工具指南、FAQ |
| 🐛 问题排查 | [09-问题排查/](./09-问题排查/) | 排查记录、根因分析 |
---
@@ -122,8 +132,9 @@ docs/
| 文档 | 路径 | 说明 |
|------|------|------|
| 架构设计 | `../ARCHITECTURE.md` | 22,745 字完整架构文档 |
| 架构设计 | `../ARCHITECTURE.md` | 完整架构文档 |
| 项目进展 | `../PROGRESS.md` | 工作进展与交接 |
| 工作看板 | `./todo.md` | 任务/bug 跟踪（含决策记录） |
| Crate 结构 | `../ARCHITECTURE.md#四crate-结构` | 8 个 Crate 概览 |
| 数据模型 | `../ARCHITECTURE.md#六数据模型` | SQLite 表结构定义 |
| Phase 规划 | `../ARCHITECTURE.md#八phase-规划` | 5 个 Phase 路线图 |
@@ -139,4 +150,4 @@ docs/
| Engine | Rust Workspace (8 crate) | 多 crate 架构 |
| Storage | SQLite (rusqlite) | 本地优先，零运维 |
| AI | Multi-Provider | Claude/GLM/DeepSeek/OpenAI 兼容 |
| Build | Bun + Vite | 前端构建 |
| Build | npm + Vite | 前端构建（不要使用 bun） |