@shgroup/dsh-serenity-hooks 1.30.10 → 1.30.12
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/README.md +327 -24
- package/cordis.patch.yml +20 -0
- package/dsh.plugin.json +3 -3
- package/lib/{access-CdL6BAYj.js → access-dU_vG1q8.js} +5 -1
- package/lib/host/access.d.ts +7 -0
- package/lib/index.d.ts +4 -0
- package/lib/index.js +215 -8
- package/lib/{settings-section-BPk0e1du.js → settings-section-CP4uMJf_.js} +1 -1
- package/lib/{skiff-debug-TONJlpgF.js → skiff-debug-CizJBLeZ.js} +1 -1
- package/lib/web-fetch-provider.d.ts +73 -0
- package/package.json +7 -2
package/README.md
CHANGED
|
@@ -1,50 +1,353 @@
|
|
|
1
|
-
#
|
|
1
|
+
# 宁静号 ACC —— 给 DeepSeek Harness 装一个「AI 工作区」
|
|
2
2
|
|
|
3
|
-
|
|
3
|
+
> **一句话**：装上这个插件，你在电脑上给 AI 划一块自己的工作区（就是一个普通目录），
|
|
4
|
+
> AI 在里面干活时就有了**记忆、纪律、工具和边界**——中途换模型、重启电脑、第二天再来，都能接着干。
|
|
5
|
+
>
|
|
6
|
+
> 适用 [DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness)（下称 DSH）0.1.2-rc.1 及以上。
|
|
7
|
+
> 想了解背后的想法（为什么叫"认知容器"），看 [docs/cognitive-container-theory.md](https://github.com/tellmewhattodo/dsh-serenity-plugin/blob/master/docs/cognitive-container-theory.md)；本文只讲**能干什么、怎么用**。
|
|
4
8
|
|
|
5
|
-
|
|
9
|
+
**几个词先说明白**（后面都用这几个词，不再解释）：
|
|
6
10
|
|
|
7
|
-
|
|
11
|
+
| 词 | 说人话 |
|
|
12
|
+
|---|---|
|
|
13
|
+
| **工作区 / CCC** | 一个目录，里面放一个 `.serenity` 空标记文件。DSH 在别的目录里跑，插件完全不插手；一旦你进到这种目录，它自动生效 |
|
|
14
|
+
| **插件 / ACC** | 就是这个仓库（npm 包 `@shgroup/dsh-serenity-hooks`）。它给 DSH 加工具、加约束、加记忆 |
|
|
15
|
+
| **MSM** | 你写在工作区里的可执行小工具（一个脚本 + 一行注册）。AI 通过 `msm("名字", ["参数"])` 调用它们 |
|
|
16
|
+
| **SESSION.md** | 工作区里的"工作日志"。AI 把目标、决定、进度写进去，中断后再来就从这里接着干 |
|
|
17
|
+
|
|
18
|
+
---
|
|
19
|
+
|
|
20
|
+
## 1. 它到底解决什么问题
|
|
21
|
+
|
|
22
|
+
不吹概念，直接说四个每天都会遇到的麻烦：
|
|
23
|
+
|
|
24
|
+
| 麻烦 | 没有它 | 有了它 |
|
|
25
|
+
|---|---|---|
|
|
26
|
+
| **AI 干到一半忘了自己在干什么** | 上下文一满，之前的目标、决定全丢，你得重讲一遍 | 每个工作区有一本工作日志，AI 每推进一段就写进去；上下文满了就"换载体"重来，日志还在原地，接着干 |
|
|
27
|
+
| **AI 到处乱翻、乱改文件** | 它能读你整台机器的文件，包括密钥 | 工作区有围墙：墙内随便用，墙外一律拒绝；密钥文件连"读"都读不到 |
|
|
28
|
+
| **出门在外想用** | 只能坐在那台电脑前 | 自带一个带登录的网页入口（密码或手机验证码二选一），手机也能用 |
|
|
29
|
+
| **家人想用微信问点事** | 得教他们装软件、开电脑 | 扫一次码把微信接上，家人在微信里说话，AI 用你定义的人格回话 |
|
|
30
|
+
|
|
31
|
+
---
|
|
32
|
+
|
|
33
|
+
## 2. 快速开始（2 分钟）
|
|
34
|
+
|
|
35
|
+
前置：Node ≥ 20（或 bun）、DSH 0.1.2-rc.1 及以上。
|
|
8
36
|
|
|
9
37
|
```bash
|
|
38
|
+
# 1. 装插件（自动加入 DSH 的 web profile）
|
|
10
39
|
dsh plugin --profile web add @shgroup/dsh-serenity-hooks
|
|
40
|
+
|
|
41
|
+
# 2. 重启 dsh web（插件和网页端界面一起生效）
|
|
42
|
+
dsh web
|
|
43
|
+
|
|
44
|
+
# 3. 验证：进到带 .serenity 标记的目录里开一个会话
|
|
45
|
+
# · 会话开头会自动带上这个插件的身份说明和技能目录
|
|
46
|
+
# · 网页端会话标题旁出现一个状态胶囊（绿点常亮 + SAFE 滑块）
|
|
47
|
+
# · 输入 dashboard health，看到工作区三项检查全通过
|
|
48
|
+
```
|
|
49
|
+
|
|
50
|
+
卸载：`dsh plugin --profile web remove @shgroup/dsh-serenity-hooks`
|
|
51
|
+
|
|
52
|
+
从源码装（自己改代码时用）：
|
|
53
|
+
|
|
54
|
+
```bash
|
|
55
|
+
git clone https://github.com/tellmewhattodo/dsh-serenity-plugin.git
|
|
56
|
+
cd dsh-serenity-plugin
|
|
57
|
+
dsh plugin --profile web add link:$(pwd)/hooks/dsh-serenity-hooks
|
|
58
|
+
```
|
|
59
|
+
|
|
60
|
+
> ⚠️ 别用 `dsh plugin add github:...` 这种写法——那个地址指向的是仓库根目录（不是插件包本身），装上了也不会生效。用 npm 或上面的 `link:` 方式。
|
|
61
|
+
|
|
62
|
+
**安全模式**：点一下网页端胶囊里的 SAFE 滑块，`bash` 就会从 AI 的工具列表里**直接消失**（不是报错，是它根本看不到这个工具）。于是 AI 只能走你注册过、测试过的小工具通道。这个开关是给你用的——AI 看不见、也打不开。
|
|
63
|
+
|
|
64
|
+
---
|
|
65
|
+
|
|
66
|
+
## 3. 装完之后你多了什么
|
|
67
|
+
|
|
68
|
+
### 3.1 十个工具
|
|
69
|
+
|
|
70
|
+
| 工具 | 干什么 | 什么时候用 |
|
|
71
|
+
|---|---|---|
|
|
72
|
+
| `container_fs` | 在工作区里管文件：列目录、找文件、复制、移动、新建、追加、在文件管理器里打开 | 需要看/整理工作区里的文件时 |
|
|
73
|
+
| `logbook` | 工作日志的全生命周期：新建、查看、切换、关闭、归档，还有"原地重建" | 任何多步骤的活儿，第一步就是它 |
|
|
74
|
+
| `dashboard` | 仪表盘：工作区健康检查（三项）、当前时间、等待 | 进工作区先自查一下；等外部服务时用 |
|
|
75
|
+
| `container_git` | git 操作：status / commit / push / log / pull / diff | 提交和推送代码；它绝不自动强推 |
|
|
76
|
+
| `msm` | 小工具执行入口：`msm("名字", ["参数"])`；名字记不全就给候选；`inspect=true` 看用法 | 调用工作区里注册的任何小工具 |
|
|
77
|
+
| `praxis` | 按需给 AI 注入三套"做事方法"：输出自检（eap）、设计对齐（neat）、认知连续性（cce） | 要它把话说清楚 / 先对齐再动手时 |
|
|
78
|
+
| `handyman` | 杂工：派一个便宜模型的助手，循环干活直到完成；也可以一次派多个并行 | 大批量、重复性的活（比如扫描几十个技能） |
|
|
79
|
+
| `localstore` | 存密钥和配置（凭据、偏好两个命名空间） | API key、密码集中放一处，不进 git |
|
|
80
|
+
| `container_admin` | 机务舱：管理子角色、管理小工具注册表、查看全部配置 | 定义"子角色"、注册新小工具时 |
|
|
81
|
+
| `autopilot-trajectory` | 自动巡航：定时唤醒工作区、注入当前焦点，支持多个工作区各自独立 | 想让 AI 定时自己干活（见 §6.5） |
|
|
82
|
+
|
|
83
|
+
> **改过名**（旧名已彻底停用，没有兼容别名）：`cc_fs` → `container_fs` · `cc_git` → `container_git` · `session`+`session_rebuild` → `logbook` · `acc_kit` → `dashboard` · `acc_msm` → `msm`（执行）+ `container_admin`（管理）· `eap`/`neat`/`cce` → `praxis` · `skiff_admin` → `container_admin role`。老会话里看到旧名，照这张表对照即可。
|
|
84
|
+
|
|
85
|
+
### 3.2 机械约束（AI 绕不过去）
|
|
86
|
+
|
|
87
|
+
这些不是"提示词里劝它别做"，而是**机制上做不到**：
|
|
88
|
+
|
|
89
|
+
| 约束 | 你会看到的效果 | 为什么这样做 |
|
|
90
|
+
|---|---|---|
|
|
91
|
+
| **安全模式** | bash 从工具列表里消失（每一步都同步一次），就算它想调也会被兜底拦下 | 走注册过的小工具，比让 AI 自己拼 shell 命令可靠得多 |
|
|
92
|
+
| **工作区围墙** | 墙内什么都能干，墙外一律拒绝（连路径都解析不出去） | AI 不该碰工作区之外的东西 |
|
|
93
|
+
| **黑名单 / 治理文件** | 可配黑名单；`.serenity` 这类治理文件禁止 AI 写 | 防止 AI 把自己所在的"地基"改坏 |
|
|
94
|
+
| **密钥文件守卫** | `localstore.json` 对**所有**工具拒绝（包括 read/grep/glob） | 密钥值在结构上就出不来 |
|
|
95
|
+
| **对外输出守卫** | 对外面的会话（子角色 / ACP / 重建会话）如果答出敏感词，会被打回重答，并告诉它命中了哪个词、该怎么改 | 外面的人不该看到内部机制 |
|
|
96
|
+
| **轨迹提醒** | 做久了会提醒 AI"把进度写回工作日志"，并要求它回一个确认码 | 提醒是机制，不是靠自觉 |
|
|
97
|
+
|
|
98
|
+
### 3.3 对外的入口
|
|
99
|
+
|
|
100
|
+
| 入口 | 默认端口 | 给谁用 |
|
|
101
|
+
|---|---|---|
|
|
102
|
+
| DSH 主界面 | 3080 | 你自己在本机用（插件不碰这个端口） |
|
|
103
|
+
| **网页登录入口** | 3081 | 外部/手机访问完整界面：登录后反向代理到 3080，可配工作区白名单 |
|
|
104
|
+
| **微信主动发送入口** | 3082（只绑 127.0.0.1） | 工作区里的小工具用它主动给微信发消息（公网到不了，所以不需要密钥） |
|
|
105
|
+
| **子角色调试页** | 3099（只绑 127.0.0.1） | 你调试"子角色"时用，能切换工作区、看对话轨迹 |
|
|
106
|
+
| **ACP + 对外问答页** | 3100（只绑 127.0.0.1） | 程序化接入（JSON-RPC）+ 给别人用的问答页（key 认证，只返回答案，不返回内部轨迹） |
|
|
107
|
+
| **微信桥** | 无需端口（出站长轮询） | 家人在微信里直接和 AI 说话 |
|
|
108
|
+
|
|
109
|
+
> 默认只监听 127.0.0.1 的入口，要暴露到公网由你自己决定（隧道 / 反代 / 端口映射都行），插件不绑定任何特定做法。
|
|
110
|
+
|
|
111
|
+
---
|
|
112
|
+
|
|
113
|
+
## 4. 一个工作区长什么样
|
|
114
|
+
|
|
115
|
+
工作区就是一个普通目录，加一个标记文件：
|
|
116
|
+
|
|
117
|
+
```
|
|
118
|
+
my-workspace/ ← 工作区根目录（放一个 .serenity 就成）
|
|
119
|
+
├── .serenity ← 标记：这个目录是一个工作区
|
|
120
|
+
├── .opencode/
|
|
121
|
+
│ ├── serenity.json ← 工作区级配置：助手模型白名单 / 日志阈值 / 子角色
|
|
122
|
+
│ └── skills/ ← 领域技能（每个技能 = 一个领域的知识 + 可能有小工具）
|
|
123
|
+
│ ├── home-media/ ← 例如：媒体（找片源 / 做字幕 / 推送）
|
|
124
|
+
│ ├── home-wealth/ ← 例如：家庭财务
|
|
125
|
+
│ └── …（每个技能可以自带脚本）
|
|
126
|
+
├── AGENT_SESSIONS/ ← 工作日志库：每个目录一本 SESSION.md
|
|
127
|
+
│ └── 2026-09-08--S142--xxx/
|
|
128
|
+
│ └── SESSION.md ← 目标 / 决定 / 进度（永远留在这里，不会被搬走）
|
|
129
|
+
└── _tmp/ ← 运行时落盘：你粘贴的图片和文件
|
|
130
|
+
├── images_from_user/
|
|
131
|
+
└── files_from_user/
|
|
132
|
+
```
|
|
133
|
+
|
|
134
|
+
---
|
|
135
|
+
|
|
136
|
+
## 5. 能拿它做什么（12 个真实用例）
|
|
137
|
+
|
|
138
|
+
> 下面这些都在真实部署里跑着。地址、账号、路径都做了泛化。
|
|
139
|
+
|
|
140
|
+
| # | 你想干的事 | 实际怎么走 |
|
|
141
|
+
|---|---|---|
|
|
142
|
+
| 1 | **长期项目不断线** | `logbook create` 建日志 → 每推进一段写进去 → 中断后 `logbook use` 接上 → 上下文满了 `logbook rebuild` 原地重建并自动继续 |
|
|
143
|
+
| 2 | **批量同步代码** | 当前仓库 `container_git commit/push`；多个子仓库一条命令全同步（自动提交 + 推送） |
|
|
144
|
+
| 3 | **做一集字幕** | 搜片源 → 下载 → Whisper 转写 → 翻译 → 双语 SRT → 机械质检（7 项）→ 推送订阅/邮件 |
|
|
145
|
+
| 4 | **服务器巡检** | 一条命令出 CPU/内存/GPU/容器/服务报告；重启容器也在同一条白名单通道里 |
|
|
146
|
+
| 5 | **内网服务定位** | 仓库全景（分类/技术栈/关联）+ 设备端口扫描 |
|
|
147
|
+
| 6 | **家庭财务** | 结构化记录资产/负债/收支/预算，随时查询汇总；房贷利率对比这类宏观跟踪 |
|
|
148
|
+
| 7 | **家人档案** | 成员资料统一维护，工作区是唯一真相源 |
|
|
149
|
+
| 8 | **想法随手记** | 想到什么就聊，AI 访谈式问清 → 结构化归档 → 定期回顾你的思考模式 |
|
|
150
|
+
| 9 | **手机/外出使用** | 浏览器打开 `http://内网地址:3081` → 输密码或 6 位验证码 → 直接用完整界面 |
|
|
151
|
+
| 10 | **粘贴资料自动处理** | 粘图片 → 自动落盘 → 视觉模型识别（快递单/截图/图表）；粘 PDF/压缩包 → 自动落盘 → 提取文本/解压/读表格 |
|
|
152
|
+
| 11 | **微信里用 AI** | 面板扫一次码 → 家人在微信发消息（文字/语音/图片/文件）→ 路由到指定子角色 → 回复回到微信 |
|
|
153
|
+
| 12 | **定时自己干活** | 工作区配好巡航（间隔/目标会话/焦点/偏见脚本）→ 到点自动唤醒并注入焦点，全程在你眼前发生，可随时介入 |
|
|
154
|
+
|
|
155
|
+
**典型一天**：
|
|
156
|
+
|
|
157
|
+
```
|
|
158
|
+
早上 服务器巡检（一条命令）→ 一切正常
|
|
159
|
+
上午 同步昨天的代码 → 子仓库全部推送
|
|
160
|
+
午间 收到 PDF 账单 → 粘进对话 → 自动落盘 + 表格提取 → 记进财务
|
|
161
|
+
下午 做一集视频字幕（转写 → 翻译 → 双语 SRT → 质检）→ 推送订阅
|
|
162
|
+
晚间 手机登录 3081 处理运维（验证码验证）
|
|
163
|
+
全程 每段工作都落在 SESSION.md 里 → 轨迹连续，随时换人/换模型/换机器接着干
|
|
11
164
|
```
|
|
12
165
|
|
|
13
|
-
|
|
166
|
+
---
|
|
14
167
|
|
|
15
|
-
##
|
|
168
|
+
## 6. 对外入口详解
|
|
16
169
|
|
|
17
|
-
|
|
170
|
+
### 6.1 网页登录入口（3081）
|
|
18
171
|
|
|
19
|
-
|
|
172
|
+
插件自己起第二个监听器，请求流程是：
|
|
20
173
|
|
|
21
|
-
|
|
174
|
+
```
|
|
175
|
+
外部浏览器 → http://内网IP:3081
|
|
176
|
+
→ 没登录 → 极简登录页（用户名 + 密码，或 6 位动态验证码，二选一；手机端适配）
|
|
177
|
+
→ 提交 → scrypt 校验 / TOTP 校验 + CSRF 校验 + 连续失败锁定（5 次 → 15 分钟指数退避）
|
|
178
|
+
→ 通过 → 下发 HttpOnly cookie（SameSite=Strict，24 小时滑动续期）→ 302 跳转
|
|
179
|
+
→ 已登录 → 反向代理到 127.0.0.1:3080（改写过 Host/Origin，作为信任栅栏）
|
|
180
|
+
→ 工作区列表按白名单过滤 + 新建工作区做校验
|
|
181
|
+
→ WebSocket 升级也转发（101 回写 + 双向错误监听，防止连接被压垮）
|
|
182
|
+
```
|
|
183
|
+
|
|
184
|
+
### 6.2 微信桥
|
|
22
185
|
|
|
23
|
-
|
|
186
|
+
工作区级配置（`.opencode/serenity.json` 的 `weixin` 段），**凭据放在工作区的 `localstore.json`**（不落 git 明文）。
|
|
187
|
+
DSH 一个进程可以同时带多个工作区，每个工作区各自对接自己的微信。
|
|
24
188
|
|
|
25
|
-
|
|
189
|
+
- **扫码绑定**：设置面板 → 微信桥 → 选工作区 → 扫码（手机微信确认）→ 机器人 token 自动写入凭据
|
|
190
|
+
- **多账号**：每个账号独立扫码、独立移除
|
|
191
|
+
- **能收什么**：文字、语音（微信服务端自带转写，无需额外识别）、图片、文件
|
|
192
|
+
（图片和文件会从微信 CDN 下载并解密，落到 `_tmp/weixin-inbound/`，再把路径告诉 AI）
|
|
193
|
+
- **正在输入**：处理期间微信会显示"正在输入…"
|
|
194
|
+
- **回复干净**：自动剥掉思考过程，微信只看到正文
|
|
195
|
+
- **记得住**：同一个微信号对应固定会话，重启后恢复历史，不会"失忆"
|
|
196
|
+
- **路由**：微信号 → 子角色（精确匹配优先，`*` 兜底）
|
|
197
|
+
- **主动发消息**：工作区里的小工具可以主动给指定用户发消息——
|
|
198
|
+
`msm("weixin-send", ["send", "--ccc", "<工作区>", "--user", "yh", "内容"])`
|
|
199
|
+
（`--ccc` 必填，没有"默认当前工作区"这种猜测；发出的消息会自动被记录）
|
|
200
|
+
- **让 AI 自己决定怎么回**（v1.30.10）：配置 `"weixin": { "autoReplyWithLastMessage": false }`
|
|
201
|
+
后，插件不再自动把 AI 最后那段话转给用户，而是每轮告诉它"你必须自己发"，并附上一条可直接照抄的命令。
|
|
202
|
+
适合需要过程汇报、想分多条发、或者该安静就安静的角色。默认 `true`（保持原行为）。
|
|
203
|
+
- **消息记录**：配一个 `weixin.hook` 脚本，每收/发一条消息就把事件（JSON）喂给它，存哪里由你决定。
|
|
204
|
+
记录里 `source: "reply"` 表示"回复用户"，`source: "proactive"` 表示"AI 主动发起"。
|
|
205
|
+
- **排障**：`msm("weixin-doctor", ["status"|"diag"|"verify"|"guide"])`
|
|
26
206
|
|
|
27
|
-
|
|
207
|
+
### 6.3 子角色（Skiff）
|
|
208
|
+
|
|
209
|
+
你可以从一个"什么都能干"的助手身上，切出一个**能力受限的小角色**——不只是问答，也可以带操作能力：
|
|
28
210
|
|
|
29
211
|
```jsonc
|
|
30
212
|
{
|
|
31
|
-
"
|
|
32
|
-
|
|
33
|
-
|
|
34
|
-
|
|
35
|
-
|
|
36
|
-
|
|
213
|
+
"skiff": {
|
|
214
|
+
"roles": {
|
|
215
|
+
"qa": {
|
|
216
|
+
"model": "provider/model", // 这个角色单独用哪个模型
|
|
217
|
+
"msms": ["web-search", "vlm-describe"], // 它能调哪些小工具
|
|
218
|
+
"tools": ["read", "grep", "glob"], // 它能用哪些平台工具
|
|
219
|
+
"systemPromptFile": "roles/qa.md" // 它的人格与边界（也可以直接内联）
|
|
220
|
+
}
|
|
221
|
+
}
|
|
222
|
+
}
|
|
37
223
|
}
|
|
38
224
|
```
|
|
39
225
|
|
|
40
|
-
|
|
226
|
+
- 两份白名单分开配（小工具 / 平台工具），没列出来的一律隐藏
|
|
227
|
+
- 调试页（3099）可以切工作区、看轨迹；回答用 markdown 渲染，思考过程折叠
|
|
228
|
+
- `container_admin role validate` 校验配置，`apply` 才真正生效
|
|
229
|
+
|
|
230
|
+
### 6.4 对外问答页（3100）
|
|
231
|
+
|
|
232
|
+
- **key 认证**（常量时间比较 + 失败 IP 锁定 + 可轮换）+ 容器白名单（留空 = 全部开放）
|
|
233
|
+
- **只给答案**：响应里只有 answer / answer_html / sessionId——内部轨迹、工具结果、机制信息都不出去
|
|
234
|
+
- 默认只监听 127.0.0.1；要给别人用，怎么暴露（隧道/反代/端口映射）由你决定
|
|
235
|
+
|
|
236
|
+
### 6.5 自主巡航（Autopilot Trajectory）
|
|
237
|
+
|
|
238
|
+
让工作区**到点自己醒过来干活**，全程在你眼前发生（前台注入，随时可介入）：
|
|
239
|
+
|
|
240
|
+
- **什么时候醒**：工作区开关打开 + 全局开关打开（默认关，只在你想跑的机器上开）+ 目标会话存在（目录带 `--auto` 后缀）+ 到了间隔（支持小数，最密约 36 秒）+ 不在避开的高峰窗口（默认北京时间 8~18 点）+ 偏见脚本就绪
|
|
241
|
+
- **醒了先看什么**：先看你自己写的"焦点"（`topPrompt`，每轮最先注入，防跑偏），再看随机生成的"偏见内容"（你写的脚本，负责探索方向）
|
|
242
|
+
- **多个工作区各自独立**：每个工作区自己的间隔/会话/焦点/窗口，互不干扰
|
|
243
|
+
- **有审计**：每次唤醒都记一笔，面板里能看到最近几次；失败会指数退避重试
|
|
244
|
+
- 没有"每天最多唤醒几次"的限制——频率只由间隔和窗口决定
|
|
245
|
+
|
|
246
|
+
### 6.6 安全模型
|
|
247
|
+
|
|
248
|
+
| 层面 | 做了什么 |
|
|
249
|
+
|---|---|
|
|
250
|
+
| 登录 | scrypt 密码哈希 + 常量时间比较 + 256-bit token + 24 小时滑动有效期 + 审计日志 |
|
|
251
|
+
| 双因素 | TOTP（兼容 Authenticator），扫码绑定；密码和验证码二选一 |
|
|
252
|
+
| 防爆破 | 按账号锁定：连续失败 5 次 → 锁 15 分钟，且指数退避 |
|
|
253
|
+
| 防 CSRF | 登录双提交 + 配置写入校验 Origin + 服务端 token 集合（多标签页不冲突） |
|
|
254
|
+
| 凭据 | 集中放 `localstore.json`（默认禁止提交到 git）；密钥文件对工具结构性隔离 |
|
|
255
|
+
| 对外输出 | 敏感词检测 → 打回重答，并告知命中词和规避方向 |
|
|
41
256
|
|
|
42
|
-
|
|
257
|
+
---
|
|
43
258
|
|
|
44
|
-
|
|
45
|
-
|
|
46
|
-
|
|
259
|
+
## 7. 配置分四层
|
|
260
|
+
|
|
261
|
+
| 层 | 位置 | 放什么 |
|
|
262
|
+
|---|---|---|
|
|
263
|
+
| DSH 原生设置 | DSH 的 settings.yaml | 简单开关：网关 / 重建 / 会话命名、重建阈值、子角色开关与调试端口、ACP 与问答页开关、**巡航总开关（默认关）** |
|
|
264
|
+
| 插件全局文件 | `~/.dsh/serenity-hooks.json`（权限 0600） | 网关账号（scrypt + TOTP）、监听地址与端口、工作区白名单、cookie 安全开关、问答页 key |
|
|
265
|
+
| 工作区配置 | `.opencode/serenity.json` | 助手模型白名单、日志阈值、安全模式黑名单、子角色、**巡航（间隔/会话/焦点/窗口）**、**微信（账号/路由/开关）** |
|
|
266
|
+
| 工作区凭据 | `localstore.json` | 密钥与本地偏好；微信机器人 token 也在这一层 |
|
|
267
|
+
|
|
268
|
+
> 原则：**插件是全局的，工作区是具体的**——账号、开关、阈值归插件层；角色、凭据、本地偏好归工作区层。
|
|
269
|
+
|
|
270
|
+
---
|
|
271
|
+
|
|
272
|
+
## 8. 上下文快满了怎么办
|
|
273
|
+
|
|
274
|
+
AI 一次能"记住"的内容有上限。满了不用你手动开新会话：
|
|
275
|
+
|
|
276
|
+
| 机制 | 说人话 |
|
|
277
|
+
|---|---|
|
|
278
|
+
| **工作日志（SESSION.md）** | AI 的"笔记本"，永远留在原地。目标、决定、进度都写这儿 |
|
|
279
|
+
| **原地重建（logbook rebuild）** | 快满时它会提示 AI 主动重建：把这一轮对话清空，但重新注入"你是谁 + 继续 S### 的工作"——**载体换了，活儿接着干**。重建后的 token 计量也正确回落 |
|
|
280
|
+
| **进度提醒** | 做久了会按计分提醒 AI 把进度写回日志，并要求它回确认码 |
|
|
281
|
+
| **沉淀纪律** | 重建前如果产生了有价值的认知，先把它写进相关技能（而不是丢掉） |
|
|
282
|
+
|
|
283
|
+
---
|
|
284
|
+
|
|
285
|
+
## 9. 给插件开发者
|
|
286
|
+
|
|
287
|
+
```bash
|
|
288
|
+
pnpm typecheck # 类型检查（node + 浏览器端两套）
|
|
289
|
+
pnpm test # 全量测试（当前 70 个文件 / 993 个用例）
|
|
290
|
+
pnpm build # 打包（lib/index.js + client.js）
|
|
291
|
+
```
|
|
292
|
+
|
|
293
|
+
- **开发用小工具**：`scripts/dsh-develop.ts`——typecheck / test / build / status / commit / push / version / bump / deploy / restart-web / publish / pack-check / github-push 一条龙。
|
|
294
|
+
`pack-check` 会在发布前核对打包产物是否完整（曾经踩过"发到 npm 少了文件"的坑）；`scripts/dsh-crash-investigate.ts` 用来查崩溃（只读）
|
|
295
|
+
- **架构**：Cordis 原生插件，用 DSH 的正式接口注册工具和拦截点——**从不修改 DSH 本体**
|
|
296
|
+
- **代码地图**：[docs/codebase-overview-v1.22.md](https://github.com/tellmewhattodo/dsh-serenity-plugin/blob/master/docs/codebase-overview-v1.22.md)
|
|
297
|
+
- **设计决策**：见 [CHANGELOG.md](https://github.com/tellmewhattodo/dsh-serenity-plugin/blob/master/CHANGELOG.md) 和维护技能 `dsh-serenity-plugin-development`
|
|
298
|
+
- **发布**：npm `@shgroup/dsh-serenity-hooks` + GitHub 双仓库同步推送
|
|
299
|
+
|
|
300
|
+
---
|
|
301
|
+
|
|
302
|
+
## 10. 和 opencode 版是什么关系
|
|
303
|
+
|
|
304
|
+
| | opencode-serenity-plugin | dsh-serenity-plugin（本仓库） |
|
|
305
|
+
|---|---|---|
|
|
306
|
+
| 跑在 | OpenCode | DeepSeek Harness |
|
|
307
|
+
| 实现 | 独立 | **独立**（不复用源码，但遵循同一套标准） |
|
|
308
|
+
| 系统提示词 | `system.transform` | `systemPrompt.section`，平台无关的部分逐字对齐 |
|
|
309
|
+
| 工具 | msm / container_fs / logbook 等 | container_fs / logbook / dashboard / container_git / msm / praxis / handyman / localstore / container_admin / autopilot-trajectory |
|
|
310
|
+
|
|
311
|
+
**同一个工作区可以随时换运行时**：`.serenity` 标记、`.opencode/skills/`、配置、`AGENT_SESSIONS/` 的文件格式都一致；
|
|
312
|
+
差别只在平台层（工具名、注入方式），换过去以后 AI 收到的约束是一样的。
|
|
313
|
+
|
|
314
|
+
---
|
|
315
|
+
|
|
316
|
+
## 11. 常见问题
|
|
317
|
+
|
|
318
|
+
**Q：装完没反应？**
|
|
319
|
+
先确认你进的是带 `.serenity` 标记的目录。不是工作区的话，插件完全不介入。进去后输入 `dashboard health` 看三项检查。
|
|
320
|
+
|
|
321
|
+
**Q：bash 怎么不见了？**
|
|
322
|
+
安全模式开着——这是设计，不是 bug。走注册过的小工具比让 AI 自己拼命令可靠。关掉胶囊里的 SAFE 滑块就回来了。
|
|
323
|
+
|
|
324
|
+
**Q：3081 登录被锁了？**
|
|
325
|
+
连续失败 5 次锁 15 分钟（指数退避）。等锁过期，或检查账号的验证码绑定状态。
|
|
326
|
+
|
|
327
|
+
**Q：上下文快满了怎么办？**
|
|
328
|
+
先让 AI 把进度写回 SESSION.md，然后按提示调用 `logbook rebuild`。轨迹会自动接续，不用手动开新会话。
|
|
329
|
+
|
|
330
|
+
**Q：对外问答页会返回内部信息吗？**
|
|
331
|
+
不会。只返回答案本身，内部轨迹和工具结果都不出去。
|
|
332
|
+
|
|
333
|
+
**Q：微信桥里，AI 的回复是怎么发出去的？**
|
|
334
|
+
默认由插件自动把它的最后一段话转发给你。如果配了 `autoReplyWithLastMessage: false`，插件就不转了，改由 AI 自己发——所以这时候它如果没发，你就收不到消息（没有兜底，这是刻意设计）。
|
|
335
|
+
|
|
336
|
+
**Q：主动发的微信消息会被记录吗？**
|
|
337
|
+
会。和工作区里配的 `weixin.hook` 记录脚本走同一条路，事件里标 `source: "proactive"`；自动回复标 `source: "reply"`。
|
|
338
|
+
|
|
339
|
+
---
|
|
340
|
+
|
|
341
|
+
## 12. 延伸阅读
|
|
342
|
+
|
|
343
|
+
- **这套东西的想法从哪来**：[docs/cognitive-container-theory.md](https://github.com/tellmewhattodo/dsh-serenity-plugin/blob/master/docs/cognitive-container-theory.md)——认知容器是什么、认知的"发生/存储/再发生"、轨迹与载体
|
|
344
|
+
- **权威标准**：[serenity-acc-specs](https://github.com/tellmewhattodo/serenity-acc-specs)——理论根基、注入规范、不变量
|
|
345
|
+
- **改了什么**：[CHANGELOG.md](https://github.com/tellmewhattodo/dsh-serenity-plugin/blob/master/CHANGELOG.md)——每个版本做了什么、为什么这么做
|
|
346
|
+
|
|
347
|
+
---
|
|
47
348
|
|
|
48
349
|
## 许可
|
|
49
350
|
|
|
50
|
-
MIT
|
|
351
|
+
MIT（见 [LICENSE](https://github.com/tellmewhattodo/dsh-serenity-plugin/blob/master/LICENSE)）
|
|
352
|
+
|
|
353
|
+
> **版本**：v1.30.11 ｜ **前置**：DSH 0.1.2-rc.1+ / Node ≥ 20 或 bun ｜ **测试**：70 个文件 / 993 个用例
|
package/cordis.patch.yml
CHANGED
|
@@ -1,8 +1,28 @@
|
|
|
1
1
|
# dsh-serenity-hooks bundle 层（经 package.json `dsh.bundle.patch` 声明）
|
|
2
2
|
# 装入 profile（`dsh plugin --profile <name> add @shgroup/dsh-serenity-hooks`）
|
|
3
3
|
# 后由 profile-boot 组合：行 name 即包名，Loader 从 profile node_modules 解析。
|
|
4
|
+
#
|
|
5
|
+
# patch 语义（宿主 app-boot `applyEntryPatches` 实证，0.1.2-rc.1）：
|
|
6
|
+
# - `insert:` 追加条目；无 id 追加到根，有 id 追加到该 group 的 config
|
|
7
|
+
# - 无 insert 的行按 id 定向覆盖字段（`config` 为**整体替换**，非深合并）
|
|
8
|
+
# - 未命中的 patch 只告警跳过（宿主换版本时不会炸）
|
|
9
|
+
# - 各 bundle 的 patch 与本 profile 的 cordis.patch.yml 被**展平成一个列表**按序应用
|
|
10
|
+
# （本包在 bundles 末尾 → 其 patch 在所有宿主 bundle 之后生效）
|
|
4
11
|
- insert:
|
|
5
12
|
- id: serenity-hooks
|
|
6
13
|
name: '@shgroup/dsh-serenity-hooks'
|
|
7
14
|
config:
|
|
8
15
|
serenityConfigPaths: ['.dsh/serenity.json', '.opencode/serenity.json']
|
|
16
|
+
|
|
17
|
+
# ── v1.30.12（S142 用户拍板 L3）：web_fetch 在 fake-ip/TUN 网络下恒失败 ────────────
|
|
18
|
+
# 宿主内置 provider `@deepseek-ai/dsh-web-fetch-http` 用 ipaddr.js 判「公网单播」，
|
|
19
|
+
# 而本网络 DNS 走 Clash fake-ip（域名→198.18.0.0/15，实证 cdn.jsdelivr.net→198.18.1.85）
|
|
20
|
+
# → 恒抛 WEB_BLOCKED_URL，且该包 Config 无开关（只有 5 个配额字段）。
|
|
21
|
+
# 屏蔽：禁用宿主内置 provider，改由本插件注册的 provider 接管**同一 id**（`http`，
|
|
22
|
+
# HttpFetchProvider 的实例字段 LOCAL_FETCH_PROVIDER_ID）——宿主 `web` 的既有配置
|
|
23
|
+
# `fetchProvider: http` 因此无需改动（也就不会覆盖 searchProvider）。
|
|
24
|
+
# 需要恢复宿主原行为：把下面两行删除或改 `disabled: false`，并同时关掉插件配置
|
|
25
|
+
# `serenity-hooks.webFetch.enabled`（否则会 WEB_DUPLICATE_PROVIDER）。
|
|
26
|
+
- id: web-fetch-http
|
|
27
|
+
name: '@deepseek-ai/dsh-web-fetch-http'
|
|
28
|
+
disabled: true
|
package/dsh.plugin.json
CHANGED
|
@@ -1,10 +1,10 @@
|
|
|
1
1
|
{
|
|
2
2
|
"id": "dsh-serenity-hooks",
|
|
3
|
-
"version": "1.30.
|
|
3
|
+
"version": "1.30.12",
|
|
4
4
|
"main": "lib/index.js",
|
|
5
|
-
"description": "宁静号 ACC harness（Native Cordis
|
|
5
|
+
"description": "宁静号 ACC harness（Native Cordis 插件）：给 DSH 装一个「AI 工作区」——10 个工具（container_fs/logbook/dashboard/container_git/msm/praxis/handyman/localstore/container_admin/autopilot-trajectory）+ 机械约束（安全模式/工作区围墙/密钥守卫）+ 工作日志与原地重建 + 网页登录入口/微信桥/子角色/对外问答页/自主巡航。适配 DSH 0.1.2-rc.1（deepseek-ai/deepseek-harness）。",
|
|
6
6
|
"engines": {
|
|
7
|
-
"dsh": ">=0.1.
|
|
7
|
+
"dsh": ">=0.1.2-rc.1"
|
|
8
8
|
},
|
|
9
9
|
"contributes": {
|
|
10
10
|
"tools": [
|
|
@@ -45,5 +45,9 @@ function hostWebServer(ctx) {
|
|
|
45
45
|
function hostSettings(ctx) {
|
|
46
46
|
return hostInjected(ctx, "settings");
|
|
47
47
|
}
|
|
48
|
+
/** `ctx.web`（injected；v1.30.12 web_fetch provider 注册通道） */
|
|
49
|
+
function hostWeb(ctx) {
|
|
50
|
+
return hostInjected(ctx, "web");
|
|
51
|
+
}
|
|
48
52
|
//#endregion
|
|
49
|
-
export { hostSettings as a, hostSessions as i, hostInjected as n,
|
|
53
|
+
export { hostSettings as a, hostSessions as i, hostInjected as n, hostWeb as o, hostService as r, hostWebServer as s, hostAgents as t };
|
package/lib/host/access.d.ts
CHANGED
|
@@ -41,6 +41,11 @@ export interface HostWebServer {
|
|
|
41
41
|
export interface HostSettings {
|
|
42
42
|
installSection?: (...args: unknown[]) => unknown;
|
|
43
43
|
}
|
|
44
|
+
/** `ctx.web`（injected；v1.30.12：fetch provider 注册通道） */
|
|
45
|
+
export interface HostWeb {
|
|
46
|
+
registerFetchProvider?: (provider: unknown) => unknown;
|
|
47
|
+
registerSearchProvider?: (provider: unknown) => unknown;
|
|
48
|
+
}
|
|
44
49
|
/** `ctx.sessions`（injected） */
|
|
45
50
|
export declare function hostSessions(ctx: unknown): HostSessions | undefined;
|
|
46
51
|
/** `ctx.agents`（injected） */
|
|
@@ -49,5 +54,7 @@ export declare function hostAgents(ctx: unknown): HostAgents | undefined;
|
|
|
49
54
|
export declare function hostWebServer(ctx: unknown): HostWebServer | undefined;
|
|
50
55
|
/** `ctx.settings`（injected；提供 settings 面板装配通道） */
|
|
51
56
|
export declare function hostSettings(ctx: unknown): HostSettings | undefined;
|
|
57
|
+
/** `ctx.web`（injected；v1.30.12 web_fetch provider 注册通道） */
|
|
58
|
+
export declare function hostWeb(ctx: unknown): HostWeb | undefined;
|
|
52
59
|
/** 会话 cwd 列表（live 会话；形状不符时返回空数组而非抛错） */
|
|
53
60
|
export declare function hostSessionCwds(ctx: unknown): string[];
|
package/lib/index.d.ts
CHANGED
|
@@ -60,6 +60,10 @@ export interface Config {
|
|
|
60
60
|
enabled?: boolean;
|
|
61
61
|
httpPort?: number;
|
|
62
62
|
};
|
|
63
|
+
/** v1.30.12 web_fetch provider 接管（fake-ip / TUN 网络：宿主内置 provider 判「非公网」恒拒） */
|
|
64
|
+
webFetch?: {
|
|
65
|
+
enabled?: boolean;
|
|
66
|
+
};
|
|
63
67
|
}
|
|
64
68
|
export declare const Config: z<Config>;
|
|
65
69
|
export declare function apply(ctx: Context, config: Config): void;
|
package/lib/index.js
CHANGED
|
@@ -1,11 +1,11 @@
|
|
|
1
1
|
import { t as __exportAll } from "./rolldown-runtime-D7D4PA-g.js";
|
|
2
2
|
import { a as findSerenityRoot, c as matchBlacklist, d as readCccName$2, f as readHandymanConfig, i as findGitRoot, l as pathInside, m as resolveInside, n as SAFE_MODE_MARKER, o as isSafeModeOn, r as classifyPath, s as loadSerenityConfig, t as DEFAULT_SERENITY_CONFIG_PATHS, u as readBlacklist } from "./ccc-DAsSHsub.js";
|
|
3
3
|
import { a as resolveRoleSystemPrompt, i as readSkiffRoles, l as systemPromptSource, r as isSkiffSessionId, s as roleToolWhitelist } from "./skiff-role-DlrbHPLD.js";
|
|
4
|
-
import { C as newStopToken, D as writeFailedStatus, E as splitModel, O as writeProgress, S as listActiveHandymen, T as requireWhitelistedModel, _ as workspaceTrajectoryLine, a as startSkiffDebugServer, b as buildRoundPrompt, c as askSkiff, d as getSkiffAgent, f as skiffMsmGate, g as unregisterSkiffSession, h as skiffTrajectoryEnabled, k as skiffRoleFor, l as createSkiffAgent, m as skiffSessionSnapshot, n as jscSafeJsonText, o as stopSkiffDebugServer, p as skiffSessionInfo, r as renderSkiffMarkdown, s as stripThink, t as discoverCccs, u as ensureSkiffSession, v as waitAgentIdle, w as readProgress, x as handymanProgressPaths, y as HANDYMAN_GUIDE } from "./skiff-debug-
|
|
5
|
-
import { i as hostSessions, n as hostInjected, o as
|
|
4
|
+
import { C as newStopToken, D as writeFailedStatus, E as splitModel, O as writeProgress, S as listActiveHandymen, T as requireWhitelistedModel, _ as workspaceTrajectoryLine, a as startSkiffDebugServer, b as buildRoundPrompt, c as askSkiff, d as getSkiffAgent, f as skiffMsmGate, g as unregisterSkiffSession, h as skiffTrajectoryEnabled, k as skiffRoleFor, l as createSkiffAgent, m as skiffSessionSnapshot, n as jscSafeJsonText, o as stopSkiffDebugServer, p as skiffSessionInfo, r as renderSkiffMarkdown, s as stripThink, t as discoverCccs, u as ensureSkiffSession, v as waitAgentIdle, w as readProgress, x as handymanProgressPaths, y as HANDYMAN_GUIDE } from "./skiff-debug-CizJBLeZ.js";
|
|
5
|
+
import { i as hostSessions, n as hostInjected, o as hostWeb, r as hostService, s as hostWebServer, t as hostAgents } from "./access-dU_vG1q8.js";
|
|
6
6
|
import { a as readWeixinCredential, c as weixinInboundDir, d as LOCALSTORE_SCOPES, f as checkLocalstoreGitCompliance, h as runLocalStore, i as matchWeixinRoute, l as weixinSessionIdFor, m as readGitTrack, n as extractWeixinText, o as readWeixinSettings, p as localstorePath, r as hasVoiceItem, s as sanitizeFileName$1, t as extractWeixinMedia } from "./weixin-route-BD_yYAZz.js";
|
|
7
7
|
import { C as summarize, S as showSession, _ as readActiveSessionMd, a as archiveSessions, b as sessionsRoot, c as createSession, d as findSession, f as getActiveSessionInfo, g as qaCheck, h as parseSessionContextFromEvents, i as SESSION_ACTIONS, l as extractSessionMdPathFromText, m as listSessions, n as readLastBound, o as clearActiveSessionInfo, p as healthCheck, r as DEFAULT_SESSION_SCOPE, s as closeSession, t as appendBound, u as findLatestActiveSessionMd, v as resolveSessionByTitle, w as useSession, x as setActiveSessionInfo, y as sessionEvents } from "./session-bound-D2ANqVn-.js";
|
|
8
|
-
import { n as registerSettingsSection, t as readSimpleSettings } from "./settings-section-
|
|
8
|
+
import { n as registerSettingsSection, t as readSimpleSettings } from "./settings-section-CP4uMJf_.js";
|
|
9
9
|
import { a as markdownToPlainText, c as sniffImageExt, i as getUpdates, n as downloadMedia, o as sendTextMessage, r as getConfig, s as sendTyping, t as TypingStatus } from "./weixin-api-BMpljodH.js";
|
|
10
10
|
import z from "@deepseek-ai/schemastery";
|
|
11
11
|
import { defineTool } from "@deepseek-ai/dsh-tools";
|
|
@@ -21,6 +21,8 @@ import { createHmac, randomBytes, randomUUID, scryptSync, timingSafeEqual } from
|
|
|
21
21
|
import { createServer, request } from "node:http";
|
|
22
22
|
import * as zlib from "node:zlib";
|
|
23
23
|
import { deriveEventMessage } from "@deepseek-ai/dsh-session";
|
|
24
|
+
import { lookup } from "node:dns/promises";
|
|
25
|
+
import { isIP } from "node:net";
|
|
24
26
|
//#region src/fs-ops.ts
|
|
25
27
|
/**
|
|
26
28
|
* fs-ops.ts — container_fs 纯操作层（cc_fs → container_fs，v1.30；零 DSH 依赖，可独立单测）
|
|
@@ -914,6 +916,17 @@ const HOST_SERVICES = [
|
|
|
914
916
|
impact: "设置面板不安装 → 所有开关静默 no-op",
|
|
915
917
|
required: true
|
|
916
918
|
},
|
|
919
|
+
{
|
|
920
|
+
id: "web",
|
|
921
|
+
name: "web",
|
|
922
|
+
access: "injected",
|
|
923
|
+
members: [{
|
|
924
|
+
name: "registerFetchProvider",
|
|
925
|
+
kind: "function"
|
|
926
|
+
}],
|
|
927
|
+
impact: "web_fetch provider 无法注册 → fake-ip 网络下 web_fetch 不可用",
|
|
928
|
+
required: false
|
|
929
|
+
},
|
|
917
930
|
{
|
|
918
931
|
id: "systemPrompt",
|
|
919
932
|
name: "systemPrompt",
|
|
@@ -6465,7 +6478,7 @@ function registerStatusApi(ctx, opts = {}) {
|
|
|
6465
6478
|
workspace: url.searchParams.get("workspace") ?? void 0
|
|
6466
6479
|
});
|
|
6467
6480
|
const root = findSerenityRoot(workspace) ?? "";
|
|
6468
|
-
const { discoverCccs } = await import("./skiff-debug-
|
|
6481
|
+
const { discoverCccs } = await import("./skiff-debug-CizJBLeZ.js").then((n) => n.i);
|
|
6469
6482
|
sendJson$2(res, 200, { cccs: await discoverCccs(ctx, root) });
|
|
6470
6483
|
} catch (err) {
|
|
6471
6484
|
sendJson$2(res, 400, { error: err.message ?? String(err) });
|
|
@@ -6495,7 +6508,7 @@ function registerStatusApi(ctx, opts = {}) {
|
|
|
6495
6508
|
return;
|
|
6496
6509
|
}
|
|
6497
6510
|
const settings = readAdvancedSettings();
|
|
6498
|
-
const { readSimpleSettings } = await import("./settings-section-
|
|
6511
|
+
const { readSimpleSettings } = await import("./settings-section-CP4uMJf_.js").then((n) => n.r);
|
|
6499
6512
|
const simple = readSimpleSettings();
|
|
6500
6513
|
const allowed = settings.publicAsk.allowed;
|
|
6501
6514
|
const port = simple.acpHttpPort ?? 3100;
|
|
@@ -9872,7 +9885,7 @@ function matchCcc(input, candidates) {
|
|
|
9872
9885
|
}
|
|
9873
9886
|
/** 组装候选列表（discoverCccs 投影 + `.serenity` 名；动态 import 保持本模块静态依赖轻量） */
|
|
9874
9887
|
async function collectCandidates(ctx) {
|
|
9875
|
-
const { discoverCccs } = await import("./skiff-debug-
|
|
9888
|
+
const { discoverCccs } = await import("./skiff-debug-CizJBLeZ.js").then((n) => n.i);
|
|
9876
9889
|
const entries = await discoverCccs(ctx, process.cwd());
|
|
9877
9890
|
const seen = /* @__PURE__ */ new Set();
|
|
9878
9891
|
const out = [];
|
|
@@ -10145,6 +10158,197 @@ function registerLifecycle(ctx) {
|
|
|
10145
10158
|
registerDisposer(ctx, "self-started resources (skiff-debug/acp/weixin)", disposeAll);
|
|
10146
10159
|
}
|
|
10147
10160
|
//#endregion
|
|
10161
|
+
//#region src/web-fetch-provider.ts
|
|
10162
|
+
/**
|
|
10163
|
+
* web-fetch-provider.ts — fake-ip / TUN 网络下的 web_fetch provider（v1.30.12，S142）
|
|
10164
|
+
*
|
|
10165
|
+
* 问题（用户报告 + 实证）：`web_fetch` 在本机恒失败，报
|
|
10166
|
+
* `URL hostname "X" resolves to a non-public IP address`（`WEB_BLOCKED_URL`）。
|
|
10167
|
+
* 根因不是 DSH 误判，而是**本地 DNS 在说谎**：Clash/mihomo 的 fake-ip 让所有域名解析到
|
|
10168
|
+
* 198.18.0.0/15（实证 `cdn.jsdelivr.net → 198.18.1.85`），而宿主的
|
|
10169
|
+
* `@deepseek-ai/dsh-web-fetch-http` 用 `ipaddr.js` 判定 `range() === "unicast"`，
|
|
10170
|
+
* 该段属 reserved → 无条件 throw（其 Config 只有 5 个配额字段，**没有开关**）。
|
|
10171
|
+
*
|
|
10172
|
+
* 方案（用户拍板 L3）：ACC 自己注册一个 fetch provider——**复用宿主的 HttpFetchProvider**
|
|
10173
|
+
* （重定向策略/字节与字符配额/字符集解码/连接固定全部继承），只替换 `resolveAddresses`：
|
|
10174
|
+
* 「必须公网单播」→「公网单播 **或** fake-ip 段」。其余私网段（loopback / link-local /
|
|
10175
|
+
* RFC1918 / CGNAT / 云元数据 169.254.169.254 / ULA / 组播）**依旧拒绝**。
|
|
10176
|
+
*
|
|
10177
|
+
* 屏蔽（用户要求「屏蔽掉 dsh 自身注册的」）：宿主内置的 `web-fetch-http` 插件由本包的
|
|
10178
|
+
* `cordis.patch.yml`（bundle patch 层）`disabled: true` 关闭——两者都注册 id `http`
|
|
10179
|
+
* （`LOCAL_FETCH_PROVIDER_ID`，HttpFetchProvider 的实例字段），同时存在会
|
|
10180
|
+
* `WEB_DUPLICATE_PROVIDER`；禁用后由本模块的实例接管同一 id，宿主 `web` 的既有
|
|
10181
|
+
* 配置 `fetchProvider: http` 无需改动（**不改宿主的 web 配置对象**，避免覆盖 searchProvider）。
|
|
10182
|
+
*
|
|
10183
|
+
* 边界：本模块只放宽「地址可达性」一条判据；URL 校验（协议/凭据/长度）、同源重定向、
|
|
10184
|
+
* 配额、二进制拒绝全部仍由宿主实现执行。
|
|
10185
|
+
*/
|
|
10186
|
+
/**
|
|
10187
|
+
* 与宿主 `WebError` 同形的最小错误（带机器可路由的 `code`）。
|
|
10188
|
+
*
|
|
10189
|
+
* 为什么不 import 宿主的 WebError：宿主 peer 包在测试环境不可解析（现有测试全部
|
|
10190
|
+
* `vi.mock('@deepseek-ai/dsh-tools')` 同因），而 `dsh-tool-web` 只渲染 `error.message`、
|
|
10191
|
+
* 不判 `instanceof`——因此本地错误对象足以满足契约，且让本模块零运行时宿主依赖。
|
|
10192
|
+
*/
|
|
10193
|
+
function fetchError(message, code) {
|
|
10194
|
+
const error = new Error(message);
|
|
10195
|
+
error.code = code;
|
|
10196
|
+
return error;
|
|
10197
|
+
}
|
|
10198
|
+
/**
|
|
10199
|
+
* 传输与配额上限。
|
|
10200
|
+
*
|
|
10201
|
+
* 值镜像 `@deepseek-ai/dsh-web-fetch-http` 的 Config 默认值（该包 README 的字段表；
|
|
10202
|
+
* 它不导出解析后的默认值，`Config` 是 schemastery schema 而非结果）。`userAgent`
|
|
10203
|
+
* 运行时取该包导出的 `DEFAULT_USER_AGENT`（单一真相源，不复制字符串）。
|
|
10204
|
+
*/
|
|
10205
|
+
const FETCH_LIMIT_DEFAULTS = {
|
|
10206
|
+
maxResponseBytes: 5e6,
|
|
10207
|
+
maxBodyChars: 1e5,
|
|
10208
|
+
timeoutMs: 3e4,
|
|
10209
|
+
maxRedirects: 5
|
|
10210
|
+
};
|
|
10211
|
+
/** Clash/mihomo fake-ip 默认段 198.18.0.0/15（可配 fake-ip-range；改配置需同步此常量） */
|
|
10212
|
+
const FAKE_IP_OCTET_A = 198;
|
|
10213
|
+
const FAKE_IP_OCTET_B_MIN = 18;
|
|
10214
|
+
const FAKE_IP_OCTET_B_MAX = 19;
|
|
10215
|
+
/** 去掉 IPv6 字面量的方括号（`[::1]` → `::1`） */
|
|
10216
|
+
function stripBrackets(hostname) {
|
|
10217
|
+
return hostname.startsWith("[") && hostname.endsWith("]") ? hostname.slice(1, -1) : hostname;
|
|
10218
|
+
}
|
|
10219
|
+
function octets(address) {
|
|
10220
|
+
const parts = address.split(".");
|
|
10221
|
+
if (parts.length !== 4) return null;
|
|
10222
|
+
const nums = parts.map((p) => /^\d{1,3}$/.test(p) ? Number(p) : NaN);
|
|
10223
|
+
const [a, b, c, d] = nums;
|
|
10224
|
+
if (a === void 0 || b === void 0 || c === void 0 || d === void 0) return null;
|
|
10225
|
+
if (nums.some((n) => !Number.isInteger(n) || n < 0 || n > 255)) return null;
|
|
10226
|
+
return [
|
|
10227
|
+
a,
|
|
10228
|
+
b,
|
|
10229
|
+
c,
|
|
10230
|
+
d
|
|
10231
|
+
];
|
|
10232
|
+
}
|
|
10233
|
+
/** 公网单播 IPv4（拒绝全部保留/私网段——与宿主判定口径一致，只额外放行 fake-ip） */
|
|
10234
|
+
function isPublicV4(address) {
|
|
10235
|
+
const parsed = octets(address);
|
|
10236
|
+
if (parsed === null) return false;
|
|
10237
|
+
const [a, b] = parsed;
|
|
10238
|
+
if (a === 0 || a === 10 || a === 127) return false;
|
|
10239
|
+
if (a === 100 && b >= 64 && b <= 127) return false;
|
|
10240
|
+
if (a === 169 && b === 254) return false;
|
|
10241
|
+
if (a === 172 && b >= 16 && b <= 31) return false;
|
|
10242
|
+
if (a === 192 && b === 168) return false;
|
|
10243
|
+
if (a === 192 && b === 0) return false;
|
|
10244
|
+
if (a === 198 && (b === 18 || b === 19)) return false;
|
|
10245
|
+
if (a === 198 && b === 51) return false;
|
|
10246
|
+
if (a === 203 && b === 0) return false;
|
|
10247
|
+
if (a >= 224) return false;
|
|
10248
|
+
return true;
|
|
10249
|
+
}
|
|
10250
|
+
/** fake-ip 段判定（198.18.0.0/15） */
|
|
10251
|
+
function isFakeIpV4(address) {
|
|
10252
|
+
const parsed = octets(address);
|
|
10253
|
+
if (parsed === null) return false;
|
|
10254
|
+
const [a, b] = parsed;
|
|
10255
|
+
return a === FAKE_IP_OCTET_A && b >= FAKE_IP_OCTET_B_MIN && b <= FAKE_IP_OCTET_B_MAX;
|
|
10256
|
+
}
|
|
10257
|
+
/**
|
|
10258
|
+
* 公网单播 IPv6：只接受全局单播 2000::/3；IPv4-mapped（`::ffff:a.b.c.d`）按内嵌 IPv4 判定。
|
|
10259
|
+
* 其余（`::1` / `::` / ULA fc00::/7 / link-local fe80::/10 / 组播 ff00::/8 / v4-translated）一律拒绝。
|
|
10260
|
+
*/
|
|
10261
|
+
function isPublicV6(address) {
|
|
10262
|
+
const lower = address.toLowerCase();
|
|
10263
|
+
const mapped = /^::ffff:(\d{1,3}(?:\.\d{1,3}){3})$/.exec(lower);
|
|
10264
|
+
if (mapped?.[1] !== void 0) return isPublicV4(mapped[1]);
|
|
10265
|
+
const first = lower.split(":")[0] ?? "";
|
|
10266
|
+
if (first === "") return false;
|
|
10267
|
+
const value = Number.parseInt(first, 16);
|
|
10268
|
+
if (!Number.isInteger(value)) return false;
|
|
10269
|
+
return value >= 8192 && value <= 16383;
|
|
10270
|
+
}
|
|
10271
|
+
/** 该地址是否允许被抓取：公网单播 **或** fake-ip 段 */
|
|
10272
|
+
function isAllowedFetchAddress(address) {
|
|
10273
|
+
const bare = stripBrackets(address);
|
|
10274
|
+
const family = isIP(bare);
|
|
10275
|
+
if (family === 4) return isPublicV4(bare) || isFakeIpV4(bare);
|
|
10276
|
+
if (family === 6) return isPublicV6(bare);
|
|
10277
|
+
return false;
|
|
10278
|
+
}
|
|
10279
|
+
/**
|
|
10280
|
+
* 解析并校验地址集合（宿主 `HttpFetchResolver` 契约）。
|
|
10281
|
+
*
|
|
10282
|
+
* 语义与宿主 `resolvePublicAddresses` 一致——**任一地址不合法即整体拒绝**（防 DNS 重绑定），
|
|
10283
|
+
* 仅判据从「公网单播」放宽为 `isAllowedFetchAddress`。
|
|
10284
|
+
*/
|
|
10285
|
+
const resolveAllowedAddresses = async (hostname, signal) => {
|
|
10286
|
+
const bare = stripBrackets(hostname);
|
|
10287
|
+
const literalFamily = isIP(bare);
|
|
10288
|
+
let resolved;
|
|
10289
|
+
if (literalFamily === 0) resolved = await lookupAll(bare, signal);
|
|
10290
|
+
else resolved = [{
|
|
10291
|
+
address: bare,
|
|
10292
|
+
family: literalFamily
|
|
10293
|
+
}];
|
|
10294
|
+
if (resolved.length === 0) throw fetchError(`hostname "${hostname}" resolved to no addresses`, "WEB_PROVIDER_ERROR");
|
|
10295
|
+
const addresses = [];
|
|
10296
|
+
for (const entry of resolved) {
|
|
10297
|
+
if (entry.family !== 4 && entry.family !== 6) throw fetchError(`hostname "${hostname}" resolved to an invalid IP address`, "WEB_PROVIDER_ERROR");
|
|
10298
|
+
if (isIP(entry.address) !== entry.family) throw fetchError(`hostname "${hostname}" resolved to an invalid IP address`, "WEB_PROVIDER_ERROR");
|
|
10299
|
+
if (!isAllowedFetchAddress(entry.address)) throw fetchError(`URL hostname "${hostname}" resolves to a non-public IP address`, "WEB_BLOCKED_URL");
|
|
10300
|
+
addresses.push({
|
|
10301
|
+
address: entry.address,
|
|
10302
|
+
family: entry.family
|
|
10303
|
+
});
|
|
10304
|
+
}
|
|
10305
|
+
return addresses;
|
|
10306
|
+
};
|
|
10307
|
+
/** `dns.lookup` 的 `all` 形态 + 信号中断（宿主同款语义：OS 查询可能无谓完成） */
|
|
10308
|
+
async function lookupAll(hostname, signal) {
|
|
10309
|
+
if (signal.aborted) throw fetchError("web fetch aborted", "WEB_ABORTED");
|
|
10310
|
+
const lookupPromise = lookup(hostname, {
|
|
10311
|
+
all: true,
|
|
10312
|
+
order: "verbatim"
|
|
10313
|
+
});
|
|
10314
|
+
const aborted = new Promise((_, reject) => {
|
|
10315
|
+
signal.addEventListener("abort", () => reject(fetchError("web fetch aborted", "WEB_ABORTED")), { once: true });
|
|
10316
|
+
});
|
|
10317
|
+
try {
|
|
10318
|
+
return (await Promise.race([lookupPromise, aborted])).map((e) => ({
|
|
10319
|
+
address: e.address,
|
|
10320
|
+
family: e.family
|
|
10321
|
+
}));
|
|
10322
|
+
} finally {
|
|
10323
|
+
lookupPromise.catch(() => void 0);
|
|
10324
|
+
}
|
|
10325
|
+
}
|
|
10326
|
+
/**
|
|
10327
|
+
* 注册接管 `http` id 的 fetch provider（宿主内置 provider 由本包 bundle patch 禁用）。
|
|
10328
|
+
*
|
|
10329
|
+
* 后端包 `@deepseek-ai/dsh-web-fetch-http` 用**动态 import**：宿主版本里若没有该包，
|
|
10330
|
+
* 只降级为一条告警（绝不因缺一个可选后端而让整机启动失败——apply 抛错 = dsh 启动失败）。
|
|
10331
|
+
* 失败一律响亮但不抛错。
|
|
10332
|
+
*/
|
|
10333
|
+
async function registerWebFetchProvider(ctx) {
|
|
10334
|
+
const web = hostWeb(ctx);
|
|
10335
|
+
if (typeof web?.registerFetchProvider !== "function") {
|
|
10336
|
+
console.warn("[serenity-hooks] ✗ web fetch provider 未注册：宿主 web 服务不可用（web_fetch 退回宿主默认实现）");
|
|
10337
|
+
return;
|
|
10338
|
+
}
|
|
10339
|
+
try {
|
|
10340
|
+
const backend = await import("@deepseek-ai/dsh-web-fetch-http");
|
|
10341
|
+
const limits = {
|
|
10342
|
+
...FETCH_LIMIT_DEFAULTS,
|
|
10343
|
+
userAgent: backend.DEFAULT_USER_AGENT
|
|
10344
|
+
};
|
|
10345
|
+
web.registerFetchProvider(new backend.HttpFetchProvider(limits, resolveAllowedAddresses));
|
|
10346
|
+
console.log(`[serenity-hooks] ✓ web fetch provider 已接管（id=${backend.LOCAL_FETCH_PROVIDER_ID}，额外放行 fake-ip 段 198.18.0.0/15）`);
|
|
10347
|
+
} catch (error) {
|
|
10348
|
+
console.error(`[serenity-hooks] ✗ web fetch provider 注册失败（web_fetch 将不可用）: ${String(error?.message ?? error)}`);
|
|
10349
|
+
}
|
|
10350
|
+
}
|
|
10351
|
+
//#endregion
|
|
10148
10352
|
//#region src/index.ts
|
|
10149
10353
|
const name = "dsh-serenity-hooks";
|
|
10150
10354
|
/** 主动调用的服务；其余（agent 事件）随 harness 装配必然存在
|
|
@@ -10159,7 +10363,8 @@ const inject = [
|
|
|
10159
10363
|
"agents",
|
|
10160
10364
|
"systemPrompt",
|
|
10161
10365
|
"sessionProjections",
|
|
10162
|
-
"settings"
|
|
10366
|
+
"settings",
|
|
10367
|
+
"web"
|
|
10163
10368
|
];
|
|
10164
10369
|
const Config = z.object({
|
|
10165
10370
|
serenityConfigPaths: z.array(z.string()).default([...DEFAULT_SERENITY_CONFIG_PATHS]),
|
|
@@ -10185,7 +10390,8 @@ const Config = z.object({
|
|
|
10185
10390
|
acp: z.object({
|
|
10186
10391
|
enabled: z.boolean().default(false),
|
|
10187
10392
|
httpPort: z.number().min(1024).max(65535).default(3100)
|
|
10188
|
-
})
|
|
10393
|
+
}),
|
|
10394
|
+
webFetch: z.object({ enabled: z.boolean().default(true) })
|
|
10189
10395
|
});
|
|
10190
10396
|
function apply(ctx, config) {
|
|
10191
10397
|
try {
|
|
@@ -10232,6 +10438,7 @@ function apply(ctx, config) {
|
|
|
10232
10438
|
registerWeixinBridge(ctx);
|
|
10233
10439
|
registerWeixinSendApi(ctx);
|
|
10234
10440
|
registerLifecycle(ctx);
|
|
10441
|
+
if (config.webFetch?.enabled !== false) registerWebFetchProvider(ctx);
|
|
10235
10442
|
}
|
|
10236
10443
|
/**
|
|
10237
10444
|
* F4 Skiff 调试服务装配：启停 = 人工（设置面板 Skiff 区块开关，settings 持久化）。
|
|
@@ -1,5 +1,5 @@
|
|
|
1
1
|
import { t as __exportAll } from "./rolldown-runtime-D7D4PA-g.js";
|
|
2
|
-
import { a as hostSettings } from "./access-
|
|
2
|
+
import { a as hostSettings } from "./access-dU_vG1q8.js";
|
|
3
3
|
import z from "@deepseek-ai/schemastery";
|
|
4
4
|
//#region src/settings-section.ts
|
|
5
5
|
var settings_section_exports = /* @__PURE__ */ __exportAll({
|
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
import { t as __exportAll } from "./rolldown-runtime-D7D4PA-g.js";
|
|
2
2
|
import { a as findSerenityRoot, f as readHandymanConfig } from "./ccc-DAsSHsub.js";
|
|
3
3
|
import { a as resolveRoleSystemPrompt, i as readSkiffRoles, n as buildSkiffBasePrompt, o as roleMsmWhitelist, r as isSkiffSessionId, u as trajectorySubset } from "./skiff-role-DlrbHPLD.js";
|
|
4
|
-
import { i as hostSessions, r as hostService, t as hostAgents } from "./access-
|
|
4
|
+
import { i as hostSessions, r as hostService, t as hostAgents } from "./access-dU_vG1q8.js";
|
|
5
5
|
import { c as createSession, f as getActiveSessionInfo, n as readLastBound, t as appendBound, x as setActiveSessionInfo } from "./session-bound-D2ANqVn-.js";
|
|
6
6
|
import { existsSync, mkdirSync, readFileSync, readdirSync, writeFileSync } from "node:fs";
|
|
7
7
|
import { basename, join } from "node:path";
|
|
@@ -0,0 +1,73 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* web-fetch-provider.ts — fake-ip / TUN 网络下的 web_fetch provider（v1.30.12，S142）
|
|
3
|
+
*
|
|
4
|
+
* 问题（用户报告 + 实证）：`web_fetch` 在本机恒失败，报
|
|
5
|
+
* `URL hostname "X" resolves to a non-public IP address`（`WEB_BLOCKED_URL`）。
|
|
6
|
+
* 根因不是 DSH 误判，而是**本地 DNS 在说谎**：Clash/mihomo 的 fake-ip 让所有域名解析到
|
|
7
|
+
* 198.18.0.0/15（实证 `cdn.jsdelivr.net → 198.18.1.85`），而宿主的
|
|
8
|
+
* `@deepseek-ai/dsh-web-fetch-http` 用 `ipaddr.js` 判定 `range() === "unicast"`，
|
|
9
|
+
* 该段属 reserved → 无条件 throw（其 Config 只有 5 个配额字段，**没有开关**）。
|
|
10
|
+
*
|
|
11
|
+
* 方案（用户拍板 L3）：ACC 自己注册一个 fetch provider——**复用宿主的 HttpFetchProvider**
|
|
12
|
+
* （重定向策略/字节与字符配额/字符集解码/连接固定全部继承），只替换 `resolveAddresses`：
|
|
13
|
+
* 「必须公网单播」→「公网单播 **或** fake-ip 段」。其余私网段（loopback / link-local /
|
|
14
|
+
* RFC1918 / CGNAT / 云元数据 169.254.169.254 / ULA / 组播）**依旧拒绝**。
|
|
15
|
+
*
|
|
16
|
+
* 屏蔽（用户要求「屏蔽掉 dsh 自身注册的」）：宿主内置的 `web-fetch-http` 插件由本包的
|
|
17
|
+
* `cordis.patch.yml`（bundle patch 层）`disabled: true` 关闭——两者都注册 id `http`
|
|
18
|
+
* （`LOCAL_FETCH_PROVIDER_ID`，HttpFetchProvider 的实例字段），同时存在会
|
|
19
|
+
* `WEB_DUPLICATE_PROVIDER`；禁用后由本模块的实例接管同一 id，宿主 `web` 的既有
|
|
20
|
+
* 配置 `fetchProvider: http` 无需改动（**不改宿主的 web 配置对象**，避免覆盖 searchProvider）。
|
|
21
|
+
*
|
|
22
|
+
* 边界：本模块只放宽「地址可达性」一条判据；URL 校验（协议/凭据/长度）、同源重定向、
|
|
23
|
+
* 配额、二进制拒绝全部仍由宿主实现执行。
|
|
24
|
+
*/
|
|
25
|
+
import type { Context } from 'cordis';
|
|
26
|
+
import type { HttpFetchResolver } from '@deepseek-ai/dsh-web-fetch-http';
|
|
27
|
+
/**
|
|
28
|
+
* 与宿主 `WebError` 同形的最小错误（带机器可路由的 `code`）。
|
|
29
|
+
*
|
|
30
|
+
* 为什么不 import 宿主的 WebError：宿主 peer 包在测试环境不可解析（现有测试全部
|
|
31
|
+
* `vi.mock('@deepseek-ai/dsh-tools')` 同因），而 `dsh-tool-web` 只渲染 `error.message`、
|
|
32
|
+
* 不判 `instanceof`——因此本地错误对象足以满足契约，且让本模块零运行时宿主依赖。
|
|
33
|
+
*/
|
|
34
|
+
export declare function fetchError(message: string, code: string): Error;
|
|
35
|
+
/**
|
|
36
|
+
* 传输与配额上限。
|
|
37
|
+
*
|
|
38
|
+
* 值镜像 `@deepseek-ai/dsh-web-fetch-http` 的 Config 默认值（该包 README 的字段表；
|
|
39
|
+
* 它不导出解析后的默认值，`Config` 是 schemastery schema 而非结果）。`userAgent`
|
|
40
|
+
* 运行时取该包导出的 `DEFAULT_USER_AGENT`（单一真相源，不复制字符串）。
|
|
41
|
+
*/
|
|
42
|
+
export declare const FETCH_LIMIT_DEFAULTS: {
|
|
43
|
+
readonly maxResponseBytes: 5000000;
|
|
44
|
+
readonly maxBodyChars: 100000;
|
|
45
|
+
readonly timeoutMs: 30000;
|
|
46
|
+
readonly maxRedirects: 5;
|
|
47
|
+
};
|
|
48
|
+
/** 公网单播 IPv4（拒绝全部保留/私网段——与宿主判定口径一致，只额外放行 fake-ip） */
|
|
49
|
+
export declare function isPublicV4(address: string): boolean;
|
|
50
|
+
/** fake-ip 段判定（198.18.0.0/15） */
|
|
51
|
+
export declare function isFakeIpV4(address: string): boolean;
|
|
52
|
+
/**
|
|
53
|
+
* 公网单播 IPv6：只接受全局单播 2000::/3；IPv4-mapped（`::ffff:a.b.c.d`）按内嵌 IPv4 判定。
|
|
54
|
+
* 其余（`::1` / `::` / ULA fc00::/7 / link-local fe80::/10 / 组播 ff00::/8 / v4-translated）一律拒绝。
|
|
55
|
+
*/
|
|
56
|
+
export declare function isPublicV6(address: string): boolean;
|
|
57
|
+
/** 该地址是否允许被抓取：公网单播 **或** fake-ip 段 */
|
|
58
|
+
export declare function isAllowedFetchAddress(address: string): boolean;
|
|
59
|
+
/**
|
|
60
|
+
* 解析并校验地址集合（宿主 `HttpFetchResolver` 契约）。
|
|
61
|
+
*
|
|
62
|
+
* 语义与宿主 `resolvePublicAddresses` 一致——**任一地址不合法即整体拒绝**（防 DNS 重绑定），
|
|
63
|
+
* 仅判据从「公网单播」放宽为 `isAllowedFetchAddress`。
|
|
64
|
+
*/
|
|
65
|
+
export declare const resolveAllowedAddresses: HttpFetchResolver;
|
|
66
|
+
/**
|
|
67
|
+
* 注册接管 `http` id 的 fetch provider（宿主内置 provider 由本包 bundle patch 禁用）。
|
|
68
|
+
*
|
|
69
|
+
* 后端包 `@deepseek-ai/dsh-web-fetch-http` 用**动态 import**：宿主版本里若没有该包，
|
|
70
|
+
* 只降级为一条告警（绝不因缺一个可选后端而让整机启动失败——apply 抛错 = dsh 启动失败）。
|
|
71
|
+
* 失败一律响亮但不抛错。
|
|
72
|
+
*/
|
|
73
|
+
export declare function registerWebFetchProvider(ctx: Context): Promise<void>;
|
package/package.json
CHANGED
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@shgroup/dsh-serenity-hooks",
|
|
3
|
-
"version": "1.30.
|
|
4
|
-
"description": "宁静号 ACC harness
|
|
3
|
+
"version": "1.30.12",
|
|
4
|
+
"description": "宁静号 ACC harness（Native Cordis 插件）——给 DeepSeek Harness 装一个「AI 工作区」：10 个工具（container_fs/logbook/dashboard/container_git/msm/praxis/handyman/localstore/container_admin/autopilot-trajectory）+ 机械约束（安全模式/工作区围墙/密钥守卫/对外输出守卫）+ 工作日志与原地重建 + 网页登录入口/微信桥/子角色/对外问答页/自主巡航。适配 DSH 0.1.2-rc.1。",
|
|
5
5
|
"license": "MIT",
|
|
6
6
|
"repository": {
|
|
7
7
|
"type": "git",
|
|
@@ -65,6 +65,8 @@
|
|
|
65
65
|
"@deepseek-ai/dsh-skill": "^0.1.2-rc.1",
|
|
66
66
|
"@deepseek-ai/dsh-system-prompt": "^0.1.2-rc.1",
|
|
67
67
|
"@deepseek-ai/dsh-tools": "^0.1.2-rc.1",
|
|
68
|
+
"@deepseek-ai/dsh-web": "^0.1.2-rc.1",
|
|
69
|
+
"@deepseek-ai/dsh-web-fetch-http": "^0.1.2-rc.1",
|
|
68
70
|
"@deepseek-ai/schemastery": "^3.18.1",
|
|
69
71
|
"cordis": "^4.0.0-rc.7",
|
|
70
72
|
"@deepseek-ai/cordis": "^4.0.0-rc.7"
|
|
@@ -87,6 +89,9 @@
|
|
|
87
89
|
},
|
|
88
90
|
"@deepseek-ai/dsh-compaction": {
|
|
89
91
|
"optional": true
|
|
92
|
+
},
|
|
93
|
+
"@deepseek-ai/dsh-web-fetch-http": {
|
|
94
|
+
"optional": true
|
|
90
95
|
}
|
|
91
96
|
},
|
|
92
97
|
"devDependencies": {
|