@wenaixi/cfbridge 0.1.0 → 0.1.2

package/README.md

@@ -3,13 +3,29 @@
 > Cloudflare 官方 Code Mode MCP 在 DeepSeek Harness（DSH）中的**全局 Bundle 桥接**。
 
 [![npm](https://img.shields.io/npm/v/@wenaixi/cfbridge?color=cb3837)](https://www.npmjs.com/package/@wenaixi/cfbridge)
-[![版本](https://img.shields.io/badge/version-0.1.0-2563eb)](#版本与维护)
+[![CI](https://github.com/Wenaixi/dsh-cfbridge/actions/workflows/ci.yml/badge.svg)](https://github.com/Wenaixi/dsh-cfbridge/actions/workflows/ci.yml)
+[![版本](https://img.shields.io/badge/version-0.1.2-2563eb)](#版本与维护)
 [![许可](https://img.shields.io/badge/license-MIT-16a34a)](./LICENSE)
 
-cfbridge 是一个 **DSH Bundle（组合包）**，通过 `dsh plugin --profile <name> add` 安装到任意 DSH profile 后，**所有会话全局可见** Cloudflare 官方 Code Mode MCP 三工具（docs / search / execute）与配套 Skill，配合项目本地 Wrangler CLI 透传。
+cfbridge 是一个 **DSH Bundle（组合包）**，通过 `dsh plugin --profile web add` 装到 **web** profile 后，**所有会话全局可见** Cloudflare 官方 Code Mode MCP 三工具（docs / search / execute）与配套 Skill，配合项目本地 Wrangler CLI 透传。走 `dsh.bundle` 原生分发，无需 `prepare` 构建。
 
 > 仓库：**[Wenaixi/dsh-cfbridge](https://github.com/Wenaixi/dsh-cfbridge)** · npm 包：**[@wenaixi/cfbridge](https://www.npmjs.com/package/@wenaixi/cfbridge)**
 
+## 一键安装（装到 web）
+
+```powershell
+# 方式 A — npm（推荐）
+dsh plugin --profile web add @wenaixi/cfbridge
+
+# 方式 B — GitHub 直装（免构建）
+dsh plugin --profile web add github:Wenaixi/dsh-cfbridge#v0.1.2
+
+# 验证
+dsh --profile web --dump-config | Select-String "cfbridge"
+```
+
+装完重启 `dsh --profile web`，任意新会话即可看到 `mcp__cloudflare__*` 与 `cfbridge` Skill。其他 profile 把 `web` 换成对应名字即可。
+
 ## 它是什么
 
 ```text
@@ -63,7 +79,7 @@ dsh plugin --profile web add @wenaixi/cfbridge
 ```powershell
 dsh plugin --profile web add github:Wenaixi/dsh-cfbridge
 # 锁定版本更稳妥：
-dsh plugin --profile web add github:Wenaixi/dsh-cfbridge#v0.1.0
+dsh plugin --profile web add github:Wenaixi/dsh-cfbridge#v0.1.2
 ```
 
 > 直装前提：仓库含 `dsh.bundle` 声明且无 TypeScript 编译步骤（本仓库满足 —— 纯 JS + YAML + Markdown，GitHub 拉到的就是可运行形态，无需 `prepare`/`allowBuilds`）。
@@ -120,7 +136,7 @@ npm run dump:config
 dsh plugin --profile web add @wenaixi/cfbridge
 
 # 启用（GitHub 直装）
-dsh plugin --profile web add github:Wenaixi/dsh-cfbridge#v0.1.0
+dsh plugin --profile web add github:Wenaixi/dsh-cfbridge#v0.1.2
 
 # 停用
 dsh plugin --profile web remove @wenaixi/cfbridge
@@ -177,8 +193,8 @@ dsh plugin --profile web remove @wenaixi/cfbridge
 
 ## 版本与维护
 
-- 当前版本：**v0.1.0**（首个公开发布；Bundle 形态，运行时 Skill，全局可见）。
+- 当前版本：**v0.1.2**（首个公开发布；Bundle 形态，运行时 Skill，全局可见）。
 - 作者：**Wenaixi**
 - 许可证：MIT
 - 决策与历史记录见 [`CLAUDE.md`](./CLAUDE.md) 与 [`docs/plan-v0.3.0-global-bundle.md`](./docs/plan-v0.3.0-global-bundle.md)
-- 相关链接：[Cloudflare MCP](https://github.com/cloudflare/mcp) · [Wrangler 文档](https://developers.cloudflare.com/workers/wrangler/) · [DSH Bundle 文档](https://github.com/deepseek-ai/deepseek-harness)
+- 相关链接：[Cloudflare MCP](https://github.com/cloudflare/mcp) · [Wrangler 文档](https://developers.cloudflare.com/workers/wrangler/) · [DSH Bundle 文档](https://github.com/deepseek-ai/deepseek-harness)

package/cordis.patch.yml

@@ -1,4 +1,4 @@
-# @wenaixi/cfbridge — DSH Bundle Patch (host composition, v0.1.0)
+# @wenaixi/cfbridge — DSH Bundle Patch (host composition, v0.1.2)
 #
 # 安装后作为 web profile 的一个 bundle 层全局生效；所有会话均自动看到
 # Cloudflare Code Mode MCP 三工具（docs / search / execute）与 cfbridge Skill。
@@ -35,4 +35,4 @@
           maxAttempts: 10
 
     - id: cfbridge-skill
-      name: '@wenaixi/cfbridge/src/cfbridge-skill.js'
+      name: '@wenaixi/cfbridge/src/cfbridge-skill.js'

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wenaixi/cfbridge",
-  "version": "0.1.0",
+  "version": "0.1.2",
   "description": "Cloudflare Code Mode MCP 全局 Bundle，安装后所有 DSH 会话自动获得 docs/search/execute 三工具与 cfbridge Skill，配合项目本地 Wrangler CLI 透传。",
   "author": "Wenaixi <wenxiloveyou@gmail.com>",
   "license": "MIT",
@@ -71,4 +71,4 @@
   "engines": {
     "node": ">=22"
   }
-}
+}

package/scripts/check.js

@@ -42,7 +42,7 @@ function hasTokenLeak(text) {
 const pkg = readJson(path.join(ROOT, 'package.json'))
 if (pkg) {
   check('package name is @wenaixi/cfbridge', pkg.name === '@wenaixi/cfbridge', `got: ${pkg.name}`)
-  check('package version is 0.1.0', pkg.version === '0.1.0', `got: ${pkg.version}`)
+  check('package version is 0.1.2', pkg.version === '0.1.2', `got: ${pkg.version}`)
   check('package is not private', pkg.private !== true, pkg.private ? 'package.json must not be private for npm publish' : '')
   check('package publishConfig.access is public', pkg.publishConfig?.access === 'public', `got: ${pkg.publishConfig?.access}`)
   check('package repository points to Wenaixi/dsh-cfbridge', /github\.com\/Wenaixi\/dsh-cfbridge(\.git)?$/i.test(pkg.repository?.url || ''), `got: ${pkg.repository?.url}`)
@@ -252,4 +252,4 @@ for (const c of checks) {
   else console.log(`FAIL  ${c.name}${c.detail ? ` — ${c.detail}` : ''}`)
 }
 console.log(`\n${pass === checks.length ? 'PASS' : 'FAIL'}: ${pass}/${checks.length} checks`)
-process.exit(pass === checks.length ? 0 : 1)
+process.exit(pass === checks.length ? 0 : 1)

package/scripts/validate-bundle.js

@@ -57,8 +57,8 @@ function main() {
 
     if (pkg.name === '@wenaixi/cfbridge') pass('package name is @wenaixi/cfbridge')
     else fail('package name is @wenaixi/cfbridge', pkg.name)
-    if (pkg.version === '0.1.0') pass('package version is 0.1.0')
-    else fail('package version is 0.1.0', pkg.version)
+    if (pkg.version === '0.1.2') pass('package version is 0.1.2')
+    else fail('package version is 0.1.2', pkg.version)
     if (pkg.private !== true) pass('package is not private (npm publishable)')
     else fail('package is not private (npm publishable)', 'private must be absent/false')
     if (pkg.publishConfig && pkg.publishConfig.access === 'public') pass('publishConfig.access is public')
@@ -229,4 +229,4 @@ try {
 } catch (e) {
   console.error(`[ERR ] ${e.stack || e.message}`)
   process.exit(1)
-}
+}

package/src/cfbridge-skill.js

@@ -3,6 +3,8 @@
 // 作为 host 组合的一行，随 bundle 安装后所有会话自动可见。
 // 形态遵循 dsh-vision-toolkit 实践：inject: ['skills'] + ctx.skills.register()。
 // 资源基座指向 bundle 内的 skills/cfbridge/ 目录，内容为 SKILL.md 全文。
+// 读取放在 apply 内，以贴合 Fiber 生命周期语义：失败走 Fiber FAILED 响亮失败，
+// 且更易被 HMR 热替捕获（与模块作用域副作用区分）。
 
 const fs = require('fs')
 const path = require('path')
@@ -12,35 +14,31 @@ const path = require('path')
 const SKILL_DIR = path.resolve(__dirname, '..', 'skills', 'cfbridge')
 const SKILL_MD = path.join(SKILL_DIR, 'SKILL.md')
 
-let SKILL_CONTENT = ''
-try {
-  SKILL_CONTENT = fs.readFileSync(SKILL_MD, 'utf8')
-} catch (e) {
-  // 缺少 SKILL.md 时让 apply 抛异常，触发 loader 的响亮失败
-  throw new Error(`cfbridge-skill: cannot read SKILL.md at ${SKILL_MD}: ${e.message}`)
-}
-
-// 从首段提取 description，避免与文件内容重复维护。
-// SKILL.md 首行是标题，第三段是全局可见声明，取其精简版作 catalog 描述。
-const SKILL_DEFINITION = {
-  name: 'cfbridge',
-  description:
-    'Cloudflare Code Mode MCP 全局 Bridge：装后所有会话自动获得 mcp__cloudflare__docs/search/execute 三工具与本操作指南；含 search-then-execute 工作流、写操作审批规范、Token 权限边界与 Wrangler 透传指引。',
-  whenToUse:
-    '任何涉及 Cloudflare API 的请求（Workers/KV/D1/Pages/Zones/DNS/R2/Analytics 等）都应先加载本 Skill；执行前用 mcp__cloudflare__docs 或 mcp__cloudflare__search 确认端点，再用 mcp__cloudflare__execute 执行。',
-  source: 'runtime',
-  resourceBase: {
-    kind: 'directory',
-    path: SKILL_DIR,
-  },
-  content: SKILL_CONTENT,
-}
-
 const name = 'cfbridge-skill'
 const inject = ['skills']
 
 function apply(ctx) {
-  ctx.skills.register(SKILL_DEFINITION)
+  let content
+  try {
+    content = fs.readFileSync(SKILL_MD, 'utf8')
+  } catch (e) {
+    // 缺少 SKILL.md 时让 apply 抛异常，触发 Fiber 响亮失败（进程终止/重载报错）
+    throw new Error(`cfbridge-skill: cannot read SKILL.md at ${SKILL_MD}: ${e.message}`)
+  }
+
+  ctx.skills.register({
+    name: 'cfbridge',
+    description:
+      'Cloudflare Code Mode MCP 全局 Bridge：装后所有会话自动获得 mcp__cloudflare__docs/search/execute 三工具与本操作指南；含 search-then-execute 工作流、写操作审批规范、Token 权限边界与 Wrangler 透传指引。',
+    whenToUse:
+      '任何涉及 Cloudflare API 的请求（Workers/KV/D1/Pages/Zones/DNS/R2/Analytics 等）都应先加载本 Skill；执行前用 mcp__cloudflare__docs 或 mcp__cloudflare__search 确认端点，再用 mcp__cloudflare__execute 执行。',
+    source: 'runtime',
+    resourceBase: {
+      kind: 'directory',
+      path: SKILL_DIR,
+    },
+    content,
+  })
 }
 
 module.exports = { name, inject, apply }