归档当前功能基线并完善工作区 Agent

README.dev.md

@@ -321,6 +321,43 @@ QStandardPaths::AppDataLocation/sounds/reminders/
 - 修改源码
 - 执行脚本或命令
 
+## 本地工作区 Agent v1b 独立窗口
+
+本地工作区 Agent 是旧文件操作 v1 的后续替代方向。当前已接入 v1a.1/v1b/v1b.5，并完成独立窗口化：工作区路径只保存在本次运行内，不执行任何写操作。
+
+当前支持：
+
+- `打开工作区 / 选择工作区`：用户主动选择一个目录后，程序扫描并建立内存索引
+- `当前工作区 / 扫描工作区`：查看当前工作区和重新扫描
+- `搜索 README / 搜索 main.cpp`：按文件名搜索，最多显示 30 个结果
+- `搜索包含 class 的文件 / 含class的文件 / 找一下含 class 的文件`：搜索文本内容，显示路径、行号和片段
+- `读取 main.cpp / 读取第一个`：读取工作区内文本文件，最多显示前 128KB
+- `总结这个文件 / 分析这个文件 / 解释 main.cpp / main.cpp 是干嘛的`：使用最近读取或指定工作区文件；AI 可用且空闲时补简短分析
+- `分析这个项目`：先显示本地结构摘要；AI 可用且空闲时再用独立工作区提示词补简短分析
+- `打开 README / 打开第一个`：打开工作区内普通文件，打开前二次确认
+- `打开 docs / 显示 main.cpp 所在位置 / 打开所在文件夹`：打开工作区内文件夹或文件所在目录
+- 独立 Agent 窗口：左侧展示文件结果、文本命中和上下文，中间展示用户任务、本地工具结果和 AI 分析，右侧展示选中项详情、文本命中详情、最近读取预览以及 v1c 预留的变更计划/Diff 空状态
+- 窗口入口：桌宠右键菜单、托盘菜单和全局快捷键，默认 `Alt+A`
+- 设置页 `Agent` 页：可启用/关闭窗口快捷键、修改快捷键、控制工作区命令完成后是否自动显示窗口
+
+安全规则：
+
+- 工作区只能由用户通过目录选择框选择
+- 拒绝 Windows 系统目录、符号链接目录和工作区外路径
+- 跳过 `.git`、`build`、`node_modules`、`dist`、`release_packages` 等目录
+- 默认拒绝读取 `.env`、密钥、凭证和包含 `secret/token/password/credential/private/api_key` 等关键词的敏感文件
+- 拒绝打开 `.exe/.bat/.cmd/.ps1/.vbs/.msi/.scr/.reg/.com/.pif/.lnk`
+- `读取文件` 这类泛泛请求仍走旧 `src/fileops/`；工作区读取建议使用 `读取 main.cpp` 或 `读取这个项目里的 README`
+- `打开工作区 / 选择工作区` 表示重新选择目录；查看状态使用 `当前工作区`
+- `创建 test.txt / 新建文件 / 写入 README / 修改 main.cpp / 修复 main.cpp / 优化 main.cpp` 当前只提示不支持，不弹读取文件选择框
+- 不执行命令，不创建/修改/移动/删除文件
+
+完整施工计划见：
+
+```text
+docs/agent/DesktopPet_本地工作区Agent_施工计划.md
+```
+
 ## 联网模式
 
 联网模式不是搜索引擎聚合器。用户在输入框打开“联网”开关后，普通聊天会进入当前 AI Provider 的原生联网能力：
@@ -329,6 +366,7 @@ QStandardPaths::AppDataLocation/sounds/reminders/
 - Google Gemini Provider：使用 Gemini Google Search grounding。
 - DeepSeek 官方 API：当前不提供托管联网搜索工具，显示“不支持原生联网”。
 - Custom / 第三方 OpenAI-Compatible：默认无法确认联网能力，不会尝试旧搜索页抓取。
+- 输入框“联网”开关在启用“记住输入框联网开关状态”时会随用户切换立即保存，不依赖发送消息。
 
 配置保存到：