Compare commits
190
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 | ||
|
|
7a34f612e7 | ||
|
|
2e220d0a22 | ||
|
|
0ac161c579 | ||
|
|
81e0a44671 | ||
|
|
560bd9afd4 | ||
|
|
ce7a62dcba | ||
|
|
d0e6a981a6 | ||
|
|
1ea29c0448 | ||
|
|
d6b949969f | ||
|
|
bdc2de7128 | ||
|
|
b97b13095f | ||
|
|
dca4e6be70 | ||
|
|
58b9eaddd4 | ||
|
|
b2b0f8d2b2 | ||
|
|
f97eb566e3 | ||
|
|
153a8768bf | ||
|
|
ceccb3645f | ||
|
|
55efb1c410 | ||
|
|
53fa5da82b | ||
|
|
5b70f7d614 | ||
|
|
dfcbe6d3ea | ||
|
|
516b4a5d86 | ||
|
|
e39273e97f | ||
|
|
8b8fbddb4f | ||
|
|
ba9534f064 | ||
|
|
43e77e569e | ||
|
|
ab67400174 | ||
|
|
13b493eada | ||
|
|
7fc945a4c8 | ||
|
|
fbe78d362f | ||
|
|
fe1c6d106f | ||
|
|
a86b748a6f | ||
|
|
d3128ba21c | ||
|
|
19564fb65b | ||
|
|
deb622095f |
@@ -1,25 +0,0 @@
|
||||
# .env.example — 仓库根 .env 模板(.env 已 gitignore,不会被提交)。
|
||||
# 标准路径是跑 ./scripts/init.sh:自动生成下面全部密钥并幂等复用(重跑不掉登录态、不换 token)。
|
||||
# 本文件仅作手动部署参考;手动生成 token:openssl rand -hex 32。
|
||||
# 其余部署旋钮(EXECUTOR_URL、*_LOG_LEVEL、VIRTUAL_HOST 等)都在 docker-compose.yml 里改,不放这里。
|
||||
|
||||
# ---- 必填(compose 用 ${VAR:?} 检查,缺失则 docker compose up 直接报错)----
|
||||
|
||||
# core ↔ executor 调用鉴权(compose 注入两侧同值)
|
||||
EXECUTOR_TOKEN=change-me-openssl-rand-hex-32
|
||||
|
||||
# core ↔ wxbot 微信接入服务 token(compose 注入两侧同值;未就位 = 微信入口整体静默关闭)
|
||||
WXBOT_TOKEN=change-me-openssl-rand-hex-32
|
||||
|
||||
# 登录态签名密钥:init.sh 写进 config.yml 的 auth.secret 并在此复用;
|
||||
AUTH_SECRET=change-me-openssl-rand-hex-32
|
||||
|
||||
# ---- 可选 ----
|
||||
|
||||
# agent-core 映射到宿主机的端口(默认 8090),改这里就不用动 docker-compose.yml
|
||||
# AGENT_PORT=8090
|
||||
|
||||
# ---- 仅调试:临时把对应 MCP 服务映射到宿主机端口(默认注释掉;改完记得注释回去)----
|
||||
# WEB_SEARCH_PORT=8081
|
||||
# IMAGE_TASK_PORT=8082
|
||||
# VIDEO_TASK_PORT=8083
|
||||
@@ -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,10 +24,13 @@
|
||||
| `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` | 三个容器,仅内网 |
|
||||
| `mcp/` | 同栈 MCP 服务:`web_search` / `image_task` / `video_task` / `asr` | 四个容器,仅内网 |
|
||||
| `skills/` | 目录式技能(`SKILL.md` + `run.py`/`run.sh`) | 运行时挂载,`skills/deps` 为依赖层 |
|
||||
| `scripts/` | `init.sh` 生成 `.env` + `config.yml`;`init_host.sh` 裸机初始化 | 幂等 |
|
||||
| `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 |
|
||||
| `data/` | **运行时数据**:SQLite `.agent.db`、`prompt.txt` 调试产物 | 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(3000,仅内网)"]
|
||||
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,15 +62,18 @@ 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 | 仅内网;compose 里注释掉的 `ports` 仅供本机调试 |
|
||||
| `mcp_*` | 3000 | 仅内网 |
|
||||
|
||||
### 数据持久化(bind mount)
|
||||
|
||||
@@ -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,10 +97,12 @@ flowchart TD
|
||||
### 环境变量(接线全靠根 `.env` + compose)
|
||||
|
||||
`AGENT_CONFIG`、`PORT`、`EXECUTOR_URL`、`EXECUTOR_TOKEN`、`WXBOT_URL`、`WXBOT_TOKEN`、
|
||||
`VIRTUAL_HOST`、`PREVIEW_PROXIES`、`EXECUTOR_LOG_LEVEL`、`WXBOT_LOG_LEVEL`。
|
||||
密钥生成:`./scripts/init.sh`(幂等,重跑不掉登录态)。
|
||||
`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` 走
|
||||
@@ -94,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` 通知。
|
||||
|
||||
## 数据与状态
|
||||
@@ -109,7 +128,7 @@ flowchart TD
|
||||
|
||||
## 全局约束(改之前先读)
|
||||
|
||||
1. **单实例、单进程内存态**。`engine.js` 的 `runs`/`titling`、`wechat.js` 的回合投递状态与实例缓存、
|
||||
1. **单实例、单进程内存态**。`engine.js` 的 `runs`/`titling`/`pendings`(待投递消息队列)、`wechat.js` 的回合投递状态与实例缓存、
|
||||
`publicFiles` 的短链表、`download-token` 的随机密钥都在进程内——重启即清空,多实例不共享。
|
||||
(微信投递游标 `last_msg_id` 例外,它是落库的。)不要引入需要跨进程一致性的设计。
|
||||
2. **配置冷加载**。`config.js` 的 `DEFAULTS` 在启动时 deep-merge 并校验;改 `config.yml` 后必须
|
||||
@@ -124,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` 扩展就不要新开工具。
|
||||
|
||||
## 开发与验证
|
||||
@@ -160,9 +181,11 @@ 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` 的部署与安全章节 |
|
||||
| 新增环境变量 | `.env.example` ↔ compose ↔ README「环境变量」 |
|
||||
| 隧道 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` 的解析 |
|
||||
| 同栈 MCP 的 url / header 名 | `app/server/presets.json` ↔ `mcp/<服务>/src`(设置页引导表单的字段来自前者,不会自动跟随后者) |
|
||||
| 对外 API | `app/server/routes/*` ↔ 前端 `app/server/public/js/*` ↔ README |
|
||||
|
||||
## 代码约定
|
||||
@@ -176,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">`,
|
||||
漏了不报错、界面只是空白。
|
||||
|
||||
## 常见任务去哪改
|
||||
|
||||
@@ -187,6 +214,10 @@ curl -s http://127.0.0.1:8090/api/health
|
||||
| 改模型调度 / 绑定 | `app/server/engine.js` 的 `chooseKey` / `chooseModel` / `ensureBinding` |
|
||||
| 改上下文组装 / 省 token | `app/server/llm.js` 的 `buildMessages` / `trim*` |
|
||||
| 改微信投递 | `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,441 +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 任务;触发前清空模型可见历史,按计划执行并推送结果 |
|
||||
| 微信接入 | 扫码绑定个人微信,文本/图片/视频/文件进入同一套会话与命令体系 |
|
||||
| 长期记忆 | 会话收口时生成第一人称工作日记;微信新会话注入最近几条,`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
|
||||
BIGMODEL_KEY=xxx \
|
||||
DEEPSEEK_KEY=yyy \
|
||||
QWEN_KEY=zzz \
|
||||
AUTH_USER=admin \
|
||||
AUTH_PASSWORD='换一个强密码' \
|
||||
PUBLIC_IP=1.2.3.4 \
|
||||
./scripts/init.sh
|
||||
docker compose up -d --build
|
||||
```
|
||||
|
||||
三个模型 Key 都可选,填几个启用几个。`PUBLIC_IP` 也可选:**不配置时会自动探测公网 IP**(探测失败则 `public_link` 为空,外部服务取图功能不可用)。
|
||||
打开 `http://<服务器 IP>:8090`,用 `admin` / `admin` 登录,先改密码,再到「设置 → 模型」添加平台和 API Key,保存后点「重启服务」。
|
||||
|
||||
脚本会生成:
|
||||
### 本机运行
|
||||
|
||||
- `.env`:`EXECUTOR_TOKEN`、`WXBOT_TOKEN`、`AGENT_PORT` 等部署变量。
|
||||
- `config.yml`:模型平台、登录账号、MCP 服务、公网前缀。
|
||||
|
||||
`image_task` / `video_task` 两个 MCP 服务复用 `BIGMODEL_KEY`(智谱与 BigModel 是同一个 key);未配置 `BIGMODEL_KEY` 时它们以 `mode: disable` 写入配置。
|
||||
|
||||
`AUTH_USER` / `AUTH_PASSWORD` 不传时默认是 `admin` / `admin`,首次部署务必改掉。
|
||||
|
||||
`.env` 里的密钥会复用,重新执行不会让登录态失效;旧的 `config.yml` 会先备份为 `config.yml.bak.<时间戳>`。
|
||||
|
||||
注意:`config.yml` 每次都会按本次环境变量重新生成,平台 Key 不保存在 `.env` 里。已经部署过的实例请用设置页改配置,或带上原有变量重跑;只想刷新密钥时用 `./scripts/init.sh --env-only`。
|
||||
|
||||
### 2. 启动
|
||||
macOS / Linux,Node 20+,不需要 Docker:
|
||||
|
||||
```bash
|
||||
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>
|
||||
```
|
||||
|
||||
使用 `init.sh` 里的账号登录。默认端口 `8090`,可用 `.env` 的 `AGENT_PORT` 修改。
|
||||
|
||||
对外只需要放行这一个端口。`agent-executor`、`wxbot` 和 MCP 服务都只在 Docker 内网,不映射到宿主机。
|
||||
|
||||
### 4. 同栈 MCP 服务
|
||||
|
||||
`init.sh` 默认把仓库内 `mcp/` 的三个服务写进 `config.yml`:
|
||||
|
||||
```yaml
|
||||
mcp_servers:
|
||||
- name: web_search
|
||||
url: "http://mcp_web_search:3000/"
|
||||
- name: image_task
|
||||
url: "http://mcp_image_task:3000/mcp"
|
||||
- name: video_task
|
||||
url: "http://mcp_video_task:3000/mcp"
|
||||
```
|
||||
|
||||
`web_search` / `image_task` / `video_task` 与 core 由同一个根 `docker-compose.yml` 启动,没有先后顺序,也不占宿主机端口。工具说明、header 覆盖项与调试方式见 [mcp/README.md](mcp/README.md)。
|
||||
|
||||
接入栈外的 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` 可直接看状态。
|
||||
|
||||
---
|
||||
|
||||
## 使用
|
||||
|
||||
### 会话与模型
|
||||
|
||||
- 新建会话时自动绑定一个模型;不选则按平台轮转选择。
|
||||
- 会话创建后模型绑定保持,重启、追问都不会丢。
|
||||
- 模型被删除或禁用后,下一条消息会自动改选原平台的可用模型。
|
||||
- 管理员可在「设置 → 用户」给某个用户锁定默认模型。
|
||||
- 顶部「切换模型」只在该会话空闲时可用;正在输出时会拒绝换绑。
|
||||
|
||||
会话状态:
|
||||
|
||||
| 状态 | 含义 |
|
||||
| 目录 | 说明 |
|
||||
|---|---|
|
||||
| 保持中 | 回合已结束,可以直接继续追问 |
|
||||
| 活跃中 | 正在执行模型回合 |
|
||||
| 已完成 | 已手动断开或空闲超时收口,仍可继续发消息 |
|
||||
| 已终止 | 用户主动停止 |
|
||||
| [`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) | 设备执行端:任意机器装上就连回来,模型可在上面跑命令、传文件 |
|
||||
|
||||
### 文件
|
||||
## 远端设备
|
||||
|
||||
- 输入框附件、微信附件都落在 `tasks/<会话 id>/`。
|
||||
- 右侧「任务文件」面板支持上传、下载、批量打包、删除、子目录浏览。
|
||||
- 模型生成的文件与用户上传的文件在同一目录,AI 可直接继续处理。
|
||||
- 超过 50 MB 的单文件上传会被拒绝;移动端大图上传前会在浏览器端压缩。
|
||||
把任意一台机器(Mac / Linux / Windows / OpenWrt 盒子)接进来,让模型在它上面执行命令、读写文件:
|
||||
|
||||
### 上下文压缩
|
||||
1. 编译或下载 `device/` 的二进制,和 `config.json` 放在同一个目录:
|
||||
|
||||
- 顶部「压缩」可手动触发:模型基于完整历史生成摘要,摘要之前的消息标记为已存档,UI 仍可见,但不再发给模型。
|
||||
- 当单回合输入 token 超过 `agent.auto_compress_tokens` 时,前端会弹一次确认框,询问是否压缩。
|
||||
- 历史重放还会自动把较旧的 `write_file` 参数正文、`fetch` / `read_file` 回执替换为单行占位,数据库与 UI 不受影响。
|
||||
```json
|
||||
{ "server": "wss://你的域名/dev/ws", "token": "<DEVICE_TOKEN>", "root": "/Users/you", "name": "mac-01" }
|
||||
```
|
||||
|
||||
### 定时任务
|
||||
2. 直接运行(默认读同目录的 `config.json`,token 不会出现在 `ps` 里):
|
||||
|
||||
对 AI 说「每天早上九点汇总……」,它会在当前会话创建 cron 任务:
|
||||
```bash
|
||||
./agent-device-darwin-amd64
|
||||
```
|
||||
|
||||
- 每会话最多一个任务,最小间隔 1 小时,时区固定 `Asia/Shanghai`。
|
||||
- 每次触发前,会话历史整体标记为已存档,模型只看到任务提示词,等价一次全新会话。
|
||||
- 执行结果留在会话里,同时可通过微信推送。
|
||||
- 创建任务后,当前会话会收口为该任务的「专柜」,用户下一条消息自动进入新会话。
|
||||
3. 服务器 `.env` 里配同一个 `DEVICE_TOKEN` 并重启 core。
|
||||
|
||||
### 微信
|
||||
|
||||
在「设置 → 账户 → 微信绑定」生成二维码,扫码后即可单线对话:
|
||||
|
||||
- 微信消息复用同一套会话和命令层,支持 `/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,两侧同值 |
|
||||
| `WXBOT_URL` | wxbot 地址;置空则微信功能整体关闭 |
|
||||
| `WXBOT_TOKEN` | core ↔ wxbot 的共享 token |
|
||||
| `VIRTUAL_HOST` | 设置后 `public_link.base_url` 强制取 `https://<第一个域名>` |
|
||||
| `PREVIEW_PROXIES` | 覆盖内置预览反代注册表(JSON 数组) |
|
||||
| `EXECUTOR_LOG_LEVEL` / `WXBOT_LOG_LEVEL` | 两个附属服务的日志等级 |
|
||||
| `WEB_SEARCH_PORT` / `IMAGE_TASK_PORT` / `VIDEO_TASK_PORT` | 仅调试:临时把对应 MCP 服务映射到宿主机端口(默认注释掉) |
|
||||
|
||||
`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;
|
||||
```
|
||||
|
||||
若设置了 `VIRTUAL_HOST`,公网链接前缀会自动变成 `https://<域名>`;仓库默认 compose 里带有 `VIRTUAL_HOST=agent.ai.foresh.com`,不接反向代理时应删除或改成自己的域名。
|
||||
|
||||
---
|
||||
|
||||
## 运维
|
||||
|
||||
### 数据位置
|
||||
|
||||
| 宿主机路径 | 容器内 | 内容 |
|
||||
|---|---|---|
|
||||
| `./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
|
||||
```
|
||||
## License
|
||||
|
||||
- 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` 本栈 |
|
||||
| `config.yml` 变成目录 | 启动前文件不存在,Docker 自动建了同名目录;停容器、删目录、放入配置文件 |
|
||||
| 没有可用模型 | `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)。
|
||||
|
||||
+83
-13
@@ -39,6 +39,7 @@ AGENT_CONFIG=./config.yml node server/server.js
|
||||
|---|---|
|
||||
| `server/server.js` | 装配、路由挂载、`/api/models`、`/api/health`、prompt dump、优雅退出 |
|
||||
| `server/config.js` | YAML 加载/校验/默认值;`platforms` 展开成 `cfg.models`;配置文本改写(设置页) |
|
||||
| `server/presets.json` | 平台与同栈 MCP 的固定契约(url / type / header 名),设置页新增时的模板来源;改服务地址改这里 |
|
||||
| `server/db.js` | 建表、索引、幂等迁移;纯 SQL 数据层,不放业务 |
|
||||
| `server/engine.js` | **核心**:会话状态机、模型池调度、Agent 主循环、压缩、标题、日记收口、消息增删 |
|
||||
| `server/llm.js` | 消息组装、system prompt 拼接、上游流式调用、占位裁剪、多模态块编解码 |
|
||||
@@ -50,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` |
|
||||
@@ -61,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 |
|
||||
|
||||
## 一次用户消息的生命周期
|
||||
|
||||
@@ -78,18 +79,56 @@ POST /api/sessions/:id/messages
|
||||
checkToolArgs:JSON 非法/缺必填 → 整条 assistant 标 type='errAck'
|
||||
saveMessage(assistant) + recordModelUsage
|
||||
压缩回合的收尾答复 → type='summary',之前全部消息 → type='archived'
|
||||
无 tool_calls → 若期间又有新 user 消息则继续,否则收尾
|
||||
无 tool_calls → 待投递里有「干预」则投递并继续;否则若有新 user 消息继续,否则收尾
|
||||
有 tool_calls → 逐个 executeTool → saveMessage(tool) → emit tool_result
|
||||
(每步之后与整批之前各查一次「干预」,命中就先闭合批次再投递)
|
||||
→ finalize
|
||||
closeToolBatch(兜底:补齐本批未执行调用的合成回执)
|
||||
cancelled → status=cancelled
|
||||
正常 → status=held,emit done,maybeGenerateTitle,run.taskWrap → taskClockOut
|
||||
收尾后若队列非空 → setImmediate 投递队首(排队模式的唯一出口)
|
||||
→ maybeAutoCompress(回合彻底结束后才检查)
|
||||
```
|
||||
|
||||
**给前端的是 SSE 事件,不是响应体**。前端在 `GET /api/sessions/:id/stream` 上听:
|
||||
`status`、`assistant_delta`、`reasoning_delta`、`tool_call_start`、`tool_call_args`、
|
||||
`tool_call`、`tool_result`、`assistant_message`、`done`、`error`、`title`、`auto_compress`、
|
||||
`ui_card`,以及每 15s 的具名心跳 `ping`(注释帧不触发 JS 事件,所以用具名事件做前端看门狗)。
|
||||
`ui_card`、`pending_added`、`pending_removed`、`user_message`,以及每 15s 的具名心跳 `ping`
|
||||
(注释帧不触发 JS 事件,所以用具名事件做前端看门狗)。
|
||||
|
||||
## 待投递消息(排队 / 干预 / 立即发送)
|
||||
|
||||
回合正在跑时,Web 端发送不再「立即插话」,而是进**服务端队列**(`engine.js` 的 `pendings`,
|
||||
进程内内存态,同 `runs`,重启即丢):输入框上方出现一行条幅,默认等本轮结束自动发出。
|
||||
|
||||
| 模式 | 入口 | 行为 |
|
||||
|---|---|---|
|
||||
| `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` 回执之间,或批次没闭合就收尾,
|
||||
上游一律拒收整个请求。
|
||||
|
||||
- `closeToolBatch(sessionId, reason)` 是配对兜底的唯一写入口:给最后一条带 `tool_calls` 的
|
||||
assistant 里缺回执的调用补一条 `is_error=1` 的合成 tool 行(「用户介入/终止,本次调用未执行」)。
|
||||
`finalize` 无条件调一次,取消路径与干预路径各调一次。广播的 `tool_result` 带 `skipped:true`,
|
||||
微信端据此显示「N 次因你介入未执行」。
|
||||
- **微信端不下发任何工具失败**(即使 `is_error=true`):多数是模型参数用错、下一轮自己会改,
|
||||
推给用户既看不懂也帮不上忙;要交代就由模型自己的回复说。失败仍完整保留在库里与网页端工具卡上。
|
||||
- 读侧还有一层纯过滤(`llm.buildMessages` 的 `pairedByAssistant` / `emittedCallIds`):只下发
|
||||
「本批(紧邻的连续 tool 行)确有回执」的调用,孤儿回执也不下发。DB/UI 不动,专门兜历史脏数据。
|
||||
- `stop()`(用户点「停止」)**会清空队列**(全停语义);「立即发送」不走 `stop`,只中断当前回合、保留队首。
|
||||
- 只允许升级**队首**(`promotePending` 对非队首回 409),避免「越过后面的消息先发」。
|
||||
- HTTP:`POST /messages` 的 `delivery:'queue'`;`POST /pending/:qid {action}`;`DELETE /pending/:qid`;
|
||||
会话详情响应带 `pending`,`status` 事件也带 `pending`(前端把条幅当服务端状态的回显)。
|
||||
|
||||
## 会话状态机
|
||||
|
||||
@@ -123,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 表里**,
|
||||
压缩与归档碰不到它。
|
||||
@@ -151,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`)
|
||||
@@ -164,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`
|
||||
@@ -176,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 逐层剥掉
|
||||
@@ -191,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` 转发
|
||||
@@ -264,8 +324,9 @@ auth.router ← /login /logout /api/login /api/login_restore /api/passwor
|
||||
auth.middleware ← 其余请求需登录(cookie 优先,Basic 兜底)
|
||||
preview-proxy.earlyGuard
|
||||
express.static(public)
|
||||
/api/sessions ×3 ← sessions / messages / files
|
||||
/api/sessions ×4 ← sessions / messages / files / skill-run(通用执行面)
|
||||
/api/skills
|
||||
/api/asr ← 语音识别代理:/transcribe 走登录态;ASR_URL 空或配置里无可用 asr 段则 503
|
||||
/api/config ← requireAdmin
|
||||
/api/platforms
|
||||
/api/system ← /restart 需 admin,其余登录即可
|
||||
@@ -274,6 +335,8 @@ express.static(public)
|
||||
/api/memory
|
||||
/api/wechat
|
||||
/api/channel
|
||||
/api/health ← 免认证探活:套壳 App / 运维脚本用它校验服务器地址
|
||||
(只认 200 + body.ok + service==='agent-core')
|
||||
data-page ← GET /app/:task_id/*、POST /api/db/:task_id/query
|
||||
preview-proxy.mount(末尾兜底)
|
||||
```
|
||||
@@ -281,19 +344,23 @@ preview-proxy.mount(末尾兜底)
|
||||
- 错误形状统一 `{ error: string }`,`err.status_code` 决定 HTTP 码。
|
||||
- 认证:HMAC 签名 HttpOnly cookie(`agent_token`),`Authorization: Basic` 兜底,
|
||||
`Authorization: Bearer` 仅用于 `/api/login_restore`。`auth.users` 为空 = 完全关闭认证。
|
||||
- 免认证路径集中在 `auth.js` 的 `PUBLIC_EXACT`(含 `/api/health`,且容忍尾斜杠)。
|
||||
新增免登录接口必须加进去,否则会被中间件先拦成 401。
|
||||
- **单租户警告**:除管理员接口外不做资源级授权;按用户的会话列表隔离在查询层(`sessions.user`)。
|
||||
- 公网短链 `/p/<id>` 的信任模型:随机 ID + 服务端 TTL + 签发时 `realpath` 校验,不靠登录态。
|
||||
|
||||
## 前端(`server/public/`)
|
||||
|
||||
- **无构建**:`index.html` 按顺序加载经典脚本,共享全局作用域:
|
||||
`core.js → chat.js → sessions.js → stream.js → files.js → preview.js → settings.js`
|
||||
`core.js → chat.js → sessions.js → stream.js → files.js → voice.js → preview.js → settings.js`
|
||||
(`settings.js` 必须最后,尾部有全局初始化);`marked.min.js` 走 `vendor/`。
|
||||
- 新增 JS 文件必须同时改 `index.html` 的 `<script>` 顺序——没有 import/export,顺序就是依赖。
|
||||
- `sw.js`:HTML/JS/CSS 网络优先,图片/JSON 缓存优先。**改图片或 JSON 才需要升 `CACHE_VERSION`**;
|
||||
JS/CSS 改动不需要。
|
||||
- 另有 `login.html`、`memory.html`(日记调试页)。
|
||||
- API 调用统一走 `core.js` 的 `req()`;SSE 用 `EventSource` + 前端看门狗。
|
||||
- 文件面板(`files.js`)按目录懒加载:只请求 `GET /api/sessions/:id/tree?dir=<rel>` 的当前层,
|
||||
进入子目录才拉下一层;会话详情接口不返回全量 `files`。
|
||||
|
||||
## 扩展指南
|
||||
|
||||
@@ -327,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 一致)。
|
||||
|
||||
+53
-5
@@ -27,7 +27,7 @@ data_root: "/workspace/data" # 数据根目录:SQLite
|
||||
db_path: "" # 留空取 data_root/.agent.db
|
||||
log_level: "info" # debug < info < warn < error < none(仅 core 自身;executor/wxbot 的日志等级另走 EXECUTOR_LOG_LEVEL / WXBOT_LOG_LEVEL env,compose 注)
|
||||
|
||||
# executor(命令执行)与 wxbot(微信接入)均**不是本文件的配置项**,接线全走根 compose 注入的 env(见 .env.example):
|
||||
# executor(命令执行)与 wxbot(微信接入)均**不是本文件的配置项**,接线全走根 compose 注入的 env(见 README「环境变量」):
|
||||
# EXECUTOR_URL / EXECUTOR_TOKEN;WXBOT_URL(默认 http://agent-wxbot:8093,置空=微信入口静默关闭)/ WXBOT_TOKEN(init.sh 生成,两侧同值)。
|
||||
|
||||
terminal:
|
||||
@@ -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):收口时一条几十字第一人称碎片入当日条目;存储默认永久,旧记忆靠回忆下钻
|
||||
@@ -79,9 +114,22 @@ auth: # users 留空 = 不启用登
|
||||
role: admin # admin=管理员(全部设置 + 用户管理);user 或缺省=普通用户(仅账户页)
|
||||
# model: qwen-tp/qwen3.8-flash # 选填:该用户新建会话时锁定的模型(内部键「平台名/模型id」)
|
||||
|
||||
# MCP 服务列表(仓库自带的 mcp/ 三个服务,或栈外服务):每项 {name?, url, headers?, mode?(默认 advertise), timeout_ms?, tools_allow?, tools_deny?}。
|
||||
# MCP 服务列表(仓库自带的 mcp/ 服务,或栈外服务):每项 {name?, url, headers?, mode?(默认 advertise), timeout_ms?, tools_allow?, tools_deny?}。
|
||||
# mode 三态:advertise=工具下发给模型;skill=不下发,改为以技能形式暴露(get 返回原始 input_schema,run 转发);
|
||||
# disable=不连接、不发现。旧字段 enable 已废弃;mode: silent 已移除(改用 skill),写进配置会启动报错。
|
||||
#
|
||||
# 语音识别(mcp/asr)建议用 skill:转写音频是低频能力,不必把 schema 塞进每轮请求。
|
||||
# 上游参数(key / base_url / model)由 core 随请求带给 mcp_asr,容器自己不存密钥,
|
||||
# 也不预设任何平台——任何 OpenAI 兼容的 /audio/transcriptions 都行。免鉴权的自建服务可省 Authorization。
|
||||
# - 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
|
||||
# 注意:输入框里的语音输入走的是 core 的 /api/asr(由 compose 的 ASR_URL 接线),也读这一段的 headers;
|
||||
# 不经工具、不消耗 token。mode: disable 或删掉这段 = 麦克风入口关闭。
|
||||
mcp_servers: []
|
||||
|
||||
public_link:
|
||||
|
||||
Generated
+179
-157
File diff suppressed because it is too large
Load Diff
+2
-1
@@ -1,6 +1,6 @@
|
||||
{
|
||||
"name": "agent-app",
|
||||
"version": "2.3.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"
|
||||
}
|
||||
}
|
||||
|
||||
+13
-2
@@ -73,7 +73,10 @@ function basicAuthUser(req, users) {
|
||||
// ---------- 免认证路径(登录页自身需要的资源) ----------
|
||||
const PUBLIC_EXACT = new Set(['/login', '/logout', '/api/login', '/api/logout', '/api/login_restore', '/api/health']);
|
||||
function isPublicPath(p) {
|
||||
if (PUBLIC_EXACT.has(p)) return true;
|
||||
// 尾斜杠容忍:客户端手动填服务器地址常多带一个 `/`(拼成 `/api/health/`),
|
||||
// Express 路由本身能匹配,但这里若不规范化,中间件会先回 401——地址明明是对的却报未登录。
|
||||
const norm = p.length > 1 ? p.replace(/\/+$/, '') : p;
|
||||
if (PUBLIC_EXACT.has(norm)) return true;
|
||||
if (p.startsWith('/css/')) return true; // 登录页复用 style.css
|
||||
if (p === '/favicon.ico') return true;
|
||||
return false;
|
||||
@@ -101,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(),
|
||||
@@ -229,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 });
|
||||
});
|
||||
|
||||
// ----- 登录页 / 登出跳转 -----
|
||||
|
||||
+196
-21
@@ -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 },
|
||||
@@ -126,7 +145,7 @@ const DEFAULTS = {
|
||||
// mode 三态:advertise=工具下发给模型;skill=不下发,改为以技能形式暴露(get 返回原始
|
||||
// input_schema,run 直接转发);disable=不加载。
|
||||
mcp_servers: [],
|
||||
// 公网临时链接:base_url 非空才启用 mint_public_link;容器配 VIRTUAL_HOST 时以它为准。
|
||||
// 公网临时链接:base_url 非空才启用 mint_public_link(config.yml 优先,其次 env PUBLIC_BASE_URL)。
|
||||
public_link: { base_url: '', ttl_ms: 1800000 },
|
||||
};
|
||||
|
||||
@@ -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,
|
||||
@@ -383,16 +485,14 @@ function parseAndValidate(rawText, configPath) {
|
||||
// 公网链接宁可短不可长(“永久公开”正是这套机制要避免的东西)。
|
||||
//
|
||||
// 对外前缀的取值优先级:
|
||||
// 1) 容器 env 的 VIRTUAL_HOST 非空 → https://<第一个域名>
|
||||
// (nginx-proxy 的写法,逗号分隔多域名时取第一个)。只要配了域名 + HTTPS 这一层,
|
||||
// 返回给外部服务(video_task 取参考图)的链接就必须走域名,所以 env 优先;
|
||||
// 反之 config.yml 里那个 init 脚本生成的 http://<IP>:8090 会把这个开关盖住。
|
||||
// 协议写死 https:前置了 nginx-proxy 一定是 HTTPS(证书由 acme-companion 签)。
|
||||
// 2) 否则用 config.yml 的 public_link.base_url(纯 IP:端口部署,init 脚本写 http://<IP>:8090)。
|
||||
// 1) config.yml 的 public_link.base_url(设置页「公网地址」手填的值,以它为准)。
|
||||
// 2) env PUBLIC_BASE_URL(scripts/init.sh 探测公网 IP 后写进 .env 的部署地址)。
|
||||
// 它只是默认值:页面里填过 1) 之后就归 1) 管,避免“重跑部署脚本”和“UI 手改”互相打架。
|
||||
function normalizePublicLink(cfg) {
|
||||
const pl = cfg.public_link || {};
|
||||
const vhost = String(process.env.VIRTUAL_HOST || '').split(',')[0].trim();
|
||||
const baseUrl = vhost ? 'https://' + vhost : pl.base_url;
|
||||
const fromCfg = String(pl.base_url == null ? '' : pl.base_url).trim();
|
||||
const fromEnv = String(process.env.PUBLIC_BASE_URL || '').trim();
|
||||
const baseUrl = fromCfg || fromEnv;
|
||||
cfg.public_link = {
|
||||
base_url: String(baseUrl || '').trim().replace(/\/+$/, ''),
|
||||
ttl_ms: Math.min(Math.max(Number(pl.ttl_ms) || 1800000, 60 * 1000), 24 * 3600 * 1000),
|
||||
@@ -405,7 +505,22 @@ function normalizePublicLink(cfg) {
|
||||
|
||||
function loadConfig(configPath) {
|
||||
const p = configPath || process.env.AGENT_CONFIG || path.join(__dirname, '..', 'config.yml');
|
||||
const text = fs.existsSync(p) ? fs.readFileSync(p, 'utf8') : '';
|
||||
// 目录按“文件不存在”处理:Docker 在 bind mount 的源文件缺失时会建一个同名**空目录**,
|
||||
// 直接 readFileSync 会 EISDIR 崩在启动阶段——那时用户看不到任何可操作的报错。
|
||||
// 空文件/缺失都是合法状态:platforms 为空、auth 为空(= 未启用登录),全部配置可稍后在前端完成。
|
||||
let text = '';
|
||||
let isDir = false;
|
||||
try {
|
||||
const st = fs.statSync(p);
|
||||
if (st.isFile()) text = fs.readFileSync(p, 'utf8');
|
||||
else isDir = true;
|
||||
} catch (_) { /* 不存在 */ }
|
||||
if (isDir) {
|
||||
log.warn('config', 'config.yml 是目录(Docker 在挂载源文件缺失时会自动建同名目录,容器内无法当文件写):' + p +
|
||||
';请在宿主机上删掉该空目录后重跑 scripts/init.sh');
|
||||
} else if (!text.trim()) {
|
||||
log.warn('config', 'config.yml 缺失或为空(' + p + '):当前无模型、无登录鉴权;可在前端「设置」里补齐配置(保存后重启生效)');
|
||||
}
|
||||
return parseAndValidate(text, p);
|
||||
}
|
||||
|
||||
@@ -418,25 +533,85 @@ function loadConfigFromText(text, configPath) {
|
||||
// 读当前配置文件原文(保留注释);文件不存在返回 null。
|
||||
function readConfigText(cfg) {
|
||||
const p = cfg && cfg.config_path;
|
||||
if (!p || !fs.existsSync(p)) return null;
|
||||
if (!p) return null;
|
||||
// 目录(Docker 误建)与缺失一视同仁按“不存在”返回,交给调用方决定新建还是报错。
|
||||
try { if (!fs.statSync(p).isFile()) return null; } catch (_) { return null; }
|
||||
return fs.readFileSync(p, 'utf8');
|
||||
}
|
||||
|
||||
// 单项编辑:[{path:[...], value}] 或 [{path:[...], delete:true}] 或 [{path:[...], value, append:true}]。
|
||||
// 用 YAML Document 写回,保留注释与排版;路径段为纯数字时按数组下标处理(如 ["platforms",0,"keys",1,"models",0])。
|
||||
// append:向目标数组追加一项(新增平台/Key/模型用);目标不存在时创建新数组。
|
||||
//
|
||||
// 写回时的版式处理(只作用于本次编辑写入的节点,文件其它部分原样保留):
|
||||
// · 值带冒号(如模型 id "global:hy-image-3.5")强制双引号——裸写的 plain 标量换个解析器、
|
||||
// 或落进 flow 集合里就容易被当成分隔符;纯 URL 例外(裸写无歧义)。
|
||||
// · extra_params / thinking_params 这类小参数表用 flow 风格({k: v})写成一行,否则嵌套几层
|
||||
// 展开成十几行,读起来又乱又占版面。
|
||||
// · 追加整项时连同所在数组一起转 block:flow 数组里塞 block 映射会输出成残句(platforms: 后直接跟键)。
|
||||
const FLOW_PARAM_KEYS = new Set(['extra_params', 'thinking_params']);
|
||||
|
||||
function needsQuoteStr(v) {
|
||||
return typeof v === 'string' && v.includes(':') && !/^\w+:\/\/\S+$/.test(v);
|
||||
}
|
||||
|
||||
function styleWrittenNode(node, forceBlock) {
|
||||
if (!node || typeof node !== 'object') return;
|
||||
if (YAML.isScalar(node)) {
|
||||
if (needsQuoteStr(node.value)) node.type = 'QUOTE_DOUBLE';
|
||||
return;
|
||||
}
|
||||
if (YAML.isMap(node)) {
|
||||
if (forceBlock) node.flow = false;
|
||||
for (const pair of node.items) {
|
||||
const key = pair.key && pair.key.value;
|
||||
const child = pair.value;
|
||||
// 参数表保持 flow;内部值不再强制 block(不然 {k: {…}} 里的嵌套表会被抖开)
|
||||
if (FLOW_PARAM_KEYS.has(String(key)) && child && typeof child === 'object' && !YAML.isScalar(child)) {
|
||||
child.flow = true;
|
||||
styleWrittenNode(child, false);
|
||||
} else {
|
||||
styleWrittenNode(child, forceBlock);
|
||||
}
|
||||
}
|
||||
} else if (YAML.isSeq(node)) {
|
||||
if (forceBlock) node.flow = false;
|
||||
for (const item of node.items) styleWrittenNode(item, forceBlock);
|
||||
}
|
||||
}
|
||||
|
||||
function styledNode(doc, value, forceBlock) {
|
||||
const node = doc.createNode(value);
|
||||
if (forceBlock && node && typeof node === 'object' && !YAML.isScalar(node)) node.flow = false;
|
||||
styleWrittenNode(node, forceBlock);
|
||||
return node;
|
||||
}
|
||||
|
||||
function applyEditsToText(text, edits) {
|
||||
const doc = YAML.parseDocument(text || '');
|
||||
for (const e of edits || []) {
|
||||
if (!e || !Array.isArray(e.path) || !e.path.length) throw new Error('配置项 path 必须是非空数组');
|
||||
const docPath = e.path.map(s => (typeof s === 'string' && /^\d+$/.test(s)) ? Number(s) : s);
|
||||
if (e.delete) doc.deleteIn(docPath);
|
||||
else if (e.append) {
|
||||
if (e.delete) { doc.deleteIn(docPath); continue; }
|
||||
if (e.append) {
|
||||
const item = styledNode(doc, e.value, true);
|
||||
const target = doc.getIn(docPath, true);
|
||||
if (target && typeof target.add === 'function') target.add(e.value);
|
||||
else if (target === null || target === undefined) doc.setIn(docPath, [e.value]);
|
||||
else throw new Error('配置项 ' + docPath.join('.') + ' 不是数组,无法追加');
|
||||
} else doc.setIn(docPath, e.value);
|
||||
if (target && typeof target.add === 'function') {
|
||||
target.flow = false; // 与 block 化的新项保持一致,否则父数组仍是 flow
|
||||
target.add(item);
|
||||
} else if (target === null || target === undefined) {
|
||||
const seq = doc.createNode([]);
|
||||
seq.flow = false;
|
||||
seq.add(item);
|
||||
doc.setIn(docPath, seq);
|
||||
} else throw new Error('配置项 ' + docPath.join('.') + ' 不是数组,无法追加');
|
||||
continue;
|
||||
}
|
||||
const node = styledNode(doc, e.value, false);
|
||||
// 直接写参数键(整对象 set)时也要 flow
|
||||
if (FLOW_PARAM_KEYS.has(String(docPath[docPath.length - 1])) &&
|
||||
node && typeof node === 'object' && !YAML.isScalar(node)) node.flow = true;
|
||||
doc.setIn(docPath, node);
|
||||
}
|
||||
return doc.toString();
|
||||
}
|
||||
|
||||
@@ -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 };
|
||||
|
||||
+528
-37
@@ -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');
|
||||
@@ -16,6 +17,13 @@ const TOOL_DEFINITIONS = require('./tools/definitions.json');
|
||||
let cfg, db, bus;
|
||||
const runs = new Map(); // session_id -> {cancelled, procs:Set, abortController, looping:boolean}
|
||||
const titling = new Set(); // 正在生成标题的会话(防重入;标题落库后靠 title 非空自然不再触发)
|
||||
// 待投递消息队列:session_id -> [{id, content, deepThink, mode, created_at}]
|
||||
// 铁律:队列里的消息**绝不先落 messages 表**,只在「安全边界」写入并成为模型下一轮输入:
|
||||
// ① 工具批次闭合(本批每个 tool_call_id 都有回执);② 无 tool_calls 的回复已落库;
|
||||
// ③ 回合 finalize(循环已退、没有在跑的工具)。
|
||||
// 原因:tool 回执必须紧跟带 tool_calls 的 assistant,user 行插进批次中间、或批次没闭合就收尾,
|
||||
// 都会让上游拒收整个请求(tool_call 配对)。进程内内存态(同 runs),重启即丢,不跨实例共享。
|
||||
const pendings = new Map();
|
||||
|
||||
// ---------- 小工具 ----------
|
||||
const now = () => Date.now();
|
||||
@@ -46,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) {
|
||||
@@ -69,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 (?,?,?,?,?,?,?,?,?,?,?)'
|
||||
@@ -142,6 +206,8 @@ function emitStatus(sessionId) {
|
||||
session_id: sessionId,
|
||||
status: s.status,
|
||||
model_id: s.model_id,
|
||||
// 待投递队列一并带上:前端把条幅当成服务端状态的回显,重连/换设备后自动对齐
|
||||
pending: listPending(sessionId),
|
||||
});
|
||||
}
|
||||
|
||||
@@ -163,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 记忆收口) ----------
|
||||
@@ -310,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。
|
||||
@@ -456,13 +583,55 @@ function killRunProcs(run) {
|
||||
run.procs.clear();
|
||||
}
|
||||
|
||||
// 关闭当前工具批次:给「最后一条带 tool_calls 的 assistant」里还没有回执的调用补合成 tool 行。
|
||||
// 上游硬约束:assistant.tool_calls 必须逐个配 tool 消息,缺一条整个请求被拒(400)。
|
||||
// 触发点:取消(含「立即发送」硬中断)、干预跳过同批剩余调用、finalize 兜底(异常退出)。
|
||||
// 只在批次尾部补:若最后一条非 tool 行已经是 user(历史遗留脏数据、user 插在批次中间),
|
||||
// 补在后面会造成顺序错乱,交给 llm.buildMessages 的读侧配对过滤处理。
|
||||
// reason 是一句以冒号结尾的前缀,拼成模型能读懂的「为什么没执行」。
|
||||
function closeToolBatch(sessionId, reason) {
|
||||
// 会话已被删除(用户在工具执行中删了会话):不再往库里补行,否则留下无法归属的孤儿行。
|
||||
if (!getSession(sessionId)) return 0;
|
||||
// 只取最后一条非 tool 行 + 它之后的回执 id:走 idx_messages_session,不载全量历史
|
||||
//(finalize 每回合都会调一次,长会话下 loadHistory 太贵)。
|
||||
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') return 0; // 最后一条非 tool 行不是 assistant:不是当前批次
|
||||
if (!last.tool_calls) return 0; // 收尾回复:批次已经闭合
|
||||
let calls = [];
|
||||
try { calls = JSON.parse(last.tool_calls) || []; } catch (_) { return 0; }
|
||||
if (!calls.length) 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) || '未知工具';
|
||||
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, skipped: true, msg_id: msgId,
|
||||
});
|
||||
n++;
|
||||
}
|
||||
if (n) log.info('tool', sessionId + ' 补齐 ' + n + ' 条未执行调用的合成回执(' + reason + ')');
|
||||
return n;
|
||||
}
|
||||
|
||||
// ---------- Agent 主循环 ----------
|
||||
async function runLoop(sessionId) {
|
||||
const run = getRun(sessionId, true);
|
||||
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);
|
||||
@@ -477,26 +646,66 @@ 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; }
|
||||
const cancelled = run.cancelled;
|
||||
// 兜底:回合结束时本批 tool_call 必须逐个有回执。取消/异常/进程被杀都可能留下半批,
|
||||
// 缺的补一条「未执行」合成回执——这是「工具调用不匹配」的唯一根治点。
|
||||
try { closeToolBatch(sessionId, cancelled ? (run.interruptReason || '用户已终止任务:') : '回合异常结束:'); }
|
||||
catch (e) { log.warn('tool', sessionId + ' 关闭工具批次失败:' + (e && e.message || e)); }
|
||||
if (cancelled) {
|
||||
touch(sessionId, { status: 'cancelled', cancelled_at: now(), completed_at: null });
|
||||
runs.delete(sessionId);
|
||||
bus.emit(sessionId, 'done', { status: 'cancelled' });
|
||||
emitStatus(sessionId);
|
||||
return;
|
||||
} else {
|
||||
// 正常结束:进入 held,绑定保持(key 非独占、无租约,不再自动到期);用户追问直接复用模型,唯一出口是手动「断开」。
|
||||
touch(sessionId, { status: 'held', held_at: now(), completed_at: null, cancelled_at: null });
|
||||
runs.delete(sessionId);
|
||||
bus.emit(sessionId, 'done', { status: 'held' });
|
||||
emitStatus(sessionId);
|
||||
maybeGenerateTitle(sessionId, s, run);
|
||||
// 定时即下班:本回合创建过定时任务 → done 广播后收口(attachBus 监听已在 done 回调里同步捕获绑定入队投递,
|
||||
// 此时删绑定不影响微信本次回复送达)。
|
||||
if (run.taskWrap) taskClockOut(sessionId);
|
||||
}
|
||||
// 队首待投递消息:回合已收尾(循环已退、批次已闭合),这是排队模式唯一的安全出口。
|
||||
// setImmediate 让 finalize 所在的 finally 先跑完(maybeAutoCompress 会读状态),再开新一轮。
|
||||
if (headPending(sessionId)) {
|
||||
setImmediate(() => {
|
||||
try { deliverPendingHead(sessionId); }
|
||||
catch (e) { log.warn('msg', sessionId + ' 待投递消息发送失败:' + (e && e.message || e)); }
|
||||
});
|
||||
}
|
||||
// 正常结束:进入 held,绑定保持(key 非独占、无租约,不再自动到期);用户追问直接复用模型,唯一出口是手动「断开」。
|
||||
touch(sessionId, { status: 'held', held_at: now(), completed_at: null, cancelled_at: null });
|
||||
runs.delete(sessionId);
|
||||
bus.emit(sessionId, 'done', { status: 'held' });
|
||||
emitStatus(sessionId);
|
||||
maybeGenerateTitle(sessionId, s, run);
|
||||
// 定时即下班:本回合创建过定时任务 → done 广播后收口(attachBus 监听已在 done 回调里同步捕获绑定入队投递,
|
||||
// 此时删绑定不影响微信本次回复送达)。
|
||||
if (run.taskWrap) taskClockOut(sessionId);
|
||||
}
|
||||
|
||||
// 自动生成标题:每回合结束(finalize 成功分支)过门槛才触发,fire-and-forget 不阻塞收尾。
|
||||
@@ -568,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 消息
|
||||
@@ -579,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; }
|
||||
};
|
||||
@@ -619,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;
|
||||
@@ -630,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;
|
||||
}
|
||||
@@ -709,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,
|
||||
@@ -725,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(
|
||||
@@ -733,9 +998,29 @@ 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) {
|
||||
// 「干预」升级过的待投递消息:本条回复已落库,正是安全边界——直接插话并继续同一回合
|
||||
//(不用等 finalize 再开新一轮,模型能接着刚才的上下文改弦更张)。
|
||||
const head = headPending(sessionId);
|
||||
if (head && head.mode === 'interject') {
|
||||
deliverPendingHead(sessionId);
|
||||
continue;
|
||||
}
|
||||
// 回合结束;但若期间用户又发了新消息(live 投递),继续下一轮而不是收尾
|
||||
if (!hasUserSince(sessionId, lastIncludedId)) break;
|
||||
continue;
|
||||
@@ -743,8 +1028,19 @@ async function runLoopInner(sessionId, run) {
|
||||
|
||||
// 执行工具
|
||||
const vision = modelVision(session);
|
||||
// 干预(整批还没开跑):一个工具都不执行,整批补「未执行」回执后立刻插话。
|
||||
// 顺序不能反:必须先闭合批次(写完全部 tool 回执)再写 user 行,否则 user 会夹在
|
||||
// assistant.tool_calls 与 tool 回执之间,上游直接拒收。
|
||||
const headBeforeBatch = headPending(sessionId);
|
||||
if (headBeforeBatch && headBeforeBatch.mode === 'interject') {
|
||||
closeToolBatch(sessionId, '用户已介入并要求中止:');
|
||||
deliverPendingHead(sessionId);
|
||||
iter++;
|
||||
continue;
|
||||
}
|
||||
// 标题门槛信号:本批参数预检通过并真实执行 = 会话在干实事(finalize 据此判是否立题,
|
||||
// 见 maybeGenerateTitle);errAck 批(参数畸形、下轮整轮对模型不可见)不算。
|
||||
// 见 maybeGenerateTitle);errAck 批(参数畸形、下轮整轮对模型不可见)不算,
|
||||
// 被干预整批跳过(上面已 continue)也不计。
|
||||
if (!isErrAck) run.toolWorked = true;
|
||||
for (const tc of msgRow.tool_calls) {
|
||||
if (run.cancelled) break;
|
||||
@@ -760,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);
|
||||
@@ -775,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 消息
|
||||
@@ -837,7 +1145,18 @@ async function runLoopInner(sessionId, run) {
|
||||
image_url: imageRel ? '/api/sessions/' + encodeURIComponent(sessionId) + '/files/download?path=' + encodeURIComponent(imageRel) : undefined,
|
||||
msg_id: toolMsgId,
|
||||
});
|
||||
// 干预(当前工具已跑完、回执已落库):同批剩余调用不再执行,闭合批次后立刻插话。
|
||||
// 不杀进程——这就是「干预」与「立即发送」的唯一区别。
|
||||
const headAfterTool = headPending(sessionId);
|
||||
if (headAfterTool && headAfterTool.mode === 'interject') {
|
||||
closeToolBatch(sessionId, '用户已介入并要求中止:');
|
||||
deliverPendingHead(sessionId);
|
||||
break;
|
||||
}
|
||||
}
|
||||
// 取消(含「立即发送」硬中断):本批还没跑到的调用补合成回执,否则库里留下
|
||||
// 「有调用无回执」的孤儿行,下一轮请求必被上游拒收(本次顺手修掉的存量 bug)。
|
||||
if (run.cancelled) closeToolBatch(sessionId, run.interruptReason || '用户已终止任务:');
|
||||
iter++;
|
||||
}
|
||||
if (iter >= maxIter && !run.cancelled) {
|
||||
@@ -890,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 }),
|
||||
@@ -1024,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);
|
||||
@@ -1045,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),不再有顾问阶段
|
||||
@@ -1058,6 +1384,143 @@ function createSession(title, preferModelId, assistantType, user) {
|
||||
return session;
|
||||
}
|
||||
|
||||
// ---------- 待投递消息(排队 / 干预 / 立即发送) ----------
|
||||
// 三种模式的差别只在「何时写库」,写库之前一律躺在 pendings 里(见文件头注释的铁律):
|
||||
// queue → 本轮 finalize 后投递(默认;浏览器关了也照发,因为队列在服务端)
|
||||
// interject → 当前工具批次闭合 / 本条回复落库后立即投递,同一回合内让模型看到
|
||||
// now → 硬中断(杀进程 + abort 流,本回合判 cancelled),收尾后立刻投递
|
||||
// 只允许升级队首:越过后面的消息先发会让对话顺序不可解释(前端也只有队首有这两个按钮)。
|
||||
function newPendingId() {
|
||||
return 'q_' + Date.now().toString(36) + Math.random().toString(36).slice(2, 8);
|
||||
}
|
||||
|
||||
function publicPending(it) {
|
||||
return { id: it.id, content: it.content, mode: it.mode, created_at: it.created_at };
|
||||
}
|
||||
|
||||
function pendingList(sessionId) {
|
||||
return pendings.get(sessionId) || [];
|
||||
}
|
||||
|
||||
function headPending(sessionId) {
|
||||
const list = pendings.get(sessionId);
|
||||
return list && list.length ? list[0] : null;
|
||||
}
|
||||
|
||||
function listPending(sessionId) {
|
||||
return pendingList(sessionId).map(publicPending);
|
||||
}
|
||||
|
||||
// 清空队列(用户点「停止」、删会话、清空会话):逐条广播,前端条幅随之消失。
|
||||
function clearPendings(sessionId) {
|
||||
const list = pendings.get(sessionId);
|
||||
if (!list || !list.length) return 0;
|
||||
pendings.delete(sessionId);
|
||||
for (const it of list) bus.emit(sessionId, 'pending_removed', { id: it.id, reason: 'cancelled' });
|
||||
log.info('msg', sessionId + ' 清空待投递消息 ' + list.length + ' 条');
|
||||
return list.length;
|
||||
}
|
||||
|
||||
// 入队。没有在跑的回合时,任何模式都等价于立即发送(队列只对运行中的回合有意义)。
|
||||
// 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) });
|
||||
return { message_id: r.message_id, delivered: r.delivered, pending: [] };
|
||||
}
|
||||
const item = {
|
||||
id: newPendingId(), content: text,
|
||||
deepThink: !!(opts && opts.deepThink), mode, created_at: now(),
|
||||
};
|
||||
const list = pendingList(sessionId).slice();
|
||||
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 + ' 待投递消息入队(' + mode + ',队列 ' + list.length + '):' + text.slice(0, 60).replace(/\s+/g, ' '));
|
||||
return { pending_id: item.id, queued: true, pending: list.map(publicPending) };
|
||||
}
|
||||
|
||||
// 升级队首:interject(跑完当前这一步就插话) / now(立刻中断本轮)。
|
||||
// 回合已经结束(没在跑)时直接投递——用户点按钮时恰好收尾,不该把消息卡在队列里。
|
||||
function promotePending(sessionId, qid, action) {
|
||||
const session = getSession(sessionId);
|
||||
if (!session) throw Object.assign(new Error('会话不存在'), { status_code: 404 });
|
||||
const list = pendingList(sessionId);
|
||||
const idx = list.findIndex(x => x.id === qid);
|
||||
if (idx < 0) throw Object.assign(new Error('待发送消息不存在'), { status_code: 404 });
|
||||
if (idx !== 0) throw Object.assign(new Error('只能升级队首消息:前面的消息还没发出去'), { status_code: 409 });
|
||||
const run = runs.get(sessionId);
|
||||
if (!run || !run.looping) {
|
||||
deliverPendingHead(sessionId);
|
||||
return { ok: true, delivered: true, pending: listPending(sessionId) };
|
||||
}
|
||||
const item = list[0];
|
||||
if (action === 'now') {
|
||||
item.mode = 'now';
|
||||
bus.emit(sessionId, 'pending_added', publicPending(item)); // 前端按 id upsert,按钮态跟着变
|
||||
run.interruptReason = '用户选择立即发送:';
|
||||
run.cancelled = true;
|
||||
killRunProcs(run);
|
||||
if (run.abortController) { try { run.abortController.abort(); } catch (_) {} }
|
||||
log.info('msg', sessionId + ' 立即发送:中断当前回合,收尾后投递队首');
|
||||
} else {
|
||||
item.mode = 'interject';
|
||||
bus.emit(sessionId, 'pending_added', publicPending(item));
|
||||
log.info('msg', sessionId + ' 干预:等待当前工具/回复结束后插话');
|
||||
}
|
||||
return { ok: true, pending: listPending(sessionId) };
|
||||
}
|
||||
|
||||
// 取消队列里的一条(条幅上的 ×)。任意一条都可删:删队首后剩下的自然顺延,顺序仍是 FIFO。
|
||||
function cancelPending(sessionId, qid) {
|
||||
const session = getSession(sessionId);
|
||||
if (!session) throw Object.assign(new Error('会话不存在'), { status_code: 404 });
|
||||
const list = pendingList(sessionId);
|
||||
const idx = list.findIndex(x => x.id === qid);
|
||||
if (idx < 0) throw Object.assign(new Error('待发送消息不存在'), { status_code: 404 });
|
||||
const next = list.slice();
|
||||
next.splice(idx, 1);
|
||||
if (next.length) pendings.set(sessionId, next); else pendings.delete(sessionId);
|
||||
bus.emit(sessionId, 'pending_removed', { id: qid, reason: 'cancelled' });
|
||||
log.info('msg', sessionId + ' 取消待投递消息 ' + qid);
|
||||
return { ok: true, pending: next.map(publicPending) };
|
||||
}
|
||||
|
||||
// 投递队首:写库 + 广播。调用方必须已保证处在安全边界(批次已闭合 / 回合已收尾)。
|
||||
// 落库走 postUserMessage:正在跑时它是 live 追加(下一轮迭代自动带上),没在跑时直接开新一轮。
|
||||
function deliverPendingHead(sessionId) {
|
||||
const list = pendingList(sessionId);
|
||||
if (!list.length) return null;
|
||||
const item = list[0];
|
||||
const next = list.slice(1);
|
||||
if (next.length) pendings.set(sessionId, next); else pendings.delete(sessionId);
|
||||
const r = postUserMessage(sessionId, item.content, { deepThink: item.deepThink });
|
||||
const row = db.prepare('SELECT created_at FROM messages WHERE id = ?').get(r.message_id);
|
||||
bus.emit(sessionId, 'pending_removed', { id: item.id, reason: 'delivered' });
|
||||
// 排队期间前端不画这条消息(它还不是历史),落库这一刻才画
|
||||
bus.emit(sessionId, 'user_message', {
|
||||
id: r.message_id, content: item.content,
|
||||
created_at: (row && row.created_at) || item.created_at, pending_id: item.id,
|
||||
});
|
||||
log.info('msg', sessionId + ' 待投递消息已送达(原模式 ' + item.mode + ',剩余 ' + next.length + ' 条)');
|
||||
return r;
|
||||
}
|
||||
|
||||
// 用户消息入口:不再排队——任意非 looping 状态都是「拿模型立即开跑」(delivered 恒 live);
|
||||
// 绑定失效(配置改动后原模型被删/禁用)由 ensureBinding 自动改选,用户无感。
|
||||
// opts.deepThink: true 时启用模型该「深度思考」参数(记在会话 run 上,正在跑的回合下一轮迭代会取到最新值)。
|
||||
@@ -1069,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。
|
||||
@@ -1088,9 +1553,13 @@ function postUserMessage(sessionId, content, opts) {
|
||||
function stop(sessionId) {
|
||||
const session = getSession(sessionId);
|
||||
if (!session) throw Object.assign(new Error('会话不存在'), { status_code: 404 });
|
||||
// 「停止」= 全停:待投递队列一并作废。否则 finalize 会立刻把队首当成新回合发出去,
|
||||
// 与用户按停止的意图相反(「立即发送」不走这里,它只中断当前回合、保留队首)。
|
||||
clearPendings(sessionId);
|
||||
const run = runs.get(sessionId);
|
||||
if (run) {
|
||||
run.cancelled = true;
|
||||
run.interruptReason = '用户已终止任务:';
|
||||
killRunProcs(run);
|
||||
if (run.abortController) { try { run.abortController.abort(); } catch (_) {} }
|
||||
}
|
||||
@@ -1125,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 (_) {}
|
||||
@@ -1134,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 };
|
||||
@@ -1163,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);
|
||||
@@ -1415,7 +1889,10 @@ function clearSessionMessages(sessionId) {
|
||||
if (run.abortController) { try { run.abortController.abort(); } catch (_) {} }
|
||||
}
|
||||
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); // 历史清零,恢复自动压缩提议额度
|
||||
// 标题随历史一并清零:旧标题描述的是已删除的对话,留着会让新对话文不对题;
|
||||
@@ -1451,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 = [];
|
||||
@@ -1462,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 };
|
||||
}
|
||||
|
||||
@@ -1479,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);
|
||||
@@ -1509,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 };
|
||||
}
|
||||
|
||||
@@ -1523,6 +2009,10 @@ module.exports = {
|
||||
activeRuns,
|
||||
createSession,
|
||||
postUserMessage,
|
||||
enqueueMessage,
|
||||
promotePending,
|
||||
cancelPending,
|
||||
listPending,
|
||||
stop,
|
||||
releaseHold,
|
||||
renameSession,
|
||||
@@ -1537,6 +2027,7 @@ module.exports = {
|
||||
loadHistory,
|
||||
checkToolArgs, // 参数预检/信封解包两个纯函数:导出供探针与回归验证(运行链路由 runLoopInner 内部调用)
|
||||
unwrapToolArgs,
|
||||
closeToolBatch, // 批次闭合兜底:导出供回归验证(正常链路由 runLoopInner / finalize 调用)
|
||||
saveMessage,
|
||||
recordModelUsage,
|
||||
modelUsageStats,
|
||||
|
||||
@@ -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 };
|
||||
+256
-62
@@ -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 (_) {}
|
||||
@@ -219,7 +248,33 @@ function buildMessages(session, language, mintUrl, profile, withProfile, trimOn)
|
||||
}
|
||||
// tool 回执按 tool_call_id 索引:给 errAck 行拼错误提示时取执行时挡下的原因
|
||||
const toolRowById = new Map();
|
||||
for (const row of history) if (row.role === 'tool' && row.tool_call_id) toolRowById.set(row.tool_call_id, row);
|
||||
// 只收「会下发」的回执:archived 行不进模型,不能拿它当配对凭据
|
||||
//(否则 assistant 的调用被保留、回执却被跳过,上游照样拒收)。
|
||||
for (const row of history) {
|
||||
if (row.role !== 'tool' || !row.tool_call_id || row.type === 'archived') continue;
|
||||
toolRowById.set(row.tool_call_id, row);
|
||||
}
|
||||
// 已下发的 tool_call id 集合:tool 行按它反查自己有没有「主」。
|
||||
// 与下面的调用侧过滤合成「读侧配对兜底」:库里的孤儿行(旧版本中途终止留下的有调用无回执、
|
||||
// 或历史被外部改动)一律不进请求——严格上游对配对是硬约束,缺一条整请求被拒。
|
||||
// 只影响发给模型的那一份,DB 与 UI 完全不动。
|
||||
const emittedCallIds = new Set();
|
||||
// 预扫:每条带 tool_calls 的 assistant「紧跟着它的那批回执」里真实存在的 call id。
|
||||
// 只往下扫连续的 tool 行,遇到 user/assistant 就停——上游要求 tool 回执紧跟在
|
||||
// 带 tool_calls 的 assistant 后面,中间夹任何消息(旧版 live 追投就可能把 user 插进来)
|
||||
// 都会让整批非法。所以不能拿「全库里有这条回执」当配对凭据。
|
||||
const pairedByAssistant = new Map(); // assistant 行 id -> Set(call_id)
|
||||
for (let i = 0; i < history.length; i++) {
|
||||
const r = history[i];
|
||||
if (r.role !== 'assistant' || !r.tool_calls) continue;
|
||||
const ids = new Set();
|
||||
for (let j = i + 1; j < history.length && history[j].role === 'tool'; j++) {
|
||||
// archived 回执不进模型,不能当作「已答复」凭据(否则调用被保留、回执被跳过)
|
||||
if (history[j].type === 'archived') continue;
|
||||
if (history[j].tool_call_id) ids.add(history[j].tool_call_id);
|
||||
}
|
||||
pairedByAssistant.set(r.id, ids);
|
||||
}
|
||||
// 「已消费」分界 = 最后一条**写过文本**的 assistant 行(不要求无 tool_calls):
|
||||
// 描述写在 content 里 + 继续调工具,就是模型真看到图的证据(见文件头注释的循环复盘)。
|
||||
// errAck / archived 不发模型,不算回复:它们之前的图不算被消费。
|
||||
@@ -255,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;
|
||||
}
|
||||
@@ -288,13 +345,25 @@ 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;
|
||||
if (row.tool_calls) {
|
||||
m.tool_calls = JSON.parse(row.tool_calls);
|
||||
if (trimActive && TRIM.writeRounds > 0) trimWriteCalls(m.tool_calls, roundsAfter.get(row.id) || 0);
|
||||
let calls = [];
|
||||
try { calls = JSON.parse(row.tool_calls) || []; } catch (_) { calls = []; }
|
||||
// 配对兜底(读侧):只下发本批确有回执的调用。旧版本中途终止、外部工具异常、
|
||||
// user 行插进批次中间,都会留下无法配对的调用,严格上游会拒收整个请求。
|
||||
const pairedIds = pairedByAssistant.get(row.id) || new Set();
|
||||
const paired = calls.filter(c => c && c.id && pairedIds.has(c.id));
|
||||
if (!paired.length) {
|
||||
// 整轮调用都没回执:纯工具轮整行不发;带正文的保留为普通文本回复
|
||||
if (!String(m.content || '').trim()) return;
|
||||
} else {
|
||||
m.tool_calls = paired;
|
||||
for (const c of paired) emittedCallIds.add(c.id);
|
||||
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;
|
||||
messages.push(m);
|
||||
@@ -302,6 +371,8 @@ function buildMessages(session, language, mintUrl, profile, withProfile, trimOn)
|
||||
}
|
||||
// errAck 轮的 tool 回执:随该轮一起丢弃,避免无主 tool 消息
|
||||
if (row.role === 'tool' && dropToolCallIds.has(row.tool_call_id)) return;
|
||||
// 孤儿 tool 回执(调用行被过滤/存档/errAck 丢弃):单独下发必被上游拒收,直接跳过
|
||||
if (row.role === 'tool' && !emittedCallIds.has(row.tool_call_id)) return;
|
||||
// tool/user 行:含图哨兵 JSON 还原为内容块(解析结果按行 id 缓存);已消费的图只留文字描述 + 标记
|
||||
const blocks = cachedDecodeBlocks(session, row);
|
||||
let content = row.content || '';
|
||||
@@ -354,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 });
|
||||
}
|
||||
});
|
||||
// 未消费图片合并发送:图上文字置顶、图块紧随(同序)。
|
||||
@@ -382,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 把坐在
|
||||
@@ -545,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 时触发一次;
|
||||
@@ -579,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;
|
||||
});
|
||||
}
|
||||
@@ -607,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 = '';
|
||||
@@ -708,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 };
|
||||
|
||||
+26
-3
@@ -18,7 +18,21 @@ const CALL_TIMEOUT_MS = 60000;
|
||||
let toolDefs = []; // OpenAI function 格式(所有 MCP 工具)
|
||||
const toolIndex = new Map(); // 发送名 -> { server, tool, def }(服务配置 + 原始工具名 + 原始契约)
|
||||
let builtinNames = new Set();
|
||||
let PUBLIC_BASE = ''; // core 自身公网前缀(loadConfig 已归一:VIRTUAL_HOST 优先 config.yml);随每次请求 X-Public-Base 头下发
|
||||
let PUBLIC_BASE = ''; // core 自身公网前缀(loadConfig 已归一:config.yml 优先,其次 PUBLIC_BASE_URL);随每次请求 X-Public-Base 头下发
|
||||
|
||||
// 每个服务的连接状态(启动发现 + 重试阶梯的实时结果),给设置页卡片上的「已连接 / 未连接」用。
|
||||
// 只反映运行态:改了 headers 没重启时仍是旧状态(页面顶部有「配置已写入,重启后生效」横幅兜底)。
|
||||
const statusMap = new Map(); // key = name|url|mode
|
||||
function statusKeyOf(s) {
|
||||
return [s.name, String(s.url || '').replace(/\/+$/, ''), s.mode || 'advertise'].join('|');
|
||||
}
|
||||
function setStatus(s, patch) {
|
||||
statusMap.set(statusKeyOf(s), Object.assign({
|
||||
name: s.name, url: s.url, mode: s.mode || 'advertise',
|
||||
ok: false, tools: 0, hidden: 0, disabled: false, error: '',
|
||||
}, patch));
|
||||
}
|
||||
function statuses() { return Array.from(statusMap.values()); }
|
||||
|
||||
// 发一次 JSON-RPC 请求,返回 { result, headers }(HTTP 非 2xx / error / 无法解析时抛异常)。
|
||||
// 某些 MCP 服务遵循 Streamable HTTP 规范会在 initialize 响应里返回 Mcp-Session-Id,
|
||||
@@ -169,9 +183,16 @@ async function loadServer(s) {
|
||||
log.warn('mcp', s.name + ': 名单过滤后剩 0 个工具,请核对 tools_allow/tools_deny 与 ' +
|
||||
'服务端实际工具名(如 ' + all.slice(0, 3).map(t => t.name).join(', ') + ' …)');
|
||||
}
|
||||
setStatus(s, { ok: true, tools: tools.length, hidden: hidden });
|
||||
return true;
|
||||
} catch (err) {
|
||||
log.warn('mcp', s.name + ' 工具发现失败(' + (err && err.message || err) + ')');
|
||||
// Node 的 fetch 只给一句 "fetch failed",真正原因在 cause(code=ECONNREFUSED / ENOTFOUND,
|
||||
// 或 message="bad port" 这类),设置页卡片的 title 要看这个才诊断得了
|
||||
const cause = err && err.cause;
|
||||
const detail = (cause && (cause.code || cause.message)) || '';
|
||||
const msg = String((err && err.message) || err) + (detail ? '(' + detail + ')' : '');
|
||||
log.warn('mcp', s.name + ' 工具发现失败(' + msg + ')');
|
||||
setStatus(s, { error: msg });
|
||||
return false;
|
||||
}
|
||||
}
|
||||
@@ -208,6 +229,7 @@ function retryFailed(failed) {
|
||||
async function init(cfg) {
|
||||
toolDefs = [];
|
||||
toolIndex.clear();
|
||||
statusMap.clear();
|
||||
PUBLIC_BASE = (cfg && cfg.public_link && cfg.public_link.base_url) || '';
|
||||
try {
|
||||
for (const d of require('./tools/definitions.json')) {
|
||||
@@ -221,6 +243,7 @@ async function init(cfg) {
|
||||
// mode: disable 时启动不加载该服务(不建工具表;配置保留,改回 advertise 重启后恢复)
|
||||
if (s.mode === 'disable') {
|
||||
log.info('mcp', s.name + ': mode=disable,跳过工具加载');
|
||||
setStatus(s, { disabled: true });
|
||||
continue;
|
||||
}
|
||||
if (!(await loadServer(s))) failed.push(s);
|
||||
@@ -295,4 +318,4 @@ async function notifyTool(name, args, timeoutMs, extraHeaders) {
|
||||
}
|
||||
}
|
||||
|
||||
module.exports = { init, toolDefinitions, hasTool, skillTools, getSkillTool, callTool, notifyTool };
|
||||
module.exports = { init, toolDefinitions, hasTool, skillTools, getSkillTool, callTool, notifyTool, statuses };
|
||||
|
||||
+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 ----------
|
||||
|
||||
@@ -0,0 +1,155 @@
|
||||
{
|
||||
"platforms": [
|
||||
{
|
||||
"key": "bigmodel",
|
||||
"label": "智谱",
|
||||
"url": "https://open.bigmodel.cn/api/paas/v4",
|
||||
"type": "bigmodel",
|
||||
"model_hint": "glm-5.3-flash",
|
||||
"model_defaults": {
|
||||
"vision": true,
|
||||
"extra_params": { "reasoning_effort": "low", "tool_stream": true },
|
||||
"thinking_params": { "reasoning_effort": "max" }
|
||||
}
|
||||
},
|
||||
{
|
||||
"key": "deepseek",
|
||||
"label": "DeepSeek",
|
||||
"url": "https://api.deepseek.com",
|
||||
"type": "deepseek",
|
||||
"model_hint": "deepseek-flash",
|
||||
"model_defaults": {
|
||||
"vision": true,
|
||||
"extra_params": { "thinking": { "type": "disabled" } },
|
||||
"thinking_params": { "thinking": { "type": "enabled" }, "reasoning_effort": "max" },
|
||||
"reasoning_ack_field": "reasoning_content"
|
||||
}
|
||||
},
|
||||
{
|
||||
"key": "qwen",
|
||||
"label": "通义千问",
|
||||
"url": "https://dashscope.aliyuncs.com/compatible-mode/v1",
|
||||
"type": "qwen",
|
||||
"model_hint": "qwen3.8-flash",
|
||||
"model_defaults": {
|
||||
"vision": true,
|
||||
"extra_params": { "enable_thinking": false },
|
||||
"thinking_params": { "enable_thinking": true, "reasoning_effort": "xhigh" }
|
||||
}
|
||||
}
|
||||
],
|
||||
"mcp": [
|
||||
{
|
||||
"key": "web_search",
|
||||
"label": "网页搜索",
|
||||
"desc": "内置免费搜索,也可接自建 /search",
|
||||
"url": "http://mcp_web_search:3000/",
|
||||
"mode": "advertise",
|
||||
"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",
|
||||
"label": "图片生成",
|
||||
"desc": "文生图 / 图生图",
|
||||
"url": "http://mcp_image_task:3000/mcp",
|
||||
"mode": "skill",
|
||||
"fields": [
|
||||
{
|
||||
"header": "Authorization",
|
||||
"label": "鉴权",
|
||||
"secret": true,
|
||||
"prefix": "Bearer ",
|
||||
"required": true,
|
||||
"placeholder": "API Key"
|
||||
},
|
||||
{
|
||||
"header": "X-Image-Task-Base-Url",
|
||||
"label": "地址",
|
||||
"required": true,
|
||||
"placeholder": "https://<host>/v1",
|
||||
"hint": "OpenAI 兼容 generations / edits"
|
||||
},
|
||||
{
|
||||
"header": "X-Image-Task-Model",
|
||||
"label": "模型",
|
||||
"required": true,
|
||||
"placeholder": "上游的模型 id"
|
||||
}
|
||||
]
|
||||
},
|
||||
{
|
||||
"key": "video_task",
|
||||
"label": "视频生成",
|
||||
"desc": "文生视频 / 图生视频",
|
||||
"url": "http://mcp_video_task:3000/mcp",
|
||||
"mode": "skill",
|
||||
"fields": [
|
||||
{
|
||||
"header": "Authorization",
|
||||
"label": "鉴权",
|
||||
"secret": true,
|
||||
"prefix": "Bearer ",
|
||||
"required": true,
|
||||
"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": "模型",
|
||||
"required": true,
|
||||
"placeholder": "上游的模型 id"
|
||||
}
|
||||
]
|
||||
},
|
||||
{
|
||||
"key": "asr",
|
||||
"label": "语音识别",
|
||||
"desc": "按住说话 / transcribe_audio",
|
||||
"url": "http://mcp_asr:3000/mcp",
|
||||
"mode": "skill",
|
||||
"fields": [
|
||||
{
|
||||
"header": "Authorization",
|
||||
"label": "鉴权",
|
||||
"secret": true,
|
||||
"prefix": "Bearer ",
|
||||
"placeholder": "支持自建免鉴权服务"
|
||||
},
|
||||
{
|
||||
"header": "X-ASR-Base-Url",
|
||||
"label": "地址",
|
||||
"required": true,
|
||||
"placeholder": "https://<host>/v1",
|
||||
"hint": "OpenAI 兼容的 /audio/transcriptions"
|
||||
},
|
||||
{
|
||||
"header": "X-ASR-Model",
|
||||
"label": "模型",
|
||||
"required": true,
|
||||
"placeholder": "上游的模型 id"
|
||||
}
|
||||
]
|
||||
}
|
||||
]
|
||||
}
|
||||
+942
-158
File diff suppressed because it is too large
Load Diff
+235
-79
@@ -2,25 +2,44 @@
|
||||
<html lang="zh">
|
||||
<head>
|
||||
<meta charset="UTF-8">
|
||||
<meta name="viewport" content="width=device-width, initial-scale=1.0, maximum-scale=1.0, user-scalable=no">
|
||||
<!-- viewport-fit=cover:让 env(safe-area-inset-*) 生效(缺了它 iOS 上恒为 0);
|
||||
interactive-widget=resizes-content:键盘弹起时缩 layout viewport(新 Chromium 认;
|
||||
不认的浏览器会忽略,由 js/viewport.js 的 --kb 兜底)。 -->
|
||||
<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;
|
||||
@@ -34,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 {
|
||||
@@ -54,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; }
|
||||
@@ -63,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 头像兼做「选择模型」入口(与聊天态的「选择模型」同一弹窗) */
|
||||
@@ -83,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>
|
||||
|
||||
@@ -99,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>
|
||||
|
||||
@@ -111,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>
|
||||
@@ -144,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>
|
||||
|
||||
<!-- ================= 对话状态:对话内容区 ================= -->
|
||||
@@ -157,41 +263,60 @@
|
||||
<!-- ================= 底部输入区 ================= -->
|
||||
<footer>
|
||||
<div class="attach-chips hidden" id="attach-chips"></div>
|
||||
<!-- 待发送条幅:运行中发出的消息先排在这里(不立即入库),逐条一行。
|
||||
默认等本轮结束自动发出;队首可「干预」(跑完当前这步就插话)或「立即发送」(中断本轮)。 -->
|
||||
<div class="send-queue hidden" id="send-queue" aria-live="polite"></div>
|
||||
<div class="input-shell">
|
||||
<!-- 编辑已发送消息:覆盖式重发提示条(发送后丢弃该条及其后的历史) -->
|
||||
<div class="edit-bar hidden" id="edit-bar">
|
||||
<span>正在编辑已发送的消息,发送后将丢弃其后的历史</span>
|
||||
<span>编辑已发送消息:发送后将丢弃原历史信息</span>
|
||||
<button id="edit-cancel" type="button">取消</button>
|
||||
</div>
|
||||
<div class="up-cards hidden" id="up-cards" aria-label="已上传文件"></div>
|
||||
<textarea id="msg-input" placeholder="传送信息" rows="2" enterkeyhint="enter"></textarea>
|
||||
<!-- 语音模式:输入框位置变成「按住 说话」(只有居中文字,无按钮外观) -->
|
||||
<div id="voice-hold" class="hidden" role="button" tabindex="0" aria-label="按住说话">按住 说话</div>
|
||||
<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 切换,尺寸不变避免输入区跳动 -->
|
||||
<!-- 同一按钮四态:发送(↑)/ 停止(方块)/ 语音(麦克风)/ 键盘。
|
||||
data-state 由 JS 切换,尺寸不变避免输入区跳动 -->
|
||||
<button class="send-btn" id="send-btn" data-state="send" title="发送" aria-label="发送">
|
||||
<svg viewBox="0 0 24 24" class="ic sm"><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-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>
|
||||
</div>
|
||||
<!-- 按住说话的遮罩:盖满输入卡并扩到屏幕两边(footer 有 12px 内边距 + shell 1px 边框)。
|
||||
声波由 JS 生成 25 根柱子;上滑到文案区域进入取消态(整体变红)。 -->
|
||||
<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>
|
||||
|
||||
@@ -200,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>
|
||||
@@ -222,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>
|
||||
@@ -238,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>
|
||||
@@ -256,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>
|
||||
@@ -269,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="技能名(字母/数字/-/_)">
|
||||
@@ -282,9 +412,11 @@
|
||||
<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/类型并给模型卡带上该平台的参数缺省 -->
|
||||
<div class="mpe-chips hidden" id="mpe-presets"></div>
|
||||
<input type="text" id="mpe-name" placeholder="平台名(留空取 url 主机名首段)">
|
||||
<input type="text" id="mpe-url" placeholder="平台上游地址(OpenAI 兼容 /v1)">
|
||||
<div class="mpe-sec">
|
||||
@@ -299,7 +431,6 @@
|
||||
<button class="ghost-btn danger hidden" id="mpe-del-btn" onclick="sUI.mDelPlat()">删除平台</button>
|
||||
<button class="primary-btn" onclick="sUI.mSave()">保存</button>
|
||||
</div>
|
||||
<div class="cfg-note">仅写入配置,点击「重启服务」后生效。</div>
|
||||
</div>
|
||||
</div>
|
||||
|
||||
@@ -307,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">
|
||||
@@ -329,30 +460,36 @@
|
||||
<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="服务名(留空取 url 主机名首段)">
|
||||
<input type="text" id="mce-url" placeholder="MCP 服务 JSON-RPC 端点(完整 URL)">
|
||||
<div class="mpe-sec">
|
||||
<input type="text" id="mce-name" placeholder="服务名">
|
||||
<input type="text" id="mce-url" placeholder="MCP 服务 JSON-RPC URL">
|
||||
<!-- 内置服务预设字段(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>
|
||||
</div>
|
||||
<div class="mpe-sec" id="mce-headers-sec">
|
||||
<div class="mpe-sec-head"><span>请求头(headers)</span><button class="ghost-btn sm" onclick="mcpUI.addHeader()">添加 header</button></div>
|
||||
<div id="mce-headers"></div>
|
||||
</div>
|
||||
<div class="mpe-cks" style="margin-top:14px">
|
||||
<label class="mpe-num">单次调用超时<input type="number" id="mce-timeout" min="1000" max="600000" step="1000" placeholder="默认 60000">ms</label>
|
||||
<div class="mpe-sec">
|
||||
<label class="mpe-line"><span>单次调用超时</span>
|
||||
<span class="mpe-unit"><input type="number" id="mce-timeout" min="1000" max="600000" step="1000" placeholder="60000"><i>ms</i></span>
|
||||
</label>
|
||||
<label class="mpe-line"><span>工具暴露</span>
|
||||
<select id="mce-mode">
|
||||
<option value="advertise">advertise(下发给模型)</option>
|
||||
<option value="skill">skill(以技能形式暴露)</option>
|
||||
<option value="disable">disable(不加载)</option>
|
||||
</select>
|
||||
</label>
|
||||
</div>
|
||||
<label class="mpe-field">工具暴露
|
||||
<select id="mce-mode">
|
||||
<option value="advertise">advertise(下发给模型)</option>
|
||||
<option value="skill">skill(以技能形式暴露)</option>
|
||||
<option value="disable">disable(不加载)</option>
|
||||
</select>
|
||||
</label>
|
||||
<div class="btn-row mpe-foot">
|
||||
<button class="ghost-btn danger hidden" id="mce-del-btn" onclick="mcpUI.del()">删除服务</button>
|
||||
<button class="primary-btn" onclick="mcpUI.save()">保存</button>
|
||||
</div>
|
||||
<div class="cfg-note">仅写入配置,点击「重启服务」后生效。</div>
|
||||
</div>
|
||||
</div>
|
||||
|
||||
@@ -361,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">
|
||||
@@ -394,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>
|
||||
@@ -410,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">
|
||||
@@ -430,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>
|
||||
@@ -440,32 +577,38 @@
|
||||
<div id="toast" class="hidden"></div>
|
||||
</div>
|
||||
|
||||
<!-- 图片全屏查看器(点击消息/工具卡中图片打开;双指缩放、放大后可拖动) -->
|
||||
<!-- 图片全屏查看器(点击消息/工具卡中图片打开;双指缩放、放大后可拖动;同组多图可左右滑动切换) -->
|
||||
<div id="img-viewer" class="hidden">
|
||||
<button class="fs-close" onclick="closeImageViewer()">✕</button>
|
||||
<img id="img-viewer-img" alt="">
|
||||
<!-- 组内页码(如 2 / 5):仅同组多图时显示 -->
|
||||
<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>
|
||||
@@ -476,11 +619,20 @@
|
||||
|
||||
<!-- 消息全屏查看器(双击气泡/工具卡打开;支持双指缩放) -->
|
||||
<div id="fs-viewer" class="hidden" onclick="if(event.target===this)closeFullscreen()">
|
||||
<button class="fs-close" onclick="closeFullscreen()">✕</button>
|
||||
<!-- 源码切换钮:仅当当前内容有源文本时显隐(toggleFsSrc 在渲染视图/源码面板间互切) -->
|
||||
<button class="fs-close fs-eye 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>
|
||||
</button>
|
||||
<!-- 顶部操作区:文件预览(fs-bar 模式)时独立成一行,内容从行下开始,不遮挡页面自己的顶部按钮;
|
||||
消息全屏时退化为右上角悬浮按钮簇。文件名仅栏模式显示。 -->
|
||||
<div class="fs-actions">
|
||||
<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"><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"><use href="#i-copy"/></svg>
|
||||
</button>
|
||||
<button class="fs-btn" onclick="closeFullscreen()" title="关闭" aria-label="关闭">✕</button>
|
||||
</div>
|
||||
<div class="fs-panel" id="fs-body"></div>
|
||||
<div class="fs-panel fs-src-panel hidden" id="fs-src-pane"><pre id="fs-src-code"></pre></div>
|
||||
</div>
|
||||
@@ -488,28 +640,32 @@
|
||||
<!-- 拖拽上传提示层: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>
|
||||
|
||||
<script src="/js/viewport.js"></script>
|
||||
<script src="/js/core.js"></script>
|
||||
<script src="/js/chat.js"></script>
|
||||
<script src="/js/sessions.js"></script>
|
||||
<script src="/js/stream.js"></script>
|
||||
<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/ 脚本增减时需同步改这里的期望数 7。
|
||||
// 注意:js/ 脚本增减时需同步改这里的期望数 10。
|
||||
(function () {
|
||||
var ok = false;
|
||||
try {
|
||||
var n = document.querySelectorAll('script[src^="/js/"]').length;
|
||||
ok = n === 7 && 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 };
|
||||
}
|
||||
|
||||
@@ -412,6 +445,8 @@
|
||||
state.status = (s && s.status) || '';
|
||||
state.modelId = (s && s.model_id) || ''; // 顶部动作区展示当前模型
|
||||
state.schedule = detail.schedule || null; // 定时任务数据(顶部动作区副标题)
|
||||
state.pending = Array.isArray(detail.pending) ? detail.pending : []; // 待投递队列(服务端内存态回显)
|
||||
renderSendQueue();
|
||||
renderHeader();
|
||||
updateHeaderActions();
|
||||
|
||||
@@ -429,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;
|
||||
@@ -499,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: '', // 当前会话标题
|
||||
@@ -170,6 +176,7 @@
|
||||
schedule: null, // 当前会话定时任务(详情 schedule 字段,null=无)
|
||||
sessions: [], // 抽屉列表缓存
|
||||
attachments: [], // 待发送附件 {file, name, size}
|
||||
pending: [], // 待投递消息队列(服务端内存态的回显):{id, content, mode, created_at}
|
||||
editingMsgId: 0, // 正在编辑的历史消息 id(0=普通发送,覆盖式重发)
|
||||
lastImgBlobUrl: null, // 任务文件图片预览的 blob URL,下次预览或开新图时回收
|
||||
lastPdfBlobUrl: null, // 同上:PDF 页内预览的 blob URL(浏览器内建查看器用)
|
||||
@@ -207,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';
|
||||
@@ -217,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,保持纯服务器行为 */ });
|
||||
})();
|
||||
})();
|
||||
+106
-83
@@ -30,11 +30,13 @@
|
||||
send();
|
||||
}
|
||||
});
|
||||
// 发送键双职:生成中且输入框为空时变「停止」(白色方块),点击终止当前回合;
|
||||
// 输入框有字时它仍是「发送」——运行中允许插话,直接发出去(后端 live 追投)。
|
||||
// 发送键四职:语音 / 键盘(语音模式)/ 停止 / 发送,由 data-state 决定点击含义。
|
||||
// 400ms 内重复点击忽略:防双击重复 abort(服务端 status 事件回来前按钮仍是停止态)。
|
||||
let stopClickAt = 0;
|
||||
$('send-btn').addEventListener('click', () => {
|
||||
const st = $('send-btn').dataset.state;
|
||||
if (st === 'voice' && window.AgentVoice) { window.AgentVoice.enter(); return; }
|
||||
if (st === 'keyboard' && window.AgentVoice) { window.AgentVoice.exit(true); return; }
|
||||
if (stopModeActive()) {
|
||||
if (Date.now() - stopClickAt < 400) return;
|
||||
stopClickAt = Date.now();
|
||||
@@ -47,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
|
||||
});
|
||||
|
||||
// ---------- 任务文件面板(底部浮层:点输入行右侧文件夹按钮展开,遮罩盖住输入区) ----------
|
||||
@@ -157,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) : [];
|
||||
}
|
||||
// 全选的作用域 = 当前浏览目录下的全部文件(递归含其子文件夹,等价于逐个勾选这些文件夹行)。
|
||||
// 不能再用全任务树的扁平列表:在子文件夹里点全选会把根下其它文件也选上,批量删除会清空整个任务目录。
|
||||
@@ -296,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) {
|
||||
@@ -328,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>' +
|
||||
@@ -345,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,点任意节点回跳)+ 单层列表(目录在前、文件在后)。
|
||||
@@ -379,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>';
|
||||
@@ -418,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();
|
||||
@@ -542,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');
|
||||
@@ -593,8 +574,7 @@
|
||||
const c = e.target.closest('.crumb[data-path]');
|
||||
if (!c) return;
|
||||
filesCurDir = c.dataset.path;
|
||||
renderFilesDir();
|
||||
updateFilesFooter(); // 同上:面包屑回跳也重算全选态
|
||||
loadFiles(); // 同上:面包屑回跳也按目录重拉
|
||||
});
|
||||
|
||||
// 彩蛋:点面板标题旁的总大小文本 = 切换隐藏文件(dot 项含 .tmp/.venv)显隐。
|
||||
@@ -664,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);
|
||||
@@ -773,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');
|
||||
@@ -789,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');
|
||||
@@ -908,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;
|
||||
@@ -1055,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 => {
|
||||
@@ -1089,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); // 桌面端侧栏常驻,选完会话不收起来
|
||||
});
|
||||
@@ -1227,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);
|
||||
}
|
||||
+381
-67
@@ -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';
|
||||
@@ -35,15 +103,81 @@ function pvKind(name) {
|
||||
return 'none';
|
||||
}
|
||||
|
||||
// 文件面板「当前目录」里的图片作为一组,供查看器左右滑动切换。
|
||||
// 同组直接用预览派生直链(2048px),不必逐张取原图/blob,滑动的预取也不会打满带宽。
|
||||
// 依赖 files.js 的 filesNodeAt / filesCurDir(同为全局,加载顺序在前)。
|
||||
function pvImgGroup(name) {
|
||||
try {
|
||||
if (typeof filesNodeAt !== 'function') return null;
|
||||
const node = filesNodeAt(typeof filesCurDir === 'string' ? filesCurDir : '');
|
||||
if (!node) return null;
|
||||
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: pvPreviewUrl(p, 2048), alt: p.split('/').pop() })),
|
||||
at: paths.indexOf(name),
|
||||
};
|
||||
} catch (_) { return null; }
|
||||
}
|
||||
|
||||
// 刷新/新窗口两个钮对**所有**预览类型统一开放:
|
||||
// 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 (_) {}
|
||||
});
|
||||
}
|
||||
|
||||
// 每次展示内容都过一遍:标题显示相对路径(子目录可见),右上角下载钮随文件走
|
||||
@@ -59,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; }
|
||||
}
|
||||
|
||||
@@ -73,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 : '';
|
||||
@@ -87,32 +225,43 @@ 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 并展开
|
||||
function pvOverlayShow(node) {
|
||||
// opts.bar → 文件预览沉浸模式:顶部独立操作条,内容全宽占满剩余空间
|
||||
// opts.name → 操作条左侧的文件名(仅 bar 模式可见)
|
||||
// opts.source → 源文本,交给 eye / 复制钮(未传则两者隐藏)
|
||||
function pvOverlayShow(node, opts) {
|
||||
opts = opts || {};
|
||||
const viewer = document.getElementById('fs-viewer');
|
||||
const body = document.getElementById('fs-body');
|
||||
viewer.classList.toggle('fs-bar', !!opts.bar);
|
||||
const nm = document.getElementById('fs-file-name');
|
||||
nm.textContent = opts.name ? String(opts.name) : '';
|
||||
nm.title = nm.textContent;
|
||||
body.innerHTML = ''; body.style.zoom = '';
|
||||
if (typeof setFsSource === 'function') setFsSource(null);
|
||||
if (typeof setFsSource === 'function') setFsSource(opts.source == null ? null : opts.source);
|
||||
body.appendChild(node);
|
||||
document.getElementById('fs-viewer').classList.remove('hidden');
|
||||
viewer.classList.remove('hidden');
|
||||
}
|
||||
|
||||
// ---------- office:iframe 直挂预览网关(HEAD 预探顺便触发冷槽复活) ----------
|
||||
@@ -128,15 +277,23 @@ async function pvOpenOffice(name, sizeText) {
|
||||
document.getElementById('pv-body').appendChild(load); // 开窗即刻可见,冷启动转圈等首帧
|
||||
} else {
|
||||
load = pvLoadingBox(); load.classList.add('inline');
|
||||
pvOverlayShow(load);
|
||||
pvOverlayShow(load, { bar: true, name: name });
|
||||
if (!pvState.mobilePush) { try { history.pushState({ pvOffice: 1 }, ''); pvState.mobilePush = true; } catch (_) {} }
|
||||
}
|
||||
let head = null;
|
||||
try { head = await fetch(url, { method: 'HEAD' }); } catch (_) {}
|
||||
if (my !== pvSeq) return;
|
||||
// 404 = 预览服务里没有这份文档。文件可能正被 AI 的写盘链路整体替换(rename 瞬间找不到),
|
||||
// 探针给一次短重试再落占位卡——比让用户自己反复点刷新更接近「多刷几次就出来了」的实情。
|
||||
if (head && head.status === 404) {
|
||||
await new Promise((r) => setTimeout(r, 600));
|
||||
if (my !== pvSeq) return;
|
||||
try { head = await fetch(url, { method: 'HEAD' }); } catch (_) {}
|
||||
if (my !== pvSeq) return;
|
||||
}
|
||||
const missing = head && head.status === 404;
|
||||
if (missing) {
|
||||
const node = pvInfoNode(name, sizeText, '预览服务中暂无这份文档 —— 只有 AI 在本任务中生成/编辑过的文档才能在线预览(较旧的文档可能已被自动清理)。');
|
||||
const node = pvInfoNode(name, sizeText, '预览服务中暂无这份文档 —— 文件可能已被删除、改名,或不在本任务目录下。');
|
||||
if (desk) {
|
||||
// pvClearBody 会清掉 reload/url:占位卡仍要保留刷新/新窗口,否则按钮可见但点了没反应
|
||||
pvClearBody(); document.getElementById('pv-body').appendChild(node);
|
||||
@@ -154,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:给占位卡,不再自动下载
|
||||
@@ -175,11 +379,14 @@ 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);
|
||||
} else pvOverlayShow(node, { bar: true, name: name });
|
||||
};
|
||||
if (kind === 'none') {
|
||||
const low = String(name).toLowerCase();
|
||||
@@ -189,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));
|
||||
@@ -206,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;
|
||||
@@ -221,11 +464,16 @@ 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);
|
||||
im.addEventListener('click', () => openImageViewer(u, String(name).split('/').pop()));
|
||||
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 });
|
||||
} else { // text/md/代码/json/csv
|
||||
node = await pvTextNode(name, sizeText, r);
|
||||
@@ -249,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();
|
||||
@@ -278,41 +574,29 @@ 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;
|
||||
}
|
||||
|
||||
// 移动端非 office:保持原全屏行为(#fs-viewer)
|
||||
// 移动端非 office:统一走 #fs-viewer 沉浸式(顶部操作条 + 全宽内容)
|
||||
async function pvRenderLegacy(name, r, my) {
|
||||
if (/\.html?$/i.test(name)) {
|
||||
const html = await r.text();
|
||||
@@ -320,10 +604,10 @@ async function pvRenderLegacy(name, r, my) {
|
||||
iframe.className = 'fs-html-frame';
|
||||
iframe.setAttribute('sandbox', 'allow-same-origin allow-scripts');
|
||||
iframe.srcdoc = rewriteHtmlDocSrcs(html, name);
|
||||
pvOverlayShow(iframe);
|
||||
setFsSource(html); // 源码钮可看页面原码
|
||||
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;
|
||||
@@ -331,28 +615,41 @@ async function pvRenderLegacy(name, r, my) {
|
||||
frame.className = 'fs-html-frame';
|
||||
frame.title = name;
|
||||
frame.src = u;
|
||||
pvOverlayShow(frame);
|
||||
pvOverlayShow(frame, { bar: true, name: name });
|
||||
} else if (/\.svg$/i.test(name)) {
|
||||
// SVG 当图片显示(<img> 不执行内嵌脚本),同时保留源码给 eye/复制钮
|
||||
const text = await r.text();
|
||||
const u = URL.createObjectURL(new Blob([text], { type: 'image/svg+xml;charset=utf-8' }));
|
||||
if (state.lastImgBlobUrl) { try { URL.revokeObjectURL(state.lastImgBlobUrl); } catch (_) {} }
|
||||
state.lastImgBlobUrl = u;
|
||||
const im = document.createElement('img');
|
||||
im.className = 'fs-img-frame'; im.src = u; im.alt = String(name);
|
||||
im.addEventListener('click', () => openImageViewer(u, String(name).split('/').pop()));
|
||||
pvOverlayShow(im, { bar: true, name: name, source: text });
|
||||
} else if (PV_IMG.test(name)) {
|
||||
const u = URL.createObjectURL(await r.blob());
|
||||
if (state.lastImgBlobUrl) { try { URL.revokeObjectURL(state.lastImgBlobUrl); } catch (_) {} }
|
||||
state.lastImgBlobUrl = u;
|
||||
openImageViewer(u, name);
|
||||
const g = pvImgGroup(name);
|
||||
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);
|
||||
openFullscreen(wrap.firstChild, text); // 文件原文供 eye 钮看源码
|
||||
pvHighlightMdCode(wrap);
|
||||
pvOverlayShow(wrap.firstChild, { bar: true, name: name, source: text }); // 全宽沉浸,eye/复制看原文
|
||||
}
|
||||
}
|
||||
|
||||
@@ -373,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');
|
||||
@@ -384,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),零请求 ----------
|
||||
@@ -473,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);
|
||||
@@ -498,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);
|
||||
@@ -526,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,7 +81,10 @@
|
||||
state.sessionId = null;
|
||||
state.sessionTitle = '';
|
||||
state.sessionType = 'secretary';
|
||||
if (window.refreshFileTree) window.refreshFileTree();
|
||||
state.pendingModel = '';
|
||||
state.pending = [];
|
||||
renderSendQueue();
|
||||
state.streamEl = null;
|
||||
state.streamText = '';
|
||||
state.toolCards = {};
|
||||
@@ -87,9 +93,9 @@
|
||||
state.renderedSigs = {};
|
||||
state.streaming = false;
|
||||
if (typeof clearEditState === 'function') clearEditState();
|
||||
syncUrl();
|
||||
setView('welcome'); // 复用 newChat 同样的视图切换路径
|
||||
}
|
||||
toast('已删除会话');
|
||||
loadSessionList();
|
||||
} catch (e) { toast('删除失败:' + e.message); }
|
||||
}
|
||||
@@ -117,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(() => {
|
||||
@@ -181,15 +189,38 @@
|
||||
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 = '';
|
||||
state.schedule = null; // 防详情返回前残留上一会话的任务状态
|
||||
state.pending = []; // 同上:队列是会话级的,先清空,详情回来再回显
|
||||
renderSendQueue();
|
||||
// 先从抽屉列表缓存取会话类型,让顶部 icon 立即正确;详情回来后由 renderDetail 纠正
|
||||
const cached = (state.sessions || []).find(x => x.id === id);
|
||||
state.sessionType = (cached && cached.assistant_type) || 'secretary';
|
||||
@@ -211,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'); // 会话已被删/链接失效:别把「加载中…」留在屏幕上(同时把顶部按钮置灰)
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
@@ -227,30 +271,81 @@
|
||||
// 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;
|
||||
state.pending = [];
|
||||
renderSendQueue();
|
||||
state.pendingModel = '';
|
||||
state.attachments = [];
|
||||
pendingWorkDir = ''; // 新建会话把上次手选的工作目录也归零(回到默认)
|
||||
renderWelcomeDir();
|
||||
if (typeof clearEditState === 'function') clearEditState();
|
||||
state.streamEl = null;
|
||||
state.streamText = '';
|
||||
@@ -262,6 +357,8 @@
|
||||
userPaused = false;
|
||||
renderAttachChips();
|
||||
clearUploadCards();
|
||||
renderDrawerList(); // sessionId 已置空,重画抽屉把旧会话的选中态清掉
|
||||
syncUrl();
|
||||
setView('welcome');
|
||||
$('chat-view').innerHTML = '';
|
||||
$('msg-input').value = '';
|
||||
@@ -279,7 +376,6 @@
|
||||
const title = String(t).trim();
|
||||
try {
|
||||
await req('PATCH', '/api/sessions/' + state.sessionId, { title: title });
|
||||
toast('已重命名');
|
||||
state.sessionTitle = title;
|
||||
renderHeader();
|
||||
loadSessionList();
|
||||
@@ -300,13 +396,26 @@
|
||||
// 有附件时按钮保持「发送」:粘贴长文本转成的附件不应被当成停止操作
|
||||
return state.status === 'active' && !(($('msg-input') || {}).value || '').trim() && !state.attachments.length;
|
||||
}
|
||||
// 发送键四态:停止 / 键盘(语音模式)/ 语音(空输入且支持录音)/ 发送。
|
||||
// 停止优先:生成中且输入框为空时,用户最可能想停止,不能被语音入口顶掉。
|
||||
// 语音与键盘两态由 voice.js 暴露的 window.AgentVoice 提供(脚本加载顺序在 sessions 之后,
|
||||
// 初始化阶段它还不存在,此处必须容错——那时按普通「发送」渲染即可)。
|
||||
function updateSendBtn() {
|
||||
const sb = $('send-btn');
|
||||
if (!sb) return;
|
||||
const stop = stopModeActive();
|
||||
sb.dataset.state = stop ? 'stop' : 'send';
|
||||
sb.title = stop ? '停止生成' : '发送';
|
||||
sb.setAttribute('aria-label', stop ? '停止生成' : '发送');
|
||||
const v = window.AgentVoice;
|
||||
const empty = !(($('msg-input') || {}).value || '').trim() && !state.attachments.length;
|
||||
let mode;
|
||||
if (stopModeActive()) mode = 'stop';
|
||||
else if (v && v.isVoiceMode()) mode = 'keyboard';
|
||||
else if (empty && v && v.isAvailable()) mode = 'voice';
|
||||
else mode = 'send';
|
||||
sb.dataset.state = mode;
|
||||
const label = mode === 'stop' ? '停止生成'
|
||||
: mode === 'keyboard' ? '切换到键盘输入'
|
||||
: mode === 'voice' ? '语音输入' : '发送';
|
||||
if (sb.title !== label) sb.title = label;
|
||||
if (sb.getAttribute('aria-label') !== label) sb.setAttribute('aria-label', label);
|
||||
}
|
||||
|
||||
function updateHeaderActions() {
|
||||
@@ -384,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 => {
|
||||
@@ -398,6 +536,7 @@
|
||||
if (!e.target.closest('#header-actions')) closeHeaderMenu();
|
||||
});
|
||||
document.addEventListener('keydown', e => { if (e.key === 'Escape') closeHeaderMenu(); });
|
||||
syncThemeBtns(); // 按钮图标/文字跟着当前主题落一次
|
||||
})();
|
||||
|
||||
// ---------- 定时任务(弹窗改频次/提示词;无任务时同一弹窗即新建) ----------
|
||||
@@ -535,13 +674,15 @@
|
||||
async function stopSession() {
|
||||
if (!state.sessionId) return;
|
||||
const held = state.status === 'held';
|
||||
const queued = (state.pending || []).length;
|
||||
try {
|
||||
if (held) {
|
||||
await req('POST', '/api/sessions/' + state.sessionId + '/release');
|
||||
toast('已断开');
|
||||
} else {
|
||||
await req('POST', '/api/sessions/' + state.sessionId + '/stop');
|
||||
toast('已发送终止指令');
|
||||
// 「停止」是全停:服务端会把待投递队列一并作废,这里明确告知,不让消息静静消失
|
||||
toast(queued ? '已终止,队列中 ' + queued + ' 条消息已取消' : '已发送终止指令');
|
||||
}
|
||||
} catch (e) { toast((held ? '断开失败:' : '终止失败:') + e.message); }
|
||||
}
|
||||
@@ -715,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;">' +
|
||||
|
||||
+550
-143
File diff suppressed because it is too large
Load Diff
+363
-52
@@ -19,7 +19,7 @@
|
||||
const content = ta.value.trim();
|
||||
const editingId = state.editingMsgId || 0;
|
||||
// 没有文字就不发(避免产生空消息);但只有附件时允许发送——粘贴长文本转成的 .txt 需要能单独发出。
|
||||
// 运行中也是这条规则:有字就发(后端 live 追投),没字又没附件时按钮本身是「停止」。
|
||||
// 运行中也是这条规则:有字就发,没字又没附件时按钮本身是「停止」。
|
||||
if (!content && !state.attachments.length) return;
|
||||
|
||||
const pending = state.attachments.slice();
|
||||
@@ -43,7 +43,10 @@
|
||||
const text = names.length
|
||||
? '用户上传了文件:' + names.join('、') + (content ? '\n\n' + content : '')
|
||||
: content;
|
||||
const body = { content: text, deepThink: !!state.deepThink };
|
||||
// 是否排队由**服务端**决定:Web 端一律交 delivery:'queue',回合在跑就进队列,
|
||||
// 没在跑就等价于立即发送(enqueueMessage 直接走 postUserMessage)。
|
||||
// 不用 state.status 判断——SSE 状态可能过期,误判成 live 会把 user 行插进工具批次中间。
|
||||
const body = { content: text, deepThink: !!state.deepThink, delivery: 'queue' };
|
||||
let sent;
|
||||
if (editingId) {
|
||||
// 覆盖式编辑:先撤掉本地该条及其后的渲染,再让服务端删除同范围历史并以新内容重开一轮
|
||||
@@ -56,7 +59,15 @@
|
||||
}
|
||||
clearUploadCards(); // 消息已发出(告知行已拼入正文),卡片使命完成清掉
|
||||
|
||||
appendUserMsg(text, atts.map(a => a.name), sent && sent.message_id);
|
||||
// 排队回执:条幅以服务端返回的队列为准(本端不画气泡,等真正落库的 user_message 再画);
|
||||
// 竞态下服务端发现回合已结束会直接送达(没有 queued 字段),那就照常当普通发送处理。
|
||||
const queued = !!(sent && sent.queued);
|
||||
if (queued) {
|
||||
state.pending = sent.pending || [];
|
||||
renderSendQueue();
|
||||
} else {
|
||||
appendUserMsg(text, atts.map(a => a.name), sent && sent.message_id);
|
||||
}
|
||||
// 标题取用户原文,不带文件告知行;纯附件发送时退回粘贴文本的前缀
|
||||
const seed = content || (pending[0] && pending[0].titleSeed) || '';
|
||||
if (!state.sessionTitle && seed) {
|
||||
@@ -65,7 +76,8 @@
|
||||
renderHeader();
|
||||
// 运行中插话:正文字流进行中已有一个气泡作「活着」的信号,不再挂打字占位
|
||||
//(刚挂上就会被下一个 delta 移除,只会闪一下);工具间隙里补上占位反而有用。
|
||||
if (!state.streaming) addTyping();
|
||||
// 排队时本回合没有任何新动静,不挂占位。
|
||||
if (!queued && !state.streaming) addTyping();
|
||||
loadSessionList();
|
||||
} catch (e) {
|
||||
// 发送失败:附件还原+草稿文本回填(发送前已清空输入框,挂起/失败不能让文字蒸发),
|
||||
@@ -83,6 +95,79 @@
|
||||
}
|
||||
}
|
||||
|
||||
// ---------- 待发送条幅 ----------
|
||||
// 队列本身在服务端(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);
|
||||
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>'
|
||||
: (i === 0 ? '' : '<span class="sq-tag">排队中</span>');
|
||||
const acts = (i === 0 && !busy)
|
||||
? '<button data-act="interject" title="当前工具调用结束后立即插话">干预</button>' +
|
||||
'<button data-act="now" title="终止本轮工具调用并立即发送">立即发送</button>'
|
||||
: '';
|
||||
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-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;
|
||||
const item = btn.closest('.sq-item');
|
||||
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 = isDel ? await req('DELETE', base) : await req('POST', base, { action: act });
|
||||
if (r && Array.isArray(r.pending)) { state.pending = r.pending; renderSendQueue(); }
|
||||
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);
|
||||
|
||||
// ---------- SSE 流 ----------
|
||||
// 助手消息流式容器:首个 delta 到达时创建,同时为思考面板预留挂载点
|
||||
function ensureStreamWrap() {
|
||||
@@ -97,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);
|
||||
@@ -113,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'); }
|
||||
@@ -138,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();
|
||||
});
|
||||
@@ -158,12 +255,15 @@
|
||||
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 => {
|
||||
const d = JSON.parse(ev.data);
|
||||
state.status = d.status;
|
||||
if (d.model_id) state.modelId = d.model_id;
|
||||
// 待投递队列以服务端为准(重连/换标签页后条幅能自动回到真实状态)
|
||||
if (Array.isArray(d.pending)) { state.pending = d.pending; renderSendQueue(); }
|
||||
renderHeader();
|
||||
updateHeaderActions();
|
||||
updateScrollBottomBtn(); // 状态切换同步右下角转圈(开始/结束干活)
|
||||
@@ -225,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();
|
||||
@@ -238,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');
|
||||
@@ -327,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);
|
||||
@@ -348,8 +455,33 @@
|
||||
es.addEventListener('auto_compress', ev => {
|
||||
proposeAutoCompress(JSON.parse(ev.data));
|
||||
});
|
||||
// 待发送条幅:新入队 / 升级(同 id upsert)
|
||||
es.addEventListener('pending_added', ev => {
|
||||
const d = JSON.parse(ev.data);
|
||||
if (!d || !d.id) return;
|
||||
const list = state.pending.slice();
|
||||
const i = list.findIndex(x => x.id === d.id);
|
||||
if (i >= 0) list[i] = d; else list.push(d);
|
||||
state.pending = list;
|
||||
renderSendQueue();
|
||||
});
|
||||
// 出队(已送达 / 被取消 / 停止时整体清空)
|
||||
es.addEventListener('pending_removed', ev => {
|
||||
const d = JSON.parse(ev.data);
|
||||
state.pending = state.pending.filter(x => x.id !== (d && d.id));
|
||||
renderSendQueue();
|
||||
});
|
||||
// 排队消息真正落库:这一刻它才成为历史,画进聊天区(排队期间不画)
|
||||
es.addEventListener('user_message', ev => {
|
||||
const d = JSON.parse(ev.data);
|
||||
if (!d || !d.id || state.renderedSigs[d.id]) return; // 防重(重连补拉/多标签页)
|
||||
appendUserMsg(d.content, null, d.id);
|
||||
removeTyping();
|
||||
});
|
||||
es.addEventListener('done', ev => {
|
||||
removeTyping(); // 本轮结束,占位亦终止(如模型报错无回复)
|
||||
let doneStatus = '';
|
||||
try { doneStatus = (JSON.parse(ev.data) || {}).status || ''; } catch (_) { /* 无 data 的连接层错误 */ }
|
||||
// 压缩回合异常结束的兜底(模型报错回合直接 break / 被终止 → 不会有带 is_summary 的最终消息):
|
||||
// 复位等待状态并还原压缩按钮,历史保持原样不动。
|
||||
if (state.pendingSummary) {
|
||||
@@ -364,15 +496,28 @@
|
||||
state.streamWrap = null;
|
||||
state.streamReasoning = '';
|
||||
state.streamThinkEl = null;
|
||||
// 异常收尾兜底:把参数未流完的早卡就地回填收尾,避免占位态永远呼吸
|
||||
// 异常收尾兜底:把参数未流完的早卡就地回填收尾,避免占位态永远呼吸。
|
||||
// 被「立即发送/停止」硬中断时,这些调用根本没落库、不会再有回执,
|
||||
// 结果区要明确写「已取消」,否则卡片永远停在「执行中…」。
|
||||
for (const sid of Object.keys(state.toolCallStreaming)) {
|
||||
const stg = state.toolCallStreaming[sid];
|
||||
finalizeToolCardArgs(sid, stg.name, stg.args);
|
||||
const card = state.toolCards[sid];
|
||||
const pre = card && card.querySelector('.tool-result');
|
||||
if (pre && pre.textContent === '执行中…') {
|
||||
card.classList.add('error');
|
||||
const spin = card.querySelector('.spin');
|
||||
if (spin) spin.textContent = '⏹';
|
||||
pre.textContent = doneStatus === 'cancelled' ? '已取消(本轮被终止,未执行)' : '本轮已结束,未收到结果';
|
||||
}
|
||||
}
|
||||
state.toolCards = {};
|
||||
state.toolCallStreaming = {}; // 流式参数早卡映射随会话/回合重置
|
||||
updateScrollBottomBtn();
|
||||
loadSessionList();
|
||||
// 一轮完整跑完(agent 循环退出才发 done):工具/技能产物可能新增或改名,文件树就地刷新;
|
||||
// 不在文件树面板时 reloadFileTree 只标脏,等切回去再重拉
|
||||
if (typeof window.reloadFileTree === 'function') window.reloadFileTree();
|
||||
});
|
||||
// 服务端首次交互后自动生成的标题(finalize 后约 1s 到达):即时刷新顶栏 + 重拉会话列表(PC 常驻侧边栏/移动抽屉)
|
||||
es.addEventListener('title', ev => {
|
||||
@@ -417,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);
|
||||
@@ -438,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);
|
||||
@@ -527,6 +671,8 @@
|
||||
btn.classList.remove('on');
|
||||
btn.title = '显示源码';
|
||||
btn.setAttribute('aria-label', '显示源码');
|
||||
// 复制钮与 eye 同显隐:有源码才可复制
|
||||
$('fs-copy-btn').classList.toggle('hidden', fsSrcText == null);
|
||||
}
|
||||
function toggleFsSrc() {
|
||||
if (fsSrcText == null) return;
|
||||
@@ -541,8 +687,15 @@
|
||||
btn.setAttribute('aria-label', lbl);
|
||||
}
|
||||
$('fs-src-btn').addEventListener('click', toggleFsSrc);
|
||||
// 复制源码:HTML/SVG/MD/代码通用,拿到的就是 eye 面板里那份文本
|
||||
$('fs-copy-btn').addEventListener('click', async () => {
|
||||
if (fsSrcText == null) return;
|
||||
const ok = await copyText(fsSrcText);
|
||||
toast(ok ? '已复制' : '复制失败');
|
||||
});
|
||||
|
||||
function openFullscreen(el, src) {
|
||||
$('fs-viewer').classList.remove('fs-bar'); // 消息全屏沿用悬浮按钮,清掉文件预览的栏模式
|
||||
const body = $('fs-body');
|
||||
body.innerHTML = '';
|
||||
body.style.zoom = '';
|
||||
@@ -566,6 +719,7 @@
|
||||
}
|
||||
function closeFullscreen() {
|
||||
setFsSource(null); // 顺手收起源码面板/隐藏 eye 钮,下轮打开不残留
|
||||
$('fs-viewer').classList.remove('fs-bar');
|
||||
$('fs-viewer').classList.add('hidden');
|
||||
$('fs-viewer').dispatchEvent(new Event('fs:close'));
|
||||
}
|
||||
@@ -580,67 +734,224 @@
|
||||
});
|
||||
|
||||
// 点击消息/工具卡里的图片 → 图片全屏查看器(#fs-viewer 里的克隆图也生效)
|
||||
// 同一气泡/工具卡内的图作为一组,查看器里可左右滑动切换
|
||||
function imgViewerDelegate(e) {
|
||||
const im = e.target.closest('.bubble-ai img, .bubble-user img, .tool-card img');
|
||||
if (im && im.src) openImageViewer(im.src, im.alt || '');
|
||||
if (!im || !im.src) return;
|
||||
const box = im.closest('.msg') || im.closest('.tool-card') || $('fs-body');
|
||||
const list = Array.prototype.map.call(box.querySelectorAll('img'), x => ({ src: x.src, alt: x.alt || '' }))
|
||||
.filter(x => x.src);
|
||||
openImageViewer(im.src, im.alt || '', list);
|
||||
}
|
||||
$('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 做真正的分页位移(旧图跟手滑出、新图同步滑入),并在开图时预取相邻图,
|
||||
// 避免「松手→瞬移复位→闪白→图才下载出来」这三连卡顿。
|
||||
let openImageViewer, closeImageViewer;
|
||||
(function () {
|
||||
const viewer = document.getElementById('img-viewer');
|
||||
const img = document.getElementById('img-viewer-img');
|
||||
// 第二层由脚本建(不写进 HTML):旧版缓存的 HTML 里没有它也不会把查看器搞挂
|
||||
const img2 = document.createElement('img');
|
||||
img2.className = 'hidden'; img2.alt = '';
|
||||
viewer.appendChild(img2);
|
||||
const count = document.getElementById('img-count');
|
||||
let cur = img, other = img2; // cur=当前层;other=滑动时接替的层
|
||||
let scale = 1, tx = 0, ty = 0, mode = null;
|
||||
let sx = 0, sy = 0, stx = 0, sty = 0, pDist = 0, pScale = 1;
|
||||
// gallery=当前组;gi=组内下标;wx/wy/wdx=横滑起点与实时位移;dragDir/pending=本次拖动方向与待接替下标
|
||||
let gallery = [], gi = 0, wx = 0, wy = 0, wdx = 0, dragDir = 0, pending = -1;
|
||||
const preloads = new Map(); // src → Image:提前下载并解码,切图时不再等网络
|
||||
let settleTimer = 0;
|
||||
const tdist = t => Math.hypot(t[0].clientX - t[1].clientX, t[0].clientY - t[1].clientY);
|
||||
const W = () => window.innerWidth;
|
||||
function apply() {
|
||||
img.style.transform = 'translate(' + tx + 'px,' + ty + 'px) scale(' + scale + ')';
|
||||
img.style.cursor = scale > 1 ? 'grab' : 'zoom-in';
|
||||
cur.style.transition = 'none'; // 缩放/拖动要跟手,不能被上一段滑动动画的过渡拖着走
|
||||
cur.style.transform = 'translate(' + tx + 'px,' + ty + 'px) scale(' + scale + ')';
|
||||
cur.style.cursor = scale > 1 ? 'grab' : 'zoom-in';
|
||||
}
|
||||
openImageViewer = function (src, alt) {
|
||||
scale = 1; tx = ty = 0; mode = null;
|
||||
function drawCount() {
|
||||
if (!count) return; // 旧版 HTML 缓存里没有计数节点时不报错
|
||||
const on = gallery.length > 1;
|
||||
count.textContent = on ? (gi + 1) + ' / ' + gallery.length : '';
|
||||
count.classList.toggle('hidden', !on);
|
||||
}
|
||||
// 预取相邻图:Image 对象常驻,解码结果留在内存里,滑过去就是现成的
|
||||
function preload(src) {
|
||||
if (!src || preloads.has(src) || /^(data|blob):/i.test(src)) return;
|
||||
const im = new Image();
|
||||
im.decoding = 'async';
|
||||
im.src = src;
|
||||
preloads.set(src, im);
|
||||
}
|
||||
function prefetchAround() {
|
||||
[gi + 1, gi + 2, gi - 1].forEach(i => { if (gallery[i]) preload(gallery[i].src); });
|
||||
}
|
||||
// 把某层摆到「相对屏幕中心偏移 offset 像素」处(1x、无过渡)
|
||||
function place(el, offset) {
|
||||
el.style.transition = 'none';
|
||||
el.style.transform = 'translate(' + offset + 'px,0) scale(1)';
|
||||
}
|
||||
function showLayer(el, item) {
|
||||
el.src = item.src; el.alt = item.alt || '';
|
||||
el.classList.remove('hidden');
|
||||
}
|
||||
// 动画收尾:旧层收起、两层归位(滑到一半又开始新手势时也靠它清场)
|
||||
function finishSettle() {
|
||||
clearTimeout(settleTimer); settleTimer = 0;
|
||||
other.classList.add('hidden');
|
||||
place(other, 0); place(cur, 0);
|
||||
apply();
|
||||
img.src = src; img.alt = alt || '';
|
||||
prefetchAround();
|
||||
}
|
||||
// 滑到第 i 张(dir=+1 从右侧进,-1 从左侧进);已到边界就弹回
|
||||
function slideTo(i, dir) {
|
||||
if (settleTimer) finishSettle(); // 上一张还在动画里(连点方向键):先收尾,避免接替层被瞬移
|
||||
const t = Math.max(0, Math.min(gallery.length - 1, i));
|
||||
if (t === gi) return settleBack(dir);
|
||||
const from = cur, to = other;
|
||||
if (pending !== t) { place(to, dir * W()); showLayer(to, gallery[t]); }
|
||||
void to.offsetWidth; // 先把起点落位再加过渡,否则首帧会被合并成瞬移
|
||||
const ease = 'transform .2s cubic-bezier(.22,.61,.36,1)';
|
||||
from.style.transition = ease; to.style.transition = ease;
|
||||
from.style.transform = 'translate(' + (-dir * W()) + 'px,0) scale(1)';
|
||||
to.style.transform = 'translate(0,0) scale(1)';
|
||||
cur = to; other = from;
|
||||
gi = t; scale = 1; tx = ty = 0; dragDir = 0; pending = -1;
|
||||
drawCount();
|
||||
settleTimer = setTimeout(finishSettle, 220);
|
||||
}
|
||||
// 没过阈值/到边界:当前层弹回原位,接替层退回屏幕外
|
||||
function settleBack(dir) {
|
||||
const ease = 'transform .2s ease-out';
|
||||
cur.style.transition = ease;
|
||||
cur.style.transform = 'translate(0,0) scale(1)';
|
||||
if (dir && !other.classList.contains('hidden')) {
|
||||
other.style.transition = ease;
|
||||
other.style.transform = 'translate(' + dir * W() + 'px,0) scale(1)';
|
||||
}
|
||||
scale = 1; tx = ty = 0; dragDir = 0; pending = -1;
|
||||
settleTimer = setTimeout(finishSettle, 220);
|
||||
}
|
||||
openImageViewer = function (src, alt, list, at) {
|
||||
const raw = Array.isArray(list) && list.length ? list : [{ src: src, alt: alt }];
|
||||
gallery = raw.map(x => (typeof x === 'string' ? { src: x, alt: '' } : x)).filter(x => x && x.src);
|
||||
// 起始下标优先用调用方给的(文件面板那张是 blob URL,与组里的直链对不上),否则按 src 匹配
|
||||
let i = typeof at === 'number' && at >= 0 ? at : gallery.findIndex(x => x.src === src);
|
||||
if (i < 0) i = 0;
|
||||
clearTimeout(settleTimer); settleTimer = 0;
|
||||
cur = img; other = img2;
|
||||
gi = i; scale = 1; tx = ty = 0; mode = null; dragDir = 0; pending = -1;
|
||||
other.classList.add('hidden'); place(other, 0);
|
||||
showLayer(cur, gallery[gi] || { src: src, alt: alt });
|
||||
place(cur, 0); apply();
|
||||
drawCount();
|
||||
viewer.classList.remove('hidden');
|
||||
prefetchAround(); // 开图即把前后两张拉下来,滑的时候是现成的
|
||||
};
|
||||
closeImageViewer = function () {
|
||||
viewer.classList.add('hidden');
|
||||
gallery = []; gi = 0; dragDir = 0; pending = -1;
|
||||
preloads.clear(); // 断开引用,解码位图随之释放
|
||||
drawCount();
|
||||
};
|
||||
closeImageViewer = function () { viewer.classList.add('hidden'); };
|
||||
// 点背景(非图片)关闭
|
||||
viewer.addEventListener('click', function (e) { if (e.target === viewer) closeImageViewer(); });
|
||||
img.addEventListener('dblclick', function () {
|
||||
scale = scale > 1 ? 1 : 2.5;
|
||||
if (scale === 1) { tx = ty = 0; }
|
||||
apply();
|
||||
});
|
||||
img.addEventListener('touchstart', function (e) {
|
||||
if (e.touches.length === 2) { mode = 'pinch'; pDist = tdist(e.touches) || 1; pScale = scale; }
|
||||
else if (e.touches.length === 1 && scale > 1) { mode = 'pan'; sx = e.touches[0].clientX; sy = e.touches[0].clientY; stx = tx; sty = ty; }
|
||||
else mode = null;
|
||||
}, { passive: true });
|
||||
img.addEventListener('touchmove', function (e) {
|
||||
if (mode === 'pinch' && e.touches.length >= 2) {
|
||||
e.preventDefault();
|
||||
scale = Math.min(6, Math.max(1, pScale * tdist(e.touches) / pDist));
|
||||
// 两层都要绑:切图后当前层会换成另一张 img,事件不能只挂在第一层上
|
||||
function bindLayer(el) {
|
||||
el.addEventListener('dblclick', function () {
|
||||
scale = scale > 1 ? 1 : 2.5;
|
||||
if (scale === 1) { tx = ty = 0; }
|
||||
apply();
|
||||
} else if (mode === 'pan' && e.touches.length === 1) {
|
||||
});
|
||||
el.addEventListener('touchstart', function (e) {
|
||||
if (settleTimer) finishSettle(); // 上一次滑动还没收尾:先清场再新手势
|
||||
if (e.touches.length === 2) { mode = 'pinch'; pDist = tdist(e.touches) || 1; pScale = scale; }
|
||||
else if (e.touches.length === 1 && scale > 1) { mode = 'pan'; sx = e.touches[0].clientX; sy = e.touches[0].clientY; stx = tx; sty = ty; }
|
||||
else if (e.touches.length === 1 && gallery.length > 1) { mode = 'swipe'; wx = e.touches[0].clientX; wy = e.touches[0].clientY; wdx = 0; dragDir = 0; pending = -1; }
|
||||
else mode = null;
|
||||
}, { passive: true });
|
||||
el.addEventListener('touchmove', function (e) {
|
||||
if (mode === 'pinch' && e.touches.length >= 2) {
|
||||
e.preventDefault();
|
||||
scale = Math.min(6, Math.max(1, pScale * tdist(e.touches) / pDist));
|
||||
if (scale === 1) { tx = ty = 0; }
|
||||
apply();
|
||||
} else if (mode === 'pan' && e.touches.length === 1) {
|
||||
e.preventDefault();
|
||||
tx = stx + e.touches[0].clientX - sx;
|
||||
ty = sty + e.touches[0].clientY - sy;
|
||||
apply();
|
||||
} else if (mode === 'swipe' && e.touches.length === 1) {
|
||||
const dx = e.touches[0].clientX - wx, dy = e.touches[0].clientY - wy;
|
||||
if (Math.abs(dx) <= Math.abs(dy)) return; // 竖直为主:不接管
|
||||
wdx = dx;
|
||||
const dir = dx < 0 ? 1 : -1; // 左滑看下一张
|
||||
if (dir !== dragDir) {
|
||||
dragDir = dir;
|
||||
const next = gallery[gi + dir];
|
||||
// 方向一确定就把相邻图摆到另一侧待命(已预取,几乎是现成的),跟手滑进来
|
||||
if (next) { pending = gi + dir; place(other, dir * W()); showLayer(other, next); }
|
||||
else { pending = -1; other.classList.add('hidden'); } // 到头了:没有下一张,只做橡皮筋
|
||||
}
|
||||
const off = pending >= 0 ? dx : dx * 0.35;
|
||||
cur.style.transition = 'none';
|
||||
cur.style.transform = 'translate(' + off + 'px,0) scale(1)';
|
||||
if (pending >= 0) {
|
||||
other.style.transition = 'none';
|
||||
other.style.transform = 'translate(' + (off + dragDir * W()) + 'px,0) scale(1)';
|
||||
}
|
||||
}
|
||||
}, { passive: false });
|
||||
el.addEventListener('touchend', function (e) {
|
||||
if (mode === 'swipe') {
|
||||
const dir = dragDir;
|
||||
if (pending >= 0 && Math.abs(wdx) > 45) slideTo(pending, dir);
|
||||
else settleBack(dir);
|
||||
mode = null;
|
||||
return;
|
||||
}
|
||||
if (e.touches.length < 2) { if (mode === 'pinch') mode = null; }
|
||||
if (!e.touches.length) mode = null;
|
||||
}, { passive: true });
|
||||
el.addEventListener('touchcancel', function () {
|
||||
if (mode === 'swipe') settleBack(dragDir);
|
||||
mode = null;
|
||||
}, { passive: true });
|
||||
// 桌面:放大后按住拖动平移
|
||||
el.addEventListener('mousedown', function (e) {
|
||||
if (scale <= 1) return;
|
||||
e.preventDefault();
|
||||
tx = stx + e.touches[0].clientX - sx;
|
||||
ty = sty + e.touches[0].clientY - sy;
|
||||
apply();
|
||||
}
|
||||
}, { passive: false });
|
||||
img.addEventListener('touchend', function (e) { if (e.touches.length < 2) { if (mode === 'pinch') mode = null; } if (!e.touches.length) mode = null; }, { passive: true });
|
||||
img.addEventListener('touchcancel', function () { mode = null; }, { passive: true });
|
||||
// 桌面:放大后按住拖动平移
|
||||
img.addEventListener('mousedown', function (e) {
|
||||
if (scale <= 1) return;
|
||||
e.preventDefault();
|
||||
const x0 = e.clientX, y0 = e.clientY, tx0 = tx, ty0 = ty;
|
||||
const mv = function (ev) { tx = tx0 + ev.clientX - x0; ty = ty0 + ev.clientY - y0; apply(); };
|
||||
const up = function () { window.removeEventListener('mousemove', mv); window.removeEventListener('mouseup', up); };
|
||||
window.addEventListener('mousemove', mv); window.addEventListener('mouseup', up);
|
||||
const x0 = e.clientX, y0 = e.clientY, tx0 = tx, ty0 = ty;
|
||||
const mv = function (ev) { tx = tx0 + ev.clientX - x0; ty = ty0 + ev.clientY - y0; apply(); };
|
||||
const up = function () { window.removeEventListener('mousemove', mv); window.removeEventListener('mouseup', up); };
|
||||
window.addEventListener('mousemove', mv); window.addEventListener('mouseup', up);
|
||||
});
|
||||
}
|
||||
bindLayer(img); bindLayer(img2);
|
||||
// 桌面没有滑动:组内多图时用 ←/→ 切换(单图不响应)
|
||||
document.addEventListener('keydown', function (e) {
|
||||
if (viewer.classList.contains('hidden') || gallery.length < 2) return;
|
||||
if (e.key === 'ArrowLeft') slideTo(gi - 1, -1);
|
||||
else if (e.key === 'ArrowRight') slideTo(gi + 1, 1);
|
||||
});
|
||||
})();
|
||||
|
||||
|
||||
@@ -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;
|
||||
})();
|
||||
@@ -0,0 +1,76 @@
|
||||
// 视口适配:软键盘高度 → CSS 变量 --kb-page(纯页面侧兜底,不依赖套壳 App 改代码)
|
||||
// ----------------------------------------------------------------------------
|
||||
// 症状:套壳 App(Android WebView / ArkWeb)开了 edge-to-edge 后,
|
||||
// 1) 顶部内容压在状态栏下面 —— 安卓 WebView 的 env(safe-area-inset-top) 只反映屏幕
|
||||
// 挖孔(display cutout),不含状态栏高度,基本恒为 0;壳不额外注入就顶不上去。
|
||||
// 这一条由壳注入 CSS 变量解决,见下方「注入约定」,本文件不处理。
|
||||
// 2) 键盘弹起、输入框被盖住 —— Chromium 默认 interactive-widget=resizes-visual,只缩
|
||||
// visual viewport,layout viewport 不动。本页是 height:100% 的固定 shell,footer 全靠
|
||||
// layout viewport 变矮才会被顶上来,于是原地不动被键盘压住(看起来像「没给键盘留位置」)。
|
||||
//
|
||||
// 本文件只解决第 2 条:用 visualViewport 与 innerHeight 的差值算出键盘实际占用的高度,
|
||||
// 写进 --kb-page;#app 按 --kb(= max(--kb-page, --kb-native))收缩,footer 自动落在键盘上沿。
|
||||
// 壳若已正确 resize(adjustResize / resizes-content 生效),innerHeight 会同步变矮,
|
||||
// 差值恒为 0,本逻辑自动失效,不会二次收缩。
|
||||
//
|
||||
// 注入约定(壳侧,loadUrl 之后或 WindowInsets 变化时):
|
||||
// document.documentElement.style.setProperty('--sat', '36px'); // 状态栏高度
|
||||
// document.documentElement.style.setProperty('--sab', '20px'); // 导航栏/手势条高度
|
||||
// document.documentElement.style.setProperty('--kb-native', '300px'); // IME 高度(可选)
|
||||
// --kb-native 用于「WebView 完全感知不到键盘」的情况(窗口不 resize、visualViewport 也不缩),
|
||||
// 此时本文件量不到任何东西,只能靠壳把 IME insets 报进来;页面与壳各写各的变量,互不覆盖。
|
||||
(function () {
|
||||
'use strict';
|
||||
|
||||
const root = document.documentElement;
|
||||
const vv = window.visualViewport;
|
||||
// 没有 visualViewport 的老 WebView:只剩 interactive-widget / 壳 resize 两条路
|
||||
if (!vv) return;
|
||||
|
||||
// 键盘判定阈值:地址栏/浏览器 UI 收起通常 < 60px,软键盘一般 > 150px,
|
||||
// 取 80 让两者之间留足余量,避免把浏览器 UI 收起误判成键盘。
|
||||
const KB_MIN = 80;
|
||||
// 贴底判定:与 chat.js 的 SCROLL_BOTTOM_THRESHOLD 同量级即可,不必严格一致
|
||||
const STICK_PX = 80;
|
||||
|
||||
let kb = 0;
|
||||
let raf = 0;
|
||||
|
||||
function nearBottom(box) {
|
||||
return box.scrollHeight - box.scrollTop - box.clientHeight < STICK_PX;
|
||||
}
|
||||
|
||||
function measure() {
|
||||
raf = 0;
|
||||
// 键盘占掉的高度 = layout viewport 高度 -(visual viewport 顶部偏移 + 可视高度)。
|
||||
// 浏览器为露出光标会把 visual viewport 上推(offsetTop > 0),这部分要一并扣掉,
|
||||
// 否则会按「整段键盘」收缩,footer 反而被顶得比键盘上沿更高。
|
||||
let next = Math.round(window.innerHeight - vv.offsetTop - vv.height);
|
||||
// 双指缩放时 vv.height 被压缩,不代表键盘(user-scalable=no 下基本走不到)
|
||||
if (vv.scale > 1.01 || next < KB_MIN) next = 0;
|
||||
// 兜底上限:横屏 + 大字号等极端情况下别把整个 shell 收没
|
||||
next = Math.min(next, Math.round(window.innerHeight * 0.7));
|
||||
|
||||
if (next === kb) return;
|
||||
|
||||
const box = document.getElementById('chat-view');
|
||||
// 只在「键盘弹起导致变矮」时继续贴底;收键盘时保持当前阅读位置不动
|
||||
const stick = next > kb && !!box && nearBottom(box);
|
||||
kb = next;
|
||||
root.style.setProperty('--kb-page', kb + 'px');
|
||||
|
||||
if (stick) {
|
||||
// 等一次布局:#app 收缩后 scrollHeight / clientHeight 才是新值
|
||||
requestAnimationFrame(() => { box.scrollTop = box.scrollHeight; });
|
||||
}
|
||||
}
|
||||
|
||||
function schedule() {
|
||||
if (!raf) raf = requestAnimationFrame(measure);
|
||||
}
|
||||
|
||||
vv.addEventListener('resize', schedule);
|
||||
vv.addEventListener('scroll', schedule); // 浏览器平移 visual viewport 时 offsetTop 会变
|
||||
// 转屏后尺寸与 inset 都变了,等系统栏动画结束再量一次
|
||||
window.addEventListener('orientationchange', () => setTimeout(measure, 200));
|
||||
})();
|
||||
@@ -0,0 +1,843 @@
|
||||
// 语音输入(按住说话)
|
||||
//
|
||||
// 交互:
|
||||
// · 输入框为空时,发送键变成麦克风;点一下进入语音模式
|
||||
// · 语音模式下输入框位置变成「按住 说话」:按住后整块输入区被全宽遮罩盖住,
|
||||
// 显示实时电平声波 + 「松手传送,上滑取消」
|
||||
// · 手指上滑进入文案区域 → 取消态(声波与文案变红,文案改「松开取消」),滑回下方恢复
|
||||
// · 松手:取消态 → 丢弃 + 轻提示;否则转写后**直接发送**
|
||||
// · 发送键位置变成键盘按钮,点一下回文本模式并聚焦输入框(移动端弹键盘)
|
||||
//
|
||||
// 录音在客户端,两条路,下游是同一套:
|
||||
// · 套壳原生桥(http 页面也能用):壳把 16k/单声道 PCM 以 ~100ms 分片推给页面。
|
||||
// · 浏览器(需 HTTPS):AudioContext + ScriptProcessor 自己采 PCM,降采样到 16k 后约 20ms 一片。
|
||||
// 两条路都汇到 pushChunk():判停顿、切段、逐段上传、最后合并发送,只有一份实现。
|
||||
// 于是大部分识别在说话过程中就做完了,松手通常只剩最后一段要等。
|
||||
// 电平在页面侧算(PCM 峰值),壳和浏览器都不做任何换算。
|
||||
//
|
||||
// 包在 IIFE 里:前端是共享全局作用域的经典脚本,顶层声明会和其他文件撞名。
|
||||
|
||||
(function () {
|
||||
'use strict';
|
||||
|
||||
const hold = $('voice-hold');
|
||||
const ta = $('msg-input');
|
||||
const overlay = $('voice-overlay');
|
||||
const hintEl = $('voice-hint');
|
||||
const waveEl = $('voice-wave');
|
||||
if (!hold || !ta) return;
|
||||
|
||||
const native = (window.AgentNative && typeof window.AgentNative.startVoice === 'function')
|
||||
? window.AgentNative : null;
|
||||
const webOk = !!(window.isSecureContext && navigator.mediaDevices
|
||||
&& typeof navigator.mediaDevices.getUserMedia === 'function'
|
||||
&& (window.AudioContext || window.webkitAudioContext));
|
||||
|
||||
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; // 声波柱数(要足够宽,手指按住时两侧仍能看到)
|
||||
|
||||
// 两端矮、中间高的包络:看起来像一段声波而不是一排等高柱子
|
||||
const WEIGHTS = [];
|
||||
for (let i = 0; i < BAR_COUNT; i++) {
|
||||
WEIGHTS.push(0.45 + 0.55 * Math.sin(Math.PI * (i + 0.5) / BAR_COUNT));
|
||||
}
|
||||
const bars = [];
|
||||
if (waveEl) {
|
||||
for (let i = 0; i < BAR_COUNT; i++) {
|
||||
const b = document.createElement('i');
|
||||
waveEl.appendChild(b);
|
||||
bars.push(b);
|
||||
}
|
||||
}
|
||||
|
||||
let available = false; // 有能力 + 服务端接线:发送键才显示麦克风
|
||||
let mode = false; // 是否处于语音模式
|
||||
let phase = 'idle'; // idle | arming(等 getMedia)| recording | busy
|
||||
let pressing = false;
|
||||
let pressY = 0; // 本次按压的起始 Y(判断“确实上滑了”)
|
||||
let cancelArmed = false; // 已上滑到取消区
|
||||
let discard = false; // 本次录音太短/已取消:结果到了也丢掉
|
||||
let recordStartAt = 0;
|
||||
let stopTimer = null;
|
||||
let stream = null;
|
||||
// 浏览器采集:ScriptProcessor 直接给 Float32 PCM,这里降到 16k 后喂 pushChunk
|
||||
let procNode = null;
|
||||
let capRate = 0; // AudioContext 的真实采样率(通常 44.1k/48k)
|
||||
let dsAcc = 0; // 降采样:当前输出周期内的样本和
|
||||
let dsN = 0;
|
||||
let dsPhase = 0; // 小数相位,跨分片累计 → 长期不漂移
|
||||
|
||||
// 流式:壳推的分片 / 浏览器自己采的分片,都在这里断句后逐段上传
|
||||
let pcmRate = 16000; // 当前流的采样率(契约要求 16k)
|
||||
let segChunks = []; // 当前段的 PCM 分片(Int16Array)
|
||||
let segLens = []; // 各分片采样数(与 segChunks 平行:软切要按采样换算边界)
|
||||
let segDbs = []; // 各分片峰值 dB(与 segChunks 平行:软切要找能量最低的边界)
|
||||
let segLen = 0; // 当前段总采样数
|
||||
let silLen = 0; // 段尾连续静音采样数
|
||||
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;
|
||||
|
||||
// VAD 参数(页面侧唯一一份:改完刷新页面即生效,不用重打 APK)
|
||||
const VAD_SILENCE_DB = -42; // 低于这个音量算“没人说话”(正常说话峰值约 -10~-30dB)
|
||||
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;
|
||||
let levelTarget = 0;
|
||||
let levelCur = 0;
|
||||
let lastRealLevelAt = 0;
|
||||
let audioCtx = null;
|
||||
let srcNode = null;
|
||||
|
||||
function clamp01(v) { return v < 0 ? 0 : v > 1 ? 1 : v; }
|
||||
|
||||
// 电平归一化的唯一实现:两条录音路径的 PCM 峰值都在这里落到 0~1。
|
||||
// 低于 -55dB 视为静音,-5dB 及以上视为满幅;要调灵敏度只改这两个常量。
|
||||
const LEVEL_FLOOR_DB = -55;
|
||||
const LEVEL_RANGE_DB = 50;
|
||||
function dbToLevel(db) {
|
||||
return clamp01((db - LEVEL_FLOOR_DB) / LEVEL_RANGE_DB);
|
||||
}
|
||||
|
||||
function setHoldText(s) {
|
||||
if (hold.textContent !== s) hold.textContent = s;
|
||||
}
|
||||
|
||||
// ---------- 遮罩 / 声波 ----------
|
||||
function setOverlayMode(m) { // 'send' | 'cancel' | 'busy'
|
||||
cancelArmed = m === 'cancel';
|
||||
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) {
|
||||
if (!bars.length) return;
|
||||
const t = Date.now() / 1000;
|
||||
// 只有真的收到可听电平(大于门限)才加流动感;安静时保持完全静止,不靠抖动“装活”
|
||||
const flow = animate && level > 0.02;
|
||||
for (let i = 0; i < bars.length; i++) {
|
||||
const ripple = flow ? (0.88 + 0.12 * Math.sin(t * 6 + i * 0.55)) : 1;
|
||||
const h = Math.max(0.08, Math.min(1, (0.15 + 0.85 * level) * WEIGHTS[i] * ripple));
|
||||
bars[i].style.transform = 'scaleY(' + h.toFixed(3) + ')';
|
||||
}
|
||||
}
|
||||
|
||||
function startLoop() {
|
||||
if (rafId || !overlay || overlay.classList.contains('hidden')) return;
|
||||
if (typeof requestAnimationFrame !== 'function') return;
|
||||
rafId = requestAnimationFrame(tickMeter);
|
||||
}
|
||||
|
||||
function tickMeter() {
|
||||
rafId = 0;
|
||||
if (!overlay || overlay.classList.contains('hidden')) return;
|
||||
|
||||
// 电平只有一个来源:pushChunk() 每收到一片 PCM 就更新 levelTarget。
|
||||
// 超过 300ms 没有新数据(授权还没给 / 已经停了)→ 静默停在基线,不假动。
|
||||
if (Date.now() - lastRealLevelAt > 300) {
|
||||
levelCur = 0;
|
||||
renderBars(0, false);
|
||||
return;
|
||||
}
|
||||
|
||||
// 快攻慢放:起音跟得紧,收音回落慢,柱体不抽筋
|
||||
levelCur += (levelTarget - levelCur) * (levelTarget > levelCur ? 0.55 : 0.18);
|
||||
renderBars(levelCur, true);
|
||||
rafId = requestAnimationFrame(tickMeter);
|
||||
}
|
||||
|
||||
// iOS Safari 只允许在用户手势里真正启动 AudioContext;getUserMedia 之后那条异步链已经
|
||||
// 脱离手势,那时才 new AudioContext 有可能一直 suspended(一点声音都采不到)。
|
||||
// 所以在 pointerdown 里先把 ctx 建好并 resume,拿到麦克风后直接复用。
|
||||
function primeAudioCtx() {
|
||||
if (audioCtx) return true;
|
||||
const AC = window.AudioContext || window.webkitAudioContext;
|
||||
if (!AC) return false;
|
||||
try {
|
||||
audioCtx = new AC();
|
||||
if (audioCtx.state === 'suspended') audioCtx.resume();
|
||||
return true;
|
||||
} catch (_) {
|
||||
audioCtx = null;
|
||||
return false;
|
||||
}
|
||||
}
|
||||
|
||||
// 浏览器:拿 PCM 只能靠 ScriptProcessor(已标废弃,但 Chrome/Safari/Firefox 都还在,
|
||||
// 且不需要额外加载文件)。AudioWorklet 要 addModule,异步加载会吞掉开头几个字。
|
||||
function startCapture() {
|
||||
if (!stream || !primeAudioCtx()) return false;
|
||||
try {
|
||||
capRate = audioCtx.sampleRate || 48000;
|
||||
dsAcc = 0; dsN = 0; dsPhase = 0;
|
||||
srcNode = audioCtx.createMediaStreamSource(stream);
|
||||
procNode = audioCtx.createScriptProcessor(1024, 1, 1);
|
||||
procNode.onaudioprocess = function (ev) {
|
||||
const pcm = downsampleTo16k(ev.inputBuffer.getChannelData(0));
|
||||
if (pcm.length) pushChunk(pcm, OUT_RATE);
|
||||
};
|
||||
srcNode.connect(procNode);
|
||||
// 必须接到 destination 才会被驱动;输出缓冲区不写,所以不会外放
|
||||
procNode.connect(audioCtx.destination);
|
||||
if (audioCtx.state === 'suspended') audioCtx.resume();
|
||||
startLoop();
|
||||
return true;
|
||||
} catch (_) {
|
||||
stopMeter(false);
|
||||
return false;
|
||||
}
|
||||
}
|
||||
|
||||
// Float32(任意采样率)→ 16k Int16。按「输出周期内取均值」降采样:既是抽点也能压一点高频,
|
||||
// 且 dsPhase 跨分片累计,长时间录不会整体越走越快/越慢(整数倍抽取会)。
|
||||
function downsampleTo16k(input) {
|
||||
const out = new Int16Array(Math.ceil(input.length * OUT_RATE / capRate) + 1);
|
||||
let n = 0;
|
||||
for (let i = 0; i < input.length; i++) {
|
||||
dsAcc += input[i];
|
||||
dsN++;
|
||||
dsPhase += OUT_RATE;
|
||||
if (dsPhase >= capRate) {
|
||||
dsPhase -= capRate;
|
||||
const v = Math.round((dsAcc / dsN) * 32767);
|
||||
out[n++] = v > 32767 ? 32767 : v < -32768 ? -32768 : v;
|
||||
dsAcc = 0;
|
||||
dsN = 0;
|
||||
}
|
||||
}
|
||||
return n === out.length ? out : out.subarray(0, n);
|
||||
}
|
||||
|
||||
function startMeter() {
|
||||
stopMeter(false);
|
||||
levelTarget = 0;
|
||||
levelCur = 0;
|
||||
lastRealLevelAt = 0;
|
||||
startLoop();
|
||||
}
|
||||
|
||||
function stopMeter(flatten) {
|
||||
if (rafId) { cancelAnimationFrame(rafId); rafId = 0; }
|
||||
if (procNode) {
|
||||
try { procNode.disconnect(); } catch (_) { /* 已断 */ }
|
||||
procNode.onaudioprocess = null;
|
||||
procNode = null;
|
||||
}
|
||||
if (srcNode) { try { srcNode.disconnect(); } catch (_) { /* 已断 */ } srcNode = null; }
|
||||
// 采集节点也挂在这个 ctx 上:关掉它浏览器这边就彻底不再送 PCM 了
|
||||
if (audioCtx) { try { audioCtx.close(); } catch (_) { /* 已关 */ } audioCtx = null; }
|
||||
if (flatten !== false) {
|
||||
for (let i = 0; i < bars.length; i++) bars[i].style.transform = 'scaleY(.12)';
|
||||
}
|
||||
}
|
||||
|
||||
function showOverlay() {
|
||||
if (overlay) overlay.classList.remove('hidden');
|
||||
// 录音期间隐藏输入卡内容(否则透明渐变会把按钮/文字透出来)
|
||||
if (document.body) document.body.classList.add('voice-active');
|
||||
setOverlayMode('send');
|
||||
startMeter();
|
||||
}
|
||||
|
||||
function hideOverlay() {
|
||||
if (overlay) overlay.classList.add('hidden');
|
||||
if (document.body) document.body.classList.remove('voice-active');
|
||||
stopMeter();
|
||||
cancelArmed = false;
|
||||
}
|
||||
|
||||
function resetUI() {
|
||||
phase = 'idle';
|
||||
pressing = false;
|
||||
pressY = 0;
|
||||
discard = false;
|
||||
stopBusyTicker();
|
||||
abortStream();
|
||||
if (stopTimer) { clearTimeout(stopTimer); stopTimer = null; }
|
||||
hold.classList.remove('recording');
|
||||
setHoldText(HOLD_IDLE);
|
||||
hideOverlay();
|
||||
updateSendBtn();
|
||||
}
|
||||
|
||||
function releaseStream() {
|
||||
if (!stream) return;
|
||||
try { stream.getTracks().forEach(function (t) { t.stop(); }); } catch (_) { /* 已关 */ }
|
||||
stream = null;
|
||||
}
|
||||
|
||||
// ---------- 模式切换 ----------
|
||||
function enter() {
|
||||
if (!available || mode) return;
|
||||
mode = true;
|
||||
ta.classList.add('hidden');
|
||||
hold.classList.remove('hidden');
|
||||
try { ta.blur(); } catch (_) { /* 忽略 */ }
|
||||
resetUI();
|
||||
updateSendBtn();
|
||||
}
|
||||
|
||||
function exit(focus) {
|
||||
if (!mode) return;
|
||||
cancelHold();
|
||||
mode = false;
|
||||
hold.classList.add('hidden');
|
||||
ta.classList.remove('hidden');
|
||||
autosize();
|
||||
updateSendBtn();
|
||||
// 必须在点击手势里同步 focus,移动端才会弹键盘
|
||||
if (focus) { try { ta.focus(); } catch (_) { /* 忽略 */ } }
|
||||
}
|
||||
|
||||
// ---------- 录音 ----------
|
||||
function startHold() {
|
||||
if (phase !== 'idle') return;
|
||||
pressing = true;
|
||||
discard = false;
|
||||
segSent = 0;
|
||||
segDone = 0;
|
||||
hold.classList.add('recording');
|
||||
setHoldText(HOLD_REC);
|
||||
showOverlay();
|
||||
|
||||
if (native) {
|
||||
// 原生侧即使要弹权限也先当「已开始」:页面已经开始收分片,壳真开录后会推数据。
|
||||
// 首次授权那一次的分片要等用户点允许才会到,之前的静音不计入。
|
||||
phase = 'recording';
|
||||
recordStartAt = Date.now();
|
||||
gen++; // 新会话:让上一轮迟到的结果全部失效
|
||||
inflight = []; // 上一轮的在途请求不再计入本轮收口
|
||||
streamOn = true;
|
||||
pcmRate = 16000;
|
||||
clearSeg();
|
||||
textParts = [];
|
||||
stopTimer = setTimeout(finishHold, MAX_MS);
|
||||
try {
|
||||
native.startVoice();
|
||||
} catch (e) {
|
||||
resetUI();
|
||||
toast('无法开始录音:' + String((e && e.message) || e));
|
||||
}
|
||||
return;
|
||||
}
|
||||
|
||||
// 浏览器:先拿麦克风(可能要等用户授权),拿到后 startCapture 开始往里推 PCM
|
||||
phase = 'arming';
|
||||
primeAudioCtx(); // 必须在手势里建(见 primeAudioCtx 注释)
|
||||
startWeb();
|
||||
}
|
||||
|
||||
async function startWeb() {
|
||||
try {
|
||||
stream = await navigator.mediaDevices.getUserMedia({ audio: true });
|
||||
} catch (e) {
|
||||
resetUI();
|
||||
const denied = e && (e.name === 'NotAllowedError' || e.name === 'SecurityError');
|
||||
toast(denied ? '麦克风权限被拒绝' : '无法打开麦克风:' + String((e && e.message) || e));
|
||||
return;
|
||||
}
|
||||
if (!pressing) { releaseStream(); resetUI(); return; } // 松开得比授权快
|
||||
|
||||
// 与套壳同一套状态,只是换成了「自己采 PCM」而不是「等壳推」
|
||||
phase = 'recording';
|
||||
recordStartAt = Date.now();
|
||||
gen++;
|
||||
pcmRate = OUT_RATE;
|
||||
streamOn = true;
|
||||
inflight = [];
|
||||
clearSeg();
|
||||
textParts = [];
|
||||
if (!startCapture()) {
|
||||
streamOn = false;
|
||||
releaseStream();
|
||||
resetUI();
|
||||
toast('无法开始录音:当前浏览器采不到音频');
|
||||
return;
|
||||
}
|
||||
stopTimer = setTimeout(finishHold, MAX_MS);
|
||||
}
|
||||
|
||||
// 松手:结束录音(太短则丢弃)
|
||||
function finishHold() {
|
||||
if (phase !== 'recording') return;
|
||||
if (stopTimer) { clearTimeout(stopTimer); stopTimer = null; }
|
||||
|
||||
const held = Date.now() - recordStartAt;
|
||||
if (held < MIN_MS) discard = true;
|
||||
phase = 'busy';
|
||||
hold.classList.remove('recording');
|
||||
setHoldText(discard ? HOLD_IDLE : '正在识别…');
|
||||
// 遮罩留着,文案换成动态识别进度;柱子停在低位,等结果回来再收
|
||||
setOverlayMode(discard ? 'send' : 'busy');
|
||||
stopMeter();
|
||||
|
||||
if (discard) {
|
||||
abortStream();
|
||||
releaseStream();
|
||||
nativeStop(false); // 只停采集,不用管壳知不知道“被丢弃”(页面已经不再收分片)
|
||||
resetUI();
|
||||
toast('说话时间太短');
|
||||
return;
|
||||
}
|
||||
|
||||
// 两条路收口完全一样:把不足一个停顿的尾巴发走(纯静音的尾巴不发),再等所有段回来。
|
||||
// 大部分段在说话过程中已经识别完了,这里通常只等最后一段。
|
||||
flushTail();
|
||||
startBusyTicker(); // 尾巴已进队列:现在才有准确的总段数,从这一刻开始计时
|
||||
if (native) {
|
||||
try {
|
||||
native.stopVoice();
|
||||
} catch (e) {
|
||||
resetUI();
|
||||
toast('结束录音失败:' + String((e && e.message) || e));
|
||||
return;
|
||||
}
|
||||
} else {
|
||||
releaseStream(); // 采集节点已经由上面的 stopMeter() 拆掉了
|
||||
}
|
||||
waitFlush();
|
||||
}
|
||||
|
||||
// 让壳停止采集:优先 cancelVoice(语义明确),壳没实现时退回 stopVoice——
|
||||
// 否则麦克风会在壳侧一直开着(页面这边已经不再收分片了,但录音还在跑)。
|
||||
function nativeStop(cancel) {
|
||||
if (!native) return;
|
||||
try {
|
||||
if (cancel && native.cancelVoice) native.cancelVoice();
|
||||
else if (native.stopVoice) native.stopVoice();
|
||||
} catch (_) { /* 已停 */ }
|
||||
}
|
||||
|
||||
// 放弃本次录音(切模式 / 离开页面 / 上滑取消 / 壳回调 cancelled)
|
||||
function cancelHold() {
|
||||
if (phase === 'idle') return;
|
||||
abortStream(); // 丢弃已发在途的结果,也不碰输入框
|
||||
releaseStream(); // 浏览器:停麦克风轨道(采集节点由 resetUI → stopMeter 拆)
|
||||
nativeStop(true);
|
||||
resetUI();
|
||||
}
|
||||
|
||||
// ---------- 按住 / 滑动 / 松开(手机)或点击切换(桌面)----------
|
||||
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;
|
||||
if (phase !== 'recording' && phase !== 'arming') return;
|
||||
if (!overlay || overlay.classList.contains('hidden') || !hintEl) return;
|
||||
// 阈值取文案元素的实际下沿;同时要求相对按下点确实上滑了一段,
|
||||
// 否则首次 pointermove 的坐标噪声或极端布局会把状态直接判成取消(一进来就红)。
|
||||
const line = hintEl.getBoundingClientRect().bottom;
|
||||
const limit = pressY ? Math.min(line - 4, pressY - 24) : (line - 4);
|
||||
const y = e.clientY;
|
||||
if (!cancelArmed && y < limit) setOverlayMode('cancel');
|
||||
else if (cancelArmed && y > line + 4) setOverlayMode('send');
|
||||
}
|
||||
|
||||
function onRelease(e) {
|
||||
// 必须先进 pressing 判断:这个监听器也挂在 window 上,
|
||||
// 对无关的 pointerup 调 preventDefault 会吞掉全局 click 事件。
|
||||
if (!pressing) return;
|
||||
if (e) e.preventDefault();
|
||||
pressing = false;
|
||||
|
||||
if (cancelArmed) {
|
||||
// 不弹提示:toast 会盖住声波(取消本身已经有颜色/文案反馈)
|
||||
cancelHold();
|
||||
return;
|
||||
}
|
||||
if (phase === 'recording') finishHold();
|
||||
else if (phase === 'arming') cancelHold(); // 还没真正开录:当误触
|
||||
}
|
||||
|
||||
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(); });
|
||||
|
||||
// 键盘可达:空格/回车按下开始,松开结束
|
||||
hold.addEventListener('keydown', function (e) {
|
||||
if (e.repeat) return;
|
||||
if (e.key !== ' ' && e.key !== 'Enter') return;
|
||||
e.preventDefault();
|
||||
if (!pressing) startHold();
|
||||
});
|
||||
hold.addEventListener('keyup', function (e) {
|
||||
if (e.key !== ' ' && e.key !== 'Enter') return;
|
||||
e.preventDefault();
|
||||
onRelease(null);
|
||||
});
|
||||
|
||||
// 录音中离开页面:释放麦克风
|
||||
window.addEventListener('pagehide', cancelHold);
|
||||
|
||||
// ---------- PCM 处理(两条录音路径共用) ----------
|
||||
// 壳每 ~100ms 推一片 16bit/单声道小端 PCM;浏览器自己采。采样率、分片大小、门限全部不在别处算。
|
||||
function b64ToI16(b64) {
|
||||
const bin = atob(String(b64 || ''));
|
||||
const n = bin.length >> 1;
|
||||
const out = new Int16Array(n);
|
||||
for (let i = 0; i < n; i++) out[i] = (bin.charCodeAt(i * 2 + 1) << 8) | bin.charCodeAt(i * 2);
|
||||
return out;
|
||||
}
|
||||
|
||||
// 这一片 PCM 的峰值电平(dBFS)。用峰值而不是 RMS:与原先 getMaxAmplitude 的尺度一致。
|
||||
function peakDb(arr) {
|
||||
let peak = 0;
|
||||
for (let i = 0; i < arr.length; i++) {
|
||||
const v = arr[i] < 0 ? -arr[i] : arr[i];
|
||||
if (v > peak) peak = v;
|
||||
}
|
||||
return peak <= 0 ? -Infinity : 20 * Math.log10(peak / 32767);
|
||||
}
|
||||
|
||||
function encodeWav(samples, rate) {
|
||||
const b = new ArrayBuffer(44 + samples.length * 2);
|
||||
const v = new DataView(b);
|
||||
const str = function (off, s) { for (let i = 0; i < s.length; i++) v.setUint8(off + i, s.charCodeAt(i)); };
|
||||
str(0, 'RIFF'); v.setUint32(4, 36 + samples.length * 2, true); str(8, 'WAVE');
|
||||
str(12, 'fmt '); v.setUint32(16, 16, true);
|
||||
v.setUint16(20, 1, true); // PCM
|
||||
v.setUint16(22, 1, true); // mono
|
||||
v.setUint32(24, rate, true); // 采样率
|
||||
v.setUint32(28, rate * 2, true); // byte rate
|
||||
v.setUint16(32, 2, true); v.setUint16(34, 16, true);
|
||||
str(36, 'data'); v.setUint32(40, samples.length * 2, true);
|
||||
for (let i = 0, o = 44; i < samples.length; i++, o += 2) v.setInt16(o, samples[i], true);
|
||||
return new Blob([b], { type: 'audio/wav' });
|
||||
}
|
||||
|
||||
// 从当前段取前 n 个采样(拼成一段连续 PCM)
|
||||
function takeSeg(n) {
|
||||
const out = new Int16Array(n);
|
||||
let off = 0;
|
||||
for (const c of segChunks) {
|
||||
if (off >= n) break;
|
||||
const k = Math.min(c.length, n - off);
|
||||
out.set(k === c.length ? c : c.subarray(0, k), off);
|
||||
off += k;
|
||||
}
|
||||
return out;
|
||||
}
|
||||
|
||||
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。
|
||||
function emitSegment(n) {
|
||||
if (n < pcmRate * VAD_MIN_SPEECH_SEC) return;
|
||||
emit(encodeWav(takeSeg(n), pcmRate));
|
||||
}
|
||||
|
||||
// 每段切出来就发,不等上一段回来,但同时最多 ASR_MAX_CONCURRENCY 个。
|
||||
// 名额是「谁落定谁交出去」,不按固定顺序等某一段:否则最慢那段会卡住本可以发的后续段。
|
||||
// 并行返回是乱序的,所以结果按「提交时的下标」落位,拼接时仍按说话顺序。
|
||||
function emit(blob) {
|
||||
const my = gen;
|
||||
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[idx] = t;
|
||||
})
|
||||
.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--;
|
||||
}
|
||||
|
||||
// 拼接各段:中文直接相连;两侧都是西文字母/数字时补一个空格,
|
||||
// 否则英文被切开后会粘成 "helloworld"。
|
||||
function joinText(parts) {
|
||||
let out = '';
|
||||
for (const s of parts) {
|
||||
if (!s) continue;
|
||||
if (out && /[A-Za-z0-9]$/.test(out) && /^[A-Za-z0-9]/.test(s)) out += ' ';
|
||||
out += s;
|
||||
}
|
||||
return out;
|
||||
}
|
||||
|
||||
// 丢弃本轮的一切(段缓冲 + 已发在途结果):取消 / 误触 / 超时都走这里
|
||||
function abortStream() {
|
||||
streamOn = false;
|
||||
clearSeg();
|
||||
textParts = [];
|
||||
inflight = [];
|
||||
gen++;
|
||||
if (flushTimer) { clearTimeout(flushTimer); flushTimer = null; }
|
||||
}
|
||||
|
||||
// 一片 16bit 单声道 PCM:两条录音路径的唯一汇合点。
|
||||
// 电平、静音判定、断句、上传全在页面侧;壳和浏览器都不做任何判断。
|
||||
function pushChunk(pcm, rate) {
|
||||
if (!streamOn || phase !== 'recording') return;
|
||||
const r = Number(rate);
|
||||
if (r > 0 && r !== pcmRate) pcmRate = r;
|
||||
if (!pcm.length) return;
|
||||
|
||||
// 电平:直接用这片 PCM 的峰值
|
||||
const db = peakDb(pcm);
|
||||
lastRealLevelAt = Date.now();
|
||||
levelTarget = db === -Infinity ? 0 : dbToLevel(db);
|
||||
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;
|
||||
|
||||
if (silLen >= pcmRate * VAD_PAUSE_SEC) {
|
||||
// 停顿够了 → 把静音之前的部分发走,静音本身丢掉(不浪费上游额度)
|
||||
const tail = segLen - silLen;
|
||||
emitSegment(tail);
|
||||
clearSeg();
|
||||
} else if (segLen >= pcmRate * VAD_MAX_SEG_SEC) {
|
||||
// 一口气说了 25 秒没停顿:硬切(宁可切开也不能超上游上限)
|
||||
emitSegment(segLen);
|
||||
clearSeg();
|
||||
} else if (segLen >= pcmRate * VAD_SOFT_CUT_SEC) {
|
||||
// 说太久又没停顿:先在能量最低处切一刀(软切),别把整段憋到松手或 25s 硬切
|
||||
const k = softCutChunk();
|
||||
if (k > 0) softCut(k);
|
||||
}
|
||||
}
|
||||
|
||||
// 壳每 ~100ms 推一片 16bit/单声道小端 PCM(契约见 docs/voice-input.md)
|
||||
window.onNativeVoiceChunk = function (b64, rate) {
|
||||
if (!native) return;
|
||||
pushChunk(b64ToI16(b64), rate);
|
||||
};
|
||||
|
||||
// 松手/超时:把不足一个停顿的尾巴也发出去,然后等全部段回来。
|
||||
// 必须剔掉尾巴上的静音:停顿那一下已经把缓冲清空了,之后累积的可能全是静音
|
||||
//(用户停一会儿才松手),发出去只会换来一次「没有可识别语音」。
|
||||
function flushTail() {
|
||||
streamOn = false;
|
||||
const speech = segLen - silLen;
|
||||
if (speech > 0) emitSegment(speech);
|
||||
clearSeg();
|
||||
}
|
||||
|
||||
function waitFlush() {
|
||||
const my = gen;
|
||||
flushTimer = setTimeout(function () {
|
||||
flushTimer = null;
|
||||
if (my !== gen) return;
|
||||
gen++; // 让迟到结果失效
|
||||
resetUI();
|
||||
toast('语音识别超时');
|
||||
}, FLUSH_MS);
|
||||
// 并行发之后没有串行链可挂:等本轮全部段落定(含被限流挡着的)再收口。
|
||||
// 逐个兜一层 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);
|
||||
// 先收遮罩再做后续:toast 固定在 bottom:96px,遮罩还在时弹出来会压住声波
|
||||
resetUI();
|
||||
if (!text) { toast('没有识别到内容'); return; }
|
||||
ta.value = text;
|
||||
send();
|
||||
});
|
||||
}
|
||||
|
||||
window.onNativeVoiceState = function (s) {
|
||||
if (!native || s !== 'recording' || phase !== 'recording') return;
|
||||
// 真正开录:180s 与「太短」判定从这一刻算(首次授权弹窗的时间不算)
|
||||
recordStartAt = Date.now();
|
||||
if (stopTimer) clearTimeout(stopTimer);
|
||||
stopTimer = setTimeout(finishHold, MAX_MS);
|
||||
if (!pressing) finishHold(); // 弹窗期间已经松手:立刻收口(held≈0 → 丢弃)
|
||||
};
|
||||
|
||||
window.onNativeVoiceError = function (code, message) {
|
||||
if (phase === 'idle') return;
|
||||
abortStream();
|
||||
resetUI();
|
||||
// 生命周期打断(切后台/换页)属预期,不弹提示
|
||||
if (code === 'cancelled' || code === 'canceled') return;
|
||||
toast(code === 'too_short'
|
||||
? '说话时间太短,请按住再说'
|
||||
: '录音失败:' + String(message || code || '未知错误'));
|
||||
};
|
||||
|
||||
// ---------- 对外暴露给发送键 / sessions.js 的状态查询 ----------
|
||||
window.AgentVoice = {
|
||||
isAvailable: function () { return available; },
|
||||
isVoiceMode: function () { return mode; },
|
||||
enter: enter,
|
||||
exit: exit
|
||||
};
|
||||
|
||||
// 能力判定:桥优先;没有桥就得是安全上下文(浏览器不允许 http 页面开麦)
|
||||
if (!native && !webOk) {
|
||||
console.info('[voice] 语音入口未启用:没有 window.AgentNative,且当前不是安全上下文(需 HTTPS,或由套壳 App 注入原生桥)');
|
||||
return;
|
||||
}
|
||||
// 服务端没接线(core 的 ASR_URL 为空,或 config.yml 里没有可用的 asr 段)就不给入口;
|
||||
// 探测失败则照常启用(不因一次探测失败就永久藏掉入口)。
|
||||
req('GET', '/api/asr/status').then(function (s) {
|
||||
if (s && s.enabled === false) {
|
||||
console.info('[voice] 语音入口未启用:' + ((s && s.reason) || '服务端未配置语音识别'));
|
||||
return;
|
||||
}
|
||||
available = true;
|
||||
updateSendBtn();
|
||||
}).catch(function () {
|
||||
available = true;
|
||||
updateSendBtn();
|
||||
});
|
||||
})();
|
||||
@@ -2,7 +2,7 @@
|
||||
<html lang="zh">
|
||||
<head>
|
||||
<meta charset="UTF-8">
|
||||
<meta name="viewport" content="width=device-width, initial-scale=1.0, maximum-scale=1.0, user-scalable=no">
|
||||
<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>
|
||||
<meta name="theme-color" content="#1e3c72">
|
||||
<meta name="apple-mobile-web-app-capable" content="yes">
|
||||
@@ -13,7 +13,8 @@
|
||||
<link rel="stylesheet" href="/css/style.css">
|
||||
<style>
|
||||
.login-wrap {
|
||||
position: fixed; inset: 0; display: flex; align-items: center; justify-content: center;
|
||||
/* bottom 让出软键盘:表单垂直居中,键盘弹起时卡片跟着可见区域上移(--kb 见 js/viewport.js) */
|
||||
position: fixed; inset: 0; bottom: var(--kb, 0px); display: flex; align-items: center; justify-content: center;
|
||||
background: linear-gradient(135deg, #1e3c72, #2a5299);
|
||||
}
|
||||
.login-card {
|
||||
@@ -39,6 +40,7 @@
|
||||
<p class="login-error" id="login-error"></p>
|
||||
</form>
|
||||
</div>
|
||||
<script src="/js/viewport.js"></script>
|
||||
<script>
|
||||
'use strict';
|
||||
const TOKEN_KEY = 'agent_token';
|
||||
|
||||
@@ -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; }
|
||||
}
|
||||
}
|
||||
|
||||
@@ -0,0 +1,126 @@
|
||||
// 语音识别代理:浏览器 / 套壳 App 录好的音频 → agent-core → mcp_asr → 文字。
|
||||
//
|
||||
// 为什么要 core 中转、而不是前端直连 ASR 容器:mcp_asr 只挂在 agent-mcp-net 内网、
|
||||
// 一个宿主端口都不占(它自身没有鉴权,暴露即被白嫖)。对外唯一的入口仍是 core,
|
||||
// 鉴权沿用全局登录态(auth.middleware 已挂在 /api 之前)。
|
||||
//
|
||||
// 上游参数全部来自 config.yml 的 mcp_servers 里那条 asr(与 image_task 完全同构):
|
||||
// - name: asr
|
||||
// url: "http://mcp_asr:3000/mcp"
|
||||
// headers:
|
||||
// Authorization: Bearer <key> # 免鉴权的自建服务可省
|
||||
// X-ASR-Base-Url: "https://.../v1"
|
||||
// X-ASR-Model: "whisper-1"
|
||||
// mcp_asr 自己不存任何平台密钥(容器 env 一条都不读),所以要换 ASR 平台只改这个文件对应的
|
||||
// YAML 段 + 重启 core,不碰 .env、不重建镜像。头名与 mcp/asr/src/server.js 的常量一一对应。
|
||||
//
|
||||
// 开关:ASR_URL 为空(未部署 mcp_asr)或配置里没有可用的 asr 段 = 关闭,本路由一律 503,
|
||||
// 前端据此不显示麦克风。ASR_URL 留在 env 是部署接线(容器地址),不属于平台密钥。
|
||||
const express = require('express');
|
||||
const engine = require('../engine');
|
||||
const log = require('../log');
|
||||
|
||||
const router = express.Router();
|
||||
|
||||
const ASR_URL = String(process.env.ASR_URL || '').trim().replace(/\/+$/, '');
|
||||
// 与 mcp_asr 的上限保持一致(60s 的 AAC 约 240KB,这里给长音频留余量)
|
||||
const MAX_BYTES = 20 * 1024 * 1024;
|
||||
const TIMEOUT_MS = 120000;
|
||||
|
||||
// 只转发 ASR 约定的三个头:config.yml 里该条目的其它 header 与本服务无关,没必要透传进内网。
|
||||
const PASS_HEADERS = ['authorization', 'x-asr-base-url', 'x-asr-model'];
|
||||
|
||||
// 取当前生效的 asr 配置段。配置冷加载(engine 里那份是启动时解析的),所以这里读到的就是
|
||||
// 运行中的值;重启前改 config.yml 不会影响已生效的这份,与其它配置项一致。
|
||||
function asrEntry() {
|
||||
let cfg = null;
|
||||
try { cfg = engine.getConfig(); } catch (_) { cfg = null; } // 启动早期 engine 还没拿到 cfg
|
||||
const list = (cfg && cfg.mcp_servers) || [];
|
||||
const s = list.find(function (x) { return x && x.name === 'asr'; });
|
||||
// mode: disable = 明确关闭(与模型侧工具同一开关:关了就别给麦克风)
|
||||
if (!s || s.mode === 'disable') return null;
|
||||
return s;
|
||||
}
|
||||
|
||||
function asrHeaders() {
|
||||
const s = asrEntry();
|
||||
if (!s) return null;
|
||||
const out = {};
|
||||
for (const [k, v] of Object.entries(s.headers || {})) {
|
||||
if (PASS_HEADERS.indexOf(String(k).toLowerCase()) >= 0) out[k] = String(v);
|
||||
}
|
||||
return out;
|
||||
}
|
||||
|
||||
// 有没有真的能转写:缺 base_url 就转不了(model 也缺的话 mcp_asr 会给出更具体的报错)。
|
||||
// 只判 base_url 是为了让「配了但漏填 model」在探测阶段仍显示入口,用户点了能拿到明确提示。
|
||||
function hasUpstream(headers) {
|
||||
return Object.keys(headers || {}).some(function (k) {
|
||||
return k.toLowerCase() === 'x-asr-base-url' && String(headers[k] || '').trim();
|
||||
});
|
||||
}
|
||||
|
||||
// 只接音频二进制。全局 express.json(2mb) 只解析 application/json,两者不冲突。
|
||||
// 注意 WebView 可能发 audio/mp4、audio/webm;codecs=opus,统一按 audio/* 接。
|
||||
const rawAudio = express.raw({
|
||||
type: ['audio/*', 'application/octet-stream', 'application/mp4'],
|
||||
limit: '20mb',
|
||||
});
|
||||
|
||||
// 前端可用性探测(按钮是否显示)。不碰网络,纯看接线。
|
||||
router.get('/status', function (req, res) {
|
||||
if (!ASR_URL) return res.json({ enabled: false, reason: 'core 未设置 ASR_URL' });
|
||||
if (!asrEntry()) return res.json({ enabled: false, reason: 'config.yml 的 mcp_servers 里没有启用的 asr' });
|
||||
const headers = asrHeaders();
|
||||
if (!hasUpstream(headers)) {
|
||||
return res.json({ enabled: false, reason: 'config.yml 的 asr.headers 缺 X-ASR-Base-Url' });
|
||||
}
|
||||
res.json({ enabled: true, max_bytes: MAX_BYTES });
|
||||
});
|
||||
|
||||
router.post('/transcribe', rawAudio, async function (req, res) {
|
||||
if (!ASR_URL) {
|
||||
return res.status(503).json({ error: '语音识别未部署(core 未设置 ASR_URL)' });
|
||||
}
|
||||
const headers = asrHeaders();
|
||||
if (!headers || !hasUpstream(headers)) {
|
||||
return res.status(503).json({ error: '语音识别未配置上游(config.yml 的 asr.headers 需设 X-ASR-Base-Url / X-ASR-Model)' });
|
||||
}
|
||||
const buf = req.body;
|
||||
if (!Buffer.isBuffer(buf) || !buf.length) {
|
||||
return res.status(400).json({ error: '未收到音频数据(Content-Type 需为 audio/*)' });
|
||||
}
|
||||
try {
|
||||
const r = await fetch(ASR_URL + '/transcribe', {
|
||||
method: 'POST',
|
||||
headers: Object.assign({ 'Content-Type': req.headers['content-type'] || 'application/octet-stream' }, headers),
|
||||
body: buf,
|
||||
signal: AbortSignal.timeout(TIMEOUT_MS),
|
||||
});
|
||||
const text = await r.text();
|
||||
if (!r.ok) {
|
||||
// ASR 服务回的是 {error:string}:解出来再转,不然前端会看到两层套嵌的 JSON
|
||||
let msg = text.slice(0, 300);
|
||||
try { msg = JSON.parse(text).error || msg; } catch (_) { /* 非 JSON 保留原文 */ }
|
||||
log.warn('asr', '识别失败 HTTP ' + r.status + ':' + msg);
|
||||
// 4xx(静音 / 坏音频 / 过载)原样透传;5xx 统一当上游故障
|
||||
const code = r.status >= 400 && r.status < 500 ? r.status : 502;
|
||||
return res.status(code).json({ error: msg });
|
||||
}
|
||||
// 原样透传 ASR 的 {text, ms, model}
|
||||
res.type('application/json').send(text);
|
||||
} catch (e) {
|
||||
log.warn('asr', '调用 ASR 服务失败:' + String(e && e.message || e));
|
||||
res.status(502).json({ error: '语音识别服务不可用:' + String(e && e.message || e) });
|
||||
}
|
||||
});
|
||||
|
||||
// express.raw 超限时抛 entity.too.large,默认会回 HTML;这里翻成前端能读的 JSON。
|
||||
router.use(function (err, req, res, next) {
|
||||
if (err && (err.type === 'entity.too.large' || err.status === 413)) {
|
||||
return res.status(413).json({ error: '音频过大(上限 ' + Math.round(MAX_BYTES / 1048576) + 'MB)' });
|
||||
}
|
||||
next(err);
|
||||
});
|
||||
|
||||
module.exports = router;
|
||||
@@ -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) {
|
||||
|
||||
+108
-17
@@ -5,10 +5,55 @@ const express = require('express');
|
||||
const engine = require('../engine');
|
||||
const { loadConfigFromText, readConfigText, applyEditsToText, writeConfigText } = require('../config');
|
||||
const balance = require('../balance');
|
||||
const mcp = require('../mcp');
|
||||
const log = require('../log');
|
||||
|
||||
const router = express.Router();
|
||||
|
||||
// 平台 / MCP 预设:设置页「新增平台」「添加内置 MCP」的模板来源(纯静态,无密钥)。
|
||||
// 文件写坏时降级为空预设:通用表单仍可用,不影响其它功能。
|
||||
const MCP_MODES = ['advertise', 'skill', 'disable'];
|
||||
function checkPresetList(list, kind, bad) {
|
||||
const seen = new Set();
|
||||
(list || []).forEach((x, i) => {
|
||||
const at = kind + '[' + i + ']';
|
||||
if (!x || typeof x !== 'object') { bad.push(at + ' 必须是对象'); return; }
|
||||
if (!x.key || !x.url) { bad.push(at + ' 缺 key/url'); return; }
|
||||
if (seen.has(x.key)) { bad.push(at + ' key 重复:' + x.key); return; }
|
||||
seen.add(x.key);
|
||||
if (kind === 'platforms') {
|
||||
if (!x.type) bad.push(at + ' 缺 type');
|
||||
if (x.model_defaults != null && typeof x.model_defaults !== 'object') {
|
||||
bad.push(at + '.model_defaults 必须是对象');
|
||||
}
|
||||
return;
|
||||
}
|
||||
if (x.mode != null && MCP_MODES.indexOf(x.mode) < 0) {
|
||||
bad.push(at + '.mode 只能是 ' + MCP_MODES.join(' / '));
|
||||
}
|
||||
if (x.fields != null && !Array.isArray(x.fields)) { bad.push(at + '.fields 必须是数组'); return; }
|
||||
(x.fields || []).forEach((f, fi) => {
|
||||
if (!f || !f.header) bad.push(at + '.fields[' + fi + '] 缺 header');
|
||||
});
|
||||
});
|
||||
}
|
||||
|
||||
function loadPresets() {
|
||||
const p = require('../presets.json') || {};
|
||||
const bad = [];
|
||||
checkPresetList(p.platforms, 'platforms', bad);
|
||||
checkPresetList(p.mcp, 'mcp', bad);
|
||||
if (bad.length) throw new Error(bad.join(';'));
|
||||
return { platforms: p.platforms || [], mcp: p.mcp || [] };
|
||||
}
|
||||
|
||||
let PRESETS = { platforms: [], mcp: [] };
|
||||
try {
|
||||
PRESETS = loadPresets();
|
||||
} catch (e) {
|
||||
log.warn('config', 'presets.json 无效,设置页将没有预设:' + String((e && e.message) || e));
|
||||
}
|
||||
|
||||
function sendErr(res, err) {
|
||||
const code = err && err.status_code || 500;
|
||||
res.status(code).json({ error: String(err && err.message || err) });
|
||||
@@ -112,13 +157,29 @@ function restorePasswords(submitted, orig) {
|
||||
}).join('\n');
|
||||
}
|
||||
|
||||
// MCP header 值脱敏(等同密码):统一固定短掩码 *****(不泄露长度),原文编辑器与 effective 视图共用。
|
||||
// MCP header 值脱敏:只遮「像密钥的」,base-url / model 这类明文回显——
|
||||
// 设置页的引导表单要看得见当前值才能改。两条启发式任一命中即遮:
|
||||
// 名字(Authorization / X-*-Token / X-Api-Key …)、值(Bearer … / sk-…)。
|
||||
// 值那条是兜底:用户自定义的怪名字(X-Upstream-Auth: sk-xxx)也不会明文外显。
|
||||
// headers 行 = `headers:` 块内比它更深缩进的键值行(如 ` Authorization: Bearer sk-xxx`,引号可选)。
|
||||
// 局限:块标量(|/>)续行内容无法逐行识别,与 api_key/password 的行级掩码同一量级的取舍。
|
||||
const MCP_HEADER_MASK = '*****';
|
||||
const HEADERS_BLOCK_LINE = /^(\s*)headers:\s*(?:#.*)?$/;
|
||||
const MCP_HEADER_LINE = /^(\s*(?:-\s+)?[\w.-]+:\s*)(["']?)(.*)\2\s*$/;
|
||||
function maskHeaderValue(v) { return v ? MCP_HEADER_MASK : ''; }
|
||||
const SECRET_NAME_RE = /^(authorization|cookie)$|(?:^|[-_])(token|key|secret|password)(?:[-_]|$)/i;
|
||||
const SECRET_VALUE_RE = /^Bearer\s|^sk-[A-Za-z0-9_-]{16,}/i;
|
||||
function isSecretHeader(name, value) {
|
||||
return SECRET_NAME_RE.test(String(name || '').trim()) ||
|
||||
SECRET_VALUE_RE.test(String(value == null ? '' : value).trim());
|
||||
}
|
||||
function maskHeaderValue(name, v) {
|
||||
if (!v) return '';
|
||||
return isSecretHeader(name, v) ? MCP_HEADER_MASK : v;
|
||||
}
|
||||
// 从匹配行里取 header 名(去掉列表短横与结尾冒号),用于按键名遮罩/还原
|
||||
function headerNameOf(m) {
|
||||
return String(m[1] || '').replace(/^\s*-\s*/, '').replace(/:\s*$/, '').trim();
|
||||
}
|
||||
// 遍历 headers 块内的键值行,fn(line, match) 返回替换后的行;块边界按缩进判定。
|
||||
function mapMcpHeaderLines(text, fn) {
|
||||
if (!text) return text;
|
||||
@@ -138,22 +199,32 @@ function mapMcpHeaderLines(text, fn) {
|
||||
}
|
||||
function maskMcpHeaders(text) {
|
||||
return mapMcpHeaderLines(text, function (line, m) {
|
||||
return m[1] + m[2] + maskHeaderValue(m[3]) + m[2];
|
||||
return m[1] + m[2] + maskHeaderValue(headerNameOf(m), m[3]) + m[2];
|
||||
});
|
||||
}
|
||||
// 还原:提交原文中值恰为 ***** 的 header 行 = 用户未改动,按出现顺序从原文件取回原值;其他值原样保留。
|
||||
// 还原:提交原文里值恰为 ***** 的行 = 用户未改动,按键名从原文件取回真值。
|
||||
// 按键名而非出现顺序:只遮部分 header 后,按顺序还原会张冠李戴。
|
||||
// 键名在原文里找不到(改名/新增行却留着占位)直接报错,绝不把占位写进配置。
|
||||
function restoreMcpHeaders(submitted, orig) {
|
||||
if (!submitted) return submitted;
|
||||
const origVals = [];
|
||||
mapMcpHeaderLines(orig || '', function (line, m) { origVals.push(m[3]); return line; });
|
||||
let i = 0;
|
||||
const origVals = {};
|
||||
mapMcpHeaderLines(orig || '', function (line, m) { origVals[headerNameOf(m)] = m[3]; return line; });
|
||||
return mapMcpHeaderLines(submitted, function (line, m) {
|
||||
if (m[3] !== MCP_HEADER_MASK) return line; // 用户改过,保留手输新值
|
||||
const ov = i < origVals.length ? origVals[i] : '';
|
||||
i++;
|
||||
return m[1] + m[2] + ov + m[2];
|
||||
const name = headerNameOf(m);
|
||||
if (!(name in origVals)) throw new Error('Header「' + name + '」的值为脱敏占位且找不到原值,请填写真实值');
|
||||
return m[1] + m[2] + origVals[name] + m[2];
|
||||
});
|
||||
}
|
||||
// 整文件编辑的还原链:掩码占位按原文件回填真值;还原不了属于用户输入问题,回 400
|
||||
function unmaskText(text, origText) {
|
||||
try {
|
||||
return restoreApiKeys(restorePasswords(restoreMcpHeaders(text, origText), origText), origText);
|
||||
} catch (e) {
|
||||
e.status_code = 400;
|
||||
throw e;
|
||||
}
|
||||
}
|
||||
// PATCH 细粒度编辑的 headers 还原:值=掩码占位时按键名找回原值(前端只持有脱敏视图,改不动真值)。
|
||||
// 找不到可还原的原值(新增服务/用户改了 header 名)则报错,绝不把占位符写进配置。
|
||||
function restoreHeaderMasks(headers, origHeaders) {
|
||||
@@ -168,13 +239,22 @@ function restoreMaskedHeaderEdit(e, curCfg) {
|
||||
if (e.delete) return;
|
||||
const p = e.path;
|
||||
if (p[0] !== 'mcp_servers') return;
|
||||
const origOf = (i) => (((curCfg || {}).mcp_servers || [])[Number(i)] || {}).headers || {};
|
||||
if (e.append) { // 新增服务没有“原值”可言,出现占位即拒绝
|
||||
if (e.value && e.value.headers) restoreHeaderMasks(e.value.headers, null);
|
||||
return;
|
||||
}
|
||||
if (p.length === 3 && p[2] === 'headers' && e.value && typeof e.value === 'object') {
|
||||
const orig = (((curCfg || {}).mcp_servers || [])[Number(p[1])] || {}).headers || {};
|
||||
restoreHeaderMasks(e.value, orig);
|
||||
restoreHeaderMasks(e.value, origOf(p[1]));
|
||||
return;
|
||||
}
|
||||
// 单个 header 的叶子写入(如 ['mcp_servers',0,'headers','Authorization'])同样要按键名还原;
|
||||
// 漏了这一支会把 ***** 当真值写进 config.yml(前端引导表单不走这条路,但 API 可直达)。
|
||||
if (p.length === 4 && p[2] === 'headers' && e.value === MCP_HEADER_MASK) {
|
||||
const one = {};
|
||||
one[p[3]] = MCP_HEADER_MASK;
|
||||
restoreHeaderMasks(one, origOf(p[1]));
|
||||
e.value = one[p[3]];
|
||||
}
|
||||
}
|
||||
|
||||
@@ -186,7 +266,7 @@ function maskEffective(cfg) {
|
||||
}));
|
||||
c.mcp_servers = (cfg.mcp_servers || []).map(s => {
|
||||
const headers = {};
|
||||
for (const [k, v] of Object.entries(s.headers || {})) headers[k] = maskHeaderValue(v);
|
||||
for (const [k, v] of Object.entries(s.headers || {})) headers[k] = maskHeaderValue(k, v);
|
||||
return Object.assign({}, s, { headers });
|
||||
});
|
||||
c.models = (cfg.models || []).map(m => Object.assign({}, m, { api_key: maskKey(m.api_key) }));
|
||||
@@ -215,13 +295,23 @@ router.get('/', wrap((req, res) => {
|
||||
res.json({ config_path: cfg.config_path || '', exists: text !== null, text: shown, effective: eff, balance_types: balance.types() });
|
||||
}));
|
||||
|
||||
// 预设模板(前端新增平台 / 添加内置 MCP 用)
|
||||
router.get('/presets', wrap((req, res) => { res.json(PRESETS); }));
|
||||
|
||||
// MCP 运行态连接状态(设置页卡片上的「已连接 / 未连接」):只读快照,
|
||||
// 来自 mcp.init 的工具发现结果(含重试阶梯的更新)。重启前改 header 不会反映出来
|
||||
// —— 那些情况由页面顶部的「配置已写入,重启后生效」横幅兜底。
|
||||
router.get('/mcp-status', wrap((req, res) => {
|
||||
res.json({ servers: mcp.statuses() });
|
||||
}));
|
||||
|
||||
// 干跑校验(编辑器保存前预检):body { text }
|
||||
// 还原脱敏后的 api_key/password 再校验,避免 diff 误报变更。
|
||||
router.post('/validate', wrap((req, res) => {
|
||||
const text = req.body && req.body.text;
|
||||
if (typeof text !== 'string') return badRequest(res, new Error('body.text 必须是字符串'));
|
||||
const origText = readConfigText(cfgOf()) || '';
|
||||
const restored = restoreApiKeys(restorePasswords(restoreMcpHeaders(text, origText), origText), origText);
|
||||
const restored = unmaskText(text, origText);
|
||||
try {
|
||||
const next = loadConfigFromText(restored, '');
|
||||
res.json({ ok: true, changed: diffTop(cfgOf(), next) });
|
||||
@@ -237,7 +327,7 @@ router.put('/', wrap((req, res) => {
|
||||
const text = req.body && req.body.text;
|
||||
if (typeof text !== 'string') return badRequest(res, new Error('body.text 必须是字符串'));
|
||||
const origText = readConfigText(cfg) || '';
|
||||
const restored = restoreApiKeys(restorePasswords(restoreMcpHeaders(text, origText), origText), origText);
|
||||
const restored = unmaskText(text, origText);
|
||||
let next;
|
||||
try { next = loadConfigFromText(restored, cfg.config_path); } catch (e) { return badRequest(res, e); }
|
||||
writeConfigText(cfg, restored);
|
||||
@@ -261,8 +351,9 @@ function normEdit(e) {
|
||||
}
|
||||
router.patch('/', wrap((req, res) => {
|
||||
const cfg = cfgOf();
|
||||
const text = readConfigText(cfg);
|
||||
if (text === null) return sendErr(res, Object.assign(new Error('配置文件不存在:' + (cfg.config_path || '(未知路径)')), { status_code: 409 }));
|
||||
// 文件缺失(或曾被 Docker 误建成空目录)不阻塞:以空文档继续,写入时由 writeConfigText 创建。
|
||||
// 前提是父目录可写(容器里 /app 可写);否则 fs.writeFileSync 会报错并在下面回 500。
|
||||
const text = readConfigText(cfg) || '';
|
||||
const body = req.body || {};
|
||||
let edits;
|
||||
try {
|
||||
|
||||
@@ -1,7 +1,9 @@
|
||||
// data-page 技能的服务端承载,两条通道(配套 skills/data-page/SKILL.md 的契约):
|
||||
// 1. GET /app/{task_id}/... —— 静态托管任务目录的 .app/ 子树(index.html 兑底,不给列目录);
|
||||
// 目录名刻意带点:任务文件面板默认隐藏(?hidden=1 才列);
|
||||
// 只暴露 .app/ 而非整个任务目录,其余任务文件不从 URL 泄漏。
|
||||
// 只暴露 .app/ 而非整个任务目录,其余任务文件不从 URL 泄漏;
|
||||
// 允许符号链接(技能页面链回技能目录,不必每会话复制),
|
||||
// 但 realpath 必须落在会话目录或技能根目录内。
|
||||
// 2. POST /api/db/{task_id}/query —— 任务 data.db 的 SQL API(页面前端 fetch 调):任意单语句,
|
||||
// 执行核心与 db 工具共用 runTaskSql(executor.js),语义单一事实源。
|
||||
// 认证:挂在 server.js 的 auth.middleware 之后——信任模型与 files 路由一致(登录 ≈ 运维,可跨会话)。
|
||||
@@ -13,6 +15,7 @@ const fs = require('fs');
|
||||
const path = require('path');
|
||||
const engine = require('../engine');
|
||||
const { resolveInTask, runTaskSql } = require('../tools/executor');
|
||||
const { skillsRoot } = require('../tools/skills');
|
||||
|
||||
// 页面忘写 LIMIT 的服务端兜底:iterate 到量即停(不全量物化),超限报错引导分页。
|
||||
const API_MAX_ROWS = 2000;
|
||||
@@ -23,6 +26,19 @@ function notFound(res, msg) {
|
||||
res.status(404).json({ error: msg });
|
||||
}
|
||||
|
||||
// 符号链接白名单:技能页面不必每个会话复制一份,发布时链回技能目录(见各技能的 run.py)。
|
||||
// 链接只是字符串:executor 里看不到的目标也能被链上,而解析发生在 core 的命名空间
|
||||
// (例如 core 把 ./config.yml 挂在 /app/config.yml),所以 realpath 后必须落在
|
||||
// 「本会话目录」或「技能根目录」内,其余一律 404。
|
||||
function realInside(abs, roots) {
|
||||
let real;
|
||||
try { real = fs.realpathSync(abs); } catch (_) { return null; }
|
||||
for (const root of roots) {
|
||||
if (real === root || real.startsWith(root + path.sep)) return real;
|
||||
}
|
||||
return null;
|
||||
}
|
||||
|
||||
// ---------- /app/{task_id}/...:任务 .app/ 子树静态托管(URL 路径与目录名解耦)----------
|
||||
router.use('/app', (req, res) => {
|
||||
try {
|
||||
@@ -31,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, '非法路径');
|
||||
}
|
||||
@@ -44,7 +70,15 @@ router.use('/app', (req, res) => {
|
||||
try { st = fs.statSync(abs); } catch (_) { return notFound(res, '页面不存在'); }
|
||||
}
|
||||
if (!st.isFile()) return notFound(res, '页面不存在');
|
||||
res.sendFile(abs, err => {
|
||||
const candidates = [engine.taskDirOf(sessionId)];
|
||||
try { candidates.push(skillsRoot({ cfg: engine.getConfig() })); } catch (_) {}
|
||||
const roots = [];
|
||||
for (const dir of candidates) {
|
||||
try { roots.push(fs.realpathSync(dir)); } catch (_) {}
|
||||
}
|
||||
const real = realInside(abs, roots);
|
||||
if (!real) return notFound(res, '页面不存在');
|
||||
res.sendFile(real, err => {
|
||||
if (err && !res.headersSent) notFound(res, '页面不存在');
|
||||
});
|
||||
} catch (err) {
|
||||
|
||||
+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;
|
||||
@@ -16,17 +16,46 @@ function wrap(fn) {
|
||||
}
|
||||
|
||||
// 附件上传只写任务目录文件(见 routes/files.js),消息正文原样入库,不再拼接任何通知行。
|
||||
// delivery:
|
||||
// live(默认,兼容旧调用方/微信)→ 立即入库;回合在跑时下一轮迭代自动带上
|
||||
// queue → 回合在跑时进待投递队列(不落库),回合收尾后自动发出;不在跑则等价于 live
|
||||
// 「干预 / 立即发送」不走这里,而是对已在队列里的条目做升级(POST /pending/:qid)。
|
||||
router.post('/:id/messages', wrap((req, res) => {
|
||||
const content = String((req.body && req.body.content) || '').trim();
|
||||
if (!content) return res.status(400).json({ error: 'content 不能为空' });
|
||||
// deepThink:是否启用模型该「深度思考」参数(thinking_params 合并进上游请求体)
|
||||
const deepThink = !!(req.body && req.body.deepThink);
|
||||
const delivery = String((req.body && req.body.delivery) || 'live');
|
||||
if (delivery === 'queue') {
|
||||
const r = engine.enqueueMessage(req.params.id, content, { deepThink });
|
||||
log.info('msg', (req.user || '-') + ' ' + req.params.id + ' 用户消息(' +
|
||||
(r.queued ? '排队 ' + r.pending_id : r.delivered || '?') + '):' +
|
||||
content.slice(0, 60).replace(/\s+/g, ' '));
|
||||
return res.json(r);
|
||||
}
|
||||
const r = engine.postUserMessage(req.params.id, content, { deepThink });
|
||||
log.info('msg', (req.user || '-') + ' ' + req.params.id + ' 用户消息(' + (r && r.delivered || '?') + '):' +
|
||||
content.slice(0, 60).replace(/\s+/g, ' '));
|
||||
res.json(r);
|
||||
}));
|
||||
|
||||
// 待投递队列:升级队首(干预 / 立即发送)。
|
||||
// 干预 = 等当前工具跑完/本条回复落库后插话;立即发送 = 杀进程 + abort 流,本回合收尾后立刻发。
|
||||
router.post('/:id/pending/:qid', wrap((req, res) => {
|
||||
const action = String((req.body && req.body.action) || 'interject');
|
||||
if (action !== 'interject' && action !== 'now') {
|
||||
return res.status(400).json({ error: 'action 只能是 interject 或 now' });
|
||||
}
|
||||
const r = engine.promotePending(req.params.id, req.params.qid, action);
|
||||
log.info('msg', (req.user || '-') + ' ' + req.params.id + ' 待投递消息 ' + req.params.qid + ' → ' + action);
|
||||
res.json(r);
|
||||
}));
|
||||
|
||||
// 取消一条待投递消息(条幅上的 ×)。
|
||||
router.delete('/:id/pending/:qid', wrap((req, res) => {
|
||||
res.json(engine.cancelPending(req.params.id, req.params.qid));
|
||||
}));
|
||||
|
||||
|
||||
// 覆盖式编辑:删除该条及其后的历史,再以新内容重开一轮(运行中 409)。
|
||||
router.post('/:id/messages/:mid/edit', wrap((req, res) => {
|
||||
|
||||
@@ -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,18 +198,20 @@ 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,
|
||||
// 待投递队列(刷新/换设备后条幅能原样恢复):只在服务端内存里,重启即空
|
||||
pending: engine.listPending(session.id),
|
||||
has_more: hasMore, // 分页模式下:是否还有更早的历史
|
||||
oldest_id: messages.length ? messages[0].id : null, // 本页最早行 id,作为下一页 before 游标
|
||||
});
|
||||
|
||||
@@ -0,0 +1,75 @@
|
||||
// 通用技能执行面:POST /api/sessions/:id/skills/:name/run
|
||||
//
|
||||
// 与 /api/db 的定位对称:data-page 给了页面「通用数据面」,这里补上「通用执行面」。
|
||||
// 页面类技能(如文档审核页)需要用户点一下就在服务端跑一次技能,而不经过模型:
|
||||
// - 不新开技能专属路由,core 不感知任何技能名、参数语义或产物路径;
|
||||
// - 参数校验、相对路径规整、远端 executor、超时/取消全部复用 tools/skills.runSkill,
|
||||
// 与模型侧 skill(op=run) 是同一事实源,不存在第二套执行逻辑;
|
||||
// - 本文件只做会话存在性、并发闸门、HTTP 错误映射。
|
||||
//
|
||||
// 认证:挂在 server.js 的 auth.middleware 之后,信任模型与 data-page/files 一致
|
||||
// (登录 ≈ 运维;能登录的人本来也能通过对话让模型跑任意技能,这里不新增权限面)。
|
||||
// 刻意不加 CORS:跨站 application/json POST 会被预检挡下。
|
||||
//
|
||||
// 并发:同一 (session, skill) 同时只允许一个请求;页面重复点按钮得到 409 而不是双跑。
|
||||
// 单实例内存 Set 即可(仓库整体就是单进程内存模型,重启即清空)。
|
||||
//
|
||||
// 响应契约:
|
||||
// - 进程成功退出 → HTTP 200 {ok:true, result}
|
||||
// stdout 能解析成 JSON 就返回对象,否则原样返回字符串;
|
||||
// - 技能自身业务失败(脚本以 exit 0 + {"ok":false} 表达)仍算进程成功,
|
||||
// 调用方查 result.ok(与 skill 工具的约定一致);
|
||||
// - 进程失败/超时 → HTTP 200 {ok:false, error}(与 data-page 的「HTTP 200 + error」一致);
|
||||
// - 会话不存在 / 参数形状错误 → 4xx {ok:false, error}。
|
||||
'use strict';
|
||||
const express = require('express');
|
||||
const engine = require('../engine');
|
||||
const skills = require('../tools/skills');
|
||||
const log = require('../log');
|
||||
|
||||
const router = express.Router();
|
||||
const inflight = new Set();
|
||||
|
||||
function sendErr(res, code, msg) {
|
||||
res.status(code).json({ ok: false, error: msg });
|
||||
}
|
||||
|
||||
router.post('/:id/skills/:name/run', async (req, res) => {
|
||||
const sessionId = req.params.id;
|
||||
const name = String(req.params.name || '').trim();
|
||||
if (!engine.getSession(sessionId)) return sendErr(res, 404, '会话不存在');
|
||||
if (!name) return sendErr(res, 400, '技能名不能为空');
|
||||
|
||||
const body = req.body || {};
|
||||
const args = body.args === undefined ? {} : body.args;
|
||||
if (args === null || typeof args !== 'object' || Array.isArray(args)) {
|
||||
return sendErr(res, 400, 'args 必须是 JSON 对象');
|
||||
}
|
||||
|
||||
const key = sessionId + '\n' + name;
|
||||
if (inflight.has(key)) return sendErr(res, 409, '该技能正在执行,请稍候');
|
||||
inflight.add(key);
|
||||
const t0 = Date.now();
|
||||
try {
|
||||
const ctx = {
|
||||
sessionId,
|
||||
taskDir: engine.taskDirOf(sessionId),
|
||||
cfg: engine.getConfig(),
|
||||
};
|
||||
const out = await skills.runSkill(ctx, name, args);
|
||||
let result = out;
|
||||
try { result = JSON.parse(out); } catch (_) { /* 非 JSON 技能:原样返回字符串 */ }
|
||||
log.info('skills', sessionId + ' HTTP 运行 ' + name + ' 完成(' + (Date.now() - t0) + 'ms)');
|
||||
res.json({ ok: true, result });
|
||||
} catch (err) {
|
||||
const msg = String((err && err.message) || err || '技能执行失败');
|
||||
if (err && err.name === 'SkillNotFoundError') return sendErr(res, 404, msg);
|
||||
// 脚本失败/超时不冒充 5xx:调用方统一查 ok/error(与 data-page 契约一致)
|
||||
log.warn('skills', sessionId + ' HTTP 运行 ' + name + ' 失败(' + (Date.now() - t0) + 'ms):' + msg.split('\n')[0]);
|
||||
res.json({ ok: false, error: msg });
|
||||
} finally {
|
||||
inflight.delete(key);
|
||||
}
|
||||
});
|
||||
|
||||
module.exports = router;
|
||||
@@ -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.3.0';
|
||||
const VERSION = '2.5.0';
|
||||
// git 提交号单独返回(提交时 post-commit 钩子自动生成),前端只显示简洁版本号
|
||||
const VERSION_COMMIT = versionInfo.commit || '';
|
||||
|
||||
|
||||
+57
-5
@@ -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,10 +78,22 @@ 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'));
|
||||
// 通用技能执行面(页面类技能用,不经模型):POST /api/sessions/:id/skills/:name/run。
|
||||
// 与 /api/db 对称;执行核心仍复用 tools/skills.runSkill,core 不感知具体技能。
|
||||
app.use('/api/sessions', require('./routes/skill-run'));
|
||||
app.use('/api/skills', require('./routes/skills'));
|
||||
// 语音识别(可选):录音在客户端(套壳 App 原生桥或浏览器 MediaRecorder),转写在 mcp_asr。
|
||||
// ASR_URL 为空、或 config.yml 里没有启用的 asr 段时接口回 503,前端据此不显示麦克风按钮(见 routes/asr.js)。
|
||||
app.use('/api/asr', require('./routes/asr'));
|
||||
// 系统配置含全部用户(脱敏密码)与平台密钥,且可整份改写 YAML:仅管理员可访问。
|
||||
app.use('/api/config', auth.requireAdmin, require('./routes/config'));
|
||||
app.use('/api/platforms', require('./routes/platforms'));
|
||||
@@ -142,9 +168,33 @@ app.get('/api/models', (req, res) => {
|
||||
res.json(rows);
|
||||
});
|
||||
|
||||
app.get('/api/health', (req, res) => res.json({ ok: true, time: Date.now() }));
|
||||
// 探活 + 服务器地址校验(免认证,见 auth.js 的 PUBLIC_EXACT)。
|
||||
// 套壳 App / 运维脚本会手动填服务器地址,必须能判断“这个地址到底是不是本服务”:
|
||||
// 只认 HTTP 200 + body.ok===true + service==='agent-core',不能只看状态码——
|
||||
// 填到别的站点、反代首页或劫持页同样可能回 200。
|
||||
// no-store:避免 WebView / 反向代理 / Service Worker 把旧响应当成“服务在线”。
|
||||
// auth_required 让客户端区分“连上了但没登录”和“地址填错了”。
|
||||
app.get('/api/health', (req, res) => {
|
||||
res.setHeader('Cache-Control', 'no-store');
|
||||
res.json({
|
||||
ok: true,
|
||||
service: 'agent-core',
|
||||
api: 1, // 接口代际:未来出现不兼容改动时升,客户端据此提示升级
|
||||
time: Date.now(),
|
||||
auth_required: !!(cfg.auth && cfg.auth.users && cfg.auth.users.length),
|
||||
});
|
||||
});
|
||||
|
||||
// 统一错误出口:**必须最后挂**(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)。包含:
|
||||
@@ -187,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);
|
||||
@@ -207,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.
|
||||
@@ -1,109 +1,59 @@
|
||||
You are a general-purpose task assistant running on a private server via a web
|
||||
interface. You help with file generation, data processing, web fetching,
|
||||
You are a general-purpose task assistant on a private server, reached through a
|
||||
web interface. You help with file generation, data processing, web fetching,
|
||||
running commands, writing scripts, and similar tasks.
|
||||
|
||||
You have a dedicated working directory for each conversation. All file paths in
|
||||
tool calls are relative to that directory unless otherwise specified.
|
||||
Each conversation has its own working directory; tool paths are relative to it
|
||||
unless stated otherwise. Uploaded files appear there.
|
||||
|
||||
## Scope & Capability Boundaries
|
||||
## Capabilities
|
||||
|
||||
You are a file / data / information processing assistant. The tools available
|
||||
to you vary by session — always check the live tool list before answering.
|
||||
Your capabilities are exactly what the live tool list and the skills list below
|
||||
expose — they vary by session, so check them before answering. Do not assume a
|
||||
capability that isn't there.
|
||||
|
||||
In scope: understanding images (describe, OCR, read charts); deterministic image
|
||||
operations (format conversion, resize, crop, watermark); generative image
|
||||
creation and editing when an image skill/tool is available; charts and diagrams
|
||||
from data; document processing and conversion (PDF / Markdown / Word / Excel /
|
||||
PowerPoint); data processing; running scripts and commands; fetching and
|
||||
summarizing web information; audio/video transcoding and basic editing;
|
||||
generative media when a tool or skill for it is present in the current session
|
||||
(read that tool's or skill's own description for its capabilities and limits);
|
||||
SQLite operations.
|
||||
Never fake results: no placeholder files, no claiming a file was created, no
|
||||
crude substitutes (ASCII art, hand-drawn SVG) for what the user actually wants.
|
||||
|
||||
Out of scope: capabilities no available tool exposes in this session. Do not
|
||||
fake results — no placeholder files, no claiming a file was created, no crude
|
||||
substitutes (ASCII art, hand-drawn SVG) for what the user actually wants.
|
||||
|
||||
When the user asks for something that seems out of scope:
|
||||
|
||||
- Before concluding you can't do it, check for combinations: chaining tools, or
|
||||
combining tools with the user's own environment (their browser or device).
|
||||
Some requests are impossible from the server alone but become possible when
|
||||
the work is split between the server and the user's side.
|
||||
- If an available skill might handle it, check the skill before declaring it out
|
||||
of scope.
|
||||
- If it truly can't be done, say so in one or two sentences and stop — do not
|
||||
call tools just to reject a request, do not over-apologize. If a third-party
|
||||
tool covers it, mention one briefly. If part of the request is doable, offer
|
||||
that part.
|
||||
|
||||
## Communication
|
||||
|
||||
- Be concise and direct. Use plain language; format with Markdown when useful.
|
||||
- Be truthful. If unsure, say so.
|
||||
- Do not over-apologize.
|
||||
If something seems impossible, check relevant skills first, then whether tools
|
||||
can be combined, or whether the work can be split with the user's own
|
||||
environment (their browser or device). If it truly can't be done, say so in one
|
||||
or two sentences and offer whatever part is doable; do not call tools just to
|
||||
reject a request.
|
||||
|
||||
## Work Principles
|
||||
|
||||
- **Choose the simplest reliable path.** Prefer standard library or built-in
|
||||
tools. If a required package is missing, install it into a session-local venv
|
||||
when possible; otherwise use a fallback or report the limitation.
|
||||
- **Stop after repeated failures.** If the same approach fails more than once or
|
||||
twice, switch to a different approach or report failure. Do not keep retrying
|
||||
the same method.
|
||||
- **Report progress.** If a task will take many steps, state your plan briefly
|
||||
first and give periodic updates. Do not run silently for a long stretch.
|
||||
- **Match effort to the task.** Do not write complex scripts where a few
|
||||
commands suffice, and do not verify more deeply than the task requires. One
|
||||
basic check that the output is usable is enough.
|
||||
- Choose the simplest reliable path; do not write a script where a few commands
|
||||
suffice.
|
||||
- If the same approach fails twice, switch approaches or report the failure —
|
||||
do not keep retrying.
|
||||
- For multi-step work, state the plan briefly and give periodic updates.
|
||||
- Match effort to the task: one basic check that the output is usable is enough.
|
||||
|
||||
## Tool Use
|
||||
## Tools
|
||||
|
||||
- Use the most appropriate tool for each step.
|
||||
- Independent tool calls can be made in parallel.
|
||||
- Follow the parameter schemas exactly; parameters are passed as top-level
|
||||
fields of the tool call arguments.
|
||||
- Skills marked **required** in the skill list below must be used for their
|
||||
scope — do not hand-write scripts to accomplish what a required skill already
|
||||
does. For other skills, prefer them when they match the task.
|
||||
- `mint_public_link` creates a public, unauthenticated URL — never use it for
|
||||
files containing secrets. For image editing, minting the reference image is
|
||||
the intended path; the link is temporary but publicly reachable.
|
||||
- Independent calls can run in parallel. Parameters are top-level fields of the
|
||||
tool call arguments — follow the schema exactly.
|
||||
- `mint_public_link` makes a file publicly reachable without authentication —
|
||||
never use it for files containing secrets.
|
||||
|
||||
## Skill Use
|
||||
|
||||
Before writing a script or installing a package, check the skill list below.
|
||||
If a skill covers the task, use it instead of reimplementing the same job in
|
||||
ad-hoc code — skills already handle the server-specific pitfalls. Read its
|
||||
interface with the `skill` tool (`{"op":"get","name":"<skill>"}`) before the
|
||||
first run, once per skill per conversation. `required` marks the skills whose
|
||||
domain must never be hand-rolled.
|
||||
|
||||
{APP_SKILLS_SECTION}
|
||||
|
||||
## File Management
|
||||
## Communication
|
||||
|
||||
- Work inside the working directory. Use clear file names.
|
||||
- Uploaded files appear in the working directory; check with `terminal` (e.g.
|
||||
`ls`) if needed.
|
||||
- Be concise and direct; Markdown when useful. If unsure, say so. Don't
|
||||
over-apologize.
|
||||
- When done, briefly state what was done and list created/modified files. Offer
|
||||
follow-ups only when useful.
|
||||
|
||||
## Completion
|
||||
## Environment
|
||||
|
||||
- After finishing, briefly state what was done and list created/modified files.
|
||||
- Offer follow-up options only if useful; do not do extra work automatically.
|
||||
|
||||
## System Environment
|
||||
|
||||
- OS: linux. Shell commands run under POSIX sh (`/bin/sh` is dash); use `bash`
|
||||
for scripts (`run.sh`). Keep `terminal` one-liners POSIX-compatible.
|
||||
- Isolated container: a command can access the session working directory, a
|
||||
session-scoped `/tmp`, read-only `/workspace/skills`, and read-only system
|
||||
paths. It cannot see other sessions.
|
||||
- `/tmp` is usable for scratch across `terminal` calls in the same conversation.
|
||||
`/dev/shm` and `/var/tmp` reset on every `terminal` call — do not use them to
|
||||
carry state across calls.
|
||||
- Python 3.11 is available; the system Python and its packages are read-only.
|
||||
To add packages, create a virtualenv inside the working directory
|
||||
(`python3 -m venv --system-site-packages .venv`, then `.venv/bin/pip` and `.venv/bin/python`).
|
||||
Keep it in the working directory, not `/tmp`.
|
||||
The venv inherits system packages; do not reinstall packages that are
|
||||
already importable. Only install what is missing.
|
||||
- System packages cannot be installed at runtime (`apt-get install` fails on the
|
||||
read-only root filesystem). If a required CLI tool is missing, tell the user
|
||||
it must be added on the server.
|
||||
- No C/C++ compiler or `make` — `pip install` works only for packages that ship
|
||||
a prebuilt wheel or are pure Python.
|
||||
- For Chinese text in matplotlib: set `font.sans-serif` to `Noto Sans CJK SC`.
|
||||
- For Chinese ZIP files with GBK filenames, prefer `unar` or `7z x` to avoid
|
||||
garbled names; in Python, use automatic encoding detection.
|
||||
{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
|
||||
+42
-15
@@ -3,9 +3,14 @@ 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:
|
||||
# 无 nginx-proxy:直接把容器 8090 映射到宿主机端口,用 http://<服务器IP>:<AGENT_PORT> 访问。
|
||||
# 改端口:在仓库顶层 .env 里设 AGENT_PORT(默认 8090)。
|
||||
# 直接把容器 8090 映射到宿主机端口,用 http://<服务器IP>:<AGENT_PORT> 访问。
|
||||
- "${AGENT_PORT:-8090}:8090"
|
||||
volumes:
|
||||
- ./tasks:/workspace/tasks # 持久化:任务目录
|
||||
@@ -20,10 +25,18 @@ services:
|
||||
- EXECUTOR_URL=http://agent-executor:9000
|
||||
# 调用鉴权 token:两侧同一值。从 .env 读取(已 gitignore),不再硬编码进仓库;
|
||||
# 未设置则 compose 直接报错,避免静默无鉴权。生成:openssl rand -hex 32
|
||||
- EXECUTOR_TOKEN=${EXECUTOR_TOKEN:?EXECUTOR_TOKEN not set - see .env.example}
|
||||
- EXECUTOR_TOKEN=${EXECUTOR_TOKEN:?EXECUTOR_TOKEN not set - run scripts/init.sh}
|
||||
# 微信接入
|
||||
- WXBOT_URL=http://agent-wxbot:8093
|
||||
- WXBOT_TOKEN=${WXBOT_TOKEN:?WXBOT_TOKEN not set - run scripts/init.sh}
|
||||
# 语音识别(可选):core 拼 /transcribe 的基地址,固定指向栈内 mcp_asr。
|
||||
- ASR_URL=http://mcp_asr:3000
|
||||
# 对外地址: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
|
||||
|
||||
@@ -79,8 +92,8 @@ services:
|
||||
- ./skills:/workspace/skills:ro # 技能目录:所有任务/会话共享同一份技能
|
||||
environment:
|
||||
- PORT=9000
|
||||
# 与 agent-core 侧同一值,从 .env 读取(见 .env.example):
|
||||
- EXECUTOR_TOKEN=${EXECUTOR_TOKEN:?EXECUTOR_TOKEN not set - see .env.example}
|
||||
# 与 agent-core 侧同一值,从根 .env 读取(scripts/init.sh 生成):
|
||||
- EXECUTOR_TOKEN=${EXECUTOR_TOKEN:?EXECUTOR_TOKEN not set - run scripts/init.sh}
|
||||
# 日志等级:debug|info|warn|error|none(默认 info);
|
||||
# debug 会把与 core 的完整交互打印出来(请求、/exec 请求体、每条 SSE 帧、JSON 响应):
|
||||
- EXECUTOR_LOG_LEVEL=info
|
||||
@@ -168,9 +181,6 @@ services:
|
||||
timeout: 5s
|
||||
retries: 5
|
||||
start_period: 5s
|
||||
# 调试用(默认关):
|
||||
# ports:
|
||||
# - "${WEB_SEARCH_PORT:-8081}:3000"
|
||||
networks:
|
||||
- agent-mcp-net
|
||||
|
||||
@@ -184,9 +194,6 @@ services:
|
||||
timeout: 5s
|
||||
retries: 5
|
||||
start_period: 5s
|
||||
# 调试用(默认关):
|
||||
# ports:
|
||||
# - "${IMAGE_TASK_PORT:-8082}:3000"
|
||||
networks:
|
||||
- agent-mcp-net
|
||||
|
||||
@@ -200,14 +207,34 @@ services:
|
||||
timeout: 5s
|
||||
retries: 5
|
||||
start_period: 5s
|
||||
# 调试用(默认关;这里映的是 MCP 端口,会暴露 /mcp,仅本机短时调试用):
|
||||
# ports:
|
||||
# - "${VIDEO_TASK_PORT:-8083}:3000"
|
||||
networks:
|
||||
- agent-mcp-net
|
||||
|
||||
# 语音识别:录音在客户端(套壳 App 原生桥 / 浏览器 MediaRecorder),转写在这里。
|
||||
# 同进程两个入口(见 mcp/asr/src/server.js 头注释):
|
||||
# POST /transcribe ← agent-core 的 /api/asr 转发(输入框,低延迟、不经过模型)
|
||||
# POST /mcp ← 模型的 MCP 工具 transcribe_audio({url})(转写任务目录里的音频)
|
||||
# 本容器不存任何平台密钥:上游走 OpenAI 兼容的 /audio/transcriptions,key / base_url / model
|
||||
# 全部由调用方随请求 header 带入(core 从 config.yml 的 mcp_servers 里 asr.headers 取)。
|
||||
# 换 ASR 平台 → 改 config.yml 后重启 core,本服务不用动、也不用重建镜像。
|
||||
mcp_asr:
|
||||
build: ./mcp/asr
|
||||
container_name: mcp_asr
|
||||
restart: unless-stopped
|
||||
healthcheck:
|
||||
test: ["CMD", "node", "-e", "fetch('http://127.0.0.1:3000/health').then(r => process.exit(r.ok ? 0 : 1)).catch(() => process.exit(1))"]
|
||||
interval: 10s
|
||||
timeout: 5s
|
||||
retries: 5
|
||||
start_period: 5s
|
||||
environment:
|
||||
- ASR_LOG_LEVEL=${ASR_LOG_LEVEL:-info}
|
||||
- TZ=Asia/Shanghai
|
||||
networks:
|
||||
- agent-mcp-net
|
||||
|
||||
networks:
|
||||
# 全部服务共用一个网络;由本仓库创建(固定名字,避免被加上 compose 项目名前缀)。
|
||||
# 全部服务共用一个网络;由本仓库创建
|
||||
# - core 与 executor 靠它按容器名访问 MCP 服务(如 http://mcp_web_search:3000/)
|
||||
# - 外部服务取参考图走的是 core 对外的 GET /p/<id>(见 public_link):AI 调内置工具
|
||||
# mint_public_link 在 core 进程内现签短链,不需要 executor 反查 core 的额外端口
|
||||
|
||||
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 信封。
|
||||
|
||||
Some files were not shown because too many files have changed in this diff Show More
Reference in New Issue
Block a user