dsh-at-menu 0.0.0-stage → 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 dsh-at-menu contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.en.md

@@ -0,0 +1,102 @@
+# dsh-at-menu
+
+[中文](README.md) | **English**
+
+When the `@` reference menu opens, a row of category tabs appears on top of it: pick a tab to see only
+that category instead of scrolling through one mixed list.
+
+## Categories
+
+Only the three kinds the DSH conversation UI already has data for are built in:
+
+| Category | Source |
+| --- | --- |
+| Workspace files | The workspace file-reference API; files and folders share one category, and a folder row drills into the directory with the trailing arrow (or Tab), with breadcrumbs to go back up |
+| Past sessions | Plain sessions from the session-reference candidates |
+| Subagent sessions | The rows marked as subagents in the same candidate list |
+
+Skills, plugins, saved prompts, sidebar references and so on are **not** built in: each plugin
+registers its own source through
+`ctx.inputTriggers.registerSource({ trigger: '@', name: 'name', candidates, onPick })`,
+and the panel turns every registered source into a tab — `name` is the tab label.
+
+## Install
+
+```sh
+dsh plugin --profile desktop add github:taoziliyouchong/dsh-at-menu
+```
+
+Once published to npm, this also works:
+
+```sh
+dsh plugin --profile desktop add dsh-at-menu
+```
+
+Restart DSH afterwards. Replace `desktop` with your own profile name if you use another one.
+
+Requirements: the DSH 0.2.1 line, desktop app or `dsh web` (needs the @ menu of the conversation composer).
+Compatible with DSH 0.2.1 (alpha / rc / stable); 0.3 and later are not guaranteed.
+
+## Recommended: disable the built-in @ menu
+
+The built-in reference menu (loader id `ui-reference`) also registers sources named "Workspace files"
+and "Past sessions". Two sources with the same name produce duplicated groups. Disable it in the
+profile's `cordis.patch.yml`:
+
+```yaml
+- id: ui-reference
+  disabled: true
+```
+
+What that costs: `@path` mentions in past messages lose their decoration and file references are no
+longer clickable — the text itself stays. Leaving it enabled still works (this plugin hides the
+built-in menu visually); only the candidates are duplicated.
+
+## How it works
+
+- The panel mounts at the list slot `conversation.input.overlay`, the same seat as the built-in menu;
+  an injected style hides the built-in menu only while the @ menu is open
+  (`body[data-dsh-at-open] [data-trigger-menu]`), so the `/` slash menu keeps its native look.
+- Data, keyboard handling (up/down, Enter, Esc) and insertion stay owned by the built-in controller;
+  the panel only subscribes to its menu store and feeds pick / hover / dismiss back.
+- Mentions go into the draft as plain text (`@path`, `@[title](dsh-session:…)`), and the existing
+  text-parsing chain on the host side keeps working.
+- No network access, nothing uploaded.
+
+## Known limits
+
+- With the built-in `ui-reference` enabled, groups with the same name appear twice (see above).
+- Tabs only show sources registered in `CATEGORY_SOURCES`; a plugin that registers a new source name
+  needs that line in `src/entry.jsx` edited before its tab shows up.
+- This plugin only changes the look and grouping of the @ menu; it does not change the insertion format.
+
+## Development
+
+```sh
+npm install
+npm run build:client    # regenerate lib/client.js from src/entry.jsx
+npm run check:client    # verify the committed artifact matches the source
+npm run check           # syntax
+npm run smoke           # structure / bundle declaration / host / artifact / companion
+```
+
+`lib/client.js` is a build artifact committed to the repository: installing from GitHub does not run
+a build, and without it the UI does not load. Keep `react` and `react/jsx-runtime` external (the DSH
+client module table provides them); the `id` inside the `window.__ModuleLoader__.load({ id, factory })`
+envelope must equal the package name.
+
+Source layout:
+
+- `src/entry.jsx` — the browser half (panel, tabs, source registration)
+- `index.js` — the host half (no host behavior; exists so the plugin loader can load the package)
+
+## Feedback
+
+- Open an issue: https://github.com/taoziliyouchong/dsh-at-menu/issues
+- Or reach me on QQ: **2171960697** (mention which plugin you installed when adding the contact).
+
+Please include: DSH version, plugin version, the exact error text, and a screenshot.
+
+## License
+
+MIT

package/README.md

