Compare commits
155
Commits
| Author | SHA1 | Date | |
|---|---|---|---|
|
|
3df103cd45 | ||
|
|
c9dd5e48bd | ||
|
|
47a0b9e50d | ||
|
|
490afd6977 | ||
|
|
7dd6e5d12d | ||
|
|
e0cba62a0c | ||
|
|
ba20a4f39d | ||
|
|
02c154ae24 | ||
|
|
2f0b056a63 | ||
|
|
7212e0dfee | ||
|
|
29e4690982 | ||
|
|
1eeaf38009 | ||
|
|
1fd04e2607 | ||
|
|
92f0f16070 | ||
|
|
0e2f7c219f | ||
|
|
1e7f3e76ee | ||
|
|
938a99cabe | ||
|
|
3c9f9d2bdb | ||
|
|
4a36cc0266 | ||
|
|
af2e4a1c20 | ||
|
|
4333a53dd3 | ||
|
|
7d855454a8 | ||
|
|
1859fe0d5b | ||
|
|
925cf18da9 | ||
|
|
54c33dd7f1 | ||
|
|
4ff8b93025 | ||
|
|
ae9b78c661 | ||
|
|
ca8099b158 | ||
|
|
e55d209f59 | ||
|
|
8096d42926 | ||
|
|
4aa8f01610 | ||
|
|
488734641d | ||
|
|
85984e1ee2 | ||
|
|
71b83bb523 | ||
|
|
45e4720453 | ||
|
|
424bdcbd52 | ||
|
|
bba42ae2ca | ||
|
|
05d03f0836 | ||
|
|
e928fd7cb0 | ||
|
|
3139108838 | ||
|
|
c750393c81 | ||
|
|
6bd1fa48f8 | ||
|
|
6a0aed2611 | ||
|
|
af0575dddd | ||
|
|
25133f90ed | ||
|
|
ac052d6997 | ||
|
|
67d3355f44 | ||
|
|
60d8278610 | ||
|
|
772408fb6e | ||
|
|
111d6d6c90 | ||
|
|
9566cb8151 | ||
|
|
0c9a92aabd | ||
|
|
dab9d8f000 | ||
|
|
d455c2d203 | ||
|
|
da8653e5e9 | ||
|
|
d34b193033 | ||
|
|
c3fdf8b6aa | ||
|
|
b018ba7864 | ||
|
|
c07fc3be58 | ||
|
|
a0195c710b | ||
|
|
71f3cdb694 | ||
|
|
76297a8978 | ||
|
|
0529991ba1 | ||
|
|
87b8d5197b | ||
|
|
2be92e1106 | ||
|
|
f5099345d0 | ||
|
|
67dff34a89 | ||
|
|
8694061068 | ||
|
|
95047678f3 | ||
|
|
baec30398a | ||
|
|
a03fc9b82b | ||
|
|
c21647c642 | ||
|
|
cf21c42b17 | ||
|
|
2e2e47171f | ||
|
|
0433e61941 | ||
|
|
7b1ef9a479 | ||
|
|
793be29331 | ||
|
|
b9fad470ee | ||
|
|
8168eae51e | ||
|
|
a2bedbf0d7 | ||
|
|
3d5c8a80f1 | ||
|
|
6eca2dd215 | ||
|
|
43dec0ad0f | ||
|
|
ecf32c0388 | ||
|
|
f2f8ba9b72 | ||
|
|
728b213821 | ||
|
|
14616e1606 | ||
|
|
cf43206c98 | ||
|
|
0922045a38 | ||
|
|
351662d18c | ||
|
|
4c4076ba13 | ||
|
|
65d05d2656 | ||
|
|
e50015cdc1 | ||
|
|
6d4b41ebfe | ||
|
|
a4897c1ace | ||
|
|
25f9e157ad | ||
|
|
8a92f2543d | ||
|
|
90158ab590 | ||
|
|
f587eb5b52 | ||
|
|
57ff5073d8 | ||
|
|
b657a22fe2 | ||
|
|
ffca861dc1 | ||
|
|
f6665e904e | ||
|
|
893fc92f6d | ||
|
|
b3a0d5370c | ||
|
|
8effba36dd | ||
|
|
77ef1ec11c | ||
|
|
0234bc85e5 | ||
|
|
24d7f023ba | ||
|
|
d03d8ba95b | ||
|
|
10bf2f554b | ||
|
|
0ec9aec93e | ||
|
|
5959b4a674 | ||
|
|
4e1c1f36d0 | ||
|
|
a52b227d8b | ||
|
|
317397154e | ||
|
|
0f9cc241bb | ||
|
|
69e44c27ae | ||
|
|
469e801319 | ||
|
|
5b45368f58 | ||
|
|
a7eecdbe97 | ||
|
|
c7394dc45f | ||
|
|
8764fedabc | ||
|
|
29e4f6e6ea | ||
|
|
59994b688a | ||
|
|
50c53fd885 | ||
|
|
870033f26d | ||
|
|
c892703673 | ||
|
|
01757d4f4b | ||
|
|
c0488938ff | ||
|
|
20824dc42e | ||
|
|
419e3fc914 | ||
|
|
83644c09e7 | ||
|
|
d06cd6cedf | ||
|
|
4e97194b04 | ||
|
|
8ef4ec1ee4 | ||
|
|
2d5467203b | ||
|
|
80e9dcb0aa | ||
|
|
b5cfa36832 | ||
|
|
f451027729 | ||
|
|
8a5c8b1547 | ||
|
|
62e5902834 | ||
|
|
b4755ac98b | ||
|
|
df1b1787e9 | ||
|
|
03cf4b86e4 | ||
|
|
7641f5c0a7 | ||
|
|
ae8ed6bb25 | ||
|
|
3806071698 | ||
|
|
b0a8283406 | ||
|
|
cc53c117e8 | ||
|
|
10877c9723 | ||
|
|
509d63a99b | ||
|
|
dbd67ec273 | ||
|
|
774d09a07a | ||
|
|
5b005cc042 |
@@ -0,0 +1,53 @@
|
||||
name: agent-device release
|
||||
|
||||
# 只认设备端标签(agent-device-v0.1.0),不碰主项目的 v2.5.0 这类版本号。
|
||||
on:
|
||||
push:
|
||||
tags:
|
||||
- 'agent-device-v*'
|
||||
workflow_dispatch: # 兜底:页面上手动跑,填一个已存在的标签
|
||||
inputs:
|
||||
tag:
|
||||
description: '要发布的标签(已存在),如 agent-device-v0.1.0'
|
||||
required: true
|
||||
|
||||
permissions:
|
||||
contents: write # action-gh-release 需要建 release、传附件
|
||||
|
||||
jobs:
|
||||
release:
|
||||
runs-on: ubuntu-latest
|
||||
steps:
|
||||
- uses: actions/checkout@v4
|
||||
|
||||
- uses: actions/setup-go@v5
|
||||
with:
|
||||
go-version-file: device/go.mod
|
||||
cache-dependency-path: device/go.sum
|
||||
|
||||
# 复用仓库里的脚本,本地和 CI 一套目标列表
|
||||
- name: 编译各平台
|
||||
working-directory: device
|
||||
run: sh scripts/build.sh all
|
||||
|
||||
- name: 发布 Release
|
||||
uses: softprops/action-gh-release@v2
|
||||
with:
|
||||
name: ${{ inputs.tag || github.ref_name }}
|
||||
tag_name: ${{ inputs.tag || github.ref_name }}
|
||||
files: device/bin/agent-device-*
|
||||
fail_on_unmatched_files: true
|
||||
body: |
|
||||
设备执行端 agent-device(`device/`)。
|
||||
|
||||
- 设备主动出站连 core 的 `/dev/ws`,不需要公网 IP、不需要开端口
|
||||
- 二进制不含服务器地址与 token,启动时用 `-server` 或同目录 `config.json` 指定
|
||||
- 模型侧可用 `device` 工具跑命令、看负载、收发文件
|
||||
|
||||
| 平台 | 文件 |
|
||||
| --- | --- |
|
||||
| Linux amd64 / arm64 / mips | `agent-device-linux-*` |
|
||||
| macOS amd64 / arm64 | `agent-device-darwin-*` |
|
||||
| Windows amd64 | `agent-device-windows-amd64.exe` |
|
||||
|
||||
`linux-mips` 是软浮点(`GOMIPS=softfloat`),给 AR9331 这类没 FPU 的 OpenWrt 设备用。
|
||||
@@ -7,12 +7,21 @@ data/
|
||||
tasks/
|
||||
skills/deps/
|
||||
skills/*/.deps_installed
|
||||
# 本地端(local/):运行期产物与生成的配置都不入库(含密钥,见 local/README.md)
|
||||
local/.runtime/
|
||||
local/config.local.yml
|
||||
# officecli 二进制资产:skills/office/install.sh 运行期拉取,不进 git
|
||||
skills/office/bin/
|
||||
skills/**/__pycache__/
|
||||
*.log
|
||||
# 读图压缩缓存(会话工作目录 = 仓库根时落在仓库里)
|
||||
.imgcache/
|
||||
.DS_Store
|
||||
app/server/version.json
|
||||
*.apk
|
||||
# 部署配置真身(含密钥,模板见 scripts/deploy.conf.example);
|
||||
deploy.conf
|
||||
relay/config.json
|
||||
|
||||
# 设备端编译产物(交叉编译后本地生成,不入库)
|
||||
device/bin/
|
||||
|
||||
@@ -10,6 +10,9 @@
|
||||
`/chat/completions`)→ 模型调用内置工具 / MCP / 技能 → 命令在 `agent-executor` 隔离容器里执行 →
|
||||
产物落在会话工作目录并回传。每个会话 = 一个真实 Linux 工作目录 + 一条 SQLite 会话记录。
|
||||
|
||||
另有一个可选的**设备执行端** `device/`:设备主动出站连 core 的 `/dev/ws`,模型用 `device`
|
||||
工具在远端机器(Mac / Windows / OpenWrt 盒子)上跑命令、拉推文件。
|
||||
|
||||
设计基调:**单进程内存模型 + SQLite 同步 API**(JS 单线程,不存在跨进程竞争);**配置冷加载**
|
||||
(改 `config.yml` 需重启,少数写盘接口例外);**单租户**(登录只把门,不做资源级授权)。
|
||||
|
||||
@@ -21,9 +24,12 @@
|
||||
| `app/server/` | 后端全部代码(入口 `server.js`) | 见 `app/AGENTS.md` |
|
||||
| `app/server/public/` | 前端静态资源,经典脚本按序加载,共享全局作用域 | 无构建步骤 |
|
||||
| `executor/` | **agent-executor**:`/exec` 隔离命令执行 + Office 预览网关 | 零依赖 Node,独立容器 |
|
||||
| `device/` | **agent-device**:设备执行端,出站连 core 的 `/dev/ws`,提供 exec / 文件传输 | Go 单二进制,交叉编译(amd64/arm64/mips/mipsle/windows),见 `device/README.md` |
|
||||
| `wxbot/` | 微信 iLink 协议调制解调器(多实例) | 独立容器 `agent-wxbot` |
|
||||
| `mcp/` | 同栈 MCP 服务:`web_search` / `image_task` / `video_task` / `asr` | 四个容器,仅内网 |
|
||||
| `skills/` | 目录式技能(`SKILL.md` + `run.py`/`run.sh`) | 运行时挂载,`skills/deps` 为依赖层 |
|
||||
| `local/` | **本地端启动器**:同一份代码跑在本机(不起 Docker / executor),`start.sh` 负责探测、装依赖、守护 | 独立于 compose,见 `docs/local-mode.md` |
|
||||
| `tunnel/` | **反向隧道**:服务器端 `server.js` 按 Host / 固定端口 / 通配路由转发,本机 `client.js` 承接 | 独立 compose,见 `tunnel/README.md` |
|
||||
| `scripts/` | `init.sh` 生成 `.env` + 首次创建 `config.yml`(仅初始管理员);`init_host.sh` 裸机初始化 | 幂等,**不覆盖已有配置** |
|
||||
| `docs/` | 专题文档:`tool-design.md`(工具接口规范)、`OFFICE.md` | — |
|
||||
| `tasks/` | **运行时数据**:每个会话一个工作目录 | gitignore |
|
||||
@@ -37,13 +43,17 @@
|
||||
|
||||
```mermaid
|
||||
flowchart TD
|
||||
CORE["agent-core(8090,唯一对外端口)"]
|
||||
B["浏览器 / PWA"] -->|"HTTP + SSE"| CORE
|
||||
M["手机 / 外网"] -->|"HTTPS"| TUN["tunnel server(19000,仅回环)"]
|
||||
TUN -->|"WebSocket"| TC["tunnel client(本机)"]
|
||||
TC -->|"HTTP"| CORE
|
||||
W["微信客户端"] --> WXBOT["agent-wxbot(8093,仅内网)"]
|
||||
WXBOT -->|"回调 /wxhook/*(共享 Bearer token)"| CORE
|
||||
CORE["agent-core(8090,唯一对外端口)"]
|
||||
CORE --> EXEC["agent-executor(9000 exec / 3100 预览,仅内网)"]
|
||||
CORE --> MCP["mcp_web_search / mcp_image_task / mcp_video_task / mcp_asr(3000,仅内网)"]
|
||||
CORE -->|"分段投递回复"| WXBOT
|
||||
DEV["设备:Mac / Windows / OpenWrt"] -->|"wss 出站 /dev/ws"| CORE
|
||||
```
|
||||
|
||||
- **对外只暴露 `agent-core` 一个端口**(宿主 `AGENT_PORT`,默认 8090)。executor、wxbot、MCP
|
||||
@@ -52,12 +62,15 @@ flowchart TD
|
||||
- 容器间按容器名访问(`http://agent-executor:9000`、`http://mcp_web_search:3000/`);
|
||||
所有业务容器同在 `agent-mcp-net`(compose 里固定网络名,避免被加上项目名前缀)。
|
||||
- `agent-executor-init` 是一次性容器:把技能依赖装进 `./skills/deps` 后退出,属正常现象。
|
||||
- 设备(`device/`)**不需要任何入站端口**:设备主动连 `wss://<PUBLIC_BASE_URL 的 host>/dev/ws`,
|
||||
core 按 `DEVICE_TOKEN` 校验。本地部署没有公网前缀,端点不挂,`device` 工具直接回“未启用”。
|
||||
|
||||
### 端口与网络(要改先看这里)
|
||||
|
||||
| 服务 | 端口 | 可见性 |
|
||||
|---|---|---|
|
||||
| `agent-core` | 8090 | 宿主机映射,**唯一对外** |
|
||||
| `tunnel` server | 19000 | 仅 `127.0.0.1`,对外经 nginx 反代 |
|
||||
| `agent-executor` | 9000(exec)、3100(预览网关) | 仅 `expose`,内网 |
|
||||
| `agent-wxbot` | 8093 | 仅内网 |
|
||||
| `mcp_*` | 3000 | 仅内网 |
|
||||
@@ -71,6 +84,7 @@ flowchart TD
|
||||
| `./skills/` | `/workspace/skills` | `/workspace/skills:ro` | 技能与共享依赖 |
|
||||
| `./config.yml` | `/app/config.yml` | 不挂、不读 | 平台密钥、登录密钥 |
|
||||
| `./app/server/` | `/app/server` | — | 后端代码(**热挂载**) |
|
||||
| `./tunnel/data/` | — | — | 隧道服务端配置 `server.yml`(首次启动自动生成,含 token) |
|
||||
| `./wxbot/data/` | — | `/data`(wxbot) | 微信登录凭证 |
|
||||
|
||||
推论:
|
||||
@@ -83,12 +97,12 @@ flowchart TD
|
||||
### 环境变量(接线全靠根 `.env` + compose)
|
||||
|
||||
`AGENT_CONFIG`、`PORT`、`EXECUTOR_URL`、`EXECUTOR_TOKEN`、`WXBOT_URL`、`WXBOT_TOKEN`、
|
||||
`PUBLIC_BASE_URL`、`ASR_URL`、`PREVIEW_PROXIES`、`EXECUTOR_LOG_LEVEL`、`WXBOT_LOG_LEVEL`、`ASR_LOG_LEVEL`。
|
||||
`PUBLIC_BASE_URL`、`DEVICE_TOKEN`、`ASR_URL`、`PREVIEW_PROXIES`、`EXECUTOR_LOG_LEVEL`、`WXBOT_LOG_LEVEL`、`ASR_LOG_LEVEL`。
|
||||
密钥生成:`./scripts/init.sh`(幂等,重跑不掉登录态;**从不覆盖已有 config.yml**,只在其缺失时创建
|
||||
最小骨架)。语音识别的上游 key/base/model 不在 env,
|
||||
写在 `config.yml` 的 `mcp_servers[name=asr].headers`(容器不存平台密钥)。
|
||||
|
||||
## 三条主链路
|
||||
## 四条主链路
|
||||
|
||||
1. **Web / HTTP**:`app/server/server.js` 装配 → 路由 → `engine.js` 起回合 →
|
||||
`llm.js` 组装并流式调用上游 → `tools/executor.js` 执行工具(`terminal` / `skill` 走
|
||||
@@ -96,7 +110,10 @@ flowchart TD
|
||||
2. **微信**:`agent-wxbot` 收消息 → 回调 core `/wxhook/inbox` → `wechat.js` 落媒体、注入上下文 →
|
||||
`routes/channel.js` 的命令层(`/new` `/switch` `/think` …)→ 同一套 `engine`;回合结束由
|
||||
SSE 内部订阅者(`bus.onInternal`)分段推回微信。
|
||||
3. **定时任务**:`scheduler.js` 每 30s tick → 到期则先 `archiveHistory`(历史整体 `archived`,
|
||||
3. **远端设备**:设备上的 `agent-device` 出站连 core `/dev/ws` → `devices.js` 维护连接表 →
|
||||
模型调 `device` 工具(`list` / `health` / `exec` / `pull` / `push`)→ 命令经 WS 下发、输出分片
|
||||
回传;`pull` 落到会话目录后,`read_file` / 技能可直接消费。
|
||||
4. **定时任务**:`scheduler.js` 每 30s tick → 到期则先 `archiveHistory`(历史整体 `archived`,
|
||||
模型等价新会话)→ `engine.postUserMessage` 投递 → 结束后 `wechat.notifyTask` 通知。
|
||||
|
||||
## 数据与状态
|
||||
@@ -126,7 +143,9 @@ flowchart TD
|
||||
「回合中会话数 → 在用会话数 → 最久未用」择优(详见 `app/AGENTS.md`)。
|
||||
7. **运行时目录不入库**。`tasks/`、`data/`、`skills/deps/`、`wxbot/data/` 已被 gitignore;
|
||||
不要把样例任务、数据库、密钥当成源码提交。
|
||||
8. **工具 schema 是每轮全量重发的上下文成本**。新增工具前先读 `docs/tool-design.md`:能用已有工具
|
||||
8. **设备是远端 shell**。`device exec` 在设备上就是 `sh -c` / `cmd /c`;`root` 只约束**起始
|
||||
cwd**,命令里 `cd /etc` 照样能跑。`DEVICE_TOKEN` 泄漏等价于那台机器的 shell 泄漏,按这个等级管理。
|
||||
9. **工具 schema 是每轮全量重发的上下文成本**。新增工具前先读 `docs/tool-design.md`:能用已有工具
|
||||
的 `op` 扩展就不要新开工具。
|
||||
|
||||
## 开发与验证
|
||||
@@ -162,6 +181,7 @@ curl -s http://127.0.0.1:8090/api/health
|
||||
| 配置默认值 | `app/server/config.js` 的 `DEFAULTS` ↔ `app/config.example.yml` |
|
||||
| 内置工具 | `app/server/tools/definitions.json` ↔ `app/AGENTS.md` / README 工具表 ↔ `docs/tool-design.md` 规范 |
|
||||
| 新增服务 / 端口 / 卷 | `docker-compose.yml` ↔ `README.md` 的部署与安全章节 |
|
||||
| 隧道 token | `tunnel/data/server.yml`(自动生成)↔ `tunnel/client.yml`(手写),两边必须一致 |
|
||||
| 新增环境变量 | compose ↔ README「环境变量」 |
|
||||
| 发版号 | `app/package.json` 的 `version` ↔ `app/server/routes/system.js` 的 `VERSION` 字面量(两者不自动同步) |
|
||||
| 技能格式 | `skills/README.md` ↔ `app/server/tools/skills.js` 的解析 |
|
||||
@@ -179,6 +199,10 @@ curl -s http://127.0.0.1:8090/api/health
|
||||
由 `server.js` 传函数进去。
|
||||
- 前端是**无构建的经典脚本**:新增文件要同时改 `app/server/public/index.html` 的 `<script>`
|
||||
顺序(共享全局作用域,顺序即依赖)。
|
||||
- 前端图标统一走 `index.html` 顶部的 `<symbol>` sprite:引用写成
|
||||
`<svg class="…" viewBox="0 0 24 24"><use href="#i-xxx"/></svg>`,形状只改 sprite 里那一行,
|
||||
尺寸与描边归各处 CSS(`.ic` / `.tree-act svg` 等)。加图标先加 `<symbol id="i-xxx">`,
|
||||
漏了不报错、界面只是空白。
|
||||
|
||||
## 常见任务去哪改
|
||||
|
||||
@@ -192,5 +216,8 @@ curl -s http://127.0.0.1:8090/api/health
|
||||
| 改微信投递 | `app/server/wechat.js`(业务)+ `app/server/routes/wechat.js`(HTTP/鉴权) |
|
||||
| 改语音输入 | `app/server/public/js/voice.js`(录音与插入)+ `app/server/routes/asr.js`(代理)+ `mcp/asr/`(转写);客户端桥契约见 `docs/voice-input.md` |
|
||||
| 改隔离执行 | `executor/server.js`(先读顶部安全模型注释) |
|
||||
| 改设备执行 / 文件传输 | `app/server/devices.js`(连接表 + exec/health/pull/push)+ `app/server/tools/executor.js` 的 `toolDevice` |
|
||||
| 改设备端行为 | `device/cmd/agent/`(协议 `device/pkg/proto`,连接基座 `device/pkg/wsnode`) |
|
||||
| 改隧道路由 / 转发 | `tunnel/server.js`(按 Host / 端口匹配)+ `tunnel/client.js`(本地服务映射) |
|
||||
| 加同栈 MCP 服务 | `mcp/<name>/` + `docker-compose.yml` + `config.yml` 的 `mcp_servers` |
|
||||
| 加技能 | `skills/<name>/`(`SKILL.md` + `run.py`),见 `skills/README.md` |
|
||||
|
||||
@@ -1,481 +1,104 @@
|
||||
# Agent 任务台
|
||||
|
||||
自托管的通用 Agent 系统。浏览器或微信发来任务,服务端调度模型、调用工具,在独立工作目录里生成文件并回传结果。
|
||||
自托管的 Agent 系统。浏览器或微信下发任务,模型在独立工作目录里读写文件、执行命令、调用技能,产物直接回传。
|
||||
|
||||
它不是聊天壳子:每个会话对应一个真实的 Linux 工作目录,模型可以读写文件、执行命令、抓网页、操作 SQLite、调用技能和 MCP 服务;命令在隔离容器中运行,文件可以直接下载或生成公网临时链接。
|
||||
|
||||
- 面向个人或小团队自用,单实例部署。
|
||||
- 模型层兼容任何 OpenAI `/chat/completions` 接口。
|
||||
- 前端是免构建的移动优先 H5,HTTPS 下可安装为 PWA。
|
||||
|
||||
---
|
||||
|
||||
## 能力
|
||||
|
||||
| 能力 | 说明 |
|
||||
|---|---|
|
||||
| 任务会话 | 每个会话一个独立目录 `tasks/<会话 id>/`,历史、文件、模型绑定都随会话保存 |
|
||||
| 模型池 | 多平台、每平台多 key、每平台多模型;key 共享并发,不独占、不排队 |
|
||||
| 工具调用 | 文件读写编辑、目录列举、复制、命令执行、网页抓取、SQLite、定时任务、技能、长期记忆等 14 个内置工具 |
|
||||
| 隔离执行 | `terminal` 和技能在 `agent-executor` 容器中运行,只看到当前会话目录,根文件系统只读 |
|
||||
| 大文件交付 | 文件面板上传/下载/打包 zip;外部服务取图走带过期时间的公网短链 |
|
||||
| 上下文管理 | 手动压缩、按 token 阈值提示压缩、历史重放自动裁剪、会话标题自动生成 |
|
||||
| 回合中投递 | 运行中发的消息先进输入框上方的待发送条幅:默认等本轮结束自动发出;可「干预」(当前工具跑完就插话)或「立即发送」(终止本轮并立刻发)。队列在服务端,关页面不丢 |
|
||||
| 定时任务 | 每会话最多一个 cron 任务;触发前清空模型可见历史,按计划执行并推送结果 |
|
||||
| 微信接入 | 扫码绑定个人微信,文本/图片/视频/文件进入同一套会话与命令体系 |
|
||||
| 语音输入 | 输入框为空时发送键变麦克风:点一下进入语音模式,输入框位置变成「按住 说话」,松开即转写并直接发送;发送键位置变键盘按钮可切回打字。套壳 App 走原生录音(http 页面也能用),浏览器走 MediaRecorder(需 HTTPS);识别在 `mcp_asr`,不经过模型、不消耗 token |
|
||||
| 长期记忆 | 会话收口时生成第一人称工作日记;微信新会话注入最近几条,`recall` 可检索全部 |
|
||||
| 用户画像 | 记录称谓、行业、偏好,会话创建时冻结注入,跨会话生效 |
|
||||
| 技能 | 目录式技能(`SKILL.md` + `run.py`/`run.sh`),可在设置页管理 |
|
||||
| MCP | 启动时发现 MCP 服务的工具;仓库内自带 `web_search` / `image_task` / `video_task` 三个 |
|
||||
| 多用户 | 登录账号、管理员角色、按用户隔离的会话列表与画像 |
|
||||
|
||||
---
|
||||

|
||||
|
||||
## 快速开始
|
||||
|
||||
### 前置条件
|
||||
### 服务器
|
||||
|
||||
- Linux 服务器,Docker 与 Docker Compose v2。
|
||||
- 至少一个 OpenAI 兼容模型平台的 API Key。
|
||||
- 一个可用端口,默认 `8090`。
|
||||
|
||||
Debian 12 裸机可以先跑 `scripts/init_host.sh`(幂等,可重复执行,也可单独拷到服务器上跑):它会配好 Swap、Docker、国内镜像加速与基础 shell 环境;`REGION=oversea` 切海外源。跑完会打印后续的 `init.sh` 与部署步骤。
|
||||
|
||||
### 1. 初始化(只做部署接线)
|
||||
|
||||
在仓库根目录执行:
|
||||
需要 Docker 与 Compose v2:
|
||||
|
||||
```bash
|
||||
./scripts/init.sh
|
||||
docker compose up -d --build
|
||||
```
|
||||
|
||||
它只做三件事,**幂等**,随便重跑:
|
||||
打开 `http://<服务器 IP>:8090`,用 `admin` / `admin` 登录,先改密码,再到「设置 → 模型」添加平台和 API Key,保存后点「重启服务」。
|
||||
|
||||
1. 生成 `.env` 里的 `EXECUTOR_TOKEN` / `WXBOT_TOKEN` / `AUTH_SECRET`(已有值原样复用,重跑不会掉登录态,也不会换掉 executor 的 token)。
|
||||
2. 探测公网 IP 并写成 `PUBLIC_BASE_URL`(外部服务靠它回取会话文件,图生视频需要)。知道地址就直接给:
|
||||
```bash
|
||||
PUBLIC_IP=1.2.3.4 ./scripts/init.sh
|
||||
```
|
||||
3. 确保 `config.yml` 存在:**不存在时**才创建,内容只有初始管理员 `admin` / `admin`。已有文件**绝不改写**。
|
||||
### 本机运行
|
||||
|
||||
脚本不再生成模型平台 / MCP / 语音这些配置——它们全部在前端「设置」里完成,写的就是同一个 `config.yml`。所以重跑脚本永远不会清掉你配好的东西(旧版脚本会覆盖,这是本次的行为变化)。
|
||||
|
||||
- 想换初始管理员:仅在**首次创建**时生效,`AUTH_USER=me AUTH_PASSWORD='强密码' ./scripts/init.sh`。
|
||||
- `config.yml` 被 Docker 误建成了空目录(源文件缺失时才会这样):脚本会自动删掉并重建;目录非空则报错让你手工处理。
|
||||
|
||||
没有 `config.yml` 也能启动:`platforms` 为空、`auth` 为空即“无模型 + 不启用登录”,登录后从设置页补齐即可(保存后点「重启服务」生效)。
|
||||
|
||||
### 2. 启动
|
||||
macOS / Linux,Node 20+,不需要 Docker:
|
||||
|
||||
```bash
|
||||
# 迁移:把旧版根目录的 config.yml 原样留着即可,init.sh 不会动它
|
||||
docker compose up -d --build
|
||||
docker compose logs -f agent-core
|
||||
./local/start.sh # 后台启动
|
||||
./local/stop.sh
|
||||
```
|
||||
|
||||
看到 `Agent server listening on 8090` 即启动完成。
|
||||
首次运行会让你选一个工作目录(技能、会话、数据库都在里面)。命令直接在本机执行,没有沙箱隔离,只监听 `127.0.0.1`。
|
||||
|
||||
首次启动还会运行一次性的 `agent-executor-init`,把技能依赖安装到 `./skills/deps`,随后自动退出,属正常现象。
|
||||
需要从外网访问时,配好 [`tunnel/client.yml`](tunnel/README.md) 后 `start.sh` 会一并拉起隧道 client;未配置则跳过。
|
||||
|
||||
### 3. 访问与首次配置
|
||||
## 组成
|
||||
|
||||
浏览器打开:
|
||||
|
||||
```text
|
||||
http://<服务器 IP>:<AGENT_PORT>
|
||||
```
|
||||
|
||||
首次用 `admin` / `admin` 登录(**登录后立刻在「设置 → 账户」改密码**)。默认端口 `8090`,可用 `.env` 的 `AGENT_PORT` 修改。
|
||||
|
||||
登录后去「设置」补齐三块,保存后点页面顶部的「重启服务」:
|
||||
|
||||
| 设置页 | 配什么 |
|
||||
| 目录 | 说明 |
|
||||
|---|---|
|
||||
| 模型 | 平台地址 + API Key + 模型 id(`extra_params` / `thinking_params` / profile 等在「高级」里) |
|
||||
| MCP | `image_task` / `video_task` / `asr` 需上游 key;`web_search` 免费,地址 `http://mcp_web_search:3000/` |
|
||||
| 用户 | 其余账号、角色、默认模型;改密码在「账户」 |
|
||||
| [`app/`](app/README.md) | agent-core:Express + SQLite + 前端静态资源,唯一对外端口 |
|
||||
| `executor/` | agent-executor:隔离的命令执行、Office 预览网关 |
|
||||
| [`wxbot/`](wxbot/README.md) | 微信接入 |
|
||||
| [`mcp/`](mcp/README.md) | 四个 MCP 服务:网页搜索、图片生成、视频生成、语音转写 |
|
||||
| [`skills/`](skills/README.md) | 内置技能 |
|
||||
| [`local/`](local/README.md) | 本机模式启动器 |
|
||||
| [`tunnel/`](tunnel/README.md) | 反向隧道:把本机服务经服务器中转,供外网访问 |
|
||||
| [`device/`](device/README.md) | 设备执行端:任意机器装上就连回来,模型可在上面跑命令、传文件 |
|
||||
|
||||
对外只需要放行 core 这一个端口。`agent-executor`、`wxbot` 和 MCP 服务都只在 Docker 内网,不映射到宿主机。
|
||||
## 远端设备
|
||||
|
||||
### 4. 同栈 MCP 服务
|
||||
把任意一台机器(Mac / Linux / Windows / OpenWrt 盒子)接进来,让模型在它上面执行命令、读写文件:
|
||||
|
||||
初始 `config.yml` 不包含任何 MCP 服务。设置页「MCP」会把四个同栈服务作为**内置服务卡片**列出来,
|
||||
点卡片 → 填表 → 保存即可(url 与 header 名由 `app/server/presets.json` 提供,不用记)。
|
||||
`web_search` 免费、无需 key;另外三个要填上游 key。手工写 YAML 的形状如下(容器不存密钥):
|
||||
1. 编译或下载 `device/` 的二进制,和 `config.json` 放在同一个目录:
|
||||
|
||||
```yaml
|
||||
mcp_servers:
|
||||
- name: web_search
|
||||
url: "http://mcp_web_search:3000/"
|
||||
```json
|
||||
{ "server": "wss://你的域名/dev/ws", "token": "<DEVICE_TOKEN>", "root": "/Users/you", "name": "mac-01" }
|
||||
```
|
||||
|
||||
# - name: image_task
|
||||
# url: "http://mcp_image_task:3000/mcp"
|
||||
# headers:
|
||||
# Authorization: Bearer <upstream-api-key>
|
||||
# X-Image-Task-Base-Url: "https://open.bigmodel.cn/api/paas/v4" # 任意 OpenAI 兼容的 images 上游(生成 /images/generations、编辑 /images/edits)
|
||||
# X-Image-Task-Model: "CogView-4"
|
||||
# mode: skill
|
||||
# - name: video_task
|
||||
# url: "http://mcp_video_task:3000/mcp"
|
||||
# headers:
|
||||
# Authorization: Bearer <zhipu-api-key>
|
||||
# mode: skill
|
||||
# - name: asr
|
||||
# url: "http://mcp_asr:3000/mcp"
|
||||
# headers:
|
||||
# Authorization: Bearer <key> # 免鉴权的自建服务可省
|
||||
# X-ASR-Base-Url: "https://<host>/v1"
|
||||
# X-ASR-Model: "whisper-1"
|
||||
# mode: skill
|
||||
```
|
||||
2. 直接运行(默认读同目录的 `config.json`,token 不会出现在 `ps` 里):
|
||||
|
||||
`web_search` / `image_task` / `video_task` / `asr` 四个容器与 core 由同一个根 `docker-compose.yml` 启动(与是否写进配置无关),没有先后顺序,也不占宿主机端口。工具说明、header 覆盖项与调试方式见 [mcp/README.md](mcp/README.md)。
|
||||
```bash
|
||||
./agent-device-darwin-amd64
|
||||
```
|
||||
|
||||
`ASR_URL`(`docker-compose.yml` 里固定为 `http://mcp_asr:3000`)是 core 调用语音转写的基地址;把 `mcp_asr` 放到另一台机器时改这一行即可(那台要能接受 `Authorization` / `X-ASR-Base-Url` / `X-ASR-Model` 三个 header)。
|
||||
3. 服务器 `.env` 里配同一个 `DEVICE_TOKEN` 并重启 core。
|
||||
|
||||
语音输入(H5 输入框里说话)走的是另一条路:客户端录音 → `POST /api/asr/transcribe` → `mcp_asr` 的 `/transcribe`,**不经过模型、不消耗 token**,结果插入输入框可编辑。客户端录音契约(Android 套壳原生桥 / 浏览器 MediaRecorder)见 [docs/voice-input.md](docs/voice-input.md);删掉 `config.yml` 里的 `asr` 段即整体关闭。
|
||||
|
||||
`mcp_asr` 自己**不存任何平台密钥**:上游 key / base_url / model 都由 core 从这里那段 `asr.headers` 随请求带进去,换平台只改 YAML(不用重建镜像、不用动 `.env`),也不预设任何厂商。
|
||||
|
||||
接入栈外的 MCP 服务:在设置页添加 `url` / `headers`,或在 `config.yml` 的 `mcp_servers` 追加一项。服务不可达时 core 只在启动日志里告警,不影响 Web 主流程,但对应工具不会下发给模型。
|
||||
|
||||
每个服务可用 `mode` 控制「工具是否下发给模型」:
|
||||
|
||||
| `mode` | 连接/发现 | 进 tools 数组 | 进技能清单 | 谁可以调用 |
|
||||
|---|---|---|---|---|
|
||||
| `advertise`(默认) | ✓ | ✓ | ✗ | 模型与技能 |
|
||||
| `skill` | ✓ | ✗ | ✓ | `skill` 工具与 `lab` |
|
||||
| `disable` | ✗ | ✗ | ✗ | 无人 |
|
||||
|
||||
`skill` 用于「能力包在技能后面」的场景:工具照常发现并注册,只是不进模型的 tools 数组,改为以技能形式暴露——`{"op":"list"}` 能看到它,`{"op":"get","name":"<名>"}` 直接返回 MCP 原始的 `description` + `input_schema`,`{"op":"run","name":"<名>","args":{…}}` 转发给服务。不用在 `skills/` 里建目录。旧字段 `enable` 已废弃,`mode: silent` 已移除(启动会报错并提示改用 `skill`)。
|
||||
|
||||
工具发现只在启动时做一次,因此发现失败后会自动按 **2s / 20s / 1min 重试 3 次**(覆盖 compose 并行拉起与宿主机重启后的容器乱序);成功后工具在下一轮请求即可用,三次都失败则需重启 core。四个 MCP 服务都配了 `/health` 健康检查,`docker ps` 可直接看状态。
|
||||
|
||||
---
|
||||
|
||||
## 使用
|
||||
|
||||
### 会话与模型
|
||||
|
||||
- 新建会话时自动绑定一个模型;不选则按平台轮转选择。
|
||||
- 会话创建后模型绑定保持,重启、追问都不会丢。
|
||||
- 模型被删除或禁用后,下一条消息会自动改选原平台的可用模型。
|
||||
- 管理员可在「设置 → 用户」给某个用户锁定默认模型。
|
||||
- 顶部「切换模型」只在该会话空闲时可用;正在输出时会拒绝换绑。
|
||||
|
||||
会话状态:
|
||||
|
||||
| 状态 | 含义 |
|
||||
|---|---|
|
||||
| 保持中 | 回合已结束,可以直接继续追问 |
|
||||
| 活跃中 | 正在执行模型回合 |
|
||||
| 已完成 | 已手动断开或空闲超时收口,仍可继续发消息 |
|
||||
| 已终止 | 用户主动停止 |
|
||||
|
||||
### 文件
|
||||
|
||||
- 输入框附件、微信附件都落在 `tasks/<会话 id>/`。
|
||||
- 右侧「任务文件」面板支持上传、下载、批量打包、删除、子目录浏览。
|
||||
- 模型生成的文件与用户上传的文件在同一目录,AI 可直接继续处理。
|
||||
- 超过 50 MB 的单文件上传会被拒绝;移动端大图上传前会在浏览器端压缩。
|
||||
|
||||
### 上下文压缩
|
||||
|
||||
- 顶部「压缩」可手动触发:模型基于完整历史生成摘要,摘要之前的消息标记为已存档,UI 仍可见,但不再发给模型。
|
||||
- 当单回合输入 token 超过 `agent.auto_compress_tokens` 时,前端会弹一次确认框,询问是否压缩。
|
||||
- 历史重放还会自动把较旧的 `write_file` 参数正文、`fetch` / `read_file` 回执替换为单行占位,数据库与 UI 不受影响。
|
||||
|
||||
### 定时任务
|
||||
|
||||
对 AI 说「每天早上九点汇总……」,它会在当前会话创建 cron 任务:
|
||||
|
||||
- 每会话最多一个任务,最小间隔 1 小时,时区固定 `Asia/Shanghai`。
|
||||
- 每次触发前,会话历史整体标记为已存档,模型只看到任务提示词,等价一次全新会话。
|
||||
- 执行结果留在会话里,同时可通过微信推送。
|
||||
- 创建任务后,当前会话会收口为该任务的「专柜」,用户下一条消息自动进入新会话。
|
||||
|
||||
### 微信
|
||||
|
||||
在「设置 → 账户 → 微信绑定」生成二维码,扫码后即可单线对话:
|
||||
|
||||
- 微信消息复用同一套会话和命令层,支持 `/new`、`/list`、`/switch`、`/delete`、`/rename`、`/models`、`/think`、`/stop`、`/compact`、`/clear`、`/status`、`/help`。
|
||||
- 图片、视频、文件会落到当前会话目录;单发媒体只留痕,不唤醒 AI。
|
||||
- AI 最终回复会推回微信;较长回复自动分段,超长时落成 `.md` 文件卡片。
|
||||
- 定时任务完成或失败也会通知微信。
|
||||
|
||||
### 长期记忆
|
||||
|
||||
- 会话空闲超过 `memory.wrap_idle_ms`(默认 4 小时)后,后台生成一条工作日记碎片,并归档、解绑通道。
|
||||
- 微信新会话开场注入最近 `memory.inject_max` 条碎片。
|
||||
- AI 可用 `recall` 工具按关键词、日期索引、具体某天检索全部日记。
|
||||
- 删除会话会连带删除它的日记碎片;清空会话在普通情况下也会删除,但定时任务「专柜」例外。
|
||||
- 日记调试页:`/memory.html`。
|
||||
|
||||
---
|
||||
设备**主动出站**连接,不需要公网 IP、不需要开端口。连上后模型侧多出 `device` 工具:
|
||||
`list` 看在线设备、`health` 看负载、`exec` 跑命令、`pull`/`push` 收发文件(单个 2 GiB 以内)。
|
||||
盒子上的常驻用系统自带的服务管理器(systemd / procd / schtasks),细节见 [`device/README.md`](device/README.md)。
|
||||
|
||||
## 配置
|
||||
|
||||
`config.yml` 只给 `agent-core` 读取,包含平台密钥和登录密钥。`agent-executor`、`wxbot` 不挂载、不读取它。
|
||||
|
||||
主要配置段:
|
||||
|
||||
| 段 | 作用 |
|
||||
|---|---|
|
||||
| `platforms` | 模型平台池:`name`、`url`、`type`、`models`、`keys` |
|
||||
| `model_profiles` | prompt + 工具名单组合;模型用 `profile: <名>` 引用 |
|
||||
| `tools_deny` | 全局工具黑名单,默认屏蔽元工具 `lab` |
|
||||
| `auth` | 登录账号、`secret`、有效期;留空则不启用认证 |
|
||||
| `mcp_servers` | 外部 MCP 服务:`url`、`headers`、`mode`(advertise / skill / disable)、`timeout_ms`、工具名单 |
|
||||
| `public_link` | 公网临时链接前缀与有效期 |
|
||||
| `agent` | 温度、最大工具迭代、重试、语言、压缩阈值、空闲收口、历史裁剪 |
|
||||
| `memory` | 日记注入条数、保留期、空闲收口阈值 |
|
||||
| `terminal` / `fetch` | 命令超时与输出上限、抓取超时、字节数、SSRF 开关 |
|
||||
| `skills` | 技能目录与单次执行超时 |
|
||||
| `upload` | 前端大图压缩阈值与参数 |
|
||||
| `workspace_root` / `data_root` | 任务目录与 SQLite / 调试产物目录 |
|
||||
|
||||
平台结构示例:
|
||||
`./scripts/init.sh` 首次生成 `config.yml`,只有 agent-core 读取。日常改动走设置页,保存后点「重启服务」。
|
||||
|
||||
```yaml
|
||||
platforms:
|
||||
- name: bigmodel
|
||||
url: https://open.bigmodel.cn/api/paas/v4
|
||||
type: bigmodel # 决定余额查询适配器
|
||||
models:
|
||||
- id: glm-5.3-flash
|
||||
vision: true
|
||||
extra_params: { reasoning_effort: "low", tool_stream: true }
|
||||
thinking_params: { reasoning_effort: "max" }
|
||||
keys:
|
||||
- api_key: "sk-..."
|
||||
```
|
||||
|
||||
通用模型字段:
|
||||
端口与其余环境变量在 `docker-compose.yml` 里。
|
||||
|
||||
- `enable: false`:模型不进池,不参与分配。
|
||||
- `vision: false`:读图时不回传像素,回执只给结构化说明(`reason: no_vision`)。
|
||||
- `profile: <名>`:引用 `model_profiles`,不配则使用默认全量 prompt 与工具。
|
||||
- `reasoning_ack_field`:需要把思考链回传给上游时填写,例如 DeepSeek 系的 `reasoning_content`。
|
||||
|
||||
日常修改配置建议使用设置页;改完需重启生效。设置页写入前会先校验,非法配置不会覆盖原文件。
|
||||
|
||||
### 环境变量
|
||||
|
||||
| 变量 | 作用 |
|
||||
|---|---|
|
||||
| `AGENT_CONFIG` | core 配置文件路径,容器内固定 `/app/config.yml` |
|
||||
| `PORT` | core 监听端口,容器内 `8090` |
|
||||
| `EXECUTOR_URL` | `agent-executor` 地址;空则命令在 core 进程内本地执行,仅适合开发 |
|
||||
| `EXECUTOR_TOKEN` | core ↔ executor 的 Bearer token,两侧同值 |
|
||||
| `ASR_URL` | core 拼接 `/transcribe` 的基地址,compose 里固定 `http://mcp_asr:3000`(把 `mcp_asr` 放别处时改那一行) |
|
||||
| `ASR_LOG_LEVEL` | `mcp_asr` 日志等级 |
|
||||
| `WXBOT_URL` | wxbot 地址;置空则微信功能整体关闭 |
|
||||
| `WXBOT_TOKEN` | core ↔ wxbot 的共享 token |
|
||||
| `PUBLIC_BASE_URL` | 对外的完整地址(如 `http://1.2.3.4:8090`),作为 `public_link` 的默认值;设置页填过则以设置页为准 |
|
||||
| `PREVIEW_PROXIES` | 覆盖内置预览反代注册表(JSON 数组) |
|
||||
| `EXECUTOR_LOG_LEVEL` / `WXBOT_LOG_LEVEL` | 两个附属服务的日志等级 |
|
||||
|
||||
`config.yml` 与 `.env` 都含密钥,已在 `.gitignore` 中。不要提交,也不要挂给不需要它的容器。
|
||||
|
||||
---
|
||||
|
||||
## 内置工具
|
||||
|
||||
模型实际收到的工具是内置工具加 MCP 工具,再经 `tools_deny` 与模型 `profile` 过滤。
|
||||
|
||||
| 工具 | 用途 |
|
||||
|---|---|
|
||||
| `read_file` | 读文本或图片;大文件返回符号大纲;支持 `@<会话 id>/<路径>` 只读查看历史会话文件 |
|
||||
| `write_file` | 新建或覆盖文本文件 |
|
||||
| `edit_file` | 按 `old_text` / `new_text` 做精确或容错编辑 |
|
||||
| `list_directory` | 单层列目录;支持 `@<会话 id>/<路径>` |
|
||||
| `copy_path` | 复制文件或目录;可从历史会话导入文件 |
|
||||
| `terminal` | 执行 shell 命令;默认在会话目录,超时可终止 |
|
||||
| `fetch` | 抓取 HTTP/HTTPS 并转 Markdown;带 SSRF 防护与分段续读 |
|
||||
| `mint_public_link` | 为会话内文件签发短期公网链接 |
|
||||
| `skill` | 技能:`op` = `list` / `get` / `run`;`name` 指技能,`args` 传参数 |
|
||||
| `db` | 操作会话本地 `data.db`:`exec`、`query`、`insert`、`tables`、`schema` |
|
||||
| `schedule` | 定时任务 `get` / `list` / `create` / `update` / `delete` |
|
||||
| `profile` | 用户画像 `list` / `set` / `add` / `remove` |
|
||||
| `recall` | 长期记忆 `search` / `days` / `day` |
|
||||
| `lab` | 元工具:按名字调用任意工具,`help` 可列出全部工具;默认被全局黑名单屏蔽 |
|
||||
|
||||
跨会话路径只读:`@` 形式只用于 `read_file`、`list_directory` 和 `copy_path` 的源路径,且只能访问同一用户自己的会话。要真正处理旧文件,先用 `copy_path` 导入当前会话。
|
||||
|
||||
---
|
||||
|
||||
## 技能
|
||||
|
||||
技能是 `skills/<名字>/` 目录:
|
||||
|
||||
```text
|
||||
skills/my-skill/
|
||||
├── SKILL.md # 必需:描述、input_schema、可选 required / visit_url
|
||||
├── run.py | run.sh # 入口,唯一命令行参数是 JSON 字符串
|
||||
├── requirements.txt # 可选:Python 依赖
|
||||
└── install.sh # 可选:系统层安装脚本,镜像构建期执行
|
||||
```
|
||||
|
||||
- `SKILL.md` 的 `description` 会进入 system prompt,模型启动时就知道有哪些技能。
|
||||
- `input_schema.required` 在 `op=run` 前校验。
|
||||
- MCP 工具不用建目录:给该服务配 `mode: skill`,平台会自动把它暴露成技能(`get` 返回 MCP 原始的
|
||||
`input_schema`,`run` 转发),见上文「同栈 MCP 服务」。
|
||||
- 入口脚本以绝对路径启动;远端执行时 cwd 是会话目录,本地开发时是技能目录。相对路径参数会先按会话目录转成绝对路径。
|
||||
- `requirements.txt` 的依赖由 `agent-executor-init` 安装到 `skills/deps`;技能容器通过 `PYTHONPATH` 可见。
|
||||
- `install.sh` 在镜像构建期以 root 执行,用于必须落在系统层的依赖。改完需要重建 executor 镜像。
|
||||
- 技能目录在 executor 中只读,运行期不能修改技能本身。
|
||||
|
||||
设置页支持创建、重命名、删除技能和在线编辑文本文件;技能列表变更后会实时刷新 system prompt 中的清单,无需重启。
|
||||
|
||||
---
|
||||
|
||||
## 安全模型
|
||||
|
||||
### 部署边界
|
||||
|
||||
- 对外只暴露 `agent-core` 端口。
|
||||
- `agent-executor` 使用独立的 mount / PID / IPC namespace,只 bind 当前会话目录;根文件系统只读,丢弃全部 capability 后仅保留 `SYS_ADMIN`。
|
||||
- 命令容器没有独立网络 namespace,所以 executor 会拒绝来自自身容器网卡的 `/exec` 请求,避免 token 泄漏后被借用。
|
||||
- `wxbot` 只挂内网;微信登录凭证在 `./wxbot/data`,等同微信账号权限,不要外泄。
|
||||
- 配置文件、`.env`、微信凭证、任务目录、SQLite 都属于敏感数据。
|
||||
|
||||
### 认证与授权
|
||||
|
||||
- 登录使用 HMAC 签名的 HttpOnly Cookie,支持 `Authorization: Basic` 作为脚本 / curl 的兜底。
|
||||
- `auth.users` 留空则完全关闭认证,只适合本机或完全可信网络。
|
||||
- 管理员接口:配置读写、用户管理、进程重启。
|
||||
- 删除用户会连带清理其微信绑定(含 wxbot 实例与凭证)、会话(含任务目录)、画像、长期记忆与通道绑定;`model_usage` 的用量统计保留(与删会话一致,不清账)。
|
||||
- **重要**:系统按单租户设计。除上述管理员接口外,会话、消息、文件、技能等 API 只校验「已登录」,不按用户做资源级授权;按用户的会话列表隔离发生在前端查询层。不要把实例开放给互不信任的用户。
|
||||
|
||||
### 公网临时链接
|
||||
|
||||
`mint_public_link` 生成 22 字符随机 ID,链接形如:
|
||||
|
||||
```text
|
||||
http://<host>/p/<id>
|
||||
```
|
||||
|
||||
- 只由 core 进程内的工具签发,签发前校验文件在任务目录内且 `realpath` 未越界。
|
||||
- 默认 30 分钟过期,可配置 1 分钟到 24 小时。
|
||||
- 链接可重复使用,直到过期;服务重启后全部失效。
|
||||
- 任何人拿到链接即可匿名访问,不要对含密钥的文件签发。
|
||||
|
||||
### HTTPS
|
||||
|
||||
仓库不内置 TLS 反向代理。直接 `http://IP:端口` 使用时:
|
||||
|
||||
- PWA / Service Worker 不会注册。
|
||||
- 复制按钮会回退到旧 API。
|
||||
- 登录 Cookie 不带 `Secure` 标志,HTTP 下正常工作。
|
||||
|
||||
如果前面加 nginx 等反向代理,SSE 必须关闭缓冲:
|
||||
|
||||
```nginx
|
||||
proxy_http_version 1.1;
|
||||
proxy_buffering off;
|
||||
proxy_read_timeout 3600s;
|
||||
```
|
||||
|
||||
公网链接前缀取 `config.yml` 的 `public_link.base_url`(设置页「服务 → 公网地址」);没填时用 `.env` 的 `PUBLIC_BASE_URL`(`init.sh` 会自动探测写入)。前置了反向代理 + HTTPS 的部署,直接把它填成域名即可。
|
||||
|
||||
---
|
||||
|
||||
## 运维
|
||||
|
||||
### 数据位置
|
||||
|
||||
| 宿主机路径 | 容器内 | 内容 |
|
||||
|---|---|---|
|
||||
| `./tasks/` | `/workspace/tasks` | 每个会话的工作目录 |
|
||||
| `./data/` | `/workspace/data` | SQLite `.agent.db`、`prompt.txt` 调试产物 |
|
||||
| `./skills/` | `/workspace/skills` | 技能与共享依赖 |
|
||||
| `./config.yml` | `/app/config.yml` | core 配置 |
|
||||
| `./wxbot/data/` | `/data` | 微信登录凭证 |
|
||||
|
||||
备份至少覆盖 `data/`、`tasks/`、`config.yml`;需要保留微信登录态时再备份 `wxbot/data/`。
|
||||
|
||||
### 升级
|
||||
## 升级
|
||||
|
||||
```bash
|
||||
git pull
|
||||
docker compose up -d --build
|
||||
```
|
||||
|
||||
数据库与任务目录都在 bind mount 中,升级不丢数据。进程重启时,执行中的回合会被打断;`active` 会话会归位为保持中,用户再发消息即可继续。
|
||||
数据在 `data/`、`tasks/` 和 `config.yml` 里,升级不受影响。
|
||||
|
||||
> 从旧的「agent + mcp 双仓库」部署升级:旧 mcp 容器占着 `agent-mcp-net` 和同名 `container_name`,需先停旧栈再 `up` 本栈,否则会报 `network agent-mcp-net has active endpoints` 或 `container name ... is already in use`。旧仓库的 `down` 只需执行一次:
|
||||
>
|
||||
> ```bash
|
||||
> cd /root/workspace/tools/mcp && docker compose down
|
||||
> cd /root/workspace/tools/agent && docker compose up -d --build
|
||||
> ```
|
||||
>
|
||||
> 微信服务已改名为 `agent-wxbot`(原容器名 `wxbot`)。旧容器不受新 compose 管理,升级后需手动清理,否则两个实例会同时轮询同一个微信号:`docker rm -f wxbot`。
|
||||
## 安全
|
||||
|
||||
### 日志与健康检查
|
||||
- 对外只开 agent-core 一个端口,其余服务只在 Docker 内网
|
||||
- 隧道只经服务器 nginx(TLS)对外,宿主机端口仅绑 `127.0.0.1`;`server.yml` 与 `client.yml` 的 token 必须一致
|
||||
- 命令在 executor 容器里执行,只挂当前会话目录,根文件系统只读
|
||||
- 单租户设计:除管理员接口外不做用户级资源隔离,不要开放给互不信任的人
|
||||
- `config.yml`、`.env`、`wxbot/data/` 存密钥,已加入 `.gitignore`
|
||||
|
||||
```bash
|
||||
docker compose logs -f agent-core
|
||||
docker compose logs -f agent-executor
|
||||
docker compose logs -f agent-wxbot
|
||||
curl -s http://127.0.0.1:8090/api/health
|
||||
# {"ok":true,"service":"agent-core","api":1,"time":...,"auth_required":true}
|
||||
```
|
||||
## License
|
||||
|
||||
- `GET /api/health` 是**唯一免登录接口**,供运维探活,也供套壳 App 校验用户手填的服务器地址。
|
||||
客户端判定条件:HTTP 200 且 `ok === true` 且 `service === 'agent-core'`——**不要只看状态码**,
|
||||
填错到别的站点或反代首页同样可能回 200。地址末尾的 `/` 可带可不带。
|
||||
`auth_required` 用于区分「地址对了但没登录」与「地址错了」。
|
||||
|
||||
- core 日志等级由 `config.yml` 的 `log_level` 控制,改完重启生效。
|
||||
- executor / wxbot 的日志等级由各自环境变量控制,`debug` 会打印完整交互。
|
||||
- 启动时会在 `data/prompt.txt` 写入实际下发的 system prompt 与各 profile 的工具清单,便于核对。
|
||||
|
||||
### 常见问题
|
||||
|
||||
| 现象 | 原因 / 处理 |
|
||||
|---|---|
|
||||
| 启动时报 `network agent-mcp-net has active endpoints` | 旧的双仓库部署残留:先停旧的 mcp 仓库(`docker compose down`),再 `up` 本栈 |
|
||||
| 套壳 App 填了服务器地址仍连不上 | 先 `curl <地址>/api/health` 看是否返回 `service:agent-core`;再查 Android 9+ 默认禁止明文 HTTP(需 `usesCleartextTraffic`)与 https 自签证书 |
|
||||
| 麦克风按钮不显示 | `config.yml` 的 `mcp_servers` 里没有启用的 `asr` 段 / 该段缺 `X-ASR-Base-Url`(`GET /api/asr/status` 会返回 `reason`);或浏览器以 `http://<IP>` 访问且没有原生录音桥(非安全上下文开不了麦,见 `docs/voice-input.md`) |
|
||||
| 点麦克风提示「语音识别服务不可用」 | `mcp_asr` 未起来(`docker compose logs --tail=50 mcp_asr`);或 `config.yml` 的 `asr.headers` 缺 `X-ASR-Base-Url` / `X-ASR-Model` |
|
||||
| `config.yml` 变成目录 | 启动前文件不存在,Docker 自动建了同名目录;重跑 `./scripts/init.sh` 会自动删除空目录并重建(非空目录需先备份再手工删除) |
|
||||
| 没有可用模型 | `platforms` 为空或模型全部禁用;在设置页添加后重启 |
|
||||
| 创建会话报「无可用模型」 | 模型池为空,或指定模型所在平台没有 key |
|
||||
| 技能依赖缺失 | 重新 `docker compose up -d --build agent-executor`;或检查 `skills/deps` |
|
||||
| 微信设置页显示未连接 | wxbot 未启动,或 `WXBOT_TOKEN` 两侧不一致 |
|
||||
| 图生视频拉不到参考图 | `public_link.base_url` 未配置,或公网不可达 |
|
||||
| 启动日志出现 `xxx 工具发现失败` | 当时服务未就绪,core 会按 2s/20s/1min 重试 3 次;仍失败则重启 `agent-core` |
|
||||
|
||||
---
|
||||
|
||||
## 目录
|
||||
|
||||
```text
|
||||
agent/
|
||||
├── app/ agent-core:Express + SQLite + 前端静态资源
|
||||
├── executor/ agent-executor:隔离命令执行与 Office 预览网关
|
||||
├── wxbot/ 微信 iLink 协议调制解调器
|
||||
├── mcp/ 同栈 MCP 服务:web_search / image_task / video_task
|
||||
├── skills/ 技能目录
|
||||
├── tasks/ 会话工作目录(运行时生成)
|
||||
├── data/ SQLite 与调试产物(运行时生成)
|
||||
├── docs/ 专题文档
|
||||
├── docker-compose.yml
|
||||
└── scripts/init.sh
|
||||
```
|
||||
|
||||
进一步阅读:
|
||||
|
||||
- [mcp/README.md](mcp/README.md):同栈 MCP 服务(搜索 / 生图 / 生视频)。
|
||||
- [docs/OFFICE.md](docs/OFFICE.md):Office 文档技能与预览链路。
|
||||
- [docs/tool-design.md](docs/tool-design.md):工具接口设计规范。
|
||||
|
||||
## 开发
|
||||
|
||||
```bash
|
||||
cd app
|
||||
npm install
|
||||
node server/server.js
|
||||
```
|
||||
AGPL-3.0,见 [LICENSE](LICENSE)。
|
||||
|
||||
+46
-12
@@ -51,7 +51,7 @@ AGENT_CONFIG=./config.yml node server/server.js
|
||||
| `server/wechat.js` | 微信绑定、媒体落盘、上下文注入、SSE→微信分段投递、任务通知 |
|
||||
| `server/routes/channel.js` | 文本命令层(`/new` `/switch` `/think` …),微信与外部接入端共用 |
|
||||
| `server/routes/*.js` | HTTP API,按资源分文件 |
|
||||
| `server/sse.js` | 按会话分组的 SSE 总线(`addClient`/`emit`/`onInternal`) |
|
||||
| `server/sse.js` | 按会话分组的 SSE 总线(`addClient`/`emit`/`onInternal`);`assistant_delta` / `reasoning_delta` / `tool_call_args` 攒 50ms 或 8 条合并写入 |
|
||||
| `server/auth.js` | HMAC cookie 登录、Basic 兜底、`requireAdmin`、免认证路径 |
|
||||
| `server/memory.js` | 长期记忆(日记碎片)读写与检索,仅依赖 `time.js` |
|
||||
| `server/time.js` | 业务时区单一入口:`TZ`、`dayString`、`stampString`、`fmtTime`、`fmtIso` |
|
||||
@@ -62,7 +62,7 @@ AGENT_CONFIG=./config.yml node server/server.js
|
||||
| `server/log.js` | 分级日志 `log.debug/info/warn/error(category, ...)` |
|
||||
| `server/balance.js` | 平台余额查询适配器(按 `platform.type` 分发) |
|
||||
| `server/version.js` | git commit/date:优先读 `version.json`(post-commit 钩子生成),宿主机有 git 时兜底 `git rev-parse`;页面版本号另外由 `routes/system.js` 的 `VERSION` 字面量决定 |
|
||||
| `server/templates/` | system prompt 模板、压缩/标题指令、profile prompt |
|
||||
| `server/templates/` | system prompt 模板、环境段(按部署形态二选一)、压缩/标题指令、profile prompt |
|
||||
|
||||
## 一次用户消息的生命周期
|
||||
|
||||
@@ -103,10 +103,15 @@ POST /api/sessions/:id/messages
|
||||
|
||||
| 模式 | 入口 | 行为 |
|
||||
|---|---|---|
|
||||
| `queue`(默认) | 运行中点发送 | 本轮 `finalize` 后作为新回合的第一条消息发出 |
|
||||
| `interject`(干预) | 条幅「干预」 | 当前工具跑完(或本条回复落库)后,闭合批次、就地插话,同一回合继续 |
|
||||
| `queue`(默认) | 网页端运行中点发送 | 本轮 `finalize` 后作为新回合的第一条消息发出 |
|
||||
| `interject`(干预) | 条幅「干预」/ **IM 渠道消息** | 当前工具跑完(或本条回复落库)后,闭合批次、就地插话,同一回合继续 |
|
||||
| `now`(立即发送) | 条幅「立即发送」 | 杀进程 + abort 流,本回合判 `cancelled`,收尾后立刻发 |
|
||||
|
||||
微信 / `POST /api/channel/send` 的普通消息走 `enqueueMessage(..., {mode:'interject'})`:
|
||||
IM 用户在实时对话,回合中插话应当“当前这步跑完就插”,不排队等本轮结束;且**必须走队列**
|
||||
(旧的直接 `postUserMessage` 会把 user 行插进工具批次中间)。`interject` 入队时插到所有
|
||||
`queue` 之前(已在队列里的 interject 仍保持先来后到),这样它立刻成为队首,边界检查才能命中。
|
||||
|
||||
**铁律:队列里的消息绝不先落 `messages` 表。** 只在安全边界写库——① 工具批次闭合
|
||||
(本批每个 `tool_call_id` 都有回执);② 无 `tool_calls` 的回复已落库;③ 回合 finalize。
|
||||
否则 `user` 行会夹在 `assistant.tool_calls` 与 `tool` 回执之间,或批次没闭合就收尾,
|
||||
@@ -114,7 +119,10 @@ POST /api/sessions/:id/messages
|
||||
|
||||
- `closeToolBatch(sessionId, reason)` 是配对兜底的唯一写入口:给最后一条带 `tool_calls` 的
|
||||
assistant 里缺回执的调用补一条 `is_error=1` 的合成 tool 行(「用户介入/终止,本次调用未执行」)。
|
||||
`finalize` 无条件调一次,取消路径与干预路径各调一次。
|
||||
`finalize` 无条件调一次,取消路径与干预路径各调一次。广播的 `tool_result` 带 `skipped:true`,
|
||||
微信端据此显示「N 次因你介入未执行」。
|
||||
- **微信端不下发任何工具失败**(即使 `is_error=true`):多数是模型参数用错、下一轮自己会改,
|
||||
推给用户既看不懂也帮不上忙;要交代就由模型自己的回复说。失败仍完整保留在库里与网页端工具卡上。
|
||||
- 读侧还有一层纯过滤(`llm.buildMessages` 的 `pairedByAssistant` / `emittedCallIds`):只下发
|
||||
「本批(紧邻的连续 tool 行)确有回执」的调用,孤儿回执也不下发。DB/UI 不动,专门兜历史脏数据。
|
||||
- `stop()`(用户点「停止」)**会清空队列**(全停语义);「立即发送」不走 `stop`,只中断当前回合、保留队首。
|
||||
@@ -154,7 +162,7 @@ POST /api/sessions/:id/messages
|
||||
|
||||
`buildMessages(session, language, mintUrl, profile)` 的输出顺序固定:
|
||||
|
||||
1. `system`:模板(`profile-default.txt` 或 profile 自定义 prompt)+ 技能清单段 + 语言指令;
|
||||
1. `system`:模板(`profile-default.txt` 或 profile 自定义 prompt)+ 环境段 + 技能清单段 + 语言指令;
|
||||
进程内按 `(profile, language)` 缓存,保证前缀缓存稳定。
|
||||
2. 画像快照(`sessions.profile_snapshot`,建会话/清空时冻结):作为首条 `user`。**不在 messages 表里**,
|
||||
压缩与归档碰不到它。
|
||||
@@ -182,8 +190,16 @@ POST /api/sessions/:id/messages
|
||||
- 重读去重(engine `run.imgDelivered`)**只拦同一批 tool call 内的重复读**(一次请求里塞两份同样的图
|
||||
没意义);跨批次重读一律放行。不要写成「一回合只投递一次」,也不要靠推测「图还在不在上下文里」——
|
||||
模型说拿不到就得给,而且文件可能已重新生成(路径相同、内容不同);拦掉只会把新像素挡在门外。
|
||||
- 占位裁剪(`agent.trim_write_rounds` / `trim_result_rounds`):距尾 ≥N 个 assistant 轮的
|
||||
`write_file.content`、`fetch`/`read_file` 回执换成单行占位。**只改发给上游的副本**,DB 与 UI 不动。
|
||||
- 占位裁剪(`agent.trim.rules`):指定工具的参数(`side: args` + `fields`,仅顶层字符串)或回执正文
|
||||
(`side: result`)在满足**两个距离条件**时换成单行占位:`rounds` = 其后又有几条 assistant 行
|
||||
(「后面 AI 又说了几句话」)、`turns` = 其后又有几条真人消息(`role=user` 且 `type` 为空,
|
||||
「后面又来了几条真人消息」)。两者是 AND,同时满足才裁;`turns: 1` = 回合内绝不裁、跨过用户
|
||||
回合边界才裁——`fetch` / `read_file` / `web_search` 默认都配了它(否则长回合里模型会把同一段
|
||||
反复重读,实测有回合重读同一文件 24 次);`write_file` 的参数只是快照,只配 `rounds: 1`。
|
||||
默认规则在 `config.js` 的 `DEFAULTS.agent.trim.rules`(唯一来源),`config.yml` 写了 `trim.rules`
|
||||
就整体替换(`[]` = 全关)。**只改发给上游的副本**,DB 与 UI 不动。规则只给「内容可再生或
|
||||
只是当时快照」的工具配:`terminal` 这类一次性输出裁掉后模型就再也看不到
|
||||
(规则写法与示例见 `config.example.yml` 的 `agent.trim`)。
|
||||
- `compressMessages` = `buildMessages` + 末尾一条压缩指令 `user`。**铁律**:压缩请求必须与上一次
|
||||
常规请求字节同构、只在尾部追加;不要为了省 token 在压缩回合抽掉快照或裁剪历史,断前缀缓存等于全价重读。
|
||||
- `titleMessages`:不带 system prompt,只取 user/assistant 纯文本行(白名单 `null`/`summary`/`task_brief`)
|
||||
@@ -195,6 +211,11 @@ POST /api/sessions/:id/messages
|
||||
`{content, reasoning, tool_calls, finish_reason, usage, aborted, sseFrames}`;正文开头混入的
|
||||
`<think>` 块会被 `splitInlineThinking` 剥离到 reasoning。
|
||||
|
||||
增量上下文(模型配了 `store: true` 且带 `opts.context_id`):只发上次之后新增的消息,带
|
||||
`X-Context-Id` / `X-Context-Hash`;relay 回 409 说明缓存对不上(压缩、relay 重启、TTL 过期),
|
||||
改发全量重试**一次**。指针存 `ctxState`(进程内存,只存 hash + 条数),进程重启即失效 →
|
||||
下一轮自动全量。上游仍然是全量,语义不变。
|
||||
|
||||
## 工具层
|
||||
|
||||
- 工具全集 = `definitions.json`(14 个内置)+ MCP 发现结果;再依次叠 profile 的 `tools_allow`
|
||||
@@ -207,10 +228,17 @@ POST /api/sessions/:id/messages
|
||||
`disable` 连 `tools/list` 都不发。旧字段 `enable` 已废弃,`mode: silent` 已移除,
|
||||
出现即报配置错(不静默忽略)。
|
||||
- `executeTool(baseCtx, name, args)`:先查 `HANDLERS` 表,未命中再交给 MCP 注册表。
|
||||
`ctx = {sessionId, taskDir, run, cfg, db, vision}`;工具返回字符串,`read_file` 读图时返回
|
||||
`ctx = {sessionId, taskDir, workDir, run, cfg, db, vision}`;工具返回字符串,`read_file` 读图时返回
|
||||
`{text, image_rel}`(`text` 是结构化 JSON 回执,由 engine 转成 `image_ref` 块)。
|
||||
`workDir` = 会话手选的工作目录(本地端新建会话可选),空串时 `taskDir` 就是默认的
|
||||
`workspace_root/<会话id>`。
|
||||
- **路径沙箱**:所有路径经 `resolveInTask` 解析到 `taskDir` 内;`/tmp` 会被映射到
|
||||
`<taskDir>/.tmp`(与 executor 容器里 `/tmp` 的 bind 对齐)。符号链接越界一律拒绝。
|
||||
例外:`AGENT_FILE_SCOPE=workspace`(本地端 `local/start.sh` 注入)把业务工具的根放宽到
|
||||
`workspace_root`,且 `/tmp` 不重写、直接放行(本地 terminal 写的是真 `/tmp`);
|
||||
会话若手选了目录(`sessions.work_dir` 非空),业务工具与文件 API 的根都取那个真实目录
|
||||
(`fsRoot` 优先返回 `ctx.workDir`),且不再创建 `task-*` 子目录;
|
||||
路由层(文件 API / 公网短链 / data-page)与 `@会话` 仍按 `taskDir` 校验,不随之外扩。
|
||||
- **跨会话只读**:`@<session-id>/<rel>` 只允许 `list_directory`、`read_file`、`copy_path` 的
|
||||
`source_path`,且只限同一用户的会话。写侧显式拒绝——否则会造出字面 `@task-x` 目录。
|
||||
- `checkToolArgs` + `unwrapToolArgs`:前者做结构性预检并生成 `errAck`,后者按 schema 逐层剥掉
|
||||
@@ -222,8 +250,9 @@ POST /api/sessions/:id/messages
|
||||
get/run 指认技能,`args` 仅 run 用;条件必填写不进 schema,由 `toolSkill` 校验并点名。
|
||||
`toolSkill` 在入口把旧字段名 `input_args` 归一化成 `args`,之后只走一条分派路径
|
||||
(曾有两条路径,其中一条只读 `input_args`,会静默丢参)。
|
||||
`input_schema.required` 在 `run` 前校验;相对路径参数按会话目录转绝对路径;入口一律用绝对路径
|
||||
(远端 cwd 是会话目录)。配了 executor 就走 `remote-exec`,否则本地 `spawn`。
|
||||
`input_schema.required` 在 `run` 前校验;相对路径参数按会话目录转绝对路径;入口一律用绝对路径,
|
||||
cwd 也一律是会话目录(本地 spawn 与远端一致,否则按 cwd 干活的技能会写到技能目录里)。
|
||||
配了 executor 就走 `remote-exec`,否则本地 `spawn`。
|
||||
模型可见的技能清单是 `listCallableSkills`(目录技能 + `mode=skill` 的 MCP 工具,同名时目录胜出);
|
||||
设置页的技能 API 仍只用 `listSkills`(按目录增删改),两者不要混用。
|
||||
mode=skill 的 MCP 技能在 `runSkill` 里位于 `absolutizeArgs` **之前**:直接 `mcp.callTool` 转发
|
||||
@@ -330,6 +359,8 @@ preview-proxy.mount(末尾兜底)
|
||||
JS/CSS 改动不需要。
|
||||
- 另有 `login.html`、`memory.html`(日记调试页)。
|
||||
- API 调用统一走 `core.js` 的 `req()`;SSE 用 `EventSource` + 前端看门狗。
|
||||
- 文件面板(`files.js`)按目录懒加载:只请求 `GET /api/sessions/:id/tree?dir=<rel>` 的当前层,
|
||||
进入子目录才拉下一层;会话详情接口不返回全量 `files`。
|
||||
|
||||
## 扩展指南
|
||||
|
||||
@@ -363,7 +394,10 @@ preview-proxy.mount(末尾兜底)
|
||||
|
||||
**改 prompt / profile**
|
||||
|
||||
- 默认 prompt:`templates/profile-default.txt`(`{APP_SKILLS_SECTION}` 占位技能清单)。
|
||||
- 默认 prompt:`templates/profile-default.txt`(`{APP_SKILLS_SECTION}` 占位技能清单,
|
||||
`{APP_ENV_SECTION}` 占位环境段)。
|
||||
- 环境段:`templates/env-server.txt`(executor 容器形态)/ `env-local.txt`(本机 spawn 形态),
|
||||
启动时按 `EXECUTOR_URL` 有无选定(`server.js` 的 `llm.setEnvMode`),改完重启。
|
||||
- 压缩/标题指令:`templates/prompt-compress.txt` / `prompt-title.txt`。
|
||||
- 自定义组合:`config.yml` 的 `model_profiles` + 模型的 `profile: <名>`;改完重启。
|
||||
|
||||
|
||||
@@ -2,6 +2,22 @@ FROM node:20-slim
|
||||
|
||||
ENV TZ=Asia/Shanghai
|
||||
|
||||
# git:Git 面板(提交历史 / 未提交改动)要读仓库,本机与容器共用同一条代码路径。
|
||||
# 国内构建慢:apt 默认源在国外,apt-get update 能卡十几分钟。默认换成腾讯云镜像(与 executor 同源)。
|
||||
# 境外构建或想换源:docker compose build --build-arg DEBIAN_MIRROR=deb.debian.org
|
||||
ARG DEBIAN_MIRROR=mirrors.cloud.tencent.com
|
||||
|
||||
# 换 apt 源:bookworm 可能是 /etc/apt/sources.list,也可能是 deb822 的 /etc/apt/sources.list.d/*.sources,
|
||||
# 直接 grep 扫一遍、只替换域名,两种格式都盖住(路径 /debian、/debian-security 保持不变)。
|
||||
RUN set -eux; \
|
||||
files="$(grep -rl 'deb.debian.org' /etc/apt/ 2>/dev/null || true)"; \
|
||||
if [ -n "$files" ]; then sed -i "s|deb.debian.org|${DEBIAN_MIRROR}|g" $files; fi
|
||||
|
||||
# 装完清 apt 列表,不给镜像多留几十 MB。
|
||||
RUN apt-get update \
|
||||
&& apt-get install -y --no-install-recommends git \
|
||||
&& rm -rf /var/lib/apt/lists/*
|
||||
|
||||
WORKDIR /app
|
||||
|
||||
# 国内构建慢:npm 默认源在国外。默认换成腾讯云 npm 镜像(与宿主机 ~/.npmrc 一致)。
|
||||
|
||||
+38
-3
@@ -46,9 +46,44 @@ agent:
|
||||
max_tool_iterations: 100 # 单轮最大迭代数(含工具调用)
|
||||
max_retries: 2 # 上游失败重试次数
|
||||
language: "Simplified Chinese" # 强制回复语言;留空不限
|
||||
auto_compress_tokens: 60000 # In token 超此值弹「自动压缩」提议;0=关
|
||||
trim_write_rounds: 1 # 历史重放裁剪:write_file 参数正文距尾 ≥N 个 assistant 轮换单行占位(0=关;DB/UI 不动,盘上可重读)
|
||||
trim_result_rounds: 2 # fetch/read_file 回执正文距尾 ≥N 个 assistant 轮换单行占位(0=关;占位留 url/path 作恢复指针)
|
||||
auto_compress_tokens: 0 # In token 超此值弹「自动压缩」提议;0=关(默认关)
|
||||
# 历史重放占位裁剪(省 token):把「可再生的重负载」换成单行占位再发给上游
|
||||
#(DB/UI 不动,盘上可重读/重抓)。两个距离条件**同时满足**才裁:
|
||||
# rounds = 这一行之后又出现了几条 AI 回复 (「后面 AI 又说了几句话」)
|
||||
# turns = 这一行之后又来了几条真人消息 (「后面又来了几条真人消息」;注入行不算)
|
||||
#
|
||||
# 举例(rounds: 2 + turns: 1):
|
||||
# 回合1:读① → 读② → 改③ → 「改好了」
|
||||
# 回合2 第 1 句请求:①② 已过 2 条 AI 回复 + 1 条真人消息 → 裁成占位;
|
||||
# ③ 只过了 1 条 AI 回复 → 留着
|
||||
# 回合2 第 2 句请求:③ 也过了 2 条 → 裁
|
||||
# 也就是说:回合内绝不会裁,回合结束后开始清;想「新回合第一句就清光」把 rounds 改成 1。
|
||||
#
|
||||
# rounds 与 turns 都写 0(或不写)= 该条规则关闭;整段 rules: [] = 全关。
|
||||
# side=args 裁调用参数(fields 点名顶层字符串参数);side=result 裁整段回执正文。
|
||||
# tool 用模型看到的最终工具名(MCP 重名时含 server__ 前缀)。
|
||||
# 下面就是内置默认(与 config.js 的 DEFAULTS.agent.trim.rules 同步);写了本段就整体替换默认。
|
||||
trim:
|
||||
min_chars: 600 # 短于此长度的正文不裁(占位自身也有成本);单条规则可用 min_chars 覆盖
|
||||
rules:
|
||||
- tool: write_file # 参数正文只是写盘时的快照,后续 edit_file 一次就失真
|
||||
side: args
|
||||
fields: [content]
|
||||
rounds: 1
|
||||
turns: 0 # 不带 turns:回合内也照裁(省的是每轮重发整个文件)
|
||||
- tool: fetch # 页面可重抓;status_regex 取第一个捕获组写进占位(YAML 用单引号,避免 \d 被当转义)
|
||||
side: result
|
||||
rounds: 2
|
||||
turns: 1 # 回合内不裁(否则同一 URL 会被反复重抓),跨回合后按 rounds 清
|
||||
status_regex: '^HTTP (\d{3})'
|
||||
- tool: read_file # 文件在盘上,可重读
|
||||
side: result
|
||||
rounds: 2
|
||||
turns: 1 # 回合内不裁(否则长回合里模型会反复重读同一段)
|
||||
- tool: web_search # 栈内免费搜索 MCP;可重搜,但结果会随时间变化
|
||||
side: result
|
||||
rounds: 2
|
||||
turns: 1 # 同上;现在回执默认不截断,单条可能上万字
|
||||
auto_complete_ms: 1800000 # 保持中(held)超此时长自动收口为已完成;0=关(纯状态动作,历史/模型绑定不动)
|
||||
|
||||
# 长期记忆(日记,memory.js):收口时一条几十字第一人称碎片入当日条目;存储默认永久,旧记忆靠回忆下钻
|
||||
|
||||
Generated
+179
-157
File diff suppressed because it is too large
Load Diff
+2
-1
@@ -1,6 +1,6 @@
|
||||
{
|
||||
"name": "agent-app",
|
||||
"version": "2.4.0",
|
||||
"version": "2.5.0",
|
||||
"description": "自用通用 Agent 系统:多模型调度 + 任务目录 + 工具调用 + H5 Web UI",
|
||||
"main": "server/server.js",
|
||||
"scripts": {
|
||||
@@ -13,6 +13,7 @@
|
||||
"multer": "1.4.5-lts.1",
|
||||
"sharp": "0.35.4",
|
||||
"turndown": "7.2.0",
|
||||
"ws": "^8.23.0",
|
||||
"yaml": "2.6.1"
|
||||
}
|
||||
}
|
||||
|
||||
+9
-1
@@ -104,6 +104,12 @@ function createAuth(cfg) {
|
||||
let users = (cfg.auth && cfg.auth.users) || [];
|
||||
if (!users.length) {
|
||||
// 未启用认证 = 单用户自用:管理接口按「本机主人」放行,用户 CRUD 由 routes/users.js 自己拒绝。
|
||||
// /api/me 在关闭分支里也必须存在:前端靠它一次请求判定形态(auth:false = 未启用),
|
||||
// 若这里不注册,本地模式(无认证)下浏览器网络面板会永远挂着一条红色 404,
|
||||
// 也无法区分「路由不存在」和「cookie 失效」——后者才该跳登录页。
|
||||
router.get('/api/me', (req, res) => {
|
||||
res.json({ user: null, role: 'admin', model: '', auth: false });
|
||||
});
|
||||
return {
|
||||
enabled: false,
|
||||
middleware: (req, res, next) => next(),
|
||||
@@ -232,7 +238,9 @@ function createAuth(cfg) {
|
||||
// 与中间件同一解析顺序(cookie 优先),保证 /api/me 显示的用户与业务路由认定的用户一致
|
||||
const name = authUser(req);
|
||||
const row = name ? userRow(name) : null;
|
||||
res.json({ user: name, role: row ? row.role : '', model: row ? (row.model || '') : '' });
|
||||
// auth:true 让前端明确区分「启用了认证但当前无登录」(user:null → 跳登录)
|
||||
// 与「根本没启用认证」(auth:false → 单用户自用)这两种 user:null。
|
||||
res.json({ user: name, role: row ? row.role : '', model: row ? (row.model || '') : '', auth: true });
|
||||
});
|
||||
|
||||
// ----- 登录页 / 登出跳转 -----
|
||||
|
||||
+106
-4
@@ -83,12 +83,31 @@ const DEFAULTS = {
|
||||
// allow_private=false 开 SSRF 防护:目标主机名解析到回环/私有/链路本地地址即拒绝(重定向逐跳复查);
|
||||
// 确需抓内网服务再显式开 true(注意 DNS 重绑定属残余风险)。
|
||||
fetch: { timeout_ms: 30000, max_bytes: 1048576, max_chars: 12000, max_chars_hard: 64000, allow_private: false },
|
||||
// auto_compress_tokens:本轮 In token 峰值 ≥ 此值时推送「自动压缩」提议(0=关)。
|
||||
// auto_compress_tokens:本轮 In token 峰值 ≥ 此值时推送「自动压缩」提议(0=关,默认关)。
|
||||
// auto_complete_ms:held(保持中)超过此时长自动收口为 completed(0=关)。key 非独占后 held 不占任何资源,
|
||||
// 收口是纯视觉动作:历史/绑定不动,再发言照常由 completed 分支续跑(见 engine.sweepHeldTimeouts)。
|
||||
// trim_write_rounds / trim_result_rounds:历史重放占位裁剪(llm.buildMessages)——write_file 参数正文 /
|
||||
// fetch、read_file 回执正文距尾 ≥N 个 assistant 轮后换单行占位(DB/UI 不动,内容可再生:盘上重读/重抓);0=关。
|
||||
agent: { temperature: 1.0, max_tool_iterations: 100, max_retries: 2, language: 'Simplified Chinese', auto_compress_tokens: 60000, auto_complete_ms: 1800000, trim_write_rounds: 1, trim_result_rounds: 2 },
|
||||
// 历史重放占位裁剪(llm.buildMessages):trim.rules 逐条声明「哪个工具、参数侧还是回执侧、
|
||||
// 距尾多远换单行占位」;只改发给上游的副本,DB/UI 不动。
|
||||
// 两个距离条件**同时满足**才裁:
|
||||
// rounds = 这一行之后又出现了几条 assistant 行(「后面 AI 又说了几句话」)
|
||||
// turns = 这一行之后又来了几条真人消息(role=user 且 type 为空,「后面又来了几条真人消息」)
|
||||
// 所以 turns:1 = 回合内绝不裁、跨过用户回合边界才裁(避免长回合里模型反复重读同一个文件)。
|
||||
// 这里是默认策略的唯一来源:config.yml 写了 trim.rules 就整体替换(写 [] = 全关)。
|
||||
agent: { temperature: 1.0, max_tool_iterations: 100, max_retries: 2, language: 'Simplified Chinese', auto_compress_tokens: 0, auto_complete_ms: 1800000, trim: {
|
||||
min_chars: 600,
|
||||
rules: [
|
||||
// 参数正文只是写盘时的快照:不带 turns,回合内也照裁(省的是每轮重发整个文件)
|
||||
{ tool: 'write_file', side: 'args', fields: ['content'], rounds: 1 },
|
||||
// 回执可再生(页面可重抓 / 文件可重读 / 可重搜):turns:1 保证同一回合内不裁,回合结束后按 rounds 兜底
|
||||
{ tool: 'fetch', side: 'result', rounds: 2, turns: 1, status_regex: '^HTTP (\\d{3})' },
|
||||
{ tool: 'read_file', side: 'result', rounds: 2, turns: 1 },
|
||||
{ tool: 'web_search', side: 'result', rounds: 2, turns: 1 },
|
||||
// terminal 输出占了会话上下文的大头(实测 69%),但单条都不大(最大 10KB),
|
||||
// 所以阈值降到 1500(实测拐点:>1500 裁 43%,>2000 只裁 33%)。
|
||||
// rounds:5 比其它规则更晚动手——terminal 输出经常还要回头看;turns:2 保证当前回合绝不裁。
|
||||
{ tool: 'terminal', side: 'result', rounds: 5, turns: 2, min_chars: 1500 },
|
||||
],
|
||||
} },
|
||||
// 大图上传预处理(浏览器端 canvas 压缩,参数经 /api/system/status 下发前端)。
|
||||
// paste_to_file_threshold_chars:粘贴文本超过该字符数时前端转成 .txt 附件,0 = 关闭。
|
||||
upload: { image_compress_threshold_kb: 1536, image_max_dim: 2000, image_quality: 0.85, confirm_size_mb: 10, paste_to_file_threshold_chars: 2000 },
|
||||
@@ -221,6 +240,12 @@ function normalizePlatforms(rawPlatforms, profileNames) {
|
||||
// 非空时发请求前给历史 assistant 行挂该字段;空(缺省)= 不回传。纯发送侧旋钮,
|
||||
// 与接收解析无关(接收早已兼容 reasoning/reasoning_content 双名)。
|
||||
reasoning_ack_field: typeof m.reasoning_ack_field === 'string' ? m.reasoning_ack_field.trim() : '',
|
||||
// 选填:该模型的请求走增量上下文(context relay),只有配合 relay 生效。
|
||||
// 不配 = 每轮重传全量,和以前完全一样。
|
||||
store: m.store === true,
|
||||
// 选填:自动压缩阈值(用户自定义的「上下文用量线」,**不是**模型真实窗口)。
|
||||
// 回合内 In token 峰值达到它即自动压缩上下文(见 engine.runLoopInner 循环顶部);0/未配 = 不启用。
|
||||
max_context: Math.max(0, parseInt(m.max_context, 10) || 0),
|
||||
profile,
|
||||
});
|
||||
}
|
||||
@@ -236,10 +261,85 @@ function normalizePlatforms(rawPlatforms, profileNames) {
|
||||
return out;
|
||||
}
|
||||
|
||||
// ---------- 历史重放的重负载占位裁剪(agent.trim) ----------
|
||||
// 语义:某条工具调用/回执距对话尾部 ≥rounds 个 assistant 轮、且 ≥turns 个真人回合后,
|
||||
// 把其中「可再生的重负载」换成单行占位再发给上游(llm.buildMessages;DB/UI 不动)。
|
||||
// rounds = 「后面 AI 又说了几句话」;turns = 「后面又来了几条真人消息」(type 为空的 user 行)。
|
||||
// 两者同时满足才裁。只该给「内容可再生或只是当时快照」的工具开:read_file/fetch 能重读重抓、write_file 参数
|
||||
// 只是快照;terminal 输出是一次性的,裁掉模型就永久看不到了。
|
||||
const TRIM_RULE_KEYS = new Set(['tool', 'side', 'rounds', 'turns', 'fields', 'min_chars', 'status_regex']);
|
||||
|
||||
function toNonNegInt(v, d) {
|
||||
const n = Math.floor(Number(v));
|
||||
return Number.isFinite(n) ? Math.max(0, n) : d;
|
||||
}
|
||||
|
||||
// 单条规则校验:未知字段直接报错(拼错静默忽略 = 以为省了 token 其实没省)。
|
||||
function normalizeTrimRule(r, i, defMinChars) {
|
||||
const at = 'agent.trim.rules[' + i + ']';
|
||||
if (!r || typeof r !== 'object' || Array.isArray(r)) throw new Error(at + ' 必须是对象');
|
||||
for (const k of Object.keys(r)) {
|
||||
if (!TRIM_RULE_KEYS.has(k)) {
|
||||
throw new Error(at + ' 含未知字段:' + k + '(可用:' + Array.from(TRIM_RULE_KEYS).join(' / ') + ')');
|
||||
}
|
||||
}
|
||||
const tool = String(r.tool == null ? '' : r.tool).trim();
|
||||
if (!tool) throw new Error(at + ' 缺少 tool(填模型看到的最终工具名,MCP 重名时含 server__ 前缀)');
|
||||
const side = String(r.side == null ? '' : r.side).trim();
|
||||
if (side !== 'args' && side !== 'result') {
|
||||
throw new Error(at + '.side 只能是 args(裁调用参数)/ result(裁回执正文),收到:' + side);
|
||||
}
|
||||
// rounds / turns 都是「距尾多远」,同时满足才裁;两个都写 0(或不写)= 该条规则关闭,直接丢掉,不留空规则。
|
||||
const rounds = toNonNegInt(r.rounds, 0);
|
||||
const turns = toNonNegInt(r.turns, 0);
|
||||
if (rounds <= 0 && turns <= 0) return null;
|
||||
const out = { tool, side, rounds, turns, min_chars: toNonNegInt(r.min_chars, defMinChars) };
|
||||
if (side === 'args') {
|
||||
if (!Array.isArray(r.fields) || !r.fields.length) {
|
||||
throw new Error(at + '(args 侧)必须配 fields 数组(要占位的顶层参数名,如 [content])');
|
||||
}
|
||||
out.fields = r.fields.map(x => String(x).trim()).filter(Boolean);
|
||||
if (!out.fields.length) throw new Error(at + '(args 侧)fields 不能为空');
|
||||
} else if (r.fields !== undefined) {
|
||||
throw new Error(at + '.fields 只适用于 args 侧(result 侧整段正文替换,无需点名字段)');
|
||||
}
|
||||
if (r.status_regex !== undefined && r.status_regex !== null && String(r.status_regex).trim()) {
|
||||
if (side !== 'result') throw new Error(at + '.status_regex 只适用于 result 侧');
|
||||
const src = String(r.status_regex);
|
||||
try { new RegExp(src); } catch (_) { throw new Error(at + '.status_regex 不是合法正则:' + src); }
|
||||
out.status_regex = src;
|
||||
}
|
||||
return out;
|
||||
}
|
||||
|
||||
// agent.trim 归一:默认值来自 DEFAULTS.agent.trim.rules(唯一来源),config.yml 写了 rules
|
||||
// 就整体替换([] = 全关)。归一结果直接写回 cfg.agent.trim.rules,不再另造 trim_rules 键。
|
||||
function normalizeAgentTrim(cfg) {
|
||||
// 拷一份再改:无 agent 段时 cfg.agent 与 DEFAULTS.agent 是同一引用,直接写会污染默认值
|
||||
// (配置页反复校验时上一份的 trim 会漏给下一份)。
|
||||
const a = Object.assign({}, cfg.agent || {});
|
||||
cfg.agent = a;
|
||||
const trim = (a.trim && typeof a.trim === 'object' && !Array.isArray(a.trim)) ? a.trim : {};
|
||||
const defMinChars = toNonNegInt(trim.min_chars, DEFAULTS.agent.trim.min_chars);
|
||||
// undefined / null 都是「没配」,回落到 DEFAULTS(deepMerge 通常已把默认数组带进来,
|
||||
// 这里兜住 agent.trim: null 这类显式空值);显式 [] 才是全关。
|
||||
const rawRules = (trim.rules === undefined || trim.rules === null) ? DEFAULTS.agent.trim.rules : trim.rules;
|
||||
if (!Array.isArray(rawRules)) throw new Error('agent.trim.rules 必须是数组');
|
||||
const rules = rawRules.map((r, i) => normalizeTrimRule(r, i, defMinChars)).filter(Boolean);
|
||||
const seen = new Set();
|
||||
for (const r of rules) {
|
||||
const k = r.side + '\u0000' + r.tool;
|
||||
if (seen.has(k)) throw new Error('agent.trim.rules 重复声明同一工具同一侧:' + r.tool + '(' + r.side + ')');
|
||||
seen.add(k);
|
||||
}
|
||||
a.trim = Object.assign({}, trim, { min_chars: defMinChars, rules });
|
||||
}
|
||||
|
||||
// 校验原始配置文本(启动读文件与网页编辑共用)。configPath 仅记录来源,可为空。
|
||||
function parseAndValidate(rawText, configPath) {
|
||||
let raw = YAML.parse(rawText || '') || {};
|
||||
const cfg = deepMerge(DEFAULTS, raw);
|
||||
normalizeAgentTrim(cfg);
|
||||
|
||||
// ---------- 模型配置:platforms 层级(platforms[].models[] + platforms[].keys[])----------
|
||||
// models 提到平台层(与 url/type 同级),多 key 共用同一份 models。
|
||||
@@ -269,6 +369,8 @@ function parseAndValidate(rawText, configPath) {
|
||||
display_name: m.display_name, vision: m.vision, enable: m.enable,
|
||||
extra_params: m.extra_params, thinking_params: m.thinking_params,
|
||||
reasoning_ack_field: m.reasoning_ack_field,
|
||||
max_context: m.max_context,
|
||||
store: m.store,
|
||||
profile: m.profile,
|
||||
url: p.url, api_key: k.api_key, platform: p.name, type: p.type, concurrency: k.concurrency,
|
||||
platform_index: pi, key_index: ki, model_index: mi,
|
||||
|
||||
@@ -20,6 +20,7 @@ function initDb(dbPath) {
|
||||
assistant_type TEXT DEFAULT 'secretary',
|
||||
user TEXT DEFAULT '',
|
||||
profile TEXT DEFAULT '',
|
||||
deep_think INTEGER NOT NULL DEFAULT 0,
|
||||
created_at INTEGER NOT NULL,
|
||||
updated_at INTEGER NOT NULL,
|
||||
completed_at INTEGER,
|
||||
@@ -231,6 +232,11 @@ function initDb(dbPath) {
|
||||
// 迁移:title_locked 用户手动重命名过标题(renameSession 置 1):显式留痕「名字是用户起的」,
|
||||
// 不得静默冲掉;清空会话时随标题一并复位(旧名字已文不对题)。
|
||||
if (!cols.some(c => c.name === 'title_locked')) db.exec("ALTER TABLE sessions ADD COLUMN title_locked INTEGER NOT NULL DEFAULT 0");
|
||||
// 迁移:会话级工作目录(本地桌面端新建会话时手选一个真实目录)。空串 = 沿用
|
||||
// workspace_root/<会话id>;服务器形态永远为空,行为与旧版完全一致(见 engine.taskDirOf)。
|
||||
if (!cols.some(c => c.name === 'work_dir')) db.exec("ALTER TABLE sessions ADD COLUMN work_dir TEXT NOT NULL DEFAULT ''");
|
||||
// 迁移:会话级深度思考开关(发消息时按请求体落库;重进会话回填按钮,压缩回合也以它为准)。
|
||||
if (!cols.some(c => c.name === 'deep_think')) db.exec('ALTER TABLE sessions ADD COLUMN deep_think INTEGER NOT NULL DEFAULT 0');
|
||||
// 迁移:wechat_bindings 补 deep_think 列——微信端全局深度思考开关(routes/channel.js /think 读写,
|
||||
// 投递时作为既有 deepThink 参数的取值来源);默认 0=关(与 H5 按钮初始态一致,/think on 手动开)。
|
||||
// 旧库若曾按 DEFAULT 1 补过列(当时默认开,存量行都是默认值回填而非用户显式选择),
|
||||
|
||||
@@ -0,0 +1,448 @@
|
||||
// 设备(远端执行节点)接入层。
|
||||
//
|
||||
// 设备主动出站连 wss://<公网前缀>/dev/ws,core 维护连接表;工具调用时把命令推下去、
|
||||
// 把 stdout/stderr/退出码收回来。设备侧不需要任何入站端口,所以家里的盒子、公司的
|
||||
// Windows 都能直接在 NAT 后面接进来。
|
||||
//
|
||||
// 启用条件:有公网前缀(config.yml public_link.base_url 或 env PUBLIC_BASE_URL)
|
||||
// 且配了 DEVICE_TOKEN。本地部署两者都没有,设备也连不进来,端点干脆不挂。
|
||||
const crypto = require('crypto');
|
||||
const fs = require('fs');
|
||||
const WebSocket = require('ws');
|
||||
const log = require('./log');
|
||||
|
||||
const PATH = '/dev/ws';
|
||||
const PING_MS = 20000; // nginx 默认 60s 空闲断,20s 足够安全
|
||||
const DEAD_SEC = 61; // 超过这么久没任何消息 → 判假死
|
||||
const HELLO_MS = 10000; // 连上后多久没 hello 就踢
|
||||
const DEFAULT_TIMEOUT_MS = 120000;
|
||||
const MAX_TIMEOUT_MS = 600000;
|
||||
const MAX_OUT_CHARS = 256 * 1024; // 单流回传上限,超出截断(免得一次把上下文塞爆)
|
||||
|
||||
const state = {
|
||||
enabled: false,
|
||||
token: '',
|
||||
wss: null,
|
||||
byName: new Map(), // name -> device
|
||||
pending: new Map(), // 请求 id -> { onChunk, onExit, onHealth }
|
||||
};
|
||||
|
||||
function init(cfg) {
|
||||
const base = String((cfg.public_link && cfg.public_link.base_url) || '').trim();
|
||||
state.token = String(process.env.DEVICE_TOKEN || '').trim();
|
||||
state.enabled = !!(base && state.token);
|
||||
if (state.enabled) {
|
||||
let host = base;
|
||||
try { host = new URL(base).host; } catch (_) { /* 保留原文 */ }
|
||||
log.info('devices', '设备接入已启用:wss://' + host + PATH);
|
||||
} else {
|
||||
log.info('devices', '设备接入未启用(' + (base ? '缺 DEVICE_TOKEN' : '无公网前缀') + ')');
|
||||
}
|
||||
return state.enabled;
|
||||
}
|
||||
|
||||
function enabled() {
|
||||
return state.enabled;
|
||||
}
|
||||
|
||||
function tokenOK(given) {
|
||||
if (!state.token) return false;
|
||||
const a = Buffer.from(String(given || ''));
|
||||
const b = Buffer.from(state.token);
|
||||
return a.length === b.length && crypto.timingSafeEqual(a, b);
|
||||
}
|
||||
|
||||
function attach(server) {
|
||||
if (!state.enabled) return;
|
||||
state.wss = new WebSocket.Server({ noServer: true, maxPayload: 8 * 1024 * 1024 });
|
||||
server.on('upgrade', (req, socket, head) => {
|
||||
let url;
|
||||
try { url = new URL(req.url, 'http://x'); } catch (_) { return; }
|
||||
if (url.pathname !== PATH) return; // 不认识的 upgrade 不归这层管
|
||||
const hdr = String(req.headers.authorization || '');
|
||||
const bearer = hdr.toLowerCase().startsWith('bearer ') ? hdr.slice(7).trim() : '';
|
||||
if (!tokenOK(bearer || url.searchParams.get('token'))) {
|
||||
log.warn('devices', '设备接入被拒:token 不匹配(来自 ' + (req.socket.remoteAddress || '?') + ')');
|
||||
socket.write('HTTP/1.1 401 Unauthorized\r\n\r\n');
|
||||
socket.destroy();
|
||||
return;
|
||||
}
|
||||
state.wss.handleUpgrade(req, socket, head, ws => state.wss.emit('connection', ws, req));
|
||||
});
|
||||
state.wss.on('connection', onConnection);
|
||||
setInterval(() => {
|
||||
const now = Date.now();
|
||||
for (const dev of state.byName.values()) {
|
||||
if (now - dev.lastSeen > DEAD_SEC * 1000) {
|
||||
log.warn('devices', '设备无消息超时,断开:' + dev.name);
|
||||
try { dev.ws.terminate(); } catch (_) {}
|
||||
continue;
|
||||
}
|
||||
try { dev.ws.send(JSON.stringify({ t: 'ping' })); } catch (_) {}
|
||||
}
|
||||
}, PING_MS).unref();
|
||||
}
|
||||
|
||||
function onConnection(ws) {
|
||||
const dev = {
|
||||
ws, name: null, os: '', arch: '', shell: '', shellPath: '', shellVer: '', root: '', ver: '',
|
||||
connectedAt: Date.now(), lastSeen: Date.now(), helloTimer: null,
|
||||
};
|
||||
dev.helloTimer = setTimeout(() => {
|
||||
if (!dev.name) { try { ws.close(4001, 'hello timeout'); } catch (_) {} }
|
||||
}, HELLO_MS);
|
||||
|
||||
ws.on('message', raw => {
|
||||
let m;
|
||||
try { m = JSON.parse(String(raw)); } catch (_) { return; }
|
||||
dev.lastSeen = Date.now();
|
||||
if (m.t === 'hello') return onHello(dev, m);
|
||||
if (m.t === 'chunk') {
|
||||
const p = state.pending.get(m.id);
|
||||
if (p && p.onChunk) p.onChunk(m);
|
||||
return;
|
||||
}
|
||||
if (m.t === 'exit') {
|
||||
const p = state.pending.get(m.id);
|
||||
if (p && p.onExit) p.onExit(m);
|
||||
return;
|
||||
}
|
||||
if (m.t === 'file.chunk') {
|
||||
const p = state.pending.get(m.id);
|
||||
if (p && p.onFileChunk) p.onFileChunk(m);
|
||||
return;
|
||||
}
|
||||
if (m.t === 'file.done') {
|
||||
const p = state.pending.get(m.id);
|
||||
if (p && p.onFileDone) p.onFileDone(m);
|
||||
return;
|
||||
}
|
||||
if (m.t === 'health') {
|
||||
const p = state.pending.get(m.id);
|
||||
if (p && p.onHealth) p.onHealth(m);
|
||||
}
|
||||
});
|
||||
|
||||
ws.on('close', () => {
|
||||
clearTimeout(dev.helloTimer);
|
||||
if (dev.name && state.byName.get(dev.name) === dev) {
|
||||
state.byName.delete(dev.name);
|
||||
log.info('devices', '设备下线:' + dev.name);
|
||||
}
|
||||
});
|
||||
ws.on('error', () => {});
|
||||
}
|
||||
|
||||
function onHello(dev, m) {
|
||||
clearTimeout(dev.helloTimer);
|
||||
dev.name = String(m.name || '').trim() || ('dev-' + crypto.randomBytes(3).toString('hex'));
|
||||
dev.os = String(m.os || '');
|
||||
dev.arch = String(m.arch || '');
|
||||
dev.shell = String(m.shell || '');
|
||||
dev.shellPath = String(m.shell_path || '');
|
||||
dev.shellVer = String(m.shell_ver || '');
|
||||
dev.root = String(m.root || '');
|
||||
dev.ver = String(m.ver || '');
|
||||
|
||||
const old = state.byName.get(dev.name);
|
||||
if (old && old !== dev) {
|
||||
log.warn('devices', '同名设备重新接入,踢掉旧连接:' + dev.name);
|
||||
try { old.ws.close(4000, 'replaced'); } catch (_) {}
|
||||
}
|
||||
state.byName.set(dev.name, dev);
|
||||
log.info('devices', `设备上线:${dev.name}(${dev.os}/${dev.arch} shell=${dev.shellPath || dev.shell} ${dev.shellVer} root=${dev.root})`);
|
||||
}
|
||||
|
||||
function pick(name) {
|
||||
if (name) return state.byName.get(String(name).trim()) || null;
|
||||
const first = state.byName.values().next();
|
||||
return first.done ? null : first.value;
|
||||
}
|
||||
|
||||
function list() {
|
||||
const now = Date.now();
|
||||
return [...state.byName.values()].map(d => ({
|
||||
device: d.name,
|
||||
os: d.os,
|
||||
arch: d.arch,
|
||||
// shell 是模型的命令入口:kind 决定调用形式(sh -c / cmd /c),path 决定实际解释器
|
||||
//(/bin/sh 可能是 dash、bash 或 busybox),ver 拿得到就给。
|
||||
shell: d.shell,
|
||||
shell_path: d.shellPath,
|
||||
shell_ver: d.shellVer,
|
||||
root: d.root,
|
||||
ver: d.ver,
|
||||
connected_sec: Math.round((now - d.connectedAt) / 1000),
|
||||
idle_sec: Math.round((now - d.lastSeen) / 1000),
|
||||
}));
|
||||
}
|
||||
|
||||
function health(name) {
|
||||
const dev = pick(name);
|
||||
if (!dev) return Promise.reject(new Error(name ? `设备 ${name} 不在线` : '当前没有设备在线'));
|
||||
const id = newJobId();
|
||||
return new Promise((resolve, reject) => {
|
||||
const timer = setTimeout(() => {
|
||||
state.pending.delete(id);
|
||||
reject(new Error(`设备 ${dev.name} 未在 5s 内回应 health`));
|
||||
}, 5000);
|
||||
state.pending.set(id, {
|
||||
onHealth(m) {
|
||||
clearTimeout(timer);
|
||||
state.pending.delete(id);
|
||||
resolve({
|
||||
device: dev.name, os: dev.os, arch: dev.arch,
|
||||
uptime_sec: m.uptime_sec, host_uptime_sec: m.host_uptime_sec,
|
||||
load1: m.load1, load5: m.load5, load15: m.load15,
|
||||
mem_total_mb: m.mem_total_mb, mem_free_mb: m.mem_free_mb,
|
||||
disk_total_gb: m.disk_total_gb, disk_free_gb: m.disk_free_gb, temp_c: m.temp_c,
|
||||
});
|
||||
},
|
||||
});
|
||||
try {
|
||||
dev.ws.send(JSON.stringify({ t: 'health', id }));
|
||||
} catch (e) {
|
||||
clearTimeout(timer);
|
||||
state.pending.delete(id);
|
||||
reject(new Error('下发 health 失败:' + e.message));
|
||||
}
|
||||
});
|
||||
}
|
||||
|
||||
function newJobId() {
|
||||
return crypto.randomBytes(6).toString('hex');
|
||||
}
|
||||
|
||||
function exec({ device, command, cwd, timeout_ms }) {
|
||||
return new Promise((resolve, reject) => {
|
||||
const dev = pick(device);
|
||||
if (!dev) return reject(new Error(device ? `设备 ${device} 不在线` : '当前没有设备在线'));
|
||||
const cmd = String(command || '');
|
||||
if (!cmd.trim()) return reject(new Error('command 不能为空'));
|
||||
const tmo = Math.min(Math.max(Number(timeout_ms) || DEFAULT_TIMEOUT_MS, 1000), MAX_TIMEOUT_MS);
|
||||
const id = newJobId();
|
||||
const started = Date.now();
|
||||
let out = '';
|
||||
let err = '';
|
||||
let truncated = false;
|
||||
let settled = false;
|
||||
|
||||
const done = payload => {
|
||||
if (settled) return;
|
||||
settled = true;
|
||||
clearTimeout(watchdog);
|
||||
state.pending.delete(id);
|
||||
resolve(payload);
|
||||
};
|
||||
|
||||
// 兜底看门狗:设备侧本来就会按 timeout 杀进程,这里再晚 10s 收尸,防止设备掉线后永远挂着
|
||||
const watchdog = setTimeout(() => {
|
||||
done({
|
||||
device: dev.name, code: -1, killed_by: 'watchdog', ms: Date.now() - started,
|
||||
stdout: out, stderr: err, truncated,
|
||||
note: '设备未在超时后回传结果(可能已掉线)',
|
||||
});
|
||||
}, tmo + 10000);
|
||||
|
||||
state.pending.set(id, {
|
||||
onChunk(m) {
|
||||
const text = Buffer.from(String(m.chunk || ''), 'base64').toString('utf8');
|
||||
if (m.out === 'err') {
|
||||
if (err.length + text.length > MAX_OUT_CHARS) { truncated = true; err += text.slice(0, Math.max(0, MAX_OUT_CHARS - err.length)); }
|
||||
else err += text;
|
||||
} else {
|
||||
if (out.length + text.length > MAX_OUT_CHARS) { truncated = true; out += text.slice(0, Math.max(0, MAX_OUT_CHARS - out.length)); }
|
||||
else out += text;
|
||||
}
|
||||
},
|
||||
onExit(m) {
|
||||
done({
|
||||
device: dev.name,
|
||||
code: typeof m.code === 'number' ? m.code : -1,
|
||||
killed_by: m.killed_by || '',
|
||||
ms: Number(m.ms) || Date.now() - started,
|
||||
stdout: out,
|
||||
stderr: err + (m.err ? String(m.err) : ''),
|
||||
truncated: truncated || !!m.truncated,
|
||||
});
|
||||
},
|
||||
});
|
||||
|
||||
try {
|
||||
dev.ws.send(JSON.stringify({
|
||||
t: 'exec', id, cmd, cwd: cwd ? String(cwd) : '', timeout_ms: tmo,
|
||||
}));
|
||||
} catch (e) {
|
||||
state.pending.delete(id);
|
||||
clearTimeout(watchdog);
|
||||
reject(new Error('下发命令失败:' + e.message));
|
||||
}
|
||||
});
|
||||
}
|
||||
|
||||
|
||||
// ---------- 文件通道 ----------
|
||||
// core 与设备之间拉/推单个文件,复用同一条 WS:256 KiB 一块,base64 传输。
|
||||
// 写盘一律先落 .part,size 与 sha256 都对上才 rename——不留半截文件。
|
||||
const FILE_CHUNK = 256 * 1024; // 每块 256 KiB
|
||||
const MAX_FILE = 2 * 1024 * 1024 * 1024; // 单文件上限 2 GiB
|
||||
const FIRST_CHUNK_MS = 30000; // 请求发出后等第一块(覆盖设备端 open/stat)
|
||||
const IDLE_MS = 30000; // 块与块之间的空闲超时:只看卡不卡,不看总共多久
|
||||
const DONE_WAIT_MS = 60000; // push 发完最后一包后等设备确认
|
||||
const WS_HIGH = 4 * 1024 * 1024; // 发送缓冲高水位,超了就歇一会
|
||||
|
||||
const sleep = ms => new Promise(r => setTimeout(r, ms));
|
||||
|
||||
// 流式算 sha256:2 GiB 不能整块读进内存
|
||||
function hashFile(p) {
|
||||
return new Promise((resolve, reject) => {
|
||||
const h = crypto.createHash('sha256');
|
||||
fs.createReadStream(p)
|
||||
.on('data', c => h.update(c))
|
||||
.on('end', () => resolve(h.digest('hex')))
|
||||
.on('error', reject);
|
||||
});
|
||||
}
|
||||
|
||||
// pull:设备 → 会话目录
|
||||
// 超时按「空闲」算:首块 30s,之后每收到一块重置 30s。稳定但慢的链路不会被误杀。
|
||||
function pull({ device, remotePath, localPath }) {
|
||||
return new Promise((resolve, reject) => {
|
||||
const dev = pick(device);
|
||||
if (!dev) return reject(new Error(device ? `设备 ${device} 不在线` : '当前没有设备在线'));
|
||||
if (!remotePath) return reject(new Error('remote_path 不能为空'));
|
||||
|
||||
const id = newJobId();
|
||||
const tmp = localPath + '.part';
|
||||
const out = fs.createWriteStream(tmp);
|
||||
const hash = crypto.createHash('sha256');
|
||||
let got = 0;
|
||||
let settled = false;
|
||||
let paused = false;
|
||||
let idle = null;
|
||||
|
||||
const finish = () => {
|
||||
if (settled) return false;
|
||||
settled = true;
|
||||
clearTimeout(idle);
|
||||
state.pending.delete(id);
|
||||
// 背压可能把连接停在 pause 上:结束时必须恢复,否则后续所有消息都收不到
|
||||
if (paused) {
|
||||
paused = false;
|
||||
try { dev.ws.resume(); } catch (_) {}
|
||||
}
|
||||
return true;
|
||||
};
|
||||
const fail = msg => {
|
||||
if (!finish()) return;
|
||||
try { out.destroy(); } catch (_) {}
|
||||
try { fs.unlinkSync(tmp); } catch (_) {}
|
||||
reject(new Error(msg));
|
||||
};
|
||||
const bump = ms => {
|
||||
clearTimeout(idle);
|
||||
idle = setTimeout(() => fail(`${ms / 1000}s 没有收到数据,判定卡住`), ms);
|
||||
};
|
||||
bump(FIRST_CHUNK_MS);
|
||||
|
||||
state.pending.set(id, {
|
||||
onFileChunk(m) {
|
||||
if (settled) return;
|
||||
bump(IDLE_MS);
|
||||
let b;
|
||||
try { b = Buffer.from(String(m.data || ''), 'base64'); } catch (_) { return fail('数据块解码失败'); }
|
||||
got += b.length;
|
||||
if (got > MAX_FILE) return fail('文件超过 2GiB 上限');
|
||||
hash.update(b);
|
||||
// 磁盘比网络慢时暂停从连接读,等 drain 再恢复——否则缓冲会在内存里堆到 OOM
|
||||
if (!out.write(b) && !paused) {
|
||||
paused = true;
|
||||
try { dev.ws.pause(); } catch (_) {}
|
||||
out.once('drain', () => {
|
||||
paused = false;
|
||||
try { dev.ws.resume(); } catch (_) {}
|
||||
});
|
||||
}
|
||||
},
|
||||
onFileDone(m) {
|
||||
if (settled) return;
|
||||
clearTimeout(idle);
|
||||
if (m.err) return fail(String(m.err));
|
||||
out.end(() => {
|
||||
if (!finish()) return;
|
||||
const sum = hash.digest('hex');
|
||||
if (typeof m.size === 'number' && m.size !== got) {
|
||||
try { fs.unlinkSync(tmp); } catch (_) {}
|
||||
return reject(new Error(`大小不符:收到 ${got},设备报 ${m.size}`));
|
||||
}
|
||||
if (m.sha256 && String(m.sha256).toLowerCase() !== sum) {
|
||||
try { fs.unlinkSync(tmp); } catch (_) {}
|
||||
return reject(new Error('sha256 不符'));
|
||||
}
|
||||
try { fs.renameSync(tmp, localPath); } catch (e) { return reject(e); }
|
||||
resolve({ device: dev.name, bytes: got, sha256: sum, path: localPath });
|
||||
});
|
||||
},
|
||||
});
|
||||
|
||||
dev.ws.send(JSON.stringify({ t: 'file', id, op: 'read', path: remotePath }));
|
||||
});
|
||||
}
|
||||
|
||||
// push:会话目录 → 设备
|
||||
// 发送阶段不设总超时(core 自己知道在发,靠 bufferedAmount 控节奏),
|
||||
// 发完最后一包才开始等设备确认(60s)。
|
||||
async function push({ device, localPath, remotePath }) {
|
||||
const dev = pick(device);
|
||||
if (!dev) throw new Error(device ? `设备 ${device} 不在线` : '当前没有设备在线');
|
||||
if (!remotePath) throw new Error('remote_path 不能为空');
|
||||
|
||||
const st = fs.statSync(localPath);
|
||||
if (!st.isFile()) throw new Error('只能推文件,不能推目录:' + localPath);
|
||||
if (st.size > MAX_FILE) throw new Error('文件超过 2GiB 上限');
|
||||
const size = st.size;
|
||||
const sum = await hashFile(localPath);
|
||||
const id = newJobId();
|
||||
|
||||
let settled = false;
|
||||
let doneTimer = null;
|
||||
let rejectDone = null;
|
||||
const done = new Promise((resolve, reject) => {
|
||||
rejectDone = reject;
|
||||
state.pending.set(id, {
|
||||
onFileDone(m) {
|
||||
if (settled) return;
|
||||
settled = true;
|
||||
clearTimeout(doneTimer);
|
||||
state.pending.delete(id);
|
||||
if (m.err) return reject(new Error(String(m.err)));
|
||||
resolve({ device: dev.name, bytes: size, sha256: sum, path: remotePath });
|
||||
},
|
||||
});
|
||||
});
|
||||
|
||||
try {
|
||||
dev.ws.send(JSON.stringify({ t: 'file', id, op: 'write', path: remotePath, size, sha256: sum }));
|
||||
for await (const chunk of fs.createReadStream(localPath, { highWaterMark: FILE_CHUNK })) {
|
||||
dev.ws.send(JSON.stringify({ t: 'file.chunk', id, data: chunk.toString('base64') }));
|
||||
while (dev.ws.bufferedAmount > WS_HIGH) await sleep(10);
|
||||
}
|
||||
dev.ws.send(JSON.stringify({ t: 'file.done', id }));
|
||||
} catch (e) {
|
||||
settled = true;
|
||||
state.pending.delete(id);
|
||||
throw e;
|
||||
}
|
||||
|
||||
// 发完最后一包才开始看门狗:设备还要算 sha、rename,慢盘上会停几秒
|
||||
doneTimer = setTimeout(() => {
|
||||
if (settled) return;
|
||||
settled = true;
|
||||
state.pending.delete(id);
|
||||
rejectDone(new Error(`发完最后一包后 ${DONE_WAIT_MS / 1000}s 仍未收到设备确认`));
|
||||
}, DONE_WAIT_MS);
|
||||
|
||||
return done;
|
||||
}
|
||||
|
||||
module.exports = { init, attach, enabled, list, health, exec, pull, push, PATH };
|
||||
@@ -1,21 +1,46 @@
|
||||
// 单文件下载响应的公共实现:任务文件的浏览器下载(routes/files.js)与公网临时文件
|
||||
// 单文件下载 / 内联响应的公共实现:任务文件的浏览器下载(routes/files.js)、公网临时文件
|
||||
// (routes/public-files.js)共用,避免两处各写一套文件名/缓存策略。
|
||||
'use strict';
|
||||
|
||||
const path = require('path');
|
||||
const log = require('./log');
|
||||
|
||||
// Content-Disposition 手工构造,绕开 content-disposition 包的 ASCII 兜底:
|
||||
// 该包会把中文名逐字替换成 ?(???.pdf),且 filename= 后紧跟 filename*= 会让
|
||||
// 老 AOSP DownloadManager 的正则解析失败而改从 URL 猜名(download.pdf)。
|
||||
// 这里传统 filename= 直接放百分号编码的 UTF-8:朴素解析器解码后能得到真名,
|
||||
// 标准客户端照旧优先 filename*(RFC 5987)。
|
||||
function downloadDisposition(name) {
|
||||
function contentDisposition(name, type) {
|
||||
const legacy = encodeURIComponent(name);
|
||||
// RFC 5987 attr-char 不含 ' ( ) ! *,ext-value 里需额外编码
|
||||
const ext = legacy.replace(/['()!*]/g, function (c) {
|
||||
return '%' + c.charCodeAt(0).toString(16).toUpperCase();
|
||||
});
|
||||
return 'attachment; filename="' + legacy + '"; filename*=UTF-8\'\'' + ext;
|
||||
return type + '; filename="' + legacy + '"; filename*=UTF-8\'\'' + ext;
|
||||
}
|
||||
|
||||
function downloadDisposition(name) {
|
||||
return contentDisposition(name, 'attachment');
|
||||
}
|
||||
|
||||
// 内联图片判定:只看扩展名,不读文件头——公网端点不做内容嗅探,也不该为了“猜类型”整包读文件。
|
||||
// svg 也算:浏览器只有拿到 image/svg+xml 才会渲染而不是下载(脚本风险由下面的 CSP sandbox 兜住)。
|
||||
const INLINE_IMAGE_TYPES = new Map([
|
||||
['.png', 'image/png'],
|
||||
['.jpg', 'image/jpeg'],
|
||||
['.jpeg', 'image/jpeg'],
|
||||
['.webp', 'image/webp'],
|
||||
['.gif', 'image/gif'],
|
||||
['.bmp', 'image/bmp'],
|
||||
['.tif', 'image/tiff'],
|
||||
['.tiff', 'image/tiff'],
|
||||
['.avif', 'image/avif'],
|
||||
['.ico', 'image/x-icon'],
|
||||
['.svg', 'image/svg+xml'],
|
||||
]);
|
||||
|
||||
function inlineImageType(abs) {
|
||||
return INLINE_IMAGE_TYPES.get(path.extname(String(abs || '')).toLowerCase()) || null;
|
||||
}
|
||||
|
||||
// 下载统一响应:禁用一切缓存协商。
|
||||
@@ -23,12 +48,61 @@ function downloadDisposition(name) {
|
||||
// 先发条件请求拿 304 空体,下载管理器随后卡在“等待中”(桌面 Safari/curl 不受影响)。
|
||||
// 不能用 res.download:它会用 content-disposition 包覆盖上面的文件名策略;
|
||||
// res.sendFile 不设置 Content-Disposition,Content-Type 按扩展名自动出,Range 由 send 支持。
|
||||
function sendDownload(res, abs) {
|
||||
function noStore(res) {
|
||||
res.setHeader('Cache-Control', 'no-store, no-cache, must-revalidate');
|
||||
res.setHeader('Pragma', 'no-cache');
|
||||
res.setHeader('Expires', '0');
|
||||
res.setHeader('Content-Disposition', downloadDisposition(path.basename(abs)));
|
||||
res.sendFile(abs, { lastModified: false, etag: false, maxAge: 0 });
|
||||
}
|
||||
|
||||
module.exports = { downloadDisposition, sendDownload };
|
||||
// sendFile 失败的统一出口(所有调用方共用,不再各自 try/catch——sendFile 的失败是
|
||||
// **异步**回调,调用方外层的 try/catch 根本抓不到)。
|
||||
//
|
||||
// 为什么必须有人接:没人接就落进 Express 默认错误处理器,而它在 NODE_ENV != production 时
|
||||
// 会把 err.stack 拼成 HTML 页面吐给请求方——服务端绝对路径、源码文件名+行号、依赖版本全在
|
||||
// 里面。/p/<id> 是匿名可达端点(public-files.js 挂在 auth 之前),一次失败就等于把内部结构
|
||||
// 公开。所以正文只留一行固定文案,细节进日志。
|
||||
//
|
||||
// 4xx 一律折叠成 404:不向匿名取用方区分「不存在」与「无权限」(原来的 403/416 会变成
|
||||
// 探针,能区分路径是否存在)。
|
||||
function sendFileError(res, err, abs) {
|
||||
const code = Number(err && err.status);
|
||||
const notFound = !!err && (err.code === 'ENOENT' || (code >= 400 && code < 500));
|
||||
const status = notFound ? 404 : 500;
|
||||
log.warn('download', (notFound ? '取不到文件:' : '发送失败:') + abs +
|
||||
'(' + ((err && (err.code || err.message)) || err) + ')');
|
||||
if (res.headersSent) { if (res.destroy) res.destroy(); return; } // 已吐了半截,只能断开
|
||||
res.removeHeader('Content-Disposition'); // 进来前已按附件设过,错误响应不该带文件名
|
||||
res.status(status).type('text').send(notFound ? 'not found' : 'internal error');
|
||||
}
|
||||
|
||||
function sendDownload(res, abs) {
|
||||
noStore(res);
|
||||
res.setHeader('Content-Disposition', downloadDisposition(path.basename(abs)));
|
||||
// dotfiles:'allow' 与下面的图片分支对齐。send 默认 'ignore' 会把 .env / .gitignore 这类
|
||||
// 文件当成"不存在"抛 NotFoundError——文件明明在,取用方却拿到 404,且历史版本还会连带
|
||||
// 把堆栈页吐出去(见 sendFileError)。点文件本来就是我们自己签发的,没有理由拒绝。
|
||||
res.sendFile(abs, { dotfiles: 'allow', lastModified: false, etag: false, maxAge: 0 }, function (err) {
|
||||
if (err) sendFileError(res, err, abs);
|
||||
});
|
||||
}
|
||||
|
||||
// 内联图片响应(公网链 GET /p/<id> 的图片分支):点开链接直接显示,不再被当成附件下载。
|
||||
// 安卓封装壳 / WebView 对 attachment 一律交系统下载器,图片外链因此“只下载、不打开”;
|
||||
// inline + 明确的 image/* 才走渲染路径。缓存仍 no-store:/p/<id> 是短命 bearer 链,
|
||||
// 不该被中间缓存留副本(与下载同语义)。
|
||||
function sendInlineImage(res, abs, type) {
|
||||
noStore(res);
|
||||
res.setHeader('Content-Type', type);
|
||||
res.setHeader('X-Content-Type-Options', 'nosniff');
|
||||
res.setHeader('Content-Disposition', contentDisposition(path.basename(abs), 'inline'));
|
||||
// SVG 是唯一能带脚本的“图片”,而 /p/ 是匿名同源端点:直接打开会以本应用身份执行脚本。
|
||||
// sandbox 不给 allow-scripts,退化成不可执行、无同源权限的文档;<img> 引用本就不执行脚本,不受影响。
|
||||
if (type === 'image/svg+xml') res.setHeader('Content-Security-Policy', 'sandbox');
|
||||
// dotfiles 显式放行:read_file 的压缩产物在 .imgcache/(点目录),默认策略对其他调用方不保证。
|
||||
// 回调同 sendDownload:图片也可能在读盘中途失败(被删/EACCES),不能漏给默认错误处理器。
|
||||
res.sendFile(abs, { dotfiles: 'allow', lastModified: false, etag: false, maxAge: 0 }, function (err) {
|
||||
if (err) sendFileError(res, err, abs);
|
||||
});
|
||||
}
|
||||
|
||||
module.exports = { contentDisposition, downloadDisposition, sendDownload, sendInlineImage, inlineImageType };
|
||||
|
||||
+296
-31
@@ -2,7 +2,8 @@
|
||||
// 单进程内存模型:JS 单线程 + better-sqlite3 同步 API,不存在跨进程竞争。
|
||||
const fs = require('fs');
|
||||
const path = require('path');
|
||||
const { buildMessages, callModel, encodeBlocks, decodeBlocks, compressMessages, titleMessages, setProfilePrompts, patchImageReceipt } = require('./llm');
|
||||
const { buildMessages, callModel, encodeBlocks, decodeBlocks, compressMessages, titleMessages, setProfilePrompts, patchImageReceipt, invalidateContext } = require('./llm');
|
||||
const { instanceId } = require('./instance');
|
||||
const { executeTool, resolveInTask } = require('./tools/executor');
|
||||
const publicFiles = require('./public-files');
|
||||
const mcp = require('./mcp');
|
||||
@@ -53,8 +54,41 @@ function genTaskId() {
|
||||
return id;
|
||||
}
|
||||
|
||||
// 会话级工作目录:本地桌面端新建会话时可手选一个真实目录(DB 列 work_dir,见 db.js 迁移)。
|
||||
// 空串 = 沿用 workspace_root/<会话id>,服务器形态永远走这条,行为与 v2.5.0 完全一致。
|
||||
// 用缓存的 prepared statement:taskDirOf 在文件 API / 工具链里被高频调用,每次现 prepare 没必要。
|
||||
let stmtWorkDir = null;
|
||||
function sessionWorkDir(sessionId) {
|
||||
try {
|
||||
if (!stmtWorkDir) stmtWorkDir = db.prepare('SELECT work_dir FROM sessions WHERE id = ?');
|
||||
const row = stmtWorkDir.get(sessionId);
|
||||
return String((row && row.work_dir) || '');
|
||||
} catch (_) { return ''; }
|
||||
}
|
||||
|
||||
function taskDirOf(sessionId) {
|
||||
return path.join(cfg.workspace_root, sessionId);
|
||||
return sessionWorkDir(sessionId) || path.join(cfg.workspace_root, sessionId);
|
||||
}
|
||||
|
||||
// 校验并归一化「手选工作目录」:必须已存在的真实目录(不替用户 mkdir),且不能是根目录 /
|
||||
// 或平台数据目录——后者存着 SQLite(.agent.db)和 prompt dump,让会话目录指过去等于让 AI
|
||||
// 直接动运行数据库。用户主目录/Linux 根下子目录不拦(本地模式本来就没沙箱,README 已提示
|
||||
// 选专用目录),但选到根目录本身无意义。
|
||||
function normalizeWorkDir(input) {
|
||||
const raw = String(input || '').trim();
|
||||
if (!raw) return '';
|
||||
if (!path.isAbsolute(raw)) throw Object.assign(new Error('工作目录必须是绝对路径:' + raw), { status_code: 400 });
|
||||
let real;
|
||||
try { real = fs.realpathSync(raw); } catch (_) { throw Object.assign(new Error('工作目录不存在:' + raw), { status_code: 400 }); }
|
||||
let st;
|
||||
try { st = fs.statSync(real); } catch (_) { throw Object.assign(new Error('工作目录不可访问:' + raw), { status_code: 400 }); }
|
||||
if (!st.isDirectory()) throw Object.assign(new Error('不是目录:' + raw), { status_code: 400 });
|
||||
if (real === path.parse(real).root) throw Object.assign(new Error('不能把根目录作为工作目录'), { status_code: 400 });
|
||||
const dataRoot = String(cfg.data_root || '');
|
||||
if (dataRoot && (real === dataRoot || real.startsWith(dataRoot + path.sep))) {
|
||||
throw Object.assign(new Error('不能选择平台数据目录作为工作目录'), { status_code: 400 });
|
||||
}
|
||||
return real;
|
||||
}
|
||||
|
||||
function getSession(sessionId) {
|
||||
@@ -76,6 +110,29 @@ function loadHistory(sessionId) {
|
||||
return db.prepare('SELECT * FROM messages WHERE session_id = ? ORDER BY id').all(sessionId);
|
||||
}
|
||||
|
||||
// 已被压缩掉的行数 = 「压缩代数」。压缩时会把摘要之前的所有行标成 archived,
|
||||
// 所以这个数单调递增;用它做增量上下文的 id 后缀,压缩后 id 自变,relay 缓存自然失效。
|
||||
function archivedCount(history) {
|
||||
let n = 0;
|
||||
for (const r of history || []) if (r.type === 'archived') n++;
|
||||
return n;
|
||||
}
|
||||
|
||||
// 同上,但按 sessionId 现查:编辑/删除入口拿到的是裸 sessions 行(不含 history),
|
||||
// 用 archivedCount(session.history) 会恒得 0,作废的 cid 就打到别的 key 上(压缩过的会话必踩)。
|
||||
function archivedCountOf(sessionId) {
|
||||
const r = db.prepare("SELECT COUNT(*) AS n FROM messages WHERE session_id = ? AND type = 'archived'").get(sessionId);
|
||||
return r ? r.n : 0;
|
||||
}
|
||||
|
||||
// 增量上下文 id 的拼法(与 llm.js 的 X-Context-Id 一致):<core_id>:<user>:<session_id>:<archived_cnt>。
|
||||
// 删除消息后要把这个 key 作废,让下一轮走全量重建。
|
||||
// runLoop 里 session.history 已就绪,走内存计数;其余入口现查库,两条路结果一致。
|
||||
function contextIdOf(session) {
|
||||
const n = session.history ? archivedCount(session.history) : archivedCountOf(session.id);
|
||||
return instanceId(cfg.data_root) + ':' + (session.user || '-') + ':' + session.id + ':' + n;
|
||||
}
|
||||
|
||||
function saveMessage(sessionId, msg) {
|
||||
const info = db.prepare(
|
||||
'INSERT INTO messages (session_id, role, content, reasoning, tool_calls, tool_call_id, name, type, is_error, usage, created_at) VALUES (?,?,?,?,?,?,?,?,?,?,?)'
|
||||
@@ -172,9 +229,44 @@ function syncModelPool() {
|
||||
// 进程重启后:key 非独占,所有会话的绑定保持不动(顶部展示的模型持续可见,直到用户手动断开/换绑)。
|
||||
// active(重启后必无回合进程)与遗留 queued 会话统一归位 held;指向已被删除/禁用模型的绑定,
|
||||
// 下次发消息时由 ensureBinding 自动改选(优先留原平台),用户无感。
|
||||
// 归位前先把「回合没走完」的 active 挑出来:stop/重启打断时它们停在半路,最后一条非 tool 消息
|
||||
// 必是 user(模型还没答)或带 tool_calls 的 assistant(这批工具之后没了下文)。
|
||||
// 已答完、只是没来得及 finalize 的会话(最后是纯文本 assistant)不在此列,照常归位 held。
|
||||
const resumeIds = [];
|
||||
for (const r of db.prepare("SELECT id FROM sessions WHERE status='active'").all()) {
|
||||
const last = db.prepare(
|
||||
"SELECT role, tool_calls FROM messages WHERE session_id = ? AND role != 'tool' ORDER BY id DESC LIMIT 1"
|
||||
).get(r.id);
|
||||
if (last && (last.role === 'user'
|
||||
|| (last.role === 'assistant' && last.tool_calls && last.tool_calls !== '[]'))) resumeIds.push(r.id);
|
||||
}
|
||||
db.prepare('UPDATE model_pool SET is_busy = 0, current_session_id = NULL').run(); // 旧版独占列清残留(调度已不读)
|
||||
db.prepare("UPDATE sessions SET status='held', held_at=COALESCE(held_at, updated_at), updated_at=? WHERE status IN ('active','queued')").run(now());
|
||||
startHeldSweeper();
|
||||
// 续跑:不伪造工具执行结果,但给中断点那批调用补一条「服务重启、结果未知」的回执,
|
||||
// 否则 buildMessages 会把整行 tool_calls 丢掉,模型看不到自己发过什么命令,重启类任务就会无限重试。
|
||||
// 等 5s 是因为 init 早于 server.listen,executor 也可能还在起,太早开跑首轮工具只会拿到连接错误。
|
||||
const RESUME_DELAY_MS = 5000;
|
||||
for (const id of resumeIds) {
|
||||
setTimeout(() => {
|
||||
const s = getSession(id);
|
||||
// 5s 内用户可能已经自己发消息(已开跑)或点了停止:只接管仍停在 held/active 的会话
|
||||
if (!s || (s.status !== 'held' && s.status !== 'active')) return;
|
||||
try {
|
||||
ensureBinding(s);
|
||||
touch(id, { status: 'active', held_at: null, completed_at: null, cancelled_at: null });
|
||||
getRun(id, true).deepThink = !!s.deep_think; // 恢复中断前的深度思考开关(会话行里持久化的值)
|
||||
const n = markInterruptedBatch(id); // 先补中断点的回执,模型才能看到自己发过什么命令
|
||||
if (n) log.info('tool', id + ' 重启续跑前补齐 ' + n + ' 条中断回执');
|
||||
emitStatus(id);
|
||||
runLoop(id);
|
||||
log.info('engine', id + ' 重启后续跑未完成的回合');
|
||||
} catch (e) {
|
||||
log.warn('engine', id + ' 重启续跑失败:' + (e && e.message || e));
|
||||
}
|
||||
}, RESUME_DELAY_MS);
|
||||
}
|
||||
if (resumeIds.length) log.info('engine', '检测到 ' + resumeIds.length + ' 个被中断的回合,就绪后自动续跑');
|
||||
}
|
||||
|
||||
// ---------- 会话闲置处理(30min held 归档 + 4h 记忆收口) ----------
|
||||
@@ -319,6 +411,32 @@ function modelVision(session) {
|
||||
return !!(m && m.vision);
|
||||
}
|
||||
|
||||
// 会话绑定模型的自动压缩阈值(models[].max_context,0=未配→不自动压缩)。
|
||||
// 它不是模型真实上下文窗口,而是用户自己设的「用量线」——到线就压,与真实窗口多大无关。
|
||||
function modelMaxContext(session) {
|
||||
const m = session.model_id && (cfg.models || []).find(x => x.id === session.model_id);
|
||||
return (m && Number(m.max_context)) || 0;
|
||||
}
|
||||
|
||||
// 回合起点播种回合一开局的 In token:取「上一回合最后一次上游实报的 prompt_tokens」。
|
||||
// 不播种的话新回合第一个判据永远是 0(run.turnMaxPt 在 runLoop 里清零),
|
||||
// 历史早就超线也照样把整段再发一遍,只有等到本回合内出现工具迭代才补判——
|
||||
// 实测 123903 ≥ 120000 的那一发就是白打的(无 tool_calls 的回合到头来一发都不压)。
|
||||
// 摘要行的 usage 是「压缩请求自身」的用量(含被截断的旧转写),不代表压缩后的上下文,
|
||||
// 拿它播种会让刚压完立刻再压,故只认最新摘要之后的行。
|
||||
function seedTurnMaxPt(sessionId) {
|
||||
const last = db.prepare("SELECT MAX(id) AS id FROM messages WHERE session_id = ? AND type = 'summary'").get(sessionId);
|
||||
const row = db.prepare(
|
||||
"SELECT usage FROM messages WHERE session_id = ? AND role = 'assistant' AND usage IS NOT NULL" +
|
||||
" AND id > ? ORDER BY id DESC LIMIT 1"
|
||||
).get(sessionId, (last && last.id) || 0);
|
||||
if (!row || !row.usage) return 0;
|
||||
try {
|
||||
const u = JSON.parse(row.usage);
|
||||
return Math.max(0, Number(u && u.pt) || 0);
|
||||
} catch (_) { return 0; }
|
||||
}
|
||||
|
||||
// ---------- 模型 profile(prompt+tools 组合) ----------
|
||||
// 把 cfg 里预加载的自定义 prompt 文本注册给 llm(配置加载时已读入,见 config.js);
|
||||
// engine.init 调一次,运行期只按名选取,零 IO。
|
||||
@@ -495,9 +613,11 @@ function closeToolBatch(sessionId, reason) {
|
||||
const name = (c.function && c.function.name) || '未知工具';
|
||||
const text = 'Error: ' + reason + '本次调用未执行(' + name + ')。';
|
||||
const msgId = saveMessage(sessionId, { role: 'tool', tool_call_id: c.id, name, content: text, is_error: true });
|
||||
// 同步广播:前端工具卡不能停在「调用中」呼吸态
|
||||
// 同步广播:前端工具卡不能停在「调用中」呼吸态。
|
||||
// skipped:这不是工具自己失败,而是用户介入导致没执行——微信端据此不报
|
||||
// 「工具调用失败」、不计入失败数(否则一次干预会换来一串误导性告警)。
|
||||
bus.emit(sessionId, 'tool_result', {
|
||||
tool_call_id: c.id, name, content: text, is_error: true, msg_id: msgId,
|
||||
tool_call_id: c.id, name, content: text, is_error: true, skipped: true, msg_id: msgId,
|
||||
});
|
||||
n++;
|
||||
}
|
||||
@@ -511,7 +631,7 @@ async function runLoop(sessionId) {
|
||||
if (run.looping) return; // 已有循环在跑(下一轮迭代会自动带上最新消息)
|
||||
run.looping = true;
|
||||
// 回合级 In token 峰值(整轮结束后供自动压缩检查);记录本回合是否为压缩回合,压缩回合不再自启压缩防递归
|
||||
run.turnMaxPt = 0;
|
||||
run.turnMaxPt = seedTurnMaxPt(sessionId);
|
||||
const wasCompressTurn = !!run.summarizing;
|
||||
try {
|
||||
await runLoopInner(sessionId, run);
|
||||
@@ -526,6 +646,34 @@ async function runLoop(sessionId) {
|
||||
}
|
||||
}
|
||||
|
||||
// 重启续跑前给中断点那批调用补回执:不伪造执行结果,只告知「服务重启、结果未知」。
|
||||
// 有了配对回执,buildMessages 才会保留整行 tool_calls——否则它会把无回执的调用剔掉,
|
||||
// 模型看不到自己发过什么命令,「重启」类任务就靠猜,猜错就无限重试。
|
||||
function markInterruptedBatch(sessionId) {
|
||||
const last = db.prepare(
|
||||
"SELECT id, role, tool_calls FROM messages WHERE session_id = ? AND role != 'tool' ORDER BY id DESC LIMIT 1"
|
||||
).get(sessionId);
|
||||
if (!last || last.role !== 'assistant' || !last.tool_calls) return 0; // 收尾回复或用户才发完话
|
||||
let calls = [];
|
||||
try { calls = JSON.parse(last.tool_calls) || []; } catch (_) { return 0; }
|
||||
const got = new Set(
|
||||
db.prepare(
|
||||
"SELECT tool_call_id FROM messages WHERE session_id = ? AND role = 'tool' AND id > ? AND tool_call_id IS NOT NULL AND tool_call_id != ''"
|
||||
).all(sessionId, last.id).map(r => r.tool_call_id)
|
||||
);
|
||||
let n = 0;
|
||||
for (const c of calls) {
|
||||
if (!c || !c.id || got.has(c.id)) continue;
|
||||
const name = (c.function && c.function.name) || '未知工具';
|
||||
saveMessage(sessionId, {
|
||||
role: 'tool', tool_call_id: c.id, name,
|
||||
content: '[系统] 服务重启,本次调用被中断,执行结果未知:先核实实际状态再决定,不要直接重试。',
|
||||
});
|
||||
n++;
|
||||
}
|
||||
return n;
|
||||
}
|
||||
|
||||
function finalize(sessionId, run) {
|
||||
const s = getSession(sessionId);
|
||||
if (!s || s.status !== 'active') { runs.delete(sessionId); return; }
|
||||
@@ -629,6 +777,29 @@ function cleanTitle(raw) {
|
||||
return t.slice(0, 60);
|
||||
}
|
||||
|
||||
// 读图回传上游有两条取图路,取决于「谁能访问这个 URL」:
|
||||
// - 服务器形态:签一条公网短链(/p/<id>),模型厂商的服务器来拉;
|
||||
// - 本地形态:core 监听在回环地址,厂商拉不到 127.0.0.1,改为把压缩后的图内联成 data URL
|
||||
// (llm.js 侧本来就接受这个形态——用户粘贴附件的 image_url 走的就是它)。
|
||||
// 只认 AGENT_IMAGE_INLINE=1(local/start.sh 注入):服务器不设 → 完全走原路径。
|
||||
const INLINE_IMAGE_MAX_BYTES = 1.5 * 1024 * 1024;
|
||||
const INLINE_IMAGE_MIME = {
|
||||
'.jpg': 'image/jpeg', '.jpeg': 'image/jpeg', '.png': 'image/png',
|
||||
'.webp': 'image/webp', '.gif': 'image/gif',
|
||||
};
|
||||
|
||||
function inlineImageDataUrl(abs) {
|
||||
if (String(process.env.AGENT_IMAGE_INLINE || '') !== '1') return null;
|
||||
const mime = INLINE_IMAGE_MIME[path.extname(abs).toLowerCase()];
|
||||
if (!mime) return null;
|
||||
try {
|
||||
// 上限按原文件字节算(base64 约 1.34 倍):超限宁可不发——llm 侧会照旧降级成
|
||||
// 「像素未送达」——也不把请求体顶爆(.imgcache 产物已压到长边 2000px,正常远低于上限)。
|
||||
if (fs.statSync(abs).size > INLINE_IMAGE_MAX_BYTES) return null;
|
||||
return 'data:' + mime + ';base64,' + fs.readFileSync(abs).toString('base64');
|
||||
} catch (_) { return null; }
|
||||
}
|
||||
|
||||
async function runLoopInner(sessionId, run) {
|
||||
let iter = 0;
|
||||
// 已纳入模型请求的最大消息 id;用于判断是否有尚未被回应的新 user 消息
|
||||
@@ -640,21 +811,39 @@ async function runLoopInner(sessionId, run) {
|
||||
if (!session || session.status !== 'active' || !session.model_id) break;
|
||||
session.history = loadHistory(sessionId);
|
||||
for (const m of session.history) if (m.id > lastIncludedId) lastIncludedId = m.id;
|
||||
// 自动压缩:本回合已用到的 In token 峰值(上一轮上游实报值)达到模型配的 max_context,
|
||||
// 就地把握回合切成压缩回合——不新开 run、不发 auto_compress 提议,前端无感(产物就是摘要卡片,
|
||||
// 与手点「压缩」完全同一条路径:下一圈的 compressing 分支换 prompt、摘要落库归档)。
|
||||
// 检查点必须在请求发出之前:这个数字是上一轮的真实值,下一轮只会更大。
|
||||
// 压缩回合自身不再判(run.summarizing 已真),否则会把自己再压一遍。
|
||||
const maxCtx = modelMaxContext(session);
|
||||
if (maxCtx > 0 && !run.summarizing && (run.turnMaxPt || 0) >= maxCtx) {
|
||||
log.info('msg', sessionId + ' 自动压缩:回合 In ' + run.turnMaxPt + ' ≥ max_context ' + maxCtx);
|
||||
run.summarizing = true;
|
||||
// 标记「这是回合内自动压缩」:摘要落地后要接着跑完原任务(见 isSummary 分支),
|
||||
// 与用户手点「压缩」发起的独立压缩回合区分开(那种压完就该停)。
|
||||
run.compactAuto = true;
|
||||
}
|
||||
// 压缩回合(run.summarizing = 由「压缩」按钮发起、尚未产出摘要):
|
||||
// 沿用默认 system prompt + 正常历史,末尾追加一条压缩指令 user(见 llm.compressMessages);
|
||||
// 且不传 tools,模型只能输出摘要文本。
|
||||
// 沿用默认 system prompt + 正常历史 + 同一套 tools,末尾追加一条压缩指令 user(见 llm.compressMessages),
|
||||
// 请求与上一发常规请求只差尾部这一段,前缀缓存整段命中。
|
||||
// 发送前为历史里的 image_ref 块现签公网外链(GET /p/<id>,同 mint_public_link):
|
||||
// 每次请求重签,回合内多轮迭代/重试永不过期;DB 只存几十字符的 rel,base64 不进库不进请求体。
|
||||
// base_url 未配/校验不过/mint 异常时返回 null,buildMessages 降级为文字占位。
|
||||
// base_url 未配/校验不过/mint 异常时返回 null,buildMessages 降级为文字占位;本地形态
|
||||
// 没有公网前缀时改走内联 data URL(同见 inlineImageDataUrl),厂商拉不到回环地址。
|
||||
// image_rel 可能是压缩无收益时直指的原文件:与 mint_public_link 同款 realpath 复核,
|
||||
// 防任务目录里指向外部的符号链接图片被签上公网。
|
||||
const mintImageUrl = (rel) => {
|
||||
const pl = cfg.public_link || {};
|
||||
if (!pl.base_url) return null;
|
||||
let dir, real;
|
||||
try {
|
||||
const dir = taskDirOf(sessionId);
|
||||
const real = fs.realpathSync(resolveInTask(dir, rel));
|
||||
dir = taskDirOf(sessionId);
|
||||
real = fs.realpathSync(resolveInTask(dir, rel));
|
||||
if (real !== dir && !real.startsWith(dir + path.sep)) return null;
|
||||
} catch (_) { return null; }
|
||||
// 符号链接复核先做完再分叉:内联形态同样不能让任务目录外的图出去(见 inlineImageDataUrl)。
|
||||
if (!pl.base_url) return inlineImageDataUrl(real);
|
||||
try {
|
||||
return pl.base_url + '/p/' + publicFiles.mint({ sessionId: sessionId, rel, ttlMs: pl.ttl_ms });
|
||||
} catch (_) { return null; }
|
||||
};
|
||||
@@ -680,8 +869,9 @@ async function runLoopInner(sessionId, run) {
|
||||
+ (txt.includes('"already_delivered"') ? '[图重复读挡回]' : '');
|
||||
}).join(' '));
|
||||
}
|
||||
// 内置工具 + 启动时发现的 MCP 工具(按 profile 白名单过滤),一起随 system prompt 发给模型(压缩回合不发)
|
||||
const tools = compressing ? [] : effectiveTools(profileName);
|
||||
// 内置工具 + 启动时发现的 MCP 工具(按 profile 白名单过滤),一起随 system prompt 发给模型。
|
||||
// 压缩回合也照发:tools 段在最前,删掉等于断整段前缀缓存(尾部指令已写明不要调用工具)。
|
||||
const tools = effectiveTools(profileName);
|
||||
|
||||
let result = null;
|
||||
let lastErr = null;
|
||||
@@ -691,15 +881,26 @@ async function runLoopInner(sessionId, run) {
|
||||
break;
|
||||
} catch (err) {
|
||||
lastErr = err;
|
||||
// 无 upstream_status = 网络层失败或中断(含「停止」「立即发送」的 abort):relay 在收到
|
||||
// 上游 200 头时就已 put,而这边没拿到响应头、指针还停在上一轮,不作废就会在下一轮把
|
||||
// 重复的增量再拼一遍 → tool_call_mismatch。直接清指针,下一轮走全量 + Reset 覆盖。
|
||||
// 有 upstream_status 的 429/5xx 则确定没写缓存,保留指针,重试发空增量最省。
|
||||
if (!err.upstream_status) invalidateContext(contextIdOf(session));
|
||||
const retriable = !err.upstream_status || err.upstream_status === 429 || err.upstream_status >= 500;
|
||||
if (!retriable || attempt === cfg.agent.max_retries) break;
|
||||
// 重试用的是同一份 messages(数组一字未变),所以增量上下文会发空 body,
|
||||
// 只花百来字节就能让 relay 用缓存重发。这行日志是用来对上那笔账的。
|
||||
log.warn('model', sessionId + ' 第 ' + (attempt + 1) + '/' + cfg.agent.max_retries +
|
||||
' 次重试:' + String(err.message || '').slice(0, 100));
|
||||
await sleep(2000 * (attempt + 1));
|
||||
}
|
||||
}
|
||||
if (run.cancelled) break;
|
||||
if (!result) {
|
||||
const text = '⚠️ 模型调用失败:' + (lastErr && lastErr.message || '未知错误');
|
||||
const errId = saveMessage(sessionId, { role: 'assistant', content: text });
|
||||
// type='error_note':留痕给 UI,但不进模型上下文(buildMessages 跳过),
|
||||
// 否则失败文案会当成模型的真实回复一直带下去。
|
||||
const errId = saveMessage(sessionId, { role: 'assistant', content: text, type: 'error_note' });
|
||||
bus.emit(sessionId, 'assistant_message', { id: errId, content: text, error: true, created_at: now() });
|
||||
break;
|
||||
}
|
||||
@@ -770,10 +971,10 @@ async function runLoopInner(sessionId, run) {
|
||||
recordModelUsage(sessionId, session.model_id, result.usage);
|
||||
// 回合级 In token 峰值:工具迭代只会越滚越大,取各轮 prompt_tokens 最大值作自动压缩判据
|
||||
if (msgRow.usage && msgRow.usage.pt > (run.turnMaxPt || 0)) run.turnMaxPt = msgRow.usage.pt;
|
||||
// 「压缩」回合的总结判定:压缩时不传 tools,因此本回合第一条「无 tool_calls 的收尾回复」
|
||||
// 就是摘要(compressing 取自本回合的 run.summarizing 标记);回合中间若有异常产生的
|
||||
// 工具轮(理论上不会)都是普通消息,前端照常渲染。
|
||||
const isSummary = !hasTools && compressing;
|
||||
// 「压缩」回合的总结判定:压缩指令发出去,模型回来的第一段非空文本就是摘要——带不带
|
||||
// 工具都算(模型常为了把摘要写准先调一次工具查证,这一轮的文字同样是摘要,不能当普通
|
||||
// 回复落库)。空文本(纯工具调用、一个字没写)不算,run.summarizing 保持,下一轮继续压。
|
||||
const isSummary = compressing && !!String(msgRow.content || '').trim();
|
||||
bus.emit(sessionId, 'assistant_message', {
|
||||
id: assistantId, content: msgRow.content, reasoning: msgRow.reasoning,
|
||||
tool_calls: msgRow.tool_calls, type: msgRow.type, created_at: msgRow.created_at,
|
||||
@@ -786,6 +987,9 @@ async function runLoopInner(sessionId, run) {
|
||||
// 后续对话从这条摘要开始,旧历史不再烧 token。
|
||||
// 旧摘要行(多轮压缩)一并存档:被新摘要覆盖替代,不再进上下文。
|
||||
run.summarizing = null;
|
||||
// 摘要已落地:清掉本回合的 In 峰值,后续轮次按压缩后的新上下文重新计量。
|
||||
// 不清就会拿旧值立刻再触发一次(死循环);清了则压完仍超还能再压(支持连续压缩)。
|
||||
run.turnMaxPt = 0;
|
||||
if ((msgRow.content || '').trim()) {
|
||||
db.prepare("UPDATE messages SET type = 'summary' WHERE id = ?").run(assistantId);
|
||||
const n = db.prepare(
|
||||
@@ -794,6 +998,19 @@ async function runLoopInner(sessionId, run) {
|
||||
).run(sessionId, assistantId).changes;
|
||||
log.info('msg', sessionId + ' 压缩摘要 ' + assistantId + ' 落库,存档之前 ' + n + ' 条消息(不再发给模型)');
|
||||
}
|
||||
// 回合内自动压缩把正在跑的任务切成了摘要,摘要一落地就地续跑:
|
||||
// 没有工具回执可用时补一条 user 指令接回原任务,否则会直接走到下面的 !hasTools 收尾,
|
||||
// 任务停在半路,要用户再喊一声才动。有工具回执时不插消息也不 continue——落到下面
|
||||
// 执行工具,回执紧跟在摘要后面,本身就是续跑输入。
|
||||
if (run.compactAuto) {
|
||||
run.compactAuto = false;
|
||||
if (!hasTools) {
|
||||
const resumeText = '上下文已压缩,请继续完成原任务。';
|
||||
const resumeId = saveMessage(sessionId, { role: 'user', content: resumeText });
|
||||
bus.emit(sessionId, 'user_message', { id: resumeId, content: resumeText, created_at: now() });
|
||||
continue;
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
if (!hasTools) {
|
||||
@@ -839,9 +1056,20 @@ async function runLoopInner(sessionId, run) {
|
||||
output = chk.error;
|
||||
isError = true;
|
||||
} else {
|
||||
// 工具执行中的增量输出(terminal 长命令):50ms 或 16KB 合并成一帧 SSE,避免逐行刷包
|
||||
let liveBuf = '';
|
||||
let liveTimer = null;
|
||||
const flushLive = () => {
|
||||
if (liveTimer) { clearTimeout(liveTimer); liveTimer = null; }
|
||||
if (!liveBuf) return;
|
||||
const chunk = liveBuf;
|
||||
liveBuf = '';
|
||||
bus.emit(sessionId, 'tool_output', { id, chunk });
|
||||
};
|
||||
try {
|
||||
output = await executeTool({ sessionId, taskDir: taskDirOf(sessionId), run, cfg, db, vision,
|
||||
output = await executeTool({ sessionId, taskDir: taskDirOf(sessionId), workDir: sessionWorkDir(sessionId), run, cfg, db, vision,
|
||||
onTaskCreated: () => { run.taskWrap = true; }, onCard: (card) => bus.emit(sessionId, 'ui_card', card),
|
||||
onOutput: (s) => { liveBuf += s; if (liveBuf.length >= 16384) flushLive(); else if (!liveTimer) liveTimer = setTimeout(flushLive, 50); },
|
||||
onDeepThink: (info) => {
|
||||
const m = (cfg.models || []).find(x => x.id === session.model_id);
|
||||
const supported = !!(m && m.thinking_params && Object.keys(m.thinking_params).length);
|
||||
@@ -854,6 +1082,7 @@ async function runLoopInner(sessionId, run) {
|
||||
output = 'Error: ' + (err && err.message || String(err));
|
||||
isError = true;
|
||||
}
|
||||
flushLive();
|
||||
}
|
||||
// 工具可返回 {text, image_rel}(read_file 读图且模型支持 vision,压缩产物在 .imgcache/,
|
||||
// text 是 imageReceipt 生成的结构化 JSON 回执):落库时以 image_ref 内容块拼进 tool 消息
|
||||
@@ -980,6 +1209,11 @@ async function streamAssistant(sessionId, run, session, messages, tools) {
|
||||
// key_slot 定位会话占用的具体 key 副本(model_id 只到「平台/模型」)
|
||||
const result = await callModel(cfg, session.model_id, messages, tools, {
|
||||
key_slot: session.model_slot,
|
||||
// 增量上下文用:<core_id>:<user>:<session_id>:<archived_cnt>。
|
||||
// archived_cnt = 已被压缩掉的行数,它就是「压缩代数」:压缩后自增 → id 自变 →
|
||||
// relay 找不到缓存并回 409 → 发全量重建。裁剪不改它(只换内容不删行),
|
||||
// 所以裁剪不会打断增量。只有带 store: true 的模型才真的用它(llm.js 判断)。
|
||||
context_id: contextIdOf(session),
|
||||
signal: run.abortController.signal,
|
||||
shouldCancel: () => run.cancelled,
|
||||
onText: delta => bus.emit(sessionId, 'assistant_delta', { text: delta }),
|
||||
@@ -1114,7 +1348,7 @@ function sleep(ms) { return new Promise(r => setTimeout(r, ms)); }
|
||||
// ---------- 对外 API ----------
|
||||
// 新建即绑模(无排队):指定了优先模型(welcome 预选)就取其平台「最不 active」的 key;
|
||||
// 模型无效或平台无槽位退回全局优先级选。池完全为空直接报错(配置问题),不建吊儿郎当的会话。
|
||||
function createSession(title, preferModelId, assistantType, user) {
|
||||
function createSession(title, preferModelId, assistantType, user, workDir) {
|
||||
// 用户锁定模型(auth.users[].model)优先于前端预选;锁定值无效/被禁用时退回原逻辑(用前端预选或全局自动选择)。
|
||||
const lock = lockedModelOf(user);
|
||||
const lockValid = !!lock && platformModels(platformOf(lock)).includes(lock);
|
||||
@@ -1135,11 +1369,13 @@ function createSession(title, preferModelId, assistantType, user) {
|
||||
if (!modelId) throw Object.assign(new Error('无可用模型:请检查配置并重启服务'), { status_code: 503 });
|
||||
}
|
||||
const id = genTaskId();
|
||||
const dir = taskDirOf(id);
|
||||
fs.mkdirSync(dir, { recursive: true });
|
||||
// 手选目录:直接当作会话工作目录(不建 task-* 子目录);未选 = 沿用 workspace_root/<会话id>。
|
||||
// 选中的目录必须已存在(normalizeWorkDir 已校验),绝不在用户目录里替它 mkdir。
|
||||
// 两种情况下目录都由工具执行时懒建(见 tools/executor.js 的 executeTool),纯文本对话不留空目录。
|
||||
const wd = normalizeWorkDir(workDir);
|
||||
db.prepare(
|
||||
"INSERT INTO sessions (id, title, status, model_id, model_slot, last_model_id, held_at, assistant_type, user, created_at, updated_at) VALUES (?,?,'held',?,?,?,?,?,?,?,?)"
|
||||
).run(id, title || '', modelId, key.id, modelId, now(), assistantType || 'secretary', user || '', now(), now());
|
||||
"INSERT INTO sessions (id, title, status, model_id, model_slot, last_model_id, held_at, assistant_type, user, work_dir, created_at, updated_at) VALUES (?,?,'held',?,?,?,?,?,?,?,?,?)"
|
||||
).run(id, title || '', modelId, key.id, modelId, now(), assistantType || 'secretary', user || '', wd, now(), now());
|
||||
db.prepare('UPDATE model_pool SET last_used_at = ? WHERE id = ?').run(now(), key.id);
|
||||
profile.freezeSnapshot(db, id); // 冻结画像快照:仅创建/清空时点注入,会话内恒定(见 user-profile.js)
|
||||
// 新建会话默认走模型配置的 profile(未配 = 全量默认组合 + profile-default.txt),不再有顾问阶段
|
||||
@@ -1186,11 +1422,16 @@ function clearPendings(sessionId) {
|
||||
}
|
||||
|
||||
// 入队。没有在跑的回合时,任何模式都等价于立即发送(队列只对运行中的回合有意义)。
|
||||
// opts.mode:
|
||||
// queue(默认)→ 排到队尾,本轮收尾后发(网页端发消息走这条)
|
||||
// interject → 插队到所有 queue 之前,下一个安全边界就投递(IM/渠道消息走这条:
|
||||
// 用户是在实时对话,不应该排在网页端被动排队的消息后面)
|
||||
function enqueueMessage(sessionId, content, opts) {
|
||||
const session = getSession(sessionId);
|
||||
if (!session) throw Object.assign(new Error('会话不存在'), { status_code: 404 });
|
||||
const text = String(content == null ? '' : content).trim();
|
||||
if (!text) throw Object.assign(new Error('content 不能为空'), { status_code: 400 });
|
||||
const mode = (opts && opts.mode) === 'interject' ? 'interject' : 'queue';
|
||||
const run = runs.get(sessionId);
|
||||
if (!run || !run.looping) {
|
||||
const r = postUserMessage(sessionId, text, { deepThink: !!(opts && opts.deepThink) });
|
||||
@@ -1198,13 +1439,19 @@ function enqueueMessage(sessionId, content, opts) {
|
||||
}
|
||||
const item = {
|
||||
id: newPendingId(), content: text,
|
||||
deepThink: !!(opts && opts.deepThink), mode: 'queue', created_at: now(),
|
||||
deepThink: !!(opts && opts.deepThink), mode, created_at: now(),
|
||||
};
|
||||
const list = pendingList(sessionId).slice();
|
||||
list.push(item);
|
||||
if (mode === 'interject') {
|
||||
// 插到第一条「排队」消息之前;已在队列里的干预消息仍保持先来后到(不反序)。
|
||||
const i = list.findIndex(x => x.mode === 'queue');
|
||||
if (i < 0) list.push(item); else list.splice(i, 0, item);
|
||||
} else {
|
||||
list.push(item);
|
||||
}
|
||||
pendings.set(sessionId, list);
|
||||
bus.emit(sessionId, 'pending_added', publicPending(item));
|
||||
log.info('msg', sessionId + ' 待投递消息入队(队列 ' + list.length + '):' + text.slice(0, 60).replace(/\s+/g, ' '));
|
||||
log.info('msg', sessionId + ' 待投递消息入队(' + mode + ',队列 ' + list.length + '):' + text.slice(0, 60).replace(/\s+/g, ' '));
|
||||
return { pending_id: item.id, queued: true, pending: list.map(publicPending) };
|
||||
}
|
||||
|
||||
@@ -1285,6 +1532,8 @@ function postUserMessage(sessionId, content, opts) {
|
||||
// 预建/更新 run 记录,记下本轮的 deepThink(被 runLoop / callModel 读取)
|
||||
const run = getRun(sessionId, true);
|
||||
run.deepThink = !!(opts && opts.deepThink);
|
||||
// 随消息落库:重进会话按它回填按钮,压缩回合也读它
|
||||
db.prepare('UPDATE sessions SET deep_think = ? WHERE id = ?').run(run.deepThink ? 1 : 0, sessionId);
|
||||
// 真实用户消息到达:若还有个「尚未开跑」的压缩回合(见 summarizeContext),
|
||||
// 让它作废,避免新消息被误当成压缩回合处理;已在跑(looping)的不动,
|
||||
// 由其收尾时自行清空 summarizing。
|
||||
@@ -1345,6 +1594,9 @@ function renameSession(sessionId, title) {
|
||||
function deleteSession(sessionId, deleteDir) {
|
||||
const session = getSession(sessionId);
|
||||
if (!session) throw Object.assign(new Error('会话不存在'), { status_code: 404 });
|
||||
// 删行前先取目录:行没了 taskDirOf 会退回默认路径,且手选目录根本不归平台管。
|
||||
const sessionDir = taskDirOf(sessionId);
|
||||
const ownWorkDir = String(session.work_dir || '');
|
||||
stop(sessionId);
|
||||
// 尽力清理该会话在 executor 侧的预览槽(officecli 预览已迁 executor/preview.js;未配 executor 静默,失败只记日志不阻断删除)
|
||||
try { rexec.killPreviewSession(cfg, sessionId); } catch (_) {}
|
||||
@@ -1354,8 +1606,10 @@ function deleteSession(sessionId, deleteDir) {
|
||||
const frags = memory.dropFragment(db, sessionId); // 日记随会话一并销毁:删掉的会话不该还活在长期记忆里
|
||||
if (frags) log.info('task', sessionId + ' 连带删除日记碎片 ' + frags + ' 条');
|
||||
autoCompressProposed.delete(sessionId); // 提议闸门随会话销毁
|
||||
if (deleteDir) {
|
||||
try { fs.rmSync(taskDirOf(sessionId), { recursive: true, force: true }); } catch (_) {}
|
||||
if (deleteDir && !ownWorkDir) {
|
||||
// 只删平台自己建的会话目录(workspace_root/<会话id>)。手选工作目录是用户的资产,
|
||||
// 多个会话可以共用同一个目录,删会话绝不能连带删用户的项目。
|
||||
try { fs.rmSync(sessionDir, { recursive: true, force: true }); } catch (_) {}
|
||||
}
|
||||
bus.closeAll(sessionId);
|
||||
return { ok: true };
|
||||
@@ -1383,10 +1637,10 @@ function summarizeContext(sessionId) {
|
||||
}
|
||||
const prompt = '正在压缩上下文:AI 将基于完整对话记录生成摘要…';
|
||||
// 与 postUserMessage 同样的唤醒语义(不再排队、不落消息行);run.summarizing 标记本回合为压缩回合,摘要产出后由 runLoopInner 清空。
|
||||
// 状态流转时顺带重置 deepThink:压缩回合不需要思考参数,避免沿用上一轮的残留值。
|
||||
// 思考参数跟会话当前状态(由发消息时落库),换开关就换请求体,历史字节不受影响。
|
||||
const r = getRun(sessionId, true);
|
||||
r.summarizing = true;
|
||||
r.deepThink = false;
|
||||
r.deepThink = !!session.deep_think;
|
||||
ensureBinding(session);
|
||||
touch(sessionId, { status: 'active', held_at: null, completed_at: null, cancelled_at: null });
|
||||
emitStatus(sessionId);
|
||||
@@ -1636,7 +1890,9 @@ function clearSessionMessages(sessionId) {
|
||||
}
|
||||
runs.delete(sessionId);
|
||||
clearPendings(sessionId); // 历史清零:队列里的消息也没了着落,一并作废
|
||||
const cid = contextIdOf(session); // 删行不影响 archived_cnt,先算后算等价
|
||||
db.prepare('DELETE FROM messages WHERE session_id = ?').run(sessionId);
|
||||
invalidateContext(cid); // 历史清零:增量指针也得跟着作废
|
||||
wipeSessionTmp(sessionId); // 会话级 /tmp 随清空一并抹掉(尽力而为,失败只记日志不阻断)
|
||||
autoCompressProposed.delete(sessionId); // 历史清零,恢复自动压缩提议额度
|
||||
// 标题随历史一并清零:旧标题描述的是已删除的对话,留着会让新对话文不对题;
|
||||
@@ -1672,6 +1928,7 @@ function deleteMessage(sessionId, messageId) {
|
||||
const row = db.prepare('SELECT * FROM messages WHERE id = ? AND session_id = ?').get(messageId, sessionId);
|
||||
if (!row) throw Object.assign(new Error('消息不存在'), { status_code: 404 });
|
||||
if (row.role === 'tool') return deleteToolMessage(sessionId, row);
|
||||
const cid = contextIdOf(session); // 删之前先算:archived_cnt 不受删行影响,两者等价,但先算更直观
|
||||
let removed = 0;
|
||||
if (row.tool_calls) {
|
||||
let calls = [];
|
||||
@@ -1683,6 +1940,9 @@ function deleteMessage(sessionId, messageId) {
|
||||
}
|
||||
}
|
||||
db.prepare('DELETE FROM messages WHERE id = ?').run(messageId);
|
||||
// 删中间一条:后面的行位置全变,但末尾行 id 没变,锚点查不出来——主动作废增量指针,
|
||||
// 下一轮改发 X-Context-Reset 全量重建,否则 relay 缓存里还留着被删那行,增量拼出来会错位。
|
||||
invalidateContext(cid);
|
||||
return { ok: true, id: messageId, removed: removed + 1 };
|
||||
}
|
||||
|
||||
@@ -1700,6 +1960,8 @@ function editUserMessage(sessionId, messageId, content, opts) {
|
||||
// 先确保能开跑:无可用模型时抛 503,避免删完历史却发不出去
|
||||
ensureBinding(session);
|
||||
const removed = db.prepare('DELETE FROM messages WHERE session_id = ? AND id >= ?').run(sessionId, messageId).changes;
|
||||
// 尾部截断:锚点本就能查出,但这里紧接着就重新发消息,一并作废指针更直接
|
||||
invalidateContext(contextIdOf(session));
|
||||
const r = postUserMessage(sessionId, content, opts);
|
||||
log.info('msg', sessionId + ' 编辑消息 ' + messageId + ',丢弃其后 ' + Math.max(0, removed - 1) + ' 条历史');
|
||||
return Object.assign({ removed: removed }, r);
|
||||
@@ -1730,6 +1992,9 @@ function deleteToolMessage(sessionId, row) {
|
||||
}
|
||||
break; // id 唯一,命中即止
|
||||
}
|
||||
// 同上:回执被删、父调用也改过 tool_calls,历史已被控——作废增量指针
|
||||
const s = getSession(sessionId);
|
||||
if (s) invalidateContext(contextIdOf(s));
|
||||
return { ok: true, id: row.id, removed };
|
||||
}
|
||||
|
||||
|
||||
@@ -0,0 +1,32 @@
|
||||
// 统一 HTTP 错误出口(Express 的四参数错误中间件,必须在所有路由之后注册)。
|
||||
//
|
||||
// 存在理由:Express 默认错误处理器只有 NODE_ENV=production 时才回一句干净的 500,
|
||||
// 其余环境把 err.stack 拼成 HTML 吐给请求方——里面是服务端绝对路径、源码文件名+行号、
|
||||
// 依赖版本。本地形态 NODE_ENV 通常未设置,等于默认开启。而 /p/<id> 这类端点匿名可达
|
||||
// (见 routes/public-files.js),一次 sendFile 失败就能把整份栈打到公网。
|
||||
//
|
||||
// 策略:状态码照旧透出(body-parser 的 400/413、send 的 404 都靠它,客户端要能区分),
|
||||
// 正文永远固定一句,栈只进日志。
|
||||
'use strict';
|
||||
|
||||
const log = require('./log');
|
||||
|
||||
// 只认 err.status / err.statusCode 里的合法 4xx-5xx;其余(含没状态码的普通 Error)一律 500。
|
||||
function statusOf(err) {
|
||||
const s = Number(err && (err.status || err.statusCode));
|
||||
return s >= 400 && s <= 599 ? s : 500;
|
||||
}
|
||||
|
||||
function errorHandler(err, req, res, next) { // eslint-disable-line no-unused-vars
|
||||
const status = statusOf(err);
|
||||
const where = (req && req.method ? req.method + ' ' + (req.originalUrl || req.url || '') : '(unknown)');
|
||||
// 5xx = 未预期异常,栈进日志;4xx 是调用方问题,一行 message 足够。
|
||||
if (status >= 500) log.error('http', where + ' → ' + status + ':' + ((err && err.stack) || err));
|
||||
else log.warn('http', where + ' → ' + status + ':' + ((err && err.message) || err));
|
||||
|
||||
if (res.headersSent) { if (res.destroy) res.destroy(); return; } // 响应已开始,只能断开
|
||||
res.removeHeader('Content-Disposition'); // 可能已被 download-send 设过,错误体不该带文件名
|
||||
res.status(status).type('text').send(status >= 500 ? 'internal error' : 'request failed');
|
||||
}
|
||||
|
||||
module.exports = { errorHandler, statusOf };
|
||||
@@ -0,0 +1,280 @@
|
||||
// 只读 git 数据层:仓库探测 / 提交列表 / 提交详情 / 未提交改动详情。
|
||||
// 一律 execFile + 参数数组(不经 shell),只跑 rev-parse / status / log / show / diff,不碰任何写操作。
|
||||
// -c core.quotepath=false:中文路径原样返回,不转义成 \346\226\207 那种八进制。
|
||||
const { execFile } = require('child_process');
|
||||
const fs = require('fs');
|
||||
|
||||
const TIMEOUT = 8000;
|
||||
const MAX_BUFFER = 8 * 1024 * 1024;
|
||||
const PATCH_FILE_MAX = 120 * 1024; // 单文件 diff 字符上限
|
||||
const PATCH_TOTAL_MAX = 400 * 1024; // 整页 diff 字符上限
|
||||
const UNTRACKED_MAX_BYTES = 512 * 1024; // 未跟踪文件超过此大小不生成 diff
|
||||
const MAX_FILES = 300; // 一次最多返回的文件数
|
||||
|
||||
const BASE = ['-c', 'core.quotepath=false'];
|
||||
|
||||
function run(dir, args) {
|
||||
return new Promise((resolve, reject) => {
|
||||
// cwd 不存在时 execFile 也报 ENOENT,会和「没装 git」混为一谈,先自己挡掉
|
||||
let isDir = false;
|
||||
try { isDir = fs.statSync(dir).isDirectory(); } catch (_) { isDir = false; }
|
||||
if (!isDir) return reject(Object.assign(new Error('会话目录不存在'), { reason: 'not_repo' }));
|
||||
execFile('git', BASE.concat(args), { cwd: dir, timeout: TIMEOUT, maxBuffer: MAX_BUFFER }, (err, stdout, stderr) => {
|
||||
if (!err) return resolve(stdout);
|
||||
err.stdout = String(stdout || '');
|
||||
err.stderr = String(stderr || '').trim();
|
||||
reject(err);
|
||||
});
|
||||
});
|
||||
}
|
||||
|
||||
function reasonOf(err) {
|
||||
if (err && err.code === 'ENOENT') return 'no_git';
|
||||
if (err && err.code === 'ETIMEDOUT') return 'timeout';
|
||||
return 'not_repo';
|
||||
}
|
||||
|
||||
// 仓库信息:root 用 --show-toplevel(会话目录可能是仓库子目录);空仓库没有 HEAD,不算错。
|
||||
async function ensureRepo(dir) {
|
||||
let root;
|
||||
try {
|
||||
root = (await run(dir, ['rev-parse', '--show-toplevel'])).trim();
|
||||
} catch (err) {
|
||||
throw Object.assign(new Error(err.code === 'ENOENT' ? '未安装 git' : '当前目录不是 git 仓库'), { reason: reasonOf(err) });
|
||||
}
|
||||
if (!root) throw Object.assign(new Error('当前目录不是 git 仓库'), { reason: 'not_repo' });
|
||||
let branch = '';
|
||||
let head = '';
|
||||
try { branch = (await run(root, ['symbolic-ref', '--short', '-q', 'HEAD'])).trim(); } catch (_) { /* detached */ }
|
||||
try { head = (await run(root, ['rev-parse', '--short', 'HEAD'])).trim(); } catch (_) { /* 空仓库 */ }
|
||||
// remote:列表里要能看出这个仓库推到哪。只取第一条 fetch(origin 惯例在最前);
|
||||
// URL 里的 user:pass 脱敏,免得面板上直接暴露凭据。
|
||||
let remote = null;
|
||||
try {
|
||||
const first = (await run(root, ['remote', '-v'])).split('\n').filter(Boolean)[0] || '';
|
||||
const m = /^(\S+)\s+(\S+)\s+\(fetch\)/.exec(first);
|
||||
if (m) remote = { name: m[1], url: m[2].replace(/\/\/[^/@]+@/, '//***@') };
|
||||
} catch (_) { /* 没配 remote */ }
|
||||
// upstream:列表要把 origin/master 标在它指向的那条提交上,一眼看出本地领先几条。
|
||||
// 优先当前分支的 upstream,没配就回退 origin/master。
|
||||
let upstream = null;
|
||||
try {
|
||||
const ref = (await run(root, ['rev-parse', '--abbrev-ref', '--symbolic-full-name', '@{u}'])).trim();
|
||||
if (ref) upstream = { ref, id: (await run(root, ['rev-parse', ref])).trim() };
|
||||
} catch (_) {
|
||||
try { upstream = { ref: 'origin/master', id: (await run(root, ['rev-parse', 'origin/master'])).trim() }; } catch (__) { upstream = null; }
|
||||
}
|
||||
return { root, branch: branch || (head ? 'detached' : ''), head, remote, upstream };
|
||||
}
|
||||
|
||||
// 把一个整段 diff 按 `diff --git` 切开,键是文件路径。
|
||||
// 路径优先取 `+++ b/...`(改后),删除文件取 `--- a/...`;都没有就等于没有内容变化(仅 mode 变更)。
|
||||
function patchPath(body) {
|
||||
const plus = body.match(/^\+\+\+ b\/(.+)$/m);
|
||||
if (plus) return plus[1].replace(/\t$/, '');
|
||||
const minus = body.match(/^--- a\/(.+)$/m);
|
||||
if (minus) return minus[1].replace(/\t$/, '');
|
||||
const head = body.match(/^diff --git a\/(.+) b\/(.+)$/m);
|
||||
return head ? head[2] : null;
|
||||
}
|
||||
|
||||
function splitPatch(text) {
|
||||
const out = new Map();
|
||||
if (!text) return out;
|
||||
const parts = String(text).split(/^diff --git /m);
|
||||
for (let i = 1; i < parts.length; i++) {
|
||||
const body = 'diff --git ' + parts[i];
|
||||
const p = patchPath(body);
|
||||
if (p) out.set(p, body);
|
||||
}
|
||||
return out;
|
||||
}
|
||||
|
||||
function countLines(patch) {
|
||||
let adds = 0;
|
||||
let dels = 0;
|
||||
for (const line of String(patch).split('\n')) {
|
||||
if (line.charAt(0) === '+' && line.charAt(1) !== '+') adds++;
|
||||
else if (line.charAt(0) === '-' && line.charAt(1) !== '-') dels++;
|
||||
}
|
||||
return { adds, dels };
|
||||
}
|
||||
|
||||
function statusOf(patch, fallback) {
|
||||
if (/^new file mode /m.test(patch)) return 'A';
|
||||
if (/^deleted file mode /m.test(patch)) return 'D';
|
||||
if (/^rename from /m.test(patch) || /^copy from /m.test(patch)) return 'R';
|
||||
if (/^Binary files .* differ$/m.test(patch) || /^GIT binary patch$/m.test(patch)) return fallback || 'M';
|
||||
return fallback || 'M';
|
||||
}
|
||||
|
||||
function isBinary(patch) {
|
||||
return /^Binary files .* differ$/m.test(patch) || /^GIT binary patch$/m.test(patch);
|
||||
}
|
||||
|
||||
// 裁剪 + 汇总。逐文件先裁,再按总量裁(超出的文件保留路径与统计,patch 置空并标 truncated)。
|
||||
function buildFiles(map, order, extra) {
|
||||
const files = [];
|
||||
const byPath = new Map();
|
||||
let budget = PATCH_TOTAL_MAX;
|
||||
for (const p of order) {
|
||||
if (files.length >= MAX_FILES) break;
|
||||
const raw = map.get(p) || '';
|
||||
const binary = isBinary(raw);
|
||||
let patch = raw;
|
||||
let truncated = false;
|
||||
if (patch.length > PATCH_FILE_MAX) { patch = patch.slice(0, PATCH_FILE_MAX); truncated = true; }
|
||||
if (patch.length > budget) { patch = ''; truncated = true; }
|
||||
budget -= patch.length;
|
||||
const counts = binary ? { adds: 0, dels: 0 } : countLines(patch);
|
||||
const item = {
|
||||
path: p,
|
||||
status: extra && extra[p] ? extra[p].status : statusOf(raw, extra && extra[p] && extra[p].status),
|
||||
adds: counts.adds,
|
||||
dels: counts.dels,
|
||||
binary: binary,
|
||||
truncated: truncated,
|
||||
patch: binary ? '' : patch,
|
||||
};
|
||||
if (extra && extra[p] && extra[p].old_path) item.old_path = extra[p].old_path;
|
||||
files.push(item);
|
||||
byPath.set(p, item);
|
||||
}
|
||||
return files;
|
||||
}
|
||||
|
||||
function summarize(files) {
|
||||
let adds = 0;
|
||||
let dels = 0;
|
||||
for (const f of files) { adds += f.adds; dels += f.dels; }
|
||||
return { stats: { files: files.length, adds, dels } };
|
||||
}
|
||||
|
||||
// git status --porcelain -z:拿未跟踪文件和状态字母(已跟踪文件的 patch 统一从 `diff HEAD` 拆)
|
||||
// -z 必须加:不加引号规则下含空格的路径会被写成 "a b.txt",和 diff 里的裸路径对不上,会多出幽灵条目。
|
||||
// -z 里改名的旧路径是紧随其后的一条 NUL 分隔记录。
|
||||
function worktreeEntries(out) {
|
||||
const entries = [];
|
||||
const parts = String(out || '').split('\0');
|
||||
for (let i = 0; i < parts.length; i++) {
|
||||
const line = parts[i];
|
||||
if (!line || line.length < 4) continue;
|
||||
const xy = line.slice(0, 2);
|
||||
const p = line.slice(3);
|
||||
let oldPath = '';
|
||||
if (/[RC]/.test(xy)) {
|
||||
oldPath = parts[i + 1] || '';
|
||||
i++;
|
||||
}
|
||||
let status = 'M';
|
||||
if (xy === '??') status = 'U';
|
||||
else if (xy.indexOf('A') >= 0) status = 'A';
|
||||
else if (xy.indexOf('D') >= 0) status = 'D';
|
||||
else if (xy.indexOf('R') >= 0) status = 'R';
|
||||
entries.push({ path: p, old_path: oldPath || undefined, status });
|
||||
}
|
||||
return entries;
|
||||
}
|
||||
|
||||
// 未跟踪文件没有 diff:用 --no-index 对 /dev/null 造一个(退出码 1 = 有差异,属正常)
|
||||
async function untrackedPatch(root, rel) {
|
||||
const abs = root + '/' + rel;
|
||||
try {
|
||||
const st = fs.statSync(abs);
|
||||
if (!st.isFile() || st.size > UNTRACKED_MAX_BYTES) return { patch: '', binary: st.size > UNTRACKED_MAX_BYTES };
|
||||
} catch (_) { return { patch: '', binary: false }; }
|
||||
try {
|
||||
return { patch: await run(root, ['diff', '--no-index', '--', '/dev/null', rel]), binary: false };
|
||||
} catch (err) {
|
||||
if (err.code === 1) return { patch: err.stdout, binary: false };
|
||||
return { patch: '', binary: false };
|
||||
}
|
||||
}
|
||||
|
||||
async function worktreeDetail(root) {
|
||||
let entries = [];
|
||||
try { entries = worktreeEntries(await run(root, ['status', '--porcelain', '-z'])); }
|
||||
catch (_) { entries = []; }
|
||||
let all = '';
|
||||
try { all = await run(root, ['diff', 'HEAD']); } catch (_) { all = ''; } // 空仓库没有 HEAD
|
||||
const map = splitPatch(all);
|
||||
const extra = {};
|
||||
for (const e of entries) extra[e.path] = e;
|
||||
const order = [];
|
||||
for (const e of entries) order.push(e.path);
|
||||
for (const p of map.keys()) if (!extra[p]) { extra[p] = { status: 'M' }; order.push(p); }
|
||||
for (const e of entries) {
|
||||
if (e.status !== 'U' || map.has(e.path)) continue;
|
||||
const r = await untrackedPatch(root, e.path);
|
||||
if (r.patch) map.set(e.path, r.patch);
|
||||
else if (r.binary) extra[e.path].binary = true;
|
||||
}
|
||||
const files = buildFiles(map, order, extra);
|
||||
return { kind: 'worktree', commit: null, files: files, ...summarize(files) };
|
||||
}
|
||||
|
||||
// git log:before 是上一页最后一条的 commit id,用 `<id>^` 翻页(git 天然不含自身)。
|
||||
async function listCommits(dir, before, limit) {
|
||||
const repo = await ensureRepo(dir);
|
||||
const n = Math.max(1, Math.min(100, limit || 30));
|
||||
const args = ['log', '--max-count=' + (n + 1), '--pretty=format:%H%x1f%h%x1f%an%x1f%aI%x1f%s'];
|
||||
if (before) args.push(before + '^', '--');
|
||||
let out = '';
|
||||
try { out = await run(repo.root, args); } catch (err) {
|
||||
if (before) return { ok: true, repo, worktree: null, commits: [], next: null }; // 已经翻到底
|
||||
if (reasonOf(err) === 'no_git') throw err;
|
||||
return { ok: true, repo, worktree: null, commits: [], next: null }; // 空仓库
|
||||
}
|
||||
const rows = out.split('\n').filter(Boolean).map((line) => {
|
||||
const f = line.split('\x1f');
|
||||
return { id: f[0], short: f[1], author: f[2], time: f[3], subject: f[4] || '' };
|
||||
});
|
||||
const hasMore = rows.length > n;
|
||||
const commits = hasMore ? rows.slice(0, n) : rows;
|
||||
const next = hasMore && commits.length ? commits[commits.length - 1].id : null;
|
||||
let worktree = null;
|
||||
try {
|
||||
const st = await run(repo.root, ['status', '--porcelain']);
|
||||
worktree = { files: st.split('\n').filter(Boolean).length };
|
||||
} catch (_) { worktree = null; }
|
||||
return { ok: true, repo, worktree, commits, next };
|
||||
}
|
||||
|
||||
async function commitDetail(dir, rev) {
|
||||
const repo = await ensureRepo(dir);
|
||||
if (rev === 'worktree') {
|
||||
const d = await worktreeDetail(repo.root);
|
||||
return { ok: true, repo, ...d };
|
||||
}
|
||||
let meta;
|
||||
try {
|
||||
meta = await run(repo.root, ['show', '-s', '--first-parent', '--format=%H%x1f%h%x1f%an%x1f%ae%x1f%aI%x1f%P%x1f%s%x1f%b', rev]);
|
||||
} catch (err) {
|
||||
throw Object.assign(new Error('提交不存在或读取失败'), { reason: 'bad_rev' });
|
||||
}
|
||||
const f = meta.split('\x1f');
|
||||
const commit = {
|
||||
id: f[0], short: f[1], author: f[2], email: f[3], time: f[4],
|
||||
parents: String(f[5] || '').split(' ').filter(Boolean),
|
||||
subject: f[6] || '', body: (f[7] || '').replace(/\s+$/, ''),
|
||||
};
|
||||
// --first-parent:合并提交默认不出 patch,跟第一个父提交比才是"这次合并带进来什么"
|
||||
let all = '';
|
||||
try { all = await run(repo.root, ['show', '--first-parent', '--format=', '--patch', rev]); } catch (_) { all = ''; }
|
||||
const map = splitPatch(all);
|
||||
const order = [...map.keys()];
|
||||
const files = buildFiles(map, order, null);
|
||||
return { ok: true, repo, kind: 'commit', commit, files, ...summarize(files) };
|
||||
}
|
||||
|
||||
// 统一入口:ok:false 只用于「不是仓库 / 没装 git / 会话不存在」,前端按 reason 出空状态
|
||||
async function query(dir, kind, opts) {
|
||||
try {
|
||||
if (kind === 'commits') return await listCommits(dir, opts && opts.before, opts && opts.limit);
|
||||
return await commitDetail(dir, (opts && opts.rev) || '');
|
||||
} catch (err) {
|
||||
return { ok: false, reason: (err && err.reason) || 'not_repo', error: String((err && err.message) || err) };
|
||||
}
|
||||
}
|
||||
|
||||
module.exports = { query };
|
||||
@@ -0,0 +1,29 @@
|
||||
'use strict';
|
||||
// 实例标识:跨 core 隔离用,作 relay 的 X-Context-Id 前缀。
|
||||
// 首次启动生成并落盘到 <data_root>/instance-id,之后只读同一个值。
|
||||
// 删了数据目录会换新 id —— 旧缓存成孤儿,由 relay 的 TTL 自行清理,不影响正确性。
|
||||
const fs = require('node:fs');
|
||||
const path = require('node:path');
|
||||
const crypto = require('node:crypto');
|
||||
|
||||
const cache = new Map(); // dataRoot -> id
|
||||
|
||||
function instanceId(dataRoot) {
|
||||
const root = path.resolve(String(dataRoot || '.'));
|
||||
if (cache.has(root)) return cache.get(root);
|
||||
const file = path.join(root, 'instance-id');
|
||||
let id = '';
|
||||
try {
|
||||
id = fs.readFileSync(file, 'utf8').trim();
|
||||
} catch (_) {}
|
||||
if (!/^[0-9a-f]{12}$/.test(id)) {
|
||||
id = crypto.randomBytes(6).toString('hex');
|
||||
try {
|
||||
fs.writeFileSync(file, id + '\n');
|
||||
} catch (_) {}
|
||||
}
|
||||
cache.set(root, id);
|
||||
return id;
|
||||
}
|
||||
|
||||
module.exports = { instanceId };
|
||||
+214
-60
@@ -3,6 +3,11 @@
|
||||
const fs = require('fs');
|
||||
const path = require('path');
|
||||
|
||||
// 增量上下文:context_id -> { len }(本进程认为 relay 已存到第几条)。
|
||||
// 只存指针不存正文;进程重启即清空 → 下一轮发全量,relay 整段替换,行为正确。
|
||||
// 不存 hash:id 里已经带 archived_cnt(压缩代数),压缩后 id 自变、缓存自然对不上。
|
||||
const ctxState = new Map();
|
||||
|
||||
const SYSTEM_PROMPT_TEMPLATE = fs.readFileSync(path.join(__dirname, 'templates', 'profile-default.txt'), 'utf8');
|
||||
|
||||
// 上下文压缩提示词(templates/prompt-compress.txt):点「压缩」时不插入指令消息。
|
||||
@@ -58,6 +63,26 @@ function setProfilePrompts(map) {
|
||||
// system prompt 每次请求都随 messages 发出,拼接结果按 (profile, 语言) 缓存,不重复分配大字符串。
|
||||
let _promptTextCache = new Map(); // 'profile\u0000lang' -> text
|
||||
|
||||
// 部署形态决定的环境段:模板里的 {APP_ENV_SECTION} 由两份小模板填充(mode 由 server.js 启动时选定)。
|
||||
// 为什么不能写成一段「两边都成立」的话:服务器形态是容器(每会话隔离、会话级 /tmp、只读 skills),
|
||||
// 本地形态是用户自己那台机器(无沙箱、真实共享 /tmp)——两边的环境事实互相矛盾,混着写会误导模型。
|
||||
// 只选一次、进程内恒定,和技能段同属「前缀缓存不得抖动」的部分。
|
||||
const APP_ENV_TOKEN = '{APP_ENV_SECTION}';
|
||||
const ENV_TEXTS = {
|
||||
server: fs.readFileSync(path.join(__dirname, 'templates', 'env-server.txt'), 'utf8').trim(),
|
||||
local: fs.readFileSync(path.join(__dirname, 'templates', 'env-local.txt'), 'utf8').trim(),
|
||||
};
|
||||
let ENV_TEXT = ENV_TEXTS.server;
|
||||
function setEnvMode(mode) {
|
||||
ENV_TEXT = ENV_TEXTS[mode] || ENV_TEXTS.server;
|
||||
_promptTextCache = new Map(); // 环境段换了,拼接结果必须重建
|
||||
}
|
||||
|
||||
// 自定义 profile prompt 里写了占位符也照样生效(没写就是没有环境段,同技能段规则)。
|
||||
function withEnvSection(text) {
|
||||
return text.indexOf(APP_ENV_TOKEN) >= 0 ? text.split(APP_ENV_TOKEN).join(ENV_TEXT) : text;
|
||||
}
|
||||
|
||||
// “可用技能”段落(skills.formatSkillListForPrompt):启动时快照(server.js)与技能变更后
|
||||
//(routes/skills.js)经 setSkillListText 更新。插入位置由模板内的 {APP_SKILLS_SECTION} 占位符决定
|
||||
//(拼在技能规则旁边,模型一眼看到清单,不再盲猜尾部多出来的孤儿段落):
|
||||
@@ -85,12 +110,9 @@ function systemPromptText(language, profile) {
|
||||
const key = (profile || 'default') + '\u0000' + t;
|
||||
const hit = _promptTextCache.get(key);
|
||||
if (hit) return hit;
|
||||
let text;
|
||||
if (profile && PROFILE_PROMPTS[profile]) {
|
||||
text = withSkillList(PROFILE_PROMPTS[profile], false); // 自定义文件:没放占位符就真没有技能段
|
||||
} else {
|
||||
text = withSkillList(SYSTEM_PROMPT_TEMPLATE, true);
|
||||
}
|
||||
// 环境段先替(模板里的占位符),再拼技能段:自定义 prompt 没放占位符就真没有环境段/技能段
|
||||
const custom = profile && PROFILE_PROMPTS[profile];
|
||||
let text = withSkillList(withEnvSection(custom || SYSTEM_PROMPT_TEMPLATE), !custom);
|
||||
if (t) text += '\n\n## Reply Language\n' +
|
||||
'- ALWAYS respond to the user in ' + t + '. Tool descriptions, tool outputs and errors are usually in English — ' +
|
||||
'never let them switch your reply language. Tool names, parameters, code, file paths and shell commands stay as-is; ' +
|
||||
@@ -198,19 +220,26 @@ function buildMessages(session, language, mintUrl, profile, withProfile, trimOn)
|
||||
const ids = new Set(history.map(r => r.id));
|
||||
for (const k of Array.from(session.blocksCache.keys())) if (!ids.has(k)) session.blocksCache.delete(k);
|
||||
}
|
||||
// 裁剪预扫:① 每行距尾的 assistant 轮数(从尾往头扫);② tool_call id → function
|
||||
// (给 fetch/read_file 占位回填 url/path)。trimOn=false 时整个跳过(压缩回合)。
|
||||
const trimActive = trimOn !== false && (TRIM.writeRounds > 0 || TRIM.resultRounds > 0);
|
||||
// 裁剪预扫:① 每行距尾的 assistant 轮数(rounds)与真人回合数(turns),一趟从尾往头扫;
|
||||
// ② tool_call id → function(result 侧规则需要反查工具名)。
|
||||
// turns 只数「真实用户消息」(role=user 且 type 为空):channel_note / memory_note 这类注入行
|
||||
// 不是回合边界(与 engine 立题同口径),数进去会让回合数虚高、提前裁掉本回合的内容。
|
||||
// trimOn=false(压缩回合)或没配规则时整个跳过。
|
||||
const trimActive = trimOn !== false && (TRIM.argsByTool.size > 0 || TRIM.resultByTool.size > 0);
|
||||
const roundsAfter = new Map();
|
||||
const turnsAfter = new Map();
|
||||
const callById = new Map();
|
||||
if (trimActive) {
|
||||
let n = 0;
|
||||
let t = 0;
|
||||
for (let i = history.length - 1; i >= 0; i--) {
|
||||
const r = history[i];
|
||||
roundsAfter.set(r.id, n);
|
||||
turnsAfter.set(r.id, t);
|
||||
if (r.role === 'user' && r.type == null) t++;
|
||||
if (r.role === 'assistant' && r.type !== 'archived' && r.type !== 'errAck') n++;
|
||||
}
|
||||
if (TRIM.resultRounds > 0) {
|
||||
if (TRIM.resultByTool.size > 0) {
|
||||
for (const r of history) {
|
||||
if (r.role !== 'assistant' || !r.tool_calls) continue;
|
||||
try { for (const c of JSON.parse(r.tool_calls) || []) if (c && c.id && c.function) callById.set(c.id, c.function); } catch (_) {}
|
||||
@@ -281,10 +310,12 @@ function buildMessages(session, language, mintUrl, profile, withProfile, trimOn)
|
||||
history.forEach((row, i) => {
|
||||
// archived:UI 可见,但不进入模型上下文(节省 token)
|
||||
if (row.type === 'archived') return;
|
||||
// error_note:失败文案,只给 UI 留痕,不进模型(否则被当成模型的真实回复带下去)
|
||||
if (row.type === 'error_note') return;
|
||||
// summarize_request(旧版遗留行):仅在未收尾的旧压缩回合内发给模型,其余一律跳过
|
||||
if (row.type === 'summarize_request') {
|
||||
if (i > lastClosingAssistant && (row.content || '').trim()) {
|
||||
messages.push({ role: 'user', content: row.content });
|
||||
messages.push({ role: 'user', content: row.content, __rowId: row.id });
|
||||
}
|
||||
return;
|
||||
}
|
||||
@@ -314,7 +345,7 @@ function buildMessages(session, language, mintUrl, profile, withProfile, trimOn)
|
||||
});
|
||||
return;
|
||||
}
|
||||
const m = { role: 'assistant', content: row.content || '' };
|
||||
const m = { role: 'assistant', content: row.content || '', __rowId: row.id };
|
||||
// 思维链回传原料:存库 reasoning 随原样带给 callModel(中性内部键,按模型
|
||||
// reasoning_ack_field 改名注入后此键必被剥除,不会泄往上游)。
|
||||
if (row.reasoning) m.__reasoning = row.reasoning;
|
||||
@@ -331,7 +362,7 @@ function buildMessages(session, language, mintUrl, profile, withProfile, trimOn)
|
||||
} else {
|
||||
m.tool_calls = paired;
|
||||
for (const c of paired) emittedCallIds.add(c.id);
|
||||
if (trimActive && TRIM.writeRounds > 0) trimWriteCalls(m.tool_calls, roundsAfter.get(row.id) || 0);
|
||||
if (trimActive && TRIM.argsByTool.size > 0) trimToolCallArgs(m.tool_calls, roundsAfter.get(row.id) || 0, turnsAfter.get(row.id) || 0);
|
||||
}
|
||||
}
|
||||
if (!m.content) delete m.content;
|
||||
@@ -394,10 +425,10 @@ function buildMessages(session, language, mintUrl, profile, withProfile, trimOn)
|
||||
}
|
||||
}
|
||||
if (row.role === 'tool') {
|
||||
if (trimActive && typeof content === 'string') content = trimToolContent(content, row, callById, roundsAfter);
|
||||
messages.push({ role: 'tool', tool_call_id: row.tool_call_id, name: row.name, content });
|
||||
if (trimActive && typeof content === 'string') content = trimToolContent(content, row, callById, roundsAfter, turnsAfter);
|
||||
messages.push({ role: 'tool', tool_call_id: row.tool_call_id, name: row.name, content, __rowId: row.id });
|
||||
} else {
|
||||
messages.push({ role: row.role, content });
|
||||
messages.push({ role: row.role, content, __rowId: row.id });
|
||||
}
|
||||
});
|
||||
// 未消费图片合并发送:图上文字置顶、图块紧随(同序)。
|
||||
@@ -422,52 +453,93 @@ function buildMessages(session, language, mintUrl, profile, withProfile, trimOn)
|
||||
}
|
||||
|
||||
// ---------- 重负载占位裁剪(历史重放省 token) ----------
|
||||
// fetch/read_file 回执与 write_file 参数正文是重放里最贵的存量,且都可再生:文件在盘上、
|
||||
// 页面可重抓;write 参数只是当时快照(后续 edit_file 一次就失真,本就不该被当现势引用)。
|
||||
// 组装请求时对「距尾 ≥N 个 assistant 轮」的行换单行占位:纯函数、DB 不动(UI 工具卡照旧
|
||||
// 可展全量)、与压缩归档正交(archived 行本来就不进模型)。距离按现存行数 assistant 轮:
|
||||
// 删中间消息可让已占位行短暂复活全文(一次性断前缀缓存,与图片消费 i<lastAck 同一
|
||||
// 语义,接受)。阈值可配(config agent.trim_write_rounds / trim_result_rounds,0=关),
|
||||
// 启动时 setPayloadTrim 注入。
|
||||
let TRIM = { writeRounds: 1, resultRounds: 2 };
|
||||
const TRIM_MIN_CHARS = 600; // 短正文不裁:占位行自身成本接近原文,裁了反而胀
|
||||
function setPayloadTrim(agentCfg) {
|
||||
const a = agentCfg || {};
|
||||
const toN = (v, d) => { const n = Math.floor(Number(v)); return Number.isFinite(n) ? Math.max(0, n) : d; };
|
||||
TRIM = { writeRounds: toN(a.trim_write_rounds, 1), resultRounds: toN(a.trim_result_rounds, 2) };
|
||||
// 策略只在配置里:默认值来自 config.js 的 DEFAULTS.agent.trim.rules,config.yml 写了
|
||||
// agent.trim.rules 就整体替换([] = 全关)。本模块不含任何工具名或默认阈值;未注入 = 不裁剪。
|
||||
// 语义:某条工具调用/回执距对话尾部 ≥rounds 个 assistant 轮**且** ≥turns 个真人回合后,把其中
|
||||
//「可再生的重负载」——args 侧指定参数正文、result 侧整段回执——换成单行占位再发给上游。
|
||||
// rounds = 「后面 AI 又说了几句话」,turns = 「后面又来了几条真人消息」;
|
||||
// turns:1 就是「回合内绝不裁,跨过用户回合边界才裁」(长回合里防模型反复重读同一段)。
|
||||
// 只应给可再生/快照型工具开规则:占位只改发给上游的副本(DB/UI 照旧可看全量),但模型侧
|
||||
// 一旦被裁就再也看不到那段内容(如 terminal 的一次性输出)。
|
||||
// 纯函数、与压缩归档正交(archived 行本来就不进模型)。距离按现存行数:删中间消息可让已占位行
|
||||
// 短暂复活全文(一次性断前缀缓存,与图片消费 i<lastAck 同一语义,接受)。
|
||||
function compileTrimRules(rules) {
|
||||
const argsByTool = new Map();
|
||||
const resultByTool = new Map();
|
||||
for (const r of rules || []) {
|
||||
if (!r || !r.tool) continue;
|
||||
const rounds = Math.max(0, Math.floor(Number(r.rounds)) || 0);
|
||||
const turns = Math.max(0, Math.floor(Number(r.turns)) || 0);
|
||||
// 两个距离都写 0 = 规则关闭(config.js 归一化时已丢弃,这里兼容手搓 cfg)
|
||||
if (rounds <= 0 && turns <= 0) continue;
|
||||
const rule = {
|
||||
rounds,
|
||||
turns,
|
||||
minChars: Math.max(0, Math.floor(Number(r.min_chars)) || 0),
|
||||
fields: Array.isArray(r.fields) ? r.fields.map(String) : [],
|
||||
statusRe: null,
|
||||
};
|
||||
if (r.side === 'result' && r.status_regex) {
|
||||
try { rule.statusRe = new RegExp(String(r.status_regex)); } catch (_) { /* config.js 已校验 */ }
|
||||
}
|
||||
if (r.side === 'args') argsByTool.set(String(r.tool), rule);
|
||||
else if (r.side === 'result') resultByTool.set(String(r.tool), rule);
|
||||
}
|
||||
return { argsByTool, resultByTool };
|
||||
}
|
||||
// write_file 参数占位:只洗 content。AI 友好记号风格:键值对、不写整句——path 不必重复,
|
||||
// 本条 arguments 里就还在;改写的是已 parse 副本,DB 行不动,重新 stringify 保持 JSON 合法。
|
||||
function trimWriteCalls(calls, rounds) {
|
||||
if (rounds < TRIM.writeRounds) return;
|
||||
let TRIM = compileTrimRules([]);
|
||||
function setPayloadTrim(agentCfg) {
|
||||
const trim = (agentCfg && agentCfg.trim && typeof agentCfg.trim === 'object' && !Array.isArray(agentCfg.trim))
|
||||
? agentCfg.trim : {};
|
||||
TRIM = compileTrimRules(Array.isArray(trim.rules) ? trim.rules : []);
|
||||
}
|
||||
function omittedMarker(size, extra) {
|
||||
return '[OMITTED' + (extra || '') + ', size=' + size + ']';
|
||||
}
|
||||
// args 侧占位:只洗规则点名的顶层字符串参数,其余参数原样保留(path/url 等恢复指针不动)。
|
||||
// 改写的是已 parse 副本,DB 行不动,重新 stringify 保持 JSON 合法。
|
||||
function trimToolCallArgs(calls, rounds, turns) {
|
||||
for (const c of calls || []) {
|
||||
if (!c || !c.function || c.function.name !== 'write_file') continue;
|
||||
if (!c || !c.function) continue;
|
||||
const rule = TRIM.argsByTool.get(c.function.name);
|
||||
if (!rule || rounds < rule.rounds || turns < rule.turns) continue;
|
||||
let args;
|
||||
try { args = JSON.parse(c.function.arguments || ''); } catch (_) { continue; }
|
||||
if (!args || typeof args.content !== 'string' || args.content.length < TRIM_MIN_CHARS) continue;
|
||||
args.content = '[OMITTED, size=' + args.content.length + ']';
|
||||
c.function.arguments = JSON.stringify(args);
|
||||
if (!args || typeof args !== 'object' || Array.isArray(args)) continue;
|
||||
let changed = false;
|
||||
for (const f of rule.fields) {
|
||||
const v = args[f];
|
||||
if (typeof v !== 'string' || v.length < rule.minChars) continue;
|
||||
args[f] = omittedMarker(v.length);
|
||||
changed = true;
|
||||
}
|
||||
if (changed) c.function.arguments = JSON.stringify(args);
|
||||
}
|
||||
}
|
||||
// fetch/read_file 回执占位:同款键值记号。url/path 不进占位——发起调用的 assistant 行仍载着
|
||||
// 它们,参数本身就是恢复指针。图片回执(blocks 非空)不碰:已有自己的消费省略逻辑。
|
||||
function trimToolContent(content, row, callById, roundsAfter) {
|
||||
if (TRIM.resultRounds <= 0 || content.length < TRIM_MIN_CHARS) return content;
|
||||
if ((roundsAfter.get(row.id) || 0) < TRIM.resultRounds) return content;
|
||||
// result 侧占位:整段回执换单行。图片回执(blocks 非空)在上游分支里已还原成文字/图块,
|
||||
// 这里只处理纯文本;status_regex 可把状态码写进占位(如 fetch 的 HTTP 状态)。
|
||||
function trimToolContent(content, row, callById, roundsAfter, turnsAfter) {
|
||||
if (typeof content !== 'string') return content;
|
||||
const fn = callById.get(row.tool_call_id);
|
||||
const name = row.name || (fn && fn.name) || '';
|
||||
if (name !== 'fetch' && name !== 'read_file') return content;
|
||||
if (name === 'fetch') {
|
||||
const hm = /^HTTP (\d{3})/.exec(content);
|
||||
return '[OMITTED' + (hm ? ', http_status=' + hm[1] : '') + ', size=' + content.length + ']';
|
||||
const rule = TRIM.resultByTool.get(name);
|
||||
if (!rule) return content;
|
||||
if ((roundsAfter.get(row.id) || 0) < rule.rounds) return content;
|
||||
if ((turnsAfter.get(row.id) || 0) < rule.turns) return content;
|
||||
if (content.length < rule.minChars) return content;
|
||||
let extra = '';
|
||||
if (rule.statusRe) {
|
||||
const m = rule.statusRe.exec(content);
|
||||
if (m && m[1]) extra = ', http_status=' + m[1];
|
||||
}
|
||||
return '[OMITTED, size=' + content.length + ']';
|
||||
return omittedMarker(content.length, extra);
|
||||
}
|
||||
|
||||
// 拼压缩回合的 messages(参考 titleMessages 的拼法):默认 system prompt + 正常历史
|
||||
//(与 buildMessages 同取舍:archived 不发、旧摘要/工具轮照常),末尾追加一条 user
|
||||
//(prompt-compress.txt 原文,历史就在它前面的 messages 里,不再填占位符)。
|
||||
// 调用方(engine.runLoopInner 的 compressing 分支)需同时不传 tools。
|
||||
// 调用方(engine.runLoopInner 的 compressing 分支)照常带 tools:工具段在最前,删掉等于断整段
|
||||
// 前缀缓存;模型偶尔会为核对事实调一次,那一轮的文字仍按摘要处理(见 isSummary 判定)。
|
||||
// 【缓存铁律】压缩请求必须与上一次常规请求字节同构、只在尾部追加指令:画像快照与
|
||||
// 占位裁剪一律照常(不传 withProfile/trim = 同一拼法),也不裁历史中间任何注入行——
|
||||
// 从首个被删/被改动行起前缀缓存全断,等于全价重读(旧代码 withProfile=false 把坐在
|
||||
@@ -585,6 +657,14 @@ function splitInlineThinking(raw) {
|
||||
return { content: text.trim(), reasoning: think.trim() };
|
||||
}
|
||||
|
||||
// 剥离内部键 __rowId(锚点用):有才拷贝,没就原样返回,避免每行都新建对象
|
||||
function stripRowId(m) {
|
||||
if (!m || m.__rowId == null) return m;
|
||||
const c = Object.assign({}, m);
|
||||
delete c.__rowId;
|
||||
return c;
|
||||
}
|
||||
|
||||
// 调模型一次。onText(textDelta) 回调流式文本。
|
||||
// 返回 { content, tool_calls: [{id,name,arguments(string)}], finish_reason, usage, aborted }
|
||||
// 可选回调 opts.onToolCallStart({id,name}):某 tool_call 首次凑齐 id+name 时触发一次;
|
||||
@@ -619,20 +699,26 @@ async function callModel(cfg, modelId, messages, tools, options) {
|
||||
if (opts.deepThink && modelCfg.thinking_params && Object.keys(modelCfg.thinking_params).length) {
|
||||
deepMergeInto(body, modelCfg.thinking_params);
|
||||
}
|
||||
// 思维链回传(逐模型 opt-in,纯配置闸门不看 tools):reasoning_ack_field 非空时,把
|
||||
// buildMessages 挂的内部键 __reasoning 按该字段名写回 assistant 行(对话/压缩/标题回合同规则;
|
||||
// 没配/无思考的行零变化)。无论配与否都剥一遍 __reasoning,内部键不出仓库。
|
||||
// 思维链回传(逐模型 opt-in):开思考时把 buildMessages 挂的内部键 __reasoning 按
|
||||
// reasoning_ack_field 写回 assistant 行;关思考时整段不发。带 tool_calls 的行缺思维链
|
||||
// 时用空串占位(缺失会被上游 400,空串实测通过)。__reasoning 是内部键,任何情况都剥。
|
||||
// __rowId(锚点用的库行 id)同样是内部键:没想发也不该发给上游,任何行有就剥。
|
||||
if (body.messages && body.messages.length) {
|
||||
const ack = modelCfg.reasoning_ack_field;
|
||||
// 思考模式下带 tool_calls 的 assistant 行必须回传 reasoning_content:中途开启思考时,
|
||||
// 本轮早先的调用没有思维链,用空串占位(缺失会被上游 400,空串实测通过)。
|
||||
const send = !!(ack && opts.deepThink);
|
||||
body.messages = body.messages.map(mm => {
|
||||
if (!mm || mm.role !== 'assistant') return mm;
|
||||
const fill = !!(opts.deepThink && ack && mm.tool_calls && !mm.__reasoning);
|
||||
if (!mm.__reasoning && !fill) return mm;
|
||||
if (!mm || mm.role !== 'assistant') return stripRowId(mm);
|
||||
if (!mm.__reasoning) {
|
||||
if (!send || !mm.tool_calls) return stripRowId(mm);
|
||||
const c = Object.assign({}, mm);
|
||||
c[ack] = '';
|
||||
delete c.__rowId; // 内部键,不发给上游
|
||||
return c;
|
||||
}
|
||||
const c = Object.assign({}, mm);
|
||||
if (ack) c[ack] = c.__reasoning || '';
|
||||
if (send) c[ack] = mm.__reasoning;
|
||||
delete c.__reasoning;
|
||||
delete c.__rowId;
|
||||
return c;
|
||||
});
|
||||
}
|
||||
@@ -647,18 +733,78 @@ async function callModel(cfg, modelId, messages, tools, options) {
|
||||
opts.onFetchParams(logBody);
|
||||
}
|
||||
|
||||
const res = await fetch(modelCfg.url + '/chat/completions', {
|
||||
// ---- 增量上下文(context relay)----
|
||||
// 仅对显式 store: true 的模型生效,且必须带 opts.context_id。
|
||||
// id 尾部的 archived_cnt 就是「压缩代数」:压缩会把老行标 archived,代数一变 id 就变,
|
||||
// relay 自然找不到缓存并回 409,不需要额外传 hash。
|
||||
// 裁剪不改 id(只换内容不删行),所以它不会打断增量:relay 里留着完本文,模型读到的信息更多。
|
||||
//
|
||||
// 能不能只发新增,靠「锚点」判:上一轮发出去的最后一条库行(其 messages.id)还在不在
|
||||
// 本轮数组的同一位置上。历史被改只有两种形态——尾部截断(编辑/清空/压缩后)与中间挖洞
|
||||
//(删单条,由 invalidateContext 另行作废)——前者必然让锚点对不上。
|
||||
// 只比长度是不行的:编辑台丢弃历史后新内容又长出来,长度可能反而更大,切点就错位了,
|
||||
// relay 忠实 concat 出一份错位数组,上游按 tool_call_mismatch 拒收。
|
||||
const cid = opts.context_id;
|
||||
const storeOn = !!(modelCfg.store && cid);
|
||||
const fullBody = JSON.stringify(body);
|
||||
// 已剥内部键的全量数组(上面 map 的产物,保序保长)。增量分支会把它替换成尾部切片,
|
||||
// 所以先存一份:409 重试要拿它重发全量,不能拿原始 messages(那上面挂着 __rowId)。
|
||||
const strippedFull = body.messages;
|
||||
if (storeOn) {
|
||||
const st = ctxState.get(cid);
|
||||
headers['X-Context-Id'] = cid;
|
||||
// 锚点:上一轮发出去的数组里最后一条库行的 messages.id。
|
||||
const anchor = st && st.len > 0 ? messages[st.len - 1] : null;
|
||||
const anchorOk = !!(st && anchor && anchor.__rowId === st.lastRowId);
|
||||
if (anchorOk && messages.length === st.len) {
|
||||
// 数组与上次一模一样(错误重试 / 切模型但没新增消息):发空增量,
|
||||
// relay 用缓存原样转发即可。缓存不在时它会回 409,下面重试一次全量。
|
||||
body.messages = [];
|
||||
} else if (anchorOk && messages.length > st.len) {
|
||||
// 前缀没动:只发新增。strippedFull 与 messages 同序同长,索引可直接沿用。
|
||||
body.messages = strippedFull.slice(st.len);
|
||||
} else {
|
||||
// 全量:首轮 / 进程重启 / 压缩后新 id / 历史被改
|
||||
headers['X-Context-Reset'] = '1';
|
||||
}
|
||||
}
|
||||
|
||||
let res = await fetch(modelCfg.url + '/chat/completions', {
|
||||
method: 'POST',
|
||||
headers,
|
||||
body: JSON.stringify(body),
|
||||
body: storeOn ? JSON.stringify(body) : fullBody,
|
||||
signal: controller.signal,
|
||||
});
|
||||
|
||||
// 409 = relay 那边没有这个 id 的缓存(重启 / TTL / LRU / 压缩换了 id):改发全量重试一次。
|
||||
// 只重试一次:重发的是全量(带 Reset 头),relay 会整段存下,不可能再 409。
|
||||
if (storeOn && res.status === 409) {
|
||||
body.messages = strippedFull; // 已剥内部键的全量,不能拿原始 messages
|
||||
headers['X-Context-Reset'] = '1';
|
||||
res = await fetch(modelCfg.url + '/chat/completions', {
|
||||
method: 'POST',
|
||||
headers,
|
||||
body: JSON.stringify(body),
|
||||
signal: controller.signal,
|
||||
});
|
||||
}
|
||||
|
||||
if (!res.ok) {
|
||||
const text = await res.text().catch(() => '');
|
||||
const err = new Error('上游返回 ' + res.status + ': ' + text.slice(0, 500));
|
||||
err.upstream_status = res.status;
|
||||
throw err;
|
||||
}
|
||||
// 成功才更新“relay 已存到几条”:失败下一轮自然重发全量。
|
||||
// lastRowId 取本轮发出去的数组里最后一个「来自数据库的行」的 id(末尾可能是合成的
|
||||
// 图片提示行,没有 __rowId,要往前找):它就是下一轮比对的锚点。
|
||||
if (storeOn) {
|
||||
let lastRowId = null;
|
||||
for (let i = messages.length - 1; i >= 0; i--) {
|
||||
if (messages[i] && messages[i].__rowId != null) { lastRowId = messages[i].__rowId; break; }
|
||||
}
|
||||
ctxState.set(cid, { len: messages.length, lastRowId: lastRowId });
|
||||
}
|
||||
|
||||
let content = '';
|
||||
let reasoning = '';
|
||||
@@ -748,4 +894,12 @@ async function callModel(cfg, modelId, messages, tools, options) {
|
||||
return { content, reasoning, tool_calls: Array.from(toolCalls.values()), finish_reason: finishReason, usage, aborted, sseFrames };
|
||||
}
|
||||
|
||||
module.exports = { callModel, buildMessages, buildSystemPrompt, systemPromptText, setSkillListText, setPayloadTrim, setProfilePrompts, encodeBlocks, decodeBlocks, compressMessages, titleMessages, patchImageReceipt };
|
||||
// 作废某会话的增量上下文指针:下一轮直接走 X-Context-Reset 全量重建。
|
||||
// 用在「历史被挖了一个洞」的地方——删中间某条消息时,后面的行位置没变、
|
||||
// 锚点(末尾行 id)查不出异常,但 relay 缓存里还留着被删那行,增量拼出来就错位了。
|
||||
// 压缩不用调:压缩会改 cid(archived_cnt +1),自然回落。
|
||||
function invalidateContext(cid) {
|
||||
if (cid) ctxState.delete(cid);
|
||||
}
|
||||
|
||||
module.exports = { callModel, buildMessages, buildSystemPrompt, systemPromptText, setSkillListText, setEnvMode, setPayloadTrim, setProfilePrompts, encodeBlocks, decodeBlocks, compressMessages, titleMessages, patchImageReceipt, invalidateContext };
|
||||
|
||||
+46
-7
@@ -118,7 +118,7 @@ function tokenScore(fl, t) {
|
||||
const frac = hit / (t.length - 1);
|
||||
return frac >= 0.5 ? frac * 0.9 : 0;
|
||||
}
|
||||
function searchFragments(db, user, query, count) {
|
||||
function searchFragments(db, user, query, count, excludeSid) {
|
||||
const toks = String(query || '').toLowerCase().split(/[\s,,、;;。.!!??]+/).filter(Boolean).slice(0, 8);
|
||||
if (!toks.length) return '';
|
||||
const lim = Math.max(1, Math.min(30, Number(count) || 10));
|
||||
@@ -132,6 +132,23 @@ function searchFragments(db, user, query, count) {
|
||||
for (const t of toks) sum += tokenScore(fl, t);
|
||||
if (sum > 0) hits.push({ r: r, score: sum / toks.length, i: i });
|
||||
});
|
||||
// 未收口的会话没有碎片,标题是它唯一可检索的记忆:同样打分、同样渲染、同样排序,
|
||||
// 不另起段落(否则模型会把「标题命中」当另一类东西,反而不信)。
|
||||
const pend = db.prepare(
|
||||
"SELECT id, title, updated_at FROM sessions WHERE user = ? AND journaled_at IS NULL AND TRIM(title) != ''"
|
||||
).all(String(user || ''));
|
||||
pend.forEach((s, i) => {
|
||||
if (excludeSid && s.id === excludeSid) return;
|
||||
const fl = String(s.title).toLowerCase();
|
||||
let sum = 0;
|
||||
for (const t of toks) sum += tokenScore(fl, t);
|
||||
if (sum > 0) {
|
||||
hits.push({
|
||||
r: { session_id: s.id, day: dayString(s.updated_at), text: s.title, last_active_at: s.updated_at },
|
||||
score: sum / toks.length, i: rows.length + i
|
||||
});
|
||||
}
|
||||
});
|
||||
if (!hits.length) return '';
|
||||
hits.sort((a, b) => b.score - a.score || a.i - b.i);
|
||||
const shown = hits.slice(0, lim);
|
||||
@@ -143,14 +160,36 @@ function searchFragments(db, user, query, count) {
|
||||
|
||||
// ---------- 读:日期索引 / 某天整天(只记得「大概哪天」时的翻页) ----------
|
||||
function daysIndex(db, user) {
|
||||
return db.prepare(
|
||||
'SELECT day, COUNT(*) n FROM memory_fragments WHERE user = ? GROUP BY day ORDER BY day DESC'
|
||||
).all(String(user || '')).map(r => '- ' + r.day + '(' + r.n + ' 条)');
|
||||
const u = String(user || '');
|
||||
const map = new Map();
|
||||
for (const r of db.prepare('SELECT day, COUNT(*) n FROM memory_fragments WHERE user = ? GROUP BY day').all(u)) {
|
||||
map.set(r.day, (map.get(r.day) || 0) + r.n);
|
||||
}
|
||||
// 未收口会话的日期也要进索引:那天干过活,只是还没落碎片,索引里不该整天消失。
|
||||
// 日期一律走 dayString(业务时区 Asia/Shanghai),不交给 SQLite 的 localtime,避免容器 TZ 漂移。
|
||||
for (const s of db.prepare(
|
||||
"SELECT updated_at FROM sessions WHERE user = ? AND journaled_at IS NULL AND TRIM(title) != ''"
|
||||
).all(u)) {
|
||||
const d = dayString(s.updated_at);
|
||||
map.set(d, (map.get(d) || 0) + 1);
|
||||
}
|
||||
return [...map.entries()].sort((a, b) => (a[0] < b[0] ? 1 : a[0] > b[0] ? -1 : 0))
|
||||
.map(e => '- ' + e[0] + '(' + e[1] + ' 条)');
|
||||
}
|
||||
function dayEntry(db, user, date) {
|
||||
return db.prepare(
|
||||
'SELECT ' + FRAG_COLS + FRAG_FROM + ' WHERE f.user = ? AND f.day = ? ORDER BY COALESCE(f.last_active_at, f.created_at)'
|
||||
).all(String(user || ''), String(date || '').trim()).map(renderFrag).join('\n\n');
|
||||
const u = String(user || '');
|
||||
const d = String(date || '').trim();
|
||||
const rows = db.prepare(
|
||||
'SELECT ' + FRAG_COLS + FRAG_FROM + ' WHERE f.user = ? AND f.day = ?'
|
||||
).all(u, d);
|
||||
for (const s of db.prepare(
|
||||
"SELECT id, title, updated_at FROM sessions WHERE user = ? AND journaled_at IS NULL AND TRIM(title) != ''"
|
||||
).all(u)) {
|
||||
if (dayString(s.updated_at) !== d) continue;
|
||||
rows.push({ session_id: s.id, day: d, text: s.title, last_active_at: s.updated_at });
|
||||
}
|
||||
rows.sort((a, b) => (Number(a.last_active_at) || 0) - (Number(b.last_active_at) || 0));
|
||||
return rows.map(renderFrag).join('\n\n');
|
||||
}
|
||||
|
||||
// ---------- 裁剪:day 为 ISO 串,字典序即日期序;默认永久存储为 no-op ----------
|
||||
|
||||
+28
-5
@@ -42,10 +42,25 @@
|
||||
{
|
||||
"key": "web_search",
|
||||
"label": "网页搜索",
|
||||
"desc": "栈内搜索服务,无需密钥",
|
||||
"desc": "内置免费搜索,也可接自建 /search",
|
||||
"url": "http://mcp_web_search:3000/",
|
||||
"mode": "advertise",
|
||||
"fields": []
|
||||
"fields": [
|
||||
{
|
||||
"header": "Authorization",
|
||||
"label": "鉴权",
|
||||
"secret": true,
|
||||
"prefix": "Bearer ",
|
||||
"placeholder": "API Key",
|
||||
"hint": "免费后端留空"
|
||||
},
|
||||
{
|
||||
"header": "X-Web-Search-Base-Url",
|
||||
"label": "地址",
|
||||
"placeholder": "https://<host>/v1",
|
||||
"hint": "留空用免费后端"
|
||||
}
|
||||
]
|
||||
},
|
||||
{
|
||||
"key": "image_task",
|
||||
@@ -80,7 +95,7 @@
|
||||
{
|
||||
"key": "video_task",
|
||||
"label": "视频生成",
|
||||
"desc": "智谱 BigModel 异步视频接口",
|
||||
"desc": "文生视频 / 图生视频",
|
||||
"url": "http://mcp_video_task:3000/mcp",
|
||||
"mode": "skill",
|
||||
"fields": [
|
||||
@@ -90,12 +105,20 @@
|
||||
"secret": true,
|
||||
"prefix": "Bearer ",
|
||||
"required": true,
|
||||
"placeholder": "智谱 API Key"
|
||||
"placeholder": "API Key"
|
||||
},
|
||||
{
|
||||
"header": "X-Video-Task-Base-Url",
|
||||
"label": "地址",
|
||||
"required": true,
|
||||
"placeholder": "https://<host>/v1",
|
||||
"hint": "OpenAI 兼容 videos / generations"
|
||||
},
|
||||
{
|
||||
"header": "X-Video-Task-Model",
|
||||
"label": "模型",
|
||||
"default": "cogvideox-flash"
|
||||
"required": true,
|
||||
"placeholder": "上游的模型 id"
|
||||
}
|
||||
]
|
||||
},
|
||||
|
||||
+741
-151
File diff suppressed because it is too large
Load Diff
+180
-61
@@ -8,22 +8,38 @@
|
||||
<meta name="viewport" content="width=device-width, initial-scale=1.0, maximum-scale=1.0, user-scalable=no, viewport-fit=cover, interactive-widget=resizes-content">
|
||||
<title>Agent 任务台</title>
|
||||
<script src="/vendor/marked.min.js"></script>
|
||||
<script src="/vendor/katex/katex.min.js"></script>
|
||||
<script src="/js/math.js"></script>
|
||||
<script src="/vendor/prism.min.js"></script>
|
||||
<meta name="theme-color" content="#3964FE">
|
||||
<!-- 主题首屏:先落 data-theme,避开刷新时的白屏闪一下。默认浅色,手动切过后存 localStorage -->
|
||||
<script>
|
||||
(function () {
|
||||
try {
|
||||
var m = localStorage.getItem('agent-theme') === 'dark' ? 'dark' : 'light';
|
||||
document.documentElement.setAttribute('data-theme', m);
|
||||
document.documentElement.setAttribute('data-theme-mode', m);
|
||||
} catch (_) {
|
||||
document.documentElement.setAttribute('data-theme', 'light');
|
||||
document.documentElement.setAttribute('data-theme-mode', 'light');
|
||||
}
|
||||
})();
|
||||
</script>
|
||||
<meta name="apple-mobile-web-app-capable" content="yes">
|
||||
<meta name="apple-mobile-web-app-status-bar-style" content="black-translucent">
|
||||
<meta name="apple-mobile-web-app-title" content="Agent">
|
||||
<link rel="manifest" href="/manifest.json">
|
||||
<link rel="apple-touch-icon" href="/icons/apple-touch-icon.png">
|
||||
<link rel="icon" type="image/png" sizes="192x192" href="/icons/icon-192.png">
|
||||
<link rel="stylesheet" href="/vendor/katex/katex.min.css">
|
||||
<link rel="stylesheet" href="/css/style.css">
|
||||
<style>
|
||||
/* 「压缩」摘要卡片:与 .msg-think 同族的折叠交互,但做成更醒目的蓝色调卡片;
|
||||
流式收尾(live)和历史重渲染(type='summary' 消息)共用同一套样式。
|
||||
live 阶段 open=true 展开阅读;历史重渲染默认收起。 */
|
||||
/* 「压缩」摘要卡片:与 .msg-ctx(画像快照/渠道/记忆)同一套视觉——淡蓝底、蓝边蓝字、
|
||||
三角箭头、虚线分隔。纯色不用渐变/阴影,折叠与展开同一底色。默认收起 */
|
||||
.msg-summary {
|
||||
margin: 0 0 8px; border: 1px solid #dbe4fb; border-radius: 12px; overflow: hidden;
|
||||
background: linear-gradient(180deg, #f7f9ff 0%, #ffffff 56%);
|
||||
box-shadow: 0 1px 3px rgba(57, 100, 254, 0.08);
|
||||
width: 100%; /* .msg.other 是 align-items:flex-start 的列 flex,不写就只撑标题那点宽 */
|
||||
margin: 0 0 8px; border: 1px solid var(--bd-dbe4fb); border-radius: 12px; overflow: hidden;
|
||||
background: var(--bg-f7f9ff);
|
||||
}
|
||||
.msg-summary > summary {
|
||||
list-style: none; cursor: pointer; user-select: none;
|
||||
@@ -37,13 +53,12 @@
|
||||
transition: transform .15s ease;
|
||||
}
|
||||
.msg-summary[open] > summary::before { transform: rotate(90deg); }
|
||||
.msg-summary .sum-ic { flex: none; width: 15px; height: 15px; }
|
||||
.msg-summary .sum-hint { margin-left: auto; font-size: 11px; font-weight: 400; color: var(--gray); }
|
||||
.msg-summary-body {
|
||||
border-top: 1px dashed #dbe4fb; background: var(--page);
|
||||
/* 比标题区深一档(用变量,暗色自动跟随) */
|
||||
border-top: 1px dashed var(--bd-dbe4fb); background: var(--bg-fbfcff);
|
||||
padding: 10px 13px 12px;
|
||||
}
|
||||
.msg-summary-body .bubble-ai { margin: 0; font-size: 14px; line-height: 1.7; }
|
||||
.msg-summary-body .bubble-ai { margin: 0; background: transparent; font-size: 14px; line-height: 1.7; }
|
||||
/* 「仅摘要」后摘要之前的旧历史:UI 保留但变淡,尾部附存档说明(不再发给 AI) */
|
||||
.msg-archived { opacity: .55; }
|
||||
.archived-note {
|
||||
@@ -57,7 +72,7 @@
|
||||
#schedule-modal .sched-row select,
|
||||
#schedule-modal .sched-row input {
|
||||
width: auto; margin: 0; padding: 7px 8px; font-size: 14px;
|
||||
border: 1px solid #dde1ea; border-radius: 8px; background: #fff; color: var(--ink);
|
||||
border: 1px solid var(--bd-dde1ea); border-radius: 8px; background: var(--bg-fff); color: var(--ink);
|
||||
}
|
||||
#schedule-modal .sched-row select { appearance: none; -webkit-appearance: none; }
|
||||
#schedule-modal .sched-row .sched-num { width: 52px; text-align: center; }
|
||||
@@ -66,9 +81,9 @@
|
||||
/* schedule 弹窗内的提示词编辑区(.modal input 不覆盖 textarea,单独给样式) */
|
||||
#schedule-modal textarea {
|
||||
width: 100%; box-sizing: border-box; display: block;
|
||||
border: 1px solid #dde1ea; border-radius: 10px;
|
||||
border: 1px solid var(--bd-dde1ea); border-radius: 10px;
|
||||
padding: 10px 12px; font-size: 14px; line-height: 1.5;
|
||||
margin-bottom: 10px; background: #fff; color: var(--ink); resize: vertical;
|
||||
margin-bottom: 10px; background: var(--bg-fff); color: var(--ink); resize: vertical;
|
||||
}
|
||||
#schedule-modal textarea:focus { border-color: var(--active); }
|
||||
/* welcome 头像兼做「选择模型」入口(与聊天态的「选择模型」同一弹窗) */
|
||||
@@ -86,12 +101,79 @@
|
||||
</script>
|
||||
</head>
|
||||
<body>
|
||||
<!-- 图标 sprite:全站 99 处 svg 的几何图形都收在这里,引用方式
|
||||
<svg class="ic" viewBox="0 0 24 24"><use href="#i-xxx"/></svg>
|
||||
尺寸/描边仍由各处 CSS 控制(.ic、.tree-act svg 等),本文件只存形状。
|
||||
同形但历史写法不同的(folder/folder-b/folder-c、x-line/x-line-b/x-path、eye/eye-sm 等)
|
||||
各留一份,保证替换前后逐像素一致;后续要收敛,改引用指向同一个 id 即可。 -->
|
||||
<svg id="icon-sprite" style="position:absolute;width:0;height:0;overflow:hidden" aria-hidden="true">
|
||||
<symbol id="i-history" viewBox="0 0 24 24"><path stroke-width="2" stroke-linecap="round" d="M4 5h16M4 15h10"/></symbol>
|
||||
<symbol id="i-clock" viewBox="0 0 24 24"><circle cx="12" cy="12" r="8.5"></circle><polyline points="12 7.5 12 12 15.5 14"></polyline></symbol>
|
||||
<symbol id="i-database" viewBox="0 0 24 24"><ellipse cx="12" cy="5" rx="8" ry="2.5" fill="none" stroke="currentColor" stroke-width="1.6"></ellipse><path fill="none" stroke="currentColor" stroke-width="1.6" stroke-linecap="round" d="M4 5v6c0 1.4 3.6 2.5 8 2.5s8-1.1 8-2.5V5"></path><path fill="none" stroke="currentColor" stroke-width="1.6" stroke-linecap="round" d="M4 11v6c0 1.4 3.6 2.5 8 2.5s8-1.1 8-2.5v-6"></path></symbol>
|
||||
<symbol id="i-plus" viewBox="0 0 24 24"><line x1="12" y1="5" x2="12" y2="19"></line><line x1="5" y1="12" x2="19" y2="12"></line></symbol>
|
||||
<symbol id="i-more" viewBox="0 0 24 24"><circle cx="5" cy="12" r="1.4" fill="currentColor" stroke="none"></circle><circle cx="12" cy="12" r="1.4" fill="currentColor" stroke="none"></circle><circle cx="19" cy="12" r="1.4" fill="currentColor" stroke="none"></circle></symbol>
|
||||
<symbol id="i-sliders" viewBox="0 0 24 24"><line x1="3" y1="7" x2="21" y2="7"></line><circle cx="9" cy="7" r="2.6"></circle><line x1="3" y1="17" x2="21" y2="17"></line><circle cx="15" cy="17" r="2.6"></circle></symbol>
|
||||
<symbol id="i-robot" viewBox="0 0 24 24"><rect x="4" y="8" width="16" height="12" rx="3"></rect><line x1="12" y1="4" x2="12" y2="8"></line><circle cx="12" cy="3" r="1.4"></circle><circle cx="9" cy="13.5" r="1" fill="currentColor" stroke="none"></circle><circle cx="15" cy="13.5" r="1" fill="currentColor" stroke="none"></circle><line x1="9.5" y1="17" x2="14.5" y2="17"></line></symbol>
|
||||
<symbol id="i-folder" viewBox="0 0 24 24"><path d="M3 7a2 2 0 0 1 2-2h4l2 2h8a2 2 0 0 1 2 2v8a2 2 0 0 1-2 2H5a2 2 0 0 1-2-2z"></path></symbol>
|
||||
<symbol id="i-x-line" viewBox="0 0 24 24"><line x1="6" y1="6" x2="18" y2="18"></line><line x1="18" y1="6" x2="6" y2="18"></line></symbol>
|
||||
<symbol id="i-bulb" viewBox="0 0 24 24"><path d="M12 10.2a1.8 1.8 0 1 0 0.001 3.6A1.8 1.8 0 0 0 12 10.2z"></path><path stroke-width="1.5" d="M15.76 15.76 C10.955 20.565 5.373 22.779 3.297 20.703 C1.22 18.627 3.434 13.045 8.24 8.24 C13.045 3.435 18.627 1.22 20.703 3.297 C22.779 5.374 20.565 10.955 15.76 15.76z"></path><path stroke-width="1.5" d="M16.096 7.904 C20.905 12.713 22.965 18.298 20.703 20.703 C18.44 23.108 13.003 20.755 8.24 15.76 C3.477 10.76 1.22 5.373 3.297 3.297 C5.374 1.22 10.955 3.434 16.096 7.904z"></path></symbol>
|
||||
<symbol id="i-folder-b" viewBox="0 0 24 24"><path fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" d="M22 19a2 2 0 0 1-2 2H4a2 2 0 0 1-2-2V5a2 2 0 0 1 2-2h5l2 3h9a2 2 0 0 1 2 2z"></path></symbol>
|
||||
<symbol id="i-paperclip" viewBox="0 0 24 24"><path fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" d="M21.44 11.05l-9.19 9.19a6 6 0 0 1-8.49-8.49l9.19-9.19a4 4 0 0 1 5.66 5.66l-9.2 9.19a2 2 0 0 1-2.83-2.83l8.49-8.48"></path></symbol>
|
||||
<symbol id="i-send" viewBox="0 0 24 24"><line x1="12" y1="19" x2="12" y2="5"></line><polyline points="5 12 12 5 19 12"></polyline></symbol>
|
||||
<symbol id="i-mic" viewBox="0 0 24 24"><rect x="9" y="2" width="6" height="12" rx="3"></rect><path d="M5 10a7 7 0 0 0 14 0"></path><line x1="12" y1="19" x2="12" y2="22"></line></symbol>
|
||||
<symbol id="i-keyboard" viewBox="0 0 24 24"><rect x="3" y="5" width="18" height="14" rx="2.5"></rect><circle cx="7" cy="9" r="1.1" fill="currentColor" stroke="none"></circle><circle cx="12" cy="9" r="1.1" fill="currentColor" stroke="none"></circle><circle cx="17" cy="9" r="1.1" fill="currentColor" stroke="none"></circle><circle cx="7" cy="12.5" r="1.1" fill="currentColor" stroke="none"></circle><circle cx="12" cy="12.5" r="1.1" fill="currentColor" stroke="none"></circle><circle cx="17" cy="12.5" r="1.1" fill="currentColor" stroke="none"></circle><line x1="8" y1="16" x2="16" y2="16"></line></symbol>
|
||||
<symbol id="i-chevron-down" viewBox="0 0 24 24"><polyline points="6 9 12 15 18 9"></polyline></symbol>
|
||||
<symbol id="i-spinner" viewBox="0 0 24 24"><circle cx="12" cy="12" r="10" style="fill:none;stroke:var(--sb-ring,#dde);stroke-width:2.5"></circle><path d="M22 12a10 10 0 0 1-10 10" style="fill:none;stroke:var(--sb-arc,#3964FE);stroke-width:2.5;stroke-linecap:round"></path></symbol>
|
||||
<symbol id="i-search" viewBox="0 0 24 24"><circle cx="11" cy="11" r="8"></circle><line x1="21" y1="21" x2="16.65" y2="16.65"></line></symbol>
|
||||
<symbol id="i-gear" viewBox="0 0 24 24"><circle cx="12" cy="12" r="3"></circle><path d="M12.22 2h-.44a2 2 0 0 0-2 2v.18a2 2 0 0 1-1 1.73l-.43.25a2 2 0 0 1-2 0l-.15-.08a2 2 0 0 0-2.73.73l-.22.38a2 2 0 0 0 .73 2.73l.15.1a2 2 0 0 1 1 1.72v.51a2 2 0 0 1-1 1.74l-.15.09a2 2 0 0 0-.73 2.73l.22.38a2 2 0 0 0 2.73.73l.15-.08a2 2 0 0 1 2 0l.43.25a2 2 0 0 1 1 1.73V20a2 2 0 0 0 2 2h.44a2 2 0 0 0 2-2v-.18a2 2 0 0 1 1-1.73l.43-.25a2 2 0 0 1 2 0l.15.08a2 2 0 0 0 2.73-.73l.22-.39a2 2 0 0 0-.73-2.73l-.15-.08a2 2 0 0 1-1-1.74v-.5a2 2 0 0 1 1-1.74l.15-.09a2 2 0 0 0 .73-2.73l-.22-.38a2 2 0 0 0-2.73-.73l-.15.08a2 2 0 0 1-2 0l-.43-.25a2 2 0 0 1-1-1.73V4a2 2 0 0 0-2-2z"></path></symbol>
|
||||
<symbol id="i-upload-cloud" viewBox="0 0 24 24"><path d="M21 15v4a2 2 0 0 1-2 2H5a2 2 0 0 1-2-2v-4"></path><polyline points="17 8 12 3 7 8"></polyline><line x1="12" y1="3" x2="12" y2="15"></line></symbol>
|
||||
<symbol id="i-download" viewBox="0 0 24 24"><path d="M21 15v4a2 2 0 0 1-2 2H5a2 2 0 0 1-2-2v-4"></path><polyline points="7 10 12 15 17 10"></polyline><line x1="12" y1="15" x2="12" y2="3"></line></symbol>
|
||||
<symbol id="i-trash" viewBox="0 0 24 24"><path d="M3 6h18"/><path d="M8 6V4a1 1 0 0 1 1-1h6a1 1 0 0 1 1 1v2"/><path d="M19 6l-1 14a2 2 0 0 1-2 2H8a2 2 0 0 1-2-2L5 6"/><path d="M10 11v6"/><path d="M14 11v6"/></symbol>
|
||||
<symbol id="i-chevron-left" viewBox="0 0 24 24"><polyline points="15 18 9 12 15 6"></polyline></symbol>
|
||||
<symbol id="i-x-line-b" viewBox="0 0 24 24"><line x1="18" y1="6" x2="6" y2="18"></line><line x1="6" y1="6" x2="18" y2="18"></line></symbol>
|
||||
<symbol id="i-refresh" viewBox="0 0 24 24"><polyline points="23 4 23 10 17 10"></polyline><path d="M20.49 15a9 9 0 1 1-2.12-9.36L23 10"></path></symbol>
|
||||
<symbol id="i-external" viewBox="0 0 24 24"><path d="M18 13v6a2 2 0 0 1-2 2H5a2 2 0 0 1-2-2V8a2 2 0 0 1 2-2h6"></path><polyline points="15 3 21 3 21 9"></polyline><line x1="10" y1="14" x2="21" y2="3"></line></symbol>
|
||||
<symbol id="i-eye" viewBox="0 0 24 24"><path d="M1 12s4-8 11-8 11 8 11 8-4 8-11 8-11-8-11-8z"></path><circle cx="12" cy="12" r="3"></circle></symbol>
|
||||
<symbol id="i-maximize" viewBox="0 0 24 24"><path d="M8 3H5a2 2 0 0 0-2 2v3"></path><path d="M21 8V5a2 2 0 0 0-2-2h-3"></path><path d="M16 21h3a2 2 0 0 0 2-2v-3"></path><path d="M3 16v3a2 2 0 0 0 2 2h3"></path></symbol>
|
||||
<symbol id="i-minimize" viewBox="0 0 24 24"><path d="M8 3v3a2 2 0 0 1-2 2H3"></path><path d="M21 8h-3a2 2 0 0 1-2-2V3"></path><path d="M3 16h3a2 2 0 0 1 2 2v3"></path><path d="M16 21v-3a2 2 0 0 1 2-2h3"></path></symbol>
|
||||
<symbol id="i-copy" viewBox="0 0 24 24"><rect x="9" y="9" width="13" height="13" rx="2"></rect><path d="M5 15H4a2 2 0 0 1-2-2V4a2 2 0 0 1 2-2h9a2 2 0 0 1 2 2v1"></path></symbol>
|
||||
<symbol id="i-x-path" viewBox="0 0 24 24"><path d="M18 6 6 18"></path><path d="m6 6 12 12"></path></symbol>
|
||||
<symbol id="i-pencil" viewBox="0 0 24 24"><path d="M12 20h9"></path><path d="M16.5 3.5a2.1 2.1 0 0 1 3 3L7 19l-4 1 1-4z"></path></symbol>
|
||||
<symbol id="i-gem" viewBox="0 0 24 24"><path d="M6 3h12l4 6-10 13L2 9z"></path><polyline points="2 9 22 9"></polyline><polyline points="10 3 8 9 12 22"></polyline><polyline points="14 3 16 9 12 22"></polyline></symbol>
|
||||
<symbol id="i-image" viewBox="0 0 24 24"><rect x="3" y="3" width="18" height="18" rx="2"></rect><circle cx="8.5" cy="8.5" r="1.5"></circle><polyline points="21 15 16 10 5 21"></polyline></symbol>
|
||||
<symbol id="i-file" viewBox="0 0 24 24"><path d="M6 3h8l4 4v14H6z"/><path d="M14 3v4h4"/></symbol>
|
||||
<symbol id="i-link" viewBox="0 0 24 24"><path d="M10 13a5 5 0 0 0 7 0l2-2a5 5 0 0 0-7-7l-1 1"/><path d="M14 11a5 5 0 0 0-7 0l-2 2a5 5 0 0 0 7 7l1-1"/></symbol>
|
||||
<symbol id="i-external-b" viewBox="0 0 24 24"><path d="M14 4h6v6"/><path d="M20 4l-9 9"/><path d="M19 14v5a1 1 0 0 1-1 1H5a1 1 0 0 1-1-1V6a1 1 0 0 1 1-1h5"/></symbol>
|
||||
<symbol id="i-reload" viewBox="0 0 24 24"><path d="M20 12a8 8 0 1 1-2.3-5.7"/><path d="M20 4v5h-5"/></symbol>
|
||||
<symbol id="i-terminal" viewBox="0 0 24 24"><rect x="3" y="4" width="18" height="16" rx="2"/><path d="M7 9l3 3-3 3"/><path d="M13 15h4"/></symbol>
|
||||
<symbol id="i-git" viewBox="0 0 24 24"><circle cx="6" cy="5" r="2"/><circle cx="6" cy="19" r="2"/><circle cx="18" cy="7" r="2"/><path d="M6 7v10"/><path d="M18 9v1a4 4 0 0 1-4 4H9"/></symbol>
|
||||
<symbol id="i-eye-sm" viewBox="0 0 24 24"><path d="M2 12s3.5-7 10-7 10 7 10 7-3.5 7-10 7S2 12 2 12z"/><circle cx="12" cy="12" r="2.6"/></symbol>
|
||||
<symbol id="i-theme-auto" viewBox="0 0 24 24"><rect x="2" y="3" width="20" height="14" rx="2"/><path d="M8 21h8"/><path d="M12 17v4"/></symbol>
|
||||
<symbol id="i-theme-light" viewBox="0 0 24 24"><circle cx="12" cy="12" r="4.5"/><path d="M12 1.5v2M12 20.5v2M3.4 3.4l1.4 1.4M19.2 19.2l1.4 1.4M1.5 12h2M20.5 12h2M3.4 20.6l1.4-1.4M19.2 4.8l1.4-1.4"/></symbol>
|
||||
<symbol id="i-theme-dark" viewBox="0 0 24 24"><path d="M21 13.2A9 9 0 1 1 10.8 3a7.2 7.2 0 0 0 10.2 10.2z"/></symbol>
|
||||
<symbol id="i-file-doc" viewBox="0 0 24 24"><path d="M14 2H6a2 2 0 0 0-2 2v16a2 2 0 0 0 2 2h12a2 2 0 0 0 2-2V8z"></path><polyline points="14 2 14 8 20 8"></polyline></symbol>
|
||||
<symbol id="i-folder-c" viewBox="0 0 24 24"><path d="M22 19a2 2 0 0 1-2 2H4a2 2 0 0 1-2-2V5a2 2 0 0 1 2-2h5l2 3h9a2 2 0 0 1 2 2z"></path></symbol>
|
||||
<symbol id="i-chevron-right" viewBox="0 0 24 24"><polyline points="9 18 15 12 9 6"></polyline></symbol>
|
||||
<symbol id="i-home" viewBox="0 0 24 24"><path d="M3 9l9-7 9 7v11a2 2 0 0 1-2 2H5a2 2 0 0 1-2-2z"></path><polyline points="9 22 9 12 15 12 15 22"></polyline></symbol>
|
||||
<symbol id="i-image-b" viewBox="0 0 24 24"><rect x="3" y="3" width="18" height="18" rx="2" ry="2"></rect><circle cx="8.5" cy="8.5" r="1.5"></circle><polyline points="21 15 16 10 5 21"></polyline></symbol>
|
||||
<symbol id="i-user" viewBox="0 0 24 24"><circle cx="12" cy="8" r="4"></circle><path d="M4 21c0-4 4-6 8-6s8 2 8 6"></path></symbol>
|
||||
<symbol id="i-users" viewBox="0 0 24 24"><circle cx="9" cy="8" r="3.5"></circle><path d="M2 21c0-3.6 3.1-5.5 7-5.5s7 1.9 7 5.5"></path><path d="M16 8.5a3 3 0 0 1 0 6"></path><path d="M18 21c0-2.8-1.4-4.5-4-5.2"></path></symbol>
|
||||
<symbol id="i-sliders-v" viewBox="0 0 24 24"><line x1="4" y1="21" x2="4" y2="14"></line><line x1="4" y1="10" x2="4" y2="3"></line><line x1="12" y1="21" x2="12" y2="12"></line><line x1="12" y1="8" x2="12" y2="3"></line><line x1="20" y1="21" x2="20" y2="16"></line><line x1="20" y1="12" x2="20" y2="3"></line><line x1="1" y1="14" x2="7" y2="14"></line><line x1="9" y1="8" x2="15" y2="8"></line><line x1="17" y1="16" x2="23" y2="16"></line></symbol>
|
||||
<symbol id="i-zap" viewBox="0 0 24 24"><polygon points="13 2 3 14 12 14 11 22 21 10 12 10 13 2"></polygon></symbol>
|
||||
<symbol id="i-cpu" viewBox="0 0 24 24"><rect x="4" y="4" width="16" height="16" rx="2"></rect><rect x="9" y="9" width="6" height="6"></rect><line x1="9" y1="1" x2="9" y2="4"></line><line x1="15" y1="1" x2="15" y2="4"></line><line x1="9" y1="20" x2="9" y2="23"></line><line x1="15" y1="20" x2="15" y2="23"></line><line x1="20" y1="9" x2="23" y2="9"></line><line x1="20" y1="14" x2="23" y2="14"></line><line x1="1" y1="9" x2="4" y2="9"></line><line x1="1" y1="14" x2="4" y2="14"></line></symbol>
|
||||
<symbol id="i-layout" viewBox="0 0 24 24"><rect x="3" y="4" width="18" height="16" rx="2"></rect><line x1="3" y1="10" x2="21" y2="10"></line><circle cx="7" cy="15" r="1.2" fill="currentColor" stroke="none"></circle><circle cx="12" cy="15" r="1.2" fill="currentColor" stroke="none"></circle><circle cx="17" cy="15" r="1.2" fill="currentColor" stroke="none"></circle></symbol>
|
||||
<symbol id="i-chevron-right-b" viewBox="0 0 24 24"><polyline points="9 6 15 12 9 18"></polyline></symbol>
|
||||
<symbol id="i-edit" viewBox="0 0 24 24"><path d="M11 4H4a2 2 0 0 0-2 2v14a2 2 0 0 0 2 2h14a2 2 0 0 0 2-2v-7"></path><path d="M18.5 2.5a2.12 2.12 0 0 1 3 3L12 15l-4 1 1-4z"></path></symbol>
|
||||
<symbol id="i-check" viewBox="0 0 24 24"><polyline points="20 6 9 17 4 12"></polyline></symbol>
|
||||
<symbol id="i-pencil-b" viewBox="0 0 24 24"><path d="M12 20h9"/><path d="M16.5 3.5a2.12 2.12 0 0 1 3 3L7 19l-4 1 1-4Z"/></symbol>
|
||||
</svg>
|
||||
|
||||
<div id="app">
|
||||
|
||||
<!-- ================= 顶部导航栏 ================= -->
|
||||
<header class="header" id="chat-header">
|
||||
<button class="icon-btn" id="menu-btn" title="历史记录" aria-label="打开历史记录">
|
||||
<svg viewBox="0 0 24 24" class="ic sm"><path stroke-width="2" stroke-linecap="round" d="M4 5h16M4 15h10"/></svg>
|
||||
<svg viewBox="0 0 24 24" class="ic sm"><use href="#i-history"/></svg>
|
||||
</button>
|
||||
<div class="header-center" id="header-center"><!-- 未对话状态为空白,JS 注入对话信息 --></div>
|
||||
|
||||
@@ -102,11 +184,11 @@
|
||||
<span class="hdr-label" id="hdr-model-text">选择模型</span>
|
||||
</button>
|
||||
<button class="hdr-chip hdr-sched hidden" id="hdr-sched" data-act="schedule" data-tip="定时任务" aria-label="定时任务">
|
||||
<svg class="ic" viewBox="0 0 24 24"><circle cx="12" cy="12" r="8.5"></circle><polyline points="12 7.5 12 12 15.5 14"></polyline></svg>
|
||||
<svg class="ic" viewBox="0 0 24 24"><use href="#i-clock"/></svg>
|
||||
<span class="hdr-label" id="hdr-sched-text">定时任务</span>
|
||||
</button>
|
||||
<button class="icon-btn ha-btn hdr-compact hidden" id="hdr-compact" data-act="compact" data-tip="压缩上下文" aria-label="压缩上下文">
|
||||
<svg class="ic" viewBox="0 0 24 24"><ellipse cx="12" cy="5" rx="8" ry="2.5" fill="none" stroke="currentColor" stroke-width="1.6"></ellipse><path fill="none" stroke="currentColor" stroke-width="1.6" stroke-linecap="round" d="M4 5v6c0 1.4 3.6 2.5 8 2.5s8-1.1 8-2.5V5"></path><path fill="none" stroke="currentColor" stroke-width="1.6" stroke-linecap="round" d="M4 11v6c0 1.4 3.6 2.5 8 2.5s8-1.1 8-2.5v-6"></path></svg>
|
||||
<svg class="ic" viewBox="0 0 24 24"><use href="#i-database"/></svg>
|
||||
</button>
|
||||
</div>
|
||||
|
||||
@@ -114,28 +196,37 @@
|
||||
桌面属性区与菜单项共用 data-act,事件统一在 sessions.js 分发。 -->
|
||||
<div class="header-actions" id="header-actions">
|
||||
<div class="ha-icons">
|
||||
<button class="icon-btn ha-btn" data-act="theme" id="theme-toggle" data-tip="主题:浅色" aria-label="切换主题">
|
||||
<svg class="ic sm" viewBox="0 0 24 24"><use href="#i-theme-light"/></svg>
|
||||
<svg class="ic sm hidden" viewBox="0 0 24 24"><use href="#i-theme-dark"/></svg>
|
||||
</button>
|
||||
<button class="icon-btn ha-btn" data-act="new" data-tip="新建会话" aria-label="新建会话">
|
||||
<svg class="ic sm" viewBox="0 0 24 24"><line x1="12" y1="5" x2="12" y2="19"></line><line x1="5" y1="12" x2="19" y2="12"></line></svg>
|
||||
<svg class="ic sm" viewBox="0 0 24 24"><use href="#i-plus"/></svg>
|
||||
</button>
|
||||
</div>
|
||||
<button class="icon-btn ha-more" id="ha-more" title="更多" aria-label="更多操作" aria-haspopup="menu" aria-expanded="false" aria-controls="ha-menu">
|
||||
<svg class="ic sm" viewBox="0 0 24 24"><circle cx="5" cy="12" r="1.4" fill="currentColor" stroke="none"></circle><circle cx="12" cy="12" r="1.4" fill="currentColor" stroke="none"></circle><circle cx="19" cy="12" r="1.4" fill="currentColor" stroke="none"></circle></svg>
|
||||
<svg class="ic sm" viewBox="0 0 24 24"><use href="#i-more"/></svg>
|
||||
</button>
|
||||
<div class="ha-menu hidden" id="ha-menu" role="menu">
|
||||
<button class="ha-item" role="menuitem" data-act="model">
|
||||
<svg class="ic sm" viewBox="0 0 24 24"><line x1="3" y1="7" x2="21" y2="7"></line><circle cx="9" cy="7" r="2.6"></circle><line x1="3" y1="17" x2="21" y2="17"></line><circle cx="15" cy="17" r="2.6"></circle></svg>
|
||||
<svg class="ic sm" viewBox="0 0 24 24"><use href="#i-sliders"/></svg>
|
||||
<span class="ha-item-main">切换模型</span><span class="ha-item-sub hidden" id="ha-model-sub"></span>
|
||||
</button>
|
||||
<button class="ha-item" role="menuitem" data-act="schedule">
|
||||
<svg class="ic sm" viewBox="0 0 24 24"><circle cx="12" cy="12" r="8.5"></circle><polyline points="12 7.5 12 12 15.5 14"></polyline></svg>
|
||||
<svg class="ic sm" viewBox="0 0 24 24"><use href="#i-clock"/></svg>
|
||||
<span class="ha-item-main">定时任务</span><span class="ha-item-sub hidden" id="ha-sched-sub"></span>
|
||||
</button>
|
||||
<button class="ha-item" role="menuitem" data-act="compact">
|
||||
<svg class="ic sm" viewBox="0 0 24 24"><ellipse cx="12" cy="5" rx="8" ry="2.5" fill="none" stroke="currentColor" stroke-width="1.6"></ellipse><path fill="none" stroke="currentColor" stroke-width="1.6" stroke-linecap="round" d="M4 5v6c0 1.4 3.6 2.5 8 2.5s8-1.1 8-2.5V5"></path><path fill="none" stroke="currentColor" stroke-width="1.6" stroke-linecap="round" d="M4 11v6c0 1.4 3.6 2.5 8 2.5s8-1.1 8-2.5v-6"></path></svg>
|
||||
<svg class="ic sm" viewBox="0 0 24 24"><use href="#i-database"/></svg>
|
||||
<span class="ha-item-main">压缩上下文</span>
|
||||
</button>
|
||||
<button class="ha-item" role="menuitem" data-act="theme" id="theme-toggle-mobile">
|
||||
<svg class="ic sm" viewBox="0 0 24 24"><use href="#i-theme-light"/></svg>
|
||||
<svg class="ic sm hidden" viewBox="0 0 24 24"><use href="#i-theme-dark"/></svg>
|
||||
<span class="ha-item-main">切换主题</span><span class="ha-item-sub" id="theme-label-mobile">浅色</span>
|
||||
</button>
|
||||
<button class="ha-item" role="menuitem" data-act="new">
|
||||
<svg class="ic sm" viewBox="0 0 24 24"><line x1="12" y1="5" x2="12" y2="19"></line><line x1="5" y1="12" x2="19" y2="12"></line></svg>
|
||||
<svg class="ic sm" viewBox="0 0 24 24"><use href="#i-plus"/></svg>
|
||||
<span class="ha-item-main">新建会话</span>
|
||||
</button>
|
||||
</div>
|
||||
@@ -147,10 +238,22 @@
|
||||
<section id="welcome-view">
|
||||
<div class="welcome-head">
|
||||
<div class="logo-badge" onclick="openModelSwitch()" title="选择模型" role="button" aria-label="选择模型">
|
||||
<svg class="ic" viewBox="0 0 24 24"><rect x="4" y="8" width="16" height="12" rx="3"></rect><line x1="12" y1="4" x2="12" y2="8"></line><circle cx="12" cy="3" r="1.4"></circle><circle cx="9" cy="13.5" r="1" fill="currentColor" stroke="none"></circle><circle cx="15" cy="13.5" r="1" fill="currentColor" stroke="none"></circle><line x1="9.5" y1="17" x2="14.5" y2="17"></line></svg>
|
||||
<svg class="ic" viewBox="0 0 24 24"><use href="#i-robot"/></svg>
|
||||
</div>
|
||||
<div class="welcome-slogan">随时开始吧</div>
|
||||
</div>
|
||||
<!-- 本地端:新建会话时手选工作目录(服务器形态由 JS 整块隐藏)。
|
||||
只暂存在前端,真正建档时随 POST /api/sessions 提交一次;不选 = 老行为。 -->
|
||||
<div class="welcome-dir hidden" id="welcome-dir">
|
||||
<span class="welcome-dir-cap">工作目录</span>
|
||||
<button type="button" class="welcome-dir-pick" id="welcome-dir-pick" title="选择本会话的工作目录">
|
||||
<svg class="ic sm" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1.8" stroke-linecap="round" stroke-linejoin="round"><use href="#i-folder"/></svg>
|
||||
<span class="welcome-dir-path" id="welcome-dir-path">默认</span>
|
||||
</button>
|
||||
<button type="button" class="welcome-dir-clear hidden" id="welcome-dir-clear" title="恢复默认目录" aria-label="恢复默认目录">
|
||||
<svg class="ic sm" viewBox="0 0 24 24"><use href="#i-x-line"/></svg>
|
||||
</button>
|
||||
</div>
|
||||
</section>
|
||||
|
||||
<!-- ================= 对话状态:对话内容区 ================= -->
|
||||
@@ -176,23 +279,23 @@
|
||||
<div class="input-actions">
|
||||
<div class="ia-side ia-left">
|
||||
<button class="think-toggle" id="deep-think-btn" title="深度思考">
|
||||
<svg viewBox="0 0 24 24" class="ic sm"><path d="M12 10.2a1.8 1.8 0 1 0 0.001 3.6A1.8 1.8 0 0 0 12 10.2z"></path><path stroke-width="1.5" d="M15.76 15.76 C10.955 20.565 5.373 22.779 3.297 20.703 C1.22 18.627 3.434 13.045 8.24 8.24 C13.045 3.435 18.627 1.22 20.703 3.297 C22.779 5.374 20.565 10.955 15.76 15.76z"></path><path stroke-width="1.5" d="M16.096 7.904 C20.905 12.713 22.965 18.298 20.703 20.703 C18.44 23.108 13.003 20.755 8.24 15.76 C3.477 10.76 1.22 5.373 3.297 3.297 C5.374 1.22 10.955 3.434 16.096 7.904z"></path></svg>
|
||||
<svg viewBox="0 0 24 24" class="ic sm"><use href="#i-bulb"/></svg>
|
||||
深度思考
|
||||
</button>
|
||||
</div>
|
||||
<div class="ia-side ia-right">
|
||||
<button class="plus-btn" id="files-btn" title="任务文件" aria-label="任务文件">
|
||||
<svg viewBox="0 0 24 24" class="ic sm"><path fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" d="M22 19a2 2 0 0 1-2 2H4a2 2 0 0 1-2-2V5a2 2 0 0 1 2-2h5l2 3h9a2 2 0 0 1 2 2z"></path></svg>
|
||||
<svg viewBox="0 0 24 24" class="ic sm"><use href="#i-folder-b"/></svg>
|
||||
</button>
|
||||
<button class="plus-btn" id="attach-btn" title="上传文件" aria-label="上传文件">
|
||||
<svg viewBox="0 0 24 24" class="ic sm"><path fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" d="M21.44 11.05l-9.19 9.19a6 6 0 0 1-8.49-8.49l9.19-9.19a4 4 0 0 1 5.66 5.66l-9.2 9.19a2 2 0 0 1-2.83-2.83l8.49-8.48"></path></svg>
|
||||
<svg viewBox="0 0 24 24" class="ic sm"><use href="#i-paperclip"/></svg>
|
||||
</button>
|
||||
<!-- 同一按钮四态:发送(↑)/ 停止(方块)/ 语音(麦克风)/ 键盘。
|
||||
data-state 由 JS 切换,尺寸不变避免输入区跳动 -->
|
||||
<button class="send-btn" id="send-btn" data-state="send" title="发送" aria-label="发送">
|
||||
<svg class="ic sm ic-send" viewBox="0 0 24 24"><line x1="12" y1="19" x2="12" y2="5"></line><polyline points="5 12 12 5 19 12"></polyline></svg>
|
||||
<svg class="ic sm ic-voice" viewBox="0 0 24 24"><rect x="9" y="2" width="6" height="12" rx="3"></rect><path d="M5 10a7 7 0 0 0 14 0"></path><line x1="12" y1="19" x2="12" y2="22"></line></svg>
|
||||
<svg class="ic sm ic-kb" viewBox="0 0 24 24"><rect x="3" y="5" width="18" height="14" rx="2.5"></rect><circle cx="7" cy="9" r="1.1" fill="currentColor" stroke="none"></circle><circle cx="12" cy="9" r="1.1" fill="currentColor" stroke="none"></circle><circle cx="17" cy="9" r="1.1" fill="currentColor" stroke="none"></circle><circle cx="7" cy="12.5" r="1.1" fill="currentColor" stroke="none"></circle><circle cx="12" cy="12.5" r="1.1" fill="currentColor" stroke="none"></circle><circle cx="17" cy="12.5" r="1.1" fill="currentColor" stroke="none"></circle><line x1="8" y1="16" x2="16" y2="16"></line></svg>
|
||||
<svg class="ic sm ic-send" viewBox="0 0 24 24"><use href="#i-send"/></svg>
|
||||
<svg class="ic sm ic-voice" viewBox="0 0 24 24"><use href="#i-mic"/></svg>
|
||||
<svg class="ic sm ic-kb" viewBox="0 0 24 24"><use href="#i-keyboard"/></svg>
|
||||
<span class="stop-sq" aria-hidden="true"></span>
|
||||
</button>
|
||||
</div>
|
||||
@@ -202,13 +305,18 @@
|
||||
<div id="voice-overlay" class="hidden" aria-hidden="true">
|
||||
<div class="vo-hint" id="voice-hint">松手传送,上滑取消</div>
|
||||
<div class="vo-wave" id="voice-wave"></div>
|
||||
<!-- 桌面点击模式的操作行:手机端按住说话用不到,CSS 里默认隐藏 -->
|
||||
<div class="vo-actions" id="voice-actions">
|
||||
<button type="button" class="vo-btn ghost" id="voice-cancel">取消</button>
|
||||
<button type="button" class="vo-btn primary" id="voice-send">发送</button>
|
||||
</div>
|
||||
</div>
|
||||
</div>
|
||||
<!-- 回到底部浮动按钮(搬自 index;上翻历史时出现、AI 输出中常驻转圈)。
|
||||
放在 footer 内、相对 footer 顶边停靠:输入框长高/编辑条出现时不会被盖住 -->
|
||||
<button class="scroll-bottom-btn hidden" id="scroll-bottom-btn" onclick="clickScrollBottom()" title="回到底部" aria-label="回到底部">
|
||||
<svg class="sb-arrow" viewBox="0 0 24 24"><polyline points="6 9 12 15 18 9"></polyline></svg>
|
||||
<svg class="sb-spinner hidden" viewBox="0 0 24 24"><circle cx="12" cy="12" r="10"></circle><path d="M22 12a10 10 0 0 1-10 10"></path></svg>
|
||||
<svg class="sb-arrow" viewBox="0 0 24 24"><use href="#i-chevron-down"/></svg>
|
||||
<svg class="sb-spinner hidden" viewBox="0 0 24 24"><use href="#i-spinner"/></svg>
|
||||
</button>
|
||||
</footer>
|
||||
|
||||
@@ -217,16 +325,21 @@
|
||||
<aside id="drawer" aria-label="对话历史">
|
||||
<div class="drawer-search">
|
||||
<div class="search-box">
|
||||
<svg class="ic sm" viewBox="0 0 24 24"><circle cx="11" cy="11" r="8"></circle><line x1="21" y1="21" x2="16.65" y2="16.65"></line></svg>
|
||||
<svg class="ic sm" viewBox="0 0 24 24"><use href="#i-search"/></svg>
|
||||
<input type="search" id="search-input" placeholder="搜寻对话内容..." enterkeyhint="search">
|
||||
</div>
|
||||
</div>
|
||||
<div class="drawer-list" id="drawer-list"></div>
|
||||
<div class="drawer-user" id="drawer-user">
|
||||
<div class="avatar" id="drawer-avatar">A</div>
|
||||
<div class="user-name" id="drawer-user-name">Agent 用户</div>
|
||||
<button class="user-more" id="user-more-btn" title="更多设置" aria-label="更多设置">
|
||||
<svg class="ic sm" viewBox="0 0 24 24"><circle cx="5" cy="12" r="1.4" fill="currentColor" stroke="none"></circle><circle cx="12" cy="12" r="1.4" fill="currentColor" stroke="none"></circle><circle cx="19" cy="12" r="1.4" fill="currentColor" stroke="none"></circle></svg>
|
||||
<div class="files-tree" id="files-tree"></div>
|
||||
<!-- 底部图标操作栏:文件树 / 设置(文件树按钮是「会话 ↔ 文件」的切换开关)。
|
||||
预览不占按钮:桌面端在文件树里点文件即开预览栏,关窗走预览栏自己的关闭钮。
|
||||
窄屏两个都隐藏:文件只保留输入行右侧的旧面板(不做两套)。选中项高亮。 -->
|
||||
<div class="drawer-actions" id="drawer-actions">
|
||||
<button class="drawer-act" id="da-files" type="button" title="文件树" aria-label="文件树">
|
||||
<svg viewBox="0 0 24 24"><use href="#i-folder"/></svg>
|
||||
</button>
|
||||
<button class="drawer-act" id="da-settings" type="button" title="设置" aria-label="设置">
|
||||
<svg viewBox="0 0 24 24"><use href="#i-gear"/></svg>
|
||||
</button>
|
||||
</div>
|
||||
</aside>
|
||||
@@ -239,7 +352,7 @@
|
||||
<span class="files-panel-title">任务文件<span class="files-panel-size" id="files-panel-size" title="当前目录下全部文件总大小"></span></span>
|
||||
<label class="file-upload" title="上传文件" aria-label="上传文件">
|
||||
<input type="file" id="file-input" multiple hidden>
|
||||
<svg viewBox="0 0 24 24"><path d="M21 15v4a2 2 0 0 1-2 2H5a2 2 0 0 1-2-2v-4"></path><polyline points="17 8 12 3 7 8"></polyline><line x1="12" y1="3" x2="12" y2="15"></line></svg>
|
||||
<svg viewBox="0 0 24 24"><use href="#i-upload-cloud"/></svg>
|
||||
</label>
|
||||
</div>
|
||||
<div class="files-crumbs hidden" id="files-crumbs" aria-label="目录路径"></div>
|
||||
@@ -255,10 +368,10 @@
|
||||
</div>
|
||||
<div class="files-panel-actions">
|
||||
<button class="files-fab" id="files-bulk-download" title="批量下载" aria-label="批量下载" disabled>
|
||||
<svg viewBox="0 0 24 24"><path d="M21 15v4a2 2 0 0 1-2 2H5a2 2 0 0 1-2-2v-4"></path><polyline points="7 10 12 15 17 10"></polyline><line x1="12" y1="15" x2="12" y2="3"></line></svg>
|
||||
<svg viewBox="0 0 24 24"><use href="#i-download"/></svg>
|
||||
</button>
|
||||
<button class="files-fab del" id="files-bulk-delete" title="批量删除" aria-label="批量删除" disabled>
|
||||
<svg viewBox="0 0 24 24"><polyline points="3 6 5 6 21 6"></polyline><path d="M19 6l-1 14a2 2 0 0 1-2 2H8a2 2 0 0 1-2-2L5 6"></path><line x1="10" y1="11" x2="10" y2="17"></line><line x1="14" y1="11" x2="14" y2="17"></line></svg>
|
||||
<svg viewBox="0 0 24 24"><use href="#i-trash"/></svg>
|
||||
</button>
|
||||
</div>
|
||||
</div>
|
||||
@@ -273,7 +386,7 @@
|
||||
<!-- 顶栏:左侧返回 + 中间标题 + 右侧操作按钮,风格与对话页 header 一致 -->
|
||||
<header class="header">
|
||||
<button class="icon-btn" id="set-back-btn" title="返回" aria-label="返回">
|
||||
<svg class="ic" viewBox="0 0 24 24"><polyline points="15 18 9 12 15 6"></polyline></svg>
|
||||
<svg class="ic" viewBox="0 0 24 24"><use href="#i-chevron-left"/></svg>
|
||||
</button>
|
||||
<div class="header-center"><div class="header-title" id="set-title">设置</div></div>
|
||||
<div class="header-right" id="set-actions"><!-- JS 按页注入操作按钮 --></div>
|
||||
@@ -286,7 +399,7 @@
|
||||
<div id="skill-create-modal" class="modal-overlay hidden" onclick="if(event.target===this)sUI.closeCreate()">
|
||||
<div class="modal">
|
||||
<button class="modal-close-btn" onclick="sUI.closeCreate()">
|
||||
<svg viewBox="0 0 24 24"><line x1="18" y1="6" x2="6" y2="18"></line><line x1="6" y1="6" x2="18" y2="18"></line></svg>
|
||||
<svg viewBox="0 0 24 24"><use href="#i-x-line-b"/></svg>
|
||||
</button>
|
||||
<h3>新建技能</h3>
|
||||
<input type="text" id="skill-new-name" placeholder="技能名(字母/数字/-/_)">
|
||||
@@ -299,7 +412,7 @@
|
||||
<div id="model-edit-modal" class="modal-overlay hidden" onclick="if(event.target===this)sUI.mClose()">
|
||||
<div class="modal modal-wide">
|
||||
<button class="modal-close-btn" onclick="sUI.mClose()">
|
||||
<svg viewBox="0 0 24 24"><line x1="18" y1="6" x2="6" y2="18"></line><line x1="6" y1="6" x2="18" y2="18"></line></svg>
|
||||
<svg viewBox="0 0 24 24"><use href="#i-x-line-b"/></svg>
|
||||
</button>
|
||||
<h3 id="mpe-title">编辑平台</h3>
|
||||
<!-- 平台预设:仅新增平台时展示,点选即填好 url/类型并给模型卡带上该平台的参数缺省 -->
|
||||
@@ -325,7 +438,7 @@
|
||||
<div id="user-edit-modal" class="modal-overlay hidden" onclick="if(event.target===this)sUI.closeUserModal()">
|
||||
<div class="modal">
|
||||
<button class="modal-close-btn" onclick="sUI.closeUserModal()">
|
||||
<svg viewBox="0 0 24 24"><line x1="18" y1="6" x2="6" y2="18"></line><line x1="6" y1="6" x2="18" y2="18"></line></svg>
|
||||
<svg viewBox="0 0 24 24"><use href="#i-x-line-b"/></svg>
|
||||
</button>
|
||||
<h3 id="ue-title">添加用户</h3>
|
||||
<input type="text" id="ue-user" placeholder="用户名(字母/数字/下划线)" autocomplete="off">
|
||||
@@ -347,12 +460,12 @@
|
||||
<div id="mcp-edit-modal" class="modal-overlay hidden" onclick="if(event.target===this)mcpUI.close()">
|
||||
<div class="modal modal-wide">
|
||||
<button class="modal-close-btn" onclick="mcpUI.close()">
|
||||
<svg viewBox="0 0 24 24"><line x1="18" y1="6" x2="6" y2="18"></line><line x1="6" y1="6" x2="18" y2="18"></line></svg>
|
||||
<svg viewBox="0 0 24 24"><use href="#i-x-line-b"/></svg>
|
||||
</button>
|
||||
<h3 id="mce-title">编辑 MCP 服务</h3>
|
||||
<input type="text" id="mce-name" placeholder="服务名">
|
||||
<input type="text" id="mce-url" placeholder="MCP 服务 JSON-RPC URL">
|
||||
<!-- 内置服务预设字段(url/name 只读,表单由预设生成) -->
|
||||
<!-- 内置服务预设字段(name 只读、url 可改,表单由预设生成) -->
|
||||
<div class="mpe-sec hidden" id="mce-preset-sec">
|
||||
<div class="mpe-sec-head"><span>配置参数</span><span class="cfg-note" id="mce-preset-desc"></span></div>
|
||||
<div id="mce-preset-fields"></div>
|
||||
@@ -385,7 +498,7 @@
|
||||
<div id="schedule-modal" class="modal-overlay hidden" onclick="if(event.target===this)closeScheduleModal()">
|
||||
<div class="modal">
|
||||
<button class="modal-close-btn" onclick="closeScheduleModal()">
|
||||
<svg viewBox="0 0 24 24"><line x1="18" y1="6" x2="6" y2="18"></line><line x1="6" y1="6" x2="18" y2="18"></line></svg>
|
||||
<svg viewBox="0 0 24 24"><use href="#i-x-line-b"/></svg>
|
||||
</button>
|
||||
<h3 id="schedule-modal-title">定时任务</h3>
|
||||
<div class="sched-row">
|
||||
@@ -418,7 +531,7 @@
|
||||
<div id="confirm-modal" class="modal-overlay hidden" onclick="if(event.target===this)confirmClose(null)">
|
||||
<div class="modal">
|
||||
<button class="modal-close-btn" onclick="confirmClose(null)" aria-label="关闭">
|
||||
<svg viewBox="0 0 24 24"><line x1="18" y1="6" x2="6" y2="18"></line><line x1="6" y1="6" x2="18" y2="18"></line></svg>
|
||||
<svg viewBox="0 0 24 24"><use href="#i-x-line-b"/></svg>
|
||||
</button>
|
||||
<h3 id="confirm-title">请确认</h3>
|
||||
<div class="modal-text" id="confirm-text"></div>
|
||||
@@ -434,7 +547,7 @@
|
||||
<div id="prompt-modal" class="modal-overlay hidden" onclick="if(event.target===this)promptCancel()">
|
||||
<div class="modal">
|
||||
<button class="modal-close-btn" onclick="promptCancel()">
|
||||
<svg viewBox="0 0 24 24"><line x1="18" y1="6" x2="6" y2="18"></line><line x1="6" y1="6" x2="18" y2="18"></line></svg>
|
||||
<svg viewBox="0 0 24 24"><use href="#i-x-line-b"/></svg>
|
||||
</button>
|
||||
<h3 id="prompt-title">请输入</h3>
|
||||
<input type="text" id="prompt-input">
|
||||
@@ -454,7 +567,7 @@
|
||||
<p class="msw-sub" id="bind-model-sub">选择一个模型继续当前会话</p>
|
||||
</div>
|
||||
<button class="modal-close-btn" onclick="closeModelSwitch()">
|
||||
<svg viewBox="0 0 24 24"><line x1="18" y1="6" x2="6" y2="18"></line><line x1="6" y1="6" x2="18" y2="18"></line></svg>
|
||||
<svg viewBox="0 0 24 24"><use href="#i-x-line-b"/></svg>
|
||||
</button>
|
||||
</div>
|
||||
<div class="msw-list" id="bind-model-list"></div>
|
||||
@@ -472,26 +585,30 @@
|
||||
<span id="img-count" class="hidden"></span>
|
||||
</div>
|
||||
|
||||
<!-- ================= 文档预览右栏(桌面端≥960px;office/全部文档类型统一承载;移动端走全屏 #fs-viewer,本栏隐藏) -->
|
||||
<!-- ================= 文档预览分栏(桌面端≥960px;紧贴左侧文件树:文件树 | 预览 | 会话;office/全部文档类型统一承载;移动端走全屏 #fs-viewer,本栏隐藏) -->
|
||||
<aside id="pv-pane" aria-label="文档预览">
|
||||
<header class="pv-head">
|
||||
<!-- 地址条胶囊:路径 input(点击全选可复制) + 内嵌 刷新/新窗口,模拟浏览器地址栏 -->
|
||||
<span class="pv-addr">
|
||||
<input class="pv-title" id="pv-title" aria-label="文件路径或网址">
|
||||
<button class="icon-btn hidden" id="pv-refresh" title="重新载入" aria-label="重新载入">
|
||||
<svg class="ic sm" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><polyline points="23 4 23 10 17 10"></polyline><path d="M20.49 15a9 9 0 1 1-2.12-9.36L23 10"></path></svg>
|
||||
<svg class="ic sm" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><use href="#i-refresh"/></svg>
|
||||
</button>
|
||||
<button class="icon-btn hidden" id="pv-popup" title="新窗口打开" aria-label="新窗口打开">
|
||||
<svg class="ic sm" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><path d="M18 13v6a2 2 0 0 1-2 2H5a2 2 0 0 1-2-2V8a2 2 0 0 1 2-2h6"></path><polyline points="15 3 21 3 21 9"></polyline><line x1="10" y1="14" x2="21" y2="3"></line></svg>
|
||||
<svg class="ic sm" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><use href="#i-external"/></svg>
|
||||
</button>
|
||||
</span>
|
||||
<span class="pv-actions">
|
||||
<!-- 源码钮:只在当前内容有源文本时出现(md/文本/代码/html/svg),点了在预览与原文间切换 -->
|
||||
<button class="icon-btn hidden" id="pv-src" title="查看源码" aria-label="查看源码">
|
||||
<svg class="ic sm" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><use href="#i-eye"/></svg>
|
||||
</button>
|
||||
<button class="icon-btn hidden" id="pv-download" title="下载文件" aria-label="下载文件">
|
||||
<svg class="ic sm" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><path d="M21 15v4a2 2 0 0 1-2 2H5a2 2 0 0 1-2-2v-4"></path><polyline points="7 10 12 15 17 10"></polyline><line x1="12" y1="15" x2="12" y2="3"></line></svg>
|
||||
<svg class="ic sm" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><use href="#i-download"/></svg>
|
||||
</button>
|
||||
<button class="icon-btn" id="pv-max" title="放大" aria-label="放大">
|
||||
<svg class="ic sm" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><path d="M8 3H5a2 2 0 0 0-2 2v3"></path><path d="M21 8V5a2 2 0 0 0-2-2h-3"></path><path d="M16 21h3a2 2 0 0 0 2-2v-3"></path><path d="M3 16v3a2 2 0 0 0 2 2h3"></path></svg>
|
||||
<svg class="ic sm hidden" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><path d="M8 3v3a2 2 0 0 1-2 2H3"></path><path d="M21 8h-3a2 2 0 0 1-2-2V3"></path><path d="M3 16h3a2 2 0 0 1 2 2v3"></path><path d="M16 21v-3a2 2 0 0 1 2-2h3"></path></svg>
|
||||
<svg class="ic sm" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><use href="#i-maximize"/></svg>
|
||||
<svg class="ic sm hidden" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><use href="#i-minimize"/></svg>
|
||||
</button>
|
||||
<button class="icon-btn" id="pv-close" title="关闭预览" aria-label="关闭预览">✕</button>
|
||||
</span>
|
||||
@@ -508,11 +625,11 @@
|
||||
<span class="fs-name" id="fs-file-name"></span>
|
||||
<!-- 源码切换钮:仅当当前内容有源文本时显隐(toggleFsSrc 在渲染视图/源码面板间互切) -->
|
||||
<button class="fs-btn hidden" id="fs-src-btn" title="显示源码" aria-label="显示源码">
|
||||
<svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><path d="M1 12s4-8 11-8 11 8 11 8-4 8-11 8-11-8-11-8z"></path><circle cx="12" cy="12" r="3"></circle></svg>
|
||||
<svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><use href="#i-eye"/></svg>
|
||||
</button>
|
||||
<!-- 复制源码:显隐与 eye 一致(有源文本才出现);HTML/SVG/MD/代码通用 -->
|
||||
<button class="fs-btn hidden" id="fs-copy-btn" title="复制源码" aria-label="复制源码">
|
||||
<svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><rect x="9" y="9" width="13" height="13" rx="2"></rect><path d="M5 15H4a2 2 0 0 1-2-2V4a2 2 0 0 1 2-2h9a2 2 0 0 1 2 2v1"></path></svg>
|
||||
<svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><use href="#i-copy"/></svg>
|
||||
</button>
|
||||
<button class="fs-btn" onclick="closeFullscreen()" title="关闭" aria-label="关闭">✕</button>
|
||||
</div>
|
||||
@@ -523,7 +640,7 @@
|
||||
<!-- 拖拽上传提示层:window 级 dragenter 时显示;pointer-events:none,不参与命中测试(逻辑见 js/files.js) -->
|
||||
<div id="drop-overlay" class="hidden" aria-hidden="true">
|
||||
<div class="drop-hint">
|
||||
<svg viewBox="0 0 24 24" class="ic"><path d="M21 15v4a2 2 0 0 1-2 2H5a2 2 0 0 1-2-2v-4"></path><polyline points="17 8 12 3 7 8"></polyline><line x1="12" y1="3" x2="12" y2="15"></line></svg>
|
||||
<svg viewBox="0 0 24 24" class="ic"><use href="#i-upload-cloud"/></svg>
|
||||
<span>松开即可上传</span>
|
||||
</div>
|
||||
</div>
|
||||
@@ -536,17 +653,19 @@
|
||||
<script src="/js/files.js"></script>
|
||||
<script src="/js/voice.js"></script>
|
||||
<script src="/js/preview.js"></script>
|
||||
<script src="/js/vcs.js"></script>
|
||||
<script src="/js/files-tree.js"></script>
|
||||
<script src="/js/settings.js"></script>
|
||||
<script>
|
||||
// 启动自愈:外部工具改前端文件是非原子写入,极端时机下浏览器可能拿到半截或重复拼接的 HTML
|
||||
// (脚本缺半 → 白屏裸首页;重复注入 → 每个文件报 duplicate variable 后 JS 全挂)。
|
||||
// 这里检测关键脚本数量与入口全局,不对就自动整页重载一次(sessionStorage 防循环)。
|
||||
// 注意:js/ 脚本增减时需同步改这里的期望数 9。
|
||||
// 注意:js/ 脚本增减时需同步改这里的期望数 10。
|
||||
(function () {
|
||||
var ok = false;
|
||||
try {
|
||||
var n = document.querySelectorAll('script[src^="/js/"]').length;
|
||||
ok = n === 9 && typeof state !== 'undefined' &&
|
||||
ok = n === 10 && typeof state !== 'undefined' &&
|
||||
typeof openFilePreview === 'function' && typeof restartNow === 'function';
|
||||
} catch (_) {}
|
||||
if (ok) { try { sessionStorage.removeItem('boot-heal'); } catch (_) {} return; }
|
||||
|
||||
@@ -32,13 +32,13 @@
|
||||
// 删除本条:仅已落库消息可删(传 m.id);流式未落库时无 id,不渲染
|
||||
const del = msgId
|
||||
? '<button class="act act-del" title="删除本条" data-msg-id="' + msgId + '">' +
|
||||
'<svg class="ic sm" viewBox="0 0 24 24"><path d="M18 6 6 18"></path><path d="m6 6 12 12"></path></svg>' +
|
||||
'<svg class="ic sm" viewBox="0 0 24 24"><use href="#i-x-path"/></svg>' +
|
||||
'</button>'
|
||||
: '';
|
||||
// 编辑并重发:只给未压缩的用户消息(调用方传 canEdit);带 b64 回填输入框,避免从 DOM 反推
|
||||
const edit = canEdit && msgId
|
||||
? '<button class="act act-edit" title="编辑并重发" data-msg-id="' + msgId + '" data-b64="' + b64 + '">' +
|
||||
'<svg class="ic sm" viewBox="0 0 24 24"><path d="M12 20h9"></path><path d="M16.5 3.5a2.1 2.1 0 0 1 3 3L7 19l-4 1 1-4z"></path></svg>' +
|
||||
'<svg class="ic sm" viewBox="0 0 24 24"><use href="#i-pencil"/></svg>' +
|
||||
'</button>'
|
||||
: '';
|
||||
const u = normUsage(usage);
|
||||
@@ -49,13 +49,28 @@
|
||||
'<span>' + fmtTime(ts) + '</span>' +
|
||||
usageHtml +
|
||||
'<button class="act act-copy" title="复制" data-b64="' + b64 + '">' +
|
||||
'<svg class="ic sm" viewBox="0 0 24 24"><rect x="9" y="9" width="13" height="13" rx="2"></rect><path d="M5 15H4a2 2 0 0 1-2-2V4a2 2 0 0 1 2-2h9a2 2 0 0 1 2 2v1"></path></svg>' +
|
||||
'<svg class="ic sm" viewBox="0 0 24 24"><use href="#i-copy"/></svg>' +
|
||||
'</button>' +
|
||||
edit +
|
||||
del +
|
||||
'</div>';
|
||||
}
|
||||
|
||||
// 上下文卡片:画像快照 / 渠道说明 / 开场记忆这类「只发给模型看的注入行」,
|
||||
// 统一渲染成可折叠的系统卡片,而不是伪装成用户发言。
|
||||
function ctxCardHtml(title, text, id) {
|
||||
const r = mdHtml(text || ''); // 与摘要卡片同样走 markdown,保持四张卡片观感一致
|
||||
return '<details class="msg-ctx"' + (id ? ' id="' + id + '"' : '') + '><summary>' + esc(title) + '</summary>'
|
||||
+ '<div class="msg-ctx-body"><div class="bubble-ai' + (r.fmt ? ' md' : '') + '">' + r.html + '</div></div></details>';
|
||||
}
|
||||
|
||||
// 画像快照是每轮请求拼在最前的上下文(不在 messages 表里)。历史是懒加载的,首屏只拉最近几条,
|
||||
// 所以不能一打开就插,得等翻到最早、确认没有更早的消息了再放到最顶。
|
||||
function ensureProfileCard(box) {
|
||||
if (!state.profileSnapshot || !box || box.querySelector('#ctx-profile')) return;
|
||||
box.insertAdjacentHTML('afterbegin', ctxCardHtml('画像快照', state.profileSnapshot, 'ctx-profile'));
|
||||
}
|
||||
|
||||
function userMsgHtml(m) {
|
||||
const p = parseUploadNotice(m.content);
|
||||
const attach = p.files && p.files.length
|
||||
@@ -72,16 +87,20 @@
|
||||
function aiMsgHtml(m) {
|
||||
const text = (m.content || '').trim();
|
||||
const reason = (m.reasoning || '').trim();
|
||||
if (!text && !reason) return null; // 纯工具调用的应答:不渲染气泡,工具卡由 appendToolCardsFromAssistant 铺
|
||||
const errAck = m.type === 'errAck';
|
||||
// 纯工具调用的应答不渲染气泡(工具卡由 appendToolCardsFromAssistant 铺),但 errAck 要留个标记
|
||||
if (!text && !reason && !errAck) return null;
|
||||
const note = errAck
|
||||
? '<div class="msg-note">工具调用参数无效,本轮已从上下文移除,模型会重新发起</div>' : '';
|
||||
const think = reason ? thinkPanelHtml(m.reasoning) : '';
|
||||
const bubble = text ? (() => { const r = mdHtml(m.content); return '<div class="bubble-ai' + (r.fmt ? ' md' : '') + '">' + r.html + '</div>'; })() : '';
|
||||
return '<div class="msg other">' + think + bubble + actionsHtml(m.created_at, m.content || '', m.id, m.usage) + '</div>';
|
||||
return '<div class="msg other">' + note + think + bubble + actionsHtml(m.created_at, m.content || '', m.id, m.usage) + '</div>';
|
||||
}
|
||||
// 思考过程折叠面板:summary 固定名「思考过程」+ 右侧复制按钮,body 展示推理全文。
|
||||
// 历史重渲染默认收起(与原设计一致),流式阶段的展开行为由 ensureStreamThinkPanel 显式控制。
|
||||
// 复制按钮走 onCopyClick 统一代理:点击时从 DOM 取思考全文(不依赖 b64,流式增量也能复制)
|
||||
const THINK_COPY_BTN = '<button class="act act-copy" title="复制思考内容">' +
|
||||
'<svg class="ic sm" viewBox="0 0 24 24"><rect x="9" y="9" width="13" height="13" rx="2"></rect><path d="M5 15H4a2 2 0 0 1-2-2V4a2 2 0 0 1 2-2h9a2 2 0 0 1 2 2v1"></path></svg>' +
|
||||
'<svg class="ic sm" viewBox="0 0 24 24"><use href="#i-copy"/></svg>' +
|
||||
'</button>';
|
||||
function thinkPanelHtml(text) {
|
||||
return '<details class="msg-think"><summary>思考过程' + THINK_COPY_BTN + '</summary><div class="msg-think-body">' + esc(text) + '</div></details>';
|
||||
@@ -93,7 +112,7 @@
|
||||
// 复制文本在点击时从 pre.textContent 现取(onCopyClick 的 .code-wrap 分支),不嵌 b64、不怕内容后续变化。
|
||||
// 只碰 .md 里的 pre:工具卡 / 思考区已有自己的复制按钮,行内 code 不加。
|
||||
const CODE_COPY_BTN = '<button class="act act-copy" type="button" title="复制代码">' +
|
||||
'<svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><rect x="9" y="9" width="13" height="13" rx="2"></rect><path d="M5 15H4a2 2 0 0 1-2-2V4a2 2 0 0 1 2-2h9a2 2 0 0 1 2 2v1"></path></svg>' +
|
||||
'<svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><use href="#i-copy"/></svg>' +
|
||||
'</button>';
|
||||
function decorateCodePre(root) {
|
||||
if (!root || !root.querySelectorAll) return;
|
||||
@@ -118,15 +137,7 @@
|
||||
|
||||
// 「压缩」摘要卡片:流式收尾与历史重渲染共用的头部(图标 + 标题 + 右侧说明)。
|
||||
function summaryHeaderHtml() {
|
||||
return '<summary>' +
|
||||
'<svg class="sum-ic" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1.6" stroke-linecap="round">' +
|
||||
'<ellipse cx="12" cy="5" rx="8" ry="2.5"></ellipse>' +
|
||||
'<path d="M4 5v6c0 1.4 3.6 2.5 8 2.5s8-1.1 8-2.5V5"></path>' +
|
||||
'<path d="M4 11v6c0 1.4 3.6 2.5 8 2.5s8-1.1 8-2.5v-6"></path>' +
|
||||
'</svg>' +
|
||||
'<span>上下文总结</span>' +
|
||||
'<span class="sum-hint">后续对话以此为起点</span>' +
|
||||
'</summary>';
|
||||
return '<summary><span>上下文总结</span></summary>';
|
||||
}
|
||||
|
||||
// 历史重渲染:被标记 type='summary' 的摘要消息渲染成摘要卡片(默认收起,点开可重现)。
|
||||
@@ -161,14 +172,14 @@
|
||||
if (!text) return '';
|
||||
const b64 = btoa(unescape(encodeURIComponent(text)));
|
||||
return '<button class="act act-copy" title="复制参数与结果" data-b64="' + b64 + '">' +
|
||||
'<svg class="ic sm" viewBox="0 0 24 24"><rect x="9" y="9" width="13" height="13" rx="2"></rect><path d="M5 15H4a2 2 0 0 1-2-2V4a2 2 0 0 1 2-2h9a2 2 0 0 1 2 2v1"></path></svg></button>';
|
||||
'<svg class="ic sm" viewBox="0 0 24 24"><use href="#i-copy"/></svg></button>';
|
||||
}
|
||||
// 工具卡「删除本条」:删的是 tool 消息行;后端会把它在父 assistant 里的调用同步摘除。
|
||||
// msgId = tool 消息的库行 id(历史渲染传 m.id;实时由 tool_result 事件的 msg_id 携带)
|
||||
function toolDelBtnHtml(msgId) {
|
||||
if (!msgId) return '';
|
||||
return '<button class="act act-del" title="删除本条" data-msg-id="' + msgId + '">' +
|
||||
'<svg class="ic sm" viewBox="0 0 24 24"><path d="M18 6 6 18"></path><path d="m6 6 12 12"></path></svg></button>';
|
||||
'<svg class="ic sm" viewBox="0 0 24 24"><use href="#i-x-path"/></svg></button>';
|
||||
}
|
||||
function renderToolCard(id, name, argsStr, createdAt, opts) {
|
||||
const div = document.createElement('div');
|
||||
@@ -181,7 +192,7 @@
|
||||
const gen = !!(opts && opts.generating);
|
||||
if (gen) div.classList.add('tool-generating');
|
||||
div.innerHTML =
|
||||
'<details' + (open ? ' open' : '') + '><summary><span class="spin">◌</span>' +
|
||||
'<details' + (open ? ' open' : '') + '><summary><span class="spin"><svg class="ic sm" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2.5" stroke-linecap="round"><path d="M21 12a9 9 0 1 1-6.2-8.6"/></svg></span>' +
|
||||
'<span class="tool-name">' + esc(name) + '</span>' +
|
||||
'<span class="tool-args">' + (gen ? '生成参数中…' : esc(toolArgsSummary(name, argsStr))) + '</span></summary>' +
|
||||
'<pre class="tool-args-full">' + (gen ? '' : esc(toolArgsFull(argsStr))) + '</pre>' +
|
||||
@@ -238,7 +249,10 @@
|
||||
const card = document.getElementById('tool-' + id);
|
||||
if (!card) return;
|
||||
if (isError) card.classList.add('error');
|
||||
card.querySelector('.spin').textContent = isError ? '✕' : '✓';
|
||||
card.classList.remove('running'); // 停止转圈,换成结果标记
|
||||
card.querySelector('.spin').innerHTML = isError
|
||||
? '<svg class="ic sm" viewBox="0 0 24 24"><use href="#i-x-line"/></svg>'
|
||||
: '<svg class="ic sm" viewBox="0 0 24 24"><use href="#i-check"/></svg>';
|
||||
const parsed = parseToolContent(content);
|
||||
const pre = card.querySelector('.tool-result');
|
||||
if (!pre) return;
|
||||
@@ -263,6 +277,20 @@
|
||||
pre.insertAdjacentElement('afterend', el);
|
||||
}
|
||||
}
|
||||
// 工具执行中的增量输出(terminal 长命令):边跑边填;只留尾部 2000 行,避免长跑命令撑爆 DOM
|
||||
function appendToolOutput(id, chunk) {
|
||||
const card = document.getElementById('tool-' + id);
|
||||
if (!card) return;
|
||||
const pre = card.querySelector('.tool-result');
|
||||
if (!pre) return;
|
||||
if (!pre.dataset.streaming) { pre.textContent = ''; pre.dataset.streaming = '1'; } // 首块到达:清掉“执行中…”占位
|
||||
const follow = pre.scrollHeight - pre.scrollTop - pre.clientHeight < 8; // 用户往上翻时不抢滚动
|
||||
pre.appendChild(document.createTextNode(chunk));
|
||||
const lines = pre.textContent.split('\n');
|
||||
if (lines.length > 2000) pre.textContent = '…(更早输出已折叠)\n' + lines.slice(-2000).join('\n');
|
||||
// 追加后滚到底:读 scrollHeight 会强制布局拿到新高度;再补一帧,避免大 chunk 一次没贴到底
|
||||
if (follow) { pre.scrollTop = pre.scrollHeight; requestAnimationFrame(() => { pre.scrollTop = pre.scrollHeight; }); }
|
||||
}
|
||||
// 把 assistant 消息里的 tool_calls 建成工具卡片(历史渲染与 assistant_message 事件共用)
|
||||
function appendToolCardsFromAssistant(m, container) {
|
||||
if (!m.tool_calls) return;
|
||||
@@ -322,7 +350,11 @@
|
||||
}
|
||||
|
||||
function msgNode(m) {
|
||||
if (m.role === 'user') return userMsgHtml(m);
|
||||
if (m.role === 'user') {
|
||||
if (m.type === 'channel_note') return ctxCardHtml('渠道上下文', m.content);
|
||||
if (m.type === 'memory_note') return ctxCardHtml('开场记忆', m.content);
|
||||
return userMsgHtml(m);
|
||||
}
|
||||
// 被「压缩总结」标记的摘要消息:重渲染成摘要卡片,而不是普通 AI 气泡
|
||||
if (m.role === 'assistant') return m.type === 'summary' ? summaryMsgHtml(m) : aiMsgHtml(m);
|
||||
return null; // tool 结果不单独展示
|
||||
@@ -365,6 +397,7 @@
|
||||
}
|
||||
// 历史渲染收口:给本轮新渲染出的代码块补复制按钮(目标可能是分页离屏容器,装饰后再随节点搬迁)
|
||||
decorateCodePre(target);
|
||||
pvHighlightMdCode(target); // 对话正文里的围栏代码块也上色(与预览同一套)
|
||||
return { closeArc };
|
||||
}
|
||||
|
||||
@@ -431,9 +464,12 @@
|
||||
const prevTop = keepView ? box.scrollTop : 0;
|
||||
const followBottom = !keepView || !box.firstElementChild || isNearBottom();
|
||||
box.innerHTML = '';
|
||||
state.profileSnapshot = (s && s.profile_snapshot) || '';
|
||||
appendMessagesDom(detail.messages || [], box).closeArc();
|
||||
// 首屏就把历史拉完了(条数少):直接上画像卡片;否则等上滑翻到最早再插
|
||||
if (!detail.has_more) ensureProfileCard(box);
|
||||
if (!(detail.messages || []).length) {
|
||||
box.innerHTML = '<div class="drawer-empty">描述你的需求,AI 会和你讨论并直接干活。</div>';
|
||||
box.insertAdjacentHTML('beforeend', '<div class="drawer-empty">描述你的需求,AI 会和你讨论并直接干活。</div>');
|
||||
}
|
||||
state.chatHasMore = !!detail.has_more;
|
||||
state.chatOldestId = detail.oldest_id || null;
|
||||
@@ -501,6 +537,7 @@
|
||||
while (frag.firstChild) box.insertBefore(frag.firstChild, anchor);
|
||||
box.scrollTop = box.scrollHeight - prevH + prevTop;
|
||||
state.chatHasMore = !!detail.has_more;
|
||||
if (!detail.has_more) ensureProfileCard(box); // 翻到最早了:画像卡片补到流最顶
|
||||
if (detail.oldest_id) state.chatOldestId = detail.oldest_id;
|
||||
state.chatLoadedCount += (detail.messages || []).length;
|
||||
// 旧页太短导致补完后仍贴在触发区:继续拉下一页,避免卡在顶部要再动一下才加载
|
||||
|
||||
@@ -48,7 +48,13 @@
|
||||
if (typeof marked !== 'undefined') marked.setOptions({ breaks: true, gfm: true });
|
||||
function mdHtml(text) {
|
||||
if (typeof marked === 'undefined') return { html: esc(text), fmt: false };
|
||||
try { return { html: marked.parse(text || ''), fmt: true }; }
|
||||
try {
|
||||
// 公式先抠成占位、marked 解析完再填回 KaTeX 输出(见 math.js)
|
||||
const html = typeof mdParseWithMath === 'function'
|
||||
? mdParseWithMath(text || '', marked)
|
||||
: marked.parse(text || '');
|
||||
return { html: html, fmt: true };
|
||||
}
|
||||
catch (_) { return { html: esc(text), fmt: false }; }
|
||||
}
|
||||
function fmtTime(ts) {
|
||||
@@ -148,11 +154,11 @@
|
||||
const MODES = {
|
||||
secretary: {
|
||||
label: '文秘助理', hint: '支持文字输入,可起草、润色、整理文书',
|
||||
icon: '<svg class="header-mode-icon" viewBox="0 0 24 24"><path d="M6 3h12l4 6-10 13L2 9z"></path><polyline points="2 9 22 9"></polyline><polyline points="10 3 8 9 12 22"></polyline><polyline points="14 3 16 9 12 22"></polyline></svg>',
|
||||
icon: '<svg class="header-mode-icon" viewBox="0 0 24 24"><use href="#i-gem"/></svg>',
|
||||
},
|
||||
vision: {
|
||||
label: '识图专家', hint: '支持图片识别输入',
|
||||
icon: '<svg class="header-mode-icon" viewBox="0 0 24 24"><rect x="3" y="3" width="18" height="18" rx="2"></rect><circle cx="8.5" cy="8.5" r="1.5"></circle><polyline points="21 15 16 10 5 21"></polyline></svg>',
|
||||
icon: '<svg class="header-mode-icon" viewBox="0 0 24 24"><use href="#i-image"/></svg>',
|
||||
},
|
||||
};
|
||||
|
||||
@@ -161,7 +167,7 @@
|
||||
view: 'welcome', // welcome | chat
|
||||
mode: 'secretary', // 新建会话默认助手类型(欢迎页已去掉模式切换,不再可变)
|
||||
sessionType: 'secretary', // 当前会话的助手类型(建档时锁定,后续不随模式切换变更)
|
||||
deepThink: false, // 深度思考开关(仅本地视觉状态,无后端参数)
|
||||
deepThink: false, // 深度思考开关(发消息时落库到 sessions.deep_think,重进会话回填)
|
||||
pendingModel: '', // welcome 预选模型(ensureSession 建档时透传 model_id)
|
||||
sessionId: null, // 当前会话
|
||||
sessionTitle: '', // 当前会话标题
|
||||
@@ -208,7 +214,11 @@
|
||||
function renderHeader() {
|
||||
const c = $('header-center');
|
||||
// welcome(含刚 newChat)一律清空:newChat 会停在 welcome,不重刷会残留旧会话标题
|
||||
if (state.view !== 'chat' || !state.sessionId) { c.innerHTML = ''; return; }
|
||||
if (state.view !== 'chat' || !state.sessionId) {
|
||||
c.innerHTML = '';
|
||||
document.title = 'Agent 任务台'; // 回欢迎页/新建会话时标签页恢复默认
|
||||
return;
|
||||
}
|
||||
// 顶部只显标题;助手类型 icon 早已退位(会话阶段徽标随 advising 一并移除)
|
||||
const title = document.createElement('div');
|
||||
title.className = 'header-title';
|
||||
@@ -218,6 +228,8 @@
|
||||
title.addEventListener('click', renameSession); // 点标题重命名(同步 index)
|
||||
c.innerHTML = '';
|
||||
c.appendChild(title);
|
||||
// 标签页标题跟着会话走:切会话/重命名/自动生成标题都会走到这里
|
||||
document.title = state.sessionTitle || 'Agent 任务台';
|
||||
}
|
||||
|
||||
// ---------- 模式切换已移除:新建会话固定用 state.mode(secretary),助手类型不再占顶部 icon
|
||||
|
||||
@@ -0,0 +1,537 @@
|
||||
// 桌面端左栏文件树:会话文件的唯一浏览入口(服务器形态与 local 形态共用)。
|
||||
// · 懒加载:一次只请求一层目录,展开才拉下一层;node_modules 这类大目录后端只回标记、不展开,
|
||||
// 避免旧的整棵递归接口在单线程 core 上卡死;
|
||||
// · 点文件 → 中间预览栏(文件树 | 预览 | 会话);行内 hover 出「下载 / 删除 / 在 Finder 中显示」;
|
||||
// · 「在 Finder / 终端中打开」只在 local 启动器下可用(服务器上这些动作没有意义),
|
||||
// 靠 /api/local/info 探测,拿不到就隐藏这两个按钮。
|
||||
// 手机端不启用(收纳在抽屉里体验太差),仍走输入行右侧的旧文件面板。
|
||||
// 依赖(全局):state $ req toast downloadFile confirmModal openFilePreview
|
||||
'use strict';
|
||||
(function () {
|
||||
const SVG_FOLDER = '<svg class="ic sm" viewBox="0 0 24 24"><use href="#i-folder"/></svg>';
|
||||
const SVG_FILE = '<svg class="ic sm" viewBox="0 0 24 24"><use href="#i-file"/></svg>';
|
||||
const SVG_LINK = '<svg class="ic sm" viewBox="0 0 24 24"><use href="#i-link"/></svg>';
|
||||
const SVG_REVEAL = '<svg class="ic sm" viewBox="0 0 24 24"><use href="#i-external-b"/></svg>';
|
||||
const SVG_REFRESH = '<svg class="ic sm" viewBox="0 0 24 24"><use href="#i-reload"/></svg>';
|
||||
const SVG_TERM = '<svg class="ic sm" viewBox="0 0 24 24"><use href="#i-terminal"/></svg>';
|
||||
const SVG_VCS = '<svg class="ic sm" viewBox="0 0 24 24"><use href="#i-git"/></svg>';
|
||||
const SVG_EYE = '<svg class="ic sm" viewBox="0 0 24 24"><use href="#i-eye-sm"/></svg>';
|
||||
const SVG_DL = '<svg viewBox="0 0 24 24"><use href="#i-download"/></svg>';
|
||||
const SVG_DEL = '<svg viewBox="0 0 24 24"><use href="#i-trash"/></svg>';
|
||||
const SVG_REVEAL_SM = '<svg viewBox="0 0 24 24"><use href="#i-external-b"/></svg>';
|
||||
const SVG_AT = '<span class="at-glyph">@</span>';
|
||||
|
||||
let localCapable = false; // local 启动器:才显示「在 Finder/终端中打开」
|
||||
let showHidden = false;
|
||||
let expanded = new Set(['']); // 已展开的相对目录('' = 根)
|
||||
let cache = new Map(); // rel -> /tree 响应
|
||||
let loading = new Map(); // rel -> Promise(并发去重)
|
||||
let emptyDirs = new Map(); // rel -> 目录 mtimeMs:确认空着的目录,mtime 没变就不必再请求
|
||||
let gen = 0; // 会话切换/刷新时自增,防止旧请求回填到新树的缓存
|
||||
// 多选:rel -> 'dir' | 'file'。勾目录表示整个目录(下载打成一个 zip、删除递归),
|
||||
// 所以勾目录会吃掉子项,勾子项会把祖先目录降级掉,见 toggleSel。
|
||||
let sel = new Map();
|
||||
|
||||
// 失效缓存。gen 自增让在飞的旧请求回来时不再写缓存(否则切会话会闪旧目录)。
|
||||
function invalidate(keepExpanded) {
|
||||
gen++;
|
||||
cache = new Map();
|
||||
loading = new Map();
|
||||
if (!keepExpanded) { expanded = new Set(['']); sel.clear(); emptyDirs = new Map(); }
|
||||
}
|
||||
|
||||
function sid() { return (state && state.sessionId) || ''; }
|
||||
|
||||
function tip(parent, text, cls) {
|
||||
const el = document.createElement('div');
|
||||
el.className = cls || 'tree-empty';
|
||||
el.textContent = text;
|
||||
parent.appendChild(el);
|
||||
}
|
||||
|
||||
function openDir(rel, dirMtime) {
|
||||
if (cache.has(rel)) return Promise.resolve(cache.get(rel));
|
||||
if (loading.has(rel)) return loading.get(rel);
|
||||
if (!sid()) return Promise.resolve(null);
|
||||
// 已知空目录且目录自身 mtime 未变(增删子项才会变):跳过请求,直接给空结果
|
||||
if (dirMtime != null && emptyDirs.get(rel) === dirMtime) {
|
||||
return Promise.resolve({ dir: rel, total: 0, capped: false, entries: [] });
|
||||
}
|
||||
const url = '/api/sessions/' + encodeURIComponent(sid()) + '/tree?dir=' +
|
||||
encodeURIComponent(rel) + (showHidden ? '&hidden=1' : '');
|
||||
const myGen = gen;
|
||||
const p = req('GET', url).then(function (data) {
|
||||
if (myGen === gen) {
|
||||
cache.set(rel, data); loading.delete(rel);
|
||||
const n = (data && data.entries) ? data.entries.length : 0;
|
||||
if (!n && dirMtime != null) emptyDirs.set(rel, dirMtime);
|
||||
else if (n) emptyDirs.delete(rel);
|
||||
}
|
||||
return data;
|
||||
}, function (e) {
|
||||
if (myGen === gen) loading.delete(rel);
|
||||
throw e;
|
||||
});
|
||||
loading.set(rel, p);
|
||||
return p;
|
||||
}
|
||||
|
||||
function actBtn(act, title, svg, danger) {
|
||||
const b = document.createElement('button');
|
||||
b.type = 'button';
|
||||
b.className = 'tree-act' + (danger ? ' danger' : '');
|
||||
b.dataset.act = act;
|
||||
b.title = title;
|
||||
b.innerHTML = svg;
|
||||
return b;
|
||||
}
|
||||
|
||||
function rowFor(ent, depth) {
|
||||
const row = document.createElement('div');
|
||||
row.className = 'tree-row';
|
||||
row.dataset.rel = ent.rel;
|
||||
row.dataset.type = ent.type;
|
||||
row.style.paddingLeft = (6 + depth * 14) + 'px';
|
||||
row.title = ent.rel;
|
||||
if (ent.type === 'dir') {
|
||||
row.classList.add('is-dir');
|
||||
if (expanded.has(ent.rel)) row.classList.add('open');
|
||||
}
|
||||
if (ent.type === 'link') row.classList.add('is-link');
|
||||
|
||||
// 不画展开箭头:文件夹图标已经说明可以点,点行任意位置都能展开/收起。
|
||||
|
||||
// 勾选框:hover 或已选中时淡入,但占位始终在,避免 hover 时文件名左右跳。
|
||||
// 软链不参与批量操作(后端也不让删),所以不给勾选框。
|
||||
if (ent.type !== 'link') {
|
||||
const chk = document.createElement('span');
|
||||
chk.className = 'tree-check';
|
||||
chk.setAttribute('role', 'checkbox');
|
||||
chk.setAttribute('aria-label', '选择');
|
||||
const on = sel.has(ent.rel);
|
||||
chk.setAttribute('aria-checked', on ? 'true' : 'false');
|
||||
if (on) row.classList.add('selected');
|
||||
row.appendChild(chk);
|
||||
}
|
||||
|
||||
const ico = document.createElement('span');
|
||||
ico.className = 'tree-ico';
|
||||
ico.innerHTML = ent.type === 'dir' ? SVG_FOLDER : (ent.type === 'link' ? SVG_LINK : SVG_FILE);
|
||||
row.appendChild(ico);
|
||||
|
||||
const name = document.createElement('span');
|
||||
name.className = 'tree-name';
|
||||
name.textContent = ent.name;
|
||||
row.appendChild(name);
|
||||
|
||||
// 行内动作:服务器形态给「下载 / 删除」;local 本就跑在同一台机器上,
|
||||
// 「下载」到本地是多余的(用 Finder 直接看原文件更顺),所以换成「在 Finder 中显示」。
|
||||
// @ 引用排最前:它是「往输入框送东西」的动作,和后面的下载 / Finder / 删除(对文件本身动手)分开
|
||||
row.appendChild(actBtn('at', ent.type === 'dir' ? '引用此目录' : '引用到输入框', SVG_AT, false));
|
||||
if (ent.type === 'file' && !localCapable) row.appendChild(actBtn('download', '下载', SVG_DL, false));
|
||||
if (localCapable) row.appendChild(actBtn('reveal', '在 Finder 中显示', SVG_REVEAL_SM, false));
|
||||
row.appendChild(actBtn('delete', '删除', SVG_DEL, true));
|
||||
return row;
|
||||
}
|
||||
|
||||
async function renderDirInto(container, rel, depth, dirMtime) {
|
||||
container.innerHTML = '';
|
||||
const data = await openDir(rel, dirMtime);
|
||||
if (!data) return;
|
||||
const frag = document.createDocumentFragment();
|
||||
const list = data.entries || [];
|
||||
// 只在根目录给空提示:子目录展开后本来就该「看不出变化」,根节点全空白则分不清是空还是没加载
|
||||
if (!list.length && !rel) tip(frag, '(空目录)');
|
||||
for (const ent of list) {
|
||||
frag.appendChild(rowFor(ent, depth));
|
||||
if (ent.type === 'dir' && expanded.has(ent.rel)) {
|
||||
const kids = document.createElement('div');
|
||||
kids.className = 'tree-children';
|
||||
frag.appendChild(kids);
|
||||
renderDirInto(kids, ent.rel, depth + 1, ent.mtimeMs).catch(function () {}); // 异步填充子层
|
||||
}
|
||||
}
|
||||
if (data.capped) tip(frag, '仅显示前 ' + list.length + ' 项(共 ' + data.total + ' 项)', 'tree-more');
|
||||
container.appendChild(frag);
|
||||
}
|
||||
|
||||
async function renderBody() {
|
||||
const body = $('tree-body');
|
||||
if (!body) return;
|
||||
// 没有会话就没有任务目录:不写提示,直接把侧栏退回会话列表。
|
||||
// 这条会兜住「在文件页里点了新建会话 / 删掉了当前会话」——那时卡片不该停在一个空树里。
|
||||
if (!sid()) {
|
||||
body.innerHTML = '';
|
||||
if (typeof setDrawerPane === 'function') setDrawerPane(false);
|
||||
return;
|
||||
}
|
||||
const sc = body.scrollTop;
|
||||
body.innerHTML = '';
|
||||
const root = document.createElement('div');
|
||||
body.appendChild(root);
|
||||
try {
|
||||
await renderDirInto(root, '', 0);
|
||||
} catch (e) {
|
||||
root.innerHTML = '';
|
||||
tip(root, '加载失败:' + e.message);
|
||||
}
|
||||
body.scrollTop = sc;
|
||||
syncSelUI();
|
||||
}
|
||||
|
||||
async function localAction(kind, rel) {
|
||||
if (!localCapable) return;
|
||||
if (!sid()) { toast('尚未开始会话'); return; }
|
||||
try {
|
||||
await req('POST', '/api/local/' + kind, { session: sid(), path: rel });
|
||||
} catch (e) {
|
||||
toast((kind === 'reveal' ? '打开目录失败:' : '打开终端失败:') + e.message);
|
||||
}
|
||||
}
|
||||
|
||||
async function deleteNode(rel, isDir) {
|
||||
if (!sid()) return;
|
||||
const name = rel.split('/').pop();
|
||||
const ok = typeof confirmModal === 'function'
|
||||
? await confirmModal('删除' + (isDir ? '文件夹' : '文件'),
|
||||
'删除「' + name + '」' + (isDir ? '(含其中全部内容)' : '') + '?', '删除', true)
|
||||
: true;
|
||||
if (!ok) return;
|
||||
try {
|
||||
await req('DELETE', '/api/sessions/' + sid() + '/files?path=' + encodeURIComponent(rel));
|
||||
// 预览里正开着被删的文件 → 一起关掉,别留一份已不存在的内容
|
||||
if (typeof pvState === 'object' && pvState && pvState.name === rel && typeof pvCloseDoc === 'function') pvCloseDoc();
|
||||
sel.delete(rel);
|
||||
invalidate(true);
|
||||
renderBody();
|
||||
} catch (e) { toast('删除失败:' + e.message); }
|
||||
}
|
||||
|
||||
// ---- 多选与批量操作 ----
|
||||
|
||||
// 有效选中:自身被勾,或某个祖先目录被勾(勾目录=整目录)。
|
||||
// 注意 UI 上只给 sel 里显式存在的行打勾:目录打勾就代表整目录,子行不再重复显示勾。
|
||||
function isSel(rel) {
|
||||
if (sel.has(rel)) return true;
|
||||
let p = rel;
|
||||
while (p.lastIndexOf('/') > 0) {
|
||||
p = p.slice(0, p.lastIndexOf('/'));
|
||||
if (sel.has(p)) return true;
|
||||
}
|
||||
return false;
|
||||
}
|
||||
|
||||
function toggleSel(rel, type) {
|
||||
if (sel.has(rel)) {
|
||||
sel.delete(rel);
|
||||
} else {
|
||||
// 选子项时祖先目录降级为部分选择,否则一个目录会既「全选」又「只选一部分」
|
||||
let p = rel;
|
||||
while (p.lastIndexOf('/') > 0) {
|
||||
p = p.slice(0, p.lastIndexOf('/'));
|
||||
sel.delete(p);
|
||||
}
|
||||
sel.set(rel, type);
|
||||
}
|
||||
syncSelUI();
|
||||
}
|
||||
|
||||
// 当前可见(已展开)的可选行
|
||||
function visibleRows() {
|
||||
const body = $('tree-body');
|
||||
if (!body) return [];
|
||||
return Array.from(body.querySelectorAll('.tree-row')).filter(function (r) {
|
||||
return r.dataset.type !== 'link';
|
||||
});
|
||||
}
|
||||
|
||||
// 提交给后端前折叠:目录已选时,它下面的路径不再单独出现(否则 zip 里会重复)
|
||||
function effectiveSel() {
|
||||
const keys = Array.from(sel.keys()).sort(function (a, b) {
|
||||
return a.split('/').length - b.split('/').length;
|
||||
});
|
||||
const out = [];
|
||||
for (const k of keys) {
|
||||
if (!out.some(function (p) { return k.startsWith(p + '/'); })) out.push(k);
|
||||
}
|
||||
return out;
|
||||
}
|
||||
|
||||
function syncSelUI() {
|
||||
const body = $('tree-body');
|
||||
if (body) {
|
||||
body.querySelectorAll('.tree-row').forEach(function (row) {
|
||||
const chk = row.querySelector('.tree-check');
|
||||
if (!chk) return;
|
||||
const on = sel.has(row.dataset.rel);
|
||||
chk.setAttribute('aria-checked', on ? 'true' : 'false');
|
||||
row.classList.toggle('selected', on);
|
||||
});
|
||||
}
|
||||
const n = sel.size;
|
||||
const cnt = $('tree-sel-count'), dl = $('tree-bulk-download'), del = $('tree-bulk-delete');
|
||||
if (cnt) cnt.textContent = n ? '已选 ' + n + ' 项' : '未选择';
|
||||
if (dl) dl.disabled = !n;
|
||||
if (del) del.disabled = !n;
|
||||
const all = $('tree-check-all');
|
||||
if (all) {
|
||||
const rows = visibleRows();
|
||||
const every = rows.length > 0 && rows.every(function (r) { return isSel(r.dataset.rel); });
|
||||
all.setAttribute('aria-checked', every ? 'true' : (n ? 'mixed' : 'false'));
|
||||
}
|
||||
}
|
||||
|
||||
function toggleSelAll() {
|
||||
const rows = visibleRows();
|
||||
const every = rows.length > 0 && rows.every(function (r) { return isSel(r.dataset.rel); });
|
||||
sel.clear();
|
||||
if (!every) {
|
||||
// 浅的先加:父目录已经覆盖的子项不再重复记
|
||||
rows.map(function (r) { return [r.dataset.rel, r.dataset.type]; })
|
||||
.sort(function (a, b) { return a[0].split('/').length - b[0].split('/').length; })
|
||||
.forEach(function (it) { if (!isSel(it[0])) sel.set(it[0], it[1]); });
|
||||
}
|
||||
syncSelUI();
|
||||
}
|
||||
|
||||
async function bulkDownload() {
|
||||
if (!sid() || !sel.size) return;
|
||||
const paths = effectiveSel();
|
||||
const hasDir = paths.some(function (p) { return sel.get(p) === 'dir'; });
|
||||
// 含目录 → 后端打成一个 zip;纯文件 → 逐个签名直链。
|
||||
// 先把 token 全取完再逐个触发,边取边点会让浏览器把后面的当弹窗拦掉。
|
||||
if (hasDir) {
|
||||
try {
|
||||
const r = await req('GET', '/api/sessions/' + sid() + '/files/zip-token?paths=' +
|
||||
encodeURIComponent(JSON.stringify(paths)));
|
||||
if (!r || !r.url) throw new Error('未拿到打包链接');
|
||||
const a = document.createElement('a');
|
||||
a.href = r.url;
|
||||
if (r.name) a.download = r.name;
|
||||
document.body.appendChild(a);
|
||||
a.click();
|
||||
a.remove();
|
||||
} catch (e) { toast('打包下载失败:' + e.message); }
|
||||
return;
|
||||
}
|
||||
const items = [];
|
||||
for (const p of paths) {
|
||||
try {
|
||||
const r = await req('GET', '/api/sessions/' + sid() + '/files/download-token?path=' +
|
||||
encodeURIComponent(p));
|
||||
if (r && r.url) items.push({ name: p.split('/').pop(), url: r.url });
|
||||
} catch (e) { /* 单个取票失败不拖累其余 */ }
|
||||
}
|
||||
if (!items.length) { toast('下载失败'); return; }
|
||||
items.forEach(function (it, i) {
|
||||
setTimeout(function () {
|
||||
const a = document.createElement('a');
|
||||
a.href = it.url;
|
||||
a.download = it.name;
|
||||
document.body.appendChild(a);
|
||||
a.click();
|
||||
a.remove();
|
||||
}, i * 250);
|
||||
});
|
||||
}
|
||||
|
||||
async function bulkDelete() {
|
||||
if (!sid() || !sel.size) return;
|
||||
const paths = effectiveSel();
|
||||
const ok = typeof confirmModal === 'function'
|
||||
? await confirmModal('批量删除', '删除选中的 ' + paths.length + ' 项?文件夹会连同内容一起删除。', '删除', true)
|
||||
: true;
|
||||
if (!ok) return;
|
||||
let done = 0, fail = 0;
|
||||
for (const p of paths) {
|
||||
try {
|
||||
await req('DELETE', '/api/sessions/' + sid() + '/files?path=' + encodeURIComponent(p));
|
||||
done++;
|
||||
} catch (e) { fail++; }
|
||||
}
|
||||
// 预览里正开着被删的文件就一起关掉,别留一份已不存在的内容
|
||||
if (typeof pvState === 'object' && pvState && pvState.name && typeof pvCloseDoc === 'function') {
|
||||
const cur = pvState.name;
|
||||
if (paths.some(function (p) { return cur === p || cur.startsWith(p + '/'); })) pvCloseDoc();
|
||||
}
|
||||
sel.clear();
|
||||
invalidate(true);
|
||||
renderBody();
|
||||
if (fail) toast('已删除 ' + done + ' 项,' + fail + ' 项失败'); // 全成功时列表自己就空了,不弹
|
||||
}
|
||||
|
||||
function onTreeClick(e) {
|
||||
const row = e.target.closest('.tree-row');
|
||||
if (!row) return;
|
||||
const rel = row.dataset.rel;
|
||||
const isDir = row.dataset.type === 'dir';
|
||||
// 勾选框只切换选中,不展开、不预览(树里点错行代价大,整行不承担选中)
|
||||
if (e.target.closest('.tree-check')) {
|
||||
e.stopPropagation();
|
||||
toggleSel(rel, row.dataset.type);
|
||||
return;
|
||||
}
|
||||
const act = e.target.closest('.tree-act');
|
||||
if (act) {
|
||||
e.stopPropagation();
|
||||
const a = act.dataset.act;
|
||||
if (a === 'download') { if (typeof downloadFile === 'function') downloadFile(rel); }
|
||||
else if (a === 'delete') deleteNode(rel, isDir);
|
||||
else if (a === 'reveal') localAction('reveal', rel);
|
||||
else if (a === 'at') insertPathRef(rel, isDir);
|
||||
return;
|
||||
}
|
||||
if (row.dataset.type === 'link') return;
|
||||
if (isDir) {
|
||||
if (expanded.has(rel)) expanded.delete(rel); else expanded.add(rel);
|
||||
renderBody();
|
||||
} else if (typeof openFilePreview === 'function') {
|
||||
openFilePreview(rel, '');
|
||||
// 窄屏的预览是全屏浮层:点完把抽屉收起(同点会话的行为),否则关预览后还压在抽屉上
|
||||
if (typeof openDrawer === 'function' && !window.matchMedia('(min-width: 960px)').matches) openDrawer(false);
|
||||
}
|
||||
}
|
||||
|
||||
// @ 引用:把相对路径插到对话框光标处。插的是纯相对路径,不带 @ 前缀——
|
||||
// @<会话id>/<rel> 是跨会话只读路径的语法(resolvePastPath),带上会被当成会话 id 而报错。
|
||||
// 相对路径正是 read_file / list_directory 直接认的形态。
|
||||
function insertPathRef(rel, isDir) {
|
||||
const ta = $('msg-input');
|
||||
if (!ta || !rel) return;
|
||||
const txt = isDir ? rel + '/' : rel;
|
||||
const s = ta.selectionStart == null ? ta.value.length : ta.selectionStart;
|
||||
const e = ta.selectionEnd == null ? s : ta.selectionEnd;
|
||||
const before = ta.value.slice(0, s);
|
||||
const after = ta.value.slice(e);
|
||||
// 前后补空格:粘在已有文字上会让路径和句子糊成一串,AI 切不开。
|
||||
// 末尾(光标后无内容)也补一个,光标落在空格之后,接着打字不会和路径粘连。
|
||||
const lead = before && !/\s$/.test(before) ? ' ' : '';
|
||||
const tail = after ? (/^\s/.test(after) ? '' : ' ') : ' ';
|
||||
ta.value = before + lead + txt + tail + after;
|
||||
// 光标落在「路径 + 尾部空格」之后:末尾插入时继续打字不会和路径粘连(空格真起作用),
|
||||
// 开头/中间插入时也停在插入块之后,与原文自然隔开。
|
||||
const pos = (before + lead + txt + tail).length;
|
||||
ta.focus();
|
||||
try { ta.setSelectionRange(pos, pos); } catch (_) { /* 部分环境不支持,光标位置不强求 */ }
|
||||
ta.dispatchEvent(new Event('input', { bubbles: true })); // 发送按钮状态 / 自动高度靠它跟上
|
||||
}
|
||||
|
||||
// local 能力探测结果回来后才把「在 Finder/终端中打开」露出来(服务器形态永远隐藏)
|
||||
|
||||
function syncLocalButtons() {
|
||||
const rv = $('tree-reveal'), tm = $('tree-terminal');
|
||||
if (rv) rv.classList.toggle('hidden', !localCapable);
|
||||
if (tm) tm.classList.toggle('hidden', !localCapable);
|
||||
// 本地端文件就在本机,批量下载是多余的,底栏只留删除;服务器端才需要
|
||||
const bulkDl = $('tree-bulk-download');
|
||||
if (bulkDl) bulkDl.classList.toggle('hidden', localCapable);
|
||||
if (localCapable && $('tree-body')) renderBody(); // 行内 reveal 按钮也要重新生成
|
||||
}
|
||||
|
||||
function ensureShell() {
|
||||
const box = $('files-tree');
|
||||
if (!box || box.dataset.ready) return;
|
||||
box.dataset.ready = '1';
|
||||
box.innerHTML = '';
|
||||
|
||||
// 头部直接复用预览栏的 .pv-head / .pv-actions / .icon-btn:
|
||||
// 两者在桌面上左右并排,尺寸/描边/内边距必须一模一样,否则一眼就看出错位。
|
||||
// 不放地址条(路径在 280px 里必然截断,没有信息量)。
|
||||
// 操作钮按用途分两组:左边是树内的只读操作(显示隐藏文件 / 刷新 / Git 面板),
|
||||
// 右边是拉到外部打开(Finder / 终端,仅本地模式出现)。两组分居两端,连点不易误触。
|
||||
const head = document.createElement('header');
|
||||
head.className = 'pv-head tree-head';
|
||||
head.innerHTML =
|
||||
'<span class="pv-actions tree-actions-main">' +
|
||||
'<button class="icon-btn" type="button" id="tree-hidden" title="显示隐藏文件" aria-label="显示隐藏文件">' + SVG_EYE + '</button>' +
|
||||
'<button class="icon-btn" type="button" id="tree-refresh" title="刷新" aria-label="刷新">' + SVG_REFRESH + '</button>' +
|
||||
'<button class="icon-btn" type="button" id="tree-vcs" title="Git 改动与历史" aria-label="Git 改动与历史">' + SVG_VCS + '</button>' +
|
||||
'</span>' +
|
||||
'<span class="pv-actions tree-actions-ext">' +
|
||||
'<button class="icon-btn hidden" type="button" id="tree-reveal" title="在 Finder 中打开" aria-label="在 Finder 中打开">' + SVG_REVEAL + '</button>' +
|
||||
'<button class="icon-btn hidden" type="button" id="tree-terminal" title="在终端中打开" aria-label="在终端中打开">' + SVG_TERM + '</button>' +
|
||||
'</span>';
|
||||
|
||||
const body = document.createElement('div');
|
||||
body.className = 'tree-body';
|
||||
body.id = 'tree-body';
|
||||
|
||||
// 底部批量条:全选框、计数、下载/删除。未选时两个按钮禁用。
|
||||
const foot = document.createElement('div');
|
||||
foot.className = 'tree-foot';
|
||||
foot.innerHTML =
|
||||
'<span class="tree-check-all" id="tree-check-all" role="checkbox" aria-checked="false" title="全选当前可见" aria-label="全选"></span>' +
|
||||
'<span class="tree-sel-count" id="tree-sel-count">未选择</span>' +
|
||||
'<button class="tree-foot-btn" type="button" id="tree-bulk-download" title="下载所选" aria-label="下载所选" disabled>' + SVG_DL + '</button>' +
|
||||
'<button class="tree-foot-btn danger" type="button" id="tree-bulk-delete" title="删除所选" aria-label="删除所选" disabled>' + SVG_DEL + '</button>';
|
||||
|
||||
box.appendChild(head);
|
||||
box.appendChild(body);
|
||||
box.appendChild(foot);
|
||||
|
||||
head.querySelector('#tree-hidden').addEventListener('click', function () {
|
||||
showHidden = !showHidden;
|
||||
invalidate(false);
|
||||
this.classList.toggle('active', showHidden);
|
||||
renderBody();
|
||||
});
|
||||
head.querySelector('#tree-refresh').addEventListener('click', function () {
|
||||
invalidate(true);
|
||||
renderBody();
|
||||
});
|
||||
head.querySelector('#tree-reveal').addEventListener('click', function () { localAction('reveal', ''); });
|
||||
head.querySelector('#tree-terminal').addEventListener('click', function () { localAction('terminal', ''); });
|
||||
head.querySelector('#tree-vcs').addEventListener('click', function () {
|
||||
if (typeof window.openVcsPane === 'function') window.openVcsPane();
|
||||
});
|
||||
foot.querySelector('#tree-check-all').addEventListener('click', toggleSelAll);
|
||||
foot.querySelector('#tree-bulk-download').addEventListener('click', bulkDownload);
|
||||
foot.querySelector('#tree-bulk-delete').addEventListener('click', bulkDelete);
|
||||
body.addEventListener('click', onTreeClick);
|
||||
|
||||
syncLocalButtons();
|
||||
}
|
||||
|
||||
// 侧栏底部「文件树」图标 → 切到这个面板(由 files.js 的 setDrawerPane 调用)。
|
||||
window.showFileTree = function () {
|
||||
ensureShell();
|
||||
// 缓存还在就直接用:同一会话里反复开关面板,不该把已展开的目录全部重拉一遍
|
||||
// (展开 N 层就是 N 轮请求,移动网络下能到 1-2 秒)。文件真变了有 reloadFileTree 兜底,
|
||||
// 它在一轮跑完 / 回前台 / 断线重连时会把已展开的层重新拉一遍。
|
||||
if (!cache.size) invalidate(true);
|
||||
renderBody();
|
||||
};
|
||||
|
||||
// 会话切换后由 sessions.js 调用,避免树停在旧会话。
|
||||
window.refreshFileTree = function () {
|
||||
invalidate(false);
|
||||
const drawer = $('drawer');
|
||||
if (drawer && drawer.classList.contains('drawer-mode-files')) renderBody();
|
||||
};
|
||||
|
||||
// 按需刷新(一轮跑完 / 回前台 / 断线重连):保留展开与勾选,只重拉已展开的目录。
|
||||
// 不在文件树面板时只标脏不渲染,等切回来由 showFileTree 重新拉。
|
||||
let reloadTimer = 0, reloadAt = 0, reloading = false;
|
||||
window.reloadFileTree = function () {
|
||||
clearTimeout(reloadTimer);
|
||||
reloadTimer = setTimeout(async function () {
|
||||
if (Date.now() - reloadAt < 1000) return; // 刚刷过:多路触发(done/visibility/focus/resync)合并掉
|
||||
if (reloading) return; // 上一轮还在渲,跳过(它读到的就是刚清过的缓存)
|
||||
reloadAt = Date.now();
|
||||
invalidate(true);
|
||||
const drawer = $('drawer');
|
||||
if (!drawer || !drawer.classList.contains('drawer-mode-files')) return;
|
||||
reloading = true;
|
||||
try { await renderBody(); } finally { reloading = false; }
|
||||
}, 250);
|
||||
};
|
||||
|
||||
(function init() {
|
||||
if (!$('drawer-actions') || !$('files-tree')) return;
|
||||
req('GET', '/api/local/info').then(function (info) {
|
||||
if (!info || !info.enabled) return;
|
||||
localCapable = true;
|
||||
syncLocalButtons();
|
||||
}).catch(function () { /* 服务器形态:接口 404,保持纯服务器行为 */ });
|
||||
})();
|
||||
})();
|
||||
+102
-81
@@ -49,8 +49,7 @@
|
||||
// 深度思考开关:每次发消息随 body 传给后端,后端会合并该模型的 thinking_params
|
||||
$('deep-think-btn').addEventListener('click', () => {
|
||||
state.deepThink = !state.deepThink;
|
||||
$('deep-think-btn').classList.toggle('on', state.deepThink);
|
||||
toast(state.deepThink ? '深度思考已开启' : '深度思考已关闭');
|
||||
$('deep-think-btn').classList.toggle('on', state.deepThink); // 按钮态即反馈,不再弹 toast
|
||||
});
|
||||
|
||||
// ---------- 任务文件面板(底部浮层:点输入行右侧文件夹按钮展开,遮罩盖住输入区) ----------
|
||||
@@ -159,10 +158,10 @@
|
||||
return fileSelected.has(p) || isPathInDirSel(p);
|
||||
}
|
||||
// 目录节点内所有文件的相对路径(递归)
|
||||
// 当前层能拿到的文件(懒加载只拉这一层,子目录内容没有;
|
||||
// 目录整体勾选走 dirSelKey,zip 打包由后端 collectZipEntries 递归)
|
||||
function filesUnderDir(node) {
|
||||
let out = node.files.map(f => f.filename);
|
||||
for (const d of node.dirs.values()) out = out.concat(filesUnderDir(d));
|
||||
return out;
|
||||
return node ? node.files.map(f => f.filename) : [];
|
||||
}
|
||||
// 全选的作用域 = 当前浏览目录下的全部文件(递归含其子文件夹,等价于逐个勾选这些文件夹行)。
|
||||
// 不能再用全任务树的扁平列表:在子文件夹里点全选会把根下其它文件也选上,批量删除会清空整个任务目录。
|
||||
@@ -298,31 +297,28 @@
|
||||
// 扁平文件列表 → 树节点 { name, path, dirs: Map, files: [] }
|
||||
// 目录标记行(?dirs=1:filename 以 '/' 结尾 + dir:true)只沿途铺设路径节点、不入任何 files[],
|
||||
// 不含文件的空夹子因此也能渲染;与同名文件路径铺出的节点经 dirs Map 天然去重。
|
||||
function buildFilesTree(files) {
|
||||
const root = { name: '', path: '', dirs: new Map(), files: [] };
|
||||
for (const f of files) {
|
||||
const isDir = f.dir === true || /\/$/.test(String(f.filename));
|
||||
const name = isDir ? String(f.filename).replace(/\/+$/, '') : String(f.filename);
|
||||
if (!name) continue;
|
||||
const segs = name.split('/');
|
||||
let node = root, rel = '';
|
||||
const dirDepth = isDir ? segs.length : segs.length - 1; // 文件:末段是文件名;目录:全是路径段
|
||||
for (let i = 0; i < dirDepth; i++) {
|
||||
const seg = segs[i];
|
||||
rel = rel ? rel + '/' + seg : seg;
|
||||
if (!node.dirs.has(seg)) node.dirs.set(seg, { name: seg, path: rel, dirs: new Map(), files: [] });
|
||||
node = node.dirs.get(seg);
|
||||
// 把 /tree 返回的单层 entries 变成渲染用节点(子目录只留空 Map,进入时才拉)
|
||||
function buildNodeFromEntries(dir, entries) {
|
||||
const node = { name: dir.split('/').pop() || '', path: dir, dirs: new Map(), files: [] };
|
||||
for (const e of entries) {
|
||||
if (e.type === 'dir') {
|
||||
node.dirs.set(e.name, { name: e.name, path: e.rel, dirs: new Map(), files: [], mtime: e.mtimeMs });
|
||||
} else if (e.type === 'file') {
|
||||
node.files.push({ filename: e.rel, size: e.size, mtime: e.mtimeMs, ctime: e.mtimeMs });
|
||||
}
|
||||
if (!isDir) node.files.push(f);
|
||||
}
|
||||
return root;
|
||||
return node;
|
||||
}
|
||||
|
||||
// 目录(含子目录)内文件总数,用于目录头计数
|
||||
function countDirFiles(node) {
|
||||
let n = node.files.length;
|
||||
for (const d of node.dirs.values()) n += countDirFiles(d);
|
||||
return n;
|
||||
// 文件/目录时间:统一「年/月/日 时:分」。全局 fmtTime 对今天只给时分(聊天消息那种场景),
|
||||
// 文件列表要能一眼看出新旧,所以固定带日期。
|
||||
function fmtFileTime(ts) {
|
||||
if (!ts) return '';
|
||||
const d = new Date(ts);
|
||||
if (isNaN(d.getTime())) return '';
|
||||
const p = n => String(n).padStart(2, '0');
|
||||
return d.getFullYear() + '/' + p(d.getMonth() + 1) + '/' + p(d.getDate())
|
||||
+ ' ' + p(d.getHours()) + ':' + p(d.getMinutes());
|
||||
}
|
||||
|
||||
function fileRowHtml(f) {
|
||||
@@ -330,10 +326,10 @@
|
||||
const low = f.filename.toLowerCase();
|
||||
const fsPv = /\.(md|txt|html?|pdf|png|jpe?g|gif|webp|svg|docx|xlsx|pptx|csv|tsv|json|jsonl|xml|yml|yaml|toml|ini|conf|cfg|properties|env|log|py|pyw|js|mjs|cjs|ts|tsx|jsx|java|kt|c|h|cpp|hpp|cc|cs|go|rs|rb|php|swift|sh|bash|zsh|bat|ps1|sql|lua|r|dart|vue|css|less|scss|srt|vtt)$/.test(low);
|
||||
const ico = fsPv
|
||||
? '<svg class="file-ico eye" viewBox="0 0 24 24" aria-label="可预览"><path d="M1 12s4-8 11-8 11 8 11 8-4 8-11 8-11-8-11-8z"></path><circle cx="12" cy="12" r="3"></circle></svg>'
|
||||
: '<svg class="file-ico doc" viewBox="0 0 24 24" aria-label="可下载"><path d="M14 2H6a2 2 0 0 0-2 2v16a2 2 0 0 0 2 2h12a2 2 0 0 0 2-2V8z"></path><polyline points="14 2 14 8 20 8"></polyline></svg>';
|
||||
? '<svg class="file-ico eye" viewBox="0 0 24 24" aria-label="可预览"><use href="#i-eye"/></svg>'
|
||||
: '<svg class="file-ico doc" viewBox="0 0 24 24" aria-label="可下载"><use href="#i-file-doc"/></svg>';
|
||||
const name = esc(String(f.filename).split('/').pop() || f.filename);
|
||||
const ftime = fmtTime(f.mtime || f.ctime);
|
||||
const ftime = fmtFileTime(f.mtime || f.ctime);
|
||||
const sel = isFileEffectivelySelected(f.filename);
|
||||
return '<div class="file-row clickable' + (sel ? ' selected' : '') + '" data-path="' + esc(f.filename) + '" data-preview="' + (fsPv ? '1' : '0') + '" data-size="' + esc(fmtSize(f.size)) + '">' +
|
||||
'<span class="file-check" role="checkbox" aria-checked="' + (sel ? 'true' : 'false') + '" aria-label="选择"></span>' +
|
||||
@@ -347,29 +343,23 @@
|
||||
|
||||
// 目录行(带勾选框):整个文件夹作为一个选中项(下载时后端打包成 zip);
|
||||
// 点行其余区域进入该目录(单层列表,不再有折叠/展开)。
|
||||
// 懒加载下不知道子目录内容,勾选态只看这一行自己是否被整体勾选;右侧显示修改时间,和文件行一致。
|
||||
function dirRowHtml(node) {
|
||||
const under = filesUnderDir(node);
|
||||
const checked = fileSelected.has(dirSelKey(node.path)) ||
|
||||
(under.length > 0 && under.every(isFileEffectivelySelected));
|
||||
const checked = fileSelected.has(dirSelKey(node.path));
|
||||
const dtime = fmtFileTime(node.mtime);
|
||||
return '<div class="file-dir-head' + (checked ? ' selected' : '') + '" data-dir="' + esc(node.path) + '" role="button">' +
|
||||
'<span class="file-check" role="checkbox" aria-checked="' + (checked ? 'true' : 'false') + '" aria-label="选择文件夹"></span>' +
|
||||
'<svg class="file-dir-ico" viewBox="0 0 24 24"><path d="M22 19a2 2 0 0 1-2 2H4a2 2 0 0 1-2-2V5a2 2 0 0 1 2-2h5l2 3h9a2 2 0 0 1 2 2z"></path></svg>' +
|
||||
'<svg class="file-dir-ico" viewBox="0 0 24 24"><use href="#i-folder-c"/></svg>' +
|
||||
'<span class="file-dir-name">' + esc(node.name) + '</span>' +
|
||||
'<span class="file-dir-count">' + countDirFiles(node) + ' 个文件</span>' +
|
||||
'<svg class="file-dir-go" viewBox="0 0 24 24"><polyline points="9 18 15 12 9 6"></polyline></svg>' +
|
||||
(dtime ? '<span class="file-dir-time">' + dtime + '</span>' : '') +
|
||||
'<svg class="file-dir-go" viewBox="0 0 24 24"><use href="#i-chevron-right"/></svg>' +
|
||||
'</div>';
|
||||
}
|
||||
|
||||
// 按相对路径取树节点('' = 根);路径不存在(如删除后重拉)返回 null
|
||||
// 懒加载下只有当前浏览目录的节点('' = 根);其它路径没有数据
|
||||
function filesNodeAt(path) {
|
||||
let node = filesTreeRoot;
|
||||
if (!node) return null;
|
||||
if (!path) return node;
|
||||
for (const seg of String(path).split('/')) {
|
||||
node = node.dirs.get(seg);
|
||||
if (!node) return null;
|
||||
}
|
||||
return node;
|
||||
if (!filesTreeRoot) return null;
|
||||
return (path || '') === filesCurDir ? filesTreeRoot : null;
|
||||
}
|
||||
|
||||
// 渲染当前目录:顶部面包屑(根目录(home) › a › b,点任意节点回跳)+ 单层列表(目录在前、文件在后)。
|
||||
@@ -381,13 +371,13 @@
|
||||
if (!node) { filesCurDir = ''; node = filesNodeAt(''); } // 当前目录已被删除 → 退回根
|
||||
const sizeEl = $('files-panel-size');
|
||||
if (!node) { el.innerHTML = ''; if (sizeEl) sizeEl.textContent = ''; return; }
|
||||
// 标题旁总大小:按未过滤的聚合表取当前目录递归总量(关彩蛋时服务端不返回 dot 项;开彩蛋时含 .imgcache/.tmp/.venv 全计)
|
||||
// 标题旁总大小:只算当前层文件(子目录的递归大小要额外扫全树,懒加载拿不到)
|
||||
if (sizeEl) {
|
||||
const total = filesDirSizes.get(filesCurDir) || 0;
|
||||
sizeEl.textContent = total > 0 ? fmtSize(total) : '';
|
||||
}
|
||||
// 根节点:home 图标 + 「根目录」,比一个孤悬的「/」醒目得多;在根时它是当前层,纯文本不可点
|
||||
const homeIc = '<svg class="crumb-ic" viewBox="0 0 24 24"><path d="M3 9l9-7 9 7v11a2 2 0 0 1-2 2H5a2 2 0 0 1-2-2z"></path><polyline points="9 22 9 12 15 12 15 22"></polyline></svg>';
|
||||
const homeIc = '<svg class="crumb-ic" viewBox="0 0 24 24"><use href="#i-home"/></svg>';
|
||||
let html = filesCurDir
|
||||
? '<span class="crumb" data-path="">' + homeIc + '根目录</span>'
|
||||
: '<span class="crumb cur">' + homeIc + '根目录</span>';
|
||||
@@ -420,28 +410,18 @@
|
||||
filesTreeRoot = null;
|
||||
updateFilesFooter();
|
||||
try {
|
||||
// 彩蛋开启时后端连 dot 项一起列,且不再滤 .tmp/.venv(全量放出)
|
||||
// 按目录懒加载:只拉当前这一层(/tree),不再全量递归。
|
||||
// 之前一次拉全树,仓库级工作目录能到 1.4MB(10544 个文件,81% 在 node_modules)。
|
||||
const hiddenQ = filesShowHidden ? '&hidden=1' : '';
|
||||
const files = await req('GET', '/api/sessions/' + state.sessionId + '/files?dirs=1' + hiddenQ);
|
||||
// 会话级 .tmp(executor 的共享 /tmp 落盘处)与 .venv(Python 虚拟环境)不属于任务产物:默认隐藏(老后端兼容兑底;新版关彩蛋时服务端已不返回 dot 项)
|
||||
const shown = filesShowHidden ? files : files.filter(f => !/^(\.tmp|\.venv)(\/|$)/.test(String(f.filename)));
|
||||
// 重建目录树后只渲染当前目录这一层(后端已按时间倒序,组内再排一次防旧排序缓存)
|
||||
filesTreeRoot = buildFilesTree(shown);
|
||||
// 总大小按原始列表(含 .tmp/.venv)聚合:目录标记行无字节量跳过;文件把 size 记到每一级祖先目录(根 = '')
|
||||
filesDirSizes = new Map([['', 0]]);
|
||||
for (const f of files) {
|
||||
if (f.dir === true || /\/$/.test(String(f.filename))) continue;
|
||||
const sz = Number(f.size) || 0;
|
||||
if (!sz) continue;
|
||||
filesDirSizes.set('', (filesDirSizes.get('') || 0) + sz);
|
||||
const segs = String(f.filename).split('/');
|
||||
segs.pop(); // 末段是文件名,其余是祖先目录
|
||||
let acc = '';
|
||||
for (const seg of segs) {
|
||||
acc = acc ? acc + '/' + seg : seg;
|
||||
filesDirSizes.set(acc, (filesDirSizes.get(acc) || 0) + sz);
|
||||
}
|
||||
}
|
||||
const data = await req('GET', '/api/sessions/' + state.sessionId + '/tree?dir='
|
||||
+ encodeURIComponent(filesCurDir) + hiddenQ);
|
||||
const entries = (data && data.entries) || [];
|
||||
filesTreeRoot = buildNodeFromEntries(filesCurDir, entries);
|
||||
// 标题旁总大小:只统计当前层文件(子目录的递归大小要额外扫全树,懒加载拿不到)
|
||||
let total = 0;
|
||||
for (const f of filesTreeRoot.files) total += Number(f.size) || 0;
|
||||
filesDirSizes = new Map([[filesCurDir, total]]);
|
||||
if (data && data.capped) toast('目录条目过多,仅显示前 ' + entries.length + ' 项');
|
||||
renderFilesDir(); // filesCurDir 失效时自动退回根目录
|
||||
// 重新渲染后刷新底部计数与按钮状态
|
||||
updateFilesFooter();
|
||||
@@ -544,8 +524,7 @@
|
||||
if (!dp || !state.sessionId) return;
|
||||
if (e.target.closest('.file-check')) { toggleDirSelect(dp); return; }
|
||||
filesCurDir = dp;
|
||||
renderFilesDir();
|
||||
updateFilesFooter(); // 全选作用域随浏览目录变化,刷新底部勾选态
|
||||
loadFiles(); // 懒加载:进哪层拉哪层(renderFilesDir / updateFilesFooter 在它内部调)
|
||||
return;
|
||||
}
|
||||
const row = e.target.closest('.file-row');
|
||||
@@ -595,8 +574,7 @@
|
||||
const c = e.target.closest('.crumb[data-path]');
|
||||
if (!c) return;
|
||||
filesCurDir = c.dataset.path;
|
||||
renderFilesDir();
|
||||
updateFilesFooter(); // 同上:面包屑回跳也重算全选态
|
||||
loadFiles(); // 同上:面包屑回跳也按目录重拉
|
||||
});
|
||||
|
||||
// 彩蛋:点面板标题旁的总大小文本 = 切换隐藏文件(dot 项含 .tmp/.venv)显隐。
|
||||
@@ -666,8 +644,7 @@
|
||||
ok++;
|
||||
} catch (e) { fail++; toast('删除失败:' + name + ' ' + e.message); }
|
||||
}
|
||||
if (ok) toast('已删除 ' + ok + ' 项');
|
||||
loadFiles(); // 重新拉取并重置选中
|
||||
loadFiles(); // 重新拉取并重置选中;失败已逐条提示,全成功时不弹汇总
|
||||
}
|
||||
$('files-bulk-download').addEventListener('click', bulkDownload);
|
||||
$('files-bulk-delete').addEventListener('click', bulkDelete);
|
||||
@@ -775,8 +752,8 @@
|
||||
function uploadIconSvg(name) {
|
||||
// 与文件面板同款图标语言:图片用图、其余用文档
|
||||
return /\.(png|jpe?g|gif|webp|bmp|svg)$/i.test(name || '')
|
||||
? '<svg class="ic" viewBox="0 0 24 24"><rect x="3" y="3" width="18" height="18" rx="2" ry="2"></rect><circle cx="8.5" cy="8.5" r="1.5"></circle><polyline points="21 15 16 10 5 21"></polyline></svg>'
|
||||
: '<svg class="ic" viewBox="0 0 24 24"><path d="M14 2H6a2 2 0 0 0-2 2v16a2 2 0 0 0 2 2h12a2 2 0 0 0 2-2V8z"></path><polyline points="14 2 14 8 20 8"></polyline></svg>';
|
||||
? '<svg class="ic" viewBox="0 0 24 24"><use href="#i-image-b"/></svg>'
|
||||
: '<svg class="ic" viewBox="0 0 24 24"><use href="#i-file-doc"/></svg>';
|
||||
}
|
||||
function addUploadCard(file) {
|
||||
const row = $('up-cards');
|
||||
@@ -791,7 +768,7 @@
|
||||
'<div class="up-meta">' + uploadTypeLabel(file.name) + ' · ' + fmtSize(file.size) + '</div>' +
|
||||
'</div>' +
|
||||
'<button class="up-x hidden" title="不再随消息告知该文件" aria-label="移除卡片">' +
|
||||
'<svg class="ic" viewBox="0 0 24 24"><line x1="18" y1="6" x2="6" y2="18"></line><line x1="6" y1="6" x2="18" y2="18"></line></svg>' +
|
||||
'<svg class="ic" viewBox="0 0 24 24"><use href="#i-x-line-b"/></svg>' +
|
||||
'</button>' +
|
||||
'<div class="up-mask"><span class="up-pct">0%</span></div>';
|
||||
const mask = card.querySelector('.up-mask');
|
||||
@@ -910,6 +887,9 @@
|
||||
// 全部成功不再弹提示(卡片已完成态即反馈);有失败才提醒
|
||||
if (errCount) toast('已上传 ' + done + ' 个,失败 ' + errCount + ' 个');
|
||||
loadFiles();
|
||||
// 桌面端左栏文件树是新的浏览入口,上传后要同步(旧面板只在手机端用);
|
||||
// 用 reloadFileTree 保留展开与勾选,refreshFileTree 会把用户展开的目录全收起来
|
||||
if (typeof window.reloadFileTree === 'function') window.reloadFileTree();
|
||||
// 1.2s 后收起进度条(还有别的批次在传就不收)
|
||||
setTimeout(() => {
|
||||
if (uploadBatches.size) return;
|
||||
@@ -1057,7 +1037,7 @@
|
||||
row.innerHTML = state.attachments.map((f, i) =>
|
||||
'<span class="attach-chip"><span class="name">' + esc(f.name) + '</span>' +
|
||||
'<button class="rm" data-i="' + i + '" aria-label="移除附件">' +
|
||||
'<svg class="ic sm" viewBox="0 0 24 24"><line x1="18" y1="6" x2="6" y2="18"></line><line x1="6" y1="6" x2="18" y2="18"></line></svg>' +
|
||||
'<svg class="ic sm" viewBox="0 0 24 24"><use href="#i-x-line-b"/></svg>' +
|
||||
'</button></span>').join('');
|
||||
}
|
||||
$('attach-chips').addEventListener('click', e => {
|
||||
@@ -1091,11 +1071,21 @@
|
||||
searchTimer = setTimeout(loadSessionList, 250);
|
||||
});
|
||||
$('drawer-list').addEventListener('click', e => {
|
||||
// 桌面端 hover 删除按钮:先于打开会话处理,点击弹删除确认 modal
|
||||
// 桌面端 hover 行内按钮:先于打开会话处理
|
||||
const popBtn = e.target.closest('.conv-pop');
|
||||
if (popBtn) {
|
||||
e.stopPropagation();
|
||||
// files=1 让新窗口开局直接把侧栏切到文件树(打开后即被 syncUrl 抹掉)
|
||||
window.open('/?s=' + encodeURIComponent(popBtn.dataset.pop) + '&files=1', '_blank', 'noopener');
|
||||
return;
|
||||
}
|
||||
// 删除按钮:点击弹删除确认 modal
|
||||
const delBtn = e.target.closest('.conv-del');
|
||||
if (delBtn) { e.stopPropagation(); deleteSession(delBtn.dataset.del); return; }
|
||||
const item = e.target.closest('.conv-item');
|
||||
if (!item) return;
|
||||
// 设置页现在保留左栏(可在设置中看会话/文件):点会话即退出设置页回到对话。
|
||||
if (typeof closeSettings === 'function' && !$('settings-page').classList.contains('hidden')) closeSettings();
|
||||
openSession(item.dataset.id);
|
||||
if (!drawerMQ.matches) openDrawer(false); // 桌面端侧栏常驻,选完会话不收起来
|
||||
});
|
||||
@@ -1229,9 +1219,40 @@
|
||||
document.addEventListener('touchcancel', e => endDrag(e, false), { passive: true });
|
||||
})();
|
||||
|
||||
// 抽屉底部用户区:整行点击 → 设置主页(逻辑见文末「设置区」一节)
|
||||
$('drawer-user').addEventListener('click', () => {
|
||||
if (!drawerMQ.matches) openDrawer(false); // 桌面端设置页覆盖在会话区上,侧栏保持展开
|
||||
// 抽屉底部图标操作栏:文件树 / 预览 / 设置。
|
||||
// 「文件树」是侧栏两个互斥面板的切换开关:不在文件页 → 切到文件树(高亮),
|
||||
// 再点一次 → 回会话列表(不亮)。预览与设置不占用侧栏,高亮由 preview.js / settings.js 同步。
|
||||
function setDrawerPane(files) {
|
||||
// 窄屏没有文件树(只有输入行右侧的旧文件面板),任何调用方都不允许切过去
|
||||
if (files && !drawerMQ.matches) return;
|
||||
// 还没开始会话 = 没有任务目录:不切过去(否则只能切出一个写着「尚未开始会话」的空面板)
|
||||
if (files && !state.sessionId) return;
|
||||
// 文件树模块没加载成功时不要把一个空面板切出来
|
||||
if (files && typeof window.showFileTree !== 'function') return;
|
||||
const drawer = $('drawer');
|
||||
const changed = drawer.classList.contains('drawer-mode-files') !== files;
|
||||
drawer.classList.toggle('drawer-mode-files', files);
|
||||
$('da-files').classList.toggle('active', files);
|
||||
// 重复点当前项不重干活(不重拉列表/不重渲树),避免白掉请求和滚动位置
|
||||
if (!changed) return;
|
||||
if (files) window.showFileTree();
|
||||
else loadSessionList();
|
||||
// 地址栏跟着侧栏模式走(?s=<id>&files=1):刷新后还停在同一面板
|
||||
if (typeof syncUrl === 'function') syncUrl();
|
||||
}
|
||||
$('da-files').addEventListener('click', () => {
|
||||
setDrawerPane(!$('drawer').classList.contains('drawer-mode-files'));
|
||||
});
|
||||
// 窄屏只保留输入行右侧的旧「任务文件」面板,左栏不再提供文件树(按钮也已 CSS 隐藏)。
|
||||
// 宽屏缩到窄屏时如果正停在文件页,先退回会话列表,避免出现两套文件 UI。
|
||||
drawerMQ.addEventListener('change', (e) => { if (!e.matches) setDrawerPane(false); });
|
||||
// 预览没有独立按钮:桌面端只在文件树里点文件时开窗(关窗走预览栏自己的关闭钮 / Esc)。
|
||||
$('da-settings').addEventListener('click', () => {
|
||||
if (typeof showSettings !== 'function') return;
|
||||
const page = $('settings-page');
|
||||
// 再点一次返回(关设置页);否则打开。不看当前在设置栈的第几层,都当"退出设置"
|
||||
if (page && !page.classList.contains('hidden')) { closeSettings(); return; }
|
||||
if (!drawerMQ.matches) openDrawer(false); // 移动端设置页整屏,抽屉先收起
|
||||
showSettings();
|
||||
});
|
||||
|
||||
|
||||
@@ -0,0 +1,116 @@
|
||||
// 数学公式渲染(KaTeX 本地化,vendor/katex/)。
|
||||
// 所有 markdown 入口(聊天气泡 / md 文件预览 / 流式增量)都走 core.js 的 mdHtml(),
|
||||
// 公式处理收在这一个文件里,不散落到各处。
|
||||
//
|
||||
// 支持:
|
||||
// $$...$$ 块级(可换行)
|
||||
// $...$ 行内($ 后不能是空白、前不能是数字/字母,避免「$5 ... $6」被当公式)
|
||||
//
|
||||
// 实现方式:占位符往返,而不是 marked 扩展。
|
||||
// 1) markdown 解析前,把公式抠成 @@MATHn@@ 占位(跳过围栏代码与行内代码)
|
||||
// 2) 交给 marked 正常解析
|
||||
// 3) 输出 HTML 里把占位换回 KaTeX 渲染结果
|
||||
// 这样公式里的 * _ \ { } 不会被 marked 当成强调/转义吃掉。
|
||||
|
||||
const MATH_PH = /@@MATH(\d+)@@/g;
|
||||
|
||||
// 从 markdown 源里抠出公式,返回 { md, store }
|
||||
function mathExtract(src) {
|
||||
const text = String(src || '');
|
||||
const store = [];
|
||||
let out = '';
|
||||
let i = 0;
|
||||
while (i < text.length) {
|
||||
// 围栏代码块整段跳过(三个反引号)
|
||||
if (text.startsWith('```', i)) {
|
||||
const end = text.indexOf('```', i + 3);
|
||||
const stop = end < 0 ? text.length : end + 3;
|
||||
out += text.slice(i, stop);
|
||||
i = stop;
|
||||
continue;
|
||||
}
|
||||
// 行内代码跳过
|
||||
if (text[i] === '`') {
|
||||
const end = text.indexOf('`', i + 1);
|
||||
if (end > i) {
|
||||
out += text.slice(i, end + 1);
|
||||
i = end + 1;
|
||||
continue;
|
||||
}
|
||||
}
|
||||
// 块级 $$...$$
|
||||
if (text.startsWith('$$', i)) {
|
||||
const end = text.indexOf('$$', i + 2);
|
||||
if (end > i + 2) {
|
||||
const latex = text.slice(i + 2, end).trim();
|
||||
if (latex) {
|
||||
store.push({ latex: latex, display: true });
|
||||
out += '@@MATH' + (store.length - 1) + '@@';
|
||||
i = end + 2;
|
||||
continue;
|
||||
}
|
||||
}
|
||||
}
|
||||
// 行内 $...$
|
||||
if (text[i] === '$') {
|
||||
const m = /^\$(?!\s)((?:\\.|[^$\\\n])+?)(?<!\s)\$/.exec(text.slice(i));
|
||||
if (m) {
|
||||
const before = i > 0 ? text[i - 1] : '';
|
||||
const after = text[i + m[0].length] || '';
|
||||
// 前后紧邻字母/数字时不当公式:$5 和 $6、a$b$c 之类
|
||||
if (!/[0-9A-Za-z]/.test(before) && !/[0-9A-Za-z]/.test(after)) {
|
||||
store.push({ latex: m[1], display: false });
|
||||
out += '@@MATH' + (store.length - 1) + '@@';
|
||||
i += m[0].length;
|
||||
continue;
|
||||
}
|
||||
}
|
||||
}
|
||||
out += text[i];
|
||||
i++;
|
||||
}
|
||||
return { md: out, store: store };
|
||||
}
|
||||
|
||||
function mathEsc(s) {
|
||||
return String(s == null ? '' : s).replace(/[&<>"]/g, function (c) {
|
||||
return { '&': '&', '<': '<', '>': '>', '"': '"' }[c];
|
||||
});
|
||||
}
|
||||
|
||||
// 单个公式 → HTML。KaTeX 不存在或 LaTeX 有错时原样吐回,用户能看见哪里写错了。
|
||||
function mathRenderOne(latex, display) {
|
||||
const wrap = display ? '$$' : '$';
|
||||
if (typeof katex === 'undefined') {
|
||||
return '<span class="math-fallback">' + wrap + mathEsc(latex) + wrap + '</span>';
|
||||
}
|
||||
try {
|
||||
const html = katex.renderToString(latex, {
|
||||
displayMode: display,
|
||||
throwOnError: false,
|
||||
output: 'html',
|
||||
strict: false,
|
||||
});
|
||||
// 块级公式自己占一行;行内公式保持内联
|
||||
return display ? '<span class="math-block">' + html + '</span>' : '<span class="math-inline">' + html + '</span>';
|
||||
} catch (e) {
|
||||
return '<span class="math-error" title="' + mathEsc(String((e && e.message) || e)) + '">' +
|
||||
wrap + mathEsc(latex) + wrap + '</span>';
|
||||
}
|
||||
}
|
||||
|
||||
// 把 HTML 里的占位换回渲染结果
|
||||
function mathExpand(html, store) {
|
||||
if (!store || !store.length) return html;
|
||||
return String(html || '').replace(MATH_PH, function (all, idx) {
|
||||
const item = store[Number(idx)];
|
||||
return item ? mathRenderOne(item.latex, item.display) : all;
|
||||
});
|
||||
}
|
||||
|
||||
// 一步到位:markdown → 含公式的 HTML。markedRef 由调用方传入(core.js 里的全局 marked)
|
||||
function mdParseWithMath(text, markedRef) {
|
||||
const r = mathExtract(text);
|
||||
const html = markedRef.parse(r.md);
|
||||
return mathExpand(html, r.store);
|
||||
}
|
||||
+326
-57
@@ -1,7 +1,8 @@
|
||||
// 通用文档预览窗(桌面右侧 #pv-pane / 移动端全屏 #fs-viewer)
|
||||
// 通用文档预览窗(桌面分栏 #pv-pane:文件树 | 预览 | 会话 / 移动端全屏 #fs-viewer)
|
||||
// —— 文件列表的点击一律进预览窗:office 走 /preview 预览网关(固定格式前端自拼);
|
||||
// md/txt/代码/json/csv 等文本渲染;html/pdf/图片专用渲染;其余类型显示文件信息占位 + 下载。
|
||||
// 桌面打开时自动折叠左侧历史栏让位,关闭恢复;左右边界可拖拽调宽(记忆在 localStorage)。
|
||||
// 桌面端紧贴左栏文件树右侧:点文件后内容就在旁边,不用横跨整个会话区看。
|
||||
// 右边界可拖拽调宽(记忆在 localStorage)。
|
||||
// 依赖(core.js/chat.js/stream.js/files.js 顶层声明):state $ esc toast mdHtml decorateCodePre
|
||||
// rewriteHtmlDocSrcs rewriteMdImageSrcs openFullscreen setFsSource closeFullscreen
|
||||
// openImageViewer downloadFile openDrawer
|
||||
@@ -14,9 +15,64 @@ const PV_PLAIN = /\.(txt|log)$/i;
|
||||
// 常见代码/配置/数据文本扩展名;无扩展名的文件(Dockerfile/LICENSE 等)也按文本尝试,二进制嗅探兜底
|
||||
const PV_TEXT = /\.(md|markdown|txt|log|csv|tsv|json|jsonl|xml|yml|yaml|toml|ini|conf|cfg|properties|env|py|pyw|js|mjs|cjs|ts|tsx|jsx|java|kt|c|h|cpp|hpp|cc|cs|go|rs|rb|php|swift|sh|bash|zsh|bat|ps1|sql|lua|r|dart|vue|css|less|scss|srt|vtt)$/i;
|
||||
const PV_TEXT_MAX = 512 * 1024; // 文本预览截断阈值(字符),超出提示下载看全文
|
||||
const PV_CODE_MAX = 5000; // 代码预览最多逐行渲染的行数:行号要逐行建节点,几万行会把面板拖死
|
||||
// 扩展名 → Prism 语言 id。只映射打包进来的语言(见 vendor/prism.min.js),命中不了就当纯文本
|
||||
const PV_LANG = {
|
||||
js: 'javascript', mjs: 'javascript', cjs: 'javascript', jsx: 'jsx',
|
||||
ts: 'typescript', mts: 'typescript', cts: 'typescript', tsx: 'tsx',
|
||||
json: 'json', jsonl: 'json', json5: 'json',
|
||||
yml: 'yaml', yaml: 'yaml',
|
||||
sh: 'bash', bash: 'bash', zsh: 'bash', ksh: 'bash', env: 'bash',
|
||||
py: 'python', pyw: 'python',
|
||||
go: 'go', rs: 'rust', java: 'java',
|
||||
c: 'c', h: 'c', cpp: 'cpp', hpp: 'cpp', cc: 'cpp', cxx: 'cpp', hh: 'cpp',
|
||||
sql: 'sql', css: 'css', wxss: 'css',
|
||||
html: 'markup', htm: 'markup', xml: 'markup', svg: 'markup', vue: 'markup',
|
||||
md: 'markdown', markdown: 'markdown',
|
||||
toml: 'toml', ini: 'ini', conf: 'ini', cfg: 'ini', properties: 'ini',
|
||||
diff: 'diff', patch: 'diff',
|
||||
};
|
||||
// 整块高亮;Prism 没加载、语言没打包、或抛异常都返回 null,调用方退回纯文本
|
||||
function pvHighlightCode(text, name) {
|
||||
if (typeof Prism === 'undefined' || !Prism.languages) return null;
|
||||
const ext = (String(name).match(/\.([^.\\/]+)$/) || [])[1];
|
||||
const lang = PV_LANG[String(ext || '').toLowerCase()];
|
||||
const grammar = lang && Prism.languages[lang];
|
||||
if (!grammar) return null;
|
||||
try { return Prism.highlight(text, grammar, lang); } catch (_) { return null; }
|
||||
}
|
||||
// 把整块高亮 HTML 按行拆开:跨行的 <span> 在行尾补 </span>、下一行行首重开。
|
||||
// 逐行调用 Prism.highlight 会把多行注释/三引号字符串切花,所以必须先整块高亮再拆。
|
||||
// Prism 输出的文本已转义(< 等),不存在裸 '<',因此只匹配标签与换行就够了。
|
||||
function pvSplitHighlighted(html) {
|
||||
const out = [];
|
||||
const stack = [];
|
||||
let cur = '';
|
||||
let last = 0;
|
||||
const re = /(\n|<span\b[^>]*>|<\/span>)/g;
|
||||
let m;
|
||||
while ((m = re.exec(html))) {
|
||||
cur += html.slice(last, m.index);
|
||||
last = m.index + m[0].length;
|
||||
if (m[0] === '\n') {
|
||||
out.push(cur + '</span>'.repeat(stack.length));
|
||||
cur = stack.join('');
|
||||
} else if (m[0] === '</span>') {
|
||||
stack.pop();
|
||||
cur += '</span>';
|
||||
} else {
|
||||
stack.push(m[0]);
|
||||
cur += m[0];
|
||||
}
|
||||
}
|
||||
out.push(cur + html.slice(last)); // 末尾无条件留一行:文本以 \n 结尾时最后是空行
|
||||
return out;
|
||||
}
|
||||
const PV_SRC_MAX = 2 * 1024 * 1024; // 源码面板的显示上限,超过就只给前 2MB(大文件塞 pre 会卡)
|
||||
let pvSeq = 0; // 预览序号:快速连点时旧请求不许再动 DOM
|
||||
// reload: 当前内容的"重新载入"动作(文本类无 iframe,按名重开);为 null 时回退到 reload iframe
|
||||
const pvState = { name: null, url: null, blobUrl: null, reload: null, drawerWasOpen: false, mobilePush: false };
|
||||
const pvState = { name: null, url: null, blobUrl: null, reload: null, mobilePush: false,
|
||||
source: null, srcOn: false, bodyNode: null, srcPre: null };
|
||||
|
||||
function pvDesktop() { return window.matchMedia('(min-width: 960px)').matches; }
|
||||
|
||||
@@ -25,6 +81,18 @@ function pvOfficeUrl(rel) {
|
||||
String(rel).split('/').filter(Boolean).map(encodeURIComponent).join('/') + '/';
|
||||
}
|
||||
|
||||
// 图片预览派生地址:服务端按 w 生成并缓存 WebP,<img> 直连可边下边画;原图只留给“下载”。
|
||||
function pvPreviewUrl(rel, w) {
|
||||
return '/api/sessions/' + encodeURIComponent(state.sessionId) +
|
||||
'/files/preview?path=' + encodeURIComponent(rel) + '&w=' + w;
|
||||
}
|
||||
|
||||
// PDF 预览直连:让内建查看器自己发 Range 请求,不必先 fetch 整包转 blob。
|
||||
function pvPdfUrl(rel) {
|
||||
return '/api/sessions/' + encodeURIComponent(state.sessionId) +
|
||||
'/files/inline?path=' + encodeURIComponent(rel);
|
||||
}
|
||||
|
||||
function pvKind(name) {
|
||||
const low = String(name).toLowerCase();
|
||||
if (/\.html?$/i.test(low)) return 'html';
|
||||
@@ -36,8 +104,8 @@ function pvKind(name) {
|
||||
}
|
||||
|
||||
// 文件面板「当前目录」里的图片作为一组,供查看器左右滑动切换。
|
||||
// 同组直接用下载直链(<img> 不受 Content-Disposition: attachment 影响),不必逐张取 blob。
|
||||
// 依赖 files.js 的 filesNodeAt / filesCurDir / assetDownloadUrl(同为全局,加载顺序在前)。
|
||||
// 同组直接用预览派生直链(2048px),不必逐张取原图/blob,滑动的预取也不会打满带宽。
|
||||
// 依赖 files.js 的 filesNodeAt / filesCurDir(同为全局,加载顺序在前)。
|
||||
function pvImgGroup(name) {
|
||||
try {
|
||||
if (typeof filesNodeAt !== 'function') return null;
|
||||
@@ -46,7 +114,7 @@ function pvImgGroup(name) {
|
||||
const paths = node.files.map(f => f.filename).filter(p => PV_IMG.test(p));
|
||||
if (paths.length < 2) return null;
|
||||
return {
|
||||
list: paths.map(p => ({ src: assetDownloadUrl(p), alt: p.split('/').pop() })),
|
||||
list: paths.map(p => ({ src: pvPreviewUrl(p, 2048), alt: p.split('/').pop() })),
|
||||
at: paths.indexOf(name),
|
||||
};
|
||||
} catch (_) { return null; }
|
||||
@@ -54,13 +122,62 @@ function pvImgGroup(name) {
|
||||
|
||||
// 刷新/新窗口两个钮对**所有**预览类型统一开放:
|
||||
// refresh → pvState.reload(各类型都注入「按同一路径重开」,与地址条回车同一条路)
|
||||
// popup → pvState.url(office=预览网关;文本/HTML/图片/PDF=blob URL;不支持的类型=下载地址)
|
||||
// 服务端文件响应一律是 attachment,直接导航只会触发下载,所以能用 blob 的一律走 blob。
|
||||
// popup → pvState.url(office=预览网关;图片/PDF=inline 直链;
|
||||
// 文本/HTML=blob URL;不支持的类型=下载地址)
|
||||
// 下载接口是 attachment,直接导航只会触发下载;图片/PDF 走各自的 inline 路由可直接开新窗口。
|
||||
function pvToolbar(o) {
|
||||
document.getElementById('pv-refresh').classList.toggle('hidden', !o.refresh);
|
||||
document.getElementById('pv-popup').classList.toggle('hidden', !o.popup);
|
||||
pvState.reload = typeof o.reload === 'function' ? o.reload : null;
|
||||
pvState.url = o.url === undefined ? null : o.url;
|
||||
// 源码钮:o.source 是原文(已渲染过的内容才有),没传就藏起来并回到预览态
|
||||
pvState.source = o.source == null || o.source === '' ? null : String(o.source);
|
||||
pvState.srcOn = false;
|
||||
pvState.srcPre = null;
|
||||
const sb = document.getElementById('pv-src');
|
||||
sb.classList.toggle('hidden', pvState.source == null);
|
||||
sb.classList.remove('active');
|
||||
sb.title = '查看源码';
|
||||
sb.setAttribute('aria-label', '查看源码');
|
||||
}
|
||||
|
||||
// 预览 ↔ 源码互切:不重建预览节点,只把它 display:none 再挂一个等宽 pre,来回切代价很低
|
||||
function pvToggleSrc() {
|
||||
const btn = document.getElementById('pv-src');
|
||||
if (!btn || pvState.source == null || !pvState.bodyNode) return;
|
||||
pvState.srcOn = !pvState.srcOn;
|
||||
if (pvState.srcOn) {
|
||||
let text = pvState.source;
|
||||
if (text.length > PV_SRC_MAX) text = text.slice(0, PV_SRC_MAX) + '\n\n…(源码较大,仅显示前 ' + Math.round(PV_SRC_MAX / 1024) + ' KB)';
|
||||
const pre = document.createElement('pre');
|
||||
pre.className = 'pv-pre pv-src-pre'; // 源码面板:不加行号的原文(代码预览本身走 .pv-code)
|
||||
pre.textContent = text; // 不用 innerHTML:源码里的标签必须当文本
|
||||
pvState.srcPre = pre;
|
||||
document.getElementById('pv-body').appendChild(pre);
|
||||
pvState.bodyNode.style.display = 'none';
|
||||
} else {
|
||||
if (pvState.srcPre && pvState.srcPre.parentNode) pvState.srcPre.parentNode.removeChild(pvState.srcPre);
|
||||
pvState.srcPre = null;
|
||||
pvState.bodyNode.style.display = '';
|
||||
}
|
||||
btn.classList.toggle('active', pvState.srcOn);
|
||||
const lbl = pvState.srcOn ? '返回预览' : '查看源码';
|
||||
btn.title = lbl;
|
||||
btn.setAttribute('aria-label', lbl);
|
||||
}
|
||||
|
||||
// md 里的围栏代码块上色:marked 输出 <pre><code class="language-xx">,命中 PV_LANG 才处理。
|
||||
// highlightElement 会重写 code 的 innerHTML,复制按钮挂在父级 .code-wrap 上,不受影响。
|
||||
function pvHighlightMdCode(root) {
|
||||
if (typeof Prism === 'undefined' || !Prism.languages) return;
|
||||
root.querySelectorAll('pre code').forEach((el) => {
|
||||
if (el.dataset.hl) return; // 幂等:同一节点被重复装饰时不再处理
|
||||
const m = /language-([\w-]+)/.exec(String(el.className || ''));
|
||||
const lang = m && PV_LANG[m[1].toLowerCase()];
|
||||
if (!lang || !Prism.languages[lang]) return;
|
||||
el.dataset.hl = '1';
|
||||
try { Prism.highlightElement(el); } catch (_) {}
|
||||
});
|
||||
}
|
||||
|
||||
// 每次展示内容都过一遍:标题显示相对路径(子目录可见),右上角下载钮随文件走
|
||||
@@ -76,6 +193,11 @@ function pvClearBody() {
|
||||
document.getElementById('pv-body').innerHTML = '';
|
||||
pvState.reload = null; // 换内容/关窗后旧的刷新动作立即失效
|
||||
pvState.url = null; // 新窗口地址同理:不清会残留上一份内容的 blob/网关 URL
|
||||
pvState.source = null; // 源码同样跟内容走,不然会把上一个文件的原文留在按钮里
|
||||
pvState.srcOn = false;
|
||||
pvState.bodyNode = null;
|
||||
pvState.srcPre = null;
|
||||
document.getElementById('pv-src').classList.add('hidden');
|
||||
if (pvState.blobUrl) { try { URL.revokeObjectURL(pvState.blobUrl); } catch (_) {} pvState.blobUrl = null; }
|
||||
}
|
||||
|
||||
@@ -90,8 +212,7 @@ function pvInfoNode(name, sizeText, hint) {
|
||||
const box = document.createElement('div');
|
||||
box.className = 'pv-none';
|
||||
box.innerHTML =
|
||||
'<svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1.4" stroke-linecap="round" stroke-linejoin="round">' +
|
||||
'<path d="M14 2H6a2 2 0 0 0-2 2v16a2 2 0 0 0 2 2h12a2 2 0 0 0 2-2V8z"></path><polyline points="14 2 14 8 20 8"></polyline></svg>' +
|
||||
'<svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1.4" stroke-linecap="round" stroke-linejoin="round"><use href="#i-file-doc"/></svg>' +
|
||||
'<div class="nm"></div><div class="meta"></div><div class="hint"></div>';
|
||||
box.querySelector('.nm').textContent = String(name || '');
|
||||
box.querySelector('.meta').textContent = sizeText ? sizeText : '';
|
||||
@@ -104,25 +225,27 @@ function pvInfoNode(name, sizeText, hint) {
|
||||
}
|
||||
|
||||
function pvOpenPane() {
|
||||
// 不自动折叠左侧栏:左栏是文件树,打开预览时保持可见(文件树 | 预览 | 会话)。
|
||||
if (!document.body.classList.contains('pv-open')) {
|
||||
pvState.drawerWasOpen = document.getElementById('drawer').classList.contains('open');
|
||||
if (pvState.drawerWasOpen && typeof openDrawer === 'function') openDrawer(false); // 挤压式分栏:折叠左侧让位
|
||||
document.body.classList.add('pv-open');
|
||||
}
|
||||
// 开预览就把侧栏切到文件树:预览就贴在它旁边,切了才能顺手换文件看。
|
||||
// 已经在文件页时 setDrawerPane 内部会因「没变化」而直接返回,不会重复拉树。
|
||||
if (typeof setDrawerPane === 'function') setDrawerPane(true);
|
||||
}
|
||||
|
||||
function pvCloseDoc() {
|
||||
if (!document.body.classList.contains('pv-open')) return;
|
||||
document.body.classList.remove('pv-open', 'pv-max');
|
||||
if (typeof vcsSetMode === 'function') vcsSetMode(false); // 关面板即离开 Git 模式
|
||||
if (typeof pvSetMaxUI === 'function') pvSetMaxUI(false); // 收起时复位放大钮图标(函数声明提升,定义在后亦可)
|
||||
pvClearBody();
|
||||
pvState.name = null; pvState.url = null;
|
||||
if (pvState.drawerWasOpen) {
|
||||
pvState.drawerWasOpen = false;
|
||||
if (typeof openDrawer === 'function') openDrawer(true); // 恢复打开预览前的折叠态
|
||||
}
|
||||
}
|
||||
|
||||
// 侧栏底部没有「预览」按钮:桌面端的预览只有一条入口——在文件树里点文件(点即开窗),
|
||||
// 关窗走预览栏自己的关闭钮 / Esc / 缩到窄屏。所以这里不再维护任何按钮高亮状态。
|
||||
|
||||
// 移动端全屏承载:把节点塞进 #fs-viewer 并展开
|
||||
// opts.bar → 文件预览沉浸模式:顶部独立操作条,内容全宽占满剩余空间
|
||||
// opts.name → 操作条左侧的文件名(仅 bar 模式可见)
|
||||
@@ -188,9 +311,56 @@ async function pvOpenOffice(name, sizeText) {
|
||||
pvState.url = url;
|
||||
}
|
||||
|
||||
// ---------- 站内地址预览:会话流里的链接 / 地址条回车 → 直接挂进预览窗 ----------
|
||||
// 「本机」判定:完全同源,或两端都是本机别名(localhost/127.0.0.1/[::1]/0.0.0.0,端口不究)。
|
||||
// 外链、锚点、mailto、相对路径都不算,调用方自行放行。
|
||||
function pvLocalHost(h) { return h === 'localhost' || h === '127.0.0.1' || h === '::1' || h === '[::1]' || h === '0.0.0.0'; }
|
||||
function pvSameHost(target) {
|
||||
let u;
|
||||
try { u = new URL(target, location.href); } catch (_) { return null; }
|
||||
if (u.origin === location.origin) return u;
|
||||
if (pvLocalHost(u.hostname) && pvLocalHost(location.hostname)) return u;
|
||||
return null;
|
||||
}
|
||||
function pvUrlTitle(url) {
|
||||
try {
|
||||
const u = new URL(url, location.href);
|
||||
return decodeURIComponent(u.pathname.split('/').filter(Boolean).pop() || '') || u.host;
|
||||
} catch (_) { return String(url); }
|
||||
}
|
||||
// iframe 直挂,不走文件读取链路:桌面进右侧分栏,窄屏进全屏浮层。
|
||||
// sandbox 与现有 HTML 预览一致——data-page 页面要靠脚本渲染表格。
|
||||
function pvOpenUrl(url, title) {
|
||||
const desk = pvDesktop();
|
||||
const name = title || pvUrlTitle(url);
|
||||
++pvSeq; // 在途的文件预览请求就此作废,别回来抢 DOM
|
||||
const mkFrame = () => {
|
||||
const fr = document.createElement('iframe');
|
||||
fr.className = desk ? 'pv-frame' : 'fs-html-frame';
|
||||
fr.title = name;
|
||||
fr.setAttribute('sandbox', 'allow-same-origin allow-scripts');
|
||||
fr.src = url;
|
||||
return fr;
|
||||
};
|
||||
if (desk) {
|
||||
pvOpenPane(); pvClearBody();
|
||||
pvHeader(name, '');
|
||||
pvState.name = null; // 不是文件:下载钮收起(按名下载会拼错路径)
|
||||
document.getElementById('pv-download').classList.add('hidden');
|
||||
pvToolbar({ refresh: true, popup: true, reload: () => pvOpenUrl(url, title), url });
|
||||
const t = document.getElementById('pv-title'); // 地址条显示完整地址,可选中复制
|
||||
t.value = url; t.title = url;
|
||||
document.getElementById('pv-body').appendChild(mkFrame());
|
||||
} else {
|
||||
pvOverlayShow(mkFrame(), { bar: true, name });
|
||||
if (!pvState.mobilePush) { try { history.pushState({ pvOffice: 1 }, ''); pvState.mobilePush = true; } catch (_) {} }
|
||||
}
|
||||
}
|
||||
|
||||
// ---------- 统一入口:所有文件点击都走这 ----------
|
||||
async function openFilePreview(name, sizeText) {
|
||||
if (!state.sessionId) return;
|
||||
if (typeof vcsSetMode === 'function') vcsSetMode(false); // 点文件即离开 Git 面板(预览/Git 二选一)
|
||||
if (PV_OFFICE.test(name)) { try { await pvOpenOffice(name, sizeText); } catch (e) { toast('预览失败:' + e.message); } return; }
|
||||
let kind = pvKind(name);
|
||||
if (kind === 'pdf' && !navigator.pdfViewerEnabled) kind = 'none'; // WebView 内嵌不了 PDF:给占位卡,不再自动下载
|
||||
@@ -209,9 +379,12 @@ async function openFilePreview(name, sizeText) {
|
||||
}
|
||||
const show = (node, tb) => {
|
||||
if (my !== pvSeq) return;
|
||||
// 节点上挂了 __src(原文)就带进工具条:预览栏据此显示源码钮。手机端的源码钮走 fs-viewer,不掺和。
|
||||
if (node && node.__src != null) { tb = Object.assign({}, tb || tbAll, { source: node.__src }); delete node.__src; }
|
||||
if (desk) {
|
||||
pvClearBody(); pvHeader(name, sizeText);
|
||||
document.getElementById('pv-body').appendChild(node);
|
||||
pvState.bodyNode = node;
|
||||
pvToolbar(tb || tbAll);
|
||||
} else pvOverlayShow(node, { bar: true, name: name });
|
||||
};
|
||||
@@ -223,6 +396,40 @@ async function openFilePreview(name, sizeText) {
|
||||
show(pvInfoNode(name, sizeText, hint), tbAll);
|
||||
return;
|
||||
}
|
||||
// 图片走服务端派生预览:<img> 直连边下边画,不再 fetch 整包转 blob;原图只在“下载”时取。
|
||||
// SVG 保留原路径(移动端还要展示源码),其余图片统一交给 /files/preview。
|
||||
if (kind === 'img' && !/\.svg$/i.test(name)) {
|
||||
const alt = String(name).split('/').pop();
|
||||
const g = pvImgGroup(name);
|
||||
if (desk) {
|
||||
const im = document.createElement('img');
|
||||
im.className = 'pv-img'; im.alt = String(name); im.decoding = 'async';
|
||||
// 面板宽度约半屏,交给浏览器按 DPR 选 640/1280/2048,手机不会去拉大图
|
||||
im.sizes = '(min-width: 960px) 50vw, 100vw';
|
||||
im.srcset = [640, 1280, 2048].map(w => pvPreviewUrl(name, w) + ' ' + w + 'w').join(',');
|
||||
const url = pvPreviewUrl(name, 2048);
|
||||
im.src = url;
|
||||
im.addEventListener('click', () => openImageViewer(url, alt, g && g.list, g && g.at));
|
||||
im.addEventListener('error', () => {
|
||||
if (my !== pvSeq) return;
|
||||
show(pvInfoNode(name, sizeText, '图片读取失败:文件可能已被删除,或格式无法解码。'), tbAll);
|
||||
});
|
||||
show(im, Object.assign({}, tbAll, { url }));
|
||||
} else {
|
||||
openImageViewer(pvPreviewUrl(name, 2048), alt, g && g.list, g && g.at);
|
||||
}
|
||||
return;
|
||||
}
|
||||
// PDF 直连 inline 路由:桌面面板与窄窗口(全屏 overlay)都让内建查看器按 Range 取字节,
|
||||
// 不再 fetch 整包转 blob。show() 会按 desk 自动落到右侧面板或 #fs-viewer。
|
||||
if (kind === 'pdf') {
|
||||
const url = pvPdfUrl(name);
|
||||
const fr = document.createElement('iframe');
|
||||
fr.className = desk ? 'pv-frame' : 'fs-html-frame';
|
||||
fr.title = String(name); fr.src = url;
|
||||
show(fr, Object.assign({}, tbAll, { url }));
|
||||
return;
|
||||
}
|
||||
let r;
|
||||
try {
|
||||
r = await fetch('/api/sessions/' + state.sessionId + '/files/download?path=' + encodeURIComponent(name));
|
||||
@@ -240,11 +447,13 @@ async function openFilePreview(name, sizeText) {
|
||||
// 统一等 show() 之后登记,陈旧序号则立即撤销防泄漏。
|
||||
let newBlobUrl = null;
|
||||
if (kind === 'html') {
|
||||
const src = rewriteHtmlDocSrcs(await r.text(), name); // 相对资源改写,否则 about:srcdoc/blob 基准下全 404
|
||||
const raw = await r.text(); // 原文留着做源码面板,改写只用于内嵌显示
|
||||
const src = rewriteHtmlDocSrcs(raw, name); // 相对资源改写,否则 about:srcdoc/blob 基准下全 404
|
||||
const fr = document.createElement('iframe');
|
||||
fr.className = 'pv-frame';
|
||||
fr.setAttribute('sandbox', 'allow-same-origin allow-scripts');
|
||||
fr.srcdoc = src;
|
||||
fr.__src = raw;
|
||||
newBlobUrl = URL.createObjectURL(new Blob([src], { type: 'text/html;charset=utf-8' }));
|
||||
tb = Object.assign({}, tbAll, { url: newBlobUrl }); // 新窗口=改写后的页面(与面板里同一份)
|
||||
node = fr;
|
||||
@@ -255,10 +464,14 @@ async function openFilePreview(name, sizeText) {
|
||||
fr.className = 'pv-frame'; fr.title = String(name); fr.src = u; // 不加 sandbox:内建查看器插件需要 unrestricted 帧
|
||||
node = fr; tb = Object.assign({}, tbAll, { url: u });
|
||||
} else if (kind === 'img') {
|
||||
const u = URL.createObjectURL(await r.blob());
|
||||
// r 只能读一次:svg 先取文本再自己包 blob(也顺便拿到源码面板要的原文)
|
||||
const isSvg = /\.svg$/i.test(name);
|
||||
const svgText = isSvg ? await r.text() : null;
|
||||
const u = URL.createObjectURL(isSvg ? new Blob([svgText], { type: 'image/svg+xml;charset=utf-8' }) : await r.blob());
|
||||
newBlobUrl = u;
|
||||
const im = document.createElement('img');
|
||||
im.className = 'pv-img'; im.src = u; im.alt = String(name);
|
||||
if (isSvg) im.__src = svgText;
|
||||
const g = pvImgGroup(name);
|
||||
im.addEventListener('click', () => openImageViewer(u, String(name).split('/').pop(), g && g.list, g && g.at));
|
||||
node = im; tb = Object.assign({}, tbAll, { url: u });
|
||||
@@ -284,21 +497,69 @@ function pvCloseOverlayQuiet() { const fs = document.getElementById('fs-viewer')
|
||||
// 其余按 text/plain 原样打开——服务端文件响应一律 attachment,直接导航只会触发下载。
|
||||
// md 里原样透传的 <script> 在面板(innerHTML)本就不执行,但 blob 文档会执行,故先剔除以保持一致。
|
||||
function pvMdDoc(html, name) {
|
||||
// KaTeX 样式表用根绝对路径引入:blob 文档的 base 是 blob:,相对路径找不到字体
|
||||
const css =
|
||||
'body{margin:0;padding:24px 32px 48px;max-width:900px;font:15px/1.7 -apple-system,BlinkMacSystemFont,"Segoe UI","PingFang SC","Microsoft YaHei",sans-serif;color:#1f2328;background:#fff}' +
|
||||
'img{max-width:100%;height:auto}pre{background:#f6f8fa;padding:12px 14px;border-radius:8px;overflow:auto}' +
|
||||
'code{font-family:ui-monospace,SFMono-Regular,Menlo,Consolas,monospace;font-size:.92em}' +
|
||||
'table{border-collapse:collapse}th,td{border:1px solid #d8dee4;padding:6px 10px}' +
|
||||
'blockquote{margin:0;padding:0 14px;color:#57606a;border-left:3px solid #d8dee4}' +
|
||||
'a{color:#0969da}';
|
||||
'a{color:#0969da}' +
|
||||
'.math-block{display:block;text-align:center;margin:14px 0;overflow-x:auto;overflow-y:hidden}';
|
||||
const title = esc(String(name || '').split('/').pop() || '预览');
|
||||
const origin = (typeof location !== 'undefined' && location.origin) ? location.origin : '';
|
||||
return '<!DOCTYPE html><html><head><meta charset="utf-8">' +
|
||||
'<meta name="viewport" content="width=device-width,initial-scale=1">' +
|
||||
'<title>' + title + '</title><style>' + css + '</style></head><body>' +
|
||||
'<title>' + title + '</title>' +
|
||||
'<link rel="stylesheet" href="' + origin + '/vendor/katex/katex.min.css">' +
|
||||
'<style>' + css + '</style></head><body>' +
|
||||
html.replace(/<script\b[\s\S]*?(?:<\/script\s*>|$)/gi, '') + '</body></html>';
|
||||
}
|
||||
function pvTextUrl(text) { return URL.createObjectURL(new Blob([text], { type: 'text/plain;charset=utf-8' })); }
|
||||
|
||||
// 代码/配置/数据渲染:行号 + Prism 着色。桌面(pvTextNode)与移动端(pvRenderLegacy)共用——
|
||||
// 移动端原来只 esc 成纯文本,同一个文件在手机上没行号也没颜色。
|
||||
function pvCodeNode(text, name) {
|
||||
const frag = document.createDocumentFragment();
|
||||
let bodyText = text;
|
||||
if (text.length > PV_TEXT_MAX) {
|
||||
bodyText = text.slice(0, PV_TEXT_MAX);
|
||||
const tip = document.createElement('div');
|
||||
tip.className = 'pv-trunc';
|
||||
tip.textContent = '文件较大,仅预览前 ' + Math.round(PV_TEXT_MAX / 1024) + ' KB,完整内容请下载查看。';
|
||||
frag.appendChild(tip);
|
||||
}
|
||||
// 逐行渲染以便左侧打行号(视觉同 Git 面板的 .vcs-line)。
|
||||
// 超过 PV_CODE_MAX 行只渲染前段,剩下的交代一句——几万个逐行节点会让面板卡到没法滚。
|
||||
const lines = bodyText.split('\n');
|
||||
const total = lines.length;
|
||||
const shown = total > PV_CODE_MAX ? lines.slice(0, PV_CODE_MAX) : lines;
|
||||
const code = document.createElement('div');
|
||||
code.className = 'pv-code';
|
||||
code.style.setProperty('--nw', Math.max(2, String(shown.length).length) + 'ch'); // 行号列宽按最大行号位数
|
||||
const rows = [];
|
||||
const hl = pvHighlightCode(shown.join('\n'), name); // 整块高亮再按行拆,跨行 token 才不会花
|
||||
const parts = hl ? pvSplitHighlighted(hl) : null;
|
||||
const useHl = parts && parts.length === shown.length; // 行数对不上就退回纯文本,不让行号错位
|
||||
for (let i = 0; i < shown.length; i++) {
|
||||
// 行号交给 CSS counter(.pv-cl::before)生成:伪元素不进选区,复制不会把行号带走。
|
||||
// 代码必须包在 .c 里:裸文本在 flex 容器里是匿名 flex 项,浏览器会折叠它的前导空白。
|
||||
rows.push('<div class="pv-cl"><span class="c">' + (useHl ? parts[i] : esc(shown[i])) + '</span></div>');
|
||||
}
|
||||
code.innerHTML = rows.join('');
|
||||
frag.appendChild(code);
|
||||
if (total > PV_CODE_MAX) {
|
||||
const tip2 = document.createElement('div');
|
||||
tip2.className = 'pv-trunc';
|
||||
tip2.textContent = '文件较大,仅显示前 ' + PV_CODE_MAX + ' 行(共 ' + total + ' 行),完整内容请下载查看。';
|
||||
frag.appendChild(tip2);
|
||||
}
|
||||
const holder = document.createElement('div');
|
||||
holder.className = 'pv-plain';
|
||||
holder.appendChild(frag);
|
||||
return holder;
|
||||
}
|
||||
|
||||
// 桌面文本渲染:md 走气泡 markdown;txt/log 原文排版;代码/配置/数据等宽 pre;二进制嗅探回退占位卡
|
||||
async function pvTextNode(name, sizeText, r) {
|
||||
const text = await r.text();
|
||||
@@ -313,37 +574,25 @@ async function pvTextNode(name, sizeText, r) {
|
||||
wrap.className = 'msg other';
|
||||
wrap.innerHTML = '<div class="' + cls + ' pv-doc">' + html + '</div>';
|
||||
decorateCodePre(wrap);
|
||||
pvHighlightMdCode(wrap); // 围栏代码块上色(与代码预览同一套配色)
|
||||
const n = wrap.firstChild;
|
||||
// q.fmt=false 表示 marked 不可用、面板就是原文排版:新窗口也按纯文本开,避免空白被折叠
|
||||
n.__tb = q.fmt
|
||||
? { popup: true, url: URL.createObjectURL(new Blob([pvMdDoc(html, name)], { type: 'text/html;charset=utf-8' })) }
|
||||
: { popup: true, url: pvTextUrl(text) };
|
||||
n.__src = text;
|
||||
return n;
|
||||
}
|
||||
if (PV_PLAIN.test(low)) {
|
||||
const wrap = document.createElement('div');
|
||||
wrap.className = 'msg other';
|
||||
wrap.innerHTML = '<div class="bubble-ai pv-doc">' + esc(text) + '</div>';
|
||||
const n = wrap.firstChild; n.__tb = { popup: true, url: pvTextUrl(text) };
|
||||
const n = wrap.firstChild; n.__tb = { popup: true, url: pvTextUrl(text) }; n.__src = text;
|
||||
return n;
|
||||
}
|
||||
const frag = document.createDocumentFragment();
|
||||
let bodyText = text;
|
||||
if (text.length > PV_TEXT_MAX) {
|
||||
bodyText = text.slice(0, PV_TEXT_MAX);
|
||||
const tip = document.createElement('div');
|
||||
tip.className = 'pv-trunc';
|
||||
tip.textContent = '文件较大,仅预览前 ' + Math.round(PV_TEXT_MAX / 1024) + ' KB,完整内容请下载查看。';
|
||||
frag.appendChild(tip);
|
||||
}
|
||||
const pre = document.createElement('pre');
|
||||
pre.className = 'pv-pre';
|
||||
pre.textContent = bodyText;
|
||||
frag.appendChild(pre);
|
||||
const holder = document.createElement('div');
|
||||
holder.className = 'pv-plain';
|
||||
holder.appendChild(frag);
|
||||
const holder = pvCodeNode(text, name);
|
||||
holder.__tb = { popup: true, url: pvTextUrl(text) }; // 新窗口用全文,不受面板截断影响
|
||||
holder.__src = text; // 源码面板同样给全文
|
||||
return holder;
|
||||
}
|
||||
|
||||
@@ -358,6 +607,7 @@ async function pvRenderLegacy(name, r, my) {
|
||||
pvOverlayShow(iframe, { bar: true, name: name, source: html }); // 全宽沉浸,源码可看/可复制
|
||||
if (my !== pvSeq) return;
|
||||
} else if (/\.pdf$/i.test(name)) {
|
||||
// 正常路径已在 openFilePreview 用 /files/inline 直连;这里仅作旧路径兜底。
|
||||
const u = URL.createObjectURL(await r.blob());
|
||||
if (state.lastPdfBlobUrl) { try { URL.revokeObjectURL(state.lastPdfBlobUrl); } catch (_) {} }
|
||||
state.lastPdfBlobUrl = u;
|
||||
@@ -384,19 +634,21 @@ async function pvRenderLegacy(name, r, my) {
|
||||
openImageViewer(u, name, g && g.list, g && g.at);
|
||||
} else {
|
||||
const text = await r.text();
|
||||
let cls = 'bubble-ai', html;
|
||||
if (PV_MD.test(name)) {
|
||||
const q = mdHtml(text);
|
||||
html = q.html;
|
||||
if (q.fmt) cls += ' md';
|
||||
html = rewriteMdImageSrcs(html, name);
|
||||
} else {
|
||||
html = esc(text);
|
||||
if (!PV_MD.test(name)) {
|
||||
// 代码/配置/数据:与桌面同一套行号 + Prism 着色(原来在手机上只是纯文本)
|
||||
pvOverlayShow(pvCodeNode(text, name), { bar: true, name: name, source: text });
|
||||
return;
|
||||
}
|
||||
const q = mdHtml(text);
|
||||
let cls = 'bubble-ai';
|
||||
let html = q.html;
|
||||
if (q.fmt) cls += ' md';
|
||||
html = rewriteMdImageSrcs(html, name);
|
||||
const wrap = document.createElement('div');
|
||||
wrap.className = 'msg other';
|
||||
wrap.innerHTML = '<div class="' + cls + '">' + html + '</div>';
|
||||
decorateCodePre(wrap);
|
||||
pvHighlightMdCode(wrap);
|
||||
pvOverlayShow(wrap.firstChild, { bar: true, name: name, source: text }); // 全宽沉浸,eye/复制看原文
|
||||
}
|
||||
}
|
||||
@@ -418,6 +670,7 @@ document.getElementById('pv-max').addEventListener('click', () => {
|
||||
const max = document.body.classList.toggle('pv-max');
|
||||
pvSetMaxUI(max);
|
||||
});
|
||||
document.getElementById('pv-src').addEventListener('click', pvToggleSrc);
|
||||
document.getElementById('pv-refresh').addEventListener('click', () => {
|
||||
if (typeof pvState.reload === 'function') { pvState.reload(); return; }
|
||||
const f = document.getElementById('pv-body').querySelector('iframe');
|
||||
@@ -429,11 +682,16 @@ document.getElementById('pv-popup').addEventListener('click', () => {
|
||||
});
|
||||
// 地址条:点击/聚焦全选——长路径被截断时可选中看全文、直接 Ctrl+C 复制
|
||||
document.getElementById('pv-title').addEventListener('focus', (e) => e.target.select());
|
||||
// 地址条回车跳转:http(s) 网址新标签打开,其余按任务目录相对路径进预览
|
||||
// 地址条回车跳转:本机地址(含 /app/... 这类站内绝对路径)进预览窗,外部网址新开标签,
|
||||
// 其余按任务目录相对路径当文件预览。
|
||||
function pvClean(s) { return String(s || '').trim().replace(/^["']+|["']+$/g, ''); }
|
||||
function pvAddrGo(v) {
|
||||
if (/^https?:\/\//i.test(v)) { window.open(v, '_blank', 'noopener'); return; }
|
||||
if (/^https?:\/\//i.test(v)) {
|
||||
if (pvSameHost(v)) { document.getElementById('pv-title').blur(); pvOpenUrl(v); return; }
|
||||
window.open(v, '_blank', 'noopener'); return;
|
||||
}
|
||||
document.getElementById('pv-title').blur();
|
||||
if (v.charAt(0) === '/' && v.charAt(1) !== '/') { pvOpenUrl(v); return; }
|
||||
openFilePreview(v);
|
||||
}
|
||||
// ---------- 地址条文件名补全:候选取自 files.js 缓存的目录树(filesNodeAt),零请求 ----------
|
||||
@@ -518,23 +776,24 @@ document.getElementById('pv-pane').addEventListener('click', (e) => {
|
||||
const b = e.target.closest('.act-copy');
|
||||
if (b && typeof onCopyClick === 'function') onCopyClick(e);
|
||||
});
|
||||
// 移动端系统返回键:先收起 office 全屏预览
|
||||
// 移动端系统返回键:先收起 iframe 类全屏预览(office 网关 / 站内地址)
|
||||
window.addEventListener('popstate', () => {
|
||||
pvState.mobilePush = false;
|
||||
const fs = document.getElementById('fs-viewer');
|
||||
if (!fs.classList.contains('hidden') && fs.querySelector('.fs-html-frame[src^="/preview/"]')) closeFullscreen();
|
||||
if (!fs.classList.contains('hidden') && fs.querySelector('.fs-html-frame')) closeFullscreen();
|
||||
});
|
||||
// Esc 关闭右栏(未开全屏查看器时)
|
||||
// Esc 关闭预览分栏(未开全屏查看器时)
|
||||
window.addEventListener('keydown', (e) => {
|
||||
if (e.key !== 'Escape') return;
|
||||
if (document.activeElement && document.activeElement.id === 'pv-title') { document.activeElement.blur(); return; } // 地址条聚焦时:先退框不关栏
|
||||
if (!document.getElementById('fs-viewer').classList.contains('hidden')) return;
|
||||
pvCloseDoc();
|
||||
});
|
||||
// 窗口收窄到移动端宽度:右栏收起
|
||||
// 窗口收窄到移动端宽度:预览栏收起
|
||||
window.matchMedia('(min-width: 960px)').addEventListener('change', () => { if (!pvDesktop()) pvCloseDoc(); });
|
||||
|
||||
// ---------- 左缘拖拽调宽(预览/会话列边界):双击复位默认宽度,宽度记在 localStorage ----------
|
||||
// ---------- 右缘拖拽调宽(预览/会话列边界):双击复位默认宽度,宽度记在 localStorage ----------
|
||||
// 预览现在贴在文件树右侧(文件树 | 预览 | 会话),所以手柄在它自己的右缘,往右拖变宽。
|
||||
(function bindPvResize() {
|
||||
const pane = document.getElementById('pv-pane');
|
||||
const saved = Number(localStorage.getItem('pv-w') || 0);
|
||||
@@ -543,21 +802,31 @@ window.matchMedia('(min-width: 960px)').addEventListener('change', () => { if (!
|
||||
const h = document.createElement('div');
|
||||
h.className = 'pv-resizer';
|
||||
pane.appendChild(h);
|
||||
let st = null;
|
||||
let st = null; // { x: 起始 clientX, w: 起始宽度, lastX: 最新 clientX }
|
||||
let rafId = 0;
|
||||
// 改 --pv-w 会带着 #app 的 width/margin 一起重排(会话里的文字跟着重新折行),
|
||||
// 一帧可能来十几个 pointermove,所以只在 rAF 里落一次值。
|
||||
function commit() {
|
||||
if (!st) return;
|
||||
document.documentElement.style.setProperty('--pv-w', clamp(st.w + (st.lastX - st.x)) + 'px');
|
||||
}
|
||||
h.addEventListener('pointerdown', (e) => {
|
||||
st = { x: e.clientX, w: pane.offsetWidth || clamp(window.innerWidth * 0.5) };
|
||||
e.preventDefault(); // 从按下这一刻就掐掉拖选,否则会顺手选中一大片消息文字
|
||||
st = { x: e.clientX, w: pane.offsetWidth || clamp(window.innerWidth * 0.5), lastX: e.clientX };
|
||||
try { h.setPointerCapture(e.pointerId); } catch (_) {}
|
||||
document.body.classList.add('pv-resizing');
|
||||
});
|
||||
h.addEventListener('pointermove', (e) => {
|
||||
if (!st) return;
|
||||
document.documentElement.style.setProperty('--pv-w', clamp(st.w + (st.x - e.clientX)) + 'px');
|
||||
st.lastX = e.clientX;
|
||||
if (!rafId) rafId = requestAnimationFrame(() => { rafId = 0; commit(); });
|
||||
});
|
||||
function end() {
|
||||
if (!st) return;
|
||||
if (rafId) { cancelAnimationFrame(rafId); rafId = 0; commit(); } // 把最后一帧补上
|
||||
const w = pane.offsetWidth;
|
||||
st = null;
|
||||
document.body.classList.remove('pv-resizing');
|
||||
const w = pane.offsetWidth;
|
||||
if (w) localStorage.setItem('pv-w', String(w));
|
||||
}
|
||||
h.addEventListener('pointerup', end);
|
||||
@@ -571,7 +840,7 @@ window.matchMedia('(min-width: 960px)').addEventListener('change', () => { if (!
|
||||
// —— 通用 UI 卡片(stream.js 转发 SSE ui_card;任何 MCP 服务/工具回包附 type:"ui_card" 块即可产出)——
|
||||
// 产生方契约 {action, arg, title?, note?};新交互在动作注册表加一条即可,未知 action 忽略(向前兼容)。
|
||||
// 图标由前端统一持有(与 pv-none 同一枚文档 SVG),产生方不提供图形,只给数据。
|
||||
const UI_CARD_ICON_DOC = '<svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1.4" stroke-linecap="round" stroke-linejoin="round"><path d="M14 2H6a2 2 0 0 0-2 2v16a2 2 0 0 0 2 2h12a2 2 0 0 0 2-2V8z"></path><polyline points="14 2 14 8 20 8"></polyline></svg>';
|
||||
const UI_CARD_ICON_DOC = '<svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1.4" stroke-linecap="round" stroke-linejoin="round"><use href="#i-file-doc"/></svg>';
|
||||
const UI_CARD_ACTIONS = {
|
||||
// arg = 相对会话目录的文件路径,点击 = openFilePreview(office 走预览网关,其余类型走文本/图片渲染)
|
||||
open_preview: { go: '预览 ›', hint: '点击打开预览', icon: UI_CARD_ICON_DOC, run: (d) => openFilePreview(d.arg) },
|
||||
|
||||
@@ -31,8 +31,11 @@
|
||||
'<button class="conv-item' + (s.id === state.sessionId ? ' active' : '') + '" data-id="' + esc(s.id) + '">' +
|
||||
'<span class="conv-title">' + esc(s.title || s.id) + '</span>' + drawerStatusDot(s) +
|
||||
'</button>' +
|
||||
'<button class="conv-pop" data-pop="' + esc(s.id) + '" title="在新窗口打开" aria-label="在新窗口打开">' +
|
||||
'<svg viewBox="0 0 24 24" width="14" height="14" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><use href="#i-external"/></svg>' +
|
||||
'</button>' +
|
||||
'<button class="conv-del" data-del="' + esc(s.id) + '" title="删除会话" aria-label="删除会话">' +
|
||||
'<svg viewBox="0 0 24 24" width="14" height="14" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><polyline points="3 6 5 6 21 6"/><path d="M19 6v14a2 2 0 0 1-2 2H7a2 2 0 0 1-2-2V6m3 0V4a2 2 0 0 1 2-2h4a2 2 0 0 1 2 2v2"/></svg>' +
|
||||
'<svg viewBox="0 0 24 24" width="14" height="14" fill="none" stroke="currentColor" stroke-width="1.9" stroke-linecap="round" stroke-linejoin="round"><use href="#i-trash"/></svg>' +
|
||||
'</button>' +
|
||||
'</div>';
|
||||
}
|
||||
@@ -78,6 +81,7 @@
|
||||
state.sessionId = null;
|
||||
state.sessionTitle = '';
|
||||
state.sessionType = 'secretary';
|
||||
if (window.refreshFileTree) window.refreshFileTree();
|
||||
state.pendingModel = '';
|
||||
state.pending = [];
|
||||
renderSendQueue();
|
||||
@@ -89,9 +93,9 @@
|
||||
state.renderedSigs = {};
|
||||
state.streaming = false;
|
||||
if (typeof clearEditState === 'function') clearEditState();
|
||||
syncUrl();
|
||||
setView('welcome'); // 复用 newChat 同样的视图切换路径
|
||||
}
|
||||
toast('已删除会话');
|
||||
loadSessionList();
|
||||
} catch (e) { toast('删除失败:' + e.message); }
|
||||
}
|
||||
@@ -119,6 +123,8 @@
|
||||
}).catch(() => {}).then(() => {
|
||||
sseResyncing = false;
|
||||
if (state.sessionId === id && state.view === 'chat' && !state.es) connectStream();
|
||||
// 断点期间的文件变动看不到任何 SSE,补拉完顺手重刷一次文件树
|
||||
if (typeof window.reloadFileTree === 'function') window.reloadFileTree();
|
||||
});
|
||||
}
|
||||
setInterval(() => {
|
||||
@@ -183,11 +189,32 @@
|
||||
if (Date.now() - state.lastSseAt > 45000) probeSseAlive();
|
||||
});
|
||||
|
||||
// 地址栏跟随当前会话与侧栏模式:?s=<id>[&files=1],刷新/收藏/分享都能回到同一屏
|
||||
function syncUrl() {
|
||||
const id = state.sessionId;
|
||||
let url = '/';
|
||||
if (id) {
|
||||
url = '/?s=' + encodeURIComponent(id);
|
||||
// 侧栏停在文件树时带上 files=1:刷新后还是文件树,不会莫名退回会话列表
|
||||
if ($('drawer').classList.contains('drawer-mode-files')) url += '&files=1';
|
||||
}
|
||||
try { history.replaceState(null, '', url); } catch (_) {}
|
||||
}
|
||||
|
||||
// 收起预览:桌面分栏(#pv-pane,含 Git 面板)与窄屏全屏浮层都要收。
|
||||
// pvCloseDoc 内部会 vcsSetMode(false),Git 面板跟着一起落下。
|
||||
function closePreviewAll() {
|
||||
if (typeof pvCloseDoc === 'function') pvCloseDoc();
|
||||
const fs = document.getElementById('fs-viewer');
|
||||
if (fs && !fs.classList.contains('hidden') && typeof closeFullscreen === 'function') closeFullscreen();
|
||||
}
|
||||
|
||||
async function openSession(id) {
|
||||
closeStream();
|
||||
removeTyping();
|
||||
setFilesPanel(false); // 会话切换,收起文件面板防旧列表残留
|
||||
if (typeof pvCloseDoc === 'function') pvCloseDoc(); // 同上:收起文档预览右栏,防旧会话内容残留
|
||||
// 切会话也要收起预览与 Git:里面是上一个会话的文件/仓库,留在旁边容易被当成新会话的
|
||||
closePreviewAll();
|
||||
state.sessionId = id;
|
||||
state.status = '';
|
||||
state.modelId = '';
|
||||
@@ -215,15 +242,28 @@
|
||||
renderAttachChips();
|
||||
clearUploadCards(); // 切会话清掉旧会话的上传卡片
|
||||
renderDrawerList(); // 会话切换后立刻重画抽屉高亮,避免下次打开才看到更新
|
||||
// 文件树同理,而且更早:它的缓存按路径存、不含会话,晚一步清就会在抽屉里
|
||||
// 先看到上个会话的文件。紧跟 sessionId 变更就清,不等 detail 回来。
|
||||
if (window.refreshFileTree) window.refreshFileTree();
|
||||
setView('chat');
|
||||
$('chat-view').innerHTML = '<div class="drawer-empty">加载中…</div>';
|
||||
try {
|
||||
const detail = await req('GET', '/api/sessions/' + id + '?limit=' + CHAT_INIT_PAGE_SIZE);
|
||||
if (state.sessionId !== id) return; // 期间已切到别的会话
|
||||
renderDetail(detail);
|
||||
// 深度思考跟随会话(发消息时落库):只在这里回填,软刷新不动用户未发出的切换
|
||||
state.deepThink = !!(detail.session && detail.session.deep_think);
|
||||
$('deep-think-btn').classList.toggle('on', state.deepThink);
|
||||
connectStream();
|
||||
syncUrl(); // 详情拿到才写地址栏:坏链接不会把刷新后的页面也钉死在坏会话上
|
||||
} catch (e) {
|
||||
if (state.sessionId === id) toast('打开会话失败:' + e.message);
|
||||
if (state.sessionId === id) {
|
||||
toast('打开会话失败:' + e.message);
|
||||
state.sessionId = null;
|
||||
state.sessionTitle = '';
|
||||
syncUrl();
|
||||
setView('welcome'); // 会话已被删/链接失效:别把「加载中…」留在屏幕上(同时把顶部按钮置灰)
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
@@ -231,25 +271,72 @@
|
||||
// welcome 经弹窗预选的模型在这里兑现:model_id 建档透传。
|
||||
async function ensureSession() {
|
||||
if (state.sessionId) return state.sessionId;
|
||||
const s = await req('POST', '/api/sessions', { title: '', model_id: state.pendingModel || '', assistant_type: state.mode });
|
||||
const s = await req('POST', '/api/sessions', { title: '', model_id: state.pendingModel || '', assistant_type: state.mode, work_dir: pendingWorkDir || undefined });
|
||||
state.sessionId = s.id;
|
||||
state.sessionTitle = (s && s.title) || '';
|
||||
state.sessionType = (s && s.assistant_type) || state.mode;
|
||||
state.pendingModel = '';
|
||||
if (window.refreshFileTree) window.refreshFileTree();
|
||||
setView('chat');
|
||||
renderHeader();
|
||||
updateHeaderActions();
|
||||
connectStream();
|
||||
syncUrl();
|
||||
return s.id;
|
||||
}
|
||||
|
||||
// ---------- 本地端:新建会话时手选工作目录 ----------
|
||||
// 只在 local/ 启动器(AGENT_LOCAL_PICK=1)下可用:探测 /api/local/info,拿不到就把整条
|
||||
// chip 隐藏,服务器形态完全看不见这个入口。选择只暂存在前端,真正建档时随
|
||||
// POST /api/sessions 提交一次;不选 = work_dir 空串 = 老行为(workspace_root/<会话id>)。
|
||||
let pendingWorkDir = '';
|
||||
|
||||
function renderWelcomeDir() {
|
||||
const pathEl = $('welcome-dir-path');
|
||||
if (!pathEl) return;
|
||||
const chip = $('welcome-dir');
|
||||
pathEl.textContent = pendingWorkDir || '默认(工作区内)';
|
||||
pathEl.title = pendingWorkDir || '默认:每个会话在系统工作目录下单独建档';
|
||||
chip.classList.toggle('is-set', !!pendingWorkDir);
|
||||
$('welcome-dir-clear').classList.toggle('hidden', !pendingWorkDir);
|
||||
}
|
||||
|
||||
async function pickWelcomeDir() {
|
||||
const btn = $('welcome-dir-pick');
|
||||
if (btn.disabled) return;
|
||||
btn.disabled = true;
|
||||
try {
|
||||
// 超时给足 130s:后端对话框上限 120s,这里多留余量,别让前端先断
|
||||
const r = await req('POST', '/api/local/pick-dir', {}, false, 130000);
|
||||
if (r && r.path) { pendingWorkDir = r.path; renderWelcomeDir(); }
|
||||
} catch (e) {
|
||||
toast('选择目录失败:' + e.message);
|
||||
} finally {
|
||||
btn.disabled = false;
|
||||
}
|
||||
}
|
||||
|
||||
(function initWelcomeDir() {
|
||||
const chip = $('welcome-dir');
|
||||
if (!chip) return;
|
||||
req('GET', '/api/local/info').then(info => {
|
||||
if (!info || !info.enabled) return;
|
||||
chip.classList.remove('hidden');
|
||||
renderWelcomeDir();
|
||||
}).catch(() => { /* 服务器形态:接口 404,整条隐藏 */ });
|
||||
$('welcome-dir-pick').addEventListener('click', pickWelcomeDir);
|
||||
$('welcome-dir-clear').addEventListener('click', () => { pendingWorkDir = ''; renderWelcomeDir(); });
|
||||
})();
|
||||
|
||||
function newChat() {
|
||||
closeStream();
|
||||
removeTyping();
|
||||
setFilesPanel(false); // 新建会话,文件面板随之收起
|
||||
closePreviewAll(); // 预览/Git 都属于上一个会话,新建时一并收起
|
||||
state.sessionId = null;
|
||||
state.sessionTitle = '';
|
||||
state.sessionType = 'secretary';
|
||||
if (window.refreshFileTree) window.refreshFileTree();
|
||||
state.status = '';
|
||||
state.modelId = '';
|
||||
state.schedule = null;
|
||||
@@ -257,6 +344,8 @@
|
||||
renderSendQueue();
|
||||
state.pendingModel = '';
|
||||
state.attachments = [];
|
||||
pendingWorkDir = ''; // 新建会话把上次手选的工作目录也归零(回到默认)
|
||||
renderWelcomeDir();
|
||||
if (typeof clearEditState === 'function') clearEditState();
|
||||
state.streamEl = null;
|
||||
state.streamText = '';
|
||||
@@ -268,6 +357,8 @@
|
||||
userPaused = false;
|
||||
renderAttachChips();
|
||||
clearUploadCards();
|
||||
renderDrawerList(); // sessionId 已置空,重画抽屉把旧会话的选中态清掉
|
||||
syncUrl();
|
||||
setView('welcome');
|
||||
$('chat-view').innerHTML = '';
|
||||
$('msg-input').value = '';
|
||||
@@ -285,7 +376,6 @@
|
||||
const title = String(t).trim();
|
||||
try {
|
||||
await req('PATCH', '/api/sessions/' + state.sessionId, { title: title });
|
||||
toast('已重命名');
|
||||
state.sessionTitle = title;
|
||||
renderHeader();
|
||||
loadSessionList();
|
||||
@@ -403,8 +493,37 @@
|
||||
if (act === 'model') openModelSwitch();
|
||||
else if (act === 'schedule') openScheduleModal();
|
||||
else if (act === 'compact') summarizeChat();
|
||||
else if (act === 'theme') cycleTheme();
|
||||
else if (act === 'new') newChat();
|
||||
}
|
||||
|
||||
// ---------- 主题(浅/深两态,默认浅色;色板全在 style.css 变量里)----------
|
||||
function themeMode() { return document.documentElement.getAttribute('data-theme-mode') === 'dark' ? 'dark' : 'light'; }
|
||||
function applyTheme(mode) {
|
||||
const m = mode === 'dark' ? 'dark' : 'light';
|
||||
document.documentElement.setAttribute('data-theme', m);
|
||||
document.documentElement.setAttribute('data-theme-mode', m);
|
||||
try { localStorage.setItem('agent-theme', m); } catch (_) {}
|
||||
const meta = document.querySelector('meta[name="theme-color"]');
|
||||
if (meta) meta.setAttribute('content', m === 'dark' ? '#0d1117' : '#3964FE');
|
||||
syncThemeBtns();
|
||||
}
|
||||
function cycleTheme() { applyTheme(themeMode() === 'dark' ? 'light' : 'dark'); }
|
||||
function syncThemeBtns() {
|
||||
const dark = themeMode() === 'dark';
|
||||
const lbl = dark ? '主题:深色' : '主题:浅色';
|
||||
['theme-toggle', 'theme-toggle-mobile'].forEach(function (id) {
|
||||
const b = $(id);
|
||||
if (!b) return;
|
||||
b.querySelectorAll('svg').forEach(function (s, k) { s.classList.toggle('hidden', k !== (dark ? 1 : 0)); });
|
||||
});
|
||||
const t = $('theme-toggle');
|
||||
if (t) { t.title = lbl; t.dataset.tip = lbl; }
|
||||
const lab = $('theme-label-mobile');
|
||||
if (lab) lab.textContent = dark ? '深色' : '浅色'; // 副标题只写当前值,主文案是动作
|
||||
}
|
||||
window.applyTheme = applyTheme;
|
||||
window.cycleTheme = cycleTheme;
|
||||
// 桌面属性区(模型/定时任务/压缩)与移动菜单项共用同一批 data-act,事件只在这里绑一次。
|
||||
(function bindHeaderActions() {
|
||||
document.querySelectorAll('#header-meta [data-act], #header-actions [data-act]').forEach(el => {
|
||||
@@ -417,6 +536,7 @@
|
||||
if (!e.target.closest('#header-actions')) closeHeaderMenu();
|
||||
});
|
||||
document.addEventListener('keydown', e => { if (e.key === 'Escape') closeHeaderMenu(); });
|
||||
syncThemeBtns(); // 按钮图标/文字跟着当前主题落一次
|
||||
})();
|
||||
|
||||
// ---------- 定时任务(弹窗改频次/提示词;无任务时同一弹窗即新建) ----------
|
||||
@@ -736,7 +856,7 @@
|
||||
wrap.innerHTML =
|
||||
'<div class="modal">' +
|
||||
'<button class="modal-close-btn" data-act="cancel" aria-label="关闭">' +
|
||||
'<svg viewBox="0 0 24 24"><line x1="18" y1="6" x2="6" y2="18"></line><line x1="6" y1="6" x2="18" y2="18"></line></svg>' +
|
||||
'<svg viewBox="0 0 24 24"><use href="#i-x-line-b"/></svg>' +
|
||||
'</button>' +
|
||||
'<h3 id="compress-modal-title">压缩上下文</h3>' +
|
||||
'<div class="modal-body" style="font-size:14px;line-height:1.55;color:#555;padding:4px 0 12px;">' +
|
||||
|
||||
@@ -16,7 +16,7 @@
|
||||
stack: [],
|
||||
snaps: {}, // 页名 → 静态快照 HTML(setPush 时刷新;右滑返回垫底用)
|
||||
role: 'user', // 当前登录用户角色(admin | user);启动时由 /api/me 回填
|
||||
authEnabled: true, // 是否启用多用户认证(/api/me 404 = 未启用,单用户自用)
|
||||
authEnabled: true, // 是否启用多用户认证(/api/me 返回 auth:false = 未启用,单用户自用)
|
||||
pendingKeys: new Set(), // 已写盘、尚未重启生效的顶层配置段
|
||||
effCfg: null, cfgOrig: '',
|
||||
users: [], userModels: [], // 用户管理页:账号/角色/默认模型 + 可选模型清单
|
||||
@@ -130,23 +130,23 @@
|
||||
function showSettings() {
|
||||
// 普通用户没有设置主页:直接进账户页(栈里只有一页,返回即退出设置)
|
||||
SET.stack = [SET.role === 'admin' ? 'home' : 'account']; SET.snaps = {}; setUnderHide();
|
||||
// 桌面端:打开设置时收起侧边栏让设置页占满窗口,关闭时恢复之前的展开态
|
||||
if (drawerMQ.matches) { drawerWasOpenBeforeSet = document.body.classList.contains('drawer-open'); openDrawer(false); }
|
||||
// 桌面端保留左侧栏:设置页是 #app 内的 absolute 覆盖层,自然只占侧栏右侧区域,
|
||||
// 左栏(会话/文件)保持可见可用。
|
||||
$('settings-page').classList.remove('hidden'); renderSetPage();
|
||||
const b = $('da-settings'); if (b) b.classList.add('active'); // 侧栏底部图标同步选中态
|
||||
}
|
||||
let drawerWasOpenBeforeSet = false;
|
||||
function closeSettings() {
|
||||
SET.stack = []; SET.snaps = {}; setUnderHide();
|
||||
// 退回会话页才重置模型池状态:平台卡全部折叠、余额清空,下次进入重新自动查
|
||||
SET.expandedGroups = {}; SET.balanceByGroup = {}; SET.balanceRequested = {};
|
||||
$('settings-page').classList.add('hidden');
|
||||
if (drawerMQ.matches && drawerWasOpenBeforeSet) { openDrawer(true); drawerWasOpenBeforeSet = false; }
|
||||
const b = $('da-settings'); if (b) b.classList.remove('active');
|
||||
}
|
||||
// 当前页静态快照(顶栏+正文):右滑返回时垫底,呈现原生导航栈的视差感。
|
||||
// 快照里的 id 全部剥除,防止重复 id 干扰 $('…') 查找;仅作动画背景,滑完由 renderSetPage 重渲染真页。
|
||||
function snapSetPage() {
|
||||
const box = document.createElement('div');
|
||||
box.innerHTML = '<header class="header"><button class="icon-btn" tabindex="-1"><svg class="ic" viewBox="0 0 24 24"><polyline points="15 18 9 12 15 6"></polyline></svg></button>' +
|
||||
box.innerHTML = '<header class="header"><button class="icon-btn" tabindex="-1"><svg class="ic" viewBox="0 0 24 24"><use href="#i-chevron-left"/></svg></button>' +
|
||||
'<div class="header-center"><div class="header-title">' + esc($('set-title').textContent) + '</div></div>' +
|
||||
'<div class="header-right">' + $('set-actions').innerHTML + '</div></header>' +
|
||||
'<div class="set-under-body">' + $('set-body').innerHTML + '</div>';
|
||||
@@ -281,17 +281,17 @@
|
||||
// ---------- 页:设置主页(卡片入口) ----------
|
||||
const SET_CARDS = [
|
||||
{ go: 'account', name: '账户', desc: '修改密码 · 用户画像 · 退出登录',
|
||||
icon: '<svg class="ic" viewBox="0 0 24 24"><circle cx="12" cy="8" r="4"></circle><path d="M4 21c0-4 4-6 8-6s8 2 8 6"></path></svg>' },
|
||||
icon: '<svg class="ic" viewBox="0 0 24 24"><use href="#i-user"/></svg>' },
|
||||
{ go: 'users', name: '用户', desc: '账号 · 角色 · 默认模型', adminOnly: true, needAuth: true,
|
||||
icon: '<svg class="ic" viewBox="0 0 24 24"><circle cx="9" cy="8" r="3.5"></circle><path d="M2 21c0-3.6 3.1-5.5 7-5.5s7 1.9 7 5.5"></path><path d="M16 8.5a3 3 0 0 1 0 6"></path><path d="M18 21c0-2.8-1.4-4.5-4-5.2"></path></svg>' },
|
||||
icon: '<svg class="ic" viewBox="0 0 24 24"><use href="#i-users"/></svg>' },
|
||||
{ go: 'service', name: '服务', desc: '服务状态 · 系统配置', adminOnly: true,
|
||||
icon: '<svg class="ic" viewBox="0 0 24 24"><line x1="4" y1="21" x2="4" y2="14"></line><line x1="4" y1="10" x2="4" y2="3"></line><line x1="12" y1="21" x2="12" y2="12"></line><line x1="12" y1="8" x2="12" y2="3"></line><line x1="20" y1="21" x2="20" y2="16"></line><line x1="20" y1="12" x2="20" y2="3"></line><line x1="1" y1="14" x2="7" y2="14"></line><line x1="9" y1="8" x2="15" y2="8"></line><line x1="17" y1="16" x2="23" y2="16"></line></svg>' },
|
||||
icon: '<svg class="ic" viewBox="0 0 24 24"><use href="#i-sliders-v"/></svg>' },
|
||||
{ go: 'skills', name: '技能', desc: '技能管理 · 技能文件编辑', adminOnly: true,
|
||||
icon: '<svg class="ic" viewBox="0 0 24 24"><polygon points="13 2 3 14 12 14 11 22 21 10 12 10 13 2"></polygon></svg>' },
|
||||
icon: '<svg class="ic" viewBox="0 0 24 24"><use href="#i-zap"/></svg>' },
|
||||
{ go: 'models', name: '模型', desc: '模型池状态 · 增删改', adminOnly: true,
|
||||
icon: '<svg class="ic" viewBox="0 0 24 24"><rect x="4" y="4" width="16" height="16" rx="2"></rect><rect x="9" y="9" width="6" height="6"></rect><line x1="9" y1="1" x2="9" y2="4"></line><line x1="15" y1="1" x2="15" y2="4"></line><line x1="9" y1="20" x2="9" y2="23"></line><line x1="15" y1="20" x2="15" y2="23"></line><line x1="20" y1="9" x2="23" y2="9"></line><line x1="20" y1="14" x2="23" y2="14"></line><line x1="1" y1="9" x2="4" y2="9"></line><line x1="1" y1="14" x2="4" y2="14"></line></svg>' },
|
||||
icon: '<svg class="ic" viewBox="0 0 24 24"><use href="#i-cpu"/></svg>' },
|
||||
{ go: 'mcp', name: 'MCP', desc: 'MCP 服务 · 增删改', adminOnly: true,
|
||||
icon: '<svg class="ic" viewBox="0 0 24 24"><rect x="3" y="4" width="18" height="16" rx="2"></rect><line x1="3" y1="10" x2="21" y2="10"></line><circle cx="7" cy="15" r="1.2" fill="currentColor" stroke="none"></circle><circle cx="12" cy="15" r="1.2" fill="currentColor" stroke="none"></circle><circle cx="17" cy="15" r="1.2" fill="currentColor" stroke="none"></circle></svg>' },
|
||||
icon: '<svg class="ic" viewBox="0 0 24 24"><use href="#i-layout"/></svg>' },
|
||||
];
|
||||
function setPageHome(ctx) {
|
||||
setTitle('设置');
|
||||
@@ -303,7 +303,7 @@
|
||||
'<span class="set-ico">' + c.icon + '</span>' +
|
||||
'<span class="set-tt"><span class="set-name">' + c.name + '</span>' +
|
||||
'<span class="set-desc">' + c.desc + '</span></span>' +
|
||||
'<svg class="ic sm set-arrow" viewBox="0 0 24 24"><polyline points="9 6 15 12 9 18"></polyline></svg>' +
|
||||
'<svg class="ic sm set-arrow" viewBox="0 0 24 24"><use href="#i-chevron-right-b"/></svg>' +
|
||||
'</button>').join('') + '</div>');
|
||||
}
|
||||
|
||||
@@ -320,23 +320,8 @@
|
||||
for (const ch of String(name || '')) h = (h * 31 + ch.codePointAt(0)) >>> 0;
|
||||
return AVATAR_COLORS[h % AVATAR_COLORS.length];
|
||||
}
|
||||
// 侧边栏底部用户区:展示真实登录用户名,头像样式与设置页 user-card 一致(按用户名取色+首两字)。
|
||||
// 启动校验已经拉到登录用户时直接传入,避免同一次加载重复请求 /api/me;未传入时自拉兜底。
|
||||
async function loadDrawerUser(knownUser) {
|
||||
const av = $('drawer-avatar'), un = $('drawer-user-name');
|
||||
if (!av || !un) return;
|
||||
let name = knownUser ? String(knownUser) : '';
|
||||
if (!name) {
|
||||
try {
|
||||
const r = await req('GET', '/api/me');
|
||||
name = r && r.user ? String(r.user) : '';
|
||||
} catch (_) { return; /* 未启用认证时无 /api/me,保留默认占位 */ }
|
||||
}
|
||||
if (!name) return; // 未登录态(理论上不会出现,401 已自动跳登录页)
|
||||
av.textContent = userInitials(name);
|
||||
av.style.background = avatarColor(name);
|
||||
un.textContent = name;
|
||||
}
|
||||
// 侧栏底部已改成纯图标操作栏,不再展示登录用户名(用户信息仍在设置页「账户」里),
|
||||
// 所以原来的 loadDrawerUser 已随之删除。
|
||||
function userCardHtml(me) {
|
||||
return '<div class="settings-card user-card">' +
|
||||
'<div class="user-avatar" style="background:' + avatarColor(me) + '">' + esc(userInitials(me)) + '</div>' +
|
||||
@@ -351,9 +336,9 @@
|
||||
setActions('');
|
||||
setBody('<div class="set-scroll"><div class="empty-tip">加载中…</div></div>');
|
||||
// 单个 /api/me 判认证开关:启用时中间件保证已登录,user 必有;
|
||||
// 未启用时该路由 404 → 只是没有密码/登出卡,画像仍渲染(未认证 = 空串键隐式单用户)。
|
||||
// 未启用时回 auth:false + user:null → 只是没有密码/登出卡,画像仍渲染(未认证 = 空串键隐式单用户)。
|
||||
let me = null;
|
||||
try { const r = await req('GET', '/api/me'); if (r && r.user) me = r; } catch (_) { /* 404 等一律按无账户信息处理 */ }
|
||||
try { const r = await req('GET', '/api/me'); if (r && r.user) me = r; } catch (_) { /* 一律按无账户信息处理 */ }
|
||||
let p = null, pErr = '';
|
||||
try { p = await req('GET', '/api/profile'); } catch (e) { pErr = String((e && e.message) || e); }
|
||||
if (!ctx()) return;
|
||||
@@ -377,29 +362,55 @@
|
||||
} catch (e) { toast('修改失败:' + e.message); }
|
||||
}
|
||||
// ---------- 页:账户——用户画像编辑卡直接渲染在账户页(无二级页;保存后 renderSetPage 重拉刷新停用徽标) ----------
|
||||
const PREF_MAX = 1000; // 与后端 user-profile.js 的 PREF_MAX 对齐
|
||||
const PROFILE_FIELDS = [
|
||||
['honorific', '称谓', '希望被怎么称呼', 80],
|
||||
['industry', '行业', '影响术语与默认假设', 80],
|
||||
['preference', '偏好', '顿号分隔标签(AI 会在沟通中自动补充,可手动增删)', 300],
|
||||
['preference', '偏好', '一行一条', 0, 'textarea'],
|
||||
];
|
||||
function prefCountText(n) {
|
||||
return '已用 ' + n + ' / ' + PREF_MAX + ' 字' + (n > PREF_MAX ? ',超出部分保存时截断' : '');
|
||||
}
|
||||
function prefCount() {
|
||||
const el = $('prof-preference'), out = $('prof-count-preference');
|
||||
if (!el || !out) return;
|
||||
const n = el.value.trim().length;
|
||||
out.textContent = prefCountText(n);
|
||||
out.style.color = n > PREF_MAX ? 'var(--fg-c0392b)' : '';
|
||||
}
|
||||
function profileCardHtml(p) {
|
||||
let html = '<div class="settings-card"><h4>用户画像' +
|
||||
(p.enabled === false ? ' <span class="badge held">已停用</span>' : '') + '</h4>' +
|
||||
'<div class="cfg-kv"><label>启用</label><input type="checkbox" id="prof-enabled"' + (p.enabled === false ? '' : ' checked') + '></div>';
|
||||
for (const [k, name, ph, maxLen] of PROFILE_FIELDS) {
|
||||
for (const [k, name, ph, maxLen, kind] of PROFILE_FIELDS) {
|
||||
const v = String(p[k] || '');
|
||||
html += '<div class="cfg-kv"><label>' + esc(name) + '</label>' +
|
||||
'<input class="cfg-input" id="prof-' + k + '" type="text" maxlength="' + (maxLen || 80) + '" data-orig="' + att(v) + '" value="' + att(v) + '" placeholder="' + esc(ph) + '"></div>';
|
||||
if (kind === 'textarea') {
|
||||
// 用户输入什么就存什么、注入什么:不拆不拼、不规范化分隔符,换行原样保留
|
||||
html += '<div class="cfg-kv stack"><label>' + esc(name) + '</label>' +
|
||||
'<textarea class="cfg-textarea" id="prof-' + k + '" rows="8" placeholder="' + esc(ph) + '" oninput="sUI.prefCount()">' + esc(v) + '</textarea>' +
|
||||
'<div class="cfg-note" id="prof-count-' + k + '">' + prefCountText(v.length) + '</div></div>';
|
||||
} else {
|
||||
html += '<div class="cfg-kv"><label>' + esc(name) + '</label>' +
|
||||
'<input class="cfg-input" id="prof-' + k + '" type="text" maxlength="' + (maxLen || 80) + '" data-orig="' + att(v) + '" value="' + att(v) + '" placeholder="' + esc(ph) + '"></div>';
|
||||
}
|
||||
}
|
||||
html += '<button class="primary-btn" style="margin-top:8px" onclick="sUI.saveProfile()">保存</button>' +
|
||||
'<div class="cfg-note">画像只记「不知道就会做错」的信息,新会话开始时作为背景注入(会话内不更新;清空字段保存即抹除)。' +
|
||||
'AI 会在沟通中持续维护(尤其偏好标签,只记明确表达过的,写入自下个会话生效),这里手动改随时可覆盖。' +
|
||||
'停用后不再注入,AI 的记录请求也会被拒。近期关注(最近会话标题)自动带入背景,无需维护。</div></div>';
|
||||
'<div class="cfg-note">新会话生效</div></div>';
|
||||
return html;
|
||||
}
|
||||
async function saveProfile() {
|
||||
const body = { enabled: $('prof-enabled').checked };
|
||||
for (const [k] of PROFILE_FIELDS) { const el = $('prof-' + k); if (el) body[k] = el.value.trim(); }
|
||||
for (const [k, , , , kind] of PROFILE_FIELDS) {
|
||||
const el = $('prof-' + k);
|
||||
if (!el) continue;
|
||||
const v = el.value.trim();
|
||||
if (kind === 'textarea' && v.length > PREF_MAX) {
|
||||
body[k] = v.slice(0, PREF_MAX);
|
||||
toast('偏好超过 ' + PREF_MAX + ' 字,已截断保存');
|
||||
} else {
|
||||
body[k] = v;
|
||||
}
|
||||
}
|
||||
try { await req('PUT', '/api/profile', body); toast('已保存,新会话生效'); renderSetPage(); }
|
||||
catch (e) { toast('保存失败:' + e.message); }
|
||||
}
|
||||
@@ -410,7 +421,7 @@
|
||||
async function setPageUsers(ctx) {
|
||||
setTitle('用户');
|
||||
setActions('<button class="icon-btn" title="添加用户" onclick="sUI.openUserAdd()">' +
|
||||
'<svg class="ic" viewBox="0 0 24 24"><line x1="12" y1="5" x2="12" y2="19"></line><line x1="5" y1="12" x2="19" y2="12"></line></svg></button>');
|
||||
'<svg class="ic" viewBox="0 0 24 24"><use href="#i-plus"/></svg></button>');
|
||||
setBody('<div class="set-scroll" id="user-list"><div class="empty-tip">加载中…</div></div>');
|
||||
try {
|
||||
const r = await req('GET', '/api/users');
|
||||
@@ -704,7 +715,7 @@
|
||||
async function setPageService(ctx) {
|
||||
setTitle('服务');
|
||||
setActions('<button class="icon-btn" title="编辑配置文件" onclick="sUI.openCfg()">' +
|
||||
'<svg class="ic" viewBox="0 0 24 24"><path d="M11 4H4a2 2 0 0 0-2 2v14a2 2 0 0 0 2 2h14a2 2 0 0 0 2-2v-7"></path><path d="M18.5 2.5a2.12 2.12 0 0 1 3 3L12 15l-4 1 1-4z"></path></svg></button>');
|
||||
'<svg class="ic" viewBox="0 0 24 24"><use href="#i-edit"/></svg></button>');
|
||||
setBody('<div class="set-scroll" id="svc-body"><div class="empty-tip">加载中…</div></div>');
|
||||
try {
|
||||
const [st, cg] = await Promise.all([
|
||||
@@ -784,7 +795,7 @@
|
||||
async function setPageCfgEditor(ctx) {
|
||||
setTitle('config.yml 原文');
|
||||
setActions('<button class="icon-btn" title="校验并保存" onclick="sUI.saveCfg()">' +
|
||||
'<svg class="ic" viewBox="0 0 24 24"><polyline points="20 6 9 17 4 12"></polyline></svg></button>');
|
||||
'<svg class="ic" viewBox="0 0 24 24"><use href="#i-check"/></svg></button>');
|
||||
setBody('<div class="set-editor"><div class="cfg-err hidden" id="cfg-editor-err"></div>' +
|
||||
'<textarea id="set-editor-area" spellcheck="false" autocomplete="off" autocapitalize="off"></textarea></div>');
|
||||
try {
|
||||
@@ -827,7 +838,7 @@
|
||||
SET.curSkill = null;
|
||||
setTitle('技能管理');
|
||||
setActions('<button class="icon-btn" title="新建技能" onclick="sUI.openCreate()">' +
|
||||
'<svg class="ic" viewBox="0 0 24 24"><line x1="12" y1="5" x2="12" y2="19"></line><line x1="5" y1="12" x2="19" y2="12"></line></svg></button>');
|
||||
'<svg class="ic" viewBox="0 0 24 24"><use href="#i-plus"/></svg></button>');
|
||||
setBody('<div class="set-scroll" id="skills-list"><div class="empty-tip">加载中…</div></div>');
|
||||
try {
|
||||
const rows = await req('GET', '/api/skills');
|
||||
@@ -870,7 +881,7 @@
|
||||
setTitle(SET.curSkill);
|
||||
setActions('<label class="icon-btn" title="上传文件">' +
|
||||
'<input type="file" style="display:none;" onchange="sUI.onUpload(event)">' +
|
||||
'<svg class="ic" viewBox="0 0 24 24"><path d="M21 15v4a2 2 0 0 1-2 2H5a2 2 0 0 1-2-2v-4"></path><polyline points="17 8 12 3 7 8"></polyline><line x1="12" y1="3" x2="12" y2="15"></line></svg></label>');
|
||||
'<svg class="ic" viewBox="0 0 24 24"><use href="#i-upload-cloud"/></svg></label>');
|
||||
setBody('<div class="set-scroll" id="skill-detail"><div class="empty-tip">加载中…</div></div>');
|
||||
try {
|
||||
const d = await req('GET', '/api/skills/' + encodeURIComponent(SET.curSkill));
|
||||
@@ -886,7 +897,7 @@
|
||||
el.innerHTML = '<div class="skill-files">' + d.files.map(f => {
|
||||
const a = encodeURIComponent(f.filename);
|
||||
return '<div class="file-row" onclick="sUI.editFile(\'' + a + '\')">' +
|
||||
'<svg class="file-ico" viewBox="0 0 24 24"><path d="M14 2H6a2 2 0 0 0-2 2v16a2 2 0 0 0 2 2h12a2 2 0 0 0 2-2V8z"></path><polyline points="14 2 14 8 20 8"></polyline></svg>' +
|
||||
'<svg class="file-ico" viewBox="0 0 24 24"><use href="#i-file-doc"/></svg>' +
|
||||
'<span class="file-name">' + esc(f.filename) + '</span>' +
|
||||
'<span class="file-size">' + fmtSize(f.size) + '</span>' +
|
||||
'<button class="file-act" onclick="event.stopPropagation();sUI.editFile(\'' + a + '\')">编辑</button>' +
|
||||
@@ -900,7 +911,7 @@
|
||||
function setPageSkillEditor(ctx) {
|
||||
setTitle(SET.editorLabel || '编辑文件');
|
||||
setActions('<button class="icon-btn" title="保存" onclick="sUI.saveFile()">' +
|
||||
'<svg class="ic" viewBox="0 0 24 24"><polyline points="20 6 9 17 4 12"></polyline></svg></button>');
|
||||
'<svg class="ic" viewBox="0 0 24 24"><use href="#i-check"/></svg></button>');
|
||||
setBody('<div class="set-editor"><textarea id="set-editor-area" spellcheck="false" autocomplete="off" autocapitalize="off"></textarea></div>');
|
||||
$('set-editor-area').value = SET.editorText;
|
||||
}
|
||||
@@ -1081,7 +1092,7 @@
|
||||
if (ev) ev.stopPropagation(); // 冒泡到分组头会误触折叠/展开
|
||||
fetchBalance(pi + '-' + ki, pi, ki, true);
|
||||
}
|
||||
const BAL_REFRESH_SVG = '<svg viewBox="0 0 24 24"><polyline points="23 4 23 10 17 10"></polyline><path d="M20.49 15a9 9 0 1 1-2.12-9.36L23 10"></path></svg>';
|
||||
const BAL_REFRESH_SVG = '<svg viewBox="0 0 24 24"><use href="#i-refresh"/></svg>';
|
||||
// 平台卡折叠/展开(gk = 'p'+pi)。首次展开:给该平台每个 Key 行自动查一次余额(每页会话一次;手动刷新不受限)。
|
||||
function toggleModelGroup(gk) {
|
||||
const on = !SET.expandedGroups[gk];
|
||||
@@ -1174,7 +1185,7 @@
|
||||
}).join('') : '';
|
||||
return '<div class="model-group' + (open ? ' open' : '') + '" id="mgrp-' + gk + '">' +
|
||||
'<div class="model-group-head" onclick="sUI.toggleGroup(\'' + gk + '\')">' +
|
||||
'<svg class="model-group-caret" viewBox="0 0 24 24"><polyline points="9 6 15 12 9 18"></polyline></svg>' +
|
||||
'<svg class="model-group-caret" viewBox="0 0 24 24"><use href="#i-chevron-right-b"/></svg>' +
|
||||
'<span class="model-group-name">' + esc(p.name || ('平台' + pi)) + '</span>' +
|
||||
'<span class="model-group-badge">' + keys.length + ' keys</span>' +
|
||||
'<span class="model-group-meta">' + models.filter(m => m.enable !== false).length + ' / ' + models.length + ' 模型</span>' +
|
||||
@@ -1227,7 +1238,7 @@
|
||||
function setPageModels(ctx) {
|
||||
setTitle('模型池');
|
||||
setActions('<button class="icon-btn" title="添加模型" onclick="sUI.openAdd()">' +
|
||||
'<svg class="ic" viewBox="0 0 24 24"><line x1="12" y1="5" x2="12" y2="19"></line><line x1="5" y1="12" x2="19" y2="12"></line></svg></button>');
|
||||
'<svg class="ic" viewBox="0 0 24 24"><use href="#i-plus"/></svg></button>');
|
||||
setBody('<div class="set-scroll" id="model-cards"><div class="empty-tip">加载中…</div></div>');
|
||||
// 余额与展开态跨设置内导航保持(仅 closeSettings 回会话页时重置),重进本页不重复查余额
|
||||
loadModelCards(ctx);
|
||||
@@ -1275,7 +1286,7 @@
|
||||
}
|
||||
function pfNewModel() {
|
||||
const r = { ref: null, id: '', vision: true, enable: true, display_name: '', profile: '',
|
||||
extra_params: '', thinking_params: '', reasoning_ack_field: '', adv: false };
|
||||
extra_params: '', thinking_params: '', reasoning_ack_field: '', max_context: 0, store: false, adv: false };
|
||||
if (pfEdit) applyModelDefaults(r, pfEdit.preset);
|
||||
return r;
|
||||
}
|
||||
@@ -1298,6 +1309,8 @@
|
||||
extra_params: pfJsonText(m.extra_params),
|
||||
thinking_params: pfJsonText(m.thinking_params),
|
||||
reasoning_ack_field: m.reasoning_ack_field || '',
|
||||
max_context: Number(m.max_context) || 0,
|
||||
store: m.store === true,
|
||||
adv: false,
|
||||
})),
|
||||
};
|
||||
@@ -1378,6 +1391,7 @@
|
||||
'<label class="mpe-line"><span>请求参数</span><textarea rows="2" spellcheck="false" placeholder=\'{"key":"value"}\' oninput="sUI.mModField(' + i + ',\'extra_params\',this.value)">' + esc(r.extra_params) + '</textarea></label>' +
|
||||
'<label class="mpe-line"><span>思考参数</span><textarea rows="2" spellcheck="false" placeholder=\'{"reasoning_effort":"max"}\' oninput="sUI.mModField(' + i + ',\'thinking_params\',this.value)">' + esc(r.thinking_params) + '</textarea></label>' +
|
||||
'<label class="mpe-line"><span>思考链回传</span><input type="text" placeholder="回传字段名" value="' + att(r.reasoning_ack_field) + '" oninput="sUI.mModField(' + i + ',\'reasoning_ack_field\',this.value)"></label>' +
|
||||
'<label class="mpe-line"><span>压缩阈值</span><input type="number" min="0" step="1000" placeholder="0=不自动压缩" value="' + att(r.max_context || 0) + '" oninput="sUI.mModField(' + i + ',\'max_context\',this.value)"></label>' +
|
||||
'</div>' : '';
|
||||
return '<div class="mpe-mcard">' +
|
||||
'<div class="mpe-row">' +
|
||||
@@ -1387,6 +1401,7 @@
|
||||
'<div class="mpe-cks">' +
|
||||
'<label class="mpe-ck"><input type="checkbox"' + (r.vision ? ' checked' : '') + ' onchange="sUI.mModVision(' + i + ',this.checked)">图片输入</label>' +
|
||||
'<label class="mpe-ck"><input type="checkbox"' + (r.enable !== false ? ' checked' : '') + ' onchange="sUI.mModEnable(' + i + ',this.checked)">启用</label>' +
|
||||
'<label class="mpe-ck" title="只发新增消息,需上游有 context relay"><input type="checkbox"' + (r.store ? ' checked' : '') + ' onchange="sUI.mModField(' + i + ',\'store\',this.checked)">增量上下文</label>' +
|
||||
'<button type="button" class="mpe-adv-btn" onclick="sUI.mAdvToggle(' + i + ')">' + (r.adv ? '收起' : '高级') + '</button>' +
|
||||
'</div>' + adv +
|
||||
'</div>';
|
||||
@@ -1441,6 +1456,9 @@
|
||||
if (Object.keys(tp).length) nv.thinking_params = tp;
|
||||
const ra = String(r.reasoning_ack_field || '').trim();
|
||||
if (ra) nv.reasoning_ack_field = ra;
|
||||
const mc = Math.max(0, parseInt(r.max_context, 10) || 0);
|
||||
if (mc) nv.max_context = mc;
|
||||
if (r.store === true) nv.store = true; // 缺省 false,只在勾选时写
|
||||
return nv;
|
||||
}
|
||||
// 根据工作态算批量编辑:原地改(值变更项) → 删行(降序) → 新增行(append)。
|
||||
@@ -1517,6 +1535,18 @@
|
||||
} else if (ra !== curRa) {
|
||||
edits.push({ path: mp.concat('reasoning_ack_field'), value: ra });
|
||||
}
|
||||
// 压缩阈值:0 = 删键(缺省不写),避免无意义重写文件
|
||||
const curMc = Number(om.max_context) || 0;
|
||||
const mc = Math.max(0, parseInt(r.max_context, 10) || 0);
|
||||
if (mc !== curMc) {
|
||||
edits.push(mc ? { path: mp.concat('max_context'), value: mc } : { path: mp.concat('max_context'), op: 'delete' });
|
||||
}
|
||||
// 增量上下文:缺省不写,只在勾选时落键,取消勾选则删键
|
||||
const curSt = om.store === true;
|
||||
const st = r.store === true;
|
||||
if (st !== curSt) {
|
||||
edits.push(st ? { path: mp.concat('store'), value: true } : { path: mp.concat('store'), op: 'delete' });
|
||||
}
|
||||
} else {
|
||||
edits.push({ op: 'append', path: ['platforms', pfEdit.idx, 'models'], value: pfModelValue(r) });
|
||||
}
|
||||
@@ -1627,7 +1657,7 @@
|
||||
async function setPageMcp(ctx) {
|
||||
setTitle('MCP 服务');
|
||||
setActions('<button class="icon-btn" title="添加 MCP 服务" onclick="mcpUI.add()">' +
|
||||
'<svg class="ic" viewBox="0 0 24 24"><line x1="12" y1="5" x2="12" y2="19"></line><line x1="5" y1="12" x2="19" y2="12"></line></svg></button>');
|
||||
'<svg class="ic" viewBox="0 0 24 24"><use href="#i-plus"/></svg></button>');
|
||||
setBody('<div class="set-scroll" id="mcp-list"><div class="empty-tip">加载中…</div></div>');
|
||||
await loadMcpList(ctx);
|
||||
}
|
||||
@@ -1700,13 +1730,16 @@
|
||||
const txt = f.secret ? (v ? '已配置' : '--') : (v ? String(v) : '--');
|
||||
return '<div class="cfg-kv"><label>' + esc(f.label || f.header) + '</label><b>' + esc(txt) + '</b></div>';
|
||||
}).join('');
|
||||
// 地址一律显示真实配置:预设地址只是容器形态的缺省值,本地形态是 127.0.0.1:809x,
|
||||
// 照抄预设会与「已连接」徽章自相矛盾。
|
||||
const urlTxt = (s ? (s.url || '') : p.url) || '';
|
||||
return '<div class="model-card' + (mode === 'disable' ? ' off' : '') + '"' +
|
||||
' onclick="mcpUI.' + (s ? 'editPreset' : 'addPreset') + '(\'' + att(p.key) + '\')">' +
|
||||
'<div class="model-card-head">' +
|
||||
'<span class="model-card-name">' + esc(p.label || p.key) + '</span>' +
|
||||
state +
|
||||
'</div>' +
|
||||
'<div class="cfg-kv"><label>地址</label><b>' + esc(p.url) + '</b></div>' + kv +
|
||||
'<div class="cfg-kv"><label>地址</label><b>' + esc(urlTxt) + '</b></div>' + kv +
|
||||
'</div>';
|
||||
}
|
||||
// MCP 卡:头部 = 名称 + url + mode 状态;体内 = headers 键值列表。整卡点击进入编辑。
|
||||
@@ -1735,7 +1768,8 @@
|
||||
'</div>';
|
||||
}
|
||||
// 弹窗打开:add 模式 (idx=null) → 空工作态;edit 模式 → 从当前配置复制。
|
||||
// presetKey 有值 = 内置服务模式:url/name/mode 是契约(只读),表单由预设的 fields 生成。
|
||||
// presetKey 有值 = 内置服务模式:name/mode 是契约(只读),url 可改(地址随部署形态变,预设只给缺省值),
|
||||
// 表单由预设的 fields 生成。
|
||||
function openMcpEditor(idx, presetKey) {
|
||||
const preset = presetKey ? (presetMcpList().find(p => p.key === presetKey) || null) : null;
|
||||
const add = idx == null;
|
||||
@@ -1768,9 +1802,11 @@
|
||||
}
|
||||
$('mce-title').textContent = (add ? '添加 ' : '编辑 ') + (preset ? preset.label : 'MCP 服务');
|
||||
$('mce-name').value = preset ? preset.key : (add ? '' : (s.name || ''));
|
||||
$('mce-url').value = preset ? preset.url : (add ? '' : (s.url || ''));
|
||||
// 预填优先级:当前配置 > 预设缺省值。url 不锁只读——容器形态是 mcp_*:3000,本地形态是
|
||||
// 127.0.0.1:809x,漏改这里用户就看不到也改不了真实地址。
|
||||
$('mce-url').value = add ? (preset ? preset.url : '') : (s.url || (preset ? preset.url : ''));
|
||||
$('mce-name').readOnly = !!preset;
|
||||
$('mce-url').readOnly = !!preset;
|
||||
$('mce-url').readOnly = false;
|
||||
// 运行配置里的 timeout_ms 已被 config.js 填上缺省值,所以这里显示的就是当前生效值(没配则为 60000)。
|
||||
$('mce-timeout').value = add || s.timeout_ms == null ? '' : String(s.timeout_ms);
|
||||
// 预设的 mode 是契约(asr / image_task 必须 skill 才不会把一堆转写/生成工具塞进每轮工具表),
|
||||
@@ -1903,11 +1939,13 @@
|
||||
if (!Number.isFinite(tmo) || tmo < 1000 || tmo > 600000) throw new Error('超时要填 1000 ~ 600000 毫秒(留空 = 默认 60s)');
|
||||
tmo = Math.round(tmo);
|
||||
}
|
||||
// 内置服务的 name/url 是契约(表单只读),只有自定义服务才从输入框取
|
||||
const name = preset ? preset.key : $('mce-name').value.trim();
|
||||
const url = preset ? preset.url : $('mce-url').value.trim();
|
||||
const headers = preset ? presetHeaders() : plainHeaders();
|
||||
// name 是契约(预设的服务名固定);url 不再是契约——展示与写盘均以 config 为准,
|
||||
// 输入框里默认的就是预设值,改了就存。
|
||||
const add = mcpEdit.idx < 0;
|
||||
const cur = add ? {} : (SET.cfgMcp[mcpEdit.idx] || {});
|
||||
const name = preset ? preset.key : $('mce-name').value.trim();
|
||||
const url = $('mce-url').value.trim();
|
||||
const headers = preset ? presetHeaders() : plainHeaders();
|
||||
if (add) {
|
||||
if (!url) throw new Error('请填写 url');
|
||||
const obj = { url };
|
||||
@@ -1917,12 +1955,10 @@
|
||||
if (Object.keys(headers).length) obj.headers = headers;
|
||||
edits.push({ op: 'append', path: ['mcp_servers'], value: obj });
|
||||
} else {
|
||||
const cur = SET.cfgMcp[mcpEdit.idx] || {};
|
||||
if (!preset) {
|
||||
if (!url) throw new Error('请填写 url');
|
||||
if (name !== (cur.name || '')) edits.push({ path: ['mcp_servers', mcpEdit.idx, 'name'], value: name });
|
||||
if (url !== (cur.url || '')) edits.push({ path: ['mcp_servers', mcpEdit.idx, 'url'], value: url });
|
||||
}
|
||||
// 自定义服务:name/url 都能改;内置服务只允许改 url(name/mode 是契约)
|
||||
if (!url) throw new Error('请填写 url');
|
||||
if (!preset && name !== (cur.name || '')) edits.push({ path: ['mcp_servers', mcpEdit.idx, 'name'], value: name });
|
||||
if (url !== (cur.url || '')) edits.push({ path: ['mcp_servers', mcpEdit.idx, 'url'], value: url });
|
||||
// mode:默认值不写进文件(选 advertise 就删键)
|
||||
if ((cur.mode || 'advertise') !== mode) edits.push(mode === 'advertise'
|
||||
? { path: ['mcp_servers', mcpEdit.idx, 'mode'], op: 'delete' }
|
||||
@@ -1988,6 +2024,7 @@
|
||||
// 账户
|
||||
changePassword: changePassword,
|
||||
saveProfile: saveProfile,
|
||||
prefCount: prefCount,
|
||||
// 用户管理(仅管理员)
|
||||
openUserAdd: openUserAdd,
|
||||
openUserEdit: openUserEditor,
|
||||
@@ -2057,35 +2094,42 @@
|
||||
drawerMQ.addEventListener('change', e => openDrawer(e.matches));
|
||||
// 页面加载时校验 cookie 身份:防止 localStorage 旧 token 通过 autoRestore 恢复错误用户
|
||||
(async () => {
|
||||
let verifiedUser = null; // 校验结果顺带复用给侧边栏,避免同一次加载请求两次 /api/me
|
||||
try {
|
||||
const res = await fetch('/api/me', { credentials: 'include' });
|
||||
if (res.ok) {
|
||||
const j = await res.json();
|
||||
if (!j.user) {
|
||||
if (j.auth === false) {
|
||||
// 未启用多用户认证(单用户自用,本地模式即此形态):没有登录态可校验,全部设置可见
|
||||
SET.role = 'admin';
|
||||
SET.authEnabled = false;
|
||||
} else if (!j.user) {
|
||||
// cookie 无效或用户已从配置中移除 → 彻底清理所有前端凭据并跳登录
|
||||
localStorage.removeItem('agent_token');
|
||||
sessionStorage.removeItem('agent_creds'); // 旧版本遗留的 Basic 凭据,顺带清理
|
||||
location.href = '/logout';
|
||||
return;
|
||||
} else {
|
||||
SET.role = j.role === 'admin' ? 'admin' : 'user';
|
||||
SET.authEnabled = true;
|
||||
}
|
||||
verifiedUser = String(j.user);
|
||||
SET.role = j.role === 'admin' ? 'admin' : 'user';
|
||||
SET.authEnabled = true;
|
||||
} else {
|
||||
// /api/me 404 = 未启用多用户认证:单用户自用,全部设置可见(用户管理页因 auth 关闭而隐藏)
|
||||
// 兜底:改契约之前的旧后端在未启用认证时该路由不存在(404),按未启用处理
|
||||
SET.role = 'admin';
|
||||
SET.authEnabled = false;
|
||||
}
|
||||
} catch (_) { /* 网络错误放过,让后续请求正常走 */ }
|
||||
loadSessionList();
|
||||
loadDrawerUser(verifiedUser); // 侧边栏底部展示真实登录用户(未启用鉴权/拉取失败时静默回退默认占位)
|
||||
// 侧栏底部已是纯图标操作栏(不展示用户信息),不再需要 loadDrawerUser
|
||||
// 会话深链 /?s=<session_id>:数据页面(/app/{task_id}/...)的「返回会话」FAB 用——
|
||||
// task_id 即会话 id(engine 里 1:1),启动时消费一次即 replaceState 抹掉参数,
|
||||
// 避免刷新/分享时被钉回该会话;会话已删则 openSession 自行报错,落在 welcome。
|
||||
const deep = new URLSearchParams(location.search).get('s');
|
||||
// task_id 即会话 id(engine 里 1:1)。地址栏常驻 ?s= 不抹掉,刷新/收藏/分享都能回到同一会话;
|
||||
// 会话已删时 openSession 会自己回落到 welcome 并把 URL 清回 /。
|
||||
const params = new URLSearchParams(location.search);
|
||||
const deep = params.get('s');
|
||||
if (deep) {
|
||||
history.replaceState(null, '', '/');
|
||||
openSession(deep);
|
||||
openSession(deep).then(() => {
|
||||
// 从侧栏「在新窗口打开」进来(带 files=1):开局直接把侧栏切到文件树;
|
||||
// 窄屏/无会话/文件树未加载时 setDrawerPane 内部会自行忽略
|
||||
if (params.get('files') === '1' && typeof setDrawerPane === 'function') setDrawerPane(true);
|
||||
});
|
||||
}
|
||||
})();
|
||||
|
||||
@@ -98,13 +98,19 @@
|
||||
// ---------- 待发送条幅 ----------
|
||||
// 队列本身在服务端(engine.pendings),关页面/换设备/重连都不丢;这里只负责画。
|
||||
// 每条一行;只有队首有「干预 / 立即发送」,其余显示排队中(不能越过前一条先发)。
|
||||
// 两条操作各配一枚图标:笔=撤回编辑(正文退回输入框),垃圾桶=直接丢弃这条
|
||||
const SQ_EDIT_ICON = '<svg viewBox="0 0 24 24" width="14" height="14" fill="none" stroke="currentColor" stroke-width="1.9" stroke-linecap="round" stroke-linejoin="round"><use href="#i-pencil-b"/></svg>';
|
||||
const SQ_TRASH_ICON = '<svg viewBox="0 0 24 24" width="14" height="14" fill="none" stroke="currentColor" stroke-width="1.9" stroke-linecap="round" stroke-linejoin="round"><use href="#i-trash"/></svg>';
|
||||
|
||||
function renderSendQueue() {
|
||||
const box = $('send-queue');
|
||||
if (!box) return;
|
||||
const list = state.pending || [];
|
||||
// 条幅增减会改 chat-view 的 clientHeight,浏览器不会替你补滚动:
|
||||
// 改动前先记住是不是贴底,贴底就强制滚回去,否则最后一条消息被裁在视口外。
|
||||
const keepBottom = typeof isNearBottom === 'function' ? isNearBottom() : false;
|
||||
box.classList.toggle('hidden', !list.length);
|
||||
if (!list.length) { box.innerHTML = ''; return; }
|
||||
box.innerHTML = list.map((it, i) => {
|
||||
box.innerHTML = list.length ? list.map((it, i) => {
|
||||
const busy = it.mode === 'interject' || it.mode === 'now';
|
||||
const tag = it.mode === 'now' ? '<span class="sq-tag">正在中断…</span>'
|
||||
: it.mode === 'interject' ? '<span class="sq-tag">等待当前步骤…</span>'
|
||||
@@ -116,11 +122,14 @@
|
||||
return '<div class="sq-item' + (busy ? ' sq-busy' : '') + '" data-qid="' + esc(it.id) + '">' +
|
||||
'<span class="sq-text" title="' + esc(it.content) + '">' + esc(it.content) + '</span>' +
|
||||
tag + acts +
|
||||
'<button class="sq-x" data-act="cancel" title="取消这条">×</button></div>';
|
||||
}).join('');
|
||||
'<button class="sq-act" data-act="recall" title="撤回到输入框,重新编辑" aria-label="撤回编辑">' + SQ_EDIT_ICON + '</button>' +
|
||||
'<button class="sq-act" data-act="cancel" title="删除这条" aria-label="删除这条">' + SQ_TRASH_ICON + '</button></div>';
|
||||
}).join('') : '';
|
||||
// 双帧补滚:hidden 类与 textarea 高度都是本帧生效,rAF 后再跟一次才稳
|
||||
if (keepBottom && typeof scrollBottom === 'function') { scrollBottom(); requestAnimationFrame(scrollBottom); }
|
||||
}
|
||||
|
||||
// 条幅按钮:× 取消;干预/立即发送升级队首(服务端只在安全边界真正投递)。
|
||||
// 条幅按钮:笔=撤回编辑(正文退回输入框),垃圾桶=直接丢弃;干预/立即发送升级队首。
|
||||
async function onSendQueueClick(e) {
|
||||
const btn = e.target.closest('#send-queue button[data-act]');
|
||||
if (!btn || !state.sessionId) return;
|
||||
@@ -128,20 +137,34 @@
|
||||
const qid = item && item.dataset.qid;
|
||||
if (!qid) return;
|
||||
const act = btn.dataset.act;
|
||||
const isDel = act === 'recall' || act === 'cancel'; // 两者都是删队列项,区别只在要不要回填
|
||||
// 撤回文本必须在请求前取:DELETE 的响应里这条已经没了
|
||||
const draft = act === 'recall' ? ((state.pending || []).find(x => x.id === qid) || {}).content || '' : '';
|
||||
btn.disabled = true;
|
||||
try {
|
||||
const base = '/api/sessions/' + state.sessionId + '/pending/' + encodeURIComponent(qid);
|
||||
const r = act === 'cancel' ? await req('DELETE', base) : await req('POST', base, { action: act });
|
||||
const r = isDel ? await req('DELETE', base) : await req('POST', base, { action: act });
|
||||
if (r && Array.isArray(r.pending)) { state.pending = r.pending; renderSendQueue(); }
|
||||
if (act === 'cancel') return;
|
||||
if (r && r.delivered) return; // 回合已结束:服务端直接投递,等 user_message 画气泡
|
||||
toast(act === 'now' ? '已请求中断,随后立即发送' : '已请求干预:当前步骤结束后插话');
|
||||
if (isDel) { if (draft) recallToInput(draft); return; }
|
||||
// 干预/立即发送:条幅自己会变成「等待当前步骤…」/「正在中断…」,不再弹 toast
|
||||
} catch (err) {
|
||||
toast('操作失败:' + err.message);
|
||||
renderSendQueue();
|
||||
}
|
||||
}
|
||||
|
||||
// 撤回:塞回输入框(撤回段在前、已有草稿在后,与发送失败的兜底同序),光标停在撤回段末尾
|
||||
function recallToInput(text) {
|
||||
const ta = $('msg-input');
|
||||
if (!ta) return;
|
||||
ta.value = text + (ta.value ? '\n' + ta.value : '');
|
||||
autosize();
|
||||
updateSendBtn();
|
||||
ta.focus({ preventScroll: true }); // 别让浏览器为露出输入框去滚页面,聊天区的位置由下面统一管
|
||||
try { ta.setSelectionRange(text.length, text.length); } catch (_) {}
|
||||
if (typeof scrollBottom === 'function') { scrollBottom(); requestAnimationFrame(scrollBottom); }
|
||||
}
|
||||
|
||||
const sendQueueBox = $('send-queue');
|
||||
if (sendQueueBox) sendQueueBox.addEventListener('click', onSendQueueClick);
|
||||
|
||||
@@ -159,15 +182,16 @@
|
||||
state.streamEl = bubble;
|
||||
return wrap;
|
||||
}
|
||||
// 思考面板:首次思考 delta 到达时创建,带 open 状态(流式中默认展开)
|
||||
// 思考面板:首次思考 delta 到达时创建。**不展开**,只在 summary 里挂一段动态文字,
|
||||
// 让人感觉到在干活;正文开始后清空那段文字,需要看全文再点开。
|
||||
function ensureStreamThinkPanel() {
|
||||
if (state.streamThinkEl) return state.streamThinkEl;
|
||||
if (!state.streamWrap) ensureStreamWrap();
|
||||
const det = document.createElement('details');
|
||||
det.className = 'msg-think streaming';
|
||||
det.open = true; // 流式阶段默认展开,看思考增量
|
||||
det.open = false; // 流式阶段也不展开:展开的大段思考会把下面的内容一路顶下去
|
||||
const sum = document.createElement('summary');
|
||||
sum.innerHTML = '思考过程' + THINK_COPY_BTN;
|
||||
sum.innerHTML = '思考过程<span class="msg-think-live"></span>' + THINK_COPY_BTN;
|
||||
const body = document.createElement('div');
|
||||
body.className = 'msg-think-body';
|
||||
det.appendChild(sum);
|
||||
@@ -175,10 +199,12 @@
|
||||
// 插在气泡之前(思考 → 结论 的顺序)
|
||||
state.streamWrap.insertBefore(det, state.streamEl);
|
||||
state.streamThinkEl = body;
|
||||
state.streamThinkLive = sum.querySelector('.msg-think-live');
|
||||
return body;
|
||||
}
|
||||
// 思考结束(正文开始流式或本轮收尾):自动折叠思考面板并去掉流式高亮边框;用户仍可手动点开回看
|
||||
// 思考结束(正文开始流式或本轮收尾):清空标题行那段动态文字、折叠面板、去掉流式标记
|
||||
function collapseStreamThink() {
|
||||
if (state.streamThinkLive) state.streamThinkLive.textContent = '';
|
||||
if (!state.streamThinkEl) return;
|
||||
const det = state.streamThinkEl.closest('details');
|
||||
if (det) { det.open = false; det.classList.remove('streaming'); }
|
||||
@@ -200,13 +226,22 @@
|
||||
el.textContent = full; // 结构不符(收尾后重建/罕见回退)才整段重写
|
||||
}
|
||||
|
||||
// 标题行里的动态文字:只取最后一行(单行截断),持续换内容形成“在动”的感觉。
|
||||
// 不能像正文那样 appendData:这里是一行标题,追加只会无限变长。
|
||||
function paintThinkLive(el, full) {
|
||||
if (!el) return;
|
||||
const lines = String(full || '').split('\n').filter(Boolean);
|
||||
const tail = lines.length ? lines[lines.length - 1] : '';
|
||||
if (el.textContent !== tail) el.textContent = tail;
|
||||
}
|
||||
|
||||
function scheduleStreamPaint() {
|
||||
if (streamPaintQueued) return;
|
||||
streamPaintQueued = true;
|
||||
requestAnimationFrame(() => {
|
||||
streamPaintQueued = false;
|
||||
paintStreamingText(state.streamEl, state.streamText);
|
||||
paintStreamingText(state.streamThinkEl, state.streamReasoning);
|
||||
paintThinkLive(state.streamThinkLive, state.streamReasoning);
|
||||
maybeAutoScroll();
|
||||
updateScrollBottomBtn();
|
||||
});
|
||||
@@ -220,7 +255,7 @@
|
||||
state.lastSseAt = Date.now(); // 建连即重置静默计时
|
||||
// 任何具名事件都算连接存活:静默看门狗与回前台宽限共用(error 不列,原生连接错误也走 error)
|
||||
['ping', 'status', 'assistant_delta', 'reasoning_delta', 'assistant_message', 'tool_call_start',
|
||||
'tool_call_args', 'tool_call', 'tool_result', 'ui_card', 'auto_compress', 'done', 'title', 'think_auto',
|
||||
'tool_call_args', 'tool_call', 'tool_output', 'tool_result', 'ui_card', 'auto_compress', 'done', 'title', 'think_auto',
|
||||
'pending_added', 'pending_removed', 'user_message']
|
||||
.forEach(function (n) { es.addEventListener(n, function () { markSseAlive(n); }); });
|
||||
es.addEventListener('status', ev => {
|
||||
@@ -290,6 +325,7 @@
|
||||
state.streamEl.className = 'bubble-ai' + (r.fmt ? ' md' : ''); // 增量期间是纯文本,收尾统一换 md 排版
|
||||
state.streamEl.innerHTML = r.html;
|
||||
decorateCodePre(state.streamEl); // 流式期间不插按钮(每帧整块换 innerHTML),收尾统一装饰一次
|
||||
pvHighlightMdCode(state.streamEl); // 围栏代码块上色
|
||||
} else {
|
||||
// 无文本时去掉气泡(纯工具调用/纯思考也要保留思考面板)
|
||||
state.streamEl.remove();
|
||||
@@ -303,18 +339,18 @@
|
||||
bubble.className = 'bubble-ai' + (r.fmt ? ' md' : '');
|
||||
bubble.innerHTML = r.html;
|
||||
decorateCodePre(bubble);
|
||||
pvHighlightMdCode(bubble);
|
||||
state.streamWrap.appendChild(bubble);
|
||||
}
|
||||
// 「压缩」总结回合的最终答复(后端已保证只有压缩回合里首条无工具调用的收尾回复才带 is_summary,
|
||||
// 中间 AI 回复已按普通消息渲染):把已流式输出的气泡装进摘要卡片(与历史重渲染同款样式),
|
||||
// 并标记 wrap 为 msg-summary-live:archiveDomBeforeSummary 据此定位摘要卡片,之前的旧消息收进存档容器。
|
||||
// open=true 让用户立刻读到;后续轮次不自动折起(卡片可手动点 summary 收起)。
|
||||
// 摘要卡片默认收起(与画像快照/渠道/记忆同一种交互),用户想读时点开。
|
||||
// 防重:同一 streamWrap 已有卡片则不再重复插入(保护 SSE 重连重发等场景)。
|
||||
if (d.is_summary && hasText && state.streamWrap && !state.streamWrap.querySelector('.msg-summary')) {
|
||||
const wrap0 = state.streamWrap;
|
||||
const det = document.createElement('details');
|
||||
det.className = 'msg-summary';
|
||||
det.open = true;
|
||||
det.innerHTML = summaryHeaderHtml() + '<div class="msg-summary-body"></div>';
|
||||
const body = det.querySelector('.msg-summary-body');
|
||||
const bubble = wrap0.querySelector('.bubble-ai');
|
||||
@@ -392,14 +428,20 @@
|
||||
if (state.toolCards[d.id]) {
|
||||
// 执行时的完整参数事件:若为流式早卡则回填收尾(unwrap 后的干净参数),普通卡不动
|
||||
finalizeToolCardArgs(d.id, d.name, d.arguments);
|
||||
state.toolCards[d.id].classList.add('running'); // 执行中:摘要行圆点转起来
|
||||
return;
|
||||
}
|
||||
// 无早卡(旧行为/刷新后重连):直接建展开卡
|
||||
const card = renderToolCard(d.id, d.name, d.arguments, Date.now(), { open: true });
|
||||
card.classList.add('running');
|
||||
$('chat-view').appendChild(card);
|
||||
state.toolCards[d.id] = card;
|
||||
maybeAutoScroll();
|
||||
});
|
||||
es.addEventListener('tool_output', ev => {
|
||||
const d = JSON.parse(ev.data);
|
||||
appendToolOutput(d.id, d.chunk);
|
||||
});
|
||||
es.addEventListener('tool_result', ev => {
|
||||
const d = JSON.parse(ev.data);
|
||||
fillToolResult(d.tool_call_id, d.content, d.is_error, d.image_url, d.msg_id);
|
||||
@@ -473,6 +515,9 @@
|
||||
state.toolCallStreaming = {}; // 流式参数早卡映射随会话/回合重置
|
||||
updateScrollBottomBtn();
|
||||
loadSessionList();
|
||||
// 一轮完整跑完(agent 循环退出才发 done):工具/技能产物可能新增或改名,文件树就地刷新;
|
||||
// 不在文件树面板时 reloadFileTree 只标脏,等切回去再重拉
|
||||
if (typeof window.reloadFileTree === 'function') window.reloadFileTree();
|
||||
});
|
||||
// 服务端首次交互后自动生成的标题(finalize 后约 1s 到达):即时刷新顶栏 + 重拉会话列表(PC 常驻侧边栏/移动抽屉)
|
||||
es.addEventListener('title', ev => {
|
||||
@@ -517,7 +562,7 @@
|
||||
try { text = decodeURIComponent(escape(atob(copyBtn.dataset.b64 || ''))); } catch (_) {}
|
||||
}
|
||||
const ok = await copyText(text);
|
||||
toast(ok ? '已复制' : '复制失败');
|
||||
if (!ok) toast('复制失败');
|
||||
if (ok) {
|
||||
copyBtn.classList.add('copied');
|
||||
setTimeout(() => copyBtn.classList.remove('copied'), 1200);
|
||||
@@ -538,7 +583,6 @@
|
||||
btn.disabled = true;
|
||||
try {
|
||||
await req('DELETE', '/api/sessions/' + state.sessionId + '/messages/' + msgId);
|
||||
toast('已删除');
|
||||
// 按已加载量分页重拉(长会话删一条不该退回全量重建)
|
||||
const detail = await req('GET', '/api/sessions/' + state.sessionId + '?limit=' + Math.max(CHAT_PAGE_SIZE, state.chatLoadedCount));
|
||||
if (state.view === 'chat') renderDetail(detail);
|
||||
@@ -702,6 +746,21 @@
|
||||
$('chat-view').addEventListener('click', imgViewerDelegate);
|
||||
$('fs-viewer').addEventListener('click', imgViewerDelegate);
|
||||
|
||||
// ---------- 会话流里的本机链接:进预览窗 ----------
|
||||
// 只拦本机 host(同源 / localhost 别名);外链、锚点、mailto、相对路径维持浏览器默认。
|
||||
// 修饰键与中键放行,留着「我就是要新开一个标签页」这个出口。
|
||||
function linkPreviewDelegate(e) {
|
||||
if (e.button !== 0 || e.ctrlKey || e.metaKey || e.shiftKey || e.altKey) return;
|
||||
const a = e.target.closest('a[href]');
|
||||
if (!a) return;
|
||||
const href = a.getAttribute('href') || '';
|
||||
if (!/^(https?:\/\/|\/(?!\/))/i.test(href) || !pvSameHost(href)) return;
|
||||
e.preventDefault();
|
||||
const txt = (a.textContent || '').trim();
|
||||
pvOpenUrl(href, txt && txt.length <= 40 ? txt : null);
|
||||
}
|
||||
$('chat-view').addEventListener('click', linkPreviewDelegate);
|
||||
|
||||
// 图片全屏查看器:transform 缩放+平移。双指捻合缩放(1~6x)、放大后单指/鼠标拖动、双击切 2.5x。
|
||||
// 第 3 参 list([{src,alt}] 或 [src]) 传入「同组图片」时开启左右滑动切换;第 4 参 at 指定起始下标。
|
||||
// 切图用双层 img 做真正的分页位移(旧图跟手滑出、新图同步滑入),并在开图时预取相邻图,
|
||||
|
||||
@@ -0,0 +1,275 @@
|
||||
// Git 面板(复用 #pv-pane:预览 / Git 二选一,由 body.pv-mode-vcs 切换)。
|
||||
// 三个视图:list(提交历史 + 未提交入口)/ detail(提交详情)/ worktree(未提交改动)。
|
||||
// 后两者共用一个渲染器,区别只在头部有没有 commit 信息。
|
||||
// 不做自动刷新:打开、切视图、点刷新时才请求。
|
||||
// 依赖(全局):state esc toast req pvOpenPane pvHeader pvToolbar pvClearBody pvState pvDesktop openFilePreview
|
||||
'use strict';
|
||||
(function () {
|
||||
const PAGE = 30;
|
||||
// view: list | detail | worktree;cur: 当前详情响应;lastPreview: 进 Git 前预览的文件(切回用)
|
||||
const st = { view: 'list', sid: '', repo: null, commits: [], next: null, cur: null, lastPreview: null, seq: 0 };
|
||||
|
||||
function bodyEl() { return document.getElementById('pv-body'); }
|
||||
function sid() { return (state && state.sessionId) || ''; }
|
||||
|
||||
function api(p) {
|
||||
return req('GET', '/api/sessions/' + encodeURIComponent(sid()) + p);
|
||||
}
|
||||
|
||||
// 仓库路径显示在地址条上(地址条是现成的路径位,不另开头部)
|
||||
function setAddr(repo) {
|
||||
const t = document.getElementById('pv-title');
|
||||
if (!t || !repo) return;
|
||||
t.value = repo.root || '';
|
||||
t.title = (repo.root || '') + (repo.branch ? ' · ' + repo.branch : '');
|
||||
}
|
||||
|
||||
function fmtTime(iso) {
|
||||
const d = new Date(iso);
|
||||
if (isNaN(d.getTime())) return String(iso || '');
|
||||
const p = (n) => (n < 10 ? '0' + n : '' + n);
|
||||
return d.getFullYear() + '-' + p(d.getMonth() + 1) + '-' + p(d.getDate()) + ' ' + p(d.getHours()) + ':' + p(d.getMinutes());
|
||||
}
|
||||
|
||||
const BADGE = { A: '新增', D: '删除', R: '改名', M: '修改', U: '未跟踪' };
|
||||
|
||||
function errBox(text, retry) {
|
||||
bodyEl().innerHTML =
|
||||
'<div class="pv-err"><div class="vcs-err-t"></div>' + (retry ? '<button type="button" class="vcs-retry">重试</button>' : '') + '</div>';
|
||||
bodyEl().querySelector('.vcs-err-t').textContent = text;
|
||||
const b = bodyEl().querySelector('.vcs-retry');
|
||||
if (b) b.addEventListener('click', retry);
|
||||
}
|
||||
|
||||
function reasonText(reason) {
|
||||
if (reason === 'no_git') return '这个环境没有 git 命令。';
|
||||
if (reason === 'bad_rev') return '提交不存在,可能已被改写或清理。';
|
||||
if (reason === 'timeout') return 'git 执行超时,仓库可能过大。';
|
||||
if (reason === 'not_repo') return '未找到 git 仓库:当前会话目录及其上级都不是仓库。';
|
||||
return '读取失败:' + (reason || '未知错误');
|
||||
}
|
||||
|
||||
// ---------- 列表 ----------
|
||||
function renderList() {
|
||||
const parts = [];
|
||||
parts.push('<div class="vcs-list">');
|
||||
if (st.repo) {
|
||||
const rm = st.repo.remote;
|
||||
parts.push('<div class="vcs-repo">' + esc(st.repo.root) + (st.repo.branch ? ' · ' + esc(st.repo.branch) : '') +
|
||||
' · <span class="vcs-remote' + (rm ? '' : ' none') + '" title="' + esc(rm ? rm.url : '未配置 remote') + '">' +
|
||||
esc(rm ? rm.name : '无 remote') + '</span></div>');
|
||||
}
|
||||
if (st.worktree && st.worktree.files) {
|
||||
parts.push('<div class="vcs-item wt" data-act="worktree">' +
|
||||
'<div class="t">未提交的改动</div>' +
|
||||
'<div class="m">' + st.worktree.files + ' 个文件有变动</div></div>');
|
||||
}
|
||||
const up = st.repo && st.repo.upstream;
|
||||
for (const c of st.commits) {
|
||||
const atUp = up && c.id === up.id;
|
||||
parts.push('<div class="vcs-item' + (atUp ? ' at-up' : '') + '" data-act="commit" data-id="' + esc(c.id) + '">' +
|
||||
'<div class="t">' + esc(c.subject) +
|
||||
(atUp ? ' <span class="vcs-up" title="远端 ' + esc(up.ref) + ' 指向这里">' + esc(up.ref) + '</span>' : '') + '</div>' +
|
||||
'<div class="m">' + esc(c.author) + ' · ' + esc(fmtTime(c.time)) + ' · ' + esc(c.short) + '</div></div>');
|
||||
}
|
||||
if (!st.commits.length && !(st.worktree && st.worktree.files)) {
|
||||
parts.push('<div class="vcs-empty">还没有提交记录</div>');
|
||||
}
|
||||
if (st.next) parts.push('<button type="button" class="vcs-more" data-act="more">加载更多</button>');
|
||||
parts.push('</div>');
|
||||
bodyEl().innerHTML = parts.join('');
|
||||
}
|
||||
|
||||
// ---------- 详情(提交 / 未提交共用)----------
|
||||
// 语法高亮:与预览共用 PV_LANG(preview.js)。只能逐行高亮:diff 是片段,多行注释/三引号串
|
||||
// 本来就拼不完整;逐行反而不会把行号与红绿底色搞乱。
|
||||
function prismLang(path) {
|
||||
if (typeof PV_LANG === 'undefined' || typeof Prism === 'undefined' || !Prism.languages) return null;
|
||||
const m = /\.([^.\\/]+)$/.exec(String(path || ''));
|
||||
const lang = m && PV_LANG[m[1].toLowerCase()];
|
||||
return lang && Prism.languages[lang] ? lang : null;
|
||||
}
|
||||
function codeEsc(text, lang) {
|
||||
if (!lang) return esc(text);
|
||||
try { return Prism.highlight(text, Prism.languages[lang], lang); } catch (_) { return esc(text); }
|
||||
}
|
||||
function lineHtml(cls, oldNo, newNo, text, lang) {
|
||||
return '<div class="vcs-line' + (cls ? ' ' + cls : '') + '"><span class="n">' + (oldNo == null ? '' : oldNo) +
|
||||
'</span><span class="n">' + (newNo == null ? '' : newNo) + '</span><span class="c">' + codeEsc(text, lang) + '</span></div>';
|
||||
}
|
||||
|
||||
// 行号自己推:@@ -a,b +c,d @@ 之后的上下文/+/- 分别推进两个计数器
|
||||
function patchHtml(f) {
|
||||
if (f.binary) return '<div class="vcs-nodiff">二进制文件,不显示差异</div>';
|
||||
if (!f.patch) return '<div class="vcs-nodiff">没有可显示的差异</div>';
|
||||
const out = [];
|
||||
const lines = String(f.patch).split('\n');
|
||||
// 大 patch 不上色:逐行跑 Prism 是同步的,几千行会把面板卡一下
|
||||
const lang = lines.length <= 2000 ? prismLang(f.path) : null;
|
||||
let oldNo = 0, newNo = 0, inHunk = false, rows = 0;
|
||||
for (let i = 0; i < lines.length; i++) {
|
||||
const line = lines[i];
|
||||
if (i === lines.length - 1 && line === '') break; // 末尾换行不算内容行
|
||||
if (line.slice(0, 2) === '@@') {
|
||||
const m = /^@@ -(\d+)(?:,\d+)? \+(\d+)(?:,\d+)? @@/.exec(line);
|
||||
if (m) { oldNo = Number(m[1]); newNo = Number(m[2]); inHunk = true; }
|
||||
out.push('<div class="vcs-line h"><span class="n"></span><span class="n"></span><span class="c">' + esc(line) + '</span></div>');
|
||||
continue;
|
||||
}
|
||||
if (!inHunk) continue; // 文件头(diff --git / index / --- / +++)由文件行本身表达,不重复渲染
|
||||
if (line.charAt(0) === '\\') { out.push('<div class="vcs-line meta"><span class="n"></span><span class="n"></span><span class="c">' + esc(line) + '</span></div>'); continue; }
|
||||
const c = line.charAt(0);
|
||||
if (c === '+') out.push(lineHtml('a', null, newNo++, line.slice(1), lang));
|
||||
else if (c === '-') out.push(lineHtml('d', oldNo++, null, line.slice(1), lang));
|
||||
else out.push(lineHtml('', oldNo++, newNo++, line.slice(1), lang));
|
||||
if (++rows > 3000) { out.push('<div class="vcs-nodiff">行数过多,剩余部分已隐藏</div>'); break; }
|
||||
}
|
||||
return out.join('') || '<div class="vcs-nodiff">仅改名或模式变更,没有内容差异</div>';
|
||||
}
|
||||
|
||||
function fileHtml(f, idx, openAll) {
|
||||
const open = openAll ? ' open' : '';
|
||||
return '<div class="vcs-file' + open + '" data-i="' + idx + '">' +
|
||||
'<div class="vcs-fh">' +
|
||||
'<span class="vcs-caret"></span>' +
|
||||
'<span class="vcs-path">' + esc(f.path) + '</span>' +
|
||||
'<span class="vcs-badge ' + esc(String(f.status || '').toLowerCase()) + '">' + esc(BADGE[f.status] || f.status) + '</span>' +
|
||||
'<span class="vcs-stat"><b class="a">+' + f.adds + '</b><b class="d">-' + f.dels + '</b></span>' +
|
||||
'</div>' +
|
||||
'<div class="vcs-fb"><div class="vcs-fb-in">' + patchHtml(f) + (f.truncated ? '<div class="vcs-nodiff">差异过大,已截断</div>' : '') + '</div></div>' +
|
||||
'</div>';
|
||||
}
|
||||
|
||||
// 行背景要盖满「可视宽度 ∩ 内容宽度」:只量 clientWidth 不够,长行溢出到 1129 时行背景仍只有 699,
|
||||
// 横滑右边就露白。scrollWidth 正好是最长行的内容宽,取两者较大值写成 px 给内层。
|
||||
function syncPatchWidth(scope) {
|
||||
(scope || document).querySelectorAll('.vcs-fb').forEach(function (fb) {
|
||||
const inner = fb.firstElementChild;
|
||||
if (!inner) return;
|
||||
const w = Math.max(fb.clientWidth, fb.scrollWidth);
|
||||
if (w > 0) inner.style.minWidth = w + 'px';
|
||||
});
|
||||
}
|
||||
|
||||
function renderDetail(d) {
|
||||
st.cur = d;
|
||||
const openAll = d.files.length <= 3; // 少量文件默认展开,多文件默认折叠
|
||||
const parts = [];
|
||||
parts.push('<div class="vcs-detail">');
|
||||
parts.push('<button type="button" class="vcs-back" data-act="back">返回提交列表</button>');
|
||||
if (d.commit) {
|
||||
parts.push('<div class="vcs-commit">' +
|
||||
'<div class="vcs-subject">' + esc(d.commit.subject) + '</div>' +
|
||||
'<div class="vcs-meta"><span>' + esc(d.commit.author) + '</span><span>' + esc(fmtTime(d.commit.time)) + '</span>' +
|
||||
'<span class="vcs-hash">' + esc(d.commit.short) + '</span>' +
|
||||
(d.commit.parents && d.commit.parents.length > 1 ? '<span>合并提交</span>' : '') + '</div>' +
|
||||
(d.commit.body ? '<pre class="vcs-msg">' + esc(d.commit.body) + '</pre>' : '') +
|
||||
'</div>');
|
||||
} else {
|
||||
parts.push('<div class="vcs-commit"><div class="vcs-subject">未提交的改动</div>' +
|
||||
'<div class="vcs-meta"><span>' + esc(d.repo.branch || 'HEAD') + '</span><span>' + esc(d.repo.root) + '</span></div></div>');
|
||||
}
|
||||
parts.push('<div class="vcs-sum">' + d.stats.files + ' 个文件 · <b class="a">+' + d.stats.adds + '</b> <b class="d">-' + d.stats.dels + '</b></div>');
|
||||
d.files.forEach(function (f, i) { parts.push(fileHtml(f, i, openAll)); });
|
||||
if (!d.files.length) parts.push('<div class="vcs-empty">没有文件变动</div>');
|
||||
parts.push('</div>');
|
||||
bodyEl().innerHTML = parts.join('');
|
||||
syncPatchWidth(bodyEl());
|
||||
}
|
||||
|
||||
// ---------- 数据加载 ----------
|
||||
async function loadList(more) {
|
||||
const seq = ++st.seq;
|
||||
const keepTop = more ? bodyEl().scrollTop : 0; // 加载更多是整体重绘,得自己把滚动位置补回去
|
||||
st.view = 'list';
|
||||
st.sid = sid();
|
||||
if (!more) { st.commits = []; st.next = null; bodyEl().innerHTML = '<div class="pv-loading"></div>'; }
|
||||
const q = '?limit=' + PAGE + (more && st.next ? '&before=' + encodeURIComponent(st.next) : '');
|
||||
let d;
|
||||
try { d = await api('/git/commits' + q); }
|
||||
catch (e) { if (seq === st.seq) errBox('请求失败:' + (e.message || e), function () { loadList(false); }); return; }
|
||||
if (seq !== st.seq) return;
|
||||
if (!d || !d.ok) { errBox(reasonText(d && d.reason), function () { loadList(false); }); return; }
|
||||
st.repo = d.repo;
|
||||
st.worktree = d.worktree;
|
||||
st.commits = more ? st.commits.concat(d.commits) : d.commits;
|
||||
st.next = d.next;
|
||||
setAddr(d.repo);
|
||||
renderList();
|
||||
if (more) bodyEl().scrollTop = keepTop;
|
||||
}
|
||||
|
||||
async function loadDetail(rev) {
|
||||
const seq = ++st.seq;
|
||||
st.view = rev === 'worktree' ? 'worktree' : 'detail';
|
||||
st.sid = sid();
|
||||
bodyEl().innerHTML = '<div class="pv-loading"></div>';
|
||||
let d;
|
||||
try { d = await api('/git/commit/' + encodeURIComponent(rev)); }
|
||||
catch (e) {
|
||||
if (seq === st.seq) errBox('请求失败:' + (e.message || e), function () { loadDetail(rev); });
|
||||
return;
|
||||
}
|
||||
if (seq !== st.seq) return;
|
||||
if (!d || !d.ok) { errBox(reasonText(d && d.reason), function () { loadDetail(rev); }); return; }
|
||||
renderDetail(d);
|
||||
}
|
||||
|
||||
function refresh() {
|
||||
if (st.view === 'list') return loadList(false);
|
||||
if (st.view === 'worktree') return loadDetail('worktree');
|
||||
if (st.cur && st.cur.commit) return loadDetail(st.cur.commit.id);
|
||||
return loadList(false);
|
||||
}
|
||||
|
||||
// ---------- 面板开关 ----------
|
||||
function syncBtn() {
|
||||
const b = document.getElementById('tree-vcs');
|
||||
if (b) b.classList.toggle('active', document.body.classList.contains('pv-mode-vcs'));
|
||||
}
|
||||
|
||||
function setMode(on) {
|
||||
document.body.classList.toggle('pv-mode-vcs', !!on);
|
||||
syncBtn();
|
||||
}
|
||||
|
||||
function openPane() {
|
||||
if (!sid()) { toast('请先打开一个会话'); return; }
|
||||
if (typeof pvDesktop === 'function' && !pvDesktop()) { toast('Git 面板仅在桌面端可用'); return; }
|
||||
const on = document.body.classList.contains('pv-mode-vcs');
|
||||
if (on && st.sid === sid()) { // 再点一次:有上次预览就切回预览,否则关面板
|
||||
setMode(false);
|
||||
if (st.lastPreview) { openFilePreview(st.lastPreview); return; }
|
||||
document.getElementById('pv-close').click();
|
||||
return;
|
||||
}
|
||||
if (!on) st.lastPreview = (typeof pvState === 'object' && pvState && pvState.name) || null;
|
||||
if (typeof pvOpenPane === 'function') pvOpenPane();
|
||||
setMode(true);
|
||||
pvClearBody();
|
||||
pvHeader(null); // 清掉预览的文件名与下载钮;地址条下面再写仓库路径
|
||||
pvToolbar({ refresh: true, popup: false, reload: refresh });
|
||||
loadList(false);
|
||||
}
|
||||
|
||||
// 事件委托:pv-body 的内容每次整体重建,逐元素绑定没必要
|
||||
document.getElementById('pv-body').addEventListener('click', function (e) {
|
||||
if (!document.body.classList.contains('pv-mode-vcs')) return;
|
||||
const it = e.target.closest('.vcs-item');
|
||||
if (it) {
|
||||
if (it.dataset.act === 'worktree') loadDetail('worktree');
|
||||
else if (it.dataset.act === 'commit') loadDetail(it.dataset.id);
|
||||
return;
|
||||
}
|
||||
const more = e.target.closest('.vcs-more');
|
||||
if (more) { loadList(true); return; }
|
||||
const back = e.target.closest('.vcs-back');
|
||||
if (back) { loadList(false); return; }
|
||||
const fh = e.target.closest('.vcs-fh');
|
||||
if (fh) { fh.parentNode.classList.toggle('open'); syncPatchWidth(fh.parentNode); return; }
|
||||
});
|
||||
|
||||
window.openVcsPane = openPane;
|
||||
window.vcsSetMode = setMode;
|
||||
window.vcsRefresh = refresh;
|
||||
})();
|
||||
+173
-27
@@ -36,6 +36,14 @@
|
||||
const MAX_MS = 180000; // 单次录音上限(流式上传后不再受 60s 限制)
|
||||
const MIN_MS = 500; // 短于这个时长按误触处理,不上传
|
||||
const FLUSH_MS = 60000; // 松手后等尾段识别完的上限(超过就当失败)
|
||||
// 桌面用鼠标就用「点一下开始、再点一下发送」;手机(触屏)继续按住说话。
|
||||
// 桌面一直压着鼠标键说话手累,上滑取消也没意义;两个平台各自按自己的习惯来。
|
||||
const POINT_FINE = !!(window.matchMedia && window.matchMedia('(hover: hover) and (pointer: fine)').matches);
|
||||
const HOLD_IDLE = POINT_FINE ? '点击 说话' : '按住 说话';
|
||||
const HOLD_REC = POINT_FINE ? '说完 点击发送' : '松开 结束';
|
||||
// 转写请求的并发上限:段一碎(6s 软切)并发就会很多,全放出去会把上游压垮、
|
||||
// 也可能被限流。超过就排到后面,等前面的落定再发。改完刷新页面即生效。
|
||||
const ASR_MAX_CONCURRENCY = 3;
|
||||
const OUT_RATE = 16000; // 页面内部统一按 16k 处理:VAD 时长与段长上限都按它算
|
||||
const BAR_COUNT = 45; // 声波柱数(要足够宽,手指按住时两侧仍能看到)
|
||||
|
||||
@@ -73,10 +81,18 @@
|
||||
// 流式:壳推的分片 / 浏览器自己采的分片,都在这里断句后逐段上传
|
||||
let pcmRate = 16000; // 当前流的采样率(契约要求 16k)
|
||||
let segChunks = []; // 当前段的 PCM 分片(Int16Array)
|
||||
let segLens = []; // 各分片采样数(与 segChunks 平行:软切要按采样换算边界)
|
||||
let segDbs = []; // 各分片峰值 dB(与 segChunks 平行:软切要找能量最低的边界)
|
||||
let segLen = 0; // 当前段总采样数
|
||||
let silLen = 0; // 段尾连续静音采样数
|
||||
let textParts = []; // 各段识别结果(按顺序)
|
||||
let chain = Promise.resolve(); // 串行上传链:保证拼接顺序 = 说话顺序
|
||||
let textParts = []; // 各段识别结果,按提交顺序占位(并行返回是乱序的)
|
||||
let segSent = 0; // 本轮已提交转写的段数(进度分母)
|
||||
let segDone = 0; // 已返回(含失败)的段数(进度分子)
|
||||
let busyTimer = null; // 「识别中」提示的秒表(1s 一跳)
|
||||
let busyStartAt = 0;
|
||||
let inflight = []; // 本轮各段的落定 promise(收口要等全它们)
|
||||
let waiting = []; // 等名额的段(在飞满了才排)
|
||||
let active = 0; // 正在飞的请求数
|
||||
let gen = 0; // 会话代号:取消/重录后迟到结果直接丢弃
|
||||
let streamOn = false; // 是否接受 PCM 分片
|
||||
let flushTimer = null;
|
||||
@@ -86,6 +102,8 @@
|
||||
const VAD_PAUSE_SEC = 0.5; // 连续静音这么久 → 断句(与壳无关)
|
||||
const VAD_MIN_SPEECH_SEC = 0.3; // 一段短于这个 → 当噪声丢掉
|
||||
const VAD_MAX_SEG_SEC = 25; // 单段上限:连续说话没停顿就硬切(上游单次上限)
|
||||
const VAD_SOFT_CUT_SEC = 6; // 累计语音超过这么久 → 在低能量处先切一刀发出去
|
||||
const VAD_SOFT_WINDOW_SEC = 3; // 软切只在尾部这个窗口里找切点(不切在很久以前)
|
||||
|
||||
// 电平与渲染
|
||||
let rafId = 0;
|
||||
@@ -112,11 +130,40 @@
|
||||
// ---------- 遮罩 / 声波 ----------
|
||||
function setOverlayMode(m) { // 'send' | 'cancel' | 'busy'
|
||||
cancelArmed = m === 'cancel';
|
||||
if (overlay) overlay.classList.toggle('cancel', m === 'cancel');
|
||||
if (hintEl) {
|
||||
hintEl.textContent = m === 'cancel' ? '松开取消'
|
||||
: m === 'busy' ? '正在识别…' : '松手传送,上滑取消';
|
||||
if (overlay) {
|
||||
overlay.classList.toggle('cancel', m === 'cancel');
|
||||
overlay.classList.toggle('busy', m === 'busy'); // 识别中把操作行藏起来,避免空点
|
||||
}
|
||||
if (hintEl) {
|
||||
hintEl.textContent = m === 'cancel' ? '松手取消'
|
||||
: m === 'busy' ? busyHintText()
|
||||
: (POINT_FINE ? '' : '松手传送,上滑取消');
|
||||
}
|
||||
}
|
||||
|
||||
// 「识别中」的进度提示:段数是真实进度(一段一次转写),秒数让长时间等待时数字也在动,
|
||||
// 不至于看着像卡住。只有一段时不显示 0/1(那看着也像没进展),只留秒数。
|
||||
function busyHintText() {
|
||||
const sec = Math.max(0, Math.floor((Date.now() - busyStartAt) / 1000));
|
||||
if (segSent > 1) {
|
||||
return '正在识别 ' + Math.min(segDone, segSent) + '/' + segSent + ' 段 · ' + sec + 's';
|
||||
}
|
||||
return '正在识别… ' + sec + 's';
|
||||
}
|
||||
|
||||
function refreshBusyHint() {
|
||||
if (hintEl && phase === 'busy') hintEl.textContent = busyHintText();
|
||||
}
|
||||
|
||||
function stopBusyTicker() {
|
||||
if (busyTimer) { clearInterval(busyTimer); busyTimer = null; }
|
||||
}
|
||||
|
||||
function startBusyTicker() {
|
||||
stopBusyTicker();
|
||||
busyStartAt = Date.now();
|
||||
refreshBusyHint();
|
||||
busyTimer = setInterval(refreshBusyHint, 1000);
|
||||
}
|
||||
|
||||
function renderBars(level, animate) {
|
||||
@@ -260,10 +307,11 @@
|
||||
pressing = false;
|
||||
pressY = 0;
|
||||
discard = false;
|
||||
stopBusyTicker();
|
||||
abortStream();
|
||||
if (stopTimer) { clearTimeout(stopTimer); stopTimer = null; }
|
||||
hold.classList.remove('recording');
|
||||
setHoldText('按住 说话');
|
||||
setHoldText(HOLD_IDLE);
|
||||
hideOverlay();
|
||||
updateSendBtn();
|
||||
}
|
||||
@@ -302,8 +350,10 @@
|
||||
if (phase !== 'idle') return;
|
||||
pressing = true;
|
||||
discard = false;
|
||||
segSent = 0;
|
||||
segDone = 0;
|
||||
hold.classList.add('recording');
|
||||
setHoldText('松开 结束');
|
||||
setHoldText(HOLD_REC);
|
||||
showOverlay();
|
||||
|
||||
if (native) {
|
||||
@@ -312,6 +362,7 @@
|
||||
phase = 'recording';
|
||||
recordStartAt = Date.now();
|
||||
gen++; // 新会话:让上一轮迟到的结果全部失效
|
||||
inflight = []; // 上一轮的在途请求不再计入本轮收口
|
||||
streamOn = true;
|
||||
pcmRate = 16000;
|
||||
clearSeg();
|
||||
@@ -349,6 +400,7 @@
|
||||
gen++;
|
||||
pcmRate = OUT_RATE;
|
||||
streamOn = true;
|
||||
inflight = [];
|
||||
clearSeg();
|
||||
textParts = [];
|
||||
if (!startCapture()) {
|
||||
@@ -370,8 +422,8 @@
|
||||
if (held < MIN_MS) discard = true;
|
||||
phase = 'busy';
|
||||
hold.classList.remove('recording');
|
||||
setHoldText(discard ? '按住 说话' : '正在识别…');
|
||||
// 遮罩留着,文案换成「正在识别…」;柱子停在低位,等结果回来再收
|
||||
setHoldText(discard ? HOLD_IDLE : '正在识别…');
|
||||
// 遮罩留着,文案换成动态识别进度;柱子停在低位,等结果回来再收
|
||||
setOverlayMode(discard ? 'send' : 'busy');
|
||||
stopMeter();
|
||||
|
||||
@@ -387,6 +439,7 @@
|
||||
// 两条路收口完全一样:把不足一个停顿的尾巴发走(纯静音的尾巴不发),再等所有段回来。
|
||||
// 大部分段在说话过程中已经识别完了,这里通常只等最后一段。
|
||||
flushTail();
|
||||
startBusyTicker(); // 尾巴已进队列:现在才有准确的总段数,从这一刻开始计时
|
||||
if (native) {
|
||||
try {
|
||||
native.stopVoice();
|
||||
@@ -420,15 +473,15 @@
|
||||
resetUI();
|
||||
}
|
||||
|
||||
// ---------- 按住 / 滑动 / 松开 ----------
|
||||
hold.addEventListener('pointerdown', function (e) {
|
||||
// ---------- 按住 / 滑动 / 松开(手机)或点击切换(桌面)----------
|
||||
function onPointerDown(e) {
|
||||
if (e && e.button != null && e.button !== 0) return; // 只响应左键/触摸
|
||||
e.preventDefault();
|
||||
if (phase !== 'idle') return;
|
||||
pressY = e.clientY || 0;
|
||||
try { hold.setPointerCapture(e.pointerId); } catch (_) { /* 忽略 */ }
|
||||
startHold();
|
||||
});
|
||||
}
|
||||
|
||||
function onMove(e) {
|
||||
if (!pressing) return;
|
||||
@@ -459,13 +512,39 @@
|
||||
else if (phase === 'arming') cancelHold(); // 还没真正开录:当误触
|
||||
}
|
||||
|
||||
hold.addEventListener('pointerup', onRelease);
|
||||
hold.addEventListener('pointercancel', onRelease);
|
||||
hold.addEventListener('pointermove', onMove);
|
||||
// 兜底:个别环境下 setPointerCapture 不生效,手指移出按钮后也要跟手
|
||||
window.addEventListener('pointerup', onRelease);
|
||||
window.addEventListener('pointercancel', onRelease);
|
||||
window.addEventListener('pointermove', onMove);
|
||||
if (POINT_FINE) {
|
||||
// 桌面:点一下开始,再点一下发送(pressing 由 startHold 置 true 后一直保持,不会自己松)
|
||||
hold.addEventListener('click', function (e) {
|
||||
e.preventDefault();
|
||||
if (phase === 'idle') startHold();
|
||||
else if (phase === 'recording') finishHold();
|
||||
else if (phase === 'arming') cancelHold(); // 等麦克风授权时再点一下 = 取消
|
||||
});
|
||||
} else {
|
||||
hold.addEventListener('pointerdown', onPointerDown);
|
||||
hold.addEventListener('pointerup', onRelease);
|
||||
hold.addEventListener('pointercancel', onRelease);
|
||||
hold.addEventListener('pointermove', onMove);
|
||||
// 兜底:个别环境下 setPointerCapture 不生效,手指移出按钮后也要跟手
|
||||
window.addEventListener('pointerup', onRelease);
|
||||
window.addEventListener('pointercancel', onRelease);
|
||||
window.addEventListener('pointermove', onMove);
|
||||
}
|
||||
|
||||
// 桌面点击模式:遮罩底部那行「取消 / 发送」的点击绑定
|
||||
if (POINT_FINE) {
|
||||
const sendBtn = $('voice-send');
|
||||
const cancelBtn = $('voice-cancel');
|
||||
if (sendBtn) sendBtn.addEventListener('click', function (e) { e.stopPropagation(); if (phase === 'recording') finishHold(); });
|
||||
if (cancelBtn) cancelBtn.addEventListener('click', function (e) { e.stopPropagation(); cancelHold(); });
|
||||
}
|
||||
|
||||
// 录音中 Esc 取消(两端都可用,桌面端尤其需要一个键盘出口)
|
||||
document.addEventListener('keydown', function (e) {
|
||||
if (e.key !== 'Escape' || phase === 'idle') return;
|
||||
e.preventDefault();
|
||||
cancelHold();
|
||||
});
|
||||
|
||||
// 长按不弹系统菜单(移动端)
|
||||
hold.addEventListener('contextmenu', function (e) { e.preventDefault(); });
|
||||
@@ -535,7 +614,39 @@
|
||||
return out;
|
||||
}
|
||||
|
||||
function clearSeg() { segChunks = []; segLen = 0; silLen = 0; }
|
||||
function clearSeg() { segChunks = []; segLens = []; segDbs = []; segLen = 0; silLen = 0; }
|
||||
|
||||
// 长说不停顿是最慢的路径:没有 0.5s 停顿就一段都发不出去,只能憋到松手整段上传。
|
||||
// 所以累计语音到 VAD_SOFT_CUT_SEC 后,在尾部窗口里挑能量最低的分片边界先切一刀,
|
||||
// 后面的继续累积。真静音切点依然优先(更自然),这里只解决「一直说个没完」。
|
||||
function softCutChunk() {
|
||||
const win = Math.floor(pcmRate * VAD_SOFT_WINDOW_SEC);
|
||||
let from = segChunks.length - 1; // 窗口起点分片下标
|
||||
let acc = 0;
|
||||
for (let i = segChunks.length - 1; i >= 0; i--) {
|
||||
acc += segLens[i];
|
||||
from = i;
|
||||
if (acc >= win) break;
|
||||
}
|
||||
let best = from;
|
||||
for (let i = from + 1; i < segChunks.length; i++) {
|
||||
if (segDbs[i] < segDbs[best]) best = i;
|
||||
}
|
||||
// 切在 best 之前(前 best 片发走);best 为 0 说明没有可切的前缀
|
||||
return best > 0 ? best : -1;
|
||||
}
|
||||
|
||||
// 从段头取走前 k 个分片发出去,剩下的留在缓冲里继续累积
|
||||
function softCut(k) {
|
||||
let n = 0;
|
||||
for (let i = 0; i < k; i++) n += segLens[i];
|
||||
emitSegment(n);
|
||||
segChunks = segChunks.slice(k);
|
||||
segLens = segLens.slice(k);
|
||||
segDbs = segDbs.slice(k);
|
||||
segLen -= n;
|
||||
if (silLen > segLen) silLen = segLen; // 切点落在尾巴的静音里时,静音计数不能超过剩余长度
|
||||
}
|
||||
|
||||
// 把当前段的前 n 个采样作为一段发出去(太短当噪声丢掉)。
|
||||
// 注意:必须在 clearSeg() 之前调,takeSeg 要读 segChunks。
|
||||
@@ -544,19 +655,43 @@
|
||||
emit(encodeWav(takeSeg(n), pcmRate));
|
||||
}
|
||||
|
||||
// 串行上传:一段没回来不发下一段(2 vCPU 上并发只会互相拖慢,而且顺序也没法保证)
|
||||
// 每段切出来就发,不等上一段回来,但同时最多 ASR_MAX_CONCURRENCY 个。
|
||||
// 名额是「谁落定谁交出去」,不按固定顺序等某一段:否则最慢那段会卡住本可以发的后续段。
|
||||
// 并行返回是乱序的,所以结果按「提交时的下标」落位,拼接时仍按说话顺序。
|
||||
function emit(blob) {
|
||||
const my = gen;
|
||||
chain = chain.then(function () {
|
||||
if (my !== gen) return; // 已取消/重录:不再发
|
||||
const idx = segSent++; // 分母:已提交的段数,同时是这一段结果的落位下标
|
||||
const p = acquire().then(function () {
|
||||
if (my !== gen) { release(); return; } // 已取消/重录:名额还回去,别再发
|
||||
return req('POST', '/api/asr/transcribe', blob, true, 120000)
|
||||
.then(function (r) {
|
||||
if (my !== gen) return;
|
||||
const t = String((r && r.text) || '').replace(/\s+/g, ' ').trim();
|
||||
if (t) textParts.push(t);
|
||||
if (t) textParts[idx] = t;
|
||||
})
|
||||
.catch(function () { /* 单段失败不连坐,其余段照常出字 */ });
|
||||
.catch(function () {
|
||||
/* 单段失败不连坐,其余段照常出字;失败也算走完一段,进度才不会停在半路 */
|
||||
})
|
||||
.then(function () {
|
||||
release(); // 不论成败都先腾名额
|
||||
if (my !== gen) return;
|
||||
segDone++;
|
||||
refreshBusyHint();
|
||||
});
|
||||
});
|
||||
inflight.push(p);
|
||||
}
|
||||
|
||||
// 名额:没满直接拿;满了就排队,任一请求落定后把名额交给下一个(不按固定顺序)
|
||||
function acquire() {
|
||||
if (active < ASR_MAX_CONCURRENCY) { active++; return Promise.resolve(); }
|
||||
return new Promise(function (res) { waiting.push(res); });
|
||||
}
|
||||
|
||||
function release() {
|
||||
const next = waiting.shift();
|
||||
if (next) next(); // 名额直接转交,active 不变
|
||||
else active--;
|
||||
}
|
||||
|
||||
// 拼接各段:中文直接相连;两侧都是西文字母/数字时补一个空格,
|
||||
@@ -576,6 +711,7 @@
|
||||
streamOn = false;
|
||||
clearSeg();
|
||||
textParts = [];
|
||||
inflight = [];
|
||||
gen++;
|
||||
if (flushTimer) { clearTimeout(flushTimer); flushTimer = null; }
|
||||
}
|
||||
@@ -595,6 +731,8 @@
|
||||
startLoop();
|
||||
|
||||
segChunks.push(pcm);
|
||||
segLens.push(pcm.length);
|
||||
segDbs.push(db);
|
||||
segLen += pcm.length;
|
||||
// 静音按「整片」判:一片约 20~100ms,足够分辨 0.5s 的停顿(再细也没意义)
|
||||
silLen = db < VAD_SILENCE_DB ? silLen + pcm.length : 0;
|
||||
@@ -608,6 +746,10 @@
|
||||
// 一口气说了 25 秒没停顿:硬切(宁可切开也不能超上游上限)
|
||||
emitSegment(segLen);
|
||||
clearSeg();
|
||||
} else if (segLen >= pcmRate * VAD_SOFT_CUT_SEC) {
|
||||
// 说太久又没停顿:先在能量最低处切一刀(软切),别把整段憋到松手或 25s 硬切
|
||||
const k = softCutChunk();
|
||||
if (k > 0) softCut(k);
|
||||
}
|
||||
}
|
||||
|
||||
@@ -636,7 +778,11 @@
|
||||
resetUI();
|
||||
toast('语音识别超时');
|
||||
}, FLUSH_MS);
|
||||
chain = chain.then(function () {
|
||||
// 并行发之后没有串行链可挂:等本轮全部段落定(含被限流挡着的)再收口。
|
||||
// 逐个兜一层 catch:只要有一个 Promise 意外 reject,Promise.all 就整批失败,
|
||||
// 收口逻辑永远不跑,只能等 60s 超时把已识别的内容全部丢掉。
|
||||
const all = inflight.map(function (p) { return p.catch(function () {}); });
|
||||
Promise.all(all).then(function () {
|
||||
if (my !== gen) return;
|
||||
if (flushTimer) { clearTimeout(flushTimer); flushTimer = null; }
|
||||
const text = joinText(textParts);
|
||||
|
||||
@@ -50,8 +50,12 @@ self.addEventListener('fetch', (event) => {
|
||||
// 只处理同源
|
||||
if (url.origin !== self.location.origin) return;
|
||||
|
||||
// 跳过 API/SSE/预览/交付取件,避免缓存动态数据(预览页需实时;/f/ 同链内容会随重新 save 变化)
|
||||
if (url.pathname.startsWith('/api/') || url.pathname.startsWith('/sse') || url.pathname.startsWith('/preview') || url.pathname.startsWith('/f/')) return;
|
||||
// 跳过 API/SSE/预览/交付取件,避免缓存动态数据(预览页需实时;/f/ 同链内容会随重新 save 变化)。
|
||||
// /p/ 是公网短链(图片/文件直链):内容是二进制、带 TTL 的 bearer 能力,既不能当 HTML 文本重建,
|
||||
// 也不该进缓存。漏掉它时点开图片外链会先被“导航”分支 fetch 两次、再按文本重建,结果是一张坏图,
|
||||
// 日志里表现为每点一次成对出现两条 public-file 取用记录。
|
||||
if (url.pathname.startsWith('/api/') || url.pathname.startsWith('/sse') || url.pathname.startsWith('/preview')
|
||||
|| url.pathname.startsWith('/f/') || url.pathname.startsWith('/p/')) return;
|
||||
|
||||
// vendor 预览页发出的根绝对请求(fetch('/') 自刷新、EventSource('/events') 等,Referer 是预览页):
|
||||
// 内容随文档变化,既不缓存,也不能把 office 文档页写进 '/' 这类 SPA 缓存键。
|
||||
@@ -73,6 +77,9 @@ self.addEventListener('fetch', (event) => {
|
||||
try {
|
||||
const resp = await fetch(request);
|
||||
if (!resp.ok || resp.type !== 'basic') return resp;
|
||||
// 非 HTML 的导航(图片/PDF 等直链):二进制不能按文本重建,原样透传;
|
||||
// 否则 resp.text() 会把像素解成替换字符,页面只剩空白/乱码。
|
||||
if (!/text\/html/i.test(resp.headers.get('content-type') || '')) return resp;
|
||||
last = { txt: await resp.text(), resp };
|
||||
} catch (e) {
|
||||
if (last) break; // 已有残破快照:降级返回它
|
||||
|
||||
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
File diff suppressed because one or more lines are too long
+1
File diff suppressed because one or more lines are too long
+1
File diff suppressed because one or more lines are too long
@@ -19,7 +19,7 @@ function reqHeaders(cfg) {
|
||||
}
|
||||
|
||||
// 执行一条命令。返回 { code, killed_by, out };传输层失败抛 Error(由调用方决定如何呈现)。
|
||||
// opts: { command, cwd?, timeout_ms?, env?, run? }(run = engine 的 {cancelled, procs},可省略)
|
||||
// opts: { command, cwd?, timeout_ms?, env?, run?, onChunk? }(run = engine 的 {cancelled, procs},可省略)
|
||||
async function run(cfg, opts) {
|
||||
const base = cfg.executor.url;
|
||||
const timeoutMs = opts.timeout_ms && opts.timeout_ms > 0 ? opts.timeout_ms : 300000;
|
||||
@@ -73,7 +73,11 @@ async function run(cfg, opts) {
|
||||
let ev;
|
||||
try { ev = JSON.parse(line.slice(6)); } catch (_) { continue; }
|
||||
if (ev.type === 'start') id = ev.id;
|
||||
else if (ev.type === 'out' || ev.type === 'err') out += ev.chunk;
|
||||
else if (ev.type === 'out' || ev.type === 'err') {
|
||||
out += ev.chunk;
|
||||
// 增量回调(UI 实时显示用):失败不影响主流程
|
||||
if (opts.onChunk) { try { opts.onChunk(ev.chunk); } catch (_) {} }
|
||||
}
|
||||
else if (ev.type === 'exit') { exit = ev; break outer; }
|
||||
}
|
||||
}
|
||||
|
||||
@@ -236,7 +236,11 @@ function handleSend(db, opts) {
|
||||
|
||||
// 普通消息:解析当前会话,无绑定自动新建(IM 用户不会先打 /new 才能聊天)。
|
||||
// 微信通道以 binding 行的全局 deep_think 开关作消息的 deepThink 取值(与 H5 按钮 body 同义,
|
||||
// 只是没得点、改用 /think 拨);非 wx 通道照旧不传 opts,行为零变化。
|
||||
// 只是没得点、改用 /think 拨);非 wx 通道照旧不传 deepThink,行为零变化。
|
||||
// 投递走 mode:'interject':IM 用户是在实时对话,回合中插话应当「当前工具跑完就插话」,
|
||||
// 而不是排队等本轮结束。没在跑时 enqueueMessage 等价于立即发送,行为与旧 postUserMessage 一致。
|
||||
// (旧实现直接 postUserMessage → live 追投:user 行可能落在 assistant.tool_calls 与
|
||||
// tool 回执之间,批次配对当场断裂。走队列才能保证只在安全边界写库。)
|
||||
if (!parsed || parsed.normal) {
|
||||
const wx = String(channel).startsWith('wx:');
|
||||
const deepThink = wx ? !!((db.prepare('SELECT deep_think FROM wechat_bindings WHERE id = ?').get(channel.slice(3)) || {}).deep_think) : undefined;
|
||||
@@ -246,10 +250,17 @@ function handleSend(db, opts) {
|
||||
const r = newSessionFor(db, user, channel, text, wx ? { deepThink } : undefined);
|
||||
s = r.s; sent = r.sent;
|
||||
} else {
|
||||
sent = engine.postUserMessage(s.id, text, wx ? { deepThink } : undefined);
|
||||
sent = engine.enqueueMessage(s.id, text, wx ? { deepThink, mode: 'interject' } : { mode: 'interject' });
|
||||
}
|
||||
log.info('msg', tag + ' channel 消息 → ' + s.id);
|
||||
return { kind: 'message', reply: '已发送到会话 ' + s.id, session_id: s.id, message_id: sent.message_id };
|
||||
const queued = !!(sent && sent.queued);
|
||||
log.info('msg', tag + ' channel 消息 → ' + s.id + (queued ? '(已排队,等安全边界投递)' : ''));
|
||||
return {
|
||||
kind: 'message',
|
||||
reply: (queued ? '已排队到会话 ' : '已发送到会话 ') + s.id,
|
||||
session_id: s.id,
|
||||
message_id: sent && sent.message_id,
|
||||
pending_id: sent && sent.pending_id,
|
||||
};
|
||||
}
|
||||
|
||||
if (parsed.unknown) {
|
||||
|
||||
@@ -47,9 +47,19 @@ router.use('/app', (req, res) => {
|
||||
if (!sessionId) return notFound(res, '会话不存在');
|
||||
if (!engine.getSession(sessionId)) return notFound(res, '会话不存在');
|
||||
const appRoot = path.join(engine.taskDirOf(sessionId), '.app');
|
||||
// 页面根目录的地址必须带尾斜杠:浏览器按「最后一段是否目录」算相对链接的基址,
|
||||
// /app/<会话> 会把 ./table.html 解析成 /app/table.html(白屏)。
|
||||
// 空余路径 = 就是在要根目录 → 补斜杠再跳转;比让每个技能模板改绝对链接可靠。
|
||||
// 注意不能靠 stat 判断:下面空余路径会先被映射成 index.html,永远不是目录。
|
||||
const rest = segs.slice(1).join('/');
|
||||
if (!rest && !req.path.endsWith('/')) {
|
||||
const q = req.originalUrl.indexOf('?');
|
||||
return res.redirect(302, (q < 0 ? req.originalUrl : req.originalUrl.slice(0, q)) + '/'
|
||||
+ (q < 0 ? '' : req.originalUrl.slice(q)));
|
||||
}
|
||||
let abs;
|
||||
try {
|
||||
abs = resolveInTask(appRoot, segs.slice(1).join('/') || 'index.html'); // 越界即挡,限 .app/ 子树
|
||||
abs = resolveInTask(appRoot, rest || 'index.html'); // 越界即挡,限 .app/ 子树
|
||||
} catch (_) {
|
||||
return notFound(res, '非法路径');
|
||||
}
|
||||
|
||||
+189
-1
@@ -1,5 +1,6 @@
|
||||
// 文件管理 API:上传 / 列表 / 下载 / 删除
|
||||
// 文件管理 API:上传 / 列表 / 下载 / 预览 / 删除
|
||||
const express = require('express');
|
||||
const crypto = require('crypto');
|
||||
const fs = require('fs');
|
||||
const path = require('path');
|
||||
const multer = require('multer');
|
||||
@@ -8,6 +9,7 @@ const { listTaskFiles } = require('./sessions');
|
||||
const { resolveInTask } = require('../tools/executor');
|
||||
const downloadToken = require('../download-token');
|
||||
const log = require('../log');
|
||||
const git = require('../git');
|
||||
|
||||
const router = express.Router();
|
||||
|
||||
@@ -75,6 +77,96 @@ router.post('/:id/files', upload.array('files', 10), function (req, res) {
|
||||
}
|
||||
});
|
||||
|
||||
// ---------- 会话文件树(桌面端左栏唯一浏览入口) ----------
|
||||
// 为什么不复用 GET /:id/files:那个接口同步递归整棵目录,会话里一旦有大项目 /
|
||||
// node_modules,单线程 core 会被卡死(连 SSE 一起挂)。这里一律「一次一层」、
|
||||
// 忽略大目录、限量返回,客户端展开才请求下一层。
|
||||
const TREE_MAX = 500;
|
||||
|
||||
// 相对路径 → 会话根内的绝对路径。字面 + realpath 双重校验,防符号链接跳出会话目录。
|
||||
function resolveTreeAbs(rootAbs, rel) {
|
||||
const p = String(rel || '').replace(/^[\\/]+/, '');
|
||||
const abs = p ? path.resolve(rootAbs, p) : rootAbs;
|
||||
const inside = (root, x) => x === root || x.startsWith(root + path.sep);
|
||||
if (!inside(rootAbs, abs)) throw new Error('路径越界');
|
||||
let realAbs = abs, realRoot = rootAbs;
|
||||
try { realAbs = fs.realpathSync(abs); } catch (_) {}
|
||||
try { realRoot = fs.realpathSync(rootAbs); } catch (_) {}
|
||||
if (!inside(realRoot, realAbs)) throw new Error('路径越界');
|
||||
return abs;
|
||||
}
|
||||
|
||||
router.get('/:id/tree', function (req, res) {
|
||||
const session = engine.getSession(req.params.id);
|
||||
if (!session) return res.status(404).json({ error: '会话不存在' });
|
||||
const rootAbs = path.resolve(engine.taskDirOf(req.params.id));
|
||||
const rel = String(req.query.dir || '').replace(/^[\\/]+/, '').replace(/\/+$/, '');
|
||||
let abs;
|
||||
try { abs = resolveTreeAbs(rootAbs, rel); }
|
||||
catch (err) { return res.status(400).json({ error: err.message }); }
|
||||
let st;
|
||||
try { st = fs.statSync(abs); } catch (_) { return res.status(404).json({ error: '目录不存在' }); }
|
||||
if (!st.isDirectory()) return res.status(400).json({ error: '不是目录' });
|
||||
const showHidden = req.query.hidden === '1';
|
||||
const entries = [];
|
||||
try {
|
||||
for (const e of fs.readdirSync(abs, { withFileTypes: true })) {
|
||||
if (!showHidden && e.name.startsWith('.')) continue;
|
||||
const childRel = rel ? rel + '/' + e.name : e.name;
|
||||
if (e.isSymbolicLink()) { entries.push({ name: e.name, rel: childRel, type: 'link' }); continue; }
|
||||
if (e.isDirectory()) {
|
||||
// mtimeMs 给前端判断空目录是否还是空的:目录内增删子项会更新它
|
||||
let mtimeMs = null;
|
||||
try { mtimeMs = fs.statSync(path.join(abs, e.name)).mtimeMs; } catch (_) {}
|
||||
entries.push({ name: e.name, rel: childRel, type: 'dir', mtimeMs: mtimeMs });
|
||||
} else if (e.isFile()) {
|
||||
let size = null, mtimeMs = null;
|
||||
try { const st = fs.statSync(path.join(abs, e.name)); size = st.size; mtimeMs = st.mtimeMs; } catch (_) {}
|
||||
entries.push({ name: e.name, rel: childRel, type: 'file', size: size, mtimeMs: mtimeMs });
|
||||
}
|
||||
}
|
||||
} catch (err) {
|
||||
return res.status(500).json({ error: String((err && err.message) || err) });
|
||||
}
|
||||
// 排序:目录在前、文件在后;同类按名称
|
||||
entries.sort((a, b) =>
|
||||
(a.type === 'dir' ? 0 : 1) - (b.type === 'dir' ? 0 : 1) ||
|
||||
(a.name < b.name ? -1 : a.name > b.name ? 1 : 0));
|
||||
res.json({
|
||||
root: rootAbs,
|
||||
dir: rel,
|
||||
total: entries.length,
|
||||
capped: entries.length > TREE_MAX,
|
||||
entries: entries.slice(0, TREE_MAX),
|
||||
});
|
||||
});
|
||||
|
||||
// ---------- Git 面板(只读):提交列表 / 提交详情 ----------
|
||||
// rev=worktree 是「未提交的改动」,与提交详情返回同一副骨架(commit=null),前端共用一个渲染器。
|
||||
// 不是仓库 / 没装 git 不算错误:HTTP 200 + { ok:false, reason },由界面显示空状态。
|
||||
function gitDir(req) { return engine.taskDirOf(req.params.id); }
|
||||
|
||||
router.get('/:id/git/commits', async function (req, res) {
|
||||
const session = engine.getSession(req.params.id);
|
||||
if (!session) return res.status(404).json({ error: '会话不存在' });
|
||||
const limit = Math.min(Math.max(parseInt(req.query.limit, 10) || 30, 1), 100);
|
||||
const before = String(req.query.before || '');
|
||||
// before 只接受完整/短 hash:它会拼进 git 参数,绝不能是任意表达式
|
||||
const out = await git.query(gitDir(req), 'commits', {
|
||||
before: /^[0-9a-f]{7,40}$/i.test(before) ? before : '',
|
||||
limit,
|
||||
});
|
||||
res.json(out);
|
||||
});
|
||||
|
||||
router.get('/:id/git/commit/:rev', async function (req, res) {
|
||||
const session = engine.getSession(req.params.id);
|
||||
if (!session) return res.status(404).json({ error: '会话不存在' });
|
||||
const rev = String(req.params.rev || '');
|
||||
if (rev !== 'worktree' && !/^[0-9a-f]{4,40}$/i.test(rev)) return res.status(400).json({ error: '非法的提交编号' });
|
||||
res.json(await git.query(gitDir(req), 'commit', { rev }));
|
||||
});
|
||||
|
||||
router.get('/:id/files', function (req, res) {
|
||||
try {
|
||||
const session = engine.getSession(req.params.id);
|
||||
@@ -146,6 +238,102 @@ router.get('/:id/files/download', serveDownload);
|
||||
// 供解析不了 Content-Disposition 的下载器兜底;path 参数与验签逻辑完全一致。
|
||||
router.get('/:id/files/download-name/*', serveDownload);
|
||||
|
||||
// ---------- 图片预览派生图(inline,供 <img> 直连;与下载接口的 attachment/no-store 语义分开) ----------
|
||||
// 大图慢的三层原因:整包 fetch 完才渲染、每次都要重下、把原始像素丢给浏览器解码。
|
||||
// 这里按宽度用 sharp 生成 WebP 落盘缓存,前端 <img> 直连即可边下边画;原图只留给“下载”。
|
||||
const PREVIEW_IMG_RE = /\.(png|jpe?g|gif|webp|svg|bmp|avif|ico)$/i;
|
||||
const PREVIEW_WIDTHS = new Set([320, 640, 960, 1280, 1600, 2048]);
|
||||
let sharp = null;
|
||||
try { sharp = require('sharp'); } catch (_) { /* 未安装 sharp 时整条路由降级为原图直出 */ }
|
||||
|
||||
// 预览响应不能带 Content-Disposition: attachment;.imgcache 是点目录,sendFile 需显式放行。
|
||||
function sendInline(res, abs) {
|
||||
res.setHeader('Cache-Control', 'private, max-age=0, must-revalidate');
|
||||
res.sendFile(abs, { cacheControl: false, dotfiles: 'allow', etag: true, lastModified: true });
|
||||
}
|
||||
|
||||
router.get('/:id/files/preview', async function (req, res) {
|
||||
try {
|
||||
const rel = String(req.query.path || '');
|
||||
if (!rel) return res.status(400).json({ error: '缺少 path 参数' });
|
||||
if (!PREVIEW_IMG_RE.test(rel)) return res.status(400).json({ error: '不是图片' });
|
||||
const w = PREVIEW_WIDTHS.has(Number(req.query.w)) ? Number(req.query.w) : 1600;
|
||||
const taskDir = engine.taskDirOf(req.params.id);
|
||||
const abs = resolveInTask(taskDir, rel);
|
||||
const st = fs.statSync(abs);
|
||||
if (!st.isFile()) return res.status(400).json({ error: '不是文件' });
|
||||
|
||||
// SVG 是矢量;GIF 可能在预览里要保留动画;没有 sharp 时只能原图直出。
|
||||
if (/\.svg$/i.test(rel) || /\.gif$/i.test(rel) || !sharp) {
|
||||
return sendInline(res, abs);
|
||||
}
|
||||
|
||||
// 缓存 key 带 size+mtime:文件被 AI 覆盖后自动失效,不需要额外的清理逻辑。
|
||||
const key = crypto.createHash('sha1')
|
||||
.update(rel + '|' + st.size + '|' + st.mtimeMs + '|' + w)
|
||||
.digest('hex');
|
||||
const outDir = path.join(path.resolve(taskDir), '.imgcache', 'preview');
|
||||
const out = path.join(outDir, key + '.webp');
|
||||
if (!fs.existsSync(out)) {
|
||||
// sharp 默认只取动图首帧,直接给原图避免“预览不动了”。metadata 只读文件头,不解码像素。
|
||||
let meta = null;
|
||||
try { meta = await sharp(abs).metadata(); } catch (_) { /* 交给下面原图兜底 */ }
|
||||
if (meta && meta.pages && meta.pages > 1) return sendInline(res, abs);
|
||||
|
||||
// 小文件不一定像素少(高压缩的大尺寸图仍解码很慢):体积与像素都小才直出原图,
|
||||
// 避免“压缩后反而更大”,也避免把 24MP 的 200KB 图原样丢给低端机解码。
|
||||
const px = meta && meta.width && meta.height ? meta.width * meta.height : 0;
|
||||
if (st.size <= 256 * 1024 && (!px || px <= 2 * 1000 * 1000)) return sendInline(res, abs);
|
||||
|
||||
fs.mkdirSync(outDir, { recursive: true });
|
||||
// 随机临时名 + rename:并发请求不会读到半截文件,也不互相覆盖。
|
||||
const tmp = out + '.' + crypto.randomBytes(4).toString('hex') + '.tmp.webp';
|
||||
try {
|
||||
await sharp(abs, { limitInputPixels: 80 * 1000 * 1000 })
|
||||
.rotate()
|
||||
.resize({ width: w, height: w, fit: 'inside', withoutEnlargement: true })
|
||||
.webp({ quality: 85 })
|
||||
.toFile(tmp);
|
||||
fs.renameSync(tmp, out);
|
||||
} catch (err) {
|
||||
try { fs.unlinkSync(tmp); } catch (_) {}
|
||||
return sendInline(res, abs); // 解码失败/格式不支持 → 原图兜底
|
||||
}
|
||||
}
|
||||
sendInline(res, out);
|
||||
} catch (err) {
|
||||
res.status(404).json({ error: '文件不存在' });
|
||||
}
|
||||
});
|
||||
|
||||
// ---------- PDF 预览(inline,供 iframe 直连) ----------
|
||||
// 现有下载接口是 attachment + no-store:前端只能 fetch 整包再转 blob,查看器要等整包下完才出现。
|
||||
// 这里单独给预览一条 inline 路由,保留 sendFile 的 Range 支持,让内建查看器自己按需取字节;
|
||||
// ETag/Last-Modified 让重复打开走 304,不再重下。下载按钮仍走原 /files/download,语义不变。
|
||||
router.get('/:id/files/inline', function (req, res) {
|
||||
try {
|
||||
const rel = String(req.query.path || '');
|
||||
if (!rel) return res.status(400).json({ error: '缺少 path 参数' });
|
||||
if (!/\.pdf$/i.test(rel)) return res.status(400).json({ error: '不是 PDF' });
|
||||
const abs = resolveInTask(engine.taskDirOf(req.params.id), rel);
|
||||
const st = fs.statSync(abs);
|
||||
if (!st.isFile()) return res.status(400).json({ error: '不是文件' });
|
||||
|
||||
res.setHeader('Content-Type', 'application/pdf');
|
||||
res.setHeader('Content-Disposition', 'inline');
|
||||
res.setHeader('Cache-Control', 'private, max-age=0, must-revalidate');
|
||||
res.sendFile(abs, {
|
||||
cacheControl: false,
|
||||
dotfiles: 'allow',
|
||||
etag: true,
|
||||
lastModified: true,
|
||||
acceptRanges: true,
|
||||
});
|
||||
} catch (err) {
|
||||
res.status(404).json({ error: '文件不存在' });
|
||||
}
|
||||
});
|
||||
|
||||
// ---------- 打包下载(选中项含文件夹时,后端把整个选择打成 zip 流式返回) ----------
|
||||
// 纯 Node 实现(STORE 不压缩 + 手拼 zip 结构):任务目录里多是媒体/生成产物,
|
||||
// 压缩收益低;两遍读文件(先算 CRC 再磁盘流发送),内存占用与总大小无关。
|
||||
|
||||
@@ -0,0 +1,168 @@
|
||||
// 本地桌面端(local/ 启动器)专用:唤起系统原生目录选择器。
|
||||
// 只在 AGENT_LOCAL_PICK=1 时挂载(见 server.js),服务器形态根本不加载本文件。
|
||||
//
|
||||
// 为什么必须走后端:浏览器拿不到本机目录的绝对路径(<input webkitdirectory> 只给相对名),
|
||||
// 要真实路径只能调系统对话框。必须 execFile 异步——同步执行会阻塞事件循环,所有会话的 SSE
|
||||
// 都会卡住,直到用户关掉对话框。用户取消不是错误,回 { path: '' };
|
||||
// 其它失败(无对话框、权限被拒、超时)要带原因回给前端,别让用户以为是自己取消了。
|
||||
const express = require('express');
|
||||
const fs = require('fs');
|
||||
const path = require('path');
|
||||
const os = require('os');
|
||||
const { execFile } = require('child_process');
|
||||
const engine = require('../engine');
|
||||
|
||||
const router = express.Router();
|
||||
|
||||
// 这些接口都是弹宿主机的原生对话框 / 开 Finder / 开终端,只有坐在这台机器前才有意义。
|
||||
// 远程访问(经隧道 / 反代 / 局域网)一律当作不存在,返回 404 —— 行为和服务器形态完全一致
|
||||
// (那边 server.js 根本不挂这个路由),前端原有的 catch 就会把入口整条隐藏。
|
||||
// 判断依据:反向代理一定会加 X-Forwarded-* 头(nginx 设的,tunnel client 原样转发),
|
||||
// 本机直连 127.0.0.1:8090 不会有。
|
||||
// 不能看 Host:tunnel client 用 fetch 转发时 Host 是禁止头、会被重写成 127.0.0.1:8090。
|
||||
// 也不能看 X-Forwarded-For 的 IP 值:stream 分流后源地址永远是 127.0.0.1。
|
||||
function isLocalHost(req) {
|
||||
if (req.headers['x-forwarded-for'] || req.headers['x-forwarded-host']
|
||||
|| req.headers['x-real-ip'] || req.headers['x-forwarded-proto']) return false;
|
||||
const host = String(req.headers.host || '').replace(/:\d+$/, '').toLowerCase().replace(/^\[|\]$/g, '');
|
||||
return host === '127.0.0.1' || host === 'localhost' || host === '::1';
|
||||
}
|
||||
|
||||
router.use(function (req, res, next) {
|
||||
if (isLocalHost(req)) return next();
|
||||
res.status(404).json({ error: 'Not Found' });
|
||||
});
|
||||
|
||||
function sendErr(res, err) {
|
||||
const code = (err && err.status_code) || 500;
|
||||
res.status(code).json({ error: String((err && err.message) || err) });
|
||||
}
|
||||
|
||||
// 各平台可用的对话框后端。mac 用 osascript;Linux 依次试 zenity / kdialog。
|
||||
// cancelRe / cancelExit 区分「用户取消」和「真失败」:
|
||||
// osascript 取消时 stderr 是 "User canceled. (-128)",别的报错(如自动化权限被拒)不能当取消;
|
||||
// zenity/kdialog 取消统一退出码 1。
|
||||
const CANDIDATES = process.platform === 'darwin'
|
||||
? [{ cmd: 'osascript', args: ['-e', 'POSIX path of (choose folder with prompt "选择这个会话的工作目录")'], cancelRe: /User canceled|-128/ }]
|
||||
: process.platform === 'linux'
|
||||
? [
|
||||
{ cmd: 'zenity', args: ['--file-selection', '--directory', '--title=选择这个会话的工作目录'], cancelExit: 1 },
|
||||
{ cmd: 'kdialog', args: ['--getexistingdirectory', os.homedir(), '--title', '选择这个会话的工作目录'], cancelExit: 1 },
|
||||
]
|
||||
: [];
|
||||
|
||||
// 跑一个对话框,resolve 出选中的路径(用户取消 → '')。
|
||||
// 超时兜底:对话框可能被用户晾在那儿,这里到点 kill,避免永远挂着一个 child。
|
||||
function runPicker(cand, timeoutMs) {
|
||||
return new Promise((resolve, reject) => {
|
||||
execFile(cand.cmd, cand.args, { timeout: timeoutMs, maxBuffer: 1 << 20 }, (err, stdout, stderr) => {
|
||||
if (!err) return resolve(String(stdout || '').trim());
|
||||
if (err.code === 'ENOENT') return reject(Object.assign(new Error('no-cmd'), { no_cmd: true }));
|
||||
if (err.killed) return reject(Object.assign(new Error('选择目录超时,请重试'), { status_code: 408 }));
|
||||
const msg = String(stderr || '').trim();
|
||||
if (cand.cancelRe && cand.cancelRe.test(msg)) return resolve('');
|
||||
if (cand.cancelExit && err.code === cand.cancelExit) return resolve('');
|
||||
reject(Object.assign(new Error('目录选择器失败:' + (msg || ('退出码 ' + err.code))), { status_code: 500 }));
|
||||
});
|
||||
});
|
||||
}
|
||||
|
||||
async function pickDir() {
|
||||
if (!CANDIDATES.length) {
|
||||
throw Object.assign(new Error('当前系统不支持目录选择(仅支持 macOS / Linux)'), { status_code: 501 });
|
||||
}
|
||||
for (const cand of CANDIDATES) {
|
||||
try {
|
||||
const out = await runPicker(cand, 120000);
|
||||
if (!out) return '';
|
||||
// osascript 的 POSIX path 带尾斜杠,去掉让展示一致;选到根 '/' 时保底保留。
|
||||
return out.replace(/\/+$/, '') || '/';
|
||||
} catch (e) {
|
||||
if (e.no_cmd) continue; // 换下一个后端
|
||||
throw e;
|
||||
}
|
||||
}
|
||||
throw Object.assign(new Error('没有可用的目录选择器(Linux 请安装 zenity 或 kdialog)'), { status_code: 501 });
|
||||
}
|
||||
|
||||
// ---------- 原生文件管理器(仅本机会话目录内) ----------
|
||||
// 文件树的列表接口已上收为通用的 GET /api/sessions/:id/tree(桌面端服务器形态也用),
|
||||
// 这里只剩「在 Finder / 终端中打开」这两个只能开在本机的动作。
|
||||
function isInside(rootAbs, abs) {
|
||||
return abs === rootAbs || abs.startsWith(rootAbs + path.sep);
|
||||
}
|
||||
|
||||
// 会话内相对路径 → 绝对路径,双重越界校验(字面 + realpath,防符号链接跳出)。
|
||||
function resolveInside(sessionId, rel) {
|
||||
const sid = String(sessionId || '').trim();
|
||||
if (!sid) throw Object.assign(new Error('缺少 session'), { status_code: 400 });
|
||||
const session = engine.getSession(sid);
|
||||
if (!session) throw Object.assign(new Error('会话不存在'), { status_code: 404 });
|
||||
const rootAbs = path.resolve(engine.taskDirOf(sid));
|
||||
const p = String(rel || '').replace(/^[\\/]+/, '');
|
||||
const abs = p ? path.resolve(rootAbs, p) : rootAbs;
|
||||
if (!isInside(rootAbs, abs)) throw Object.assign(new Error('路径越界'), { status_code: 400 });
|
||||
let real = abs, rootReal = rootAbs;
|
||||
try { real = fs.realpathSync(abs); } catch (_) {}
|
||||
try { rootReal = fs.realpathSync(rootAbs); } catch (_) {}
|
||||
if (!isInside(rootReal, real)) throw Object.assign(new Error('路径越界'), { status_code: 400 });
|
||||
return { rootAbs: rootAbs, abs: abs };
|
||||
}
|
||||
|
||||
// execFile 异步(同步会阻塞事件循环);open/xdg-open 一般秒回,10s 兜底。
|
||||
function runOpen(cmd, args) {
|
||||
return new Promise((resolve, reject) => {
|
||||
execFile(cmd, args, { timeout: 10000 }, (err) => {
|
||||
if (!err) return resolve();
|
||||
if (err.code === 'ENOENT') return reject(Object.assign(new Error('no-cmd'), { no_cmd: true }));
|
||||
if (err.killed) return reject(Object.assign(new Error('系统调用超时'), { status_code: 504 }));
|
||||
reject(Object.assign(new Error('打开失败:' + (err.message || err.code)), { status_code: 500 }));
|
||||
});
|
||||
});
|
||||
}
|
||||
|
||||
function dirOf(abs) {
|
||||
try { return fs.statSync(abs).isDirectory() ? abs : path.dirname(abs); } catch (_) { return path.dirname(abs); }
|
||||
}
|
||||
|
||||
// 在系统文件管理器里打开:目录→直接打开;文件→定位所在目录(mac 用 open -R 直接选中该文件)。
|
||||
router.post('/reveal', (req, res) => {
|
||||
let target;
|
||||
try { target = resolveInside(req.body && req.body.session, req.body && req.body.path); }
|
||||
catch (err) { return sendErr(res, err); }
|
||||
const abs = target.abs;
|
||||
let isDir = false;
|
||||
try { isDir = fs.statSync(abs).isDirectory(); } catch (_) {}
|
||||
const mac = process.platform === 'darwin';
|
||||
const cmd = mac ? 'open' : 'xdg-open';
|
||||
const args = mac && !isDir ? ['-R', abs] : [isDir ? abs : path.dirname(abs)];
|
||||
runOpen(cmd, args).then(() => res.json({ ok: true })).catch(err => sendErr(res, err));
|
||||
});
|
||||
|
||||
// 在系统终端里打开该目录。mac 用 open -a Terminal;Linux 尽力而为。
|
||||
router.post('/terminal', (req, res) => {
|
||||
let target;
|
||||
try { target = resolveInside(req.body && req.body.session, req.body && req.body.path); }
|
||||
catch (err) { return sendErr(res, err); }
|
||||
const dir = dirOf(target.abs);
|
||||
if (process.platform === 'darwin') {
|
||||
runOpen('open', ['-a', 'Terminal', dir]).then(() => res.json({ ok: true })).catch(err => sendErr(res, err));
|
||||
return;
|
||||
}
|
||||
runOpen('x-terminal-emulator', ['--working-directory=' + dir])
|
||||
.then(() => res.json({ ok: true }))
|
||||
.catch(() => runOpen('gnome-terminal', ['--working-directory=' + dir])
|
||||
.then(() => res.json({ ok: true }))
|
||||
.catch(() => sendErr(res, Object.assign(new Error('没有可用的终端程序'), { status_code: 501 }))));
|
||||
});
|
||||
|
||||
// 能力探测:前端凭这个决定是否显示「工作目录」入口(拿不到就整条隐藏)。
|
||||
router.get('/info', (req, res) => {
|
||||
res.json({ enabled: true, platform: process.platform, workspace_root: engine.getConfig().workspace_root });
|
||||
});
|
||||
|
||||
router.post('/pick-dir', (req, res) => {
|
||||
pickDir().then(p => res.json({ path: p })).catch(err => sendErr(res, err));
|
||||
});
|
||||
|
||||
module.exports = router;
|
||||
@@ -7,6 +7,10 @@
|
||||
// 3. 只吐"签发时已校验过、且落在该会话任务目录内"的文件,这里再用 resolveInTask 复核一次。
|
||||
//
|
||||
// 挂在 auth.middleware **之前**(server.js),所以登录与否都能访问;未命中一律 404,不吐内部信息。
|
||||
//
|
||||
// 响应头按扩展名分两路:图片(png/jpg/webp/gif/.../svg)走 inline + 明确 image/*,
|
||||
// 用户或外部服务点开链接就能直接看图;其余一律 attachment,交给下载器
|
||||
// (安卓封装壳的 DownloadManager 只认 attachment,下载语义不能改)。
|
||||
'use strict';
|
||||
|
||||
const fs = require('fs');
|
||||
@@ -14,7 +18,7 @@ const express = require('express');
|
||||
const engine = require('../engine');
|
||||
const publicFiles = require('../public-files');
|
||||
const { resolveInTask } = require('../tools/executor');
|
||||
const { sendDownload } = require('../download-send');
|
||||
const { sendDownload, sendInlineImage, inlineImageType } = require('../download-send');
|
||||
const log = require('../log');
|
||||
|
||||
const router = express.Router();
|
||||
@@ -31,7 +35,12 @@ router.get('/:id', function (req, res) {
|
||||
return res.status(404).type('text/plain').send('not found\n');
|
||||
}
|
||||
|
||||
log.info('public-file', entry.sessionId + ' 外部取用:' + entry.rel);
|
||||
// 图片单独走 inline:用户点开 /p/<id> 是要看图,不是要下载文件。安卓封装壳 / WebView
|
||||
// 对 Content-Disposition: attachment 一律交系统下载器,图片外链因此“只下载、不打开”。
|
||||
// 其余类型保持原下载语义(PDF/Office 等交给下载器或外部服务自己处理)。
|
||||
const imgType = inlineImageType(abs);
|
||||
log.info('public-file', entry.sessionId + ' 外部取用' + (imgType ? '(图片,inline)' : '(附件)') + ':' + entry.rel);
|
||||
if (imgType) return sendInlineImage(res, abs, imgType);
|
||||
sendDownload(res, abs);
|
||||
});
|
||||
|
||||
|
||||
@@ -84,7 +84,9 @@ router.post('/', wrap((req, res) => {
|
||||
const assistantType = String((req.body && req.body.assistant_type) || 'secretary').trim().slice(0, 32) || 'secretary';
|
||||
// 创建者取认证中间件的 req.user(不信客户端传参);未启用认证时为空串
|
||||
const user = String(req.user || '').trim().slice(0, 64);
|
||||
const session = engine.createSession(title, modelId, assistantType, user);
|
||||
// 手选工作目录(仅本地端前端会传,服务器前端从不带;不传/空串 = 老行为,见 engine.createSession)
|
||||
const workDir = String((req.body && req.body.work_dir) || '').trim();
|
||||
const session = engine.createSession(title, modelId, assistantType, user, workDir);
|
||||
log.info('task', (req.user || '-') + ' 新建任务 ' + session.id + '「' + (session.title || '未命名') + '」model=' + (modelId || '自动') + ' type=' + (session.assistant_type || 'secretary'));
|
||||
res.json(session);
|
||||
}));
|
||||
@@ -196,16 +198,16 @@ router.get('/:id', wrap((req, res) => {
|
||||
}
|
||||
}
|
||||
|
||||
const taskDir = engine.taskDirOf(session.id);
|
||||
// 定时任务状态(scheduler.js / schedule 工具;每会话至多一行,无则 null)。
|
||||
// 列表接口故意不带此字段,避免 N+1;前端进会话详情时才拉。
|
||||
const schedule = db.prepare(
|
||||
'SELECT cron_expr, prompt, next_run_at, last_run_at, last_status, last_note FROM scheduled_tasks WHERE session_id = ?'
|
||||
).get(session.id) || null;
|
||||
// 不再返回 files:文件树由 /api/files 按目录懒加载(routes/files.js),
|
||||
// 这里全量递归扫一遍纯属浪费——曾让每次切会话多传 1.4MB(10544 个文件)。
|
||||
res.json({
|
||||
session,
|
||||
messages,
|
||||
files: listTaskFiles(taskDir),
|
||||
schedule,
|
||||
running: !!(engine.getRun(session.id) || {}).looping,
|
||||
// 待投递队列(刷新/换设备后条幅能原样恢复):只在服务端内存里,重启即空
|
||||
|
||||
@@ -15,7 +15,7 @@ const router = express.Router();
|
||||
const STARTED_AT = Date.now();
|
||||
// 版本以本文件字面量为准:容器部署只挂载 app/server,镜像里的 package.json 可能是旧的,
|
||||
// 读它会一直显示发版时的版本号(之前 2.1.0 改完仍显 2.0.0 即此因)。发版时记得同步这里。
|
||||
const VERSION = '2.4.0';
|
||||
const VERSION = '2.5.0';
|
||||
// git 提交号单独返回(提交时 post-commit 钩子自动生成),前端只显示简洁版本号
|
||||
const VERSION_COMMIT = versionInfo.commit || '';
|
||||
|
||||
|
||||
+35
-4
@@ -13,12 +13,21 @@ const scheduler = require('./scheduler');
|
||||
const wechat = require('./wechat');
|
||||
const llm = require('./llm');
|
||||
const mcp = require('./mcp');
|
||||
const devices = require('./devices');
|
||||
const skills = require('./tools/skills');
|
||||
const log = require('./log');
|
||||
|
||||
const cfg = loadConfig(process.env.AGENT_CONFIG);
|
||||
log.setLevel(cfg.log_level); // 分级日志开关(log.js;config.yml log_level,重启生效)
|
||||
llm.setPayloadTrim(cfg.agent); // 历史重放的重负载占位裁剪阈值(llm.buildMessages;config agent.trim_*)
|
||||
llm.setPayloadTrim(cfg.agent); // 历史重放的重负载占位裁剪规则(llm.buildMessages;config agent.trim.rules)
|
||||
// system prompt 的「环境段」:executor.url 为空 = 命令在本机 spawn(本地桌面形态,无沙箱),
|
||||
// 有值 = 送进 agent-executor 容器(每会话隔离)。用这个信号而不是另立开关,因为它就是
|
||||
// 隔离与否的成因(resolveInTask 的 /tmp 重写、WIDE_SCOPE 同理)。启动日志跟一行,方便核对。
|
||||
llm.setEnvMode(cfg.executor.url ? 'server' : 'local');
|
||||
log.info('startup', '环境形态:' + (cfg.executor.url ? 'server(executor 容器隔离)' : 'local(本机 spawn,无沙箱)'));
|
||||
// 启动时把生效规则打出来:工具名拼错不会报错(MCP 工具要等发现后才存在),只能靠这行核对。
|
||||
log.info('startup', '历史重放占位裁剪:' + (((cfg.agent && cfg.agent.trim && cfg.agent.trim.rules) || [])
|
||||
.map(r => r.tool + '/' + r.side + '(轮≥' + r.rounds + ',回合≥' + r.turns + ')').join(', ') || '关闭'));
|
||||
const db = initDb(cfg.db_path);
|
||||
const bus = createBus();
|
||||
|
||||
@@ -40,6 +49,11 @@ wechat.init(cfg, db, bus);
|
||||
const app = express();
|
||||
const server = http.createServer(app);
|
||||
|
||||
// 设备接入(devices.js):设备主动出站连 wss://<公网前缀>/dev/ws。
|
||||
// 只在「有公网前缀 + 配了 DEVICE_TOKEN」时真正挂升级处理器,本地部署静默跳过。
|
||||
devices.init(cfg);
|
||||
devices.attach(server);
|
||||
|
||||
// wxbot 内网回调(/wxhook/inbox|hook):凭共享服务 token(Bearer)把门,微信用户永远不该直接碰
|
||||
// 这两个端点(wxbot 只挂内网)。必须挂在全局 express.json(2mb) 之前:媒体 base64 转发体远超 2mb,
|
||||
// 由 hookRouter 自带的 32mb 解析器先读掉并置 req._body,下游全局 json 解析器自动跳过(同 executor 不冲突)。
|
||||
@@ -64,6 +78,12 @@ require('./routes/preview-proxy').earlyGuard(app);
|
||||
|
||||
app.use(express.static(path.join(__dirname, 'public')));
|
||||
|
||||
// 本地桌面端(local/ 启动器)专用:原生目录选择器。AGENT_LOCAL_PICK=1 才挂,
|
||||
// 服务器形态零影响(不加载 routes/local.js,/api/local/* 一律 404)。
|
||||
if (String(process.env.AGENT_LOCAL_PICK || '') === '1') {
|
||||
app.use('/api/local', require('./routes/local'));
|
||||
}
|
||||
|
||||
app.use('/api/sessions', require('./routes/sessions'));
|
||||
app.use('/api/sessions', require('./routes/messages'));
|
||||
app.use('/api/sessions', require('./routes/files'));
|
||||
@@ -165,7 +185,16 @@ app.get('/api/health', (req, res) => {
|
||||
});
|
||||
});
|
||||
|
||||
// 统一错误出口:**必须最后挂**(Express 按注册顺序挑错误中间件,挂在路由前等于没挂)。
|
||||
// 没有它,任何路由漏出的异常(最典型:res.sendFile 的异步失败)都会落到 Express 默认
|
||||
// 处理器,在非 production 环境下把 err.stack 拼成 HTML 吐给请求方,泄露服务端绝对路径、
|
||||
// 源码行号与依赖版本——/p/<id> 是匿名可达端点,这份栈等于公开。详见 error-handler.js。
|
||||
app.use(require('./error-handler').errorHandler);
|
||||
|
||||
const PORT = process.env.PORT || cfg.port;
|
||||
// 监听地址:不设 = 0.0.0.0(容器/服务器形态,宿主机端口映射靠它)。
|
||||
// 本机 local 模式由 local/start.sh 注入 HOST=127.0.0.1:单机自用不该让同一局域网的人直接访问。
|
||||
const HOST = String(process.env.HOST || '').trim();
|
||||
|
||||
// 启动成功后把模型实际收到的各部分 dump 到文件方便人工核对(data_root 默认 ./data,
|
||||
// 宿主机对应 <repo>/data/prompt.txt,已被 gitignore)。包含:
|
||||
@@ -208,8 +237,8 @@ mcp.init(cfg).then(async () => {
|
||||
} catch (e) {
|
||||
log.warn('startup', '技能列表生成失败:' + e.message);
|
||||
}
|
||||
server.listen(PORT, () => {
|
||||
log.info('startup', 'Agent server listening on ' + PORT);
|
||||
const onListening = () => {
|
||||
log.info('startup', 'Agent server listening on ' + (HOST ? HOST + ':' : '') + PORT);
|
||||
log.info('startup', ' public_link=' + ((cfg.public_link || {}).base_url || '未配置(mint_public_link 不可用)'));
|
||||
log.info('startup', ' workspace_root=' + cfg.workspace_root);
|
||||
log.info('startup', ' data_root=' + cfg.data_root);
|
||||
@@ -228,7 +257,9 @@ mcp.init(cfg).then(async () => {
|
||||
} catch (e) {
|
||||
log.warn('startup', 'prompt dump 失败:' + e.message);
|
||||
}
|
||||
});
|
||||
};
|
||||
if (HOST) server.listen(PORT, HOST, onListening);
|
||||
else server.listen(PORT, onListening);
|
||||
});
|
||||
|
||||
// 优雅退出(照抄 executor/server.js 的 shutdown 形态):node 在容器里是 PID 1,
|
||||
|
||||
+43
-3
@@ -5,6 +5,31 @@ function createBus() {
|
||||
const clients = new Map(); // session_id -> Set<res>
|
||||
const internal = new Set(); // fn(sessionId, event, data)
|
||||
|
||||
// 高频事件的合并缓冲:LLM 每吐一个 token 就是一条 assistant_delta,一次 res.write 就是一个
|
||||
// TCP 包(Node 默认 TCP_NODELAY)。手机热点 / 跨境链路上包数比字节数更伤——每包都要射频调度,
|
||||
// 拥塞窗口也容易被小包拖住。摍 50ms 或 8 条合并成一次 write。
|
||||
// 其他事件立即发,但发前先 flush,保证前端看到的顺序和产生顺序一致。
|
||||
const MERGE_EVENTS = new Set(['assistant_delta', 'reasoning_delta', 'tool_call_args']);
|
||||
const FLUSH_MS = 50;
|
||||
const FLUSH_COUNT = 8;
|
||||
const pending = new Map(); // session_id -> { parts: string[], timer }
|
||||
|
||||
function writeAll(sessionId, payload) {
|
||||
const set = clients.get(sessionId);
|
||||
if (!set || set.size === 0) return;
|
||||
for (const res of Array.from(set)) {
|
||||
try { res.write(payload); } catch (_) { removeClient(sessionId, res); }
|
||||
}
|
||||
}
|
||||
|
||||
function flush(sessionId) {
|
||||
const p = pending.get(sessionId);
|
||||
if (!p) return;
|
||||
pending.delete(sessionId);
|
||||
if (p.timer) { clearTimeout(p.timer); p.timer = null; }
|
||||
if (p.parts.length) writeAll(sessionId, p.parts.join(''));
|
||||
}
|
||||
|
||||
function onInternal(fn) {
|
||||
internal.add(fn);
|
||||
return () => internal.delete(fn);
|
||||
@@ -19,7 +44,10 @@ function createBus() {
|
||||
const set = clients.get(sessionId);
|
||||
if (!set) return;
|
||||
set.delete(res);
|
||||
if (set.size === 0) clients.delete(sessionId);
|
||||
if (set.size === 0) {
|
||||
clients.delete(sessionId);
|
||||
flush(sessionId); // 没人看了,把还摍着的清掉,避免 pending 常驻
|
||||
}
|
||||
}
|
||||
|
||||
// event 名称 + 任意 JSON data。无客户端时静默丢弃(消息本身已持久化,重连可回放)。
|
||||
@@ -32,13 +60,25 @@ function createBus() {
|
||||
}
|
||||
const set = clients.get(sessionId);
|
||||
if (!set || set.size === 0) return;
|
||||
|
||||
const payload = 'event: ' + event + '\ndata: ' + JSON.stringify(data) + '\n\n';
|
||||
for (const res of Array.from(set)) {
|
||||
try { res.write(payload); } catch (_) { removeClient(sessionId, res); }
|
||||
|
||||
if (MERGE_EVENTS.has(event)) {
|
||||
let p = pending.get(sessionId);
|
||||
if (!p) { p = { parts: [], timer: null }; pending.set(sessionId, p); }
|
||||
p.parts.push(payload);
|
||||
if (p.parts.length >= FLUSH_COUNT) { flush(sessionId); return; }
|
||||
if (!p.timer) p.timer = setTimeout(() => flush(sessionId), FLUSH_MS);
|
||||
return;
|
||||
}
|
||||
|
||||
// 非合并事件:先把摍着的发掉,保证顺序不乱
|
||||
flush(sessionId);
|
||||
writeAll(sessionId, payload);
|
||||
}
|
||||
|
||||
function closeAll(sessionId) {
|
||||
flush(sessionId);
|
||||
const set = clients.get(sessionId);
|
||||
if (!set) return;
|
||||
for (const res of Array.from(set)) {
|
||||
|
||||
@@ -0,0 +1,11 @@
|
||||
- You run on the user's own machine with their permissions, not a sandbox; other
|
||||
conversations share it and `/tmp` is the system temp dir. Work inside the
|
||||
working directory; treat everything outside it as the user's.
|
||||
- `python3` may be missing. Install what a task needs; Python packages go into
|
||||
`$AGENT_SKILLS_DEPS`. If a skill fails, cat its own `AGENTS.md`
|
||||
(`"$(dirname "$AGENT_SKILLS_DEPS")/<skill>/AGENTS.md"`) and follow it.
|
||||
- Installs and big downloads stay silent until they end. Run them in the background
|
||||
with output to a log file and poll that file every ~10s, instead of one long timeout.
|
||||
- Slow or failing installs and downloads: switch mirrors instead of retrying — pip
|
||||
`-i https://pypi.tuna.tsinghua.edu.cn/simple`, npm `--registry=https://registry.npmmirror.com`,
|
||||
GitHub URLs prefixed with `https://gh-proxy.com/`, Homebrew mirrors or let the user install.
|
||||
@@ -0,0 +1,16 @@
|
||||
- Linux container, isolated per conversation: you see the working directory, a
|
||||
session-scoped `/tmp`, read-only `/workspace/skills`, and system paths — never
|
||||
other sessions.
|
||||
- `terminal` runs POSIX sh (`/bin/sh` is dash); use `bash` for scripts.
|
||||
- `/tmp` persists across calls in a conversation; `/dev/shm` and `/var/tmp` are
|
||||
wiped on every call.
|
||||
- Python 3.11; system packages are read-only. Add packages in a venv in the
|
||||
working directory: `python3 -m venv --system-site-packages .venv`, then
|
||||
`.venv/bin/pip` / `.venv/bin/python`. Don't reinstall packages that are
|
||||
already importable.
|
||||
- System packages can't be installed at runtime (`apt-get` fails). A missing CLI
|
||||
tool must be added on the server — tell the user.
|
||||
- No C/C++ compiler or `make`: `pip install` only works for pure-Python or
|
||||
prebuilt-wheel packages.
|
||||
- Chinese text in matplotlib: set `font.sans-serif` to `Noto Sans CJK SC`. For
|
||||
ZIPs with GBK filenames, use `unar` or `7z x` to avoid garbled names.
|
||||
@@ -56,19 +56,4 @@ domain must never be hand-rolled.
|
||||
|
||||
## Environment
|
||||
|
||||
- Linux container, isolated per conversation: you see the working directory, a
|
||||
session-scoped `/tmp`, read-only `/workspace/skills`, and system paths — never
|
||||
other sessions.
|
||||
- `terminal` runs POSIX sh (`/bin/sh` is dash); use `bash` for scripts.
|
||||
- `/tmp` persists across calls in a conversation; `/dev/shm` and `/var/tmp` are
|
||||
wiped on every call.
|
||||
- Python 3.11; system packages are read-only. Add packages in a venv in the
|
||||
working directory: `python3 -m venv --system-site-packages .venv`, then
|
||||
`.venv/bin/pip` / `.venv/bin/python`. Don't reinstall packages that are
|
||||
already importable.
|
||||
- System packages can't be installed at runtime (`apt-get` fails). A missing CLI
|
||||
tool must be added on the server — tell the user.
|
||||
- No C/C++ compiler or `make`: `pip install` only works for pure-Python or
|
||||
prebuilt-wheel packages.
|
||||
- Chinese text in matplotlib: set `font.sans-serif` to `Noto Sans CJK SC`. For
|
||||
ZIPs with GBK filenames, use `unar` or `7z x` to avoid garbled names.
|
||||
{APP_ENV_SECTION}
|
||||
|
||||
@@ -198,23 +198,6 @@
|
||||
}
|
||||
}
|
||||
},
|
||||
{
|
||||
"type": "function",
|
||||
"function": {
|
||||
"name": "profile",
|
||||
"description": "Maintain the current user's profile — stable facts that persist across conversations and get injected into the context of NEW sessions (the current session's injected copy is frozen). Ops: list (read the live profile), set (honorific or industry, single short value), add (append preference tags), remove (delete exact preference tags). Rules: only record what the user has clearly stated or asked to be remembered (form of address, domain, stable output/work preferences); never guess personality, never store one-time task parameters; brief tags beat essays. Preference is a 、-separated tag list (each tag ≤15 chars, ≤24 tags, ≤300 chars total; overflow is rejected — consolidate or remove first). When unsure what is already recorded, op=list returns live state — trust it over memory.",
|
||||
"parameters": {
|
||||
"type": "object",
|
||||
"required": ["op"],
|
||||
"properties": {
|
||||
"op": { "type": "string", "enum": ["list", "set", "add", "remove"], "description": "list = read live profile; set = single-value honorific/industry; add/remove = preference tags." },
|
||||
"honorific": { "type": "string", "description": "op=set: how to address the user (≤20 chars, e.g. 王工). Pass empty string to clear. Exactly one of honorific/industry per call." },
|
||||
"industry": { "type": "string", "description": "op=set: the user's industry/domain (≤20 chars, e.g. 金融). Pass empty string to clear." },
|
||||
"tags": { "type": "array", "items": { "type": "string" }, "description": "op=add/remove: preference tag list, e.g. [\"偏好简洁回复\", \"图表中文标注\"]. Matching is exact text." }
|
||||
}
|
||||
}
|
||||
}
|
||||
},
|
||||
{
|
||||
"type": "function",
|
||||
"function": {
|
||||
@@ -340,11 +323,17 @@
|
||||
"description": "Run or inspect the skills installed on this server. Each skill describes its purpose and input_schema.\n\n{\"op\":\"list\"} list every skill with a one-line description\n{\"op\":\"get\",\"name\":\"<skill>\"} return the skill's full details; call it before the first run\n{\"op\":\"run\",\"name\":\"<skill>\",\"args\":{...}} execute it; args follow its input_schema\n\nop is required. op=get and op=run require name. Put skill arguments inside args, never at the top level.",
|
||||
"parameters": {
|
||||
"type": "object",
|
||||
"required": ["op"],
|
||||
"required": [
|
||||
"op"
|
||||
],
|
||||
"properties": {
|
||||
"op": {
|
||||
"type": "string",
|
||||
"enum": ["list", "get", "run"],
|
||||
"enum": [
|
||||
"list",
|
||||
"get",
|
||||
"run"
|
||||
],
|
||||
"description": "Operation to perform on skills."
|
||||
},
|
||||
"name": {
|
||||
@@ -403,6 +392,56 @@
|
||||
}
|
||||
}
|
||||
},
|
||||
{
|
||||
"type": "function",
|
||||
"function": {
|
||||
"name": "device",
|
||||
"description": "Operate the remote devices (other machines) connected to this server. Devices dial out to this server, so they need no inbound port; they stay connected until closed.\n\n- action=list: no other params. Returns every online device with os/arch/shell/root. Always call this first when you don't know device names.\n- action=health: requires device. Returns host uptime, load, memory, disk and temperature (fields the platform can't provide are -1).\n- action=exec: requires device and command. Runs the command through a shell on that device (sh -c on Unix, cmd /c on Windows) and returns stdout, stderr and the exit code. `cwd` must be inside that device's work root; omit it to use the root.\n\n- action=pull: requires device and remote_path; copies a file from the device into the session directory so read_file / skills can use it.\n- action=push: requires device, local_path and remote_path; sends a session file to the device.\n\nUse it when the work has to happen on the user's own machine (laptop, box, Windows PC). For the machine running this server use `terminal` instead. If a device is offline, say so explicitly — do not silently run the command elsewhere.",
|
||||
"parameters": {
|
||||
"type": "object",
|
||||
"required": [
|
||||
"action"
|
||||
],
|
||||
"properties": {
|
||||
"action": {
|
||||
"type": "string",
|
||||
"enum": [
|
||||
"list",
|
||||
"health",
|
||||
"exec",
|
||||
"pull",
|
||||
"push"
|
||||
],
|
||||
"description": "Operation to perform."
|
||||
},
|
||||
"device": {
|
||||
"type": "string",
|
||||
"description": "Device name from action=list."
|
||||
},
|
||||
"command": {
|
||||
"type": "string",
|
||||
"description": "Shell command line (action=exec). Avoid interactive commands."
|
||||
},
|
||||
"cwd": {
|
||||
"type": "string",
|
||||
"description": "Working directory on the device; must be inside its work root (action=exec)."
|
||||
},
|
||||
"timeout_ms": {
|
||||
"type": "integer",
|
||||
"description": "Default 120000, max 600000 (action=exec)."
|
||||
},
|
||||
"remote_path": {
|
||||
"type": "string",
|
||||
"description": "设备上的绝对路径,必须在设备工作根内(pull/push)。"
|
||||
},
|
||||
"local_path": {
|
||||
"type": "string",
|
||||
"description": "会话目录内的相对路径。pull 省略则用远端文件名;push 必填(源文件)。"
|
||||
}
|
||||
}
|
||||
}
|
||||
}
|
||||
},
|
||||
{
|
||||
"type": "function",
|
||||
"function": {
|
||||
|
||||
+207
-66
@@ -11,38 +11,74 @@ const skills = require('./skills');
|
||||
const Database = require('better-sqlite3'); // db 工具:会话目录下的 data.db(同步 API,与单进程模型契合)
|
||||
const TurndownService = require('turndown'); // fetch 工具:HTML→Markdown 用真解析器(内置 htmlparser2,容错截断/畸形文档)
|
||||
const rexec = require('../remote-exec');
|
||||
const devices = require('../devices'); // device 工具:远端执行节点(设备主动出站连 core,见 devices.js)
|
||||
const log = require('../log'); // device 工具调用日志(info 记动作+设备+耗时+命令截断)
|
||||
const publicFiles = require('../public-files');
|
||||
const scheduler = require('../scheduler'); // 只依赖 log/cron-parser/time.js,不成环(engine→executor→scheduler 单向)
|
||||
const profile = require('../user-profile'); // profile 工具的数据面(仅 llm/log 依赖,无环)
|
||||
const memory = require('../memory'); // recall 工具的数据面(日记翻阅;仅依赖 time.js,无环)
|
||||
// lab 的 help 伪工具要读全量定义:与 engine 同路径 require → node 缓存同一对象,单一事实源。
|
||||
const BUILTIN_TOOL_DEFS = require('./definitions.json');
|
||||
|
||||
// ---------- 路径沙箱 ----------
|
||||
function resolveInTask(taskDir, p) {
|
||||
// 文件工具的可见范围(AGENT_FILE_SCOPE,默认 session):
|
||||
// session = 锁在会话目录。与 executor 容器里的物理视图一致,是服务器形态。
|
||||
// workspace= 放宽到 workspace_root。本地桌面端形态(不起 executor、单机单用户):
|
||||
// AI 要能操作你指定的整个工作目录,而不是它的一个子目录。
|
||||
// 纯 env 接线与 EXECUTOR_URL/ASR_URL 同类:这是部署形态,不是平台配置。
|
||||
const WIDE_SCOPE = String(process.env.AGENT_FILE_SCOPE || '').trim().toLowerCase() === 'workspace';
|
||||
|
||||
function resolveInTask(taskDir, p, rootDir) {
|
||||
if (typeof p !== 'string' || !p.trim()) throw new Error('路径不能为空');
|
||||
const taskRoot = path.resolve(taskDir);
|
||||
let abs;
|
||||
if (path.isAbsolute(p)) {
|
||||
abs = path.normalize(p);
|
||||
// /tmp → <taskDir>/.tmp:与 executor 容器的 bind 对齐(容器内 /tmp 即会话 .tmp,
|
||||
// terminal 写 /tmp/x,core 侧实体在 <taskDir>/.tmp/x)。先 normalize 再重写,
|
||||
// 重写后仍走下方越界校验,无穿越风险。
|
||||
if (abs === '/tmp') abs = path.join(path.resolve(taskDir), '.tmp');
|
||||
else if (abs.startsWith('/tmp/')) abs = path.join(path.resolve(taskDir), '.tmp', abs.slice(5));
|
||||
// workspace 形态【不重写】:本地 terminal 是真 spawn,写的就是本机 /tmp,
|
||||
// 两边必须指向同一处——否则 AI 自己刚写到 /tmp 的文件,自己 read_file 读不到。
|
||||
if (!WIDE_SCOPE) {
|
||||
if (abs === '/tmp') abs = path.join(taskRoot, '.tmp');
|
||||
else if (abs.startsWith('/tmp/')) abs = path.join(taskRoot, '.tmp', abs.slice(5));
|
||||
}
|
||||
} else {
|
||||
abs = path.resolve(taskDir, p);
|
||||
// 相对路径永远相对会话目录(AI 的 cwd 就在那里),不随 rootDir 漂移。
|
||||
abs = path.resolve(taskRoot, p);
|
||||
}
|
||||
const root = path.resolve(taskDir);
|
||||
if (abs !== root && !abs.startsWith(root + path.sep)) {
|
||||
throw new Error('路径越界(只允许任务目录内操作):' + p);
|
||||
const root = path.resolve(rootDir || taskRoot);
|
||||
const inRoot = abs === root || abs.startsWith(root + path.sep);
|
||||
// workspace 形态额外放行本机 /tmp:AI 与 terminal 共用的临时区。
|
||||
const inTmp = WIDE_SCOPE && (abs === '/tmp' || abs.startsWith('/tmp/'));
|
||||
if (!inRoot && !inTmp) {
|
||||
throw new Error((rootDir ? '路径越界(只允许工作目录内操作):' : '路径越界(只允许任务目录内操作):') + p);
|
||||
}
|
||||
return abs;
|
||||
}
|
||||
|
||||
// 工具层允许的根:session 形态 = 会话目录;workspace 形态 = workspace_root。
|
||||
// 只给「业务工具」用;路由层(文件 API/公网短链/data-page)与 @历史会话仍按会话目录校验。
|
||||
function fsRoot(ctx) {
|
||||
// 手选工作目录的会话:AI 的一切文件操作都在这个真实目录里(本地端,不建 task-* 子目录)。
|
||||
// 优先于 WIDE_SCOPE 的 workspace_root 兜底。
|
||||
if (ctx.workDir) return ctx.workDir;
|
||||
if (!WIDE_SCOPE) return ctx.taskDir;
|
||||
return (ctx.cfg && ctx.cfg.workspace_root) || ctx.taskDir;
|
||||
}
|
||||
|
||||
function relOf(taskDir, abs) {
|
||||
return path.relative(path.resolve(taskDir), abs) || '.';
|
||||
}
|
||||
|
||||
// 展示用路径:会话目录内保持相对(跟以前一致,省 token);
|
||||
// 宽根模式下文件可能在会话目录外,那就回绝对路径——否则模型看到的是
|
||||
// ../../../../tmp/x 这种既难读、又容易被它当成会话内路径去二次拼接的名字。
|
||||
function dispPath(ctx, abs) {
|
||||
const rel = relOf(ctx.taskDir, abs);
|
||||
if (rel === '..' || rel.startsWith('..' + path.sep)) return abs;
|
||||
return rel;
|
||||
}
|
||||
|
||||
// ---------- 跨会话路径:@<会话id>/<rel>(历史只读,「看一眼」可过墙,「字节落地」只走 copy_path) ----------
|
||||
// 背景:terminal 在远端 executor 容器里跑(compose:wrapper 启动即 unmount host-tasks),
|
||||
// 别的会话目录在 shell 物理视图里根本不存在;core 进程内的文件工具又被 resolveInTask
|
||||
@@ -58,13 +94,15 @@ function resolvePastPath(ctx, p) {
|
||||
const sid = m[1];
|
||||
const rel = m[2] || '.';
|
||||
if (!/^task-[0-9A-Za-z_\-]+$/.test(sid)) throw new Error('@ 后需会话 id, 形如 task-YYYYMMDD-NNN: ' + sid);
|
||||
const s = ctx.db.prepare('SELECT id, user, title FROM sessions WHERE id = ?').get(sid);
|
||||
const s = ctx.db.prepare('SELECT id, user, title, work_dir FROM sessions WHERE id = ?').get(sid);
|
||||
if (!s) throw new Error('会话不存在: ' + sid);
|
||||
const me = ctx.db.prepare('SELECT user FROM sessions WHERE id = ?').get(ctx.sessionId);
|
||||
if (String(s.user || '') !== String((me && me.user) || '')) throw new Error('无权访问该会话: ' + sid);
|
||||
// 目标会话若手选了工作目录,@<会话> 也必须指向那个真实目录,而不是 workspace_root/<id>。
|
||||
const wd = String(s.work_dir || '');
|
||||
const root = String((ctx.cfg && ctx.cfg.workspace_root) || '');
|
||||
if (!root) throw new Error('workspace_root 未配置');
|
||||
const dir = path.join(root, sid);
|
||||
const dir = wd || (root ? path.join(root, sid) : '');
|
||||
if (!dir) throw new Error('workspace_root 未配置');
|
||||
return { sid: sid, title: s.title || sid, dir: dir, abs: resolveInTask(dir, rel) };
|
||||
}
|
||||
|
||||
@@ -284,7 +322,7 @@ async function toolReadFile(ctx, args) {
|
||||
const inner = relOf(past.dir, abs);
|
||||
disp = inner === '.' ? '@' + past.sid : '@' + past.sid + '/' + inner;
|
||||
} else {
|
||||
abs = resolveInTask(ctx.taskDir, args.path);
|
||||
abs = resolveInTask(ctx.taskDir, args.path, fsRoot(ctx));
|
||||
// 本会话沿用绝对路径做展示(大纲/首 1KB 头,历史行为不变);历史会话只暴露 @<sid>/<rel> 形,
|
||||
// 不把别的会话的 workspace_root 绝对路径喂进上下文。
|
||||
disp = abs;
|
||||
@@ -370,7 +408,7 @@ async function toolListDirectory(ctx, args) {
|
||||
const inner = relOf(past.dir, abs);
|
||||
prefix = '@' + past.sid + (inner === '.' ? '/' : '/' + inner + '/');
|
||||
} else {
|
||||
abs = resolveInTask(ctx.taskDir, p || '.');
|
||||
abs = resolveInTask(ctx.taskDir, p || '.', fsRoot(ctx));
|
||||
const inner = relOf(ctx.taskDir, abs);
|
||||
prefix = inner === '.' ? '' : inner + '/';
|
||||
}
|
||||
@@ -408,14 +446,15 @@ async function toolCopyPath(ctx, args) {
|
||||
const dp = String(args.destination_path || '').trim();
|
||||
if (!sp || !dp) throw new Error('source_path 与 destination_path 都必填');
|
||||
if (dp.startsWith('@')) throw new Error('destination_path 不支持 @ (历史只读)');
|
||||
const dst = resolveInTask(ctx.taskDir, dp);
|
||||
if (path.resolve(dst) === path.resolve(ctx.taskDir)) throw new Error('destination_path 不能是任务目录本身');
|
||||
const root = fsRoot(ctx);
|
||||
const dst = resolveInTask(ctx.taskDir, dp, root);
|
||||
if (path.resolve(dst) === path.resolve(root)) throw new Error('destination_path 不能是任务目录本身');
|
||||
let src;
|
||||
if (sp.startsWith('@')) {
|
||||
const past = resolvePastPath(ctx, sp);
|
||||
src = past.abs;
|
||||
} else {
|
||||
src = resolveInTask(ctx.taskDir, sp);
|
||||
src = resolveInTask(ctx.taskDir, sp, root);
|
||||
}
|
||||
if (path.resolve(src) === path.resolve(dst)) throw new Error('源与目标相同');
|
||||
let lst;
|
||||
@@ -435,17 +474,17 @@ async function toolCopyPath(ctx, args) {
|
||||
}
|
||||
let exists = true;
|
||||
try { await fsp.stat(dst); } catch (_) { exists = false; }
|
||||
if (exists) throw new Error('目标已存在, 拒绝覆盖: ' + relOf(ctx.taskDir, dst));
|
||||
if (exists) throw new Error('目标已存在, 拒绝覆盖: ' + dispPath(ctx, dst));
|
||||
await fsp.mkdir(path.dirname(dst), { recursive: true });
|
||||
await fsp.cp(src, dst, { recursive: true });
|
||||
recordFile(ctx, dst); // 文件表只记普通文件(目录自然跳过),供前端/微信附件展示
|
||||
const sizeNote = budget ? ' (' + budget.files + ' files, ' + Math.round(budget.bytes / 1024) + ' KB)' : '';
|
||||
return '已复制 ' + sp + ' -> ' + relOf(ctx.taskDir, dst) + sizeNote;
|
||||
return '已复制 ' + sp + ' -> ' + dispPath(ctx, dst) + sizeNote;
|
||||
}
|
||||
|
||||
async function toolWriteFile(ctx, args) {
|
||||
if (String(args.path || '').trim().startsWith('@')) throw new Error('write_file 不支持 @ 路径(历史只读;要改旧成果先 copy_path 导入本会话)');
|
||||
const abs = resolveInTask(ctx.taskDir, args.path);
|
||||
const abs = resolveInTask(ctx.taskDir, args.path, fsRoot(ctx));
|
||||
// 纵深防御:引擎 checkToolArgs 已把 null 判缺,但直调 executor(测试等)不经过它;
|
||||
// 旧版 `?? ''` 会把 null 洗成空串静默清空已有文件,这里显式拒绝。
|
||||
if (args.content == null) throw new Error('write_file 缺少参数 content(写空文件请显式传空字符串 "")');
|
||||
@@ -456,7 +495,7 @@ async function toolWriteFile(ctx, args) {
|
||||
await fsp.writeFile(abs, String(args.content), 'utf8');
|
||||
recordFile(ctx, abs);
|
||||
const nbytes = Buffer.byteLength(String(args.content), 'utf8');
|
||||
const rel = relOf(ctx.taskDir, abs);
|
||||
const rel = dispPath(ctx, abs);
|
||||
// 区分新建/覆盖:「原 M 字节」是给模型的止损信号(盲覆盖大文件时能立刻察觉)。
|
||||
return st
|
||||
? '已覆盖文件 ' + rel + '(' + nbytes + ' 字节,原 ' + st.size + ' 字节)'
|
||||
@@ -686,7 +725,7 @@ function applyEdit(text, edit, i) {
|
||||
// 错误信息告知模型已应用了多少、需重新 read_file。
|
||||
async function toolEditFile(ctx, args) {
|
||||
if (String(args.path || '').trim().startsWith('@')) throw new Error('edit_file 不支持 @ 路径(历史只读;要改旧成果先 copy_path 导入本会话)');
|
||||
const abs = resolveInTask(ctx.taskDir, args.path);
|
||||
const abs = resolveInTask(ctx.taskDir, args.path, fsRoot(ctx));
|
||||
let st;
|
||||
try { st = await fsp.stat(abs); }
|
||||
catch (_) { throw new Error('文件不存在:' + args.path); }
|
||||
@@ -711,7 +750,7 @@ async function toolEditFile(ctx, args) {
|
||||
? '(前 ' + applied + ' 处编辑已应用并保存,文件已变化,请重新 read_file 后再继续)'
|
||||
: '(文件未改动)'));
|
||||
}
|
||||
return '已成功应用 ' + applied + ' 处编辑到 ' + relOf(ctx.taskDir, abs);
|
||||
return '已成功应用 ' + applied + ' 处编辑到 ' + dispPath(ctx, abs);
|
||||
}
|
||||
|
||||
// 对齐 Zed select_terminal_output_lines:head/tail 各自取行;同时给时中间空一行;不去重叠;0 合法。
|
||||
@@ -746,17 +785,127 @@ function drainUiCards(text, ctx) {
|
||||
return keep.join('\n');
|
||||
}
|
||||
|
||||
// device 工具:把命令送到远端设备执行(设备主动出站连 core,连接表在 devices.js)。
|
||||
// 与 terminal 的分工:terminal 只在 core 所在机器/容器里跑,需要落在用户自己的电脑、盒子、
|
||||
// Windows 上时用 device。设备不在线就明确报错,不自动降级到本机执行。
|
||||
// device 日志用:命令压成一行并截断,避免长命令刷屏
|
||||
function devCmd(s, n) {
|
||||
const t = String(s || '').replace(/\s+/g, ' ').trim();
|
||||
return t.length > (n || 120) ? t.slice(0, n || 120) + '…' : t;
|
||||
}
|
||||
|
||||
// device 日志用:字节数human化
|
||||
function devBytes(n) {
|
||||
if (!n) return '0B';
|
||||
if (n < 1024) return n + 'B';
|
||||
if (n < 1024 * 1024) return (n / 1024).toFixed(1) + 'KB';
|
||||
return (n / 1024 / 1024).toFixed(2) + 'MB';
|
||||
}
|
||||
|
||||
async function toolDevice(ctx, args) {
|
||||
if (!devices.enabled()) {
|
||||
return '设备接入未启用:需要配置公网前缀(PUBLIC_BASE_URL 或设置页「公网地址」)和 DEVICE_TOKEN,重启 core 后生效。';
|
||||
}
|
||||
const action = String(args.action || '').trim();
|
||||
|
||||
if (action === 'list') {
|
||||
const list = devices.list();
|
||||
log.debug('device', 'list → ' + list.length + ' 台');
|
||||
if (!list.length) return '当前没有设备在线(设备需主动连 wss://<公网前缀>/dev/ws)。';
|
||||
return JSON.stringify(list, null, 2);
|
||||
}
|
||||
|
||||
if (action === 'health') {
|
||||
const name = String(args.device || '').trim();
|
||||
if (!name) return 'Error: action=health 需要 device 参数(先调 action=list 看设备名)';
|
||||
try {
|
||||
const h = await devices.health(name);
|
||||
log.debug('device', 'health ' + name + ' ok');
|
||||
return JSON.stringify(h, null, 2);
|
||||
} catch (e) {
|
||||
log.warn('device', 'health ' + name + ' 失败:' + e.message);
|
||||
return 'Error: ' + e.message;
|
||||
}
|
||||
}
|
||||
|
||||
if (action === 'exec') {
|
||||
const name = String(args.device || '').trim();
|
||||
if (!name) return 'Error: action=exec 需要 device 参数(先调 action=list 看设备名)';
|
||||
if (!String(args.command || '').trim()) return 'Error: action=exec 需要 command 参数';
|
||||
try {
|
||||
const r = await devices.exec({
|
||||
device: name,
|
||||
command: args.command,
|
||||
cwd: args.cwd,
|
||||
timeout_ms: args.timeout_ms,
|
||||
});
|
||||
log.info('device', `exec ${r.device} code=${r.code} ${r.ms}ms cmd="${devCmd(args.command)}"`);
|
||||
const head = `device=${r.device} exit=${r.code}`
|
||||
+ (r.killed_by ? ` killed_by=${r.killed_by}` : '')
|
||||
+ ` ${r.ms}ms` + (r.truncated ? '(输出已截断)' : '');
|
||||
const parts = [head];
|
||||
if (r.note) parts.push('note: ' + r.note);
|
||||
if (r.stdout && r.stdout.trim()) parts.push('--- stdout ---\n' + r.stdout.replace(/\s+$/, ''));
|
||||
if (r.stderr && r.stderr.trim()) parts.push('--- stderr ---\n' + r.stderr.replace(/\s+$/, ''));
|
||||
return parts.join('\n');
|
||||
} catch (e) {
|
||||
log.warn('device', `exec ${name} 失败:${e.message} cmd="${devCmd(args.command)}"`);
|
||||
return 'Error: ' + e.message;
|
||||
}
|
||||
}
|
||||
|
||||
if (action === 'pull') {
|
||||
const name = String(args.device || '').trim();
|
||||
const remote = String(args.remote_path || '').trim();
|
||||
if (!name) return 'Error: action=pull 需要 device 参数(先调 action=list 看设备名)';
|
||||
if (!remote) return 'Error: action=pull 需要 remote_path 参数';
|
||||
try {
|
||||
const rel = String(args.local_path || '').trim() || path.basename(remote);
|
||||
const abs = resolveInTask(ctx.taskDir, rel, fsRoot(ctx));
|
||||
const t0 = Date.now();
|
||||
const r = await devices.pull({ device: name, remotePath: remote, localPath: abs });
|
||||
recordFile(ctx, abs);
|
||||
log.info('device', `pull ${name} ${remote} → ${path.relative(ctx.taskDir, abs) || path.basename(abs)} ${devBytes(r.bytes)} ${Date.now() - t0}ms`);
|
||||
return `已拉到 ${path.relative(ctx.taskDir, abs) || path.basename(abs)}(${r.bytes} 字节,sha256 ${r.sha256.slice(0, 16)}…)`;
|
||||
} catch (e) {
|
||||
log.warn('device', `pull ${name} ${remote} 失败:${e.message}`);
|
||||
return 'Error: ' + e.message;
|
||||
}
|
||||
}
|
||||
|
||||
if (action === 'push') {
|
||||
const name = String(args.device || '').trim();
|
||||
const local = String(args.local_path || '').trim();
|
||||
const remote = String(args.remote_path || '').trim();
|
||||
if (!name) return 'Error: action=push 需要 device 参数(先调 action=list 看设备名)';
|
||||
if (!local) return 'Error: action=push 需要 local_path 参数(会话目录内的相对路径)';
|
||||
if (!remote) return 'Error: action=push 需要 remote_path 参数(设备上的绝对路径,须在工作根内)';
|
||||
try {
|
||||
const abs = resolveInTask(ctx.taskDir, local, fsRoot(ctx));
|
||||
const t0 = Date.now();
|
||||
const r = await devices.push({ device: name, localPath: abs, remotePath: remote });
|
||||
log.info('device', `push ${name} ${remote} ← ${path.relative(ctx.taskDir, abs) || path.basename(abs)} ${devBytes(r.bytes)} ${Date.now() - t0}ms`);
|
||||
return `已推到 ${name}:${remote}(${r.bytes} 字节,sha256 ${r.sha256.slice(0, 16)}…)`;
|
||||
} catch (e) {
|
||||
log.warn('device', `push ${name} ${remote} 失败:${e.message}`);
|
||||
return 'Error: ' + e.message;
|
||||
}
|
||||
}
|
||||
|
||||
return 'Error: action 必须是 list / health / exec / pull / push';
|
||||
}
|
||||
|
||||
async function toolTerminal(ctx, args) {
|
||||
const cfg = ctx.cfg;
|
||||
const timeout = args.timeout_ms || cfg.terminal.default_timeout_ms;
|
||||
const maxChars = cfg.terminal.max_output_chars;
|
||||
let cwd = ctx.taskDir;
|
||||
if (args.cd) cwd = resolveInTask(ctx.taskDir, args.cd);
|
||||
if (args.cd) cwd = resolveInTask(ctx.taskDir, args.cd, fsRoot(ctx));
|
||||
if (!fs.existsSync(cwd)) throw new Error('工作目录不存在:' + cwd);
|
||||
|
||||
// 配了 executor.url(或 env EXECUTOR_URL):命令交给远端 agent-executor 执行,文本拼回与本地完全一致。
|
||||
if (rexec.isRemote(cfg)) {
|
||||
const r = await rexec.run(cfg, { command: args.command, cwd, timeout_ms: timeout, run: ctx.run });
|
||||
const r = await rexec.run(cfg, { command: args.command, cwd, timeout_ms: timeout, run: ctx.run, onChunk: ctx.onOutput });
|
||||
r.out = drainUiCards(r.out, ctx);
|
||||
let text = selectOutput(r.out.replace(/\n+$/, ''), args.head_lines, args.tail_lines);
|
||||
if (r.killed_by === 'timeout') {
|
||||
@@ -782,7 +931,11 @@ async function toolTerminal(ctx, args) {
|
||||
killGroup(child);
|
||||
}, timeout);
|
||||
|
||||
const onData = (d) => { out += d.toString(); };
|
||||
const onData = (d) => {
|
||||
const s = d.toString();
|
||||
out += s;
|
||||
if (ctx.onOutput) { try { ctx.onOutput(s); } catch (_) {} }
|
||||
};
|
||||
child.stdout.on('data', onData);
|
||||
child.stderr.on('data', onData);
|
||||
|
||||
@@ -1166,9 +1319,13 @@ function recordFile(ctx, abs) {
|
||||
try {
|
||||
const st = fs.statSync(abs);
|
||||
if (!st.isFile()) return;
|
||||
// 宽根模式(本地)下写在会话目录之外的文件不进附件表:表里的 filename 是会话相对路径,
|
||||
// 存个 '../x' 会让前端按会话去取,最终只能拿到 400。
|
||||
const rel = relOf(ctx.taskDir, abs);
|
||||
if (rel === '..' || rel.startsWith('..' + path.sep)) return;
|
||||
ctx.db.prepare(
|
||||
'INSERT INTO files (session_id, filename, size, created_at) VALUES (?,?,?,?)'
|
||||
).run(ctx.sessionId, relOf(ctx.taskDir, abs), st.size, Date.now());
|
||||
).run(ctx.sessionId, rel, st.size, Date.now());
|
||||
} catch (_) { /* 文件表仅用于展示,失败不影响主流程 */ }
|
||||
}
|
||||
|
||||
@@ -1177,7 +1334,11 @@ function recordFile(ctx, abs) {
|
||||
// 而 ctx.taskDir 就是会话目录,relOf 的结果正是取用侧(routes/public-files.js)要的 rel。
|
||||
async function toolMintPublicLink(ctx, args) {
|
||||
const pl = (ctx.cfg && ctx.cfg.public_link) || {};
|
||||
if (!pl.base_url) throw new Error('public_link.base_url 未配置,无法签发公网链接');
|
||||
// 本地桌面形态没有公网前缀,但用户就在这台机器上:回环地址签出来的链接照样点得开。
|
||||
// 与 visit_url 的回落同源(都不写配置,靠 HOST 判断形态);容器/服务器形态 HOST 为空
|
||||
// → localOrigin 返回 '' → 仍是原来那句报错,行为不变。
|
||||
const base = String(pl.base_url || '').replace(/\/+$/, '') || localOrigin(ctx.cfg);
|
||||
if (!base) throw new Error('public_link.base_url 未配置,无法签发公网链接');
|
||||
const abs = resolveInTask(ctx.taskDir, args.path);
|
||||
const rel = relOf(ctx.taskDir, abs);
|
||||
if (rel === '.') throw new Error('path 要指向一个文件,不能是任务目录本身');
|
||||
@@ -1191,7 +1352,7 @@ async function toolMintPublicLink(ctx, args) {
|
||||
throw new Error('path 经符号链接指向了任务目录之外,拒绝签发');
|
||||
}
|
||||
const id = publicFiles.mint({ sessionId: ctx.sessionId, rel, ttlMs: pl.ttl_ms });
|
||||
return pl.base_url + '/p/' + id;
|
||||
return base + '/p/' + id;
|
||||
}
|
||||
|
||||
// schedule:用户全部定时任务的生命周期(op 分派,规范见 docs/tool-design.md)。
|
||||
@@ -1300,39 +1461,6 @@ function toolScheduleTask(ctx, args) {
|
||||
}
|
||||
}
|
||||
|
||||
// profile:用户画像增量维护(op 分派同 schedule 风格)。user 取自会话行,AI 不可指定他人;
|
||||
// 条件必填/帽子校验全在 user-profile.js(抛错由引擎包成 is_error 回执),停用拒写不拒读。
|
||||
function toolProfile(ctx, args) {
|
||||
const op = String(args.op || '').trim().toLowerCase();
|
||||
const s = ctx.db.prepare('SELECT user FROM sessions WHERE id = ?').get(ctx.sessionId);
|
||||
if (!s) throw new Error('会话不存在');
|
||||
const user = s.user;
|
||||
switch (op) {
|
||||
case 'list': {
|
||||
const p = profile.getProfile(ctx.db, user);
|
||||
const lines = [
|
||||
'称谓:' + (p.honorific || '(未记录)'),
|
||||
'行业:' + (p.industry || '(未记录)'),
|
||||
'偏好:' + (p.preference || '(未记录)'),
|
||||
];
|
||||
if (!p.enabled) lines.push('(该用户已停用画像注入;set/add/remove 会被拒绝)');
|
||||
lines.push('本会话已注入的快照不会因写入而变;新会话自动携带最新画像。');
|
||||
return lines.join('\n');
|
||||
}
|
||||
case 'set': {
|
||||
const keys = ['honorific', 'industry'].filter(k => typeof args[k] === 'string');
|
||||
if (keys.length !== 1) throw new Error('op=set 需要 honorific 或 industry 恰一个字符串参数(偏好标签用 add/remove)');
|
||||
return profile.setProfileField(ctx.db, user, keys[0], args[keys[0]]);
|
||||
}
|
||||
case 'add':
|
||||
return profile.addProfileTags(ctx.db, user, args.tags);
|
||||
case 'remove':
|
||||
return profile.removeProfileTags(ctx.db, user, args.tags);
|
||||
default:
|
||||
throw new Error('未知的 op:"' + op + '"。可用:list / set(honorific|industry) / add(tags) / remove(tags)');
|
||||
}
|
||||
}
|
||||
|
||||
// db:会话本地 SQLite(taskDir/data.db,随会话目录隔离,首次使用自动建库建文件)。
|
||||
// 连接策略:每次调用 open→用→close,不缓存句柄(会话删目录后不留脏连接);
|
||||
// 单进程 + better-sqlite3 同步 API,同进程内不存在交叠。busy_timeout 兼容
|
||||
@@ -1577,6 +1705,15 @@ function toolDb(ctx, args) {
|
||||
// visit_url(front matter 可选):页面产物类技能声明访问路径模板,run 成功后在本层拼
|
||||
// public_link.base_url(与 mint_public_link 同源)追加完整「访问地址」——技能进程跑在
|
||||
// executor 隔离视图里不知道公网前缀,AI 拿到相对路径就会原样转给用户,而相对路径打不开。
|
||||
// 本地桌面形态的对外前缀:只有监听在回环地址(local/start.sh 注入 HOST=127.0.0.1)才认。
|
||||
// 容器/服务器形态 HOST 为空(= 0.0.0.0),不能凭空造一个 127.0.0.1 给远端用户,照旧只给站内路径。
|
||||
function localOrigin(cfg) {
|
||||
const host = String(process.env.HOST || '').trim().toLowerCase();
|
||||
if (host !== '127.0.0.1' && host !== 'localhost' && host !== '::1') return '';
|
||||
const port = String(process.env.PORT || (cfg && cfg.port) || '').trim();
|
||||
return port ? 'http://127.0.0.1:' + port : '';
|
||||
}
|
||||
|
||||
async function runSkillWithVisit(ctx, name, inputArgs) {
|
||||
const out = await skills.runSkill(ctx, name, inputArgs);
|
||||
let fm;
|
||||
@@ -1590,9 +1727,11 @@ async function runSkillWithVisit(ctx, name, inputArgs) {
|
||||
const rel = tpl.replace(/\{task_id\}/g, ctx.sessionId || path.basename(path.resolve(ctx.taskDir || '')));
|
||||
const pl = (ctx.cfg && ctx.cfg.public_link) || {};
|
||||
const base = String(pl.base_url || '').trim().replace(/\/+$/, '');
|
||||
return out + '\n访问地址:' + (base
|
||||
? base + rel
|
||||
: rel + '(站内路径:public_link.base_url 未配置,拼不出公网前缀)');
|
||||
if (base) return out + '\n访问地址:' + base + rel;
|
||||
// 没有公网前缀时别只给站内路径:本地形态用户就在这台机器上,回环地址就是能直接点开的地址。
|
||||
const origin = localOrigin(ctx.cfg);
|
||||
if (origin) return out + '\n访问地址:' + origin + rel;
|
||||
return out + '\n访问地址:' + rel + '(站内路径:public_link.base_url 未配置,拼不出公网前缀)';
|
||||
}
|
||||
|
||||
const SKILL_USAGE = 'skill 用法:{"op":"list"} / {"op":"get","name":"<技能名>"} / {"op":"run","name":"<技能名>","args":{...}}';
|
||||
@@ -1700,7 +1839,7 @@ function toolRecall(ctx, args) {
|
||||
case 'search': {
|
||||
const q = String(args.query || '').trim();
|
||||
if (!q) throw new Error('op=search 需要 query(关键词;空格分隔多个词更好,如「身份证 水印」)');
|
||||
const txt = memory.searchFragments(db, user, q, args.count);
|
||||
const txt = memory.searchFragments(db, user, q, args.count, ctx.sessionId);
|
||||
return txt || '日记中无「' + q + '」相关记录。';
|
||||
}
|
||||
case 'days': {
|
||||
@@ -1729,9 +1868,9 @@ const HANDLERS = {
|
||||
terminal: toolTerminal,
|
||||
fetch: toolFetch,
|
||||
schedule: toolScheduleTask,
|
||||
profile: toolProfile,
|
||||
recall: toolRecall,
|
||||
db: toolDb,
|
||||
device: toolDevice,
|
||||
skill: toolSkill,
|
||||
lab: toolLab,
|
||||
};
|
||||
@@ -1741,6 +1880,8 @@ const HANDLERS = {
|
||||
// (见 imageReceipt),image_rel 缺省表示本次不投递像素。
|
||||
// 内置工具优先;未命中时交给 MCP 注册表(启动时发现的服务工具)。
|
||||
async function executeTool(baseCtx, name, args) {
|
||||
// 会话目录懒建:会话创建时不再占坑,第一次真用到工具才建(纯文本对话不留空目录)。
|
||||
try { if (baseCtx && baseCtx.taskDir) fs.mkdirSync(baseCtx.taskDir, { recursive: true }); } catch (_) {}
|
||||
const handler = HANDLERS[name];
|
||||
if (handler) return handler(baseCtx, args || {});
|
||||
if (mcp.hasTool(name)) return mcp.callTool(name, args || {}, baseCtx); // baseCtx.taskDir → X-Session-Dir 头下发给 MCP 服务
|
||||
|
||||
@@ -280,10 +280,10 @@ async function runSkill(ctx, skillName, inputArgs) {
|
||||
throw new SkillExecutionError('技能 ' + skillName + ' 缺少入口 run.py 或 run.sh', 1);
|
||||
}
|
||||
|
||||
// cwd:远端取会话目录(executor 侧命中 session 隔离,技能看到的 /workspace/tasks/<sid>
|
||||
// 与 core 侧是同一份数据,absolutizeArgs 产出的绝对路径因此有效);缺 taskDir 时退回
|
||||
// 技能目录(退化为旧行为)。本地无隔离诉求,仍以技能目录为 cwd。
|
||||
const execCwd = rexec.isRemote(ctx.cfg) ? (ctx.taskDir || dir) : dir;
|
||||
// cwd 一律取会话任务目录(技能契约,见 skills/README §6:技能按 cwd 读写会话数据,
|
||||
// data-page 这类会往 cwd 下写 .app/)。旧代码在「无 executor」分支退回技能目录,
|
||||
// 等于假设线上一定走远端;本地桌面形态(本机 spawn)下会把所有按 cwd 干活的技能打歪。
|
||||
const execCwd = ctx.taskDir || dir;
|
||||
const timeoutMs = (ctx.cfg && ctx.cfg.skills && ctx.cfg.skills.timeout_ms) || 120000;
|
||||
log.info('skills', '执行 ' + skillName + ':' + entry + ' ' + cmdArgs.join(' ') + '(cwd=' + execCwd + ')');
|
||||
return runEntry(ctx, entry, cmdArgs, execCwd, timeoutMs);
|
||||
|
||||
@@ -7,19 +7,15 @@
|
||||
// - 注入:会话创建/清空时把渲染文本冻结进 sessions.profile_snapshot,
|
||||
// buildMessages 每轮以 system 后首条 user 消息注入——内容字节恒定不破坏前缀缓存,
|
||||
// 且不落 messages 表,阶段切换归档/压缩都动不到它。
|
||||
// - 更新(原 handoff 落槌一次性提取链路已移除):AI 沟通中经 profile 工具增量维护
|
||||
// (list/set/add/remove,见 executor.js;写入只影响下个会话——快照冻结语义不变),
|
||||
// 用户也可在设置页手动编辑。preference 按顿号标签列表管理,工具只做增量增删、
|
||||
// 不做整段覆写——防模型重写时吃掉旧标签;停用(enabled=0)时拒写不拒读。
|
||||
// - 更新:只由用户在设置页手动编辑。原 AI 侧的 profile 工具(list/set/add/remove)已移除:
|
||||
// 模型自主记录容易把错的东西冻结成长期上下文,记什么由用户把关。
|
||||
// - preference 是用户自由输入的多行文本(一行一条即可):原样入库、原样注入,不拆不拼、
|
||||
// 不把分隔符规范化;只卡一个总长帽(PREF_MAX)。
|
||||
const log = require('./log');
|
||||
|
||||
const FIELDS = ['honorific', 'industry', 'preference'];
|
||||
const MAX_FIELD = 80; // honorific/industry 长度帽(Web 手改与工具共用)
|
||||
const PREF_MAX = 300; // preference 总长帽
|
||||
const SET_MAX = 20; // AI 写 honorific/industry 的单值帽(称谓应当短小)
|
||||
const TAG_MAX = 15; // 单个偏好标签长度帽
|
||||
const TAGS_MAX = 24; // 偏好标签数量帽
|
||||
const TAG_SPLIT = /[、,,;;\n]+/;
|
||||
const MAX_FIELD = 80; // honorific/industry 长度帽
|
||||
const PREF_MAX = 1000; // preference 总长帽(用户自由输入的多行文本,只卡总量)
|
||||
// 画像快照头:AI 友好的分块标记(与 channel_note/memory_note 同款「# [CTX] <名>」体例,
|
||||
// buildMessages 把快照作 system 后首条 user 注入,标题即自描述来源)。
|
||||
const SNAPSHOT_HEAD = '# [CTX] user_profile\n\n以下为历史会话沉淀的粗粒度认知,非任务约束;与当前请求冲突时,一律以当前请求为准。';
|
||||
@@ -54,7 +50,9 @@ function sanitizePatch(body) {
|
||||
const patch = { fields: {}, enabled: undefined };
|
||||
for (const k of FIELDS) {
|
||||
if (typeof b[k] === 'string') {
|
||||
patch.fields[k] = b[k].replace(/\s+/g, ' ').trim().slice(0, k === 'preference' ? PREF_MAX : MAX_FIELD);
|
||||
// preference 是用户按条目输入的自由文本:保留换行,只去首尾空白;另两字段压成单行
|
||||
const v = k === 'preference' ? b[k].trim() : b[k].replace(/\s+/g, ' ').trim();
|
||||
patch.fields[k] = v.slice(0, k === 'preference' ? PREF_MAX : MAX_FIELD);
|
||||
}
|
||||
}
|
||||
if (typeof b.enabled === 'boolean' || b.enabled === 0 || b.enabled === 1) patch.enabled = !!b.enabled;
|
||||
@@ -70,77 +68,6 @@ function saveProfile(db, user, patch) {
|
||||
writeRow(db, user, data, enabled);
|
||||
}
|
||||
|
||||
// ---------- profile 工具(AI 增量维护入口;op 语义与 executor.js toolProfile 对应) ----------
|
||||
// preference 存顿号连接的标签串;读取按分隔符拆 token(人工输入的整句会被拆为 token 存留,可接受)。
|
||||
function profileTokens(preference) {
|
||||
return String(preference || '').split(TAG_SPLIT).map(t => t.trim()).filter(Boolean);
|
||||
}
|
||||
|
||||
// 所有写 op 的统一后缀:快照「新会话冻结注入」语义不因工具改变,明说免 AI 在本会话里困惑等待。
|
||||
const WRITE_NOTE = '(新会话开始时注入,本会话内不变;可用 op=list 查看实时状态)';
|
||||
|
||||
function requireEnabled(db, user) {
|
||||
if (!getProfile(db, user).enabled) {
|
||||
throw new Error('该用户已停用画像(设置页·账户·用户画像可重新启用),本次未写入。');
|
||||
}
|
||||
}
|
||||
|
||||
// 单值字段(称谓/行业)设置;空串 = 清除。
|
||||
function setProfileField(db, user, field, value) {
|
||||
if (!FIELDS.includes(field) || field === 'preference') {
|
||||
throw new Error('op=set 仅支持 honorific / industry(偏好标签请用 op=add / op=remove)');
|
||||
}
|
||||
requireEnabled(db, user);
|
||||
const v = String(value == null ? '' : value).replace(/\s+/g, ' ').trim().slice(0, SET_MAX);
|
||||
const cur = getProfile(db, user)[field];
|
||||
if (cur === v) return FIELD_LABELS[field] + '已是「' + v + '」,未改动。';
|
||||
saveProfile(db, user, { fields: { [field]: v } });
|
||||
return v
|
||||
? FIELD_LABELS[field] + '已设为「' + v + '」' + WRITE_NOTE
|
||||
: FIELD_LABELS[field] + '已清除(下次冻结时将不再出现)。';
|
||||
}
|
||||
|
||||
// 追加偏好标签:清洗 → 逐条校验长度 → 去重 → 数量/总长帽(整批原子:任一带帽违例则不落库)
|
||||
function addProfileTags(db, user, tags) {
|
||||
const list = (Array.isArray(tags) ? tags : [tags])
|
||||
.map(t => String(t == null ? '' : t).replace(TAG_SPLIT, ' ').replace(/\s+/g, ' ').trim())
|
||||
.filter(Boolean);
|
||||
if (!list.length) throw new Error('op=add 需要非空的 tags 字符串数组(单个标签也用数组传)');
|
||||
requireEnabled(db, user);
|
||||
const cur = profileTokens(getProfile(db, user).preference);
|
||||
const added = [], dup = [];
|
||||
for (const t of list) {
|
||||
if (t.length > TAG_MAX) throw new Error('标签「' + t + '」超过 ' + TAG_MAX + ' 字上限,请换成更概括的说法');
|
||||
if (cur.includes(t)) { dup.push(t); continue; }
|
||||
cur.push(t); added.push(t);
|
||||
}
|
||||
if (cur.length > TAGS_MAX) throw new Error('偏好标签已达 ' + TAGS_MAX + ' 个上限(本次将到 ' + cur.length + '),先用 op=remove 合并精简');
|
||||
const joined = cur.join('、');
|
||||
if (joined.length > PREF_MAX) throw new Error('偏好总长将超 ' + PREF_MAX + ' 字(现 ' + joined.length + '),先用 op=remove 精简');
|
||||
if (!added.length) {
|
||||
return '均已存在,未新增(' + dup.join('、') + ');当前偏好 ' + cur.length + ' 条。';
|
||||
}
|
||||
saveProfile(db, user, { fields: { preference: joined } });
|
||||
return '已记录:' + added.join('、')
|
||||
+ (dup.length ? '(已存在未重复:' + dup.join('、') + ')' : '')
|
||||
+ ';偏好现共 ' + cur.length + ' 条' + WRITE_NOTE;
|
||||
}
|
||||
|
||||
// 删除偏好标签:按 token 精确匹配;未命中的回报(引导先 list 核对写法)。
|
||||
function removeProfileTags(db, user, tags) {
|
||||
const list = (Array.isArray(tags) ? tags : [tags]).map(t => String(t == null ? '' : t).trim()).filter(Boolean);
|
||||
if (!list.length) throw new Error('op=remove 需要非空的 tags 字符串数组');
|
||||
requireEnabled(db, user);
|
||||
const cur = profileTokens(getProfile(db, user).preference);
|
||||
const removed = list.filter(t => cur.includes(t));
|
||||
const missing = list.filter(t => !cur.includes(t));
|
||||
if (!removed.length) return '未找到要删除的标签:' + missing.join('、') + '(op=list 可查看当前精确标签)';
|
||||
saveProfile(db, user, { fields: { preference: cur.filter(t => !removed.includes(t)).join('、') } });
|
||||
return '已移除:' + removed.join('、')
|
||||
+ (missing.length ? ';未找到:' + missing.join('、') : '')
|
||||
+ ';偏好现共 ' + (cur.length - removed.length) + ' 条' + WRITE_NOTE;
|
||||
}
|
||||
|
||||
// 渲染注入文本:三字段(非空才成行);停用或全空 → 空串(不注入)。
|
||||
function snapshotText(db, user) {
|
||||
const p = getProfile(db, user);
|
||||
@@ -161,5 +88,4 @@ function freezeSnapshot(db, sessionId) {
|
||||
|
||||
module.exports = {
|
||||
getProfile, sanitizePatch, saveProfile, snapshotText, freezeSnapshot,
|
||||
setProfileField, addProfileTags, removeProfileTags,
|
||||
};
|
||||
|
||||
+22
-35
@@ -418,9 +418,10 @@ function saveTaskMedia(s, buf, kind, rawName) {
|
||||
// 预算够 → 全文 + 附件卡片;放不下但 ≥2 → 降级「截断头部 + 全文写会话
|
||||
// .md 转文件卡片」(内容零丢失);<2 → 放弃并告警(网页端完整可见)。
|
||||
// 4. 工具台账(重结果轻过程;微信端不再有独立台账消息):tool_call/tool_result 只在 st.tools
|
||||
// 记账;失败即时单发一行「工具调用失败: 名称 + 参数」(预算保不住结论储备则留给尾段汇总);
|
||||
// done 时汇总为一句「本轮工具调用 N 次(name x c, ...),其中 M 次失败」搭结论尾段,
|
||||
// 纯工具轮(无结论文本)则汇总与文件卡片合成一条兜底消息(网页端始终全量可见)。
|
||||
// 记账;**工具失败一律不下发**(多数是 AI 参数用错,模型下一轮自己改,推给用户既看不懂
|
||||
// 也帮不上忙;网页端工具卡与库里的 is_error 照旧保留)。done 时只汇总一句中性计数
|
||||
// 「本轮工具调用 N 次(name x c, ...)」搭结论尾段,若本轮有因用户介入而未执行的调用,
|
||||
// 额外补「N 次因你介入未执行」;纯工具轮(无结论文本)则汇总与文件卡片合成一条兜底消息。
|
||||
// 5. 通用 ui_card(MCP 工具回包的预览卡片块):按 URL 去重攒进 st.cards,不独立占配额,
|
||||
// done 时作「文件」小节搭结论尾段;每条 markdown 链接 + 原始 URL 各一行(防纯文化退化
|
||||
// 后点不开);未知 action 或未配公网前缀在微信端静默忽略。
|
||||
@@ -439,13 +440,13 @@ function attachBus() {
|
||||
else if (event === 'done') enqueueDelivery(bid, () => flushHeld(bid));
|
||||
else {
|
||||
// 工具调用/回执:心跳 + 台账记账(台账不再独立成消息,见策略注释第 4 条);
|
||||
// 失败经串行队列即时单发一行;ui_card 攒进本回合卡片列表(done 时随尾段投)。
|
||||
// 失败一律**不下发**(多数是 AI 参数用错,模型下一轮自己改;用户看到
|
||||
// 「工具调用失败」既看不懂也帮不上忙)。网页端工具卡与库里的 is_error 照旧保留。
|
||||
// ui_card 攒进本回合卡片列表(done 时随尾段投)。
|
||||
// reasoning_delta(思考流)不进台账,只走下面的心跳——微信用户能看到「正在输入」在思考。
|
||||
if (event === 'tool_call') toolDigestPush(bid, data);
|
||||
else if (event === 'tool_result') {
|
||||
toolDigestMark(bid, data);
|
||||
if (data && data.is_error) enqueueDelivery(bid, () => flushFailedLine(bid));
|
||||
} else if (event === 'ui_card') cardCollect(bid, data, sessionId);
|
||||
else if (event === 'tool_result') toolDigestMark(bid, data);
|
||||
else if (event === 'ui_card') cardCollect(bid, data, sessionId);
|
||||
maybeTypingPing(bid); // 「正在输入」心跳:长工具/思考回合里微信持续看到 AI 还在干活
|
||||
}
|
||||
} catch (e) {
|
||||
@@ -488,7 +489,7 @@ function getTurn(bid) { return turnState.get(bid) || resetTurn(bid); }
|
||||
|
||||
// 投递前的内容归一(语义同旧 deliverNow):errAck / 空文本 → 不可投;富文本 blocks → 占位文案。
|
||||
function normalizeContent(m) {
|
||||
if (!m || m.type === 'errAck') return '';
|
||||
if (!m || m.type === 'errAck' || m.type === 'error_note') return '';
|
||||
let content = String(m.content || '').trim();
|
||||
if (!content) return '';
|
||||
if (content.startsWith('{"__blocks__"')) content = '【富文本消息,请到网页端查看】';
|
||||
@@ -572,32 +573,34 @@ function toolDigestPush(bid, data) {
|
||||
const name = String((data && data.name) || '');
|
||||
if (!name) return;
|
||||
const hint = argHint(data && data.arguments);
|
||||
const ex = st.tools.find(t => t.name === name && t.hint === hint && !t.err);
|
||||
// 同参数同名归并成一条(失败也不再单开一条:失败对用户不可见,没必要为它拆行)
|
||||
const ex = st.tools.find(t => t.name === name && t.hint === hint && !t.skipped);
|
||||
if (ex) { ex.count++; if (data.id) ex.ids.push(data.id); return; }
|
||||
st.tools.push({ name, hint, count: 1, err: false, ids: data && data.id ? [data.id] : [] });
|
||||
st.tools.push({ name, hint, count: 1, skipped: false, ids: data && data.id ? [data.id] : [] });
|
||||
} catch (_) { /* 摘要锦上添花,绝不动摇投递 */ }
|
||||
}
|
||||
// 只记「未执行」(用户介入/终止导致没跑的调用)。工具自身失败不进台账展示:
|
||||
// 多数是 AI 参数写错,模型下一轮会自己改;它要不要告诉用户,由模型自己的回复决定。
|
||||
function toolDigestMark(bid, data) {
|
||||
try {
|
||||
if (!data || !data.is_error) return;
|
||||
if (!data || !data.skipped) return;
|
||||
const st = getTurn(bid);
|
||||
const t = st.tools.find(x => x.ids.indexOf(data.tool_call_id) >= 0);
|
||||
if (t) t.err = true;
|
||||
if (t) t.skipped = true;
|
||||
} catch (_) { /* 同上 */ }
|
||||
}
|
||||
// 降级路径的渲染(peek 不清空):台账单发预算不足/失败时搭结论尾段,结论投递成功后调用方清空。
|
||||
// 若 wxbot 开 WXBOT_STRIP_MARKDOWN 回退纯文化,stripMarkdown 会把围栏/标题降为普通行,信息不丢。
|
||||
// done 尾段的工具汇总(peek 不清空):一句计数 + 未即时送达的失败行;结论投递成功后由调用方清空。
|
||||
// done 尾段的工具汇总(peek 不清空):一句中性计数 + 「因你介入未执行」的条数。
|
||||
// 刻意不列失败:工具报错是 AI 自己该处理的事,往里推只会让用户困惑(详见 toolDigestMark 注释)。
|
||||
function peekToolDigest(st) {
|
||||
const ts = st && st.tools;
|
||||
if (!ts || !ts.length) return '';
|
||||
const total = ts.reduce((n, t) => n + (t.count || 1), 0);
|
||||
const breakdown = ts.map(t => t.name + (t.count > 1 ? ' x' + t.count : '')).join(', ');
|
||||
const errN = ts.filter(t => t.err).length;
|
||||
let s = '---\n\n### 工具\n\n本轮工具调用 ' + total + ' 次(' + breakdown + ')';
|
||||
if (errN) s += ',其中 ' + errN + ' 次失败';
|
||||
const unnotified = ts.filter(t => t.err && !t.warned);
|
||||
if (unnotified.length) s += '\n' + unnotified.map(t => '- 失败: ' + t.name + (t.hint ? ' ' + t.hint : '')).join('\n');
|
||||
const skipN = ts.filter(t => t.skipped).length;
|
||||
if (skipN) s += ',' + skipN + ' 次因你介入未执行';
|
||||
return s;
|
||||
}// 正文与 digest 一起分段:正文照旧 splitText,digest 原子追尾——markdown 代码围栏不能被
|
||||
// 1800 字分段拦腰斩断;尾段能与正文同段就同段(不多占配额),放不下才单独成段。
|
||||
@@ -610,22 +613,6 @@ function digestSegs(body, digest) {
|
||||
else segs.push(digest);
|
||||
return segs;
|
||||
}
|
||||
// 独立台账消息:一批 ≤8 行整屏渲染,无折叠(零头等下一班车,done 时补发)。
|
||||
// 失败即时单发:一次 tool_result 失败事件触发一次;预算保不住结论储备就留给尾段汇总兜底。
|
||||
async function flushFailedLine(bid) {
|
||||
const st = getTurn(bid);
|
||||
const t = st.tools.find(x => x.err && !x.warned);
|
||||
if (!t) return;
|
||||
const b = bindReady(bid);
|
||||
if (!b) return;
|
||||
if (st.sent + 1 > REPLY_QUOTA - CONCLUSION_RESERVE) return;
|
||||
try {
|
||||
await wxbotApi('POST', '/api/deliver', { id: b.id, to: b.wx_to_user, text: '工具调用失败: ' + t.name + (t.hint ? '\n' + t.hint : '') }, 15000);
|
||||
st.sent++;
|
||||
t.warned = true;
|
||||
} catch (_) { /* 投失败不紧:done 时尾段汇总仍会列出 */ }
|
||||
}
|
||||
|
||||
// ---------- 通用 UI 卡片(bus ui_card 事件,见 wechat 策略注释第 5 条)----------
|
||||
// open_preview → 绝对预览 URL:与前端 pvOfficeUrl/网关寻址同款,前缀真相在 core(public_link.base_url)。
|
||||
function uiCardUrl(data, sessionId) {
|
||||
@@ -671,7 +658,7 @@ async function flushTail(bid) {
|
||||
// 留给结论尾段搭便车;直投失败归还队首(串行队列调度,与正文消息天然排队,无并发互踩)。
|
||||
|
||||
// 过程消息:直发窗口内且投完后仍给结论留足储备才投;否则计入 omitted,并进结论的注记行。
|
||||
// 正文不携带工具信息——工具信息自有出口(失败即时行/done 尾段汇总),不重复。
|
||||
// 正文不携带工具信息——工具信息自有出口(done 尾段汇总),不重复;工具失败不下发。
|
||||
async function deliverProcess(bid, m, sessionId) {
|
||||
const b = bindReady(bid);
|
||||
if (!b || stale(b, m)) return;
|
||||
|
||||
@@ -0,0 +1,140 @@
|
||||
# agent-device:远端设备执行端
|
||||
|
||||
把一台机器(Linux 盒子、Windows、macOS)变成 agent 的一双“手”:**主动出站**连到 core 的
|
||||
WebSocket 端点,接收 shell 命令、流式回传输出与退出码、上报主机指标。
|
||||
|
||||
设备不需要公网 IP、不需要开任何入站端口,NAT、公司网络、随身热点都能用。
|
||||
|
||||
> 这不是通用 agent,只是执行端。会话、模型、记忆都在服务端;这里只负责“在那台机器上跑东西”。
|
||||
|
||||
## 二进制里没有服务器地址
|
||||
|
||||
`-server` 与 token 都**没有默认值**,不显式给就启动失败。所以拿到的二进制不会连到别人的服务器上——
|
||||
它只连你指定的那一台。
|
||||
|
||||
## 安装
|
||||
|
||||
### 自己编译
|
||||
|
||||
需要 Go 1.22+:
|
||||
|
||||
```sh
|
||||
git clone <本仓库> && cd device
|
||||
go build -trimpath -ldflags "-s -w" -o bin/agent-device ./cmd/agent
|
||||
```
|
||||
|
||||
交叉编译(一次出六个平台):
|
||||
|
||||
```sh
|
||||
sh scripts/build.sh all
|
||||
```
|
||||
|
||||
脚本只做构建:不联网、不推送、不依赖任何特定服务器。本机没有 Go 但装了 docker 时,
|
||||
会自动用 `golang:1.23-alpine` 容器编译。
|
||||
|
||||
### 下载预编译
|
||||
|
||||
从本仓库的 Releases 页面取对应平台的文件(`agent-device-linux-arm64`、`agent-device-windows-amd64.exe` 等),
|
||||
`chmod +x` 即可,静态链接、无运行时依赖,一个文件约 5.5 MB。
|
||||
|
||||
## 运行
|
||||
|
||||
```sh
|
||||
# 推荐:二进制旁边放一个 config.json,直接启动(token 不出现在 ps 里)
|
||||
./agent-device
|
||||
|
||||
# 或者全走命令行
|
||||
./agent-device -server wss://your-host.example/dev/ws -token <TOKEN> -root /var/agent-work -name box-01
|
||||
|
||||
# 配置文件不在默认位置时显式指定
|
||||
./agent-device -config /etc/agent-device.json
|
||||
```
|
||||
|
||||
**默认会自动读可执行文件同目录的 `config.json`**(存在才读,不存在就当没配),所以部署时把二进制和配置放一个目录、直接跑就行:
|
||||
|
||||
```json
|
||||
{
|
||||
"server": "wss://your-host.example/dev/ws",
|
||||
"token": "…",
|
||||
"root": "/var/agent-work",
|
||||
"name": "box-01"
|
||||
}
|
||||
```
|
||||
|
||||
优先级:**命令行显式参数 > 环境变量 `NODE_TOKEN`(仅 token)> 配置文件 > 默认值**。
|
||||
|
||||
### shell 用哪个
|
||||
|
||||
默认:macOS / Linux 用 `/bin/sh`(固定,不读 `$SHELL`——用户把默认 shell 设成 fish 时,
|
||||
模型写的 POSIX 语法会全废);Windows 用 `cmd`。
|
||||
|
||||
想换就在 `config.json` 里写 `shell`,**不做自动探测**:装了 Git Bash / busybox 就写路径,
|
||||
没装就保持默认。
|
||||
|
||||
```json
|
||||
{ "shell": "C:\\Program Files\\Git\\bin\\bash.exe" }
|
||||
```
|
||||
|
||||
报给 core 的是短标签(`sh` / `bash` / `busybox` / `cmd` / `powershell`),同时带上解释器路径与版本。
|
||||
|
||||
| 参数 | 说明 |
|
||||
|---|---|
|
||||
| `-server` | core 的接入地址,`wss://…/dev/ws` |
|
||||
| `-token` | Bearer token,须与服务端 `DEVICE_TOKEN` 一致 |
|
||||
| `-root` | 工作根目录,命令的 `cwd` 必须落在它之内(默认 `~/agent-work`,会自动建)。写相对路径时按**二进制所在目录**解析,如 `workspace` / `.`,不能越出该目录 |
|
||||
| `-name` | 设备名,服务端用它区分设备(默认 hostname) |
|
||||
| `-shell` | `sh` / `cmd` / `powershell`,默认按平台 |
|
||||
| `-config` | 配置文件路径,默认 `<二进制所在目录>/config.json` |
|
||||
| `-insecure` | 跳过证书校验(自签证书调试用) |
|
||||
| `-fix-clock` | 证书报错时用服务器 `Date` 头校准本机时间(小设备没有 RTC 时用,Linux 需 root) |
|
||||
|
||||
设备名重复时后接入的会顶掉前一个连接(换机、重装不留僵尸连接)。
|
||||
|
||||
## 协议
|
||||
|
||||
一条 WebSocket 上全是 JSON 文本帧,`t` 区分类型:
|
||||
|
||||
| 方向 | 消息 |
|
||||
|---|---|
|
||||
| 设备 → core | `{t:"hello", ver, name, os, arch, shell, shell_path, shell_ver, root}` |
|
||||
| core → 设备 | `{t:"exec", id, cmd, cwd, timeout_ms}` · `{t:"kill", id}` · `{t:"ping"}` · `{t:"health", id}` |
|
||||
| 文件通道 | `{t:"file", id, op:"read"\|"write", path, size?, sha256?}` · `{t:"file.chunk", id, data:<base64>}` ×N · `{t:"file.done", id, size?, sha256?, err?}` |
|
||||
| 设备 → core | `{t:"chunk", id, out:"out"\|"err", chunk:<base64>}` · `{t:"exit", id, code, killed_by, ms, truncated}` · `{t:"pong"}` · `{t:"health", …}` |
|
||||
|
||||
- 保活:core 每 20 秒发 `ping`,设备回 `pong`;90 秒无任何消息即断开重连。
|
||||
- 断线:指数退避 1s → 2s → 4s → … 上限 30s,连上后重置。
|
||||
- 超时:命令超过 `timeout_ms` 由设备侧杀**进程组**,回 `killed_by:"timeout"`。
|
||||
- 输出:单流超过上限截断并置 `truncated`。
|
||||
- `shell` 报的是实际解释器(`/bin/sh` 可能是 dash / bash / busybox),连同版本,供模型决定命令语法。
|
||||
|
||||
## 文件通道
|
||||
|
||||
core 通过同一条连接搬文件,**设备不需要任何额外端口**:
|
||||
|
||||
| 方向 | 流程 |
|
||||
|---|---|
|
||||
| 拉取(设备 → 会话目录) | `file{op:read}` → 设备分块回 `file.chunk` → `file.done{size,sha256}` |
|
||||
| 推送(会话目录 → 设备) | `file{op:write,size,sha256}` → 分块 `file.chunk` → `file.done` |
|
||||
|
||||
- 每块 256 KiB(base64 后约 341 KiB),单文件上限 2 GiB;
|
||||
- 超时按**空闲**算:首块 30s,之后每收到一块重置 30s——链路慢但不卡就不会被误杀;
|
||||
- 写盘先落 `<path>.part`,`size` 与 `sha256` 都对上才 `rename`;
|
||||
- 设备侧路径必须在工作根内(与 `exec` 的 cwd 校验同一套)。
|
||||
|
||||
## 安全边界
|
||||
|
||||
- 设备主动出站,服务端不需要知道设备 IP;
|
||||
- token 走 `Authorization: Bearer`,与业务 token 分开;
|
||||
- `cwd` 只约束**起始目录**,命令内部仍可 `cd` 到别处——给了 shell 就是这个语义,需要强隔离请用容器/namespaces;
|
||||
- 同一个 token 可被多台设备共用(当前设计),吊销需换 token 并重启所有设备。
|
||||
|
||||
## 实测
|
||||
|
||||
| 用例 | 结果 |
|
||||
|---|---|
|
||||
| exec 基本 | cwd 自动创建,stdout/stderr 分流,退出码透传 |
|
||||
| 超时 | 杀进程组,`killed_by=timeout` |
|
||||
| 起始 cwd 越界 | 拒绝 |
|
||||
| 断线重连 | 1s→2s→4s 退避,恢复后自动注册 |
|
||||
|
||||
在 Linux / macOS / Windows 三平台编译验证(amd64 + arm64);另出 `linux-mips` 软浮点版给 OpenWrt 设备。
|
||||
@@ -0,0 +1,237 @@
|
||||
package main
|
||||
|
||||
// 文件通道:core 通过同一条 WS 拉取 / 推送文件。
|
||||
//
|
||||
// 协议(与 core 的 devices.js 一一对应):
|
||||
//
|
||||
// core → 节点 {t:"file", id, op:"read", path}
|
||||
// 节点 → core {t:"file.chunk", id, data:<base64>} ×N → {t:"file.done", id, size, sha256}
|
||||
//
|
||||
// core → 节点 {t:"file", id, op:"write", path, size, sha256}
|
||||
// core → 节点 {t:"file.chunk", id, data} ×N → {t:"file.done", id}
|
||||
// 节点 → core {t:"file.done", id, size} 或 {t:"file.done", id, err}
|
||||
//
|
||||
// 写盘一律先落 <path>.part,校验通过再 rename——半截文件不能留在原地。
|
||||
|
||||
import (
|
||||
"crypto/sha256"
|
||||
"encoding/hex"
|
||||
"errors"
|
||||
"hash"
|
||||
"io"
|
||||
"os"
|
||||
"path/filepath"
|
||||
"strconv"
|
||||
"strings"
|
||||
"sync"
|
||||
|
||||
"agent-device/pkg/wsnode"
|
||||
"agent-device/pkg/proto"
|
||||
)
|
||||
|
||||
const (
|
||||
fileChunkSize = 256 << 10 // 每块 256 KiB(base64 后约 341 KiB)
|
||||
maxFileBytes = 2 << 30 // 单文件上限 2 GiB
|
||||
)
|
||||
|
||||
type fileWriter struct {
|
||||
path string
|
||||
tmp *os.File
|
||||
tmpPath string
|
||||
hash hash.Hash
|
||||
got int64
|
||||
// 期望值(core 下发时给的,用于对账)
|
||||
size int64
|
||||
sha string
|
||||
}
|
||||
|
||||
type fileMgr struct {
|
||||
mu sync.Mutex
|
||||
writers map[string]*fileWriter
|
||||
}
|
||||
|
||||
func newFileMgr() *fileMgr {
|
||||
return &fileMgr{writers: map[string]*fileWriter{}}
|
||||
}
|
||||
|
||||
// safePath 把设备侧路径限制在 root 之内(与 exec 的 cwd 校验同一套语义)。
|
||||
func (r *runner) safePath(raw string) (string, error) {
|
||||
if raw == "" {
|
||||
return "", errors.New("path 不能为空")
|
||||
}
|
||||
p := raw
|
||||
if !filepath.IsAbs(p) {
|
||||
p = filepath.Join(r.root, p)
|
||||
}
|
||||
p = filepath.Clean(p)
|
||||
rel, err := filepath.Rel(r.root, p)
|
||||
if err != nil || rel == ".." || strings.HasPrefix(rel, ".."+string(filepath.Separator)) {
|
||||
return "", errors.New("path 超出工作根:" + raw)
|
||||
}
|
||||
return p, nil
|
||||
}
|
||||
|
||||
func (r *runner) fileStart(c *wsnode.Conn, m proto.Msg) {
|
||||
switch m.Op {
|
||||
case "read":
|
||||
go r.fileRead(c, m)
|
||||
case "write":
|
||||
r.fileBegin(c, m)
|
||||
default:
|
||||
r.fileFail(c, m.ID, "未知的 file.op:"+m.Op)
|
||||
}
|
||||
}
|
||||
|
||||
func (r *runner) fileFail(c *wsnode.Conn, id, msg string) {
|
||||
_ = c.Send(proto.Msg{T: proto.TKindFileDone, ID: id, Err: msg})
|
||||
}
|
||||
|
||||
// fileRead 把设备上的文件分块推回 core。
|
||||
func (r *runner) fileRead(c *wsnode.Conn, m proto.Msg) {
|
||||
p, err := r.safePath(m.Path)
|
||||
if err != nil {
|
||||
r.fileFail(c, m.ID, err.Error())
|
||||
return
|
||||
}
|
||||
f, err := os.Open(p)
|
||||
if err != nil {
|
||||
r.fileFail(c, m.ID, err.Error())
|
||||
return
|
||||
}
|
||||
defer f.Close()
|
||||
|
||||
st, err := f.Stat()
|
||||
if err != nil {
|
||||
r.fileFail(c, m.ID, err.Error())
|
||||
return
|
||||
}
|
||||
if st.IsDir() {
|
||||
r.fileFail(c, m.ID, "是目录,不是文件:"+p)
|
||||
return
|
||||
}
|
||||
if st.Size() > maxFileBytes {
|
||||
r.fileFail(c, m.ID, "文件超过 2GiB 上限")
|
||||
return
|
||||
}
|
||||
|
||||
h := sha256.New()
|
||||
buf := make([]byte, fileChunkSize)
|
||||
var sent int64
|
||||
for {
|
||||
n, rerr := f.Read(buf)
|
||||
if n > 0 {
|
||||
h.Write(buf[:n])
|
||||
sent += int64(n)
|
||||
if err := c.Send(proto.Msg{
|
||||
T: proto.TKindFileChunk, ID: m.ID,
|
||||
Data: append([]byte(nil), buf[:n]...),
|
||||
}); err != nil {
|
||||
return
|
||||
}
|
||||
}
|
||||
if rerr == io.EOF {
|
||||
break
|
||||
}
|
||||
if rerr != nil {
|
||||
r.fileFail(c, m.ID, rerr.Error())
|
||||
return
|
||||
}
|
||||
}
|
||||
_ = c.Send(proto.Msg{
|
||||
T: proto.TKindFileDone, ID: m.ID,
|
||||
Size: sent, SHA: hex.EncodeToString(h.Sum(nil)),
|
||||
})
|
||||
}
|
||||
|
||||
// fileBegin 为一次 write 建立临时文件。
|
||||
func (r *runner) fileBegin(c *wsnode.Conn, m proto.Msg) {
|
||||
p, err := r.safePath(m.Path)
|
||||
if err != nil {
|
||||
r.fileFail(c, m.ID, err.Error())
|
||||
return
|
||||
}
|
||||
if m.Size > maxFileBytes {
|
||||
r.fileFail(c, m.ID, "文件超过 2GiB 上限")
|
||||
return
|
||||
}
|
||||
if err := os.MkdirAll(filepath.Dir(p), 0o755); err != nil {
|
||||
r.fileFail(c, m.ID, err.Error())
|
||||
return
|
||||
}
|
||||
tmpPath := p + ".part"
|
||||
f, err := os.OpenFile(tmpPath, os.O_CREATE|os.O_TRUNC|os.O_WRONLY, 0o644)
|
||||
if err != nil {
|
||||
r.fileFail(c, m.ID, err.Error())
|
||||
return
|
||||
}
|
||||
r.files.mu.Lock()
|
||||
r.files.writers[m.ID] = &fileWriter{
|
||||
path: p, tmp: f, tmpPath: tmpPath, hash: sha256.New(),
|
||||
size: m.Size, sha: m.SHA,
|
||||
}
|
||||
r.files.mu.Unlock()
|
||||
}
|
||||
|
||||
func (r *runner) fileChunk(c *wsnode.Conn, m proto.Msg) {
|
||||
r.files.mu.Lock()
|
||||
w := r.files.writers[m.ID]
|
||||
r.files.mu.Unlock()
|
||||
if w == nil {
|
||||
return
|
||||
}
|
||||
if w.got+int64(len(m.Data)) > maxFileBytes {
|
||||
r.abortWriter(m.ID, w, "超过 2GiB 上限")
|
||||
r.fileFail(c, m.ID, "超过 2GiB 上限")
|
||||
return
|
||||
}
|
||||
if _, err := w.tmp.Write(m.Data); err != nil {
|
||||
r.abortWriter(m.ID, w, err.Error())
|
||||
r.fileFail(c, m.ID, err.Error())
|
||||
return
|
||||
}
|
||||
w.hash.Write(m.Data)
|
||||
w.got += int64(len(m.Data))
|
||||
}
|
||||
|
||||
// fileEnd 收尾写入:校验大小与 sha256,通过才改名到正式路径。
|
||||
func (r *runner) fileEnd(c *wsnode.Conn, m proto.Msg) {
|
||||
r.files.mu.Lock()
|
||||
w := r.files.writers[m.ID]
|
||||
delete(r.files.writers, m.ID)
|
||||
r.files.mu.Unlock()
|
||||
if w == nil {
|
||||
return
|
||||
}
|
||||
defer func() { _ = w.tmp.Close() }()
|
||||
|
||||
sum := hex.EncodeToString(w.hash.Sum(nil))
|
||||
if w.size > 0 && w.got != w.size {
|
||||
_ = os.Remove(w.tmpPath)
|
||||
r.fileFail(c, m.ID, "大小不符:收到 "+strconv.FormatInt(w.got, 10)+",应为 "+strconv.FormatInt(w.size, 10))
|
||||
return
|
||||
}
|
||||
if w.sha != "" && !strings.EqualFold(w.sha, sum) {
|
||||
_ = os.Remove(w.tmpPath)
|
||||
r.fileFail(c, m.ID, "sha256 不符")
|
||||
return
|
||||
}
|
||||
if err := w.tmp.Close(); err != nil {
|
||||
_ = os.Remove(w.tmpPath)
|
||||
r.fileFail(c, m.ID, err.Error())
|
||||
return
|
||||
}
|
||||
if err := os.Rename(w.tmpPath, w.path); err != nil {
|
||||
_ = os.Remove(w.tmpPath)
|
||||
r.fileFail(c, m.ID, err.Error())
|
||||
return
|
||||
}
|
||||
_ = c.Send(proto.Msg{T: proto.TKindFileDone, ID: m.ID, Size: w.got, SHA: sum})
|
||||
}
|
||||
|
||||
func (r *runner) abortWriter(id string, w *fileWriter, why string) {
|
||||
r.files.mu.Lock()
|
||||
delete(r.files.writers, id)
|
||||
r.files.mu.Unlock()
|
||||
_ = w.tmp.Close()
|
||||
_ = os.Remove(w.tmpPath)
|
||||
}
|
||||
@@ -0,0 +1,162 @@
|
||||
//go:build !windows
|
||||
|
||||
package main
|
||||
|
||||
// 主机指标:Linux 读 /proc,macOS 调 sysctl / vm_stat(health 调用不频繁,允许 fork)。
|
||||
// 拿不到的指标给 -1,不编数据。
|
||||
|
||||
import (
|
||||
"context"
|
||||
"os"
|
||||
"os/exec"
|
||||
"runtime"
|
||||
"strconv"
|
||||
"strings"
|
||||
"syscall"
|
||||
"time"
|
||||
)
|
||||
|
||||
type healthInfo struct {
|
||||
HostUptimeSec int64
|
||||
Load1, Load5, Load15 float64
|
||||
MemTotalMB, MemFreeMB int64
|
||||
DiskTotalGB, DiskFreeGB float64
|
||||
TempC float64
|
||||
}
|
||||
|
||||
func hostHealth() healthInfo {
|
||||
h := healthInfo{
|
||||
HostUptimeSec: -1, Load1: -1, Load5: -1, Load15: -1,
|
||||
MemTotalMB: -1, MemFreeMB: -1, DiskTotalGB: -1, DiskFreeGB: -1, TempC: -1,
|
||||
}
|
||||
|
||||
switch runtime.GOOS {
|
||||
case "linux":
|
||||
if b, err := os.ReadFile("/proc/uptime"); err == nil {
|
||||
if f := strings.Fields(string(b)); len(f) > 0 {
|
||||
if v, err := strconv.ParseFloat(f[0], 64); err == nil {
|
||||
h.HostUptimeSec = int64(v)
|
||||
}
|
||||
}
|
||||
}
|
||||
if b, err := os.ReadFile("/proc/loadavg"); err == nil {
|
||||
if f := strings.Fields(string(b)); len(f) >= 3 {
|
||||
h.Load1, _ = strconv.ParseFloat(f[0], 64)
|
||||
h.Load5, _ = strconv.ParseFloat(f[1], 64)
|
||||
h.Load15, _ = strconv.ParseFloat(f[2], 64)
|
||||
}
|
||||
}
|
||||
if b, err := os.ReadFile("/proc/meminfo"); err == nil {
|
||||
for _, line := range strings.Split(string(b), "\n") {
|
||||
f := strings.Fields(line)
|
||||
if len(f) < 2 {
|
||||
continue
|
||||
}
|
||||
kb, _ := strconv.ParseInt(f[1], 10, 64)
|
||||
switch f[0] {
|
||||
case "MemTotal:":
|
||||
h.MemTotalMB = kb / 1024
|
||||
case "MemAvailable:":
|
||||
h.MemFreeMB = kb / 1024
|
||||
}
|
||||
}
|
||||
}
|
||||
if b, err := os.ReadFile("/sys/class/thermal/thermal_zone0/temp"); err == nil {
|
||||
if v, err := strconv.ParseFloat(strings.TrimSpace(string(b)), 64); err == nil {
|
||||
h.TempC = v / 1000
|
||||
}
|
||||
}
|
||||
case "darwin":
|
||||
// macOS 没有 /proc,走 sysctl / vm_stat;每次 health 只 fork 三四个进程,频率极低
|
||||
if v, err := sysctlValue("hw.memsize"); err == nil {
|
||||
if n, err := strconv.ParseInt(v, 10, 64); err == nil {
|
||||
h.MemTotalMB = n >> 20
|
||||
}
|
||||
}
|
||||
// 开机时长:kern.boottime 形如 { sec = 1794298276, usec = 155984 } Tue Nov 10 …
|
||||
if v, err := sysctlValue("kern.boottime"); err == nil {
|
||||
if i := strings.Index(v, "sec = "); i >= 0 {
|
||||
rest := v[i+6:]
|
||||
if j := strings.IndexAny(rest, ",}"); j > 0 {
|
||||
if sec, err := strconv.ParseInt(strings.TrimSpace(rest[:j]), 10, 64); err == nil {
|
||||
h.HostUptimeSec = time.Now().Unix() - sec
|
||||
}
|
||||
}
|
||||
}
|
||||
}
|
||||
// 负载:vm.loadavg 形如 { 1.11 1.40 1.59 }
|
||||
if v, err := sysctlValue("vm.loadavg"); err == nil {
|
||||
f := strings.FieldsFunc(v, func(r rune) bool { return r == '{' || r == '}' || r == ' ' })
|
||||
if len(f) >= 3 {
|
||||
h.Load1, _ = strconv.ParseFloat(f[0], 64)
|
||||
h.Load5, _ = strconv.ParseFloat(f[1], 64)
|
||||
h.Load15, _ = strconv.ParseFloat(f[2], 64)
|
||||
}
|
||||
}
|
||||
// 可用内存 ≈ free + inactive + speculative:macOS 上只看 free 会小得吓人(大半是缓存)
|
||||
if mb := darwinAvailableMB(); mb >= 0 {
|
||||
h.MemFreeMB = mb
|
||||
}
|
||||
}
|
||||
|
||||
var st syscall.Statfs_t
|
||||
if err := syscall.Statfs("/", &st); err == nil {
|
||||
h.DiskTotalGB = float64(st.Blocks) * float64(st.Bsize) / (1 << 30)
|
||||
h.DiskFreeGB = float64(st.Bavail) * float64(st.Bsize) / (1 << 30)
|
||||
}
|
||||
return h
|
||||
}
|
||||
|
||||
// sysctlValue 读一个 sysctl 键,1s 超时兜底。
|
||||
func sysctlValue(key string) (string, error) {
|
||||
ctx, cancel := context.WithTimeout(context.Background(), time.Second)
|
||||
defer cancel()
|
||||
out, err := exec.CommandContext(ctx, "sysctl", "-n", key).Output()
|
||||
if err != nil {
|
||||
return "", err
|
||||
}
|
||||
return strings.TrimSpace(string(out)), nil
|
||||
}
|
||||
|
||||
// darwinAvailableMB 解析 vm_stat,返回 free+inactive+speculative 的 MB 数;解析失败给 -1。
|
||||
func darwinAvailableMB() int64 {
|
||||
ctx, cancel := context.WithTimeout(context.Background(), 1200*time.Millisecond)
|
||||
defer cancel()
|
||||
out, err := exec.CommandContext(ctx, "vm_stat").Output()
|
||||
if err != nil {
|
||||
return -1
|
||||
}
|
||||
pageSize := int64(4096)
|
||||
free, inactive, speculative := int64(-1), int64(0), int64(0)
|
||||
for _, line := range strings.Split(string(out), "\n") {
|
||||
if i := strings.Index(line, "page size of "); i >= 0 {
|
||||
rest := line[i+len("page size of "):]
|
||||
if j := strings.Index(rest, " bytes"); j > 0 {
|
||||
if v, err := strconv.ParseInt(rest[:j], 10, 64); err == nil {
|
||||
pageSize = v
|
||||
}
|
||||
}
|
||||
continue
|
||||
}
|
||||
num := func(prefix string) (int64, bool) {
|
||||
if !strings.HasPrefix(line, prefix) {
|
||||
return 0, false
|
||||
}
|
||||
v, err := strconv.ParseInt(strings.TrimSuffix(strings.TrimSpace(line[len(prefix):]), "."), 10, 64)
|
||||
return v, err == nil
|
||||
}
|
||||
if v, ok := num("Pages free:"); ok {
|
||||
free = v
|
||||
}
|
||||
if v, ok := num("Pages inactive:"); ok {
|
||||
inactive = v
|
||||
}
|
||||
if v, ok := num("Pages speculative:"); ok {
|
||||
speculative = v
|
||||
}
|
||||
}
|
||||
if free < 0 {
|
||||
return -1
|
||||
}
|
||||
return (free + inactive + speculative) * pageSize / (1 << 20)
|
||||
}
|
||||
@@ -0,0 +1,67 @@
|
||||
//go:build windows
|
||||
|
||||
package main
|
||||
|
||||
// Windows 指标:GetTickCount64(开机时长)+ GlobalMemoryStatusEx + GetDiskFreeSpaceExW。
|
||||
// 负载/温度在 Windows 上没有等价指标,返回 -1。
|
||||
|
||||
import (
|
||||
"syscall"
|
||||
"unsafe"
|
||||
)
|
||||
|
||||
type healthInfo struct {
|
||||
HostUptimeSec int64
|
||||
Load1, Load5, Load15 float64
|
||||
MemTotalMB, MemFreeMB int64
|
||||
DiskTotalGB, DiskFreeGB float64
|
||||
TempC float64
|
||||
}
|
||||
|
||||
var (
|
||||
kernel32 = syscall.NewLazyDLL("kernel32.dll")
|
||||
procTick = kernel32.NewProc("GetTickCount64")
|
||||
procMem = kernel32.NewProc("GlobalMemoryStatusEx")
|
||||
procDiskF = kernel32.NewProc("GetDiskFreeSpaceExW")
|
||||
)
|
||||
|
||||
type memStatusEx struct {
|
||||
Length uint32
|
||||
MemoryLoad uint32
|
||||
TotalPhys uint64
|
||||
AvailPhys uint64
|
||||
TotalPageFile uint64
|
||||
AvailPageFile uint64
|
||||
TotalVirtual uint64
|
||||
AvailVirtual uint64
|
||||
AvailExtendedVirtual uint64
|
||||
}
|
||||
|
||||
func hostHealth() healthInfo {
|
||||
h := healthInfo{
|
||||
HostUptimeSec: -1, Load1: -1, Load5: -1, Load15: -1,
|
||||
MemTotalMB: -1, MemFreeMB: -1, DiskTotalGB: -1, DiskFreeGB: -1, TempC: -1,
|
||||
}
|
||||
if r, _, _ := procTick.Call(); r != 0 {
|
||||
h.HostUptimeSec = int64(r / 1000)
|
||||
}
|
||||
var m memStatusEx
|
||||
m.Length = uint32(unsafe.Sizeof(m))
|
||||
if r, _, _ := procMem.Call(uintptr(unsafe.Pointer(&m))); r != 0 {
|
||||
h.MemTotalMB = int64(m.TotalPhys >> 20)
|
||||
h.MemFreeMB = int64(m.AvailPhys >> 20)
|
||||
}
|
||||
if p, err := syscall.UTF16PtrFromString("C:\\"); err == nil {
|
||||
var free, total, totalFree uint64
|
||||
if r, _, _ := procDiskF.Call(
|
||||
uintptr(unsafe.Pointer(p)),
|
||||
uintptr(unsafe.Pointer(&free)),
|
||||
uintptr(unsafe.Pointer(&total)),
|
||||
uintptr(unsafe.Pointer(&totalFree)),
|
||||
); r != 0 {
|
||||
h.DiskTotalGB = float64(total) / (1 << 30)
|
||||
h.DiskFreeGB = float64(free) / (1 << 30)
|
||||
}
|
||||
}
|
||||
return h
|
||||
}
|
||||
@@ -0,0 +1,522 @@
|
||||
// agent-device:跑在盒子 / Windows / 任意 Linux 上,主动出站连 core 的 wss,接收并执行命令。
|
||||
//
|
||||
// agent-device -server wss://your-host.example/dev/ws -token <TOKEN> -root /var/agent/work
|
||||
// agent-device # 自动读同目录下的 config.json(token 不进 ps)
|
||||
//
|
||||
// 设计约束(对齐 files/print/agent):
|
||||
// - 只出站,服务器不需要任何入站端口
|
||||
// - 断线指数退避重连,半开连接靠读超时兜底
|
||||
// - 单机不依赖 Node / 不装运行时,一个二进制跑起来
|
||||
package main
|
||||
|
||||
import (
|
||||
"context"
|
||||
"encoding/json"
|
||||
"errors"
|
||||
"flag"
|
||||
"io"
|
||||
"log"
|
||||
"os"
|
||||
"os/exec"
|
||||
"path/filepath"
|
||||
"runtime"
|
||||
"strings"
|
||||
"sync"
|
||||
"sync/atomic"
|
||||
"time"
|
||||
"unicode/utf8"
|
||||
|
||||
"agent-device/pkg/proto"
|
||||
"agent-device/pkg/wsnode"
|
||||
"golang.org/x/text/encoding/simplifiedchinese"
|
||||
)
|
||||
|
||||
const version = "0.1.1"
|
||||
|
||||
var (
|
||||
maxOutBytes = int64(4 << 20) // 单条命令回传上限,超出截断并标记
|
||||
maxParallel = 4 // 同机并发执行数
|
||||
)
|
||||
|
||||
type proc struct {
|
||||
cmd *exec.Cmd
|
||||
mu sync.Mutex
|
||||
kln string // 终止原因:cancelled / timeout
|
||||
}
|
||||
|
||||
func (p *proc) kill(reason string) {
|
||||
p.mu.Lock()
|
||||
if p.kln == "" {
|
||||
p.kln = reason
|
||||
}
|
||||
p.mu.Unlock()
|
||||
killProc(p.cmd)
|
||||
}
|
||||
|
||||
func (p *proc) killed() string {
|
||||
p.mu.Lock()
|
||||
defer p.mu.Unlock()
|
||||
return p.kln
|
||||
}
|
||||
|
||||
// fileConfig 是 -config 读的 JSON,字段全部可选:没写的落到命令行/默认值。
|
||||
// 之所以需要它:token 写在命令行会被 ps 看见。
|
||||
type fileConfig struct {
|
||||
Server string `json:"server"`
|
||||
Token string `json:"token"`
|
||||
Root string `json:"root"`
|
||||
Name string `json:"name"`
|
||||
Shell string `json:"shell"`
|
||||
Insecure *bool `json:"insecure"`
|
||||
}
|
||||
|
||||
var startedAt = time.Now()
|
||||
|
||||
type runner struct {
|
||||
conn *wsnode.Conn
|
||||
root string
|
||||
shell string
|
||||
sem chan struct{}
|
||||
|
||||
mu sync.Mutex
|
||||
procs map[string]*proc
|
||||
|
||||
files *fileMgr // 文件通道:core 拉取/推送文件时的在途写入
|
||||
}
|
||||
|
||||
func main() {
|
||||
server := flag.String("server", "", "core 的接入地址,如 wss://your-host.example/dev/ws")
|
||||
token := flag.String("token", "", "Bearer token(或环境变量 NODE_TOKEN,或写在 -config 里)")
|
||||
root := flag.String("root", "", "工作根目录(默认 ~/agent-work),命令的 cwd 必须落在它之内")
|
||||
shellName := flag.String("shell", "", "sh | cmd | powershell(默认按平台)")
|
||||
name := flag.String("name", "", "设备名(默认 hostname)")
|
||||
configPath := flag.String("config", "", "JSON 配置文件;不给时自动找可执行文件同目录的 config.json")
|
||||
insecure := flag.Bool("insecure", false, "跳过证书校验")
|
||||
fixClock := flag.Bool("fix-clock", false, "证书失败时用服务器时间校准本机(Linux 需 root)")
|
||||
flag.Parse()
|
||||
|
||||
// 优先级:命令行显式参数 > 环境变量(仅 token)> 配置文件 > 默认值。
|
||||
// 配置文件的意义是把 token 从命令行拿掉——ps aux 能看见所有参数。
|
||||
set := map[string]bool{}
|
||||
flag.Visit(func(f *flag.Flag) { set[f.Name] = true })
|
||||
// 配置文件默认位置:可执行文件同目录的 config.json。放二进制旁边就不用带参数,
|
||||
// token 也不会出现在 ps 里。命令行显式给的 -config 优先。
|
||||
effectiveCfg := *configPath
|
||||
if effectiveCfg == "" {
|
||||
if dir := exeDir(); dir != "" {
|
||||
p := filepath.Join(dir, "config.json")
|
||||
if _, err := os.Stat(p); err == nil {
|
||||
effectiveCfg = p
|
||||
}
|
||||
}
|
||||
}
|
||||
if effectiveCfg != "" {
|
||||
var fc fileConfig
|
||||
b, err := os.ReadFile(effectiveCfg)
|
||||
if err != nil {
|
||||
log.Fatalf("读配置失败:%v", err)
|
||||
}
|
||||
if err := json.Unmarshal(b, &fc); err != nil {
|
||||
log.Fatalf("配置 %s 不是合法 JSON:%v", effectiveCfg, err)
|
||||
}
|
||||
log.Printf("已加载配置 %s", effectiveCfg)
|
||||
if !set["server"] && fc.Server != "" {
|
||||
*server = fc.Server
|
||||
}
|
||||
if !set["token"] && fc.Token != "" {
|
||||
*token = fc.Token
|
||||
}
|
||||
if !set["root"] && fc.Root != "" {
|
||||
*root = fc.Root
|
||||
}
|
||||
if !set["name"] && fc.Name != "" {
|
||||
*name = fc.Name
|
||||
}
|
||||
if !set["shell"] && fc.Shell != "" {
|
||||
*shellName = fc.Shell
|
||||
}
|
||||
if !set["insecure"] && fc.Insecure != nil {
|
||||
*insecure = *fc.Insecure
|
||||
}
|
||||
}
|
||||
if *token == "" {
|
||||
*token = os.Getenv("NODE_TOKEN")
|
||||
}
|
||||
|
||||
if *server == "" {
|
||||
log.Fatal("缺少 -server(或配置文件里的 server)")
|
||||
}
|
||||
if *token == "" {
|
||||
log.Fatal("缺少 token:用 -token / NODE_TOKEN / 配置文件")
|
||||
}
|
||||
|
||||
r := &runner{
|
||||
root: *root,
|
||||
shell: *shellName,
|
||||
sem: make(chan struct{}, maxParallel),
|
||||
procs: map[string]*proc{},
|
||||
files: newFileMgr(),
|
||||
}
|
||||
if r.root == "" {
|
||||
home, _ := os.UserHomeDir()
|
||||
r.root = filepath.Join(home, "agent-work")
|
||||
}
|
||||
r.root = filepath.Clean(r.root)
|
||||
// 相对路径按可执行文件所在目录解析:双击、服务、命令行启动都得到同一个工作区,
|
||||
// 不受进程当前目录影响;同时不允许用 ".." 跑到 exe 目录之外。
|
||||
if !filepath.IsAbs(r.root) {
|
||||
dir := exeDir()
|
||||
if dir == "" {
|
||||
log.Fatalf("工作根 %q 是相对路径,但取不到可执行文件位置", r.root)
|
||||
}
|
||||
abs := filepath.Join(dir, r.root)
|
||||
rel, err := filepath.Rel(dir, abs)
|
||||
if err != nil || rel == ".." || strings.HasPrefix(rel, ".."+string(filepath.Separator)) {
|
||||
log.Fatalf("工作根 %q 超出可执行文件目录:%s", r.root, abs)
|
||||
}
|
||||
r.root = abs
|
||||
}
|
||||
if err := os.MkdirAll(r.root, 0o755); err != nil {
|
||||
log.Fatalf("工作根不可用:%v", err)
|
||||
}
|
||||
// 进程 cwd 失效时(快捷方式的「起始位置」指向已删目录、启动目录被改名等),
|
||||
// Windows 上 os/exec 给 nil Stdin 打开空设备 "NUL" 是个相对路径调用,会直接报
|
||||
// 「找不到文件」,任何命令都起不来(含下面的 shellInfo 探测)。工作根刚 MkdirAll 过,
|
||||
// 钉在这里;失败也不致命,后面 run() 还有一层不依赖 NUL 的兵底。
|
||||
if err := os.Chdir(r.root); err != nil {
|
||||
log.Printf("切换工作目录失败(不影响命令执行):%v", err)
|
||||
}
|
||||
if r.shell == "" {
|
||||
r.shell = defaultShell()
|
||||
}
|
||||
host, _ := os.Hostname()
|
||||
if *name != "" {
|
||||
host = *name
|
||||
}
|
||||
|
||||
log.Printf("agent-device %s 启动:root=%s shell=%s → %s", version, r.root, shellKind(r.shell), *server)
|
||||
shPath, shVer := shellInfo(r.shell)
|
||||
log.Printf("shell:%s(%s %s)", r.shell, shPath, shVer)
|
||||
cfg := wsnode.Config{URL: *server, Token: *token, Insecure: *insecure, FixClock: *fixClock}
|
||||
err := wsnode.Run(context.Background(), cfg,
|
||||
func(c *wsnode.Conn) error {
|
||||
r.conn = c
|
||||
if err := c.Send(proto.Msg{
|
||||
T: proto.TKindHello, Ver: version, Name: host,
|
||||
OS: runtime.GOOS, Arch: runtime.GOARCH,
|
||||
Shell: shellKind(r.shell), ShellPath: shPath, ShellVer: shVer, Root: r.root,
|
||||
}); err != nil {
|
||||
return err
|
||||
}
|
||||
log.Printf("已连上 hub(%s/%s shell=%s %s)", runtime.GOOS, runtime.GOARCH, shPath, shVer)
|
||||
return nil
|
||||
},
|
||||
func(c *wsnode.Conn, t string, raw []byte) {
|
||||
var m proto.Msg
|
||||
if json.Unmarshal(raw, &m) != nil {
|
||||
return
|
||||
}
|
||||
switch t {
|
||||
case proto.TKindExec:
|
||||
go r.run(m)
|
||||
case proto.TKindKill:
|
||||
if p := r.lookup(m.ID); p != nil {
|
||||
p.kill("cancelled")
|
||||
}
|
||||
case proto.TKindPing:
|
||||
_ = c.Send(proto.Msg{T: proto.TKindPong})
|
||||
case proto.TKindFile:
|
||||
// write 的建栅必须同步完成:core 紧接着就发 chunk,异步会先到后建、丢块
|
||||
r.fileStart(c, m)
|
||||
case proto.TKindFileChunk:
|
||||
r.fileChunk(c, m)
|
||||
case proto.TKindFileDone:
|
||||
r.fileEnd(c, m)
|
||||
case proto.TKindHealth:
|
||||
h := hostHealth()
|
||||
m := proto.Msg{
|
||||
T: proto.TKindHealth, ID: m.ID,
|
||||
UptimeSec: int64(time.Since(startedAt).Seconds()), HostUptimeSec: h.HostUptimeSec,
|
||||
Load1: h.Load1, Load5: h.Load5, Load15: h.Load15,
|
||||
MemTotalMB: h.MemTotalMB, MemFreeMB: h.MemFreeMB,
|
||||
DiskTotalGB: h.DiskTotalGB, DiskFreeGB: h.DiskFreeGB, TempC: h.TempC,
|
||||
OS: runtime.GOOS, Arch: runtime.GOARCH, Name: host,
|
||||
}
|
||||
_ = c.Send(m)
|
||||
}
|
||||
})
|
||||
log.Printf("退出:%v", err)
|
||||
}
|
||||
|
||||
func (r *runner) lookup(id string) *proc {
|
||||
r.mu.Lock()
|
||||
defer r.mu.Unlock()
|
||||
return r.procs[id]
|
||||
}
|
||||
|
||||
func (r *runner) send(m proto.Msg) { _ = r.conn.Send(m) }
|
||||
|
||||
func (r *runner) exit(id string, code int, killed, errMsg string, truncated bool, ms int64) {
|
||||
m := proto.Msg{T: proto.TKindExit, ID: id, Code: &code, Killed: killed, Err: errMsg, MS: ms, Truncated: truncated}
|
||||
r.send(m)
|
||||
}
|
||||
|
||||
// run 执行一条命令:并发闸门 → cwd 校验 → 起进程组 → 流式回传 → 退出码。
|
||||
func (r *runner) run(m proto.Msg) {
|
||||
select {
|
||||
case r.sem <- struct{}{}:
|
||||
case <-time.After(30 * time.Second):
|
||||
r.exit(m.ID, -1, "", "节点忙:排队超过 30 秒", false, 0)
|
||||
return
|
||||
}
|
||||
defer func() { <-r.sem }()
|
||||
|
||||
dir, err := r.resolveCwd(m.Cwd)
|
||||
if err != nil {
|
||||
r.exit(m.ID, -1, "", err.Error(), false, 0)
|
||||
return
|
||||
}
|
||||
tmo := time.Duration(m.TimeoutMS) * time.Millisecond
|
||||
if tmo <= 0 {
|
||||
tmo = 5 * time.Minute
|
||||
}
|
||||
|
||||
ctx, cancel := context.WithTimeout(context.Background(), tmo)
|
||||
defer cancel()
|
||||
|
||||
sh, shArgs := shellCmd(r.shell)
|
||||
cmd := newCmd(ctx, sh, append(shArgs, m.Cmd)...)
|
||||
cmd.Dir = dir
|
||||
if len(m.Env) > 0 {
|
||||
cmd.Env = append(os.Environ(), flatten(m.Env)...)
|
||||
}
|
||||
cmd.Cancel = func() error { killProc(cmd); return nil } // 超时/取消时整组杀,不只杀 sh
|
||||
setupProc(cmd)
|
||||
|
||||
outPipe, err1 := cmd.StdoutPipe()
|
||||
errPipe, err2 := cmd.StderrPipe()
|
||||
if err1 != nil || err2 != nil {
|
||||
r.exit(m.ID, 127, "", "取管道失败", false, 0)
|
||||
return
|
||||
}
|
||||
|
||||
p := &proc{cmd: cmd}
|
||||
r.mu.Lock()
|
||||
r.procs[m.ID] = p
|
||||
r.mu.Unlock()
|
||||
defer func() {
|
||||
r.mu.Lock()
|
||||
delete(r.procs, m.ID)
|
||||
r.mu.Unlock()
|
||||
}()
|
||||
|
||||
started := time.Now()
|
||||
if err := cmd.Start(); err != nil {
|
||||
r.exit(m.ID, 127, "", "启动失败:"+err.Error(), false, 0)
|
||||
return
|
||||
}
|
||||
|
||||
var sent atomic.Int64
|
||||
var truncated atomic.Bool
|
||||
var wg sync.WaitGroup
|
||||
pump := func(rd io.Reader, stream string) {
|
||||
defer wg.Done()
|
||||
buf := make([]byte, 32<<10)
|
||||
for {
|
||||
n, rerr := rd.Read(buf)
|
||||
if n > 0 {
|
||||
if sent.Load() >= maxOutBytes {
|
||||
truncated.Store(true)
|
||||
} else {
|
||||
chunk := make([]byte, n)
|
||||
copy(chunk, buf[:n])
|
||||
sent.Add(int64(n))
|
||||
r.send(proto.Msg{T: proto.TKindChunk, ID: m.ID, Out: stream, Stream: chunk})
|
||||
}
|
||||
}
|
||||
if rerr != nil {
|
||||
return
|
||||
}
|
||||
}
|
||||
}
|
||||
wg.Add(2)
|
||||
go pump(outPipe, "out")
|
||||
go pump(errPipe, "err")
|
||||
wg.Wait()
|
||||
werr := cmd.Wait()
|
||||
|
||||
code := 0
|
||||
if werr != nil {
|
||||
var ee *exec.ExitError
|
||||
if errors.As(werr, &ee) {
|
||||
code = ee.ExitCode()
|
||||
} else {
|
||||
code = 127
|
||||
}
|
||||
}
|
||||
killed := p.killed()
|
||||
if killed == "" && ctx.Err() == context.DeadlineExceeded {
|
||||
killed = "timeout"
|
||||
}
|
||||
if killed != "" && code == 0 {
|
||||
code = -1
|
||||
}
|
||||
r.exit(m.ID, code, killed, "", truncated.Load(), time.Since(started).Milliseconds())
|
||||
}
|
||||
|
||||
// resolveCwd:hub 已把服务器路径重写成节点路径,这里只保证落在 root 之内并自动建目录。
|
||||
func (r *runner) resolveCwd(raw string) (string, error) {
|
||||
if raw == "" {
|
||||
return r.root, nil
|
||||
}
|
||||
if !filepath.IsAbs(raw) {
|
||||
return "", errors.New("cwd 必须是绝对路径:" + raw)
|
||||
}
|
||||
cwd := filepath.Clean(raw)
|
||||
rel, err := filepath.Rel(r.root, cwd)
|
||||
if err != nil || rel == ".." || strings.HasPrefix(rel, ".."+string(filepath.Separator)) {
|
||||
return "", errors.New("cwd 超出工作根:" + cwd)
|
||||
}
|
||||
if err := os.MkdirAll(cwd, 0o755); err != nil {
|
||||
return "", errors.New("建目录失败:" + err.Error())
|
||||
}
|
||||
return cwd, nil
|
||||
}
|
||||
|
||||
func flatten(env map[string]string) []string {
|
||||
out := make([]string, 0, len(env))
|
||||
for k, v := range env {
|
||||
out = append(out, k+"="+v)
|
||||
}
|
||||
return out
|
||||
}
|
||||
|
||||
// exeDir 返回可执行文件所在目录(解开软链接)。相对的工作根、默认配置都基于它。
|
||||
func exeDir() string {
|
||||
exe, err := os.Executable()
|
||||
if err != nil {
|
||||
return ""
|
||||
}
|
||||
if real, err := filepath.EvalSymlinks(exe); err == nil {
|
||||
exe = real
|
||||
}
|
||||
return filepath.Dir(exe)
|
||||
}
|
||||
|
||||
// defaultShell 选默认解释器。POSIX 上固定 /bin/sh(不读 $SHELL:用户把 shell 设成 fish
|
||||
// 之后模型写的 POSIX 语法全废);Windows 默认 cmd,想用 git-bash / busybox 就在
|
||||
// config.json 里写 "shell": "C:\\Program Files\\Git\\bin\\bash.exe"(或 PATH 里的名字)。
|
||||
func defaultShell() string {
|
||||
if runtime.GOOS == "windows" {
|
||||
return "cmd"
|
||||
}
|
||||
return "sh"
|
||||
}
|
||||
|
||||
// shellKind 把路径/命令名归成一个短标签给 core 看(hello 的 shell 字段)。
|
||||
func shellKind(p string) string {
|
||||
b := strings.ToLower(filepath.Base(p))
|
||||
switch {
|
||||
case strings.Contains(b, "busybox"):
|
||||
return "busybox"
|
||||
case strings.Contains(b, "bash"):
|
||||
return "bash"
|
||||
case b == "sh" || b == "sh.exe" || b == "/bin/sh":
|
||||
return "sh"
|
||||
case strings.Contains(b, "powershell"), b == "pwsh", b == "pwsh.exe":
|
||||
return "powershell"
|
||||
case b == "cmd" || b == "cmd.exe":
|
||||
return "cmd"
|
||||
}
|
||||
return p
|
||||
}
|
||||
|
||||
// newCmd 统一构造要执行的命令:Stdin 显式给一个空 reader。
|
||||
// 不给(nil)时 os/exec 会自己 os.Open(os.DevNull),Windows 上那是相对路径的设备名
|
||||
// "NUL"——有的机器上 CreateFile 直接报 ERROR_FILE_NOT_FOUND,命令还没到 shell 就死了
|
||||
//(实测 pc-gd:所有 exec 都 exit 127 "open NUL: The system cannot find the file specified")。
|
||||
// 空 reader 与 NUL 语义一致(子进程读到立即 EOF),且不依赖进程 cwd。
|
||||
func newCmd(ctx context.Context, name string, args ...string) *exec.Cmd {
|
||||
c := exec.CommandContext(ctx, name, args...)
|
||||
c.Stdin = strings.NewReader("")
|
||||
return c
|
||||
}
|
||||
|
||||
func shellCmd(name string) (string, []string) {
|
||||
switch name {
|
||||
case "cmd":
|
||||
return "cmd", []string{"/c"}
|
||||
case "powershell", "pwsh":
|
||||
return name, []string{"-NoProfile", "-NonInteractive", "-Command"}
|
||||
}
|
||||
// busybox 的子命令形式:busybox sh -c "…"
|
||||
if strings.Contains(strings.ToLower(filepath.Base(name)), "busybox") {
|
||||
return name, []string{"sh", "-c"}
|
||||
}
|
||||
// 带路径的(git-bash 绝对路径、/bin/sh)直接当 POSIX shell 用
|
||||
if strings.ContainsAny(name, `\/`) {
|
||||
return name, []string{"-c"}
|
||||
}
|
||||
if runtime.GOOS == "windows" {
|
||||
return "cmd", []string{"/c"}
|
||||
}
|
||||
if _, err := os.Stat("/bin/sh"); err == nil {
|
||||
return "/bin/sh", []string{"-c"}
|
||||
}
|
||||
return "sh", []string{"-c"}
|
||||
}
|
||||
|
||||
// toUTF8 把 Windows 中文控制台吐出的 GBK 字节转成 UTF-8。
|
||||
// 先过 utf8.Valid:纯 ASCII / 真 UTF-8(英文版 Windows、开了 UTF-8 的系统)一律原样返回,
|
||||
// 不会被误转;只有不是合法 UTF-8 时才按 GBK 解,解不出来就保留原样。
|
||||
func toUTF8(b []byte) []byte {
|
||||
if utf8.Valid(b) {
|
||||
return b
|
||||
}
|
||||
if d, err := simplifiedchinese.GBK.NewDecoder().Bytes(b); err == nil {
|
||||
return d
|
||||
}
|
||||
return b
|
||||
}
|
||||
|
||||
// shellInfo 探测实际解释器与版本。这是模型写命令的唯一入口,所以路径要解开符号链接
|
||||
// (/bin/sh 可能是 dash / bash / busybox),版本拿不到就留空(dash、busybox 不支持 --version)。
|
||||
func shellInfo(name string) (string, string) {
|
||||
bin, _ := shellCmd(name)
|
||||
p, err := exec.LookPath(bin)
|
||||
if err != nil {
|
||||
return "", ""
|
||||
}
|
||||
if real, err := filepath.EvalSymlinks(p); err == nil {
|
||||
p = real
|
||||
}
|
||||
|
||||
ctx, cancel := context.WithTimeout(context.Background(), 800*time.Millisecond)
|
||||
defer cancel()
|
||||
|
||||
var c *exec.Cmd
|
||||
switch name {
|
||||
case "cmd":
|
||||
c = newCmd(ctx, "cmd", "/c", "ver")
|
||||
case "powershell", "pwsh":
|
||||
c = newCmd(ctx, bin, "-NoProfile", "-NonInteractive", "-Command",
|
||||
"$PSVersionTable.PSVersion.ToString()")
|
||||
default:
|
||||
c = newCmd(ctx, p, "--version")
|
||||
}
|
||||
out, _ := c.Output()
|
||||
out = toUTF8(out) // 中文 Windows 的 ver 是 GBK;本来就是 UTF-8 的原样返回
|
||||
|
||||
ver := ""
|
||||
if s := strings.TrimSpace(string(out)); s != "" {
|
||||
if i := strings.IndexByte(s, '\n'); i > 0 {
|
||||
s = s[:i]
|
||||
}
|
||||
s = strings.TrimSpace(s)
|
||||
if len(s) > 60 {
|
||||
s = s[:60] + "…"
|
||||
}
|
||||
ver = s
|
||||
}
|
||||
return p, ver
|
||||
}
|
||||
@@ -0,0 +1,21 @@
|
||||
//go:build !windows
|
||||
|
||||
package main
|
||||
|
||||
import (
|
||||
"os/exec"
|
||||
"syscall"
|
||||
)
|
||||
|
||||
// setupProc 让命令自成一个进程组,后面才能整组杀(sh 拉起的子进程一起收)。
|
||||
func setupProc(cmd *exec.Cmd) {
|
||||
cmd.SysProcAttr = &syscall.SysProcAttr{Setpgid: true}
|
||||
}
|
||||
|
||||
// killProc 负号 = 整个进程组。忽略错误:进程可能已自行退出。
|
||||
func killProc(cmd *exec.Cmd) {
|
||||
if cmd == nil || cmd.Process == nil {
|
||||
return
|
||||
}
|
||||
_ = syscall.Kill(-cmd.Process.Pid, syscall.SIGKILL)
|
||||
}
|
||||
@@ -0,0 +1,25 @@
|
||||
//go:build windows
|
||||
|
||||
package main
|
||||
|
||||
import (
|
||||
"context"
|
||||
"os/exec"
|
||||
"strconv"
|
||||
"syscall"
|
||||
)
|
||||
|
||||
const createNewProcessGroup = 0x00000200
|
||||
|
||||
// setupProc 让命令自成一组,taskkill /T 才能连子进程一起收。
|
||||
func setupProc(cmd *exec.Cmd) {
|
||||
cmd.SysProcAttr = &syscall.SysProcAttr{CreationFlags: createNewProcessGroup}
|
||||
}
|
||||
|
||||
func killProc(cmd *exec.Cmd) {
|
||||
if cmd == nil || cmd.Process == nil {
|
||||
return
|
||||
}
|
||||
_ = newCmd(context.Background(), "taskkill", "/T", "/F", "/PID", strconv.Itoa(cmd.Process.Pid)).Run()
|
||||
_ = cmd.Process.Kill()
|
||||
}
|
||||
@@ -0,0 +1,7 @@
|
||||
module agent-device
|
||||
|
||||
go 1.22
|
||||
|
||||
require github.com/gorilla/websocket v1.5.3
|
||||
|
||||
require golang.org/x/text v0.21.0
|
||||
@@ -0,0 +1,4 @@
|
||||
github.com/gorilla/websocket v1.5.3 h1:saDtZ6Pbx/0u+bgYQ3q96pZgCzfhKXGPqt7kZ72aNNg=
|
||||
github.com/gorilla/websocket v1.5.3/go.mod h1:YR8l580nyteQvAITg2hZ9XVh4b55+EU/adAjf1fMHhE=
|
||||
golang.org/x/text v0.21.0 h1:zyQAAkrwaneQ066sspRyJaG9VNi/YJ1NfzcGB3hZ/qo=
|
||||
golang.org/x/text v0.21.0/go.mod h1:4IBbMaMmOPCJ8SecivzSH54+73PCFmPWxNTLm+vZkEQ=
|
||||
@@ -0,0 +1,68 @@
|
||||
// Package proto 定义 hub 与节点之间的消息。一条连接上全是 JSON 文本帧,
|
||||
// 用 t 字段区分类型;二进制数据(命令输出)走 chunk 字段,encoding/json 自动 base64。
|
||||
package proto
|
||||
|
||||
// 消息类型
|
||||
const (
|
||||
TKindHello = "hello" // 节点 → hub:上线自报家门
|
||||
TKindExec = "exec" // hub → 节点:执行一条命令
|
||||
TKindKill = "kill" // hub → 节点:终止某条命令
|
||||
TKindChunk = "chunk" // 节点 → hub:输出片段
|
||||
TKindExit = "exit" // 节点 → hub:命令结束
|
||||
TKindPing = "ping" // hub → 节点:保活
|
||||
TKindPong = "pong" // 节点 → hub:保活回应
|
||||
TKindHealth = "health" // 双向:hub 要指标 / 节点回指标
|
||||
TKindFile = "file" // 双向:core 发起一次 read/write
|
||||
TKindFileChunk = "file.chunk" // 双向:文件数据块(base64)
|
||||
TKindFileDone = "file.done" // 双向:结束,带 size / sha256 / err
|
||||
)
|
||||
|
||||
// Msg 是双向通用信封:不同 t 只用其中一部分字段,其余 omitempty。
|
||||
type Msg struct {
|
||||
T string `json:"t"`
|
||||
|
||||
// hello
|
||||
Ver string `json:"ver,omitempty"`
|
||||
Name string `json:"name,omitempty"`
|
||||
OS string `json:"os,omitempty"`
|
||||
Arch string `json:"arch,omitempty"`
|
||||
Shell string `json:"shell,omitempty"` // 逻辑名:sh / cmd / powershell
|
||||
ShellPath string `json:"shell_path,omitempty"` // 实际解释器路径(符号链接已解开)
|
||||
ShellVer string `json:"shell_ver,omitempty"` // 版本首行(拿不到就留空)
|
||||
Root string `json:"root,omitempty"`
|
||||
|
||||
// exec / kill
|
||||
ID string `json:"id,omitempty"`
|
||||
Cmd string `json:"cmd,omitempty"`
|
||||
Cwd string `json:"cwd,omitempty"`
|
||||
TimeoutMS int `json:"timeout_ms,omitempty"`
|
||||
Env map[string]string `json:"env,omitempty"`
|
||||
|
||||
// chunk / exit
|
||||
Stream []byte `json:"chunk,omitempty"` // 原始字节,JSON 里是 base64
|
||||
Out string `json:"out,omitempty"` // "out" | "err"
|
||||
Code *int `json:"code,omitempty"`
|
||||
Killed string `json:"killed_by,omitempty"` // cancelled | timeout
|
||||
MS int64 `json:"ms,omitempty"`
|
||||
Err string `json:"err,omitempty"`
|
||||
Truncated bool `json:"truncated,omitempty"`
|
||||
|
||||
// health(hub 请求 / 节点回报共用)
|
||||
UptimeSec int64 `json:"uptime_sec,omitempty"` // 本进程已运行秒数
|
||||
HostUptimeSec int64 `json:"host_uptime_sec,omitempty"` // 主机开机秒数(不支持为 -1)
|
||||
Load1 float64 `json:"load1,omitempty"`
|
||||
Load5 float64 `json:"load5,omitempty"`
|
||||
Load15 float64 `json:"load15,omitempty"`
|
||||
MemTotalMB int64 `json:"mem_total_mb,omitempty"`
|
||||
MemFreeMB int64 `json:"mem_free_mb,omitempty"`
|
||||
DiskTotalGB float64 `json:"disk_total_gb,omitempty"`
|
||||
DiskFreeGB float64 `json:"disk_free_gb,omitempty"`
|
||||
TempC float64 `json:"temp_c,omitempty"`
|
||||
|
||||
// file(read/write 共用一个 信封)
|
||||
Op string `json:"op,omitempty"` // read | write
|
||||
Path string `json:"path,omitempty"` // 设备侧绝对路径,必须在 root 内
|
||||
Size int64 `json:"size,omitempty"` // 文件字节数
|
||||
SHA string `json:"sha256,omitempty"` // 文件内容的 sha256(传完对账)
|
||||
Data []byte `json:"data,omitempty"` // 数据块(JSON 里是 base64)
|
||||
}
|
||||
@@ -0,0 +1,210 @@
|
||||
// Package wsnode 是「节点主动出站 + 断线重连 + 心跳保活」的最小 WebSocket 基座。
|
||||
// 语义与 files/print/agent 一致:节点在 NAT 后面也能被驱动,服务器不需要任何入站端口。
|
||||
package wsnode
|
||||
|
||||
import (
|
||||
"context"
|
||||
"crypto/tls"
|
||||
"crypto/x509"
|
||||
"encoding/json"
|
||||
"fmt"
|
||||
"log"
|
||||
"net"
|
||||
"net/http"
|
||||
"net/url"
|
||||
"os"
|
||||
"os/exec"
|
||||
"runtime"
|
||||
"time"
|
||||
|
||||
"github.com/gorilla/websocket"
|
||||
)
|
||||
|
||||
// ReadTimeout 多久没收到服务器任何消息(含 ping)就认定连接已死。
|
||||
// hub 每 20s ping 一次,正常情况下永远触发不到;半开连接会在这里超时并触发重连。
|
||||
const ReadTimeout = 90 * time.Second
|
||||
|
||||
type Config struct {
|
||||
URL string // wss://host/ws
|
||||
Token string // Authorization: Bearer <token>
|
||||
Insecure bool // 跳过证书校验(自签环境)
|
||||
CAFile string // 额外信任的 CA
|
||||
FixClock bool // 证书校验失败时用服务器 Date 头校时(盒子无 RTC 时有用)
|
||||
}
|
||||
|
||||
type Conn struct {
|
||||
ws *websocket.Conn
|
||||
mu chan struct{} // 容量 1 的信号量:gorilla 不允许并发写
|
||||
cfg Config
|
||||
}
|
||||
|
||||
func (c *Conn) Send(v any) error {
|
||||
b, err := json.Marshal(v)
|
||||
if err != nil {
|
||||
return err
|
||||
}
|
||||
c.mu <- struct{}{}
|
||||
defer func() { <-c.mu }()
|
||||
return c.ws.WriteMessage(websocket.TextMessage, b)
|
||||
}
|
||||
|
||||
func (c *Conn) Close() { _ = c.ws.Close() }
|
||||
|
||||
// Wrap 把已升级的底层连接包成 Conn(hub 服务端用;客户端走 Run/Dial)。
|
||||
func Wrap(ws *websocket.Conn) *Conn {
|
||||
ws.SetReadLimit(4 << 20)
|
||||
return &Conn{ws: ws, mu: make(chan struct{}, 1)}
|
||||
}
|
||||
|
||||
// Run 持续维持连接:拨号 → onOpen → 读循环 → 断开 → 退避重连,直到 ctx 结束。
|
||||
func Run(ctx context.Context, cfg Config, onOpen func(*Conn) error, onMsg func(*Conn, string, []byte)) error {
|
||||
backoff := time.Second
|
||||
for {
|
||||
start := time.Now()
|
||||
err := once(ctx, cfg, onOpen, onMsg)
|
||||
if ctx.Err() != nil {
|
||||
return ctx.Err()
|
||||
}
|
||||
// 稳定连过 60s 才把退避重置,避免「连上就断」时疯狂重试
|
||||
if time.Since(start) > 60*time.Second {
|
||||
backoff = time.Second
|
||||
}
|
||||
if err != nil {
|
||||
log.Printf("连接中断:%v;%s 后重连", err, backoff)
|
||||
}
|
||||
select {
|
||||
case <-time.After(backoff):
|
||||
case <-ctx.Done():
|
||||
return ctx.Err()
|
||||
}
|
||||
if backoff < 30*time.Second {
|
||||
backoff *= 2
|
||||
if backoff > 30*time.Second {
|
||||
backoff = 30 * time.Second
|
||||
}
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
func once(ctx context.Context, cfg Config, onOpen func(*Conn) error, onMsg func(*Conn, string, []byte)) error {
|
||||
d := websocket.Dialer{
|
||||
HandshakeTimeout: 15 * time.Second,
|
||||
TLSClientConfig: tlsConf(cfg),
|
||||
Proxy: http.ProxyFromEnvironment,
|
||||
NetDial: (&net.Dialer{
|
||||
Timeout: 15 * time.Second,
|
||||
KeepAlive: 30 * time.Second,
|
||||
}).Dial,
|
||||
}
|
||||
hdr := http.Header{}
|
||||
if cfg.Token != "" {
|
||||
hdr.Set("Authorization", "Bearer "+cfg.Token)
|
||||
}
|
||||
ws, resp, err := d.DialContext(ctx, cfg.URL, hdr)
|
||||
if err != nil {
|
||||
if resp != nil {
|
||||
return fmt.Errorf("%s 拒绝连接:%s", cfg.URL, resp.Status)
|
||||
}
|
||||
if cfg.FixClock && !cfg.Insecure && isCertErr(err) {
|
||||
log.Printf("证书校验失败,可能是系统时间不对(%v),尝试用服务器时间校准", err)
|
||||
syncClock(cfg.URL)
|
||||
}
|
||||
return err
|
||||
}
|
||||
defer ws.Close()
|
||||
ws.SetReadLimit(4 << 20)
|
||||
|
||||
c := &Conn{ws: ws, mu: make(chan struct{}, 1), cfg: cfg}
|
||||
if err := onOpen(c); err != nil {
|
||||
return err
|
||||
}
|
||||
for {
|
||||
_ = ws.SetReadDeadline(time.Now().Add(ReadTimeout))
|
||||
_, data, err := ws.ReadMessage()
|
||||
if err != nil {
|
||||
return err
|
||||
}
|
||||
var head struct {
|
||||
T string `json:"t"`
|
||||
}
|
||||
if json.Unmarshal(data, &head) != nil {
|
||||
continue
|
||||
}
|
||||
onMsg(c, head.T, data)
|
||||
}
|
||||
}
|
||||
|
||||
func isCertErr(err error) bool {
|
||||
for _, k := range []string{"certificate", "x509", "tls:"} {
|
||||
if contains(err.Error(), k) {
|
||||
return true
|
||||
}
|
||||
}
|
||||
return false
|
||||
}
|
||||
|
||||
func contains(s, sub string) bool {
|
||||
for i := 0; i+len(sub) <= len(s); i++ {
|
||||
if s[i:i+len(sub)] == sub {
|
||||
return true
|
||||
}
|
||||
}
|
||||
return false
|
||||
}
|
||||
|
||||
func tlsConf(cfg Config) *tls.Config {
|
||||
t := &tls.Config{InsecureSkipVerify: cfg.Insecure}
|
||||
if cfg.CAFile != "" {
|
||||
if pem, err := os.ReadFile(cfg.CAFile); err == nil {
|
||||
pool := x509.NewCertPool()
|
||||
if pool.AppendCertsFromPEM(pem) {
|
||||
t.RootCAs = pool
|
||||
}
|
||||
} else {
|
||||
log.Printf("读 CA 失败:%v(忽略)", err)
|
||||
}
|
||||
}
|
||||
return t
|
||||
}
|
||||
|
||||
// syncClock 用服务器 Date 头把本机时间拨回来(只对 Linux 的 date 生效,Windows 一般有 RTC 不需要)。
|
||||
// 证书本身可能是「因为时间错才失败」,所以这里刻意不校验证书。
|
||||
func syncClock(rawURL string) {
|
||||
u, err := url.Parse(rawURL)
|
||||
if err != nil {
|
||||
return
|
||||
}
|
||||
scheme := "http"
|
||||
if u.Scheme == "wss" || u.Scheme == "https" {
|
||||
scheme = "https"
|
||||
}
|
||||
req, err := http.NewRequest("HEAD", scheme+"://"+u.Host+"/", nil)
|
||||
if err != nil {
|
||||
return
|
||||
}
|
||||
client := &http.Client{
|
||||
Timeout: 10 * time.Second,
|
||||
Transport: &http.Transport{TLSClientConfig: &tls.Config{InsecureSkipVerify: true}},
|
||||
}
|
||||
resp, err := client.Do(req)
|
||||
if err != nil {
|
||||
log.Printf("校时请求失败:%v", err)
|
||||
return
|
||||
}
|
||||
defer resp.Body.Close()
|
||||
t, err := http.ParseTime(resp.Header.Get("Date"))
|
||||
if err != nil {
|
||||
log.Printf("服务器 Date 头不可解析:%v", err)
|
||||
return
|
||||
}
|
||||
log.Printf("本地时间偏差约 %s(服务器 %s)", time.Since(t).Truncate(time.Second), t.Format(time.RFC3339))
|
||||
if runtime.GOOS == "windows" {
|
||||
return
|
||||
}
|
||||
out, err := exec.Command("date", "-u", "-s", t.UTC().Format("2006-01-02 15:04:05")).CombinedOutput()
|
||||
if err != nil {
|
||||
log.Printf("设置系统时间失败(需要 root):%v %s", err, out)
|
||||
return
|
||||
}
|
||||
log.Printf("已校时到 %s", t.UTC().Format(time.RFC3339))
|
||||
}
|
||||
@@ -0,0 +1,48 @@
|
||||
#!/bin/sh
|
||||
# 交叉编译设备端二进制到 ./bin(纯本地动作:不联网、不推送、不依赖任何特定服务器)。
|
||||
#
|
||||
# sh scripts/build.sh # 编当前平台
|
||||
# sh scripts/build.sh all # 编 linux-arm64 / linux-amd64 / linux-mips / windows-amd64 / darwin-amd64 / darwin-arm64
|
||||
#
|
||||
# 有本机 Go 就用本机;没有但有 docker 就用 golang 镜像;都没有就报错。
|
||||
set -e
|
||||
cd "$(dirname "$0")/.."
|
||||
|
||||
TARGETS="$(uname -s | tr 'A-Z' 'a-z')/$(uname -m | sed 's/x86_64/amd64/;s/aarch64/arm64/')"
|
||||
[ "${1:-}" = "all" ] && TARGETS="linux/arm64 linux/amd64 linux/mips windows/amd64 darwin/amd64 darwin/arm64"
|
||||
|
||||
build_with_go() {
|
||||
mkdir -p bin
|
||||
for t in $TARGETS; do
|
||||
os=${t%/*}; arch=${t#*/}; ext=""; gomips=""
|
||||
[ "$os" = windows ] && ext=.exe
|
||||
# mips 设备(OpenWrt / 老路由)基本都没有 FPU,硬浮点二进制一跑就是非法指令
|
||||
[ "$arch" = mips ] && gomips=softfloat
|
||||
echo "build $os/$arch"
|
||||
GOOS=$os GOARCH=$arch GOMIPS=$gomips CGO_ENABLED=0 go build -trimpath -ldflags "-s -w" \
|
||||
-o "bin/agent-device-$os-$arch$ext" ./cmd/agent
|
||||
done
|
||||
}
|
||||
|
||||
if command -v go >/dev/null 2>&1; then
|
||||
build_with_go
|
||||
elif command -v docker >/dev/null 2>&1; then
|
||||
echo "本机没有 Go,改用 golang:1.23-alpine 容器编译"
|
||||
docker run --rm -v "$PWD":/w -w /w \
|
||||
-e CGO_ENABLED=0 -e TARGETS="$TARGETS" \
|
||||
golang:1.23-alpine sh -c '
|
||||
mkdir -p bin
|
||||
for t in $TARGETS; do
|
||||
os=${t%/*}; arch=${t#*/}; ext=""; gomips=""
|
||||
[ "$os" = windows ] && ext=.exe
|
||||
[ "$arch" = mips ] && gomips=softfloat
|
||||
echo "build $os/$arch"
|
||||
GOOS=$os GOARCH=$arch GOMIPS=$gomips go build -trimpath -ldflags "-s -w" \
|
||||
-o "bin/agent-device-$os-$arch$ext" ./cmd/agent
|
||||
done'
|
||||
else
|
||||
echo "需要 Go 或 docker 才能编译" >&2
|
||||
exit 1
|
||||
fi
|
||||
|
||||
ls -lh bin
|
||||
@@ -3,6 +3,12 @@ services:
|
||||
build: ./app
|
||||
container_name: agent-core
|
||||
restart: unless-stopped
|
||||
# 日志轮转:默认 json-file 无上限,长期跑会把磁盘吃穿。保留最近 100MB。
|
||||
logging:
|
||||
driver: json-file
|
||||
options:
|
||||
max-size: "20m"
|
||||
max-file: "5"
|
||||
ports:
|
||||
# 直接把容器 8090 映射到宿主机端口,用 http://<服务器IP>:<AGENT_PORT> 访问。
|
||||
- "${AGENT_PORT:-8090}:8090"
|
||||
@@ -28,6 +34,9 @@ services:
|
||||
# 对外地址:public_link 的默认值(scripts/init.sh 探测公网 IP 后写进 .env)。
|
||||
# 设置页里填过 public_link.base_url 时以设置页为准。
|
||||
- PUBLIC_BASE_URL=${PUBLIC_BASE_URL:-}
|
||||
# 设备接入(可选):设备主动连 wss://<公网前缀>/dev/ws 时的 Bearer token。
|
||||
# 与 PUBLIC_BASE_URL 同时具备才会挂端点;留空 = 不启用,本地部署就是这种。
|
||||
- DEVICE_TOKEN=${DEVICE_TOKEN:-}
|
||||
networks:
|
||||
- agent-mcp-net
|
||||
|
||||
|
||||
Binary file not shown.
|
After Width: | Height: | Size: 257 KiB |
@@ -0,0 +1,484 @@
|
||||
# 本地端(local 模式):设计与交接
|
||||
|
||||
> 本文是 `local/` 的设计说明 + 交接单。
|
||||
> **状态:已在 macOS 真机(12.7.6 / x86_64 / Node 22.21 / python3 3.10,本机无 ffmpeg)按第 6 节
|
||||
> 清单逐项跑过,结果见第 5 节。** 只剩三件依赖人工交互或外部环境的事没覆盖(真实选目录弹窗、
|
||||
> 真浏览器打开、装 ffmpeg 之后的链路),见第 6 节。
|
||||
|
||||
## 1. 目标
|
||||
|
||||
把同一个 `agent-core` 直接跑在本机(macOS / Linux),**不装 Docker、不起 executor**,形态类似
|
||||
桌面 agent:给它一个工作目录,它在这个目录下的 `tasks/` 里放开手脚干活(`data/`、`skills/` 是兄弟目录,
|
||||
归启动器和技能自己管)。
|
||||
|
||||
明确的设计约束(都来自讨论):
|
||||
|
||||
- **和服务器端同一份代码**,不 fork 新仓库、不长期开 branch;靠运行时开关分叉
|
||||
- **`app/` 最小化改动**(最终只有 2 个后端文件,前端 0 改动)
|
||||
- **组件按需**:node 必需;ffmpeg 决定语音;python3 决定 Python 类技能能否执行(非 Python 技能如 `office` 不受影响)
|
||||
- **Windows 暂时不做**(本机执行依赖 POSIX 语义,见第 7 节)
|
||||
- 不用 Docker(用户明确否决)
|
||||
|
||||
基线版本:`v2.5.0`(服务器端最后一个纯容器部署版本)。
|
||||
|
||||
## 2. 与服务器形态的差异(只有六处)
|
||||
|
||||
| 差异 | 服务器 | 本地 | 由谁注入 |
|
||||
|---|---|---|---|
|
||||
| 命令在哪跑 | `agent-executor` 容器(mount/pid namespace 隔离) | 本机 `spawn`(**无沙箱**) | `EXECUTOR_URL` 留空 → 现成分支,未改代码 |
|
||||
| 文件工具的根 | 会话目录 `tasks/<会话id>/` | 工作目录下的 `tasks/`(`data/`、`skills/` 是兄弟目录,越界) | `AGENT_FILE_SCOPE=workspace` |
|
||||
| 监听地址 | `0.0.0.0` | `127.0.0.1` | `HOST=127.0.0.1` |
|
||||
| 对外链接(`mint_public_link` / `visit_url`) | `public_link.base_url` 拼公网短链 | 没有公网前缀时改拼 `http://127.0.0.1:<PORT>/p/<id>` | 复用 `localOrigin()`,靠 `HOST` 判断形态,不写配置 |
|
||||
| 读图回传给模型 | 签公网短链,上游服务器来拉 | 上游拉不到回环地址,改为内联 base64 `data:` URL | `AGENT_IMAGE_INLINE=1` |
|
||||
| office 预览的后端 | executor 的 `:3100` 网关(mount/pid 牢笼) | `local/preview-gateway.js`(同机、无牢笼) | `PREVIEW_PROXIES` 注入 core 的反代注册表 |
|
||||
|
||||
后五项都由本地启动器注入。**都不注入时,行为与 v2.5.0 完全一致**(容器部署不受影响)。
|
||||
|
||||
## 3. 本次改动清单
|
||||
|
||||
### 后端(`app/`)
|
||||
|
||||
| 文件 | 改动 |
|
||||
|---|---|
|
||||
| `app/server/server.js` | 读 `HOST` 环境变量;有值则 `server.listen(PORT, HOST, cb)`,无值维持 `listen(PORT, cb)`(= `0.0.0.0`)。启动日志带上 host |
|
||||
| `app/server/tools/executor.js` | 新增 `WIDE_SCOPE`(由 `AGENT_FILE_SCOPE=workspace` 打开)与 `fsRoot(ctx)`;`resolveInTask()` 增加可选第三参 `rootDir`;6 个业务工具的调用点改为传 `fsRoot(ctx)`;`recordFile()` 跳过会话目录之外的文件;`mint_public_link` 在没有 `public_link.base_url` 时改用 `localOrigin()`(回环地址) |
|
||||
| `app/server/engine.js` | `mintImageUrl` 在没有 `public_link.base_url` 且 `AGENT_IMAGE_INLINE=1` 时,把待回传的图内联成 `data:` URL(先做同样的 realpath 越界复核;>1.5MB 仍降级) |
|
||||
| `app/server/routes/files.js` | 新增 `GET /:id/tree`(桌面端左栏文件树用:单层懒加载、忽略大目录、上限 500、越界双重校验) |
|
||||
|
||||
`resolveInTask` 的两个分叉点:
|
||||
|
||||
1. **根**:`rootDir` 给了就按它校验(workspace 形态 = `workspace_root`),否则仍按会话目录
|
||||
2. **`/tmp`**:`session` 形态保持「重定向到 `<会话>/.tmp`」;`workspace` 形态**不重定向**,并把真实
|
||||
`/tmp` 纳入允许范围
|
||||
|
||||
### 刻意没有动的(重要)
|
||||
|
||||
- `resolvePastPath()`(`@<会话id>/...` 跨会话只读)—— 仍锁在对方会话目录
|
||||
- `routes/public-files.js`、`routes/data-page.js` —— 公网短链与 data-page 仍按会话目录校验
|
||||
- `mint_public_link` —— 路径校验仍是会话目录语义;只是没有公网前缀时改用回环地址签发(见 §2)
|
||||
- 前端 —— 本地模式没有专属前端代码;左栏文件树是桌面端共用的(见下)
|
||||
|
||||
> 追加:文件树最初只给 local 用,后来上收为桌面端通用能力 —— `/tree` 移到 `routes/files.js`,
|
||||
> 服务器形态的桌面端也用它取代「输入行右侧的旧文件面板」(含下载/删除);`reveal`、`terminal`、
|
||||
> `pick-dir` 仍只在 `AGENT_LOCAL_PICK=1` 下挂载(它们开的是跑 core 那台机器的窗口)。
|
||||
|
||||
### 新增 `local/`
|
||||
|
||||
| 文件 | 作用 |
|
||||
|---|---|
|
||||
| `start.sh` | 主入口:探测 → 首次生成配置 → 装依赖 → 起 core + MCP → 守护重启。**后台化**:拉起真正的启动器就返回 |
|
||||
| `stop.sh` | 停止启动器(按 `supervisor.pid` → core 的父进程 → 占端口的进程,三级兜底),幂等 |
|
||||
| `config.example.yml` | **仅作参考,不被读取**;实际配置由 `start.sh` 生成到 `config.local.yml` |
|
||||
| `preview-gateway.js` | 本地 office 预览网关(对位 executor 的 `:3100`,见 §4.15) |
|
||||
| `README.md` | 给使用者的说明(含安全边界、已知限制) |
|
||||
|
||||
`.gitignore` 增加 `local/.runtime/`、`local/config.local.yml`。
|
||||
|
||||
> 曾经有一个 `start.command`(macOS 双击入口),已删除:Finder 里双击 `.command` 常被系统当文本
|
||||
> 预览打开、不执行,而且它补的 PATH 探测和 `start.sh` 重复。现在唯一入口就是 `./local/start.sh`。
|
||||
|
||||
### 3.1 真机验证阶段补的修改
|
||||
|
||||
首次在 mac 上跑,暴露了下面这些;都不是设计变更,是实现跟设计对不上或漏了边界:
|
||||
|
||||
| 文件 | 改动 | 为的什么 |
|
||||
|---|---|---|
|
||||
| `local/start.sh` | 新增启动即弹出的**状态页**(`local/.runtime/status.html`,每秒自刷新) | 启动时终端看不到进度;失败页既没有应用名也没有日志,用户无从判断 |
|
||||
| `local/start.sh` | 依赖检测从「node_modules 在不在」改成**逐包实测 + `.agent-installed` 时间戳** | `npm install` 中途失败会留下半成品目录(目录在、包不全),原逻辑会永远跳过安装,core 起来就 require 失败 |
|
||||
| `local/start.sh` | `npm install` 输出 `tee` 到 `local/.runtime/npm-install.log`,并嵌进状态页 | 失败时只有终端能看到,滚过去就没了 |
|
||||
| `local/start.sh` | MCP 默认端口 3101~3104 → **8091~8094**;新增「PORT 撞 MCP 端口就拒绝启动」检查 | 跟 core 的 8090 连号,同时堵掉「换端口时不小心占用 MCP 端口」→ 子进程 bind 失败、静默降级 |
|
||||
| `local/start.sh` | 已有配置里的 MCP 端口与本次启动不一致时**告警** | 配置永不覆盖,改了默认值/用了 `MCP_*_PORT` 时,旧配置会让 core 静默发现不到工具 |
|
||||
| `local/start.sh` | 生成的 YAML 里路径**加引号** | 用户选的目录带空格/`:`/`#` 时会被 YAML 解析坏 |
|
||||
| `local/start.sh` | 没 ffmpeg 时**不再启动** `mcp_asr`(原实现无条件启动,与 4.3 的设计说明不符) | 否则模型拿到一个必然失败的 `transcribe_audio` 工具;同时少一个 `0.0.0.0` 监听 |
|
||||
| `local/start.sh` | 默认**后台化**(`AGENT_LOCAL_DETACH=1`),拉起启动器后 1 秒返回;新增 `local/stop.sh` | 用户不想让一个终端窗口永远挂着;Finder 里关窗口很容易误杀服务,后台 + 显式 `stop.sh` 更可控 |
|
||||
| `local/start.sh` | 没 node 时在入口就拦下(生成配置之前),并在终端打出安装方式 | 原来先进「选工作目录」、写好配置才报「后台进程立刻退出了」,用户白选一次,而且日志里只有两行启动横幅,看不出原因 |
|
||||
| `local/start.sh` | 同一轮只开一个状态页标签(`UI_OPENED`) | `ui_init` 已经开过一次,失败时 `ui_fail` 又开一个,同一个页面两个标签 |
|
||||
| `local/start.sh` | 「已在运行」改看 `supervisor.pid`(pid 存活且命令行是本脚本),health 只做兜底 | 只看 health 时 core 还没起来的几秒内连跑两次,会拉起两个启动器抢同一端口(实测:互相 `EADDRINUSE` 重启,`stop.sh` 只能停一个) |
|
||||
| `local/start.sh` | 首次安装**不自动跳转**,停在状态页给「打开应用」按钮;后续启动才 2 秒自动跳 | 首次装完先让用户看完「怎么配模型」再进去,别一上来就甩进空界面 |
|
||||
| `app/server/tools/executor.js` | 新增 `dispPath()`:会话目录外用绝对路径回显 | 宽根模式下写 `/tmp/x` 会回 `../../../../tmp/x`,模型容易当会话内路径二次拼接 |
|
||||
| `app/package-lock.json` | `resolved` 从腾讯云**内网镜像**改为公共 registry | 原 lockfile 把 tarball 钉在 `mirrors.tencentyun.com`(只有腾讯云 VPC 内能解析),外部机器 `npm install` 必失败,且换 `NPM_REGISTRY` 也无效 |
|
||||
|
||||
## 4. 关键设计决定(含「为什么」,别推翻)
|
||||
|
||||
### 4.1 开关用环境变量,不进 `config.yml`
|
||||
|
||||
`EXECUTOR_URL` / `ASR_URL` 已经是「部署接线走 env」的先例,本地模式属于同一类(部署形态),
|
||||
不是平台配置。好处是 `app/` 只需改 2 个文件,不必动 `config.js` 的 `DEFAULTS` 和
|
||||
`config.example.yml`(改配置项必须两处同步,是仓库的硬规则)。
|
||||
|
||||
### 4.2 配置**首次生成后永不覆盖**
|
||||
|
||||
`config.local.yml` 里既有启动器生成的字段(`workspace_root` / `skills_root`),也有用户在网页里
|
||||
配的东西(`platforms`、API Key、MCP headers)。每次启动重写会直接冲掉后者。
|
||||
|
||||
推论:**能力变化不能靠改配置实现**,只能靠 env / 起不起子进程 / 首次复制(见 4.3、4.4)。
|
||||
|
||||
### 4.3 ffmpeg 是运行时能力,与配置解耦
|
||||
|
||||
`routes/asr.js` 直接读 `process.env.ASR_URL`,`/api/asr/status` 在 `ASR_URL` 为空时返回
|
||||
`enabled:false`,前端 `voice.js` 据此**自动隐藏麦克风**。所以:
|
||||
|
||||
- 有 ffmpeg → 启动器起 `mcp_asr` + 注入 `ASR_URL`
|
||||
- 没 ffmpeg → 不起、不注入 → 麦克风自动消失
|
||||
|
||||
装完 ffmpeg 后**重跑脚本**即生效,配置文件一个字不用改。
|
||||
|
||||
### 4.4 技能是工作目录里的副本,不再软链仓库并随 python3 有无切换
|
||||
|
||||
用户选的工作目录被拆成三个兄弟目录:
|
||||
|
||||
```
|
||||
<工作目录>/tasks/ 会话工作区(AI 的文件根)
|
||||
<工作目录>/data/ SQLite、prompt dump
|
||||
<工作目录>/skills/ 技能 + deps/
|
||||
```
|
||||
|
||||
`skills_root` 写死 `<工作目录>/skills`(首次生成后不覆盖)。首次启动时把仓库 `skills/` 里的
|
||||
**内置技能逐个复制**过去,之后每次启动**只补缺、不覆盖**:
|
||||
|
||||
- 只复制目录,`deps` 不复制(仓库那份是服务器构建期产物,平台/版本都不该跟着走)
|
||||
- 目标已存在就跳过——用户改过的、AI 自己新建的技能都靠这条保住
|
||||
- 要拿仓库里的新版:删掉对应子目录再跑一次脚本
|
||||
|
||||
这样三个东西同时在位:仓库永远干净(`git status` 无未跟踪用户数据);用户数据一目录备份、
|
||||
一目录卸载;AI 真能“自己长技能”(新增目录即被发现,`skill list` 实时可见)。
|
||||
|
||||
早期版本把 `.runtime/skills` 软链到仓库,导致技能只能写回版本库(与仓库更新抢地盘)。
|
||||
更早还按 python3 有无切到空目录,想“别让模型看到跑不了的工具”——但技能不一定是 Python 的
|
||||
(`office` 只要 Node + 二进制),一刀切会把它们一并藏掉;而且 `skills.js` 的 `runEntry` 对
|
||||
`spawn` 的 `error` 有处理,缺解释器时模型拿到的是「技能入口启动失败:spawn python3 ENOENT」,
|
||||
干净可读,自己装完继续跑即可。
|
||||
|
||||
**没有改 `skills.js` 一行代码。**
|
||||
|
||||
### 4.5 启动器必须是守护进程
|
||||
|
||||
`routes/system.js` 的重启实现是「校验配置 → `process.exit(0)` → 等 Docker restart 策略拉起」,
|
||||
注释里写明「非 docker 部署不会自动重启」。本地没有 Docker,如果启动器只是前台 `node`,
|
||||
用户配完模型点一次「重启」,服务就再也回不来。
|
||||
|
||||
所以主循环是:起 core → 等健康 → `wait` → 非用户中断就 1 秒后重启;连续异常退出 5 次才停
|
||||
(防配置写坏导致无限刷屏)。`exit 0` 视为用户主动重启。
|
||||
|
||||
### 4.6 四个 MCP 必须分端口
|
||||
|
||||
容器里它们是四个独立容器、都监听 3000;本地同机必须错开(默认 **8091~8094**,紧跟 core 的 8090)。
|
||||
另外**它们的启动参数不统一**,这是个坑:
|
||||
|
||||
| 服务 | 启动方式 | 说明 |
|
||||
|---|---|---|
|
||||
| `web_search` | `node server.js --http --host --port` | 默认 host 已经是 `127.0.0.1` |
|
||||
| `image_task` | `node src/mcp-server.js --http --host --port` | 默认 `0.0.0.0` |
|
||||
| `video_task` | `node src/mcp-server.js --http --host --port` | 默认 `0.0.0.0` |
|
||||
| `mcp_asr` | **只认 `PORT` 环境变量** | 不解析 argv,且 `listen` 没带 host(= `0.0.0.0`) |
|
||||
|
||||
所以 `start.sh` 拆成 `start_mcp_flags` / `start_mcp_env` 两个函数,别合并。
|
||||
|
||||
### 4.7 `/tmp` 语义为什么分叉
|
||||
|
||||
服务器端:executor 在 session 模式下执行 `mount --bind <会话>/.tmp /tmp`,容器内 `/tmp` 的物理
|
||||
落点就是宿主 `<会话>/.tmp`。core 的文件工具必须去同一处找,否则 AI 用 terminal 写 `/tmp/x` 后
|
||||
`read_file /tmp/x` 读不到。所以那份「重定向」是**必需的**,不是 bug。
|
||||
|
||||
本地端:`toolTerminal` 是真 `spawn('/bin/sh')`,`/tmp` 就是本机 `/tmp`。此时再重定向就会造成
|
||||
「terminal 写真实 /tmp、file 工具读会话 .tmp」的错位——这正是 `AGENT_FILE_SCOPE=workspace`
|
||||
要关掉重定向的原因。
|
||||
|
||||
### 4.8 `skills_root` 的默认值
|
||||
|
||||
`skills.skills_root` 留空时默认取 `workspace_root` 的**同级** `skills` 目录。新的目录布局正好也是
|
||||
`tasks/` 与 `skills/` 同级,所以留空也能算对;但生成的配置仍然显式写死它——一个字段就能看出
|
||||
技能到底在哪,不依赖目录推导。
|
||||
|
||||
### 4.9 状态页:静态文件 + `meta refresh`,不起 HTTP 服务
|
||||
|
||||
启动时终端窗口不一定在前台,失败时也可能已经滚过去。所以启动就打开
|
||||
`local/.runtime/status.html`,并让它能自己更新:
|
||||
|
||||
- 脚本把状态写进 `local/.runtime/ui/` 下的几个小文件(`title` / `steps` / `busy` / `logpath` /
|
||||
`error` / `redirect`),`ui_render` 把它们拼成整页;页面用 `<meta http-equiv="refresh" content="1">`
|
||||
每秒重读一次。不需要常驻服务,所以「连 node 都没装」的环境也能打开。
|
||||
- 长步骤(`npm install`、等 core 健康检查)另起一个**心跳子进程**每秒重绘,页面上就能看到
|
||||
已经过了多少秒 + 当前日志的尾巴(npm 输出、core 启动报错)。
|
||||
- 状态全部落文件而不是留 shell 变量:心跳子进程拿到的是 fork 时的快照,用变量会越刷越旧。
|
||||
- 成功时:**首次安装**(配置是本次刚生成的)页面停在「已启动」,只给一个「打开应用」按钮,
|
||||
用户自己点(先看完下面的首次使用提示);**后续启动**写入 `redirect`,2 秒后自动进应用
|
||||
(同一个标签页,不多开窗)。
|
||||
- 失败时页面保留错误说明和日志尾部,并把完整日志路径写在页面上。
|
||||
- 默认只在 macOS 自动弹出(`AGENT_LOCAL_UI=auto`),Linux 服务器上要显式 `AGENT_LOCAL_UI=1`;
|
||||
无论弹不弹,页面都会生成。
|
||||
- 渲染先写临时文件再 `mv`:浏览器随时可能在刷新,不能让它读到半截 HTML;临时名用 `mktemp`
|
||||
而不是 `$$`——`$$` 在子 shell 里仍是主 shell 的 PID,心跳与主流程同时渲染会撞车。
|
||||
|
||||
### 4.10 依赖检测为什么不能只看 `node_modules` 目录
|
||||
|
||||
`npm install` 失败(断网、源不对)会留下一堆**空目录**:`app/node_modules` 在、`express` 目录
|
||||
也在,但里面没东西。原逻辑「目录存在且不比 `package.json` 旧」会判定为已安装,以后每次启动
|
||||
都跳过安装,core 起来立刻 `require` 失败——用户看到的是「装依赖那步过了,但服务起不来」。
|
||||
|
||||
现在的判定:
|
||||
|
||||
1. 逐个直接依赖检查 `node_modules/<dep>/package.json` 是否存在(比 `require.resolve` 可靠:
|
||||
`@modelcontextprotocol/sdk` 这类纯 ESM 包的 `exports.require` 指向的文件根本不存在,
|
||||
`require.resolve` 会误判成「没装」);
|
||||
2. 装成功后 `touch node_modules/.agent-installed`,只有 `package.json` 比它新才重装
|
||||
(npm 在「已经是最新」时不会更新 `node_modules` 的 mtime,只比目录 mtime 会每启动都白跑一次)。
|
||||
|
||||
### 4.11 后台化 + 显式 `stop.sh`,以及「已在运行」怎么判
|
||||
|
||||
用户不想为了跑一个本地服务永久占着一个终端窗口(而且关窗口可能连带杀掉进程)。所以:
|
||||
|
||||
- `start.sh` 自己**只做入口**:首次配置生成(要 tty 弹窗)→ `nohup` 拉起真正的启动器 → 1 秒后
|
||||
打印地址/状态页/停止命令并 `exit 0`。`AGENT_LOCAL_DETACHED=1` 是子进程标记,防无限重入。
|
||||
- 停止统一走 `local/stop.sh`。它按「`supervisor.pid` → core 的父进程 → 占端口的进程」三级兜底:
|
||||
只杀 core 会被守护循环重新拉起,所以必须能认出**启动器**。命令行是相对路径(`sh ./local/start.sh`),
|
||||
`pgrep -f` 匹配不到绝对路径,所以第一选择是 pid 文件。
|
||||
- 前台模式保留:`AGENT_LOCAL_DETACH=0 ./local/start.sh`(看实时日志、`Ctrl-C` 停)。
|
||||
|
||||
「已在运行」的判定不能只看 `/api/health`:core 起来要几秒(先起 MCP,首次还要装依赖),
|
||||
这期间再跟一次 `start.sh` 就会拉起第二个启动器,两个 core 抢同一个端口——一个被守护循环
|
||||
反复 `EADDRINUSE` 重启,而 `stop.sh` 只认 pid 文件里那一个,等于停不干净(已实测复现)。
|
||||
改成先看 `supervisor.pid`(子进程一启动就写,秒级就绪;`kill -0` + 命令行含 `start.sh` 防 pid 被回收),
|
||||
health 只作为「端口上有服务但不是本启动器拉起的」兜底提示。
|
||||
|
||||
### 4.12 依赖安装:源探测 + 换源重试 + 本地缓存(只在 `local/` 里做)
|
||||
|
||||
首装联网是逃不掉的,但「哪个源能用、卡住了怎么办」不该让用户想。启动器的策略:
|
||||
|
||||
1. **已装齐 → 不联网**(逐包检查 + `.agent-installed` 时间戳,见 4.10);
|
||||
2. **缓存命中 → 解压**:装成功后把 `node_modules` 打成
|
||||
`<平台>-<架构>-abi<ABI>-<依赖哈希>.tgz` 放 `~/.cache/agent-local/`;原生模块与 ABI 绑定,
|
||||
所以文件名必须含 ABI(`process.versions.modules`)。换 clone / 删 `node_modules` 都走这里,
|
||||
秒级且零网络;只留最近 3 份。
|
||||
3. **缓存未命中 → 选源安装**:并行探 `npmmirror` 与官方源(各 3 秒超时),取最快的;
|
||||
结果缓存一天。**只用命令行参数传源,绝不写 `~/.npmrc`**。
|
||||
4. **失败换源**:仅当用的是公共源(npmmirror / 官方)时换下一个重试,换源成功就记住;
|
||||
用户显式指定或公司私有源不兜底(乱兜底可能装错东西)。重试前先删半成品 `node_modules`。
|
||||
5. **看门狗**:npm 10 + Node 22 在断网时既不报错也不退出(已知的
|
||||
`Exit handler never called`,实测卡死超过 2 分钟),所以每次 `npm install` 都带超时,
|
||||
超时就 `SIGKILL` 整棵树再换源。
|
||||
6. **报错翻译**:把 npm 原文归成「网络没通 / 缺编译工具链(`xcode-select --install`)/
|
||||
没有写权限 / 源没响应」,状态页只显示这一句,原文仍完整落在 `npm-install.log`。
|
||||
|
||||
两个容易踩的实现细节(都踩过):
|
||||
|
||||
- `kill_tree` 不能把参数先赋给变量再递归:POSIX sh 没有局部变量,递归会覆盖它,回到外层
|
||||
kill 的是子进程而不是原本那个。
|
||||
- 看门狗只用 `SIGKILL`:先 `TERM` 会先干掉外壳让 npm 变成孤儿(`PPID=1`),`kill -0` 判不到,
|
||||
再想硬杀就找不到它了。
|
||||
|
||||
### 4.13 Python 包:不预装,交给模型按提示词装进 `skills/deps`
|
||||
|
||||
服务器上技能依赖由 `agent-executor-init` 一次性装进 `skills/deps`(compose 再把它放进
|
||||
`PYTHONPATH`)。本地没有这套东西,`start.sh` 也不去跑 pip——安装时机、镜像源、半成品清理
|
||||
是另一整套逻辑,收益不抵成本。做法改成「缺了再装」:
|
||||
|
||||
- `start.sh` 起 core 时注入 `PYTHONPATH=<工作目录>/skills/deps` 与
|
||||
`AGENT_SKILLS_DEPS=<工作目录>/skills/deps`(后者只为把路径交给模型)。
|
||||
`terminal` 与技能子进程都继承 core 的 env,所以装进去的东西**下次运行就能 import**,不用重启。
|
||||
- `templates/env-local.txt` 把原来的「永远不要自己装任何东西」改成「缺模块就装进
|
||||
`$AGENT_SKILLS_DEPS` 再重试」——**只给路径,不给命令**,怎么装由模型自己决定。
|
||||
技能失败时 stdout+stderr 是合并回给模型的,它能看到 `ModuleNotFoundError` 自己判断。
|
||||
- 为什么给一个目录而不是让模型自己选:那个目录已经在 `PYTHONPATH` 里,装进去下次运行就能
|
||||
import;而不指定位置的话,它很可能装到别处(或去改系统 Python)。pip 对 `--target` 的
|
||||
PEP 668 拦截明确豁免(`pip/_internal/commands/install.py`),所以这条路在 Homebrew 那种
|
||||
externally-managed 解释器上也走得通——但这话不写进提示词,交给模型自己判断。
|
||||
- 缺 `python3` 本体时也放给模型自己处理:本地形态是「用户自己的机器 + 用户自己的 agent」,
|
||||
目标是把事做成,而不是把它当生产环境保护。提示词只告诉它**装到哪**(Python 包进
|
||||
`$AGENT_SKILLS_DEPS`),不写条件也不写禁令——要不要先知会用户,交给模型按场合自己判断。
|
||||
- 技能自己的 `requirements.txt` 一律**不写版本号**:服务端 init 用
|
||||
`pip install --no-index --dry-run` 探测,pin 到与镜像不同的版本会让探测失败 → 真的往
|
||||
`skills/deps` 装一份旧的,而 `PYTHONPATH` 优先于系统 site-packages,等于反向遮蔽镜像包。
|
||||
|
||||
需要系统库的包(`weasyprint` → pango/cairo)pip 装不了,仍需用户 `brew install`;这类不在
|
||||
自动修复范围内,模型只报结论。
|
||||
|
||||
### 4.14 技能自洽:本机环境写在技能目录的 `AGENTS.md`
|
||||
|
||||
`install.sh` / `requirements.txt` 是服务器工件(镜像构建与 `agent-executor-init` 读它们),本机不跑、
|
||||
不改。启动器也不认识任何具体技能:不注入 PATH、不预装、不做特判。新增技能不需要动 `local/`。
|
||||
|
||||
本机缺东西时只有一条入口:技能自己目录下的 `AGENTS.md`。它是**排错清单**,只写「现象 → 命令」
|
||||
(报什么错、敲什么),不写背景、不提服务器。起点是 `env-local` 提示词的一句话:技能失败就读
|
||||
`"$(dirname "$AGENT_SKILLS_DEPS")/<技能>/AGENTS.md"`。装完不需要重启,旧进程不影响。
|
||||
|
||||
分两层,各管各的:**技能目录的 `AGENTS.md` 只写该技能特有的**(缺哪个包、缺什么系统库);
|
||||
**网络换源与长任务这类通用规则不进技能文档**,直接写在 `env-local.txt` 提示词里——
|
||||
它们必须常驻上下文,靠「出错时去翻文件」是拉不动的(尤其长任务:AI 决定跑 `brew install` 的
|
||||
那一刻没有任何报错信号触发它去查文档)。
|
||||
|
||||
代价明写:`office` 的命令入口在本地不在 PATH 上,按次 `PATH="$SK/scripts:$PATH" office ...` 即可
|
||||
(这是它 `AGENTS.md` 的第一条)。
|
||||
|
||||
报错指向各自文档,不在 core 里做全局特征匹配(那种正则既脆又不可移植):
|
||||
|
||||
| 位置 | 报错附带 |
|
||||
|---|---|
|
||||
| `office` 封装层 ENOENT | 本技能 `AGENTS.md` 绝对路径 |
|
||||
| `x2pdf` 缺包 / 无渲染后端 | 同上 |
|
||||
| `image-process` 缺中文字体 | 同上(并提示传 `font`) |
|
||||
| 网络类 / 长任务 | 不进技能文档:写在 `env-local.txt`,常驻上下文 |
|
||||
|
||||
唯一保留的环境相关代码是 `x2pdf` 的 `find_soffice()`:`brew install --cask libreoffice` 后
|
||||
`soffice` 不在 PATH(在 app bundle 内),不探这几个默认位置,“装 LibreOffice 即可”就是假的。
|
||||
另保留了 WeasyPrint 不可用时回落 LibreOffice,让本地只需一个后端而不是 pango + WeasyPrint 两套链。
|
||||
|
||||
没做的是预览:预览卡片要 executor 的 `:3100` 网关,本地没有——这一项后来补了,见 §4.15。
|
||||
|
||||
### 4.15 office 文档预览:本地自建一个薄网关
|
||||
|
||||
服务器上「点开 docx」是 core → 反代 `/preview` → executor 的 `:3100` 网关 → 网关按需 spawn
|
||||
`officecli watch`。本地没有 executor,链路断在中间。补法不是改 core,而是在 `local/` 里放一个
|
||||
零依赖网关,用 `PREVIEW_PROXIES` 把它登记进 core 的反代注册表(`app/` 一行没改)。
|
||||
|
||||
**不复用 `executor/preview.js`**:那套 `unshare --mount --pid` + `nsenter` + `mount --bind` 是为
|
||||
「让沙箱内的命令和 watch 看见同一个世界」造的(vendor 靠 `TMPDIR` 下的句柄文件 + 回环 TCP 相互
|
||||
发现)。本地没有沙箱,命令和 watch 本来就同机同盘,那些系统调用不但用不上,有些平台根本没有。
|
||||
于是本地网关只剩数据面:
|
||||
|
||||
- `/preview/<会话id>/<相对路径>` → 解析真实文件 → 确保有 watch → 剥前缀转发
|
||||
- `/`、`/events`(SSE)与 `/api/*` → 按 `Referer` 认领槽位转发(`/` 尤其关键:vendor 把根绝对
|
||||
`/` 当「自身最新 HTML」比对,回 404 它就 `location.reload()`,用户看到的是白屏后重载)
|
||||
- 4 个槽位,LRU 挤占 + 闲置回收;watch 端口从 26315 起按代轮转,跳过已被占用的
|
||||
- 就绪 = 真发一次 `GET /`(首帧渲染在那次请求里完成);裸 TCP 连上只说明 Kestrel bind 好了
|
||||
- HEAD 探针等槽位就绪再回 200(有上限):冷启动渲染不落到 iframe 的导航请求上
|
||||
- 导航请求绝不为启动/自愈阻塞:未就绪或外部改动 → 立刻中转页 + 后台热槽;缺尾斜杠补 301
|
||||
- 外部写盘靠 mtime 指纹 + 2s 轮询 `POST /api/switch` 触发重读;`__pv-touch` 是编辑命令的事后一脚
|
||||
- 槽位带活性校验:watch 自己退了就丢掉重起,转发出错也立即摘槽(GET/HEAD 再自愈重试一次)
|
||||
- 缺 `officecli` 时给「安装说明页」,而不是无限转圈:服务器那份二进制是构建期必装的,
|
||||
`preview.js` 从没为「没装」设计;本地全新 clone 一定没有,这是常态不是异常
|
||||
|
||||
于是本地 `office` 的体验与服务器一致:`create`/`open` 后聊天里出预览卡片,点开即右侧预览,
|
||||
`get-pos` 能读到选区。技能侧因此不需要任何本地分支(`skills/office` 与服务器同源)。
|
||||
|
||||
平台差异都收在两处:进程回收(POSIX 杀进程组 / Windows `taskkill /T`)、二进制解析(`.exe`、
|
||||
POSIX 补 `chmod +x`、`officecli-*` 资产名也认)。其余只用 Node 内置能力。
|
||||
|
||||
已知:watch 没有 `--host` 参数,只能绑 `0.0.0.0`(与 `mcp_asr` 同类);网关与 core 只在回环上。
|
||||
|
||||
## 5. 验证结果(macOS 12.7.6 / x86_64 / Node 22.21 / python3 3.10 / 本机无 ffmpeg)
|
||||
|
||||
静态检查:`sh -n local/start.sh`、`sh -n local/stop.sh`、`node --check` 均通过。
|
||||
|
||||
| 项 | 结果 |
|
||||
|---|---|
|
||||
| 首次启动:生成配置 → 装依赖(app 134 包,image_task / video_task 各 127 包)→ 起 MCP + core → 打开状态页(停在「已启动」,等点击) | 通过 |
|
||||
| 配置内容:`workspace_root` = `<选定目录>/tasks`、`data_root` = `<选定目录>/data`、`skills_root` = `<选定目录>/skills`(内置技能已复制)、`platforms: []`、MCP 端口 8091~8094 | 通过 |
|
||||
| 绑定地址:`lsof` 只有 `127.0.0.1:8090` | 通过 |
|
||||
| 设置页「重启」→ 守护拉起:PID 变化,2 秒内 `/api/health` 恢复 | 通过 |
|
||||
| 文件工具限定在 `<工作目录>/tasks/` 下:放进 `tasks/` 的 `probe.txt` 可读,`<工作目录>/data/` 报路径越界 | 待复测 |
|
||||
| 越界保护:`read_file ~/.ssh/config`、`terminal cd /etc` 均报「路径越界」 | 通过 |
|
||||
| `/tmp` 一致性:`write_file /tmp/x` → `terminal cat /tmp/x` 与 `read_file /tmp/x` 内容一致 | 通过 |
|
||||
| 无 ffmpeg:`/api/asr/status` = `enabled:false`(麦克风隐藏),asr 子进程不启动,8094 不监听 | 通过 |
|
||||
| 有 python3:Python 技能可执行;桩掉 python3 后技能清单不变(`/api/skills` 照常返回),执行 `run.py` 类技能报「技能入口启动失败:spawn python3 ENOENT」,`office` 这类非 Python 技能不受影响 | 待复测 |
|
||||
| 四个 MCP 在具备条件时均能发现工具(`[mcp] web_search / image_task / video_task / asr: 发现 1 个工具`) | 通过 |
|
||||
| 前台模式 `Ctrl-C` 与 `TERM`:8090 与 8091~8094 全部释放,无残留进程 | 通过 |
|
||||
| 二次启动:沿用配置、跳过依赖安装(时间戳生效) | 通过 |
|
||||
| 后台模式:`start.sh` 1 秒返回、启动器 PPID=1、`supervisor.pid` 是子进程 pid | 通过 |
|
||||
| `stop.sh`:命中 pid 文件分支;pid 文件丢失时按 core 父进程/端口也能停;未运行时幂等返回 | 通过 |
|
||||
| 重复执行 `start.sh`:打印「已在运行(启动器 pid N)」+ 停止命令,exit 0,不起第二个进程 | 通过 |
|
||||
| 启动器被 `kill -9` 后的恢复:残留 pid 文件被清理,端口仍被占时明确提示先 `stop.sh` | 通过 |
|
||||
| 依赖源自动探测:删依赖后启动,自动选中 `registry.npmmirror.com`(本机 npm 全局源也是它),状态页显示「依赖源」 | 通过 |
|
||||
| 依赖缓存:装成功后生成 `~/.cache/agent-local/deps-...tgz`;删掉 `node_modules` 重启,日志为「使用本地依赖缓存」、`npm-install.log` 为空(零网络) | 通过 |
|
||||
| 换源自愈:把缓存里的源改成不可达地址 → 看门狗超时 → 自动换到 npmmirror 装完,缓存里的源被改回可用值 | 通过 |
|
||||
| 失败翻译:源不可用 + 冷 npm 缓存 → 状态页标题「依赖安装失败」、提示「源没有响应…(已自动换源重试)」,无 npm 残留进程 | 通过 |
|
||||
| 前台模式 `AGENT_LOCAL_DETACH=0`:阻塞运行,`TERM` 后端口全部释放 | 通过 |
|
||||
| 无 node(PATH 里剥掉 node/npm):入口直接拦下,**不** 先让选目录、不生成配置;终端打出安装方式;状态页列出自检项(X Node.js / X npm) | 通过 |
|
||||
| 失败时只开一个状态页标签(不再两个) | 通过 |
|
||||
| 状态页:启动即弹出、每秒刷新、显示步骤/计时/日志尾巴;失败时保留错误与日志 | 通过 |
|
||||
| 预览网关(直接打网关,临时 tasks 根):HEAD 探针 200、GET 200、自动起 watch @26315 | 通过 |
|
||||
| 预览数据面:`/events` 是真 SSE、`/api/selection` 204、`/api/send` 200;无 `Referer` 404 | 通过 |
|
||||
| 缺 `officecli`:给安装说明页,HEAD 仍 200(面板不闪死链) | 通过 |
|
||||
| 网关退出:watch 端口释放,无残留进程 | 通过 |
|
||||
| 冷 HEAD 等首帧(3.3s)回 200;随后热导航 10ms 拿到页面 | 通过 |
|
||||
| vendor 的根绝对 `/`(带 Referer):200 且与页面 HTML 逐字节相同(不再触发 `location.reload()` 白屏) | 通过 |
|
||||
| 冷启动导航:2.7ms 回中转页(不等启动),4 秒后刷新即真页面 | 通过 |
|
||||
| 缺尾斜杠导航:301 到带斜杠的页面 | 通过 |
|
||||
| `__pv-touch`:命中活槽位 → `{"touched":true}`;外部 `touch` 文件 → 2s 轮询 POST `/api/switch` → SSE 收到 `"action":"full"` | 通过 |
|
||||
| 槽位自愈:`kill -9` 掉 watch 后再请求,自动在下一代端口重起(26315 → 26316),页面照常返回 | 通过 |
|
||||
| 经 core 的 `/preview` 端到端(含手选工作目录、`work_dir` 在 `tasks/` 外的会话) | 待复验 |
|
||||
| `osascript` 真实选目录弹窗 | 未验证(用桩跑的「没选→回落 `~/AgentWork`」分支) |
|
||||
| 真浏览器打开(`open`) | 未验证(用桩记录了被打开的 URL) |
|
||||
| 装 ffmpeg 之后:`ASR_URL` 注入、asr 子进程与麦克风一起出现 | 未验证(本机未装 ffmpeg) |
|
||||
|
||||
验证过程中发现并修掉的问题见 3.1(依赖检测、lockfile 内网源、`asr` 无条件启动、端口冲突、
|
||||
状态页日志缺失、全角字符紧贴变量名导致的 `unbound variable`)。
|
||||
|
||||
## 6. 还没覆盖的三项(需要人工交互或外部环境)
|
||||
|
||||
其余清单已在 mac 上跑完(结果见第 5 节)。剩下这三项要在真实场景里补:
|
||||
|
||||
1. **真实选目录弹窗**:删掉 `local/config.local.yml` 后跑 `./local/start.sh`,确认弹出的是 macOS 原生
|
||||
选目录窗、选完的路径写进 `workspace_root`(带空格的目录名要顺手验一下,配置里已加引号)。
|
||||
2. **真浏览器打开**:跑 `./local/start.sh`(或前台模式),确认(a)状态页在启动过程中每秒刷新;
|
||||
(b)首次安装停在页面上等你点「打开应用」;(c)后续启动 2 秒自动进应用。
|
||||
3. **装 ffmpeg 之后**:`brew install ffmpeg` → 重跑脚本,预期:状态页显示 `ffmpeg` 为 OK、
|
||||
终端打「语音:可用」、8094 开始监听、`/api/asr/status` 变成需要填上游(不再是「未设置 ASR_URL」)。
|
||||
|
||||
手工复验用的命令:
|
||||
|
||||
```bash
|
||||
./local/start.sh # 后台启动(1 秒返回)
|
||||
./local/stop.sh # 停止(幂等)
|
||||
./local/start.sh # 已在运行时只打印地址与停止方式
|
||||
lsof -nP -iTCP:8090 -sTCP:LISTEN # 应只有 127.0.0.1
|
||||
lsof -nP -iTCP:8091-8094 -sTCP:LISTEN # 3 或 4 个 MCP(没 ffmpeg 时没有 8094)
|
||||
curl -s http://127.0.0.1:8090/api/asr/status
|
||||
curl -s -X POST http://127.0.0.1:8090/api/system/restart # 应由守护拉起
|
||||
tail -f local/.runtime/core.log # 以及 npm-install.log / mcp-*.log
|
||||
```
|
||||
|
||||
## 7. 已知限制(都不打算在本次解决)
|
||||
|
||||
| 限制 | 说明 |
|
||||
|---|---|
|
||||
| **无沙箱** | AI 的 `terminal` 就是本机 shell,能读 `~/.ssh` 等一切。这是「给它一个目录就放开手脚」的代价;README 已提示「专用目录 + `git init`」 |
|
||||
| 没 ffmpeg 时 asr 会报「工具发现失败」 | 此时 `mcp_asr` 不启动(它转码依赖 ffmpeg),但配置里的 asr 条目仍在(配置不覆盖),所以 core 启动会 warn 一次并重试,属预期 |
|
||||
| `mcp_asr` 监听 `0.0.0.0` | 它只认 `PORT` 环境变量、`listen` 不带 host(已启动时才是问题)。不存密钥(上游参数随请求带入),暴露面有限;要收紧需给 `mcp/asr` 加 `--host` 支持 |
|
||||
| Windows 不支持 | `spawn('/bin/sh')`、`process.kill(-pid)`、模型写的 bash 语法都是 POSIX 语义 |
|
||||
| 链接只在本机可达 | 本地没有公网前缀:`mint_public_link` / 页面访问地址都签成 `http://127.0.0.1:<PORT>/...`,只能在这台机器上打开(这正是本地形态的预期)。要真正对外暴露才需在设置页填 `public_link.base_url` |
|
||||
| 技能依赖 | 本地不预装:缺包时模型会把包装进 `<工作目录>/skills/deps`(`$AGENT_SKILLS_DEPS`,已在该进程 `PYTHONPATH` 里,装完下次运行即生效);连 `python3` 都没有时也由它自己装。怎么装由模型自己决定。需要系统库的包(`weasyprint`→pango/cairo)pip 装不了,仍需手工 `brew install`。服务器上由 `agent-executor-init` 处理 |
|
||||
| `office` 二进制 | 不入库、也不预装:首次用到时报 `binary missing` 并给出该技能 `AGENTS.md` 的绝对路径,模型按它自己下载(`releases/latest`,~34MB,GitHub 慢就用 gh-proxy)。不需要 root、不需重启。officecli 会自更新到 latest,版本比服务器 pin 的新属正常 |
|
||||
| `office` 预览 | 本地网关按需起 `officecli watch`,体验与服务器一致;但 watch 没有 `--host`,只能绑 `0.0.0.0`,且预览进程闲置 6h 回收(槽位 4 个) |
|
||||
| 首个 `npm install` 要联网 | 支持 `NPM_REGISTRY` 覆盖源;`app/package-lock.json` 的 `resolved` 已改指向公共 registry(原来钉在内网镜像,外部机器必失败) |
|
||||
|
||||
## 8. 回滚
|
||||
|
||||
本地模式的所有开关默认关闭,服务器行为不变。真要整体撤掉:
|
||||
|
||||
```bash
|
||||
git revert <本次提交>
|
||||
rm -rf local/ # 或保留脚本、只是不用
|
||||
```
|
||||
|
||||
`v2.5.0` 是这批改动之前的基线,可随时对照。
|
||||
|
||||
## 9. 记录:测试残留(都不入库)
|
||||
|
||||
跑过启动器之后本机会多出:`local/.runtime/`(日志、状态页)、`local/config.local.yml`、
|
||||
你选的工作目录(`data/` `skills/` `tasks/`)、`app/node_modules/`、`mcp/image_task|video_task/node_modules/`。
|
||||
仓库里只有前两项,且都在 gitignore 内;用户数据全在工作目录里,删掉它等于彻底重置。
|
||||
|
||||
## 10. 新建会话手选工作目录(本地端)
|
||||
|
||||
默认每个会话落在 `workspace_root/<会话id>`(形如 `task-YYYYMMDD-NNN`)。本地端希望「给它一个
|
||||
目录就放开手脚」,所以新建会话时可以手选一个真实目录,这个会话的 AI 一切操作都在那儿。
|
||||
|
||||
**后端只动 `taskDirOf` 一处**(`engine.js`):
|
||||
|
||||
```js
|
||||
taskDirOf(sessionId) = sessions.work_dir || path.join(workspace_root, sessionId)
|
||||
```
|
||||
|
||||
全仓库的会话路径(文件 API、上传、`terminal` 的 cwd、`resolveInTask` 基准、data-page、
|
||||
`@会话` 只读)都经由它,所以改这一处即全线生效,不必逐个路由改。
|
||||
|
||||
- 选择只存前端(`pendingWorkDir`),建档时随 `POST /api/sessions` 提交一次;不选 = 空串 = 老行为。
|
||||
- **不建 `task-*` 子目录**,直接以所选目录为工作目录(隐藏产物 `.tmp`/`.imgcache`/`.app`/`data.db` 落在这里)。
|
||||
- 允许多个会话选同一目录;**删会话绝不删该目录**(`deleteSession` 只在 `work_dir` 为空时才 `rmSync`)。
|
||||
- `fsRoot` 优先返回 `ctx.workDir`;`@<会话>` 也按目标会话的 `work_dir` 解析(`resolvePastPath`)。
|
||||
- 目录选择器:`routes/local.js` 用 `osascript`(mac)/ `zenity`/`kdialog`(Linux)弹原生窗口,
|
||||
**仅 `AGENT_LOCAL_PICK=1` 时挂载**(`server.js`),服务器形态 `/api/local/*` 一律 404,前端整条入口隐藏。
|
||||
必须 `execFile` 异步:同步会阻塞事件循环、卡住所有 SSE。
|
||||
- 只接受已存在的目录(`normalizeWorkDir` 校验真实路径),并拒绝根目录 `/` 与平台数据目录。
|
||||
- 服务器形态:前端从不传 `work_dir`,`work_dir` 列恒为空,行为与旧版完全一致。
|
||||
@@ -66,6 +66,13 @@ system prompt 不重复 schema 已表达的内容。
|
||||
|
||||
tools 数组每轮请求完整重发。新工具进来时,先问"能不能装进已有工具",再问"要不要新建"。
|
||||
|
||||
回执/参数里可能很大的内容,若**可再生**(文件在盘上可重读、页面可重抓)或只是当时快照,
|
||||
可在 `agent.trim.rules` 登记历史重放占位裁剪:同时满足「其后 ≥rounds 条 assistant 行」与
|
||||
「其后 ≥turns 条真人消息」后换成单行占位(`app/server/llm.js` 的 `setPayloadTrim`;
|
||||
`side: args` 点名参数、`side: result` 裁整段回执)。`turns: 1` = 回合内不裁、跨回合才裁;
|
||||
长回合里会被反复回看的内容(如 `read_file` 的分段)应配它,否则模型会把同一段重读一遍。
|
||||
一次性输出(`terminal`、外部服务扣额度的生成结果等)不要登记——裁掉后模型无法恢复。
|
||||
|
||||
### 九、回执形态
|
||||
|
||||
- **内容型**工具(`read_file` 的文本、`fetch` 的正文、`db` 的查询结果)回执就是内容本身,不要套 JSON 信封。
|
||||
|
||||
+6
-2
@@ -22,6 +22,8 @@
|
||||
|
||||
1. 用户按住 `#voice-hold` → 页面开始录音(套壳调 `startVoice()`,浏览器自己 `getUserMedia`),同时把整块输入区换成全宽遮罩(实时声波 + 提示文案)。
|
||||
2. 壳推 / 浏览器采的 PCM 进来后,页面自己判停顿(连续静音 ≥0.5s)→ 立即 POST 该段 → 结果攒在内存里。
|
||||
一直不停顿地长说时,累计约 6s 会在**能量最低的分片边界**先切一刀(软切)→ 同样先发出去,
|
||||
否则整段只能憋到松手才上传(这是最慢的路径)。
|
||||
3. 手指上滑进入文案区 = 取消态;松手时处于取消态则**整轮丢弃**(已上传段的结果也丢掉),输入框保持原样。
|
||||
4. 松手 → 页面把尾巴里**有声音的部分**发出去(纯静音的尾巴不发,否则只会换来一次「没有可识别人声」)
|
||||
→ 等所有段回来 → **一次性**写进输入框 → 自动发送。
|
||||
@@ -35,7 +37,7 @@
|
||||
`ScriptProcessor` 虽已标废弃,但 Chrome/Safari/Firefox 都还在,这点开销可忽略。
|
||||
- 降采样:浏览器采样率通常是 44.1k/48k,`downsampleTo16k()` 按「一个输出周期内取均值」降到 16k,
|
||||
小数相位跨分片累计(整数倍抽取会越录越快/越慢)。**不能**把 44.1k 直接喂进 VAD ——
|
||||
0.5s 停顿与 25s 段长都是按 16k 估算的。
|
||||
0.5s 停顿、6s 软切与 25s 段长都是按 16k 估算的。
|
||||
- iOS Safari:`AudioContext` 必须在手势里创建/resume;`await getUserMedia` 之后已脱离手势,
|
||||
所以按下(`pointerdown`)时就先把 ctx 建好,拿到麦克风后复用。
|
||||
- 浏览器只在安全上下文开麦:`http://<IP>` 下麦克风按钮不会出现,只有 HTTPS 域名(或套壳壳内)可用。
|
||||
@@ -371,7 +373,9 @@ Cookie: <登录态> # 与页面同一份 HttpOnly cookie
|
||||
```
|
||||
|
||||
- 上限 20MB,超时 120s;识别失败返回 `{"error": "..."}`(前端直接 toast 出来)。
|
||||
- 一次「按住说话」会变成 **多次** 请求(每个停顿一次,套壳与浏览器都是)。页面串行发送,保证拼接顺序。
|
||||
- 一次「按住说话」会变成 **多次** 请求(每个停顿一次,套壳与浏览器都是)。页面**并行**发送,
|
||||
结果按提交时的下标落位,拼接仍按说话顺序(并行返回是乱序的)。
|
||||
并发上限由 `voice.js` 的 `ASR_MAX_CONCURRENCY` 控制(默认 3),超出的排到后面等前面落定。
|
||||
- 单段失败不影响其他段(页面侧吞掉单段错误,继续等下一段);全部失败才提示。
|
||||
- 服务端只做**超长兜底**:一次请求超过 25s 才切,且切点尽量落在停顿处(端上已经按停顿切好了,
|
||||
这里多数请求根本不会触发切分)。参数见 `mcp/asr/README.md`。
|
||||
|
||||
+194
@@ -0,0 +1,194 @@
|
||||
# 本地端(local 模式)
|
||||
|
||||
把同一个 `agent-core` 直接跑在本机(macOS / Linux),不装 Docker、不起 executor。
|
||||
|
||||
它和服务器版是**同一份代码**,差别只在三件事,全部由 `local/start.sh` 注入:
|
||||
|
||||
| 差异 | 服务器 | 本地 |
|
||||
|---|---|---|
|
||||
| 命令在哪跑 | `agent-executor` 容器(mount/pid namespace 隔离) | 直接在本机 `spawn`(无沙箱) |
|
||||
| 文件工具的根 | 会话目录 `tasks/<会话id>/` | 你选的工作目录下的 `tasks/` |
|
||||
| 监听地址 | `0.0.0.0`(靠宿主机端口映射对外) | `127.0.0.1`(只有本机能访问) |
|
||||
|
||||
后两项分别由环境变量 `AGENT_FILE_SCOPE=workspace` 和 `HOST=127.0.0.1` 控制,容器部署不设置,
|
||||
行为与以前完全一致。
|
||||
|
||||
## 快速开始
|
||||
|
||||
```bash
|
||||
cd agent
|
||||
./local/start.sh # 后台启动,命令 1 秒就返回,可以关掉终端窗口
|
||||
./local/stop.sh # 停止
|
||||
```
|
||||
|
||||
首次运行会:
|
||||
|
||||
1. 自检环境(Node 20+ 必需;ffmpeg / python3 可选),并打开一个**启动状态页**
|
||||
2. 弹窗让你选一个**工作目录**,在里面建 `data/`、`skills/`、`tasks/` 三个子目录
|
||||
3. 把仓库 `skills/` 里的内置技能复制到 `<工作目录>/skills/`
|
||||
4. 生成 `local/config.local.yml`
|
||||
5. 装一次 Node 依赖(`app/` 与带依赖的 MCP,需要联网)
|
||||
6. 起 core + MCP 子进程(没 ffmpeg 时 asr 不启动)
|
||||
7. 停在那儿守护:core 退出就自动拉起
|
||||
|
||||
工作目录是你的:数据库、会话、技能都在里面,仓库里不存任何运行数据。
|
||||
|
||||
浏览器里首次使用:**左下角「用户区」→ 设置 → 模型池**,添加平台和 API Key,然后点「重启」。
|
||||
|
||||
新建会话时,欢迎页「随时开始吧」下方可以**手选一个工作目录**:选了之后这个会话的 AI 一切操作
|
||||
都在那个目录里(不再建 `task-*` 子目录);不选就沿用默认(`<工作目录>/tasks/<会话id>`)。
|
||||
删会话不会删你选的目录。
|
||||
|
||||
没有 Node 20+ 时不会让你白选目录:脚本在入口就停下,终端打出安装方式,自检结果(哪项缺、怎么装)写到状态页。
|
||||
|
||||
> 「重启」能用是因为启动器在守护。`routes/system.js` 的重启实现是 `process.exit(0)`,
|
||||
> 原本靠 Docker 的 restart 策略拉起;本地没有 Docker,没有守护的话点一次服务就回不来了。
|
||||
|
||||
启动器在后台常驻,所以:
|
||||
|
||||
- 关掉终端窗口**不会**停服务;要停就 `./local/stop.sh`
|
||||
- 重复跑 `./local/start.sh` 是安全的:检测到已在运行就只打印地址和停止方式
|
||||
- 想在终端里看实时日志、用 `Ctrl-C` 停:`AGENT_LOCAL_DETACH=0 ./local/start.sh`
|
||||
|
||||
## 启动状态页
|
||||
|
||||
启动时会在浏览器打开 `local/.runtime/status.html`(macOS 默认自动弹,Linux 要 `AGENT_LOCAL_UI=1`):
|
||||
|
||||
- 启动过程中每秒自动刷新,依次列出环境自检、工作目录、依赖安装、MCP、core 就绪
|
||||
- 长步骤(装依赖、等 core 起来)会显示已用时间,并把 npm / core 日志的尾巴实时刷出来
|
||||
- **首次安装**(配置刚生成)不自动跳转:就停在这一页,点「打开应用」自己进去
|
||||
- **后续启动**:就绪后 2 秒自动进应用(同一个标签页)
|
||||
- **失败时就在页面上给出原因和日志**,不用回头翻终端
|
||||
|
||||
这个页面是纯静态文件(不用起服务),所以“node 都没装”的时候也能打开。重跑脚本会重新生成;
|
||||
即使没自动弹出,文件也一直在那个路径。
|
||||
|
||||
## 可选能力
|
||||
|
||||
| 能力 | 需要 | 没有时的表现 |
|
||||
|---|---|---|
|
||||
| 语音输入 | `ffmpeg` + 设置页给 `asr` 填上游(`X-ASR-Base-Url` / `X-ASR-Model`) | 麦克风入口自动隐藏(`/api/asr/status` 返回 `enabled:false`),`mcp_asr` 子进程也不启动 |
|
||||
| 技能 | `python3`(仅 Python 类技能需要) | 技能清单照常显示;调 `run.py` 类技能报「入口启动失败」,`office` 这类非 Python 技能不受影响 |
|
||||
| Office 文档(docx/xlsx/pptx) | 首次用到时下载一次 officecli 二进制(约 34MB) | `office` 报 `binary missing` 并给出该技能 `AGENTS.md` 的路径,按它下载即可(不需 root、不需重启);预览面板里直接显示同一份安装说明 |
|
||||
| 网页搜索 | 无 | 装了 Node 就有(内置免费后端) |
|
||||
| 图片 / 视频生成 | 设置页给对应 MCP 填上游 key | 调用时报明确的缺参错误 |
|
||||
| 反向隧道 | `tunnel/client.yml`(服务器地址 + token) | `start.sh` 跳过,不占端口;配置说明见 `tunnel/README.md` |
|
||||
|
||||
装完 `ffmpeg` 之后**重跑一次 `./local/start.sh`** 即可生效。`python3` 稍特殊:技能清单本来就在,
|
||||
只要新装的解释器落在 core 启动时 `PATH` 已包含的目录里(如 brew 的 `/opt/homebrew/bin`)就无需重启;
|
||||
换了目录就重跑脚本。这三项都不写进配置,靠「起不起子进程 / 注入什么环境变量」切换。
|
||||
|
||||
## 配置放哪
|
||||
|
||||
你选的工作目录下:
|
||||
|
||||
| 路径 | 内容 |
|
||||
|---|---|
|
||||
| `<工作目录>/data/` | SQLite(`.agent.db`)、启动时的 prompt dump |
|
||||
| `<工作目录>/tasks/` | 会话工作区,一个会话一个 `task-YYYYMMDD-NNN/` |
|
||||
| `<工作目录>/skills/` | 技能;内置技能首次启动时复制过来,以后只补缺不覆盖。依赖装在 `skills/deps/` |
|
||||
|
||||
仓库里只有:
|
||||
|
||||
- 生成的配置:`local/config.local.yml`(**首次生成,之后永不覆盖**,避免冲掉你在网页里配的模型与密钥)
|
||||
- 运行期产物:`local/.runtime/`(`status.html` 状态页、`core.log`、`npm-install.log`、`mcp-*.log`、`preview.log` + `watch-<端口>.log`)
|
||||
|
||||
想彻底重来:删掉 `local/config.local.yml` 再启动(工作目录里的数据不会动,重选一个目录就换一套)。
|
||||
技能要跟着仓库更新:删掉 `<工作目录>/skills/<技能名>` 再启动,脚本会把新版补回来(你自建的技能不受影响)。
|
||||
|
||||
## 常用环境变量
|
||||
|
||||
| 变量 | 默认 | 说明 |
|
||||
|---|---|---|
|
||||
| `PORT` | `8090` | core 端口(别撞下面的 MCP 端口) |
|
||||
| `NPM_REGISTRY` | 空 | 手动指定 npm 源(默认自动探测;指定后不再自动换源) |
|
||||
| `MCP_WEB_PORT` / `MCP_IMAGE_PORT` / `MCP_VIDEO_PORT` / `MCP_ASR_PORT` | 8091~8094 | 四个 MCP 的端口(同机跑必须各占一个;改这里还要同步改配置里的 url) |
|
||||
| `PREVIEW_PORT` | `3100` | office 文档预览网关的端口(被占时自动往后找);watch 自己的端口从 26315 起 |
|
||||
| `AGENT_LOCAL_UI` | `auto` | 是否自动打开状态页:`auto` = 仅 macOS,`1` 强制,`0` 关闭(页面无论如何都会生成) |
|
||||
| `AGENT_LOCAL_DETACH` | `1` | `1` = 后台启动后立即返回(用 `stop.sh` 停);`0` = 前台阻塞(看实时日志、`Ctrl-C` 停) |
|
||||
| `AGENT_LOCAL_CACHE` | `~/.cache/agent-local` | 依赖缓存的存放位置(多个 clone 共享) |
|
||||
| `AGENT_LOCAL_NPM_TIMEOUT` | `240` | 单次 `npm install` 的超时秒数,超过就换源重试 |
|
||||
|
||||
## 依赖安装与网络(国内环境)
|
||||
|
||||
首次启动要装一次 Node 依赖,启动器会自己处理环境问题,不需要你操心:
|
||||
|
||||
- **自动选源**:并行探 `registry.npmmirror.com` 与官方源,用最快的那个(国内基本会选 npmmirror)。
|
||||
结果缓存一天;不写你本机的 `~/.npmrc`,也不改全局配置。
|
||||
- **失败自动换源重试**:一个源不行就换下一个;换源成功会记住它。
|
||||
- **卡住有看门狗**:npm 在断网时可能既不报错也不退出,超过 `AGENT_LOCAL_NPM_TIMEOUT` 就结束它并换源。
|
||||
- **装完存缓存**:打成一张 tarball 放到 `~/.cache/agent-local/`。之后重启、删掉 `node_modules`、
|
||||
再 clone 一份,都是解压恢复(秒级、零网络)。
|
||||
- **失败说人话**:状态页会直接告诉你「网络没通 / 缺编译工具链(`xcode-select --install`)/ 没有写权限」,
|
||||
不需要读 npm 日志。
|
||||
|
||||
要清缓存就删那个目录:`rm -rf ~/.cache/agent-local`(下次启动会重新装一次)。
|
||||
|
||||
## 更新
|
||||
|
||||
```bash
|
||||
git pull
|
||||
./local/stop.sh && ./local/start.sh # package.json 变了会自动重装依赖
|
||||
```
|
||||
|
||||
`app/server` 是直接跑源码,前端也是免构建的,所以改完代码重启(或在网页点「重启」)即生效。
|
||||
|
||||
## 安全边界(务必知情)
|
||||
|
||||
本地模式**没有沙箱**:AI 的 `terminal` 就是本机 shell,能读写你账号有权限的任何文件,
|
||||
包括 `~/.ssh`、浏览器数据、其它项目。这不是配置疏漏,而是「给它一个目录就放开手脚」的代价。
|
||||
|
||||
两条低成本保险:
|
||||
|
||||
1. 工作目录选一个**专用**目录,别直接选 `$HOME` 或整个代码仓库根
|
||||
2. 那个目录先 `git init` 一下,改坏了能回滚
|
||||
|
||||
另外,`core` 只监听 `127.0.0.1`,同一局域网的人访问不到。
|
||||
|
||||
配了隧道后,core 会经隧道 client 暴露到公网域名。访问控制靠隧道 token + 上游 nginx 的 TLS;
|
||||
入口仍是 `127.0.0.1:8090`,不额外监听端口。
|
||||
|
||||
## 已知限制
|
||||
|
||||
- **没 ffmpeg 时 core 日志会有一条 `asr 工具发现失败`**:此时 `mcp_asr` 不启动(它转码要靠
|
||||
ffmpeg),但配置里的 asr 条目仍保留(配置不被覆盖)。重试几次后放弃,不影响其它功能。
|
||||
- **`mcp_asr` 启动后监听 `0.0.0.0`**:它只认 `PORT` 环境变量,没有 `--host` 参数
|
||||
(另外三个服务都传了 `--host 127.0.0.1`)。它不存任何密钥(上游参数随请求带入),
|
||||
暴露面有限,但严格起见可以给 `mcp/asr` 补一个 `--host` 支持。
|
||||
- **Windows 暂不支持**:本机执行走 `spawn('/bin/sh')` 与 `process.kill(-pid)`,都是 POSIX 语义。
|
||||
- **链接只在本机可达**:没有公网前缀时,`mint_public_link` 与页面访问地址都会签成
|
||||
`http://127.0.0.1:<PORT>/...`,在这台机器上点得开,发给别人打不开。要对外暴露再填
|
||||
`public_link.base_url`(设置页)。本地监听回环地址,模型厂商也拉不到,所以读图回传改走内联
|
||||
base64(`AGENT_IMAGE_INLINE=1`,启动器已注入)。
|
||||
- **`office` 预览依赖 `officecli`**:网关按需起 `officecli watch`(最多 4 个,闲置 6 小时回收)。
|
||||
没装二进制时预览面板会直接显示安装说明,不会无限转圈。watch 只能监听 `0.0.0.0`(它没有
|
||||
`--host` 参数),同机其它用户理论上能访问那几个端口。
|
||||
- **技能依赖不预装**:本地没有 `agent-executor-init`,技能自带的 `requirements.txt` 不会在启动时
|
||||
自动安装。缺包时会报 `ModuleNotFoundError`,模型会把缺的包装进 `<工作目录>/skills/deps`
|
||||
(`AGENT_SKILLS_DEPS` 指向它,且已在该进程的 `PYTHONPATH` 里,装完下次运行即生效)。
|
||||
连 `python3` 都没有时技能清单依旧完整,模型会自己把它装上再继续。
|
||||
需要系统库的包(如 `weasyprint` 依赖 pango/cairo)pip 装不了,得自己 `brew install`。
|
||||
- **首个 `npm install` 要联网**:启动器会自动选源、换源重试、并把装好的依赖缓存到
|
||||
`~/.cache/agent-local/`;之后重启 / 换 clone 都是本地解压,不需要网络。真要手动指定源:
|
||||
`NPM_REGISTRY=https://registry.npmmirror.com ./local/start.sh`。中途失败留下的半成品
|
||||
`node_modules` 不用手删(换源重试前会自动清)。
|
||||
|
||||
## 排查
|
||||
|
||||
```bash
|
||||
open local/.runtime/status.html # 启动状态页:步骤、失败原因、日志尾巴
|
||||
tail -f local/.runtime/core.log # core 日志(含 prompt dump 路径、MCP 发现结果)
|
||||
tail -f local/.runtime/npm-install.log # 装依赖的输出
|
||||
tail -f local/.runtime/mcp-asr.log # 单个 MCP 的日志
|
||||
tail -f local/.runtime/preview.log # office 预览网关(watch 启动失败的原因也在这)
|
||||
```
|
||||
|
||||
启动失败时状态页会自己弹出(带错误说明和日志尾部);它是个静态页,所以改完环境要自己重跑脚本
|
||||
(它不会自动重试)。
|
||||
|
||||
进程表 / 端口对不上时:
|
||||
|
||||
```bash
|
||||
lsof -nP -iTCP:8090-8094 -sTCP:LISTEN # core + 四个 MCP 的监听情况
|
||||
lsof -nP -iTCP:3100 -sTCP:LISTEN # 预览网关(没用 office 时不存在)
|
||||
```
|
||||
@@ -0,0 +1,49 @@
|
||||
# 本机 local 模式的配置参考。
|
||||
#
|
||||
# ⚠️ 这个文件不会被读取,只是给人看的样板:真正的配置由 local/start.sh 首次运行时
|
||||
# 生成到 local/config.local.yml(含你选的工作目录与分配好的端口)。
|
||||
# 想看自己机器上实际生成成什么样,启动一次后直接打开 local/config.local.yml。
|
||||
#
|
||||
# 字段含义与服务器版完全一致(见 app/config.example.yml);下面只列 local 模式实际用到的那部分。
|
||||
|
||||
port: 8090
|
||||
|
||||
# 你选的工作目录下的三个子目录:tasks(会话工作区)、data(数据库等)、skills(技能)。
|
||||
|
||||
# AI 的工作根:文件工具的根就是它,AI 看不到同级的 data/ 与 skills/。
|
||||
workspace_root: /Users/you/AgentWork/tasks
|
||||
|
||||
# SQLite(.agent.db)与启动 prompt dump。
|
||||
data_root: /Users/you/AgentWork/data
|
||||
|
||||
skills:
|
||||
# 技能根。首次启动时从仓库 skills/ 复制内置技能过来,之后只补缺不覆盖;
|
||||
# pip 装的依赖落在同级的 deps/。
|
||||
skills_root: /Users/you/AgentWork/skills
|
||||
|
||||
# 留空:启动后到设置页添加平台与 API Key,再点「重启」(启动器负责把进程拉起来)。
|
||||
platforms: []
|
||||
|
||||
log_level: info
|
||||
|
||||
mcp_servers:
|
||||
# 四个同栈 MCP 由启动器在本机拉起,端口与 start.sh 里的默认值对应(8091~8094,
|
||||
# 紧跟在 core 的 8090 后面;改 PORT 时别撞上这四个)。
|
||||
# web_search 不需要任何密钥(内置免费后端);其余三个的上游参数在设置页卡片里填,
|
||||
# 会写进对应条目的 headers。
|
||||
- name: web_search
|
||||
url: "http://127.0.0.1:8091/"
|
||||
- name: image_task
|
||||
url: "http://127.0.0.1:8092/mcp"
|
||||
mode: skill
|
||||
- name: video_task
|
||||
url: "http://127.0.0.1:8093/mcp"
|
||||
mode: skill
|
||||
- name: asr
|
||||
url: "http://127.0.0.1:8094/mcp"
|
||||
mode: skill
|
||||
# 例:填了这两项才算启用语音(缺 X-ASR-Base-Url 时 /api/asr/status 返回 enabled:false,麦克风自动隐藏)
|
||||
# headers:
|
||||
# Authorization: Bearer <key>
|
||||
# X-ASR-Base-Url: "https://<host>/v1"
|
||||
# X-ASR-Model: "whisper-1"
|
||||
@@ -0,0 +1,718 @@
|
||||
#!/usr/bin/env node
|
||||
// local/preview-gateway.js —— 本地 office 文档预览网关(对位服务器上 executor 的 :3100)。
|
||||
//
|
||||
// 为什么要有它:服务器上「点开 docx」这条链是 core → 反代 /preview → executor 预览网关 →
|
||||
// 网关自己按需 spawn `officecli watch`。本地没有 executor,那条链路会断,面板里是个空 iframe。
|
||||
// 这里用零依赖 Node 复刻 executor/preview.js 的**数据面**,但不复刻它的隔离层:
|
||||
// 服务器给 watch 造 pid/mount ns 牢笼、bind 会话 .tmp 到 /tmp,是为了让**沙箱里的命令**
|
||||
// 和 watch 看见同一个世界(vendor 用 TMPDIR 下的 .port 文件 + TCP 回环发现彼此)。
|
||||
// 本地既没有沙箱,命令和 watch 本来就在同一个文件系统、同一个临时目录里,
|
||||
// 那些 unshare/nsenter 不但用不上,有些平台上根本不存在。于是这里只剩数据面:
|
||||
//
|
||||
// 1. /preview/<会话id>/<相对路径>/ → 解析成真实文件 → 确保它有 watch → 转发
|
||||
// 2. 页内数据面(/events、/api/*、以及 vendor 拿去比对自身的 /)→ 按 Referer 认领槽位转发
|
||||
// 3. 槽位:最多 N 个并发 watch,挤占最久未用的,闲置回收
|
||||
// 4. 缺 officecli 时给人能看懂的一页,而不是无限转圈(服务器那份二进制是构建期必装的,
|
||||
// 所以 executor 那份没为「没装」设计过;本地全新 clone 一定没有,这是常态不是异常)
|
||||
//
|
||||
// 与服务器实现逐条对齐的几处(都踩过,别简化掉):
|
||||
// - 探活 = 真发一次 `GET /`(首帧渲染就在这次请求里完成),裸 TCP 连上只说明 Kestrel bind 好了
|
||||
// - HEAD 探针等槽位就绪(有上限)再回 200:否则冷启动的首次渲染全砸在 iframe 的导航请求上
|
||||
// - 导航请求绝不为启动/自愈阻塞首字节:未就绪 → 立刻回中转页 + 后台热槽
|
||||
// - vendor 页把 `/` 当作「自身最新 HTML」来比对,回 404 它就 location.reload() —— 用户看到白屏
|
||||
// - 外部写盘(不走 officecli 的)靠 mtime 指纹 + 2s 轮询 POST /api/switch 触发重读
|
||||
//
|
||||
// 平台:只用 Node 内置能力,进程回收/二进制名/可执行位都按平台分支,不假设 POSIX。
|
||||
// 监听回环(默认 127.0.0.1:3100),唯一入口仍是 core 的 /preview 反代(登录门禁在那边)。
|
||||
'use strict';
|
||||
const fs = require('node:fs');
|
||||
const fsp = require('node:fs').promises;
|
||||
const http = require('node:http');
|
||||
const net = require('node:net');
|
||||
const path = require('node:path');
|
||||
const { spawn } = require('node:child_process');
|
||||
|
||||
const WIN = process.platform === 'win32';
|
||||
|
||||
const HOST = process.env.OFFICE_PREVIEW_HOST || '127.0.0.1';
|
||||
const PORT = Number(process.env.OFFICE_PREVIEW_PORT || 3100);
|
||||
const PREFIX = (process.env.OFFICE_PREVIEW_PREFIX || '/preview').replace(/\/+$/, '');
|
||||
const SLOTS = Math.max(1, Number(process.env.OFFICE_SLOTS || 4));
|
||||
const WATCH_BASE = Number(process.env.OFFICE_WATCH_BASE || 26315);
|
||||
const WATCH_SPAN = Math.max(SLOTS, Number(process.env.OFFICE_WATCH_SPAN || 64));
|
||||
const IDLE_MS = Number(process.env.OFFICE_IDLE_MS || 6 * 3600 * 1000);
|
||||
const RESPOND_TIMEOUT_MS = Number(process.env.OFFICE_RESPOND_TIMEOUT_MS || 15000); // 数据请求等首响包
|
||||
const NAV_TIMEOUT_MS = Number(process.env.OFFICE_NAV_TIMEOUT_MS || 5000); // 导航请求更短:失败转中转页
|
||||
const COOLDOWN_MS = Number(process.env.OFFICE_COOLDOWN_MS || 8000); // 启动失败后短期不再重试
|
||||
const HEAD_WAIT_MS = Number(process.env.OFFICE_HEAD_WAIT_MS || 15000); // 探针等首帧的上限
|
||||
const NAV_TIMEOUT_RETRIES = 3; // 连续导航超时几次才判死
|
||||
|
||||
// 会话真实目录:默认 <tasks 根>/<会话id>;手选过工作目录的会话要问 core 拿 work_dir(本地免鉴权)。
|
||||
const TASKS_ROOT = path.resolve(process.env.AGENT_TASKS_ROOT || process.cwd());
|
||||
const SKILLS_ROOT = path.resolve(process.env.AGENT_SKILLS_ROOT || path.join(TASKS_ROOT, '..', 'skills'));
|
||||
const REPO_ROOT = path.resolve(process.env.AGENT_REPO_ROOT || path.join(__dirname, '..'));
|
||||
const RUNTIME = path.resolve(process.env.AGENT_RUNTIME || path.join(__dirname, '.runtime'));
|
||||
const CORE_URL = process.env.AGENT_CORE_URL || '';
|
||||
const EXTS = new Set(['.docx', '.xlsx', '.pptx']);
|
||||
const SID_RE = /^task-[0-9A-Za-z_-]+$/;
|
||||
|
||||
const slots = new Map(); // 文件绝对路径 → { file, port, watch, pageDec, ready, readyP, lastUsed, conns, ... }
|
||||
const starting = new Map(); // 文件绝对路径 → Promise:同文件并发请求合并成一次 spawn
|
||||
const cooldown = new Map(); // 文件绝对路径 → 冷却截止时间戳
|
||||
const dirCache = new Map(); // 会话id → 真实目录(只缓存命中,避免会话晚建时永久失效)
|
||||
let watchGen = 0; // watch 端口按代轮转:残留孤儿占着旧口也不会被新槽撞上
|
||||
|
||||
const log = (msg) => process.stdout.write(new Date().toISOString() + ' ' + msg + '\n');
|
||||
|
||||
// ---------- 小工具 ----------
|
||||
function escapeHtml(s) {
|
||||
return String(s).replace(/&/g, '&').replace(/</g, '<').replace(/>/g, '>');
|
||||
}
|
||||
|
||||
// 二进制解析:每次 spawn 时才做——AI 按技能 AGENTS.md 装好之后,用户点一下刷新就该能用,不该要求重启网关。
|
||||
// 名字不一定是 officecli:官方资产叫 officecli-<平台>-<架构>[.exe],AI 很可能原样下载,所以标准名之后
|
||||
// 再认同目录里任何 officecli* 可执行文件。可执行位只在 POSIX 上有意义,且 curl 下来的资产常常是 0644,
|
||||
// 这里顺手补一下(不能要求调用者先 chmod)。
|
||||
function executable(p) {
|
||||
if (WIN) {
|
||||
try { return fs.statSync(p).isFile(); } catch (_) { return false; }
|
||||
}
|
||||
try { fs.accessSync(p, fs.constants.X_OK); return true; } catch (_) {}
|
||||
try { fs.chmodSync(p, 0o755); fs.accessSync(p, fs.constants.X_OK); return true; } catch (_) { return false; }
|
||||
}
|
||||
|
||||
function binDirs() {
|
||||
return [path.join(SKILLS_ROOT, 'office', 'bin'), path.join(REPO_ROOT, 'skills', 'office', 'bin')];
|
||||
}
|
||||
|
||||
function resolveBin() {
|
||||
const env = String(process.env.OFFICECLI_BIN || '').trim();
|
||||
if (env && executable(env)) return env;
|
||||
const std = WIN ? ['officecli.exe', 'officecli'] : ['officecli'];
|
||||
const dirs = binDirs();
|
||||
for (const d of dirs) {
|
||||
for (const n of std) {
|
||||
const p = path.join(d, n);
|
||||
if (executable(p)) return p;
|
||||
}
|
||||
}
|
||||
for (const d of dirs) {
|
||||
let list = [];
|
||||
try { list = fs.readdirSync(d).sort(); } catch (_) { continue; }
|
||||
for (const n of list) {
|
||||
if (!/^officecli/i.test(n)) continue;
|
||||
if (WIN ? !/\.exe$/i.test(n) : /\.(?:log|txt|md|zip|tar|gz|sha\d*)$/i.test(n)) continue;
|
||||
const p = path.join(d, n);
|
||||
if (executable(p)) return p;
|
||||
}
|
||||
}
|
||||
return null;
|
||||
}
|
||||
|
||||
// 端口能不能连上(判「有没有人在听」)。注意它**不能**当就绪判定:Kestrel bind 完成就能连,
|
||||
// 首帧还没渲染;就绪一律用 portUp(真发一次 GET /)。
|
||||
function portListening(port) {
|
||||
return new Promise((resolve) => {
|
||||
const s = net.connect({ host: '127.0.0.1', port, timeout: 800 });
|
||||
let done = false;
|
||||
const fin = (v) => { if (done) return; done = true; try { s.destroy(); } catch (_) {} resolve(v); };
|
||||
s.once('connect', () => fin(true));
|
||||
s.once('timeout', () => fin(false)); // 回环上不回 SYN 几乎不存在,按空闲处理
|
||||
s.once('error', () => fin(false));
|
||||
});
|
||||
}
|
||||
|
||||
// 就绪探活:真发一次 `GET /`(首帧渲染在这次请求里完成,后续浏览器请求走 vendor 的页内缓存)。
|
||||
// 任何状态码都算活着;拒连/超时继续重试,预算 40 次 x 250ms。
|
||||
function portUp(port, tries = 40) {
|
||||
return new Promise((resolve, reject) => {
|
||||
let n = 0;
|
||||
const probe = () => {
|
||||
const rq = http.get({ host: '127.0.0.1', port, path: '/', timeout: 2000 }, (up) => {
|
||||
up.resume();
|
||||
resolve();
|
||||
});
|
||||
const retry = () => {
|
||||
if (++n >= tries) return reject(new Error('watch 未在预期时间内就绪'));
|
||||
setTimeout(probe, 250);
|
||||
};
|
||||
rq.on('error', retry);
|
||||
rq.on('timeout', () => { try { rq.destroy(); } catch (_) {} retry(); });
|
||||
};
|
||||
probe();
|
||||
});
|
||||
}
|
||||
|
||||
// 端口代次轮转 + 领取前确认空闲:AI 手动起的 watch、以及被杀的旧 watch 残留,都占着固定口。
|
||||
async function allocPort() {
|
||||
for (let i = 0; i < WATCH_SPAN; i++) {
|
||||
const p = WATCH_BASE + (watchGen++ % WATCH_SPAN);
|
||||
let used = false;
|
||||
for (const s of slots.values()) if (s.port === p) { used = true; break; }
|
||||
if (used) continue;
|
||||
if (!(await portListening(p))) return p;
|
||||
}
|
||||
throw new Error('没有空闲的 watch 端口(' + WATCH_BASE + '~' + (WATCH_BASE + WATCH_SPAN - 1) + ')');
|
||||
}
|
||||
|
||||
// 回收 watch:POSIX 上它自成进程组(detached),按组杀才不会留下占端口的子进程;
|
||||
// Windows 没有进程组信号,用 taskkill /T 连子树一起收。
|
||||
function killTree(child) {
|
||||
if (!child || !child.pid) return;
|
||||
if (WIN) {
|
||||
try { spawn('taskkill', ['/pid', String(child.pid), '/T', '/F'], { stdio: 'ignore', windowsHide: true }); return; } catch (_) {}
|
||||
} else {
|
||||
try { process.kill(-child.pid, 'SIGKILL'); return; } catch (_) {}
|
||||
}
|
||||
try { child.kill('SIGKILL'); } catch (_) {}
|
||||
}
|
||||
|
||||
function killWatch(entry) {
|
||||
// 已退出的进程不再按 pid 杀:pid 可能已被系统回给别的进程组(POSIX 上是 -pid)
|
||||
if (entry.watch && entry.watch.exitCode === null && entry.watch.signalCode === null) killTree(entry.watch);
|
||||
}
|
||||
|
||||
function stopEntry(entry, why) {
|
||||
const key = entry.file;
|
||||
if (slots.get(key) === entry) slots.delete(key);
|
||||
killWatch(entry);
|
||||
if (why) log('回收槽位 ' + path.basename(key) + '(' + why + ')');
|
||||
}
|
||||
|
||||
// ---------- 页面 ----------
|
||||
function htmlPage(res, title, body, autoRefresh, code) {
|
||||
const html = '<!doctype html><html lang="zh-CN"><head><meta charset="utf-8">' +
|
||||
'<title>' + escapeHtml(title) + '</title>' +
|
||||
(autoRefresh ? '<meta http-equiv="refresh" content="' + autoRefresh + '">' : '') +
|
||||
'<style>body{font-family:-apple-system,system-ui,sans-serif;margin:0;padding:40px;line-height:1.7;color:#222}' +
|
||||
'h1{font-size:18px;margin:0 0 12px}code{background:#f2f2f2;padding:1px 5px;border-radius:3px;font-size:13px}' +
|
||||
'p{margin:8px 0;max-width:46em;color:#444}</style></head><body>' +
|
||||
'<h1>' + escapeHtml(title) + '</h1>' + body + '</body></html>';
|
||||
res.writeHead(code || 200, { 'content-type': 'text/html; charset=utf-8', 'cache-control': 'no-store' });
|
||||
res.end(html);
|
||||
}
|
||||
|
||||
// 中转页:槽位在启动/刚死,先给浏览器一个纯 CSS 转圈 + 自动刷新,别白屏干等(与服务器同一张页)。
|
||||
function loading(res) {
|
||||
res.writeHead(200, { 'content-type': 'text/html; charset=utf-8', 'cache-control': 'no-store' });
|
||||
res.end('<!doctype html><meta charset="utf-8"><meta http-equiv="refresh" content="2">' +
|
||||
'<title>正在准备预览</title><style>' +
|
||||
'html,body{height:100%;margin:0;font-family:system-ui,-apple-system,sans-serif;background:#fafafa;color:#666}' +
|
||||
'.w{position:absolute;top:50%;left:50%;transform:translate(-50%,-50%);text-align:center}' +
|
||||
'.s{width:36px;height:36px;margin:0 auto 14px;border:3px solid #ddd;border-top-color:#4a90d9;border-radius:50%;animation:r 1s linear infinite}' +
|
||||
'@keyframes r{to{transform:rotate(360deg)}}p{font-size:14px}' +
|
||||
'</style><div class="w"><div class="s"></div><p>正在准备预览,请稍候。</p></div>');
|
||||
}
|
||||
|
||||
function installPage(res) {
|
||||
const bin = path.join(SKILLS_ROOT, 'office', 'bin', WIN ? 'officecli.exe' : 'officecli');
|
||||
htmlPage(res, 'office 预览组件未安装',
|
||||
'<p>预览需要 <code>officecli</code> 二进制,这台机器上还没有。</p>' +
|
||||
'<p>它应该放在 <code>' + escapeHtml(bin) + '</code>。</p>' +
|
||||
'<p>让 AI 打开一次这个文档即可(说「用 office 打开这个文档」)——它会按技能目录里的 ' +
|
||||
'<code>AGENTS.md</code> 自己下载好;装完点下面的按钮刷新,不用重启服务。</p>' +
|
||||
'<p><button onclick="location.reload()">刷新</button></p>');
|
||||
}
|
||||
|
||||
function notFound(res) {
|
||||
// no-store:前端拿 HEAD 当探针,404 一旦被浏览器缓存,文件补上后还会继续显示「暂无文档」
|
||||
res.writeHead(404, { 'content-type': 'text/plain; charset=utf-8', 'cache-control': 'no-store' })
|
||||
.end('无匹配预览(文档不存在、不在会话目录下,或不是 .docx/.xlsx/.pptx)');
|
||||
}
|
||||
|
||||
function fail502(res) {
|
||||
if (!res.headersSent) {
|
||||
res.writeHead(502, { 'content-type': 'text/plain; charset=utf-8' }).end('预览暂时不可用,请稍后重试');
|
||||
}
|
||||
}
|
||||
|
||||
// ---------- 会话目录与路径护栏 ----------
|
||||
function coreGet(pathname) {
|
||||
return new Promise((resolve, reject) => {
|
||||
if (!CORE_URL) return reject(new Error('未配置 AGENT_CORE_URL'));
|
||||
const u = new URL(CORE_URL);
|
||||
const req = http.request({ host: u.hostname, port: u.port, path: pathname, method: 'GET', timeout: 3000 }, (res) => {
|
||||
let body = '';
|
||||
res.setEncoding('utf8');
|
||||
res.on('data', (c) => { body += c; });
|
||||
res.on('end', () => {
|
||||
if (res.statusCode !== 200) return reject(new Error('core ' + res.statusCode));
|
||||
try { resolve(JSON.parse(body)); } catch (e) { reject(e); }
|
||||
});
|
||||
});
|
||||
req.on('error', reject);
|
||||
req.on('timeout', () => { req.destroy(new Error('core 超时')); });
|
||||
req.end();
|
||||
});
|
||||
}
|
||||
|
||||
async function sessionDir(sid) {
|
||||
if (dirCache.has(sid)) return dirCache.get(sid);
|
||||
const plain = path.join(TASKS_ROOT, sid);
|
||||
let dir = fs.existsSync(plain) ? plain : '';
|
||||
if (!dir) {
|
||||
// 手选工作目录的会话:只有 core 知道真实路径(sessions.work_dir)。
|
||||
// 接口回的是 { session, ... },limit=1 只为别把整段历史拉回来。
|
||||
try {
|
||||
const row = await coreGet('/api/sessions/' + encodeURIComponent(sid) + '?limit=1');
|
||||
const wd = String((row && row.session && row.session.work_dir) || '');
|
||||
if (wd && fs.existsSync(wd)) dir = wd;
|
||||
} catch (_) { /* core 没起来 / 会话不存在:下面按缺失处理 */ }
|
||||
}
|
||||
if (dir) dirCache.set(sid, dir);
|
||||
return dir;
|
||||
}
|
||||
|
||||
// /preview/<会话id>/<相对路径> → { sid, dir, abs, rel };越界(..、绝对路径)与非办公文档一律 null。
|
||||
async function guard(sid, rawRel) {
|
||||
if (!SID_RE.test(sid)) return null;
|
||||
const dir = await sessionDir(sid);
|
||||
if (!dir) return null;
|
||||
const rel = rawRel.replace(/^\/+/, '');
|
||||
const abs = path.resolve(dir, rel);
|
||||
if (abs !== dir && !abs.startsWith(dir + path.sep)) return null;
|
||||
if (!EXTS.has(path.extname(abs).toLowerCase())) return null;
|
||||
try { await fsp.access(abs); } catch (_) { return null; }
|
||||
return { sid, dir, abs, rel: path.relative(dir, abs).split(path.sep).join('/') };
|
||||
}
|
||||
|
||||
function pageOf(t) {
|
||||
return '/' + t.sid + '/' + t.rel; // 页面前缀(已解码):槽位按它寻址
|
||||
}
|
||||
|
||||
// 路由:rel = 已解码、剥掉 PREFIX 的请求路径(形如 /task-x/doc.docx/…);最长前缀优先。
|
||||
// exact = 命中的就是页面本身(此时缺尾斜杠要 301,否则页面内相对资源会解析错)。
|
||||
function matchPage(rel) {
|
||||
if (!rel) return null;
|
||||
const rr = rel.startsWith('/') ? rel : '/' + rel;
|
||||
const cut = rr.replace(/\/+$/, '');
|
||||
let best = null;
|
||||
for (const s of slots.values()) {
|
||||
if (cut === s.pageDec) return { entry: s, exact: true };
|
||||
if (cut.startsWith(s.pageDec + '/')) {
|
||||
if (!best || s.pageDec.length > best.entry.pageDec.length) best = { entry: s, exact: false };
|
||||
}
|
||||
}
|
||||
return best;
|
||||
}
|
||||
|
||||
// ---------- watch 生命周期 ----------
|
||||
async function spawnWatch(t) {
|
||||
const bin = resolveBin();
|
||||
if (!bin) {
|
||||
const e = new Error('缺少 officecli 二进制');
|
||||
e.code = 'MISSING_BIN';
|
||||
throw e;
|
||||
}
|
||||
// 槽满:优先踢「就绪且无活动连接」里最久未用的;正在启动的槽最后才动(踢掉它等于白费冷启动)
|
||||
if (slots.size >= SLOTS) {
|
||||
const list = [...slots.values()];
|
||||
const pick = (list.filter((s) => !s.conns && s.ready).length ? list.filter((s) => !s.conns && s.ready)
|
||||
: list.filter((s) => !s.conns).length ? list.filter((s) => !s.conns) : list)
|
||||
.sort((a, b) => a.lastUsed - b.lastUsed)[0];
|
||||
if (pick) stopEntry(pick, '槽满挤占');
|
||||
}
|
||||
const port = await allocPort();
|
||||
try { await fsp.mkdir(RUNTIME, { recursive: true }); } catch (_) {}
|
||||
const logPath = path.join(RUNTIME, 'watch-' + port + '.log');
|
||||
const fd = fs.openSync(logPath, 'a');
|
||||
const child = spawn(bin, ['watch', t.abs, '--port', String(port)], {
|
||||
cwd: t.dir,
|
||||
detached: !WIN, // POSIX:自成进程组便于整组回收;Windows 靠 taskkill /T
|
||||
windowsHide: true,
|
||||
stdio: ['ignore', fd, fd],
|
||||
env: Object.assign({}, process.env, {
|
||||
// 与技能封装层同一组开关:不变式模式跑 .NET、改动即落盘、关自动 resident
|
||||
DOTNET_SYSTEM_GLOBALIZATION_INVARIANT: '1',
|
||||
OFFICECLI_NO_AUTO_RESIDENT: '1',
|
||||
OFFICECLI_RESIDENT_FLUSH: 'each',
|
||||
}),
|
||||
});
|
||||
try { fs.closeSync(fd); } catch (_) {}
|
||||
|
||||
const entry = {
|
||||
file: t.abs, port, watch: child, pageDec: pageOf(t),
|
||||
lastUsed: Date.now(), conns: 0, ready: false, readyP: null, navTimeouts: 0,
|
||||
mtimeMs: 0, size: -1, logPath,
|
||||
};
|
||||
let exited = null;
|
||||
child.on('exit', (code, sig) => {
|
||||
exited = { code, sig };
|
||||
if (slots.get(entry.file) === entry) slots.delete(entry.file); // 死了就别留在册(否则一直转发到死端口)
|
||||
});
|
||||
child.on('error', (e) => { exited = { code: -1, sig: String((e && e.message) || e) }; });
|
||||
slots.set(entry.file, entry); // 同步占坑(未就绪):并发请求等 readyP,绝不盲转发
|
||||
|
||||
let markDead;
|
||||
const dead = new Promise((_, rej) => { markDead = rej; });
|
||||
const deadTimer = setInterval(() => { if (exited) markDead(new Error('watch 进程提前退出')); }, 100);
|
||||
deadTimer.unref();
|
||||
|
||||
entry.readyP = Promise.race([
|
||||
portUp(port).then(() => { entry.ready = true; log('起 watch ' + path.basename(t.abs) + ' @' + port); }),
|
||||
dead,
|
||||
]).catch((e) => {
|
||||
if (slots.get(entry.file) === entry) slots.delete(entry.file);
|
||||
killWatch(entry);
|
||||
throw e instanceof Error ? e : new Error('watch 启动失败:' + ((e && e.message) || e));
|
||||
}).finally(() => clearInterval(deadTimer));
|
||||
|
||||
try {
|
||||
await entry.readyP;
|
||||
} catch (e) {
|
||||
let tail = '';
|
||||
try { tail = fs.readFileSync(logPath, 'utf8').split('\n').slice(-3).join(' | ').trim(); } catch (_) {}
|
||||
const err = new Error(e.message + (tail ? ':' + tail : ''));
|
||||
err.logPath = logPath;
|
||||
throw err;
|
||||
}
|
||||
// mtime+size 作为本次渲染的指纹:导航侧对照,外部写盘后回收重渲染
|
||||
try { const st = await fsp.stat(t.abs); entry.mtimeMs = st.mtimeMs; entry.size = st.size; } catch (_) {}
|
||||
return entry;
|
||||
}
|
||||
|
||||
async function startWatch(t) {
|
||||
const have = slots.get(t.abs);
|
||||
if (have) { have.lastUsed = Date.now(); return have; }
|
||||
const cool = cooldown.get(t.abs);
|
||||
if (cool && Date.now() < cool) throw new Error('刚才启动失败,稍后再试');
|
||||
if (starting.has(t.abs)) return starting.get(t.abs);
|
||||
const p = spawnWatch(t).then(
|
||||
(entry) => { starting.delete(t.abs); cooldown.delete(t.abs); return entry; },
|
||||
(err) => {
|
||||
starting.delete(t.abs);
|
||||
cooldown.set(t.abs, Date.now() + COOLDOWN_MS);
|
||||
log('watch 启动失败 ' + t.abs + ':' + err.message);
|
||||
throw err;
|
||||
},
|
||||
);
|
||||
starting.set(t.abs, p);
|
||||
return p;
|
||||
}
|
||||
|
||||
// 未命中兜底:请求路径本身就是存在的会话文档 → 就地冷启动。不行 = null。
|
||||
async function revive(decRel) {
|
||||
const rr = (decRel || '').replace(/\/+$/, '');
|
||||
if (!rr) return null;
|
||||
const segs = rr.split('/').filter(Boolean);
|
||||
const sid = segs.shift() || '';
|
||||
const t = await guard(sid, segs.join('/'));
|
||||
if (!t) return null;
|
||||
try { await startWatch(t); return { entry: slots.get(t.abs), exact: false }; } catch (_) { return null; }
|
||||
}
|
||||
|
||||
// 数据请求用:拿到「就绪」的槽位,等正在启动的那次;启动刚失败就再补一次。
|
||||
async function waitReady(decRel) {
|
||||
for (let round = 0; round < 2; round++) {
|
||||
let m = matchPage(decRel);
|
||||
if (!m) m = await revive(decRel);
|
||||
if (!m || !m.entry) return null;
|
||||
if (m.entry.ready) return m;
|
||||
await m.entry.readyP.catch(() => {});
|
||||
if (m.entry.ready) return m;
|
||||
}
|
||||
return null;
|
||||
}
|
||||
|
||||
// 探针预热:把槽位等到「就绪」(= 首帧渲染完成),复用时直接返回。任何失败/超时都静默。
|
||||
async function warmSlot(decRel, t) {
|
||||
let timer;
|
||||
try {
|
||||
await Promise.race([
|
||||
(async () => {
|
||||
const have = slots.get(t.abs);
|
||||
if (have && have.ready) return;
|
||||
const e = await startWatch(t);
|
||||
if (!e.ready) await e.readyP.catch(() => {});
|
||||
})(),
|
||||
new Promise((r) => { timer = setTimeout(r, HEAD_WAIT_MS); }),
|
||||
]);
|
||||
} catch (_) {} finally { clearTimeout(timer); }
|
||||
}
|
||||
|
||||
// 就地重读:POST watch /api/switch(同路径 = 强制从磁盘重载),watch 原生推 doc-switched,页面自刷。
|
||||
function notifySwitch(entry) {
|
||||
try {
|
||||
const q = http.request({ host: '127.0.0.1', port: entry.port, path: '/api/switch', method: 'POST', timeout: 8000,
|
||||
headers: { 'content-type': 'application/json' } }, (up) => { up.resume(); });
|
||||
q.on('error', () => {});
|
||||
q.on('timeout', () => { try { q.destroy(); } catch (_) {} });
|
||||
q.end(JSON.stringify({ file: entry.file }));
|
||||
} catch (_) {}
|
||||
}
|
||||
|
||||
// ---------- 转发 ----------
|
||||
const PASS_HEADERS = new Set(['accept', 'accept-encoding', 'cache-control', 'pragma', 'content-type',
|
||||
'content-length', 'if-modified-since', 'if-none-match', 'last-event-id', 'referer', 'user-agent']);
|
||||
|
||||
// 单次转发:拒连/首响应超时 → reject(此时尚未向浏览器写出任何字节,可安全改道);
|
||||
// 已出字节的流内失败只能毁掉响应(SSE 长流的正常路径不受看门狗影响)。
|
||||
function tryForward(entry, req, res, innerPath, respondTimeoutMs) {
|
||||
return new Promise((resolve, reject) => {
|
||||
const selfHost = '127.0.0.1:' + entry.port;
|
||||
const headers = {};
|
||||
for (const k of Object.keys(req.headers)) if (PASS_HEADERS.has(k)) headers[k] = req.headers[k];
|
||||
// watch 的同源校验只认回环:从别的名字(host 名解析到 127.0.0.1)打开 core 时会被 403
|
||||
if (req.headers.origin) headers.origin = 'http://' + selfHost;
|
||||
|
||||
const search = req.url.indexOf('?') >= 0 ? req.url.slice(req.url.indexOf('?')) : '';
|
||||
const inner = innerPath.startsWith('/') ? innerPath : '/' + innerPath;
|
||||
|
||||
entry.lastUsed = Date.now();
|
||||
entry.conns = (entry.conns || 0) + 1;
|
||||
let released = false;
|
||||
const release = () => { if (!released) { released = true; entry.conns = Math.max(0, entry.conns - 1); } };
|
||||
res.once('close', release);
|
||||
res.once('finish', release);
|
||||
|
||||
let started = false;
|
||||
let upRes = null;
|
||||
const upstream = http.request(
|
||||
{ host: '127.0.0.1', port: entry.port, path: encodeURI(inner) + search, method: req.method, headers },
|
||||
(up) => {
|
||||
started = true;
|
||||
upRes = up;
|
||||
clearTimeout(watchdog);
|
||||
const h = Object.assign({}, up.headers);
|
||||
delete h.connection; delete h['keep-alive'];
|
||||
const isSSE = String(h['content-type'] || '').includes('text/event-stream');
|
||||
if (isSSE) { h['cache-control'] = 'no-cache'; h['x-accel-buffering'] = 'no'; }
|
||||
res.writeHead(up.statusCode || 502, h);
|
||||
up.on('data', (d) => {
|
||||
entry.lastUsed = Date.now();
|
||||
// 抓到「真改文档」的原生推送(牢笼内 CLI 编辑会推 excel-patch/full 等):给轮询器一个吸收窗口。
|
||||
// 只认改文档的 action —— selection-update/mark-update 是 UI 态,把页内编辑的救场 switch 也吸掉就永不刷新了
|
||||
if (isSSE && /"action":"(?:full|excel-patch|word-patch|replace|add|remove)"/.test(String(d))) entry.lastNative = Date.now();
|
||||
});
|
||||
up.pipe(res);
|
||||
resolve();
|
||||
});
|
||||
const watchdog = setTimeout(() => {
|
||||
if (started) return;
|
||||
try { upstream.destroy(); } catch (_) {}
|
||||
release();
|
||||
if (!res.headersSent) reject(new Error('watch 响应超时'));
|
||||
}, respondTimeoutMs || RESPOND_TIMEOUT_MS);
|
||||
upstream.on('error', () => {
|
||||
clearTimeout(watchdog);
|
||||
release();
|
||||
if (!started && !res.headersSent) return reject(new Error('watch 不可达'));
|
||||
// 已开始回写后上游报错:留一拍再判(watch 会在响应其实已完整时断链,对 HEAD 必现)
|
||||
setTimeout(() => {
|
||||
if (res.writableEnded) return;
|
||||
try { res.destroy(); } catch (_) {}
|
||||
}, upRes && upRes.complete ? 0 : 120);
|
||||
});
|
||||
req.pipe(upstream);
|
||||
});
|
||||
}
|
||||
|
||||
// 转发自愈一次:失败 → 摘槽 → 同页原地复活 → 重试。GET/HEAD 才可重试(无请求体,重放无副作用)。
|
||||
async function forwardHealed(entry, req, res, innerPath) {
|
||||
try { await tryForward(entry, req, res, innerPath); return true; }
|
||||
catch (e) {
|
||||
stopEntry(entry, '转发失败:' + String((e && e.message) || e));
|
||||
if (res.headersSent || !/^(GET|HEAD)$/.test(req.method)) return false;
|
||||
await new Promise((r) => setTimeout(r, 400)); // 给内核回收旧 listen 套接字留个极短窗口
|
||||
const m2 = await waitReady(entry.pageDec);
|
||||
if (!m2 || !m2.entry) return false;
|
||||
try {
|
||||
await tryForward(m2.entry, req, res, innerPath);
|
||||
return true;
|
||||
} catch (_) { return false; }
|
||||
}
|
||||
}
|
||||
|
||||
// 槽位过期:外部(非 officecli)写盘改的是文件,watch 内存里的渲染不感知 → 导航时比对指纹回收重渲染
|
||||
function fileChanged(entry) {
|
||||
try {
|
||||
const st = fs.statSync(entry.file);
|
||||
return st.mtimeMs !== entry.mtimeMs || st.size !== entry.size;
|
||||
} catch (_) { return false; }
|
||||
}
|
||||
|
||||
// 浏览器导航请求判定:只有地址栏/iframe 直开页面带 text/html
|
||||
function isNav(req) {
|
||||
return req.method === 'GET' && /text\/html/.test(String(req.headers.accept || ''));
|
||||
}
|
||||
|
||||
// 数据请求(资源/API/SSE/Referer 兜底):按 Referer 找回来源页面
|
||||
function refererRel(req) {
|
||||
const ref = req.headers.referer || req.headers.referrer || '';
|
||||
if (!ref) return null;
|
||||
try {
|
||||
const rp = decodeURIComponent(new URL(ref).pathname);
|
||||
if (!rp.startsWith(PREFIX + '/')) return null;
|
||||
return rp.slice(PREFIX.length);
|
||||
} catch (_) { return null; }
|
||||
}
|
||||
|
||||
// ---------- 编辑命令的事后一脚 ----------
|
||||
// office 封装层改动成功后 fire-and-forget 打这里(本地没有沙箱,原生通知本来就能到 watch;
|
||||
// 这一脚是无害的补强,也让行为与服务器保持一致)。
|
||||
function handleTouch(req, res) {
|
||||
let body = '';
|
||||
req.on('data', (d) => { body += d; if (body.length > 4096) req.destroy(); });
|
||||
req.on('end', () => {
|
||||
let f = '';
|
||||
try { f = String(JSON.parse(body || '{}').file || ''); } catch (_) {}
|
||||
let hit = null;
|
||||
if (f) {
|
||||
const rp = path.resolve(f);
|
||||
for (const s of slots.values()) if (s.file === rp) { hit = s; break; }
|
||||
}
|
||||
if (hit && hit.ready) {
|
||||
hit.lastUsed = Date.now();
|
||||
notifySwitch(hit);
|
||||
try { const st = fs.statSync(hit.file); hit.mtimeMs = st.mtimeMs; hit.size = st.size; } catch (_) {}
|
||||
res.writeHead(200, { 'content-type': 'application/json' }).end('{"touched":true}');
|
||||
} else {
|
||||
res.writeHead(200, { 'content-type': 'application/json' }).end('{"touched":false}');
|
||||
}
|
||||
});
|
||||
req.on('error', () => {});
|
||||
}
|
||||
|
||||
// ---------- 路由 ----------
|
||||
const server = http.createServer((req, res) => {
|
||||
route(req, res).catch((e) => {
|
||||
log('请求失败 ' + req.url + ':' + ((e && e.message) || e));
|
||||
if (!res.headersSent) res.writeHead(500, { 'content-type': 'text/plain; charset=utf-8' }).end('预览网关内部错误');
|
||||
});
|
||||
});
|
||||
|
||||
async function route(req, res) {
|
||||
if (req.method === 'POST' && req.url.split('?')[0] === '/__pv-touch') return handleTouch(req, res);
|
||||
|
||||
let u;
|
||||
try { u = decodeURIComponent((req.url || '/').split('?')[0]); } catch (_) { res.writeHead(400).end('bad path'); return; }
|
||||
|
||||
if (req.method === 'GET' && u === '/gateway-healthz') {
|
||||
const body = JSON.stringify({ ok: true, prefix: PREFIX, slots: slots.size, bin: resolveBin() });
|
||||
res.writeHead(200, { 'content-type': 'application/json' }).end(body);
|
||||
return;
|
||||
}
|
||||
|
||||
if (u === PREFIX + '/' || u.startsWith(PREFIX + '/')) {
|
||||
const rel = u.slice(PREFIX.length) || '/';
|
||||
const rr = rel.replace(/\/+$/, ''); // 去掉尾斜杠后的页面路径
|
||||
const segs = rel.split('/').filter(Boolean);
|
||||
const sid = segs.shift() || '';
|
||||
const wantSlash = !/\/$/.test(u); // 缺尾斜杠:相对资源会解析错,要补 301
|
||||
|
||||
// HEAD = 前端预览窗的「这份文档能不能预览」探针。存在性只在本地按文件系统回答,绝不上探 watch;
|
||||
// 但回 200 前要等槽位就绪(有上限):冷启动的首次渲染很贵,这里等掉,iframe 一挂上就是渲染好的页面。
|
||||
if (req.method === 'HEAD') {
|
||||
const t = await guard(sid, segs.join('/'));
|
||||
if (t) {
|
||||
if (!resolveBin()) {
|
||||
res.writeHead(200, { 'content-type': 'text/plain; charset=utf-8', 'cache-control': 'no-store', 'content-length': '0' }).end();
|
||||
return;
|
||||
}
|
||||
await warmSlot(rel, t);
|
||||
res.writeHead(200, { 'content-type': 'text/plain; charset=utf-8', 'cache-control': 'no-store', 'content-length': '0' }).end();
|
||||
return;
|
||||
}
|
||||
if (EXTS.has(path.extname(rr).toLowerCase())) return notFound(res);
|
||||
}
|
||||
|
||||
if (isNav(req)) {
|
||||
// 导航请求 = 用户正盯着这一刻:绝不为启动/自愈阻塞首字节。未就绪 → 中转页 + 后台热槽。
|
||||
const t = await guard(sid, segs.join('/'));
|
||||
if (!t) return notFound(res);
|
||||
if (!resolveBin()) return installPage(res);
|
||||
const m = matchPage(rr);
|
||||
if (!m || !m.entry.ready) {
|
||||
startWatch(t).catch(() => {});
|
||||
return loading(res);
|
||||
}
|
||||
if (fileChanged(m.entry)) {
|
||||
stopEntry(m.entry, '外部变更');
|
||||
startWatch(t).catch(() => {});
|
||||
return loading(res);
|
||||
}
|
||||
if (m.exact && wantSlash) { res.writeHead(301, { location: (req.url || u) + '/' }).end(); return; }
|
||||
const cut = PREFIX.length + m.entry.pageDec.length;
|
||||
try {
|
||||
await tryForward(m.entry, req, res, u.length > cut ? u.slice(cut) : '/', NAV_TIMEOUT_MS);
|
||||
m.entry.navTimeouts = 0;
|
||||
return;
|
||||
} catch (e) {
|
||||
const msg = String((e && e.message) || e);
|
||||
// 超时 ≠ 死:大文档首次渲染可能超过 5s。单次超时保留槽位,连续几次才判死重启。
|
||||
m.entry.navTimeouts = /超时/.test(msg) ? (m.entry.navTimeouts || 0) + 1 : NAV_TIMEOUT_RETRIES;
|
||||
if (m.entry.navTimeouts >= NAV_TIMEOUT_RETRIES) {
|
||||
stopEntry(m.entry, msg);
|
||||
startWatch(t).catch(() => {});
|
||||
}
|
||||
if (!res.headersSent) return loading(res);
|
||||
return;
|
||||
}
|
||||
}
|
||||
|
||||
// 非导航(页面资源/API/SSE):等就绪槽位后自愈转发——用户看不见这些请求,值得原地救活
|
||||
const m = await waitReady(rel);
|
||||
if (m && m.entry) {
|
||||
if (m.exact && wantSlash) { res.writeHead(301, { location: (req.url || u) + '/' }).end(); return; }
|
||||
const cut = PREFIX.length + m.entry.pageDec.length;
|
||||
if (await forwardHealed(m.entry, req, res, u.length > cut ? u.slice(cut) : '/')) return;
|
||||
return fail502(res);
|
||||
}
|
||||
}
|
||||
|
||||
// vendor 页面把交互 API 与「自身最新 HTML」硬编码成根绝对路径(/、/events、/api/*):
|
||||
// 按 Referer 找回来源页,原路径原样转发(不剥页面前缀)。`/` 尤其关键——回 404 页面会
|
||||
// 判定自身过期并 location.reload(),用户看到的就是白屏后重新加载。
|
||||
const rrel = refererRel(req);
|
||||
if (rrel) {
|
||||
const mv = await waitReady(rrel);
|
||||
if (mv && mv.entry) {
|
||||
if (await forwardHealed(mv.entry, req, res, u)) return;
|
||||
return fail502(res);
|
||||
}
|
||||
}
|
||||
notFound(res);
|
||||
}
|
||||
|
||||
// 闲置回收:watch 是常驻进程,不回收会一直占着内存与端口(与服务器一致 6h)。
|
||||
const idleTimer = setInterval(() => {
|
||||
const now = Date.now();
|
||||
for (const s of [...slots.values()]) {
|
||||
if (!s.conns && now - s.lastUsed > IDLE_MS) stopEntry(s, '闲置回收');
|
||||
}
|
||||
for (const [k, v] of cooldown) if (v <= now) cooldown.delete(k);
|
||||
}, 60000);
|
||||
idleTimer.unref();
|
||||
|
||||
// 带外写盘兜底 + 页内编辑(POST /api/send 实测只落盘不推事件)的唯一刷新通道:
|
||||
// 开着页面时比对 mtime,变了就对活槽位 POST /api/switch 就地重读。
|
||||
const pollTimer = setInterval(() => {
|
||||
const now = Date.now();
|
||||
for (const s of [...slots.values()]) {
|
||||
let st = null;
|
||||
try { st = fs.statSync(s.file); } catch (_) {}
|
||||
if (!st) { stopEntry(s, '文件已删除'); continue; } // 会话被删/文件被移走
|
||||
if (!s.conns) continue; // 没人开着页面:导航侧的指纹门会兜住
|
||||
if (!s.ready || st.mtimeMs === s.mtimeMs) continue;
|
||||
if (now - (s.lastNative || 0) < 10000) { s.mtimeMs = st.mtimeMs; s.size = st.size; continue; }
|
||||
s.mtimeMs = st.mtimeMs;
|
||||
s.size = st.size;
|
||||
notifySwitch(s);
|
||||
}
|
||||
}, 2000);
|
||||
pollTimer.unref();
|
||||
|
||||
function shutdown() {
|
||||
for (const s of [...slots.values()]) stopEntry(s);
|
||||
process.exit(0);
|
||||
}
|
||||
process.on('SIGTERM', shutdown);
|
||||
process.on('SIGINT', shutdown);
|
||||
// 退出/崩溃时别把 spawn 出去的 watch 养成孤儿
|
||||
process.on('exit', () => { for (const s of [...slots.values()]) killWatch(s); });
|
||||
process.on('unhandledRejection', (e) => log('未处理的 Promise 拒绝:' + ((e && e.message) || e)));
|
||||
|
||||
server.listen(PORT, HOST, () => {
|
||||
log('预览网关 listening ' + HOST + ':' + PORT + ' prefix=' + PREFIX + '/' +
|
||||
' tasks=' + TASKS_ROOT + ' skills=' + SKILLS_ROOT + ' slots=' + SLOTS);
|
||||
});
|
||||
Executable
+1166
File diff suppressed because it is too large
Load Diff
Executable
+116
@@ -0,0 +1,116 @@
|
||||
#!/bin/sh
|
||||
# local/stop.sh —— 停掉本机 local 模式拉起来的 agent-core 与 MCP 子进程。
|
||||
#
|
||||
# 正常停法就是 ./local/stop.sh:启动器默认是后台跑的(start.sh 拉起后就返回)。
|
||||
# 前台模式(AGENT_LOCAL_DETACH=0)下 Ctrl-C / 关窗口也能停。
|
||||
# 但终端可能被关掉、进程可能是从别处起的——那时就只能按 pid / 端口找。
|
||||
#
|
||||
# 关键点:启动器是父进程(启动器 → core + 3/4 个 MCP),只杀 core 会被它重新拉起来
|
||||
# (那是「重启」的语义)。所以必须先停启动器,停不掉再按端口硬收。
|
||||
# 幂等:没在运行时直说,不报错。
|
||||
set -u
|
||||
|
||||
HERE=$(CDPATH= cd -- "$(dirname -- "$0")" && pwd)
|
||||
RUNTIME="$HERE/.runtime"
|
||||
PIDFILE="$RUNTIME/supervisor.pid"
|
||||
|
||||
PORT="${PORT:-8090}"
|
||||
# 与 start.sh 的默认值一致;用 MCP_*_PORT 改过端口时这里也要跟着改(否则兜底那步找不到它们)。
|
||||
MCP_PORTS="${MCP_WEB_PORT:-8091} ${MCP_IMAGE_PORT:-8092} ${MCP_VIDEO_PORT:-8093} ${MCP_ASR_PORT:-8094}"
|
||||
# 预览网关端口是启动时从 3100 往后找的第一个空闲口,只能读它写下的记录。
|
||||
pv_port=$(cat "$RUNTIME/preview.port" 2>/dev/null || printf '')
|
||||
case "$pv_port" in ''|*[!0-9]*) pv_port='3100';; esac
|
||||
|
||||
stopped=0
|
||||
|
||||
say() { printf '==> %s\n' "$*"; }
|
||||
|
||||
# 某个端口上处于 LISTEN 的进程 pid(没有 lsof 就返回空)。
|
||||
pids_on_port() {
|
||||
command -v lsof >/dev/null 2>&1 || return 0
|
||||
lsof -nP -tiTCP:"$1" -sTCP:LISTEN 2>/dev/null
|
||||
}
|
||||
|
||||
stop_pid() {
|
||||
# $1 pid $2 说明
|
||||
kill -TERM "$1" 2>/dev/null || return 0
|
||||
say "停止$2(pid $1)"
|
||||
stopped=1
|
||||
}
|
||||
|
||||
wait_gone() {
|
||||
# $1 pid,最多等 10 秒
|
||||
i=0
|
||||
while [ "$i" -lt 20 ]; do
|
||||
kill -0 "$1" 2>/dev/null || return 0
|
||||
sleep 0.5 2>/dev/null || sleep 1
|
||||
i=$((i + 1))
|
||||
done
|
||||
}
|
||||
|
||||
# 1) 首选:启动器自己写的 pid 文件(最准,也最快)。
|
||||
if [ -f "$PIDFILE" ]; then
|
||||
pid=$(cat "$PIDFILE" 2>/dev/null || printf '')
|
||||
case "$pid" in ''|*[!0-9]*) pid='';; esac
|
||||
if [ -n "$pid" ] && kill -0 "$pid" 2>/dev/null; then
|
||||
stop_pid "$pid" '启动器'
|
||||
wait_gone "$pid"
|
||||
if kill -0 "$pid" 2>/dev/null; then
|
||||
say '启动器 10 秒内没退出,强制结束'
|
||||
kill -KILL "$pid" 2>/dev/null || true
|
||||
fi
|
||||
sleep 1
|
||||
fi
|
||||
rm -f "$PIDFILE"
|
||||
fi
|
||||
|
||||
# 2) pid 文件丢了(终端被强杀、目录被清过):从 core 的父进程认出启动器。
|
||||
# 按「谁是 8090 的父进程」找,而不是按启动命令的路径拼写去 pgrep——
|
||||
# 同机可能有别的 clone,靠路径匹配容易误杀或不匹配(实测 `sh ./local/start.sh` 是相对路径)。
|
||||
if [ "$stopped" = 0 ]; then
|
||||
for pid in $(pids_on_port "$PORT"); do
|
||||
ppid=$(ps -o ppid= -p "$pid" 2>/dev/null | tr -d ' ')
|
||||
case "$ppid" in ''|0|1|*[!0-9]*) continue;; esac
|
||||
if ps -o command= -p "$ppid" 2>/dev/null | grep -q 'start\.sh'; then
|
||||
stop_pid "$ppid" '启动器(按 core 的父进程识别)'
|
||||
wait_gone "$ppid"
|
||||
if kill -0 "$ppid" 2>/dev/null; then
|
||||
say '启动器 10 秒内没退出,强制结束'
|
||||
kill -KILL "$ppid" 2>/dev/null || true
|
||||
fi
|
||||
fi
|
||||
done
|
||||
[ "$stopped" = 1 ] && sleep 2
|
||||
fi
|
||||
|
||||
# 3) 兜底:还占着端口的直接收(启动器已经死了,剩下的都是孤儿)。
|
||||
for p in "$PORT" $MCP_PORTS "$pv_port"; do
|
||||
for pid in $(pids_on_port "$p"); do
|
||||
stop_pid "$pid" "端口 $p 上的进程"
|
||||
done
|
||||
done
|
||||
[ "$stopped" = 1 ] && sleep 2
|
||||
|
||||
# 4) 收尾:仍占着端口的强制结束,避免下次启动被判「端口被占用」。
|
||||
for p in "$PORT" $MCP_PORTS "$pv_port"; do
|
||||
for pid in $(pids_on_port "$p"); do
|
||||
kill -KILL "$pid" 2>/dev/null || true
|
||||
done
|
||||
done
|
||||
|
||||
# 5) 隧道 client:它不监听端口,正常随启动器的 do_cleanup 一起收掉;
|
||||
# 启动器被 kill -9 时 EXIT trap 不跑,会漏成孤儿,按它自己写的 pid 文件兜底。
|
||||
if [ -f "$RUNTIME/tunnel.pid" ]; then
|
||||
tpid=$(cat "$RUNTIME/tunnel.pid" 2>/dev/null || printf '')
|
||||
case "$tpid" in ''|*[!0-9]*) tpid='';; esac
|
||||
if [ -n "$tpid" ] && kill -0 "$tpid" 2>/dev/null; then
|
||||
stop_pid "$tpid" '隧道 client'
|
||||
fi
|
||||
rm -f "$RUNTIME/tunnel.pid"
|
||||
fi
|
||||
|
||||
if [ "$stopped" = 1 ]; then
|
||||
say '已停止'
|
||||
else
|
||||
say "没有在运行(${PORT}、MCP 端口 ${MCP_PORTS}、预览端口 $pv_port 都空闲)"
|
||||
fi
|
||||
+21
-10
@@ -4,9 +4,9 @@
|
||||
|
||||
| 目录 | 容器名 | 作用 | 容器内端口 | MCP 端点 |
|
||||
|---|---|---|---|---|
|
||||
| `web_search/` | `mcp_web_search` | 免费网页搜索(Parallel / Exa,无需 key) | `3000` | `POST /` |
|
||||
| `web_search/` | `mcp_web_search` | 网页搜索(默认免费 Parallel / Exa,可换成自建 `/search` 上游) | `3000` | `POST /` |
|
||||
| `image_task/` | `mcp_image_task` | 图片生成 / 编辑(文生图走 `/images/generations`,图生图走 `/images/edits`,单工具 op=create/get) | `3000` | `POST /mcp` |
|
||||
| `video_task/` | `mcp_video_task` | 智谱 CogVideo 视频生成(异步,单工具 op=create/get) | `3000` | `POST /mcp` |
|
||||
| `video_task/` | `mcp_video_task` | 视频生成(任意 OpenAI 兼容 `/videos` 上游,异步,单工具 op=create/get) | `3000` | `POST /mcp` |
|
||||
| `asr/` | `mcp_asr` | 语音转文字(上游 OpenAI 兼容 `/audio/transcriptions`),**额外带一个给输入框用的 `POST /transcribe`** | `3000` | `POST /mcp` |
|
||||
|
||||
**这些服务一个宿主机端口都不占**——它们只挂在 `agent-mcp-net` 上,由 `agent-core` / `agent-executor`
|
||||
@@ -27,6 +27,10 @@ docker compose up -d --build
|
||||
mcp_servers:
|
||||
- name: web_search
|
||||
url: "http://mcp_web_search:3000/"
|
||||
# 可选:换成自己的搜索接口(不配 = 内置免费后端 Parallel / Exa)
|
||||
# headers:
|
||||
# Authorization: Bearer <key>
|
||||
# X-Web-Search-Base-Url: "https://<host>/v1"
|
||||
- name: image_task
|
||||
url: "http://mcp_image_task:3000/mcp"
|
||||
- name: video_task
|
||||
@@ -46,11 +50,18 @@ mcp_servers:
|
||||
> 从旧的「agent + mcp 双仓库」部署升级:先在旧 mcp 仓库目录 `docker compose down`(只需一次,否则同名容器与网络会冲突),再 `up` 本栈。
|
||||
|
||||
`image_task` / `video_task` 的 token **不由服务端保存**——每个请求从 `Authorization` header 读取
|
||||
(agent 侧配在 `config.yml` 的 `mcp_servers[].headers`)。`video_task` 用智谱 token;
|
||||
(agent 侧配在 `config.yml` 的 `mcp_servers[].headers`)。`video_task` 走任意 OpenAI 兼容的 videos 上游:
|
||||
提交 `/videos/generations`、查询 `/videos/{task_id}`,地址与模型由 `X-Video-Task-Base-Url` /
|
||||
`X-Video-Task-Model` 指定(两者都必填);
|
||||
`image_task` 走任意 OpenAI 兼容的 images 上游:文生图 `/images/generations`、图生图 `/images/edits`,
|
||||
上游地址与模型分别由 `X-Image-Task-Base-Url` / `X-Image-Task-Model` 指定(两者都必填)。
|
||||
所以这两个服务不用配任何密钥。
|
||||
|
||||
`web_search` 同理:默认走内置免费后端(Parallel → Exa,无需 key);想换成自己的搜索接口,
|
||||
就在这段 headers 里写 `X-Web-Search-Base-Url`(容器拼 `/search`)与可选的 `Authorization`。
|
||||
一旦配了地址就以它为准——**失败直接报错,不会静默退回免费后端**(否则 key 过期 / 地址写错
|
||||
只会表现为「结果质量突然变差」)。
|
||||
|
||||
`asr` 同理:上游的 key / base_url / model 全部由调用方随请求 header 带入
|
||||
(`Authorization` / `X-ASR-Base-Url` / `X-ASR-Model`,agent 侧配在 `config.yml` 的
|
||||
`mcp_servers[name=asr].headers`)。输入框那条路(`agent-core` → `POST /transcribe`)不经过 MCP 调用,
|
||||
@@ -62,30 +73,30 @@ mcp_servers:
|
||||
本栈默认不给 MCP 服务映射宿主机端口(它们只在 `agent-mcp-net` 内网可达)。要从宿主机直连,
|
||||
自行在 `docker-compose.yml` 给对应服务加 `ports` 即可。
|
||||
|
||||
## 图片是怎么到智谱手上的(只有 video_task 关心)
|
||||
## 图片是怎么到上游的(只有 video_task 关心)
|
||||
|
||||
智谱服务器生成视频前要**自己来拉参考图**,它不带 cookie、不带 `Authorization`。这套链路里**没有任何人上传文件**:
|
||||
上游生成视频前要**自己来拉参考图**,它不带 cookie、不带 `Authorization`。这套链路里**没有任何人上传文件**:
|
||||
|
||||
```
|
||||
AI ──调用 agent 内置的「公开临时 URL」工具(直接传文件路径)──► 拿到一条短命公网 URL
|
||||
│
|
||||
▼
|
||||
AI 把拿到的 URL 当 image_url 交给 video_task:3000/mcp
|
||||
AI 把拿到的 URL 当 image_url 交给 video_task:3000/mcp(转发为上游的 image 字段)
|
||||
│
|
||||
▼
|
||||
智谱 ──匿名 GET──► agent 侧提供的公开临时 URL
|
||||
那个文件始终躺在 agent 的任务目录里,零拷贝
|
||||
上游 ──匿名 GET──► agent 侧提供的公开临时 URL
|
||||
那个文件始终躺在 agent 的任务目录里,零拷贝
|
||||
```
|
||||
|
||||
- 签发与托管全在 agent 侧(它已集成为一个 tool,AI 直接调用即可,不需要 curl 任何内网入口)。
|
||||
- 链接短命:到期或 agent 重启后失效;智谱只在提交任务那一刻拉一次图,完全够用。
|
||||
- 链接短命:到期或 agent 重启后失效;上游只在提交任务那一刻拉一次图,完全够用。
|
||||
- mcp 这三家一个端口都不露,唯一公网可达的东西只有 agent 自己。
|
||||
|
||||
## 端口与安全
|
||||
|
||||
| 服务 | 公网暴露 | 说明 |
|
||||
|---|---|---|
|
||||
| `mcp_web_search` | 无 | 服务端无鉴权,**永远不要映射出去**(会被白嫖搜索额度);agent 走内网访问 |
|
||||
| `mcp_web_search` | 无 | 服务端无鉴权,**永远不要映射出去**(会被白嫖搜索额度;配了自定义上游时还会把你的 key 白送出去);agent 走内网访问 |
|
||||
| `mcp_image_task` | 无 | token 由调用方自带,暴露后可被拿去消耗你的上游图片额度 |
|
||||
| `mcp_video_task` | 无 | 它需要的公开临时 URL 由 agent 侧集成的工具提供,自己不占端口 |
|
||||
| `mcp_asr` | 无 | `/mcp` 与 `/transcribe` 都无鉴权,只能由 core 经内网调用;它不存密钥(上游参数随请求带入) |
|
||||
|
||||
@@ -172,7 +172,7 @@ response_format=url
|
||||
url: "http://mcp_image_task:3000/mcp"
|
||||
headers:
|
||||
Authorization: "Bearer <网关 KEY>"
|
||||
X-Image-Task-Base-Url: "https://wb.ai.foresh.com/v1"
|
||||
X-Image-Task-Base-Url: "https://your-gateway.example.com/v1"
|
||||
X-Image-Task-Model: "global:gpt-image-2.5-sunburst"
|
||||
mode: skill
|
||||
```
|
||||
@@ -258,7 +258,7 @@ curl -s -X POST http://localhost:8082/mcp \
|
||||
-H "Content-Type: application/json" \
|
||||
-H "Accept: application/json, text/event-stream" \
|
||||
-H "Authorization: Bearer $TOKEN" \
|
||||
-H "X-Image-Task-Base-Url: https://wb.ai.foresh.com/v1" \
|
||||
-H "X-Image-Task-Base-Url: https://your-gateway.example.com/v1" \
|
||||
-H "X-Image-Task-Model: global:gpt-image-2.5-sunburst" \
|
||||
-H "Mcp-Session-Id: $SESSION" \
|
||||
-d '{
|
||||
|
||||
Some files were not shown because too many files have changed in this diff Show More
Reference in New Issue
Block a user