@abelxiaoxing/cadence 2.1.0 → 2.1.1
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.de.md +72 -76
- package/README.es.md +71 -75
- package/README.fr.md +72 -76
- package/README.ja.md +83 -101
- package/README.ko.md +81 -97
- package/README.md +71 -86
- package/README.pt-BR.md +72 -76
- package/README.ru.md +72 -77
- package/README.zh-CN.md +74 -84
- package/docs/reuse-and-distribution.md +1 -0
- package/package.json +5 -2
- package/src/service/knowledge-store.ts +496 -0
- package/src/service/project-knowledge.ts +539 -0
- package/src/service/workflow-git.ts +773 -0
- package/src/service-host.mjs +1 -1
- package/web/dist/assets/cadence.js +1 -1
- package/web/dist/manifest.json +3 -3
package/README.zh-CN.md
CHANGED
|
@@ -2,126 +2,116 @@
|
|
|
2
2
|
|
|
3
3
|
[English](README.md) · [简体中文](README.zh-CN.md) · [日本語](README.ja.md) · [한국어](README.ko.md) · [Deutsch](README.de.md) · [Français](README.fr.md) · [Español](README.es.md) · [Português (Brasil)](README.pt-BR.md) · [Русский](README.ru.md)
|
|
4
4
|
|
|
5
|
-
Cadence 把 [Pi](https://www.npmjs.com/package/@earendil-works/pi-coding-agent)
|
|
6
|
-
|
|
5
|
+
Cadence 把 [Pi](https://www.npmjs.com/package/@earendil-works/pi-coding-agent) 变成对话驱动的工程工作流:输入 `/cadence [目标]`,一次对齐预期结果,之后由常驻 owner 实现、恢复并验证。
|
|
6
|
+
可在终端使用,也可使用可选的 WebUI。
|
|
7
|
+
|
|
8
|
+
## 工作方式
|
|
9
|
+
|
|
10
|
+
```mermaid
|
|
11
|
+
flowchart TD
|
|
12
|
+
A["/cadence 目标"] --> B["只读调查"]
|
|
13
|
+
B --> C["对齐需求,一次批准"]
|
|
14
|
+
C --> D["互不依赖的任务在并行 worktree 中执行"]
|
|
15
|
+
D --> E["真实检查 + 自动 Agent 审查"]
|
|
16
|
+
E -->|"通过"| F["本地合并到你的分支"]
|
|
17
|
+
E -->|"未通过"| G["自我修正"]
|
|
18
|
+
G --> D
|
|
19
|
+
F --> H["整理知识库(固定预算)"]
|
|
20
|
+
H -.-> B
|
|
21
|
+
```
|
|
22
|
+
|
|
23
|
+
```mermaid
|
|
24
|
+
flowchart LR
|
|
25
|
+
A["检查未通过"] --> B["修复"] --> C["改路线"] --> D["记录偏离"] --> E["仅因仓库之外的条件停止"]
|
|
26
|
+
```
|
|
27
|
+
|
|
28
|
+
```mermaid
|
|
29
|
+
flowchart LR
|
|
30
|
+
T["Pi 终端"] <-->|"连接 / 断开"| O[("常驻 owner")]
|
|
31
|
+
W["WebUI<br/>看板 · 分支 · 插话"] <-->|"连接 / 断开"| O
|
|
32
|
+
O --> X["worktree 中的 worker"] --> Y["你的分支"]
|
|
33
|
+
O -.-> K[".cadence/ 知识库"]
|
|
34
|
+
```
|
|
7
35
|
|
|
8
36
|
## 为什么选择 Cadence
|
|
9
37
|
|
|
10
|
-
|
|
11
|
-
|
|
12
|
-
|
|
13
|
-
|
|
14
|
-
|
|
15
|
-
|
|
16
|
-
|
|
17
|
-
|
|
18
|
-
|
|
19
|
-
|
|
20
|
-
|
|
21
|
-
|
|
22
|
-
|
|
23
|
-
Cadence 是一个受信任的助手,**不是沙箱**:它的代理在获批的 checkout 或 worktree 中使用宿主工具,所以请只在你能够审阅和恢复的代码上使用它。
|
|
38
|
+
| | |
|
|
39
|
+
| -------------------------- | ---------------------------------------------------------------------- |
|
|
40
|
+
| **工作不随窗口结束** | 客户端只是连接和断开,owner 持续运行。 |
|
|
41
|
+
| **批准之前不改任何文件** | 先只读调查,再给出一份可读的约定,由你确认。 |
|
|
42
|
+
| **结果可信** | 真实检查加独立审查;模型的文字不算通过。 |
|
|
43
|
+
| **自己做完** | 批准后自行修复、改路线或记录偏离,只因仓库之外的条件停下。 |
|
|
44
|
+
| **天生更快** | 互不依赖的任务在各自的 worktree 中并行。 |
|
|
45
|
+
| **知识持续积累** | 路由表加固定预算:worker 只读与代码对应的部分,新经验替换过时内容。 |
|
|
46
|
+
| **看得见也能插话的 WebUI** | 任务看板、路线修订、偏离、分支、思考块;回复进行中可插队或排队发消息。 |
|
|
47
|
+
| **一份历史** | 浏览器对话就是项目的 Pi 会话,两边都能继续。 |
|
|
48
|
+
|
|
49
|
+
> Cadence 是受信任的助手,**不是沙箱**:它的代理在获批的 checkout 或 worktree 中使用宿主工具。
|
|
50
|
+
> 请只在你能审阅和恢复的代码上使用。
|
|
24
51
|
|
|
25
52
|
## 安装
|
|
26
53
|
|
|
27
|
-
|
|
54
|
+
需要 Node `>=22.19.0`,以及已登录模型提供商的 Pi;Cadence 复用 Pi 的登录。
|
|
28
55
|
|
|
29
56
|
```sh
|
|
30
57
|
npm install -g @abelxiaoxing/cadence
|
|
31
58
|
pi install "$(npm root -g)/@abelxiaoxing/cadence"
|
|
59
|
+
cadence server install # 可选的 WebUI 与开机服务
|
|
32
60
|
```
|
|
33
61
|
|
|
34
|
-
|
|
35
|
-
|
|
36
|
-
端口和 token 保存在 `~/.pi/agent/cadence/.env`;任何持有 token 的人都可以使用你的工作区,所以请保持链接私密。
|
|
62
|
+
`cadence server install` 会打印私有链接(`http://127.0.0.1:17423/?token=…`)。
|
|
63
|
+
令牌可访问你的工作区,请妥善保管链接。
|
|
37
64
|
|
|
38
65
|
## 使用
|
|
39
66
|
|
|
40
|
-
###
|
|
41
|
-
|
|
42
|
-
1. 打开一次打印出的链接;浏览器之后会记住你。
|
|
43
|
-
如果丢失了链接,`cadence token-link --reveal` 会再次打印它。
|
|
44
|
-
2. 用右下角的按钮选择工作文件夹;最近文件夹也在同一个选择器中。
|
|
45
|
-
首次使用直接在对话界面引导选择,之后访问会恢复上次可用的文件夹,无需进入独立的工作台或项目首页。
|
|
46
|
-
发送时复用已保存的模型偏好;没有可用偏好时只需选择一次。
|
|
47
|
-
3. 输入一次 `/cadence [目标]`,当前对话进入持续 Cadence 模式;之后正常对话,调查项目并澄清影响交付的关键问题。
|
|
48
|
-
4. 查看完整计划,点击**按此计划实施**或发送 `按计划实施`。
|
|
49
|
-
后台自动实施、诊断故障、调整路线、维护项目知识并验证交付,普通内部问题无需再次确认。
|
|
50
|
-
5. 在同一对话查看真实进度和合并结果;子代理的完整上下文从左下角**子代理**面板打开。
|
|
51
|
-
刷新、完成目标后仍保持 Cadence;**退出 Cadence**不取消后台工作,**取消工作流 — 请求停止**才请求取消。
|
|
52
|
-
|
|
53
|
-
### 在终端中:一次进入,持续对话
|
|
54
|
-
|
|
55
|
-
在任意已信任项目的 Pi 对话里输入一次 `/cadence <目标>`,之后正常对话即可。
|
|
56
|
-
Cadence 自动调查仓库和项目知识,只澄清真正影响结果的问题,并生成包含目标、验收、范围、环境准备和本地交付方式的约定。
|
|
57
|
-
确认后输入 `按计划实施`,系统自主实施、诊断、接续部分成果和调整技术路线,之后不再向你提问;没有固定修复轮数或总交付时长配额,真实验证后再交付。
|
|
58
|
-
目标、决定、验收标准和约定里列出的假设保持批准时的样子;某条验收确实做不到时,交付最接近的可行结果,并在报告开头说明这处偏离。
|
|
59
|
-
每个获批的 Git 交付创建一个命名任务分支和稳定 worktree,互不依赖的任务在旁边的临时 worktree 里并行执行,审查与验证后合回约定中的原分支。
|
|
60
|
-
Worker 会拿到与所改代码对应的文档和章节;每次交付结束时整理 `.cadence/` 下一个有固定预算的小型知识库,新经验会替换或压缩旧内容,无需单独的知识管理命令。
|
|
61
|
-
`CADENCE_PARALLEL`(默认 4)决定一次运行中同时活动的 worker 数量。
|
|
62
|
-
进入模式和只读研究不会创建 Git 资源;不会默认推送、发布或部署。
|
|
63
|
-
非 Git 项目可选择直接工作副本交付,不执行提交或合并。
|
|
64
|
-
|
|
65
|
-
**完成任务后,这个对话仍然保持 Cadence 模式,不需要再次输入 `/cadence`。**
|
|
66
|
-
明确输入 `退出 Cadence` 或 `exit cadence` 才退出。
|
|
67
|
-
退出、关闭 Pi 或切换对话只脱离观察,不取消已接受的工作;需要取消时直接告诉 Cadence。
|
|
68
|
-
|
|
69
|
-
日常原生使用可按需启动或复用本地项目 owner,**无需安装系统服务或先进入项目管理器**。
|
|
70
|
-
模型偏好记在 `~/.pi/agent/cadence/settings.json`,跨项目复用,不复制 Pi 凭据。
|
|
71
|
-
项目知识优先维护在已有工程文档中,`.cadence/project.md` 作为简洁索引;相关内容在工作者启动时按需注入,交付时自动沉淀已验证经验。
|
|
72
|
-
隔离 worktree 不会自动复制依赖或凭据,必要的准备命令会列入确认。
|
|
73
|
-
|
|
74
|
-
详细边界见 [对话模式](docs/conversation-mode.md)。
|
|
75
|
-
`/cadence-history [运行 ID]` 提供只读诊断、运行详情和已有任务历史,不创建或执行任务,也不启动服务。
|
|
76
|
-
见[历史与诊断](docs/history.md)。
|
|
77
|
-
浏览器批准与所展示的计划、会话和访问身份绑定;登录本身不是执行授权。
|
|
78
|
-
|
|
79
|
-
### 更多项目
|
|
67
|
+
### 浏览器
|
|
80
68
|
|
|
81
|
-
|
|
82
|
-
|
|
83
|
-
|
|
84
|
-
|
|
69
|
+
1. 打开打印出的链接一次(`cadence token-link --reveal` 可再次打印)。
|
|
70
|
+
2. 用右下角按钮选择工作文件夹。
|
|
71
|
+
3. 发送 `/cadence [目标]`,回答澄清问题。
|
|
72
|
+
4. 点击 **Implement this plan**,在看板和 **Subagents** 面板中跟进。
|
|
73
|
+
图片可粘贴或拖入([详情](docs/conversation-mode.md#images-in-the-webui))。
|
|
85
74
|
|
|
86
|
-
|
|
87
|
-
在 WebUI 中,选择文件夹只切换对话上下文,发送时才按需启动或复用其 owner。
|
|
88
|
-
切换文件夹不会停止之前文件夹中正在运行的工作。
|
|
75
|
+
### 终端
|
|
89
76
|
|
|
90
|
-
|
|
77
|
+
在受信任项目的 Pi 对话里输入一次 `/cadence <目标>`;目标完成后模式仍保持开启。
|
|
78
|
+
`exit cadence` 或 `退出 Cadence` 退出模式,不会取消已接受的工作。
|
|
79
|
+
`/cadence-history [run-id]` 为只读。
|
|
80
|
+
`CADENCE_PARALLEL`(默认 4)设置并发 worker 数。
|
|
81
|
+
详情:[对话模式](docs/conversation-mode.md)、[历史](docs/history.md)。
|
|
91
82
|
|
|
92
|
-
|
|
93
|
-
|
|
83
|
+
```sh
|
|
84
|
+
cadence project open /absolute/project # 每个项目独立的 owner、端口与历史
|
|
85
|
+
```
|
|
94
86
|
|
|
95
87
|
## 管理服务
|
|
96
88
|
|
|
97
89
|
```sh
|
|
98
90
|
cadence server status
|
|
99
91
|
cadence server restart # 升级或修改 .env / models.json 之后
|
|
100
|
-
cadence server upgrade #
|
|
101
|
-
cadence server stop
|
|
102
|
-
cadence server uninstall # 在 npm uninstall -g
|
|
92
|
+
cadence server upgrade # 下载、安装、重启;新版本无法启动则回退
|
|
93
|
+
cadence server stop
|
|
94
|
+
cadence server uninstall # 在 npm uninstall -g 之前
|
|
95
|
+
cadence doctor # 残留与最近的恢复;--fix 处理其余
|
|
103
96
|
```
|
|
104
97
|
|
|
105
|
-
|
|
106
|
-
|
|
107
|
-
uninstall 只删除服务定义;项目、历史和 Pi 设置保留。
|
|
108
|
-
Linux root 与命名服务、远程 HTTPS 访问和恢复见[服务管理](docs/service-management.md)和[远程访问](docs/remote-access.md)。
|
|
98
|
+
崩溃或断电无需清理:下次启动会自动恢复并说明做了什么。
|
|
99
|
+
见[服务管理](docs/service-management.md)与[远程访问](docs/remote-access.md)。
|
|
109
100
|
|
|
110
101
|
## 开发
|
|
111
102
|
|
|
112
|
-
Pi
|
|
113
|
-
Cadence
|
|
103
|
+
Pi 也可加载本地检出或打包的 tarball:把它的绝对或相对路径加入 Pi 的 `packages`,或试用 `pi -e ./cadence`。
|
|
104
|
+
Cadence 需要 Pi 1.5.0 或兼容的 1.x 宿主;开发固定版本和测试过的运行时不是通用兼容性承诺。
|
|
114
105
|
|
|
115
106
|
```sh
|
|
116
107
|
bun install
|
|
117
108
|
bun run verify
|
|
118
109
|
```
|
|
119
110
|
|
|
120
|
-
|
|
121
|
-
`verify`
|
|
122
|
-
需要官方 Node 构建和私有临时目录;见[验证](engineering/verification.md)。
|
|
111
|
+
按领域划分的说明见 [engineering/](engineering/) 与 [AGENTS.md](AGENTS.md)。
|
|
112
|
+
`verify` 是唯一的快速门禁,需要官方 Node 构建和私有临时目录([验证](engineering/verification.md))。
|
|
123
113
|
|
|
124
114
|
## 许可证
|
|
125
115
|
|
|
126
|
-
|
|
127
|
-
|
|
116
|
+
MIT。
|
|
117
|
+
随附的改编、字体和第三方组件保留各自的许可证:[复用与分发](docs/reuse-and-distribution.md)、[第三方声明](THIRD_PARTY_NOTICES.md)。
|
|
@@ -20,6 +20,7 @@ The retired shell-local controller is not a shipped competing executor.
|
|
|
20
20
|
|
|
21
21
|
`provenance/package-members.json` is a reviewed source/import/asset policy, not generated from the archive being tested.
|
|
22
22
|
The real pack audit rejects missing/extra/duplicate/linked/special/unsafe members, altered bodies, pin/notice/font drift and linked extraction roots/ancestors.
|
|
23
|
+
The pack gate also parses each shipped module and rejects a relative runtime import the archive does not contain, so a module left out of `files` cannot reach an installed Pi.
|
|
23
24
|
Extracted tests use tar-only package bodies and explicitly linked existing fixture peers; they never fill missing package files from source.
|
|
24
25
|
No version bump, dependency install or publication is implied by this redesign.
|
|
25
26
|
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@abelxiaoxing/cadence",
|
|
3
|
-
"version": "2.1.
|
|
3
|
+
"version": "2.1.1",
|
|
4
4
|
"description": "Conversation-driven Pi workspace: persistent native and WebUI workflows, explicit plan approval, checks and local delivery.",
|
|
5
5
|
"license": "MIT",
|
|
6
6
|
"type": "module",
|
|
@@ -97,7 +97,10 @@
|
|
|
97
97
|
"src/service/liveness.ts",
|
|
98
98
|
"src/agent-browser",
|
|
99
99
|
"src/activity.ts",
|
|
100
|
-
"src/service/activity-files.ts"
|
|
100
|
+
"src/service/activity-files.ts",
|
|
101
|
+
"src/service/project-knowledge.ts",
|
|
102
|
+
"src/service/knowledge-store.ts",
|
|
103
|
+
"src/service/workflow-git.ts"
|
|
101
104
|
],
|
|
102
105
|
"pi": {
|
|
103
106
|
"extensions": [
|