Developer Guide

开发者指南

这页给想从源码运行、验证或贡献 DeepSeek++ 的开发者。

本地开发

git clone https://github.com/zhu1090093659/deepseek-pp.git
cd deepseek-pp
npm ci
npm run dev

常用命令：

npm run compile
npm test
npm run build:chrome
npm run build:edge
npm run build:firefox
npm run build:all

打包

npm run zip:chrome
npm run zip:edge
npm run zip:firefox
npm run zip:all

Release 包通常会包含 Chrome、Edge、Firefox 和 sources zip。实际发布资产以 GitHub Releases 为准。

质量检查

完整质量门：

npm run ci:quality

如果只改文档，可以优先做轻量检查，例如：

git diff --check

如果改 TypeScript、运行时、工具协议或 UI 交互，至少运行相关测试、类型检查和受影响构建。

Shell Native Host 开发

源码安装 Shell Native Host：

npm run shell:install -- --browser chrome --extension-id <扩展ID>

Shell Host 包位于 packages/shell-host。发布前需要确认 npm 包、安装命令和浏览器 Native Messaging 配置都能实际工作。

贡献建议

提交 PR 前建议：

• 从最新 main 分支开发。
• 保持 diff 聚焦，避免把无关格式化混进功能改动。
• 为用户可见行为补充测试或验证说明。
• 涉及 UI 改动时提供截图或录屏。
• 涉及发布、manifest、权限、MCP 或 Shell Host 时补充本地验证证据。

文档边界

公开 README 和 wiki 面向用户，重点写“能做什么”和“怎么使用”。内部实现细节、私有接口、协议细节和敏感配置不要写进公开用户文档。

面向开发者的实现说明可以放在仓库 docs/ 中，并在需要时从 PR 或 issue 链接。