Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 1 addition & 1 deletion content/projects/agent-webtool/docs/cli.md
Original file line number Diff line number Diff line change
Expand Up @@ -8,7 +8,7 @@ date: "2026-10-06"

## 抓取网页

以下示例基于已安装的 0.7.0:
以下示例基于已安装的 0.7.1:

```sh
webtool fetch https://example.com
Expand Down
16 changes: 8 additions & 8 deletions content/projects/agent-webtool/docs/installation.md
Original file line number Diff line number Diff line change
Expand Up @@ -3,7 +3,7 @@ id: "docs-agent-webtool-installation"
slug: "installation"
title: "安装与快速开始"
description: "使用 npm 或 Bun 安装公开版本,选择 SDK、CLI 或 MCP 入口。"
date: "2026-10-06"
date: "2026-10-11"
---

## 运行环境
Expand All @@ -15,32 +15,32 @@ date: "2026-10-06"
以下命令使用固定的公开版本:

```sh
npx -y agent-webtool@0.7.0 fetch https://example.com
npx -y agent-webtool@0.7.0 search "Bun runtime" --limit 5
npx -y agent-webtool@0.7.1 fetch https://example.com
npx -y agent-webtool@0.7.1 search "Bun runtime" --limit 5
```

Bun 用户可将 `npx -y` 替换为 `bunx`。执行时需要访问 npm 和目标网页;网络错误不代表安装失败。

## 安装到项目

```sh
npm install agent-webtool@0.7.0
npm install agent-webtool@0.7.1
# 或
bun add agent-webtool@0.7.0
bun add agent-webtool@0.7.1
```

通过 [SDK](/agent-webtool/docs/sdk) 导入 `webFetch` 与 `webSearch`。如果只需要终端命令,也可以全局安装:

```sh
npm install -g agent-webtool@0.7.0
npm install -g agent-webtool@0.7.1
webtool --version
agent-webtool --version
```

两个命令名称指向相同入口,均应输出 `0.7.0`。MCP 客户端配置见 [MCP 接入](/agent-webtool/docs/mcp)。
两个命令名称指向相同入口,均应输出 `0.7.1`。MCP 客户端配置见 [MCP 接入](/agent-webtool/docs/mcp)。

## 版本边界

2026-10-06 已在独立目录安装公开 0.7.0,验证 ESM/CJS、TypeScript、两个 CLI、MCP 及来源上下文;公开归档与 GitHub 流水线验收归档逐字节一致。0.7.0 新增 `SourceContext` 和 `createSourceContext`,从 0.6.0 升级后现有调用继续可用,独立会话可按 [SDK 指南](/agent-webtool/docs/sdk) 接入。
2026-10-11 已在独立目录安装公开 0.7.1,验证 ESM/CJS、TypeScript、两个 CLI、MCP 及来源上下文;公开归档与 GitHub 流水线验收归档逐字节一致。0.7.0 起提供 `SourceContext` 和 `createSourceContext`,从 0.6.0 升级后现有调用继续可用,独立会话可按 [SDK 指南](/agent-webtool/docs/sdk) 接入。

本次没有验收真实搜索引擎的联网结果。多引擎状态及常见失败说明见 [命令行](/agent-webtool/docs/cli)。升级时应先阅读适用版本与迁移说明,再更新依赖版本。
12 changes: 6 additions & 6 deletions content/projects/agent-webtool/docs/mcp.md
Original file line number Diff line number Diff line change
Expand Up @@ -9,7 +9,7 @@ date: "2026-10-06"
## 启动服务

```sh
npx -y agent-webtool@0.7.0 mcp
npx -y agent-webtool@0.7.1 mcp
```

服务通过标准输入输出传输 MCP 消息,默认提供 `web_fetch` 和 `web_search`。它由客户端作为子进程管理,不是 HTTP 服务,无需另开监听端口。输出用于协议通信,不应当作普通终端抓取结果使用。
Expand All @@ -23,21 +23,21 @@ npx -y agent-webtool@0.7.0 mcp
"mcpServers": {
"webtool": {
"command": "npx",
"args": ["-y", "agent-webtool@0.7.0", "mcp"]
"args": ["-y", "agent-webtool@0.7.1", "mcp"]
}
}
}
```

