Qian-Ning/prompt-skill-armory

Armory

面向 DeepSeek Harness 的社区插件 / 管理中枢 — 提示词、技能、MCP 工具服务器、Agent 预设、全局壁纸与特效，一站式管理面板。

包名 / 仓库：prompt-skill-armory · GitHub

中文 · English

Armory 管理面板

|  |  |  |  |
|--|--|--|--|
|  |  | | |

version
license
platform
CI

✦ Armory  v0.11.0
┌─────────┬─────────┬─────┬────────────┬──────┬──────┐
│ 提示词    │  技能    │ MCP │  Wallpaper │ 对话  │ 统计 │
│ 全局注入  │ 合并管理  │ 连接 │  壁纸·特效  │ 导入  │ 用量 │
└─────────┴─────────┴─────┴────────────┴──────┴──────┘

📑 目录

- 🚀 快速开始
- 🎯 适配目标 · Supported upstreams
- ✨ 功能
- 🖥️ 平台支持
- 🔄 一键更新
- 🗑️ 卸载
- 🏗️ 架构
- 📦 包含的包
- 🗂️ 仓库结构
- 🛠️ 开发
- ❓ FAQ
- 📚 文档
- 🤝 贡献 / 官方合入
- 📄 许可
- 🔗 友情链接 · Friends

🎯 适配目标 · Supported upstreams

Armory 是 DeepSeek Harness 的插件，专为以下两个官方仓库构建与测试：

| 上游 | 对应环境 | 仓库 |
|---|---|---|
| DeepSeek Harness | dsh web 网页端运行时 |  |
| DSH Desktop | 桌面客户端 |  |

⚠️ 请使用上述官方仓库的构建（或其保持兼容的派生版）。 其他 fork / 魔改版本的内部接口可能不同，导致面板无法挂载、设置不生效、命令缺失，甚至让客户端进入恢复模式——那不是本插件的 bug。安装或反馈前请先确认你的运行时来自以上两个出处。

🚀 快速开始

安装

npx prompt-skill-armory

卸载：

npx prompt-skill-armory uninstall

安装器自动完成：

1. 定位 DSH home
2. 确保 web + desktop profile 存在
3. 安装两个插件包（Host + Web 面板）
4. 配置 Host bundle
5. 挂载面板（profile cordis.patch.yml）
6. 体检 settings（防 4MB 膨胀）

启动

cd deepseek-harness
pnpm run build
pnpm dsh web

（或直接重启 DSH Desktop 客户端。）

打开 设置 → Armory（书图标）。

要求：已安装 DeepSeek Harness 运行时（dsh web 或桌面客户端）。插件是 DSH 的插件，不打包运行时本身。

✨ 功能

- 提示词（全局生效） — 增删改查、启用/停用、设默认。启用后经 ctx.systemPrompt.section 注入每个 agent 的系统提示词。
- 技能（合并管理） — 一个列表：面板安装的（编辑/开关/卸载）+ 本地扫描的（托管），带调用提示 /name。
- 技能安装方式
- 手动填写
- .md 文件选择
- 会话内命令：/armory-skill-dir 、/armory-install-zip
- MCP 工具服务器 — 添加/编辑/移除 stdio 或 HTTP 的 MCP 服务器，启用即自动连接，每台展示运行状态与工具列表，支持「测试」连接。
- Wallpaper（全局壁纸与特效） — 本地上传图片/视频（字节存盘，settings 只存 id 不膨胀）或填图片 URL；透明度/遮罩/玻璃/模糊/铺法实时可调；web 与桌面客户端分别设置。
- 输入栏提示行样式 — 为 composer 下方提示与统计行单独设启用/颜色/字号/渐变色。
- 对话导入 / 导出 — 勾选多个会话导出为 zip（含附件与工作区），另一台机器导入即可还原；列表显示对话标题、项目与时间；支持真实删除（删目录 + 清索引）。
- 使用统计（cc-switch 风格） — 时间范围筛选（全部/30天/7天/今天）；输入/输出/缓存读/缓存写 Token、缓存命中率、成本估算；请求日志（时间/项目/输入输出/缓存/成本/用时/首字/状态）；Provider（项目）统计与模型统计；SVG 双轴趋势图（今天按 24 小时分段）。
- 中英双语 UI（简体中文 / English）。
- 设置侧边栏书图标。

🖥️ 平台支持

| 环境 | 面板 | /armory 命令 |
|---|---|---|
| dsh web（deepseek-ai/deepseek-harness） | ✅ | ✅ |
| DSH Desktop 客户端（anywhere-labs/dsh-desktop） | ✅ | ✅ |

通过 profile 组合实现（安装器把面板挂进每个 profile 的 cordis.patch.yml）——无需 fork 客户端。

🔄 一键更新

插件面板每次打开会自动查询 npm 上 prompt-skill-armory 的最新版本；发现新版本时顶部显示横幅：

有新版本 vX.Y.Z（当前 v0.11.0） [一键更新]

点击「一键更新」→ Host 端运行官方安装器原地重装 → 提示「更新完成，请重启客户端生效」。

🗑️ 卸载

npx prompt-skill-armory uninstall

移除两个插件包、Host bundle、面板挂载，并清理壁纸/导出目录（提示词/技能配置保留在 settings.yaml，可手动删 switchblade 命名空间彻底清除）。

