原子能力市场ZiFan1117/dsh-atom-market

dsh-atom-market

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

DSH 社区插件 · Cordis · 一切皆插件。 · 软件原子市场（商店）

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