配置文件位置和启用方式由各客户端决定。Bun 用户可将 `command` 改为 `bunx`,`args` 改为 `["agent-webtool@0.7.0", "mcp"]`。
配置文件位置和启用方式由各客户端决定。Bun 用户可将 `command` 改为 `bunx`,`args` 改为 `["agent-webtool@0.7.1", "mcp"]`。

## 选择工具

```sh
npx -y agent-webtool@0.7.0 mcp --tools fetch
npx -y agent-webtool@0.7.0 mcp --tools fetch,search
npx -y agent-webtool@0.7.1 mcp --tools fetch
npx -y agent-webtool@0.7.1 mcp --tools fetch,search
```

`fetch` 对应 `web_fetch`,`search` 对应 `web_search`。工具返回 MCP 文本内容;出错时提供错误标记及说明。搜索的引擎选择、超时、站点和时间条件由工具输入传入,具体以客户端读取到的 schema 为准。

本次已验证公开 0.7.0 的初始化、工具列表、工具筛选及非法 URL 错误返回;没有逐一验证具体 MCP 客户端或真实搜索结果。SDK 的显式会话上下文参数不属于 MCP 输入;需要独立来源存储的应用应通过 SDK 接入。
本次已验证公开 0.7.1 的初始化、工具列表、工具筛选及非法 URL 错误返回;没有逐一验证具体 MCP 客户端或真实搜索结果。SDK 的显式会话上下文参数不属于 MCP 输入;需要独立来源存储的应用应通过 SDK 接入。
2 changes: 1 addition & 1 deletion content/projects/agent-webtool/docs/sdk.md
Original file line number Diff line number Diff line change
Expand Up @@ -6,7 +6,7 @@ description: "抓取网页、读取结构化搜索结果,并理解来源编号
date: "2026-10-06"
---

## 抓取与搜索(0.7.0)
## 抓取与搜索(0.7.1)

