Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
18 changes: 10 additions & 8 deletions AGENTS.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,19 +2,20 @@

English · [简体中文](AGENTS_ZH.md)

## Baseline (2026-10-01)
## Baseline (2026-10-02)

- Published **0.3.0**, latest=next=0.3.0 (2026-10-02 audit). PR #6 release point 85fa7d1c4a7e6f7c274d83df242d10c65e319d24 matches npm gitHead, annotated v0.3.0 and public GitHub Release/tgz. Both channel installs passed all thirteen file comparisons, 28 official-service checks each and real Web acceptance. See docs/release-report-0.3.0.md.
- Working repository: `C:/Users/Mashed Potato/Desktop/npm/dsh-git-plugin`. Check the actual checkout; do not edit another worktree inadvertently.
- Published package: **0.2.1**. PR #4 preserved history; release point `084a767aa3055d5cb0e06ddf4fb42dda4156458c` matches npm gitHead, annotated v0.2.1, and public GitHub Release. At the last release audit, latest=next=0.2.1. Channel installs and 28 official-service checks per installed entry passed. See `docs/release-report-0.2.1.md`.
- Previous published package: **0.2.1**. PR #4 preserved history; release point `084a767aa3055d5cb0e06ddf4fb42dda4156458c` matches npm gitHead, annotated v0.2.1, and public GitHub Release. At the last release audit, latest=next=0.2.1. Channel installs and 28 official-service checks per installed entry passed. See `docs/release-report-0.2.1.md`.
- Historical 0.2.0 release point: `c83f3322950b0892022d6b3efd1e4f6edbed5be8`, PR #2. Its package contained five files; do not replace it or move its tag. See `docs/release-report-0.2.0.md`.
- Adaptation commit `8181856` introduced strict TypeScript, DSH 0.2.0-rc.2 compatibility and argv/deadline/hook-directory fixes. Timer correction `922408d` removed unref from deadline/grace timers: Linux Node 20/22 could otherwise drain the event loop before timeout. Keep timers referenced and clear them when done.
- Historical verification: 26 original tests; Windows Node 24.19.0 / Git 2.53.0.windows.2; isolated WSL2 Ubuntu 24.04 Node 20.20.2 / 22.23.3 and Git 2.43.0; clean artifact gate and release-point CI passed. See `docs/validation-report-0.2.0.md`.
- Only **DSH 0.2.0-rc.2** has actual host evidence. Model sessions, other DSH versions remain unverified; Linux Node 22 real services/Web are now verified in the 0.3.0 record. Declared range is not the tested range.
- Market PR #6296 is a separate catalog submission. Its checks passed and it was ready for review at the last audit; do not claim market inclusion without querying the actual catalog. See `docs/marketplace-submission.md`.
- Market PR #6296 is a separate catalog submission. It closed unmerged on 2026-10-01, with no comments explaining the closure. Do not claim market inclusion without querying the actual catalog. See `docs/marketplace-submission.md`.

## Current development

- `feat/web-git-panel` implements the first read-only right-sidebar panel for Issue #1, fixed Host routes and TSX build. It is being released as **0.3.0**; use docs/release-report-0.3.0.md for actual status. Do not overwrite npm 0.2.1 or add GUI writes.
- PR #6 merged the first read-only right-sidebar panel for Issue #1 as **0.3.0**, release point 85fa7d1c4a7e6f7c274d83df242d10c65e319d24. GitHub v0.3.0 is public and its installed entry passed 28 service checks plus real Web acceptance. npm registry availability, installed-package acceptance and latest=next=0.3.0 are confirmed. See docs/release-report-0.3.0.md. Do not overwrite npm 0.2.1 or add GUI writes.
- Source: `src/index.ts`, `src/web-host.ts`, browser-safe `src/panel-types.ts`, `src/client/`. Build Host declarations/JS and generated `lib/client.js`; keep ESM and existing commands/tools.
- English primary documents and `_ZH.md` counterparts: README, CONTRIBUTING, AGENTS; also paired Web usage documents. Synchronize facts, commands and validation boundaries. README stays a short product page; engineering details belong in CONTRIBUTING/docs and maintenance constraints here. Do not add a skill just for a documentation edit.
- Web evidence: `docs/web-panel-validation.md`. Old release CI does not certify a new development SHA.
Expand Down Expand Up @@ -49,17 +50,18 @@ English · [简体中文](AGENTS_ZH.md)

