反思一下为什么我的开源项目没有做好

这些文字读起来很难受，可能是因为你的母语不是中文，同时没有使用好的翻译工具。
This text is difficult to read, perhaps because Chinese isn’t your native language and you didn’t use a good translation tool.

@fructose ...哥们我是中文写的不至于吧

@fructose #1 有可能是 AI 写的或者润色过的。AI 特别擅长这种语法正确但是读起来难受的长难句。

母语非中文的作者如果能写成这样，那和母语也差不多了。甚至已经超出中文互联网的平均水平了。

@gullitintanni ..不是 20 岁才出国国内读了高中为啥就变成了非中文母语者了

确实是看起来有点难受，其实没有 AI 味，说不出来什么原因

阅读起来，有一种看机器翻译的感觉

@duuu 我问了我室友她说是因为句子太多从句了，像英文不断加从句。

声称、早些时候，这些词汇，在我看来就是直接机翻，不可能是中国人写出来的。

看不懂，但已 Star 。

其实专业领域的人面对非专业领域的人在阐述问题时带有较多术语，并且经过良好训练的人讲求逻辑严谨、带很多定语或从句之类的，导致句子复杂，跟考研英语、雅思学术之类的长难句一个道理。
然后就显得难于理解，不接地气了。这属于正常现象，习惯了学习/学院/学术方式严谨思维的人，想改变到面向市场的思维方式挺难的。这是另一种“聪明反被聪明误”。

祝 OP 成功！

github 上 readme 的文字不对。

最外层的标题

你现在是：

《 Tura：少 83.1% 的交互轮次，高 16.7 个百分点的成功率》

改成下面这个，可以提升 star 率：

《 Tura：一个更快、更省钱的本地 AI 编程助手——免费、开源，减少 83.1% 的交互次数、提高 16.7% 代码生成正确率》

readme 后面的文章中夹杂着大量的专业术语，那一定会同时给人两种感觉：
1. 你似乎很专业。
2. 你似乎在看不起我——连个介绍的文档都不懂——我们不是一路人——江湖再见。

真正的专家一定是能化繁为简的。

越是水平高的专家，说的话就越能让人听懂。

而不是把简单的东西弄的很复杂，显得你很专业、用户很傻逼似

@xuld 其实我想听一下我该如何介绍能解释得更清楚。我问过 gpt 他说得解释我反而听不懂

@xuld 其实你可能觉得我是傻逼但是 16.7 的百分点是相对于 basline 标准计算的比如对比对象是 60% 我的是 76.7%我准确的说是百分点。 但是如果我说百分比也就是 16.7% 其实我的成绩应该是 10%左右。 我想说的更容易理解，但这很可能导致我说的内容不是准确的。

@lesismal 我觉得这是 2 种技能。我完全不具备能说的好理解的这个能力，只能慢慢训练。但是很难。

我不用是因为我想完成自己的 agent project （

你需要一个简明的报告来指出
- tura 用到的优化方法
- 优化方法的效果。

比起项目介绍我的私心其实更想知道 agent token 消耗的分布是如何 benchmark 的，在哪有工具和数据可以查看/分析；从我日常的直觉来看深度任务的反复返工是最要命的——设了一个过远的目标，缺乏局部 greedy 效果跟踪，导致消耗了大量 reasoning 输出后得到了一个不完全符合本意的结果。

假如你发明了某种技术，能通过实验证明能通过强力精准的剪枝把这些预期外尝试消除，那么这个技术本身就是最好的推广主体和宣传点，而你的项目只不过是该技术的一个验证，以及（比别的想复现的人更进一步地）产品化。




另外行文没什么大问题没必要听天天对着 LLM 的破碎中文语言能力都退化了的人瞎指点语法结构，让「语言模型教人类语言如何建模」才是最黑色幽默的讽刺。我甚至很多时候都会故意用长句子来回复。

@yohjisakamoto 不需要“准确”！甚至你都可以不要数字，直接用“很多”，“超过一倍”这样的描述。

