dscli

command module

v0.7.7 Latest Latest Go to latest Published: May 3, 2026 License: Apache-2.0 Imports: 30 Imported by: 0

Details

Valid go.mod file
Redistributable license
Tagged version
Stable version
Learn more about best practices

Repository

gitcode.com/dscli/dscli

Links

Open Source Insights

README ¶

dscli - AI增强的开发者工具箱

     o
    /|\
     |   +---------------+
    / \  | dscli tools   |
 ~~~~~~~~~| AI assistant  |
dscli    +---------------+

🎯 什么是 dscli？

dscli 是一个基于 DeepSeek API 的智能命令行工具，集 AI 编程助手、代码检查、项目管理于一体。

AI 编程助手 — 深度集成 DeepSeek，支持工具调用的多轮对话
开发工具箱 — 文件操作、代码搜索、Git 管理、静态检查、Shell 执行
会话记忆 — 项目级对话历史、笔记系统、跨对话回忆
可定制化 — 自定义系统提示词、技能系统、多格式输出

简单说：dscli = AI 助手 + 开发工具 + 会话记忆 + 命令行效率

📦 版本信息

当前版本：v0.7.6

版本历史

v0.7.6 (2026-05-03) — P0 nil panic 修复、类型别名清理、recall 限制、11 个新测试
v0.7.5 (2026-05-03) — toolcall 结果截断阈值提升至 1M 上下文适配
v0.7.4 (2026-04-29) — 重组包结构，整合 prompt / note / session
v0.7.3 (2026-04-15) — recall 工具支持关键词搜索历史消息
v0.7.2 (2026-04-10) — note 工具支持跨对话记忆
v0.7.1 (2026-03-16) — 重构测试，性能从 27 秒提升到 6 秒（4.2 倍）
v0.7.0 (2026-03-16) — 集成自动代码格式修正工具链，重构 shell 命令判断逻辑，添加超时控制
v0.6.0 (2026-03-13) — 合并 vimscript 分支，添加 vimscript 语言支持，优化 web reader
v0.5.5 (2026-03-12) — 修复 modernize 工具引入的问题，优化代码结构
v0.5.4 (2026-03-09) — 添加 AskExpert 函数，改进 AI 助手交互体验
v0.5.2 (2026-03-08) — 重构代码结构，分离关注点，提高可维护性
v0.5.0 (2026-02-28) — 功能完备版本，包含 43 个迭代
v0.4.0 — 格式化系统重构，支持多种输出模式
v0.3.0 — 添加 Git issue 管理功能
v0.2.0 — 增强 AI 工具调用能力
v0.1.0 — 初始版本发布

✨ 核心功能

🤖 AI 对话

dscli chat — 与 DeepSeek AI 多轮对话，支持工具调用（文件读写、代码搜索、Git 操作等）
dscli fim — 代码补全（Fill-in-the-Middle），提升编码效率
dscli models — 查看可用的 AI 模型列表
dscli balance — 查询 API 余额和使用情况

📝 会话管理

dscli history — 对话历史管理（list / load / show / edit / update）
dscli history recall <关键词> — 搜索历史消息，回忆过往讨论

🛠️ 开发工具

dscli flycheck <路径> — 静态代码检查（Go 用 staticcheck，Python 用 ruff）
dscli skill — 技能管理（list / use / query / set-auto-inject）
dscli prompt — 系统提示词管理（show / edit，支持项目级和全局）
dscli config edit — 编辑配置文件

💬 微信集成

dscli wechat — 微信 AI 工具接口（登录、收发消息、好友/群组管理）

🎨 通用特性

多格式输出 — 支持 --mode markdown（默认）和 --mode org 输出格式
数据库支持 — SQLite 存储对话历史、配置、笔记等
项目感知 — 自动识别 Git 仓库根目录，按项目隔离对话历史
会话统计 — 每次对话后显示耗时、花费、余额
dscli version — 查看版本和运行时信息

🚀 快速开始

安装

# 方式1：使用 go install（推荐）
go install gitcode.com/dscli/dscli@v0.7.6