## Roadmap and releases

- The 0.2.1 channels, bundle registration and presentation are complete. Follow the market submission through review and catalog sync, then verify search and actual install spec.
- P2 / Issue #1: read-only status, diff and history; reuse the sidebar carrier, not turn-based workspace-change summaries. That summary excludes pre-existing edits and is not an index/worktree Git source.
- The 0.3.0 dual channels, bundle registration and read-only panel are released. Market PR #6296 closed unmerged and the 2026-10-02 public catalog has zero exact repository matches; investigate separately before claiming search/install availability.
- P2 / Issue #1 is released: read-only status, diff and history; reuse the sidebar carrier, not turn-based workspace-change summaries. That summary excludes pre-existing edits and is not an index/worktree Git source.
- P3: review stage/commit/branch/stash buttons separately. Turn-bound approval is unresolved for clicks outside an open turn; read authentication is not write authorization.
- Stage prompts: `docs/dsh-tasks/README.md` and packages 03–05. Adapt them to actual completed evidence rather than repeating historical instructions. Plan/history documents remain clearly dated.
- Stage prompts: `docs/dsh-tasks/README.md`; 03–05 are complete, 06 has mount-prefix/slow Web cancellation remaining, 07 is write approval/recovery design. Adapt them to actual completed evidence rather than repeating historical instructions. Plan/history documents remain clearly dated.
- A successful publish exit/HTTP 202 is acceptance, not installability. Allow official scanning and registry propagation; check actual availability/gitHead/tarball and installed behavior before latest promotion. A successful dist-tag write also requires a confirming tag read; do not repeat publish to address delays.
- Finalize release date before publish. Version/lock/CHANGELOG/source/types/lib and tag/Release/npm gitHead/artifacts identify one release point. Publish each version once to next, verify, then promote with dist-tag. Changed published content needs a new version.
- AGENTS/docs/team state are engineering resources, not npm runtime files. Pack only closed runtime outputs, bilingual READMEs, license, patch and referenced assets; verify actual file list. Published 0.2.0/0.2.1 contents are immutable.

## Community collaboration

- CONTRIBUTING and bilingual issue/PR templates describe triage, scope, ownership, evidence, review and release. Labels and branch protection are separate settings; do not claim templates enabled them.
- Use `Refs #1` for the read-only first phase; do not close the whole issue merely because a draft/partial UI exists.
- The root screenshots.json currently describes the original capability banner. It is an illustration, not a GUI screenshot. New real screenshots must be labeled as development evidence until released and published; catalog readiness and catalog inclusion are different states.
- Root screenshots.json references the capability illustration and actual released read-only panel screenshots in docs/images. The banner is an illustration; panel images use isolated fixture repositories. Catalog readiness and catalog inclusion are different states.
- Old manual inserts must migrate to id/config overrides when enabling the bundle. DSH 0.2.0-rc.2 does not automatically add a bundle layer when upgrading an old ordinary dependency.
- Preserve the isolated WSL runtimes `~/dsh-node-runtimes/node-v20.20.2-linux-x64` and `node-v22.23.3-linux-x64` unless removal is specifically requested. System Node 18 was not used for the prior matrix.
21 changes: 12 additions & 9 deletions AGENTS_ZH.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,21 +2,22 @@

[English](AGENTS.md) · 简体中文

## 当前基线(2026-10-01)
## 当前基线(2026-10-02)

