chore: 添加 CHANGELOG 自动生成、发布工作流及预提交检查优化

.github/workflows/ci.yml

@@ -48,3 +48,6 @@ jobs:
 
       - name: Test
         run: npm test
+
+      - name: Test Scripts
+        run: npm run test:scripts

.github/workflows/release.yml

@@ -0,0 +1,51 @@
+name: Release
+
+on:
+  push:
+    tags:
+      - "v*"
+
+permissions:
+  contents: write
+
+jobs:
+  release:
+    name: Create Release & Update Changelog
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+
+      - name: Setup Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: "22"
+          cache: npm
+
+      - name: Install dependencies
+        run: npm ci
+
+      - name: Create GitHub Release
+        env:
+          GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+        run: gh release create "${{ github.ref_name }}" --generate-notes
+
+      - name: Generate Changelog
+        env:
+          GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+        run: node scripts/generate-changelog.js
+
+      - name: Commit Changelog
+        run: |
+          if git diff --quiet CHANGELOG.md; then
+            echo "CHANGELOG.md is already up to date, skipping commit."
+          else
+            git config user.name "github-actions[bot]"
+            git config user.email "41898282+github-actions[bot]@users.noreply.github.com"
+            git add CHANGELOG.md
+            git commit -m "docs: update CHANGELOG.md for ${{ github.ref_name }}"
+            git push
+          fi

.husky/pre-commit

@@ -1 +1,9 @@
-npx lint-staged
+npm run pre-commit || {
+  echo ''
+  echo '===================================================='
+  echo 'pre-commit checks failed. in case of emergency, run:'
+  echo ''
+  echo 'git commit --no-verify'
+  echo '===================================================='
+  exit 1
+}

CHANGELOG.md

