zoahdev/dsh-llms-forge

dsh-llms-forge

npm

CI
License: MIT
dsh-plugin

从 package.json + README.md 为 DeepSeek Harness（dsh）插件仓库生成 llms.txt。

AI 智能体进入一个仓库时，首先会寻找 llms.txt。大多数 dsh 插件都没有这个文件——本插件以确定性的方式创建它，并保持其内容真实可靠：标题来自包名，摘要来自描述（或 README 的第一段），以及关键事实（安装命令、许可证、主页、关键词、入口、CLI）。默认只读；写入操作需显式指定。

安装

dsh plugin add dsh-llms-forge

或独立运行：

npx dsh-llms-forge .

CLI

dsh-llms-forge [dir] [--write] [--overwrite] [--json]

- 将拟生成的 llms.txt 打印到 stdout（默认不写入）。
- --write 写入文件；--overwrite 替换已存在的文件。
- 退出码：0 无问题，1 有警告，2 用法/IO 错误。

npx dsh-llms-forge . --write --overwrite
npx dsh-llms-forge ./my-plugin --json

在 harness 内使用（可供智能体调用）

向你的 dsh 智能体发出指令：

给这个插件仓库生成一份 llms.txt：llms_forge，目录指向仓库根目录，写入并覆盖。
Generate an llms.txt for this plugin repo: llms_forge with dir set, then write: true, overwrite: true.

该工具会返回一个 dsh-llms-forge/v1 结果，包含拟生成的内容和警告信息，并且仅当 options.write 为 true 时才写入文件。

生成的文件示例

dsh-dep-audit

Dependency supply-chain hygiene audit for DeepSeek Harness ...

Key facts

- Install: dsh plugin add dsh-dep-audit
- License: MIT
- Homepage: https://github.com/zoahdev/dsh-dep-audit
- Keywords: deepseek-harness, dsh, ...
- Entry: lib/index.js
- CLI: dsh-dep-audit
- Version: 0.1.0

Generated by dsh-llms-forge. Keep this file in sync with README.md and package.json.

为什么需要它

- llms.txt 约定是 AI 智能体理解仓库的最快方式，但大多数 dsh 插件发布时都没有这个文件。
- 手写的 llms.txt 文件容易过时；生成的文件可复现，并且可通过 CI 检查（--json、退出码）。
- 零运行时依赖，默认只读——在任何地方运行都安全。

开发

pnpm install
pnpm typecheck
pnpm build
pnpm test
pnpm test:integration

CI 会运行 dsh-plugin-doctor 预检、单元测试、打包产物集成测试（真实调用 llms_forge），以及在 Windows 上以全新配置启动 dsh web 的冒烟测试。

许可证

MIT © 2026 zoahdev

dsh-llms-forge（中文）
为 DeepSeek Harness（dsh）插件仓库自动生成 llms.txt（AI 可读发现文件），数据源是 package.json + README.md。

AI agent 进入仓库时最先找的就是 llms.txt，但绝大多数 dsh 插件没有。本插件把它确定性生成并保持诚实：标题取包名，摘要取 description（或 README 第一段），关键事实（安装命令、许可证、主页、关键词、入口、CLI）自动收集。默认只读，写盘需显式开启。

安装

dsh plugin add dsh-llms-forge

独立使用：

npx dsh-llms-forge .

CLI

dsh-llms-forge [dir] [--write] [--overwrite] [--json]

- 默认只把生成的 llms.txt 打印到 stdout，不写盘。
- --write 写盘；--overwrite 覆盖已有文件。
- 退出码：0 干净，1 有警告，2 用法/IO 错误。

npx dsh-llms-forge . --write --overwrite
npx dsh-llms-forge ./my-plugin --json

在 harness 内使用（agent 可调用）

对 agent 说：

给这个插件仓库生成一份 llms.txt：llms_forge，目录指向仓库根目录，写入并覆盖。

工具返回 dsh-llms-forge/v1 结果（含生成内容与警告），仅在 options.write 为 true 时写盘。

为什么需要它

- llms.txt 是 AI agent 理解仓库最快的方式，但大多数 dsh 插件没有。
- 手写 llms.txt 会漂移过期；生成式可复现、可进 CI（--json + 退出码）。
- 零运行时依赖、默认只读，任何环境都能安全跑。

开发

pnpm install
pnpm typecheck
pnpm build
pnpm test
pnpm test:integration

CI 跑 dsh-plugin-doctor 预检、单元测试、打包集成（真实 llms_forge 调用）、Windows 全新 profile 的 dsh web 启动冒烟。

许可证

MIT © 2026 zoahdev
相关生态工具

- dsh-dep-audit - 依赖供应链卫生
- dsh-quality-score - 插件质量评分卡 + 全注册表排行榜
- dsh-ecosystem - 健康扫描、影响、趋势、实时仪表盘
- dsh-tutorials - 双语插件流水线教程
常见问题

- 如何安装？ dsh plugin add dsh-llms-forge 或直接运行 CLI（见 README）。
- 需要 API 密钥吗？ 不需要。
- 是只读的吗？ 默认是；任何写入/应用都是显式标志。
示例

完整 CLI 用法见 README。快速开始：

npx dsh-llms-forge --help