jianzi-content-workbench 0.2.30 → 1.0.9

package/README.md

@@ -43,6 +43,7 @@
 - `cordis.patch.yml`：用官方 `@deepseek-ai/dsh-mcp-client` 以 stdio 启动包内 `mcp-server.mjs`，DSH 暴露 `mcp__jianzi_workbench__jianzi_*` 工具。
 - `mcp-server.mjs` + `shared/`：复用 `scripts/agent-integration/` 的工具定义、执行器与本机 API 客户端，默认 `http://127.0.0.1:4317`（`JIANZI_WORKBENCH_URL` 可覆盖）。
 - DSH 中调用 `jianzi_workbench_start` 可启动已停止的本机项目并等待健康检查；通过 `projectRoot` 参数或 MCP 进程环境变量 `JIANZI_PROJECT_ROOT` 指定源码项目绝对路径。启动器复用项目内官方启动脚本，不会打开浏览器，并并行轮询就绪接口；服务有效响应后立即核对健康信息与项目指纹，避免启动器进程未退出造成误报。启动最多等待 90 秒，DSH MCP 单次调用上限为 120 秒。
+- DSH 插件/MCP 版本高于本地项目时，工具会停止业务调用并提示在项目根目录 `git pull`，按项目升级说明更新依赖并重建，再重启工作台和 MCP；工作台状态卡也会展示本地版本、所需版本和修复步骤。
 - 面板文案不硬编码 MCP 工具名，也不复述流程细节；流程以项目技能为准，改流程只改技能。
 
 ## 面板读取的数据
@@ -73,17 +74,17 @@ Host 插件（`dsh/index.mjs`）通过官方 `ctx.webServer.register` 注册读
 从仓库根目录运行：
 
 ```sh
-node agent-integrations/dsh-workbench/build.mjs
-cd agent-integrations/dsh-workbench
-pnpm pack
+npm run release
 ```
 