```ts
import { webFetch, webSearch } from "agent-webtool";
Expand Down
4 changes: 2 additions & 2 deletions content/projects/agent-webtool/index.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -8,7 +8,7 @@ tags: ["Agent", "搜索", "MCP"]
stack: ["TypeScript", "Node.js", "Bun"]
status: "已发布"
category: "Agent 工具"
source: "https://github.com/potato47/agent-webtool"
source: "https://github.com/semicoder-dev/agent-webtool"
start: { "label": "安装与使用", "doc": "docs-agent-webtool-installation" }
---

Expand All @@ -33,4 +33,4 @@ SDK 面向服务端,不是浏览器组件,也不包含模型或 agent loop

## 版本

本指南面向已发布的 npm **0.7.0**。该版本新增会话来源隔离 `SourceContext`、快照恢复和缓存容量修复,原有 SDK 调用与 CLI/MCP 参数保持兼容。查看 [0.7.0 更新说明](https://github.com/potato47/agent-webtool/releases/tag/v0.7.0)。
本指南面向已发布的 npm **0.7.1**,源码和可信发布已迁入 `semicoder-dev` 组织,包名及 SDK/CLI/MCP 契约保持不变。0.7.0 起提供会话来源隔离 `SourceContext`、快照恢复和缓存容量修复。查看 [0.7.1 固定源码](https://github.com/semicoder-dev/agent-webtool/tree/v0.7.1)。
10 changes: 5 additions & 5 deletions content/projects/fia/docs/distribution.md
Original file line number Diff line number Diff line change
Expand Up @@ -10,11 +10,11 @@ date: "2026-10-09"

核对日期:2026-10-09。

| 产物 | 获取方式 | 范围 |
| --------------------- | ---------------------------------------------------------------- | ----------------------------------------------------------------------- |
| FIA npm 0.18.0 | [npm](https://www.npmjs.com/package/@semicoder/fia) | 新增原生标题栏置顶;包含默认浏览器界面、隔离预览、应用子命令和 DMG 分发 |
| 麻辣烫固定 FIA 0.18.0 | [框架归档](https://github.com/potato47/fia/releases/tag/v0.18.0) | 源码 `85206f6f5322`,与公开 npm 0.18.0 和 Actions artifact 逐字节一致 |
| 麻辣烫应用 | [下载与安装说明](/malatang/docs/installation) | 0.4.0 / Build 4 正式 DMG,macOS 14+ / Apple Silicon |
| 产物 | 获取方式 | 范围 |
| --------------------- | --------------------------------------------------------------------- | ----------------------------------------------------------------------- |
| FIA npm 0.18.0 | [npm](https://www.npmjs.com/package/@semicoder/fia) | 新增原生标题栏置顶;包含默认浏览器界面、隔离预览、应用子命令和 DMG 分发 |
| 麻辣烫固定 FIA 0.18.0 | [框架归档](https://github.com/semicoder-dev/fia/releases/tag/v0.18.0) | 源码 `85206f6f5322`,与公开 npm 0.18.0 和 Actions artifact 逐字节一致 |
| 麻辣烫应用 | [下载与安装说明](/malatang/docs/installation) | 0.4.0 / Build 4 正式 DMG,macOS 14+ / Apple Silicon |

框架归档 `.tgz` 是开发依赖,不是双击安装的应用。FIA 4 的“4”也不是 npm 版本号。

Expand Down
4 changes: 2 additions & 2 deletions content/projects/fia/index.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -8,7 +8,7 @@ tags: ["桌面开发", "TypeScript", "Agent"]
stack: ["Swift Host", "Bun", "React"]
status: "已发布"
category: "桌面应用框架"
source: "https://github.com/potato47/fia"
source: "https://github.com/semicoder-dev/fia"
featured: true
start: { "label": "安装 FIA", "doc": "docs-fia-installation" }
---
Expand Down Expand Up @@ -47,4 +47,4 @@ bun run dev

FIA 4 表示架构代际,npm 包当前为 **0.18.0**。本站教程面向这个已发布版本,新增原生标题栏置顶,包含默认浏览器入口、原生外观、登录回调、应用子命令、隔离预览和 DMG 分发。麻辣烫 0.4.0 使用同一份 FIA 0.18.0 公开归档,已接入置顶按钮。见 [构建与分发](/fia/docs/distribution)。

截至 2026-10-09,[源码仓库](https://github.com/potato47/fia) 已公开,正式包通过 [npm](https://www.npmjs.com/package/@semicoder/fia) 获取。
截至 2026-10-09,[源码仓库](https://github.com/semicoder-dev/fia) 已公开,正式包通过 [npm](https://www.npmjs.com/package/@semicoder/fia) 获取。
6 changes: 5 additions & 1 deletion content/projects/malatang/docs/getting-started.md
Original file line number Diff line number Diff line change
Expand Up @@ -67,6 +67,10 @@ date: "2026-10-11"

凭证改为明文文件,不迁移旧 ChatGPT 钥匙串登录。升级后重新登录、删除旧的未连接订阅模型,再从新账号目录添加,普通 API Key 和历史保留。原生运行时改变,需要完整 DMG;见[安装说明](/malatang/docs/installation#后续更新)。

## 升级到 0.4.2
## 升级到 0.4.3

项目已迁入 `semicoder-dev` 组织,应用更新源与默认官方插件源同步切换。旧版使用完整 DMG 安装新版;已有市场来源需按[安装页](/malatang/docs/installation#后续更新)手动替换,不自动迁移旧地址。

### 从 0.4.1 或更早版本升级

升级前在旧版卸载手动安装的插件,再用完整 DMG 替换应用。新宿主不迁移旧安装记录,保留模型、凭证、KV 和历史;翻译和随手记从市场重新安装。详情见[升级说明](/malatang/docs/installation#后续更新)。
24 changes: 13 additions & 11 deletions content/projects/malatang/docs/installation.md
Original file line number Diff line number Diff line change
Expand Up @@ -10,11 +10,11 @@ date: "2026-10-10"

麻辣烫官网位于 [Semicoder 的麻辣烫项目页](/malatang),本页是统一安装入口。

**当前版本:0.4.2(Build 6)。** 支持 **macOS 14 及以上、Apple Silicon(M 系列)**;当前不支持 Intel、Windows 或 Linux。应用和 DMG 已使用 Developer ID 签名,DMG 已通过 Apple 公证。
**当前版本:0.4.3(Build 7)。** 支持 **macOS 14 及以上、Apple Silicon(M 系列)**;当前不支持 Intel、Windows 或 Linux。应用和 DMG 已使用 Developer ID 签名,DMG 已通过 Apple 公证。

- [下载麻辣烫 0.4.2 DMG](https://github.com/potato47/malatang/releases/download/v0.4.2/Malatang-0.4.2-6-mac-arm64.dmg)
- [下载 SHA-256 校验文件](https://github.com/potato47/malatang/releases/download/v0.4.2/Malatang-0.4.2-6-mac-arm64.dmg.sha256)
- [查看本次发行说明](https://github.com/potato47/malatang/releases/tag/v0.4.2)
- [下载麻辣烫 0.4.3 DMG](https://github.com/semicoder-dev/malatang/releases/download/v0.4.3/Malatang-0.4.3-7-mac-arm64.dmg)
- [下载 SHA-256 校验文件](https://github.com/semicoder-dev/malatang/releases/download/v0.4.3/Malatang-0.4.3-7-mac-arm64.dmg.sha256)
- [查看本次发行说明](https://github.com/semicoder-dev/malatang/releases/tag/v0.4.3)

使用应用无需安装 Git、Bun 或 Swift。首次安装:

Expand All @@ -26,21 +26,21 @@ date: "2026-10-10"
如需校验下载完整性,将 DMG 和校验文件放在同一目录,进入该目录执行:

```bash
shasum -a 256 -c Malatang-0.4.2-6-mac-arm64.dmg.sha256
shasum -a 256 -c Malatang-0.4.3-7-mac-arm64.dmg.sha256
```

应显示 `Malatang-0.4.2-6-mac-arm64.dmg: OK`。校验失败时重新下载,不继续安装。
应显示 `Malatang-0.4.3-7-mac-arm64.dmg: OK`。校验失败时重新下载,不继续安装。

## 从源码构建

仅开发者需要本节。以下固定使用公开 **v0.4.2** 标签,FIA 源码位于同仓的 `framework/fia/`,与应用一起构建,不再下载相邻框架归档。本机构建不会自动获得官方签名和公证。
仅开发者需要本节。以下固定使用公开 **v0.4.3** 标签,FIA 源码位于同仓的 `framework/fia/`,与应用一起构建,不再下载相邻框架归档。本机构建不会自动获得官方签名和公证。

需要 Git、**Bun 1.4.3 和 Swift 6 工具链**(Xcode / Command Line Tools);系统要求与 DMG 相同。Bun 的安装方法见[官方说明](https://bun.sh/docs/installation)。在新建目录执行,不要覆盖已有项目。

### 获取固定源码

```bash
git clone --branch v0.4.2 --single-branch https://github.com/potato47/malatang.git
git clone --branch v0.4.3 --single-branch https://github.com/semicoder-dev/malatang.git
cd malatang
bun install --frozen-lockfile --ignore-scripts
```
Expand Down Expand Up @@ -71,11 +71,13 @@ open dist/Malatang.app

## 后续更新

稳定更新源提供 0.4.2(Build 6)清单。本版取消内置插件并调整安装记录,**升级前在旧版应用中卸载所有手动安装插件,再退出旧应用,用完整 DMG 替换安装**。内置翻译无需卸载,新版从官方市场重新安装翻译与随手记。
组织迁移使用新的更新源 `https://semicoder-dev.github.io/malatang/updates/latest.json`。旧版客户端需下载完整 DMG 安装新版,不提供旧更新地址回退或自动迁移。已有数据目录中的旧市场源和插件来源绑定不会自动改写;先卸载来自旧源的插件(保留其 KV 和历史),在应用中心删除旧源,再添加 `https://raw.githubusercontent.com/semicoder-dev/malatang-plugins/main/marketplace.json`。随后从新源重新安装插件。新数据目录默认使用该官方源。

