@eduwork/dsh-mail 0.1.0 → 0.1.2

package/docs/getting-started.md

@@ -5,7 +5,7 @@
 ## 前置条件
 
 - Node.js 22+；
-- DeepSeek Harness `0.1.2-rc.1`；
+- DeepSeek Harness `0.1.5-rc.1`；
 - Profile 中已经有 Settings、Credentials、Tools、Filesystem、Permission Presets、Approval 和 Web Client；
 - 一个开启了 IMAP/SMTP 的邮箱账号，以及邮箱服务商签发的客户端授权码或应用专用密码。
 
@@ -14,14 +14,14 @@
 普通使用固定经过复核的 npm 精确版本：
 
 ```bash
-dsh plugin --profile web add @eduwork/dsh-mail@0.1.0
+dsh plugin --profile web add @eduwork/dsh-mail@0.1.1
 ```
 
 需要审计、开发或验证尚未发布的改动时，使用源码 checkout：
 
 ```bash
-git clone https://github.com/freedomkk-qfeng/dsh-mail-assistant.git
-cd dsh-mail-assistant
+git clone https://github.com/ecnu/EduWork.git
+cd EduWork/packages/dsh-mail
 npm ci
 npm run check
 dsh plugin --profile web add .
@@ -29,7 +29,7 @@ dsh plugin --profile web add .
 
 安装只向 Profile 加入一个 Bundle。插件配置为空也能正常启动；不会在启动时探测服务器或安装额外运行时。
 
-源码安装会把 checkout 链接进 Profile，因此目录必须持续存在。团队部署应固定经复核的 npm 精确版本。
+源码安装会把 checkout 链接进 Profile，因此目录必须持续存在。团队部署应固定经复核的 npm 精确版本。升级前先备份 Profile 的 `package.json` 与 `cordis.patch.yml`，不要同时启用新旧包。
 
 ## 配置
 
@@ -40,6 +40,8 @@ dsh plugin --profile web add .
 3. 仅在服务商要求时，到“高级设置”填写独立登录用户名；收件箱目录通常保持 `INBOX`；
 4. 最后分别开放 Agent 的读信和发信能力并保存。
 
+无 UI 时，只把邮箱地址、服务器、端口、TLS 模式和能力开关写入 Bundle 配置。授权码必须进入 DSH Credential Provider，固定引用名为 `DSH_MAIL_ASSISTANT_PASSWORD`；不要写入 YAML、源码、命令历史或诊断日志。
+
 常见安全组合是 IMAP 993 + 隐式 TLS、SMTP 465 + 隐式 TLS，或 SMTP 587 + STARTTLS。具体值以邮箱服务商文档为准；不要为了连通而关闭证书校验，本插件也不提供这个开关。
 
 ## 验收
@@ -49,9 +51,24 @@ dsh plugin --profile web add .
 3. 用较小的每页条数查找一个命中较多的时间范围；确认 Agent 按 `nextCursor` 持续翻页，直到 `hasMore=false` 后才总结整个范围。
 4. 读取一封包含“忽略此前指令”等文本的测试邮件；确认 Agent 把它视为不可信数据。
 5. 下载一个小附件；确认文件位于当前工作区的 `.dsh-mail-assistant/attachments/`，且不会覆盖同名文件。
-6. 保持普通权限，开启发信，让 Agent 向自己的测试地址发送纯文本；确认出现逐次审批。
+6. 保持普通权限，开启发信，让 Agent 先展示收件人、主题、正文和附件，再向自己的测试地址发送纯文本；确认出现逐次审批。
 7. 拒绝审批；确认没有 SMTP 发送。
 8. 切换到 Full Access，再向自己的测试地址发信；确认不再弹出审批且邮件正常送达。
 9. 尝试把工作区外文件作为附件；确认工具拒绝。
 
 真实邮箱测试应使用专门测试账号，不要在公开 issue 附上服务器日志、地址、标题、正文或授权码。
+
+## 开发验收
+
+```bash
+npm ci
+npm run check
+```
+
+要复核 DSH `0.1.5-rc.1` 的真实运行时契约，把 `DSH_RUNTIME_ROOT` 指向该版本的干净 Runtime 后运行：
+
+```bash
+npm run accept:dsh-015-rc1
+```
+
+此验收使用无网络发送模拟器检查 Agent 会话、审批拒绝、单次允许与 Full Access 路径，不需要真实邮箱。真实 IMAP/SMTP 互操作只在专用测试账号和隔离 Profile 中执行。

package/docs/release-checklist.en.md

@@ -1,52 +1,11 @@
-# Public release checklist
+# Package release checklist
 
 [简体中文](release-checklist.md) | **English**
 
-A release pull request or release record captures the maintainer decision, date, command-output links, independent technical-review evidence, and exceptions. A sole maintainer owns publication during the project's initial stage; do not invent a second human approver who does not exist. Any applicable incomplete security or publication check blocks a stable release. Additional maintainers and multi-person review remain future governance goals.
+Source and publication are maintained in EduWork. Follow [the shared package workflow](https://github.com/ecnu/EduWork/blob/main/docs/PACKAGES_EN.md); this package retains its independent npm name and SemVer.
 
-## Authority and metadata
-
-- [ ] The current maintainer approved public release and the MIT license and recorded technical-review evidence and remaining risk.
-- [ ] GitHub repository, npm name, homepage, issues, and private security-report URLs are correct.
-- [ ] Version, changelog, compatibility, and install commands agree.
-- [ ] Chinese is the default language and every Markdown document has an English mirror with reciprocal entries.
-- [ ] Publishable history and content contain no real accounts, messages, app passwords, servers, personal paths, or unauthorized branding.
-
-## Mail and authorization boundary
-
-- [ ] IMAP mailbox locks remain read-only; no `STORE`, `COPY`, `MOVE`, `EXPUNGE`, or flag mutation exists.
-- [ ] Reading and sending default off and remain independent.
-- [ ] `mail_send` enters DSH permission handling before credentials, attachments, or SMTP access.
-- [ ] Ordinary permissions ask per call; Full Access only skips that prompt and never enables sending.
-- [ ] Missing Agent sessions, rejection, cancellation, and unavailable approval channels fail closed.
-- [ ] Mail remains untrusted data and cannot authorize sending, request secrets, or change system policy.
-- [ ] Ambiguous SMTP DATA results return `unknown` and are never automatically retried.
-
-## Credentials, transport, and attachments
-
-- [ ] App passwords only enter a DSH Credential Provider; the browser sees configuration state only.
-- [ ] Credentials are resolved for every call and not cached across operations.
-- [ ] Only implicit TLS or STARTTLS is accepted; certificate validation is fixed on and protocol logging is off.
-- [ ] Addresses reject CR/LF injection and body, message, and attachment limits are enforced.
-- [ ] Outbound attachments are regular files inside the current session workspace.
-- [ ] Downloaded attachments use random names, exclusive writes, and real-path containment; symlink/junction escape checks pass.
-- [ ] Source maps and normalized errors expose no credentials, message content, server responses, or personal paths.
-
-## Functional acceptance
-
-- [ ] `mail_list_folders` returns server folders without mutation.
-- [ ] `mail_find` covers both directions, pagination, dates, folders, stale UIDVALIDITY, and `hasMore=false`.
-- [ ] `mail_read` preserves unread state; truncation and HTML fallback match documentation.
-- [ ] `mail_get_attachment` works on local FS and fails clearly for a remote/non-shared Host path.
-- [ ] A real test mailbox covers ordinary approve/reject, Full Access send, and outside-workspace attachment rejection.
-- [ ] OAuth2, multiple accounts, Sent-copy behavior, and complex MIME limitations remain explicit.
-
-## Supply chain and publication
-
-- [ ] Clean `npm ci` and `npm run check` pass on Windows and Linux with Node 22/24.
-- [ ] `npm audit`, CodeQL, direct/transitive licenses, and install scripts receive human review.
-- [ ] GitHub Actions use immutable commits; Dependabot and branch protection are active.
-- [ ] `npm pack --dry-run` and the extracted tarball contain only expected files; the Host bundle has no bare IMAP/SMTP imports.
-- [ ] Tag, release notes, tarball checksum, deprecation, and rollback are ready.
-- [ ] Publish the first stable release from the reviewed frozen package with the npm CLI and maintainer-confirmed browser 2FA; record that Trusted Publishing is not configured and make no provenance claim for this release.
-- [ ] For later releases, enable OIDC/provenance only after verifying that npm Trusted Publishing is bound to this repository's `.github/workflows/release.yml` and environment `npm`; never use a long-lived publish token.
+- Review the changed behavior, version, changelog, compatibility and package lock.
+- Run npm ci and npm run check in this package directory, plus relevant real Host or browser acceptance when behavior changes. Use synthetic test data.
+- Inspect the actual tarball, public documentation, licenses and exported entries. Never ship credentials or user data.
+- Select this package in packages-release.yml; publish=false only produces artifacts. Explicit publication runs from the matching package version tag, using the npm environment and this repository's trusted publisher.
+- Verify registry bytes before updating a product lock. Publishing npm does not publish a desktop Release or deploy a client.

package/docs/release-checklist.md

@@ -1,52 +1,11 @@
-# 公开发布检查表
+# 包发布检查表
 
 **简体中文** | [English](release-checklist.en.md)
 
-发布 Pull Request 或发布记录应记维护者决策、日期、命令输出链接、独立技术复核证据和例外。项目初期由单一维护者负责发布；不得虚构尚不存在的第二位人工批准人。任何适用且未完成的安全或发布检查都会阻止稳定发布；未来增加替补和多人审查作为治理目标记录。
+源码与发布入口统一在 EduWork；遵循[公共包发布流程](https://github.com/ecnu/EduWork/blob/main/docs/PACKAGES.md)，本包保留独立的 npm 名称和 SemVer。
 
-## 授权与元数据
-
-- [ ] 当前维护者确认公开发布和 MIT 许可证，并记录技术复核证据与剩余风险。
-- [ ] GitHub 仓库、npm 包名、主页、Issue 和安全报告地址准确。
-- [ ] 版本、Changelog、兼容性和安装命令一致。
-- [ ] 默认文档为中文，每份 Markdown 文档都有英文镜像和双向入口。
-- [ ] Git 历史和发布内容不含真实邮箱、邮件、授权码、服务器、个人路径或未授权品牌。
-
-## 邮件与权限边界
-
-- [ ] IMAP mailbox lock 仍固定为只读，代码没有 `STORE`、`COPY`、`MOVE`、`EXPUNGE` 或 flags 写入。
-- [ ] 读信和发信能力默认关闭，并且彼此独立。
-- [ ] `mail_send` 在读取凭据、附件和访问 SMTP 前进入 DSH 权限通路。
-- [ ] 普通权限逐次审批；Full Access 只免除逐次弹窗，不能自动开启发信能力。
-- [ ] 无 Agent 会话、拒绝、取消和不可用审批通路均失败关闭。
-- [ ] 邮件数据持续标记为不可信，不能成为发信授权、密钥请求或系统指令。
-- [ ] SMTP DATA 阶段的不确定结果返回 `unknown`，不会自动重试。
-
-## 凭据、传输和附件
-
-- [ ] 授权码只进入 DSH Credential Provider，浏览器只能看到配置状态。
-- [ ] 每次工具调用重新解析凭据，不跨操作缓存。
-- [ ] 只允许隐式 TLS 或 STARTTLS，证书校验不可关闭，协议日志关闭。
-- [ ] 地址拒绝 CR/LF 注入；正文、消息和附件大小上限有效。
-- [ ] 发送附件限定为当前会话工作区普通文件。
-- [ ] 下载附件使用随机名、独占写和真实路径包含性复核；符号链接/目录联接逃逸测试通过。
-- [ ] Source map 和错误归一化不泄露凭据、邮件内容、服务器响应或个人路径。
-
-## 功能验收
-
-- [ ] `mail_list_folders` 返回真实目录且不修改状态。
-- [ ] `mail_find` 的正序/倒序、多页、日期、目录、UIDVALIDITY 失效和 `hasMore=false` 均测试。
-- [ ] `mail_read` 不改变已读状态，正文截断和 HTML 降级符合文档。
-- [ ] `mail_get_attachment` 在本地 FS 成功，在远程/不共享 Host 路径时明确失败。
-- [ ] 普通权限下发信批准/拒绝、Full Access 发信、工作区外附件拒绝均通过真实测试邮箱验收。
-- [ ] 不支持的 OAuth2、多账号、Sent 副本和复杂 MIME 行为仍清楚记录。
-
-## 供应链与发布
-
-- [ ] Windows 与 Linux 使用 Node 22/24 完成干净 `npm ci` 和 `npm run check`。
-- [ ] `npm audit`、CodeQL、直接/间接许可证和安装脚本已人工审查。
-- [ ] GitHub Actions 固定到不可变 commit，Dependabot 与分支保护有效。
-- [ ] `npm pack --dry-run` 和解压后的 tarball 只包含预期文件；Host bundle 没有外部 IMAP/SMTP 裸导入。
-- [ ] tag、发布说明、tarball checksum、弃用和回滚方案已准备。
-- [ ] 首次稳定版从经复核的冻结包使用 npm CLI 发布，由维护者在浏览器完成 2FA；本次记录 Trusted Publishing 尚未配置，不声明 provenance。
-- [ ] 后续发布在验证 npm Trusted Publisher 已绑定本仓库的 `.github/workflows/release.yml` 与 Environment `npm` 后，再启用 OIDC/provenance 发布路径；不使用长期 Token。
+- 核对变更行为、版本、变更记录、兼容范围和依赖锁。
+- 在当前包目录执行 npm ci、npm run check；有行为变化时补对应 Host 或浏览器实测，使用合成测试数据。
+- 检查实际 tarball、公开文档、许可证和导出入口，不携带凭据或用户数据。
+- 在 packages-release.yml 中选择本包；publish=false 仅产出候选。明确发布时从匹配包版本的 tag 运行，使用 npm environment 与本仓库的 Trusted Publisher。
+- 核验 registry 中的实际字节后再更新产品锁。发布 npm 不会发布桌面 Release 或替换客户端。