truthmark 2.3.0 → 2.3.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.md +119 -157
- package/dist/main.js +198 -44
- package/dist/main.js.map +1 -1
- package/docs/README.md +45 -33
- package/docs/assets/truthmark-workflow-mobile.svg +118 -0
- package/docs/assets/truthmark-workflow.svg +182 -0
- package/docs/readmes/README.ar.md +125 -151
- package/docs/readmes/README.de.md +127 -153
- package/docs/readmes/README.el.md +127 -153
- package/docs/readmes/README.es.md +125 -151
- package/docs/readmes/README.fr.md +125 -151
- package/docs/readmes/README.id.md +126 -152
- package/docs/readmes/README.it.md +125 -151
- package/docs/readmes/README.ja.md +126 -152
- package/docs/readmes/README.ko.md +127 -153
- package/docs/readmes/README.pl.md +125 -151
- package/docs/readmes/README.pt.md +126 -152
- package/docs/readmes/README.ru.md +124 -150
- package/docs/readmes/README.tr.md +125 -151
- package/docs/readmes/README.vi.md +126 -152
- package/docs/readmes/README.zh.md +128 -154
- package/package.json +3 -1
|
@@ -1,220 +1,194 @@
|
|
|
1
1
|
# Truthmark
|
|
2
2
|
|
|
3
|
-
**Các tác
|
|
3
|
+
**Các tác nhân của bạn viết mã. Truthmark duy trì tài liệu dành cho con người và sẵn sàng để xem xét trong Git.**
|
|
4
4
|
|
|
5
|
-
|
|
6
|
-
|
|
7
|
-
|
|
8
|
-
|
|
9
|
-
## 🚀 Bắt đầu nhanh: chạy cục bộ trong năm phút
|
|
10
|
-
|
|
11
|
-
Chạy lệnh này bên trong kho Git mà bạn muốn Truthmark quản lý:
|
|
12
|
-
|
|
13
|
-
```bash
|
|
14
|
-
cd /path/to/your-repo
|
|
15
|
-
npm install -g truthmark
|
|
16
|
-
truthmark init
|
|
17
|
-
truthmark check
|
|
18
|
-
git diff
|
|
19
|
-
```
|
|
20
|
-
|
|
21
|
-
Trong terminal tương tác, `truthmark init` hiển thị danh sách đa lựa chọn được đánh số. Chọn không, một hoặc nhiều nền tảng, hoặc nhập `none` để thiết lập chỉ dùng CLI và không gắn với host.
|
|
5
|
+
Truthmark cài đặt các quy trình làm việc gốc Git, giúp tác nhân lập trình AI tạo tài liệu sản phẩm và kỹ thuật mới từ mã cùng các bài kiểm thử hiện có, giữ tài liệu luôn cập nhật sau mỗi thay đổi mã và cung cấp cho bạn các diff Markdown thông thường để xem xét.
|
|
22
6
|
|
|
23
|
-
|
|
7
|
+
[](https://www.npmjs.com/package/truthmark)
|
|
8
|
+
[](https://github.com/merlinhu1/truthmark/actions/workflows/ci.yml)
|
|
9
|
+
[](../../LICENSE)
|
|
10
|
+
[](../../package.json)
|
|
24
11
|
|
|
25
|
-
|
|
26
|
-
truthmark init --platform codex --platform cursor
|
|
27
|
-
truthmark init --json
|
|
28
|
-
```
|
|
12
|
+
[Bắt đầu](#bắt-đầu-nhanh-tạo-tài-liệu-truth-đầu-tiên) · [Trang web](https://merlinhu1.github.io/truthmark/) · [Hướng dẫn người dùng](https://github.com/merlinhu1/truthmark/blob/main/docs/user-guide.md) · [GitHub](https://github.com/merlinhu1/truthmark)
|
|
29
13
|
|
|
30
|
-
|
|
14
|
+
<details>
|
|
15
|
+
<summary>Đọc README này bằng một trong 16 ngôn ngữ</summary>
|
|
31
16
|
|
|
32
|
-
|
|
33
|
-
|
|
34
|
-
```text
|
|
35
|
-
/truthmark-document document the implemented session timeout behavior across src/auth/session.ts and tests/auth/session.test.ts
|
|
36
|
-
```
|
|
17
|
+
[🇺🇸 English](../../README.md) | [🇨🇳 简体中文](README.zh.md) | [🇯🇵 日本語](README.ja.md) | [🇰🇷 한국어](README.ko.md) | [🇩🇪 Deutsch](README.de.md) | [🇫🇷 Français](README.fr.md) | [🇪🇸 Español](README.es.md) | [🇧🇷 Português](README.pt.md) | [🇷🇺 Русский](README.ru.md) | [🇸🇦 العربية](README.ar.md) | [🇮🇹 Italiano](README.it.md) | [🇵🇱 Polski](README.pl.md) | [🇹🇷 Türkçe](README.tr.md) | [🇻🇳 Tiếng Việt](README.vi.md) | [🇮🇩 Bahasa Indonesia](README.id.md) | [🇬🇷 Ελληνικά](README.el.md)
|
|
37
18
|
|
|
38
|
-
|
|
19
|
+
</details>
|
|
39
20
|
|
|
40
|
-
|
|
21
|
+
## Tạo tài liệu đầu tiên. Giữ tài liệu luôn đúng.
|
|
41
22
|
|
|
42
|
-
|
|
23
|
+
Hầu hết công cụ tài liệu dừng lại sau khi tạo nội dung. Truthmark mang đến cho tác nhân một vòng đời tài liệu hoàn chỉnh ngay trong kho mã của bạn:
|
|
43
24
|
|
|
44
|
-
|
|
25
|
+
- **Tạo tài liệu mới từ phần mềm đang hoạt động.** Truth Document đọc mã và các bài kiểm thử, sau đó tạo tài liệu sản phẩm hoặc kỹ thuật có phạm vi rõ ràng.
|
|
26
|
+
- **Tự động giữ tài liệu luôn đồng bộ.** Truth Sync chạy khi tác nhân bàn giao sau các thay đổi mã chức năng và cập nhật sự thật của kho trước khi công việc hoàn tất.
|
|
27
|
+
- **Biến tài liệu trở lại thành mã.** Truth Realize triển khai các tài liệu truth đã được phê duyệt mà vẫn duy trì quy trình doc-first rõ ràng.
|
|
28
|
+
- **Sửa quyền sở hữu khi cơ sở mã phát triển.** Truth Structure tạo các tuyến có phạm vi rõ ràng và tài liệu khởi đầu cho khu vực mới hoặc quá tải.
|
|
29
|
+
- **Xem xét mọi thứ trong Git.** Mã, quyết định, hợp đồng, kiến trúc, vận hành và hành vi cùng di chuyển với nhánh.
|
|
45
30
|
|
|
46
|
-
|
|
47
|
-
* Tài liệu kiến trúc nhanh chóng tụt lại phía sau.
|
|
48
|
-
* Quyết định sản phẩm biến mất sau khi bàn giao.
|
|
49
|
-
* Người xem xét mã phải xem các diff mã thô mà không hiểu "vì sao".
|
|
50
|
-
* Mỗi phiên AI mới buộc phải khám phá lại sự thật của kho từ đầu.
|
|
31
|
+
Không cơ sở tri thức được lưu trữ trên máy chủ. Không bộ nhớ tác nhân riêng tư. Không tài liệu bị mắc kẹt trong lịch sử trò chuyện.
|
|
51
32
|
|
|
52
|
-
##
|
|
33
|
+
## Bắt đầu nhanh: tạo tài liệu truth đầu tiên
|
|
53
34
|
|
|
54
|
-
**
|
|
35
|
+
**Yêu cầu:** Node.js 24 trở lên, một kho Git và một host lập trình AI được hỗ trợ cho quy trình làm việc của tác nhân.
|
|
55
36
|
|
|
56
|
-
|
|
37
|
+
Chạy các lệnh sau trong kho mà bạn muốn Truthmark quản lý:
|
|
57
38
|
|
|
58
|
-
|
|
39
|
+
```bash
|
|
40
|
+
cd /path/to/your-repo
|
|
41
|
+
npm install -g truthmark
|
|
42
|
+
truthmark init
|
|
43
|
+
```
|
|
59
44
|
|
|
60
|
-
|
|
45
|
+
`truthmark init` cho phép bạn chọn Codex, Claude Code, GitHub Copilot, OpenCode, Antigravity, Cursor hoặc thiết lập giao diện dòng lệnh trung lập với host.
|
|
61
46
|
|
|
62
|
-
|
|
63
|
-
* **🌳 100% gốc Git:** Mọi thứ nằm trong kho của bạn. Sự thật di chuyển cùng nhánh của bạn.
|
|
64
|
-
* **🤝 Hợp đồng do con người sở hữu, tác tử tuân theo:** Người bảo trì sở hữu hợp đồng kho; tác tử tuân theo hướng dẫn đã cài đặt khi viết mã.
|
|
65
|
-
* **✅ Tin cậy qua xác minh:** Công việc AI dễ được tin tưởng hơn vì công việc thay đổi hành vi bao gồm một quyết định hoặc diff tài liệu sự thật mà con người có thể xem xét.
|
|
47
|
+
Bây giờ, hãy yêu cầu tác nhân đã cấu hình ghi tài liệu cho một hành vi thực tế:
|
|
66
48
|
|
|
67
|
-
|
|
49
|
+
```text
|
|
50
|
+
/truthmark-document document the implemented session timeout behavior across src/auth/session.ts and tests/auth/session.test.ts
|
|
51
|
+
```
|
|
68
52
|
|
|
69
|
-
|
|
53
|
+
Truth Document tạo một tài liệu truth mới có phạm vi rõ ràng khi chưa có tài liệu nào, cập nhật tài liệu sở hữu hiện có khi đã có và cập nhật định tuyến khi cần. Quy trình này không thay đổi mã chức năng.
|
|
70
54
|
|
|
71
|
-
|
|
72
|
-
2. 🧪 **Kiểm thử:** Các kiểm thử liên quan được chạy.
|
|
73
|
-
3. 🔍 **Kiểm tra:** Truthmark kiểm tra tài liệu được ánh xạ như một phần của bước xem xét kết thúc đã cài đặt.
|
|
74
|
-
4. 📝 **Ghi tài liệu:** Tài liệu được tác tử cập nhật khi sự thật của kho thay đổi.
|
|
75
|
-
5. 👀 **Xem xét:** Con người xem xét *diff mã* + *diff sự thật*.
|
|
55
|
+
Xem xét kết quả:
|
|
76
56
|
|
|
77
|
-
|
|
57
|
+
```bash
|
|
58
|
+
truthmark check
|
|
59
|
+
git status --short --untracked-files=all
|
|
60
|
+
git diff
|
|
61
|
+
```
|
|
78
62
|
|
|
79
|
-
|
|
63
|
+
Giờ đây bạn sẽ có:
|
|
80
64
|
|
|
81
|
-
|
|
65
|
+
```text
|
|
66
|
+
docs/truthmark/engineering/behaviors/session-timeout.md
|
|
67
|
+
docs/truthmark/routes/areas/authentication.md
|
|
68
|
+
```
|
|
82
69
|
|
|
83
|
-
|
|
70
|
+
Đường dẫn chính xác tuân theo cấu trúc quyền sở hữu của kho. Tệp mới xuất hiện trong `git status`; thay đổi đối với tệp được theo dõi xuất hiện trong `git diff`.
|
|
84
71
|
|
|
85
|
-
|
|
86
|
-
* `truthmark check` - xác thực sự thật của kho từ terminal.
|
|
72
|
+
Cách gọi khác nhau tùy theo host. OpenCode dùng `/skill truthmark-document`, Antigravity dùng `@truthmark-document`, còn các host được hỗ trợ khác dùng bề mặt skill hoặc lệnh gạch chéo gốc của mình. Xem [bảng nền tảng](https://github.com/merlinhu1/truthmark/blob/main/docs/user-guide.md#supported-agent-platforms) để biết chính xác các lệnh.
|
|
87
73
|
|
|
88
|
-
|
|
74
|
+
Đối với script và tích hợp liên tục, hãy truyền rõ các nền tảng đã chọn:
|
|
89
75
|
|
|
90
|
-
|
|
76
|
+
```bash
|
|
77
|
+
truthmark init --platform codex --platform cursor
|
|
78
|
+
truthmark init --json
|
|
79
|
+
```
|
|
91
80
|
|
|
92
|
-
|
|
81
|
+
Chọn `none` trong chế độ tương tác hoặc chạy `truthmark init --clear-platforms` để có một kho trung lập với host. Bạn có thể thêm nền tảng tác nhân sau bằng cách chạy lại `truthmark init`.
|
|
93
82
|
|
|
94
|
-
|
|
95
|
-
2. Hướng dẫn đã cài đặt cho tác tử biết khi nào cần kiểm thử, khi nào cập nhật truth docs và khi nào dừng để con người xem xét.
|
|
96
|
-
3. Bạn xem xét các Git diff thông thường: mã cộng với mọi thay đổi truth-doc.
|
|
83
|
+
Để chẩn đoán độ mới theo nhánh, hãy truyền một mốc Git cơ sở:
|
|
97
84
|
|
|
98
|
-
|
|
85
|
+
```bash
|
|
86
|
+
truthmark check --base <base-ref>
|
|
87
|
+
```
|
|
99
88
|
|
|
100
|
-
|
|
101
|
-
* `/truthmark-realize` - triển khai mã từ truth docs hiện có.
|
|
102
|
-
* `/truthmark-check` - kiểm toán sự thật của kho.
|
|
89
|
+
## Cách Truthmark hoạt động
|
|
103
90
|
|
|
104
|
-
|
|
105
|
-
|
|
91
|
+
<picture>
|
|
92
|
+
<source media="(max-width: 700px)" srcset="../assets/truthmark-workflow-mobile.svg">
|
|
93
|
+
<img src="../assets/truthmark-workflow.svg" alt="Cách Truthmark hoạt động" width="1440">
|
|
94
|
+
</picture>
|
|
106
95
|
|
|
107
|
-
|
|
96
|
+
Giao diện dòng lệnh Truthmark cài đặt và xác thực hợp đồng của kho. Tác nhân lập trình của bạn thực hiện việc xem xét bằng chứng và viết tài liệu thông qua các quy trình gốc của host đã được cài đặt.
|
|
108
97
|
|
|
109
|
-
|
|
110
|
-
| --- | --- |
|
|
111
|
-
| Sự thật gốc Git | Giữ sự thật của kho trong Markdown và cấu hình đã commit. |
|
|
112
|
-
| Tài liệu theo phạm vi nhánh | Sự thật di chuyển cùng nhánh thay vì sống trong một phiên riêng tư. |
|
|
113
|
-
| CLI dành cho con người | Cung cấp cho người bảo trì các lệnh thiết lập, làm mới, xác thực và kiểm tra. |
|
|
114
|
-
| Hướng dẫn tác tử đã cài đặt | Cho tác tử lập trình biết khi nào ghi tài liệu, kiểm thử, đồng bộ sự thật, kiểm toán hoặc dừng để xem xét. |
|
|
115
|
-
| Định tuyến rõ ràng | Ánh xạ các vùng mã tới tài liệu sự thật chuẩn. |
|
|
116
|
-
| Bàn giao có thể xem xét | Tạo các diff Git thông thường cho cả mã và tài liệu sự thật. |
|
|
117
|
-
| Vận hành ưu tiên cục bộ | Không yêu cầu dịch vụ lưu trữ, daemon, cơ sở dữ liệu hoặc máy chủ MCP. |
|
|
118
|
-
| Ranh giới ghi an toàn hơn | Tách các quy trình code-first, doc-first, chỉ đọc và chỉ tài liệu. |
|
|
119
|
-
| Xác thực | Báo cáo vấn đề về định tuyến, thẩm quyền, frontmatter, liên kết, bề mặt sinh ra, phạm vi nhánh, độ mới và độ phủ. |
|
|
120
|
-
| Portal tùy chọn | Tạo một trang trình bày HTML tĩnh đã commit từ tài liệu sự thật Markdown khi được bật và yêu cầu rõ ràng. |
|
|
98
|
+
Một thay đổi mã thông thường đi theo một vòng lặp đơn giản:
|
|
121
99
|
|
|
122
|
-
|
|
100
|
+
1. Tác nhân thay đổi mã chức năng.
|
|
101
|
+
2. Các bài kiểm thử liên quan được chạy.
|
|
102
|
+
3. Truth Sync kiểm tra tài liệu đã được ánh xạ.
|
|
103
|
+
4. Tác nhân tạo hoặc cập nhật tài liệu và định tuyến khi sự thật của kho đã thay đổi.
|
|
104
|
+
5. Bạn xem xét diff mã và diff truth cùng nhau.
|
|
123
105
|
|
|
124
|
-
|
|
106
|
+
## Quy trình làm việc
|
|
125
107
|
|
|
126
|
-
|
|
108
|
+
| Quy trình | Dùng khi | Kết quả |
|
|
109
|
+
| -------------------- | ---------------------------------------------------------------- | ---------------------------------------------------------------------- |
|
|
110
|
+
| **Truth Document** | Mã hiện có cần được ghi tài liệu | Tạo hoặc cập nhật tài liệu sản phẩm và kỹ thuật dựa trên bằng chứng |
|
|
111
|
+
| **Truth Sync** | Mã chức năng đã thay đổi | Giữ tài liệu đã ánh xạ và định tuyến đồng bộ trước khi bàn giao |
|
|
112
|
+
| **Truth Structure** | Khu vực mới cần quyền sở hữu hoặc tài liệu hiện có quá rộng | Tạo các tuyến có phạm vi rõ ràng và tài liệu khởi đầu dạng khung |
|
|
113
|
+
| **Truth Realize** | Một tài liệu truth đã phê duyệt cần trở thành phần mềm hoạt động | Cập nhật mã chức năng từ tài liệu |
|
|
114
|
+
| **Truth Check** | Sự thật của kho cần được kiểm tra | Báo cáo vấn đề về định tuyến, quyền sở hữu, bằng chứng và tài liệu |
|
|
115
|
+
| **Truthmark Portal** | Nhóm muốn có một trang tài liệu dễ duyệt | Tạo bản trình bày HTML tĩnh được commit từ các tài liệu truth Markdown |
|
|
127
116
|
|
|
128
|
-
|
|
117
|
+
Truthmark cài đặt các quy trình này dưới dạng bề mặt gốc của kho cho Codex, Claude Code, GitHub Copilot, OpenCode, Antigravity và Cursor.
|
|
129
118
|
|
|
130
|
-
|
|
119
|
+
## Những gì bạn nhận được
|
|
131
120
|
|
|
132
|
-
|
|
121
|
+
### Tài liệu bắt đầu từ thực tế
|
|
133
122
|
|
|
134
|
-
|
|
123
|
+
Truthmark có thể tạo tài liệu cho năng lực sản phẩm, hành vi triển khai, giao diện lập trình ứng dụng, kiến trúc, quy trình làm việc, vận hành và kiểm thử. Mã cùng các bài kiểm thử cung cấp bằng chứng; tài liệu Markdown có phạm vi rõ ràng lưu giữ kết quả.
|
|
135
124
|
|
|
136
|
-
|
|
125
|
+
### Tài liệu vẫn bền vững qua thay đổi tiếp theo
|
|
137
126
|
|
|
138
|
-
|
|
127
|
+
Các tuyến kết nối khu vực mã với tài liệu chuẩn. Khi tác nhân thay đổi hành vi, Truth Sync biết sự thật tương ứng thuộc về đâu và giữ cho phần bàn giao luôn sẵn sàng để xem xét.
|
|
139
128
|
|
|
140
|
-
|
|
129
|
+
### Sự thật sản phẩm và kỹ thuật trên các luồng riêng biệt
|
|
141
130
|
|
|
142
|
-
|
|
131
|
+
Sự thật sản phẩm ghi lại cam kết hướng tới người dùng, ranh giới, quyết định và tiêu chí chấp nhận. Sự thật kỹ thuật ghi lại hành vi hiện tại, hợp đồng, kiến trúc, quy trình làm việc, vận hành và hành vi kiểm thử.
|
|
143
132
|
|
|
144
|
-
|
|
133
|
+
### Cộng tác gốc Git
|
|
145
134
|
|
|
146
|
-
|
|
135
|
+
Mọi thứ quan trọng đều nằm trong các tệp kho đã commit. Sự thật đi theo nhánh, hoạt động với pull request thông thường và luôn hiển thị với mọi người bảo trì cùng tác nhân lập trình.
|
|
147
136
|
|
|
148
|
-
|
|
137
|
+
### Vận hành ưu tiên cục bộ
|
|
149
138
|
|
|
150
|
-
|
|
151
|
-
- bàn giao tốt hơn
|
|
152
|
-
- sự thật sản phẩm theo từng nhánh
|
|
153
|
-
- tài liệu kiến trúc và API bền vững
|
|
154
|
-
- quyền sở hữu rõ ràng giữa tài liệu và mã
|
|
155
|
-
- ranh giới ghi an toàn hơn cho tác tử
|
|
156
|
-
- tài liệu có thể xem xét thay vì bộ nhớ ẩn
|
|
157
|
-
- quy trình AI vẫn hoạt động từ các tệp kho đã commit
|
|
139
|
+
Truthmark không cần dịch vụ lưu trữ, daemon, cơ sở dữ liệu, kho vector hay máy chủ Model Context Protocol. Kho tự mang theo quy trình tài liệu của mình.
|
|
158
140
|
|
|
159
141
|
## Truthmark phù hợp ở đâu
|
|
160
142
|
|
|
161
|
-
|
|
162
|
-
|
|
163
|
-
|
|
164
|
-
|
|
165
|
-
|
|
|
166
|
-
|
|
|
167
|
-
|
|
|
168
|
-
|
|
|
169
|
-
| Làm tính năng theo kế hoạch trước | Quy trình đặc tả |
|
|
170
|
-
| Truth theo nhánh đi cùng mã | Truthmark |
|
|
171
|
-
| Xác thực tính đúng của hành vi | Kiểm thử và xem xét |
|
|
172
|
-
| Xem xét thay đổi tài liệu do AI hỗ trợ | Truthmark cộng với xem xét Git |
|
|
173
|
-
|
|
174
|
-
Làn đường của Truthmark được thiết kế có chủ ý là hẹp:
|
|
143
|
+
| Nhu cầu | Phù hợp nhất |
|
|
144
|
+
| ---------------------------------------- | --------------------------------- |
|
|
145
|
+
| Đầu ra tốt hơn từ một phiên tác nhân | Prompt tốt hơn |
|
|
146
|
+
| Tính liên tục cá nhân hoặc theo phiên | Công cụ bộ nhớ |
|
|
147
|
+
| Phát triển tính năng theo kế hoạch trước | Quy trình đặc tả |
|
|
148
|
+
| Tài liệu theo phạm vi nhánh đi cùng mã | **Truthmark** |
|
|
149
|
+
| Tính đúng đắn của hành vi | Kiểm thử và xem xét mã |
|
|
150
|
+
| Tài liệu có AI hỗ trợ và có thể xem xét | **Truthmark + xem xét trong Git** |
|
|
175
151
|
|
|
176
|
-
|
|
177
|
-
make repository truth explicit
|
|
178
|
-
route it to code
|
|
179
|
-
cài đặt hướng dẫn tác tử quanh nó
|
|
180
|
-
keep the result reviewable in Git
|
|
181
|
-
```
|
|
182
|
-
|
|
183
|
-
## Tìm hiểu sâu hơn
|
|
152
|
+
Truthmark được xây dựng cho người bảo trì và các nhóm kỹ thuật đã dùng tác nhân lập trình AI, đồng thời muốn kho luôn nói đúng sự thật nhanh như tốc độ thay đổi của mã.
|
|
184
153
|
|
|
185
|
-
|
|
154
|
+
## Host được hỗ trợ và dòng lệnh
|
|
186
155
|
|
|
187
|
-
|
|
156
|
+
Các host tác nhân được hỗ trợ:
|
|
188
157
|
|
|
189
|
-
|
|
158
|
+
- Codex
|
|
159
|
+
- Claude Code
|
|
160
|
+
- GitHub Copilot
|
|
161
|
+
- OpenCode
|
|
162
|
+
- Antigravity
|
|
163
|
+
- Cursor
|
|
190
164
|
|
|
191
|
-
|
|
165
|
+
<details>
|
|
166
|
+
<summary>Tham chiếu dòng lệnh</summary>
|
|
192
167
|
|
|
193
|
-
|
|
194
|
-
|
|
195
|
-
|
|
196
|
-
|
|
168
|
+
| Lệnh | Mục đích |
|
|
169
|
+
| ----------------------------------------------------------------- | --------------------------------------------------------------------------------------------- |
|
|
170
|
+
| `truthmark init` | Tạo hoặc làm mới cấu hình, định tuyến, mẫu và quy trình của các host đã chọn |
|
|
171
|
+
| `truthmark check [--base <ref>]` | Xác thực sự thật của kho và tùy chọn chạy chẩn đoán độ mới theo nhánh |
|
|
172
|
+
| `truthmark index --json` | Kiểm tra siêu dữ liệu dẫn xuất về kho và định tuyến |
|
|
173
|
+
| `truthmark impact --base <ref> --json` | Ánh xạ tệp đã thay đổi tới tài liệu, chủ sở hữu và các bài kiểm thử lân cận |
|
|
174
|
+
| `truthmark workflow status --workflow <id> [--base <ref>] --json` | Kiểm tra khả năng áp dụng và mục tiêu của quy trình |
|
|
175
|
+
| `truthmark validate ...` | Xác thực báo cáo quy trình và quyền thuê ghi |
|
|
176
|
+
| `truthmark uninstall --dry-run\|--apply` | Xem trước hoặc xóa các bề mặt host đã tạo trong khi vẫn giữ tài liệu truth do người dùng viết |
|
|
197
177
|
|
|
198
|
-
|
|
178
|
+
Đầu ra JSON có cấu trúc được cung cấp trên toàn bộ giao diện dòng lệnh cho script và tích hợp liên tục.
|
|
199
179
|
|
|
200
|
-
|
|
201
|
-
- [Chỉ mục tài liệu](../README.md)
|
|
202
|
-
- [Tổng quan kiến trúc](../truthmark/engineering/architecture/overview.md)
|
|
203
|
-
- [Hợp đồng API và CLI](../truthmark/engineering/contracts/config-route-and-check-contracts.md)
|
|
204
|
-
- [Hướng dẫn bảo trì sự thật của kho](../standards/maintaining-repository-truth.md)
|
|
180
|
+
</details>
|
|
205
181
|
|
|
206
|
-
|
|
182
|
+
## Tìm hiểu thêm
|
|
207
183
|
|
|
208
|
-
|
|
184
|
+
- [Hướng dẫn người dùng Truthmark](https://github.com/merlinhu1/truthmark/blob/main/docs/user-guide.md)
|
|
185
|
+
- [Chỉ mục tài liệu](https://github.com/merlinhu1/truthmark/blob/main/docs/README.md)
|
|
186
|
+
- [Tổng quan kiến trúc](https://github.com/merlinhu1/truthmark/blob/main/docs/truthmark/engineering/architecture/overview.md)
|
|
187
|
+
- [Hợp đồng cấu hình, định tuyến và lệnh](https://github.com/merlinhu1/truthmark/blob/main/docs/truthmark/engineering/contracts/config-route-and-check-contracts.md)
|
|
188
|
+
- [Đóng góp](https://github.com/merlinhu1/truthmark/blob/main/CONTRIBUTING.md)
|
|
209
189
|
|
|
210
|
-
Truthmark
|
|
211
|
-
|
|
212
|
-
Nó không phải dịch vụ lưu trữ, máy chủ MCP, cơ sở dữ liệu vector, lớp bộ nhớ ẩn, sản phẩm cưỡng chế CI hay động cơ tự động viết lại mã. Nó giúp sự thật của kho luôn hiển thị; nó không thay thế kiểm thử, xem xét mã hay phán đoán của con người.
|
|
190
|
+
**Cài đặt Truthmark, chọn host lập trình và biến một hành vi thực tế thành tài liệu ngay hôm nay.**
|
|
213
191
|
|
|
214
192
|
## Giấy phép
|
|
215
193
|
|
|
216
194
|
MIT. Xem [LICENSE](../../LICENSE).
|
|
217
|
-
|
|
218
|
-
## Gỡ cài đặt an toàn
|
|
219
|
-
|
|
220
|
-
Sử dụng `truthmark uninstall --dry-run` để xem lại chính xác các bề mặt host đã tạo ra, rồi `truthmark uninstall --apply` để loại bỏ chúng. Các truth đã tạo, cấu hình, mẫu, đầu ra Portal, tệp Gemini và các tệp người dùng không liên quan sẽ được giữ nguyên; hãy gỡ bỏ cài đặt npm toàn cục riêng biệt bằng trình quản lý gói của bạn.
|