@fxri/toolkit 1.12.6 → 1.13.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/CHANGELOG.md +25 -0
- package/LICENSE +21 -21
- package/NOTICE +9 -9
- package/README.md +113 -112
- package/TRADEMARK.md +41 -41
- package/dist/cli.cjs +66 -66
- package/dist/cli.js +67 -67
- package/dist/index.cjs +35 -35
- package/dist/index.js +36 -36
- package/package.json +1 -1
- package/skills/README.md +1 -0
- package/skills/fxri-plan-to-task/assets/active-task-template.md +13 -13
- package/skills/fxri-text-encoding/SKILL.md +125 -0
package/CHANGELOG.md
CHANGED
|
@@ -1,5 +1,30 @@
|
|
|
1
1
|
# 方弦工具集
|
|
2
2
|
|
|
3
|
+
## 1.13.1
|
|
4
|
+
|
|
5
|
+
> 2026-11-01 发布
|
|
6
|
+
|
|
7
|
+
### 🐛 问题修复
|
|
8
|
+
|
|
9
|
+
- `conventions status` 与 `tasks check` 的稳定 ID 校验收紧为去补零形态,`C-001` 这类补零写法现会告警并提示改写为 `C-1`
|
|
10
|
+
|
|
11
|
+
## 1.13.0
|
|
12
|
+
|
|
13
|
+
> 2026-10-24 发布
|
|
14
|
+
|
|
15
|
+
### ✨ 新增功能
|
|
16
|
+
|
|
17
|
+
- `fxri-text-encoding` 技能按「乱码三问」定归属(谁的字节 / 还能救吗 / 错在第几跳),附读取方默认解码对照与按 mojibake 特征串选 `iconv` 方向的反向转码命令
|
|
18
|
+
- 技能给出 `.ps1` / `.psm1` / `.psd1` / `.bat` / `.sh` / `.xml` / `.properties` / C 系与 Java 源文件及 Excel CSV 的 UTF-8、BOM 与行尾基线
|
|
19
|
+
- 技能对照 AI 写入工具与 `powershell.exe` / `pwsh` / .NET / Node / Python / `.editorconfig` / `.gitattributes` 的写盘 BOM 与默认编码行为,含 `-Encoding UTF8` 在两种 shell 下同名不同义、`Export-Csv` 省略 `-Encoding` 写 ASCII、Node 读侧残留 `\uFEFF`
|
|
20
|
+
- 技能提供落盘后首三字节自查与 `git ls-files` 全仓巡检,改完即可验
|
|
21
|
+
- 技能覆盖运行期管线断点——控制台代码页、`$OutputEncoding` 与 `>` 重定向、`Get-Content` 解码、Python locale、容器 CI `LANG=C`、Java `file.encoding`
|
|
22
|
+
- 技能记录 `core.autocrlf` 检出转换与 `eol=lf` 不回溯已提交内容、Windows「Beta: 使用 Unicode UTF-8 提供全球语言支持」造成的同文件异机差异、Excel 另存 CSV 的编码走向、不可见字符、全角标点、`�` 不可逆、二次转码等场景
|
|
23
|
+
|
|
24
|
+
### 🔧 功能调整
|
|
25
|
+
|
|
26
|
+
- `docs/ai-rules.md` 代码规范补脚本字节形态铁律(`.ps1` UTF-8 with BOM、`.sh` 无 BOM + LF、`.bat` / `.cmd` 不带 BOM + CRLF),以系统内置的 `powershell.exe` 指代该 shell,指向该技能
|
|
27
|
+
|
|
3
28
|
## 1.12.6
|
|
4
29
|
|
|
5
30
|
> 2026-10-19 发布
|
package/LICENSE
CHANGED
|
@@ -1,21 +1,21 @@
|
|
|
1
|
-
MIT License
|
|
2
|
-
|
|
3
|
-
Copyright © 2026 唐启云
|
|
4
|
-
|
|
5
|
-
Permission is hereby granted, free of charge, to any person obtaining a copy
|
|
6
|
-
of this software and associated documentation files (the "Software"), to deal
|
|
7
|
-
in the Software without restriction, including without limitation the rights
|
|
8
|
-
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
|
|
9
|
-
copies of the Software, and to permit persons to whom the Software is
|
|
10
|
-
furnished to do so, subject to the following conditions:
|
|
11
|
-
|
|
12
|
-
The above copyright notice and this permission notice shall be included in all
|
|
13
|
-
copies or substantial portions of the Software.
|
|
14
|
-
|
|
15
|
-
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
|
|
16
|
-
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
|
|
17
|
-
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
|
|
18
|
-
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
|
|
19
|
-
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
|
|
20
|
-
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
|
|
21
|
-
SOFTWARE.
|
|
1
|
+
MIT License
|
|
2
|
+
|
|
3
|
+
Copyright © 2026 唐启云
|
|
4
|
+
|
|
5
|
+
Permission is hereby granted, free of charge, to any person obtaining a copy
|
|
6
|
+
of this software and associated documentation files (the "Software"), to deal
|
|
7
|
+
in the Software without restriction, including without limitation the rights
|
|
8
|
+
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
|
|
9
|
+
copies of the Software, and to permit persons to whom the Software is
|
|
10
|
+
furnished to do so, subject to the following conditions:
|
|
11
|
+
|
|
12
|
+
The above copyright notice and this permission notice shall be included in all
|
|
13
|
+
copies or substantial portions of the Software.
|
|
14
|
+
|
|
15
|
+
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
|
|
16
|
+
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
|
|
17
|
+
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
|
|
18
|
+
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
|
|
19
|
+
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
|
|
20
|
+
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
|
|
21
|
+
SOFTWARE.
|
package/NOTICE
CHANGED
|
@@ -1,9 +1,9 @@
|
|
|
1
|
-
@fxri/toolkit
|
|
2
|
-
Copyright © 2026 唐启云. All rights reserved.
|
|
3
|
-
|
|
4
|
-
出品方:方弦研究所(唐启云个人项目品牌,非独立法人实体)
|
|
5
|
-
|
|
6
|
-
商标声明:
|
|
7
|
-
"方弦®"为第42类注册商标(注册号89648411),核定服务项目:计算机出租、计算机软件设计、为他人研究和开发新产品、计算机软件维护、把有形的数据或文件转换成电子媒体、为他人创建和维护网站、网络服务器出租、提供互联网搜索引擎、托管计算机站(网站)、云计算。
|
|
8
|
-
本开源许可(MIT License)不授予商标使用权。
|
|
9
|
-
详见 TRADEMARK.md 了解完整商标信息。
|
|
1
|
+
@fxri/toolkit
|
|
2
|
+
Copyright © 2026 唐启云. All rights reserved.
|
|
3
|
+
|
|
4
|
+
出品方:方弦研究所(唐启云个人项目品牌,非独立法人实体)
|
|
5
|
+
|
|
6
|
+
商标声明:
|
|
7
|
+
"方弦®"为第42类注册商标(注册号89648411),核定服务项目:计算机出租、计算机软件设计、为他人研究和开发新产品、计算机软件维护、把有形的数据或文件转换成电子媒体、为他人创建和维护网站、网络服务器出租、提供互联网搜索引擎、托管计算机站(网站)、云计算。
|
|
8
|
+
本开源许可(MIT License)不授予商标使用权。
|
|
9
|
+
详见 TRADEMARK.md 了解完整商标信息。
|
package/README.md
CHANGED
|
@@ -1,112 +1,113 @@
|
|
|
1
|
-
<p align="center">
|
|
2
|
-
<img src="./docs/public/logo.png" width="128" alt="方弦工具集">
|
|
3
|
-
</p>
|
|
4
|
-
|
|
5
|
-
# 方弦工具集
|
|
6
|
-
|
|
7
|
-
[](https://github.com/fxri-net/toolkit/actions/workflows/ci.yml)
|
|
8
|
-
[](https://www.npmjs.com/package/@fxri/toolkit)
|
|
9
|
-
[](./docs/getting-started.md#安装)
|
|
10
|
-
[](./LICENSE)
|
|
11
|
-
|
|
12
|
-
> 国内网络建议优先 [Gitee 镜像](https://gitee.com/fxri/toolkit)(与 GitHub 同源同步,仓库/文档/issues/skills 全渠道可用);问题反馈走 [GitHub Issues](https://github.com/fxri-net/toolkit/issues) 或 [Gitee Issues](https://gitee.com/fxri/toolkit/issues)。
|
|
13
|
-
|
|
14
|
-
专为**多人 + AI 跨项目协作**打造:任务管理 + 多语言 CHANGELOG。
|
|
15
|
-
|
|
16
|
-
AI 参与开发后,方案与决策散落在对话记录里,会话一关什么都不剩;任务记录零散,谁在做、做到哪,无从查起;发版 CHANGELOG 还要人肉维护多语言。本工具把这条链路沉淀为**仓库内可检索、可校验、可归档的文件**——人离开会话,记忆留在仓库里。
|
|
17
|
-
|
|
18
|
-
- **零依赖 AI 技能包(skills)**:方案落盘、发版 CHANGELOG 两套工作流沉淀为 Agent Skills,不绑定任何 AI 工具;skills 可以独立工作,CLI 是可选加速——推荐都装,体验最完整([什么关系?](./docs/faq.md#工具和-skills-都得装吗))
|
|
19
|
-
- **不懂 AI 也能用**:任务管理与 CHANGELOG 是纯 CLI 能力;术语都说了人话([先看术语表](./docs/getting-started.md#几个术语-先说人话))
|
|
20
|
-
|
|
21
|
-
## 🚀 30 秒上手
|
|
22
|
-
|
|
23
|
-
```bash
|
|
24
|
-
# 1. 项目内安装(推荐,团队共享版本)
|
|
25
|
-
pnpm add -D @fxri/toolkit
|
|
26
|
-
|
|
27
|
-
# 2. 初始化任务区(生成 .tasks/ 骨架、conventions/ 规范载体与技能入口壳;含本地依赖时写入 prepare 刷新钩子)
|
|
28
|
-
pnpm exec toolkit init
|
|
29
|
-
|
|
30
|
-
# 3. 查看任务总览
|
|
31
|
-
pnpm exec toolkit tasks
|
|
32
|
-
```
|
|
33
|
-
|
|
34
|
-
之后:方案确认后登记为 `.tasks/` 任务文件 → `pnpm exec toolkit tasks check` 校验 → 完成后 `pnpm exec toolkit tasks archive` 归档并做规范沉淀。多任务 / 多仓方案先出纯展示计划表,再逐仓逐任务建档、按序逐个交付提交。完整步骤见 [新手指南](./docs/getting-started.md)。
|
|
35
|
-
|
|
36
|
-
## ✨ 能力矩阵
|
|
37
|
-
|
|
38
|
-
| 能力 | 适用场景 | 文档 |
|
|
39
|
-
| --- | --- | --- |
|
|
40
|
-
| 任务管理(tasks) | 方案落盘、总览过滤、校验归档、导入导出 CSV / XLSX / JSON | [CLI 参考](./docs/cli.md) · [任务文件规范](./docs/guide.md#任务文件规范) |
|
|
41
|
-
| 多语言 CHANGELOG(changelog) | 封装 changesets 发版、分组标题本地化 | [CLI 参考](./docs/cli.md#changelog) |
|
|
42
|
-
| 协作规范载体(conventions) | 把任务里提炼的规范收进 `.tasks/conventions/`,成为可检索、可校验的项目规范源;支持结构升级、表格形态归一与只读体检 | [CLI 参考](./docs/cli.md) · [完整攻略](./docs/guide.md#conventions-规范沉淀地) |
|
|
43
|
-
| Node API | 把上述能力嵌进脚本或平台 | [API 参考](./docs/api.md) |
|
|
44
|
-
| 隐私脱敏 | 落盘前自动掩码邮箱、手机号、密钥等 | [配置参考](./docs/config.md) |
|
|
45
|
-
| AI 技能包(skills) | 不装本工具也能让 AI 按同一套规范干活;装了可一键分发技能(`--scope project` 随仓库入库、队友 clone 即用) | [完整攻略](./docs/guide.md#ai-技能包-skills) · [FAQ](./docs/faq.md#工具和-skills-都得装吗) |
|
|
46
|
-
| 配置文件 | 三层(全局 / 项目 / 本地)定制脱敏、告警、导入列映射、语言表;`toolkit config status` 只读查看生效情况与来源 | [CLI 参考](./docs/cli.md#config-1-11-2-新增) · [配置参考](./docs/config.md) |
|
|
47
|
-
|
|
48
|
-
## 📚 文档
|
|
49
|
-
|
|
50
|
-
| 文档 | 适合谁 |
|
|
51
|
-
| --- | --- |
|
|
52
|
-
| [新手指南](./docs/getting-started.md) | 第一次接触,想 30 秒跑起来(含零基础术语表) |
|
|
53
|
-
| [操作手册](./docs/handbook.md) | 日常照着做:每个场景该说什么、做什么 |
|
|
54
|
-
| [完整攻略](./docs/guide.md) | 日常使用:工作流、Git 纳管、项目级激活、多语言 CHANGELOG |
|
|
55
|
-
| [CLI 参考](./docs/cli.md) | 查命令、参数、默认值、退出码 |
|
|
56
|
-
| [API 参考](./docs/api.md) | 作为库引入 Node 项目 |
|
|
57
|
-
| [配置参考](./docs/config.md) | 查配置文件字段(全局 / 项目 / 本地三层) |
|
|
58
|
-
| [更新日志](./docs/changelog.md) | 查各版本变更内容 |
|
|
59
|
-
| [FAQ](./docs/faq.md) | 遇到问题先来这里找 |
|
|
60
|
-
| [推荐 AI 全局规则](./docs/ai-rules.md) | 想让 AI 助手按本工具的最佳实践协作 |
|
|
61
|
-
| [推荐提交信息规则](./docs/commit-rules.md) | 想让 AI 按统一格式写 git 提交信息 |
|
|
62
|
-
| [完整文档站](https://fxri-net.github.io/toolkit/) | 在线阅读体验 |
|
|
63
|
-
|
|
64
|
-
## 🧩 AI 技能包(skills)
|
|
65
|
-
|
|
66
|
-
```bash
|
|
67
|
-
pnpm add -g @fxri/toolkit && toolkit skills install # 装了 CLI 一键分发(npm 用户:npm i -g @fxri/toolkit)
|
|
68
|
-
toolkit skills install --scope project # 项目面分发:真源与入口薄壳随仓库入库、队友 clone 即用
|
|
69
|
-
pnpm dlx skills add fxri-net/toolkit # 也可用上游安装器(npm 用户:npx skills add fxri-net/toolkit)
|
|
70
|
-
```
|
|
71
|
-
|
|
72
|
-
技能随包分发(真源为包内 `skills/`),与 CLI 同一发布批次(技能内容版本独立编号);`toolkit skills install` 默认软链,链接创建失败自动降级副本,`toolkit skills status` 查现场,`toolkit skills remove` 卸载。`--scope project` 换项目面——真源落 `<仓库根>/.agents/skills/`、其余候选目录落入口薄壳,随 git 入库后队友 clone 靠 `toolkit init` 写入的 `prepare` 钩子自动补齐。
|
|
73
|
-
|
|
74
|
-
- [fxri-plan-to-task](./skills/fxri-plan-to-task/SKILL.md):方案确认后落盘为任务文件(任务分解与纯展示计划表、逐仓逐任务建档、check、归档 + 任务级规范沉淀为强制终点)
|
|
75
|
-
- [fxri-release-changelog](./skills/fxri-release-changelog/SKILL.md):发版时创建变更集、格式化多语言 CHANGELOG
|
|
76
|
-
- [fxri-session-recap](./skills/fxri-session-recap/SKILL.md):会话收尾全量沉淀、新会话三层恢复、历史任务时间批量修正(1.7.0 新增技能)
|
|
77
|
-
|
|
78
|
-
|
|
79
|
-
|
|
80
|
-
|
|
81
|
-
|
|
82
|
-
|
|
83
|
-
|
|
84
|
-
pnpm
|
|
85
|
-
pnpm
|
|
86
|
-
|
|
87
|
-
|
|
88
|
-
|
|
89
|
-
|
|
90
|
-
|
|
91
|
-
|
|
92
|
-
|
|
93
|
-
|
|
94
|
-
|
|
95
|
-
|
|
96
|
-
|
|
97
|
-
|
|
98
|
-
|
|
99
|
-
|
|
100
|
-
|
|
101
|
-
|
|
102
|
-
|
|
103
|
-
|
|
104
|
-
|
|
105
|
-
|
|
106
|
-
|
|
107
|
-
|
|
108
|
-
|
|
109
|
-
|
|
110
|
-
|
|
111
|
-
|
|
112
|
-
|
|
1
|
+
<p align="center">
|
|
2
|
+
<img src="./docs/public/logo.png" width="128" alt="方弦工具集">
|
|
3
|
+
</p>
|
|
4
|
+
|
|
5
|
+
# 方弦工具集
|
|
6
|
+
|
|
7
|
+
[](https://github.com/fxri-net/toolkit/actions/workflows/ci.yml)
|
|
8
|
+
[](https://www.npmjs.com/package/@fxri/toolkit)
|
|
9
|
+
[](./docs/getting-started.md#安装)
|
|
10
|
+
[](./LICENSE)
|
|
11
|
+
|
|
12
|
+
> 国内网络建议优先 [Gitee 镜像](https://gitee.com/fxri/toolkit)(与 GitHub 同源同步,仓库/文档/issues/skills 全渠道可用);问题反馈走 [GitHub Issues](https://github.com/fxri-net/toolkit/issues) 或 [Gitee Issues](https://gitee.com/fxri/toolkit/issues)。
|
|
13
|
+
|
|
14
|
+
专为**多人 + AI 跨项目协作**打造:任务管理 + 多语言 CHANGELOG。
|
|
15
|
+
|
|
16
|
+
AI 参与开发后,方案与决策散落在对话记录里,会话一关什么都不剩;任务记录零散,谁在做、做到哪,无从查起;发版 CHANGELOG 还要人肉维护多语言。本工具把这条链路沉淀为**仓库内可检索、可校验、可归档的文件**——人离开会话,记忆留在仓库里。
|
|
17
|
+
|
|
18
|
+
- **零依赖 AI 技能包(skills)**:方案落盘、发版 CHANGELOG 两套工作流沉淀为 Agent Skills,不绑定任何 AI 工具;skills 可以独立工作,CLI 是可选加速——推荐都装,体验最完整([什么关系?](./docs/faq.md#工具和-skills-都得装吗))
|
|
19
|
+
- **不懂 AI 也能用**:任务管理与 CHANGELOG 是纯 CLI 能力;术语都说了人话([先看术语表](./docs/getting-started.md#几个术语-先说人话))
|
|
20
|
+
|
|
21
|
+
## 🚀 30 秒上手
|
|
22
|
+
|
|
23
|
+
```bash
|
|
24
|
+
# 1. 项目内安装(推荐,团队共享版本)
|
|
25
|
+
pnpm add -D @fxri/toolkit
|
|
26
|
+
|
|
27
|
+
# 2. 初始化任务区(生成 .tasks/ 骨架、conventions/ 规范载体与技能入口壳;含本地依赖时写入 prepare 刷新钩子)
|
|
28
|
+
pnpm exec toolkit init
|
|
29
|
+
|
|
30
|
+
# 3. 查看任务总览
|
|
31
|
+
pnpm exec toolkit tasks
|
|
32
|
+
```
|
|
33
|
+
|
|
34
|
+
之后:方案确认后登记为 `.tasks/` 任务文件 → `pnpm exec toolkit tasks check` 校验 → 完成后 `pnpm exec toolkit tasks archive` 归档并做规范沉淀。多任务 / 多仓方案先出纯展示计划表,再逐仓逐任务建档、按序逐个交付提交。完整步骤见 [新手指南](./docs/getting-started.md)。
|
|
35
|
+
|
|
36
|
+
## ✨ 能力矩阵
|
|
37
|
+
|
|
38
|
+
| 能力 | 适用场景 | 文档 |
|
|
39
|
+
| --- | --- | --- |
|
|
40
|
+
| 任务管理(tasks) | 方案落盘、总览过滤、校验归档、导入导出 CSV / XLSX / JSON | [CLI 参考](./docs/cli.md) · [任务文件规范](./docs/guide.md#任务文件规范) |
|
|
41
|
+
| 多语言 CHANGELOG(changelog) | 封装 changesets 发版、分组标题本地化 | [CLI 参考](./docs/cli.md#changelog) |
|
|
42
|
+
| 协作规范载体(conventions) | 把任务里提炼的规范收进 `.tasks/conventions/`,成为可检索、可校验的项目规范源;支持结构升级、表格形态归一与只读体检 | [CLI 参考](./docs/cli.md) · [完整攻略](./docs/guide.md#conventions-规范沉淀地) |
|
|
43
|
+
| Node API | 把上述能力嵌进脚本或平台 | [API 参考](./docs/api.md) |
|
|
44
|
+
| 隐私脱敏 | 落盘前自动掩码邮箱、手机号、密钥等 | [配置参考](./docs/config.md) |
|
|
45
|
+
| AI 技能包(skills) | 不装本工具也能让 AI 按同一套规范干活;装了可一键分发技能(`--scope project` 随仓库入库、队友 clone 即用) | [完整攻略](./docs/guide.md#ai-技能包-skills) · [FAQ](./docs/faq.md#工具和-skills-都得装吗) |
|
|
46
|
+
| 配置文件 | 三层(全局 / 项目 / 本地)定制脱敏、告警、导入列映射、语言表;`toolkit config status` 只读查看生效情况与来源 | [CLI 参考](./docs/cli.md#config-1-11-2-新增) · [配置参考](./docs/config.md) |
|
|
47
|
+
|
|
48
|
+
## 📚 文档
|
|
49
|
+
|
|
50
|
+
| 文档 | 适合谁 |
|
|
51
|
+
| --- | --- |
|
|
52
|
+
| [新手指南](./docs/getting-started.md) | 第一次接触,想 30 秒跑起来(含零基础术语表) |
|
|
53
|
+
| [操作手册](./docs/handbook.md) | 日常照着做:每个场景该说什么、做什么 |
|
|
54
|
+
| [完整攻略](./docs/guide.md) | 日常使用:工作流、Git 纳管、项目级激活、多语言 CHANGELOG |
|
|
55
|
+
| [CLI 参考](./docs/cli.md) | 查命令、参数、默认值、退出码 |
|
|
56
|
+
| [API 参考](./docs/api.md) | 作为库引入 Node 项目 |
|
|
57
|
+
| [配置参考](./docs/config.md) | 查配置文件字段(全局 / 项目 / 本地三层) |
|
|
58
|
+
| [更新日志](./docs/changelog.md) | 查各版本变更内容 |
|
|
59
|
+
| [FAQ](./docs/faq.md) | 遇到问题先来这里找 |
|
|
60
|
+
| [推荐 AI 全局规则](./docs/ai-rules.md) | 想让 AI 助手按本工具的最佳实践协作 |
|
|
61
|
+
| [推荐提交信息规则](./docs/commit-rules.md) | 想让 AI 按统一格式写 git 提交信息 |
|
|
62
|
+
| [完整文档站](https://fxri-net.github.io/toolkit/) | 在线阅读体验 |
|
|
63
|
+
|
|
64
|
+
## 🧩 AI 技能包(skills)
|
|
65
|
+
|
|
66
|
+
```bash
|
|
67
|
+
pnpm add -g @fxri/toolkit && toolkit skills install # 装了 CLI 一键分发(npm 用户:npm i -g @fxri/toolkit)
|
|
68
|
+
toolkit skills install --scope project # 项目面分发:真源与入口薄壳随仓库入库、队友 clone 即用
|
|
69
|
+
pnpm dlx skills add fxri-net/toolkit # 也可用上游安装器(npm 用户:npx skills add fxri-net/toolkit)
|
|
70
|
+
```
|
|
71
|
+
|
|
72
|
+
技能随包分发(真源为包内 `skills/`),与 CLI 同一发布批次(技能内容版本独立编号);`toolkit skills install` 默认软链,链接创建失败自动降级副本,`toolkit skills status` 查现场,`toolkit skills remove` 卸载。`--scope project` 换项目面——真源落 `<仓库根>/.agents/skills/`、其余候选目录落入口薄壳,随 git 入库后队友 clone 靠 `toolkit init` 写入的 `prepare` 钩子自动补齐。
|
|
73
|
+
|
|
74
|
+
- [fxri-plan-to-task](./skills/fxri-plan-to-task/SKILL.md):方案确认后落盘为任务文件(任务分解与纯展示计划表、逐仓逐任务建档、check、归档 + 任务级规范沉淀为强制终点)
|
|
75
|
+
- [fxri-release-changelog](./skills/fxri-release-changelog/SKILL.md):发版时创建变更集、格式化多语言 CHANGELOG
|
|
76
|
+
- [fxri-session-recap](./skills/fxri-session-recap/SKILL.md):会话收尾全量沉淀、新会话三层恢复、历史任务时间批量修正(1.7.0 新增技能)
|
|
77
|
+
- [fxri-text-encoding](./skills/fxri-text-encoding/SKILL.md):文本文件的 UTF-8 / BOM / 行尾基线,脚本中文乱码、终端与重定向输出乱码、首行报错的定位与修复
|
|
78
|
+
|
|
79
|
+
skills 与工具的关系、只在公司项目激活等说明见 [FAQ](./docs/faq.md) 与 [完整攻略](./docs/guide.md#ai-技能包-skills)。
|
|
80
|
+
|
|
81
|
+
## 📦 安装
|
|
82
|
+
|
|
83
|
+
```bash
|
|
84
|
+
pnpm add -D @fxri/toolkit # 项目 devDependency(团队项目推荐,版本随仓库锁定)
|
|
85
|
+
pnpm i -g @fxri/toolkit # 全局(个人多项目推荐;pnpm 不受 nvm 切版本影响)
|
|
86
|
+
pnpm dlx @fxri/toolkit tasks # 不安装临时执行
|
|
87
|
+
```
|
|
88
|
+
|
|
89
|
+
npm / yarn / bun 用户与各方式对比见 [新手指南 · 安装](./docs/getting-started.md#安装)。
|
|
90
|
+
|
|
91
|
+
## 🔒 隐私脱敏
|
|
92
|
+
|
|
93
|
+
落盘记录默认脱敏敏感信息:内置邮箱、手机号、身份证、IPv4、内网 URL、JWT、AWS / GitHub / OpenAI / Slack 密钥等 13 类规则,支持自定义规则与禁用。开关三档(CLI 参数 > 环境变量 > 配置文件),详见 [配置参考](./docs/config.md)。
|
|
94
|
+
|
|
95
|
+
## ⚙️ 环境要求
|
|
96
|
+
|
|
97
|
+
- Node.js >= 20.19.0(更低版本可安装,changesets 相关子命令不可用,见 [FAQ](./docs/faq.md#node-18-能用吗))
|
|
98
|
+
|
|
99
|
+
## 📄 版权信息
|
|
100
|
+
|
|
101
|
+
作者:唐启云 <tqy@fxri.net>
|
|
102
|
+
|
|
103
|
+
出品:方弦研究所
|
|
104
|
+
|
|
105
|
+
版权:Copyright © 2026 唐启云. All rights reserved.
|
|
106
|
+
|
|
107
|
+
网站:[方弦研究信息网](https://fxri.net:444/)
|
|
108
|
+
|
|
109
|
+
协议:[MIT License](./LICENSE)
|
|
110
|
+
|
|
111
|
+
商标:"方弦®"为第42类注册商标(注册号89648411),本开源许可不授予商标使用权,详见 [TRADEMARK.md](./TRADEMARK.md)
|
|
112
|
+
|
|
113
|
+
> 方弦研究所为唐启云个人项目品牌与出品方,非独立法人实体;本软件著作权归唐启云所有。
|
package/TRADEMARK.md
CHANGED
|
@@ -1,41 +1,41 @@
|
|
|
1
|
-
# 商标声明
|
|
2
|
-
|
|
3
|
-
## 基本信息
|
|
4
|
-
|
|
5
|
-
| 项目 | 内容 |
|
|
6
|
-
|---|---|
|
|
7
|
-
| 商标名称 | 方弦® |
|
|
8
|
-
| 商标类型 | 文字商标 |
|
|
9
|
-
| 商标说明 | 商标由文字"方弦"组成 |
|
|
10
|
-
| 商标类别 | 第42类(共10项) |
|
|
11
|
-
| 注册号 | 89648411 |
|
|
12
|
-
| 申请人 | 唐启云 |
|
|
13
|
-
| 递交商标局 | 2026-01-12 |
|
|
14
|
-
| 版本 | 基础版 |
|
|
15
|
-
|
|
16
|
-
## 第42类服务项目
|
|
17
|
-
|
|
18
|
-
计算机出租;计算机软件设计;为他人研究和开发新产品;计算机软件维护;把有形的数据或文件转换成电子媒体;为他人创建和维护网站;网络服务器出租;提供互联网搜索引擎;托管计算机站(网站);云计算。
|
|
19
|
-
|
|
20
|
-
## 权利状态
|
|
21
|
-
|
|
22
|
-
"方弦®"商标(注册号89648411)已获中国国家知识产权局商标局核准注册,核定使用于第42类上述服务项目,现为注册商标。
|
|
23
|
-
|
|
24
|
-
## 授权范围
|
|
25
|
-
|
|
26
|
-
本仓库的开源许可证(MIT License)仅授予代码的使用、修改和分发权利,**不构成对任何商标、服务标记或品牌名称的授权许可**。
|
|
27
|
-
|
|
28
|
-
任何派生作品、修改版本、商业产品均不得使用"方弦"名称、Logo 或相关标识,除非获得书面授权。
|
|
29
|
-
|
|
30
|
-
## 使用规范
|
|
31
|
-
|
|
32
|
-
- 在开源社区讨论、文档引用中提及本项目时,可使用"方弦®"指代本项目名称
|
|
33
|
-
- 未经书面授权,不得在任何商业产品、服务或宣传材料中使用"方弦"标识
|
|
34
|
-
|
|
35
|
-
## 获取授权
|
|
36
|
-
|
|
37
|
-
如需将"方弦"商标用于商业用途,请联系:唐启云 <tqy@fxri.net>
|
|
38
|
-
|
|
39
|
-
## 侵权处理
|
|
40
|
-
|
|
41
|
-
如发现未经授权使用"方弦®"商标的行为,请通过上述联系方式举报。
|
|
1
|
+
# 商标声明
|
|
2
|
+
|
|
3
|
+
## 基本信息
|
|
4
|
+
|
|
5
|
+
| 项目 | 内容 |
|
|
6
|
+
|---|---|
|
|
7
|
+
| 商标名称 | 方弦® |
|
|
8
|
+
| 商标类型 | 文字商标 |
|
|
9
|
+
| 商标说明 | 商标由文字"方弦"组成 |
|
|
10
|
+
| 商标类别 | 第42类(共10项) |
|
|
11
|
+
| 注册号 | 89648411 |
|
|
12
|
+
| 申请人 | 唐启云 |
|
|
13
|
+
| 递交商标局 | 2026-01-12 |
|
|
14
|
+
| 版本 | 基础版 |
|
|
15
|
+
|
|
16
|
+
## 第42类服务项目
|
|
17
|
+
|
|
18
|
+
计算机出租;计算机软件设计;为他人研究和开发新产品;计算机软件维护;把有形的数据或文件转换成电子媒体;为他人创建和维护网站;网络服务器出租;提供互联网搜索引擎;托管计算机站(网站);云计算。
|
|
19
|
+
|
|
20
|
+
## 权利状态
|
|
21
|
+
|
|
22
|
+
"方弦®"商标(注册号89648411)已获中国国家知识产权局商标局核准注册,核定使用于第42类上述服务项目,现为注册商标。
|
|
23
|
+
|
|
24
|
+
## 授权范围
|
|
25
|
+
|
|
26
|
+
本仓库的开源许可证(MIT License)仅授予代码的使用、修改和分发权利,**不构成对任何商标、服务标记或品牌名称的授权许可**。
|
|
27
|
+
|
|
28
|
+
任何派生作品、修改版本、商业产品均不得使用"方弦"名称、Logo 或相关标识,除非获得书面授权。
|
|
29
|
+
|
|
30
|
+
## 使用规范
|
|
31
|
+
|
|
32
|
+
- 在开源社区讨论、文档引用中提及本项目时,可使用"方弦®"指代本项目名称
|
|
33
|
+
- 未经书面授权,不得在任何商业产品、服务或宣传材料中使用"方弦"标识
|
|
34
|
+
|
|
35
|
+
## 获取授权
|
|
36
|
+
|
|
37
|
+
如需将"方弦"商标用于商业用途,请联系:唐启云 <tqy@fxri.net>
|
|
38
|
+
|
|
39
|
+
## 侵权处理
|
|
40
|
+
|
|
41
|
+
如发现未经授权使用"方弦®"商标的行为,请通过上述联系方式举报。
|