dskcode

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

特性

• 终端原生交互 — dskcode chat 进入交互式对话，在终端中直接与 AI 协作编码
• 一次性任务执行 — dskcode run 重构所有 TODO 为 Jira 链接 让 AI 自动完成
• DeepSeek 深度集成 — 原生 DeepSeek API 支持，Prefix Cache 感知，成本透明
• 模型支持 — 仅支持 DeepSeek-V4-Flash（默认）和 DeepSeek-V4-Pro 两个模型
• 工具系统 — AI 可以读文件、写代码、执行命令、搜索代码，像人类开发者一样工作
• MCP 插件 — 通过 Model Context Protocol 扩展任意外部工具
• 项目记忆 — AGENTS.md 让你的项目上下文被 AI 理解
• 权限控制 — 三级审批策略（Allow / Ask / Deny），安全可控
• JSON 配置 — 多层级配置（全局 + 项目 + 环境变量 + CLI flag）
• 中文优先 — 界面提示、帮助信息、文档均为中文
• 股票行情 — dskcode stock 交互式 A 股行情终端，键盘选择 + 详情折线图 + 每 10 秒自动刷新

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

快速开始

# 全局安装
npm install -g dskcode

# 查看帮助
dskcode --help

# 启动交互式对话
dskcode chat

使用 npx

npx dskcode --help
npx dskcode chat

命令

全局选项

配置

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）。

架构

src/
├── index.ts          # 入口，shebang + 异常处理
├── cli/              # commander 命令路由
├── config/           # JSON 配置加载与合并
├── provider/         # LLM Provider 接口（DeepSeek）
├── tool/             # 内置工具接口（读文件、写文件、bash 等）
├── plugin/           # MCP 插件管理器
├── agent/            # Agent 会话循环
├── stock/            # 股票行情（StockList 交互式行情终端 + asciichart 折线图）
├── game/             # 内置小游戏
└── 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