dskcode

基于 DeepSeek 的 AI 编程助手终端 CLI 工具。让 AI 直接在终端中理解你的代码、读写文件、执行命令。

特性

• 终端原生交互 — dskcode chat 进入交互式对话，在终端中直接与 AI 协作编码 ✅
• 一次性任务执行 — dskcode run 让 AI 自动完成任务 ✅
• DeepSeek 深度集成 — 原生 DeepSeek API 支持，Prefix Cache 感知，成本透明 ✅
• 模型支持 — 支持 DeepSeek-V4-Flash（默认）和 DeepSeek-V4-Pro 两个模型 ✅
• 工具系统 — 10 个内置工具（read_file / write_file / edit_file / multi_edit / delete_range / bash / glob / grep / ls / fetch），Agent 可读写文件、执行命令、搜索代码 ✅
• 文件回退（/rewind） — 每轮对话自动生成 git stash 检查点，**/rewind 1 一键撤回最新修改**，也可选择模式的回到任意历史状态 ✅
• /rewind 提示 — 对话结束后 2s 在原状态栏位置自动出现「↩ /rewind 1 可撤回本次修改」，直到下一轮对话开始 ✅
• 计划模式 — /plan 切换到计划模式（紫色主题），让 AI 先分析再编码，适合复杂任务 ✅
• 高级设置 — /thinking 切换深度思考、/effort 切换推理等级 High/Max、/toolchoice 控制工具调用策略 ✅
• 会话持久化 — 对话自动保存到磁盘，Session.resume 恢复历史会话，支持 rewind 回退到任意对话节点 ✅
• 命令提示轮播 — 输入框上方自动轮播可用命令提示，底部命令提示条混洗展示 ✅
• MCP 插件 — 通过 Model Context Protocol 扩展任意外部工具 ⚡ 骨架就绪
• 项目记忆 — AGENTS.md 注入系统提示词 ❌ 持久化未完成
• 权限控制 — 三级审批策略（Allow / Ask / Deny），安全可控 ❌ 未开始
• JSON 配置 — 多层级配置（全局 + 项目 + 环境变量 + CLI flag） ✅
• 中文优先 — 界面提示、帮助信息、文档均为中文 ✅
• Token 计价 — 会话级 / 日级 / 历史级三层成本统计，Prefix Cache 半价计费 ✅
• 流式渲染 — 打字机效果、spinner、代码块高亮、工具调用可视化 ✅
• 股票行情 — dskcode stock 交互式 A 股行情终端，键盘选择 + 详情折线图 + 每 10 秒自动刷新 ✅

• 内置小游戏 — dskcode game 启动游戏列表，打砖块、Coder Check 极速打字等内置游戏供休闲娱乐 ✅

快速开始

# 全局安装
npm install -g dskcode

# 查看帮助
dskcode --help

# 启动交互式对话
dskcode chat

使用 npx

npx dskcode --help
npx dskcode chat

命令

全局选项

交互式 Chat 命令

在 dskcode chat 会话中输入以下命令（按 /help 查看所有可用命令）：

对话结束后若 AI 修改了文件，2 秒后原 spinner 位置会自动出现提示：

↩ /rewind 1 可撤回本次修改

该提示一直保留到下一轮对话开始，方便随时撤回最新一轮文件修改。

配置

dskcode 使用 JSON 格式的配置文件，支持多层级合并：

1. 内置默认值 — 无需配置即可运行
2. 用户全局 — ~/.dskcode/settings.json
3. 项目本地 — 当前目录下的 .dskcode/settings.json
4. 环境变量 — 如 DEEPSEEK_API_KEY
5. CLI flag — 命令行参数优先级最高

配置示例

全局配置（~/.dskcode/settings.json，存放个人密钥）：

{
  "defaultProvider": "deepseek",
  "providers": [
    {
      "name": "deepseek",
      "apiKey": "sk-xxx",
      "baseUrl": "https://api.deepseek.com",
      "model": "deepseek-v4-flash"
    }
  ]
}

项目配置（.dskcode/settings.json，存放团队约定的行为参数）：

{
  "defaultProvider": "deepseek",
  "temperature": 0.3,
  "maxToolRounds": 30,
  "tools": [
    { "name": "read_file", "enabled": true },
    { "name": "write_file", "enabled": true },
    { "name": "bash", "enabled": true },
    { "name": "grep", "enabled": true }
  ]
}

