lite-work v0.4.0

版本范围

本说明覆盖 项目首次 GitHub Release（完整项目历史） 之间的全部提交和功能变化。

核心功能

• 多窗口本地桌面模式：每个窗口拥有独立 Python Core、任务流、审批状态和 workspace。
• 同一项目支持多个窗口，每个窗口独立维护会话 Tab、文件 Tab 和运行时状态。
• 会话模型支持系统默认模型与当前会话独立模型，模型选择会持久化并在后续任务中生效。
• 改进流式响应：安全 UTF-8 解码、React 实时缓冲、SSE 终止事件和 LLM 硬超时。
• 停止任务支持协作式 abort、异步任务取消，以及 task ID 尚未返回时的延迟停止。

项目与办公

• 侧边栏「项目」页签：打开/新建项目与代码（新建代码默认 git init）、最近项目列表，先项目后对话的两级信息架构。
• 产出物面板：ZIP 一键打包下载（含素材）、按 scope 清空、单文件删除。
• Composer 支持粘贴图片与拖拽文件，上传即插入路径引用交给 Agent 处理。
• Office 工具链：docx_create/docx_append 迭代写作、xlsx/pptx/pdf 生成、data_analyze 文件直读（xlsx/csv/json）、chart_make 图表。
• diagram-to-office 技能：PlantUML/Mermaid 离线渲染成图嵌入 Word/PPT（@plantuml/core 纯 JS + resvg，无需 Java）。

代码分析工具

• get_file_outline 支持 Python、TypeScript、JavaScript、Java、Go。
• read_focused_symbol 支持 Python、TypeScript、JavaScript、Java、Go。
• Python 使用标准库 ast；TypeScript/JavaScript/Java/Go 使用对应 Tree-sitter grammar。
• 支持类、函数、异步函数、方法和 Go 类型等符号提取，目标符号缺失和语法错误返回明确错误。

安全与工程质量

• 项目外文件读取和写入采用分级审批，读取授权不能升级为写入授权。
• 交互区气泡类提示均有退出机制（TTL/随任务结束/手动关闭），UI 交互约定固化到 README。
• Windows 构建在依赖未变化时跳过 pip 安装，PyInstaller 默认复用缓存，-Clean 用于干净发布构建。

安装包

• macOS Apple Silicon：*.dmg
• Windows x64：*.exe

完整提交列表（项目初始提交到 v0.4.0）