- 当前包版本 0.2.1;PR #4 已保留历史合并,发布点为 084a767aa3055d5cb0e06ddf4fb42dda4156458c。npm latest=next=0.2.1、annotated tag 与公开 GitHub Release 均已核对该发布点,双渠道独立实装和各 28 项服务栈通过。市场 PR #6296 已转为可审查,上游两个检查通过,尚未收录,详见 docs/release-report-0.2.1.md。
- 当前 **0.3.0 已完成双渠道发布**,latest=next=0.3.0(2026-10-02 核对)。PR #6 发布点 85fa7d1c4a7e6f7c274d83df242d10c65e319d24 与 npm gitHead、annotated v0.3.0、公开 Release/tgz 一致;两个实际安装 spec 均通过十三文件对比、各 28 项官方服务和真实 Web 验收,详见 docs/release-report-0.3.0.md。
- 上一已发布包版本 0.2.1;PR #4 已保留历史合并,发布点为 084a767aa3055d5cb0e06ddf4fb42dda4156458c。npm latest=next=0.2.1、annotated tag 与公开 GitHub Release 均已核对该发布点,双渠道独立实装和各 28 项服务栈通过。市场 PR #6296 已于 2026-10-01 关闭且未合并、无说明评论,不宣称已收录,详见 docs/release-report-0.2.1.md。

- 主工作目录:`C:/Users/Mashed Potato/Desktop/npm/dsh-git-plugin`;先确认所在 checkout,避免把改动写到另一 worktree。
- 适配已提交:`8181856`,包含严格 TypeScript 迁移、DSH 0.2.0-rc.2 适配、Git 参数安全/超时/钩子目录修复、测试与文档。
- 源码为 `src/index.ts`;`npm run build` 生成 `lib/index.js`、`lib/index.d.ts`,构建产物随 Git 提交并用于 npm 安装。保持 ESM 与现有命令/工具行为。
- `0.2.0` 历史发布,CHANGELOG 日期 2026-10-01;PR #2 已以 merge commit 保留历史合并,统一发布点为 `c83f3322950b0892022d6b3efd1e4f6edbed5be8`。远端 annotated tag `v0.2.0`、公开 GitHub Release 与 npm 0.2.0 的 gitHead 均指向它,tarball 与双渠道实装产物一致。当时 npm latest=next=0.2.0,双渠道发布完成(当前标签已推广至 0.2.1);不重复 publish 或移动 tag。证据见 `docs/release-report-0.2.0.md`。
- 已验证:严格类型检查、26 项测试、构建产物一致性,以及 **Linux Node 20.20.2 / 22.23.3 的隔离矩阵**(WSL2 Ubuntu 24.04;修复后 build/check/test 通过;修复候选 922408d 的提交后干净产物门与完整 Linux 矩阵已通过)。仅 DSH `0.2.0-rc.2` 有适配验证记录;服务栈/profile 验证不等于真实模型会话验证。完整证据见 `docs/validation-report-0.2.0.md`。
- 发布点 GitHub Actions Ubuntu Node 20/22 已通过;npm 0.2.0 与固定 GitHub tag 的独立 profile 安装/启用/schema,以及官方 peer 下各 28 项服务栈验证已通过。Linux 完整 DSH 服务栈、真实模型会话及除 `0.2.0-rc.2` 外的 DSH 版本仍待验证;允许范围不等于实测范围。
- 发布点 GitHub Actions Ubuntu Node 20/22 已通过;npm 0.2.0 与固定 GitHub tag 的独立 profile 安装/启用/schema,以及官方 peer 下各 28 项服务栈验证已通过。Linux Node 22 的完整 DSH 服务栈与真实 Web 已在 0.3.0 验收中补齐;真实模型会话及除 `0.2.0-rc.2` 外的 DSH 版本仍待验证;允许范围不等于实测范围。
- 包 01 复查发现并修复了一个真实缺陷:截止时间/宽限定时器曾被 `unref`,在被等待的 promise 只由该定时器推进时超时会被跳过(Linux 上稳定复现)。修复和重建的 `lib/`、验证脚本加固已提交为 `922408d`;该 SHA 的 Linux Node 20/22 干净检出产物门与完整矩阵已通过。

## 当前开发任务