股票行情

dskcode stock 启动交互式股票行情终端，基于腾讯免费行情接口，支持实时查看 A 股/指数/ETF 行情。

功能

• 实时行情列表 — 涨跌彩色标识（红涨绿跌），显示最新价、涨跌幅、最高/最低价、成交量
• 键盘选择 — ↑/↓ 切换股票，Enter 查看详情
• 分时折线图 — 详情页展示最近 60 笔分钟线的 ASCII 折线图（直角折线风格）
• 自动刷新 — 列表 5s 倒计时自动刷新，详情页 10s 倒计时自动刷新，右上角显示倒计时
• 手动刷新 — 按 r 键强制刷新
• 自选股配置 — 首次运行自动在 ~/.dskcode/settings.json 生成默认自选股，界面底部提示编辑路径

使用方式

# 首次运行自动生成自选股配置，默认: 上证指数 + 沪深300 + 紫金矿业
dskcode stock

# 指定股票代码
 dskcode stock sh000001 sz399006 sh601688

示例界面

  📈 自选股监控                      5s 后自动刷新
   代码     名称         最新价     涨跌幅     涨跌额    最高      最低     成交量
   ────────────────────────────────────────────────────────────────────────────
   ▸ sh000001 上证指数   3150.00   +0.35%   +11.02   3160.00  3140.00  28543.0万
     sz399006 创业板指   1820.00   -0.52%    -9.50   1835.00  1815.00  9865.0万
     sh601688 华泰证券     14.25   +1.05%    +0.15     14.38    14.10    45.2万

  ↑/↓ 选择  Enter 详情  r 手动刷新  q 返回
  最后更新: 14:30:00  编辑自选股: ~/.dskcode/settings.json

按 Enter 进入详情页，查看 ASCII 分时折线图：

  📊 华泰证券 sh601688                       每 8s 刷新

  当前价    ▲ 14.25
  涨跌幅    +1.05%  +0.15

  14.42 ┤    ┌─┐
  14.34 ┤  ┌─┘ └─┐
  14.26 ┤ ┌┘     └─┐
  14.18 ┤─┘        └─┐
  14.10 ┤            └──

  Space/q 返回列表

股票代码格式

代码需带市场前缀：

自选股配置

首次运行 dskcode stock 时，程序会自动在 ~/.dskcode/settings.json 中生成默认自选股列表：

{
  "stock": {
    "symbols": [
      { "code": "sh000001" },
      { "code": "sz399300" },
      { "code": "sh601899" }
    ]
  }
}

编辑该文件的 stock.symbols 数组即可自定义自选股，列表页底部也会提示配置文件路径。

也可用纯数字代码，程序自动识别市场：

dskcode stock 000001 399006
# 000001 → sh000001（上证指数）
# 399006 → sz399006（创业板指）

数据来源

分时数据来自腾讯免费行情接口 web.ifzq.gtimg.cn/appstock/app/minute/query，全天 242 条分钟线（09:30~15:00）。

实现进度

15 章开发计划，当前进度：

内置工具详情

架构

src/
├── index.ts          # 入口，shebang + 异常处理
├── cli/              # commander 命令路由
├── config/           # JSON 配置加载与合并
├── provider/         # LLM Provider 接口（DeepSeek）+ CostTracker
├── tool/             # 内置工具（Registry + 10 个内置工具）
├── plugin/           # MCP 插件管理器（骨架就绪）
├── agent/            # Agent 会话循环 + 检查点（Checkpoint）
├── checkpoint/       # git stash 驱动的文件状态检查点（/rewind 基础）
├── session-store/    # 会话持久化与恢复
├── stock/            # 股票行情（交互式终端 + asciichart）
├── game/             # 内置小游戏
├── types/            # 共享类型定义
├── utils/            # 工具函数（渐变、模型工具等）
└── ui/               # Ink 交互式终端 UI

开发

# 克隆仓库（clone 后直接安装即可）
git clone https://github.com/Awu12277/deepseek-agent-cli.git

# 安装依赖
npm install

# 开发模式（自动监听重构建）
npm run dev

# 构建
npm run build

# 测试
npm test

# 类型检查
npm run type-check

# 代码检查
npm run lint

许可

MIT