LittleFishStars/dsh-init-command ↗★ 1
dsh-init-command
DSH plugin: /init slash command that generates an AGENTS.md guide for the current project with a two-stage model call 适合需要快速生成项目说明文件的用户,需可用模型路由,支持预览。
설치
$
npx -p @deepseek-ai/dsh dsh plugin --profile web add github:LittleFishStars/dsh-init-command配置
/init 需要可用的模型路由,按以下优先级解析(满足其一即可):
-
插件行的
config(推荐,最明确):# cordis.patch.yml 或 profile 的 patch 层 - insert: - id: init name: dsh-init-command config: provider: deepseek model: deepseek-chat -
会话最近一次请求使用的 provider/model(
session.requestHeader().config) -
agent 选项(
agent.options.provider/agent.options.model)
三者都不可用时,/init 返回明确错误,不会调用模型。
使用
在 DSH Web UI 或任意命令适配器的输入框中输入:
| 命令 | 行为 |
|---|---|
/init | 两阶段调用模型,在工作区根目录生成或替换 AGENTS.md(已存在时直接覆盖,旧内容作为改写参考);阶段二默认显示思考过程、正文直接写入文件,会话中追加完成信息与成功状态消息;阶段一默认关闭思考模式 |
/init --dry-run | 调用模型生成内容但不写文件,两阶段完整流式预览 |
/init --think | 阶段一(项目分析)改用模型的思考模式;默认不思考(更快更省 token) |
/init --git | 生成 AGENTS.md 后额外执行 git 初始化:仓库不存在时 git init、默认分支 master → main、按项目类型从 github/gitignore 下载 .gitignore(已存在时不覆盖) |
/init --commit | 生成 AGENTS.md 后创建初始 git 提交(隐式启用 --git);未配置 git 身份时只提示、不失败 |
/init --depth | 目录树收集深度:1 仅顶层、2 两层(默认)、-1 不限制 |
| `/init --ignore | |
| ` | 额外跳过名字匹配的条目(可重复使用或用逗号分隔多个) |
/init --desc | 目录为空时描述项目内容(放在最后,可含空格);生成注明"此项目还未制作"的规划稿 |
/init --help | 显示用法与全部参数说明(-h 亦可) |
/init --git --dry-run | 组合使用:只提示将做什么(初始化仓库、下载哪个模板),不执行任何写入 |
目录为空:
/init不会盲目生成,而是询问项目内容(注明此项目还未制作)。可用/init --desc ""提供描述后生成规划稿,或先创建项目文件再运行。
示例输出(--git):
Initialized /home/user/project/AGENTS.md (Node.js web application). Review the generated AGENTS.md and adjust it to your conventions.
Git: initialized a new git repository; renamed the default branch master → main; downloaded .gitignore from github/gitignore (Node)
Model calls:
1. classify — deepseek/deepseek-chat — prompt: 14 lines (You are a senior software engineer analyzing a repo...) — result: Node.js web application [JavaScript] [npm]
2. generate — deepseek/deepseek-chat — prompt: 26 lines (You are a software engineering expert...) — result: AGENTS.md (1234 chars)
生成的文件是模型的初稿:命令、目录结构等信息均来自两层目录结构,请审阅后按项目实际约定调整。