prompt-skill-armory

Armory

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

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

中文 · English

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

---

📑 目录

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

---

🎯 适配目标 · Supported upstreams

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

⚠️ 请使用上述官方仓库的构建（或其保持兼容的派生版）。 其他 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 <dir>、/armory-install-zip <zip>
• MCP 工具服务器 — 添加/编辑/移除 stdio 或 HTTP 的 MCP 服务器，启用即自动连接，每台展示运行状态与工具列表，支持「测试」连接。
• Wallpaper（全局壁纸与特效） — 本地上传图片/视频（字节存盘，settings 只存 id 不膨胀）或填图片 URL；透明度/遮罩/玻璃/模糊/铺法实时可调；web 与桌面客户端分别设置。
• 输入栏提示行样式 — 为 composer 下方提示与统计行单独设启用/颜色/字号/渐变色。
• 对话导入 / 导出 — 勾选多个会话导出为 zip（含附件与工作区），另一台机器导入即可还原；列表显示对话标题、项目与时间；支持真实删除（删目录 + 清索引）。
• 使用统计（cc-switch 风格） — 时间范围筛选（全部/30天/7天/今天）；输入/输出/缓存读/缓存写 Token、缓存命中率、成本估算；请求日志（时间/项目/输入输出/缓存/成本/用时/首字/状态）；Provider（项目）统计与模型统计；SVG 双轴趋势图（今天按 24 小时分段）。
• 中英双语 UI（简体中文 / English）。
• 设置侧边栏书图标。

🖥️ 平台支持

通过 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/
├── 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 质量门禁

🛠️ 开发

改源码后重建发布包：

node scripts/build-shipped.mjs <path-to-deepseek-harness>

版本更新三处同步：

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 <tarball> 即可；或用 file: 安装本地构建产物（见 TESTING.md）。

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

📚 文档

🤝 贡献 / 官方合入

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

📄 许可

MIT

🔗 友情链接 · Friends

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