- `feat/web-git-panel` 已实现 Issue #1 的首版只读右侧面板、Host 路由和 TSX 构建;正在发布为 0.3.0,实际状态以 docs/release-report-0.3.0.md 为准;不覆盖 npm 0.2.1,不混入 GUI 写操作。
- PR #6 已保留历史合并 Issue #1 首版只读面板为 0.3.0,发布点 85fa7d1c4a7e6f7c274d83df242d10c65e319d24;GitHub v0.3.0 已公开,固定 tag 实装的 28 项服务及真实 Web 通过。npm 注册表可见、正式实装及 latest=next=0.3.0 已确认;实际状态见 docs/release-report-0.3.0.md;不覆盖 npm 0.2.1,不混入 GUI 写操作。
- README / CONTRIBUTING / AGENTS 采用英文主文档和 `_ZH.md` 中文对应页;面板使用文档同样配对,修改时同步事实、命令和验收边界。
- 新 Web 证据见 `docs/web-panel-validation.md`;不能将旧发布点的 CI 当作本分支 CI。
- 当前源码为 src/index.ts、src/web-host.ts、src/panel-types.ts 和 src/client/;客户端通过小型构建生成官方 loader 包装,复用宿主 React,不手改 lib/client.js、不捆绑第二份 React。
Expand Down Expand Up @@ -54,21 +55,23 @@
- `AGENTS.md`、`docs/`、`.agent-teams/` 不进入 npm files;已发布 0.2.1 实际为 7 文件;当前开发包增加 Web 产物及 README_ZH,按实际 pack 文件表核验。原 0.2.0 发布包仍为 5 文件,不可覆盖;缓存与独立测试目录保持忽略。
- 本地 commit 已获持续授权:每个任务或可审阅阶段完成验证后,立即执行 commit,不再请求用户认可。合并、推送、打 tag、发布及社区消息仍按各自授权执行;已有授权不重复询问。结束报告提交 SHA、文件与原因、验证结果、未验证项和工作区状态。

## README 与市场安装(0.2.1 已发布)
## README 与市场安装(0.3.0 已发布)

- README 保持简洁的产品首页:用途、能力、最短安装步骤、使用示例与文档入口。配置细节、源码安装、架构、测试和发布流程放 CONTRIBUTING.md / docs;代理维护约束放 AGENTS.md。无需为一次文档调整新增 skill。
- 精简时保留已发布版本的真实启用方式、提交全部改动和 stash 的含义,以及实际验证宿主版本;不将开发中 bundle、未实现 GUI 或市场草稿描述为已经发布/收录。

- README 与 bundle 自动注册已进入 main,用户已授权全部上线步骤;npm latest=next=0.2.1,GitHub Release 已公开,双渠道验证通过。市场 PR #6296 尚待审查/合并,不宣称已收录;不能重发 0.2.0 / 0.2.1。
- 市场图片声明在根 screenshots.json,指向原创能力横幅;横幅仍是能力示意图,不得将其当作功能截图;docs/images/git-panel.png 为开发版真实 Web 验收截图。该声明由目录读取 GitHub,无需进入 npm files。
- README、bundle 自动注册和只读 Web 面板已进入 main,0.3.0 的 npm latest=next=0.3.0,GitHub Release/tgz 已公开,双渠道验证通过。市场 PR #6296 已关闭且未合并,2026-10-02 实际目录精确匹配为 0,不宣称已收录;不能重发 0.2.0 / 0.2.1。
- 根 screenshots.json 包含能力示意横幅及 docs/images 下已发布的真实只读面板截图;图片来自独立测试仓库,不将横幅当作 GUI 截图。该声明由目录读取 GitHub,无需进入 npm files。
- 市场来源是 `awesome-dsh-plugin/awesome-dsh-plugin`;条目、验证和旧 profile 迁移见 `docs/marketplace-submission.md`。老 insert 与新 bundle 同时启用会出现两个插件行,必须迁移为按 id 覆盖;DSH 0.2.0-rc.2 对旧依赖升级不自动补 bundle 层。

## 后续任务入口(2026-10-01 核查)

