Repository navigation
Releases
v0.5.0 — 按周期重置使用统计
本次发布实现使用统计按周期清零能力:今日、本月、累计三档口径与侧边栏展示一一对应,三个入口共用同一条服务端链路,清零后侧边栏即时刷新。
新增
- 按周期清零本地统计,三个入口任选:
- TUI 侧边栏卡片:切换按钮旁新增
[重置]动作,点击弹出周期选择,选择即执行; /deepseek-search菜单:新增「统计清零」项(原/deepseek菜单);- 桌面面板:切换按钮右侧同款「统计清零」按钮,点击展开 今日/本月/累计 单行选择,经宿主原生破坏性确认框(焦点默认在取消)确认后才执行——清掉的可是最长 60 天的本地记录。
- TUI 侧边栏卡片:切换按钮旁新增
deepseek_usage工具新增resetPeriod参数("today" | "month" | "total"),聊天里一句“只清今天的统计”即可完成;与reset: true同时给出时以resetPeriod为准,原有整表清零语义不变。- 底层新增
resetUsageRPC 方法(纯增量,旧版本客户端/服务端互不干扰);工具发起的重置现在也会广播changed事件,侧边栏不再等到下一次轮询才更新。
变更
- 斜杠命令由
/deepseek改名为/deepseek-search(与插件 id 一致),命令标题同步更新为「DeepSeek: 搜索接管与统计清零」,并新增命令面板(Ctrl+P)入口。
修复
- 修复 TUI 斜杠命令在补全列表与命令面板中不可达的问题:keymap 层此前未声明
mode,被绑定在base输入模式上,而补全弹窗与面板各自切换输入模式导致其被排除。现按官方契约声明mode: "global"。
说明
- 清零仅影响本机本地台账(
usage/v1,与 DeepSeek 账户余额无关),不可恢复; - 存储结构无迁移,升级即用;
- 完整变更见 CHANGELOG。
v0.4.0 — 补全 Search API 未用参数
新增
搜索语法直达模型
被接管的 websearch 工具描述现在声明了 query 内可用的操作符,模型会主动组合使用:
site:example.com限定站点(多个用OR连接)、-site:排除站点-词/-"短语"排除、"精确短语"精确匹配lang:zh,en限定语言、after:2025-01-01/before:2026时间窗口
操作符计入 query 的 128 字符上限;query 原样透传,无需任何额外配置。
ori_question 自动透传(尽力而为)
每次搜索会把当前会话最近一次用户输入(去首尾空白、截断到 128 字符)作为 ori_question 发给搜索接口,让它理解 query 背后的真实意图;取不到输入时自动省略该字段。
新增 localization 配置项
"options": {
"localization": "<你的IP>"
}设置后搜索结果优先贴近该地区;留空或不配置时请求里完全不出现该字段。
权威来源标注
authority >= 3(官方 0–4 分级,−1 表示未知,3 及以上为极权威)的搜索结果,标题后会带 [authoritative]标记——模型与读者都能一眼识别高可信来源。内部质量评分不进入工具输出结构。
说明
- 计费不变:按成功请求次数 ¥0.005/次,count 不影响单价
- 升级后无需改配置即可生效;localization 需要显式配置
- ori_question / localization 仅发往 api.deepseek.com,详见 README 隐私小节
v0.3.2 — 侧边栏账户余额与边栏效果优化
新增
- 侧边栏账户余额(TUI + 桌面):服务端以同一 API Key 调用官方查询余额接口
GET /user/balance,经 RPCstatus的可选balance字段下发缓存快照——60 秒 TTL、每分钟至多一次上游请求、失败保留上次值、首次成功前该行不显示。
TUI 卡片以余额行收尾:用量三行读作小票,账户真相落在下面;余额不足时金额转警示色;侧边栏窄于约 12 列时整行省略而不挤压;仅在接管启用 / 原生模式两态显示。桌面面板在用量表下方显示账户块,悬停可看赠金/充值细分(仅两者均非零时),余额不可用时金额转警示色。 - 侧边栏显示改版:用量阶梯金额优先——费用数字在窄边栏里比文字标签存活更久,低于数字下限时三行并一行、不再出现光秃秃的标签行;TUI 正文改为三档文字层级(标签 faint / 计数 muted / 金额高亮)并在宽侧边栏加 2 列缩进;glyph 被裁掉时状态词加粗兜底;桌面面板排版收紧(条目间距 10px、去掉尾部间隔点、仅 Latin 标签加字距、12px glyph 固定单元、金额不与数字断行)。
兼容性
- 无破坏性变更,无需改配置:
balance是 RPC 可选字段,旧客户端自动忽略;新客户端连旧服务端时余额行自动缺席。 - 余额刷新语义:桌面刷新按钮、TUI 菜单「刷新」、两侧失败重试会强制重探;每 10 秒的自动轮询不会,服务端始终把上游请求限制在每分钟一次。
升级方式
npm install @qthinker/opencode-deepseek-search@0.3.2升级后重启 TUI / 重载桌面窗口即可看到新卡片。
v0.3.0 — UI in English, 日本語, 简体中文
主要更新
- 界面新增三种语言:
en、ja、zh-CN。 语言由服务端解析一次(options.language>LC_ALL/LANG前缀 >
英文),再经 RPC 下发给两侧边栏,因此工具输出、TUI 卡片与桌面面板永远同一种语言。 - 已本地化的位置: TUI 卡片、桌面面板、命令 /
+菜单 / toast / 对话框 / 键位命令标题、deepseek_usage与
deepseek_mode的输出、全部错误信息,以及deepseek_fetch的截断提示与 Markdown 来源行。 - 每种语言独立的窄宽度阶梯: 按该语言实测列宽降级(完整词 → 紧凑分隔 →
0S 3F),任何一行都不会折行。 - 新增
options.language("en" | "ja" | "zh-CN",不填即自动)。填了不认识的值只会打一条警告并按自动模式
处理,不会让插件加载失败。
升级前请注意
- 默认界面语言已改为英文。 想保留原来的中文界面,在插件 options 里加
"language": "zh-CN"(保存后边栏会在
下一次读取状态时生效,重启则一定生效)。 - 控制台诊断日志统一为英文。
deepseek_fetch的 Markdown 来源行跟随界面语言,不再硬编码中文来源:。
有意保持英文的部分
模型可见的文本保持英文,这样被接管的 websearch 与内置工具输出形状一致:工具描述、## [title](url) 结果格式、
Published: 与空结果提示。
安装
{
"plugins": [
{
"package": "@qthinker/opencode-deepseek-search",
"options": {
"mode": "deepseek",
"language": "zh-CN",
"count": 5,
"apiKey": "{env:DEEPSEEK_API_KEY}"
}
}
]
}language 取 "en" / "ja" / "zh-CN",不填则跟随 LC_ALL/LANG(通常为英文)。
需要 opencode >= 2.2.5 与 Node.js >= 22.18;已在 opencode 2.2.5(Windows)实测。
完整变更记录: CHANGELOG.md
文档: 中文 · English
v0.2.0 — TUI & desktop sidebars
新增
- TUI 侧边栏卡片:状态 + 今日/本月/累计(
Search/Fetch/¥),标题右端一键启停;排版按侧边栏实测列数自适应,放得下就用整词、放不下才退化到缩写,永不折行;/deepseek提供同样的菜单。 - 桌面侧边栏面板:会话侧区域的 DeepSeek 页签(出现在 New tab 列表与
+菜单),也可用命令DeepSeek: 打开统计面板;以宿主要求的预构建gui-experimental.cjs发布。 - RPC 契约(
status/setMode/changed事件):两个侧边栏读的是同一份账本与同一个mode/v1开关,没有第二份真相。 status新增可选counts结构化计数,供两端各自排版;旧客户端仍走字符串回退。- 打包回归测试:禁止
exports、根级入口必须可解析。
变更
- peer 要求
@opencode/plugin >= 2.2.5;@opentui/*、solid-js、@opencode/theme为可选 peer(宿主提供)。 typecheck覆盖 GUI 工程;CI 在测试前构建并校验 bundle。
修复
- TUI 卡片在窄侧边栏不再折行,动作行不再被裁切。
status调用须传空对象,省略入参会被判rpc.invalid_input。- 桌面面板注册
session.panel菜单项,出现在启动器里。 - 移除
package.json的 BOM(否则 Vite 构建失败)。
安装
{ "plugins": ["@qthinker/opencode-deepseek-search"] }按半边启用:服务端与桌面读全局 opencode.json(c),TUI 读 cli.json。
完整变更:CHANGELOG.md · npm:https://www.npmjs.com/package/@qthinker/opencode-deepseek-search/v/0.2.0