我知道你在项目里花了很多心血，想要诚实以对，但问题是用户并不关心你有多努力，也没人会在意你说的准不准，用户只关心他自己，他需要在 3 秒内判定这个项目能不能为它所用，然后马上关掉页面。

你的真实用户，3 秒内看不出这个项目的价值，其实都流失了。

不要看你现在关注的人还多，我敢说他们大部分不是你的用户，他们的真实意图是：“想把你的东西抄成他们自己的，关注后以后有时间慢慢研究”。因为只有这样的人，才会愿意看你这么多“专业”的废话

比我好多了，我不走偏门，只做工具，完全没啥人关注。

这是我主页： https://github.com/MrsEWE44

@yohjisakamoto 我发了一个帖子，也被怪中文语法，我自己又重新阅读了好几遍，结果觉得还好。

@GeruzoniAnsasu 这个就乖没仔细看了 https://turaai.net/docs#benchmark-current-test-set-record

@xuld 我觉得这样就没差异化了，和 rtk 这些牛逼吹上天的就没区别了。我觉得 vibecodidng 这么多还是要有点差异化。你可以看下我上面帖子里的 jetbrain 的文章。基本跟我是一个风格的，我觉得差异性也是个挺重要的原因。

想问一下，
tura 是如何处理 schema 重试的，
patch 复杂 markdown 的时候格式出问题的概率大吗，
另外代码里有强制 dsl 输出的 command 数量吗，不强制会怎么样，
此外试过只给一个单纯的 seq(按序执行 command) 看看效果如何吗
(话说回来 DeepSeek 测试过吗)

感觉比我强太多了，我一个编辑功能优化了好久都没优化好，可以看看我的 https://github.com/Menfre01/waveloom 指点一下

啊 看的真的很难受。

比如排版问题
❌ ：节省 80%-90%token 的项目
✅ ：节省 80%～ 90% Token 的项目

比如主谓宾问题

❌ 一篇系统解释运行机制、并挑战既有假设的长文章，在已经充斥着 AI 生成文章和“节省 95% Token”插件的论坛里，很难得到传播。

✅ 论坛里充斥着 AI 生成的文章和"节省 95% Token"的插件。
在这样的环境里，一篇系统解释运行机制、挑战既有假设的长文，
很难传播出去。

感觉真的怪怪的，不像中文。

感觉在用英文的逻辑写中文。

和 ai 聊天 发现个好玩了，op 用普通话读一下，英文主谓宾舌头打结 233333

没接触过这类产品，看了 github 的感受是，不像是产品介绍，像在读论文，中文 readme 第二段已经看得很费劲了，又是数据又是破折号对比，你要做的是产品推广不是技术说明书。“少 83.1% 的交互轮次，高 16.7 个百分点的成功率”这样的数据，完全可以用更快，更省来表达。只介绍你的优势，让用户快速用起来才是最重要的，不用花大篇幅介绍你是怎么做的，也许你是想提现数据严谨，你可以将对比这部分放在篇幅末尾。readme 按照优势介绍-quick start-技术说明 这个的结构来写也许会好一点。希望对你有帮助。

专门上号吐槽一下，你的中文 README 中基准测试那一节，开头这句：
长周期任务基准测试是看透精心打磨的孤立提示，了解代理如何处理真实工作的一种方式。

这句话的断句应该是：长周期任务基准测试 / 是 / 看透精心打磨的孤立提示，了解代理如何处理真实工作 / 的 / 一种方式

那中间这个不应该是顿号吗？逗号把这句话拆分成前后两部分，导致第一眼就没看懂，“长周期任务基准测试是看透精心打磨的孤立提示”？

另外当我想帮你改写这句话的时候发现“看透精心打磨的孤立提示”这个太模糊了，看透的到底是什么？很困惑。我猜测你是想说目前框架中这些孤立的 prompt 到底对模型的正确性起到什么样的作用？

不如直接说：为了准确体现代理的真实工作逻辑，我们以长周期任务作为基准测试。

楼主我觉得你的明显一个问题就是把简单的问题表达的很复杂，以至于读者难以看明白。就算项目很好，不知道你在说啥，那也很难吸引使用者。