🧰 在聊天中使用技能

在输入框打 / + 技能名：

/code-review
/mission-keeper

技能体被注入，agent 按它执行。modelInvocable 的技能模型也可自主调用。

🏗️ 架构

┌──────────────────────────────────────────────────────┐
│                    DSH 运行时                         │
│                                                      │
│  ┌─────────────┐   RPC/connection   ┌─────────────┐  │
│  │  Web 面板    │◄──────────────────►│  Host 服务    │  │
│  │ ui-switchblade│   api.skills.*    │ switchblade │  │
│  │  (settings)  │   api.settings.*  │  (bundle)   │  │
│  │             │   /api/armory/*    │  + routes   │  │
│  └─────────────┘                    └──────┬──────┘  │
│                                            │         │
│                              ctx.systemPrompt.section│
│                              ctx.skills.register     │
│                              /api/armory/* (对话/统计 │
│                              壁纸上传/更新/卸载)       │
└──────────────────────────────────────────────────────┘

- Host 服务（switchblade bundle）持有提示词/技能/预设的 CRUD 与持久化，通过 ctx.systemPrompt.section 全局注入、ctx.skills.register 注册技能；并注册 /api/armory/ 路由（对话导入导出、会话删除、使用统计、壁纸上传、版本检查、一键更新）。
- Web 面板（ui-switchblade）通过 connection RPC 调用 Host（api.skills.list、api.settings.mutate/describe）与 /api/armory/ 路由，不直接碰 DSH 内部。
- 安装器把两者通过 profile 组合装进 DSH——web 和 desktop 共用同一套机制。

📦 包含的包

| 包 | 作用 |
|---|---|
| prompt-skill-armory | npm 安装器（CLI，含卸载） |
| @deepseek-ai/dsh-switchblade | Host 服务（提示词/技能/命令/MCP/壁纸/对话/统计 + 路由） |
| @deepseek-ai/dsh-client-ui-switchblade | Web 面板（六 tab：提示词/技能/MCP/Wallpaper/对话/统计） |

🗂️ 仓库结构

prompt-skill-armory/
├── cli.cjs                  # 一键安装/卸载 CLI
├── package.json             # npm 安装器包
├── packages/                # 构建好的插件（lib+src+manifest）
│   ├── switchblade/         # @deepseek-ai/dsh-switchblade (Host)
│   └── client-ui-switchblade/ # @deepseek-ai/dsh-client-ui-switchblade (Web)
├── plugin-src/              # 插件源码镜像
├── scripts/build-shipped.mjs # 从 DSH checkout 同步构建产物
├── demo/demo.html           # UI 预览（mock 数据）
├── docs/preview/            # 面板真实截图
├── README.md                # 本文（中文）· README.en.md 英文版
├── UPSTREAM.md              # 官方合入指南
├── CHANGELOG.md             # 版本历史
├── PUBLISHING.md            # 发布指南
├── TESTING.md               # 测试指南
├── LICENSE                  # MIT
└── .github/workflows/ci.yml # CI 质量门禁

🛠️ 开发

改源码后重建发布包：
bash
node scripts/build-shipped.mjs

版本更新三处同步：

1. packages/*/package.json version
2. ARMORY_VERSION（面板常量）
3. CHANGELOG.md

然后重建 client bundle 让版本徽章更新。

❓ FAQ

Q: 为什么我的客户端侧边栏图标是齿轮而不是书？
A: 桌面客户端打包版的 SettingsRoot 硬编码了图标映射。通过 npm 安装器的 profile 组合，面板能正常工作，但书图标需要官方合入（见 UPSTREAM.md）。

Q: 会话导入后另一台机器看不到？
A: 导入成功后需要重启 DSH 客户端让其重新扫描会话列表；若目标项目路径不同，在导入前填写「目标项目 key」（形如 --C-Users-xxx--）以归入正确项目。

Q: 统计里的成本准确吗？
A: 成本是估算（内置单价 × token：输入 $0.3/M、输出 $1.2/M、缓存读 $0.03/M、缓存写 $0.6/M），不是真实账单。

Q: 会不会影响我已有的配置/会话？
A: 不会。插件只新增 switchblade settings 命名空间，不动其他配置。安装器还会体检 settings，防止膨胀。

Q: 支持离线安装吗？
A: 可以。把 npm 包拷到目标机器，npm install  即可；或用 file: 安装本地构建产物（见 TESTING.md）。

Q: 技能从哪里来？
A: 三种：手动填写、.md 文件选择、会话内 /armory-skill-dir（目录）或 /armory-install-zip（zip）。安装后统一进「技能」tab 管理。

📚 文档

| 文档 | 说明 |
|---|---|
| README.en.md | 英文版自述 |
| TESTING.md | 本地功能测试（无需发布） |
| PUBLISHING.md | 发布新版本指南 |
| UPSTREAM.md | 官方合入指南（书图标 PR） |
| CHANGELOG.md | 完整版本历史 |

🤝 贡献 / 官方合入

见 UPSTREAM.md —— 如何让面板原生内置进 deepseek-ai/deepseek-harness 与 anywhere-labs/dsh-desktop（客户端侧边栏书图标）。

📄 许可

MIT

🔗 友情链接 · Friends

- LINUX DO — 技术社区 · LINUX DO community