dsh-thinking-lang 1.0.6 → 1.0.8
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/DEVELOPMENT.md +177 -0
- package/README.md +34 -174
- package/assets/plugin-config.png +0 -0
- package/client/client.js +305 -54
- package/client/client.raw.cjs +305 -54
- package/lib/core.d.ts +41 -5
- package/lib/core.js +67 -9
- package/lib/index.d.ts +1 -0
- package/lib/index.js +89 -20
- package/package.json +2 -1
- package/src/client/index.ts +32 -1
- package/src/client/locales.ts +54 -61
- package/src/client/panel.ts +303 -72
- package/src/core.ts +89 -10
- package/src/index.ts +96 -20
package/DEVELOPMENT.md
ADDED
|
@@ -0,0 +1,177 @@
|
|
|
1
|
+
# dsh-thinking-lang 开发说明
|
|
2
|
+
|
|
3
|
+
面向维护者的实现细节。使用说明见 [README.md](README.md)。
|
|
4
|
+
|
|
5
|
+
---
|
|
6
|
+
|
|
7
|
+
## 提示词是怎么注入的
|
|
8
|
+
|
|
9
|
+
规则用**所选语言本身**书写(不是英文语言名),分两个位置注入——区别在**频率**:
|
|
10
|
+
|
|
11
|
+
| | `systemPrompt.section` | `agent/pre-step` 提醒 |
|
|
12
|
+
|---|---|---|
|
|
13
|
+
| 由谁生成 | [`sectionText`](src/core.ts) | [`reminderText`](src/core.ts) |
|
|
14
|
+
| 内容 | 完整规则句 | 一句短提醒 |
|
|
15
|
+
| 注入形态 | 系统提示词的一段 | 一条 user 消息,追加在请求末尾 |
|
|
16
|
+
| 频率 | 每会话组装一次(文本变化时提交) | 每轮第一步,且距上次 ≥ 提醒间隔(默认 30 分钟) |
|
|
17
|
+
| 顺序 | `order: 1`,紧跟 persona | `prepend` 注册,晚于其它 pre-step 注入 |
|
|
18
|
+
|
|
19
|
+
### 实际注入的文本
|
|
20
|
+
|
|
21
|
+
文本由 [`src/core.ts`](src/core.ts) 的 `CATALOGUE` 提供,每种语言一份、**用该语言书写**:
|
|
22
|
+
|
|
23
|
+
| 语言 | section(规则句) | reminder(批次开头) | tail(请求末尾) |
|
|
24
|
+
|---|---|---|---|
|
|
25
|
+
| 简体中文 | 推理规则:思考、推理与规划一律使用简体中文。回复用户时使用用户所用的语言。 | 注意:思考、推理与规划用简体中文,即使上文不是 | 下文请使用简体中文思考 |
|
|
26
|
+
| 繁體中文 | 推理規則:思考、推理與規劃一律使用繁體中文。回覆使用者時使用使用者所用的語言。 | 注意:思考、推理與規劃用繁體中文,即使上文不是 | 下文請使用繁體中文思考 |
|
|
27
|
+
| English | Reasoning rules: think, reason, and plan in English. Reply to the user in the language they use. | Note: think, reason, and plan in English, even if the text above is not | Think in English from here on |
|
|
28
|
+
|
|
29
|
+
改文本改 `CATALOGUE`,再 `npm run build`。
|
|
30
|
+
|
|
31
|
+
section 的 `order: 1` 紧跟 persona。提醒分两处:一条独立消息插在批次最前,另一条折进 `skill-catalog` 块的 `content` 首部。`agent/pre-step` 监听器在 `agent/created` 时重新 `prepend`,所以它排在监听链最外层,能看到其余注入追加完再动手。
|
|
32
|
+
|
|
33
|
+
### 提醒间隔
|
|
34
|
+
|
|
35
|
+
存储字段是 `reminderMinutes`:
|
|
36
|
+
|
|
37
|
+
| 值 | 含义 |
|
|
38
|
+
|---|---|
|
|
39
|
+
| 负数 | 关闭每轮提醒(规范化后统一写成 `-1`) |
|
|
40
|
+
| `0` | 每个对话轮次的第一步都提醒 |
|
|
41
|
+
| `1–1440` | 两次提醒之间的最小分钟数,默认 `30` |
|
|
42
|
+
|
|
43
|
+
宿主端由 [`reminderDelayMs`](src/core.ts) 换算;客户端在插件详情页的配置卡片里修改,两处读写同一份设置文档。
|
|
44
|
+
|
|
45
|
+
### 额外提醒注入
|
|
46
|
+
|
|
47
|
+
存储字段是 `extraInjection`(布尔,默认 `true`)。开启时把 `skill-catalog` 块的 `content[0]` 换成「下文请使用简体中文思考」(按所选语言书写),模型因此在那段上下文里先读到规则、再读技能列表。
|
|
48
|
+
|
|
49
|
+
它跟着提醒间隔联动:`reminderMinutes` 为负数时,整个 `agent/pre-step` 监听器提前返回,两处注入一起停;客户端对应地把这一行置灰。
|
|
50
|
+
|
|
51
|
+
---
|
|
52
|
+
|
|
53
|
+
## Token 开销(实测)
|
|
54
|
+
|
|
55
|
+
用 DeepSeek V4 词表实测(不计特殊 token):
|
|
56
|
+
|
|
57
|
+
| 语言 | section(每会话一次) | 前置提醒(每提醒轮次) | 额外提醒(每提醒轮次) |
|
|
58
|
+
|---|---|---|---|
|
|
59
|
+
| 简体中文 | 21 | 14 | 6 |
|
|
60
|
+
| 繁體中文 | 22 | 14 | 6 |
|
|
61
|
+
| English | 23 | 18 | 6 |
|
|
62
|
+
|
|
63
|
+
前置提醒是一条独立的用户消息,额外提醒只改 `skill-catalog` 的 `content[0]`、不新增消息,所以后者便宜。按默认 30 分钟间隔、100 轮算,一个会话约 50 次提醒、合计约 1000–1300 token。**换语言对每轮开销几乎没有影响**。
|
|
64
|
+
|
|
65
|
+
旧版只有一条 10 token 的提醒;现在为了压住英文正文拆成 14 + 6(简体中文)。
|
|
66
|
+
|
|
67
|
+
### 效果数据
|
|
68
|
+
|
|
69
|
+
2026-11-18 实测,prompt 固定为「英文开场 + 中文测试句结尾」:
|
|
70
|
+
|
|
71
|
+
| 做法 | 按所选语言思考 |
|
|
72
|
+
|---|---|
|
|
73
|
+
| 系统提示 + 前置提醒 | 约 30% |
|
|
74
|
+
| 再加额外提醒注入 | 约 70%(30 个样本 21 中) |
|
|
75
|
+
|
|
76
|
+
样本:单注入 10 个(3 中);双注入 40 个(29 中)。同一配置重复跑波动在 7 个百分点以内。**注入提高概率,不保证结果**——用户消息首行就是所选语言时基本不受影响。
|
|
77
|
+
|
|
78
|
+
---
|
|
79
|
+
|
|
80
|
+
## ⚠️ 切换语言的缓存代价
|
|
81
|
+
|
|
82
|
+
DeepSeek 的上下文缓存自动生效、无需改代码,但它**只认从第 0 个 token 起完全相同的前缀**——官方原话:「只有当两个请求的前缀内容相同时(从第 0 个 token 开始相同),才算重复。**中间开始的重复不能被缓存命中**。」([API 上线硬盘缓存](https://api-docs.deepseek.com/zh-cn/news/news0802/))
|
|
83
|
+
|
|
84
|
+
切语言会改变 section 文本,影响范围取决于宿主如何处理 system prompt 更新:
|
|
85
|
+
|
|
86
|
+
- **支持 in-history 的模型**(DeepSeek 官方模型声明 `systemPromptUpdate: 'in-history'`):新 system prompt 作为一条消息追加到历史尾部,旧前缀仍可命中;
|
|
87
|
+
- **其它模型**:宿主替换开头那条 system message,从那里往后的 Token 全部重算。
|
|
88
|
+
|
|
89
|
+
reminder 每轮追加在请求末尾,只新增尾部 Token,不会让已有前缀失效。
|
|
90
|
+
|
|
91
|
+
差价是 **50 倍**(`deepseek-flash` 空闲时段:命中 0.02 元 / 百万 token,未命中 1 元 / 百万 token;高峰时段同样 50 倍。见[模型 & 价格](https://api-docs.deepseek.com/zh-cn/quick_start/pricing/))。切换的代价仍是一次性的,从下一轮起恢复命中。
|
|
92
|
+
|
|
93
|
+
**实用建议**:选定一种语言就别频繁来回切,尤其别在一轮对话中间切。切换不影响正确性,只影响钱。
|
|
94
|
+
|
|
95
|
+
---
|
|
96
|
+
|
|
97
|
+
## 构建与发版
|
|
98
|
+
|
|
99
|
+
```bash
|
|
100
|
+
npm install
|
|
101
|
+
npm run check # typecheck + build
|
|
102
|
+
```
|
|
103
|
+
|
|
104
|
+
构建分两段:
|
|
105
|
+
|
|
106
|
+
1. `tsc -p tsconfig.json` 编译宿主端到 `lib/`;
|
|
107
|
+
2. tsdown 把客户端打成 **CommonJS** 到 `client/client.raw.cjs`,再由 [`scripts/wrap-client-bundle.mjs`](scripts/wrap-client-bundle.mjs) 套上 DSH 的 `__ModuleLoader__` 工厂外壳,输出 `client/client.js`。
|
|
108
|
+
|
|
109
|
+
选 CommonJS 是为了让产物天生就是 `require(...)` 形态——DSH 的客户端工厂只提供 `require`,若先打成 ESM 就还得事后用正则把导入语句改回来。
|
|
110
|
+
|
|
111
|
+
Node(构建)需要 `^22.18.0 || >=24.11.0`;插件运行时不依赖本机 Node。
|
|
112
|
+
|
|
113
|
+
打包与发版:先 `npm run build`,再 `npm pack` 产出 `dsh-thinking-lang-<version>.tgz`;[`scripts/verify-pack.mjs`](scripts/verify-pack.mjs) 校验它带着运行时要加载的文件。发版流程是改 [`package.json`](package.json) 的 `version` → 提交 → `git tag v<version>` → 推送 tag;工作流会构建、校验、发布到 npm(OIDC trusted publishing,不需要 token),并把附件传到该 tag 的 Release,tag 与 `version` 不一致时直接失败。工作流还会上传一个固定名副本 `dsh-thinking-lang.tgz`,供 `releases/latest/download/dsh-thinking-lang.tgz` 这个永远指向最新版本的地址使用。发布包不带 `prepack`/`prepare`,所以 `dsh plugin add` 安装时不会触发 pnpm 的构建授权。
|
|
114
|
+
|
|
115
|
+
## 从源码装(开发用)
|
|
116
|
+
|
|
117
|
+
```bash
|
|
118
|
+
npm install
|
|
119
|
+
npm run build
|
|
120
|
+
dsh plugin --profile desktop add "$PWD"
|
|
121
|
+
```
|
|
122
|
+
|
|
123
|
+
目录依赖在 profile 里以 Junction 指向本项目,改完源码只需重新 `npm run build`,不必重新打包安装。宿主端改动需要重新加载进程(重启或关开插件),客户端改动刷新页面即可。
|
|
124
|
+
|
|
125
|
+
> **不要用 `github:` 安装。** pnpm 11 会拦下依赖的构建脚本,而 `github:` 源要靠 `prepare` 才产出 `lib/` 与 `client/`,安装会停在 `ERR_PNPM_GIT_DEP_PREPARE_NOT_ALLOWED`。npm 包与 [Release 附件](https://github.com/aymidasing/dsh-thinking-lang/releases/latest) 都是构建好的成品,不带 `prepack`/`prepare`,装它不会触发构建授权。
|
|
126
|
+
|
|
127
|
+
---
|
|
128
|
+
|
|
129
|
+
## 目录结构
|
|
130
|
+
|
|
131
|
+
| 路径 | 说明 |
|
|
132
|
+
|------|------|
|
|
133
|
+
| [`src/core.ts`](src/core.ts) | 语言目录、配置归一化、两份提示词生成。**纯函数,无宿主依赖**,客户端与宿主端共用。locale 解析走平台自带的 `Intl.Locale` |
|
|
134
|
+
| [`src/index.ts`](src/index.ts) | 宿主入口:Config schema、section 与 pre-step 提醒注册、语言解析(含操作系统语言探测) |
|
|
135
|
+
| [`src/client/index.ts`](src/client/index.ts) | 客户端入口:在 `settings.general.item` 插槽注册设置行,在 `plugins.bundle.config` 插槽注册配置卡片 |
|
|
136
|
+
| [`src/client/panel.ts`](src/client/panel.ts) | 设置行与插件详情页配置卡片的控件、样式 |
|
|
137
|
+
| [`src/client/locales.ts`](src/client/locales.ts) | 界面文案(简 / 英) |
|
|
138
|
+
| [`cordis.patch.yml`](cordis.patch.yml) | bundle patch,登记宿主入口 |
|
|
139
|
+
| [`PROVENANCE.md`](PROVENANCE.md) | 设置行样式的来源记录,以及从 `app.asar` 读宿主源码的方法(维护用) |
|
|
140
|
+
| `lib/` · `client/` | 构建产物,**不入库**——由 [`package.json`](package.json) 的 `files` 白名单打进包,随 npm 包和 Release 附件一起发布 |
|
|
141
|
+
| [`.github/workflows/release.yml`](.github/workflows/release.yml) | tag 触发:构建、校验、发布到 npm、上传 Release 附件 |
|
|
142
|
+
| [`scripts/verify-pack.mjs`](scripts/verify-pack.mjs) | 校验附件里带着运行时要加载的文件(构建链的看门人) |
|
|
143
|
+
| [`assets/`](assets/) | README 用的截图;随 npm 包与 Release 附件一起发布 |
|
|
144
|
+
|
|
145
|
+
### 依赖面
|
|
146
|
+
|
|
147
|
+
| 类型 | 包 | 说明 |
|
|
148
|
+
|---|---|---|
|
|
149
|
+
| 运行时 | `@deepseek-ai/schemastery` | DSH 的设置 schema 格式,`export const Config` 必需 |
|
|
150
|
+
| 构建期 | `typescript` · `tsdown` · `@types/node` | 只在 `npm run build` 时用到 |
|
|
151
|
+
| 宿主提供 | `@deepseek-ai/dsh-client-ui-primitives` | 客户端用 `tryRequire` 按需取用;宿主没有时降级为原生控件 |
|
|
152
|
+
|
|
153
|
+
**不依赖任何 DSH 类型包。** 宿主上下文由 [`src/index.ts`](src/index.ts) 里的本地 `HostContext` 接口结构化描述,所以包里没有 `@deepseek-ai/cordis`(既不是 dependency 也不是 peerDependency)。
|
|
154
|
+
|
|
155
|
+
宿主端对包只暴露四个导出:`name`、`inject`、`Config`、`apply`——其余全部是模块内私有。
|
|
156
|
+
|
|
157
|
+
---
|
|
158
|
+
|
|
159
|
+
## `auto` 的标签解析细节
|
|
160
|
+
|
|
161
|
+
标签先被清洗成 BCP-47(`_`→`-`,去掉 `.UTF-8`、`@latin` 这类 POSIX 修饰),再交给平台自带的 `Intl.Locale` 拆成语言/文字/地区三段,**不手写标签文法**。查找从最具体到最一般:完整标签 → 带文字的 → 带地区的 → 裸主标签,所以 `en-GB` 会落到 `en`。
|
|
162
|
+
|
|
163
|
+
中文是唯一的例外——两个条目共用 `zh` 这个主标签,决定简繁的是**文字**而不是地区。这部分交给 CLDR:`maximize()` 会把短标签省略的文字补出来,`Hant` 判为繁體、其余判为简体。于是 `zh-TW`/`zh-HK`/`zh-MO`/`zh-Hant` 都是繁體,`zh`/`zh-SG`/`zh-Hans` 都是简体,两张对照表都不需要。
|
|
164
|
+
|
|
165
|
+
---
|
|
166
|
+
|
|
167
|
+
## 已知限制
|
|
168
|
+
|
|
169
|
+
- **section 的位置绑住宿主的分段表**:`order: 1` 取自 `@deepseek-ai/dsh-system-prompt` 的 `SECTION_ORDERS`(persona `0`、`PLAN_POLICY` `500`)。宿主若调整那张表,改 [`src/index.ts`](src/index.ts) 的 `SECTION_ORDER`。
|
|
170
|
+
- **设置行的位置绑住宿主语言项的 order**:宿主语言行注册在 `order: 0`(`@deepseek-ai/dsh-client-locale`),本插件用 `order: 1` 紧贴其后。宿主若调整,改 [`src/client/index.ts`](src/client/index.ts) 的 `ROW_ORDER` 即可。
|
|
171
|
+
- **配置页绑住宿主的 `plugins.bundle.config` 插槽**:插件详情页的配置卡片按包名注册;宿主若改插槽名或 key 规则,改 [`src/client/index.ts`](src/client/index.ts) 的 `PACKAGE_NAME` 与注册名。
|
|
172
|
+
- **只支持三种思考语言**:简体中文、繁體中文、English。要增删语言,改 [`src/core.ts`](src/core.ts) 的 `CATALOGUE`。
|
|
173
|
+
- **没有聊天命令**:切换语言只走设置页。如需 `/thinking-language`,可参照 `dsh-thinking-language` 的命令实现补上。
|
|
174
|
+
- **`auto` 依赖运行时能报出系统语言**:Linux/macOS 走环境变量,Windows 走 `Intl`。两者都拿不到时会静默落到界面语言,再不行才是 `zh-CN`。
|
|
175
|
+
- **插件 id 与设置命名空间**:两者都是 `ay-dsh-tk-lang`,占的是一套自有命名;包名 `dsh-thinking-lang` 与 `dsh-thinking-language` 这类仍然相似,注意区分。功能重复的插件同时装上时,设置页会各插一行、各自注入提示词。
|
|
176
|
+
- **注入只提高概率,不保证结果**:用户消息首行不是所选语言(英文开场、纯图片或附件)时,实测约 30%(仅前置提醒)/ 70%(含额外注入)按所选语言思考。需要稳定拿到目标语言的思考内容,请改用官方思考过程翻译插件。
|
|
177
|
+
- **额外注入依赖 `skill-catalog` 块**:会话里没有技能目录时,规则改插在最后一条注入消息的 `content` 首部,位置与效果都可能不同。
|
package/README.md
CHANGED
|
@@ -10,218 +10,78 @@
|
|
|
10
10
|
|
|
11
11
|
---
|
|
12
12
|
|
|
13
|
-
## 安装
|
|
14
|
-
|
|
15
|
-
```bash
|
|
16
|
-
dsh plugin --profile desktop add dsh-thinking-lang
|
|
17
|
-
```
|
|
18
|
-
|
|
19
|
-
也可以把包名 `dsh-thinking-lang` 粘进设置里的插件管理器安装框。执行前请**完全退出桌面端**:`--profile desktop` 操作的 profile 必须已经初始化,且没有进程正占用它。装完重启 GUI。
|
|
20
|
-
|
|
21
|
-
`main` 分支只有 TypeScript 源码;`lib/` 与 `client/` 是构建产物。安装走 npm 包,或 [Release 附件](https://github.com/aymidasing/dsh-thinking-lang/releases/latest)(`https://github.com/aymidasing/dsh-thinking-lang/releases/latest/download/dsh-thinking-lang.tgz`),两者都是构建好的成品,装的时候不会触发构建授权。
|
|
22
|
-
|
|
23
|
-
**更新**:设置 → 插件里点「更新」,或重新执行一次上面的安装命令。npm 依赖记录为 `^1.0.5` 这样的版本范围,能跟随新版本;用 Release 附件装的话依赖以 URL 记录,换版本要重装一次新的附件地址。
|
|
24
|
-
|
|
25
|
-
**卸载**:
|
|
26
|
-
|
|
27
|
-
```bash
|
|
28
|
-
dsh plugin --profile desktop remove dsh-thinking-lang
|
|
29
|
-
```
|
|
30
|
-
|
|
31
|
-
设置里的「思考语言」那一行随之消失,提示词也不再注入。和安装一样,要在桌面端完全退出后执行。
|
|
32
|
-
|
|
33
|
-
从源码装(开发用):
|
|
34
|
-
|
|
35
|
-
```bash
|
|
36
|
-
npm install
|
|
37
|
-
npm run build
|
|
38
|
-
dsh plugin --profile desktop add "$PWD"
|
|
39
|
-
```
|
|
40
|
-
|
|
41
|
-
**语言约束对新会话生效**;切语言本身在已有会话的下一轮就生效。
|
|
42
|
-
|
|
43
|
-
> **不要再用 `github:` 安装。** pnpm 11 默认拦下依赖的构建脚本,而 `github:` 源要靠 `prepare` 才产出 `lib/` 与 `client/`,安装会停在 `ERR_PNPM_GIT_DEP_PREPARE_NOT_ALLOWED`,除非在 profile 的 `pnpm-workspace.yaml` 里逐名放行 `allowBuilds`。npm 包与 Release 附件都是成品,包里没有 `prepack`/`prepare`,装它不会触发构建授权。
|
|
44
|
-
|
|
45
|
-
---
|
|
46
|
-
|
|
47
13
|
## 它做什么
|
|
48
14
|
|
|
49
|
-
在**设置 →
|
|
15
|
+
在**设置 → 通用**里新增一行「思考语言」,并在**插件页 → 本插件详情**里提供同一份配置。两处读写同一份设置:
|
|
50
16
|
|
|
51
17
|
| 配置项 | 取值 | 作用 |
|
|
52
18
|
|--------|------|------|
|
|
53
19
|
| **思考语言** | 自动 / 简体中文 / 繁體中文 / English | 内部推理与规划所用的语言 |
|
|
20
|
+
| **提醒间隔** | 关闭 / 每轮 / 10 / 30 / 60 分钟 / 自定义 1–1440 | 两次「用该语言思考」提醒之间的最小间隔,默认 **30 分钟** |
|
|
21
|
+
| **额外提醒注入** | 开启 / 关闭 | 开启时把提醒同时并入技能目录那段上下文;提醒间隔为「关闭」时此项一并停用。默认开启 |
|
|
22
|
+
|
|
23
|
+
「关闭」停止全部注入,只保留系统提示里的规则;「每轮」是每个对话轮次的第一步都提醒一次。
|
|
54
24
|
|
|
55
25
|

|
|
56
26
|
|
|
57
27
|
*截图:设置 → 通用里的「思考语言」行,紧贴在宿主自己的界面语言下方。*
|
|
58
28
|
|
|
59
|
-
|
|
60
|
-
|
|
61
|
-
选「自动」时,按顺序取**第一个**能映射到语言目录的来源:
|
|
62
|
-
|
|
63
|
-
| 顺序 | 来源 | 取值方式 |
|
|
64
|
-
|---|---|---|
|
|
65
|
-
| 1 | **操作系统语言** | POSIX 环境变量 `LC_ALL` / `LC_MESSAGES` / `LANG`;Windows 上这些通常为空,改用 `Intl.DateTimeFormat().resolvedOptions().locale`(跟随系统区域设置) |
|
|
66
|
-
| 2 | **DSH 界面语言** | 设置服务里 `locale` 命名空间的 `preference` 字段 |
|
|
67
|
-
| 3 | **兜底** | 硬编码的 `zh-CN`(`FALLBACK_TAG`) |
|
|
68
|
-
|
|
69
|
-
标签先被清洗成 BCP-47(`_`→`-`,去掉 `.UTF-8`、`@latin` 这类 POSIX 修饰),再交给平台自带的 `Intl.Locale` 拆成语言/文字/地区三段,**不手写标签文法**。查找从最具体到最一般:完整标签 → 带文字的 → 带地区的 → 裸主标签,所以 `en-GB` 会落到 `en`。
|
|
70
|
-
|
|
71
|
-
中文是唯一的例外——两个条目共用 `zh` 这个主标签,决定简繁的是**文字**而不是地区。这部分交给 CLDR:`maximize()` 会把短标签省略的文字补出来,`Hant` 判为繁體、其余判为简体。于是 `zh-TW`/`zh-HK`/`zh-MO`/`zh-Hant` 都是繁體,`zh`/`zh-SG`/`zh-Hans` 都是简体,两张对照表都不需要。
|
|
72
|
-
|
|
73
|
-
| 系统 | 界面 | 结果 |
|
|
74
|
-
|---|---|---|
|
|
75
|
-
| `zh-CN` | `en-US` | 简体中文 |
|
|
76
|
-
| `en-US` | `zh-CN` | English |
|
|
77
|
-
| `fr-FR`(目录里没有) | `en-US` | English(落到下一级) |
|
|
78
|
-
| 取不到 | 取不到 | 简体中文 |
|
|
79
|
-
|
|
80
|
-
在下拉里**显式选了某个语言**时,那个选择优先于上面全部三级,与系统/界面语言无关。
|
|
81
|
-
|
|
82
|
-
---
|
|
83
|
-
|
|
84
|
-
## 提示词是怎么注入的
|
|
29
|
+

|
|
85
30
|
|
|
86
|
-
|
|
31
|
+
*截图:插件页 → 本插件详情里的同一份配置,含「提醒间隔」的预设与自定义输入,以及「额外提醒注入」开关。*
|
|
87
32
|
|
|
88
|
-
|
|
89
|
-
|---|---|---|
|
|
90
|
-
| 由谁生成 | [`sectionText`](src/core.ts) | [`reminderText`](src/core.ts) |
|
|
91
|
-
| 内容 | 完整规则句 | 一句短提醒 |
|
|
92
|
-
| 注入形态 | 系统提示词的一段 | 一条 user 消息,追加在请求末尾 |
|
|
93
|
-
| 频率 | 每会话组装一次(文本变化时提交) | 每轮第一步,且距上次 ≥10 分钟 |
|
|
94
|
-
| 顺序 | `order: 1`,紧跟 persona | `prepend` 注册,晚于其它 pre-step 注入 |
|
|
95
|
-
|
|
96
|
-
### 实际注入的文本
|
|
97
|
-
|
|
98
|
-
文本由 [`src/core.ts`](src/core.ts) 的 `CATALOGUE` 提供,每种语言一份、**用该语言书写**:
|
|
99
|
-
|
|
100
|
-
| 语言 | section(规则句) | reminder(每轮提醒) |
|
|
101
|
-
|---|---|---|
|
|
102
|
-
| 简体中文 | 推理规则:思考、推理与规划一律使用简体中文。回复用户时使用用户所用的语言。 | 继续用简体中文思考、推理与规划。 |
|
|
103
|
-
| 繁體中文 | 推理規則:思考、推理與規劃一律使用繁體中文。回覆使用者時使用使用者所用的語言。 | 繼續用繁體中文思考、推理與規劃。 |
|
|
104
|
-
| English | Reasoning rules: think, reason, and plan in English. Reply to the user in the language they use. | Keep thinking, reasoning, and planning in English. |
|
|
33
|
+
### 效果与限制
|
|
105
34
|
|
|
106
|
-
|
|
35
|
+
注入提高的是概率,不是保证。用户消息本身就用的所选语言时基本没问题;**用户消息首行不是所选语言**(英文开场、纯图片、只有附件)时实测:
|
|
107
36
|
|
|
108
|
-
|
|
109
|
-
|
|
110
|
-
|
|
111
|
-
|
|
112
|
-
|
|
113
|
-
> 上一版把提醒塞进 `systemPrompt.context`:它随 runtime-context 快照走,只在快照内容变化时追加,稳定期会沉到历史深处。现在改成独立消息、按轮注入。
|
|
114
|
-
|
|
115
|
-
### 顺序与优先级
|
|
116
|
-
|
|
117
|
-
- section 的 `order: 1` 紧跟在宿主的 persona 之后、第一个策略段之前——也就是渲染出来的 persona 那句话的下一行。
|
|
118
|
-
- 提醒消息排在请求最末。`prepend` 让本监听器先于其它 pre-step 监听器执行,其 append 发生在链返回之后,因此晚于 time-context 等注入。
|
|
37
|
+
| 做法 | 按所选语言思考的比例 |
|
|
38
|
+
|---|---|
|
|
39
|
+
| 系统提示 + 前置提醒(默认) | 约 **30%** |
|
|
40
|
+
| 再开启「额外提醒注入」 | 约 **70%** |
|
|
119
41
|
|
|
120
|
-
|
|
42
|
+
额外注入本身多花约 6 token(简体中文),换来请求尾部一次强提醒。
|
|
121
43
|
|
|
122
|
-
|
|
44
|
+
**如果目标是稳定拿到目标语言的思考内容**,用官方的思考过程翻译插件更合适:它把思考内容翻译后显示,代价是每次都要多付一遍翻译的 token。本插件只在「直接改思考语言、并接受大多数时候是它」这个场景下更省。
|
|
123
45
|
|
|
124
|
-
|
|
46
|
+
### 「自动」怎么判定
|
|
125
47
|
|
|
126
|
-
|
|
48
|
+
选「自动」时,按顺序取**第一个**能映射到语言目录的来源:
|
|
127
49
|
|
|
128
|
-
|
|
|
50
|
+
| 顺序 | 来源 | 取值方式 |
|
|
129
51
|
|---|---|---|
|
|
130
|
-
|
|
|
131
|
-
|
|
|
132
|
-
|
|
|
133
|
-
|
|
134
|
-
section 每会话一次;reminder 每轮最多一条(10 分钟内不重复),100 轮约 1000 token。**换语言对每轮开销几乎没有影响**。
|
|
135
|
-
|
|
136
|
-
---
|
|
137
|
-
|
|
138
|
-
## ⚠️ 切换语言的缓存代价
|
|
139
|
-
|
|
140
|
-
DeepSeek 的上下文缓存自动生效、无需改代码,但它**只认从第 0 个 token 起完全相同的前缀**——官方原话:「只有当两个请求的前缀内容相同时(从第 0 个 token 开始相同),才算重复。**中间开始的重复不能被缓存命中**。」([API 上线硬盘缓存](https://api-docs.deepseek.com/zh-cn/news/news0802/))
|
|
141
|
-
|
|
142
|
-
切语言会改变 section 文本,影响范围取决于宿主如何处理 system prompt 更新:
|
|
143
|
-
|
|
144
|
-
- **支持 in-history 的模型**(DeepSeek 官方模型声明 `systemPromptUpdate: 'in-history'`):新 system prompt 作为一条消息追加到历史尾部,旧前缀仍可命中;
|
|
145
|
-
- **其它模型**:宿主替换开头那条 system message,从那里往后的 Token 全部重算。
|
|
52
|
+
| 1 | **操作系统语言** | POSIX 环境变量 `LC_ALL` / `LC_MESSAGES` / `LANG`;Windows 上这些通常为空,改用系统区域设置 |
|
|
53
|
+
| 2 | **DSH 界面语言** | 设置里 `locale` 命名空间的 `preference` 字段 |
|
|
54
|
+
| 3 | **兜底** | `zh-CN` |
|
|
146
55
|
|
|
147
|
-
|
|
148
|
-
|
|
149
|
-
差价是 **50 倍**(`deepseek-flash` 空闲时段:命中 0.02 元 / 百万 token,未命中 1 元 / 百万 token;高峰时段同样 50 倍。见[模型 & 价格](https://api-docs.deepseek.com/zh-cn/quick_start/pricing/))。切换的代价仍是一次性的,从下一轮起恢复命中。
|
|
150
|
-
|
|
151
|
-
**实用建议**:选定一种语言就别频繁来回切,尤其别在一轮对话中间切。切换不影响正确性,只影响钱。
|
|
56
|
+
在下拉里**显式选了某个语言**时,那个选择优先于上面全部三级,与系统/界面语言无关。
|
|
152
57
|
|
|
153
58
|
---
|
|
154
59
|
|
|
155
|
-
##
|
|
60
|
+
## 安装与卸载
|
|
156
61
|
|
|
157
62
|
```bash
|
|
158
|
-
|
|
159
|
-
npm run check # typecheck + build
|
|
63
|
+
dsh plugin --profile desktop add dsh-thinking-lang
|
|
160
64
|
```
|
|
161
65
|
|
|
162
|
-
|
|
163
|
-
|
|
164
|
-
1. `tsc -p tsconfig.json` 编译宿主端到 `lib/`;
|
|
165
|
-
2. tsdown 把客户端打成 **CommonJS** 到 `client/client.raw.cjs`,再由 [`scripts/wrap-client-bundle.mjs`](scripts/wrap-client-bundle.mjs) 套上 DSH 的 `__ModuleLoader__` 工厂外壳,输出 `client/client.js`。
|
|
66
|
+
也可以把包名贴进设置里的插件管理器。执行前**完全退出桌面端**:`--profile desktop` 操作的 profile 不能被占用;装完重启 GUI。
|
|
166
67
|
|
|
167
|
-
|
|
68
|
+
**更新**:设置 → 插件里点「更新」,或重复上面那条命令。
|
|
168
69
|
|
|
169
|
-
|
|
170
|
-
|
|
171
|
-
打包与发版:先 `npm run build`,再 `npm pack` 产出 `dsh-thinking-lang-<version>.tgz`;[`scripts/verify-pack.mjs`](scripts/verify-pack.mjs) 校验它带着运行时要加载的文件。发版流程是改 [`package.json`](package.json) 的 `version` → 提交 → `git tag v<version>` → 推送 tag;工作流会构建、校验、发布到 npm(OIDC trusted publishing,不需要 token),并把附件传到该 tag 的 Release,tag 与 `version` 不一致时直接失败。工作流还会上传一个固定名副本 `dsh-thinking-lang.tgz`,供 `releases/latest/download/dsh-thinking-lang.tgz` 这个永远指向最新版本的地址使用。发布包不带 `prepack`/`prepare`,所以 `dsh plugin add` 安装时不会触发 pnpm 的构建授权。
|
|
172
|
-
|
|
173
|
-
---
|
|
174
|
-
|
|
175
|
-
## 目录结构
|
|
176
|
-
|
|
177
|
-
| 路径 | 说明 |
|
|
178
|
-
|------|------|
|
|
179
|
-
| [`src/core.ts`](src/core.ts) | 语言目录、配置归一化、两份提示词生成。**纯函数,无宿主依赖**,客户端与宿主端共用。locale 解析走平台自带的 `Intl.Locale` |
|
|
180
|
-
| [`src/index.ts`](src/index.ts) | 宿主入口:Config schema、section 与 pre-step 提醒注册、语言解析(含操作系统语言探测) |
|
|
181
|
-
| [`src/client/index.ts`](src/client/index.ts) | 客户端入口:在 `settings.general.item` 插槽注册设置行 |
|
|
182
|
-
| [`src/client/panel.ts`](src/client/panel.ts) | 单行设置控件与样式 |
|
|
183
|
-
| [`src/client/locales.ts`](src/client/locales.ts) | 三套行文案(简 / 繁 / 英) |
|
|
184
|
-
| [`cordis.patch.yml`](cordis.patch.yml) | bundle patch,登记宿主入口 |
|
|
185
|
-
| [`PROVENANCE.md`](PROVENANCE.md) | 设置行样式的来源记录,以及从 `app.asar` 读宿主源码的方法(维护用) |
|
|
186
|
-
| `lib/` · `client/` | 构建产物,**不入库**——只随 Release 附件提供;[`package.json`](package.json) 的 `files` 白名单负责把它们打进包 |
|
|
187
|
-
| [`.github/workflows/release.yml`](.github/workflows/release.yml) | tag 触发:构建、校验、上传 Release 附件 |
|
|
188
|
-
| [`scripts/verify-pack.mjs`](scripts/verify-pack.mjs) | 校验附件里带着运行时要加载的文件(构建链的看门人) |
|
|
189
|
-
| [`assets/`](assets/) | README 用的截图;随 npm 包与 Release 附件一起发布,插件详情页按相对路径直接读取 |
|
|
190
|
-
|
|
191
|
-
### 依赖面
|
|
192
|
-
|
|
193
|
-
| 类型 | 包 | 说明 |
|
|
194
|
-
|---|---|---|
|
|
195
|
-
| 运行时 | `@deepseek-ai/schemastery` | DSH 的设置 schema 格式,`export const Config` 必需 |
|
|
196
|
-
| 构建期 | `typescript` · `tsdown` · `@types/node` | 只在 `npm run build` 时用到 |
|
|
197
|
-
| 宿主提供 | `@deepseek-ai/dsh-client-ui-primitives` | 客户端用 `tryRequire` 按需取用;宿主没有时降级为原生控件 |
|
|
198
|
-
|
|
199
|
-
**不依赖任何 DSH 类型包。** 宿主上下文由 [`src/index.ts`](src/index.ts) 里的本地 `HostContext` 接口结构化描述,所以包里没有 `@deepseek-ai/cordis`(既不是 dependency 也不是 peerDependency)。
|
|
200
|
-
|
|
201
|
-
宿主端对包只暴露四个导出:`name`、`inject`、`Config`、`apply`——其余全部是模块内私有。
|
|
202
|
-
|
|
203
|
-
### 设置行文案的语言(预留功能,默认关闭)
|
|
70
|
+
**卸载**:
|
|
204
71
|
|
|
205
|
-
|
|
72
|
+
```bash
|
|
73
|
+
dsh plugin --profile desktop remove dsh-thinking-lang
|
|
74
|
+
```
|
|
206
75
|
|
|
207
|
-
|
|
208
|
-
|---|---|
|
|
209
|
-
| 开关 | [`src/client/locales.ts`](src/client/locales.ts) 里的 `COPY_FOLLOWS_THINKING_LANGUAGE`,默认 `false` |
|
|
210
|
-
| 启用 | 改成 `true` → `npm run build` → 重启 GUI |
|
|
211
|
-
| 还要改别的文件吗 | 不用。三套字典与选取函数 `dictionaryFor` 都在 `locales.ts` 里 |
|
|
76
|
+
设置里的「思考语言」行随之消失,提示词也不再注入;同样要在桌面端完全退出后执行。
|
|
212
77
|
|
|
213
|
-
|
|
78
|
+
**语言约束对新会话生效**;切语言本身在已有会话的下一轮就生效。
|
|
214
79
|
|
|
215
80
|
---
|
|
216
81
|
|
|
217
|
-
##
|
|
82
|
+
## 开发与实现细节
|
|
218
83
|
|
|
219
|
-
|
|
220
|
-
- **设置行的位置绑住宿主语言项的 order**:宿主语言行注册在 `order: 0`(`@deepseek-ai/dsh-client-locale`),本插件用 `order: 1` 紧贴其后。宿主若调整,改 [`src/client/index.ts`](src/client/index.ts) 的 `ROW_ORDER` 即可。
|
|
221
|
-
- **只支持三种思考语言**:简体中文、繁體中文、English。要增删语言,改 [`src/core.ts`](src/core.ts) 的 `CATALOGUE`,并在 [`src/client/locales.ts`](src/client/locales.ts) 补上对应文案。
|
|
222
|
-
- **没有聊天命令**:切换语言只走设置页。如需 `/thinking-language`,可参照 `dsh-thinking-language` 的命令实现补上。
|
|
223
|
-
- **`auto` 依赖运行时能报出系统语言**:Linux/macOS 走环境变量,Windows 走 `Intl`。两者都拿不到时会静默落到界面语言,再不行才是 `zh-CN`——顺序与取值方式见上文「`auto` 是怎么判定的」。
|
|
224
|
-
- **插件 id 与设置命名空间**:两者都是 `ay-dsh-tk-lang`,占的是一套自有命名;包名 `dsh-thinking-lang` 与 `dsh-thinking-language` 这类仍然相似,注意区分。不过功能重复的插件同时装上,设置页会各插一行、各自注入提示词,功能上仍是重复的。
|
|
84
|
+
构建与发版、提示词注入机制、Token 开销、缓存影响、目录结构和已知限制,见 [DEVELOPMENT.md](DEVELOPMENT.md)。
|
|
225
85
|
|
|
226
86
|
---
|
|
227
87
|
|
|
Binary file
|