dsh-prompt-star

dsh-prompt-star

一个 DeepSeek Harness (DSH) 插件：在对话输入框旁放一个 ⭐ 星星按钮。你随手写完草稿点一下 ⭐，它读懂你的意图、读取当前项目的说明文件（CLAUDE.md / AGENTS.md / .cursorrules / README.md）作为上下文，生成一版更完整、更高效、更省 token 的提示词，直接填入输入框；不满意就按 Ctrl/Cmd+Z 撤回原草稿。

设计说明见 设计说明.md。

安装

dsh plugin --profile web add dsh-prompt-star

安装后完整重启 dsh web，并在浏览器硬刷新（Cmd+Shift+R），输入框旁就会出现 ⭐。

需要 dsh web（web profile）。插件声明了 dsh.bundle，dsh 会把它追加进 profile 的 dsh.profile.bundles。

它做什么

点 ⭐ 后，插件会在完全本地完成：

1. 读取当前会话的草稿（输入框内容）；
2. 读取项目的说明文件（README / AGENTS / CLAUDE / .cursorrules 等，读不到就跳过）；
3. 把这些拼成一份结果清晰、上下文完整、可直接用的提示词，setDraft 写回输入框。

不在本地构建、不上传你的代码、不发起任何外部网络请求——只在本地读项目说明文件与草稿，客户端组装成提示词。

说明：插件不调用 DSH 的生成模型（当前 DSH 的 LLM 接口按 purpose 门控，不适合三方插件做任意文本生成），而是确定性地把项目文档与草稿拼成一份完整、自包含的提示词，使你在发送时无需重复交代项目背景，更省 token。

架构：host 读文档 + RPC 通道

插件用 通用 Connection RPC（ctx.connection.rpc）在 host 与 client 之间传递项目文档——这是三方插件可靠访问 host 的标准方式。

• host（src/index.ts）：用 ctx.connection.rpc.handle('/dsh-prompt-star', ...) 注册通道，经 ctx.fs 读取项目说明文件（README / AGENTS / CLAUDE / .cursorrules 等，读不到就跳过），返回给 client。
• client（src/client/）：⭐ 组件挂进 conversation.input.right 槽位；用 useInput() 读草稿、inputActions.setDraft() 写回；点按后用 ctx.connection.rpc.call('/dsh-prompt-star', 'context', {}) 向 host 要项目文档，再在客户端组装成完整提示词。

目录结构：

dsh-prompt-star/
├── .github/workflows/build.yml      # CI：checkout harness + 叠加 + 构建 + 发布 npm
└── packages/extensions/prompt-star/ # 插件包（叠加进 harness 构建）
    ├── package.json                 # dsh.bundle + dsh.client manifest
    ├── cordis.patch.yml             # host 插件行
    ├── tsdown.config.ts             # clientBundle('dsh-prompt-star', ..., { hostPhase:true })
    └── src/
        ├── index.ts                 # host: apply(ctx) + connection.rpc.handle 读文档
        ├── types.ts                 # 共享 RPC 协议（通道/端点/结果类型）
        └── client/
            ├── index.ts             # client apply + slot 注册 + rpc.call
            └── StarButton.tsx       # ⭐ 按钮组件（读草稿+组装+setDraft）

发布模型

client bundle 依赖 harness 仓库内部模块（clientBundle() 预设），无法独立构建，因此构建全部发生在 GitHub Actions 上：CI checkout harness → 叠加本包 → 装依赖 → tsc 生成 lib/types → 构建 host + client → npm publish。你无需本地构建或安装重依赖。

安全 / 已知限制

• 完全本地生成，不上传代码（用户项目常涉内网/涉密）。
• 读取只读：仅读取工作区内的说明文件与草稿，不修改源文件。
• 说明文件按 DSH 进程工作目录探测（process.cwd()）；若当前会话工作区不是该目录，可能读不到文档（读不到则按草稿整理，不报错）。
• 意图精确匹配、可视化模板编辑器、无说明文件时“帮你生成 CLAUDE.md”弹窗：属后续迭代。

许可证

MIT