# 方式2：从源码构建
git clone https://gitcode.com/dscli/dscli.git
cd dscli
git checkout v0.7.6
make install    # 安装到 $GOPATH/bin

# 方式3：下载预编译二进制
# 查看 Releases 页面获取最新版本

配置

获取 DeepSeek API 密钥：DeepSeek 平台
设置环境变量：

export DEEPSEEK_API_KEY="your-api-key-here"

📖 使用示例

1. AI 编程助手

# 基本对话（Markdown 格式输出）
echo "如何用 Go 实现 HTTP 服务器？" | dscli chat

# Org 模式输出
echo "解释这个算法的时间复杂度" | dscli chat --mode org

# 使用推理模型
echo "分析这个代码的性能问题" | dscli chat --model deepseek-reasoner

# 代码补全
echo "def fibonacci(n):" | dscli fim

2. 会话管理

# 查看对话历史列表
dscli history list

# 搜索历史消息
dscli history recall "Go 错误处理"

# 查看指定消息详情
dscli history show 42

# 编辑消息内容
dscli history edit 42

3. 开发工具

# 静态代码检查
dscli flycheck internal/...

# 技能管理
dscli skill list
dscli skill query "go fix"

# 编辑系统提示词
dscli prompt edit

4. 查看模型和余额

# 查看可用模型
dscli models

# 查看账户余额
dscli balance

# JSON 格式输出
dscli models --format json
dscli balance --format json

5. 查看版本信息

dscli version

⚙️ 高级配置

环境变量

# 必需：API 密钥
export DEEPSEEK_API_KEY="your-api-key"

# 可选：API 地址（默认 https://api.deepseek.com）
export DEEPSEEK_BASE_URL="https://api.deepseek.com"

# 可选：模型配置
export MODEL_DEEPSEEK_CHAT="deepseek-chat"
export MODEL_DEEPSEEK_REASONER="deepseek-reasoner"

配置文件

配置目录：~/.dscli/
环境文件：~/.dscli/dscli.env
日志文件：~/.dscli/dscli.log
数据库：~/.dscli/sqlite.db
全局提示词：~/.dscli/prompt/chat.md、~/.dscli/prompt/reasoner.md
全局技能：~/.dscli/skills/

项目级配置

项目配置目录：<project>/.dscli/
项目提示词：<project>/.dscli/prompt/chat.md
项目技能：<project>/.dscli/skills/
优先级：项目配置 > 全局配置 > 内置默认

🏗️ 项目结构

dscli/
├── main.go                    # 主入口
├── root.go                    # 根命令与初始化
├── version.go                 # 版本信息
├── chat.go                    # AI 对话（chat 命令）
├── fim.go                     # 代码补全（fim 命令）
├── models.go                  # 模型查询（models 命令）
├── balance.go                 # 余额查询（balance 命令）
├── history.go                 # 历史管理（history 命令 + recall 子命令）
├── flycheck.go                # 静态检查（flycheck 命令）
├── skill.go                   # 技能管理（skill 命令）
├── prompt.go                  # 提示词管理（prompt 命令）
├── config_edit.go             # 配置编辑（config 命令）
├── wechat_cmd.go              # 微信集成（wechat 命令）
├── parse.go                   # 解析工具
├── formatter.go               # 格式化器
├── Makefile                   # 构建脚本
│
└── internal/
    ├── config/                 # 配置管理（环境变量、配置文件）
    ├── context/                # 上下文管理（Context key/value）
    ├── dsc/                    # DeepSeek API 客户端（Chat/FIM/Balance/Models）
    ├── editor/                 # 外部编辑器调用
    ├── flycheck/               # 静态检查引擎（Go/Python）
    ├── history/                # 对话历史存取、搜索（recall）
    ├── outfmt/                 # 输出格式化（Markdown→Org、表格、等待动画）
    ├── parse/                  # 输入解析
    ├── prompt/                 # 系统提示词渲染、消息模型、笔记
    ├── session/                # 会话管理
    ├── shell/                  # Shell 命令执行与校验
    ├── skills/                 # 技能系统（本地/全局）
    ├── sqlite/                 # SQLite 数据库操作
    ├── toolcall/               # 工具调用框架
    │   ├── alltools/           # 工具注册入口
    │   ├── ask/                # ask_expert / ask_user / code_review
    │   ├── code/               # 代码读写/搜索/结构分析
    │   ├── file/               # 文件读写/搜索
    │   ├── flycheck/           # flycheck 工具
    │   ├── history/            # note / recall 工具
    │   ├── issue/              # Git issue 管理
    │   ├── shell/              # Shell 执行工具
    │   ├── skill/              # skill 工具
    │   └── web/                # Web 内容获取（web_reader）
    └── wechat/                 # 微信客户端（登录/消息/好友/群组）

