page-harness 0.1.4 → 0.1.5

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/README.md CHANGED
@@ -1,6 +1,5 @@
1
- <!-- TODO(Tencent OSS): swap in the Tencent open-source hero banner (en / zh) once brand guidelines are confirmed. No marketing copy in the image. -->
2
1
  <p align="center">
3
- <img src="./docs/logo.svg" width="72" alt="page-harness logo">
2
+ <img src="https://unpkg.com/page-harness@0.1.5/docs/logo.svg" width="72" alt="page-harness logo">
4
3
  </p>
5
4
 
6
5
  <h1 align="center">page-harness</h1>
@@ -9,11 +8,6 @@
9
8
  <a href="https://www.npmjs.com/package/page-harness"><img alt="npm page-harness" src="https://img.shields.io/npm/v/page-harness?label=npm&labelColor=16161A&color=7C5CFF&style=flat-square"></a>
10
9
  <a href="./LICENSE"><img alt="License" src="https://img.shields.io/badge/license-MIT-7C5CFF?labelColor=16161A&color=7C5CFF&style=flat-square"></a>
11
10
  <img alt="Node" src="https://img.shields.io/badge/node-%E2%89%A520.11-7C5CFF?labelColor=16161A&color=7C5CFF&style=flat-square">
12
- <!-- TODO(Tencent OSS): enable the line below (Release / Stars / CI) once the repo URL is final; replace TODO/page-harness. -->
13
- <!-- <a href="https://github.com/TODO/page-harness/releases"><img alt="Release" src="https://img.shields.io/github/v/release/TODO/page-harness?labelColor=16161A&color=7C5CFF&style=flat-square"></a>
14
- <a href="https://github.com/TODO/page-harness/stargazers"><img alt="Stars" src="https://img.shields.io/github/stars/TODO/page-harness?labelColor=16161A&color=7C5CFF&style=flat-square"></a>
15
- <br/>
16
- <a href="https://github.com/TODO/page-harness/actions/workflows/ci.yml"><img alt="ci" src="https://img.shields.io/github/actions/workflow/status/TODO/page-harness/ci.yml?branch=main&label=ci&labelColor=16161A&style=flat-square"></a> -->
17
11
  </p>
18
12
 
19
13
  <p align="center">
@@ -31,17 +25,13 @@
31
25
  </p>
32
26
 
33
27
  <p align="center">
34
- <a href="docs/hero.mp4?raw=true">
35
- <img src="./docs/hero.webp" width="720" alt="page-harness promo video (0:30)">
36
- </a>
28
+ <img src="https://unpkg.com/page-harness@0.1.5/docs/hero.webp" width="720" alt="page-harness promo video (0:30)">
37
29
  </p>
38
30
 
39
- <p align="center"><sub>0:30 · 1080p · click to open the mp4 (with sound)</sub></p>
31
+ <p align="center"><sub>0:30 · 1080p</sub></p>
40
32
 
41
33
  ## Overview
42
34
 
43
- > **TODO (Tencent OSS):** Tencent logo, attribution line and compliance notes are pending confirmation. Repo URL is a placeholder: `https://github.com/TODO/page-harness`.
44
-
45
35
  **Turn any running web page into a workspace for your coding agent.**
46
36
 
47
37
  Click the thing you want changed and tell your agent what to do, right on the page: Pick, Chat and Artifacts, driven by the agent CLI already on your machine (Claude Code, Codex, Cursor Agent, CodeBuddy Code, OpenCode). For feedback only, `--no-agent` keeps just Pick and Notes; run it with no URL and you get a home page with a **✦ Page-Harness** bookmarklet that works on any site.
@@ -86,25 +76,25 @@ Open **http://127.0.0.1:17990**. That is your app as usual, plus a dock in the b
86
76
 
