dsh-tender-workbench 0.2.1-beta.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Sunhh3221
+
+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.md

@@ -0,0 +1,108 @@
+# dsh-tender-workbench
+
+`dsh-tender-workbench` is an independent, Client-only DeepSeek Harness Web workbench for tender and proposed-project discovery. It adds a “招投标 / Tenders” action to the official `conversation.input.left` Slot, opens a Portal-based search drawer, and appends a deterministic qcc-tender request to the current Session draft through `SessionInput.setDraft()`. It also projects persisted qcc tool events into a Session Header result action and a replayable summary/list drawer with search history.
+
+The first step selects **招投标搜索 / Tender search** or **拟建项目搜索 / Proposed-project search**. Tender search defaults to **不限 / All**, combining tender and award conditions, and can be narrowed to **招标 / Tender** or **中标 / Award**. These states mirror the visible fields and options of the corresponding 标找找 `ttender`, `ifb`, `wtb`, and `proposed` reference pages while remaining completely local to the plugin.
+
+Frequently used conditions stay visible in one aligned filter workspace. Advanced fields use a compact reference-style toolbar and one shared in-place option panel instead of flattening every option. The combined All state uses a responsive 4/3/2-column grid, so labels stay on one line at desktop, compact, and mobile widths. Active triggers keep stable dimensions and expose their full values in a separate summary strip. Clicking outside closes either the advanced option panel or region cascader without clearing selections; Escape closes the active popup before the drawer.
+
+The shared region field provides searchable province → city → district multi-selection using the bundled snapshot derived from `docs/area.ts`. Every region row is a large hit target: clicking a province selects it and opens its cities, and clicking a city selects it and opens its districts. No precise arrow click is required; selected regions are written as complete administrative paths.
+
+The plugin does not modify DeepSeek Harness source, inspect or write the native composer DOM, submit messages, access the network, persist filter values, or depend on third-party DSH plugins.
+
+Visible filters are limited to parameters supported by `mcp__qcc-tender__search_tenders` and `mcp__qcc-tender__search_proposed_projects`. Relative dates become fixed dates, closed custom date ranges are converted to the tool's open interval, region paths are normalized, and amounts are converted from 万元 to 元 before the prompt is generated. The prompt contains one exact tool name and valid JSON and explicitly disallows Web-search fallback.
+
+## Documentation
+
+- [Plugin design](docs/dsh-tender-workbench-plugin-design.md)
+- [Province, city, and district source snapshot](docs/area.ts)
+
+## Compatibility
+
+This checkout targets DeepSeek Harness `0.1.1-rc.2`, the highest version currently published to the public npm registry (published under the `next` dist-tag; npm's `latest` dist-tag still points to `0.0.1-rc.1`). The plugin declares the matching public Client packages as peer and development dependencies, so it can be developed outside the Harness source workspace.
+
+## Build and test
+
+From this directory:
+
+```sh
+pnpm install --ignore-workspace
+pnpm run typecheck
+pnpm run test
+pnpm run build
+```
+
+The build emits the Host loader entry at `lib/index.js`, the DSH Client factory bundle at `lib/client.js`, and declarations under `lib/types/`.
+
+## Install into the Web profile
+
+### Install the internal preview from npm
+
+The current release is an internal preview published under the `beta` dist-tag. It does not use or create the `latest` dist-tag:
+
+```sh
+dsh plugin --profile web add dsh-tender-workbench@beta
+dsh web --no-open
+```
+
+To install an exact version:
+
+```sh
+dsh plugin --profile web add dsh-tender-workbench@0.2.1-beta.0
+```
+
+After a stable version is published to `latest`, users will be able to install it without an explicit tag:
+
+```sh
+dsh plugin --profile web add dsh-tender-workbench
+```
+
+### Install from an independent source checkout
+
+Build first, then run the following command from this plugin's own root directory when the public `dsh` CLI is available:
+
+```sh
+dsh plugin --profile web add .
+dsh web --no-open
+```
+
+If `dsh` is only available through a separate DeepSeek Harness source checkout, pass this plugin's absolute path instead of assuming that it is nested inside the Harness repository:
+
+```sh
+cd /path/to/deepseek-harness
+pnpm dsh plugin --profile web add /absolute/path/to/dsh-tender-workbench
+pnpm dsh web --no-open
+```
+
+### Install from a tarball
+
+```sh
+dsh plugin --profile web add ./dsh-tender-workbench-0.2.1-beta.0.tgz
+dsh web --no-open
+```
+
+Restart the Web profile after adding or removing the bundle. The plugin package's `dsh.bundle.patch` declaration activates `cordis.patch.yml`, whose only contribution is the `dsh-tender-workbench` Loader row.
+
+To remove it:
+
+```sh
+dsh plugin --profile web remove dsh-tender-workbench
+```
+
+## Runtime behavior
+
+- Each Session-scoped entry retains its own temporary selections until remount or refresh.
+- The default All state includes both tender and award filters without forcing a notice type; narrowed Tender, Award, and Proposed-project states render and output only their supported fields.
+- Tender and Award use separate stage selections; Proposed-project has its own stage, approval, and investment filters.
+- Preset and custom amount ranges are mutually exclusive and validated locally.
+- Province, city, and district selections are canonicalized so an ancestor and its descendant are not output together.
+- Empty filter values and unrestricted choices are omitted from the generated prompt.
+- Keywords and regions are blocked above the tool limits of 10 and 20; unsupported Hong Kong, Macao, and Taiwan selections are rejected rather than silently dropped.
+- Existing draft text is retained and separated from generated text by one blank line.
+- Confirmation calls `setDraft()` exactly once and never calls `submit()`.
+- A missing Session or input facade keeps the panel open and presents an error.
+- Outside press dismisses the active advanced or region popup. Escape dismisses an active popup first; backdrop, Cancel, Close, or a second Escape dismisses the drawer and returns focus to the trigger.
+- Persisted `tool/call` and append-surface `tool/result` events are paired by Turn and exact `callId`; historical replay and live append produce the same projection.
+- A newly completed search Turn opens its result drawer once. Historical results do not auto-open and remain available from the Session Header.
+- Result summaries combine the MCP query summary with statistics explicitly limited to loaded records. Lists contain only returned records, provide no guessed links or pagination, and deduplicate stable business IDs in result order.
+- “最近待截止时间” means the earliest parseable deadline after the current time; expired values are excluded.

package/cordis.patch.yml

@@ -0,0 +1,3 @@
+- insert:
+    - id: tender-workbench
+      name: dsh-tender-workbench