• chore: init Python backend (core/llm/tools/security/server/orchestration + tests) (2039c68)
• feat: React Web UI + Electron desktop shell + packaging scripts (c21b911)
• docs: 16-lesson Python tutorial (AI-Coding-Agent-Dummy-Book) (ecc8d65)
• fix: wrap tutorial links in <> to fix GitBook parsing of CJK filenames (d2c6199)
• fix: replace ASCII parens with full-width in filenames to fix GitBook markdown links (a247b11)
• docs: add GitBook online reading link to README (c0ede4d)
• feat: switch default DeepSeek model to deepseek-v4-flash (V4 series), update base_url & pricing (3be5792)
• feat: stability hardening (loading page, error boundary, stalled detection, debug panel, SSE reconnection, crash recovery) (b583c10)
• fix: stability hardening - write missing files (api.ts, main.tsx, styles.css, server/app.py) (725b6a2)
• Fix the markdown links. (4c99970)
• feat: v0.2.0rc0 - OpenCode风格交互重写 + 教程补充 + 自动发布 (9c7bf5e)
• fix: release workflow - install web frontend deps before build:web (3bbca69)
• fix: release workflow - macOS only, install web deps, disable signing (10038fd)
• chore: remove release workflow (49e08a9)
• fix: build script - add mirror env vars for electron-builder, update README (4f3c805)
• fix: 热切换工作区 + 修复脱敏 API key 导致的 ASCII 编码错误 (25093cd)
• docs: 更新第19课 Electron 打开项目热切换说明 (639e2a9)
• feat: Windows 打包支持 (a18a7b0)
• fix: Windows 打包图标支持 (6e33a25)
• fix: API key 持久化 + Windows 打包 extraResources 修复 (109dc27)
• docs: 教程重构为教材体例 + 同步 README (16d6eb7)
• feat: v0.3.0 缓存优化 + models.dev 元数据 + 上下文可观测性 + streaming 抖动修复 (04b5eb9)
• feat: opencode 风格上下文摘要压缩 + 文件修改 diff 展示 (0bb8863)
• feat: FileDiff 共享组件抽取 + 对话流工具卡片 + v0.5.0 版本号 (a34bdc5)
• docs: 教程 1-8 课语言润色，去除 AI 味 (ed7aa6b)
• feat: 停止任务强杀机制（LLM 流卡住时可解套） (6ad50e5)
• chore: 删除扫描临时输出文件 scan_result.txt (8a2d519)
• refactor: 移除右侧工具调用 tab，ToolPanel 只保留上下文情况 (2e80369)
• style: 工具调用卡片与回复气泡统一宽度约束 (049b9db)
• docs: 第19课同步 UI 最新实现 (c3ea776)
• feat: v0.6.0rc0 — webfetch 工具（缓存/批量）、Cordis 工具插件化、侧边栏真实目录树（git 状态徽标 + 动态刷新） (7e90550)
• fix: v0.6.1rc0 — 修复 tool_calls 原子对引发的 HTTP 400（空 id / 残缺历史） (36feea5)
• fix: v0.6.2rc0 — plan 只读模式失效（工具裁剪被插件重注册污染）+ Windows 沙箱规则 (376da12)
• feat: v0.6.3rc0 — macOS 沙箱规则（csrutil/diskutil/家目录删除/钥匙串等） (8ed234b)
• feat: v0.7.0rc0 - 多 Tab 工作台 + 文件查看器 + 代码 diff 展示 (d14c26b)
• feat: UnifiedDiff 组件 - 行级 diff 渲染（仿 OpenCode） (711a5c5)
• perf: 打包加速 + 进度显示 (fc82545)
• perf: PyInstaller --onefile → --onedir（打包快 2-3x，产物是文件夹） (70abe4e)
• docs: 第19课同步 v0.8.0rc0 — 多 Tab 工作台、UnifiedDiff 行级 diff、打包加速 (2cb5991)
• fix: extraResources 适配 --onedir 目录结构，后端进包修复 (64852f3)
• fix: Tab 标题使用会话名 + 过滤空会话 (b7d1fb7)
• feat: v0.8.1 会话绑定项目 + 切项目弹窗询问 + 重构新建对话 (b08985c)
• feat: v0.8.1 会话绑定项目 + 切项目弹窗询问 + 新建对话创建 session (cd9734a)
• release: v0.9.1rc0 (5594aaa)
• release: v0.9.2rc0 (8ad2e4b)
• fix: stabilize desktop release workflow (3f4467f)
• fix: restore v0.9.5 features and configuration (c0f02d4)
• fix: 安全规则热加载改为合并语义（代码基线永不失效）+ 测试 Windows 兼容 (35822e0)
• release: v0.10.0 — MCP 接入、Skills 系统、教程重构 22 课与桌面体验升级 (f98f673)
• fix(security): 封堵白名单前缀绕过与优先级倒置漏洞 (6f2b284)
• release: v0.11.0 — Plan Agent 感知、压缩器前缀对齐与 MCP 管理界面 (0dc76f7)
• release: v0.12.0 — LLM 自定义 Header + 版本号单一事实源 (bf0e464)
• fix: models.dev 启动阻塞——改为后台异步刷新 + TTL 挡板 (v0.12.1) (6aa4921)
• release: v0.12.2 — 持久化日志与自定义 Header 修复 (64052b3)
• docs: 同步教程中的配置与发布说明 (58be01f)
• release: v0.13.0 — 统计并入上下文面板，终端迁至侧边栏，右面板三 Tab (63f145c)
• fix: 终端高度/侧边栏宽度/打开项目跳文件 + 缓存感知成本定价 (eb44827)
• fix: per-model 定价、货币符号、会话严格绑定项目与窗口最大化 (e4a9066)
• docs: 精简教程教训标注 (004a7e9)
• feat: 执行中补充指令 / MCP 改名 / TODO 清单工具 / /compact 手动压缩 (31f304e)
• feat: Skill 权限控制（allow/deny/ask）+ TODO 清单持久化 (b73a6cd)
• fix: LLM 瞬时故障自动重试 + 运行中输入排队修复 + test_server 提速 (e6e8112)
• feat: 会话/技能/子Agent 多项增强 (b4e05e8)
• feat: 子Agent流式显示与归档持久化 + 写类工具精细并行化 + ask_user提问交互 (6fffaf1)
• feat: Plan Agent 支持 ask_user + 工具Tab按Agent切换刷新 (49c9bba)
• feat: 教程从 22 课重组为 24 课（合并 3 对知识课 + 新增 5 门实战课） (6f4150e)
• feat: 推理强度控制 reasoning_effort（适配器层 + 设置弹窗 + 主输入框快速设置） (e8681e4)
• fix: 主界面显示实际生效的模型与 reasoning_effort（会话 override 优先，否则回退供应商默认） (bc78d51)
• docs: 同步实际生效模型与推理档位教程 (38da734)
• fix: 会话模型兜底项显示内部ID与双击会话后终端工作区未同步（v0.14.1） (c2607cd)
• fix: review_code 对 .tsx/.jsx 的 JSX 语法误报 (4bd6016)
• feat: custom_headers 支持 {session_id}/{conversation_id}/{workspace}/{model}/{provider} 模板变量 (9bcab32)
• chore: bump version to 0.14.2 (8d63ef5)
• feat: 转型 GAI 通用入口——新增办公/调研模式与生产力工具集 (abeec77)
• feat: 办公依赖随主安装 + 侧边栏「产出物」Tab 预览与下载 (0114a31)
• style: 设置弹窗加宽1/3，按钮居中且高度统一 (0161810)
• feat: 待发送队列（PendingQueue）v1.0.0 升级 (6bb86d4)
• chore: merge latest main into feat/lite-work (7e7fee2)
• chore: rebrand lite-code to lite-work v0.1.0 (eb8603e)
• fix: merge lite-code main fix - 待发送队列固定在输入框上方，不随对话滚动 (a638008)
• feat: 更换 lite-work 新 logo（闪电⚡lite + 齿轮⚙work，替换原代码括号图标） (a0828f2)
• feat: 新增 diagram-to-office 技能（PlantUML/Mermaid 转图片嵌入 Word/PPT） (a7fa9c7)
• feat: diagram-to-office 支持离线预装引擎与内置兜底渲染 (4c339e9)
• feat: PlantUML 纯 JS 离线渲染（@plantuml/core + @resvg/resvg-js，无需 Java） (aad7716)
• chore: 版本升级 v0.2.0，关于弹窗移除重复的 GitHub 仓库链接 (8f3994e)
• feat: 产出物 ZIP 一键下载/清理 + 新建项目（默认 git） (877bafb)
• fix: 子 Agent 完成记录显示 20 秒后自动消失 (79da0bb)
• feat: PlantUML 安全写法规则固化到技能 + 渲染前预校验 (ec9912a)
• fix: 「已注入技能」气泡显示 20 秒后自动消失 (f495f2d)
• refactor: 技能注入气泡改为随任务生命周期显示，撤回固定 20s TTL (d566fc9)
• docs: README 固化 UI 交互约定——气泡类提示必须有退出机制 (c0a9217)
• feat: 开发办公三件套——粘贴图片/拖拽上传 + xlsx 直读 + docx 迭代追加 (1b86003)
• feat: 侧边栏「项目」页签重构——先项目后对话的两级信息架构 (9c4530a)
• ci: Release Notes 模板更新为 lite-work 当前功能（项目与办公章节） (8537e3d)
• feat: 内置技能随包分发——任意项目可见 + 办公 Agent 支持图表渲染 (4cbfbef)
• fix: 文档生成时 PlantUML/Mermaid 图表强制保留——工具层自动渲染兜底 (07fa37e)
• fix: 目录浏览隐藏文件默认过滤 + Windows 盘符支持 + 非代码文件系统打开 (d6c6a62)
• feat: 产出物目录可打开——文件管理器入口（打开目录 + 定位文件） (9802ede)
• fix: Windows 路径兼容——盘符/大小写/分隔符系统性修复 (637b395)
• feat: 最近项目支持置顶（pin）与搜索过滤 (45e6d38)
• chore: 版本升级 v0.3.0 (e7a6b7b)
• fix: /skill 与 load_skill 未命中时附带可用技能清单 (9ec3b5b)
• fix: sub_agent 缺 import time（llm:stream 转发 2439 次崩溃的元凶） (d187de0)
• feat: 新增 macOS 一键打包脚本 scripts/build-macos.sh (db7012c)
• chore: 清理死代码——unused imports/states/函数与弃用的 jar 下载逻辑 (8133747)
• fix: load_skill 附带技能目录绝对路径——Agent 不再瞎找技能脚本 (62248ce)
• fix: 内置技能安装到用户级 ~/.agents/skills/——Agent 可用的稳定位置 (fa292c2)
• feat: 启动时后台预装图表渲染引擎（依赖包开箱即用） (d1824db)
• fix: 根治应用卡死——同步工具阻塞事件循环 + 一系列连锁问题 (63127f1)
• fix: 引擎"装了但找不到"——npm 全局 bin 补 PATH + Chrome 就绪验证 (2144106)
• feat: 图表引擎随安装包分发——装完即离线可用，无需首次启动联网 (fd9b40a)
• feat: 安装包级开箱即用——任何用户装完程序引擎即全可用 (ac9d4d4)
• ci: workflow macOS 构建改用 build-macos.sh 脚本 (2baa99e)
• fix: 技能目录读取免"项目外路径"审批——受信路径白名单 (8952980)
• feat: 对话输入历史——/history 命令与空输入上下键翻阅；版本 v0.4.0 (4c84df5)
• fix: svg2png 默认白色背景——深色模式下透明背景图片看不清 (c1e0ae6)
• fix: 终端打不开——workspace 哨兵值与主进程状态缺失 (e794f83)
• fix: 终端纯黑框——node-pty spawn-helper 丢失执行权限 (ceb73b7)
• fix: 待发送队列消息立即插入对话流——用户能实时看到已发出 (460ae8f)
• fix: 打开代码误报"不是 git 仓库"——fsList 隐藏过滤误伤 .git 检查 (abb9c53)
• fix: build-macos.sh spawn-helper 只处理 darwin-arm64，避免 chmod 多行字符串报错 (cd93e04)