# 更新日志 RecoWork 的重要变更记录在此。项目遵循 [Keep a Changelog](https://keepachangelog.com/zh-CN/1.1.0/) 与 [语义化版本](https://semver.org/lang/zh-CN/)。 本更新日志只记录功能行为、兼容性、迁移、CLI、模板、target 与生成产物的变更；不记录仅涉及网站视觉、文案、布局、交互润色或文档展示的改动。 ## [未发布] ## [4.1.0] - 2026-09-07 ### 新增 - 新增 rw import 安全接入已有项目：只补缺失的 RecoWork 文件，保留已有路径，根 AGENTS.md 仅整合带标记的规则块；拒绝已有 manifest 和不安全目标。 ## [4.0.0] - 2026-09-07 不兼容变更：新建 idea-to-project 工作空间不再预建可选阶段索引和占位文档，改为按需创建；已有工作空间完整保留，不执行自动迁移。 ### 变更 - 改进 idea-to-project：按需生成六份工作记录，首页引导五分钟回读，事实分工与决策收口明确；答疑可不落盘，简单主题不强制模块双文档，维护沿用明确授权。保留阶段门与追溯；升级不搬迁、覆盖或删除已有工作空间。 ### 新增 - 新增实验性的 Codex 插件 `recowork-codex`。首个 RecoWork Skill 只复用现有 CLI 与生成项目根目录的 `AGENTS.md` 协议，不新增 Codex 专属工作区格式、MCP 服务或隐藏生命周期状态。 ## [recowork-dsh 0.2.0] - 2026-09-01 ### 新增 - 将实验性的 `recowork-dsh` Web 卡片重构为项目驾驶舱。选择工作区后自动读取授权状态，首屏依次展示带完整上下文的继续入口、阻塞决策、工作流阶段，以及从项目简报提取的稳定项目记忆；技术元数据和文档健康度下沉到次级设置。动作可将受控任务提示送入当前 DSH 会话，或复制为另一段对话可使用的同一任务包。工作区文件与生成的 `AGENTS.md` 协议仍是唯一权威来源，适配器不新增第二份任务存储或工作区写入能力。 ## [recowork-dsh 0.1.3] - 2026-08-27 ### 变更 - DSH 工作区卡片现通过 DSH 语义主题变量跟随宿主浅色／深色配色。操作按钮保持与面板对应的颜色层级，不再使用 DSH 主按钮刻意反色的样式。 ## [recowork-dsh 0.1.2] - 2026-08-26 ### 修复 - 修复 `recowork-dsh setup` 在 DSH profile 使用默认空数组占位符时会写出非法 YAML 的问题。现在 setup 会校验单一 YAML 文档；写后校验失败会恢复原始 patch。 ## [recowork-dsh 0.1.1] - 2026-08-25 ### 修复 - DSH 工作区卡片现在会实时跟随 DSH 的中文或英文偏好；用户自有工作区内容仍保持其原始语言。 ## [recowork-dsh 0.1.0] - 2026-08-25 ### 新增 - 新增实验性的 DeepSeek Harness Bundle：`recowork-dsh`。它仅能在用户明确配置的目录内新建 RecoWork 本地工作流或只读查看状态；模板生成、manifest 与升级仍统一由现有 `rw` CLI 负责。 - `recowork-dsh` 现在会注入工作空间协议：DSH Agent 仅在恰当且用户明确的边界调用两项工具，并在持续工作前读取 `AGENTS.md` 与本地化工作方法。 - 为 `recowork-dsh` 新增只读 DSH Web 状态面板：它列出已配置的工作空间根目录，并展示经授权工作区的模板、语言与当前文档数量，不增加任何写入操作。 - 将 DSH Web 面板完善为可收起的工作区卡片，并展示已识别的当前文档名称；仍保持只读边界。 - DSH 状态页现在从授权根目录选择已识别的工作区，无需手填已有目录；切换到新建工作区时不再显示旧状态结果。 - 丰富 DSH 状态页：新增推导的当前阶段、至多三项待确认行动项，以及简明的 manifest／文档健康度摘要；仍保持只读边界。 - 为 DSH Web 新增受控初始化流程：仅支持已配置根目录下的受支持模板与语言，必须在 UI 中明确确认，并仍由服务端拒绝非空目标目录。 - 新增 `recowork-dsh setup` 引导式配置命令：校验明确给出的绝对根目录、先创建备份，并且只管理带标记的 RecoWork 配置块。 ### 修复 - 本地 `link:` 安装的 `recowork-dsh` 不再依赖 DSH 内部模块解析，可直接从源码目录被 DSH profile 加载。 ## [3.2.2] - 2026-08-21 ### 变更 - 持续工作流模板现在按稳定模块组织正式材料。每个模块以 `index.md` 为入口、以中文 `整体方案.md` 或英文 `overall-plan.md` 为当前权威主文档；只有内容拥有独立生命周期、读者、评审路径或变更节奏时，才创建专门子文档。 - `rw view` 现在会在本地工作空间的 Markdown 或索引内容变化时自动刷新当前文档和导航。 ### 兼容性 - 既有工作空间仍完全归用户所有，不会被自动重组。新规范适用于后续工作，以及用户确认后对既有材料进行的收口。 ## [3.2.1] - 2026-08-21 ### 修复 - 加固 `rw view` 启动：Markdown 渲染器改用查看器专用资源路径，并仅在打开文档时加载；渲染器不可用时不会隐藏工作空间导航或当前工作概览，受影响文档会显示本地化恢复提示，不再出现空白页。 ## [3.2.0] - 2026-08-20 ### 新增 - 新增 `rw view [目录]`：零配置的本地 Markdown 工作空间查看器。它只读，按工作空间 locale 切换自身文案、按 `index.md` 导航当前工作，并将本地化归档放在用户主动打开的入口之后。它既能识别项目根目录，也支持直接传入工作空间目录；支持文档 URL 路由、按当前或归档范围的全文搜索、精简概览元信息、面包屑/上一篇/下一篇导航、GitHub 风格 Markdown、多层分支折叠，以及长文档滚动时固定顶部栏和侧栏。本地 Agent 会在初始化完成后或用户要求浏览时通过 `npx --yes recowork@latest view .` 自行启动它；同一工作空间的已运行查看器会自动复用。 - `idea-to-project` 本地工作空间新增 `搁置想法.md`，用于记录可重启方向的搁置原因、重启条件、优先级、最后评估、关联材料和下一步，不再与待确认问题或归档历史混在一起。 - 从想法到落地的 Chat / Mobile 启动指令与续接摘要现在会保留搁置方向及其重启条件。 ## [3.1.0] - 2026-08-18 ### 变更 - 持续工作空间的正式目录与常规索引现在只保留当前有效或仍待处理的内容。确认保留的历史版本和已结束过程材料会按分类、主题和版本统一进入独立的本地化归档。 ### 兼容性 - 已有工作空间文件始终归用户所有。RecoWork 不会自动移动、归档、删除、重命名或重写它们；Agent 必须先列出归档候选并取得用户确认。 ## [3.0.0] - 2026-08-16 ### 修复 - 本地 Agent 初始化 Prompt 与首次使用文档统一改用 `npx --yes recowork@latest`，无需预先全局安装 `rw`，也不会停在 npm 的交互式安装确认。 ### 变更 - 将独立的 `idea-engineering` 与 `project-engineering` 收敛为 `idea-to-project`：一个阶段式工作流完成探索、验证、明确进入项目和项目推进。 - 中文模板名称调整为“从想法到落地”和“系统性学习”；模板 ID、命令和已有工作区保持不变。 ### 兼容性 - 既有想法和项目工作区保持不动。`rw status` 与 `rw upgrade` 会提供在单独目录初始化统一工作流的只读指引，绝不进行原地转换。 ### 破坏性变更 - 不再将 `idea-engineering` 与 `project-engineering` 作为可独立初始化、列出或查看的模板。请使用统一工作流 `idea-to-project`；`idea` 与 `project` 别名仍会解析到该工作流。 ## [2.0.0] - 2026-07-24 ### 新增 - 新增 `web-design-standard`：面向产品型网页的可复用设计规范；本地 Agent 交付一份本地化规范文件，聊天 / 手机端交付一份可独立使用的响应式网页大 Prompt。 ### 变更 - 下线 `general-ai-workflow`：日常任务范围没有形成足够明确、可复用的工作流价值。新初始化请改选想法、项目或学习工作流；已有 general 工作流文件保持不动，运行 `rw status` 或 `rw upgrade` 会获得只读迁移指引。 - 本地初始化遇到已有根目录 `AGENTS.md` 时，会安全写入带标记边界的 RecoWork 区块；升级时会保留用户修改或删除过的受管区块。 - 工作流角色设定现在要求客观识别风险、矛盾、薄弱假设与可信替代方案，不得一味迎合。 ### 兼容性 - 已有根目录 `AGENTS.md` 在 RecoWork 受管区块之外的内容保持不变；已有工作流不会被自动修改。 - 已有 `general-ai-workflow` 文件保持不动；请通过 `rw status` 或 `rw upgrade` 的迁移指引，在单独目录初始化受支持的工作流。 ### 破坏性变更 - 不再支持初始化、列出或查看 `general-ai-workflow` 及其 `general`、`task`、`daily` 别名。 ## [1.0.0] - 2026-07-21 ### 新增 - 新增 `chat-mobile` target，交付启动指令、任务执行协议和手动保存的续接/迁移摘要。 - 新增 `local-agent-project` target，交付工具中立的 `AGENTS.md`、工作方法、持续工作空间与安全升级能力。 - 为旧 Chat 工作流增加迁移指引：在新目录初始化本地工作流，旧文件保持不动。 ### 变更 - 将品牌专属 target 收敛为两种用户环境：聊天 / 手机端与电脑端 AI 助手。 - 将长期知识收口到工作空间中的权威文档与索引，不再生成独立知识库目录。 - 当目标目录已有 `rw-manifest.json` 时，`rw add` 会拒绝执行，防止重新初始化覆盖既有工作流。 - 同步更新模板、CLI Prompt、中英文 README、规格与文档站。 ### 移除 - 移除品牌专属 target 输出、原生 skills、平台配置目录，以及 Notion/飞书文档导出。 ### 兼容性 - 旧 target 名称保留为 CLI 别名，映射至 `chat-mobile` 或 `local-agent-project`。 - 已有工作空间保持不动；旧 Chat 工作流会获得指向独立本地目录的迁移命令。 ### 破坏性变更 - 不再生成品牌专属路径和原生 skill 输出。完整本地工作流请使用 `local-agent-project`，轻量对话请使用 `chat-mobile`。 ## [0.4.0] - 2026-07-20 ### 新增 - 学习工作流在生成或变更课程路线、章节、练习计划或项目方案前，必须先获得学习约定的明确确认。 - 项目工作流在生成或变更完整方案、计划或实施改动前，必须先获得项目约定的明确确认。 - 中英文角色设定、工作方法、聊天提示词和项目指令均包含确认门禁。 ### 变更 - `learning-engineering` 与 `project-engineering` 模板版本升级为 `1.1.0`。 - 发布到 npm 的包现在展示仓库、官网和问题反馈链接；内置 CLI 说明增加引导式使用、源码、发布记录和 AI 初始化入口。 ### 兼容性 - 已有工作流不会自动改动。运行 `rw upgrade --plan .` 查看可用的方法和 target 更新；仅未被用户修改的文件可安全应用。 - 新初始化只会在大范围学习或项目设计工作前暂停等待明确确认；已确认的局部任务无需重复确认。 ## [0.3.0] - 2026-07-12 ### 新增 - 支持按中英文 locale 输出 target 的用户可见路径和静态内容。 - 为持续工作流模板加入文档规范、索引优先读取和索引维护机制。 - 为贡献者和 AI 智能体加入 Conventional Commits 提交规范。 - 加入保守的工作流升级顾问：版本化清单、只读检查、安全更新和工作空间升级报告。 ### 变更 - 中文初始化现在生成 `知识库/`、`示例/` 等用户可见中文路径，同时保留工具约定文件。 - locale 切换时，会安全清理上一语言遗留且可替换的生成文件。 - 升级时工作空间明确归用户所有：已有工作空间内容不会被覆盖、移动、删除或恢复。 - 升级报告写入 `.recowork/upgrade-reports/`，位于用户工作空间之外。 ### 兼容性 - 已有工作流不会被自动改动；旧版清单需先执行 `rw upgrade --adopt .`。 - 新增工作空间模板需显式使用 `--scope workspace --add-missing`；已有工作空间文件保持不变。 ## [0.2.2] - 2026-07-09 ### 修复 - 增加 `recowork` 可执行别名，确保 `npx recowork ...` 能正确解析并运行。 ## [0.2.1] - 2026-07-09 ### 修复 - 发布包含 CLI 入口、模板和 targets 的根目录 npm 包。 ## [0.2.0] - 2026-07-09 ### 已弃用 - 该版本发布时缺少必要的可执行入口，请使用 `0.2.2` 或更高版本。