@wha582 patch 最大的问题是一般工具会把 patch 分段放在一个执行 command 里，单一部分失败一般就整个崩了。tura 的 patch 会被拆分成每一段修改一个 cli 命令。正常情况下 step 1 打 patch ，step 2 build ，step 3 跑测试，step 4 读 log 。 但是如果 patch 中有 exit 1 或是其他错误，执行器会 abort 整个 llm call 。并记录执行过的成功 patch ，然后把中间态记录在 session log 中。立刻重新启动新一轮的 provider call ，把中间态和上一回合 patch exit 错误原因回填给 provider 。这样如果 Cc 或者 codex 整个补丁都会挂重头写，tura 一般只需要重写一小段。

@penguinWWY 这个，起码在英文原版中是想说，通过 eval 和 benchmak 作孤立的提示词和单元修改对整体 benchmark 成绩的影响来判定是否留下或者改变某个提示词或者架构设计。 你可以理解为把 provider 的行为想象成一个非确定性的生物系统。通过设计实验和观察来判定某些局部环境和输入的改变对输出的影响。

就比如说我研究土豆养殖，2 个分组，用同系的 200 苗株，100 每天浇水 4 次，另一组每天浇水 2 次。观察产量变化。如果一个组的收成更好，则把他的浇水方式引入系统。

就像 patch 的例子，我通过独立的完整的 benchmark 任务来测试是通过提示词和 cli 中的某个参数该如何设计。得出的结论就是在统计后，现有方案是测试模型和测试类型任务的最优解，这也是大概率的我能找到的目前的全局最优解。 我其实想说的是在构建一个复杂系统的时候，正确的做法是通过模拟 benchmark 来作某种程度的梯度下降，来衡量设计决定以及参数是否帮助构造最优解。

@wha582 目前通过 schema 限制 5-15 组命令，每个命令的长度和 step 也有限制。但是我没开 strict schema 。所以就看 llm 自觉。经过测试这是最优的配置。用 schema 和提示词但不 strict 。大部分情况会把所有能并发和串行的全部一次输出。1-3 次能解决的简单任务比如查询时间也能不输出无意义指令。在 kimi ，deepseek ，gpt ，minimax 上都有类似的效果。

@menfrexu 具体有啥问题吗哥们

@coala 这个原来的版本可能有编辑的小问题，但我觉得大家说的不是这些小问题。是根本的行文和修辞，甚至是表达问题。我也发现了这个问题，但是我发现真的很难改。这其实是语言习惯，就像很多人打中文不加标点符号一样。但是我觉得你说英文逻辑就有点夸张了。我写的时候完全是按中文逻辑写的，头脑中的思绪也是中文。 我自己写的时候读的其实听通顺的。。。

[tura postinstall] platform package tura-darwin-arm64 is unavailable; reinstall tura-ai with optional dependencies enabled after confirming [email protected] is published
____
macos iTerm2

@FrankFang128 这是 npm 报错？ 你试一下 npm install [email protected]

我跑了 action 没有复现

