dsh-cheso-design 0.0.0-stage → 0.1.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/LICENSE +21 -0
- package/README.md +98 -2
- package/README.zh.md +99 -0
- package/assets/icon-180.png +0 -0
- package/assets/icon-512.png +0 -0
- package/cordis.patch.yml +3 -0
- package/docs/DETAIL.de.md +1 -0
- package/docs/DETAIL.es.md +1 -0
- package/docs/DETAIL.fr.md +1 -0
- package/docs/DETAIL.ja.md +1 -0
- package/docs/DETAIL.md +1 -0
- package/docs/DETAIL.pt.md +1 -0
- package/docs/DETAIL.ru.md +1 -0
- package/docs/DETAIL.zh.md +1 -0
- package/docs/THIRD_PARTY_NOTICES.md +24 -0
- package/docs/previews/cheso-gallery-en.webp +0 -0
- package/docs/previews/cheso-gallery-zh.webp +0 -0
- package/lib/client.js +2193 -0
- package/lib/client.js.map +7 -0
- package/lib/index.js +1440 -0
- package/lib/index.js.map +7 -0
- package/locale/de.json +87 -0
- package/locale/en.json +87 -0
- package/locale/es.json +87 -0
- package/locale/fr.json +87 -0
- package/locale/ja.json +87 -0
- package/locale/pt.json +87 -0
- package/locale/ru.json +87 -0
- package/locale/zh.json +87 -0
- package/package.json +88 -4
package/LICENSE
ADDED
|
@@ -0,0 +1,21 @@
|
|
|
1
|
+
MIT License
|
|
2
|
+
|
|
3
|
+
Copyright (c) 2026 Cheso
|
|
4
|
+
|
|
5
|
+
Permission is hereby granted, free of charge, to any person obtaining a copy
|
|
6
|
+
of this software and associated documentation files (the "Software"), to deal
|
|
7
|
+
in the Software without restriction, including without limitation the rights
|
|
8
|
+
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
|
|
9
|
+
copies of the Software, and to permit persons to whom the Software is
|
|
10
|
+
furnished to do so, subject to the following conditions:
|
|
11
|
+
|
|
12
|
+
The above copyright notice and this permission notice shall be included in all
|
|
13
|
+
copies or substantial portions of the Software.
|
|
14
|
+
|
|
15
|
+
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
|
|
16
|
+
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
|
|
17
|
+
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
|
|
18
|
+
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
|
|
19
|
+
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
|
|
20
|
+
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
|
|
21
|
+
SOFTWARE.
|
package/README.md
CHANGED
|
@@ -1,3 +1,99 @@
|
|
|
1
|
-
#
|
|
1
|
+
# Cheso for DeepSeek Harness
|
|
2
2
|
|
|
3
|
-
|
|
3
|
+
[中文](README.zh.md) | English
|
|
4
|
+
|
|
5
|
+
Turn a chat request into a finished Cheso artifact — a deck, a slide, a presentation, a poster, an image or a motion video — then open it in the right sidebar without leaving the conversation.
|
|
6
|
+
|
|
7
|
+
This repository is the public home of the `dsh-cheso-design` plugin for [DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness). The npm package is [`dsh-cheso-design`](https://www.npmjs.com/package/dsh-cheso-design).
|
|
8
|
+
|
|
9
|
+
## What it does
|
|
10
|
+
|
|
11
|
+
- Lets the agent start a task and show the finished files. If Cheso asks a question, DeepSeek Harness shows you the options and waits for you to answer or skip.
|
|
12
|
+
- Renders every result as an artifact card at the end of the turn; clicking a file opens it in the right sidebar.
|
|
13
|
+
- Keeps the whole task on Cheso: the DSH side only holds the conversation, the login grant and a short-lived preview URL.
|
|
14
|
+
|
|
15
|
+
| Tool | Purpose |
|
|
16
|
+
| --- | --- |
|
|
17
|
+
| `cheso_create` | Create a task and return its `task_id` immediately |
|
|
18
|
+
| `cheso_wait` | Wait for a task, pausing for your answers when needed, then return its artifact card |
|
|
19
|
+
| `cheso_project_files` | List an existing project's files by project id or link |
|
|
20
|
+
| `cheso_login` / `cheso_login_wait` | Show the authorization card, then poll the login state |
|
|
21
|
+
| `cheso_whoami` | Show the signed-in account and its credits |
|
|
22
|
+
| `cheso_logout` | Clear this site's grant and ask Cheso to revoke it |
|
|
23
|
+
|
|
24
|
+
## Requirements
|
|
25
|
+
|
|
26
|
+
- DeepSeek Harness `>=0.2.1-rc.1 <0.2.2-0 || >=0.2.2-rc.1 <0.3.0-0` with the Web profile.
|
|
27
|
+
- A Cheso account on [cheso.ai](https://cheso.ai).
|
|
28
|
+
|
|
29
|
+
## Install
|
|
30
|
+
|
|
31
|
+
```sh
|
|
32
|
+
dsh plugin --profile web add dsh-cheso-design
|
|
33
|
+
```
|
|
34
|
+
|
|
35
|
+
Or open **Plugins → Install**, paste `dsh-cheso-design`, and confirm. Installing from the plugin market does the same thing.
|
|
36
|
+
|
|
37
|
+
The plugin activates through HMR; restart DSH if the host stops with `restart-required`.
|
|
38
|
+
|
|
39
|
+
## Use it
|
|
40
|
+
|
|
41
|
+
1. Open the **Plugins → Cheso Design** detail page and select **Connect Cheso account** under **Cheso account**. Finish on the authorization page and return to DSH, where the sign-in is confirmed automatically. You can also ask for `use dsh-cheso-design to log in`, or click **Get authorization link** on the login card.
|
|
42
|
+
2. Ask for what you want, for example `use dsh-cheso-design to make a three-slide deck about the water cycle`, or paste a project link and ask for its artifacts.
|
|
43
|
+
|
|
44
|
+
If Cheso asks about style, an outline, or another choice, use the question card to answer or explicitly skip each question. The same task resumes automatically. If the question card is unavailable, open the Cheso project to answer there, then ask DeepSeek Harness to continue waiting.
|
|
45
|
+
|
|
46
|
+
Cheso cards, preview controls and site settings follow the language selected in **Settings → General**. Available languages are Chinese, English, Japanese, Spanish, French, German, Russian and Brazilian Portuguese.
|
|
47
|
+
|
|
48
|
+
## Configuration
|
|
49
|
+
|
|
50
|
+
| Field | Default | Meaning |
|
|
51
|
+
| --- | --- | --- |
|
|
52
|
+
| `site` | `configured` | `global` uses `https://cheso.ai`. `configured` uses `baseUrl` and `embedBaseUrl`. |
|
|
53
|
+
| `baseUrl` | `https://cheso.ai` | Site used for login and the project API |
|
|
54
|
+
| `embedBaseUrl` | empty (follows `baseUrl`) | Where the preview page is served; point it at a local Vite server while developing |
|
|
55
|
+
| `devSet` | empty | Optional Manager routing id; when set, Host requests carry the `X-Dev-Set` header |
|
|
56
|
+
| `timeoutSec` | `540` | Default polling limit between questions or results, in seconds; time spent waiting for your answers does not count |
|
|
57
|
+
| `token` | empty | Optional API token for this `baseUrl`; otherwise the DSH credential store holds the site grant |
|
|
58
|
+
|
|
59
|
+
## What leaves your machine
|
|
60
|
+
|
|
61
|
+
- The prompt you send and the files you attach or reference are uploaded to the selected Cheso site so its agents can work on them.
|
|
62
|
+
- The Cheso grant is stored in the DSH credential store, scoped to that site; `cheso_logout` revokes it.
|
|
63
|
+
- Previews are shown through a short-lived URL that the DSH host signs after checking that the caller is the instance owner. The URL stays in browser memory.
|
|
64
|
+
|
|
65
|
+
## Limitations
|
|
66
|
+
|
|
67
|
+
- Switching sites switches both credentials and project history, because they belong to different accounts.
|
|
68
|
+
- Upgrading or reinstalling the plugin closes preview tabs that were opened before the upgrade; reopen them from the artifact card.
|
|
69
|
+
|
|
70
|
+
## Development
|
|
71
|
+
|
|
72
|
+
```sh
|
|
73
|
+
npm install
|
|
74
|
+
npm run build # lib/index.js and lib/client.js
|
|
75
|
+
npm run typecheck
|
|
76
|
+
npm test # builds the plugin and runs offline host tests
|
|
77
|
+
```
|
|
78
|
+
|
|
79
|
+
`npm run watch` rebuilds continuously while you edit. Changes to the host half need a DSH restart; client changes reload with the Web bundle.
|
|
80
|
+
|
|
81
|
+
## Publishing
|
|
82
|
+
|
|
83
|
+
From the repository root, install dependencies and sign in with an npm account that can publish the package. Choose a channel and an explicit version.
|
|
84
|
+
|
|
85
|
+
```sh
|
|
86
|
+
npm ci
|
|
87
|
+
npm login --registry=https://registry.npmjs.org
|
|
88
|
+
npm run release -- test 0.1.1-rc.0 --dry-run
|
|
89
|
+
npm run release -- test 0.1.1-rc.0
|
|
90
|
+
npm run release -- stable 0.1.1
|
|
91
|
+
```
|
|
92
|
+
|
|
93
|
+
`test` requires a prerelease version and publishes to `next`. Testers can install it with `npm install dsh-cheso-design@next`. `stable` requires a stable version and publishes to `latest`. Both channels are public.
|
|
94
|
+
|
|
95
|
+
Use `--dry-run` to preview either channel. The script type-checks, builds, runs tests, and writes the requested version to `package.json` in a temporary staging directory.
|
|
96
|
+
|
|
97
|
+
## License
|
|
98
|
+
|
|
99
|
+
MIT — see [LICENSE](LICENSE).
|
package/README.zh.md
ADDED
|
@@ -0,0 +1,99 @@
|
|
|
1
|
+
# Cheso × DeepSeek Harness
|
|
2
|
+
|
|
3
|
+
[English](README.md) | 中文
|
|
4
|
+
|
|
5
|
+
用一句对话让 Cheso 做出成品——PPT、幻灯片、演示文稿、海报、图片或动效视频——然后直接在右侧栏打开,不用离开会话。
|
|
6
|
+
|
|
7
|
+
本仓库是 DeepSeek Harness 插件 `dsh-cheso-design` 的公开主页,npm 包为 [`dsh-cheso-design`](https://www.npmjs.com/package/dsh-cheso-design)。
|
|
8
|
+
|
|
9
|
+
## 功能
|
|
10
|
+
|
|
11
|
+
- 支持创建任务、等待结果和展示成品。Cheso 提问时,DSH 会展示问题和选项,等你回答或明确跳过。
|
|
12
|
+
- 每个结果在回合末尾显示为产物卡,点击文件即可在右侧栏预览。
|
|
13
|
+
- 任务全程在 Cheso 上执行,DSH 侧只保存对话、登录授权和短期预览地址。
|
|
14
|
+
|
|
15
|
+
| 工具 | 用途 |
|
|
16
|
+
| --- | --- |
|
|
17
|
+
| `cheso_create` | 创建任务,立即返回 `task_id` |
|
|
18
|
+
| `cheso_wait` | 等待任务;有提问时先等用户操作,完成后返回在线产物卡 |
|
|
19
|
+
| `cheso_project_files` | 按项目 ID 或完整项目链接查询已有项目的文件 |
|
|
20
|
+
| `cheso_login` / `cheso_login_wait` | 显示授权卡,然后检查登录状态 |
|
|
21
|
+
| `cheso_whoami` | 查看已登录账号和积分 |
|
|
22
|
+
| `cheso_logout` | 清除当前站点的授权,并请求 Cheso 撤销 |
|
|
23
|
+
|
|
24
|
+
## 环境要求
|
|
25
|
+
|
|
26
|
+
- DeepSeek Harness `>=0.2.1-rc.1 <0.2.2-0 || >=0.2.2-rc.1 <0.3.0-0`,使用 Web profile。
|
|
27
|
+
- [cheso.ai](https://cheso.ai) 上的 Cheso 账号。
|
|
28
|
+
|
|
29
|
+
## 安装
|
|
30
|
+
|
|
31
|
+
```sh
|
|
32
|
+
dsh plugin --profile web add dsh-cheso-design
|
|
33
|
+
```
|
|
34
|
+
|
|
35
|
+
也可以在「插件 → 安装」里粘贴 `dsh-cheso-design` 后确认。从插件市场安装的效果相同。
|
|
36
|
+
|
|
37
|
+
插件通过 HMR 生效;如果宿主返回 `restart-required`,重启 DSH 即可。
|
|
38
|
+
|
|
39
|
+
## 使用
|
|
40
|
+
|
|
41
|
+
1. 打开「插件 → Cheso Design」的详情页,在「Cheso 账号」里点击「连接 Cheso 账号」,按授权页指引完成后回到 DSH,登录状态会自动确认。也可以在对话里说「使用 dsh-cheso-design 登录」,或点击登录卡上的「获取授权链接」。
|
|
42
|
+
2. 直接说要做什么,例如「使用 dsh-cheso-design 做一份三页的水循环 PPT」。也可以粘贴项目链接说「用 dsh-cheso-design 查看这个项目的产物」。
|
|
43
|
+
|
|
44
|
+
如果 Cheso 询问风格、大纲或其他选项,请在问答卡上逐题回答或明确跳过。原任务会自动继续。问答卡不可用时,可以打开 Cheso 项目处理,再回到 DSH 让它继续等待。
|
|
45
|
+
|
|
46
|
+
Cheso 卡片、预览控件和站点设置跟随「设置 → 常规」中的界面语言,支持中文、英文、日语、西班牙语、法语、德语、俄语和巴西葡萄牙语。
|
|
47
|
+
|
|
48
|
+
## 配置
|
|
49
|
+
|
|
50
|
+
| 字段 | 默认 | 说明 |
|
|
51
|
+
| --- | --- | --- |
|
|
52
|
+
| `site` | `configured` | `global` 使用 `https://cheso.ai`,`configured` 使用 `baseUrl` 和 `embedBaseUrl` |
|
|
53
|
+
| `baseUrl` | `https://cheso.ai` | 登录和项目 API 使用的站点地址 |
|
|
54
|
+
| `embedBaseUrl` | 空(跟随 `baseUrl`) | 预览页所在站点;本地联调时可指向 Vite |
|
|
55
|
+
| `devSet` | 空 | 可选的 Manager 分流标识;设置后 Host 请求会带 `X-Dev-Set` 头 |
|
|
56
|
+
| `timeoutSec` | `540` | 每段任务轮询的默认上限(秒),不含用户回答时间 |
|
|
57
|
+
| `token` | 空 | 可选的 API token,对应上面的 `baseUrl`;否则使用 DSH 凭据服务保存的站点授权 |
|
|
58
|
+
|
|
59
|
+
## 会离开本机的数据
|
|
60
|
+
|
|
61
|
+
- 你发送的需求,以及你附加或引用的文件,会上传到所选 Cheso 站点,供其 agent 处理。
|
|
62
|
+
- Cheso 授权保存在 DSH 凭据服务中,按站点区分;`cheso_logout` 会撤销该授权。
|
|
63
|
+
- 预览地址由 DSH 宿主在校验访问者为本实例所有者后签发,只在浏览器内存中使用。
|
|
64
|
+
|
|
65
|
+
## 已知限制
|
|
66
|
+
|
|
67
|
+
- 切换站点等于切换账号,凭据与项目历史都属于各自的账号。
|
|
68
|
+
- 升级或重装插件会关闭升级前打开的预览标签,需要从产物卡重新打开。
|
|
69
|
+
|
|
70
|
+
## 开发
|
|
71
|
+
|
|
72
|
+
```sh
|
|
73
|
+
npm install
|
|
74
|
+
npm run build # 生成 lib/index.js 与 lib/client.js
|
|
75
|
+
npm run typecheck
|
|
76
|
+
npm test # 构建插件并运行离线 Host 测试
|
|
77
|
+
```
|
|
78
|
+
|
|
79
|
+
`npm run watch` 可持续构建。改 Host 部分后需要重启 DSH;改 Client 部分随 Web 包热更新。
|
|
80
|
+
|
|
81
|
+
## 发布
|
|
82
|
+
|
|
83
|
+
在仓库根目录安装依赖,用有包发布权限的 npm 账号登录,然后指定发布渠道和版本。
|
|
84
|
+
|
|
85
|
+
```sh
|
|
86
|
+
npm ci
|
|
87
|
+
npm login --registry=https://registry.npmjs.org
|
|
88
|
+
npm run release -- test 0.1.1-rc.0 --dry-run
|
|
89
|
+
npm run release -- test 0.1.1-rc.0
|
|
90
|
+
npm run release -- stable 0.1.1
|
|
91
|
+
```
|
|
92
|
+
|
|
93
|
+
`test` 需要预发布版本号,发布到 `next`。测试者可以用 `npm install dsh-cheso-design@next` 安装。`stable` 需要正式版本号,发布到 `latest`。两个渠道都是公开的。
|
|
94
|
+
|
|
95
|
+
两个渠道均可用 `--dry-run` 预览。脚本会执行类型检查、构建和测试,并将指定版本写入临时打包目录中的 `package.json`。
|
|
96
|
+
|
|
97
|
+
## 许可证
|
|
98
|
+
|
|
99
|
+
MIT,见 [LICENSE](LICENSE)。
|
|
Binary file
|
|
Binary file
|
package/cordis.patch.yml
ADDED
|
@@ -0,0 +1 @@
|
|
|
1
|
+

|
|
@@ -0,0 +1 @@
|
|
|
1
|
+

|
|
@@ -0,0 +1 @@
|
|
|
1
|
+

|
|
@@ -0,0 +1 @@
|
|
|
1
|
+

|
package/docs/DETAIL.md
ADDED
|
@@ -0,0 +1 @@
|
|
|
1
|
+

|
|
@@ -0,0 +1 @@
|
|
|
1
|
+

|
|
@@ -0,0 +1 @@
|
|
|
1
|
+

|
|
@@ -0,0 +1 @@
|
|
|
1
|
+

|
|
@@ -0,0 +1,24 @@
|
|
|
1
|
+
# Third-party notices
|
|
2
|
+
|
|
3
|
+
The file type icons use SVG paths from `@tencent/bk-icon-vedas_external` 0.3.12.
|
|
4
|
+
The package lists icon_cool as its author and MIT as its license.
|
|
5
|
+
|
|
6
|
+
Copyright (c) icon_cool
|
|
7
|
+
|
|
8
|
+
Permission is hereby granted, free of charge, to any person obtaining a copy
|
|
9
|
+
of this software and associated documentation files (the "Software"), to deal
|
|
10
|
+
in the Software without restriction, including without limitation the rights
|
|
11
|
+
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
|
|
12
|
+
copies of the Software, and to permit persons to whom the Software is
|
|
13
|
+
furnished to do so, subject to the following conditions:
|
|
14
|
+
|
|
15
|
+
The above copyright notice and this permission notice shall be included in all
|
|
16
|
+
copies or substantial portions of the Software.
|
|
17
|
+
|
|
18
|
+
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
|
|
19
|
+
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
|
|
20
|
+
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
|
|
21
|
+
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
|
|
22
|
+
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
|
|
23
|
+
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
|
|
24
|
+
SOFTWARE.
|
|
Binary file
|
|
Binary file
|