🔄 工作流程

项目感知 — 自动识别 Git 仓库根目录，确定项目上下文
系统提示词 — 加载项目/全局/默认三级提示词，注入技能和笔记
上下文隔离 — 每个项目有独立的会话和对话历史
工具集成 — AI 可直接操作文件、搜索代码、执行 Git/Shell 命令、管理 Issue
会话统计 — 对话结束后显示耗时和余额消耗

🤝 贡献

欢迎贡献代码、报告问题或提出建议！

Fork 项目
创建功能分支
提交更改
推送到分支
创建 Pull Request

📄 许可证

Apache License 2.0

📞 支持

项目地址：gitcode.com/dscli/dscli
问题反馈：创建 Issue

dscli v0.7.6 — 让命令行开发更智能、更高效！

Documentation ¶

There is no documentation for this package.

Source Files ¶

balance.go
chat.go
config_edit.go
fim.go
flycheck.go
formatter.go
history.go
main.go
models.go
parse.go
prompt.go
root.go
skill.go
skill_add.go
skill_remove.go
version.go
wechat_cmd.go

Directories ¶

Path	Synopsis
internal
config
context
dsc Package dsc provides deepseek client	Package dsc provides deepseek client
editor
flycheck Package flycheck provides on-the-fly syntax checking for code files, inspired by Emacs flycheck.	Package flycheck provides on-the-fly syntax checking for code files, inspired by Emacs flycheck.
memories Package memories implements persistent memory tools backed by SQLite FTS5.	Package memories implements persistent memory tools backed by SQLite FTS5.
outfmt
parse
prompt
session
shell Package shell 提供安全的 Shell 脚本执行功能基于 mvdan/sh interp 实现，替代 os/exec	Package shell 提供安全的 Shell 脚本执行功能基于 mvdan/sh interp 实现，替代 os/exec
skills
sqlite Package sqlite provides a declarative, lazy-initialized SQLite connection with built-in test isolation and schema migration support.	Package sqlite provides a declarative, lazy-initialized SQLite connection with built-in test isolation and schema migration support.
tokenizer Package tokenizer is the cornerstone of Chinese full-text search in dscli.	Package tokenizer is the cornerstone of Chinese full-text search in dscli.
toolcall Package toolcall provides toolcall framework	Package toolcall provides toolcall framework
toolcall/alltools Package alltools to load all tools	Package alltools to load all tools
toolcall/ask
toolcall/code
toolcall/file Package file provides file ops tool calls	Package file provides file ops tool calls
toolcall/flycheck Package flycheck registers the flycheck tool for LLM-driven syntax checking.	Package flycheck registers the flycheck tool for LLM-driven syntax checking.
toolcall/history Package history 注册 note 工具，供 LLM 在对话结束时记录笔记	Package history 注册 note 工具，供 LLM 在对话结束时记录笔记
toolcall/issue Package issue to address issue create, list, show, assign, close	Package issue to address issue create, list, show, assign, close
toolcall/memory Package memory registers memory tools (mem_save/update/search/delete/get_observation/stats) with the toolcall framework and parses LLM-issued tool arguments.	Package memory registers memory tools (mem_save/update/search/delete/get_observation/stats) with the toolcall framework and parses LLM-issued tool arguments.
toolcall/shell Package shell for shell tools	Package shell for shell tools
toolcall/skill
toolcall/web
wechat Package wechat provides wechat api integration	Package wechat provides wechat api integration

?	: This menu
/	: Search site
f or F	: Jump to
y or Y	: Canonical URL