01
安装后在任意项目目录启动
推荐的用户安装方式是 npm 全局安装。进入任意项目目录后输入 deepseekcode，当前目录就是项目目录，运行数据写入当前目录的 .deepseekcode。
npm install -g @xh12312/deepseekcode
cd D:\code\DeepSeekTest
deepseekcode
也可以用 GitHub 网络安装测试当前 main 分支：
npm install -g github:xh20010913-svg/DeepSeekCode
安装后的命令是 deepseekcode；不安装 deepseek 别名，避免和其他 DeepSeek 生态工具冲突。
deepseekcode --project "D:\code\DeepSeekTest"
deepseekcode --doctor
Windows PowerShell 如果因为执行策略拦截 npm 生成的 deepseekcode.ps1，可以在同一目录直接运行 deepseekcode.cmd；cmd 里输入 deepseekcode。
02
模型和运行目录
最小配置是 DeepSeek 兼容端点、API key 和模型名。测试密钥建议只放在测试目录的 .env。
DEEPSEEK_BASE_URL=https://api.deepseek.com
DEEPSEEK_API_KEY=your_deepseek_api_key
DEEPSEEK_MODEL=deepseek-v4-flash
DEEPSEEKCODE_LANGUAGE=zh-CN
默认项目未传 --project 时使用当前目录。
默认数据未传 --data-dir 时写入 <project>/.deepseekcode。
模型切换TUI 内使用 /model、/model flash 或 /model pro。
03
权限交互
默认 safe 模式关闭 shell 和 browser。TUI 启动时如果 shell 未开启，会先询问是否为本会话开启 shell 权限；方向键选择，Enter 确认，Esc/N 保持关闭。
deepseekcode --permission-profile safe
deepseekcode --permission-profile dev
deepseekcode --allow-shell
模型真正请求 run_command 时仍然由 runtime permission gate 拦截。用户看到工具名、命令、cwd、风险等级和允许/拒绝选项；这不是通过关键词判断用户任务。
04
Native Tool Calling
主链路是 DeepSeek tools -> tool_calls -> local tools -> tool result -> next turn。不支持 native tool calls 的模型或网关会明确失败，不静默回退旧 JSON planner。
已验证文件读写、patch、glob/grep/list、todo、DOCX/PPTX runtime、skills/plugins 基础路径、TencentDB-Agent-Memory。
部分可用Browser CDP、MCP stdio、Office 质量增强、多 agent 调度。
实验中PDF 生成、长任务 worker pool、真实场景自动评测。
保留computer_use 还没有完整 GUI 桥接，不宣传成可用能力。
05
上下文、缓存和记忆
DeepSeekCode 不把所有历史原文无限塞回 prompt。稳定规则和工具 schema 放前面以提高缓存复用；旧对话压成 rolling summary；长工具结果压成摘要和 artifact manifest。
/cache
/cache guard <goal>
/usage
/cost
/memory status
/memory search 中文默认
06
Skills / Plugins
Skills 是 SKILL.md instruction pack；Plugins 可以贡献 commands、skills 和 hooks。兼容读取 .claude 来源，安装目标写入 .deepseekcode。
/skills
/skills install "D:\skills\office-report"
/skills install https://github.com/example/agent-skills/tree/main/office/report
/plugins
/plugins install "D:\plugins\review-kit"
/plugins validate
07
真实测试
真实测试产物只放在独立目录，例如 D:\code\DeepSeekTest。推荐任务包括大型网页、答辩 PPT、课程 PPT、OFDR 原理 PPT、DOCX 报告、失败后自修复、多 agent 协作和浏览器验证。
cd /d D:\code\DeepSeekTest
deepseekcode --model deepseek-v4-flash
/runs report latest "D:\code\DeepSeekTest"
08
发布边界
发布只从 D:\code\DeepSeekCode\.release 提交。不提交测试目录、prompt audit、测试报告、.env、runtime 数据库、node_modules 或开发草稿。
npm.cmd run typecheck
npm.cmd run build
npm.cmd pack --dry-run
git status --short