@mogragsigma/dsh-dual-host-plugin 0.33.1 → 0.33.3

package/README.md

@@ -1,75 +1,98 @@
-# 大肥鱼 bot — DSH 本地与云端协作
+# 大肥鱼 bot — DSH 本地与云端协作插件
 
-`@mogragsigma/dsh-dual-host-plugin` · `0.33.1` · 作者：mogragsigma
+面向 [DeepSeek Harness（DSH）](https://github.com/deepseek-ai/deepseek-harness) 的双端协作插件：
+在本地对话或 IM 中自然语言交办，云端独立 worker 持续处理有界任务，
+在统一工作台查看成果并处理需要你决定的事项。
 
-> 面向 DeepSeek Harness（DSH）的双端协作插件。本地负责日常对话与工作台入口，
-> 云端负责持久任务、独立 worker、审批账本与受控交付。
-> 技术验收基线为官方 DSH `0.2.1-rc.3`；不保证其他 Host 版本或未经验证的平台。
+- npm 包：`@mogragsigma/dsh-dual-host-plugin`（从仓库根目录打包，入口指向 `bundle/`）
+- 兼容基线：官方 DSH `0.2.1-rc.5`
+- 许可：自定义源码可见许可（以中文文本为准），允许免费自用，禁止转售与收费对外托管
+- 本仓库是产品源码仓库；`bundle/` 为 npm 发布内容，`docs/` 为设计与验收文档
 
 ## 安装
 
-### 插件市场（推荐）
-
-在 DSH 的插件市场中搜索「大肥鱼 bot」或包名，一键安装。
-本包含原生依赖 `koffi`，pnpm 默认会拦截其构建脚本；插件市场会提示
-「允许构建脚本并重试」，点击即可完成安装。
-
-### 命令行
-
 ```sh
+# 插件市场（推荐）：在 DSH 插件市场搜索「大肥鱼 bot」一键安装
+
+# 命令行
 dsh plugin --profile web add @mogragsigma/dsh-dual-host-plugin --allow-build=koffi
 ```
 
-若所用 pnpm 不支持 `--allow-build`，可在目标 profile 的 `pnpm-workspace.yaml` 中加入：
+本包含原生依赖 `koffi`，pnpm 11 默认会拦截依赖的构建脚本；插件市场会提示
+「允许构建脚本并重试」，点击即可完成安装。若所用 pnpm 不支持 `--allow-build`，
+可在目标 profile 的 `pnpm-workspace.yaml` 中加入：
 
 ```yaml
 allowBuilds:
   koffi: true
 ```
 
-安装后按当前 Host 的方式重载 profile 或重启。Desktop 与 Web 请选择各自实际使用的 profile。
+Desktop 与 Web 请选择各自实际使用的 profile；安装后按当前 Host 的方式重载或重启。
+
+## 能力
+
+- **双端协作**：本地与云端各装同一套自有插件，按角色与配对区分职责；不要求两个机器人同群
+- **持久任务**：云端独立 worker、有界批次与预算、检查点与重启恢复；入口不持续占用
+- **按任务选模型**：以目标端实际模型目录唯一匹配为准，简称可用，歧义先澄清
+- **审批账本**：工作台自然语言意见、已绑定 IM 身份核验、持久账本与权威回执；
+  批准、排队、执行、测试、交付、已读分别证明
+- **成果与文件**：任务成果查询、受控下载与原执行会话入口；IM／本地／云端三端文件收发
+- **六页配置导览**：连接云端、模型服务、聊天与审批、成果与仓库、安装计划、配置与验收
+- **全局规则与 Skill**：保护性追加或确认后创建，不覆盖用户原规则；冲突先阻止
 
-## 组成与能力
+## 兼容与边界
 
-本包包含自有插件、全局 `AGENTS.md` 托管模板和 20 个 Skill
-（19 个按全局托管安装，`task-worker` 仅用于独立执行会话）。
-提供六页配置导览、本地／云端协作、独立 worker、按任务选模型、持久任务和审批账本、
-成果入口、文件收发及工作台。普通原生模式与工具仍由 DSH 提供，不修改其源码。
-新安装默认仅显示导览，不启动业务 worker、机器人消费者或仓库写入。
-配置、配对、真实身份确认、任务批准、开发、commit、push 与发布是不同授权，不能互相替代。
+- 仅声明已测试的官方 DSH `0.2.1-rc.5`；其他 Host 版本或平台需自行验证
+- 不修改 DSH 内核或第三方 IM 插件源码
+- 不承诺操作系统级隔离、全平台支持或全部 IM 渠道能力一致
+- 开发、commit、push、发布分别授权；源码可见不等于授权分发、部署或商业托管
+- 本项目是独立插件，不代表 DeepSeek 或依赖作者的官方产品
 
-## 配置
+## 仓库结构
 
-安装后在“大肥鱼 bot”中按六页导览配置。云端实例、模型、IM 与可选用户成果仓库均由用户拥有。
-不要求用户获取产品源码仓库权限；任务成果仓库与产品源码仓库相互独立。
-基础模型接入使用 DeepSeek 官方 API Key；可选第三方模型与 IM 通过其官方插件公开能力接入。
-没有配置模型或 IM 时不伪称调用或消息回归已通过。
+| 路径 | 内容 |
+| --- | --- |
+| `bundle/` | 插件包（npm 发布内容）：自有插件、全局规则模板、Skill、工作台客户端、许可与声明 |
+| `ui-source/` | 工作台与六页导览前端源码（`bundle/` 内为生成结果，不手改） |
+| `scripts/` | 构建、模块索引与定向回归脚本 |
+| `tests/` | 合成测试；测试依赖声明见 `tests/package.json` |
+| `docs/` | 设计、兼容、验收与发行文档 |
+| `operator-kit/` | 历史运营工具，仅供维护参考 |
+
+## 开发与测试
+
+- 需要 Node.js 22 与 Python 3；测试使用隔离 HOME／DSH_HOME 与合成服务，不读取日常配置
+- 定向回归（先阅读脚本清单，不通配执行历史测试）：
+
+```sh
+python3 scripts/run-release-regression.py
+```
 
-## 规则与数据保护
+## 许可
 
-全局规则按实际 Host 路径保护性追加，或明确确认后创建；不会覆盖用户原规则。
-Skill 安装先检查冲突及文件归属；未知改动、同名文件或符号链接冲突会阻止覆盖。
-凭据、运行账本和用户会话不在发行包内。安装、升级或卸载包不等于授权删除用户数据。
+本仓库根目录 `LICENSE` 为中文控制文本，`LICENSE.en.md` 为英文参考译本；
+npm 包内 `bundle/LICENSE` 与内容相同。核心规则：
 
-## 旧包名迁移
+- 允许任何个人和组织免费安装、运行、研究、备份和修改，含企业内部使用与内部商业工作
+- 未经另行书面授权，禁止转售、出租、商业再许可、收费再分发和收费对外托管
+- 允许免费再分发；须附许可与声明、标明修改、不得冒充官方版本
+- 不是 MIT／Apache-2.0／OSI 开源许可；许可以中文文本为准
 
-历史包名 `@local/dsh-task-gateway` 与本包是不同包管理身份，不可直接认为常规版本升级。
-不要同时启用旧、新包。原生管理精确关系、托管文件归属和历史数据应先在隔离副本中核对。
-本包不改内部凭据命名空间、不清除旧队列、不重试旧任务，也不自动改写正式 profile。
-旧归档的版本接收器仍拒绝跨包身份／元数据变化，不绕过原安全契约。
+第三方组件声明见 `bundle/THIRD_PARTY_NOTICES.md`，素材声明见 `bundle/ASSET_NOTICE.md`。
 
-## 许可与素材
+## 反馈
 
-采用 `LICENSE` 中的自定义源码可见许可《mogragsigma 源码可见·免费自用·禁止转售许可 1.0》：
-允许任何个人和组织免费使用（含企业内部使用），未经书面授权禁止转售、收费再分发或收费对外托管。
-不是 MIT／Apache-2.0／OSI 开源许可。许可以中文文本为准，`LICENSE.en.md` 为英文参考译本。
-第三方组件见 `THIRD_PARTY_NOTICES.md`，素材见 `ASSET_NOTICE.md`。
+- Issues：本仓库
+- Gitee 镜像：<https://gitee.com/wenheng-Zhang/dsh-dual-host-plugin>（可见性以该站实际状态为准）
 
-## 支持与问题反馈
+提交问题前请移除 API Key、机器人密钥、用户消息、内网地址、签名及私有任务数据。
 
-- 产品源码及说明：[GitHub 仓库](https://github.com/mogragsigma/dsh-dual-host-plugin)
-- 反馈：[Issues](https://github.com/mogragsigma/dsh-dual-host-plugin/issues)
-- Gitee 镜像：<https://gitee.com/wenheng-Zhang/dsh-dual-host-plugin>（可见性以该站实际状态为准）。
+## 0.33.3 验收合同
 
-提交问题前移除 API Key、机器人密钥、用户消息、内网地址、签名及私有任务数据。
-本项目是独立插件，不代表 DeepSeek 或依赖作者的官方产品。
+- 根包是唯一 npm 发布入口；内层 `bundle/package.json` 供受控云端归档使用，不单独发布。
+- DSH 组件使用 Host 提供的可选 peer 依赖：可选仅表示包管理器不自动安装，功能仍要求 Host 服务。
+  本版明确要求 rc.5，不在插件下安装旧版 DSH 组件，也不修改 Host 的依赖。
+- `runtime-*-package/lock.json` 是另行确认后创建独立 Host 的固定依赖，不用于修改现有 Host。
+- `run-release-regression.py` 是当前具名验收入口；旧 `release-promotion`／`market-v0331`
+  与冻结清单保留作历史，不参与当前版本验收。当前合同保留身份、锁冲突、符号链接等拒绝测试。
+- UI 从 `ui-source/` 构建，模块索引从源码生成；GitHub 镜像不再另行修改发行代码。

package/bundle/LICENSE

@@ -0,0 +1,58 @@
+mogragsigma 源码可见·免费自用·禁止转售许可 1.0
+Copyright (c) 2026 mogragsigma
+
+本许可是自定义的源码可见许可，不是 MIT、Apache-2.0 或 OSI 认证的开源许可。
+它允许任何个人和组织免费安装、运行、研究、备份和修改本软件；
+它禁止将本软件本身或其访问权用于转售、收费再分发或收费对外托管。
+
+一、定义与范围
+"本软件"指明确标注适用本许可的原始插件、全局托管规则模板、Skill 及其文档。
+"许可方"指有权授予本许可的权利人，公开署名为 mogragsigma。
+以其他许可单独授权的第三方代码、组件和素材，仍适用其各自的许可与条款。
+
+二、允许的使用
+在遵守本许可的前提下，许可方授予你一项全球范围、非独占、免许可费的著作权许可：
+你可以为本人的个人使用，或为一个组织（含企业）的内部业务运营（包括内部商业工作），
+安装、运行、研究、复制、备份和修改本软件。
+组织的人员和承包商可以仅代表该组织、在上述范围内使用。
+上述使用是免费的；本许可不要求你就使用本软件支付许可费或分成。
+
+三、成果归属
+仅因使用本软件而产生的报告、分析、代码或其他成果，本许可不施加分成、收入分享、
+非商业限制或权利转让。这不构成对成果权属或权利清洁的保证；
+成果中包含的本软件或第三方受保护内容，仍适用其各自的许可。
+
+四、禁止转售
+未经许可方另行书面授权，你不得出售、出租、商业再许可本软件、修改版本或其访问权，
+也不得为其分发收取费用。改名、重新打包或将其捆绑进收费产品，不解除本条限制。
+本条限制针对本软件；独立第三方组件按其自身许可处理，独立编写的实现不受本条限制。
+
+五、禁止收费对外托管
+未经许可方另行书面授权，你不得为外部用户提供本软件或修改版本的运营服务，
+并据此收取订阅、访问、使用或捆绑服务费用，包括提供与本软件功能相当的托管机器人或 API。
+为你自己在许可范围内的使用而支付通用云主机、模型 API、网络或存储费用的，不属于本条所称的收费托管。
+向客户交付你自己的报告或其他工作成果，本身不属于出售本软件的访问权。
+
+六、免费再分发
+你可以免费再分发本软件的原版或修改版，条件是：每一接收方同时获得本许可及适用的
+版权和第三方声明，修改之处被清楚标明，且本软件继续受本许可约束。
+你不得向接收方授予超过你自身拥有的、关于本软件的权利。适用的第三方许可不因本条而被限缩。
+
+七、署名与保留权利
+不得移除或伪造署名，不得将修改版本冒充官方版本。
+本许可不授予商标权，也不表示 mogragsigma、DeepSeek、依赖维护者或其他方的认可或背书。
+未明确授予的权利均予保留；超出本许可范围的使用需另行书面授权。
+本许可仅规范本软件本身的复制、分发与对外提供；不以本软件再分发或对外托管为内容的
+独立服务（例如单独提供的安装、培训或技术支持），不属于本许可的调整范围。
+
+八、遵守、终止与免责
+超出本许可范围使用本软件，不获授权。
+你违反第四条或第五条的，本许可自违反之日起自动终止。
+在适用法律允许的最大范围内，本软件按"现状"提供，不附带任何明示或默示的保证；
+许可方不对因使用本软件而产生的损害承担责任。适用法律赋予的强制性权利不因本条被排除。
+本许可适用中华人民共和国法律。
+因本许可产生的争议，由许可方住所地有管辖权的人民法院管辖。
+
+九、语言与版本
+本许可以中文文本为准。英文译本（LICENSE.en.md）仅为参考；中英文不一致时，以中文文本为准。
+本许可版本号为 1.0。

package/bundle/LICENSE.en.md

@@ -0,0 +1,94 @@
+MogragSigma Source-Available Free-Use, No-Resale License 1.0
+Copyright (c) 2026 mogragsigma
+
+This English text is a reference translation of the controlling Chinese license in LICENSE.
+If the two differ, the Chinese text controls.
+
+This is a custom, source-available license; it is not MIT, Apache-2.0, or an OSI-approved
+open source license. It allows any individual or organization to install, run, study,
+back up and modify the Software free of charge. It prohibits selling, charging for
+redistribution of, or charging external users for hosted access to the Software itself
+or access rights to it.
+
+1. Definitions and scope
+"The Software" means the original plugin, managed global-rule templates, Skills and
+documentation expressly designated under this license.
+"Licensor" means the rights holder entitled to grant this license, publicly identified
+as mogragsigma.
+Third-party code, components and artwork licensed separately remain subject to their own
+licenses and terms.
+
+2. Permitted use
+Subject to this license, the Licensor grants you a worldwide, non-exclusive, royalty-free
+copyright license to install, run, study, copy, back up and modify the Software for your
+own personal use, or for an organization's internal business operations (including
+internal commercial work).
+An organization's personnel and contractors may use it only on that organization's
+behalf within that scope.
+That use is free of charge; this license does not require you to pay license fees or
+share revenue for using the Software.
+
+3. Outputs
+This license imposes no revenue sharing, royalty, noncommercial restriction, or
+assignment of rights on reports, analyses, code or other outputs merely because the
+Software was used to produce them.
+This is not a guarantee of ownership of, or clearance for, those outputs; the Software
+or third-party protected content included in an output remains subject to its own
+license.
+
+4. No resale
+Without separate written authorization from the Licensor, you must not sell, rent or
+commercially sublicense the Software, modified versions, or access rights to them, and
+you must not charge for their distribution.
+Renaming, repackaging, or bundling them into a paid product does not remove this
+restriction.
+This restriction applies to the Software; independent third-party components are
+governed by their own licenses, and independently authored implementations are not
+restricted by this clause.
+
+5. No paid external hosting
+Without separate written authorization from the Licensor, you must not operate the
+Software or a modified version for external users in exchange for subscription, access,
+usage or bundled service fees, including a hosted bot or API that provides functionality
+equivalent to the Software.
+Paying for general-purpose cloud hosts, model APIs, networking or storage for your own
+use within the scope of this license is not paid hosting under this clause.
+Delivering your own reports or other work products to a customer is not, by itself,
+selling access to the Software.
+
+6. Free redistribution
+You may redistribute original or modified copies of the Software free of charge,
+provided that each recipient also receives this license and the applicable copyright and
+third-party notices, modifications are clearly identified, and the Software remains
+subject to this license.
+You may not grant recipients rights in the Software broader than you hold.
+Applicable third-party licenses are not narrowed by this clause.
+
+7. Attribution and reserved rights
+Do not remove or falsify attribution, and do not present modified versions as official
+versions.
+This license grants no trademark rights and does not imply endorsement or approval by
+mogragsigma, DeepSeek, dependency maintainers or any other party.
+Rights not expressly granted are reserved; use outside this license requires separate
+written authorization.
+This license governs only copying, distribution and making available of the Software
+itself. Independent services that do not involve redistribution or external hosting of
+the Software (for example, separately providing installation, training or technical
+support) are outside the scope of this license.
+
+8. Compliance, termination and disclaimer
+Use of the Software outside this license is not authorized.
+If you breach Section 4 or Section 5, this license terminates automatically from the
+date of the breach.
+To the maximum extent permitted by applicable law, the Software is provided "AS IS",
+without warranties of any kind, express or implied; the Licensor is not liable for
+damages arising from use of the Software. Mandatory rights under applicable law are not
+excluded by this section.
+This license is governed by the laws of the People's Republic of China.
+Disputes arising from this license are subject to the jurisdiction of the competent
+people's court at the Licensor's domicile.
+
+9. Language and version
+The Chinese text of this license controls. This English translation is for reference
+only; where the Chinese and English texts differ, the Chinese text controls.
+This license is version 1.0.

package/bundle/README.md

@@ -0,0 +1,98 @@
+# 大肥鱼 bot — DSH 本地与云端协作插件
+
+面向 [DeepSeek Harness（DSH）](https://github.com/deepseek-ai/deepseek-harness) 的双端协作插件：
+在本地对话或 IM 中自然语言交办，云端独立 worker 持续处理有界任务，
+在统一工作台查看成果并处理需要你决定的事项。
+
+- npm 包：`@mogragsigma/dsh-dual-host-plugin`（从仓库根目录打包，入口指向 `bundle/`）
+- 兼容基线：官方 DSH `0.2.1-rc.5`
+- 许可：自定义源码可见许可（以中文文本为准），允许免费自用，禁止转售与收费对外托管
+- 本仓库是产品源码仓库；`bundle/` 为 npm 发布内容，`docs/` 为设计与验收文档
+
+## 安装
+
+```sh
+# 插件市场（推荐）：在 DSH 插件市场搜索「大肥鱼 bot」一键安装
+
+# 命令行
+dsh plugin --profile web add @mogragsigma/dsh-dual-host-plugin --allow-build=koffi
+```
+
+本包含原生依赖 `koffi`，pnpm 11 默认会拦截依赖的构建脚本；插件市场会提示
+「允许构建脚本并重试」，点击即可完成安装。若所用 pnpm 不支持 `--allow-build`，
+可在目标 profile 的 `pnpm-workspace.yaml` 中加入：
+
+```yaml
+allowBuilds:
+  koffi: true
+```
+
+Desktop 与 Web 请选择各自实际使用的 profile；安装后按当前 Host 的方式重载或重启。
+
+## 能力
+
+- **双端协作**：本地与云端各装同一套自有插件，按角色与配对区分职责；不要求两个机器人同群
+- **持久任务**：云端独立 worker、有界批次与预算、检查点与重启恢复；入口不持续占用
+- **按任务选模型**：以目标端实际模型目录唯一匹配为准，简称可用，歧义先澄清
+- **审批账本**：工作台自然语言意见、已绑定 IM 身份核验、持久账本与权威回执；
+  批准、排队、执行、测试、交付、已读分别证明
+- **成果与文件**：任务成果查询、受控下载与原执行会话入口；IM／本地／云端三端文件收发
+- **六页配置导览**：连接云端、模型服务、聊天与审批、成果与仓库、安装计划、配置与验收
+- **全局规则与 Skill**：保护性追加或确认后创建，不覆盖用户原规则；冲突先阻止
+
+## 兼容与边界
+
+- 仅声明已测试的官方 DSH `0.2.1-rc.5`；其他 Host 版本或平台需自行验证
+- 不修改 DSH 内核或第三方 IM 插件源码
+- 不承诺操作系统级隔离、全平台支持或全部 IM 渠道能力一致
+- 开发、commit、push、发布分别授权；源码可见不等于授权分发、部署或商业托管
+- 本项目是独立插件，不代表 DeepSeek 或依赖作者的官方产品
+
+## 仓库结构
+
+| 路径 | 内容 |
+| --- | --- |
+| `bundle/` | 插件包（npm 发布内容）：自有插件、全局规则模板、Skill、工作台客户端、许可与声明 |
+| `ui-source/` | 工作台与六页导览前端源码（`bundle/` 内为生成结果，不手改） |
+| `scripts/` | 构建、模块索引与定向回归脚本 |
+| `tests/` | 合成测试；测试依赖声明见 `tests/package.json` |
+| `docs/` | 设计、兼容、验收与发行文档 |
+| `operator-kit/` | 历史运营工具，仅供维护参考 |
+
+## 开发与测试
+
+- 需要 Node.js 22 与 Python 3；测试使用隔离 HOME／DSH_HOME 与合成服务，不读取日常配置
+- 定向回归（先阅读脚本清单，不通配执行历史测试）：
+
+```sh
+python3 scripts/run-release-regression.py
+```
+
+## 许可
+
+本仓库根目录 `LICENSE` 为中文控制文本，`LICENSE.en.md` 为英文参考译本；
+npm 包内 `bundle/LICENSE` 与内容相同。核心规则：
+
+- 允许任何个人和组织免费安装、运行、研究、备份和修改，含企业内部使用与内部商业工作
+- 未经另行书面授权，禁止转售、出租、商业再许可、收费再分发和收费对外托管
+- 允许免费再分发；须附许可与声明、标明修改、不得冒充官方版本
+- 不是 MIT／Apache-2.0／OSI 开源许可；许可以中文文本为准
+
+第三方组件声明见 `bundle/THIRD_PARTY_NOTICES.md`，素材声明见 `bundle/ASSET_NOTICE.md`。
+
+## 反馈
+
+- Issues：本仓库
+- Gitee 镜像：<https://gitee.com/wenheng-Zhang/dsh-dual-host-plugin>（可见性以该站实际状态为准）
+
+提交问题前请移除 API Key、机器人密钥、用户消息、内网地址、签名及私有任务数据。
+
+## 0.33.3 验收合同
+
+- 根包是唯一 npm 发布入口；内层 `bundle/package.json` 供受控云端归档使用，不单独发布。
+- DSH 组件使用 Host 提供的可选 peer 依赖：可选仅表示包管理器不自动安装，功能仍要求 Host 服务。
+  本版明确要求 rc.5，不在插件下安装旧版 DSH 组件，也不修改 Host 的依赖。
+- `runtime-*-package/lock.json` 是另行确认后创建独立 Host 的固定依赖，不用于修改现有 Host。
+- `run-release-regression.py` 是当前具名验收入口；旧 `release-promotion`／`market-v0331`
+  与冻结清单保留作历史，不参与当前版本验收。当前合同保留身份、锁冲突、符号链接等拒绝测试。
+- UI 从 `ui-source/` 构建，模块索引从源码生成；GitHub 镜像不再另行修改发行代码。