- 任务分包见 [docs/dsh-tasks/README.md](docs/dsh-tasks/README.md):验证补齐 → 发布 → Web Host → TSX UI → 真实 Web 验收;逐包完成与交接,不一次混做。
- 原候选 feba7b8,定时器修复 922408d,发布点 c83f332;PR/main 当前 SHA CI 均通过,协作文档与模板已进入默认分支。包 02 的 npm、GitHub、latest 推广与双渠道安装均完成;随后按 03–05 实施只读 Web,另开功能分支。
- 任务分包见 [docs/dsh-tasks/README.md](docs/dsh-tasks/README.md):03–05 已完成并发布;06 仅余挂载前缀/真实慢 Web 请求取消,07 先设计 GUI 写操作审批和恢复;逐包推进。
- 原候选 feba7b8,定时器修复 922408d,发布点 c83f332;PR/main 当前 SHA CI 均通过,协作文档与模板已进入默认分支。包 02 的 npm、GitHub、latest 推广与双渠道安装均完成;随后 03–05 的只读 Web 已实现为 0.3.0,继续 06/07 的剩余项目。
- Linux Node 20/22 已用**隔离运行时**(WSL2 Ubuntu 24.04,`~/dsh-node-runtimes/node-v20.20.2-linux-x64`、`node-v22.23.3-linux-x64`)完成修复后 build/check/test 复验;修复候选 922408d 的 npm ci/build/产物门/check/语法/test/pack 全部通过。系统 Node 18.19.1 未用于验证。证据见 `docs/validation-report-0.2.0.md`。未推送 SHA 的干净检出从本地主仓库克隆。

- publish exit 0 / HTTP 202 只表示上传被接受;等待官方扫描及注册表传播后,核对真实可用、gitHead/tarball 并实际安装,通过后才推广 latest。dist-tag 写入成功也需实际标签读取确认,延迟不重复 publish。

## 自动本地提交与收尾

- 每个任务或可审阅阶段完成后,运行相关验证,显式 git add 本任务文件,检查 git diff --cached --check 与暂存差异,执行规范中文 commit;不能只给出 commit 建议或等待用户认可。
Expand Down
2 changes: 2 additions & 0 deletions docs/dsh-tasks/06-web-edge-acceptance.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,6 +2,8 @@

Execute this package after reading AGENTS and [current evidence](../web-panel-validation.md). 先阅读维护指引与当前验收记录,然后执行。

> Status / 状态(2026-10-01):Linux real Web, edge repositories, dark/narrow layouts and installed GitHub channel have passed. Do not repeat completed checks; focus on mount-prefix hosting and actual slow Web navigation/process termination. / Linux 真 Web、边缘仓库、暗色窄屏与 GitHub 实装已通过,本包后续只聚焦前缀及真实慢 Web 请求切换/子进程终止。See [release record](../release-report-0.3.0.md).

Owner / 执行:DSH. Goal / 目标:close remaining browser/platform checks without expanding GUI writes or repeating historical release work. 补真实浏览器与平台证据,不扩大到写操作、不重做旧发布。

1. Audit branch/status/SHA and preserve existing changes. Read the local Harness checkout only; use exact DSH 0.2.0-rc.2. / 先审状态和基线,只读上游,固定宿主版本。
Expand Down
2 changes: 1 addition & 1 deletion docs/dsh-tasks/README.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
# DSH 后续任务包

> Current handoff / 当前交接(2026-10-01):0.2.1 已发布;包 03/04 的只读 Host 与 TSX 面板已实现,包 05 已完成 Windows 真实 Web 主要流程。剩余逐项验证见 [验收记录](../web-panel-validation.md),不要重复执行历史发布任务。English/中文使用见 [Web guide](../web-panel.md) / [中文指南](../web-panel_ZH.md)。
> Current handoff / 当前交接(2026-10-02):0.3.0 只读面板已通过 PR #6 合并并完成 npm/GitHub 双渠道发布,latest=next=0.3.0,正式实装/服务/Web 验收通过;包 03–05 完成,Linux 真实 Web、暗色窄屏及边缘仓库验收已补齐。包 06 仅余挂载前缀及真实慢 Web 请求取消;包 07 先做 GUI 写操作审批/恢复设计。当前发布状态见 [0.3.0 记录](../release-report-0.3.0.md),剩余逐项验证见 [验收记录](../web-panel-validation.md),不要重复执行历史发布任务。English/中文使用见 [Web guide](../web-panel.md) / [中文指南](../web-panel_ZH.md)。

核查日期:2026-10-01。主仓库:`C:/Users/Mashed Potato/Desktop/npm/dsh-git-plugin`。
基线:`feat/release-0.2.0` @ `feba7b80b0942a7a5733511ac0b9cf918ef8d2a8`。
Expand Down
Loading
Loading