dsh-atom-market

把 Software Atom Market（软件原子市场） 变成 DeepSeek Harness Agent 可逛、可校验、可投稿的能力库。 原子 = 带类型化契约的最小能力单元：intent + input + output。本插件让 Agent 在商店里选砖、读契约、验投稿、起草新原子，而不是一遍遍生成同一段代码。

DSH community plugin · Cordis · Everything is a plugin. · 软件原子市场（商店）

Topics: dsh-plugin dsh cordis deepseek-harness ai-agents

它做什么

工具	作用	例子
atom_search	按意图/标签/id 逛店（公共字段）	"搜能抽 PDF 表格的原子"
atom_read	读某原子完整 manifest（含 input/output 形状与 tests）	拿到 pdf.extract_tables 的完整契约
atom_validate	投稿前按 spec 校验候选 manifest → valid/errors/warnings	拦下一个缺 input 的坏投稿
atom_draft	由一句意图起草 verified:false 候选 + 投稿步骤	为"把金额换算成人民币"生成骨架

商店数据源（默认 GitHub，无需任何本地配置）：

• 默认读取 GitHub 商店仓库 ZiFan1117/software-atom-market 的 atoms/*.atom.json（目录即索引），带 5 分钟内存缓存；可用 GITHUB_PERSONAL_ACCESS_TOKEN 规避 API 限流。
• 可选覆盖：
  • DSH_ATOM_STORE_OWNER / DSH_ATOM_STORE_REPO / DSH_ATOM_STORE_BRANCH → 指向其它 GitHub 商店；
  • DSH_ATOM_STORE_DIR → 指向本地 atoms/ 目录（离线/开发用）。
• 别的人装这个插件，不需要设任何环境变量——装上即用。

安装

本包声明 dsh.bundle.patch（见 cordis.patch.yml），安装后即激活插件行，apply(ctx) 自动向 ctx.tools 注册四个工具。lib/ 随仓提供，装完即可用、无需本地构建。

dsh plugin add github:ZiFan1117/dsh-atom-market

npm 发布已放弃（npm 账号受限）。不影响安装：DSH 插件管理器原生支持 github spec，本仓 lib/ 随仓直接可用。dsh-market / awesome-dsh-plugin 收录仍以该安装方式申报。

开发

npm install
npm run build      # tsc → lib/
npm run test       # node --test，覆盖 store/validate/draft 纯逻辑
npm run demo       # 无 DSH 全链路冒烟（读本仓 atoms/）

与 atom 契约的映射

Software Atom Market	DSH defineTool
intent	description
input（数据形状）	parameters
output（数据形状）	output.schema（canonical value，程序化可读）
manifest（黑盒契约）	execute 只返回 canonical JSON，人话在 render
side_effects	由工具本身的实现负责（本插件是纯读/查，无副作用）

渐进披露：atom_search 只给 intent 一句话；atom_read 展开 description（四节 Markdown 详情，结构见商店仓库的 spec/detail-convention.md）。

投稿/校验/收录流程见软件原子市场仓库的 CONTRIBUTING.md 与 spec/。roadmap：v0.2 atom_assemble（意图 → 检索 → 接线图 → 拼装期校验）。

License

MIT © ZiFan1117