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 +8 -22
- package/README.zh-CN.md +8 -22
- package/docs/bookmarklet-zh.png +0 -0
- package/docs/bookmarklet.png +0 -0
- package/docs/hero-zh.webp +0 -0
- package/docs/hero.webp +0 -0
- package/docs/home-notes-zh.png +0 -0
- package/docs/home-notes.png +0 -0
- package/docs/home-zh.png +0 -0
- package/docs/home.png +0 -0
- package/docs/logo.svg +1 -0
- package/docs/review-only-zh.png +0 -0
- package/docs/review-only.png +0 -0
- package/package.json +5 -2
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="
|
|
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
|
-
<
|
|
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
|
|
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="
|
|
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="
|
|
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="
|
|
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="
|
|
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
|
|
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
|
-
[](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="
|
|
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
|
-
<
|
|
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
|
|
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="
|
|
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="
|
|
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="
|
|
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="
|
|
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
|
-
欢迎到
|
|
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
|
-
[](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
|
package/docs/home-zh.png
ADDED
|
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.
|
|
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"
|