dsh-fatfish-suite 0.0.0-stage → 0.1.1

package/CHANGELOG.md

@@ -0,0 +1,24 @@
+# Changelog
+
+## 0.1.1 — 2026-11-02
+
+- 依赖锁到 `dsh-fatfish@0.5.1`：0.5.0 在本代 DSH NEXT 宿主上装载失败（配置校验与 `command` 注入两处硬伤），
+  套装挂着它等于三件里最要紧的那件装不上。
+- 修复装载硬伤：`command` 只在 agent 上下文的子作用域提供，写进 `inject` 会让整枚插件永远 `pending`，
+  不写直接读又会被宿主抛 `cannot get property "command" without inject`。改成 try/catch 按需取——
+  取不到只少 `fatfish.suite` 这一条命令，两个只读状态工具照常装载。
+- `fatfish_suite_status` 的套装自身版本回退值同步为 `0.1.1`。
+
+## 0.1.0 — 2026-10-30
+
+首个版本。把这几天的三件能力打成一个市场可安装的套装。
+
+- 新增 `fatfish_suite_status`：只读检查 `dsh-fatfish` / `dsh-fatfish-hands` / `dsh-quota-guard`
+  是否安装、是否通过 `cordis.patch.yml` 挂载、版本是否与套装要求一致。
+- 新增 `fatfish_suite_guide`：按主题返回用法与安全边界（总览 / 记忆 / 浏览器 / 额度 / 查毒 /
+  独立桌面版 / 安装卸载），只返回说明文字，不执行动作。
+- 新增 `fatfish.suite` 命令：在 DSH 命令面板里直接看套装状态。
+- `cordis.patch.yml` 一次插入三件：人设、之手、额度护栏。额度护栏保持默认只记账不拦截。
+- 依赖锁定为 `dsh-fatfish@0.5.0`、`dsh-fatfish-hands@0.1.3`、`dsh-quota-guard@0.1.3`，
+  套装自身不联网、不读聊天、不执行命令。
+- 明确「套装与三件套二选一」，避免重复挂载。

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 dsh-fatfish contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,3 +1,124 @@
-# Temporary Holding Version
+# dsh-fatfish-suite · 大肥鱼套装
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+一条命令，把大肥鱼这几天的三件能力一起装进 DSH：
+
+| 同伴包 | 它负责什么 | 版本 |
+| --- | --- | --- |
+| [`dsh-fatfish`](https://www.npmjs.com/package/dsh-fatfish) | 四档人设、时段与情绪、本地记忆、只读查毒与可更新病毒库、七个小动作 | 0.5.1 |
+| [`dsh-fatfish-hands`](https://www.npmjs.com/package/dsh-fatfish-hands) | 用专用 Edge 真上网：读正文、点链接、搜索、截图；另带只读电脑状态 | 0.1.3 |
+| [`dsh-quota-guard`](https://www.npmjs.com/package/dsh-quota-guard) | 模型用量账本、每日/每分钟限额、免费账号轮换 | 0.1.3 |
+
+套装本身不联网、不读聊天、不执行命令；它只做两件事：把三件挂进 DSH，以及提供两个只读工具
+`fatfish_suite_status`（装齐了没）和 `fatfish_suite_guide`（怎么用、边界在哪）。
+
+## 安装
+
+在 DSH 插件市场搜 `fatfish`，或者：
+
+```bash
+dsh plugin --profile desktop add dsh-fatfish-suite
+```
+
+装完重启 DSH。设置 → 插件里能看到三个条目：
+
+- **大肥鱼**：人设、记忆、查毒、动作；
+- **大肥鱼之手**：首次调用会自动起一个专用 Edge 窗口；
+- **额度护栏**：默认只记账，不拦请求。
+
+> 套装和三件套**二选一**。已经单独装过其中任何一个，再装套装会出现重复挂载；
+> 请先卸掉单独装的包，或者只装三件套、不装套装。
+
+本地目录安装（还没发 npm 时）：
+
+```bash
+node scripts/install-to-dsh.mjs --suite
+```
+
+它会把套装和三个同伴复制进 `~/.dsh/profiles/desktop/node_modules/`，
+只把 `dsh-fatfish-suite` 写进 profile 的 `bundles`，避免重复挂载；改之前留 `.bak-<时间戳>` 备份。
+
+## 装完能干什么
+
+- **聊天有性格**：好脾气 / 毒舌 / 犯困 / 自定义；按早晚调整语气，按时间算精力与心情。
+- **记得住**：名字、喜好、习惯、生日记在本机 `~/.dsh/fatfish/memory.json`；能召回、能遗忘。
+- **会查毒**：进程名、命令行、开机启动项、常用目录文件哈希；只报告，不删文件、不杀进程。
+- **会上网**：读页面正文和链接，点编号链接、搜索、截图；不靠像素坐标猜位置。
+- **看得到电脑**：内存、开机时长、CPU、最占内存的进程；只读。
+- **管得住额度**：每次模型调用记 token 与耗时，可按天/按分钟设上限，免费账号之间自动切换。
+
+## 默认免费优先
+
+套装不配置任何付费开关，也不会自动充值或自动切到付费账号：
+
+- 额度护栏默认所有限额为 `0`（只记账，不拦）；没配单价的模型会标 `priced: false`，
+  `costCny: 0` **不代表免费**。
+- 要限额，在 DSH 用户层 `cordis.patch.yml` 覆盖 `id: llm-guard`：
+
+```yaml
+- id: llm-guard
+  name: dsh-quota-guard
+  config:
+    limits:
+      dailyTokens: 2000000
+      dailyRequests: 1500
+      perMinuteRequests: 30
+      warnAt: 0.8
+      onExceed: warn        # 先用 warn 观察一周，再考虑 block
+```
+
+- 要用付费模型，必须自己改配置，并先算清楚单价与预算；套装不会替你做这个决定。
+
+## 红线（写在各插件内核里，配置关不掉）
+
+- **不自动回复私聊**：可以读聊天记录与通讯录，但回复必须由主人发出。
+- **不代付**：支付、网购、收银台、网银页面拒绝打开、点击与输入；付款由主人完成。
+- **不碰日常浏览器**：之手只使用独立配置 `~/.dsh/fatfish-hands/edge-profile`，
+  不读日常 Edge 的登录态、书签、历史。
+- **不下载**：默认拒绝，只允许 `http/https`，`file://` 一律拒绝。
+- **不记敏感信息**：密码、验证码、证件号、银行卡、手机号、住址、API Key 一律拒收。
+- **不上传**：无遥测、无云端账号；唯一外发是病毒库订阅和主人自己配置的模型调用。
+- **查毒不处置**：只报告；重要场合请用专业安全软件复扫。
+
+## 配置在哪
+
+| 内容 | 位置 |
+| --- | --- |
+| 人设 / 记忆 / 查毒选项 | DSH 用户层 `cordis.patch.yml` 的 `id: dsh-fatfish` |
+| Edge 选项 | `~/.dsh/fatfish-hands.config.json` |
+| 额度限额与账号池 | DSH 用户层 `cordis.patch.yml` 的 `id: llm-guard` |
+| 记忆与查毒缓存 | `~/.dsh/fatfish/` |
+| 浏览器配置与截图 | `~/.dsh/fatfish-hands/` |
+| 用量账本 | `~/.dsh/llm-guard/usage.json` |
+
+删掉对应目录即清空那一部分数据；卸载套装不会自动删这些目录。
+
+## 与桌面完整版的关系
+
+电脑上的「大肥鱼陪伴」独立程序是完整版：独立窗口、桌宠气泡、聊天存档、自动备份、
+加密保险库、本地 OpenAI 兼容中转。套装是 DSH 插件形态，两者不共享进程：
+
+- 套装不会自动读独立版的记忆，也不会替它回复私聊；
+- 想日常陪伴与本地中转，用独立程序；
+- 想让 DSH 里的 agent 上网、查毒、管额度，用套装。
+
+## 卸载
+
+```bash
+dsh plugin --profile desktop remove dsh-fatfish-suite
+dsh plugin --profile desktop remove dsh-fatfish dsh-fatfish-hands dsh-quota-guard
+```
+
+然后按需删 `~/.dsh/fatfish*`、`~/.dsh/llm-guard`。卸载不会删除你的聊天记录或桌面版数据。
+
+## 开发
+
+```bash
+node dsh-fatfish-suite/test/plugin.mjs      # 套装契约：工具注册、状态、指南、卸载
+node dsh-fatfish/test/plugin.mjs            # 人设契约
+node dsh-fatfish-hands/test/plugin.mjs      # 之手契约（不开浏览器）
+node dsh-quota-guard/test/*.test.js         # 额度护栏离线测试
+```
+
+## License
+
+MIT

package/SECURITY.md

@@ -0,0 +1,52 @@
+# 安全说明
+
+## 报告问题
+
+发现安全问题**不要**公开开 issue。用仓库的 GitHub Security Advisories 私下报告，
+或直接联系维护者。写清楚：复现步骤、影响版本、可能后果。48 小时内回复。
+
+## 威胁模型
+
+套装本身是**元包**：它不联网、不读聊天、不执行命令、不写文件，只负责把三个同伴插件
+挂进 DSH，并提供两个只读工具。真正的能力与风险都在同伴包里，各自有独立的安全说明：
+
+- `dsh-fatfish`：人设、本地记忆、只读查毒；
+- `dsh-fatfish-hands`：专用 Edge 上网、只读电脑状态；
+- `dsh-quota-guard`：模型用量账本、限额、账号轮换。
+
+套装要防的是**误装带来的权限叠加**：用户以为自己只装了一个聊天插件，实际同时获得了
+浏览器操作、电脑状态读取和模型调用记账能力。
+
+## 硬边界
+
+| 能力 | 限制 | 实现位置 |
+| --- | --- | --- |
+| 套装自身网络 | 完全无网络请求 | `lib/index.js` 只读本地文件 |
+| 套装自身写入 | 不写文件、不建目录、不改配置 | `lib/index.js` |
+| 状态检查 | 只读 `package.json` 与自己的 `cordis.patch.yml` | `fatfish_suite_status` |
+| 说明工具 | 只返回静态文字，不执行任何动作 | `fatfish_suite_guide` |
+| 能力来源 | 全部来自三个同伴包，各自的红线独立生效 | 见各包 `SECURITY.md` |
+| 重复挂载 | 文档明确「套装与三件套二选一」；自检检查 patch 覆盖关系 | README / 上架自检 |
+
+**不提供**：执行 shell、读任意文件内容、读剪贴板、发消息、改系统设置、下载、支付。
+
+## 数据落在哪
+
+套装自身不落任何数据。同伴包的数据位置：
+
+| 内容 | 路径 |
+| --- | --- |
+| 记忆与查毒缓存 | `~/.dsh/fatfish/` |
+| Edge 配置与截图 | `~/.dsh/fatfish-hands/` |
+| 用量账本 | `~/.dsh/llm-guard/usage.json` |
+| 配置 | DSH 用户层 `cordis.patch.yml` |
+
+## 安装前请确认
+
+- 你接受「浏览器操作 + 电脑状态读取 + 模型用量记账」这三项能力同时存在；
+- 你已经装过其中某个同伴包时，先卸载它，避免重复挂载；
+- 额度护栏默认只记账不拦截；要防费用失控，请自己配置 `limits`，先用 `warn` 观察。
+
+## 支持版本
+
+只对最新发布版本提供安全修复。

package/cordis.patch.yml

@@ -0,0 +1,40 @@
+# ============================================================================
+# dsh-fatfish-suite —— 大肥鱼套装 bundle patch
+#
+# 装这一个包，等于同时挂上三件：
+#   dsh-fatfish        大肥鱼：人设 / 时段与情绪 / 本地记忆 / 只读查毒 / 小动作
+#   dsh-fatfish-hands  大肥鱼之手：专用 Edge 上网 / 读页面 / 截图 / 只读电脑状态
+#   dsh-quota-guard    额度护栏：用量账本 / 每日限额 / 免费账号轮换
+#
+# ⚠️ 套装和三件套二选一。已经单独装过其中任何一个，再装套装会出现重复挂载，
+#    请先 `dsh plugin remove` 掉单独装的包，或者别装套装。
+#
+# 想改人设/记忆/查毒选项：在用户层 cordis.patch.yml 覆盖 id: dsh-fatfish。
+# 想设限额：覆盖 id: llm-guard，给 limits.dailyTokens / dailyRequests 赋值。
+# ============================================================================
+
+- insert:
+    - id: dsh-fatfish
+      name: dsh-fatfish
+      config:
+        mode: normal
+        custom: ''
+        enableTimeAwareness: true
+        enableMood: true
+        memory:
+          enabled: true
+          autoCapture: true
+          maxFacts: 300
+        security:
+          enabled: true
+          feedUrl: https://gitee.com/akiba-yuzuki_0/dsh-fatfish/raw/master/signatures.json
+          autoUpdate: true
+          updateHours: 12
+
+    - id: dsh-fatfish-hands
+      name: dsh-fatfish-hands
+
+    - id: llm-guard
+      name: dsh-quota-guard
+      config:
+        enabled: true

package/lib/index.js

@@ -0,0 +1,291 @@
+/**
+ * dsh-fatfish-suite —— 大肥鱼套装入口
+ *
+ * 一个包装齐三件：人设/记忆/查毒、Edge 上网、额度护栏。
+ * 本包自己不联网、不读聊天、不执行命令，只做两件事：
+ *   1. 通过 cordis.patch.yml 把三个同伴插件挂进 DSH；
+ *   2. 提供两个只读工具，让人和 agent 都能看清「套装现在装齐了没、各自能干什么」。
+ */
+import fs from 'node:fs'
+import path from 'node:path'
+import { fileURLToPath } from 'node:url'
+
+export const name = 'fatfish-suite'
+export const inject = ['tools']
+
+const HERE = path.dirname(fileURLToPath(import.meta.url))
+const ROOT = path.resolve(HERE, '..')
+
+export const COMPANIONS = Object.freeze([
+  {
+    name: 'dsh-fatfish',
+    title: '大肥鱼',
+    role: '人设 / 时段与情绪 / 本地记忆 / 只读查毒 / 小动作',
+    boundary: '记忆拒收密码与 Key；查毒只报告，不删文件不杀进程',
+  },
+  {
+    name: 'dsh-fatfish-hands',
+    title: '大肥鱼之手',
+    role: '专用 Edge 上网 / 读正文与链接 / 截图 / 只读电脑状态',
+    boundary: '支付、网银、登录、下载硬拦截；不碰日常浏览器的账号与历史',
+  },
+  {
+    name: 'dsh-quota-guard',
+    title: '额度护栏',
+    role: '模型用量账本 / 每日与每分钟限额 / 免费账号轮换',
+    boundary: '默认只记账不拦；单价未知时明确标记 priced=false，不假装免费',
+  },
+])
+
+const TOPICS = ['overview', 'memory', 'browser', 'quota', 'security', 'desktop', 'install']
+
+const GUIDE = {
+  overview: [
+    '大肥鱼套装 = 三个 DSH 插件，装一次一起挂上：',
+    '  · 大肥鱼：人格、时段、情绪、本地记忆、只读查毒、七个小动作。',
+    '  · 大肥鱼之手：用专用 Edge 读网页、点链接、搜索、截图，另带只读电脑状态。',
+    '  · 额度护栏：记录模型用量，可按天/按分钟设上限，免费账号之间自动轮换。',
+    '',
+    '默认免费优先：套装不配置任何付费开关，也不自动充值。要用付费模型，必须自己改配置并清楚代价。',
+    '红线写在各自插件内核里：不自动回复私聊，不代付，不点支付页，不上传聊天或文件。',
+  ].join('\n'),
+  memory: [
+    '本地记忆：~/.dsh/fatfish/memory.json',
+    '  · 对话里自动抽取名字、喜好、习惯、生日；也可用 fatfish_memory_save 手动记。',
+    '  · fatfish_memory_recall 按关键词召回，fatfish_memory_forget 按 id 删除。',
+    '  · 密码、验证码、证件号、银行卡、手机号、住址、API Key 一律拒收。',
+    '  · 没有「清空全部」，删一条必须给出 id 或足够具体的描述。',
+  ].join('\n'),
+  browser: [
+    '大肥鱼之手使用独立 Edge 配置：~/.dsh/fatfish-hands/edge-profile',
+    '  · 读页面文字与链接，不靠截图猜坐标；第一次调用会自动起一个 Edge 窗口。',
+    '  · 支付、网购、银行、收银台、验证码页：只读，拒绝点击和输入。',
+    '  · 页面有密码框时拒绝输入；需要登录请主人自己完成。',
+    '  · 下载默认拒绝，只允许 http/https，file:// 一律拒绝。',
+    '  · fatfish_pc_status 只读电脑状态，不结束进程、不改设置。',
+  ].join('\n'),
+  quota: [
+    '额度护栏默认只记账，不拦请求：',
+    '  · 账本：~/.dsh/llm-guard/usage.json，只记模型、token、耗时、费用估算。',
+    '  · 在 DSH 用户层 cordis.patch.yml 给 id: llm-guard 加 limits，例如 dailyTokens / dailyRequests。',
+    '  · onExceed 先建议用 warn 观察一周，再切 block，避免误拦长任务。',
+    '  · 没配单价的模型显示 priced=false，costCny=0 不代表免费。',
+    '  · 账号池只用主人自己放进去的免费账号；插件不自动充值、不自动换付费账号。',
+  ].join('\n'),
+  security: [
+    '查毒是特征匹配，不是完整杀毒引擎：',
+    '  · 检查进程名、命令行、启动项和常用目录里的可执行文件哈希。',
+    '  · 只读：不删文件、不杀进程、不改注册表。',
+    '  · 病毒库可用 HTTPS 订阅更新，默认每 12 小时检查一次。',
+    '  · 发现可疑项先看建议，再决定是否用专业安全软件复扫。',
+  ].join('\n'),
+  desktop: [
+    '套装是 DSH 插件形态；电脑上的「大肥鱼陪伴」独立程序是完整版：',
+    '  · 独立窗口、桌宠气泡、聊天存档、自动备份、加密保险库、本地 OpenAI 兼容中转。',
+    '  · 两者不共享进程；DSH 套装不会自动读独立版的记忆，也不会替它回复私聊。',
+    '  · 想让 agent 干重活，用套装里的手和护栏；想日常陪伴与本地中转，用独立程序。',
+    '  · 独立程序的中转只监听 127.0.0.1，Key 只存在本机，不写进插件配置。',
+  ].join('\n'),
+  install: [
+    '安装与卸载：',
+    '  · DSH：dsh plugin --profile desktop add dsh-fatfish-suite',
+    '  · 卸载：dsh plugin --profile desktop remove dsh-fatfish-suite，再按需删三个同伴包。',
+    '  · 套装和三件套二选一：已经单独装了某个插件，再装套装会出现重复挂载。',
+    '  · 本机目录安装：node scripts/install-to-dsh.mjs --suite（只把套装写进 bundles）。',
+    '  · 改完配置重启 DSH，或在 profile 的 cordis.patch.yml 追加 "# reload" 触发热重载。',
+  ].join('\n'),
+}
+
+function manifestOf(pkgName) {
+  const candidates = [
+    path.join(ROOT, '..', pkgName, 'package.json'),
+    path.join(ROOT, 'node_modules', pkgName, 'package.json'),
+    path.join(process.cwd(), 'node_modules', pkgName, 'package.json'),
+  ]
+  for (const file of candidates) {
+    try {
+      return JSON.parse(fs.readFileSync(file, 'utf8'))
+    } catch {}
+  }
+  return null
+}
+
+function expectedVersions() {
+  const self = manifestOf('dsh-fatfish-suite')
+  return (self && self.dependencies) || {}
+}
+
+function mountedNames() {
+  try {
+    const yml = fs.readFileSync(path.join(ROOT, 'cordis.patch.yml'), 'utf8')
+    return [...yml.matchAll(/^\s+name:\s*['"]?([^'"\s#]+)/gm)].map((m) => m[1])
+  } catch {
+    return []
+  }
+}
+
+export function suiteStatus() {
+  const expected = expectedVersions()
+  const mounts = mountedNames()
+  const companions = COMPANIONS.map((c) => {
+    const manifest = manifestOf(c.name)
+    const want = expected[c.name] || manifest?.version || ''
+    const version = manifest?.version || ''
+    return {
+      name: c.name,
+      title: c.title,
+      role: c.role,
+      boundary: c.boundary,
+      installed: Boolean(manifest),
+      version,
+      expected: want,
+      mounted: mounts.includes(c.name),
+      ok: Boolean(manifest) && mounts.includes(c.name) && (!want || version === want),
+    }
+  })
+  const self = manifestOf('dsh-fatfish-suite')
+  return {
+    ok: true,
+    suite: { name: 'dsh-fatfish-suite', version: self?.version || '0.1.1' },
+    companions,
+    allInstalled: companions.every((c) => c.installed),
+    allMounted: companions.every((c) => c.mounted),
+    missing: companions.filter((c) => !c.installed).map((c) => c.name),
+    unmounted: companions.filter((c) => !c.mounted).map((c) => c.name),
+    versionMismatch: companions.filter((c) => c.installed && c.expected && c.version !== c.expected)
+      .map((c) => `${c.name} 装的是 ${c.version}，套装要求 ${c.expected}`),
+  }
+}
+
+function statusView(s) {
+  const lines = [`大肥鱼套装 ${s.suite.version}`]
+  for (const c of s.companions) {
+    const mark = c.ok ? '✓' : '✗'
+    const state = !c.installed ? '未安装' : (!c.mounted ? '已安装但没挂载' : `v${c.version}`)
+    lines.push(`  ${mark} ${c.title}（${c.name}）· ${state}`)
+    lines.push(`      ${c.role}`)
+  }
+  if (s.allInstalled && s.allMounted && !s.versionMismatch.length) {
+    lines.push('三件都齐了。用 fatfish_suite_guide 看每件的用法与边界。')
+  } else {
+    if (s.missing.length) lines.push(`缺：${s.missing.join(' / ')} —— 重新安装套装，或单独装这些包。`)
+    if (s.unmounted.length) lines.push(`没挂载：${s.unmounted.join(' / ')} —— 检查 cordis.patch.yml 的 insert 段。`)
+    if (s.versionMismatch.length) lines.push(`版本不一致：${s.versionMismatch.join('；')}。`)
+  }
+  return lines.join('\n')
+}
+
+function guideView(topic) {
+  const key = TOPICS.includes(topic) ? topic : 'overview'
+  return { ok: true, topic: key, text: GUIDE[key] }
+}
+
+const text = (s) => [{ type: 'text', text: s }]
+
+const STATUS_SCHEMA = {
+  type: 'object',
+  properties: {
+    ok: { type: 'boolean' },
+    suite: {
+      type: 'object',
+      properties: { name: { type: 'string' }, version: { type: 'string' } },
+    },
+    companions: {
+      type: 'array',
+      items: {
+        type: 'object',
+        properties: {
+          name: { type: 'string' },
+          title: { type: 'string' },
+          role: { type: 'string' },
+          boundary: { type: 'string' },
+          installed: { type: 'boolean' },
+          version: { type: 'string' },
+          expected: { type: 'string' },
+          mounted: { type: 'boolean' },
+          ok: { type: 'boolean' },
+        },
+      },
+    },
+    allInstalled: { type: 'boolean' },
+    allMounted: { type: 'boolean' },
+    missing: { type: 'array', items: { type: 'string' } },
+    unmounted: { type: 'array', items: { type: 'string' } },
+    versionMismatch: { type: 'array', items: { type: 'string' } },
+  },
+}
+
+export const TOOLS = [
+  {
+    name: 'fatfish_suite_status',
+    description: '查看大肥鱼套装三件（大肥鱼 / 大肥鱼之手 / 额度护栏）是否装齐、是否挂载、版本是否对得上。只读，不联网。',
+    parameters: { type: 'object', properties: {}, additionalProperties: false },
+    output: {
+      schema: STATUS_SCHEMA,
+      render: (_args, v) => text(v && v.ok ? statusView(v) : '大肥鱼套装状态读取失败。'),
+    },
+    execute: async () => {
+      try {
+        return suiteStatus()
+      } catch (e) {
+        return { ok: false, error: String(e?.message || e) }
+      }
+    },
+  },
+  {
+    name: 'fatfish_suite_guide',
+    description: '查大肥鱼套装的用法与安全边界：总览、记忆、浏览器、额度、查毒、独立桌面版、安装卸载。只返回说明文字，不执行动作。',
+    parameters: {
+      type: 'object',
+      properties: {
+        topic: { type: 'string', enum: TOPICS, description: '想了解的部分，默认 overview' },
+      },
+      additionalProperties: false,
+    },
+    output: {
+      schema: {
+        type: 'object',
+        properties: {
+          ok: { type: 'boolean' },
+          topic: { type: 'string' },
+          text: { type: 'string' },
+        },
+      },
+      render: (_args, v) => text(v?.text || '没有这条说明。'),
+    },
+    execute: async (args) => guideView(String(args?.topic || 'overview')),
+  },
+]
+
+export function apply(ctx) {
+  const disposers = []
+  for (const tool of TOOLS) {
+    disposers.push(ctx.tools.register(tool))
+  }
+  ctx.effect(() => () => {
+    for (const d of disposers) {
+      try { d() } catch {}
+    }
+  })
+
+  // command 只在 agent 上下文的子作用域提供：写进 inject 会让整枚插件永远 pending，
+  // 根作用域直接读又会被宿主抛 cannot get property，所以按需取、取不到就跳过斜杠命令。
+  let command = null
+  try {
+    command = ctx.command
+  } catch {}
+
+  if (command) {
+    command('fatfish.suite', '查看大肥鱼套装三件是否装齐、挂载与版本', async () => {
+      const s = suiteStatus()
+      return statusView(s)
+    })
+  }
+
+  try {
+    const s = suiteStatus()
+    console.log(`[fatfish-suite] ${s.allInstalled && s.allMounted ? '三件已挂载' : `缺 ${s.missing.concat(s.unmounted).join('/') || '版本不一致'}`}`)
+  } catch {}
+}
+
+export const _internal = { manifestOf, mountedNames, expectedVersions, statusView, guideView, TOPICS }

package/package.json

@@ -1,6 +1,68 @@
 {
   "name": "dsh-fatfish-suite",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.1.1",
+  "description": "大肥鱼套装：一次装齐人格与本地记忆、专用 Edge 上网之手、模型额度护栏。三件各自带硬红线，默认免费优先，不上传聊天与文件。",
+  "keywords": [
+    "dsh",
+    "dsh-plugin",
+    "deepseek-harness",
+    "fatfish",
+    "大肥鱼",
+    "suite",
+    "bundle",
+    "persona",
+    "browser",
+    "quota"
+  ],
+  "type": "module",
+  "main": "lib/index.js",
+  "exports": {
+    ".": "./lib/index.js",
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "lib",
+    "cordis.patch.yml",
+    "README.md",
+    "CHANGELOG.md",
+    "SECURITY.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "test": "node test/plugin.mjs"
+  },
+  "engines": {
+    "node": ">=22",
+    "dsh": ">=0.2.0"
+  },
+  "dependencies": {
+    "dsh-fatfish": "0.5.1",
+    "dsh-fatfish-hands": "0.1.3",
+    "dsh-quota-guard": "0.1.3"
+  },
+  "peerDependencies": {
+    "@deepseek-ai/cordis": "^4.0.2",
+    "@deepseek-ai/dsh-commands": "^0.1.2-rc.1 || ^0.1.7-rc.2 || ^0.2.0-rc.1",
+    "@deepseek-ai/dsh-llm": ">=0.0.1-rc.0",
+    "@deepseek-ai/schemastery": "^3.18.4"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/yellow-yel/dsh-fatfish.git",
+    "directory": "dsh-fatfish-suite"
+  },
+  "homepage": "https://github.com/yellow-yel/dsh-fatfish/tree/master/dsh-fatfish-suite#readme",
+  "bugs": {
+    "url": "https://github.com/yellow-yel/dsh-fatfish/issues"
+  },
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org/"
+  },
+  "dsh": {
+    "bundle": {
+      "patch": "./cordis.patch.yml"
+    }
+  },
+  "license": "MIT"
+}