@lingda-ai/dsh-plugin-ledger 0.1.2 → 0.1.4
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/LICENSE +17 -0
- package/cordis.patch.yml +3 -2
- package/docs/business-plan.md +237 -0
- package/docs/spikes.md +373 -0
- package/docs/technical.md +364 -0
- package/docs/wire-format.md +95 -0
- package/lib/attribution.js +73 -0
- package/lib/audit-tool.js +184 -0
- package/lib/budget-message.js +28 -0
- package/lib/client.js +217 -0
- package/lib/config.js +74 -0
- package/lib/guard.js +102 -0
- package/lib/identity.js +119 -0
- package/lib/index.js +217 -0
- package/lib/ledger.js +260 -0
- package/lib/panel-path.js +39 -0
- package/lib/panel-view.js +717 -0
- package/lib/pricing-file.js +169 -0
- package/lib/pricing-table.js +55 -0
- package/lib/pricing.js +84 -0
- package/lib/ring.js +54 -0
- package/lib/snapshot-file.js +293 -0
- package/lib/store.js +330 -0
- package/lib/tool-size.js +25 -0
- package/lib/trace-file.js +139 -0
- package/lib/trace.js +82 -0
- package/lib/usage.js +67 -0
- package/lib/wire.js +87 -0
- package/package.json +25 -5
package/LICENSE
ADDED
|
@@ -0,0 +1,17 @@
|
|
|
1
|
+
Apache License
|
|
2
|
+
Version 2.0, January 2004
|
|
3
|
+
http://www.apache.org/licenses/
|
|
4
|
+
|
|
5
|
+
Copyright 2026 林政通 (LingDaAi / 灵搭)
|
|
6
|
+
|
|
7
|
+
Licensed under the Apache License, Version 2.0 (the "License");
|
|
8
|
+
you may not use this file except in compliance with the License.
|
|
9
|
+
You may obtain a copy of the License at
|
|
10
|
+
|
|
11
|
+
http://www.apache.org/licenses/LICENSE-2.0
|
|
12
|
+
|
|
13
|
+
Unless required by applicable law or agreed to in writing, software
|
|
14
|
+
distributed under the License is distributed on an "AS IS" BASIS,
|
|
15
|
+
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
|
16
|
+
See the License for the specific language governing permissions and
|
|
17
|
+
limitations under the License.
|
package/cordis.patch.yml
CHANGED
|
@@ -0,0 +1,237 @@
|
|
|
1
|
+
# 账本(dsh-plugin-ledger)商业计划书
|
|
2
|
+
|
|
3
|
+
> 主体:灵搭 / LingDaAi(独立产品线,不与任何其他公司主体混用)
|
|
4
|
+
> 版本:v0.1 · 2026-11
|
|
5
|
+
> 配套:技术文档 `docs/technical.md`、协议 `docs/wire-format.md`
|
|
6
|
+
|
|
7
|
+
---
|
|
8
|
+
|
|
9
|
+
## 1. 一句话定位
|
|
10
|
+
|
|
11
|
+
**AI 编程的成本仪表盘,从"这个会话为什么贵"做到"这个团队的钱花得值不值"。**
|
|
12
|
+
|
|
13
|
+
不是计费系统,不是调试追踪器——是一个**让人敢开 AI 而不怕账单**的工具。
|
|
14
|
+
|
|
15
|
+
---
|
|
16
|
+
|
|
17
|
+
## 2. 机会
|
|
18
|
+
|
|
19
|
+
### 2.1 痛点是真的,而且正在变大
|
|
20
|
+
|
|
21
|
+
AI coding 的成本结构有三个特征,让传统工具都不适用:
|
|
22
|
+
|
|
23
|
+
1. **价格不透明**:同一份 token,命中与未命中差 50 倍;订阅制和按量制混在同一个团队里,没人说得清总账。
|
|
24
|
+
2. **归因困难**:一次对话花了 ¥0.05,是模型贵、工具吐了 18k 字符、还是压缩没生效?只有一个数字,没有解释。
|
|
25
|
+
3. **决策缺依据**:工程师不知道还能问几次;管理者不知道该不该给某个项目加预算。
|
|
26
|
+
|
|
27
|
+
### 2.2 现有工具都只解了一半
|
|
28
|
+
|
|
29
|
+
| 类型 | 代表 | 解决什么 | 缺什么 |
|
|
30
|
+
|---|---|---|---|
|
|
31
|
+
| 追踪调试 | LangSmith / Langfuse | 链路、prompt、evaluation | 不做钱,不做治理 |
|
|
32
|
+
| 单工具用量面板 | 各 IDE 自带的 usage | 自己的 token 数 | 只看自己,跨工具为零,无归因 |
|
|
33
|
+
| 云账单 | 厂商控制台 | 最终金额 | 滞后、无明细、无归因、不跨厂商 |
|
|
34
|
+
| 财务系统 | ERP / 报销 | 对账、发票 | 看不到"花在哪一步" |
|
|
35
|
+
|
|
36
|
+
**空白区很清楚**:跨工具、能归因、敢说"不知道"、能和账单对账的中间层。
|
|
37
|
+
|
|
38
|
+
### 2.3 三类客户,价值主张不同
|
|
39
|
+
|
|
40
|
+
| 客户 | 规模 | 他们在意什么 | 愿意为谁付钱 |
|
|
41
|
+
|---|---|---|---|
|
|
42
|
+
| 个人开发者 | 1 人 | 别把钱烧在看不见的地方 | 免费(用开源版) |
|
|
43
|
+
| 中小团队 | 5–50 人 | 谁在烧、该不该管 | 团队版订阅 |
|
|
44
|
+
| 企业 / 国企 | 50+ 人 | 合规、审计、账单对得上 | 私有化 + License |
|
|
45
|
+
|
|
46
|
+
---
|
|
47
|
+
|
|
48
|
+
## 3. 产品结构:三档,一条清晰的分界线
|
|
49
|
+
|
|
50
|
+
```
|
|
51
|
+
┌─────────────────────────────────────────────┐
|
|
52
|
+
│ 企业版 私有化 + License + 等保材料 │ 对账、审计、数据不出域
|
|
53
|
+
├─────────────────────────────────────────────┤
|
|
54
|
+
│ 团队版 多端汇聚 + 人/项目维度 + 预算治理 │ ← 商业分界线
|
|
55
|
+
├─────────────────────────────────────────────┤
|
|
56
|
+
│ 开源版 单会话账本(已上线) │ 免费,全功能不阉割
|
|
57
|
+
└─────────────────────────────────────────────┘
|
|
58
|
+
```
|
|
59
|
+
|
|
60
|
+
**分界线是「会话账本 → 团队账本」,不是更多图表。**
|
|
61
|
+
开源版回答"这次会话贵不贵",团队版回答"这个部门这周花了多少、该不该管"。
|
|
62
|
+
两者之间不是功能多少的差别,是**有没有治理能力**的差别。
|
|
63
|
+
|
|
64
|
+
### 3.1 开源版(已可用)
|
|
65
|
+
|
|
66
|
+
- 四档计价、缓存节省额、工具体积归因、压缩前后对照、预算与"还能问几次"
|
|
67
|
+
- 单会话 + 跨会话对比
|
|
68
|
+
- 三条铁律:采集只订阅、决策只改配置、未知即未知
|
|
69
|
+
- Apache-2.0,允许商用集成(含私有化),不收授权费
|
|
70
|
+
|
|
71
|
+
### 3.2 团队版(未开工,需先验证)
|
|
72
|
+
|
|
73
|
+
| 能力 | 为什么值钱 |
|
|
74
|
+
|---|---|
|
|
75
|
+
| 多端汇聚 | 一台机器一个孤岛,团队要一张总表 |
|
|
76
|
+
| 按人/项目维度 | 归因到人才能治理,归到插件只能自省 |
|
|
77
|
+
| 三级预算(组织/项目/个人) | 超限告警给管理员,而不是提示模型自己压缩 |
|
|
78
|
+
| 周报推送(飞书/企微/钉钉) | 让人不用打开面板就能被提醒 |
|
|
79
|
+
| 异常检测 | "某人今天花了日均 10 倍"比阈值告警更有用 |
|
|
80
|
+
| 数据保留与脱敏策略 | 合规底线,不是可选项 |
|
|
81
|
+
|
|
82
|
+
### 3.3 企业版
|
|
83
|
+
|
|
84
|
+
- 私有化部署(Docker Compose 起步,K8s 可选)+ License 授权初始化
|
|
85
|
+
- **账单对账**:采集到的金额 vs 厂商账单,出差异报告
|
|
86
|
+
- 审计日志不可篡改、数据不出域、三级等保材料
|
|
87
|
+
- 与财务系统导出对接(CSV/Excel,不承诺发票)
|
|
88
|
+
|
|
89
|
+
---
|
|
90
|
+
|
|
91
|
+
## 4. 差异化:三条别人不容易抄的
|
|
92
|
+
|
|
93
|
+
### 4.1 敢说「不知道」
|
|
94
|
+
|
|
95
|
+
竞品普遍把缺失数据填成 0 或估算值,让报表看起来完整。账本的做法相反:
|
|
96
|
+
|
|
97
|
+
- 费率缺失 → `— no-rate`,合计旁边写「其中 N 条费率未知,合计偏低」
|
|
98
|
+
- 省下的 token 属命中还是未命中无法推断 → **只报 token,不折钱**
|
|
99
|
+
|
|
100
|
+
短期看"不够漂亮",长期看这是**唯一能被财务信任的报表特征**。
|
|
101
|
+
|
|
102
|
+
### 4.2 缓存节省额是严格算出来的
|
|
103
|
+
|
|
104
|
+
```
|
|
105
|
+
saved = cacheReadTokens × (input 单价 − cacheRead 单价)
|
|
106
|
+
```
|
|
107
|
+
|
|
108
|
+
两个单价同表、差额确定,不需要任何假设。这是市面上少见的"可审计的省了多少钱"。
|
|
109
|
+
客户看到「缓存命中已省 ¥0.0153 · 占应花 25.1%」,才会相信这个工具在帮他省钱,而不只是在报数。
|
|
110
|
+
|
|
111
|
+
### 4.3 协议为多工具而生,不是一个工具的皮肤
|
|
112
|
+
|
|
113
|
+
计量用 `measures[]`(单位+数值),token 只是其中一种单位;席位订阅用 `seat.month`。
|
|
114
|
+
幂等键 `sha1(session|turn|step|operation)` 解决双端重复入账。
|
|
115
|
+
这两件在只有一个来源时就锁定,意味着第二个工具接入的成本是"一张映射表",不是一次重构。
|
|
116
|
+
|
|
117
|
+
---
|
|
118
|
+
|
|
119
|
+
## 5. 定价
|
|
120
|
+
|
|
121
|
+
### 5.1 原则
|
|
122
|
+
|
|
123
|
+
**不为功能加锁,为治理收费。** 开源版全功能免费,付费买的是"跨人、跨工具、可对账"。
|
|
124
|
+
|
|
125
|
+
锚定逻辑:团队版价格 ≈ 客户被管住的 AI 支出的 10–15%。一个 20 人团队每月 AI 花费 ¥3000–8000,
|
|
126
|
+
年付 ¥3600–7200 属可接受区间。
|
|
127
|
+
|
|
128
|
+
### 5.2 建议价目
|
|
129
|
+
|
|
130
|
+
| 档位 | 价格 | 门槛 | 说明 |
|
|
131
|
+
|---|---|---|---|
|
|
132
|
+
| 开源版 | ¥0 | — | Apache-2.0,可商用集成 |
|
|
133
|
+
| 团队版 | **¥180 / 人 / 年** | 10 人起(¥1800/年) | 含汇聚、人/项目维度、三级预算、周报 |
|
|
134
|
+
| 团队版·年付优惠 | ¥150 / 人 / 年 | 20 人以上 | 降低决策成本 |
|
|
135
|
+
| 企业版 | **¥3–8 万 / 年** | 按规模 | 私有化 + License + 等保材料 + 对账 |
|
|
136
|
+
| 一次性部署服务 | ¥1–3 万 | 可选 | 私有化实施、集成、培训 |
|
|
137
|
+
| 知识付费(DSH 插件开发) | ¥299–999 / 课 | — | 引流 + 品牌,与主产品互补 |
|
|
138
|
+
|
|
139
|
+
> 所有价格是建议,需 owner 拍板。企业版区间取决于是否含等保测评配合工作。
|
|
140
|
+
|
|
141
|
+
### 5.3 为什么不卖"按用量抽成"
|
|
142
|
+
|
|
143
|
+
按 token 抽成会把账本变成计费系统,接着就要背对账、发票、调价追溯、税务口径——那是财务产品的活。
|
|
144
|
+
**账本只回答"钱花在哪、谁花的、值不值",可以导出给财务,但不替财务下结论。** 这条边界必须守。
|
|
145
|
+
|
|
146
|
+
---
|
|
147
|
+
|
|
148
|
+
## 6. 增长路径
|
|
149
|
+
|
|
150
|
+
### 阶段一:开源铺开(现在 → 3 个月)
|
|
151
|
+
|
|
152
|
+
- Gitee 主仓 + npm 生态发布(`dsh-plugin-ledger`)
|
|
153
|
+
- 目标:**50–200 个真实安装**,不是 star 数
|
|
154
|
+
- 内容:技术文档已在写(原理级);再补 3 篇——"为什么缓存命中差 50 倍"、"压缩到底省不省钱"、"我们为什么不填 0"
|
|
155
|
+
- 渠道:DSH 社区、Gitee 推荐、掘金/知乎技术长文
|
|
156
|
+
- 验证门槛(决定是否继续投入):**有 5 个以上外部用户持续使用两周**、至少 3 个真实反馈
|
|
157
|
+
|
|
158
|
+
### 阶段二:团队版最小闭环(验证通过后 → 6 个月)
|
|
159
|
+
|
|
160
|
+
只做一件事:`本地流水 → 批量上报 → 一页「本周按人/按项目」视图`。
|
|
161
|
+
|
|
162
|
+
- 需要三块底座:身份绑定(已有线索)、上报通道、共享计价包
|
|
163
|
+
- 硬指标:上报过程**不影响插件热路径**(旁路定时器,性能门禁不得退化)
|
|
164
|
+
- 定价试水:先做 3–5 家种子客户(¥180/人/年),换取真实账单数据
|
|
165
|
+
|
|
166
|
+
### 阶段三:企业版(有 2 家以上付费企业后)
|
|
167
|
+
|
|
168
|
+
- 私有化打包 + License 初始化
|
|
169
|
+
- **账单对账**是这一档的核心卖点:采集 ¥4300 / 账单 ¥4600 / 差 ¥300 怎么来的
|
|
170
|
+
- 等保材料配合
|
|
171
|
+
|
|
172
|
+
---
|
|
173
|
+
|
|
174
|
+
## 7. 里程碑与工程量(估算,非承诺)
|
|
175
|
+
|
|
176
|
+
| 里程碑 | 内容 | 工程量 | 出口标准 |
|
|
177
|
+
|---|---|---|---|
|
|
178
|
+
| M0 ✅ | 单会话账本 | 已完成 | 158 例断言、性能门禁、面板真实渲染 |
|
|
179
|
+
| M0.5 ✅ | 协议冻结 + 身份线索 | 已完成 | `docs/wire-format.md`,幂等/计量/身份三件落盘 |
|
|
180
|
+
| M1 | 发布就绪 | 1 人日 | 代码仓 + 公开可见 + 无凭据阻塞 |
|
|
181
|
+
| M2 | 开源铺开 | 持续 | 50–200 安装,5 个持续用户 |
|
|
182
|
+
| M3 | 上报通道 + 聚合服务 | 8–12 人日 | 幂等去重、断网续传、热路径零退化 |
|
|
183
|
+
| M4 | 团队视图(一页) | 4–6 人日 | 按人/项目/工具三维,可在手机上看 |
|
|
184
|
+
| M5 | 席位摊销 + 双口径 | 5 人日 | 边际成本 / 总拥有成本可切换且标注 |
|
|
185
|
+
| M6 | 账单对账 | 6 人日 | 导入 CSV 出差异报告 |
|
|
186
|
+
| M7 | 企业版打包 | 8 人日 | 一键部署 + License |
|
|
187
|
+
|
|
188
|
+
---
|
|
189
|
+
|
|
190
|
+
## 8. 财务假设(明确标注:全部为假设,不是预测)
|
|
191
|
+
|
|
192
|
+
假设前提:由 1 名主力开发 + 兼职支持推进;不投广告;靠技术内容与生态自然增长。
|
|
193
|
+
|
|
194
|
+
| 指标 | 保守 | 基准 | 乐观 |
|
|
195
|
+
|---|---|---|---|
|
|
196
|
+
| 12 个月安装数 | 200 | 800 | 2000 |
|
|
197
|
+
| 付费转化(安装→付费) | 1.5% | 3% | 5% |
|
|
198
|
+
| 付费席位 | 3 家 × 12 人 | 8 家 × 18 人 | 20 家 × 25 人 |
|
|
199
|
+
| 团队版 ARR | ¥6,480 | ¥43,200 | ¥150,000 |
|
|
200
|
+
| 企业版客户 | 0 | 1 家 ¥5 万 | 3 家 ¥15 万 |
|
|
201
|
+
| 知识付费收入 | ¥3,000 | ¥15,000 | ¥40,000 |
|
|
202
|
+
| **合计年收入** | **≈ ¥9,500** | **≈ ¥11 万** | **≈ ¥34 万** |
|
|
203
|
+
|
|
204
|
+
**这个模型的意义不是收入预测,而是验证路径**:第一年收入不构成商业模式证明,
|
|
205
|
+
真正的信号是"付费转化率"和"企业客户数"。如果 12 个月后付费 < 3 家,问题在价值主张而不在功能。
|
|
206
|
+
|
|
207
|
+
---
|
|
208
|
+
|
|
209
|
+
## 9. 风险与边界
|
|
210
|
+
|
|
211
|
+
| 风险 | 应对 |
|
|
212
|
+
|---|---|
|
|
213
|
+
| **做成计费系统** | 死守边界:不承诺"这是你该付的钱",只做归因与对账 |
|
|
214
|
+
| **采集合规** | 开源版默认全关(面板/流水/落盘三个开关);只记体积不记内容;绝对路径不入账 |
|
|
215
|
+
| **第三方工具本地数据** | 需用户显式授权 + 本地脱敏;企业版提供"仅账单模式"(不装本地采集) |
|
|
216
|
+
| **订阅摊销口径争议** | 提供两套视图(边际 / 总拥有)并明示口径,绝不裸加总 |
|
|
217
|
+
| **宿主契约变化** | 三项契约已核实并写入 `docs/spikes.md`;SKIP≠通过的门禁防止假绿 |
|
|
218
|
+
| **单点依赖 DSH** | 协议已为多来源设计(measures + source 字段),第二个 adapter 是映射表工作量 |
|
|
219
|
+
| **开源被白嫖** | 接受。开源版就是引流层,付费层是治理能力,不靠加锁 |
|
|
220
|
+
|
|
221
|
+
---
|
|
222
|
+
|
|
223
|
+
## 10. 需要 owner 拍板的四件事
|
|
224
|
+
|
|
225
|
+
1. **仓库可见性**:现在是私有,开源引流需要转公开(Gitee 后台一键)。
|
|
226
|
+
2. **npm registry**:`private: true` 何时去掉、发到 npmjs 还是 Gitee Package。
|
|
227
|
+
3. **定价数字**:¥180/人/年 是否接受,企业版区间上限。
|
|
228
|
+
4. **团队版是否现在动工**:本人建议先看 M2 的验证门槛(5 个持续用户),再决定是否投 M3。
|
|
229
|
+
|
|
230
|
+
---
|
|
231
|
+
|
|
232
|
+
## 附:不做的事(同样重要)
|
|
233
|
+
|
|
234
|
+
- 不做 prompt 内容存储与分析(隐私红线)
|
|
235
|
+
- 不做模型效果评估(那是 LangSmith 的领域)
|
|
236
|
+
- 不做发票与税务口径
|
|
237
|
+
- 不做"AI 省了多少钱"的营销数字(只报能严格算的缓存节省)
|
package/docs/spikes.md
ADDED
|
@@ -0,0 +1,373 @@
|
|
|
1
|
+
# M0 源码探针报告(三条关键假设的实证结论)
|
|
2
|
+
|
|
3
|
+
版本:0.1.0 · 探针对象:`@deepseek-ai/dsh-*` 0.1.7-rc.2(node_modules 实装)
|
|
4
|
+
|
|
5
|
+
结论先行:**P-1 通过,P-2 不可行需降级,P-3 原设计不成立需改架构。**
|
|
6
|
+
这三条决定了插件的整个骨架,不是细节。
|
|
7
|
+
|
|
8
|
+
---
|
|
9
|
+
|
|
10
|
+
## P-1 会话可见性:通过
|
|
11
|
+
|
|
12
|
+
`@deepseek-ai/dsh-session` 的 `session/event` 事件声明:
|
|
13
|
+
|
|
14
|
+
> Post-commit, fire-and-forget append feed.
|
|
15
|
+
|
|
16
|
+
> Scope-filtered dispatch: agent-scoped listeners receive only events from sessions
|
|
17
|
+
> entered through that agent's context.
|
|
18
|
+
|
|
19
|
+
推论:
|
|
20
|
+
|
|
21
|
+
1. 在**根 ctx** 上 `ctx.on('session/event', ...)` 可收到全部会话事件;
|
|
22
|
+
只有把监听器挂在某个 agent 的 scope 内才会被过滤。
|
|
23
|
+
→ 账本插件必须挂在根 ctx,不能挂在 agent 内。
|
|
24
|
+
2. 监听器抛错会被"logged and contained",不会让已提交的 append 失败。
|
|
25
|
+
→ 我们仍然自己 try/catch 并计数(不想在日志里刷 stack),
|
|
26
|
+
但这条保证了旁路观测**不进入关键路径**。
|
|
27
|
+
3. `session/created` / `session/disposed` / `session/event` 三件套齐全,
|
|
28
|
+
→ 会话生命周期与淘汰可对齐(`session/disposed` 时 `store.drop()`)。
|
|
29
|
+
|
|
30
|
+
**代价**:post-commit 意味着事件已经落盘,账本是**事后账**,不是拦截点。
|
|
31
|
+
任何"阻止本次调用"的诉求都做不到,只能做下一次调用的决策(见 P-3)。
|
|
32
|
+
|
|
33
|
+
---
|
|
34
|
+
|
|
35
|
+
## P-2 工具级归因:不可行,必须降级
|
|
36
|
+
|
|
37
|
+
三条独立证据:
|
|
38
|
+
|
|
39
|
+
1. `tool/call` 事件载荷只有 `{ turn, step, callId, name, arguments }`,
|
|
40
|
+
**没有任何插件身份字段**。
|
|
41
|
+
2. `tools/change` 是 "UNFILTERED registry-subject notification",但**无 payload**——
|
|
42
|
+
只能知道"工具表变了",不知道是谁注册了谁。
|
|
43
|
+
3. `ctx.tools.register(definition)` 只返回 disposer,签名不携带来源;
|
|
44
|
+
来源只存在于调用方的 ctx scope,外部插件无法从公开 API 反查。
|
|
45
|
+
|
|
46
|
+
**为什么不 wrap `register`**:那是猴子补丁。会在多插件并发注册时产生顺序依赖,
|
|
47
|
+
且破坏 cordis 的 disposer 语义,是典型的"能跑但不能维护"。否决。
|
|
48
|
+
|
|
49
|
+
**降级方案(已实现于 `lib/attribution.js`)**:
|
|
50
|
+
|
|
51
|
+
| 粒度 | 依据 | 置信度 |
|
|
52
|
+
|---|---|---|
|
|
53
|
+
| 工具级 exact | 配置 `attribution.toolOwners[toolName]` 显式声明 | exact |
|
|
54
|
+
| 模型级 exact | 上一轮只被单一已知所有者的工具驱动 | exact |
|
|
55
|
+
| 模型级 shared | 上一轮由多个已声明插件共同驱动 | 共享成本,不排序、不拆百分比 |
|
|
56
|
+
| 未归因 | 工具名未声明 | `unresolvedReason: 'no-origin'` |
|
|
57
|
+
|
|
58
|
+
关键设计:**模型调用的成本归因到 `step - 1` 的工具集**。
|
|
59
|
+
因果方向是"工具结果 → 下一步模型请求",不是同一步。同一步的归因是错的。
|
|
60
|
+
|
|
61
|
+
另外:`compaction/*` 单列 `system:compaction`,不计入任何业务插件的成本。
|
|
62
|
+
压缩成本是系统开销,混进业务会让"哪个插件最贵"失去意义。
|
|
63
|
+
|
|
64
|
+
---
|
|
65
|
+
|
|
66
|
+
## P-3 预算事实注入:原设计错误,架构必须改
|
|
67
|
+
|
|
68
|
+
原设计(技术方案文档):
|
|
69
|
+
|
|
70
|
+
> 在 `agent/request` waterfall 中把 `budget_pressure` 附加到请求参数,
|
|
71
|
+
> 随请求进入模型上下文。
|
|
72
|
+
|
|
73
|
+
源码事实:
|
|
74
|
+
|
|
75
|
+
```ts
|
|
76
|
+
// dsh-agent/runtime-types.d.ts
|
|
77
|
+
'agent/request': (payload: { agent, turn, step, signal },
|
|
78
|
+
next: () => Promise<LlmCallConfig>) => Promise<LlmCallConfig>
|
|
79
|
+
// @mode waterfall
|
|
80
|
+
```
|
|
81
|
+
|
|
82
|
+
注释明确写着:
|
|
83
|
+
|
|
84
|
+
> this waterfall cannot mutate messages.
|
|
85
|
+
> Model-visible content must use logged channels.
|
|
86
|
+
|
|
87
|
+
而 `LlmCallConfig` 只有:
|
|
88
|
+
|
|
89
|
+
```ts
|
|
90
|
+
interface LlmCallConfig {
|
|
91
|
+
provider: string
|
|
92
|
+
model: string
|
|
93
|
+
reasoningEffort?: ReasoningEffortId
|
|
94
|
+
temperature?: number
|
|
95
|
+
maxTokens?: number
|
|
96
|
+
stop?: string[]
|
|
97
|
+
}
|
|
98
|
+
```
|
|
99
|
+
|
|
100
|
+
→ **返回值里没有任何"上下文/消息"槽位**,改不了模型能看到什么。
|
|
101
|
+
原设计在架构上不成立,不是实现难度问题。
|
|
102
|
+
|
|
103
|
+
### 拆分后的双通道
|
|
104
|
+
|
|
105
|
+
| 通道 | 载体 | 能力 | 默认 |
|
|
106
|
+
|---|---|---|---|
|
|
107
|
+
| A 事实(推送) | `agent.inject(message)` + 宿主提供的 `messageFactory` | 让模型读到"预算已用 92%" | 关闭 |
|
|
108
|
+
| B 决策(降级) | `agent/request` 返回替换的 `LlmCallConfig` | 换 provider/model/maxTokens | 关闭 |
|
|
109
|
+
| C 拉取 | `ledger_query` 工具 + `ctx.ledger.snapshot()` | Agent 主动查账 | **开启** |
|
|
110
|
+
|
|
111
|
+
通道 A 的依赖倒置:插件**不猜** `UserMessage` 结构。
|
|
112
|
+
已核实 `UserMessage extends MessageBase { role: 'user' }`,但 `MessageBase` 的
|
|
113
|
+
id/content 组织与 `MessageSource.kind` 词表未逐一确认,因此由宿主注入工厂函数;
|
|
114
|
+
没提供工厂时 A 通道静默不可用,退化为 C 通道。宁可少一个能力,不伪造契约。
|
|
115
|
+
|
|
116
|
+
通道 B 是**真·原生能力**,代价明确:降级会改变输出质量,所以默认关闭,
|
|
117
|
+
且只允许用户显式配置 `budget.downgrade`。
|
|
118
|
+
|
|
119
|
+
---
|
|
120
|
+
|
|
121
|
+
## P-4(附带纠正)TokenUsage 语义
|
|
122
|
+
|
|
123
|
+
```ts
|
|
124
|
+
interface TokenUsage {
|
|
125
|
+
inputTokens: number // 仅未缓存输入
|
|
126
|
+
outputTokens: number
|
|
127
|
+
totalTokens?: number
|
|
128
|
+
cacheReadTokens?: number
|
|
129
|
+
cacheWriteTokens?: number
|
|
130
|
+
reasoningTokens?: number
|
|
131
|
+
}
|
|
132
|
+
```
|
|
133
|
+
|
|
134
|
+
源码注释:
|
|
135
|
+
|
|
136
|
+
> Counts are DISJOINT: inputTokens is uncached input only;
|
|
137
|
+
> cached input is reported separately.
|
|
138
|
+
|
|
139
|
+
后果(已修正计价):
|
|
140
|
+
|
|
141
|
+
1. 原文档的单一 `cachedTokens` 字段是错的,缓存读/写必须分开。
|
|
142
|
+
2. 计费输入 = `inputTokens + cacheReadTokens + cacheWriteTokens`。
|
|
143
|
+
3. 统一价乘总量会系统性偏高,缓存命中率越高偏得越多
|
|
144
|
+
→ 必须是"未缓存输入/缓存读/缓存写/输出"四档单价。
|
|
145
|
+
4. `reasoningTokens` 已计入 `outputTokens`(适配器口径),**不重复计价**。
|
|
146
|
+
5. `totalTokens` 缺失时保持 `null`,不用加法冒充上游事实。
|
|
147
|
+
|
|
148
|
+
---
|
|
149
|
+
|
|
150
|
+
## C4 兼容性:首版不写回会话日志
|
|
151
|
+
|
|
152
|
+
`KNOWN_SESSION_EVENT_TYPES` 是生成的固定集合,持久化读取路径遇到集合外事件
|
|
153
|
+
会拒绝解析,除非事件带 `ignorable` 标记。
|
|
154
|
+
|
|
155
|
+
→ M0–M4 账本只存在于内存 + 只读快照,**不写自定义 session 事件**。
|
|
156
|
+
若后续要与会话日志同生命周期,必须走 `ignorable` 标记并回归读取路径,
|
|
157
|
+
这是独立的一笔工作(计划里 R4)。
|
|
158
|
+
|
|
159
|
+
---
|
|
160
|
+
|
|
161
|
+
## M1 复核:四处曾经的"防御式猜测"已落定
|
|
162
|
+
|
|
163
|
+
M0 阶段代码里有 4 处用可能为空的取值兜底,属于"没核实前先不崩"。M1 全部核实:
|
|
164
|
+
|
|
165
|
+
| 契约 | 结论 | 依据 | 对代码的影响 |
|
|
166
|
+
|---|---|---|---|
|
|
167
|
+
| 消息构造 | `MessageBase = { id, content: ContentBlock[], source }`,user 的 `source` 就是 `{ kind: 'user' }`;`createUserMessage({content, source})` 返回带稳定 id 的冻结消息 | `dsh-llm/lib/types/message.d.ts` L101–133、L213 | 通道 A **不再依赖宿主提供 messageFactory**,插件自己就能构造合法 `UserMessage`;只剩"运行时没装 dsh-llm"这一种降级 |
|
|
168
|
+
| 工具返回值 | `ToolOutputDefinition.schema` 是"对每次成功返回值强校验的 JSON Schema" | `dsh-tools/lib/types/index.d.ts` L106–113 | 返回字符串 + `{type:'string'}` 是自洽的,不是偷懒 |
|
|
169
|
+
| 工具参数 | `ToolSchema.parameters` 是 "JSON Schema object for the arguments" | `dsh-llm/lib/types/types.d.ts` | 直接写 JSON Schema 正确;仓库里 `defineTool({query:{type,required}})` 的 map 写法只是别的包自己的封装,不是运行时要求 |
|
|
170
|
+
| 服务暴露 | 仓库既有插件统一 `ctx.provide(name, api)`(`lingzhi-core` L119/L123、`lingzhi-workbench` L8641);`ctx.set` 不存在 | 源码 grep | 已改为 `ctx.provide('ledger', api)`,去掉 try/catch 兜底 |
|
|
171
|
+
| 事件载荷 | `assistant/message = { turn, step, message, stream, usage? }`,**usage 在事件顶层** | `dsh-session/.../types.d.ts` L330–338 | `event.usage ?? event.message?.usage` 保留(`attempt` 事件无 usage),但主路径就是顶层 |
|
|
172
|
+
| agent 事件 | `agent/created = { agent, source, signal? }`;`agent/disposed = { agent }`;`session/disposed` 直接给 `session` | `dsh-agent/runtime-types.d.ts` L227–242、`dsh-session/index.d.ts` L42–52 | 订阅签名正确,无隐式包装 |
|
|
173
|
+
| 卸载语义 | `ctx.on` 返回 disposer;`session/disposed` 时 `store.drop(id)` | 同上 | 会话消失即释放账本,内存不跨会话累积(已加测试锁住) |
|
|
174
|
+
|
|
175
|
+
顺带修掉一处架构级坏味道:M0 里用 `store.recordEntry = wrapped` 给 store 挂预算副作用,
|
|
176
|
+
属于替换他人方法的 monkey patch,多实例/多插件时会互相踩。
|
|
177
|
+
现在改为 `createLedger({ onEntry })` 显式钩子,store 只负责存,guard 只负责判。
|
|
178
|
+
|
|
179
|
+
---
|
|
180
|
+
|
|
181
|
+
## 对性能的实测口径
|
|
182
|
+
|
|
183
|
+
|
|
184
|
+
事件热路径单条成本:一次 `RingBuffer.push`(O(1))+ 若干标量累加,
|
|
185
|
+
无 JSON 序列化、无 async、无定时器、无数组 shift。
|
|
186
|
+
|
|
187
|
+
`scripts/bench.mjs`(`node --expose-gc scripts/bench.mjs`,本机 v22.23.4):
|
|
188
|
+
|
|
189
|
+
| 场景 | 单事件成本 | 备注 |
|
|
190
|
+
|---|---|---|
|
|
191
|
+
| 4 会话稳定态 | 1.21 µs | 正常形态 |
|
|
192
|
+
| 64 会话稳定态 | 1.12 µs | 与 4 会话同量级 → 不随会话数增长 |
|
|
193
|
+
| 每条事件都是新会话(LRU 抖动) | 3.81 µs | 最坏情况,主要花在桶创建与淘汰 |
|
|
194
|
+
| 300k 事件后 heapUsed | 3.2 MB | 固定容量,不随事件数增长 |
|
|
195
|
+
|
|
196
|
+
结论:稳定态在微秒级,插件对 Agent 循环的影响是噪声量级;
|
|
197
|
+
真正会放大成本的是"会话高频换入换出"(3.8 µs),这不是常态。
|
|
198
|
+
|
|
199
|
+
29 个单测(含 6 会话 × 多事件)整体耗时 167ms,平均单测 < 6ms。
|
|
200
|
+
这不是基准测试,只是确认"没有隐藏的 O(n) 操作"。
|
|
201
|
+
|
|
202
|
+
---
|
|
203
|
+
|
|
204
|
+
## M2 冒烟(真实运行时,不是替身)
|
|
205
|
+
|
|
206
|
+
`scripts/smoke-dsh.mjs` 直接加载 `/home/user/lingzhi/node_modules/@deepseek-ai/dsh-llm`,
|
|
207
|
+
用真实 `createUserMessage` 构造一条预算事实消息,结果:
|
|
208
|
+
|
|
209
|
+
- `CLM-1` 导出存在;
|
|
210
|
+
- `CLM-2..6` 产出 `{ id: <uuid>, role: 'user', source: { kind: 'user' }, content: [{ type: 'text', text }] }`;
|
|
211
|
+
- `CLM-7` 返回对象**已冻结**(`Object.isFrozen === true`)。
|
|
212
|
+
|
|
213
|
+
意义:通道 A 不需要宿主配合构造消息,插件自己就能产出可交给 `agent.inject` 的合法对象。
|
|
214
|
+
剩下未验证的只有两件:真实进程里 `session/event` 是否真的派发到根 ctx 监听器,
|
|
215
|
+
以及 `ctx.tools.register` 的 registry 是否接受本工具的 `output.schema`(需要真机 boot,M2 尾)。
|
|
216
|
+
|
|
217
|
+
### M2 追加:工具定义与挂载形态
|
|
218
|
+
|
|
219
|
+
用真实 `@deepseek-ai/dsh-tools`(0.1.7-rc.2,`.pnpm` 实装)的三个校验器验证:
|
|
220
|
+
|
|
221
|
+
| 检查 | 结果 |
|
|
222
|
+
|---|---|
|
|
223
|
+
| `assertSupportedJsonSchema({type:'string'})` | PASS,`output.schema` 在受支持子集内 |
|
|
224
|
+
| `assertObjectJsonSchema(parameters)` | PASS,required 为 `['sessionId']` |
|
|
225
|
+
| `validateJsonSchemaValue(output.schema, 实际返回值)` | PASS,execute 返回值确实符合自己声明的 schema |
|
|
226
|
+
| `render()` 产出 | PASS,合法 `ContentBlock` |
|
|
227
|
+
|
|
228
|
+
挂载形态(实测 `dsh --dump-config`):
|
|
229
|
+
`--patch` overlay 里写绝对路径,loader 会规范化成 `file:///home/user/dsh-plugin-ledger/lib/index.js`
|
|
230
|
+
后装配进 profile 树。**开发期不需要 install 到 profile 的 node_modules。**
|
|
231
|
+
|
|
232
|
+
**仍未验证(需真机 boot,不冒充已完成)**:
|
|
233
|
+
1. `ctx.tools.register(def)` 本身——`ToolRuntime` 在裸 cordis Context 里起不来(依赖 scope/logger 服务);
|
|
234
|
+
2. 真实进程里 `session/event` 是否派发到根 ctx 监听器(`ctx.on('session/event')` 无 scope 过滤的假设);
|
|
235
|
+
3. `ctx.provide('ledger')` 在真实 profile 里是否与其他插件命名冲突。
|
|
236
|
+
|
|
237
|
+
这三条只能靠 `dsh headless` 或 `dsh web` 起真进程验证,且要用真实模型凭据跑一轮对话。
|
|
238
|
+
|
|
239
|
+
|
|
240
|
+
---
|
|
241
|
+
|
|
242
|
+
## C-1 客户端右栏联动契约(2026-11-19 核实)
|
|
243
|
+
|
|
244
|
+
读 `@deepseek-ai/dsh-client-ui-sidebar-right@0.1.7-rc.2` 的类型定义得到:
|
|
245
|
+
|
|
246
|
+
**两条导航通道**
|
|
247
|
+
- `ctx.sidebarRight.openTab(kind, { params })` —— params 由 `SidebarRightTabParamsMap`
|
|
248
|
+
声明合并扩展;无 seat 时显式失败,需先看 `ctx.sidebarRight.mounted`。
|
|
249
|
+
- `ctx.sidebarRight.openResource('dsh-resource://<type>/…')` —— 按地址竞标,
|
|
250
|
+
`dsh-resource` 是唯一资源 scheme,`sidebar://…` 只是导航地址。
|
|
251
|
+
|
|
252
|
+
**类型定义字段**:`id`(包名,唯一,同时是 body/title seat 的 key)、`kind`、
|
|
253
|
+
`multiple?`、`keepMounted?`、`patterns?`、`priority?`(默认 `extension`)、
|
|
254
|
+
`canOpen?`、`title(address)=>string`、`guide?: SidebarRightGuideEntry[]`。
|
|
255
|
+
引导页 entry:`id` / `order` / `title()` / `description?()` / `icon?` / `commandId?`。
|
|
256
|
+
|
|
257
|
+
**内置五类**:`files`(目录树,不渲染文件)、`text`(认领
|
|
258
|
+
`dsh-resource://file/session/<sid>/<path>`,`fallback` 档)、`terminal`、`browser`
|
|
259
|
+
(`params:{url}`,http/https 白名单)、`guide`(空白右栏自己的引导页)。
|
|
260
|
+
|
|
261
|
+
**联动判定**
|
|
262
|
+
- 对话/工具行 → 账本:可(`dsh-client-ui-chat` 已在用 `openTab`/`openResource`)。
|
|
263
|
+
- 空白右栏 guide → 账本:可(往 `definition.guide` 投 entry,无需改宿主)。
|
|
264
|
+
- 账本 → 文件:**默认不可**。entry 里没有文件路径,`tool/call` 载荷也不含;
|
|
265
|
+
只有开 `trace.enabled` 并从工具参数里抽路径才有地址可用。
|
|
266
|
+
- 账本 → 浏览器/终端:同上,依赖 trace 里抓到 url/path 才有意义。
|
|
267
|
+
- 文件/终端/浏览器 → 账本:不会发生(它们没有成本概念)。
|
|
268
|
+
|
|
269
|
+
**未核实**:`@deepseek-ai/dsh-client-ui-slots` 不在本机
|
|
270
|
+
(`node_modules/.pnpm` 下只有无关的 `cluster-key-slot`),`sidebar.right.pane.tab`
|
|
271
|
+
的正文注册签名无法确认,因此 `lib/client.js` 只做身份登记,body 留 TODO。
|
|
272
|
+
|
|
273
|
+
**性能约束**:`keepMounted` + 定时刷新会叠加(多会话常驻时同时打点),
|
|
274
|
+
面板必须在 tab 非 active 时停掉刷新。
|
|
275
|
+
|
|
276
|
+
|
|
277
|
+
## C-2 正文与标题 seat 的真实形态(2026-11-19 核实)
|
|
278
|
+
|
|
279
|
+
从 npm 取到 `@deepseek-ai/dsh-client-ui-slots@0.0.1-rc.1` 并读 sidebar-right 的编译产物,
|
|
280
|
+
确认注册形态如下(照抄,不要自创):
|
|
281
|
+
|
|
282
|
+
```js
|
|
283
|
+
ctx.slots.inject('sidebar.right.pane.tab', () =>
|
|
284
|
+
ctx.slots.register({ name: 'sidebar.right.pane.tab', key: '<type.id>' }, Component))
|
|
285
|
+
```
|
|
286
|
+
|
|
287
|
+
- keyed seat 必须带 `key`,值等于 tab 类型的 `id`(本包为 `@lingda-ai/ledger`)。
|
|
288
|
+
- `inject(seat, factory)` 是"声明就绪后再注册"的入口:seat 由 sidebar-right 声明,
|
|
289
|
+
直接 `register` 有未声明风险。
|
|
290
|
+
- 标题 seat `sidebar.right.pane.tab.title` 同形态,组件返回 chip 文本。
|
|
291
|
+
- 组件 props 走 `ComposedProps`:session slot 带 `sessionId`;`TabHookContext`
|
|
292
|
+
(`active` / `signal` / `useTabNavigation` 等)是 inject 上下文,不是 props。
|
|
293
|
+
- React 由宿主模块表提供(sidebar-right 里是 `require("react")`);
|
|
294
|
+
客户端插件用动态 `import('react')`,取不到就退回"只登记类型"的降级态。
|
|
295
|
+
|
|
296
|
+
**尚未接通**:面板取数。数据在 Host 的 `ctx.ledger` 上,浏览器进程拿不到,
|
|
297
|
+
需要 Typert remote(`ctx.remote.$mount` + 生成产物),属 M2。
|
|
298
|
+
接入点已收敛到 `lib/client.js` 的 `createFetchView()` 一处:
|
|
299
|
+
返回 `{ totals, sources, generatedAt }`,前端只格式化,不聚合、不补零。
|
|
300
|
+
|
|
301
|
+
|
|
302
|
+
## C-3 面板数据通道:为什么用工作区文件而不是自定义 Remote(2026-11-19)
|
|
303
|
+
|
|
304
|
+
三条候选,逐条探过:
|
|
305
|
+
|
|
306
|
+
1. **自定义 Typert remote**
|
|
307
|
+
`ctx.typert.register(contribution)` 确实可以运行时注册(`dsh-typert-registry` README:
|
|
308
|
+
"其他所有者直接调用 `ctx.typert.register(contribution)`")。但 contribution 需要
|
|
309
|
+
`{ package, face, schemas, model, invocations }`,其中 `model` 是**生成产物**结构、
|
|
310
|
+
`schemas` 是 zod 工厂;正常路径是 tsdown 生成(`dsh-typert-loader`)。
|
|
311
|
+
对纯 JS 独立仓库=引入整套 TS 构建链。**结论:不划算,暂缓。**
|
|
312
|
+
|
|
313
|
+
2. **`ctx.provide('ledger')` 直连**
|
|
314
|
+
服务暴露在 Host ctx 上,浏览器进程拿不到(两侧不共享 cordis Context)。
|
|
315
|
+
**结论:不可行。**
|
|
316
|
+
|
|
317
|
+
3. **工作区文件(采用)**
|
|
318
|
+
宿主已把工作区文件能力暴露给浏览器:
|
|
319
|
+
`ctx.remote.workspaceFiles.{read,readBytes,stat,changes,list}`(sidebar-files 的
|
|
320
|
+
编译产物里就是 `remote.workspaceFiles.list` / `.changes`)。
|
|
321
|
+
Host 只写一个只读快照 JSON,面板读回即可——**零新增协议、零构建链**。
|
|
322
|
+
已知约束:`read` 按**绝对路径**取,客户端需要先知道路径;当前约定是
|
|
323
|
+
`<cwd>/.dsh/ledger/<sessionId>.json`,后续可从 session 的 workspace 根派生。
|
|
324
|
+
|
|
325
|
+
实现:`lib/snapshot-file.js`
|
|
326
|
+
- 原子写(写 `.tmp` 再 rename,面板读不到半截 JSON);
|
|
327
|
+
- 同会话按 `panel.intervalMs` 节流,热路径只多一次 Map 比较;
|
|
328
|
+
- 超过 `panel.maxBytes` 降级为"合计 + Top 来源",面板显示明细已截断;
|
|
329
|
+
- 写盘失败吞掉并计数,绝不影响采集与预算;
|
|
330
|
+
- `panel.enabled` 默认 **false**:写盘是外部副作用,不该由观测默认产生。
|
|
331
|
+
|
|
332
|
+
**取数通道已接通(同日闭环)**:客户端不需要知道绝对路径。
|
|
333
|
+
`workspaceFiles.stat(sessionId, '<相对路径>')` 的相对路径以 **Session 的 cwd 为基准**(
|
|
334
|
+
`index.d.ts`:"The selected Session header supplies the base for relative paths"),
|
|
335
|
+
返回值带 `absolutePath`;再 `read(sessionId, absolutePath, {offset,limit})` 拿到文本即可。
|
|
336
|
+
于是链路是:相对路径 `stat` → `absolutePath` → `read` → `JSON.parse`,零配置。
|
|
337
|
+
|
|
338
|
+
配套约束:
|
|
339
|
+
- Host 落盘按**会话自己的** `session.header.cwd` 拼 `<cwd>/.dsh/ledger/`,
|
|
340
|
+
不是 `process.cwd()`(多会话/多工作区各自独立)。
|
|
341
|
+
- 落盘写**多行** JSON:`read` 按行分页,单行超长会被页宽截断。
|
|
342
|
+
- 客户端对 `bytes > 1MB`、`eof=false`、非法 JSON 一律给可读原因,不静默空转。
|
|
343
|
+
|
|
344
|
+
|
|
345
|
+
## C-4 流水落盘为什么不写在 recordTrace 里做 IO(2026-11-19)
|
|
346
|
+
|
|
347
|
+
`recordTrace` 位于 `session/event` 的 post-commit 广播链上,是性能门禁实测的那条路径
|
|
348
|
+
(`scripts/bench.mjs --gate`:稳定态 <6µs、抖动 <15µs)。同步 `appendFileSync` 会把它
|
|
349
|
+
推到毫秒级,直接把门禁打穿。
|
|
350
|
+
|
|
351
|
+
所以 `lib/trace-file.js` 的契约是:
|
|
352
|
+
|
|
353
|
+
- `append()` 只做三件事:JSON.stringify、取队列、push。**零 IO**。
|
|
354
|
+
- 合并写由 `setInterval(flush, intervalMs)` 负责,定时器 `unref()`,不为写流水拖住进程。
|
|
355
|
+
- 队列按会话分、有上限(满了丢最旧并计数),内存有界。
|
|
356
|
+
- 单文件超 `maxBytes` 就写一行 `{"truncated":true}` 再封口,后续直接丢。
|
|
357
|
+
- 任何异常吞掉并计数(`stats.errors`),绝不向广播链抛。
|
|
358
|
+
|
|
359
|
+
两层开关:`trace.enabled`(采不采)与 `trace.file.enabled`(落不落盘)分开,
|
|
360
|
+
后者默认 false —— 落盘会把对话里调用的工具名与摘要写到工作区,属于额外的暴露面。
|
|
361
|
+
|
|
362
|
+
|
|
363
|
+
## C-5 归因只认"同轮上一步"的工具集(冒烟实测确认)
|
|
364
|
+
|
|
365
|
+
`lib/ledger.js` 的模型调用归因取 `store.toolsForStep(sessionId, turn, step - 1)`:
|
|
366
|
+
同一个 `turn` 内、当前 `step` 的前一步。
|
|
367
|
+
|
|
368
|
+
冒烟脚本第一次写成"turn1 的工具 + turn2 的模型调用",来源落到了 `unattributed`——
|
|
369
|
+
这不是 bug,是口径:**跨轮的工具不继承归因**。理由是 P-2 已经证明工具没有插件身份,
|
|
370
|
+
如果把上一轮的工具带入本轮,多轮对话里所有调用都会被第一轮的插件"吃掉",比空着更错。
|
|
371
|
+
|
|
372
|
+
真机上要归因到插件,仍必须配 `attribution.toolOwners`(工具名 → 插件名),
|
|
373
|
+
并且工具的 `turn/step` 要落在模型调用前一步。
|