Run set -euo pipefail
=== Runner ===
ProductName: macOS
ProductVersion: 15.7.7
BuildVersion: 24G720
Darwin iad20-fj917-84fa707e-f52f-447e-8b80-e82831afc5e5-8E81B2C365B6.local 24.6.0 Darwin Kernel Version 24.6.0: Tue Apr 21 20:18:00 PDT 2026; root:xnu-11417.140.69.710.16~1/RELEASE_ARM64_VMAPPLE arm64
v22.23.1
10.9.8
node platform=darwin arch=arm64
=== Registry metadata ===
{
"version": "0.1.34",
"optionalDependencies": {
"tura-darwin-arm64": "0.1.34",
"tura-darwin-x64": "0.1.34",
"tura-linux-x64": "0.1.34",
"tura-win32-x64": "0.1.34"
}
}
{
"version": "0.1.34",
"os": [
"darwin"
],
"cpu": [
"arm64"
],
"dist.integrity": "sha512-/yEz+bGTHw2w8HnYyE6lxvSQOOGEZ4I3R4mERAaBcogl0pHcDRMW2D8nAyhqIEkPFhFBMOjFafDmpjhuXbvhLQ=="
}
=== Published package install ===
npm verbose cli /Users/runner/hostedtoolcache/node/22.23.1/arm64/bin/node /Users/runner/hostedtoolcache/node/22.23.1/arm64/bin/npm
npm info using [email protected]
npm info using [email protected]
npm verbose title npm install [email protected]
npm verbose argv "install" "--global" "--prefix" "/Users/runner/work/_temp/tura-global" "[email protected]" "--include" "optional" "--registry" "https://registry.npmjs.org/" "--loglevel" "verbose"
npm verbose logfile logs-max:10 dir:/Users/runner/.npm/_logs/2026-07-26T12_21_28_344Z-
npm verbose logfile /Users/runner/.npm/_logs/2026-07-26T12_21_28_344Z-debug-0.log
npm http cache https://registry.npmjs.org/tura-ai 8ms (cache hit)
npm http cache https://registry.npmjs.org/tura-darwin-arm64 15ms (cache hit)
npm http fetch GET 200 https://registry.npmjs.org/tura-darwin-x64 126ms (cache miss)
npm http fetch GET 200 https://registry.npmjs.org/tura-linux-x64 112ms (cache miss)
npm http fetch GET 200 https://registry.npmjs.org/tura-win32-x64 141ms (cache miss)
npm verbose reify failed optional dependency /Users/runner/work/_temp/tura-global/lib/node_modules/tura-ai/node_modules/tura-win32-x64
npm verbose reify failed optional dependency /Users/runner/work/_temp/tura-global/lib/node_modules/tura-ai/node_modules/tura-linux-x64
npm verbose reify failed optional dependency /Users/runner/work/_temp/tura-global/lib/node_modules/tura-ai/node_modules/tura-darwin-x64
npm http cache tura-ai@https://registry.npmjs.org/tura-ai/-/tura-ai-0.1.34.tgz 0ms (cache hit)
npm http cache tura-darwin-arm64@https://registry.npmjs.org/tura-darwin-arm64/-/tura-darwin-arm64-0.1.34.tgz 0ms (cache hit)
npm http fetch GET 200 https://registry.npmjs.org/tura-ai/-/tura-ai-0.1.34.tgz 40ms (cache miss)
npm http fetch GET 200 https://registry.npmjs.org/tura-darwin-arm64/-/tura-darwin-arm64-0.1.34.tgz 1115ms (cache miss)
npm info run [email protected] postinstall node_modules/tura-ai node ./scripts/npm/install-release.mjs
npm info run [email protected] postinstall { code: 0, signal: null }

added 2 packages in 2s
npm verbose cwd /Users/runner/work/tura/tura
npm verbose os Darwin 24.6.0
npm verbose node v22.23.1
npm verbose npm v10.9.8
npm verbose exit 0
npm info ok
=== Installed dependency tree ===
/Users/runner/work/_temp/tura-global/lib
└─┬ [email protected]
├── [email protected]
├── UNMET OPTIONAL DEPENDENCY [email protected]
├── UNMET OPTIONAL DEPENDENCY [email protected]
└── UNMET OPTIONAL DEPENDENCY [email protected]

=== Installed platform package ===
{
"name": "tura-darwin-arm64",
"version": "0.1.34",
"os": [
"darwin"
],
"cpu": [
"arm64"
]
}
=== CLI verification ===
Tura terminal client

Usage:
tura [OPTIONS] open the interactive TUI
tura [OPTIONS] exec [PROMPT...] run the Rust CLI front
tura [OPTIONS] run [PROMPT...] run a non-interactive prompt
tura [OPTIONS] bash|zsh|shel [PROMPT...]
tura [OPTIONS] <command> --help show command-specific help

