@liyang8246/takeit 0.0.0-stage → 0.1.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/README.md +22 -2
- package/dist/cli.mjs +30 -0
- package/package.json +37 -3
package/README.md
CHANGED
|
@@ -1,3 +1,23 @@
|
|
|
1
|
-
#
|
|
1
|
+
# takeit
|
|
2
2
|
|
|
3
|
-
|
|
3
|
+
把一个浏览器标签页交给 agent。
|
|
4
|
+
|
|
5
|
+
装扩展。点接管。复制 prompt。
|
|
6
|
+
|
|
7
|
+
```sh
|
|
8
|
+
npx -y @liyang8246/takeit <token> help
|
|
9
|
+
```
|
|
10
|
+
|
|
11
|
+
单 tab。单次进程。无常驻桥。
|
|
12
|
+
|
|
13
|
+
## 开发
|
|
14
|
+
|
|
15
|
+
```sh
|
|
16
|
+
pnpm install
|
|
17
|
+
pnpm build
|
|
18
|
+
pnpm run ci
|
|
19
|
+
```
|
|
20
|
+
|
|
21
|
+
在 Chrome 加载 [extension](<extension/>)。开发使用 Node.js 24.15+;CLI 仍支持 22.18+。
|
|
22
|
+
|
|
23
|
+
Token 即授权。切换即撤权。超时不回滚。
|
package/dist/cli.mjs
ADDED
|
@@ -0,0 +1,30 @@
|
|
|
1
|
+
#!/usr/bin/env node
|
|
2
|
+
import{Buffer as B}from"node:buffer";import{writeFile as j}from"node:fs/promises";import{resolve as Z}from"node:path";import f from"node:process";import{parseArgs as G}from"node:util";function E(t){return typeof t=="object"&&t!==null&&!Array.isArray(t)}function R(t){return typeof t=="string"&&/^[a-f0-9]{32}$/.test(t)}var M=t=>typeof t=="number"&&Number.isFinite(t);function C(t){return typeof t=="string"&&/^[1-9]\d*$/.test(t)&&Number.isSafeInteger(Number(t))}var b=t=>t===void 0||typeof t=="boolean";function F(t){if(!E(t))return!1;switch(t.op){case"click":return C(t.ref);case"type":return C(t.ref)&&typeof t.text=="string"&&b(t.submit);case"key":return typeof t.key=="string"&&["Enter","Tab","Escape","Backspace","Delete","ArrowUp","ArrowDown","ArrowLeft","ArrowRight"].includes(t.key);case"scroll":return M(t.dy);case"navigate":{if(typeof t.url!="string")return!1;try{return["http:","https:"].includes(new URL(t.url).protocol)}catch{return!1}}case"wait":return M(t.ms)&&t.ms>=0&&t.ms<=1e4;default:return!1}}function T(t){if(!E(t))return!1;switch(t.kind){case"state":return E(t.view)&&b(t.view.id)&&b(t.view.class)&&b(t.view.hidden);case"act":return F(t.act);case"script":return typeof t.code=="string"&&t.code.trim().length>0;case"screenshot":return typeof t.full=="boolean";default:return!1}}function _(t){return E(t)&&typeof t.id=="string"&&(t.ok===!0&&typeof t.data=="string"||t.ok===!1&&typeof t.error=="string")}function V(t,a){let e={state:0,click:1,type:2,key:1,scroll:1,navigate:1,wait:1,script:1,screenshot:1};if(t===void 0||e[t]===void 0)throw new Error(`\u672A\u77E5\u547D\u4EE4\uFF1A${t??""}\uFF1B\u8FD0\u884C takeit help \u67E5\u770B\u7528\u6CD5`);let s=[],n=!1;for(let o=0;o<e[t];o+=1){let i=a.shift();if(!n&&i==="--"&&(n=!0,i=a.shift()),i===void 0||!n&&i.startsWith("--"))throw new Error(`${t} \u7F3A\u5C11\u53C2\u6570\uFF1B\u4EE5 -- \u5F00\u5934\u7684\u6587\u672C\u987B\u653E\u5728\u72EC\u7ACB\u7684 -- \u4E4B\u540E`);s.push(i)}if(n&&a.length)throw new Error("-- \u540E\u53EA\u80FD\u653E\u547D\u4EE4\u6240\u9700\u7684\u6587\u672C\uFF0C\u4E0D\u80FD\u518D\u52A0\u9009\u9879");let r={timeout:{type:"string"},...t==="state"?{"with-id":{type:"boolean"},"with-class":{type:"boolean"},"with-hidden":{type:"boolean"}}:{},...t==="type"?{submit:{type:"boolean"}}:{},...t==="screenshot"?{full:{type:"boolean"}}:{}},{values:c}=G({args:a,options:r,strict:!0,allowPositionals:!1});return{positional:s,values:c}}function U(t){if(t.length===0||["help","--help","-h"].includes(t[0]??""))return null;let[a,e,...s]=t;if(!R(a))throw new Error("token \u5FC5\u987B\u662F\u6269\u5C55\u590D\u5236\u7684 32 \u4F4D\u5B57\u7B26\u4E32\uFF1B\u8BF7\u91CD\u65B0\u590D\u5236 prompt");if(["help","--help","-h"].includes(e??""))return null;let{positional:n,values:r}=V(e,s),c=r.timeout===void 0?3e4/1e3:Number(r.timeout);if(!Number.isFinite(c)||c<=0||c>300)throw new Error("--timeout \u987B\u4E3A\u5927\u4E8E 0 \u4E14\u4E0D\u8D85\u8FC7 300 \u7684\u79D2\u6570");let o=n[0]??"",i;switch(e){case"state":i={kind:"state",view:{id:r["with-id"]===!0,class:r["with-class"]===!0,hidden:r["with-hidden"]===!0}};break;case"click":i={kind:"act",act:{op:e,ref:o}};break;case"type":i={kind:"act",act:{op:e,ref:o,text:n[1]??"",submit:r.submit===!0}};break;case"key":i={kind:"act",act:{op:e,key:o}};break;case"scroll":i={kind:"act",act:{op:e,dy:o.trim()?Number(o):NaN}};break;case"navigate":i={kind:"act",act:{op:e,url:o}};break;case"wait":i={kind:"act",act:{op:e,ms:o.trim()?Number(o):NaN}};break;case"script":i={kind:"script",code:o};break;case"screenshot":if(!o||o.startsWith("--"))throw new Error("screenshot \u9700\u8981\u4E00\u4E2A\u672A\u5B58\u5728\u7684 PNG \u8F93\u51FA\u8DEF\u5F84");i={kind:"screenshot",full:r.full===!0};break;default:throw new Error(`\u672A\u77E5\u547D\u4EE4\uFF1A${e}`)}if(!T(i))throw new Error(`${e} \u53C2\u6570\u65E0\u6548\uFF1Auid \u987B\u4E3A\u6B63\u6574\u6570\uFF0CURL \u987B\u4E3A http/https\uFF0Cwait \u8303\u56F4\u4E3A 0\u201310000ms`);return{token:a,command:i,timeoutMs:c*1e3,...e==="screenshot"?{output:o}:{}}}var $=`takeit \xB7 \u53EA\u64CD\u4F5C\u6269\u5C55\u660E\u786E\u6388\u6743\u7684\u90A3\u4E2A\u6807\u7B7E\u9875
|
|
3
|
+
|
|
4
|
+
\u7528\u6CD5\uFF1Anpx -y @liyang8246/takeit <token> <command> [\u53C2\u6570] [\u9009\u9879]
|
|
5
|
+
|
|
6
|
+
state [--with-id] [--with-class] [--with-hidden] \u8BFB\u53D6 DOM \u5FEB\u7167
|
|
7
|
+
click <uid> \u70B9\u51FB\u5143\u7D20
|
|
8
|
+
type <uid> <text> [--submit] \u66FF\u6362\u8F93\u5165\u5185\u5BB9\uFF0C\u53EF\u6309 Enter \u63D0\u4EA4
|
|
9
|
+
key <key> Enter/Tab/Escape/Backspace/Delete/Arrow\u65B9\u5411\u952E
|
|
10
|
+
scroll <dy> \u5782\u76F4\u6EDA\u52A8\u50CF\u7D20\uFF0C\u53EF\u4E3A\u8D1F\u6570
|
|
11
|
+
navigate <http/https URL> \u5728\u540C\u4E00\u6807\u7B7E\u9875\u5BFC\u822A
|
|
12
|
+
wait <ms> \u7B49\u5F85 0\u201310000 \u6BEB\u79D2
|
|
13
|
+
script <JavaScript> \u5728\u9875\u9762\u4E3B\u4E16\u754C\u6267\u884C\uFF0C\u63D0\u4F9B jQuery
|
|
14
|
+
screenshot <new.png> [--full] \u4FDD\u5B58\u89C6\u53E3/\u6574\u9875 PNG\uFF0C\u4E0D\u8986\u76D6\u5DF2\u6709\u6587\u4EF6
|
|
15
|
+
help \u672C\u5730\u663E\u793A\u8BF4\u660E\uFF0C\u4E0D\u8FDE\u63A5\u6269\u5C55
|
|
16
|
+
|
|
17
|
+
\u6240\u6709\u9875\u9762\u547D\u4EE4\u652F\u6301 --timeout <\u79D2>\uFF08\u9ED8\u8BA4 30\uFF0C\u6700\u5927 300\uFF0C\u5305\u542B\u7B49\u5F85\u7AEF\u53E3\u65F6\u95F4\uFF09\u3002
|
|
18
|
+
\u6587\u672C/\u4EE3\u7801\u4EE5 -- \u5F00\u5934\u65F6\uFF0C\u5728\u5176\u524D\u52A0\u72EC\u7ACB\u7684 --\uFF0C\u5E76\u4E14\u540E\u9762\u4E0D\u518D\u6DFB\u52A0\u9009\u9879\u3002
|
|
19
|
+
\u5FEB\u7167 uid \u7528\u4E8E click/type\uFF1B\u9875\u9762\u5BFC\u822A\u6216\u8282\u70B9\u66FF\u6362\u540E\u5E94\u91CD\u65B0\u8BFB\u53D6 state\u3002
|
|
20
|
+
\u8F93\u51FA\u53EF\u80FD\u5F88\u957F\uFF0C\u5EFA\u8BAE\u91CD\u5B9A\u5411\u6587\u4EF6\u540E\u6309\u9700\u8BFB\u53D6\uFF1B\u64CD\u4F5C\u4EC5\u8FD4\u56DE ok\uFF0C\u9700\u8981\u65F6\u81EA\u5DF1\u8BFB\u53D6 state\u3002
|
|
21
|
+
\u6BCF\u6761\u547D\u4EE4\u4E34\u65F6\u7ED1\u5B9A 127.0.0.1:8737\uFF0C\u5B8C\u6210\u5373\u9000\u51FA\uFF0C\u6CA1\u6709\u540E\u53F0\u670D\u52A1\u3002
|
|
22
|
+
\u7AEF\u53E3\u5FD9\u65F6\u9650\u65F6\u7B49\u5F85\uFF1B\u53EA\u4FDD\u8BC1\u9010\u6761\u4E92\u65A5\uFF0C\u4E0D\u4FDD\u8BC1 FIFO \u6216\u591A agent \u6574\u4E2A\u4EFB\u52A1\u72EC\u5360\u3002
|
|
23
|
+
\u5207\u6362/\u505C\u6B62\u63A5\u7BA1\u540E\uFF0C\u65E7 token \u7ACB\u5373\u5931\u6548\uFF1B\u672C\u673A\u5176\u4ED6\u7A0B\u5E8F\u5360\u7AEF\u53E3\u65F6\u4E5F\u4F1A\u7B49\u5F85\u3002
|
|
24
|
+
\u547D\u4EE4\u5DF2\u9001\u8FBE\u540E\u53D1\u751F\u8D85\u65F6/\u4E2D\u65AD\uFF0C\u6267\u884C\u7ED3\u679C\u672A\u77E5\uFF1B\u5148\u68C0\u67E5\u9875\u9762\uFF0C\u4E0D\u8981\u81EA\u52A8\u91CD\u8BD5\u526F\u4F5C\u7528\u3002
|
|
25
|
+
\u4E0B\u5355\u3001\u53D1\u6D88\u606F\u3001\u5220\u9664\u7B49\u4E0D\u53EF\u9006\u64CD\u4F5C\uFF0C\u5148\u5F81\u6C42\u7528\u6237\u786E\u8BA4\u3002
|
|
26
|
+
`;import{Buffer as J}from"node:buffer";import{randomUUID as H}from"node:crypto";import{createServer as W}from"node:http";import{setTimeout as z}from"node:timers/promises";var Y=32*1024*1024;function K(t,a){return new Promise((e,s)=>{function n(){t.off("error",r),t.off("listening",c)}function r(o){n(),s(o)}function c(){n(),e()}t.once("error",r),t.once("listening",c),t.listen({host:"127.0.0.1",port:a,exclusive:!0})})}async function Q(t){if(!t.listening)return;let a=new Promise(e=>t.close(()=>e()));t.closeAllConnections(),await a}function X(t){return new Promise((a,e)=>{let s=[],n=0,r=!1;t.on("data",c=>{r||(n+=c.length,n>Y?(r=!0,s.length=0,e(new Error("\u56DE\u6267\u8D85\u8FC7 32 MiB"))):s.push(c))}),t.on("end",()=>{r||a(J.concat(s).toString("utf8"))}),t.on("error",e),t.on("aborted",()=>e(new Error("\u56DE\u6267\u8FDE\u63A5\u4E2D\u65AD")))})}async function D(t,a,e={}){if(!R(t)||!T(a))throw new Error("\u65E0\u6548\u7684 token \u6216\u547D\u4EE4");let s=e.timeoutMs??3e4,n=e.port??8737;if(!Number.isFinite(s)||s<=0||s>3e5)throw new Error("\u8D85\u65F6\u987B\u5728 0\u2013300 \u79D2\u4E4B\u95F4");if(!Number.isInteger(n)||n<1||n>65535)throw new Error("\u65E0\u6548\u7AEF\u53E3");let r=new AbortController,c=setTimeout(()=>r.abort(),s),o=e.signal?AbortSignal.any([e.signal,r.signal]):r.signal,i={version:1,id:H(),token:t,deadline:Date.now()+s,command:a},w=()=>o.aborted||Date.now()>=i.deadline,g=!1,P=!1,I,S,y=()=>new Error(g?"\u547D\u4EE4\u5DF2\u9001\u8FBE\uFF0C\u4F46\u7B49\u5F85\u7ED3\u679C\u8D85\u65F6\u6216\u4E2D\u65AD\uFF1A\u6267\u884C\u7ED3\u679C\u672A\u77E5\uFF0C\u8BF7\u5148\u68C0\u67E5\u9875\u9762\uFF0C\u52FF\u81EA\u52A8\u91CD\u8BD5\u6709\u526F\u4F5C\u7528\u7684\u64CD\u4F5C":P?"\u7B49\u5F85\u6269\u5C55\u8D85\u65F6\u6216\u4E2D\u65AD\uFF1A\u8BF7\u786E\u8BA4\u6B64 token \u5BF9\u5E94\u7684\u6807\u7B7E\u9875\u4ECD\u5728\u63A5\u7BA1":`\u7B49\u5F85\u7AEF\u53E3 ${n} \u8D85\u65F6\u6216\u4E2D\u65AD\uFF1A\u5176\u4ED6\u547D\u4EE4\u6216\u7A0B\u5E8F\u4ECD\u5728\u5360\u7528\u7AEF\u53E3`),A=()=>S?.(y()),h=W((u,m)=>{let d=(l,p,k)=>{m.destroyed||(m.writeHead(l,{"content-type":"application/json; charset=utf-8","cache-control":"no-store",connection:"close"}),m.end(l===204?void 0:JSON.stringify(p),k))};(async()=>{let l=u.headers.origin;if(u.headers.host!==`127.0.0.1:${n}`||l!==void 0&&!/^chrome-extension:\/\/[a-p]{32}$/.test(l)||u.headers.authorization!==`Bearer ${t}`){d(403,{error:"forbidden"});return}if(w()){d(410,{error:"\u547D\u4EE4\u5DF2\u8FC7\u671F"});return}if(u.method==="POST"&&u.url==="/command"){if(g){d(204,null);return}g=!0,d(200,i);return}if(u.method!=="POST"||u.url!=="/reply"){d(404,{error:"not found"});return}let p;try{p=JSON.parse(await X(u))}catch(k){d(k instanceof Error&&k.message.includes("32 MiB")?413:400,{error:"\u65E0\u6548\u56DE\u6267"});return}if(w()){d(410,{error:"\u547D\u4EE4\u5DF2\u8FC7\u671F"});return}if(!g||!_(p)||p.id!==i.id){d(409,{error:"\u56DE\u6267\u4E0D\u5C5E\u4E8E\u5F53\u524D\u547D\u4EE4"});return}d(200,{ok:!0},()=>I?.(p))})().catch(l=>{d(500,{error:"\u8FDE\u63A5\u5904\u7406\u5931\u8D25"}),S?.(l instanceof Error?l:new Error(String(l)))})});h.headersTimeout=Math.min(s,5e3),h.requestTimeout=s,h.keepAliveTimeout=1;try{for(;;){if(w())throw y();try{await K(h,n),P=!0;break}catch(u){if(u.code!=="EADDRINUSE")throw u;try{await z(100,void 0,{signal:o})}catch{throw y()}}}return await new Promise((u,m)=>{S=m,I=d=>{w()?m(y()):d.ok?u(d.data):m(new Error(d.error))},o.addEventListener("abort",A,{once:!0}),w()&&A()})}finally{clearTimeout(c),o.removeEventListener("abort",A),await Q(h)}}var x=new AbortController,O=x.abort.bind(x);f.once("SIGINT",O);f.once("SIGTERM",O);try{let t=U(f.argv.slice(2));if(!t)f.stdout.write($);else{let{token:a,command:e,timeoutMs:s,output:n}=t,r=await D(a,e,{timeoutMs:s,signal:x.signal});if(n!==void 0){let c=B.from(r,"base64");if(!c.subarray(0,8).equals(B.from([137,80,78,71,13,10,26,10])))throw new Error("\u6269\u5C55\u672A\u8FD4\u56DE\u6709\u6548 PNG");await j(n,c,{flag:"wx"}),f.stdout.write(`${Z(n)}
|
|
27
|
+
`)}else f.stdout.write(r.endsWith(`
|
|
28
|
+
`)?r:`${r}
|
|
29
|
+
`)}}catch(t){f.stderr.write(`takeit: ${t instanceof Error?t.message:String(t)}
|
|
30
|
+
`),f.exitCode=x.signal.aborted?130:1}finally{f.off("SIGINT",O),f.off("SIGTERM",O)}
|
package/package.json
CHANGED
|
@@ -1,6 +1,40 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@liyang8246/takeit",
|
|
3
|
-
"
|
|
4
|
-
"
|
|
5
|
-
"description": "
|
|
3
|
+
"type": "module",
|
|
4
|
+
"version": "0.1.0",
|
|
5
|
+
"description": "Control one explicitly authorized browser tab with a one-shot CLI",
|
|
6
|
+
"bin": {
|
|
7
|
+
"takeit": "dist/cli.mjs"
|
|
8
|
+
},
|
|
9
|
+
"files": [
|
|
10
|
+
"dist/cli.mjs"
|
|
11
|
+
],
|
|
12
|
+
"engines": {
|
|
13
|
+
"node": ">=22.18.0"
|
|
14
|
+
},
|
|
15
|
+
"publishConfig": {
|
|
16
|
+
"access": "public"
|
|
17
|
+
},
|
|
18
|
+
"devDependencies": {
|
|
19
|
+
"@antfu/eslint-config": "^10.0.0",
|
|
20
|
+
"@resvg/resvg-js": "^2.6.2",
|
|
21
|
+
"@types/chrome": "^0.3.7",
|
|
22
|
+
"@types/node": "^26.6.6",
|
|
23
|
+
"esbuild": "^0.28.2",
|
|
24
|
+
"eslint": "^10.15.0",
|
|
25
|
+
"eslint-plugin-format": "^2.0.1",
|
|
26
|
+
"eslint-plugin-slop": "^0.1.3",
|
|
27
|
+
"eslint-plugin-sonarjs": "^4.2.2",
|
|
28
|
+
"jquery": "^4.0.0",
|
|
29
|
+
"typescript": "~6.0.3"
|
|
30
|
+
},
|
|
31
|
+
"scripts": {
|
|
32
|
+
"build": "node build.mjs",
|
|
33
|
+
"ci": "pnpm run lint && pnpm run typecheck && pnpm test",
|
|
34
|
+
"dev": "node src/cli/main.ts",
|
|
35
|
+
"lint": "eslint .",
|
|
36
|
+
"typecheck": "tsc --noEmit",
|
|
37
|
+
"selftest": "pnpm run build && node dev/protocol.test.ts && node dev/cli.test.ts && node dev/selftest.ts && node dev/snapshot.test.ts && node dev/cdp.test.ts && node dev/extension.test.ts",
|
|
38
|
+
"test": "pnpm run selftest"
|
|
39
|
+
}
|
|
6
40
|
}
|