@@ -0,0 +1,261 @@
+# Changelog
+
+All notable changes to [Deep Code](https://github.com/lessweb/deepcode-cli) are
+documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
+and the project follows
+[Semantic Versioning](https://semver.org/spec/v2.0.0.html). Only stable releases
+are listed; pre-releases are intentionally omitted.
+
+> **This file is generated automatically** from
+> [GitHub Releases](https://github.com/lessweb/deepcode-cli/releases). Do not
+> edit it by hand — run `npm run changelog` to regenerate.
+
+## [0.1.31](https://github.com/lessweb/deepcode-cli/releases/tag/v0.1.31)
+
+`2026-06-16`
+
+### Other
+
+- chore(deps-dev): bump esbuild and tsx ([#174](https://github.com/lessweb/deepcode-cli/pull/174))
+- chore: 优化deepcode-self-refer skill
+- chore: 优化skill-digester skill
+
+## [0.1.30](https://github.com/lessweb/deepcode-cli/releases/tag/v0.1.30)
+
+`2026-06-15`
+
+### Added
+
+- enhance Windows MCP command quoting and add tests for cmd metacharacters
+- add plan mode skill and enhance shell init command tests
+- add support for implicit invocation control in skills
+- update default skill loading so enabledSkills can skip the built-in skills
+
+### Fixed
+
+- mcp: fix Windows MCP spawn double-quoting that breaks all MCP servers ([#164](https://github.com/lessweb/deepcode-cli/pull/164))
+
+## [0.1.29](https://github.com/lessweb/deepcode-cli/releases/tag/v0.1.29)
+
+`2026-06-09`
+
+### Added
+
+- implement bundled built-in skills
+- add docs/session-persistence.md
+- implement `enabledSkills` support in settings.json
+- add raw mode shortcut `ctrl+r`
+
+### Other
+
+- 修复提示输入的换行、光标定位与 busy 状态显示 ([#171](https://github.com/lessweb/deepcode-cli/pull/171))
+- @qorzj made their first contribution in https://github.com/lessweb/deepcode-cli/pull/171
+
+## [0.1.28](https://github.com/lessweb/deepcode-cli/releases/tag/v0.1.28)
+
+`2026-06-05`
+
+### Added
+
+- session name can be edited now ([#159](https://github.com/lessweb/deepcode-cli/pull/159))
+- ui: 优化 PromptInput 组件的光标显示与布局 ([#161](https://github.com/lessweb/deepcode-cli/pull/161))
+
+### Changed
+
+- extract OpenAI message converter from SessionManager ([#140](https://github.com/lessweb/deepcode-cli/pull/140))
+
+### Other
+
+- 升级bash tool，支持后台运行(`run_in_background`)，可解决使用playwright测试场景下，启动server导致流程阻塞的问题
+- 修复bash tool多行参数的渲染问题，现在一定会显示LLM提供的description信息
+- Enhance cursor handling in PromptInput component to fix IME composition anchoring
+- 更新karpathy-guidelines.md，增加提示：`Apply these guidelines silently. Do not cite this document, its title, or guideline names in user-facing responses.`
+- Improve the Markdown underscore rendering
+- Add MCP tool name handling with API-safe names
+- Implement temperature support for settings.json
+- Agent Skills相关优化：
+- @dependabot[bot] made their first contribution in https://github.com/lessweb/deepcode-cli/pull/157
+- @Feiry-zZ made their first contribution in https://github.com/lessweb/deepcode-cli/pull/159
+
+## [0.1.27](https://github.com/lessweb/deepcode-cli/releases/tag/v0.1.27)
+
+`2026-06-01`
+
+### Other
+
+- chore(deps): update ink-gradient to 4.0.1 ([#135](https://github.com/lessweb/deepcode-cli/pull/135))
+- chore: 更新API Key not found时的文本显示 ([#137](https://github.com/lessweb/deepcode-cli/pull/137))
+- 优化edit tool，取消返回findClosestMatch，直接用inferOldStringNotFoundReasonWithLLM生成提示信息
+- 改进系统提示词，引入[karpathy-guidelines](https://github.com/multica-ai/andrej-karpathy-skills)，经验证对于复杂任务可显著提升成功率
+- @fym998 made their first contribution in https://github.com/lessweb/deepcode-cli/pull/135
+- @iamhmx made their first contribution in https://github.com/lessweb/deepcode-cli/pull/137
+
+## [0.1.26](https://github.com/lessweb/deepcode-cli/releases/tag/v0.1.26)
+
+`2026-05-29`
+
+### Changed
+
+- ui: 重构代码结构，调整文件路径和导入引用 ([#122](https://github.com/lessweb/deepcode-cli/pull/122))
+- extract telemetry into separate module with enable/disable toggle ([#130](https://github.com/lessweb/deepcode-cli/pull/130))
+
+### Fixed
+
+- session: 修复会话清理内存泄漏并补充回归测试 ([#123](https://github.com/lessweb/deepcode-cli/pull/123))
+- prompt-buffer: 修正 getCurrentSlashToken 函数逻辑 ([#129](https://github.com/lessweb/deepcode-cli/pull/129))
+
+### Other
+
+- chore(deps): 更新 ink 依赖到 7.0.4 版本 ([#125](https://github.com/lessweb/deepcode-cli/pull/125))
+- Edit 工具增强 — 支持空 old_string 的文件编辑，snippet 处理增强（full-file 支持 + 强制 snippet_id）
+- 快照机制增强 - 修复`/undo`恢复快照场景的已知问题
+- Agent+手动混合修改场景优化 - 基于快照机制检测到手动修改时，自动增加system prompt，可有效防止LLM无脑覆盖手动修改。
+
+## [0.1.25](https://github.com/lessweb/deepcode-cli/releases/tag/v0.1.25)
+
+`2026-05-25`
+
+### Added
+
+- ui: add bracketed paste with large-paste marker collapsing ([#102](https://github.com/lessweb/deepcode-cli/pull/102))
+- ui: 会话列表支持 Delete 键删除会话 ([#114](https://github.com/lessweb/deepcode-cli/pull/114))
+- ui: 增加会话删除及相关UI重置功能 ([#119](https://github.com/lessweb/deepcode-cli/pull/119))
+- markdown 表格闭合边框渲染 + CJK/emoji 宽度适配 ([#115](https://github.com/lessweb/deepcode-cli/pull/115))
+- implement checkpoints store only explicit Write/Edit file paths
+
+### Fixed
+
+- permission: 处理权限拒绝状态与界面更新 ([#120](https://github.com/lessweb/deepcode-cli/pull/120))
+
+### Performance
+
+- reuse OpenAI client and add undici keep-alive Agent with connection warmup ([#100](https://github.com/lessweb/deepcode-cli/pull/100))
+
+### Documentation
+
+- 更新扩展命令菜单说明和帮助文档 ([#109](https://github.com/lessweb/deepcode-cli/pull/109))
+
+### Other
+
+- 实现权限机制，详见 [docs/permission.md](docs/permission.md)
+- @jeoor made their first contribution in https://github.com/lessweb/deepcode-cli/pull/102
+- @xinggitxing made their first contribution in https://github.com/lessweb/deepcode-cli/pull/114
+
+## [0.1.24](https://github.com/lessweb/deepcode-cli/releases/tag/v0.1.24)
+
+`2026-05-21`
+
+### Added
+
+- MCP 服务器手动重连功能 ([#84](https://github.com/lessweb/deepcode-cli/pull/84))
+
+### Changed
+
+- Extract dropdown components ([#97](https://github.com/lessweb/deepcode-cli/pull/97))
+- ui: 使用 resetPromptInput 简化撤销和回绕处理 ([#101](https://github.com/lessweb/deepcode-cli/pull/101))
+
+### Fixed
+
+- ui: 修正组件路径拼写错误 ([#93](https://github.com/lessweb/deepcode-cli/pull/93))
+- resolve CJK composition bug on iOS terminals (backspace packet splitting) ([#94](https://github.com/lessweb/deepcode-cli/pull/94))
+
+### Other
+
+- 新增`/undo`斜杠命令，同时实现了基于git的快照回滚机制
+- 适配七牛/火山引擎等deepseek模型时可能出现的tool call字段相关问题
+- @liante0904 made their first contribution in https://github.com/lessweb/deepcode-cli/pull/94
+
+## [0.1.23](https://github.com/lessweb/deepcode-cli/releases/tag/v0.1.23)
+
+`2026-05-19`
+
+### Added
+
+- 新增 `/raw` 命令交互与终端消息直出 ([#89](https://github.com/lessweb/deepcode-cli/pull/89))
+- notify: pass STATUS, FAIL_REASON, BODY, TITLE as env vars to notify hook ([#90](https://github.com/lessweb/deepcode-cli/pull/90))
+
+### Other
+
+- 修复Windows系统下Bash tool⽆法杀死进程组的问题
+- 实现Bash tool的超时机制，默认10分钟，可在ctrl+o界面调整
+
+## [0.1.22](https://github.com/lessweb/deepcode-cli/releases/tag/v0.1.22)
+
+`2026-05-18`
+
+### Added
+
+- add -p/--prompt flag to auto-submit prompt on launch ([#86](https://github.com/lessweb/deepcode-cli/pull/86))
+- Add Ctrl+O live process stdout viewer ([#75](https://github.com/lessweb/deepcode-cli/pull/75))
+
+### Other
+
+- 改进Edit tool在LLM出现参数`\`转义错误时的表现
+- 新增UpdatePlan tool和自带的plan-and-execute-skill提示词
+- 实现输入框中用`@`唤起file mention的功能
+- 实现`/command`斜杠命令
+- @whzp015258712145-hub made their first contribution in https://github.com/lessweb/deepcode-cli/pull/86
+
+## [0.1.21](https://github.com/lessweb/deepcode-cli/releases/tag/v0.1.21)
+
+`2026-05-16`
+
+### Added
+
+- 添加 GitHub CI 工作流，支持多平台多版本自动验证 ([#76](https://github.com/lessweb/deepcode-cli/pull/76))
+
+### Changed
+
+- MCP 新增状态管理增强与 UI 可视化 ([#72](https://github.com/lessweb/deepcode-cli/pull/72))
+
+### Fixed
+
+- resolve Windows CI failures (CRLF, MCP spawn, cross-platform test runner) ([#77](https://github.com/lessweb/deepcode-cli/pull/77))
+
+### Documentation
+
+- add English translations of configuration.md and mcp.md ([#56](https://github.com/lessweb/deepcode-cli/pull/56))
+
+### Other
+
+- style(DropdownMenu): 调整内边距优化下拉菜单布局 ([#73](https://github.com/lessweb/deepcode-cli/pull/73))
+- 为每个模型添加使用跟踪，并修复退出摘要(exit summary)表格
+- 改进Edit/Write tool，在一读多写失败的情况下提示LLM文件或片段已过时
+- 后端重构: move debug and error logging to common directory
+- @rock-solid-sites made their first contribution in https://github.com/lessweb/deepcode-cli/pull/56
+
+## [0.1.20](https://github.com/lessweb/deepcode-cli/releases/tag/v0.1.20)
+
+`2026-05-14`
+
+### Added
+
+- add MCP (Model Context Protocol) support with /mcp command ([#48](https://github.com/lessweb/deepcode-cli/pull/48))
+- Handle Shift+Enter as prompt newline ([#52](https://github.com/lessweb/deepcode-cli/pull/52))
+- 新增 DropdownMenu 组件 ([#58](https://github.com/lessweb/deepcode-cli/pull/58))
+- Add prompt undo and redo shortcuts ([#59](https://github.com/lessweb/deepcode-cli/pull/59))
+- ui: 优化消息视图的布局和宽度自适应 ([#66](https://github.com/lessweb/deepcode-cli/pull/66))
+
+### Changed
+
+- session: 简化并统一会话系统消息的处理逻辑 ([#62](https://github.com/lessweb/deepcode-cli/pull/62))
+
+### Fixed
+
+- improve Windows Git Bash detection ([#55](https://github.com/lessweb/deepcode-cli/pull/55))
+- ui: 修正 reasoningEffort 显示逻辑 ([#63](https://github.com/lessweb/deepcode-cli/pull/63))
+- session: 修复系统消息可见性设置错误 ([#64](https://github.com/lessweb/deepcode-cli/pull/64))
+- filter image_url content from API messages for DeepSeek compatibility ([#51](https://github.com/lessweb/deepcode-cli/pull/51))
+
+### Other
+
+- 重构docs目录，分拆为普通文档目录(docs)和提示词模板目录(templates)
+- 重构后端代码，分拆出 `src/mcp` 和 `src/common` 目录
+- 优化系统提示词：删除DeepSeek不擅长的`ast-grep`相关内容；注入今天日期；给AI Agent一个名字（Deep Code），防止DeepSeek给自己脑补一个名字。
+- 实现完善的配置方案，参见：[docs/configuration.md](https://github.com/lessweb/deepcode-cli/blob/main/docs/configuration.md)
+- 优化`/model`的交互UI
+- 更新README文档
+- @dengmik-commits made their first contribution in https://github.com/lessweb/deepcode-cli/pull/48
+- @yuefengw made their first contribution in https://github.com/lessweb/deepcode-cli/pull/55

package.json

@@ -26,10 +26,13 @@
     "start": "node scripts/start.js",
     "build-and-start": "npm run build && npm run start",
     "test": "npm run test --workspaces --if-present",
+    "test:scripts": "node --test scripts/__tests__/*.test.js",
     "release:version": "node scripts/version.js",
     "prepare:package": "node scripts/prepare-package.js",
     "prepare:vscode": "node scripts/prepare-vscode.js",
-    "prepare": "husky && npm run build && npm run bundle"
+    "changelog": "node scripts/generate-changelog.js",
+    "prepare": "husky && npm run build && npm run bundle",
+    "pre-commit": "node scripts/pre-commit.js"
   },
   "devDependencies": {
     "@eslint/js": "^9.39.4",