dsh-codearts-dock 0.0.0-stage → 1.0.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/DISCLAIMER.md +47 -0
- package/LICENSE +21 -0
- package/README.md +172 -2
- package/SECURITY.md +47 -0
- package/THIRD_PARTY_NOTICES.md +64 -0
- package/client.js +3519 -0
- package/cordis.patch.yml +10 -0
- package/docs/DETAIL.md +25 -0
- package/docs/DETAIL.zh.md +25 -0
- package/docs/PUBLISHING.md +43 -0
- package/docs/preview.svg +78 -0
- package/icons/dsh-connect-codearts-128.png +0 -0
- package/icons/dsh-connect-codearts-256.png +0 -0
- package/locale/en.json +7 -0
- package/locale/zh.json +7 -0
- package/package.json +88 -4
- package/scripts/build-market-index.mjs +24 -0
- package/scripts/check-legal.sh +33 -0
- package/scripts/check-release.mjs +29 -0
- package/scripts/test.mjs +11 -0
- package/src/account.js +217 -0
- package/src/accounts.js +481 -0
- package/src/adapter.js +742 -0
- package/src/backup.js +89 -0
- package/src/catalog.js +269 -0
- package/src/checkin.js +271 -0
- package/src/credentials.js +435 -0
- package/src/features.js +79 -0
- package/src/gateway.js +521 -0
- package/src/health.js +18 -0
- package/src/index.js +1108 -0
- package/src/models.js +147 -0
- package/src/paths.js +36 -0
- package/src/preferences.js +90 -0
- package/src/protocol/crypto.js +160 -0
- package/src/protocol/sign.js +176 -0
- package/src/protocol/sm4.js +264 -0
- package/src/protocol/sse.js +134 -0
- package/src/sts.js +118 -0
- package/src/usage.js +55 -0
- package/test/accounts.test.mjs +322 -0
- package/test/adapter.test.mjs +234 -0
- package/test/assembler.test.mjs +86 -0
- package/test/features.test.mjs +257 -0
- package/test/live-probe.mjs +55 -0
- package/test/protocol.test.mjs +167 -0
- package/test/registration.test.mjs +301 -0
- package/test/sm4.test.mjs +64 -0
- package/test/ui.test.mjs +370 -0
- package/test/visual.test.mjs +438 -0
package/DISCLAIMER.md
ADDED
|
@@ -0,0 +1,47 @@
|
|
|
1
|
+
# CodeArts Dock 免责声明
|
|
2
|
+
|
|
3
|
+
适用于 `dsh-codearts-dock`(CodeArts Dock · 码道驿站)的源码、npm 包、GitHub 分发文件、插件索引和相关文档。更新日期:2026 年 11 月 20 日。
|
|
4
|
+
|
|
5
|
+
## 1. 非官方项目与商标
|
|
6
|
+
|
|
7
|
+
本项目是由个人维护的第三方开源兼容性插件,与华为技术有限公司及其关联主体、DeepSeek 及 DeepSeek Harness 的运营方**没有任何关联**,未获得上述主体对本项目的官方授权、审核、认可、赞助或支持。
|
|
8
|
+
|
|
9
|
+
Huawei、HUAWEI Cloud、CodeArts、码道、DeepSeek、DeepSeek Harness 及相关名称、商标和标识的权利归各自权利人所有。文档中的提及属于说明兼容对象的**描述性使用**,不代表本项目拥有相关权利,也不表示存在合作或官方关系。
|
|
10
|
+
|
|
11
|
+
本项目的开源许可仅适用于项目有权许可的代码和资源,不向使用者授予上游服务、第三方模型、数据或商标的使用权。第三方代码和参考实现的归属及许可见 [THIRD_PARTY_NOTICES.md](THIRD_PARTY_NOTICES.md)。
|
|
12
|
+
|
|
13
|
+
## 2. 使用权限与服务规则
|
|
14
|
+
|
|
15
|
+
使用者应自行取得合法有效的账号、凭证、模型调用权限及必要授权,并遵守适用法律、上游服务条款、账号及 API 使用规则,以及所属组织的数据与安全政策。
|
|
16
|
+
|
|
17
|
+
本插件提供接口兼容与账号配置能力,不提供账号或模型使用权益,不共享他人凭证,不绕过计费,不用于规避访问控制、服务限制或其他使用条件。开源代码可获取,不等于上游服务允许所有使用方式,也不构成有关合规性或适用性的法律意见。
|
|
18
|
+
|
|
19
|
+
## 3. 积分、费用与账号风险
|
|
20
|
+
|
|
21
|
+
模型调用、请求重试及其他上游操作可能消耗使用者账号的积分、套餐额度或产生费用。显示的余额、倍率、Token 数和本机记录可能延迟、不完整或与最终结算不同,应以上游服务方的实际记录和账单为准。
|
|
22
|
+
|
|
23
|
+
使用者自行决定调用、切换账号、导入导出及签到等操作。自动签到默认关闭,启用后仅在插件运行时按实现尝试领取,不保证奖励、到账、持续可用或跨设备操作的一致性。不得将本插件视为防止超额消费、账号限制、停用或封禁的保证。
|
|
24
|
+
|
|
25
|
+
## 4. 数据、凭证与第三方处理
|
|
26
|
+
|
|
27
|
+
插件运行时会向配置的网关及相关认证服务发送必要的请求和认证材料。模型请求可能包含对话上下文、代码、附件、工具信息及其他使用者提供的内容。第三方如何处理这些数据,应查阅其适用政策;本项目不控制第三方的数据处理。
|
|
28
|
+
|
|
29
|
+
本机账号凭证文件以明文保存,安全性依赖操作系统、账号权限及使用环境。普通账号导出也可能包含明文密钥。加密备份只保护对应备份文件,不会自动加密本机凭证、保证密码强度,或防止运行环境已被入侵时的信息泄露。
|
|
30
|
+
|
|
31
|
+
使用者应自行管理密钥、备份、密码、共享设备和自定义网关,避免提交未脱敏的日志、导出文件或诊断截图。具体实现及边界见 [SECURITY.md](SECURITY.md)。
|
|
32
|
+
|
|
33
|
+
## 5. 可用性与输出准确性
|
|
34
|
+
|
|
35
|
+
本插件依赖 Harness、码道及其他第三方服务的接口和运行行为。上游变更、网络状况、账号权限或宿主版本变化可能导致功能中断、请求失败、兼容性问题或配置迁移失败;不保证所有平台、账号或版本均可使用,也不承诺持续维护或特定响应时间。
|
|
36
|
+
|
|
37
|
+
模型输出可能错误、不完整或不适合实际用途。使用者应核实代码、命令及其他结果,并自行决定是否执行或采用。
|
|
38
|
+
|
|
39
|
+
## 6. 无担保与责任限制
|
|
40
|
+
|
|
41
|
+
在适用法律允许的范围内,本项目依据 [MIT 许可证](LICENSE) 「**按原样**」(AS IS)和现有状态提供,不附带任何明示或默示担保,包括适销性、特定用途适用性、无侵权、准确性、安全性、可用性或不中断运行的担保。
|
|
42
|
+
|
|
43
|
+
在适用法律允许的范围内,作者及维护者不对因使用、无法使用或依赖本项目而产生的损失承担责任,包括费用或积分损失、账号限制、数据丢失、凭证泄露、服务中断及其他直接或间接损失。适用法律规定不得排除或限制的责任、法定权利及救济,不因本声明而被排除或限制。
|
|
44
|
+
|
|
45
|
+
## 7. 问题反馈
|
|
46
|
+
|
|
47
|
+
一般问题请通过 [GitHub Issues](https://github.com/Jensen0925/dsh-codearts-dock/issues) 反馈;涉及凭证、漏洞或个人信息的内容,请遵循 [安全问题报告方式](SECURITY.md),不要公开发布敏感材料。
|
package/LICENSE
ADDED
|
@@ -0,0 +1,21 @@
|
|
|
1
|
+
MIT License
|
|
2
|
+
|
|
3
|
+
Copyright (c) 2026 Jensen0925
|
|
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,173 @@
|
|
|
1
|
-
|
|
1
|
+
<p align="center">
|
|
2
|
+
<img src="icons/dsh-connect-codearts-256.png" width="112" alt="CodeArts Dock · 码道驿站" />
|
|
3
|
+
</p>
|
|
2
4
|
|
|
3
|
-
|
|
5
|
+
# CodeArts Dock · 码道驿站
|
|
6
|
+
|
|
7
|
+
**在 DeepSeek Harness 中使用华为云码道模型,并在一处管理账号、积分和模型配置。**
|
|
8
|
+
|
|
9
|
+
> 第三方、非官方插件,与华为技术有限公司及 DeepSeek / DeepSeek Harness 的运营方**无任何关联**,未获其官方授权、认可或赞助。使用本插件需要你自己的合法账号和服务权限;模型调用可能消耗积分或产生费用,本插件不绕过计费。使用前请阅读 [免责声明](DISCLAIMER.md) 与 [安全说明](SECURITY.md)。
|
|
10
|
+
|
|
11
|
+
[GitHub](https://github.com/Jensen0925/dsh-codearts-dock) · [问题反馈](https://github.com/Jensen0925/dsh-codearts-dock/issues) · [MIT 许可](LICENSE)
|
|
12
|
+
|
|
13
|
+
## 能做什么
|
|
14
|
+
|
|
15
|
+
- **接入码道模型**:通过原生 LLM 适配器接入 Harness 的模型选择器,支持流式回复、推理输出和工具调用;图片输入取决于所选模型的能力。
|
|
16
|
+
- **多账号管理**:添加、重命名、导入、导出账号,手动切换当前使用的账号。
|
|
17
|
+
- **积分与余额提醒**:在输入框旁查看余额,设置低余额阈值;余额不足时查看备用账号。
|
|
18
|
+
- **账号健康检查**:显示余额不足、凭证或权限异常、限流、网络异常等状态及检查时间,支持重新检查和更新凭证。
|
|
19
|
+
- **模型筛选与预设**:按名称或 ID 搜索,筛选已启用、图片或推理模型,按倍率排序;保存模型配置预设,预览后应用。
|
|
20
|
+
- **本机用量记录**:查看最近请求的模型、耗时、Token 数和结果,支持关闭记录、清空历史。
|
|
21
|
+
- **配置备份与迁移**:备份模型选择、能力覆盖、预设、提醒等偏好;包含账号凭证时强制使用密码加密,恢复前先预览。
|
|
22
|
+
- **每日签到**:支持一键签到和可选的自动签到;自动签到默认关闭,活动是否可领取以上游返回为准。
|
|
23
|
+
- **诊断与反馈**:查看连接状态,复制经过字段筛选的诊断信息。
|
|
24
|
+
|
|
25
|
+
模型目录默认每五分钟刷新,显示的倍率来自上游。插件直接连接网关,不需要额外启动本地代理服务;保存模型选择后会通知 Harness 更新模型列表。
|
|
26
|
+
|
|
27
|
+
## 安装
|
|
28
|
+
|
|
29
|
+
需要已安装、支持第三方组合包(bundle)的 DeepSeek Harness,以及可访问码道服务的账号。
|
|
30
|
+
|
|
31
|
+
### 从 GitHub 安装
|
|
32
|
+
|
|
33
|
+
在 Harness 的插件管理页打开安装入口,输入:
|
|
34
|
+
|
|
35
|
+
```text
|
|
36
|
+
https://github.com/Jensen0925/dsh-codearts-dock.git
|
|
37
|
+
```
|
|
38
|
+
|
|
39
|
+
按宿主提示完成安装并启用插件。如宿主提示需要重启,完成一次重启后再打开设置页。
|
|
40
|
+
|
|
41
|
+
### 从 npm 安装
|
|
42
|
+
|
|
43
|
+
npm 发布完成后,可在同一安装入口输入包名:
|
|
44
|
+
|
|
45
|
+
```text
|
|
46
|
+
dsh-codearts-dock
|
|
47
|
+
```
|
|
48
|
+
|
|
49
|
+
请通过 Harness 的插件管理安装;在任意目录单独运行 `npm install` 不会自动启用 Harness 插件。
|
|
50
|
+
|
|
51
|
+
### 从插件索引安装
|
|
52
|
+
|
|
53
|
+
支持自定义插件索引的 Harness 版本可在「插件 → 发现」添加本项目的索引源,再查找 **CodeArts Dock**。索引地址与安装方式见 [发布说明](docs/PUBLISHING.md)。项目索引由本项目维护,不代表获得官方推荐或审核。
|
|
54
|
+
|
|
55
|
+
## 三步开始使用
|
|
56
|
+
|
|
57
|
+
1. 打开 **设置 → 码道 → 账号**,添加你的 Access Key ID(AK)与 Secret Access Key(SK),或导入凭证文件。
|
|
58
|
+
2. 在 **模型** 分栏启用需要的模型,调整图片开关、可关闭思考选项和默认推理强度,点击 **保存**。
|
|
59
|
+
3. 返回对话,在模型选择器里选择 `codearts` 对应的模型。输入框旁的积分胶囊可查看余额和账号。
|
|
60
|
+
|
|
61
|
+
不需要手动填写 STS 临时令牌:插件会为 AK/SK 交换临时凭证,并在需要时续期。账号或权限被撤销后,长期密钥也可能失效。
|
|
62
|
+
|
|
63
|
+
## 账号与凭证
|
|
64
|
+
|
|
65
|
+
插件依次尝试以下来源,优先采用通过检查的来源:
|
|
66
|
+
|
|
67
|
+
| 优先级 | 来源 | 配置方式 |
|
|
68
|
+
| --- | --- | --- |
|
|
69
|
+
| 1 | 环境变量 | 启动 Harness 前提供 `CODEARTS_AK`、`CODEARTS_SK`,可选 `CODEARTS_SECURITY_TOKEN` |
|
|
70
|
+
| 2 | 本机账号池 | 在设置页添加或导入 AK/SK,选择当前账号 |
|
|
71
|
+
| 3 | 本机码道客户端登录态 | 读取本机、本人已登录客户端中可用的临时凭证 |
|
|
72
|
+
|
|
73
|
+
环境变量优先于账号池。如果切换账号后使用的身份没有变化,请先检查是否设置了环境变量。
|
|
74
|
+
|
|
75
|
+
账号池支持华为云 `credentials.csv`、每行 `AK,SK` 文本,以及本插件导出的账号 JSON。导入前可预览,账号名称可以自行修改。账号池的普通导出包含**明文密钥**,不要发到 Issue、聊天或公开仓库;换机器时优先使用配置备份中的加密导出。
|
|
76
|
+
|
|
77
|
+
客户端登录态的可用性取决于客户端版本、登录状态和令牌有效期。插件只读取本机已有凭证,不代替官方登录;失效后需要在客户端重新登录。
|
|
78
|
+
|
|
79
|
+
## 设置与日常使用
|
|
80
|
+
|
|
81
|
+
### 账号、余额与健康状态
|
|
82
|
+
|
|
83
|
+
账号页显示各账号的积分、签到和健康状态。检查结果是最近一次请求的状态快照,不能保证下一次请求一定成功。余额提醒默认开启,初始阈值为 **500 积分**,可以修改或关闭;提醒可以暂时忽略。
|
|
84
|
+
|
|
85
|
+
账号切换由你手动决定。已经发出的请求不会因为切换账号而自动重发。
|
|
86
|
+
|
|
87
|
+
### 模型与预设
|
|
88
|
+
|
|
89
|
+
模型页可以搜索名称或 ID,筛选图片、推理能力,查看上下文、输出上限和积分倍率。未启用的模型仍保留在目录里,便于重新开启。搜索、筛选和模型草稿在切换设置分栏时保留,修改在保存后生效。
|
|
90
|
+
|
|
91
|
+
内置预设面向日常低倍率、深度推理和图片任务;也可以保存自己的预设。预设先应用到草稿,检查后再保存。手动打开图片或思考开关不会为上游模型增加它原本不支持的能力。
|
|
92
|
+
|
|
93
|
+
### 用量记录
|
|
94
|
+
|
|
95
|
+
默认在本机保留最近 **200 条**请求元数据,包括时间、模型、耗时、输入/输出 Token 数,以及成功、失败或取消状态。不会在这份记录中保存提示词、回复正文、工具参数或账号密钥。
|
|
96
|
+
|
|
97
|
+
上游未返回的 Token 数显示为未知。记录是本插件看到的请求尝试,重试可能产生多条记录;它不是官方账单,也不按模型倍率估算积分消耗。可以关闭后续记录,或清空已有记录。
|
|
98
|
+
|
|
99
|
+
### 签到
|
|
100
|
+
|
|
101
|
+
可在账号页执行一次签到,或开启每日自动签到。自动签到默认关闭,仅在 Harness 与插件运行时工作,不是关机后仍可执行的系统定时任务。
|
|
102
|
+
|
|
103
|
+
插件会在领取前检查活动,并记录本机尝试状态以减少重复请求。是否领取成功、奖励额度和到账时间以上游为准,不能保证在多设备并发操作时只发生一次尝试。
|
|
104
|
+
|
|
105
|
+
### 备份与迁移
|
|
106
|
+
|
|
107
|
+
在账号页展开配置备份:
|
|
108
|
+
|
|
109
|
+
1. 选择是否包含账号凭证。默认只导出配置。
|
|
110
|
+
2. 包含凭证时设置并确认密码,下载加密 JSON;配置备份也可以选择加密。
|
|
111
|
+
3. 在另一台机器选择备份文件,填写密码并预览变更,确认后恢复。
|
|
112
|
+
|
|
113
|
+
加密备份使用 scrypt 派生密钥与 AES-256-GCM。请妥善保存密码;本项目无法找回遗忘的密码。恢复会更新预览中列出的偏好和匹配账号的凭证。
|
|
114
|
+
|
|
115
|
+
## 数据与安全边界
|
|
116
|
+
|
|
117
|
+
- 模型请求会把你提交的对话上下文、附件及工具相关内容发送给配置的网关;请遵守上游服务规则及所在组织的数据政策。
|
|
118
|
+
- 为交换临时令牌、获取模型、查看积分或签到,插件会访问华为云 IAM 和码道服务。配置自定义网关后,请求及相关认证材料会发送到该地址。
|
|
119
|
+
- 本机凭证文件以明文保存,通过文件权限保护;加密备份不会加密运行中的凭证文件。
|
|
120
|
+
- 本机请求元数据不作为遥测上传。宿主、网关及你配置的其他组件可能有各自的数据处理行为。
|
|
121
|
+
- 复制诊断信息使用字段白名单;技术详情和你自行截取的日志仍可能含账号名称、路径或错误信息,提交反馈前请检查。
|
|
122
|
+
|
|
123
|
+
为兼容旧版,本机配置目录仍使用 `dsh-connect-codearts`:默认位于 `~/.config/dsh-connect-codearts/`,设置 `APPDATA` 时使用其下的同名目录;还兼容读取旧凭证文件 `~/.dsh-connect-codearts/credentials.json`。包名变更为 `dsh-codearts-dock`,模型 provider 仍为 `codearts`。
|
|
124
|
+
|
|
125
|
+
详细说明见 [SECURITY.md](SECURITY.md)。
|
|
126
|
+
|
|
127
|
+
## 常见问题
|
|
128
|
+
|
|
129
|
+
**安装后看不到设置页?**
|
|
130
|
+
|
|
131
|
+
确认插件已启用,查看 Harness 的插件加载错误;如安装过程提示需要重启,先重启再检查。不要同时启用新旧两个包来注册同一个 `codearts` provider。
|
|
132
|
+
|
|
133
|
+
**模型目录或积分加载失败?**
|
|
134
|
+
|
|
135
|
+
在账号页重新检查账号,在模型页重读目录,并查看诊断信息。优先检查网络、凭证、服务开通情况和权限。临时出现缓存目录不代表模型已经下架。
|
|
136
|
+
|
|
137
|
+
**为什么没有某个模型,或模型能力与预期不同?**
|
|
138
|
+
|
|
139
|
+
模型、价格、上下文和能力以上游接口及账号权限为准。本插件不保证某个模型长期可用,目录中的能力信息也可能滞后。
|
|
140
|
+
|
|
141
|
+
**出现限流或请求失败会自动换账号吗?**
|
|
142
|
+
|
|
143
|
+
不会自动切换账号。可查看健康状态并手动切换;部分请求错误会交由宿主的重试机制处理。
|
|
144
|
+
|
|
145
|
+
**去哪里反馈问题?**
|
|
146
|
+
|
|
147
|
+
请在 [GitHub Issues](https://github.com/Jensen0925/dsh-codearts-dock/issues) 提供 Harness 版本、插件版本、复现步骤和脱敏诊断。不要提交 AK/SK、令牌、明文账号导出或备份密码。安全问题按 [安全说明](SECURITY.md) 中的方式报告。
|
|
148
|
+
|
|
149
|
+
## 开发与验证
|
|
150
|
+
|
|
151
|
+
源码为直接运行的 ES 模块,无需构建浏览器包。使用 Node.js 安装依赖后执行:
|
|
152
|
+
|
|
153
|
+
```bash
|
|
154
|
+
npm install
|
|
155
|
+
npm test
|
|
156
|
+
```
|
|
157
|
+
|
|
158
|
+
离线测试覆盖协议、账号、注册、适配器和设置页交互。宿主 `BlockAssembler` 集成测试需要提供 `DSH_INSTALL_DIR`;真实网关测试单独通过 `npm run test:live` 运行,可能消耗真实账号的额度。
|
|
159
|
+
|
|
160
|
+
```text
|
|
161
|
+
src/ 适配器、网关协议、账号、配置、用量与备份
|
|
162
|
+
client.js Harness 设置页与输入框积分胶囊
|
|
163
|
+
locale/ 插件市场元数据
|
|
164
|
+
icons/ 插件图标
|
|
165
|
+
docs/ 详细介绍与发布说明
|
|
166
|
+
test/ 离线测试及可选集成测试
|
|
167
|
+
```
|
|
168
|
+
|
|
169
|
+
## 许可与声明
|
|
170
|
+
|
|
171
|
+
本项目采用 [MIT 许可证](LICENSE)。使用的第三方实现、界面参考和对应许可见 [THIRD_PARTY_NOTICES.md](THIRD_PARTY_NOTICES.md)。
|
|
172
|
+
|
|
173
|
+
Huawei、CodeArts、码道、DeepSeek 及 DeepSeek Harness 等名称仅用于说明兼容对象,权利归相应权利人所有。本项目按原样提供;服务可用性、使用费用、账号状态及接口兼容性不作保证,详见 [免责声明](DISCLAIMER.md)。
|
package/SECURITY.md
ADDED
|
@@ -0,0 +1,47 @@
|
|
|
1
|
+
# 安全说明
|
|
2
|
+
|
|
3
|
+
本说明对应 CodeArts Dock(`dsh-codearts-dock`)当前实现。更新日期:2026 年 11 月 20 日。
|
|
4
|
+
|
|
5
|
+
## 报告安全问题
|
|
6
|
+
|
|
7
|
+
请优先使用仓库的 [私密漏洞报告入口](https://github.com/Jensen0925/dsh-codearts-dock/security/advisories/new);该入口的可用性取决于仓库是否启用了私密报告。
|
|
8
|
+
|
|
9
|
+
如果私密入口不可用,可在 [Issues](https://github.com/Jensen0925/dsh-codearts-dock/issues) 中仅说明需要联系维护者,不要发布漏洞利用细节、真实 AK/SK、令牌、凭证文件、明文账号导出或备份密码。维护者会安排后续沟通方式,不承诺固定响应时间。发现密钥泄露时,请先在上游撤销或轮换密钥。
|
|
10
|
+
|
|
11
|
+
## 凭证存储
|
|
12
|
+
|
|
13
|
+
- 默认配置目录:`~/.config/dsh-connect-codearts/`;设置 `APPDATA` 时,使用 `$APPDATA/dsh-connect-codearts/`。当前实现不读取 `XDG_CONFIG_HOME`。
|
|
14
|
+
- 账号池文件:`credentials.json`。仍兼容读取 `~/.dsh-connect-codearts/credentials.json` 中的旧凭证。
|
|
15
|
+
- 目录名称保留旧包名以兼容已有安装,不代表仍需安装旧包。
|
|
16
|
+
- 账号池保存明文 AK/SK 与账号元数据,写入时指定文件权限 `0600`。权限保护的实际效果取决于操作系统和文件系统,不能防止同一用户下的恶意进程、磁盘泄露或不当备份。
|
|
17
|
+
- 普通账号导出包含明文密钥;不要把导出文件放进公开仓库、同步共享目录或问题反馈。
|
|
18
|
+
|
|
19
|
+
## 备份与恢复
|
|
20
|
+
|
|
21
|
+
配置备份默认不含账号凭证。勾选包含凭证时必须设置密码,使用 scrypt(N=32768、r=8、p=1)派生 256 位密钥,并以随机盐、随机 IV 和 AES-256-GCM 加密。只有配置的备份也可选择加密。
|
|
22
|
+
|
|
23
|
+
恢复前先在本机解密并显示变更预览。密码不会作为配置保存,项目不提供密码找回。备份加密不等于本机凭证加密;不要把备份文件与密码放在同一位置。
|
|
24
|
+
|
|
25
|
+
## 网络与认证边界
|
|
26
|
+
|
|
27
|
+
插件默认访问码道网关 `snap-access.cn-north-4.myhuaweicloud.com` 和华为云 IAM 认证服务。AK 用于标识签名身份;SK 用于本机生成签名,认证流程会与 IAM 交换临时凭证。不能把这一过程表述为“所有凭证都不出本机”。
|
|
28
|
+
|
|
29
|
+
模型调用向网关发送认证信息和请求内容,包括会话上下文、代码、附件及工具相关信息。配置自定义网关后,该网关将接收相应请求和认证材料。只应配置可信地址,并遵守上游数据政策和组织要求。
|
|
30
|
+
|
|
31
|
+
设置页通过宿主 HTTP 路由管理账号。常规状态接口只返回遮罩或状态;添加、导入、明文账号导出以及备份恢复等流程会处理敏感内容。是否能从远程访问宿主取决于 Harness 的部署与认证配置,请不要向不可信网络暴露宿主服务。
|
|
32
|
+
|
|
33
|
+
## 本机客户端登录态
|
|
34
|
+
|
|
35
|
+
未提供其他可用凭证时,插件可只读访问本机码道客户端的 `state.vscdb`,提取本人已登录会话中的临时凭证并用于请求服务。它不会完成官方登录、延长官方令牌的有效期或为账号增加权限。此功能受客户端版本、登录状态和文件访问权限影响。
|
|
36
|
+
|
|
37
|
+
## 用量、诊断与反馈
|
|
38
|
+
|
|
39
|
+
本机用量文件 `usage.json` 默认最多保留 200 条请求元数据,可关闭记录并清空。元数据不包含提示词、回复正文、工具参数、密钥或账号身份,不作为遥测发送给维护者。关闭记录不会自动删除此前记录。
|
|
40
|
+
|
|
41
|
+
复制诊断信息采用字段白名单,省略密钥、账号标识、本机路径、自定义网关和原始错误文本。技术详情、宿主日志、截图和使用者自行粘贴的内容不在这一保证内,分享前仍需检查。
|
|
42
|
+
|
|
43
|
+
本说明只描述本插件,不涵盖宿主、操作系统、上游网关或其他插件的日志、遥测及数据处理。
|
|
44
|
+
|
|
45
|
+
## 其他边界
|
|
46
|
+
|
|
47
|
+
模型健康检查与余额提醒只表示最近一次观测,不是安全审计或费用保证。插件依赖第三方接口,无法保证不中断、无漏洞或适用于特定用途。使用条款与责任边界见 [DISCLAIMER.md](DISCLAIMER.md)。
|
|
@@ -0,0 +1,64 @@
|
|
|
1
|
+
# Third-party notices
|
|
2
|
+
|
|
3
|
+
## dsh-connect-workbuddy (MIT)
|
|
4
|
+
|
|
5
|
+
Parts of this plugin reproduce layout rules and design decisions from
|
|
6
|
+
[dsh-connect-workbuddy](https://github.com/dingminhua/dsh-connect-workbuddy),
|
|
7
|
+
so that the two connector cards read as siblings in the same settings panel.
|
|
8
|
+
|
|
9
|
+
- **Stylesheet** (`client.js`, the `CSS` constant): the card surface, the
|
|
10
|
+
section tab strip, the account table's grid template and row rhythm, the
|
|
11
|
+
switch rows, the model row's two-line layout, and the type scale are that
|
|
12
|
+
project's rules with this plugin's `dca-` class prefix. The comments carried
|
|
13
|
+
across explain *why* each value is what it is.
|
|
14
|
+
- **Structural decisions** mirror it as well: one bulk check-in button rather
|
|
15
|
+
than one per account, account acquisition (add, import, export) in a single
|
|
16
|
+
place, and the platform checkbox themed only with `accent-color` instead of a
|
|
17
|
+
hand-drawn toggle.
|
|
18
|
+
|
|
19
|
+
## dsh-connect-madao (MIT)
|
|
20
|
+
|
|
21
|
+
The credential-borrowing path in `src/credentials.js` — reading the CodeArts
|
|
22
|
+
client's sign-in out of its `state.vscdb` by anchoring on
|
|
23
|
+
`"id":"huawei-cloud-authentication"` and pulling fields from a fixed window past
|
|
24
|
+
it, rather than opening SQLite — is adopted from
|
|
25
|
+
[dsh-connect-madao](https://github.com/XLNC-L/dsh-connect-madao), MIT, Copyright
|
|
26
|
+
(c) 2026 XLNC-L. So are the field spellings (`accessKey`, `secretKey`,
|
|
27
|
+
`securityToken`, `expiresAt`, `originData.account.label`), the candidate path
|
|
28
|
+
list, and the rule that a token with under five minutes left is treated as
|
|
29
|
+
absent rather than used.
|
|
30
|
+
|
|
31
|
+
The reasoning behind it is that project's too: the file is a SQLite database, but
|
|
32
|
+
the credential sits inside it as plain JSON text, and brace-matching from an
|
|
33
|
+
arbitrary `{` in binary surroundings walks into unrelated data — hence a known
|
|
34
|
+
anchor and a fixed window.
|
|
35
|
+
|
|
36
|
+
## Original to this project
|
|
37
|
+
|
|
38
|
+
The protocol implementation, the adapter, the account store, the check-in
|
|
39
|
+
guards, and this plugin's Host half are this project's own work.
|
|
40
|
+
|
|
41
|
+
```
|
|
42
|
+
MIT License
|
|
43
|
+
|
|
44
|
+
Copyright (c) 2026 LaoDing
|
|
45
|
+
Copyright (c) 2026 XLNC-L
|
|
46
|
+
|
|
47
|
+
Permission is hereby granted, free of charge, to any person obtaining a copy
|
|
48
|
+
of this software and associated documentation files (the "Software"), to deal
|
|
49
|
+
in the Software without restriction, including without limitation the rights
|
|
50
|
+
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
|
|
51
|
+
copies of the Software, and to permit persons to whom the Software is
|
|
52
|
+
furnished to do so, subject to the following conditions:
|
|
53
|
+
|
|
54
|
+
The above copyright notice and this permission notice shall be included in all
|
|
55
|
+
copies or substantial portions of the Software.
|
|
56
|
+
|
|
57
|
+
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
|
|
58
|
+
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
|
|
59
|
+
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
|
|
60
|
+
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
|
|
61
|
+
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
|
|
62
|
+
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
|
|
63
|
+
SOFTWARE.
|
|
64
|
+
```
|