diff --git a/content/projects/agent-webtool/docs/cli.md b/content/projects/agent-webtool/docs/cli.md index e513e79..b58436e 100644 --- a/content/projects/agent-webtool/docs/cli.md +++ b/content/projects/agent-webtool/docs/cli.md @@ -8,7 +8,7 @@ date: "2026-10-06" ## 抓取网页 -以下示例基于已安装的 0.7.0： +以下示例基于已安装的 0.7.1： ```sh webtool fetch https://example.com diff --git a/content/projects/agent-webtool/docs/installation.md b/content/projects/agent-webtool/docs/installation.md index f0867bf..69a52e5 100644 --- a/content/projects/agent-webtool/docs/installation.md +++ b/content/projects/agent-webtool/docs/installation.md @@ -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" --- ## 运行环境 @@ -15,8 +15,8 @@ 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 和目标网页；网络错误不代表安装失败。 @@ -24,23 +24,23 @@ 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)。升级时应先阅读适用版本与迁移说明，再更新依赖版本。 diff --git a/content/projects/agent-webtool/docs/mcp.md b/content/projects/agent-webtool/docs/mcp.md index 48c86a2..fc14f01 100644 --- a/content/projects/agent-webtool/docs/mcp.md +++ b/content/projects/agent-webtool/docs/mcp.md @@ -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 服务，无需另开监听端口。输出用于协议通信，不应当作普通终端抓取结果使用。 @@ -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 接入。 diff --git a/content/projects/agent-webtool/docs/sdk.md b/content/projects/agent-webtool/docs/sdk.md index 62e65c5..b8f1a1d 100644 --- a/content/projects/agent-webtool/docs/sdk.md +++ b/content/projects/agent-webtool/docs/sdk.md @@ -6,7 +6,7 @@ description: "抓取网页、读取结构化搜索结果，并理解来源编号 date: "2026-10-06" --- -## 抓取与搜索（0.7.0） +## 抓取与搜索（0.7.1） ```ts import { webFetch, webSearch } from "agent-webtool"; diff --git a/content/projects/agent-webtool/index.mdx b/content/projects/agent-webtool/index.mdx index c462d4c..40b2d16 100644 --- a/content/projects/agent-webtool/index.mdx +++ b/content/projects/agent-webtool/index.mdx @@ -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" } --- @@ -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)。 diff --git a/content/projects/fia/docs/distribution.md b/content/projects/fia/docs/distribution.md index e5be57f..fcdc0fe 100644 --- a/content/projects/fia/docs/distribution.md +++ b/content/projects/fia/docs/distribution.md @@ -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 版本号。 diff --git a/content/projects/fia/index.mdx b/content/projects/fia/index.mdx index 08a73f4..8a71d13 100644 --- a/content/projects/fia/index.mdx +++ b/content/projects/fia/index.mdx @@ -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" } --- @@ -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) 获取。 diff --git a/content/projects/malatang/docs/getting-started.md b/content/projects/malatang/docs/getting-started.md index ac919b7..9e0f099 100644 --- a/content/projects/malatang/docs/getting-started.md +++ b/content/projects/malatang/docs/getting-started.md @@ -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#后续更新)。 diff --git a/content/projects/malatang/docs/installation.md b/content/projects/malatang/docs/installation.md index 1ecb2d7..8009c61 100644 --- a/content/projects/malatang/docs/installation.md +++ b/content/projects/malatang/docs/installation.md @@ -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。首次安装： @@ -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 ``` @@ -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#凭证与数据)。跨版本代码热更新未实测，本次以完整安装包验收。 更新由用户确认，模型、插件或登录任务忙碌时推迟。原生运行时变化需要从本页重新下载完整安装包；代码更新不会替你升级独立安装的插件。 diff --git a/content/projects/malatang/docs/plugin-backend-api.md b/content/projects/malatang/docs/plugin-backend-api.md index c419742..1521c0e 100644 --- a/content/projects/malatang/docs/plugin-backend-api.md +++ b/content/projects/malatang/docs/plugin-backend-api.md @@ -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 进程运行，适合业务校验、数据整理和调用宿主模型。纯前端笔记插件不需要后端。 ## 定义与调用 @@ -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)。 diff --git a/content/projects/malatang/docs/plugin-client-api.md b/content/projects/malatang/docs/plugin-client-api.md index 0e7161a..1d90567 100644 --- a/content/projects/malatang/docs/plugin-client-api.md +++ b/content/projects/malatang/docs/plugin-client-api.md @@ -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。 ## 创建客户端 @@ -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)。 diff --git a/content/projects/malatang/docs/plugin-development.md b/content/projects/malatang/docs/plugin-development.md index 7e375bb..d059810 100644 --- a/content/projects/malatang/docs/plugin-development.md +++ b/content/projects/malatang/docs/plugin-development.md @@ -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:` 依赖使用它，可移动到任意目录。 @@ -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)。 diff --git a/content/projects/malatang/docs/plugin-distribution.md b/content/projects/malatang/docs/plugin-distribution.md index 01aa387..8dd13d6 100644 --- a/content/projects/malatang/docs/plugin-distribution.md +++ b/content/projects/malatang/docs/plugin-distribution.md @@ -6,7 +6,7 @@ description: "插件 CLI、SDK 工具 API、归档校验、安装更新与静态 date: "2026-10-11" --- -本页适用于 **麻辣烫 0.4.2 / SDK 0.3.1 / manifest 0.3**。制作插件从[入门教程](/malatang/docs/plugin-development)开始；用户安装操作见[插件管理](/malatang/docs/plugins)。 +本页适用于 **麻辣烫 0.4.3 / SDK 0.3.2 / manifest 0.3**。制作插件从[入门教程](/malatang/docs/plugin-development)开始；用户安装操作见[插件管理](/malatang/docs/plugins)。 ## CLI 命令 @@ -28,7 +28,7 @@ malatang plugin build --json malatang plugin pack --json ``` -CLI 复制固定 SDK 到 vendor，脚本消费项目自己的 SDK；复制项目时一起保留 vendor。生成的 bun run check/build/pack 调用相同实现。普通开发无需直接从 npm 安装 SDK；独立维护时可使用固定公开 `@semicoder/malatang-sdk@0.3.1`，React 与 ReactDOM 19 应精确同版本，并保留生成项目所需的 TypeScript 和类型依赖。 +CLI 复制固定 SDK 到 vendor，脚本消费项目自己的 SDK；复制项目时一起保留 vendor。生成的 bun run check/build/pack 调用相同实现。普通开发无需直接从 npm 安装 SDK；独立维护时可使用固定公开 `@semicoder/malatang-sdk@0.3.2`，React 与 ReactDOM 19 应精确同版本，并保留生成项目所需的 TypeScript 和类型依赖。 ## SDK 构建工具 API @@ -129,18 +129,18 @@ malatang call plugins.jobs --json '{}' 宿主最多配置 20 个市场，索引最多 2 MiB，索引请求最长 15 秒；市场归档最多 50 MiB，安装过程最长 120 秒，最多跟随 5 次重定向。刷新失败保留旧缓存；安装和更新仍重新获取并验证条目、哈希及包身份，不能用过期缓存保证安装成功。 -官方源在[独立官方插件仓库](https://github.com/potato47/malatang-plugins)维护，宿主不携带官方插件。自行托管市场不等于进入官方源；官方上架遵守该仓库的贡献和发布流程。 +官方源在[独立官方插件仓库](https://github.com/semicoder-dev/malatang-plugins)维护，宿主不携带官方插件。自行托管市场不等于进入官方源；官方上架遵守该仓库的贡献和发布流程。 ## 宿主管理 API 与类型变更 客户端没有 plugins 或 marketplaces 命名空间。管理安装与来源使用[自动化 CLI](/malatang/docs/automation)：marketplaces.list/add/update/remove/refresh/catalog、plugins.install/installFromMarket/update/jobs/list 等。普通插件业务只使用[客户端 API](/malatang/docs/plugin-client-api)。 -SDK 0.3.1 的 PluginInfo 删除 builtin，增加可空 market（marketId/marketURL）；InstallJob 增加 operation 和 targetVersion。manifest 仍为 0.3，SDK 0.3.0 插件的模型/KV/UI 契约不变。官方插件 0.1.0 固定用公开 SDK 0.3.0 独立构建。 +SDK 0.3.1 的 PluginInfo 删除 builtin，增加可空 market（marketId/marketURL）；InstallJob 增加 operation 和 targetVersion。manifest 仍为 0.3，SDK 0.3.0 插件的模型/KV/UI 契约不变。官方翻译、随手记 0.1.1 固定用公开 SDK 0.3.2 独立构建；组织迁移不改变 manifest 或模型/KV/UI 契约。 ## 从 SDK 0.2 迁移 旧插件不能只改 sdkVersion。需更新 SDK 依赖或 vendor 快照，改用组合式 Trigger/Content、render 和新事件参数，添加 styles.css 映射入口，以 p: 静态类/CSS Modules 使用主题，然后完整 check/build/pack。 -保持 ID 可继续访问 KV 和历史；旧宿主安装记录不迁移，升级应用前卸载旧手动插件，再安装完整 DMG，详见[安装与升级](/malatang/docs/installation#后续更新)。历史 API 以 [v0.4.0 文档](https://github.com/potato47/malatang/blob/v0.4.0/packages/sdk/README.md) 为参考，不作为当前教程默认路径。 +保持 ID 可继续访问 KV 和历史；旧宿主安装记录不迁移，升级应用前卸载旧手动插件，再安装完整 DMG，详见[安装与升级](/malatang/docs/installation#后续更新)。历史 API 以 [v0.4.0 文档](https://github.com/semicoder-dev/malatang/blob/v0.4.0/packages/sdk/README.md) 为参考，不作为当前教程默认路径。 -来源：[SDK 工具](https://github.com/potato47/malatang/blob/sdk-v0.3.1/packages/sdk/plugin.ts)、[市场 schema](https://github.com/potato47/malatang/blob/v0.4.2/shared/marketplace.ts)、[安装与更新实现](https://github.com/potato47/malatang/blob/v0.4.2/backend/plugins.ts)。 +来源：[SDK 工具](https://github.com/semicoder-dev/malatang/blob/sdk-v0.3.2/packages/sdk/plugin.ts)、[市场 schema](https://github.com/semicoder-dev/malatang/blob/v0.4.3/shared/marketplace.ts)、[安装与更新实现](https://github.com/semicoder-dev/malatang/blob/v0.4.3/backend/plugins.ts)。 diff --git a/content/projects/malatang/docs/plugin-manifest.md b/content/projects/malatang/docs/plugin-manifest.md index 69f26db..4434162 100644 --- a/content/projects/malatang/docs/plugin-manifest.md +++ b/content/projects/malatang/docs/plugin-manifest.md @@ -6,7 +6,7 @@ description: "完整 manifest 字段、SDK 导入入口、页面和后端生命 date: "2026-10-11" --- -本页适用于 **麻辣烫 0.4.2 / SDK 0.3.1**。新项目先按[入门教程](/malatang/docs/plugin-development)生成，再修改业务源码。 +本页适用于 **麻辣烫 0.4.3 / SDK 0.3.2**。新项目先按[入门教程](/malatang/docs/plugin-development)生成，再修改业务源码。 ## 项目结构 @@ -58,7 +58,7 @@ my-notes/ | description | 必填 | 字符串，最多 240 字符 | | icon | 必填 | 字符串长度 1–4，适合一个短字或符号 | | color | 必填 | 六位十六进制颜色，如 `#686868` | -| sdkVersion | 必填 | 固定字符串 `"0.3"`，不是 npm 包版本 `0.3.1` | +| sdkVersion | 必填 | 固定字符串 `"0.3"`，不是 npm 包版本 `0.3.2` | | frontend | 必填 | 固定 `dist/client.js` | | styles | 必填 | 固定 `dist/client.css` | | backend | 可选 | 声明时固定 `dist/backend.js`，并存在 `src/backend.ts` | @@ -105,4 +105,4 @@ my-notes/ 插件按可信本地代码执行。ID 命名空间、CSS 作用域和前后端入口区分都不是安全沙箱。宿主目前提供文本模型生成、运行记录、JSON KV 和插件方法；没有公共工具注册、预设 agent loop、自建长任务托管或自动升级 API。 -来源：[SDK 固定版本](https://github.com/potato47/malatang/tree/sdk-v0.3.1/packages/sdk/src)、[宿主插件实现](https://github.com/potato47/malatang/blob/v0.4.2/backend/plugins.ts)。 +来源：[SDK 固定版本](https://github.com/semicoder-dev/malatang/tree/sdk-v0.3.2/packages/sdk/src)、[宿主插件实现](https://github.com/semicoder-dev/malatang/blob/v0.4.3/backend/plugins.ts)。 diff --git a/content/projects/malatang/docs/plugin-styling.md b/content/projects/malatang/docs/plugin-styling.md index 0ce9516..9b69629 100644 --- a/content/projects/malatang/docs/plugin-styling.md +++ b/content/projects/malatang/docs/plugin-styling.md @@ -6,7 +6,7 @@ description: "使用语义 Tailwind 类、CSS Modules 与宿主主题，处理 date: "2026-10-11" --- -本页适用于 **麻辣烫 0.4.2 / SDK 0.3.1**。宿主统一提供主题、公共组件 CSS 与 reset；插件只维护自己的业务布局和样式。 +本页适用于 **麻辣烫 0.4.3 / SDK 0.3.2**。宿主统一提供主题、公共组件 CSS 与 reset；插件只维护自己的业务布局和样式。 ## 样式入口与静态类名 @@ -116,4 +116,4 @@ export function PluginIllustration() { 例外只允许该样式文件使用固定颜色，不允许全局规则、公共 token 重定义或私有类依赖；文件必须存在且理由非空。没有必要时不声明。 -来源：[主题 token](https://github.com/potato47/malatang/blob/sdk-v0.3.1/packages/sdk/src/theme.css)、[Tailwind 映射](https://github.com/potato47/malatang/blob/sdk-v0.3.1/packages/sdk/src/tailwind.css)、[样式检查器](https://github.com/potato47/malatang/blob/sdk-v0.3.1/packages/sdk/src/style-check.ts)。 +来源：[主题 token](https://github.com/semicoder-dev/malatang/blob/sdk-v0.3.2/packages/sdk/src/theme.css)、[Tailwind 映射](https://github.com/semicoder-dev/malatang/blob/sdk-v0.3.2/packages/sdk/src/tailwind.css)、[样式检查器](https://github.com/semicoder-dev/malatang/blob/sdk-v0.3.2/packages/sdk/src/style-check.ts)。 diff --git a/content/projects/malatang/docs/plugin-ui-overlays.md b/content/projects/malatang/docs/plugin-ui-overlays.md index 0e5541e..def3257 100644 --- a/content/projects/malatang/docs/plugin-ui-overlays.md +++ b/content/projects/malatang/docs/plugin-ui-overlays.md @@ -6,7 +6,7 @@ description: "对话框、菜单、提示、通知、标签页、折叠区和反 date: "2026-10-11" --- -本页适用于 **麻辣烫 0.4.2 / SDK 0.3.1**，沿用 [UI 公共约定](/malatang/docs/plugin-ui#公共约定)。下面组件统一从 `@semicoder/malatang-sdk/ui` 导入；由宿主 UIProvider 提供 Portal、主题和页面可见性。 +本页适用于 **麻辣烫 0.4.3 / SDK 0.3.2**，沿用 [UI 公共约定](/malatang/docs/plugin-ui#公共约定)。下面组件统一从 `@semicoder/malatang-sdk/ui` 导入；由宿主 UIProvider 提供 Portal、主题和页面可见性。 ## 浮层组合与焦点 @@ -368,4 +368,4 @@ export function ToastExample() { 公开 `Toast` 是已加样式的底层 Root，需传通知对象 `toast`，用于定制展示；SDK 没有导出完整 Toast 子组件集合，普通插件使用 useToast，由 UIProvider 渲染现成通知区。切页隐藏时宿主会关闭该页面的通知。不要额外创建 Provider 或重复绘制同一通知。 -来源：[浮层](https://github.com/potato47/malatang/blob/sdk-v0.3.1/packages/sdk/src/ui/overlays.tsx)、[布局](https://github.com/potato47/malatang/blob/sdk-v0.3.1/packages/sdk/src/ui/layout.tsx)、[Provider](https://github.com/potato47/malatang/blob/sdk-v0.3.1/packages/sdk/src/ui/provider.tsx)。 +来源：[浮层](https://github.com/semicoder-dev/malatang/blob/sdk-v0.3.2/packages/sdk/src/ui/overlays.tsx)、[布局](https://github.com/semicoder-dev/malatang/blob/sdk-v0.3.2/packages/sdk/src/ui/layout.tsx)、[Provider](https://github.com/semicoder-dev/malatang/blob/sdk-v0.3.2/packages/sdk/src/ui/provider.tsx)。 diff --git a/content/projects/malatang/docs/plugin-ui.md b/content/projects/malatang/docs/plugin-ui.md index 6fbbef8..37a9dd2 100644 --- a/content/projects/malatang/docs/plugin-ui.md +++ b/content/projects/malatang/docs/plugin-ui.md @@ -6,7 +6,7 @@ description: "SDK 公共组件、布局、输入、选择控件、模型选择 date: "2026-10-11" --- -本页适用于 **麻辣烫 0.4.2 / SDK 0.3.1**。所有示例组件从 `@semicoder/malatang-sdk/ui` 导入，在 CLI 创建的插件页面中使用。宿主共享 React、ReactDOM 与公共 UI，不直接导入 Base UI、Radix、Lucide 或宿主源码。 +本页适用于 **麻辣烫 0.4.3 / SDK 0.3.2**。所有示例组件从 `@semicoder/malatang-sdk/ui` 导入，在 CLI 创建的插件页面中使用。宿主共享 React、ReactDOM 与公共 UI，不直接导入 Base UI、Radix、Lucide 或宿主源码。 ## 公共约定 @@ -298,4 +298,4 @@ export function ComboboxExample() { `UIProvider` 接受 children（必填）、visible（默认 true）、pluginId（可选）。宿主已经包裹插件页面，提供 Tooltip、Toast、可见性和带插件作用域的 Portal，**普通插件不要再嵌套 Provider**。Provider 的导出用于宿主集成等场景，不会让 createPluginClient 在普通网页中可用。 -后续阅读：[浮层与反馈](/malatang/docs/plugin-ui-overlays)、[样式与主题](/malatang/docs/plugin-styling)。来源：[UI 导出](https://github.com/potato47/malatang/blob/sdk-v0.3.1/packages/sdk/src/ui.tsx)、[组件实现](https://github.com/potato47/malatang/tree/sdk-v0.3.1/packages/sdk/src/ui)。 +后续阅读：[浮层与反馈](/malatang/docs/plugin-ui-overlays)、[样式与主题](/malatang/docs/plugin-styling)。来源：[UI 导出](https://github.com/semicoder-dev/malatang/blob/sdk-v0.3.2/packages/sdk/src/ui.tsx)、[组件实现](https://github.com/semicoder-dev/malatang/tree/sdk-v0.3.2/packages/sdk/src/ui)。 diff --git a/content/projects/malatang/docs/plugins.md b/content/projects/malatang/docs/plugins.md index a554191..6994671 100644 --- a/content/projects/malatang/docs/plugins.md +++ b/content/projects/malatang/docs/plugins.md @@ -6,7 +6,7 @@ description: "通过应用中心或 CLI 安装预构建插件，了解启停、 date: "2026-10-10" --- -本页适用于麻辣烫 **0.4.2**。应用不内置插件，所有插件由用户安装；旧版本升级请先阅读[升级说明](/malatang/docs/installation#后续更新)。 +本页适用于麻辣烫 **0.4.3**。应用不内置插件，所有插件由用户安装；旧版本升级请先阅读[升级说明](/malatang/docs/installation#后续更新)。 ## 从插件市场安装 @@ -16,7 +16,7 @@ date: "2026-10-10" ## 管理市场源 -默认配置[官方市场](https://github.com/potato47/malatang-plugins)。在「管理市场源」添加名称与 HTTPS 索引地址，也可重命名、启停和删除。官方源同样可以停用或删除，重启后不会恢复；修改地址请删除后重新添加。 +默认配置[官方市场](https://github.com/semicoder-dev/malatang-plugins)。在「管理市场源」添加名称与 HTTPS 索引地址，也可重命名、启停和删除。官方源同样可以停用或删除，重启后不会恢复；修改地址请删除后重新添加。 不同源的同 ID 条目分别显示来源。已安装插件固定使用原市场更新，不跨来源替换；来源被删后插件仍可运行。手动安装不自动关联市场，如需市场更新，先卸载再从选定市场安装相同 ID。 @@ -61,6 +61,6 @@ malatang call plugins.install --json '{"source":"/absolute/path/plugin.tgz"}' 市场使用静态 JSON v1，包含 `schemaVersion/name/plugins`；条目包含 `id/packageName/name/description/icon/color/version/sdkVersion/url/sha256`。只列当前稳定版本，索引与归档使用 HTTPS，无需专门市场服务。 -参考[官方仓库](https://github.com/potato47/malatang-plugins)及[宿主协议](https://github.com/potato47/malatang/blob/v0.4.2/docs/plugin-marketplace.md)。官方插件分别打标签、上传归档，验收公开下载哈希后通过索引 PR 上架。 +参考[官方仓库](https://github.com/semicoder-dev/malatang-plugins)及[宿主协议](https://github.com/semicoder-dev/malatang/blob/v0.4.3/docs/plugin-marketplace.md)。官方插件分别打标签、上传归档，验收公开下载哈希后通过索引 PR 上架。 制作自己的插件可从[第一个插件](/malatang/docs/plugin-development)开始；归档、市场索引与更新规则见[构建与分发](/malatang/docs/plugin-distribution)。 diff --git a/content/projects/malatang/docs/troubleshooting.md b/content/projects/malatang/docs/troubleshooting.md index f5dc24e..dd77fac 100644 --- a/content/projects/malatang/docs/troubleshooting.md +++ b/content/projects/malatang/docs/troubleshooting.md @@ -56,13 +56,13 @@ SDK 0.2 及更早插件不能在 0.4.1 宿主直接运行，需要开发者按 [ ## 更新与安装包 -请从 [官网下载安装页](/malatang/docs/installation) 下载麻辣烫 0.4.2 正式 DMG，并查看 SHA-256 校验方法。Releases 中的 `fia-runtime-*` `.tgz` 仅供历史源码构建，普通安装无需下载；0.4.1 源码从同仓构建 FIA。更新状态以应用「设置 → 应用更新」和安装页为准。 +请从 [官网下载安装页](/malatang/docs/installation) 下载麻辣烫 0.4.3 正式 DMG，并查看 SHA-256 校验方法。Releases 中的 `fia-runtime-*` `.tgz` 仅供历史源码构建，普通安装无需下载；0.4.1 源码从同仓构建 FIA。更新状态以应用「设置 → 应用更新」和安装页为准。 更新时，有模型、插件或登录任务会延迟切换。代码失败回退不恢复旧数据；原生运行时改变时需重新安装完整应用。 ## 反馈问题 -在 [GitHub Issues](https://github.com/potato47/malatang/issues) 提供系统版本、芯片、应用版本、复现步骤与脱敏后的错误。不要附带模型 API Key、授权链接、完整个人输入或账号数据。 +在 [GitHub Issues](https://github.com/semicoder-dev/malatang/issues) 提供系统版本、芯片、应用版本、复现步骤与脱敏后的错误。不要附带模型 API Key、授权链接、完整个人输入或账号数据。 ## 浏览器界面提示连接已结束 diff --git a/content/projects/malatang/index.mdx b/content/projects/malatang/index.mdx index 79d30b1..ef69b7b 100644 --- a/content/projects/malatang/index.mdx +++ b/content/projects/malatang/index.mdx @@ -7,7 +7,7 @@ date: "2026-10-10" tags: ["AI 应用", "插件平台", "macOS"] stack: ["FIA", "React", "Pi AI"] status: "已发布" -source: "https://github.com/potato47/malatang" +source: "https://github.com/semicoder-dev/malatang" category: "本地插件应用平台" featured: true start: { "label": "下载与安装", "doc": "docs-malatang-installation" } @@ -39,12 +39,12 @@ start: { "label": "下载与安装", "doc": "docs-malatang-installation" } 插件默认导出 React 页面，通过 `@semicoder/malatang-sdk` 获取模型、任务和 KV。后端可注册带输入 schema 的业务方法，UI 组件与 React 运行时由宿主共享。 -从 [第一个插件](/malatang/docs/plugin-development) 开始，继续阅读[插件结构](/malatang/docs/plugin-manifest)、[前端 API](/malatang/docs/plugin-client-api)、[后端 API](/malatang/docs/plugin-backend-api)、[UI 组件](/malatang/docs/plugin-ui)、[浮层与反馈](/malatang/docs/plugin-ui-overlays)、[样式主题](/malatang/docs/plugin-styling)和[构建分发](/malatang/docs/plugin-distribution)。[SDK 0.3.1 已发布 npm](https://www.npmjs.com/package/@semicoder/malatang-sdk/v/0.3.1)。CLI 创建的项目自带 SDK 快照，可脱离源码 workspace 开发；旧 SDK 0.2 及更早插件需迁移并重新构建。 +从 [第一个插件](/malatang/docs/plugin-development) 开始，继续阅读[插件结构](/malatang/docs/plugin-manifest)、[前端 API](/malatang/docs/plugin-client-api)、[后端 API](/malatang/docs/plugin-backend-api)、[UI 组件](/malatang/docs/plugin-ui)、[浮层与反馈](/malatang/docs/plugin-ui-overlays)、[样式主题](/malatang/docs/plugin-styling)和[构建分发](/malatang/docs/plugin-distribution)。[SDK 0.3.2 已发布 npm](https://www.npmjs.com/package/@semicoder/malatang-sdk/v/0.3.2)。CLI 创建的项目自带 SDK 快照，可脱离源码 workspace 开发；旧 SDK 0.2 及更早插件需迁移并重新构建。 ## 当前边界 -当前是 **0.4.2**，支持 macOS 14+ / Apple Silicon。插件按可信本地代码运行，具有本机代码执行能力，不是强隔离沙箱。用户内容在调用模型时会发送到所选服务商，并非离线 AI。ChatGPT 凭证明文保存在受限本地文件，不再访问钥匙串；从旧版升级需要重新登录并添加订阅模型。 +当前是 **0.4.3**，支持 macOS 14+ / Apple Silicon。插件按可信本地代码运行，具有本机代码执行能力，不是强隔离沙箱。用户内容在调用模型时会发送到所选服务商，并非离线 AI。ChatGPT 凭证明文保存在受限本地文件，不再访问钥匙串；从旧版升级需要重新登录并添加订阅模型。 工具注册与调用、预设 agent loop、调研应用、其他服务商订阅登录和插件自动升级尚未实现。不要把规划中的能力当成当前功能。 -本页是麻辣烫官网。**0.4.2（Build 6）已发布**，[下载与安装](/malatang/docs/installation) 提供正式 DMG、校验文件及同版本共仓源码构建步骤。本次取消内置插件，官方翻译与随手记 0.1.0 已上架。升级前在旧版卸载手动安装插件，再用完整 DMG 替换；不迁移旧安装记录，模型、凭证、KV 和历史不主动清除。底层框架介绍见 [FIA](/fia)。 +本页是麻辣烫官网。**0.4.3（Build 7）已发布**，[下载与安装](/malatang/docs/installation) 提供正式 DMG、校验文件及同版本共仓源码构建步骤。项目、更新站和官方市场迁入 `semicoder-dev`，官方翻译与随手记 0.1.1 已上架，固定使用 SDK 0.3.2。旧版须完整 DMG 安装，不提供旧更新地址回退；已有市场来源按安装页手动切换，模型、凭证、KV 和历史不主动清除。底层框架介绍见 [FIA](/fia)。 diff --git a/content/projects/semicoder/docs/getting-started.md b/content/projects/semicoder/docs/getting-started.md index 007f058..b882a6e 100644 --- a/content/projects/semicoder/docs/getting-started.md +++ b/content/projects/semicoder/docs/getting-started.md @@ -12,7 +12,7 @@ updated: 2026-10-04 安装 Bun 1.4.2 和 Node.js 24，克隆仓库后安装锁定的依赖。 ```bash -git clone https://github.com/potato47/semicoder.git +git clone https://github.com/semicoder-dev/semicoder.git cd semicoder bun install --frozen-lockfile bun run prepare diff --git a/content/projects/semicoder/index.mdx b/content/projects/semicoder/index.mdx index 3705749..09866b7 100644 --- a/content/projects/semicoder/index.mdx +++ b/content/projects/semicoder/index.mdx @@ -9,7 +9,7 @@ tags: [全栈开发, 内容网站] stack: [TanStack Start, Cloudflare, Bun] status: 构建中 category: 个人项目网站 -source: https://github.com/potato47/semicoder +source: https://github.com/semicoder-dev/semicoder --- ## 记录构建，也让作品被使用 diff --git a/docs/architecture.md b/docs/architecture.md index d546034..d3accf9 100644 --- a/docs/architecture.md +++ b/docs/architecture.md @@ -35,3 +35,5 @@ 博客与项目集合页移除顶部介绍区的编号、宣传标题、说明和分割线，正文以 32px 顶部留白直接展示标签筛选 / 文章列表或项目分类。项目按 category 分组，缺少类别时归入“个人项目”，类别及组内顺序沿用内容清单；卡片只显示图标、名称、描述和文档入口，桌面两列、760px 及以下单列。页面保留仅供辅助技术读取的 h1（“博客” / “项目”）和原有 SEO。 博客与项目集合页通过 `codeSplitGroupings: []` 随基础路由代码加载，共用的卡片样式也在首屏加载，避免首次点击再等待列表页 JS/CSS。两页只消费已生成的元信息，不请求 Worker 或 D1；文章、项目详情、文档正文和首页历法仍按路由拆分。不要为消除列表导航等待而预加载全部正文或关闭全站代码拆分。 + +GitHub 项目资源归属 `semicoder-dev`；页脚源码入口和隐私页问题反馈使用组织仓库。个人身份展示与认证数字 ID 不因项目迁移改变。 diff --git a/docs/content.md b/docs/content.md index 5c21468..eea77a8 100644 --- a/docs/content.md +++ b/docs/content.md @@ -45,9 +45,9 @@ 当前真实内容包含 FIA、麻辣烫、agent-webtool 与本站。FIA 和麻辣烫分别在 `content/projects/fia/`、`content/projects/malatang/` 维护，统一从项目集合页进入，时间首页不再展示项目推荐。资料、版本差异和跨项目同步流程见 [内容核对记录](project-sources.md)。各外部项目内容变更由 `docs/impact.json` 同时关联内容规范和来源记录；单纯文字修正无来源影响时按 PR 规则说明原因。麻辣烫官网固定为 `https://semicoder.dev/malatang`，统一安装入口为 `/malatang/docs/installation`；应用更新文件继续由独立更新源提供。新增正式安装包时先核实 Release、文件、平台与签名状态，再更新麻辣烫安装页；框架 `.tgz` 不能标为应用下载。网站不代理安装包，不在访问时请求 GitHub 或 npm。 -麻辣烫安装页默认提供已核验的 0.4.2 / build 6 正式 DMG；插件开发手册面向公开 SDK 0.3.1 / manifest 0.3。npm、应用 DMG 与网站部署状态分别核实。 +麻辣烫安装页默认提供已核验的 0.4.3 / build 7 正式 DMG；插件开发手册面向公开 SDK 0.3.2 / manifest 0.3。npm、应用 DMG 与网站部署状态分别核实。 -agent-webtool 的介绍和安装/SDK/CLI/MCP 指南在 `content/projects/agent-webtool/`，默认使用已独立验证的公开 npm 0.7.0，包含 `SourceContext` 和 0.6.0 升级说明。项目的 CI 与 OIDC 发布已验收；网站内容和部署继续独立验证，不自动发布 npm 包。 +agent-webtool 的介绍和安装/SDK/CLI/MCP 指南在 `content/projects/agent-webtool/`，默认使用已独立验证的公开 npm 0.7.1，包含 `SourceContext` 和 0.6.0 升级说明。项目的 CI 与 OIDC 发布已验收；网站内容和部署继续独立验证，不自动发布 npm 包。 主操作按钮悬停使用强调背景与深色前景 `--on-accent`，避免浅深色模式下白字与橙色背景对比不足。 @@ -64,3 +64,7 @@ FIA 0.18 的标题栏置顶说明沿用现有 development 章节和稳定路径 2026-10-11：插件内容扩展为 8 篇开发章节，保留 plugin-development 的稳定 ID、URL 和原有章节锚点；新增清单、前端 API、后端 API、基础 UI、浮层反馈、样式主题、构建分发。麻辣烫共 14 篇指南，导航按开始使用、使用指南、插件开发、UI 与样式、自动化分组。项目 Home 提供站内直达入口。 代码示例作为静态 Markdown 代码块展示，不在网站执行，不导入 SDK 或相邻工作区；组件与 API 以固定发行源码核对，代码提取到独立临时插件工程验证。更新 SDK 时按公开导出核对全手册，同时维护版本边界、来源记录、站内链接、搜索与构建结果。 + +## 组织资源与迁移说明 + +项目源码、发行和问题入口统一使用 `semicoder-dev`；个人介绍与个人账号链接保持原义。更新当前指南和固定版本源码链接时，历史来源记录继续保留当时地址。麻辣烫更新站为 `https://semicoder-dev.github.io/malatang/updates/latest.json`，官网仍只提供安装说明和已核验 Release 链接。0.4.3 的旧用户须完整 DMG 安装，并手动替换已有旧市场源；新数据目录默认使用组织官方索引。官方翻译、随手记 0.1.1 固定 SDK 0.3.2，ID 和数据命名空间不变。 diff --git a/docs/deployment.md b/docs/deployment.md index 99343ad..97b546c 100644 --- a/docs/deployment.md +++ b/docs/deployment.md @@ -32,7 +32,7 @@ GitHub Actions 工作流为 [`.github/workflows/ci.yml`](../.github/workflows/ci 4. 确认 `wrangler.jsonc` 中两个环境的 D1 ID、域名和 Turnstile site key 都是已创建资源，且对应 Worker 已设置本文“环境”一节列出的运行时 secrets。工作流不会创建 OAuth App 或自动填充运行时密钥；`/healthz` 冒烟会阻止未就绪服务被视为发布成功。 5. 将新站代码与工作流合入 `main` 后，在 Actions 查看 **Quality checks → Deploy staging → Deploy production**。生产有审核保护时，选择 **Review deployments** 批准后继续。需要重试时可对 `main` 手动运行，保持相同检查与预发布验证流程。 -GitHub CLI 用户也可用 `gh secret set CLOUDFLARE_API_TOKEN --repo potato47/semicoder --env staging` 交互式录入；分别替换 secret 名与环境完成四项设置，不把 token 放在命令参数、日志或 PR 中。详细规则见 [GitHub environment 文档](https://docs.github.com/en/actions/how-tos/deploy/configure-and-manage-deployments/manage-environments)。 +GitHub CLI 用户也可用 `gh secret set CLOUDFLARE_API_TOKEN --repo semicoder-dev/semicoder --env staging` 交互式录入；分别替换 secret 名与环境完成四项设置，不把 token 放在命令参数、日志或 PR 中。详细规则见 [GitHub environment 文档](https://docs.github.com/en/actions/how-tos/deploy/configure-and-manage-deployments/manage-environments)。 登录密钥通过 Cloudflare 预先配置，不传入构建。上线前用真实 GitHub 账号验证登录、评论、审批、封禁与注销。确认自动部署接通必须以 GitHub 中对应 commit 的实际运行和线上冒烟结果为准，只有本地检查或工作流文件并不代表已经发布。 @@ -71,3 +71,7 @@ bunx wrangler d1 execute DB --env staging --local --persist-to /private/tmp/semi 公开预渲染路径由内容生成的统一清单提供，包含每个项目的 Home 和全部公开章节，不包含已移除的独立文档概览地址。部署仍采用 Assets 优先，不增加 Worker 优先路径或付费服务。生成器和草稿检查递归扫描项目内的文档子目录；项目本身是草稿时，其文档也必须从产物中隔离。 本次 URL 直接切换，不部署旧详情页或兼容重定向。验证 `/semicoder`、`/semicoder/docs/guides/writing` 返回完整静态正文和正确 canonical；旧 `/semicoder/docs` 概览、`/projects/semicoder`、`/docs/semicoder/getting-started` 以及不存在的项目/章节返回 404。所有项目的旧概览地址均由部署冒烟检查；Home 导航、相邻章节与项目评论关闭由构建检查覆盖。`bun run build:check` 检查统一清单对应的静态 HTML、sitemap、目录锚点和中文项目筛选；浏览器验收还包括刷新、站内跳转、搜索状态保留、手机导航和浅深色主题。 + +## GitHub 组织迁移 + +源码与 Actions 使用 `semicoder-dev/semicoder`。预发布和生产 OAuth App 转入同一组织，保留现有 Client ID、回调地址和 Cloudflare 运行时配置；转移后逐环境验证真实登录及管理员身份。Worker、D1、域名和个人 GitHub 数字 ID 不随仓库归属改变。Environment secrets、审核规则及 main 部署许可应与迁移前清单逐项核对。 diff --git a/docs/project-sources.md b/docs/project-sources.md index 6d7b34a..052b5e4 100644 --- a/docs/project-sources.md +++ b/docs/project-sources.md @@ -1,8 +1,19 @@ # 项目资料与发布状态 -公开发行核对：2026-10-11；麻辣烫 0.4.2 / build 6、SDK 0.3.1 和官方插件市场已实际发布并验证，FIA 独立 npm 保持 0.18.0。网站内容由本站维护，不在构建时复制外部工作区。分别记录源码、公开固定归档、npm 和正式应用产物；网站上线以独立部署工作流为准。 +公开发行核对：2026-10-11；麻辣烫 0.4.3 / build 7、SDK 0.3.2、agent-webtool 0.7.1 和官方插件 0.1.1 已实际发布并验证，FIA 独立 npm 保持 0.18.0。网站内容由本站维护，不在构建时复制外部工作区。分别记录源码、公开固定归档、npm 和正式应用产物；网站上线以独立部署工作流为准。 -Semicoder 是各自有项目统一的官网文档入口。当前工作区已更名为 `semicoder-workspace`，包含 FIA、麻辣烫、Semicoder 和 agent-webtool 四个开发项目；FIA 活跃源码已迁入麻辣烫，原独立仓库保留历史；本站为工作区内实体目录。该布局只用于维护协作，不作为本站运行/构建的前提。 +Semicoder 是各自有项目统一的官网文档入口。当前工作区已更名为 `semicoder-workspace`，包含 FIA、麻辣烫、malatang-plugins、Semicoder 和 agent-webtool 五个开发项目；FIA 活跃源码已迁入麻辣烫，原独立仓库保留历史；本站为工作区内实体目录。该布局只用于维护协作，不作为本站运行/构建的前提。 + +## 2026-10-11 组织迁移与首次发行 + +五个仓库通过原生 Transfer 迁入 `semicoder-dev`，保留仓库 ID、原有标签和 42 个 Release 附件的 ID/size/digest；根知识仓库继续仅本地维护，参考项目未涉及。当前资源链接使用组织地址；下方历史记录保留当时的个人仓库地址。 + +- 应用 `v0.4.3` / build 7 与 SDK `sdk-v0.3.2` 固定 `34faa9890eed6475516dfa823d664d92181966f5`。应用 [正式工作流 38117729757](https://github.com/semicoder-dev/malatang/actions/runs/38117729757) 成功；DMG SHA-256 `b83c7fb57aee9829d8adc09086821d8e2eb3cb773fffc554f975c117e16b575f`，35437084 字节。签名、公证、Gatekeeper、安装包与更新文件一致性、Bun 1.4.3、隔离启动退出通过。全新数据目录从新默认市场安装两个 0.1.1 插件并激活、KV 读写通过；本轮不重复真实模型调用。 +- 新更新站 `https://semicoder-dev.github.io/malatang/updates/latest.json` 使用独立 `updates-site` 分支，从空历史初始化；签名和 30 个在线文件大小/哈希验收通过，更新下载禁止重定向。runtimeId `ee666cda40041089e002b7e202ac69aecc68eca3034208d4346bee27df129a84`。旧 `gh-pages` 和附件原样保留，不重签名，不提供旧地址回退或自动迁移。 +- SDK [OIDC 38117101769](https://github.com/semicoder-dev/malatang/actions/runs/38117101769) 成功，公开 npm 0.3.2 SHA-256 `901b4ee1a5b8cbf8607645689129fd72ad05bde4dc3ee7972f3fe2d58f53fd7f` 与 CI 逐字节一致，组织 provenance、新缓存独立消费、notes/model 模板和 runtime/UI/前后端构建通过。manifest 保持 0.3。 +- agent-webtool `v0.7.1` 固定 `19455496011284608f7742c45ae7a6361ec3d323`，[OIDC 38116631403](https://github.com/semicoder-dev/agent-webtool/actions/runs/38116631403) 成功，公开归档 SHA-256 `b23caa32610e41ba767740df348c577b88004d1d82413135a51401c9f5f2d8c0` 与 CI 一致。组织 provenance、新缓存 SDK ESM/CJS/TypeScript、CLI 与 MCP 验收通过，API 不变。 +- 插件源码 `a6a949134703b6c88d43641261888bd75a1a5d97` 固定 SDK 0.3.2。翻译 0.1.1 SHA-256 `d42181bd290f938170dd7209dd6358f731017c6ac5e05cafaa4262e706a45077`；随手记 0.1.1 `fcfd8422211093d17fa9cdcc7ced2a06785cc93bcea28337ee9c877b41916da6`。公开归档和索引经 PR #5/#6 验证后上架，插件 ID 与数据命名空间不变。 +- npm 包名保持不变。两个活跃包的 Trusted Publisher 均已重建并显示 Valid；FIA 旧连接已移除，独立 npm 工作流停用，npm 保持 0.18.0。官网与 Cloudflare Worker/D1/域名不搬迁，个人身份链接保留。预发布 OAuth App 3870528 与生产 3870529 已由组织接收，Client ID、回调地址及应用配置与迁移基线一致；两站真实登录均成功回到 `/admin` 并显示管理员后台。未调整 Cloudflare 运行时密钥或 D1；本次网站部署另按工作流结果验收。 ## 2026-10-11 插件开发手册 diff --git a/public/sitemap.xml b/public/sitemap.xml index 579bbe1..4b03888 100644 --- a/public/sitemap.xml +++ b/public/sitemap.xml @@ -1 +1 @@ -https://semicoder.dev/https://semicoder.dev/bloghttps://semicoder.dev/projectshttps://semicoder.dev/searchhttps://semicoder.dev/privacyhttps://semicoder.dev/ruleshttps://semicoder.dev/malatang/docs/getting-startedhttps://semicoder.dev/malatang/docs/plugin-backend-apihttps://semicoder.dev/malatang/docs/plugin-client-apihttps://semicoder.dev/malatang/docs/plugin-developmenthttps://semicoder.dev/malatang/docs/plugin-distributionhttps://semicoder.dev/malatang/docs/plugin-manifesthttps://semicoder.dev/malatang/docs/plugin-stylinghttps://semicoder.dev/malatang/docs/plugin-uihttps://semicoder.dev/malatang/docs/plugin-ui-overlayshttps://semicoder.dev/malatang/docs/installationhttps://semicoder.dev/malatang/docs/modelshttps://semicoder.dev/malatang/docs/pluginshttps://semicoder.dev/malatang/docs/troubleshootinghttps://semicoder.dev/malatanghttps://semicoder.dev/fia/docs/automationhttps://semicoder.dev/fia/docs/developmenthttps://semicoder.dev/fia/docs/distributionhttps://semicoder.dev/fia/docs/installationhttps://semicoder.dev/fiahttps://semicoder.dev/agent-webtool/docs/clihttps://semicoder.dev/agent-webtool/docs/installationhttps://semicoder.dev/agent-webtool/docs/mcphttps://semicoder.dev/agent-webtool/docs/sdkhttps://semicoder.dev/agent-webtoolhttps://semicoder.dev/fia/docs/shared-apihttps://semicoder.dev/malatang/docs/automationhttps://semicoder.dev/blog/start-smallhttps://semicoder.dev/semicoder/docs/getting-startedhttps://semicoder.dev/semicoder/docs/guides/writinghttps://semicoder.dev/semicoderhttps://semicoder.dev/blog/understand-edge-runtimehttps://semicoder.dev/blog/docs-as-part-of-code \ No newline at end of file +https://semicoder.dev/https://semicoder.dev/bloghttps://semicoder.dev/projectshttps://semicoder.dev/searchhttps://semicoder.dev/privacyhttps://semicoder.dev/ruleshttps://semicoder.dev/agent-webtool/docs/installationhttps://semicoder.dev/malatang/docs/getting-startedhttps://semicoder.dev/malatang/docs/plugin-backend-apihttps://semicoder.dev/malatang/docs/plugin-client-apihttps://semicoder.dev/malatang/docs/plugin-developmenthttps://semicoder.dev/malatang/docs/plugin-distributionhttps://semicoder.dev/malatang/docs/plugin-manifesthttps://semicoder.dev/malatang/docs/plugin-stylinghttps://semicoder.dev/malatang/docs/plugin-uihttps://semicoder.dev/malatang/docs/plugin-ui-overlayshttps://semicoder.dev/malatang/docs/installationhttps://semicoder.dev/malatang/docs/modelshttps://semicoder.dev/malatang/docs/pluginshttps://semicoder.dev/malatang/docs/troubleshootinghttps://semicoder.dev/malatanghttps://semicoder.dev/fia/docs/automationhttps://semicoder.dev/fia/docs/developmenthttps://semicoder.dev/fia/docs/distributionhttps://semicoder.dev/fia/docs/installationhttps://semicoder.dev/fiahttps://semicoder.dev/agent-webtool/docs/clihttps://semicoder.dev/agent-webtool/docs/mcphttps://semicoder.dev/agent-webtool/docs/sdkhttps://semicoder.dev/agent-webtoolhttps://semicoder.dev/fia/docs/shared-apihttps://semicoder.dev/malatang/docs/automationhttps://semicoder.dev/blog/start-smallhttps://semicoder.dev/semicoder/docs/getting-startedhttps://semicoder.dev/semicoder/docs/guides/writinghttps://semicoder.dev/semicoderhttps://semicoder.dev/blog/understand-edge-runtimehttps://semicoder.dev/blog/docs-as-part-of-code \ No newline at end of file diff --git a/src/components/Shell.tsx b/src/components/Shell.tsx index 9ca3434..3d8cc62 100644 --- a/src/components/Shell.tsx +++ b/src/components/Shell.tsx @@ -130,7 +130,7 @@ export function Shell({ children }: { children: ReactNode }) {
© {new Date().getFullYear()} 新手程序员 · semicoder.dev
- GitHub ↗ + GitHub ↗ 隐私 评论规则 管理 diff --git a/src/lib/site.ts b/src/lib/site.ts index a8695be..de36c03 100644 --- a/src/lib/site.ts +++ b/src/lib/site.ts @@ -3,7 +3,7 @@ export const site = { domain: "semicoder.dev", url: "https://semicoder.dev", description: "保持好奇，认真构建。记录编程路上的思考、实践与作品。", - repository: "https://github.com/potato47/semicoder", + repository: "https://github.com/semicoder-dev/semicoder", }; export type ContentKind = "blog" | "projects" | "docs"; interface ContentBase { diff --git a/src/routes/privacy.tsx b/src/routes/privacy.tsx index 7bb21f8..81070f3 100644 --- a/src/routes/privacy.tsx +++ b/src/routes/privacy.tsx @@ -29,7 +29,7 @@ export const Route = createFileRoute("/privacy")({

数据请求

你可删除自己的评论或退出登录。如需处理账号数据，请通过{" "} - 项目问题反馈{" "} + 项目问题反馈{" "} 发起不含个人敏感信息的联系请求，再通过合适的私密渠道核实身份。