@celljs/ta-manual 0.0.0-stage → 4.12.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.en.md ADDED
@@ -0,0 +1,10 @@
1
+ # Cell - Ta Manual
2
+
3
+ A pi package that comes with Ta (on by default; turn it off under Settings → Extensions of the web client): the user manual.
4
+
5
+ - **The User manual page**: under Discover and in Quick open (started on open: loaded only when opened). A topic for each thing Ta does (start a conversation, your double, agents and channels, the workbench, extensions, Ta on your phone, scheduled tasks, quick open and widgets, more), two to four steps each, a picture and a sentence for each step; on a phone the picture is on the left and the words on the right. Under a topic, "Open …" goes to its page (Extensions, Scheduled), and "Next" to the next topic. The topics and steps of a built-in package the user turned off are left out.
6
+ - **The `ta-manual` skill**: the same for the model. When the user asks in a conversation "how do I use Ta on my phone" or "where are the scheduled tasks", Ta answers from the manual, naming buttons and pages as the pages do, and points to the User manual page when a picture helps.
7
+
8
+ What it says is written once, in `web-src/topics.ts`. The page draws it; the build writes `skills/ta-manual/SKILL.md` from it with `scripts/manual-skill.mjs` (generated, not in the repository). The pictures are in `web-src/pictures-a.tsx` and `pictures-b.tsx`, made of the few parts of `scene.tsx` (the navigation, the message box, bubbles, menus, a phone, a QR code, a ring that spreads where to tap), only in the classes `ta-pic-*` of Ta's pictures, so that they follow the theme.
9
+
10
+ When a page of Ta changes, change its steps here too: the manual says only what Ta does, in the words its pages show. A new topic or step says it in both languages; the line under a topic stays short (about 12 Chinese characters wide, 22 characters in English, so that two cards side by side on a phone show it whole), which the spec checks.
package/README.md CHANGED
@@ -1,3 +1,10 @@
1
- # Temporary Holding Version
1
+ # Cell - Ta Manual
2
2
 