+统一发布目录 `dist/` 会包含源码 ZIP、单独的 DSH 插件 `.tgz` 和校验和；Release workflow 会将 tag 作为版本号，同时戳记项目与插件包。只调试插件包时，可运行 `npm run build --prefix agent-integrations/dsh-workbench`，再从仓库根目录执行 `node scripts/release/pack-dsh-plugin.mjs ./dist`。
+
 本地 `.tgz` 安装适用于开发和调试；普通用户直接在插件管理器中输入 npm 包名即可。DSH 插件索引是另一种分发方式，目前未单独发布。详见官方[插件打包与发布说明](https://github.com/deepseek-ai/deepseek-harness/blob/master/docs/user/develop/basic/publish.md)及[插件索引说明](https://github.com/deepseek-ai/deepseek-harness/blob/master/docs/user/guide/plugin-market.md)。
 
 MCP 服务入口路径在 patch 中按 profile 写死（当前 `profiles/desktop`）；在其他 profile 安装时需要同步修改。
 
 ## npm 正式发布
 
-正式发布由仓库的 `Publish DSH plugin to npm` GitHub Actions 工作流执行。将插件 `package.json` 的版本更新并合入主分支后，推送对应标签 `dsh-plugin-v<版本号>`（例如 `dsh-plugin-v0.2.30`）。工作流会核对标签和包版本、构建、生成 `.tgz`、上传 GitHub Actions 产物，并将同一个 `.tgz` 发布到 npm。不要用普通 CI 提交触发发布。
+推送数字版本 tag（如 `1.0.7`）会同时触发 GitHub Release 打包和 DSH npm 发布。npm 工作流从 tag 提取版本，在临时工作区戳记项目与插件包版本，并查询 npm registry；如果该版本已发布，CI 会失败。旧式 `dsh-plugin-v<版本>` 标签仍可单独触发插件发布。无需手动修改项目或插件 `package.json` 的版本，也不要用普通 CI 提交触发发布。
 
 首次版本已发布到 npm Registry，GitHub Actions 已配置 **Trusted Publisher**：用户 `shiker1996`、仓库 `wechat-editroom`、工作流文件名 `publish-dsh-plugin.yml`，并允许直接发布。后续推送匹配包版本的标签时，工作流会通过 OIDC 发布，无需长期 npm 发布令牌。

package/dsh/index.mjs

@@ -14,9 +14,14 @@ const json = (payload, status = 200) => new Response(JSON.stringify(payload), {
 
 const failed = (error) => {
   console.error('Jianzi workbench route failure', error);
+  const compatibilityError = error?.code === 'WORKBENCH_VERSION_MISMATCH';
   return {
     ok: false,
-    error: { code: error?.code || 'JIANZI_READ_FAILED', message: 'Request failed' },
+    error: {
+      code: error?.code || 'JIANZI_READ_FAILED',
+      message: compatibilityError ? error.message : 'Request failed',
+      ...(compatibilityError && error.details ? { details: error.details } : {}),
+    },
   };
 };
 

package/lib/client.js

@@ -20,6 +20,8 @@ window.__ModuleLoader__.load({
         statusLoading: 'Checking…',
         statusOnline: 'Online',
         statusOffline: 'Unavailable',
+        statusUpdateRequired: 'Project update required',
+        statusUpgradeRequired: 'Installed MCP/plugin requires project version {required}; this project is {current}. Run git pull in the project root, update/rebuild as instructed, then restart the workbench and MCP connection.',
         statusRsshub: 'RSSHub',
         statusGithub: 'GitHub',
         statusOk: 'ok',
@@ -138,7 +140,7 @@ window.__ModuleLoader__.load({
         hotspotIdLabel: 'Hotspot ID: ',
         yes: 'yes',
         no: 'no',
-        promptSetup: 'Load the jianzi-workbench-setup skill if available; otherwise follow these instructions. Call jianzi_doctor first and use this DSH session’s workspace as projectRoot; never use the DSH profile/plugin directory. If offline and the project contains server.mjs plus scripts/runtime/start-workbench.ps1 or .sh, call jianzi_workbench_start and wait for ready plus a matching fingerprint. If no project exists, stop and ask whether to clone https://github.com/shiker1996/wechat-editroom.git into an empty directory; clone only after confirmation, never overwrite files, then run setup-workbench.cmd or ./setup-workbench.sh with my choices. Do not use --yes or install RSSHub unless I choose it. Once ready, verify RSSHub, sources, account profile, and collectors. Never read or output .env/secrets. If workspace or terminal tools are unavailable, give manual steps. Report each check in one line.',
+        promptSetup: 'Load the jianzi-workbench-setup skill if available; otherwise follow these instructions. Call jianzi_doctor first and use this DSH session’s workspace as projectRoot; never use the DSH profile/plugin directory. If it returns WORKBENCH_VERSION_MISMATCH, stop business tool calls and tell me to git pull in the project root, update/rebuild as instructed, then restart the workbench and MCP before retrying doctor. If offline and the project contains server.mjs plus scripts/runtime/start-workbench.ps1 or .sh, call jianzi_workbench_start and wait for ready plus a matching fingerprint. If no project exists, stop and ask whether to clone https://github.com/shiker1996/wechat-editroom.git into an empty directory; clone only after confirmation, never overwrite files, then run setup-workbench.cmd or ./setup-workbench.sh with my choices. Do not use --yes or install RSSHub unless I choose it. Once ready, verify RSSHub, sources, account profile, and collectors. Never read or output .env/secrets. If workspace or terminal tools are unavailable, give manual steps. Report each check in one line.',
         promptTopics: 'Load the jianzi-topic-to-article skill and run its topic-discovery stage. Follow the skill order strictly: create or reuse a batch, collect and wait for the job, submit tags, build events and fact cards, run the research stages, then read the rankings. Do not call any Jianzi internal-model tool. Finish with a ranked shortlist that includes batch ID, candidate/hotspot IDs, rationale, risks, and source links. Stop for my topic choice before adding a candidate or drafting an article.',
         promptArticle: 'Load the jianzi-topic-to-article skill and run its article stage. Fetch the candidate source first, read the candidate, account profile, and article-length settings, and show me the editorial angle for confirmation. Then save a draft and read it back. Do not save a final and do not start typesetting until I confirm the generated article.',
         promptTypeset: 'Load the jianzi-typeset-cover skill and run typesetting and cover generation. Read the article documents first: continue only when a user-confirmed final exists. If only a draft exists, stop and explain. Generate the WeChat HTML, submit it for typesetting, generate the cover, and return both preview links. Do not publish to WeChat and do not call Jianzi internal-model typesetting tools.',
@@ -156,6 +158,8 @@ window.__ModuleLoader__.load({
         statusLoading: '检查中…',
         statusOnline: '已连接',
         statusOffline: '未连接',
+        statusUpdateRequired: '需要更新项目',
+        statusUpgradeRequired: '当前 MCP/插件需要项目版本 {required}，本地项目为 {current}。请在项目根目录执行 git pull，按升级说明更新依赖并重新构建，然后重启工作台和 MCP 连接。',
         statusRsshub: 'RSSHub',
         statusGithub: 'GitHub',
         statusOk: '正常',
@@ -274,7 +278,7 @@ window.__ModuleLoader__.load({
         hotspotIdLabel: '热点 ID：',
         yes: '是',
         no: '否',
-        promptSetup: '如可用，加载 jianzi-workbench-setup 技能；否则按本提示执行。先调用 jianzi_doctor，并使用当前 DSH 会话工作空间作为 projectRoot；不要用 DSH profile/插件目录。服务未连接且目录含 server.mjs 与 scripts/runtime/start-workbench.ps1 或 .sh 时，调用 jianzi_workbench_start，等待 ready 和 workspaceId 指纹匹配。若没有项目，停止启动并询问是否克隆 https://github.com/shiker1996/wechat-editroom.git 到空目录；确认后才克隆，不覆盖文件，再运行 setup-workbench.cmd 或 ./setup-workbench.sh 并逐项让我选择。不要用 --yes；未经我选择不要安装 RSSHub。就绪后检查 RSSHub、采集源、账号画像和采集器。不要读取或输出 .env/密钥。若无工作区或终端工具，提供手动步骤。每项检查用一句话汇报。',
+        promptSetup: '如可用，加载 jianzi-workbench-setup 技能；否则按本提示执行。先调用 jianzi_doctor，并使用当前 DSH 会话工作空间作为 projectRoot；不要用 DSH profile/插件目录。若返回 WORKBENCH_VERSION_MISMATCH，停止业务工具调用，说明本地项目版本与插件/MCP 所需版本，并让我在项目根目录执行 git pull，按升级说明更新依赖并重建，再重启工作台和 MCP；完成后重调 doctor。服务未连接且目录含 server.mjs 与 scripts/runtime/start-workbench.ps1 或 .sh 时，调用 jianzi_workbench_start，等待 ready 和 workspaceId 指纹匹配。若没有项目，停止启动并询问是否克隆 https://github.com/shiker1996/wechat-editroom.git 到空目录；确认后才克隆，不覆盖文件，再运行 setup-workbench.cmd 或 ./setup-workbench.sh 并逐项让我选择。不要用 --yes；未经我选择不要安装 RSSHub。就绪后检查 RSSHub、采集源、账号画像和采集器。不要读取或输出 .env/密钥。若无工作区或终端工具，提供手动步骤。每项检查用一句话汇报。',
         promptTopics: '加载 jianzi-topic-to-article 技能，执行选题阶段。严格按技能顺序：创建或复用批次 → 采集并等待任务完成 → 提交打标 → 生成事件与事实卡 → 运行研判阶段 → 读取榜单。不要调用见字内部模型工具。最后给我一份排序清单，包含批次 ID、候选/热点 ID、理由、风险和来源链接；等我选题后再加入候选或写文章。',
         promptArticle: '加载 jianzi-topic-to-article 技能，执行文章阶段。先抓取候选原文，读取候选、账号画像和文章字数设置，把编辑角度给我确认；确认后保存 draft 并回读。未经我确认不要保存 final，也不要开始排版。',
         promptTypeset: '加载 jianzi-typeset-cover 技能，执行排版与封面。先读取文章文档，只有存在我确认过的 final 才继续；只有 draft 就停下来说明。生成公众号 HTML 并提交排版，再生成封面，返回两个预览入口。不要发布到公众号，也不要调用见字内部模型排版工具。',
@@ -500,6 +504,7 @@ window.__ModuleLoader__.load({
       const [pending, setPending] = React.useState('');
       const [status, setStatus] = React.useState(null);
       const [health, setHealth] = React.useState(null);
+      const [healthError, setHealthError] = React.useState(null);
       const [batches, setBatches] = React.useState([]);
       const [candidates, setCandidates] = React.useState([]);
       const [social, setSocial] = React.useState([]);
@@ -537,13 +542,23 @@ window.__ModuleLoader__.load({
         }
       };
 
+      const readEnvelope = async (url) => {
+        try {
+          const response = await fetch(url, { headers: { accept: 'application/json' } });
+          return await response.json();
+        } catch {
+          return null;
+        }
+      };
+
       const loadStatus = async () => {
         setLoadingStatus(true);
         const [doctor, list] = await Promise.all([
-          readJson('/jianzi/status'),
+          readEnvelope('/jianzi/status'),
           readJson('/jianzi/batches?limit=8'),
         ]);
-        setHealth(doctor || null);
+        setHealth(doctor?.ok ? doctor.data : null);
+        setHealthError(doctor?.ok ? null : doctor?.error || null);
         setBatches(Array.isArray(list) ? list : []);
         setLoadingStatus(false);
       };
@@ -763,6 +778,12 @@ window.__ModuleLoader__.load({
         `${tr('hotspotsLabel')} ${currentBatch.hotspot_count ?? 0}`,
         `${tr('artifactsLabel')} ${currentBatch.artifact_count ?? 0}`,
       ].filter(Boolean).join(' · ') : '';
+      const statusUpdateRequired = healthError?.code === 'WORKBENCH_VERSION_MISMATCH';
+      const versionHint = statusUpdateRequired
+        ? tr('statusUpgradeRequired')
+          .replace('{required}', String(healthError?.details?.requiredVersion || '未知'))
+          .replace('{current}', String(healthError?.details?.currentVersion || '未知'))
+        : '';
 
       return h(React.Fragment, null,
         h('style', null, styles),
@@ -786,12 +807,13 @@ window.__ModuleLoader__.load({
                 ),
                 h('div', { className: 'jianzi-desk__status-line' },
                   h('span', { className: health ? 'jianzi-desk__status-dot jianzi-desk__status-dot--online' : 'jianzi-desk__status-dot', 'aria-hidden': true }),
-                  h('span', null, health ? tr('statusOnline') : tr('statusOffline')),
+                  h('span', null, statusUpdateRequired ? tr('statusUpdateRequired') : health ? tr('statusOnline') : tr('statusOffline')),
                 ),
                 h('div', { className: 'jianzi-desk__status-details' },
                   [['RSSHub', Boolean(health && health.health && health.health.rsshub && health.health.rsshub.ok)], ['GitHub', Boolean(health && health.health && health.health.github && health.health.github.authenticated)]].map(([name, ready]) => h('span', { className: 'jianzi-desk__status-pill', key: name }, name, h('b', null, health ? (ready ? tr('statusOk') : tr('statusBad')) : '—'))),
                 ),
-                !health && !loadingStatus ? h('div', { className: 'jianzi-desk__start' },
+                statusUpdateRequired ? h('p', { className: 'jianzi-desk__start-message jianzi-desk__start-message--error', role: 'alert' }, versionHint) : null,
+                !health && !loadingStatus && !statusUpdateRequired ? h('div', { className: 'jianzi-desk__start' },
                   h('button', { type: 'button', onClick: () => void startProject(), disabled: startingProject }, startingProject ? tr('startingProject') : tr('startProject')),
                   startupMessage ? h('p', { className: `jianzi-desk__start-message jianzi-desk__start-message--${startupMessage.kind}`, role: 'status' }, startupMessage.text) : null,
                 ) : null,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "jianzi-content-workbench",
-  "version": "0.2.30",
+  "version": "1.0.9",
   "icon": "./icon.svg",
   "description": "DSH content workbench panel that starts native Agent sessions backed by Jianzi MCP tools.",
   "repository": {
@@ -29,7 +29,9 @@
     "icon.svg"
   ],
   "dsh": {
-    "bundle": { "patch": "./cordis.patch.yml" },
+    "bundle": {
+      "patch": "./cordis.patch.yml"
+    },
     "client": {
       "platform": "web",
       "immediately": true
@@ -39,5 +41,7 @@
     "@deepseek-ai/dsh-mcp-client": "0.2.2-rc.1",
     "@deepseek-ai/schemastery": "*"
   },
-  "scripts": { "build": "node ./build.mjs" }
+  "scripts": {
+    "build": "node ./build.mjs"
+  }
 }

package/shared/tools.mjs

@@ -11,6 +11,15 @@ const positiveId = (value, field) => {
   return parsed;
 };
 const sensitiveField = /^(?:api[_-]?key|token|secret|password|authorization|cookie|credential|credentials)$/i;
+const MCP_PACKAGE_VERSION = (() => {
+  const candidates = [new URL('../../package.json', import.meta.url), new URL('../package.json', import.meta.url)];
+  for (const url of candidates) {
+    if (!fs.existsSync(url)) continue;
+    const version = JSON.parse(fs.readFileSync(url, 'utf8')).version;
+    if (typeof version === 'string' && version.trim()) return version.trim();
+  }
+  throw new Error('无法读取 MCP 所属 package.json 版本');
+})();
 
 function redactSensitive(value, key = '') {
   if (Array.isArray(value)) return value.map((item) => redactSensitive(item));
@@ -49,7 +58,7 @@ function safeImageResult(result) {
 }
 
 export const JIANZI_TOOLS = [
-  { name: 'jianzi_doctor', description: '检查见字工作台连接、Node 运行时和核心功能是否可用。', inputSchema: { type: 'object', properties: {} }, readOnlyHint: true },
+  { name: 'jianzi_doctor', description: '检查见字工作台连接、项目版本与 MCP/插件兼容性、Node 运行时和核心功能是否可用。若版本不兼容，先按返回提示更新项目并重启，再继续业务工具。', inputSchema: { type: 'object', properties: {} }, readOnlyHint: true },
   { name: 'jianzi_workbench_start', description: '当用户要求启动已停止的本机见字工作台，或 jianzi_doctor 报告服务未运行时，调用项目官方启动脚本并等待服务 ready，再执行健康检查。不会打开浏览器或修改业务数据。源码 MCP 默认使用当前项目根目录；打包/独立 MCP 可传项目绝对路径 projectRoot，或设置 JIANZI_PROJECT_ROOT。', inputSchema: { type: 'object', properties: { projectRoot: string('见字项目的本机绝对路径。源码集成可省略；DSH/npm 包未配置 JIANZI_PROJECT_ROOT 时必须提供。') } }, readOnlyHint: false },
   { name: 'jianzi_account_profile', description: '读取账号画像，用于选题定位、语气和受众判断。', inputSchema: { type: 'object', properties: {} }, readOnlyHint: true },
   { name: 'jianzi_account_profile_update', description: '保存用户确认过的账号画像。至少包含公众号名称、简介、核心读者和一个内容支柱。', inputSchema: { type: 'object', properties: { context: { type: 'object', description: '符合 account-context.json 格式的账号画像字段。' } }, required: ['context'] }, readOnlyHint: false },
@@ -247,6 +256,42 @@ function unavailableWorkbenchError(error, address) {
   return unavailable;
 }
 
+function versionParts(value) {
+  const match = String(value || '').trim().match(/^(\d+)\.(\d+)\.(\d+)(?:[-+].*)?$/);
+  return match ? match.slice(1, 4).map(Number) : null;
+}
+
+function isVersionBelow(current, required) {
+  const actualParts = versionParts(current);
+  const requiredParts = versionParts(required);
+  if (!actualParts || !requiredParts) return true;
+  for (let index = 0; index < 3; index += 1) {
+    if (actualParts[index] < requiredParts[index]) return true;
+    if (actualParts[index] > requiredParts[index]) return false;
+  }
+  return false;
+}
+
+function outdatedWorkbenchError(currentVersion) {
+  const current = String(currentVersion || '').trim() || '未知';
+  const error = new Error(`本地见字项目版本为 ${current}，当前 MCP/插件需要 ${MCP_PACKAGE_VERSION} 或更高版本。请在项目根目录执行 git pull，按项目升级说明更新依赖并重新构建，然后重启工作台和 MCP 连接，再重试。`);
+  error.code = 'WORKBENCH_VERSION_MISMATCH';
+  error.details = { currentVersion: currentVersion || null, requiredVersion: MCP_PACKAGE_VERSION, action: 'git pull, update dependencies/build if required, restart workbench and MCP' };
+  return error;
+}
+
+async function assertWorkbenchVersion(client) {
+  let result;
+  try {
+    result = await client.get('/api/system/health?target=version');
+  } catch (error) {
+    if (['HTTP_400', 'HTTP_404'].includes(error?.code)) throw outdatedWorkbenchError(null);
+    throw unavailableWorkbenchError(error, client.baseUrl);
+  }
+  if (isVersionBelow(result?.appVersion, MCP_PACKAGE_VERSION)) throw outdatedWorkbenchError(result?.appVersion);
+  return result;
+}
+
 async function withArtifactEntry(client, result, type, candidateId = null) {
   const entries = {
     articlePreview: { label: '文章预览', path: '/#preview' },
@@ -279,11 +324,13 @@ function artifactTypeForJob(job) {
 export async function executeJianziTool(client, name, input = {}, context = {}) {
   const batch = encodeURIComponent(String(input.batchId || ''));
   const candidate = encodeURIComponent(String(input.candidateId || ''));
+  if (!['jianzi_doctor', 'jianzi_workbench_start'].includes(name)) await assertWorkbenchVersion(client);
   switch (name) {
     case 'jianzi_doctor': {
       try {
         const [health, batches] = await Promise.all([client.get('/api/system/health'), client.get('/api/batches?limit=1')]);
-        return { connected: true, node: health.node, health, sampleBatchCount: Array.isArray(batches) ? batches.length : 0 };
+        if (isVersionBelow(health?.appVersion, MCP_PACKAGE_VERSION)) throw outdatedWorkbenchError(health?.appVersion);
+        return { connected: true, node: health.node, integrationVersion: MCP_PACKAGE_VERSION, health, sampleBatchCount: Array.isArray(batches) ? batches.length : 0 };
       } catch (error) {
         throw unavailableWorkbenchError(error, client.baseUrl);
       }