87
77
  **Pick and Notes, nothing else.** With `--no-agent` no agent CLI is started. Pick an element, leave a comment or an edit, reply, resolve and approve per page. [Details →](#review-only---no-agent)
88
78
 
89
- <p align="center"><img src="./docs/review-only.png" width="720" alt="Page notes panel in review-only mode"></p>
79
+ <p align="center"><img src="https://unpkg.com/page-harness@0.1.5/docs/review-only.png" width="720" alt="Page notes panel in review-only mode"></p>
90
80
 
91
81
  ### Bookmarklet home
92
82
 
93
83
  **One button to drag.** Run `npx page-harness` with no URL and the home page has a single **✦ Page-Harness** button. Drag it to the bookmarks bar. [Details →](#bookmarklet-no-url)
94
84
 
95
- <p align="center"><img src="./docs/home.png" width="520" alt="Home page with the ✦ Page-Harness button"></p>
85
+ <p align="center"><img src="https://unpkg.com/page-harness@0.1.5/docs/home.png" width="520" alt="Home page with the ✦ Page-Harness button"></p>
96
86
 
97
87
  ### Notes on any site
98
88
 
99
89
  **Click the bookmark on any page.** The dock is injected into that page in a Shadow DOM, with no proxy, and notes are saved to your local server, grouped by site.
100
90
 
101
- <p align="center"><img src="./docs/bookmarklet.png" width="720" alt="Bookmarklet dock on a plain page"></p>
91
+ <p align="center"><img src="https://unpkg.com/page-harness@0.1.5/docs/bookmarklet.png" width="720" alt="Bookmarklet dock on a plain page"></p>
102
92
 
103
93
  ### My notes
104
94
 
105
95
  **Every site's notes in one place.** Sites on the left, that site's notes on the right, with Export Markdown, Export JSON and Copy prompt for your agent.
106
96
 
107
- <p align="center"><img src="./docs/home-notes.png" width="720" alt="My notes view"></p>
97
+ <p align="center"><img src="https://unpkg.com/page-harness@0.1.5/docs/home-notes.png" width="720" alt="My notes view"></p>
108
98
 
109
99
  ## How it works
110
100
 
@@ -355,16 +345,12 @@ npm run build && npm run test:e2e # browser tests against a fixture app
355
345
 
356
346
  ## Contributing
357
347
 
358
- Issues and pull requests are welcome at `https://github.com/TODO/page-harness` (placeholder until the public repo URL is final).
348
+ Issues and pull requests are welcome at [Tencent/page-harness](https://github.com/Tencent/page-harness).
359
349
 
360
350
  - **Process:** Fork → create a branch → commit → open a PR
361
351
  - **Before you push:** `npm run lint`, `npm run typecheck` and `npm test`; for UI changes also `npm run build && npm run test:e2e`
362
352
 
363
- <!-- TODO(Tencent OSS): contributors image once the repo URL is final:
364
- [![Contributors](https://contrib.rocks/image?repo=TODO/page-harness)](https://github.com/TODO/page-harness/graphs/contributors) -->
365
-
366
353
  ## License
367
354
 
368
355
  [MIT](./LICENSE). Bundled third-party code is listed in [THIRD_PARTY_LICENSES.md](./THIRD_PARTY_LICENSES.md).
369
356
 
370
- <!-- TODO(Tencent OSS): copyright holder / Tencent attribution and any required compliance or security-contact section go here. -->
package/README.zh-CN.md CHANGED
@@ -1,6 +1,5 @@
1
- <!-- TODO(腾讯开源):品牌规范定了以后,这里换成腾讯开源横幅(中英各一张),图里不放营销文案。 -->
2
1
  <p align="center">
3
- <img src="./docs/logo.svg" width="72" alt="page-harness logo">
2
+ <img src="https://unpkg.com/page-harness@0.1.5/docs/logo.svg" width="72" alt="page-harness logo">
4
3
  </p>
5
4
 
6
5
  <h1 align="center">page-harness</h1>
@@ -9,11 +8,6 @@
9
8
  <a href="https://www.npmjs.com/package/page-harness"><img alt="npm page-harness" src="https://img.shields.io/npm/v/page-harness?label=npm&labelColor=16161A&color=7C5CFF&style=flat-square"></a>
10
9
  <a href="./LICENSE"><img alt="License" src="https://img.shields.io/badge/license-MIT-7C5CFF?labelColor=16161A&color=7C5CFF&style=flat-square"></a>
11
10
  <img alt="Node" src="https://img.shields.io/badge/node-%E2%89%A520.11-7C5CFF?labelColor=16161A&color=7C5CFF&style=flat-square">
12
- <!-- TODO(腾讯开源):仓库地址定了以后打开下面这行(Release / Stars / CI),把 TODO/page-harness 换掉。 -->
13
- <!-- <a href="https://github.com/TODO/page-harness/releases"><img alt="Release" src="https://img.shields.io/github/v/release/TODO/page-harness?labelColor=16161A&color=7C5CFF&style=flat-square"></a>
14
- <a href="https://github.com/TODO/page-harness/stargazers"><img alt="Stars" src="https://img.shields.io/github/stars/TODO/page-harness?labelColor=16161A&color=7C5CFF&style=flat-square"></a>
15
- <br/>
16
- <a href="https://github.com/TODO/page-harness/actions/workflows/ci.yml"><img alt="ci" src="https://img.shields.io/github/actions/workflow/status/TODO/page-harness/ci.yml?branch=main&label=ci&labelColor=16161A&style=flat-square"></a> -->
17
11
  </p>
18
12
 
19
13
  <p align="center">
@@ -31,17 +25,13 @@
31
25
  </p>
32
26
 
33
27
  <p align="center">
34
- <a href="docs/hero-zh.mp4?raw=true">
35
- <img src="./docs/hero-zh.webp" width="720" alt="page-harness 宣传视频(36 秒)">
36
- </a>
28
+ <img src="https://unpkg.com/page-harness@0.1.5/docs/hero-zh.webp" width="720" alt="page-harness 宣传视频(36 秒)">
37
29
  </p>
38
30
 
39
- <p align="center"><sub>36 秒 · 1080p · 点击打开 mp4(有声音)</sub></p>
31
+ <p align="center"><sub>36 秒 · 1080p</sub></p>
40
32
 
41
33
  ## 概览
42
34
 
43
- > **TODO(腾讯开源):** 腾讯 logo、署名和合规说明待确认;仓库地址暂用占位 `https://github.com/TODO/page-harness`。
44
-
45
35
  **把正在跑的网页,直接变成编码 Agent 的工作台。**
46
36
 
47
37
  在页面上点一下要改的地方,就能跟 Agent 说怎么改:取点、聊天、看产物,背后用的就是你电脑上已经装好的 Agent CLI(Claude Code、Codex、Cursor Agent、CodeBuddy Code、OpenCode)。只想收集意见的话,`--no-agent` 只留取点和意见;不给地址直接跑,会打开一个书签主页,把 **✦ Page-Harness** 拖到书签栏,任何网页都能标。
@@ -86,25 +76,25 @@ npx page-harness # 不给地址:打开书
86
76
 
87
77
  **只有取点和意见。** 加 `--no-agent` 就不启动 Agent CLI。点元素留评论或者直接改,回复、解决、按页面审批都行。[详细 →](#仅评审--no-agent)
88
78
 
89
- <p align="center"><img src="./docs/review-only-zh.png" width="720" alt="仅评审模式下的页面意见面板"></p>
79
+ <p align="center"><img src="https://unpkg.com/page-harness@0.1.5/docs/review-only-zh.png" width="720" alt="仅评审模式下的页面意见面板"></p>
90
80
 
91
81
  ### 书签主页
92
82
 
93
83
  **就一个按钮,拖走就行。** 不给地址直接跑 `npx page-harness`,主页上只有一个 **✦ Page-Harness** 按钮,拖到书签栏。[详细 →](#书签不给地址)
94
84
 
95
- <p align="center"><img src="./docs/home-zh.png" width="520" alt="主页上的 ✦ Page-Harness 按钮"></p>
85
+ <p align="center"><img src="https://unpkg.com/page-harness@0.1.5/docs/home-zh.png" width="520" alt="主页上的 ✦ Page-Harness 按钮"></p>
96
86
 
97
87
  ### 任意网站留意见
98
88
 
99
89
  **打开哪个网页都能点。** 底栏直接注入到当前页面(放在 Shadow DOM 里,不走代理),意见存到本机服务,按网站分好。
100
90
 
101
- <p align="center"><img src="./docs/bookmarklet-zh.png" width="720" alt="书签注入到普通页面上的底栏"></p>
91
+ <p align="center"><img src="https://unpkg.com/page-harness@0.1.5/docs/bookmarklet-zh.png" width="720" alt="书签注入到普通页面上的底栏"></p>
102
92
 
103
93
  ### 我的标记
104
94
 
105
95
  **所有网站的意见都在这。** 左边网站,右边这个网站的意见,可以导出 Markdown、导出 JSON,或者复制 Prompt 丢给 Agent。
106
96
 
107
- <p align="center"><img src="./docs/home-notes-zh.png" width="720" alt="我的标记页"></p>
97
+ <p align="center"><img src="https://unpkg.com/page-harness@0.1.5/docs/home-notes-zh.png" width="720" alt="我的标记页"></p>
108
98
 
109
99
  ## 原理
110
100
 
@@ -355,16 +345,12 @@ npm run build && npm run test:e2e # 基于示例应用的浏览器测试
355
345
 
356
346
  ## 参与贡献
357
347
 
358
- 欢迎到 `https://github.com/TODO/page-harness`(仓库地址定了再换)提 Issue 和 PR。
348
+ 欢迎到 [Tencent/page-harness](https://github.com/Tencent/page-harness) 提 Issue 和 PR。
359
349
 
360
350
  - **流程:** Fork → 开分支 → 提交 → 开 PR
361
351
  - **推之前跑一下:** `npm run lint`、`npm run typecheck`、`npm test`;动了界面的话再跑 `npm run build && npm run test:e2e`
362
352
 
363
- <!-- TODO(腾讯开源):仓库地址定了以后放贡献者头像:
364
- [![Contributors](https://contrib.rocks/image?repo=TODO/page-harness)](https://github.com/TODO/page-harness/graphs/contributors) -->
365
-
366
353
  ## 许可证
367
354
 
368
355
  [MIT](./LICENSE)。打包进来的第三方代码见 [THIRD_PARTY_LICENSES.md](./THIRD_PARTY_LICENSES.md)。
369
356
 
370
- <!-- TODO(腾讯开源):版权方 / 腾讯署名,以及需要的合规或安全联系方式放这里。 -->
Binary file
Binary file
Binary file
package/docs/hero.webp ADDED
Binary file
Binary file
Binary file
Binary file
package/docs/home.png ADDED
Binary file
package/docs/logo.svg ADDED
@@ -0,0 +1 @@
1
+ <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24" fill="none" stroke="#0E0E10" stroke-width="1.8" stroke-linecap="square"><path d="M3 8V3h5M16 3h5v5M21 16v5h-5M8 21H3v-5"/><path d="M9 8.5l8 3.6-3.4 1-1.6 3.4z" fill="#FF5A1F" stroke="#FF5A1F" stroke-linejoin="round"/></svg>
Binary file
Binary file
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "page-harness",
3
- "version": "0.1.4",
3
+ "version": "0.1.5",
4
4
  "description": "Point it at any frontend URL and get Pick / Artifacts / Chat on the page, driven by the coding agent CLI on your machine.",
5
5
  "keywords": [
6
6
  "agent",
@@ -22,7 +22,10 @@
22
22
  "README.md",
23
23
  "README.zh-CN.md",
24
24
  "LICENSE",
25
- "THIRD_PARTY_LICENSES.md"
25
+ "THIRD_PARTY_LICENSES.md",
26
+ "docs/*.svg",
27
+ "docs/*.png",
28
+ "docs/*.webp"
26
29
  ],
27
30
  "engines": {
28
31
  "node": ">=20.11"