dscli

#+TITLE: dscli - DeepSeek 编程助手命令行工具
#+DATE: 2025-03-15

* 简介
dscli 是一个命令行编程助手，后接DeepSeek API，帮助您开发代码，也有一定
的设计能力。你可以直接在命令行终端使用，也可以集成到Emacs使用（通过
dscli.el，或自己集成）。

项目地址：[[https://gitcode.com/nanjunjie/dscli][gitcode.com/nanjunjie/dscli]]

* 快速开始
** 安装
   #+begin_src bash
   go install gitcode.com/nanjunjie/dscli@latest
   #+end_src

   或使用 Makefile：
   #+begin_src bash
     git clone https://gitcode.com/nanjunjie/dscli.git
     cd dscli
     make install    # 安装到 $GOPATH/bin
   #+end_src

** 配置
设置 DeepSeek API 密钥：
#+begin_src bash
export DEEPSEEK_API_KEY="your-api-key-here"
#+end_src

* 核心功能：dscli chat
dscli chat 是主要功能，用于与 DeepSeek 编程助手对话。

** 基本使用
切到项目目录（比如dscli），通过标准输入发送问题：
#+begin_src bash
cd dscli
dscli chat <<EOF
如何用Go实现HTTP服务器？
EOF
#+end_src

** 常用场景示例
*** 代码编写
#+begin_src bash
dscli chat <<EOF
写一个Python函数计算斐波那契数列
EOF
#+end_src

*** 代码解释
#+begin_src bash
dscli chat <<EOF
解释这段代码的作用：$(cat complex_code.go)
EOF
#+end_src

*** 技术问题
#+begin_src bash
dscli chat <<EOF
Docker和Kubernetes有什么区别？
EOF
#+end_src

** 选择模型
使用不同的 DeepSeek 模型：
#+begin_src bash
echo "问题内容" | dscli chat --model deepseek-reasoner
#+end_src

可用模型：
#+begin_src bash
dscli models
#+end_src

示例输出：
#+begin_example
deepseek-chat        # 通用聊天
deepseek-reasoner    # 复杂推理
#+end_example

** Emacs 集成 (dscli.el)
在 Emacs 中使用 dscli 更加方便：

1. 安装 dscli.el：
   #+begin_src emacs-lisp
   (add-to-list 'load-path "/path/to/dscli.el")
   (require 'dscli)
   #+end_src

2. 基本使用：
   - =M-x dscli-chat= 启动聊天
   - 在临时缓冲区输入问题
   - 按 =C-c C-c= 发送
   - 查看 org mode 格式的回答

* 其他功能
** 查询余额
查看 API 使用情况：
#+begin_src bash
dscli balance
#+end_src

** 代码补全 (FIM)
使用代码补全功能：
#+begin_src bash
echo "def fibonacci(n):" | dscli fim
#+end_src

* 高级配置
** 环境变量
- =DEEPSEEK_API_KEY=：API 密钥（必需）
- =DEEPSEEK_BASE_URL=：API 地址（可选，默认 https://api.deepseek.com）

** 命令行参数
所有命令支持：
- =--api-key=：指定 API 密钥
- =--base-url=：指定 API 地址
- =--debug=：调试模式

* 常见问题
** 如何获得 DeepSeek API 密钥？
访问 [[https://platform.deepseek.com/][DeepSeek 平台]] 注册并获取 API 密钥。

** 支持哪些编程语言？
DeepSeek 支持所有主流编程语言，包括 Go、Python、JavaScript、Java、C++ 等。
* 许可证
Apache License 2.0