Commands:
run send a prompt through the gateway and stream the answer
exec forward to the Rust CLI front (`tura_exec`)
bash run a prompt with command tools forced to bash
zsh run a prompt with command tools forced to zsh
shel run a prompt with command tools forced to shell_command
resume show an existing session or append a follow-up prompt
session list or show sessions
config read or update workspace session config
provider list providers and inspect auth state
agent list, read, create, update, or set agent models
persona list, read, create, update, or delete personas
project inspect or create gateway workspaces
file list, read, open, or reveal workspace files
command list or execute gateway commands
inspect show gateway service, paths, and sessions
gateway send a raw gateway CLI protocol request
completion generate shell completion for bash, zsh, or fish

@FrankFang128 你提个完整 issue ？ 我看下有没有更多信息可以复现

lz 的想法真是很天才的，阅读了 readme 获益匪浅，感觉可以到被 openai 和 anthropic 收购的程度（但也侧面反映了这些家伙对于 token save 一点都不在意）

我作为一个用户，讲一些我看到这个项目的心理变化，希望对 lz 的困惑有所帮助

首先我没有在第一时间理解，我要怎么用这个，它是谁的代替品。我可以像 claude code/codex ，或者是 claude desktop or Orca 还是 workbuddy 等等的产品一样使用它。（虽然我通过完整的阅读 readme 知道了问题的答案，但如果好奇为什么你声称找到了真的节省 token 的办法，我是没耐心读下去的）

其次我读完之后也并没有要安装的想法，这一方面是因为我目前对 tokne 的消耗量并不大，另一方面是，我没有直观的看出 80%，16% 这些数字对我来说意味着什么。可能是能让我多 vibe 一会儿？多产出几个项目？但是思考这些问题，就会实打实的阻碍我产生安装的动作。最直白的建议，把 token 等价的美元，在用 codex 和 tura 之间比较，告诉人们能多蹬出多少美元，这样非常直观。

最后，我想起来了我以前的一个作品，https://github.com/chaoliu719/splitpatch ，它也是把原理放在了里面，甚至放了一个示例来讲。我今天整理 github 的时候，突然觉得我写这些更适合放到 blog 中，而不是 readme 中，readme 更多的是宣传，安装，快速上手，而不是原理解释。当时我真的很想把这些讲清楚，让大家看到这个项目的价值，但今天来看，我想问当初的自己，为什么用户需要关心这些原理呢？他们只需要最浅显易懂的 CTA ，他们只是 user 而不是 developer 。我没有动力改我的项目了，因为它很小，但是我觉得你的项目真的值得好好宣传一下，它真的很有潜力。

> 如果大家有时间看到这，可以给我提一些意见，告诉我如何才能在尊重 eval 和 benchmark 严谨性的同时更好的推广我的产品。 我知道用 codex 或者 claude 写一个 coding agent 很简单，但我也相信，总会有人理解 benchmark 和 eval harness 的价值。

我在这里和你有一点不同意见，原因和上面的回复类似，如果你想获得更多的 star ，更多的传播，就要从传播学/心理学入手。我认为大众在 star 或者评论转发，或者微信里讨论的时候，是不会在意严谨性的。所以如果卸下一丝严谨性的包袱，能更好的达到你的目的。一个我自己悟到的，严谨代表着能获得喜欢严谨人群的认可，但大众通常来讲是不严谨的，不是作者傲慢，是作者在满足自己的品味和达成自己的目的之间，两个都想要。

归根结底是身处在要求严谨的评价体系中，没有信心创作非严谨内容（因为这可能遭致恶评），但大众环境对结果更为看重（可以看成另一种要求结果的评价体系），两者评价体系不同，导致作者很难创作出符合另一种评价体系的内容，所以不必太过否定自己，换个环境会好起来的。

@liuchao719 其实我做这个架构的目的就是发论文然后影响整个行业的范式。一个商业公司如果成本大规模下降 60%我觉得这个产品是有意义的。我对他成功的定义就是 26 年年底，大部分 agent 的执行都不再用现有的 tool calling 架构。

@liuchao719 这其实本身是矛盾的，我的最终目标是让更多人知道这个架构的价值。但就像你说的这其实没有数据和测试是很难感知的。这也是为什么大部分用户会觉得 RTK 这类工具能节省 token 。