@@ -1,3 +1,97 @@
-# Temporary Holding Version
+# dsh-at-menu
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+**中文** | [English](README.en.md)
+
+按 `@` 弹出的引用菜单顶部多一排类别标签：点标签只看该类候选，不用一直往下滚动找组。
+
+## 有什么类别
+
+只内置 DSH 会话界面本来就有数据的三类：
+
+| 类别 | 数据来源 |
+| --- | --- |
+| 工作区文件 | 会话工作区的文件引用接口；文件与文件夹同列一类，文件夹行尾部箭头（或 Tab）进入目录，面包屑点上级 |
+| 历史会话 | 会话引用候选里的普通会话 |
+| 子代理会话 | 同一份候选里带子代理标记的行 |
+
+技能、插件、常用提示词、侧栏引用等类别**不由本插件内置**：它们由各自的插件通过
+`ctx.inputTriggers.registerSource({ trigger: '@', name: '类别名', candidates, onPick })`
+注册到宿主，面板会把注册过的源显示成类别标签——`name` 就是标签文字，装得越多标签越多。
+
+## 安装
+
+```sh
+dsh plugin --profile desktop add github:taoziliyouchong/dsh-at-menu
+```
+
+发布到 npm 之后也可以：
+
+```sh
+dsh plugin --profile desktop add dsh-at-menu
+```
+
+装完重启 DSH。用别的 profile 就把 `desktop` 换成你的 profile 名。
+
+要求：DSH 0.2.1 系列的桌面端或 `dsh web`（需要会话输入框的 @ 菜单）。
+兼容：DSH 0.2.1 系列（alpha / rc / 正式版均可）；0.3 起不保证。
+
+## 建议同时关掉内置的 @ 菜单
+
+内置的引用菜单（loader id `ui-reference`）也会注册「工作区文件」「历史会话」这类源。
+两份源同名同时存在，菜单里会出现重复组。推荐在 profile 的 `cordis.patch.yml` 里把它关掉：
+
+```yaml
+- id: ui-reference
+  disabled: true
+```
+
+关掉之后的代价：历史消息里的 `@路径` 不再有装饰样式、文件引用不再能点击打开——文字内容不丢。
+不关也能用（本插件会隐藏内置菜单的外观），只是候选会有重复。
+
+## 怎么工作
+
+- 面板挂在 list 槽 `conversation.input.overlay` 上，与内置菜单同一个座位；只在 @ 菜单打开期间
+  用一条注入样式隐藏内置菜单（`body[data-dsh-at-open] [data-trigger-menu]`），`/` 斜杠菜单保持内置外观。
+- 候选数据、键盘（上下 / 回车 / Esc）、插入动作仍由内置 controller 拥有；面板只订阅它的
+  menu store，再把 pick / hover / dismiss 回投回去。
+- 引用以纯文本落进草稿（`@路径`、`@[标题](dsh-session:…)`），宿主侧现有的文本解析链照旧工作。
+- 不联网、不上传任何内容。
+
+## 已知限制
+
+- 与内置 `ui-reference` 同时启用时，同名的候选组会重复出现（见上一节）。
+- 类别标签只显示 `CATEGORY_SOURCES` 里登记过的源；新插件注册了新名字的源，要改 `src/entry.jsx`
+  里那一行才会出标签。
+- 只改 @ 菜单的外观与分组，不改变草稿的插入格式。
+
+## 开发
+
+```sh
+npm install
+npm run build:client    # 从 src/entry.jsx 重新生成 lib/client.js
+npm run check:client    # 已提交产物与源码一致
+npm run check           # 语法
+npm run smoke           # 结构 / 组合声明 / 宿主 / 产物 / 伴随插件 五关
+```
+
+`lib/client.js` 是提交进仓库的构建产物：从 GitHub 安装时不跑构建，缺了它界面不加载。
+打包要求：`react`、`react/jsx-runtime` 保持 external（由 DSH 客户端模块表提供）；
+产物外壳 `window.__ModuleLoader__.load({ id, factory })` 里的 `id` 必须等于包名。
+
+源码只有两处：
+
+- `src/entry.jsx` —— 浏览器半边（面板、类别标签、源注册）
+- `index.js` —— 宿主半边（本包没有宿主行为，只为被插件系统加载）
+
+## 反馈
+
+插件有问题，按这个顺序：
+
+1. 开 Issue：https://github.com/taoziliyouchong/dsh-at-menu/issues —— 能留痕、能搜历史；
+2. 急着问或不想开 Issue，QQ 号：**2171960697**（加好友请注明装的是哪个插件）。
+
+反馈时带上：DSH 版本、插件版本、报错原文、截图。
+
+## 许可
+
+MIT

package/cordis.patch.yml

@@ -0,0 +1,4 @@
+# dsh-at-menu：一个插件行，浏览器半边由 package.json 的 dsh.client 声明发现。
+- insert:
+    - id: dsh-at-menu
+      name: dsh-at-menu

package/index.js

@@ -0,0 +1,16 @@
+/**
+ * dsh-at-menu 宿主半边：无宿主行为。
+ * 面板本体在浏览器半边（exports["./client"]），由 package.json 的 dsh.client 声明发现。
+ */
+
+/** Cordis 插件名。 */
+export const name = 'dsh-at-menu'
+
+/** 宿主插件体——本包只出界面。 */
+export function apply() {}
+
+/**
+ * 需要的服务：一个都不需要。
+ * 显式声明空数组，免得宿主侧「inject 声明完整」的检查把它当成没写 inject。
+ */
+export const inject = []

package/invariant.js

@@ -0,0 +1,10 @@
+const PACKAGE_NAME = 'dsh-at-menu'
+
+/** Cordis companion plugin name. */
+export const name = 'dsh-at-menu-invariant'
+/** Service required before the companion can reserve package ownership. */
+export const inject = ['invariants']
+
+const install = () => {}
+
+export const apply = (ctx) => Promise.resolve(ctx.invariants.register(PACKAGE_NAME, install))