3
- This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
3
+ Ta 自带的 pi 包(默认开启,可在 Web 客户端的 设置 → 扩展 关闭):使用手册。
4
+
5
+ - **"使用手册"页**:在"发现"和快捷打开里(按需启动:点开才加载)。Ta 的每项能力一个主题(开始对话、我的分身、智能体与频道、工作台、扩展、在手机上用、定时任务、快捷打开与小组件、更多能力),每个主题两到四步,每步一张示意图、一句话;手机上图在左、字在右。主题页下方有"打开 …"(直接去对应的页面,比如"扩展""定时任务")和"下一篇"。用户关掉的内置包,它的主题和步骤不显示。
6
+ - **`ta-manual` 技能**:同一份内容给模型,用户在对话里问"怎么在手机上用""定时任务在哪"时,Ta 照手册回答,按界面上的叫法说按钮和页面,需要时指向"使用手册"页。
7
+
8
+ 内容只有一份:`web-src/topics.ts`。页面画它,构建时 `scripts/manual-skill.mjs` 用它写出 `skills/ta-manual/SKILL.md`(生成文件,不进仓库)。示意图在 `web-src/pictures-a.tsx`、`pictures-b.tsx`,由 `scene.tsx` 的几种零件(导航栏、输入框、气泡、菜单、手机、二维码、点按处的扩散圈)拼成,只用 Ta 图片的 `ta-pic-*` 样式类,跟随主题。
9
+
10
+ 改 Ta 的界面时,同时改这里对应的步骤:手册只写已经实现的行为,用界面上的原词。加主题或步骤时,写中英两种语言;主题的副标题要短(中文约 12 个字宽、英文不超过 22 个字符,手机上两张卡片并排时显示得下),单测会检查。
package/package.json CHANGED
@@ -1,6 +1,54 @@
1
1
  {
2
2
  "name": "@celljs/ta-manual",
3
- "version": "0.0.0-stage",
4
- "stub": true,
5
- "description": "Temporary package placeholder for staged publishing"
6
- }
3
+ "version": "4.12.0",
4
+ "description": "A pi package for Ta: the user manual, a page of short illustrated guides to what Ta does, and the ta-manual skill that answers how to use Ta from it",
5
+ "keywords": [
6
+ "pi-package"
7
+ ],
8
+ "homepage": "https://github.com/cellbang/cell",
9
+ "bugs": {
10
+ "url": "https://github.com/cellbang/cell/issues"
11
+ },
12
+ "repository": {
13
+ "type": "git",
14
+ "url": "https://github.com/cellbang/cell.git"
15
+ },
16
+ "license": "MIT",
17
+ "files": [
18
+ "web",
19
+ "skills",
20
+ "!**/*.map"
21
+ ],
22
+ "scripts": {
23
+ "build": "tsc -b && node scripts/manual-skill.mjs && bun build web-src/index.tsx --format esm --target browser --outfile web/index.js",
24
+ "clean": "rm -rf lib web skills *.tsbuildinfo",
25
+ "test": "bun test ./lib",
26
+ "watch": "tsc -b -w --preserveWatchOutput"
27
+ },
28
+ "devDependencies": {
29
+ "@celljs/ta-protocol": "4.12.0",
30
+ "@celljs/ta-web": "4.12.0",
31
+ "@types/react": "^19.3.0"
32
+ },
33
+ "publishConfig": {
34
+ "access": "public"
35
+ },
36
+ "pi": {
37
+ "title": {
38
+ "en": "User manual",
39
+ "zh-CN": "使用手册"
40
+ },
41
+ "summary": {
42
+ "en": "The User manual page: what Ta does, a few pictures and a sentence for each step, under Discover; and a skill with which Ta answers how to use it.",
43
+ "zh-CN": "\"使用手册\"页:Ta 的每项能力几张图、一句话讲清怎么用,在\"发现\"里;也让 Ta 在对话里照手册回答怎么用。"
44
+ },
45
+ "icon": "BookOpen",
46
+ "webActivation": "open",
47
+ "web": [
48
+ "./web/index.js"
49
+ ],
50
+ "skills": [
51
+ "./skills"
52
+ ]
53
+ }
54
+ }
@@ -0,0 +1,130 @@
1
+ ---
2
+ name: ta-manual
3
+ description: How to use Ta, from its User manual — conversations, the double and its tasks, agents and channels, the workbench, extensions, Ta on a phone, scheduled tasks, quick open and widgets, remote hosts, other coding agents, bots. Use it when the user asks how to do something in Ta, where something is, or what Ta can do.
4
+ ---
5
+
6
+ <!-- Written by scripts/manual-skill.mjs from web-src/topics.ts of @celljs/ta-manual: change those, not this file. -->
7
+
8
+ # How to use Ta
9
+
10
+ Answer from the steps below, in the user's language, naming buttons and pages as the user's pages show them: each step is given in English and in Chinese. Keep to the steps that answer the question. The same steps, with a picture for each, are on the User manual page (使用手册), under Discover (发现): point the user there when a picture helps. Say nothing about Ta's pages that is not below or that you have not seen; when unsure, say so.
11
+
12
+ ## Start a conversation (开始对话)
13
+
14
+ A folder and a request.
15
+
16
+ 1. **A new conversation** — Tap + in Chats; above the message box, pick the folder Ta works in.
17
+ 中文:**新建对话** — 在“对话”列表点 +,在输入框上方选 Ta 工作的目录。
18
+ 2. **Say what to do** — Enter sends; add more while Ta works, Esc or Stop halts it. Quote a reply (hold it) to ask of that part.
19
+ 中文:**说要做什么** — 回车发送;Ta 工作时可以接着补充,按 Esc 或“停下”停止。长按回复选“引用”,只问其中一段。
20
+ 3. **All in the +** — The + left of the box: pictures, @ files, / commands and skills, the model and how hard it thinks. A screenshot just taken shows once above it: tap to add.
21
+ 中文:**工具都在 + 里** — 输入框左侧的 +:图片、@ 引用文件、/ 命令与技能、模型和思考强度。刚截的图会在 + 上方提示一次,点一下带上。
22
+ 4. **Pinned, and what is new** — Swipe a conversation or an agent to the left (on a computer, right-click it or use its …) and Pin it to the top, as many as you like. One that finished while you were elsewhere has an amber dot until you open it. On a phone, tap the tab again to go to the next one with a dot, twice quickly for the top; drag the dot of the tab away to mark all as seen.
23
+ 中文:**置顶与未读** — 左滑对话或智能体(电脑上右键)可置顶。没看过的有黄点;手机上再点当前标签跳到下一个,连点两下回顶部,拖走黄点全部已读。
24
+
25
+ ## Your double (我的分身)
26
+
27
+ Hand it a job.
28
+
29
+ 1. **Hand over a job** — In Double, type it, or tap the microphone and say it; on a phone, hold the box to talk while the keyboard is down.
30
+ 中文:**交代一件事** — 在“分身”里打字,或点麦克风说出来;手机上键盘没弹出时,也可以直接按住输入框说话。
31
+ 2. **It works as a task** — A card of the task shows in the conversation; tap it to watch the work beside, and put in a word.
32
+ 中文:**交成任务去做** — 对话里出现任务卡片;点开在右侧看现场,也可以插话。
33
+ 3. **It tells you when done** — A green dot is at work, a yellow one waits for you to look or to say yes.
34
+ 中文:**做完告诉你** — 绿点表示正在做,黄点表示等你查看或确认。
35
+ 4. **Told when it needs you** — A dot on Chats and on the row says which answered; a question has its answers to tap in it. On a computer, a banner; with Ta in the back, a notice of the system. (with the built-in package `@celljs/ta-notify`, which the user may have turned off in Settings → Extensions)
36
+ 中文:**需要你时提醒你** — “对话”标签和那一行上的黄点告诉你谁回复了,提问在对话里直接点选回答;电脑上是横幅,Ta 在后台时是系统通知。
37
+
38
+ ## Agents and channels (智能体与频道)
39
+
40
+ A team in a chat. (with the built-in package `@celljs/ta-channels`, which the user may have turned off in Settings → Extensions)
41
+
42
+ 1. **Make an agent** — Tap + at the top of Double, then New agent: give it a name and a face; its first message makes it.
43
+ 中文:**新建智能体** — 点“分身”侧栏顶部的 +,选“新建智能体”:起名字、挑头像,发出第一条消息就建好了。
44
+ 2. **Open a channel** — New channel: name it and pick a few agents. The first one picked leads.
45
+ 中文:**建一个频道** — 选“新建频道”,起个名字、勾选几个智能体,先选的是负责人。
46
+ 3. **@ who should answer** — Whoever you @ answers, the lead when no one is named; members @ each other too.
47
+ 中文:**@ 谁谁回答** — @ 到谁谁回答,不点名由负责人回答;成员之间也会互相 @。
48
+ 4. **Hand it over** — Say “give this to @tester”, or pick Hand over to… in the +: Ta writes the brief, the agent or channel goes on.
49
+ 中文:**交给别人做** — 说“这个交给 @tester”,或在 + 里选“交给…”:Ta 写好交接摘要,对方接着做。
50
+
51
+ ## Rooms (房间)
52
+
53
+ Chat with others' Ta. (with the built-in package `@celljs/ta-rooms`, which the user may have turned off in Settings → Extensions)
54
+
55
+ 1. **Make a room, invite** — In Discover, Rooms, tap + to make one; Invite in its members gives a link and a code. You let in who asks.
56
+ 中文:**建房间并邀请** — 在“发现 → 房间”点 + 新建,在房间成员里点“邀请”发出链接或二维码,有人申请时由你同意。
57
+ 2. **Ask someone's double** — @ someone's double in the box: their Ta answers in the room, if they let it. Yours answers others the same way.
58
+ 中文:**问对方的分身** — 在输入框里 @ 某人的分身,对方允许时,TA 的 Ta 就在房间里回答;你的分身也一样。
59
+ 3. **Let it do more** — A double only chats. When it asks, or with the key by a member, let it use files or commands in one folder for a while; take it back in What your double did.
60
+ 中文:**授权与收回** — 分身默认只聊天。它请求时或点成员旁的钥匙,可让它在一个目录里读写文件或运行命令;在“分身记录”里收回。
61
+
62
+ ## The workbench (工作台)
63
+
64
+ Files and a terminal. (with the built-in package `@celljs/ta-workspace`, which the user may have turned off in Settings → Extensions)
65
+
66
+ 1. **Open it** — On a computer, Show the panel at the top right; on a phone, swipe left in a conversation.
67
+ 中文:**打开工作台** — 电脑上点右上角的“显示面板”;手机上在对话里向左滑。
68
+ 2. **Pick a tool** — Explorer, Search, Source control, Terminal and Browser, each opens as a tab.
69
+ 中文:**选一个工具** — 资源管理器、搜索、源代码管理、终端和浏览器,各开成一个标签。
70
+ 3. **See what changed** — Under a reply, “N files changed”: tap for the differences, or undo the changes of this reply. (with the built-in package `@celljs/ta-changes`, which the user may have turned off in Settings → Extensions)
71
+ 中文:**改了什么一目了然** — 回复下方显示“N 个文件已更改”:点开看差异,也能“撤销本轮改动”。
72
+
73
+ ## Extensions (扩展)
74
+
75
+ Say it, Ta builds it. (with the built-in package `@celljs/ta-extensions`, which the user may have turned off in Settings → Extensions)
76
+
77
+ 1. **Say what you want** — Say “add a Pomodoro timer beside the conversation”, and Ta makes it an extension.
78
+ 中文:**说出想要的** — 在对话里说“在对话旁边加一个番茄钟”,Ta 就把它做成扩展。
79
+ 2. **Or install one** — The Marketplace of the Extensions page installs what others made, in one tap.
80
+ 中文:**或者装一个** — “扩展”页的“市场”里,别人做好的一键安装。
81
+ 3. **Share it** — Share gives a link and a QR code: others open it without installing.
82
+ 中文:**分享出去** — “分享”给出链接和二维码,对方不用安装就能打开。
83
+
84
+ ## Ta on your phone (在手机上用)
85
+
86
+ Scan a code to pair.
87
+
88
+ 1. **Show the code** — On the computer, tap your avatar at the bottom of the rail, Use on your phone…, then Pair a device.
89
+ 中文:**电脑上出示二维码** — 在电脑上点导航栏底部的头像,选“在手机上使用…”,再点“配对设备”。
90
+ 2. **Scan it** — In Ta on the phone, Scan to connect. What goes between them is encrypted end to end.
91
+ 中文:**手机上扫一扫** — 在手机上的 Ta 里点“扫码连接”。来往内容端到端加密。
92
+ 3. **Use it anywhere** — Hand over jobs away from your desk; while the computer is out of reach, what you read stays.
93
+ 中文:**走到哪用到哪** — 离开电脑也能交代事情;连不上时,看过的对话照样能看。
94
+
95
+ ## Scheduled tasks (定时任务)
96
+
97
+ Ta works on time. (with the built-in package `@celljs/ta-cron`, which the user may have turned off in Settings → Extensions)
98
+
99
+ 1. **Say when and what** — Say “every morning at 9, sum up yesterday’s commits”, or use /loop and /remind.
100
+ 中文:**说清时间和事情** — 说“每天早上 9 点汇总昨天的提交”,或者用 /loop、/remind。
101
+ 2. **Manage them** — On the Scheduled page: Run now, pause, edit. Each run is a new conversation.
102
+ 中文:**在一页里管理** — 在“定时任务”页立即运行、暂停、编辑;每次运行都是一个新对话。
103
+ 3. **Hear back** — When a run ends you get its summary; Tell me says whether every run, when it fails or never.
104
+ 中文:**结束后通知你** — 运行结束给你看总结;“通知我”可选每次、失败时或不通知。
105
+
106
+ ## Quick open and widgets (快捷打开与小组件)
107
+
108
+ A swipe away. (with the built-in package `@celljs/ta-launcher`, which the user may have turned off in Settings → Extensions)
109
+
110
+ 1. **Pull down** — Pull down on the first tab of a phone (the grid of the rail on a computer): the extensions used last.
111
+ 中文:**下拉快捷打开** — 手机首页下拉(电脑上点导航栏的九宫格),最近用过的扩展都在。
112
+ 2. **Keep in Mine** — Hold an icon to keep it in Mine; the search above finds pages, extensions and the marketplace.
113
+ 中文:**收进“我的”** — 长按图标收进“我的”;上面的搜索能找页面、扩展和市场。
114
+ 3. **Widgets** — Swipe left on the first tab of a phone (a button of the rail on a computer); Edit adds and orders them.
115
+ 中文:**小组件** — 手机首页向左滑出小组件(电脑上点导航栏的按钮),点“编辑”添加和排序。
116
+ 4. **Ask the past** — Type in its search and pick Ask Ta: Ta looks through your conversations and answers, with links to them. (with the built-in package `@celljs/ta-recall`, which the user may have turned off in Settings → Extensions)
117
+ 中文:**问以前的事** — 在搜索里输入后点“问 Ta”,Ta 翻一遍你的对话再回答,并链到出处。
118
+
119
+ ## More (更多能力)
120
+
121
+ Hosts, agents, bots.
122
+
123
+ 1. **Work on another machine** — When picking a folder, Add a host: the conversation works in a folder of that machine over ssh.
124
+ 中文:**在别的机器上干活** — 选目录时点“添加主机”,对话就经 ssh 在那台机器的目录里工作。
125
+ 2. **Other coding agents** — Claude Code, Codex and others are models: pick one under Model in the +. (with the built-in package `@celljs/ta-agents`, which the user may have turned off in Settings → Extensions)
126
+ 中文:**其他编程 Agent** — Claude Code、Codex 等都当作模型,在 + 菜单的“模型”里选用。
127
+ 3. **Talk in WeChat** — Connect a WeChat or WeCom bot to your double or a conversation; pictures, voice and files go both ways. (with the built-in package `@celljs/ta-bots`, which the user may have turned off in Settings → Extensions)
128
+ 中文:**在微信里说话** — 把微信或企业微信机器人连到分身或对话上,图片、语音、文件都能收发。
129
+ 4. **Use the computer** — Ta uses the apps of this computer in the background, leaving you the mouse and keyboard. (with the built-in package `@celljs/ta-computer-use`, which the user may have turned off in Settings → Extensions)
130
+ 中文:**操作电脑** — Ta 在后台操作这台电脑上的应用,不占用你的鼠标和键盘。