本版不迁移旧插件安装记录。若旧手动记录仍存在,新版可能无法读取 `platform.json` 并启动;请回旧版完成卸载。不要删除整个数据目录或 `platform.json`,其中包含模型配置、API Key、KV 和历史。宿主不会主动清除模型、凭证、KV 和历史,相同插件 ID 可继续访问原有 KV。
稳定更新源提供 0.4.3(Build 7)签名清单。0.4.2 起取消内置插件并调整安装记录;从 0.4.1 或更早版本升级时,**先在旧版应用中卸载所有手动安装插件,再退出旧应用,用完整 DMG 替换安装**。内置翻译无需卸载,新版从官方市场重新安装翻译与随手记。

SDK 0.3.1 的 manifest 仍为 0.3,官方插件使用固定公开 SDK 0.3.0 独立构建。SDK 0.2 及更早插件仍需按[插件迁移](/malatang/docs/plugin-development#打包安装与旧插件迁移)更新重建。从 0.4.0 或更早升级时,ChatGPT 旧钥匙串登录不迁移,需重新登录并从新账号目录添加模型;见[凭证与数据](/malatang/docs/models#凭证与数据)。跨版本代码热更新未实测,本次以完整安装包验收。
本版不迁移 0.4.1 及更早的插件安装记录。若这些旧手动记录仍存在,新版可能无法读取 `platform.json` 并启动;请回旧版完成卸载。不要删除整个数据目录或 `platform.json`,其中包含模型配置、API Key、KV 和历史。宿主不会主动清除模型、凭证、KV 和历史,相同插件 ID 可继续访问原有 KV。

SDK 0.3.2 的 manifest 仍为 0.3,官方插件使用固定公开 SDK 0.3.2 独立构建。SDK 0.2 及更早插件仍需按[插件迁移](/malatang/docs/plugin-development#打包安装与旧插件迁移)更新重建。从 0.4.0 或更早升级时,ChatGPT 旧钥匙串登录不迁移,需重新登录并从新账号目录添加模型;见[凭证与数据](/malatang/docs/models#凭证与数据)。跨版本代码热更新未实测,本次以完整安装包验收。

更新由用户确认,模型、插件或登录任务忙碌时推迟。原生运行时变化需要从本页重新下载完整安装包;代码更新不会替你升级独立安装的插件。

Expand Down
4 changes: 2 additions & 2 deletions content/projects/malatang/docs/plugin-backend-api.md
Original file line number Diff line number Diff line change
Expand Up @@ -6,7 +6,7 @@ description: "定义带 schema 的插件方法,使用后端模型和 KV 上下
date: "2026-10-11"
---

本页适用于 **麻辣烫 0.4.2 / SDK 0.3.1**。后端在宿主 Bun 进程运行,适合业务校验、数据整理和调用宿主模型。纯前端笔记插件不需要后端。
本页适用于 **麻辣烫 0.4.3 / SDK 0.3.2**。后端在宿主 Bun 进程运行,适合业务校验、数据整理和调用宿主模型。纯前端笔记插件不需要后端。

## 定义与调用

Expand Down Expand Up @@ -140,4 +140,4 @@ export default function BackendNotes() {
| 返回结果失败 | 是否为 JSON、是否超过 256 KiB、是否遗漏 return |
| 激活失败 | backend 默认导出、清单入口、模块初始化异常 |

类型来源:[runtime.ts](https://github.com/potato47/malatang/blob/sdk-v0.3.1/packages/sdk/src/runtime.ts)、[types.ts](https://github.com/potato47/malatang/blob/sdk-v0.3.1/packages/sdk/src/types.ts)。宿主最终执行校验见[插件实现](https://github.com/potato47/malatang/blob/v0.4.2/backend/plugins.ts)。
类型来源:[runtime.ts](https://github.com/semicoder-dev/malatang/blob/sdk-v0.3.2/packages/sdk/src/runtime.ts)、[types.ts](https://github.com/semicoder-dev/malatang/blob/sdk-v0.3.2/packages/sdk/src/types.ts)。宿主最终执行校验见[插件实现](https://github.com/semicoder-dev/malatang/blob/v0.4.3/backend/plugins.ts)。
4 changes: 2 additions & 2 deletions content/projects/malatang/docs/plugin-client-api.md
Original file line number Diff line number Diff line change
Expand Up @@ -6,7 +6,7 @@ description: "模型、运行记录、KV、后端调用,以及事件订阅和
date: "2026-10-11"
---

本页适用于 **麻辣烫 0.4.2 / SDK 0.3.1**。客户端只在宿主加载的插件页面中使用,不是独立网页或服务端 HTTP SDK。
本页适用于 **麻辣烫 0.4.3 / SDK 0.3.2**。客户端只在宿主加载的插件页面中使用,不是独立网页或服务端 HTTP SDK。

## 创建客户端

Expand Down Expand Up @@ -283,4 +283,4 @@ export default function ModelPage() {

BackendPlugin、PluginMethod、PluginContext 见[后端 API](/malatang/docs/plugin-backend-api);PluginManifest 见[清单](/malatang/docs/plugin-manifest)。插件安装、市场配置和模型管理使用[宿主 CLI](/malatang/docs/automation),不能写成 `client.plugins.install` 或 `client.marketplaces`。

来源:[client.ts](https://github.com/potato47/malatang/blob/sdk-v0.3.1/packages/sdk/src/client.ts)、[types.ts](https://github.com/potato47/malatang/blob/sdk-v0.3.1/packages/sdk/src/types.ts)、[宿主校验](https://github.com/potato47/malatang/blob/v0.4.2/shared/api.ts)。
来源:[client.ts](https://github.com/semicoder-dev/malatang/blob/sdk-v0.3.2/packages/sdk/src/client.ts)、[types.ts](https://github.com/semicoder-dev/malatang/blob/sdk-v0.3.2/packages/sdk/src/types.ts)、[宿主校验](https://github.com/semicoder-dev/malatang/blob/v0.4.3/shared/api.ts)。
6 changes: 3 additions & 3 deletions content/projects/malatang/docs/plugin-development.md
Original file line number Diff line number Diff line change
Expand Up @@ -8,7 +8,7 @@ date: "2026-10-11"

## 准备开发环境

本手册适用于 **麻辣烫 0.4.2 / SDK 0.3.1 / manifest 0.3**。先完成[安装](/malatang/docs/installation),从应用菜单安装 CLI,并安装 Bun 1.4.2 或以上。普通应用用户不需要 Bun;宿主源码开发固定使用 1.4.3。
本手册适用于 **麻辣烫 0.4.3 / SDK 0.3.2 / manifest 0.3**。先完成[安装](/malatang/docs/installation),从应用菜单安装 CLI,并安装 Bun 1.4.2 或以上。普通应用用户不需要 Bun;宿主源码开发固定使用 1.4.3。

插件是独立 React 小应用。宿主提供模型、运行记录、KV、UI 和可选后端方法;插件不需要克隆宿主源码。CLI 将随应用提供的 SDK 归档复制到 `vendor/malatang-sdk.tgz`,项目通过相对 `file:` 依赖使用它,可移动到任意目录。

Expand Down Expand Up @@ -140,6 +140,6 @@ bun run pack

SDK 0.3 使用 Base UI 1.9 与 Tailwind CSS 4.3。组合式组件使用 Trigger / Content 和 `render`,选择类组件使用 `value/onValueChange`。对应示例已集中到 [UI 手册](/malatang/docs/plugin-ui),避免在入门页重复维护接口。

## 市场分发与 SDK 0.3.1
## 市场分发与 SDK 0.3.2

SDK 0.3.1 已公开;CLI 默认使用随应用提供的归档。官方翻译、随手记 0.1.0 仍使用固定 SDK 0.3.0,模型、KV、UI 与 manifest 0.3 契约兼容。0.3.1 的管理类型变化及市场分发见[构建与分发](/malatang/docs/plugin-distribution)。
SDK 0.3.2 已公开,仓库与可信发布迁入组织,模型、KV、UI 与 manifest 0.3 契约保持不变;CLI 默认使用随应用提供的归档。0.3.1 起的管理类型变化及市场分发见[构建与分发](/malatang/docs/plugin-distribution)。
Loading
Loading